GSCD call
A Get System Contents Directory (GSCD)
call retrieves the address of the IMS system
contents directory for batch programs.
This topic contains Product-sensitive Programming Interface information.
The ODBA interface does not support this call.
Format
| Call Name | DB/DC | DBCTL | DCCTL | DB Batch | TM Batch |
|---|---|---|---|---|---|
| GSCD | X | X |
Parameters
- db pcb
- Specifies the DB PCB for the call. This parameter is an input and output parameter.
- i/o pcb
- Specifies the I/O PCB for the call. This parameter is an input and output parameter.
- aib
- Specifies the AIB for the call. This parameter is an input and
output parameter. The these fields must be initialized in the AIB:
- AIBID
- Eye catcher. This 8-byte field must contain DFSAIBbb.
- AIBLEN
- AIB lengths. This field must contain the actual length of the AIB that the application program obtained.
- AIBRSNM1
- Resource name. This 8-byte, left-justified field must contain the PCB name, IOPCBbbb (if the I/O PCB is used), or the name of a DB PCB (if a DB PCB is used).
- AIBOALEN
- I/O area length. This field must contain the length of the I/O area specified in the call list.
- i/o area
- Specifies the I/O area, which must be 8 bytes long. IMS places the address of the system contents directory (SCD) in the first 4 bytes and the address of the program specification table (PST) in the second 4 bytes. This parameter is an output parameter.
Usage
IMS does not return a status code to a program
after it issues a successful GSCD call. The status
code from the previous call that used the same PCB remains unchanged
in the PCB.
Restrictions
The GSCD call
can be issued only from batch application programs.