Use the GU call to get (read) a specific record from an ASAM data set.
If this call is the first request for a record, AR/CTL opens the data set. The call must identify the record to read with the RSA. The WRITERSA(YES) keyword must be set in the FCB generation.
| The following example shows the format of the GU call in COBOL: |
|---|
CALL 'CBLTDLI' USING GU, asampcb, asamarea, rsa
| The following parameters are valid on the GU call: | Required. The ASAM PCB. This PCB is defined in the ASB or PSB. |
|---|
| 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. |
|---|
| Required. The name of a field containing the RSA or the name of the field that is to receive the RSA from an ISRT call. The application program can use a special RSA, value 0000000100000000, to retrieve the first record in the data set. For more information, see Record-search-arguments. |
|---|
| The call worked correctly. The I/O area contains the requested data. |
|---|
| A call function is invalid. |
|---|
| The data set contains variable length records, and the record contains an invalid length field. |
|---|
| The application program issued a GU call without a valid RSA, or the RSA parameter was not included in the call. |
|---|
| AR/CTL could not open the data set. |
|---|
| The RSA contains an invalid parameter. |
|---|
| The request is invalid for this data set. |
|---|
| An I/O error occurred during data set processing. |
|---|
| AR/CTL has reached the end of the data set on input. If the application program issues another get request, AR/CTL reads the first record in the data set. |
|---|
|
|---|
