Defining the CICS TCPIPSERVICE resource
Before your users can use the profile view or develop applications that use the APIs, you must define the CICS® TCPIPSERVICE resource for every CICS region that users access.
For every region that users access, do these steps:
- Define the TCP/IP address and host name for the z/OS® system. By default, they are defined in the PROFILE.TCPIP and TCPIP.DATA data sets.
- Add a TCP/IP listener to CICS.
Use the following CEDA command to define a TCPIPSERVICE in a group:
Ensure that the group in which you define the service is in the startup GRPLIST, so that the listener starts when CICS starts. The following list explains what values to use for some of the key fields:CEDA DEF TCPIPSERVICE(service-name) GROUP(group-name)
- TCpipservice(service-name)
- Create a name that is eight characters or less.
- GROup(group-name)
- Create a name that is eight characters or less.
- Urm
- Specify EQADCAN0.
- POrtnumber
- Specify an unused port number that the DTCN Profile Manager plug-in uses for the API's communication.
- STatus
- Specify
Open
. - PROtocol
- Specify
Http
. - TRansaction
- Specify
CWXN
. - Backlog
- The number of TCP/IP requests that are queued before TCP/IP starts to reject incoming requests. For example, 30.
- SOcketclose
- Specify
No
. - Maxdatalen
- Specify the maximum size, in bytes, of the body (the XML document)
of the HTTP request or response. For example,
032768
represents 32K bytes. - SSl
- Specify Yes if you are using SSL encryption with the HTTPS protocol.
- AUthenticate
- Specify
Basic
. - GRPcritical
- Specify
No
.
- Add a URIMAP definition to match the URLs of the incoming HTTP requests:
The following list explains what values to use for the key fields:CEDA DEF URIMAP(map-name) GROUP(group-name)
- URIMAP(map-name)
- Create a name that is eight characters or less.
- GROUP(group-name)
- Specify the same group-name as used in the TCPIPSERVICE resource definition.
- STATUS
- Specify
Enabled
. - USAGE
- Specify
Server
. - SCHEME
- Specify
HTTP
. - HOST
- Specify
*
. - PATH
- Specify
/dtcn/*
. - ANALYZER
- Specify
Yes
.
- Enter the following commands to install the TCPIPSERVICE and URIMAP definitions:
CEDA INS TCPIPSERVICE(service-name) GROUP(group-name)
CEDA INS URIMAP(map-name) GROUP(group-name)
- If you encounter problems with the connection from the
workstation to the HTTP server in the CICS region,
issue the command
CEMT INQUIRE TCPIPSERVICE(service-name)
on the server region to verify if your settings are correct. Your settings must be as follows:Port(nnnn)
, where nnnn is the port that the workstation connects to.Authentication(Basic)
Maxdatalen(032000)
Urm(EQADCAN0)
- Ask your system administrator to provide access to transactions CWBA and CWXN because they are used in the HTTP request processing.