CICSCMD Command › CICSCMD SET CONNECTION—Set Connection Status

CICSCMD SET CONNECTION—Set Connection Status

The CICSCMD SET CONNECTION command controls the status of CICS-defined connections. 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 CONNECTION transaction.

This command has the following format:

CICSCMD cics_region_name SET CONNECTION(connection_name_mask) {INS | OUT} {ACQ | REL}

cics_region_name

Defines the CICS region that owns the connections whose status is to be set.

connection_name_mask

Specifies the connections whose status is to be set. The value can be either the name or a mask. If you use a mask, it must be of the following form: connection_name_prefix*.

INS | OUT

Specifies whether the CICS region can receive and send data.

INS

Puts the connections into service. The CICS region can receive and send data.

For APPC connections, INS enables them to be established subsequently.

OUT

Puts the connections out of service. The CICS region can neither receive nor send data.

For APPC connections, OUT is valid only for links with no acquired sessions.

ACQ | REL

(APPC only) Specifies whether to acquire or release the sessions on the links.

ACQ

Acquires sessions with the CICS regions at the other end of the links that are in service.

REL

Releases the sessions with the CICS regions at the other end of the links.

Example:

CICSCMD CICSA SET CONN(CICB) INS

CICSCMD CICSA SET CONN(CICB) ACQ