Guardian Procedure Calls Reference Manual (G06.25+)

Guardian Procedure Calls (P)
Guardian Procedure Calls Reference Manual—522629-013
12-136
PROCESS_LAUNCH_ Procedure
Z^VERSION
identifies the version of the ZSYS^DDL^PLAUNCH^PARMS structure.
The following table summarizes the possible values for Z^VERSION. TAL literals
are defined in the ZSYSTAL file. Literals in the
zsysc file, for C programs, are the
same as those for TAL except that they contain the underscore (_) character
instead of the circumflex (^) character.
The following value must be supplied:
Z^LENGTH
is the length of the ZSYS^DDL^PLAUNCH^PARMS structure. Because the
structure is subject to change, Z^LENGTH is used by PROCESS_LAUNCH_ to
further identify the version of the structure.
Z^PROGRAM^NAME
if Z^PROGRAM^NAME^LEN is not 0, specifies the address of a string containing
the name of the program file to be run. If used, the value of Z^PROGRAM^NAME
must point to a valid file name and must be exactly Z^PROGRAM^NAME^LEN
bytes long. The file must reside in the Guardian name space and must contain a
program for execution in the Guardian environment.
The new process is created on the node where the program file resides. If the
program file name is partially qualified, it is resolved using the =_DEFAULTS
DEFINE. If you specify a file on the subvolume $SYSTEM.SYSTEM and the file is
not found, PROCESS_LAUNCH_ then searches on the subvolume
$SYSTEM.SYS
nn.
Refer to Appendix D for a description of file-name syntax.
This parameter must be supplied unless the caller is creating its backup process.
Z^PROGRAM^NAME^LEN
specifies the length, in bytes, of the Z^PROGRAM^NAME field.
Z^LIBRARY^NAME
if specified and if Z^LIBRARY^NAME^LEN is not 0 or -1, specifies the address of a
string containing the name of the user library file to be used by the process. If
used, the string must be exactly Z^LIBRARY^NAME^LEN bytes long. If the library
file name is partially qualified, it is resolved using the =_DEFAULTS DEFINE. The
user library file must be on the same node as the process being created and must
reside in the Guardian name space. For the program to create a linkage to the
library file, the caller must have write permission to the program file.
Name (ZSYS^VAL^ ) Value Description
PLAUNCH^PARMS^VER
1 The current version of the structure