Changes some connection attributes.

Sintaxe:

SET CONNECTION
 
>>-SET CONNECTION(data-value)--+-----------------+-------------->
                               '-ACQSTATUS(cvda)-'
 
>--+------------------+--+-------------------+------------------>
   +-CONNSTATUS(cvda)-+  +-EXITTRACING(cvda)-+
   +-ACQUIRED---------+  +-EXITTRACE---------+
   '-RELEASED---------'  '-NOEXITTRACE-------'
 
>--+------------------+--+------------------+------------------->
   +-PENDSTATUS(cvda)-+  +-PURGETYPE(cvda)--+
   '-NOTPENDING-------'  +-FORCEPURGE-------+
                         '-PURGE--+-------+-'
                                  '-FORCE-'
 
>--+------------------+--+------------------+------------------><
   +-SERVSTATUS(cvda)-+  +-ZCPTRACING(cvda)-+
   +-INSERVICE--------+  +-NOZCPTRACE-------+
   '-OUTSERVICE-------'  '-ZCPTRACE---------'
 
 

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

Descrição;

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

Opções:

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.

Condições:

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).