PRINTOPREPLY [ MPE/iX Intrinsics Reference Manual ] MPE/iX 5.0 Documentation
MPE/iX Intrinsics Reference Manual
PRINTOPREPLY
NM and CM callable.
Prints a character string on the system console and solicits a reply.
Syntax
________________________________________________
| |
| I16 CA I16V I16V |
| length:=PRINTOPREPLY(message,length,zero,|
| CA I16V |
| reply,maxlength); |
________________________________________________
Functional Return
length 16-bit signed integer (assigned functional return)
Passes the length of the reply from the system
operator. This length represents a half word count
if maxlength is positive or a byte count if
maxlength is negative.
If maxlength is zero, then this intrinsic does not
solicit a reply.
If an error occurs, the value returned is zero.
The length parameter can be zero, in which case
only the standard message prefix is written on the
system console . If both length and maxlength are
zero, then CCL (1) is returned.
Parameters
message character array (required)
Passes the characters that are output to the system
console. The character string is limited to 50
characters, additional characters are ignored.
length 16-bit signed integer by value (required)
The length of the output string to be transmitted.
If length is positive, the length is in half words;
if negative, the length is in bytes. Do not
specify a length of >50 bytes.
zero 16-bit signed integer by value (required)
Do not specify this parameter, but maintain
parameter position with a value of 0.
reply character array (required)
Returns the input characters read from the system
console.
maxlength 16-bit signed integer by value (required)
The maximum length of the message to be read into
the reply parameter. If the expected length is
positive, it specifies a half word count; if
negative, it specifies a byte count. Do not
specify a length of >31 bytes.
Condition Codes
CCE (2) Request granted.
CCG (0) Not returned.
CCL (1) Request denied. A physical I/O error occurred.
Further error analysis through the FCHECK intrinsic
is not possible.
Related Information
Intrinsics None
Commands None
Manuals Accessing Files Programmer's Guide (32650-90017)
MPE/iX 5.0 Documentation