Changes a transaction definition.

Sintaxe:

SET TRANSACTION
 
>>-SET TRANSACTION(data-value)--+---------------+--------------->
                                +-DUMPING(cvda)-+
                                +-TRANDUMP------+
                                '-NOTRANDUMP----'
 
>--+----------------------+--+--------------------+------------->
   '-PRIORITY(data-value)-'  +-PURGEABILITY(cvda)-+
                             +-NOTPURGEABLE-------+
                             '-PURGEABLE----------'
 
>--+-------------------+--+---------------------+--------------->
   +-RUNAWAYTYPE(cvda)-+  '-RUNAWAY(data-value)-'
   +-SYSTEM------------+
   '-USER--------------'
 
>--+----------------+--+--------------+------------------------->
   +-SHUTDOWN(cvda)-+  +-STATUS(cvda)-+
   +-SHUTDISABLED---+  +-DISABLED-----+
   '-SHUTENABLED----'  '-ENABLED------'
 
>--+-----------------------+--+---------------+----------------><
   +-TCLASS(data-value)----+  +-TRACING(cvda)-+
   '-TRANCLASS(data-value)-'  +-SPECTRACE-----+
                              +-SPRSTRACE-----+
                              '-STANTRACE-----'
 
 

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

Descrição:

The SET TRANSACTION command allows you to change some attributes of a transaction definition.

You can change the definitions only in the local CICS system with this command.
If you change a transaction that runs remotely (that is, one that specifies a Remote System ID value), your changes are made, but they have no effect on the definition that is in the remote system to which the local definition points, and therefore, no effect on tasks that execute the transaction.
Changing a transaction definition affects only future tasks; to change a task that is already executing the transaction, use the SET TASK command.

Opções:

DUMPING(cvda)
• Specifies whether CICS takes a transaction dump if a task that is executing this transaction terminates abnormally.
• The CVDA values are:
  • NOTRANDUMP
    • No dump is taken.
  • TRANDUMP
    • A dump is taken.
• This value applies only to abend dumps and has no effect on DUMP TRANSACTION commands.

PRIORITY(data-value)
• Specifies, as a 32-bit binary value, the priority of this transaction relative to other transactions that are in the CICS system.
• The value must be in the range 0 through 255.

PURGEABILITY(cvda)
• Returns a CVDA value that indicates whether CICS is allowed to purge this task (that is, to terminate it abnormally).
• Purge requests come from SET TASK PURGE commands (or CEMT equivalents), and CICS can generate them internally to reclaim resources to relieve a system stall condition.
• The CVDA values are:
  • NOTPURGEABLE
    • The task cannot be purged.
  • PURGEABLE
    • The task can be purged.
• The PURGEABILITY value is set initially by the PURGEABILITY option in the transaction definition.

RUNAWAY(data-value)
• Specifies, as a 32-bit binary value, the "runaway task" time, in milliseconds, for tasks that are executing this transaction.
• The value must be in the range 0 through 2700000.

RUNAWAYTYPE(cvda)
• Specifies where the runaway task time for a task executing this transaction is to be obtained.
• The CVDA values are:
  • SYSTEM
    • The system default for runaway-task time is to be used.
  • USER
    • The RUNAWAY value for this transaction is to be used.

SHUTDOWN(cvda)
• Specifies whether this transaction can be executed during CICS shutdown by a task that is created to process unsolicited terminal input.
• The CVDA values are:
  • SHUTDISABLED
    • The transaction cannot be executed.
  • SHUTENABLED
    • The transaction can be executed.

STATUS(cvda)
• Specifies whether the transaction is to be available for use.
• The CVDA values are:
  • DISABLED
    • The transaction is not available for use.
  • ENABLED
    • The transaction is available for use.
• Transactions that begin with the letter "C" are CICS-supplied transactions and cannot be disabled.

TCLASS(data-value)
• Specifies, as a 32-bit binary value, the transaction class to which the transaction is assigned.
• It must be in the range 0 through 10.

TRACING(cvda)
• Specifies the type of tracing that is to be done for tasks that are executing this transaction.
• The CVDA values are:
  • SPECTRACE
    • Tracing is special.
  • SPRSTRACE
    • Tracing is suppressed.
  • STANTRACE
    • Tracing is standard.
• TXSeries for Multiplatforms checks this value only for validity; otherwise, it ignores this value.

TRANCLASS(data-value)
• Specifies the eight-character name of the transaction class to which this transaction is assigned.
• TXSeries for Multiplatforms ignores this value.

TRANSACTION(data-value)
• Specifies the four-character name of the transaction definition (TD) that you are changing.

Condições

INVREQ
• RESP2 values:
  • The PURGEABILITY option has an invalid CVDA value (RESP2=2).
  • The STATUS option has an invalid CVDA value (RESP2=3).
  • The DISABLED option has been specified for a CICS-supplied transaction (RESP2=4).
  • The TCLASS value is not in the range 1 through 10 (RESP2=5).
  • The TRACING option has an invalid CVDA value (RESP2=7).
  • The DUMPING option has an invalid CVDA value (RESP2=8).
  • The PRIORITY value is out of range (RESP2=9).
  • The RUNAWAYTYPE option has an invalid CVDA value (RESP2=10).
  • The SHUTDOWN option has an invalid CVDA value (RESP2=11).
  • The USER option has been specified without a RUNAWAY value (RESP2=12).
  • The RUNAWAY option has been specified without a RUNAWAYTYPE value of USER (RESP2=13).
  • The RUNAWAY value is out of range (RESP2=14).

TRANSIDERR
• RESP2 values:
  • The transaction cannot be found (RESP2=1).