ISRT call

Use the ISRT call to insert (add) a new record to the end of the ASAM data set.

If the FCB has requested output staging for the data set, AR/CTL can delay writing the record to the data set until the next CHKP call or termination.

Call format

The following example shows the ISRT call in COBOL:

CALL 'CBLTDLI' USING ISRT, asampcb, asamout, rsa

Call parameters

The following parameters are valid on the ISRT call:

asampcb

Required. The PCB. This PCB is defined in the ASB or PSB.

asamarea

Required. The name of the ASAM I/O area that contains the data to write to the ASAM data set. For more information, see ASAM-I-O-area.

rsa

Optional. The name of the field to receive the RSA from the call. If the WRITERSA=YES keyword is set in the FCB generation, the call can request that AR/CTL return the RSA for the added record by including the RSA parameter. If AR/CTL is staging output for a DASD data set, it returns the RBN instead of the RSA. It cannot return the TTR; therefore, the GU call is not valid for a staged-output DASD data set. For more information, see Record-search-arguments.

blank

The call worked correctly. The data has been added to the data set.

AD

A call function is invalid.

AI

AR/CTL could not open the data set.

AM

The request is invalid for this data set.

AO

An I/O error occurred during data set processing.

IX

The application program attempted to add a record to the data set after an I/O error occurred, or the data set is no longer open.

V1

The data set contains variable length records, and the record contains an invalid length field.

 

Tip: For faster searching, add an asterisk to the end of your partial query. Example: cert*