Configuring the CICS® Server physical resource

Use the CICS® Server physical resource to specify the details of a CICS® Transaction Server, a CICS® Transaction Gateway (CICS TG), or both, depending on your requirements.

To record or stub CICS® DPL calls in a CICS® Transaction Server, you must define the DPL details for the CICS® Transaction Server. To record or to stub IPIC communications to CICS® Transaction Server, you must define the IPIC details for the CICS® Transaction Server. To record or to stub ECI request-based CICS® program invocations in a CICS® Transaction Gateway client or daemon, you must define the details for a CICS® Transaction Gateway. CICS TG settings are also required to call a CICS® program from a test through the CICS TG. If CICS® programs are made available as web services, they can be called using the HTTP transport.

About this task

Configure a CICS® Server physical resource and define whether recording and stubbing are required in a CICS® Transaction Server, a CICS® Transaction Gateway, or both.

Procedure

  1. Open a CICS® Server physical resource.
  2. To configure CICS® Transaction Server (IPIC) details, on the CICS® IP Interconnectivity tab, enter one or more of the following details:
    1. In CICS Server Host, enter the hostname that is associated with the CICS® region where TCP/IP services have been activated.
    2. In CICS Server Port, enter the port that is associated with the CICS® region where TCP/IP services have been activated.
    3. In the CICS Server User and CICS Server Password fields, enter the credentials that are used when accessing CICS® Transaction Server.
    4. Optional: In the Stub Sockets Override panel you can configure the port and the bind address that will be used when running an IPIC-based stub.
      Port
      By default, an IPIC-based stub will listen on the port specified in the CICS Server Port field. If that port is in use by another process, the stub listens on a free ephemeral port. You can override the choice of port by specifying a value in the Port field. If a value is specified, IPIC stubs related to this transport will attempt to listen on that port however if the port is not available, the stub will fail to start.
      Bind Address
      By default, an IPIC-based stub will be bound to all local addresses on the machine that is it running on. You can override this choice by specifying a value in the Bind Address field. If the specified bind address cannot be bound to, the stub will fail to start.
    5. Enter the SSL settings that are used when accessing CICS® Transaction Server by selecting the Use SSL check box, and entering the keystore.
  3. To configure the CICS® Transaction Gateway details, on the CICS® Transaction Gateway tab, enter one or more of the following details:
    1. In Transaction Gateway Host, enter the hostname of the CICS® Transaction Gateway.
    2. In Transaction Gateway Port, enter the port for the CICS® Transaction Gateway.
    3. In CICS Server Name, type the name of a CICS® server that is defined in CICS TG. The value is the name that is defined within the CICS® Transaction Gateway configuration, which might differ from the CICS® Transaction Server APPLID.
    4. In the Transaction Gateway User and Transaction Gateway Password fields, enter the credentials that are used when accessing the CICS® Transaction Gateway.
    5. Enter the SSL settings that are used when accessing the CICS® Transaction Gateway by selecting the Use SSL check box, and entering the keystore.
  4. To configure the Distributed Program Link details, on the CICS® Distributed Program Link tab, enter one or more of the following details:
    1. In SYSID, enter the system ID of the CICS® region where CICS® programs run DPL calls.
    2. In APPLID, enter the application ID of the CICS® region where CICS® programs are running DPL calls.
    3. In Region Jobname, enter the job name of the CICS® region where CICS® programs are running DPL calls.
  5. Click Test Transport to test the configuration
    Note:

    CICS programs RITQUERY and RITSTATS are installed as part of the installation of the CICS® Transaction Server (TS) agent. Clicking Test Transport calls RITQUERY by using the ECIRequest API. The RITQUERY program links to RITSTATS to retrieve information such as the CICS job name, CICS level, and OS level. Recording the resource, while clicking Test Transport captures the data flows.

    A COBOL copybook is provided in Rational® Integration Tester Installation Directory\examples\COPYBOOK\RITSTATS.CPY. This copybook can be imported as a schema for the message data.