To remove connections from an application server, enter the CICS CIRR transaction. The CIRR transaction has four parameters:
>>-CIRR----+-,---------+---+-,-----+---+-,---------+------------>
'-password,-' '-mode,-' '-interval,-'
(1)
.-Default_server-----------------------.
>-----+--------------------------------------+-----------------><
+-server_name--------------------------+
| .-,--------------. |
| V | |
'-(-+---+-----server_name---+---+---+--'
'-,-' '-)-'
Notes:
|
The parameters are described below. For the syntax rules of the transactions, see Using Syntax Rules for DB2 Server for VSE CICS Transactions.
The parameters have the following meanings:
| Note: | The PASSWORD, MODE and INTERVAL parameters have the same meanings as on the CIRT command. |
| Parameter | Default | Description |
|---|---|---|
|
PASSWORD (positional parameter 1) | SQLDBAPW | This parameter establishes the operator's authority to stop the online access to the application server. It must be the same password that was supplied for the server by the CIRB or CIRA transaction. See Password Implications on Online Resource Adapter Termination for more details. |
|
MODE (positional parameter 2) | NORMAL | This parameter establishes the shutdown mode: NORMAL or QUICK. When you specify NORMAL, the CIRR transaction prevents new online users from accessing the specified application server. Users who are already doing work, however, can finish. When all users complete their work, no online users can use the specified application server. When you specify NORMAL for a remote application server, the shutdown of the access to the remote application server will complete only when all conversations to the remote application server have been deallocated. When you specify QUICK for a local application server, online access is ended immediately. Online users cannot finish their work. Their current logical units of work are rolled back (unless they are already processing a COMMIT WORK). You can change from NORMAL to QUICK. However, once the MODE is QUICK, you cannot change it back to NORMAL. When you specify QUICK for a remote server, the QUICK mode is changed to NORMAL. |
|
INTERVAL (postitional parameter 3) |
30 (seconds) |
The number of seconds that the CIRR transaction should delay before freeing
the terminal. The value must be an integer value between 0
and 3600. This parameter controls the availability of the CICS terminal
(or operator console) after you issue the CIRR transaction.
The CICS terminal (or VSE operator console) used to activate the CIRR transaction is unavailable until the transaction ends. This could be a long time if the online application is long-running or if a user left without correctly ending the terminal session. If you enter CIRR PASSWORD,NORMAL, the terminal is not available until all online users complete their work. The value you specify for interval represents an interval of
time measured in seconds. If the CIRR transaction does not finish
immediately, it waits the amount of time you specify. When this time
ends, the CIRR transaction tries once again to finish processing. If
the CIRR transaction does not finish successfully, you receive a message
telling you to retry the CIRR transaction later. After issuing the
message, the CIRR transaction ends. The shutdown mode is still in
effect (the application server is in the process of shutting down), and the
terminal is available for your use.
|
|
SERVER_NAME (positional parameter 4) |
Determined by CIRB or CIRC transaction. | This parameter enables you to specify the application servers that you want to remove access. The default server is removed if this parameter is omitted, or if the first parameter in the server_name list is blank. The default server is the one that was established by the CIRB transaction or by the CIRC transaction. |
The CIRD transaction may be used to display the default server_name in case the user does not know what the default server_name is.
Figure 18. Example of CIRR with Defaults
msg f2
AR 015 1I40I READY
2 cirr
F2-002 ARI0455I Connections to SQLMACH1 are disabled.
F2-002 ARI0460W Connections to the default server SQLMACH1 have
been disabled.
The above example assumes that there are connections and/or access to more than one server when the CIRR transaction is entered.
If the password, mode and interval are the same then the server_name list can be used to remove connections from multiple application servers. Since SQLVM was the last active connection, the online resource adapter was terminated.
Figure 19. Example of CIRR with Server_Name List
msg f2 AR 015 1I40I READY 2 cirr ,,,(sqlmach2,sqlmach8,sqlvm) F2-002 ARI0455I Connections to SQLMACH2 are disabled. F2-002 ARI0455I Online access to SQLMACH8 is disabled. F2-002 ARI0455I Connections to SQLVM are disabled. F2-002 ARI0413I Resource Adapter ARI0OLRM is disabled. |
The CIRR transaction can be used to remove the connections to a local application server that was established by the CIRB and CIRA transactions. It can also be used to disable online access to a remote application server. If CIRR removes the last active connections to the online resource adapter and all active APPC conversations known to the online resource adapter are deallocated, then the online resource adapter is terminated. The CIRB transaction would have to be used to restart it.
The CIRA and CIRR transactions can be entered repeatedly and in any order to add and remove links to application servers as required.
If CIRR is entered to remove connections to a server to which no connections have been established, the message "ARI0456I Connections to <server_name> do not exist." is displayed.
If the password given on the CIRR transaction does not match the password that was used to start the connections to the named server, then the connections to that server are not shut down and processing continues with the next server in the list.