MPE/iX Intrinsics Reference Manual (32650-90905)

Chapter 6 299
Command Definitions (FLUSHLOG-GETUSERMODE)
GETINFO
GETINFO
NM and CM callable.
Returns user-supplied information that was passed to a process when it was created.
Syntax
I16 CA I16 I16
result :=GETINFO( infostring,infolength,parm );
Functional Return
result 16-bit signed integer (assigned functional return)
Returns an execution value:
Value Meaning
0 Successful execution.
1 Execution error, one of the following conditions exist:
•
Infostring was specified, but infolength was not
specified.
•
Infolength was specified, but infostring was not
specified.
• Either an invalid
infostring or infolength value
was specified.
• An invalid
parm value was specified.
Parameters
infostring character array (optional)
Returns an information string (the contents of an array) passed to the
calling process by the
info parameter of the RUN command, or by the item
associated with
itemnum 11 of the CREATEPROCESS intrinsic.
If the information string was not supplied at process creation time, or if it
is of length zero,
infostring is returned unmodified.
If
infostring is specified, infolength must pass the length, in bytes, of
infostring .
infolength 16-bit signed integer by reference (optional)
Passes and receives a value.
If
infostring is specified, infolength must pass the length, in bytes, of
infostring .
When returning from the call,
infolength contains the smaller of either