Guardian Procedure Calls Reference Manual

DescriptionValueName (ZSYS^VAL^ )
Propagate DEFINEs in Z^DEFINES only. Otherwise, propagate only the
DEFINEs in the caller's context.
8PCREATOPT^DEFINELIST
Enable DEFINEs if PCREATOPT^DEFENABLED is specified. Disable
DEFINEs if PCREATOPT^DEFENABLED is not specified. Otherwise, use
caller's DEFINE mode.
4PCREATOPT^DEFOVERRIDE
Ignore the value of the caller's inherited force-low PIN attribute.
Otherwise, use the value of the caller's inherited force-low PIN attribute.
32PCREATOPT^FRCLOWOVER
Require low PIN (in range 0 through 254). Otherwise, assign any PIN.1PCREATOPT^LOWPIN
If you specify ZSYS^VAL^PCREATOPT^LOWPIN, the program is run at a low PIN. If you do
not specify ZSYS^VAL^PCREATOPT^LOWPIN, the program runs at a PIN of 256 or higher if
its program file and library file (if any) have the HIGHPIN program-file flag set and if a high
PIN is available. However, if the calling process has the inherited force-low attribute set, the
new process is forced into a low PIN even if all the other conditions for running at a high PIN
are met. For further information on compatibility, see the Guardian Programmer's Guide and
the Guardian Application Conversion Guide. See also DEFINE Considerations (page 1075) for
more information on DEFINEs.
Z^NAME^OPTIONS
specifies whether the process is to be named and, if so, whether the caller is supplying the
name or the system must generate it.
This table summarizes the possible values for Z^NAME^OPTIONS. 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.
One of these values must be supplied:
DescriptionValueName (ZSYS^VAL^)
Process is named; name is the same as that of the caller. This option is
used only for the creation of the caller's backup process
3PCREATOPT^CALLERSNAME
Process is named; the system must generate a name. The generated name
is four characters long.
2PCREATOPT^NAMEDBYSYS
Process is named; the system must generate a name. The generated name
is five characters long.
4PCREATOPT^NAMEDBYSYS5
Process is named; name is supplied in Z^PROCESS^NAME.1PCREATOPT^NAMEINCALL
Process is not named; it can be named if the RUNNAMED program-file
flag is set.
0PCREATOPT^NONAME
If either the program file or the library file (if any) has the RUNNAMED program-file flag set,
the system generates a name. The generated name is four characters long, unless
Z^NAME^OPTIONS is ZSYS^VAL^PCREATOPT^NAMEDBYSYS5. In which case, the name
is five characters long.
To create a backup process, set Z^NAME^OPTIONS to 3, Z^PROCESS^NAME^LEN to 0,
and Z^PROGRAM^NAME^LEN to 0.
Z^DEBUG^OPTIONS
sets the debugging attributes for the new process.
This table summarizes the possible values for Z^DEBUG^OPTIONS. 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.
1058 Guardian Procedure Calls (P)