Start of change

SQTHRESHOLD control statement

The SQTHRESHOLD statement specifies to monitor the primary queue usage and specifies a threshold for triggering a stop action. This statement is for queue overflow protection in shared-queues environments.

Syntax

Read syntax diagramSkip visual syntax diagram SQTHRESHOLD=(PERCENT= nn,ACTION=NONESTOP )

Usage notes

Only one SQTHRESHOLD statement can be specified. All additional SQTHRESHOLD statements after the first one are ignored.

If you omit the SQTHRESHOLD statement or if no IMS Queue Control Facility extensions PROCLIB member exists, then primary queue usage is not monitored.

Keywords

PERCENT=nn
The required PERCENT parameter specifies a percentage value of 00 - 99.

The value for PERCENT specifies how much of the total queue will be looked at for analysis. A PERCENT value of 00 disables processing of the SQTHRESHOLD statement.

ACTION=action
The ACTION parameter specifies one or more actions. The following keywords are available for variable action:
NONE
Takes no action.
STOP
Conducts a stop action, which can be one of the following:
  • For TYPE=APPL (applications), issues an A7 status code to the application
  • For TYPE=APPC (LU 6.2/APPC), issues a DFS0777 message to the MTO and deallocates the input terminal
  • For TYPE=OTMA, issues a NAK message to the client

WTO messages are also written to the job log of the control region or the dependent region.

End of change