CICSplex TCPIP Service Statistics attribute group

The CICSplex TCPIP Service Statistics attribute group provides information about the TCP/IP services including the port number, protocol and the activity of each TCP/IP service. This data can be accessed online using the EXEC CICS COLLECT STATISTICS TCPIPSERVICE and the EXEC CICS INQUIRE TCPIPSERVICE command.

Note:
The attributes within the CICSplex TCPIP Service Statistics group are stored for historical retrieval within the Tivoli Data Warehouse. Selected attributes within this group are candidates for the TDW's summarization and pruning features.

Attach-time Security Indicates, for ECI over TCP/IP services, the level of attach-time security used by connections to CICS clients. These are the values: LOCAL, VERIFY, and IDENTIFY.

Backlog Is the port backlog for this TCP/IP service. It shows the number of requests that TCP/IP queues for this port before it starts to reject incoming requests. The value format is an integer of maximum four bytes.

CICS Region Name Indicates the job name or modify ID of the CICS region being monitored. Each CICS region in a z/OS operating system has a unique name. This name is an alphanumeric string, with a maximum of eight characters, and case-sensitive. CICS region names are always in uppercase characters.

Client Authentication Is the scheme used to authenticate clients. These are the values:

Asserted
Asserted identity authentication is used. This value is returned only when PROTOCOL has a value of IIOP.
Automatic
If the client does not send a certificate, then HTTP basic authentication is used to obtain a user ID and password from the client.
Basic
HTTP basic authentication is used to obtain a user ID and password from the client.
Certificate
SSL client certificate authentication is used to authenticate and identify the client.
Noauthenticate
The client is not required to send authentication or identification information.
Register
SSL client certificate authentication is used to authenticate the client. If the client's certificate is not associated with a user ID, then HTTP basic authentication is used to obtain the client's user ID. The value is returned only when PROTOCOL has a value of HTTP.

Current number of connections Is the current number of connections for the TCP/IP service. The value format is an integer of maximum four bytes.

DNS Status Is the current state of WLM/DNS registration of this TCPIPSERVICE. The parameter DNSSTATUS returns the current state of WLM/DNS registration of this TCPIPSERVICE. These are the values:

NOTAPPLICABLE
This service is not using DNS connection optimization. No DNSGROUP attribute was specified when the resource was installed.
UNAVAILABLE
Registration is not supported by z/OS.
UNREGISTERED
Registration has not yet occurred (this is the initial state of any service).
REGISTERED
Registration has completed successfully.
REGERROR
Registration has failed with an error.
DEREGISTERED
Deregistration has completed successfully.
DEREGERROR
Deregistration has failed with an error.

Group Critical Specifies whether or not this TCPIPSERVICE is a critical member of the DNS group. The parameter GRPCRITICAL returns value specifying whether or not this TCPIPSERVICE is a critical member of the DNS group. These are the values:

Critical
If this TCPIPSERVICE is closed, or abnormally stops listening for any reason, the group name specified in the DNSGROUP attribute is deregistered from WLM.
Noncritical
If this TCPIPSERVICE is closed, or abnormally stops listening for any reason, the group name specified in the DNSGROUP attribute is not deregistered from WLM, unless this is the last service in a set with the same group name.

Number of Bytes Received Is the number of bytes received by all sockets from the TCP/IP service. The value is an alphanumeric string, with a maximum of 42 characters.

Number of Bytes Received 64bit Is the number of bytes received by all sockets from the TCP/IP service. The value is an alphanumeric string, with a maximum of 32 characters.

Number of Bytes Sent Is the number of bytes sent by all sockets to the TCP/IP service. The value is an alphanumeric string, with a maximum of 42 characters.

Number of Bytes Sent 64bit Is the number of bytes sent by all sockets to the TCP/IP service. The value is an alphanumeric string, with a maximum of 32 characters.

Number of Receives Is the number of receive requests issued for the TCP/IP Service on all sockets. The value format is an integer of maximum four bytes.

Number of Sends Is the number of send requests issued for the TCP/IP Service on all sockets. The value format is an integer of maximum four bytes.

Number of Transactions Attached Is the number of transactions attached by this TCP/IP Service. The value format is an integer of maximum four bytes.

Open Status Indicates the status of the TCP/IP service. These are the values: OPEN, CLOSED, CLOSING, and IMMCLOSING.

Origin Node The combination of z/OS System ID (SMFID) and CICS region name. The value format is an alphanumeric string, maximum 32 bytes, and case-sensitive.

When a situation is true, the system compares the origin node name in the attribute to the names of managed systems assigned to the item. If the origin node name matches the name of a managed system, the status of the item changes accordingly. If the names of the origin node and the managed systems do not match, the status of the item remains unchanged.

Peak Number of Connections Is the peak number of connections for the TCP/IP service. The value format is an integer of maximum four bytes.

Port Number Is the port number being used for this TCP/IP service where CICS is monitoring. The value format is an integer of maximum four bytes.

Protocol Specifies the application level protocol used on the TCP/IP port. These are the values:

ECI
CICS ECI protocol is used.
HTTP
HTTP protocol is used.
IIOP
IIOP protocol is used.
USER
The user-defined protocol is used. Messages are processed as non-HTTP messages.
IPIC
The IPIC protocol is used.

Service Open Time (GMT) Is the GMT time at which this TCP/IP service was opened. The field is blank if the TCP/IP service is closed.

Service Open Time (Local) Is the local time at which this TCP/IP service was opened. The field is blank if the TCP/IP service is closed.

SSL Type Is the level of SSL support. These are the valid values: No_SSL, Client_Authentication, and SSL.

System ID Indicates the four character name that uniquely identifies an active z/OS operating system within a given CICSplex. The value format is an alphanumeric string, maximum four characters, and case-sensitive z/OS System IDs are always in uppercase characters.

TCP/IP Service Name Is the name of the TCP/IP service. This name is an alphanumeric string, with a maximum of eight characters.

TCP/IP Server SSL Support Is the level of SSL support defined for this TCP/IP service. These are the values: No SSL, SSL and Client Authentication

TCP/IP Service IP Address Is the IP address defined for the TCP/IP stack used for this TCP/IP service. The value is an alphanumeric string, with a maximum of 15 characters.

TCP/IP Service Max Data Length Is the maximum data length for a TCP/IP service. The value format is an integer of maximum four bytes.

TCP/IP Service Privacy Is the level of TCP/IP service privacy. These are the values: NOT_SUPPORTED, SUPPORTED, REQUIRED.

TCP/IP Service TSQ Prefix Is the name of the temporary storage queue prefix used to store inbound data and Web documents created by applications. The value is an alphanumeric string, with a maximum of six characters.

TCP/IP Service WLM DNS Group Is the DNS group name that this TCPIPSERVICE registers with the z/OS Workload Manager (WLM). The value is an alphanumeric string, with a maximum of 18 characters.

Transaction ID Is the transaction ID used to process a new request. The value format is an integer of maximum four bytes.

URM Is the name of the service user-replaceable module (URM) to be invoked by the attached task. This name is an alphanumeric string, with a maximum of eight characters.