Guardian Procedure Calls Reference Manual

• Some character-string parameters to PROCESS_GETINFO_ are followed by a parameter
maxlen that specifies the maximum length in bytes of the character string and an additional
parameter that returns the actual length of the string. Where these parameters are optional,
the character-string parameter and the two parameters that follow it must either all be supplied
or all be absent.
Syntax for TAL Programmers
! input/output error detail
error := PROCESS_GETINFO_ ( [ processhandle ] ! i,o 1
,[ proc-fname:maxlen ] ! o:i 2
,[ proc-fname-len ] ! o 3
,[ priority ] ! o 4
,[ mom's-processhandle ] ! o 5
,[ hometerm:maxlen ] ! o:i 6
,[ hometerm-len ] ! o 7
,[ process-time ] ! o 8
,[ creator-access-id ] ! o 9
,[ process-access-id ] ! o 10
,[ gmom's-processhandle ] ! o 11
,[ jobid ] ! o 12
,[ program-file: maxlen ] ! o:i 13
,[ program-len ] ! o 14
,[ swap-file:maxlen ] ! o:i 15
,[ swap-len ] ! o 16
,[ error-detail ] ! o 17
,[ proc-type ] ! o 18
,[ oss-pid ] ! o 19
,[ timeout ] ); ! i 20
Parameters
processhandle
input, output
INT .EXT:ref:10
specifies the process for which information is to be returned. If processhandle is omitted or
null, information about the caller is returned. If processhandle is null, it returns the caller's
process handle. The null process handle is one which has -1 in each word. (For details, see
the PROCESSHANDLE_NULLIT_ Procedure (page 1140).) However, PROCESS_GETINFO_ also
treats a process handle with -1 in the first word as a null process handle.
proc-fname:maxlen
output:input
STRING .EXT:ref:*, INT:value
if present and maxlen is not 0, returns the process file name of the target process. Normally,
this value is a process descriptor. However, if the specified process is an I/O process (that is,
a process that controls a device or volume), the returned value is the fully qualified device or
volume name.
maxlen is the length in bytes of the string variable proc-fname. If it is not 0, you must specify
a maxlen value of at least 33 or use the ZSYS^VAL^LEN^PROCESSDESCR literal (which
equals 33) from the ZSYSDEFS.ZSYSTAL file.
proc-fname-len
output
INT .EXT:ref:1
contains the actual length of the process file name being returned.
1006 Guardian Procedure Calls (P)