Create, View and Edit an IMS Transaction

Specify the name of the transaction.

Specify a description for the transaction.

Specify the name of the PSB associated with this transaction.

Specify the message class for this transaction.

Specify the name of the application program associated with this transaction.

Choose whether the application program can be scheduled into more than one message processing region simulatneously:

• Parallel - the application program can be scheduled into more than one message processing region simulatneously.
• Serial - the application program cannot be scheduled into more than one message processing region simulatneously.

Specify the size of the conversational scratchpad area (SPA). The size specified must be between 16 bytes and 32767 bytes.

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.

Check this to specify that this is a wait-for-input (WFI) transaction.

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.

Check Use System Value to use the system wide value for the transaction time threshold set in the ESMAC IMS Control page.

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 is 1.

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 is 1.

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.

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.

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.

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.

Choose the status of the transaction program:

• Enabled - the transaction program is enabled.
• Disabled - the transaction program is disabled.

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.

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.

This feature is currently not supported.

Specify the 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.

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.

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.

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.

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.

Check this to request a program dump if the transaction program abends.

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, for example:

  05 ATTRIBUTE-VARIABLES.
     10 CURSOR-ATTR    PIC X(2) VALUE X"C0C1". 
     10 ERROR-ATTR     PIC X(2) VALUE X"C0C9". 
     10 OK-ATTR        PIC X(2) VALUE X"00C1". 
     10 PROT-ATTR      PIC X(2) VALUE X"00F1".

• Character - The program defines attributes as characters, for example:

  05 ATTRIBUTE-VARIABLES.
     10 CURSOR-ATTR PIC X(2) VALUE "{A". 
     10 ERROR-ATTR PIC X(2) VALUE "{I". 
     10 OK-ATTR PIC X(2) VALUE " A".
     10 PROT-ATTR PIC X(2) VALUE " 1".

  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.

Specify the character to use as the NULL. You can enter the value in character form or hexadecimal form (X'nn'). The default 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.

all

Choose a setting to apply to all the security keys:

• On - enables all the security keys
• Off - disables all the security keys

1-64

Check any of the boxes 1 through 24 to activate that security key.

Click this to install (make active) this resource.

Click this to delete this transaction. You see this button only if you have permission to edit the transaction.

Click this 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 this to create and view display a dump of the transaction information.