(SYSLIB) Programming Reference Manual - Public Support Login ...

ID$–Identification Line Routine
11.2. PLUS Interface
ID$ can be called directly from PLUS programs. The data structure requirements for ID$
are described in 11.1.2. The calling sequence for ID$ is described in 11.2.2.
When ID$ is called from PLUS programs, the output is limited to a maximum of 10 lines
for the processor/program identification line(s).
11.2.1. Packet
PLUS programs that call ID$ do not need to supply a packet for ID$. Instead, the calling
program passes parameters to ID$, and ID$ builds the packet on the Automatic Storage
Stack (PLSSTACK).
The calling program must provide the following data entities:
• A buffer containing the ASCII processor/program description. It may be any length
up to ten times the maximum number of characters per line, minus the number of
characters needed for the date/time output fields. (Date/time fields require 41 or
fewer characters, depending on specified options.) The length of this buffer must be
passed to ID$ in character granularity.
• A buffer to contain the ASCII output from ID$. It must be long enough to contain the
entire output string (at most 41 characters longer than the description). ID$ will
space-fill this buffer to its end. The length of the buffer must be passed to ID$ in
word granularity.
• A 36-bit signed integer used to return error codes from ID$ to the calling program.
The above data entities must be declared LOCATABLE. These data entities are passed
to ID$ to create the identification line.
11.2.2. Calling Sequence
The following procedure declaration is required to call the ID$ routine. This procedure
must be declared by the calling program.
PROCEDURE ID_LINE( ID_OUTPUT_ADDRESS: 36 BIT MACHINE POINTER,
ID_OUTPUT_LENGTH: 36 BIT SIGNED INTEGER,
ID_NAME_ADDRESS: 36 BIT MACHINE POINTER,
ID_NAME_LENGTH: 36 BIT SIGNED INTEGER,
ID_DATE: 36 BIT MACHINE LOGICAL,
ID_OPTIONS: 36 BIT SIGNED INTEGER,
%ID_ERROR_CODE: 36 BIT SIGNED INTEGER)
IMPORTED (‘external-name’);
11–8 7833 1733–004