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.

Table 1. TCP/IP Services: resource statistics
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:
  • The TCP/IP service is open at the time the statistics are taken.
  • The statistics request is unsolicited because the TCP/IP service is closed.

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

Start of changeTCPIPSERVICE Backlog SettingEnd of change Start of changeSOR_BACKLOGEnd of change Start of changeThe 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

End of change
TCPIPSERVICE URM SOR_TCPIPS_URM The name of a user-replaceable program to be called by this service.

Reset characteristic: not reset

Start of changeCurrent Maximum BacklogEnd of change Start of changeSOR_CURR_MAX_BACKLOGEnd of change Start of changeThe 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

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

Start of changeTotal ConnectionsEnd of change Start of changeSOR_TOTAL_CONNSEnd of change Start of changeThe total number of connections made for the TCP/IP service.

Reset characteristic: reset to zero

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

Start of changeRequests processedEnd of change Start of changeSOR_REQUESTSEnd of change Start of changeThe number of requests processed by the TCP/IP service.

Reset characteristic: reset to zero

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

Start of changeMade non-persistent at MAXPERSISTEnd of change Start of changeSOR_NONP_AT_MAXPERSISTEnd of change Start of changeThe number of times a new persistent connection was made non-persistent because MAXPERSIST was reached.

Reset characteristic: reset to zero

End of change
Start of changeDisconnected after maximum usesEnd of change Start of changeSOR_DISC_AT_MAX_USESEnd of change Start of changeThe number of times a persistent HTTP connection was disconnected because its number of uses had exceeded the limit.

Reset characteristic: reset to zero

End of change
Start of changeMade non-persistent at task limitEnd of change Start of changeSOR_NONP_AT_TASK_LIMITEnd of change Start of changeThe 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

End of change
Start of changeDisconnected at task limitEnd of change Start of changeSOR_DISC_AT_TASK_LIMITEnd of change Start of changeThe 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

End of change
Start of changeCurrent backlogEnd of change Start of changeSOR_CURR_BACKLOGEnd of change Start of changeThe 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

End of change
Start of changeConnections droppedEnd of change Start of changeSOR_CONNS_DROPPEDEnd of change Start of changeThe total number of connections that were dropped because the backlog queue was full.

Reset characteristic: not reset by CICS

End of change
Start of changeTime connection last droppedEnd of change Start of changeSOR_CONN_LAST_DROPPEDEnd of change Start of changeThe time that a connection was last rejected because the backlog queue of the TCP/IP service was full.

Reset characteristic: not reset by CICS

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



dfht3_stats_tcpip_services_resource.html | Timestamp icon Last updated: Monday, 5 June 2017