Attachmate Verastream Transaction Integrator Guide


Declare a Host Transaction

What is a host transaction?

You must create at least one host transaction before you can create a client operation. You can import legacy (Synapta) host program definitions to associate with your client operations. See Import Legacy Host Interface Definitions.

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. In an IMS environment, the Program Input and Ouput Area defined by the host program is sometimes used by IMS to implement more that one transaction to be accessed by the Transaction Integrator.

Note: If a copybook file that is used to declare a host transaction is moved, renamed, or deleted, the next time Transaction Designer 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 Designer 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 Designer.

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.

    For CICS, the COBOL program name must be the name by which it is known on the mainframe. For IMS the program name is optional.

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


    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. For IMS, specify the transaction code for the target transaction.

    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.
    Select this
    Create an empty client operation 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.
    Add input elements for security attributes Username and Password Add these attributes to the client operation.

    When you select this option, the client user is required to provide these values when the service is invoked. The values the user enters are passed to the host program as part of the service. If appropriate credentials are not provided, the service will fail to retrieve data from the host. In IMS the "Group" attribute is also added.

  8. Click Finish.

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

    It is displayed in the list of existing host transactions.

Related Topics
Bullet Create a Client Operation
Bullet Import Legacy Host Interface Definitions