CEMT SET TCPIPSERVICE
In the CICS Explorer, the TCP/IP Services view provides a functional equivalent to this command.
Description
You can use the SET TCPIPSERVICE command to update information that relates to a service that uses CICS internal TCP/IP support.
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.
- CICS bundles that were deployed on their own or with a platform can be updated individually.
- If the CICS bundle was deployed as part of an application or with an application binding, update the whole application.
Syntax
- Type CEMT SET TCPIPSERVICE (or suitable abbreviations for the keywords). The resulting display lists the current status, similar to that obtained by using the CEMT INQUIRE TCPIPSERVICE command. You can tab to the highlighted or blank fields and overtype them with the required values.
- Type CEMT SET TCPIPS (or suitable abbreviations for the keywords), followed by (value) or ALL, then followed by one or more attribute settings that you want to change. For example, cemt s tcpips status open opens CICS internal sockets support.
CEMT SET TCPIPSERVICE >>-CEMT SET TCPIPSERVICE--+-(value)-+--+----------------+-------> '-ALL-----' '-BACKLOG(value)-' >--+--------------+--+-------------------+--+----------+--------> '-DEREGISTERED-' '-MAXDATALEN(value)-' +-OPEN-----+ +-CLOSE----+ '-IMMCLOSE-' >--+------------+---------------------------------------------->< '-URM(value)-'
Options
- BACKLOG
- The maximum number of requests that can be queued in TCP/IP waiting to be processed by the service. Before you can change this value, the status of the service must be closed. If the value of BACKLOG is less than the value of the TCP/IP attribute SOMAXCONN, the TCPIPservice is opened with the backlog value specified by the BACKLOG attribute. If the value of BACKLOG is greater than SOMAXCONN, the TCPIPservice is opened with the backlog value specified by SOMAXCONN. The default is 0, which means that the TCPIPService is opened with the backlog value specified by SOMAXCONN.
- MAXDATALEN
- The maximum length of data that can be received by CICS as an HTTP server. This can be 3 - 524288K. The default is 32K.
- OPENSTATUS
- The
status of the service:
- OPEN
- CICS starts listening for incoming requests on the specified port. If the TCPIPSERVICE specifies a SPECIFTCPS value, then an open TCPIPSERVICE with that name must be found. It must have the same security attribute settings for the OPEN to succeed. The OPEN will fail if the TCPIPSERVICE named in the SPECIFTCPS is already associated with another TCPIPSERVICE that is open.
- CLOSED
- CICS stops
accepting new connections for this service. The service is closed when all related sockets are
closed.
Tasks that have been initiated and are using this service are allowed to
complete.
After a SET TCPIPSERVICE OPENSTATUS(CLOSED) command is
issued, CICS attempts to close HTTP persistent connections as
follows:- When there are requests for HTTP persistent connections, CICS allows their next request to process. When the processing is complete, CICS sends out a close header to the client, and then closes the HTTP persistent connections.
- When there are no requests for HTTP persistent connections, CICS closes the HTTP persistent connections within 30 seconds or within the time as specified in the SOCKETCLOSE attribute of the TCPIPSERVICE if this value is less than 30 seconds.

In an IPIC high-availability environment, CLOSED will apply to any generic TCPIPSERVICE associated with this one. The generic TCPIPSERVICE name is recorded in the GENERICTCPS option of this resource.
- IMMCLOSE
- CICS stops accepting new connections for this service. The service is closed immediately and all related sockets are closed. Tasks initiated using this service will receive an error response only when data transmission is attempted over the socket, which may be at task termination. In an IPIC high-availability environment, IMCLOSE will apply to any generic TCPIPSERVICE associated with this one. The generic TCPIPSERVICE name is recorded in the GENERICTCPS option of this resource.
- URM
- Specifies the 8-character name of the program to be used as the service user-replaceable module by the attached task. You can specify either an installation-specific program or the CICS-supplied default for the service.
