GN call
Use the GN call to get (read) the next sequential record from an ASAM data set.
If this call is the first request for a record, AR/CTL opens the data set.
asampcb | Required. The ASAM PCB. This PCB is defined in the ASB or PSB. |
|---|---|
asamarea | Required. The name of the ASAM I/O area that contains the data retrieved from or written to the ASAM data set. For more information, see ASAM-I-O-area. |
rsa | Optional. The name of a field containing the record search argument (RSA). Include this parameter to request the RSA for the record. If the FCB was generated with the WRITERSA=NO keyword and the data set resides on DASD, AR/CTL returns the RBN instead of the TTR or the RBA. The RBN cannot be used with the GU call if the data set resides on DASD. For more information, see Record-search-arguments. |
blank | The call worked correctly. The I/O area contains the requested data. |
|---|---|
AD | A call function is invalid. |
AF | The data set contains variable length records, and the record contains an invalid length field. |
AI | AR/CTL could not open the data set. |
AM | The request is invalid for this data set. |
AO | An unrecoverable I/O error has occurred for the file. |
GB | AR/CTL has reached the end of the input data set. If the application program issues another get request, AR/CTL reads the first record in the data set. |