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.
| The following example shows the ISRT call in COBOL: CALL 'CBLTDLI' USING ISRT, asampcb, asamout, rsa |
|---|
| The following parameters are valid on the ISRT call: | Required. The PCB. This PCB is defined in the ASB or PSB. |
|---|
| 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. |
|---|
| 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. |
|---|
| The call worked correctly. The data has been added to the data set. |
|---|
| A call function is invalid. |
|---|
| AR/CTL could not open the data set. |
|---|
| The request is invalid for this data set. |
|---|
| An I/O error occurred during data set processing. |
|---|
| 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. |
|---|
| The data set contains variable length records, and the record contains an invalid length field. |
|---|
|
|---|
