Declare a Host Transaction

What is a host transaction?

The host transaction captures the information you need to interact with the host program. This information includes the program name and the data structure definitions.

You must create at least one host transaction before you can create a client operation.

In a CICS environment, the data structure defines the input and output data structure that is used to communicate with the host program that processes one CICS transaction.


If a copybook file that is used to declare a host transaction is moved, renamed, or deleted, the next time Transaction Studio starts, all client operations based on that host transaction will cause an error when loading. Although the files load correctly, they are not displayed in the Transaction Studio list of existing client operations and cannot be edited or deleted. To resolve this issue, restore the copybook file that was changed and restart Transaction Studio.


To Declare a Host Transaction

  1. Copy your COBOL copybooks to a location accessible from your workstation, such as a network share.

  2. From the Actions menu, choose New Host Transaction.

  3. Type the name, description, COBOL program name, and, if needed, the transaction ID.

    The COBOL program name must be the name by which it is known on the mainframe.

  4. Specify the data structure layout for inputs and outputs.
    If in the data structure
    Then use
    Inputs are the same as the outputs One shared data structure layout for both input and output
    Inputs are different than the outputs Two separate data structure layouts, one for input and one for output
  5. Click Next. The Import Copybooks panel displays.

  6. From the list on the left side of the screen, select the copybooks to use, and then to add them to the data structures on the right, click Add (or use drag and drop).

    -or-

    If no copybooks are displayed, click Add to browse to the location where the copybooks you want to use are stored. Select the appropriate copybook. Click Next.

    The order in which copybooks are placed must match the order expected by the host program. You can use the Up and Down buttons to rearrange the copybooks. The number of data structures displayed (either one or two) depends on your selection on the preceding screen.

  7. Provide the name and description for an initial client operation.

    By default, the client operation elements will be populated from each data item in the host program data structure and will maintain the same hierarchical relationship.

  8. Select Create an empty client operation to create a blank client schema consisting only of input and output areas, in which you must add elements and records, set their properties, and map them to data items.

  9. Click Finish.

    Your host transaction is saved in the following location: and displayed in the list of existing host transactions.

    <install_directory>\Verastream\TransactionStudio\workspace\<project_name>\
    It is displayed in the list of existing host transactions.
Related Topics
Bullet Create a Client Operation