Guardian Procedure Calls Reference Manual

Z^PFS^SIZE
if nonzero, specifies the size in bytes of the process file segment (PFS) of the new process. The
value is no longer meaningful; it is ignored. PFS size is 8 MB in G-series RVUs and 32 MB in
H-series and J-series RVUs.
Z^MAINSTACK^MAX
specifies the maximum size, in bytes, of the process main stack. The specified size cannot
exceed 32 megabytes (MB).
The default value of 0D, or 0F if using ZSYS^DDL^PLAUNCH^PARMS64, indicates that the
main stack can grow to 1 MB in the TNS/R environment and to 2 MB in the TNS/E environment.
For most processes, the default value is adequate.
Z^HEAP^MAX
for native processes only, specifies the maximum size, in bytes, of the process heap. Note that
the sum of the size of the heap and the size of global data cannot exceed 1.1 gigabytes (GB).
The default value of 0D, or 0F if using ZSYS^DDL^PLAUNCH^PARMS64, indicates that the
heap can grow to the default value of 1.1 gigabytes (GB) less the size of globals. The initial
heap size of a process is zero bytes. For most processes, the default value is adequate.
It is recommended that the value of Z^HEAP^MAX parameter be set to zero. The developer
then sets an appropriate value for Z^HEAP^MAX in the object file of the application depending
on the kind of application, the maximum memory required and the system configuration.
Z^HEAP^MAX then defaults to the value stored in the object file of the application to be
launched.
An outline of existing limitations:
Native C and C++ programs can have up to 1.1 GB of heap. CISC objects can have up to
127.5 megabytes (MB) of heap. However, other demands for memory space can deplete the
amount of memory available for heap.
Z^SPACE^GUARANTEE
specifies the minimum size, in bytes, of the amount of space that the process reserves with the
Kernel-Managed Swap Facility for swapping. For more information on this facility, see the
Kernel-Managed Swap Facility (KMSF) Manual. The value provided is rounded up to a page
size boundary of the processor. If the requested amount of space is not available,
PROCESS_LAUNCH_ returns error 55.
The default value of 0D, or 0F if using ZSYS^DDL^PLAUNCH^PARMS64, indicates that the
heap can grow to the default value of 1.1 gigabytes (GB) less the size of globals.
Z^CREATE^OPTIONS
provides information about the environment of the new process.
This table summarizes the possible values for Z^CREATE^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.
Valid values for Z^CREATE^OPTIONS are one or more of these:
DescriptionValueName (ZSYS^VAL^ )
Propagate DEFINEs in Z^DEFINES and DEFINEs in the caller's context.
In case of name conflicts, use the ones in Z^DEFINES. Otherwise,
propagate DEFINEs as specified by other values.
16PCREATOPT^ALLDEFINES
If the caller is named, the process deletion message, if any, will go to
whatever process has the calling process' name (regardless of sequence
number) at that time.
64PCREATOPT^ANYANCESTOR
The default value, which is described with each of the other options.0PCREATOPT^DEFAULT
See PCREATOPT^DEFOVERRIDE.2PCREATOPT^DEFENABLED
PROCESS_LAUNCH_ Procedure 1057