Guardian Procedure Calls Reference Manual (G06.25+)

Guardian Procedure Calls (C)
Guardian Procedure Calls Reference Manual—522629-013
3-28
CHECKALLOCATESEGMENT Procedure
(Superseded by SEGMENT_ALLOCATE_CHKPT_
error output
INT .EXT:ref:1
indicates the outcome of the call. This procedure returns all values returned by
ALLOCATESEGMENT in the backup, plus the following file-system errors:
2 Segment is not allocated by the primary, or segment ID is invalid
22 Bounds error on file name
29 The segment-id is missing
30 No message-system control blocks available
31 Cannot use the PFS, or there is no room in the PFS for a message buffer
in either the backup or the primary
201 Unable to LINK to the backup
Condition Code Settings
< (CCL) is set if the error parameter is missing, or there is a bounds error on the
error parameter.
= (CCE) is set by all other errors (see the
error parameter).
> (CCG) is never returned from this procedure.
Considerations
•
The segment-size parameter of ALLOCATESEGMENT is not supported
because the size of the primary process’s segment is used.
•
An extended data segment with the same segment ID must be previously allocated
in the primary process; that is, before the call to CHECKALLOCATESEGMENT.
•
If the file-name parameter is provided, that file name is used by
ALLOCATESEGMENT in the backup process; otherwise, no file-name parameter
is passed to ALLOCATESEGMENT in the backup process.
•
If the pin-and-flags parameter is omitted, the default value is used (%040000).
•
Be careful when using the pin-and-flags parameter. The flag settings should
be the same as the flag settings used when the extended data segment was
allocated by the primary process. CHECKALLOCATESEGMENT does not check
the flag settings; the information is no longer available.
If a PIN is specified, assign it carefully, because the PIN may not necessarily be
the same on the backup processor. You must determine the correct PIN for the
backup processor.
•
If the extended data segment is not read-only, the swap file name must be different
on the backup and primary processors because swap files cannot be shared