Netstat SLAP/-j report

Displays QoS Policy statistics. By default, all of the QoS policy statistics are displayed. The SUMMARY parameter can be specified to limit the display to summary statistics. Or you can use the POLICYN/-Y filter to display only statistics for a specific policy.

TSO syntax


>>---NETSTAT SLAP--| Modifier |--| Target |--| Output |--| (Filter |---><

Modifier


>>-+-------------+---------------------------------------------><
   +-| ACTIVE |--+   
   '-| SUMmary |-'

ACTIVE: Display QoS policy information only for the activated policies.

SUMmary: Display a summary of QoS policy information.

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.

Filter


>>-POLicyn--policyname-----------------------------------------><

z/OS UNIX syntax


>>---netstat -j--| Modifier |--| Target |--| Output |--| Filter |---><

Modifier


>>-+-------------+---------------------------------------------><
   +-| ACTIVE |--+   
   '-| SUMmary |-'

ACTIVE: Display QoS policy information only for the activated policies.

SUMmary: Display a summary of QoS policy information.

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.

Filter


>>- -Y--policyname---------------------------------------------><

Filter description

POLicyn/-Y policyname

Filter the output of the SLAP/-j report using the specified policy rule name policyname. You can enter one filter value at a time and the specified value can be up to 48 characters long.

The POLicyn/-Y filter value can be a complete string or a partial string using wildcard characters. A wildcard character can be an asterisk (*), which matches a null string or any character or character string, at the same position. A wildcard character can be a question mark (?), which matches any single character at the same position. For example, a string "searchee" matches with "*ar?he*", but the string "searhee" does not match with "*ar?he*".

When you use z/OS UNIX netstat/onetstat command in a z/OS UNIX shell environment, take care if you use a z/OS UNIX MVS™ special character in a character string. It might cause an unpredictable result. To be safe, if you want to use a z/OS UNIX MVS special character in a character string, surround the character string with single quotation marks. For example, to use an asterisk (*) in the policy name, pgnt*rl for the -Y filter, issue the command as: netstat -j -Y 'pgnt*rl'.

Command syntax examples

From TSO environment

NETSTAT SLAP
NETSTAT SLAP SUMMARY

From UNIX shell environment

   netstat -j
   netstat -j SUMMARY

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.

Tip: The Netstat SLAP/-j reports are not affected by the IPv6 enablement and format request.

NETSTAT SLAP

MVS TCP/IP NETSTAT CS V2R1       TCPIP Name: TCPCS           20:30:49 
PolicyRuleName:  ftpd                                          
  FirstActTime:     10/30/2002 20:05:48                               
  LastMapTime:      10/30/2002 20:06:09                      
  TotalBytesIn:     34816                                   
  TotalBytesOut:    86016                                   
  TotalInPackets:   17                                       
  TotalOutPackets:  42                                       
  OutBytesInProf:   28672                                   
  OutPacksInProf:   14                                      
  TotalBytesReTrn:  0                                       
  TotalPacksReTrn:  0                                       
  ReTrnTimeouts:    0                                       
  AcceptConn:       5                                       
  DeniedConn:       1                                       
  ActConnMap:       2             Status:            Active 
  SmoothRTTAvg:     12            SmoothRTTMdev:     7      
  SmoothConnDlyAvg: 5             SmoothConnDlyMdev: 3      
  AcceptQDelayAvg:  2             AcceptQDelayMdev:  2      
PolicyRuleName:  telnetd                                  
  FirstActTime:     10/30/2002 20:29:53                     
  LastMapTime:      10/30/2002 20:30:40                     
  TotalBytesIn:     68                                      
  TotalBytesOut:    108                                     
  TotalInPackets:   2                                       
  TotalOutPackets:  3                                       
  OutBytesInProf:   0                                         
  OutPacksInProf:   0                                         
  TotalBytesReTrn:  0                                         
  TotalPacksReTrn:  0                                         
  ReTrnTimeouts:    0                                         
  AcceptConn:       2                                         
  DeniedConn:       0                                         
  ActConnMap:       2             Status:            Active   
  SmoothRTTAvg:     0             SmoothRTTMdev:     0        
  SmoothConnDlyAvg: 0             SmoothConnDlyMdev: 0        
  AcceptQDelayAvg:  1             AcceptQDelayMdev:  0

NETSTAT SLAP SUMMARY

MVS TCP/IP NETSTAT CS V2R1       TCPIP Name: TCPCS           20:30:49 
PolicyRuleName:  ftpd                                          
  FirstActTime:     10/30/2002 20:05:48                               
  LastMapTime:      10/30/2002 20:06:09                      
  Status:           Active 
PolicyRuleName:  telnetd                                  
  FirstActTime:     10/30/2002 20:29:53                     
  LastMapTime:      10/30/2002 20:30:40                     
  Status:           Active

Report field descriptions

PolicyRuleName: The unique name that identifies the policy rule.

FirstActTime: The time stamp for when the policy rule was first activated.

LastMapTime: The time stamp for when the policy rule was last used.

TotalBytesIn: The number of bytes received by IP for the policy rule.

TotalBytesOut: The number of bytes transmitted by IP for the policy rule.

TotalInPackets: The number of inbound packets received from IP for the policy rule.

TotalOutPackets: The number of outbound packets sent by IP for the policy rule.

OutBytesInProf: This counter counts the number of outbound octets that are determined to be within profile.

OutPacksInProf: This counter counts the number of outbound packets that are determined to be within profile.

TotalBytesReTrn: The number of bytes retransmitted by IP for the policy rule.

TotalPacksReTrn: The number of packets retransmitted by IP for the policy rule.

ReTrnTimeouts: The number of retransmission timeouts for the policy rule.

AcceptConn: This counter is incremented when a policy action (service class) Permission value is set to Allowed and a session (TCP connection) is accepted. It will also be incremented if the policy rule Permission attribute is used.

DeniedConn: This counter is incremented when a policy action Permission value is set to Blocked and a session (TCP connection) is denied, or when a session is rejected due to a policy's connection limit (MaxConnLimit). It will not be incremented if the policy rule Permission attribute is used.

ActConnMap: The number of active TCP connections that are affected by the policy rule.

Status: Displays the status of the policy rule. Valid values are Active and Pending Delete. Active indicates that the policy rule is currently in effect. Pending Delete indicates that the policy rule has been marked for deletion but is currently in use. The policy rule is deleted when the rule is no longer in use.

SmoothRTTAvg: The average TCP round trip time for all TCP traffic affected by this policy rule, smoothed over several sampling intervals to reduce large momentary variations.

SmoothRTTMdev: Mean deviation of the TCP round-trip time, smoothed over several sampling intervals to reduce large momentary variations. This value is a computationally less expensive approximation of the standard deviation for this quantity.

SmoothConnDlyAvg: The average connection delay, smoothed over several sampling intervals to reduce large momentary variations. This is the delay between receipt of the first TCP SYN request and the time that the first data packet is returned by the application.

SmoothConnDlyMdev: Mean deviation of the connection delay, smoothed over several sampling intervals to reduce large momentary variations. This value is a computationally less expensive approximation of the standard deviation for this quantity.

AcceptQDelayAvg: The average accept queue delay. This is the delay between the sending of the TCP SYN ACK for the connection request and the time that the application accepts the connection request.

AcceptQDelayMdev: Mean deviation of the accept queue delay. This value is a computationally less expensive approximation of the standard deviation for this quantity.

Tip: The time displayed in the header of the report is local time. The FirstActTime and LastmapTime fields displayed in the report are Coordinated Universal Time (UTC).