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.
The QUIESCE command has the following syntax:
->>--- Q ------ applid ------------------------------------------------------>< |-- ALL --------| |-- ,SHUT= ----- minutes --| |-- TPX --------| | +-- hh:mm ----| |-- EXIT=userexit| +-- FILE=file --+ +-- ,SYSID=tpxappl --------| +-ALL------------+
The QUIESCE command has the following operands:
Specifies the application to be quiesced.
Indicates that all applications are to be quiesced.
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.
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
fileare ADMIN1, ADMIN2, NOTES, MAIL, or VIEW.
The SHUT operand cannot be used with the FILE= operand.
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=
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=
Specifies the time when the specified application or CA TPX is automatically inactivated. This operand is not valid when using the FILE=
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.
Identifies all instances of CA TPX, within the Generic pool, on which the command is to execute.
EXIT=userexitSpecifies 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.
Only use the EXIT=userexit command to stop a malfunctioning exit from being invoked.
If you use the
applidoperand 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.
To quiesce all applications at 9:00 p.m. issue the following command:
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.