Developer Guide and Reference

ID 767251
Date 10/31/2024
Public
Document Table of Contents

Identification Specifier (ID=)

The identification specifier identifies a pending data transfer operation for a specified unit. It takes the following form:

ID=id-var

id-var

Is a scalar integer variable to be used as an identifier.

This specifier can only be used if the value of ASYNCHRONOUS=c-expr is 'YES'.

If an ID specifier is used in a data transfer statement, a wait operation is performed for the operation. If it is omitted, wait operations are performed for all pending data transfers for the specified unit.

If an error occurs during the execution of a data transfer statement containing an ID specifier, the variable specified becomes undefined.

The value assigned to id-var is processor dependent. If this value is zero, the data transfer has completed. A non-zero value is the identifier of the data transfer operation, and it is different from the identifier of any other pending data transfer for this unit. It can be used in a subsequent INQUIRE or WAIT statement to identify the particular data transfer.

In an INQUIRE statement, the ID= specifier identifies a pending asynchronous data transfer. It is used with the PENDING specifier to determine whether a specific asynchronous pending data transfer is completed.

An ID= specifier must not be specified for a child I/O statement.