Caché ObjectScript Reference - InterSystems Documentation

double quotes. If the length parameter is omitted for modes 0, -1, and -2, the default is1.• When mode is -3, or a positive integer, the full length of the data is returned, regardlessof the length parameter. Specify a length of 1 to return the decimal value of the data.Specify a negative integer (-1) to to return the data as a string. If the length parameter isomitted, the default is 1.• When mode is -5, do not specify a length parameter.NotesProcess Virtual Address SpaceUse mode -3 to return the value from the current process' virtual address space, as shown inthis example:WRITE $VIEW(-1,-3,1)To return the virtual address space of a specified process, provide the Process ID (pid) forthat process — rather than -3 — for the second argument, as shown in this example:SET pid=$PIECE($IO,"|",4)WRITE $VIEW(-1,pid,1)The value returned is in the following format:pid^mode^dev^mem^dir^rou^stat^prio^uic^loc^blk^^^defns^lic^jbstat$VIEWThe fields are defined as follows: pid=the process ID. mode=* if in programmer mode, + or– if the job is part of a callin connection, omitted for daemons. dev=current open device(s),returned as a comma-separated list. The principal device is indicated by an astrisk (*) suffix.mem=memory in use in the process partition (in KBs), if the process is not a daemon.dir=default directory. rou=routine name. stat=bol,gcnt where bol is the beginning of linetoken, specifying the number of lines executed, and gcnt is the global count, specifying thetotal number of FOR loops and XECUTES performed. prio=user's current base priority.uic=(no longer used by Caché security at version 5.1 and subsequent) high,low representingthe high and low order bits of the User Identification Code (uic). loc=location, for daemonprocesses only. blk=number of 2K blocks that can be used for buddy block queues.defns=default namespace. lic=license bits. jbstat=job status, specified as high,low representingthe high and low order bits. Refer to $ZJOB special variable for details.Caché ObjectScript Reference 311