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