SET CONNECTION

Changes some connection attributes.

Syntax

SET CONNECTION

Conditions: INVREQ, SYSIDERR

For more information about the use of CICS-value data areas (CVDAs), see CVDAs recognized by the translator.

Description

The SET CONNECTION command allows you to change some of the attributes that define a connection.

Note: SET CONNECTION command is not implemented for connections with IPIC protocol.

Options

ACQSTATUS(cvda)

This option is retained only for compatibility purposes. You should use the CONNSTATUS option in new applications.

CONNECTION(data-value)

Specifies the name or SYSID of the connection and refers to an entry in the Communications Definitions (CD). The name can be up to four characters long.

CONNSTATUS(cvda)

Specifies whether to acquire or release sessions with the logical unit that is represented by the CONNECTION name. A connection cannot be both ACQUIRED and OUTSERVICE.

The CVDA values are:

ACQUIRED: Sessions are to be acquired.
RELEASED: Sessions are to be released.

TXSeries for Multiplatforms checks this option only for validity; otherwise, it ignores this option.

EXITTRACING(cvda)

Specifies whether to trace the activity that is associated with the terminal exit program for the sessions that are associated with this connection. The CVDA values are:

EXITTRACE: The activity is to be traced.
NOEXITTRACE: The activity is not to be traced.

TXSeries for Multiplatforms checks this option only for validity; otherwise, it ignores this option.

PENDSTATUS(cvda)

Specifies whether the normal resynchronization process is to be overridden.

The CVDA value is NOTPENDING.

TXSeries for Multiplatforms checks this option only for validity; otherwise, it ignores this option.

PURGETYPE(cvda)

Specifies how associated transactions are to be purged. The CVDA values are:

FORCEPURGE: All transactions that are running on sessions on the connected system are immediately terminated abnormally. This can cause unpredictable results and should be used only in exceptional circumstances.
In some extreme cases (for example, if an error occurs during backout processing), CICS® might terminate abnormally.
PURGE: Transactions that are running on the connected system are abnormally terminated. Transactions are terminated only if system and data integrity can be maintained. A transaction is not purged if its definition specifies PURGEABILITY =NOTPURGEABLE.

TXSeries for Multiplatforms checks this option only for validity; otherwise, it ignores this option.

SERVSTATUS(cvda)

Specifies whether the system is to be placed in service or out of service. The CVDA values are:

INSERVICE: The system is to be placed in service; that is, to be available for use.
OUTSERVICE: The connection is to be placed out of service; that is, not to be available for use.

ZCPTRACING(cvda)

Specifies whether the VTAM® control component of CICS is to trace activity on the sessions that are associated with this connection. The CVDA values are:

NOZCPTRACE: VTAM ZCP tracing is not to be carried out.
ZCPTRACE: VTAM ZCP tracing is to be carried out.

TXSeries for Multiplatforms checks this option only for validity; otherwise, it ignores this option.

Conditions

INVREQ

RESP2 values:

ACQUIRED and OUTSERVICE are specified inconsistently in any of the following ways (RESP2=2):
1. ACQUIRED specified with OUTSERVICE
2. ACQUIRED specified for OUTSERVICE connection
3. OUTSERVICE specified for ACQUIRED connection
ACQSTATUS|CONNSTATUS has an invalid CVDA value (RESP2=3).
SERVSTATUS has an invalid CVDA value (RESP=4).
PURGETYPE has an invalid CVDA value (RESP2=7).
PENDSTATUS has an invalid CVDA value (RESP2=8).
EXITTRACING has an invalid CVDA value (RESP2=12).
ZCPTRACING has an invalid CVDA value (RESP2=13).
CONNSTATUS cannot be set to ACQUIRED when in the FREEING state (RESP2=19).

SYSIDERR

RESP2 values:

The named connection could not be found (RESP2=9).