Netstat CACHinfo/-C report

Displays statistics for TCP listening sockets that are using the Fast Response Cache Accelerator (FRCA). For more information about the FRCA, see the Fast Response Cache Accelerator information in z/OS Communications Server: IP Configuration Guide.

TSO syntax


>>-NETSTAT CACHinfo----| Target |--| Output |------------------><

Target

Provide the report for a specific TCP/IP address space by using TCp tcpname. See The Netstat command target for more information about the TCp parameter.

Output

The default output option displays the output on the user's terminal. For other options, see The TSO NETSTAT command syntax or Netstat command output.

z/OS UNIX syntax


>>-netstat  -C----| Target |--| Output |-----------------------><

Target

Provide the report for a specific TCP/IP address space by using -p tcpname. See The Netstat command target for more information about the TCp parameter.

Output

The default output option displays the output to z/OS UNIX shell stdout. For other options, see The z/OS UNIX netstat command syntax or Netstat command output.

Command syntax examples

From TSO environment

NETSTAT CACHINFO
   Displays information about Fast Response Cache Accelerator statistics for the default 
   TCP/IP stack. 
NETSTAT CACHINFO TCP TCPCS6
   Displays information about Fast Response Cache Accelerator statistics for the TCPCS6 
   stack.

From UNIX shell environment

   netstat -C
   netstat -C -p tcpcs6

Report examples

The following examples are generated by using TSO NETSTAT command. Using the z/OS UNIX netstat command displays the data in the same format as the TSO NETSTAT command.

Not IPv6 enabled (SHORT format)

NETSTAT CACHINFO
MVS TCP/IP NETSTAT CS V2R1       TCPIP Name: TCPCS           13:38:04 
Client: USER34          Listening socket:  0.0.0.0..8080               
  CacheType:          Exclusive   ASID:                     0030       
  MaxCacheSize:       0000000100  CurrCacheSize:      0000000000       
  MaxNumObjects:      0000000010  CurrNumObjects:     0000000000       
  NumConns:           0000000000  ConnsProcessed:     0000000000       
  ConnsDeferred:      0000000000  ConnsTimedOut:      0000000000       
  RequestsProcessed:  0000000000  IncompleteRequests: 0000000000       
  NumCacheHits:       0000000000  NumCacheMisses:     0000000000       
  NumUnprodCacheHits: 0000000000                                       
Client: USER34          Listening socket:  0.0.0.0..8081               
  CacheType:          Shared      ASID:                     0030       
  MaxCacheSize:       0000000100  CurrCacheSize:      0000000000       
  MaxNumObjects:      0000000010  CurrNumObjects:     0000000000       
  NumConns:           0000000000  ConnsProcessed:     0000000000       
  ConnsDeferred:      0000000000  ConnsTimedOut:      0000000000       
  RequestsProcessed:  0000000000  IncompleteRequests: 0000000000       
  NumCacheHits:       0000000000  NumCacheMisses:     0000000000       
  NumUnprodCacheHits: 0000000000

IPv6 enabled or request for LONG format

NETSTAT CACHINFO
EZD0101I NETSTAT CS V2R1 TCPCS 212                                
CLIENT: USER34                                                     
  LISTENING SOCKET: 0.0.0.0..8080                                  
  CACHETYPE:          SHARED      ASID:                     0036   
  MAXCACHESIZE:       0000000100  CURRCACHESIZE:      0000000002   
  MAXNUMOBJECTS:      0000000010  CURRNUMOBJECTS:     0000000002   
  NUMCONNS:           0000000004  CONNSPROCESSED:     0000000002   
  CONNSDEFERRED:      0000000002  CONNSTIMEDOUT:      0000000000   
  REQUESTSPROCESSED:  0000000003  INCOMPLETEREQUESTS: 0000000001   
  NUMCACHEHITS:       0000000003  NUMCACHEMISSES:     0000000002   
  NUMUNPRODCACHEHITS: 0000000000                                   
CLIENT: USER34                                                     
  LISTENING SOCKET: 0.0.0.0..8081                                  
  CACHETYPE:          SHARED      ASID:                     0036   
  MAXCACHESIZE:       0000000100  CURRCACHESIZE:      0000000002   
  MAXNUMOBJECTS:      0000000010  CURRNUMOBJECTS:     0000000002   
  NUMCONNS:           0000000000  CONNSPROCESSED:     0000000000   
  CONNSDEFERRED:      0000000000  CONNSTIMEDOUT:      0000000000   
  REQUESTSPROCESSED:  0000000000  INCOMPLETEREQUESTS: 0000000000   
  NUMCACHEHITS:       0000000000  NUMCACHEMISSES:     0000000000   
  NUMUNPRODCACHEHITS: 0000000000                                   
CLIENT: USER34                                                     
  LISTENING SOCKET: 0.0.0.0..8082                                  
  CACHETYPE:          EXCLUSIVE   ASID:                     0036   
  MAXCACHESIZE:       0000000100  CURRCACHESIZE:      0000000001   
  MAXNUMOBJECTS:      0000000010  CURRNUMOBJECTS:     0000000001   
  NUMCONNS:           0000000002  CONNSPROCESSED:     0000000000   
  CONNSDEFERRED:      0000000002  CONNSTIMEDOUT:      0000000000   
  REQUESTSPROCESSED:  0000000000  INCOMPLETEREQUESTS: 0000000000   
  NUMCACHEHITS:       0000000000  NUMCACHEMISSES:     0000000002   
  NUMUNPRODCACHEHITS: 0000000000

Report field descriptions

For each listening socket configured for Cache Accelerator support, the following information is displayed:

Client: The user name of the application that bound the listening socket.

Socket

The local IP address and port pair to which the listening socket is bound.

CacheType

The type of FRCA cache that is used by the listening socket. It can be one of the following value:

Shared: The cache can be shared by more than one listening socket in the same address space. All listening sockets in the same address space that use a shared cache can access objects stored in the shared cache. Listening sockets from different address spaces cannot access objects that are stored in the cache for a different address space. The values of the MaxCacheSize, CurrCacheSize, MaxNumObjects, and CurrNumObjects fields are the same for all sockets that share a cache.
Exclusive: The cache can be used only by the listening socket. No other listening socket has access to objects stored in the cache.

ASID

The hexadecimal address space identifier for the address space that is making the request to enable FRCA on the listening socket.

MaxCacheSize: The maximum number of 4K pages that can be used for storing cache objects by the Cache Accelerator for the given socket.

CurrCacheSize: The number of 4K pages that are currently being used by the Cache Accelerator for storing cache objects.

MaxNumObjects: The maximum number of cache objects that can be stored by the Cache Accelerator.

CurrNumObjects: The current number of cache objects that are stored by the Cache Accelerator.

NumConns: The number of connections established through a listening socket that have been configured with Cache Accelerator support.

ConnsProcessed: The number of connections that have successfully completed an in-kernel transaction, resulting in a response being transmitted to the client. This counter is incremented at most one time per connection.
Tip: It is possible for a single connection to be processed by the Cache Accelerator for some cache entries and then deferred to the application for additional processing. If this occurs, the connection is included in both the ConnsProcessed and ConnsDeferred counts.

ConnsDeferred: The number of connections that require user-space application processing.
Tip: This counter is not incremented because of the connection timeout expiration, even if the action taken is to defer the connection.

ConnsTimedOut: The number of times the connection timeout timer has expired.

RequestsProcessed: The number of requests that were at least partially processed by the Cache Accelerator. This counter can be incremented multiple times for a single connection.
Tip: It is possible for a single connection to be processed by the Cache Accelerator for some cache objects and then deferred to the application for additional processing. If this occurs, the connection is included in both the RequestsProcessed and RequestsDeferred counts.

IncompleteRequests: The number of times that a request is received from the client where additional data is required to process the request. This counter can be incremented multiple times for a single connection.

NumCacheHits: The number of cache objects that were successfully located and transmitted to clients.

NumCacheMisses: The number of cache objects that were not successfully located and transmitted to clients.

NumUnprodCacheHits: The number of cache entries that were successfully found within the cache but not transmitted to the client.