Rational Developer for System z
Enterprise PL/I for z/OS, Version 3.8, Language Reference Manual

RECORD condition

Status
RECORD is always enabled.
Result
The length prefix for the specified file can be inaccurately transmitted.
Cause and syntax
The RECORD input/output condition is raised if the specified record is truncated. The condition can be raised only during a READ, WRITE, LOCATE, or REWRITE operation.

If the SCALARVARYING option is applied to the file (it must be applied to a file using locate mode to transmit varying-length strings), a 2-byte length prefix is transmitted with an element varying-length string. The length prefix is not reset if the RECORD condition is raised. If the SCALARVARYING option is not applied to the file, the length prefix is not transmitted. On input, the current length of a varying-length string is set to the shorter of the record length and the maximum length of the string.

Read syntax diagramSkip visual syntax diagram>>-RECORD--(file-reference)------------------------------------><
 

The file-reference must be a scalar reference.

Implicit action
A message is printed and the ERROR condition is raised.
Normal return
Execution continues with the statement immediately following the one for which RECORD was raised.

If a file is closed in an ON-unit for this condition, the results of normal return are undefined. Exit from the ON-unit with the closed file must be achieved with a GO TO statement.

Condition codes
20-24

Terms of use | Feedback

This information center is powered by Eclipse technology. (http://www.eclipse.org)