CTCPSRV view

To display general information about the TCP/IP services that are defined to IBM CICS, issue the following command:

CTCPSRV [target [serviceID]]

where target is the specific or generic name of a target CICS region, and serviceID is the specific or generic ID of a TCP/IP service.

The following figure is displayed:

Related topic

Communications-views

ddmmmyyyy  hh:mm:ss ------ BMC AMI Ops WINDOW INTERFACE (Vv.r.mm) --------------
COMMAND  ===>                                                 SCROLL ===> CSR  
CURR WIN ===> 1        ALT WIN ===>                                            
>W1 =CTCPSRV==========(ALL======*=======)ddmmmyyyy==hh:mm:ss====MVCICS===D===60
CMD Service   Target   Open   Prot   IP Resolved     Port  Bcklg User Rep   WLM
---    ID             Status           Address              Max   Module    Sta
    D650ECI  BCVCD660 OPEN    ECI   172.19.164.166   20650     1          NOTAP
    D650HTTP BCVCD660 OPEN    HTTP  172.19.164.166   20640     1 DFHWBAAX NOTAP
    D650IPIC BCVCD660 OPEN    IPIC  172.19.164.166   20630     1 DFHISAIP NOTAP
    JH6LIPI  BCVCJH66 OPEN    IPIC  172.19.164.166   25122     1 DFHISAIP NOTAP
    JH66IPIC BCVCJH66 OPEN    IPIC  172.19.164.166   25125     1 DFHISAIP NOTAP
    JH66LECI BCVCJH66 CLOSED  HTTP  0.0.0.0          25121     1 DFHWBAAX NOTAP
    TCPB61C  BCVTH65C CLOSED  HTTP                    3005     5 DFHWBADX NOTAP
    TCPD610  BCVTH65C CLOSED  HTTP                    3007     5 DFHWBADX NOTAP
    TCPIPDOC BCVCD660 CLOSED  HTTP  0.0.0.0          20005     5 DFHWBADX NOTAP

Usage notes

The CTCPSRV view can be used to review and change the status of TCP/IP services that are using CICS internal sockets.

The WLM DNS Status field can contain the following values:


Value

Description

NOTAPPLIC

Service does not use DNS connection optimization

UNAVAILABLE

Registration is not supported by the IBM z/OS operating system

UNREGISTERED

Registration has not yet occurred (initial state)

REGERROR

Registration failed with an error

DEREGERROR

Deregistration failed with an error

The Protocol field can contain the following values:


Value

Description

ECI

External CICS interface protocol

USER

User defined protocol

Actions

The CTCPSRV view supports the following line command actions:


Line command

Description

CLO

Closes a TCP/IP service

IMC

Immediately closes a TCP/IP service

OPE

Opens a TCP/IP service

SET

Changes the value in a modifiable field to the new value that you type in that field

In TCP/IP service views, the following fields are modifiable:

  • Open Status
  • Bcklg Max (Maximum Backlog)
  • User Rep Module (User Replaceable Module)
  • WLM DNS Status (WLM DNS Group - Status)

The WLM DNS Status fields are not available and cannot be modified for CICS TS Version 5.2 and later.

Note

Be sure the field contains exactly the value that you want before pressing Enter to issue the SET command. You must clear the field of any other data to prevent it from being passed as part of the new value.

Related views

The following views provide additional TCP/IP services information.


View

Description

CTCPSRVZ

To display summarized information about the TCP/IP services defined to CICS, enter the SUM command on the CTCPSRV view.

The data is summarized by the TCP/IP service ID. The Count field shows how many TCP/IP services are represented by each line of summary data. You can hyperlink from the Count field to the CTCPSRV view to expand a line of summary data.

CTCPSRVD

To display detailed information about a specific TCP/IP service, hyperlink from the Open Status field of the CTCPSRV view.

The CTCPSRVD detail view supports the same line command actions as the CTCPSRV view.

CTCPSRVQ

To display a menu of detailed information about a specific TCP/IP service and related resources, hyperlink from the Service ID field of the CTCPSRV view.



 

Tip: For faster searching, add an asterisk to the end of your partial query. Example: cert*