Guardian Programmer's Guide

Using the Sequential Input/Output Procedures
Guardian Programmer’s Guide — 421922-014
15 - 7
Setting Up the SIO Data Structures
Preparing the SIO File Control Blocks
Use a DEFINE named ALLOCATE^FCB or a DEFINE named ALLOCATE^FCB^D00 to
set up an FCB for each file that the SIO procedures will access.
Use ALLOCATE^FCB^D00 for $RECEIVE and the common FCB. The created FCB
will identify its opener by process handle.
Use ALLOCATE^FCB for all files other than $RECEIVE and the common FCB.
You must specify the following information each time you use a DEFINE to allocate an
FCB:
•
The name of the FCB. This name is used to refer to the file in other SIO procedure
calls.
•
A physical file name that the FCB will default to.
The physical file name is 12 words long. These 12 words can contain either a string
that is to be substituted or a complete file name. A string for substitution can be
replaced by the input file name from the Startup message, the output file name from
the Startup message, the home terminal name, or a temporary file name. The
following substitution strings are valid:
•
To substitute the input file name from the Startup message, use the following
string:
•
To substitute the output file name from the Startup message, use the following
string:
Note. These DEFINE calls must immediately follow the ALLOCATE^CBS^DOO DEFINE call,
and they must allocate space for exactly the number of DEFINES specified in the
ALLOCATE^CBS^D00 DEFINE call.
VST065.VSD
VST066.VSD