Skip to content
CA TPX™ Session Management - 5.4
Documentation powered by DocOps

QUIESCE Command

Last update March 21, 2016

Contents

The QUIESCE command halts all activity for a particular application, VSAM file, or for the entire region.

When you issue the QUIESCE command for an application or for the region, no new sessions to the specified application or region will be allowed. Existing sessions remain active. You can specify a shutdown time when all active sessions or the application will be inactivated automatically.

When you issue the QUIESCE command, the software notifies all affected users of the quiesce and impending shutdown time (if you specified one).

You can use the command to quiesce a VSAM file when you are performing maintenance on the file with a program like CA-L-Serv.

When you enter the Quiesce command for an application, a Q/S will appear on the main menu (TEN0041) to indicate that the application is in a Quiesce state. A session can not be established with this application until the application is placed in an active state by the TPXOPER administrator.

Format

The QUIESCE command has the following syntax:

->>--- Q ------ applid ------------------------------------------------------><
            |-- ALL --------|     |-- ,SHUT= ----- minutes --|
            |-- TPX --------|     |            +-- hh:mm ----|
            |-- EXIT=userexit|
            +-- FILE=file --+     +-- ,SYSID=tpxappl --------|
                                            +-ALL------------+

Operand Explanations

The QUIESCE command has the following operands:

applid
Specifies the application to be quiesced.

ALL
Indicates that all applications are to be quiesced.

TPX
Indicates that CA TPX and all applications are to be quiesced. When operating as a generic resource, the software will disassociate itself with the generic resource name.

FILE=file
Specifies a VSAM file that is to be marked as quiesced. The file will be quiesced until it is activated with the ACT command. Possible values for file are ADMIN1, ADMIN2, NOTES, MAIL, or VIEW.
The SHUT operand cannot be used with the FILE= operand.

SHUT
Indicates that all active sessions to the application or the product will be inactivated automatically after a designated interval or at a designated time. This operand is not valid when using the FILE=file operand.

minutes
Specifies the interval between the time the QUIESCE command is issued and the time the specified application or CA TPX is inactivated. This operand is not valid when using the FILE=file operand.

hh:mm
Specifies the time when the specified application or CA TPX is automatically inactivated. This operand is not valid when using the FILE=file operand.

SYSID=tpxappl
Identifies a specific instance of CA TPX on which the command is to be executed. For details, see the Operand Explanations for the ACTIVATE command.

SYSID=ALL
Identifies all instances of CA TPX, within the Generic pool, on which the command is to execute.

EXIT=userexit
Specifies a user exit name that is marked as quiesced. The exit is quiesced until it is activated with the RELOAD EXIT= command. The DISPLAY EXIT command can also be used to activate or inactive a user exit. The SHUT operand cannot be used with the EXIT= operand.

Note: Only use the EXIT=userexit command to stop a malfunctioning exit from being invoked.

Usage Information

If you use the applid operand without specifying a shutdown time, the application will not be quiesced until all active users have logged off the application. A reload of the ACT can be performed successfully only when the application has the QUIESCED status.

Example

To quiesce all applications at 9:00 p.m. issue the following command:

Q ALL,SHUT=21:00

As soon as this command is issued, no new application sessions will be allowed. At 9:00 p.m. all existing application sessions will be inactivated.

Was this helpful?

Please log in to post comments.