SET CONNECTION
Changes some connection attributes.
Syntax
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.
CICS® TX on Cloud 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.
CICS TX on Cloud 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.
CICS TX on Cloud 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.
CICS TX on Cloud 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.
CICS TX on Cloud 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):
- ACQUIRED specified with OUTSERVICE
- ACQUIRED specified for OUTSERVICE connection
- 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).
- ACQUIRED and OUTSERVICE are specified inconsistently in any of
the following ways (RESP2=2):
- SYSIDERR
- RESP2 values:
- The named connection could not be found (RESP2=9).