End CICS (ENDCICS)
Where allowed to run:
|
Parameters Examples Error messages |
The End CICS (ENDCICS) command will shut down a CICS control region and specifies what happens to active work being processed by that CICS control region.
All associated CICS shells (user or batch) must be shut down before the CICS control region can complete the shut down. The CICS user shells are informed of the involuntary shut down. Refer to the ENDCICSUSR CL command in order to shut down a CICS user shell without shutting down the CICS control region.
No new CICS shells can be started, that would be associated with the CICS control region being shut down, after this command is executed.
| Top |
Parameters
| Keyword | Description | Choices | Notes |
|---|---|---|---|
| CTLRGN | Control region | Communications name, CICS | Optional, Positional 1 |
| OPTION | How to end | *CNTRLD, *IMMED | Optional, Positional 2 |
| DELAY | Delay time, if *CNTRLD | 1-99999, *NOLIMIT | Optional, Positional 3 |
| Top |
Control region (CTLRGN)
The name of the CICS control region to be shut down. This can be obtained from your CICS System Administrator. The name of the CICS control region is also known as the CICS SYSID.
- control-region: The first character must be alphabetic, or one of the special characters, $, @, or #. The remaining characters can be alphanumeric or one of the special characters, $, @, or #.
| Top |
How to end (OPTION)
Identifies the method used to shut down the CICS control region.
The possible OPTION values are:
- *CNTRLD: All associated CICS shells are automatically shut down when they are idle or the CICS transaction that is currently executing is completed.
- def.*IMMED: All associated CICS shells are shut down immediately, meaning that any CICS transactions that are executing are not allowed to perform any cleanup. This option might cause undesirable results and, therefore, should be used only after a controlled shut down has been attempted unsuccessfully.
| Top |
Delay time, if *CNTRLD (DELAY)
Indicates the amount of time (in seconds) that is allowed to complete the controlled CICS control region shut down. If this amount of time is exceeded and the CICS control region shut down is not complete, all associated CICS shells associated with the CICS control region are ended.
The possible DELAY values are:
- *NOLIMIT: The amount of time in which to complete a controlled shut down is not limited.
- def.delay-time: Valid values range from 1 through 99999.
| Top |
Examples
None| Top |
Error messages
Unknown| Top |