Guardian Procedure Calls Reference Manual (G06.25+)

Guardian Procedure Calls (C)
Guardian Procedure Calls Reference Manual—522629-013
3-26
CHECKALLOCATESEGMENT Procedure
(Superseded by SEGMENT_ALLOCATE_CHKPT_
Parameters
segment-id input
INT:value
is the number by which the process chooses to refer to the extended data
segment. Segment IDs are in the following ranges:
0-1023 can be specified by user processes.
Other IDs are reserved for HP software.
No process can supply a segment ID greater than 2047.
file-name input
INT .EXT:ref:12
if present, is the internal-format file name of a swap file to be associated with the
extended data segment. If the file exists, all data in the file is used as initial data
for the segment. If the file does not exist, one is created. Remote file names and
structured files are not accepted. If the process terminates without deallocating the
segment, any data still in memory is written back out to the file.
CHECKALLOCATESEGMENT must be able to allocate a sufficient number of file
extents to contain all memory in the segment.
The parameter can be a volume name with a blank subvolume and file;
CHECKALLOCATESEGMENT allocates a temporary swap file on the indicated
volume.
If you do not specify
file-name (and if a segment is not being shared using the
PIN method), CHECKALLOCATESEGMENT uses the volume of the data stack
swap file to create a temporary swap file for the new segment.
pin-and-flags input
INT:value
Defaults to %040000. Its values are:
<8:15> Optional PIN for segment sharing.
Requests allocation of a shared segment that is shared by the PIN
method. This value specifies the process identification number (PIN)
of the process that has previously allocated the segment and with
which the caller wants to share the segment. This value is not used if
bit 1 is set to 1 (see bit 1 later).
<5:7> Not used; must be zero (0).
<4> If 1, requests allocation of an extensible segment. An extensible
segment is an extended data segment for which the underlying swap
file disk space is not allocated until needed. In this case, the value of
segment-size allocated by the primary process is taken as a