TCPIPSERVICE resources
A TCPIPSERVICE resource defines which TCP/IP services are to use CICS® internal sockets support.
With TCPIPSERVICE resources, the CICS services that can be defined are ECI over TCP/IP (for CICS Clients), CICS web support (HTTP), IPIC, or a user-defined protocol. The TCPIPSERVICE definition allows you to manage these internal CICS interfaces, with CICS listening on multiple ports, with different flavors of ECI, CICS web support or the user-defined protocol on different ports.
TCPIPSERVICE definitions are for use only with the CICS-provided TCP/IP services, and have nothing to do with the z/OS Communications Server IP CICS Sockets interface. The TCP/IP Socket Interface for CICS is supplied with z/OS Communications Server, which is an integral part of z/OS and does not use the CICS SO domain.
TCPIPSERVICE resources in CICS bundles
You can use a CICS bundle to create, edit, and install a TCPIPSERVICE resource definition. If you create a TCPIPSERVICE resource in this way, you must use the CICS bundle to manage the lifecycle of that resource, and you cannot manage the resource independently.
You can inquire on a TCPIPSERVICE resource that is dynamically generated by a CICS bundle, by using the EXEC CICS INQUIRE TCPIPSERVICE or CEMT INQUIRE TCPIPSERVICE command.
You cannot issue the DISCARD command against a TCPIPSERVICE resource that is dynamically generated by a CICS bundle. You must discard the CICS bundle, and CICS applies the operation to the TCPIPSERVICE resource.
To modify the attributes of a TCPIPSERVICE resource that was defined and installed in a CICS bundle, use the resource editor in the CICS Explorer® to modify the definition in the CICS bundle, and install a new version of the CICS bundle or of the application with which it was deployed. You can use the SET TCPIPSERVICE command to change the attributes of the dynamically generated resource, but these changes are not cataloged and are not recovered across a warm restart of CICS.
To change the status of a TCPIPSERVICE resource that was defined and installed in a CICS bundle, enable or disable the CICS bundle. If you have disabled the CICS bundle, but the service has not yet closed, you can issue the SET TCPIPSERVICE IMMCLOSE command against the dynamically generated resource to close the service immediately.
For more information about defining resources in CICS bundles, see Defining CICS bundles.
