Guardian Procedure Calls Reference Manual (G06.25+)

Guardian Procedure Calls (S)
Guardian Procedure Calls Reference Manual—522629-013
14-20
SEGMENT_ALLOCATE_CHKPT_ Procedure
If the process terminates without deallocating the segment, any data still in
memory is written back out to the file. Unless the segment is extensible,
SEGMENT_ALLOCATE_CHKPT_ must be able to allocate a sufficient number
of file extents to contain all memory in the segment.
•
New permanent swap file
If supplied, if
length is not 0, and if filename does not exist, specifies the
name of a swap file to be created. If used, the value of
filename must be
exactly
length bytes long. Remote file names are not accepted.
The advantage of using a permanent swap file is that the segment becomes a
permanent repository of data.
If the process terminates without deallocating the segment, any data still in
memory is written back out to the file. Unless the segment is extensible,
SEGMENT_ALLOCATE_CHKPT_ must be able to allocate a sufficient number
of file extents to contain all memory in the segment.
•
Segment sharing by the file name method
By specifying
filename, you can share the segment associated with this
swap file with another process using the same swap file (provided that both
processes have appropriate permission to the file). This is referred to as
segment sharing by the file-name method. Two processes sharing a segment
by the file-name method must be in the same processor, unless the segment is
a read-only segment. (See Considerations
on page 14-15 for
SEGMENT_ALLOCATE_.)
error-detail output
INT .EXT:ref:1
returns the error detail information returned from the backup process’s call to
SEGMENT_ALLOCATE_, or one of the following file-system errors:
2 = Segment is not allocated by the primary or the segment ID is
invalid.
30 = No message-system control blocks are available.
31 = There is no room in the process file segment (PFS) for a message
buffer in either the backup or the primary.
201 = Unable to send to the backup
See the description of the
error parameter under the SEGMENT_ALLOCATE_
procedure for information about the
error values for which detail information can
be returned here.