TRANSMIT condition

An input/output condition indicating that transmitted data is potentially incorrect.

Enabled/Disabled status

Always enabled.

Result

Indicates that any data transmitted is potentially incorrect.

Raised

After transmission when an uncorrectable transmission error occurs during any input/output operation for a record or record block.

If records are blocked, TRANSMIT is raised on input for each subsequent record in the block, and on output when the block is complete.

On a spanned record, TRANSMIT is raised on the last segment of a record only. It is not raised for any subsequent records in the same block; however, this is not an indication that subsequent records are not affected.

Restriction

  • If a file is closed in an ON-unit for the RECORD 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.

Note

An uncorrectable transmission error can be caused by a damaged recording medium, or by incorrect specification or setup.

Syntax

TRANSMIT file-reference

Parameter

file-reference
A scalar file reference.

Other Information

Condition codes
40-46
Implicit action
Prints a message and raises the ERROR condition.
Normal return
Continues processing as though no error had occurred, allowing another condition (for example, RECORD) to be raised by the statement or data item that raised the TRANSMIT condition. Can also be undefined. See Restriction above.