Asynchronous Serial Communications Programmer's Reference Manual (32022-90052)

274 Chapter9
Intrinsics Reference (cont)
PRINT
PRINT
Prints a character string on job/session list device.
Syntax
CA I16V I16V
PRINT(message,length,controlcode);
Use
The PRINT intrinsic enables you to write a string of ASCII characters
from your program to the job/session listing device ($STDLIST). This
provides a quick method of sending output to the terminal. However,
because the PRINT intrinsic does not allow you to take full advantage
of the capabilities of the file system, it is recommended that you use
FWRITE for permanent programs.
Parameters
message character array (required)
Passes the string of ASCII characters to $STDLIST.
Note that all character arrays must start on a halfword
boundary.
length 16-bit signed integer by value (required)
The length of the character string to be passed in
message. If length is positive, the length is in
halfwords. If length is negative, the length is in bytes. If
length exceeds the configured record length of the
device, successive records are written only on
terminals.
controlcode 16-bit signed integer by value (required)
A carriage control directive. See Table 9-3 for a list of
valid codes.
Condition Codes
CCE Request granted.
CCG End-of-data was encountered.
CCL Request denied. An input/output error occurred.
Further error analysis through the FCHECK intrinsic
is not possible.