Creating a Host Program Definition

A host program definition references a COBOL program on the host and identifies COBOL copybooks as input, output, or both. You must create at least one host program definition before you can create a task definition. A host program definition must reference an existing host program, and you must know, in advance, the values for the COBOL program name and host transaction ID fields.

To create a host program definition
  1. Copy your COBOL copybooks to a location accessible from your workstation, such as a network share.
    Note If a copybook file used to create host program definitions is moved, renamed, or deleted, the next time Task Builder starts, all task definitions based on that host program definition will cause an error when loading. Although the files will load correctly, they will not be displayed in Task Builder in the list of existing Task Definitions. And, if you cannot select the task definition, you cannot edit or delete it. To resolve this issue, restore the copybook file that was changed, and then restart Task Builder.

  2. In the Designer Studio window, from the Designer menu, click Task Builder for CICS.

  3. In the Task Builder Guide, click the Host Program Definition button.

  4. In the first screen, click New from the row of buttons at the bottom of the window.

  5. (Optional) Type your Host Transaction ID.

    This is the name of the group of host programs that includes the COBOL program with which you want to interact. The value for the Host Transaction ID is used internally only by Services Builder.

  6. Type the COBOL program name.

    The name you type here should be the name by which it is known on the mainframe.

  7. Select whether to use a single COMMAREA for both input and output copybooks, or separate COMMAREAs for input and output.

  8. Select whether to use a comma as a decimal point in numeric data. (This may be required for some European systems.)

    If selected, 9,999.99 becomes 9.999,99.

    Note In this version, Task Builder does not support the euro symbol (€) within copybooks. (The symbol can occur in the VALUE clause, or in the PIC clause.) To work around this, replace the euro symbol with the dollar sign ($) in the copybook. The dollar sign should be interpreted by the receiving host application as the currency it expects.
  9. Click Next.

  10. From the list on the left side of the screen, select the copybook(s) to use, and then to add them to the COMMAREA(s) on the right, click Add (or use drag and drop).


    If no copybooks are displayed, select the location where the copybooks you want to use are stored in the Look In field, and when you're done, click Next.

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

  11. Name your host program definition — choose a name that is meaningful to you.

  12. Add a description, and then click Save.

    Your host program definition is saved in the following location and displayed in the table of existing Host Program Definitions.


Note You can save your program definition without completing this procedure by choosing Save from the File menu. If you save an incomplete host program definition, it is displayed in the table of Host Program Defintions with an asterisk beside its name.
Related Topics
Bullet Creating Task Files
Bullet About COBOL Copybooks
Bullet Editing a Host Program Definition
Bullet Creating a Task Definition