Configure a CICS service port

Use the service port type CICS to connect to a Customer Information Control System (CICS) Transaction Gateway. To do so, you need to specify a client and a server. A client sends a request, while a server sends a response.

Configure general settings

Once you have created your service port, you can configure the general service port details:

Attribute

Description

General - Name

Enter the name of the service port.

General - Type

Select your service port technology.

Server / Client

Select what you want to configure:

  • Server to configure the HTTP server.

  • Client to configure the HTTP client.

Real Service

Select if you want to connect to a real service.

Forwarding

Allow OSV to forward requests to the real service. To use this option, you need to select Real Service.

Learning

Allow OSV to store forwarded messages in the Recorder tab. To use this option, you need to enable Forwarding.

Active

Select if you want your service port to be active, deselect to set it to inactive.

Configure the server

Configure the server to let the service port listen for incoming requests on the port you specify. Use the following attributes:

Attribute

Description

Port

Specify the port that you want OSV to listen to.

Culture

Enter culture information such as language or country as a string. For example: en-US.

Environment Info

Enter CICS environment information as a string. For example: OS: z/OS Arch: s390x Version: 02.02.00.

CICS server configuration

To save your changes, click Apply. To discard your changes, click Reset.

Configure the client

Configure the client to let the service port send messages to an endpoint. Use the following attributes:

Attribute

Description

Host

Enter the name of the workstation that hosts the CICS Transaction Gateway.

Port

Specify the port that you want to send messages to.

Culture

Enter culture information such as language or country as a string. For example: en-US.

Environment Info

Enter CICS environment information as a string. For example: OS: z/OS Arch: s390x Version: 02.02.00.

CICS client configuration

To save your changes, click Apply. To discard your changes, click Reset.

Once you have configured your service port, you can use your CICS connection for testing. For information on how to do so, see chapter "Work with copybook messages".