Transactions

This section allows the administrator to access all transactions defined in the environment as well as defining new ones. A transaction server reads these configurations once every 5 minutes and therefore may take this amount of time before changes are effective on runtime.<<

Program Control

The Program Control tab displays a list of defined transaction codes linked to programs. From here, it is also possible to define transaction codes for each program. It is alternatively possible to define transaction codes under the Transaction Control tab.

The following Program Control settings are available:

Application
The application that this program belongs to.

Program name
The program's name. This name needs to match the name exactly as shown in the Available Jobs section.

Program alias
warning A-Series only. The COMS program name information for this program. This is the logical name as used in COBOL code.

Program Type
Available program types are:

• Default: This type lets the transaction server treat these programs in a manner that is normal according to the application kind it belongs to.
• SelfDestructive: Not yet functional.
• SelfInitializing: Not yet functional.
• Reentrant: Programs with this type continue running after they were started, retaining its working storage data. This makes it possible to re-enter the program and continue with the same data for as long as the transaction server is not shut down. Programs with the this type can only have a concurrency of 1.
• Shared: warning A-Series only. Programs with this type are instantiated the first time they are called and executed in a separate thread by the Transaction Agent. The same instance is then used by all transactions and programs that call this program. warning Only environments with a single Transaction Server and Transaction Agent support this type. This option is the equivalent of the A-Series compiler sharing option "SHAREDBYALL".

Transaction Control

The following Transaction Control settings are available:

Application
The application that this program belongs to.

Transaction code
A free-to-choose code using up to 50 characters without spaces. These codes are to be used in COBOL code instead of the four original character transaction IDs.

Program
Select one of the available programs from this list that are defined in Program Control.

Automatic start
If enabled, the transaction will start as soon as the Transaction Server is started. The Priority setting determines the order of execution if multiple transactions are set to start automatically.

Disabled
If enabled, this disables the transaction, causing it to be inaccessible to users.

TWA size
The size of the TWA (Transaction Work Area) size in bytes. The default value is 0, which means that no TWA is used.

Remote System (optional)
The remote application on which to start the transaction.

Filters

The filters below can be applied to filter the list of available transactions:

• Application: Select an application to only display transactions part of that application.
• Program name: Enter text to filter transactions by program name (case insensitive).
• Transaction code: Enter a transaction code to filter transactions by their code.

Click the button to apply the filters.

Vsam File Control

The following settings are available:

Application
The application in which this file is accessed.

Logical name
The logical file name to use for this file in the COBOL code of the application.

Description
The description of the file (optional).

Physical name
The physical file name of the file. If a relative name is used, the name is relative to the Extracts path as set in the Basepaths configuration for this application.

File Type
The following options are available:

• Indexed
• Sequential
• Relative

Maximum record length
If the record length is larger than the set value, the record will be truncated.

Minimum record length
If the record length is less than the set value, the record will be appended to the value of the minimum length (with spaces).

Key length
If the file type is set to Indexed, this sets the length in characters for keys to build the index.

Key position
If the file type is set to Indexed, this sets the position (relative to 0) of the first character for the key in the record.

Concurrency
The limit on concurrent access to the file.

Allow duplicates
If enabled, duplicate records are accepted in the file. If disabled, no duplicate records are accepted in the file and an error will be shown (default: disabled).

Browse requests | Read requests | Add requests | Update requests | Delete requests
These settings, if enabled (individually), permit the operation to be performed on the file.

Filters

The filters below can be applied to filter the list of available Vsam File Controls:

• Logical name: Enter text to filter the list by logical name.

Click the button to apply the filters.

Transient Data Queue

The following settings are available:

Application
The application used for the queue.

Queue name
The name of the queue.

Description
The description for the queue (optional).

Filters

The filters below can be applied to filter the list of available Transient Data Queues:

• Queue name: Select a queue to only display Transient Data Queues with the selected queue.

Click the button to apply the filters.