Guardian Procedure Calls Reference Manual

CHECKALLOCATESEGMENT Procedure (Superseded by
SEGMENT_ALLOCATE_CHKPT_ Procedure)
Summary
Syntax for C Programmers
Syntax for TAL Programmers
Parameters
Condition Code Settings
Considerations
Summary
NOTE: This procedure is supported for compatibility with previous software and should not be
used for new development.
The CHECKALLOCATESEGMENT procedure allocates a selectable extended data segment for use
by the backup process in a process pair. It is called from the primary process.
Although it is possible to share flat segments meant for use by the backup process in a process
pair using the CHECKALLOCATESEGMENT procedure, flat segments can be allocated for this
purpose only with the SEGMENT_ALLOCATE_CHKPT_ procedure. SEGMENT_ALLOCATE_CHKPT_
can also allocate selectable segments for use by the backup process in a process pair.
Syntax for C Programmers
This passive backup procedure is not supported in C programs. For a comparison of active backup
and passive backup, see the Guardian Programmer's Guide.
Syntax for TAL Programmers
CALL CHECKALLOCATESEGMENT ( segment-id ! i
,[ file-name ] ! i
,[ pin-and-flags ] ! i
,error ); ! o
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 these ranges:
can be specified by user processes.0-1023
are reserved for HP software.Other IDs
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
128 Guardian Procedure Calls (C)