CEMT SET TRANSACTION
Change the attributes of a selected transaction.
In the CICS Explorer®, the Transactions 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 file (CSD) 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.
Options
- (value)
- Specifies a transaction identifier (1-4 characters). Only transactions that have been defined in the CSD 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 resources 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.