gtps1m4eSystem Macros

QGDSQ-Query General Data Set (GDS) Input/Output (I/O) Queue

Use this system macro to determine the number of input/output (I/O) requests that are queued to the device that is associated with a general data set (GDS) mounted to the TPF system.

Required Authorizations
Key0 Restricted System Common Storage
    X  

Format




label
An optional label can be used with this macro.

DSB
This parameter specifies if the first data set control block (DSCB) address that is associated with the input data set name will be returned in register 1 (R1) when macro processing is completed successfully.

NO
This parameter indicates that the first DSCB address is not returned to the caller.

YES
This parameter indicates that the first DSCB address is returned to the caller.

Entry Requirements

Return Conditions

Programming Considerations

If multiple data sets are on the device, the queue count that is returned includes all queued requests for all data sets on the device.

Examples

In the following example, a QGDSQ macro request is made to get the number of I/O requests that are queued for a device that is associated with an input data definition (DD) name of 'INPUTDDNAME'. The first DSCB that is associated with the data set is returned to the caller.


  ·
  ·
  ·
LA R1,INPUTDD Point to DDNAME for data set QGDSQ DSB=YES Check DDNAME and count of requests LTR R0,R0 Successful return? BM NOT MOUNTED No, data set not mounted BZ NO_REQUESTS Yes, but no queued requests Otherwise I/O requests queued... R0 contains the count of requests R1 points to first DSCB for data set
  ·
  ·
  ·
INPUTDD DC CL16'INPUTDDNAME' DDName to query
  ·
  ·
  ·