IMS Transaction (transaction-name)

Active, Install Class Codeset Copy Deadlock Timeout Delete Description Dump Dump On ABEND Edit Edit Exit Fast Path In Doubt Max Segments MFS Attributes MFS Null Name | P-Limit Count P-Limit Time Priority Priority Limit Process Limit Program Name PSB Name Response Mode Schedule Security Keys, 1-64 Security Keys, all SPA Size SPA Truncate Status Tracing Wait for input

IMS Transaction (transaction-name)

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

  Top

Name

  Specify the name of the description.

  Top

Description

  Specify a description for the transaction.

  Top

PSB Name

  Specify the name of the PSB associated with this transaction.

  Top

Class

  Specify the message class for this transaction.

  Top

Program Name

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

  Top

Schedule

  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.

  Top

SPA Size

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

  Top

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.

  Top

Wait for input

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

  Top

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

  Top

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

  Top

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.

  Top

P-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.

  Top

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.

  Top

P-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.

  Top

Status

  Choose the status of the transaction program:

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

  Top

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.

  Top

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.

  Top

Edit Exit

  This feature is currently not supported.

  Top

Fast Path

  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.

  Top

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.

  Top

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.

  Top

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.

  Top

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.

  Top

Dump On ABEND

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

  Top

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, 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.

  Top

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

  Top

Security Keys, all

  Choose a setting to apply to all the security keys:

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

  Top

Security Keys, 1-64

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

  Top

Active, Install

  Click this to install (make active) this resource.

  Top

Delete

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

  Top

Copy

  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.

  Top

Dump

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

  Top