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

Section 11
ID$–Identification Line Routine
ID$ provides the calling program with an identification line or lines for any processor or
program. ID$ identifies the processor called and the time it was called. The information
in the identification line consists of a processor/program description, an optional date of
creation and time for the processor/program, and the current (execution) date and time.
The System Standard Format Date and Time (SFDT$) routine formats the dates and
times. All output is in ASCII.
ID$ can be called from both MASM and PLUS programs. ID$ is available as a relocatable
element in the SYSLIB file SYS$LIB$*SYSLIB and also in the SYSLIB common bank
SYSLIB$1. The relocatable and common bank entry points for ID$ are listed in
Appendix E.
ID$ Output
The format of the identification line is
Processor/program description (creation date and time) execution date and
time
where:
Processor/program description
The calling program provides this field; it can contain any number of ASCII
characters. There are two methods to specify the description.
• A separate buffer may contain the description; the address and length in
characters are passed to ID$.
• The description can be specified as a string on the I$DPKT procedure call that
sets up the ID$ packet.
Creation date and time
ID$ obtains the date and time that the calling program was created from the
Collector-supplied values for D$ATE and T$IME. ID$ places the date and time in
parentheses using the following format: (YYMMDD HHMM:SS). Date and time are
separated from the last character of the description by one space. This field can be
excluded from the ID$ output.
7833 1733–004 11–1