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 and add a URIMAP definition for every CICS region that users access.

For every region that users access, do these steps:

  1. 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.
  2. Add a TCP/IP listener to CICS. Use the following CEDA command to define a TCPIPSERVICE in a group: 
    CEDA DEF TCPIPSERVICE(service-name) GROUP(group-name)
    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:
    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 Debug Profile Service 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.
  3. Add a URIMAP definition to match the URLs of the incoming HTTP requests: 
    CEDA DEF URIMAP(map-name) GROUP(group-name)
    The following list explains what values to use for the key fields:
    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.
  4. 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)
  5. 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)
  6. Ask your system administrator to provide access to transactions CWBA and CWXN because they are used in the HTTP request processing.