Previous Topic: CICSCMD SET TRANSACTION—Set Transaction Status

Next Topic: NCL Exits

CICSCMD SET VTAM—Set ACB Status

The CICSCMD SET VTAM command controls the status of the CICS VTAM ACB. The command sets the status of the CICS-VTAM connection. The RCIW06 or RCIW20 message indicates the success or failure of the operation. The function is similar to that provided by the CICS CEMT SET VTAM transaction.

This command has the following format:

CICSCMD cics_region_name SET VTAM {OPEN | CLOSED | IMMCLOSE | FORCECLOSE}
cics_region_name

Defines the CICS region for which you want to affect the IRC status.

OPEN | CLOSED | IMMCLOSE | FORCECLOSE

Specifies whether to establish or terminate the CICS-VTAM connection.

OPEN

Opens the CICS VTAM ACB to establish the connection.

CLOSED

Waits for transaction tasks that use VTAM-connected terminals to complete before releasing the terminals, and then closes the CICS VTAM ACB to terminate the connection.

IMMCLOSE

Cancels transaction tasks that use VTAM-connected terminals, closes the terminal sessions, and then closes the CICS VTAM ACB to terminate the connection.

FORCECLOSE

Closes the CICS VTAM ACB to terminate the connection, causing all terminal sessions to terminate immediately.

Example:

CICSCMD CICSA SET VTAM CLOSED
CICSCMD CICSA SET VTAM OPEN