DB2 Server for VSE & VM: Operation

Stopping the Online Support

To end online support, enter the CICS CIRT transaction. The CIRT transaction has three parameters:

>>-CIRT----+-,---------+---+-,-----+---+-,--------+------------>< '-password,-' '-mode,-' '-interval-'

After the CIRT transaction is over, online access to the application server is not possible. The CIRT parameters are positional. Syntax rules are explained in Using Syntax Rules for DB2 Server for VSE CICS Transactions.

The parameters have the following meanings:

Parameter Default Description

PASSWORD
(positional
parameter 1)

SQLDBAPW This password 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 CIRA or CIRB 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 remote application servers are accessed by the online support, CIRT NORMAL will complete only when all conversations to the remote application servers are deallocated. When you specify NORMAL, the CIRT transaction prevents new online users from accessing the application server. Users who are already doing work, however, can finish. When all users complete their work, no online users can use the application server. When you specify QUICK, online access to local application servers is ended immediately. Online users accessing a local application server 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 remote application servers are accessed by the online support and you specify QUICK, online access to the remote application server is not ended immediately. Online users accessing a remore server can finish their unit of work, but cannot start a new logical unit of work.

INTERVAL
(positional
parameter 3)

30
(seconds)

The number of seconds that the CIRT transaction should delay before freeing the terminal. The value must be an integer value between 0 and 3 600. This parameter controls the availability of the CICS terminal (or operator console) after you enter the CIRT transaction.
The CICS terminal (or VSE operator console) used to activate the CIRT 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 CIRT PASSWORD,NORMAL, the terminal is not available until all online users complete their work. Even with CIRT PASSWORD, QUICK there may be some delay before the CICS terminal allows the CIRT terminal to complete its clean-up process.
The value you specify here represents an interval of time measured in seconds. If the CIRT transaction does not finish immediately, it waits the amount of time you specify. When this time ends, the CIRT transaction tries again to finish processing. If the CIRT transaction does not finish successfully, you receive a message telling you to retry the CIRT transaction later. After issuing the message, the CIRT 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.

Parameter	Default	Description
PASSWORD (positional parameter 1)	SQLDBAPW	This password 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 CIRA or CIRB 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 remote application servers are accessed by the online support, CIRT NORMAL will complete only when all conversations to the remote application servers are deallocated. When you specify NORMAL, the CIRT transaction prevents new online users from accessing the application server. Users who are already doing work, however, can finish. When all users complete their work, no online users can use the application server. When you specify QUICK, online access to local application servers is ended immediately. Online users accessing a local application server 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 remote application servers are accessed by the online support and you specify QUICK, online access to the remote application server is not ended immediately. Online users accessing a remore server can finish their unit of work, but cannot start a new logical unit of work.
INTERVAL (positional parameter 3)	30 (seconds)	The number of seconds that the CIRT transaction should delay before freeing the terminal. The value must be an integer value between `0` and 3 600. This parameter controls the availability of the CICS terminal (or operator console) after you enter the CIRT transaction. The CICS terminal (or VSE operator console) used to activate the CIRT 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 CIRT PASSWORD,NORMAL, the terminal is not available until all online users complete their work. Even with CIRT PASSWORD, QUICK there may be some delay before the CICS terminal allows the CIRT terminal to complete its clean-up process. The value you specify here represents an interval of time measured in seconds. If the CIRT transaction does not finish immediately, it waits the amount of time you specify. When this time ends, the CIRT transaction tries again to finish processing. If the CIRT transaction does not finish successfully, you receive a message telling you to retry the CIRT transaction later. After issuing the message, the CIRT 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.

If links to multiple application servers exist, or if online access to multiple remote application servers exist they will all be removed. After all the links and/or online access have been removed, the online support is terminated.

The following example assumes that SQLVM, SQLMACH1 and SQLMACH2 are local application servers, and SQLMACH8 is a remote application server.

Figure 16. Example of CIRT with Connections to Four Applications Servers

msg f2 AR 015 1I40I READY 2 cirt F2-002 ARI0455I Connections to SQLVM are disabled. F2-002 ARI0455I Connections to SQLMACH2 are disabled. F2-002 ARI0455I Connections to SQLMACH1 are disabled. F2-002 ARI0455I Online access to SQLMACH8 is disabled. F2-002 ARI0413I Resource Adapter ARI0OLRM is disabled.

Note that the message "ARI0413I Resource Adapter ARI0OLRM is disabled" is not displayed until the last application server connections and/or access have been severed.

When the online resource adapter is not active, the CIRA and CIRR transactions are incorrect. The online resource adapter needs to be enabled with the CIRB transaction before the CIRA and CIRR transactions can be used.

Figure 17. Example of CIRA and CIRR after CIRT

F2-002 ARI0413I Resource Adapter ARI0OLRM is disabled. 2 cira ,,,sqlmach1 F2-002 ARI0411I Resource Adapter is not enabled. 2 cirr ,,,sqlmach1 F2-002 ARI0411I Resource Adapter is not enabled.

Password Implications on Online Resource Adapter Termination

The password used on the CIRR and CIRT transactions must be the same one that was used on the CIRA and CIRB transactions. CIRR and CIRT will only shut down the connections to servers where the password matches. If the passwords do not match, that server is not shut down.

Consider the following example:

The online resource adapter is started with the command:
```
CIRB  pw1,5,,,,(SQLMACH1,SQLMACH2)
```
Connections to two new servers are added with the command:
```
CIRA  ,,,(SQLMACH3,SQLMACH4)
```
Another connection is added to a fifth server with the command:
```
CIRA  pw2,1,,SQLMACH5
```

It is not possible to end the online resource adapter with one command in this scenario. The CIRT or CIRR transactions must be run at least three times before the online resource adapter is completely shutdown because three different passwords were used to start it up.

The CIRT transaction entered with no parameters would only shut down the connections to SQLMACH3 and SQLMACH4 because they were the only servers that were started with the default password.

To shut down SQLMACH5, you would have to enter the following command:

CIRT pw2

To bring down the remaining servers and stop the online resource adapter you need to enter:

CIRT pw1 followed by CIRT

The CIRR transaction can also be used, but the server names must be specified. The following shows the CIRR commands that would be equivalent to the CIRT commands in this scenario.

CIRT pw1 is equivalent to CIRR pw1,,,(SQLMACH1,SQLMACH2)
CIRT is equivalent to CIRR ,,,(SQLMACH3,SQLMACH4)
CIRT pw2 is equivalent to CIRR pw2,,,SQLMACH5

If the command:

CIRR ,,,(SQLMACH1,SQLMACH2,SQLMACH3,SQLMACH4,SQLMACH5)

were entered only SQLMACH3 and SQLMACH4 would be disconnected.

Message ARI0464E will be issued for servers SQLMACH1, SQLMACH2 and SQLMACH5 because the passwords do not match.

Similarly, if the command:

CIRR pw1,,,(SQLMACH1,SQLMACH2,SQLMACH3,SQLMACH4,SQLMACH5)

were entered only SQLMACH1 and SQLMACH2 would be disconnected.

Message ARI0464E will be issued for servers SQLMACH3, SQLMACH4 and SQLMACH5 because the passwords do not match.

[ Top of Page | Previous Page | Next Page | Table of Contents | Index ]