GET
Format
Purpose
Use the GET macro to retrieve a record from a VSAM file and place it in either an I/O buffer or a work area.
This discussion of the GET macro deals only with those matters that involve GCS.
Parameters
- RPL
- Specifies the address of the request parameter list (RPL) associated with your GET request. This is the same request parameter
list that you defined through the RPL macro. See RPL.
You can write this parameter as an assembler program label or as register (1) through (12).
Usage
- Each time you enter the GET macro, you must provide the system with a 72-byte save area. Before you enter the macro, place the address of this save area in register 13.
- See Using VSAM.
Return Codes and ABEND Codes
When this macro completes processing, it passes to the caller a return code in register 15. If register 15 contains 8 or 12, then the specific error is indicated in the FDBK field of the appropriate RPL. This field can be displayed through the SHOWCB or TESTCB macros. See SHOWCB or TESTCB.
|
Hex
Code |
Decimal
Code |
Meaning
|
|---|---|---|
| X'00' | 0 | Your request was accepted. |
| X'04' | 4 | Your request was not accepted because the RPL you specified in the GET macro is already active for another request. |
| X'08' | 8 | A logical error occurred. |
| X'0C' | 12 | A physical error occurred. |
| ABEND Code | Meaning |
|---|---|
| 035 | An error occurred in the GET macro. The message preceding the ABEND describes this further. |
| 03B | An invalid address was found in a VSAM control block or a VSAM parameter list. This means that your program tried to use an address to which it has no access. |
| 03B | You specified a TYPE parameter of CHK or DRBA, and those parameters are not supported. |