CEMT SET TCPIPSERVICE

Modify the status or attributes of a service that uses CICS® internal TCP/IP support.

In the CICS Explorer, the TCP/IP services operations 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.

Note: This command has no effect on the sockets support provided by the TCP/IP for CICS sockets feature.

Start of change 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. End of change

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. To update the definition, replace the old version of the CICS bundle with the new one, following the instructions in Working with bundles in the CICS Explorer product documentation.

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.

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. End of change

Syntax

Press the Clear key to clear the screen. You can start this transaction in two ways:

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.

Typing ? at the beginning of either the first or second line gives a syntax prompt. Resetting the values takes effect immediately.

CEMT SET TCPIPSERVICE

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 once all related sockets are closed. When using HTTP persistent connections, the client may choose to keep the connection open. 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.