IMS Transaction Edit

Use this page to define a new transaction or view an existing one.

Click APPLY to save your changes.

Click INSTAL to install and make the resource active.

Click DELETE to delete this transaction.

Click COPY to create a new transaction. The values on the current page will be used as the basis for the values in the new transaction.

Click DUMP to create and display a dump of the transaction information.

Name
Specify the name of the transaction.
Description
Specify a description for the transaction.
PSB Name
Specify the name of the PSB associated with this transaction.
Class
Specify the message class for this transaction.
Program Name
Specify the name of the application program associated with this transaction.
Schedule
Choose whether the application program can be scheduled into more than one message processing region simultaneously:
Parallel
The application program can be scheduled into more than one message processing region simultaneously.
Serial
The application program cannot be scheduled into more than one message processing region simultaneously.
SPA Size
Specify the size of the conversational ScratchPad Area (SPA). The size specified must be between 16 bytes and 32767 bytes.
SPA Truncate
Choose the setting of the truncated data option:
unspecified
The data option currently in effect for the conversation is used.
STRUNC
Truncated data option is on.
RTRUNC
Truncated data option is off.
Wait for input
Check this to specify that this is a wait-for-input (WFI) transaction.
Transaction threshold
Specify the maximum length of time in seconds that a transaction can run before a message is logged to the console to indicate that it has exceeded its threshold. This must be in the range 0 through 65535. A value of 0 indicates that there is no threshold.
Use System Value
Check this to use the system wide value for the transaction time threshold set on the IMS Control page.
Priority
Specify the priority assigned to this transaction (and any messages it creates) when the number of input transactions enqueued and waiting to be processed is less than the value specified in P-Limit Count. The priority must be in the range 0 through 14. The default value is 1.
Priority Limit
Specify the priority assigned to this transaction (and any messages it creates) when the number of input transactions enqueued and waiting to be processed is greater than or equal to the value specified in P-Limit Count. The priority must be in the range 0 through 14. The default value is 1.
Priority Limit Count
Specify the number of input transactions enqueued and waiting to be processed that determines whether the transaction's priority is the value specified in Priority or Priority Limit. The count must be in the range 1 through 65535. The default is 65535.
Process Limit
Specify how many of this transaction's messages a program can process in a single scheduling. This must be in the range 1 through 9999. The default is 9999. Specifying 9999 indicates that no limit is to be imposed.
Process Limit Time
Specify how many seconds a program can spend processing this transaction (or a message from it) in a single scheduling. The number must be in the range 1 through 65535. The default is 65535. Specifying 65535 indicates that no limit is to be imposed.
Max Segments
Specify the maximum number of application program output segments that are allowed into the message queues for each Get Unique (GU) call from the application program. The number must be in the range 0 through 65535. The default is 0. Specifying 0 indicates that the number of segments is not checked at execution time.
Deadlock Timeout
Specify the maximum time in seconds that the message processing region will permit this transaction to wait for a resource that has been locked by another process. A value of 0 indicates that there is no timeout.
Status
Choose the status of the transaction program:
Enabled
The transaction program is enabled.
Disabled
The transaction program is disabled.
Edit
Choose whether or not input data is to be translated to uppercase:
ULC
Input data is not to be translated to uppercase.
UC
Input data is to be translated to uppercase.
Fast Path
Specify the size of the EMH buffer required to run the transaction using Fast Path processing. The minimum value is 12 and the maximum is 30720. Specifying 0 indicates that the transaction cannot be run using Fast Path processing.
In Doubt
Choose what happens if a transaction program using intersystem communication abends at a critical moment during syncpoint or abend processing:
Backout
The effects of the transaction are backed out using ROLLBACK.
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.
Response Mode
Check this to specify that, for terminals with a default of OPTIONS=TRANRESP, no additional messages are to be allowed after this transaction is entered until this transaction sends a response message back to the terminal. Leave this option unchecked to specify that input should not stop after this transaction is entered.
Tracing
Choose the type of tracing to be performed for the transaction:
Standard
Tracing is performed.
Special
Special tracing is performed.
No
No tracing is performed.
Codeset
Choose the codeset to use for this transaction:
Default
The transaction inherits the system bias codeset.
ASCII
The transaction uses ASCII.
EBCDIC
The transaction uses EBCDIC.
Dump On Abend
Check this to request a program dump if the transaction program abends.
MFS Attributes
Choose how attributes are defined in the transaction program:
Default
The program defines attributes as defined by the system bias value (which is binary, by default).
Binary
The program defines attributes as binary values.
Character
The program defines attributes as characters.
This setting only has an effect if the program is compiled using the ASCII character set; it is ignored if the program is compiled using EBCDIC.
MFS Null
Specify the character to use as the NULL. You can enter the value in character form or hexadecimal form (X'nn'). The default value is X'1A'.This setting only has an effect if the program is compiled using the ASCII character set; it is ignored if the program is compiled using EBCDIC.
Password Reverification Required
If checked, every time the transaction is invoked, the password of the user that invoked it is reverified and access to it is denied if the verification fails.