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

Obsolete Entry Points, PROCs, and Routines
Normal Return
The output ID$ generates may be one or more lines; this depends on the length of the
processor/program description and specified options. For each line of ID$ output, a print
control word is constructed (line-spacing, image-length, image-address) and stored
sequentially in the ID$ packet starting with word 10. The number of print control words
constructed is stored in S6 or word 0 of the ID$ packet.
If the normal return occurs, the first print control word is returned in A0.
The following procedure simplifies printing of the ID$ output:
I$DPRINT pktaddr
where pktaddr is the address of the ID$ packet.
This procedure performs an APRINT$ for each print control word. It may be called from
the I$D PROC by setting option bit 4.
All output from ID$ is directed to the current print file.
Example of Calling ID$
The following example calls the ID$ routine to generate an ASCII identification line:
$ASCII
$INCLUDE ‘MAXR$’
$(0)
IDPAC I$DPKT ‘IDLINE$ ‘Math Quiz Program (Level 8)’026
$(1)
START I$D IDPAC . Generate and print the ID line
J ERROR . Jump ahead if error return
.
. (Program code)
.
J DONE . Program complete
ERROR L$SNAP ‘ID$’,2 . Dump the A-registers
DONE ER EXIT$
$END START
This MASM routine uses the ID$ routine to create and print the following identification
line:
Math Quiz Program (Level 8) 840425 1147:31
In this example, ID$ generates the ASCII identification line in the 11-word data area at
location IDLINE. The I$DPKT procedure generates the ID$ packet (see Example 2 in the
previous subsection).
J–12 7833 1733–004