GSCD call
The Get System Contents Directory (GSCD) call retrieves the address of the IMS™ system contents directory (SCD) for batch programs.
This topic contains Product-sensitive Programming Interface information.
Format
>>-GSCD--+-i/o_pcb-+--i/o_area--------------------------------->< '-aib-----'
| Call Name | DB/DC | DBCTL | DCCTL | DB Batch | TM Batch |
|---|---|---|---|---|---|
| GSCD | X | X |
Parameters
- i/o pcb
- Specifies the PCB, the first PCB address in the list passed to the program, to use for this call. This parameter is an input and output parameter.
- aib
- Specifies the address of the application interface block (AIB)
that is used for the call. This parameter is an input and output parameter.
The following 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.
- AIBOALEN
- I/O area length. This field must contain the length of the I/O area that is specified in the call list.
- i/o area
- Specifies the I/O area to be used for the call. This parameter is an output parameter. For the GCSD call, the I/O area must be 8 bytes in length. IMS TM places the address of the SCD in the first 4 bytes and the address of the program specification table (PST) in the second 4 bytes.
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 DLI or DBB batch application programs.