GU call

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.

Call format

The following example shows the format of the GU call in COBOL:

CALL 'CBLTDLI' USING GU, asampcb, asamarea, rsa

Call parameters

The following parameters are valid on the GU call:

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

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.

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.

AH

The application program issued a GU call without a valid RSA, or the RSA parameter was not included in the call.

AI

AR/CTL could not open the data set.

AJ

The RSA contains an invalid parameter.

AM

The request is invalid for this data set.

AO

An I/O error occurred during data set processing.

GB

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.

 

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