Guardian Programmer's Guide

Communicating With a TACL Process
Guardian Programmer’s Guide — 421922-014
8 - 4
Obtaining Startup Information
The structure of the Startup message is shown below:
The maximum length of the Startup message is 596 bytes, including the trailing null
characters. The Startup message contains the following information:
•
The value -1 in the first word, which identifies the message as the Startup message
from the TACL process.
•
The default volume and subvolume names provided by the last execution of the
VOLUME command. Eight bytes each are provided for the volume and subvolume
names. The volume name must be no greater than seven characters long
(including the dollar sign) if a remote volume is specified as the default volume.
•
The input and output files supplied to the process by the RUN command. Eight
bytes each are provided for the volume, subvolume, and file ID parts of the name.
If the file is on a remote node, then the upper two bytes of the volume name
identify the system. The upper byte contains a backslash character (\), and the
second byte contains the node number. This leaves only six bytes for the volume
name. (The dollar sign, $, is not included in the volume name if the file is remote.)
To supply the network version of a file name in the Startup message, the volume
name must be no more that seven characters long (including the dollar sign).
Structure of the Startup message:
STRUCT CI^STARTUP;
BEGIN
INT MSGCODE; !word 0 – value -1
STRUCT DEFAULT;
BEGIN
INT VOLUME[0:3]; !word 1 – default volume
name
INT SUBVOL[0:3]; !default subvolume name
END;
STRUCT INFILE;
BEGIN
INT VOLUME[0:3]; !word 9 – IN parameter file
INT SUBVOL[0:3]; !name of RUN command
INT FNAME[0:3];
END;
STRUCT OUTFILE;
BEGIN
INT VOLUME[0:3]; !word 21 – OUT parameter file
INT SUBVOL[0:3]; !name of RUN command
INT FNAME[0:3];
END;
STRING PARAM[0:n-1]; !word 33 – parameter string
(if
END; !any) of RUN command