Configuring CICS Events

How to:

CICS Events are configured using a design time tool such as iWay Explorer. This section will use the iwayevt0 sample program with a File port as an example.

To configure a CICS Event, you must:

  1. Create metadata in the form of an XML schema if you are using COBOL Copybooks.
  2. Create one or more ports for use as message endpoints.
  3. Create a channel to receive messages and associate it with ports and COBOL Copybooks.

Top of page

x
Procedure: How to Create XML Schemas from COBOL Copybook Metadata

This section describes how to create XML schemas for Copybook formatted messages.

Note: You can skip this section If your message is in XML format.

  1. Connect to your iBSP or JCA configuration.
  2. Create and connect to a CICS target.

    For more information on creating and connecting to targets, see Configuring the Adapter.

    Note: The connectivity being used here is outbound connectivity (CICS adapter), and not strictly necessary for Events.

  3. Right-click the Transactions node, and select Add Event.

    The Add Event dialog box opens.

  4. Provide the appropriate configuration information as described in the following table and click Update.

    Field

    Description

    Node Name

    An arbitrary descriptive name for the CICS Event.

    Input COBOL Data Description

    The location of the COBOL Copybook that describes the input event record.

    Use data structure information from COBOL

    Select this option if you want to include group names in the schema.

    Codepage

    The code page used by the input data.

    A new Event node is added in the left pane.

  5. Right-click the Event node, for example, CICSEvent, and select Export Schema(s).

    The Select Export Directory dialog box opens.

  6. Provide a file name for the schema and select a destination for future use.

    To view a sample XML schema document that is provided for your reference, see XML Schema Document.

  7. Click OK.
  8. Repeat steps 2 through 7 for the outbound message if the request returns a reply.

iWay Software