CEMT SET TRANSACTION

Change the attributes of a selected transaction.

In the CICS Explorer, the Transactions operations view provides a functional equivalent to this command.

Description

You can only use the CEMT transaction to modify transactions that are defined in the CICS® system definition (CSD) file and installed in the running CICS system. You cannot use the CEMT SET TRANSACTION command for transactions that were defined and installed in a CICS bundle.
  • You can control the status of dynamically generated TRANSACTION resources by enabling or disabling the BUNDLE resources that installed them.
  • You can modify the definition of dynamically generated TRANSACTION resources using the resource editor in the CICS Explorer®. To update the definition, replace the old version of the CICS bundle with the new one, following the instructions in Working with bundles in the CICS Explorer product documentation. CICS bundles that were deployed on their own or with a platform can be updated individually. If the CICS bundle was deployed as part of an application or with an application binding, update the whole application.

Syntax

Press the Clear key to clear the screen. There are two ways to start this transaction:
  • Type CEMT SET TRANSACTION (or suitable abbreviations for the keywords), followed by (value), CLASS(value), or ALL. The resulting display lists the current status, similar to that obtained by using the CEMT INQUIRE TRANSACTION command. You can tab to the highlighted or blank fields and overtype them with the required values.
  • Type CEMT SET TRANSACTION (or suitable abbreviations for the keywords), followed by one or more attribute settings that you want to change. For example, cemt s trans(value) e pu specifies that a named transaction is available for use (enabled) and can be purged by the system.

Typing ? at the beginning of either the first or second line gives a syntax prompt. Resetting the values takes effect immediately.

CEMT SET TRANSACTION

Read syntax diagramSkip visual syntax diagramCEMT SET TRANSACTION ( value)CLASS( value)ALLPRIORITY( value)TCLASS( value)ENABLEDDISABLEDPURGEABLENOTPURGEABLE

Options

(value)
Specifies a transaction identifier (1-4 characters). Only transactions that have been defined in the CICS system definition (CSD) file and installed on the running CICS system are accessible through CEMT.
ALL
Specifies that any changes you request are made to all resources of the specified type that you are authorized to access.
CLASS (value)
Specifies the 2-character suffix of a transaction list table (XLT).
DISABLED
The transaction is not available for use. Transactions that have identifiers that begin with the character C cannot be disabled, because these transactions are reserved for use by CICS.

When the CEMT SET TRANSACTION DISABLED command is used, existing transactions run to completion before they become unavailable for use.

Note: If a transaction is disabled, a START command that names this transaction can still be shipped to a remote region. When a task is attached for the requested transaction, CICS checks that the transaction is enabled in the remote region.
ENABLED
The transaction is available for use.
NOTPURGEABLE
The transaction cannot be purged.
PRIORITY (value)
Specifies the priority of a transaction relative to other transactions. When a transaction is running as a CICS task, the priority of a task is the sum of the transaction priority, the terminal priority, and the operator priority. The value must be in the range 0–255, where 255 is the highest priority.
PURGEABLE
The transaction can be purged by the system. This operand relates to the SPURGE attribute on the transaction resource definition and indicates that CICS can purge the transaction in a deadlock timeout situation. See TRANSACTION resource definitions for information about the SPURGE and DTIMOUT attributes on a transaction resource definition.
TCLASS (value)
Specifies the 8-character transaction class name to which the transaction belongs. If the transaction does not belong to a class, DFHTCL00 is returned. To remove a transaction from its transaction class, set the TCLASS field to DFHTCL00. A series of blanks can be inserted, in which case, DFHTCL00 is returned. An added or changed transaction class must be defined.