DEFINE TRANSACTION

Keyword Description
TRANSaction(name) Names the transaction. Mandatory. name can be up to four alphanumeric characters in length. Do not specify a transaction name starting with C, as Mainframe Transaction Option uses that prefix for system transactions.
Group(groupname) Names the group the transaction definition belongs to. Mandatory. groupname can be up to eight characters in length. Acceptable characters are A through Z, 0 through 9, $, @ and #. Do not specify a group name starting with DFH, as Mainframe Transaction Option uses that prefix for system groups
DEscription(text) Describes the file. Optional. text can be up to 60 characters in length, with no restrictions except that if you use a left parenthesis you must ensure that there is a matching right parenthesis.
PROGram(name)  
TWasize(number)  
STAtus(Enabled|Disabled) Indicates whether or not the transaction is accessible when the region is started:

Enabled: the transaction is accessible when the region starts up

Disabled: The transaction cannot be used until it is specifically enabled using the transaction CPMT.

Remote Attributes  
DYnamic(No|Yes) Indicates whether or not the transaction can be dynamically routed to a remote region:

Yes: the transaction can be dynamically routed to a remote region

No: creates a remote definition if REMOTESystem(name) is present; creates a local definition if it is not

REMOTESystem(name) Applicable only for remote transactions. Specifies the ID of the remote system that runs the transaction. This must correspond to either:
  • The Local SYSID field in the SIT used to run the related remote Mainframe Transaction Option region
  • The APPLID of another CICS system
REMOTEName(name) Applicable only for remote transactions. Names the remote transaction. Necessary only if it differs from the local transaction name.
Scheduling  
PRIOrity(number) Specifies the priority for this transaction. Defaults to 0(zero). Transaction priority is one factor in determining a transaction's execution priority, which is the sum of:

Terminal priority

Transaction priority (this field)

Operator priority

The sum cannot be greater than 255.

Recovery  
DTimout(mmss) Specifies the deadlock timeout, that is, the period after which the transaction is terminated if it has been suspended. mm is the number of minutes and ss is the number of seconds. Defaults to 0000, that is, no deadlock timeout.
DUmp(No|Yes) Indicates whether or not Mainframe Transaction Option produces a program dump if this transaction abends.
TRACe(Yes|No|Special) Indicates tracing options for this transaction:

Yes: the transaction is traced

No: the transaction is not traced

Special: not currently supported

Indoubt Attribute  
INdoubt(Backout|Commit|Wait) Indicates the action to be taken if this transaction abends during syncpoint or abend processing:

Backout: The effects of the transaction are backed out using SYNCPOINT ROLLBACK (For this to work, you must also set backwards recovery on for any file used by the transaction.)

Commit: any changes are committed

Wait: Critical resources are locked until the session has recovered and are then backed out or committed in step with the remote system

Security  
RESSec(No|Yes) Indicates whether or not the transaction program performs resource security checking by comparing a user's resource keys (defined in the user's entry in the sign-on-table) with the keys enabled for a particular resource.
TRANSec(keys) Specifies one or more indicators, each corresponding to one of the 64 security keys for this transaction. A user has access to a particular transaction only through a matching key as defined in his sign-on table entry. To toggle a key on you specify its number here. By default all keys are toggled off. You code the keys as a comma-separated list of individual numbers and ranges separated by hyphens. For example, to toggle the keys 1 to 5 and 10 on, code TRANsec(1-5,10).
RSl(keys) (RSl stands for Resource Security Level.) Specifies one or more indicators, each corresponding to one of the 24 resource keys for this transaction. A user has access to a particular resource only through a matching key as defined in his sign-on table entry. To toggle a key on you specify its number here. By default all keys are toggled off. You code the keys as a comma-separated list of individual numbers and ranges separated by hyphens. For example, to toggle the keys 1 to 5 and 10 on, code RSl(1-5,10).
Micro Focus Extensions  
_Screen(Default|Alternate) Indicates the screen size is used by the transaction. Both sizes are defined in the Typeterm definition for the terminal in use at the time.
_Uctran(Yes|No) Indicates whether or not any data received by the transaction is automatically folded to upper case
_Inboundtp(No|Yes) On Windows NT, Indicates whether or not registry entries to allow inbound transactions are created.

Example

DEFINE TRANSACTION(TRNX) GROUP(SAMPGRP)
DESCRIPTION(Sample PCT entry)
       PROGRAM(ABP0001A) TWASIZE(1024) STATUS(ENABLED) DYNAMIC(YES)
       PRIORITY(100) DTIMOUT(NO) INDOUBT(COMMIT) DUMP(YES) TRACE(YES)
       RESSEC(NO) TRANSEC(01,09-10,15-20,25,30,53-59)
       RSL(02,07-10,15,24)

DEFINE TRANSACTION(TRNX) GROUP(SAMPGRP)
DESCRIPTION(Sample PCT entry)
       PROGRAM(ABP0001A) TWASIZE(1024) STATUS(ENABLED) DYNAMIC(YES)
       PRIORITY(100) DTIMOUT(NO) INDOUBT(COMMIT) DUMP(YES) TRACE(YES)
       RESSEC(NO) TRANSEC(01,09-10,15-20,25,30,53-59)
       RSL(02,07-10,15,24) _SCREEN(DEFAULT) _UCTRAN(YES) _INBOUNDTP(NO)

Related Topics