TCP/IP services: Resource statistics
You can retrieve TCP/IP services resource statistics by using the EXEC CICS EXTRACT STATISTICS TCPIPSERVICE system command. They are mapped by the TCPIPSERVICE and the DFHSORDS DSECTs.
| DFHSTUP name | Field name | Description |
|---|---|---|
| TCPIPSERVICE Name | SOR_SERVICE_NAME | The name of the TCP/IP service. Reset characteristic: not reset |
| TCPIPSERVICE Open Date/Time | SOR_OPEN_LOCAL | The date and time on which this TCP/IP service was
opened. If this field is not set, SOR_OPEN_LOCAL contains the hexadecimal value X'0000000000000000',
shown in the report as "CLOSED". If the field is set, it contains a date expressed in
mm/dd/yyyy format. This field contains a valid date if the following statements apply:
Reset characteristic: not reset |
| TCPIPSERVICE Close Date/Time | SOR_CLOSE_LOCAL | The date and time on which this TCP/IP service was
closed. If this field is not set, SOR_CLOSE_LOCAL contains the hexadecimal value
X'0000000000000000', shown in the report as "OPEN". If the field is set, it contains a time
expressed as a store clock (STCK) value in local time. Reset characteristic: not reset |
| TCPIPSERVICE Protocol | SOR_PROTOCOL | The protocol defined for this TCP/IP service. This
protocol can be “ECI”, “HTTP”, “IIOP”, “IPIC", "USER", or blank (which means HTTP). Reset characteristic: not reset |
| TCPIPSERVICE Port | SOR_PORT_NUMBER | The port number being used for this TCP/IP service.
Reset characteristic: not reset |
| TCPIPSERVICE Host | SOR_HOSTNAME | The hostname or IPv4 or IPv6 address of the remote
system. Reset characteristic: not reset |
| TCPIPSERVICE IP Family | SOR_IP_FAMILY | The address format of the address returned in IP
Resolved Address. Reset characteristic: not reset |
| TCPIPSERVICE IP Resolved Address | SOR_IP_ADDRESS | The IPv4 or IPv6 resolved address of the host.
Reset characteristic: not reset |
| TCPIPSERVICE Transaction ID | SOR_TCPIPS_TRANID | The ID of the CICS transaction attached to process new
requests received for this service. Reset characteristic: not reset |
| TCPIPSERVICE Backlog Setting | SOR_BACKLOG | The initial backlog setting for the TCP/IP service. The
setting controls the maximum number of connection requests that are allowed to queue in the backlog
queue for the TCP/IP service before it starts to reject incoming connections. This is per stack if
the TCP/IP service is listening on multiple stacks. Reset characteristic: not reset |
| TCPIPSERVICE URM | SOR_TCPIPS_URM | The name of a user-replaceable program to be called by
this service. Reset characteristic: not reset |
| Current Maximum Backlog | SOR_CURR_MAX_BACKLOG | The maximum number of
connection requests that the TCP/IP service currently allows in its backlog queue, summed over all
appropriate stacks if the TCP/IP service is listening on multiple stacks. This value can be
greater than the TCPIPSERVICE Backlog Setting (SOR_BACKLOG) of the TCP/IP service because the TCP/IP
service might temporarily increase this value if, for example, it determines that there is a SYN
flood. Reset characteristic: not reset by CICS |
| TCPIPSERVICE SSL Type | SOR_SSL_SUPPORT | The level of SSL support defined for this TCP/IP service.
Reset characteristic: not reset |
| TCPIPSERVICE Maxdata | SOR_MAXDATA_LENGTH | The maximum length of data that can be received on this
TCP/IP service. Reset characteristic: not reset |
| TCPIPSERVICE Authenticate | SOR_AUTHENTICATE | The authentication and identification scheme specified for
this TCP/IP service. Reset characteristic: not reset |
| TCPIPSERVICE Privacy | SOR_PRIVACY | The level of SSL encryption support that applies to this
TCP/IP service. Reset characteristic: not reset |
| TCPIPSERVICE Attachsec | SOR_ATTACHSEC | The level of attach-time security required for this TCP/IP
service. Reset characteristic: not reset |
| Current Connections | SOR_CURRENT_CONNS | The current number of connections for the TCP/IP
service. Reset characteristic: reset to zero |
| Peak Connections | SOR_PEAK_CONNS | The peak number of connections for the TCP/IP service.
Reset characteristic: reset to zero |
| Transactions Attached | SOR_TRANS_ATTACHED | The number of transactions attached by the TCP/IP
service. Reset characteristic: reset to zero |
| Total Connections | SOR_TOTAL_CONNS | The total number of
connections made for the TCP/IP service. Reset characteristic: reset to zero |
| Send requests | SOR_SENDS | The number of send requests issued for the TCP/IP
service. Reset characteristic: reset to zero |
| Total Bytes Sent | SOR_BYTES_SENT | The number of bytes sent for the TCP/IP service.
Reset characteristic: reset to zero |
| Receive requests | SOR_RECEIVES | The number of receive requests issued for the TCP/IP
Service. Reset characteristic: reset to zero |
| Total Bytes Received | SOR_BYTES_RECEIVED | The number of bytes
received for the TCP/IP service.
Reset characteristic: reset to zero |
| Requests processed | SOR_REQUESTS | The number of requests
processed by the TCP/IP service. Reset characteristic: reset to zero |
| Maximum Persistent Connections | SOR_TCPIPS_MAX_PERSIST | The maximum number of persistent connections from Web
clients that the CICS region accepts at any one time. Reset characteristic: not reset |
| Non-Persistent Connections | SOR_TCPIPS_NON_PERSIST | The number of connections where CICS did not allow the Web
client to have a persistent connection. Reset characteristic: reset to zero |
| Made non-persistent at MAXPERSIST | SOR_NONP_AT_MAXPERSIST | The number of times a
new persistent connection was made non-persistent because MAXPERSIST was reached. Reset characteristic: reset to zero |
| Disconnected after maximum uses | SOR_DISC_AT_MAX_USES | The number of times a
persistent HTTP connection was disconnected because its number of uses had exceeded the
limit. Reset characteristic: reset to zero |
| Made non-persistent at task limit | SOR_NONP_AT_TASK_LIMIT | The number of times a
new persistent HTTP connection was made non-persistent because the number of tasks in the region has
exceeded the limit. Reset characteristic: reset to zero |
| Disconnected at task limit | SOR_DISC_AT_TASK_LIMIT | The number of times
an existing persistent HTTP connection was closed because the number of tasks in the region has
exceeded the limit. Reset characteristic: reset to zero |
| Current backlog | SOR_CURR_BACKLOG | The current number of
connection requests waiting in the backlog queue, summed over all appropriate stacks if the TCP/IP
service is listening on multiple stacks. Reset characteristic: not reset |
| Connections dropped | SOR_CONNS_DROPPED | The total number of
connections that were dropped because the backlog queue was full. Reset characteristic: not reset by CICS |
| Time connection last dropped | SOR_CONN_LAST_DROPPED | The time that a
connection was last rejected because the backlog queue of the TCP/IP service was
full. Reset characteristic: not reset by CICS |
| Not in DFHSTUP report | SOR_SERVICE_DEFINE_SOURCE | The source of the resource definition. Its value depends
on the change agent. For more information, see Summary of the resource signature field values. Reset characteristic: not reset |
| Not in DFHSTUP report | SOR_SERVICE_CHANGE_TIME | The time stamp (STCK) in local time of the CSD record
change. Reset characteristic: not reset |
| Not in DFHSTUP report | SOR_SERVICE_CHANGE_USERID | The user ID that ran the CHANGE_AGENT. Reset characteristic: not reset |
| Not in DFHSTUP report | SOR_SERVICE_CHANGE_AGENT | The agent that was used to make the last
change. Reset characteristic: not reset |
| Not in DFHSTUP report | SOR_SERVICE_INSTALL_AGENT | The agent that installed the resource. Reset characteristic: not reset |
| Not in DFHSTUP report | SOR_SERVICE_INSTALL_TIME | The time stamp (STCK) in local time when the resource
was installed. Reset characteristic: not reset |
| Not in DFHSTUP report | SOR_SERVICE_INSTALL_USERID | The user ID that installed the resource. Reset characteristic: not reset |
The resource statistics fields for the resource signature
The resource signature captures details about when the resource is defined, installed, and last changed. The resource statistics field names for the resource signature end in CHANGE_AGENT, CHANGE_TIME, CHANGE_USERID, DEFINE_SOURCE, INSTALL_AGENT, INSTALL_TIME, and INSTALL_USERID. For detailed information about the content of the resource signature fields, see Summary of the resource signature field values.