Guardian Procedure Calls Reference Manual (G06.25+)

Guardian Procedure Calls (P)
Guardian Procedure Calls Reference Manual—522629-013
12-62
PROCESS_GETINFO_ Procedure
Syntax for TAL Programmers
Parameters
error returned value
INT
indicates the outcome of the call. It returns one of the following values:
0 Information is returned for the specified process.
1 File-system error;
error-detail contains the error number.
2 Parameter error;
error-detail contains the number of the first parameter
found to be in error, where 1 designates the first parameter on the left.
3 Bounds error;
error-detail contains the number of the first parameter
found to be in error, where 1 designates the first parameter on the left.
4 Specified process does not exist
5 Unable to communicate with processor
6 Unable to communicate with system
processhandle input,output
INT .EXT:ref:10
specifies the process for which information is to be returned. If
processhandle
is omitted or null (-1 in each word), information about the caller is returned. If
processhandle is null, it returns the caller’s process handle.
! Input Error
! ! Output 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!