Use this system macro to:
- Maintain a control structure for general data sets (GDSs)
- Locate, add, and delete data sets, volumes, and data definition names from
the GDS storage structure
- Inquire about data sets, volumes, and data definition names.
Format
- label
- A symbolic name can be assigned to the macro statement.
- TYPE
- The object that is being acted upon. Valid values are:
- DDN
- A 16-character data definition name (DDNAME)
- VOL
- A volume number
- DSN
- A data set name (DSNAME)
- DSCB
- A data set control block (IDSDSB)
- VCB
- A volume control block (IDSDSB).
- ACTION
- The action to be performed. Valid values are:
- INQ
- Retrieve information about a specific DDNAME from the GDS control
structure. The valid type is DDN.
This value of the ACTION parameter is available for general use.
- P1=address
- The address of the DDNAME for which information is to be retrieved.
The DDNAME field must be 16 bytes in length and be padded on the right with
blanks.
- P2=address
- The address of a control block, as defined in the IDSINQ macro, that is to
be used by the TPF system to return information about the specified
DDNAME.
- ADD
- Add the specified control block to the GDS structure. Valid type
codes are DSCB or VCB.
This value of the ACTION parameter is restricted to system only use.
- P1=address
- The address of the DSCB/VCB (IDSDSB) block to be added.
- P2=address
- Not used
- DEL
- Delete specified control information from the GDS control
structure. The valid types are DDN or VOL.
This value of the ACTION parameter is restricted to system only use.
- P1=address
- The address of the DDNAME to be acted on for types DDN and VOL. The
DDNAME field must be 16 bytes in length and be padded on the right with
blanks.
- P2=address
- The address of a fullword volume number is required for type VOL.
- LOC
- Locate specified control information for the specified input. Valid
types are DDN, VOL, or DSN.
This value of the ACTION parameter is restricted to system only use.
- P1=address
- The address of the DDNAME or DSNAME to be acted on for types DDN, DSN, and
VOL. The DDNAME field must be 16 bytes in length and be padded on the
right with blanks. The DSNAME field must be 44 bytes in length and be
padded on the right with blanks.
- P2=address
- The address of a fullword volume number for type VOL.
Entry Requirements
R9 must contain the address of the ECB being processed.
Return Conditions
- Control is returned to the next sequential instruction (NSI).
- R14 contents is dependent on the action code.
- Action Code
- Description
- ADD
- The address of the system block for the DSCB for type DDN, DSN, or
DSCB.
The address of the system block for the VCB for type VOL or VCB.
- DEL
- The remaining count of mounted data set volumes.
- INQ
- Unpredictable.
- LOC
- The address of the system block for the DSCB for type DDN or DSN.
The address of the system block for the VCB for TYPE or VOL.
- R15 contains the return code.
Information about the ADD, DEL, and LOC action codes follows.
- Action Code
- Description
- 0
- If successful.
- 4
- If the name was not found.
- 8
- If the volume was not found.
- 12
- If there was a logic error.
Information about the INQ action code follows.
- Action Code
- Description
- 0
- If successful.
- 4
- If the name was not found.
Programming Considerations
When the ADD, DEL, or LOC actions are performed, this macro can be run only
on the main I-stream. When the INQ action is performed, this macro can
be run on any I-stream.
Examples
None.