OBTAIN macro - is type 3, gets LOCAL lock.
Calls module IGC0002G.
GTF data is:
- R15 and R0
- No applicable data.
- R1
- Address of the parameter list.
- PLIST
- Parameter list is 16 bytes long; format is:
- Bytes
- Contents
- 0-1
- Operation code. X'C100' SEARCH for DSNAME; X'C080' SEEK for track
address.
- 2
- Option byte.
| Bits |
Description |
|---|
| 1... |
.... |
Bypass TIOT ENQ, enqueued by caller |
| .1.. |
.... |
Do not build a dummy format-1 DSCB |
| ..1. |
.... |
Do not allocate catalog in obtains
address space |
| ...1 |
.... |
Authorized caller wants name hiding |
| .... |
1... |
EADSCB=OK keyword is specified |
- 3
- Number of DSCBs. The number of 140-byte DSCBs consecutive
return areas that are provided in bytes 12-15. When this value is
zero, one 140-byte return area must be provided.
- 4-7
- Address of the data set name or address of the track address of
the DSCB (CCHHR) depending on the operation code.
- 8-11
- Address of the volume serial number.
- 12-15
- Address of a 140-byte work area or address of consecutive 140-byte
return areas as described by byte 3.
| VOLSER |
cccccc |
volume number of an associated volume. |
| DSN/CCHHR |
ccccc... |
data set name (displayed when the operation code in word 1
of the parameter list indicates SEARCH), or track address (displayed
when the operation code in word 1 of the parameter list indicates
SEEK). |