Networking Part of ATS Parallel Sysplex Health Check - IBM€¦ · Networking Part of ATS Parallel...
Transcript of Networking Part of ATS Parallel Sysplex Health Check - IBM€¦ · Networking Part of ATS Parallel...
z/OS Network Health Check
08/27/2014 © Copyright IBM Corporation, 2014 Page 2 of 34
www.ibm.com/support/techdocs item PRS5117 --- Last updated 08/12/2014
z/OS Network Health Check
08/27/2014 © Copyright IBM Corporation, 2014 Page 3 of 34
www.ibm.com/support/techdocs item PRS5117 --- Last updated 08/12/2014
TCP/IP INET or CINET Setting ................................................................. 8
z/OS Startup Settings ................................................................................... 8 SYS1.PARMLIB(IEASYSxx) .................................................................................... 8
SYS1.PARMLIB(BPXPRMxx) ................................................................................. 8
Display OMVS Configuration Files ............................................................ 9 D OMVS ..................................................................................................................... 9
Display CINET Active Routing Table ......................................................... 9 D OMVS,CINET=ALL .............................................................................................. 9
CINET z/OS Health Checker Item ............................................................... 9
TCP/IP Resolver ......................................................................................... 10
Resolver Procedure ................................................................................... 10 SYS1.PROCLIB(resv_proc_name) .......................................................................... 10
Resolver Setup file ..................................................................................... 10 SYS1.TCPPARMS(RSETUP) .................................................................................. 10
Global TCPDATA file ............................................................................... 10 Global TCPIP.DATA file ......................................................................................... 10
Reslover z/OS Health Checker Items ........................................................ 10 z/OS CS Health Check CSRES_AUTOQ_GLOBALTCPIPDATA ........................ 10
z/OS CS Health Check CSRES_AUTOQ_RESOLVEVIA ..................................... 11
z/OS CS Health Check CSRES_AUTOQ_TIMEOUT............................................. 11
TCP/IP Stack ............................................................................................... 12
TCP/IP Procedure ..................................................................................... 12 SYS1.PROCLIB(tcp_stack_name) ........................................................................... 12
TCP/IP Routing ........................................................................................... 12
PROFILE.TCPIP Statements .................................................................... 12 BEGINROUTES/ENDBEGINROUTES .................................................................. 12
GATEWAY .............................................................................................................. 12
OMPROUTE.............................................................................................. 12 OSPF ......................................................................................................................... 12
Display Network Status Command ROUTE .............................................. 13 NETSTAT ROUTE .................................................................................................. 13
TCP/IP Routing z/OS Health Checker Items ............................................ 13 z/OS CS Health Check CSTCP_IPMAXRT4_tcpipstackname ................................ 13
z/OS CS Health Check CSTCP_IPMAXRT6_tcpipstackname ................................ 13
TCP/IP Devices............................................................................................ 14
PROFILE.TCPIP Statements .................................................................... 14 DEVICE and LINK................................................................................................... 14
HOME ....................................................................................................................... 15
INTERFACE............................................................................................................. 15
PRIMARYINTERFACE .......................................................................................... 16
SRCIP ....................................................................................................................... 16
START ...................................................................................................................... 17
z/OS Network Health Check
08/27/2014 © Copyright IBM Corporation, 2014 Page 4 of 34
www.ibm.com/support/techdocs item PRS5117 --- Last updated 08/12/2014
VIPADYNAMIC ...................................................................................................... 17
Display Network Status Commands .......................................................... 17 NETSTAT DEVLINKS ............................................................................................ 17
NETSTAT HOME .................................................................................................... 17
NETSTAT SRCIP ..................................................................................................... 17
NETSTAT VIPADCFG ............................................................................................ 18
TCP/IP Devices z/OS Health Checker Item .............................................. 18
TCP/IP Sysplex, Buffers, and Storage ...................................................... 19
PROFILE.TCPIP Statements .................................................................... 19 GLOBALCONFIG ................................................................................................... 19
IPCONFIG and IPCONFIG6 .................................................................................... 20
SMFCONFIG ............................................................................................................ 22
SMFPARMS ............................................................................................................. 23
SOMAXCONN ......................................................................................................... 23
TCPCONFIG ............................................................................................................ 23
TRANSLATE ........................................................................................................... 24
UDPCONFIG ............................................................................................................ 25
Display Network Status Command CONFIG ............................................ 25 NETSTAT CONFIG ................................................................................................. 25
TCP/IP Sysplex/Buffers/Storage z/OS Health Checker Items ................... 25 z/OS CS Health Check CSTCP_SYSPLEXMON_RECOV_tcpipstackname ......... 25
z/OS CS Health Check CSTCP_TCPMAXRCVBUFRSIZE_tcpipstackname ........ 25
TCP/IP Ports ............................................................................................... 26
PROFILE.TCPIP Statements .................................................................... 26 PORT ........................................................................................................................ 26
PORTRANGE........................................................................................................... 26
Display Network Status Command PORTLIST ......................................... 26 NETSTAT PORTLIST ............................................................................................. 26
TCP/IP Ports z/OS Health Checker Item .................................................. 26 z/OS CS Health Check CSTCP_CINET_PORTRNG_RSV_tcpipstackname ......... 26
IPsec ............................................................................................................. 27
Display Active Policy Definitions ............................................................. 27 pasearch..................................................................................................................... 27
IPsec z/OS Health Checker Item ............................................................... 27 z/OS CS Health Check ZOSMIGV1R11_CS_RFC4301 ......................................... 27
Limits and Trace Settings .......................................................................... 27
TCP/IP CTRACE Settings ......................................................................... 27 SYS1.PARMLIB(CTIEZBxx) .................................................................................. 27
CSM Storage Settings ................................................................................ 27 SYS1.PARMLIB(IVTPRM00) ................................................................................. 27
VTAM Start Options .................................................................................. 28 SYS1.VTAMLST(ATCSTRxx) ............................................................................... 28
Display CSM Storage Usage ..................................................................... 28
z/OS Network Health Check
08/27/2014 © Copyright IBM Corporation, 2014 Page 5 of 34
www.ibm.com/support/techdocs item PRS5117 --- Last updated 08/12/2014
D NET,CSM ............................................................................................................. 28
Display VTAM HPR Buffer Usage ............................................................ 28 D NET,BFRUSE,BUF=(TI,T1,T2) .................................................................. 28
Display VTAM Trace Settings ................................................................... 28 D NET,TRACES....................................................................................................... 28
Limits and Trace z/OS CS Health Checker Items ..................................... 29 z/OS CS Health Check CSTCP_SYSTCPIP_CTRACE_tcpipstackname ................ 29
z/OS CS Health Check CSVTAM_CSM_STG_LIMIT ........................................... 29
z/OS CS Health Check CSVTAM_T1BUF_T2BUF_EE ......................................... 29
z/OS CS Health Check CSVTAM_T1BUF_T2BUF_NOEE ................................... 29
z/OS CS Health Check CSVTAM_VIT_DSPSIZE .................................................. 29
z/OS CS Health Check CSVTAM_VIT_OPT_ALL ................................................ 29
z/OS CS Health Check CSVTAM_VIT_OPT_PSSSMS ......................................... 29
z/OS CS Health Check CSVTAM_VIT_SIZE ......................................................... 29
Removed TCP/IP Applications .................................................................. 30
Display Network Status Command ALL .................................................... 30 NETSTAT ALL ........................................................................................................ 30
Display System Activity List ...................................................................... 30 D A,L ........................................................................................................................ 30
Removed TCP/IP Applications z/OS Health Checker Items ..................... 30 z/OS CS Health Check ZOSMIGV1R10_CS_BIND4 ............................................. 30
z/OS CS Health Check ZOSMIGV1R10_CS_BINL ................................................ 30
z/OS CS Health Check ZOSMIGV1R10_CS_DHCP .............................................. 30
z/OS CS Health Check ZOSMIGV1R10_CS_NDB................................................. 31
z/OS CS Health Check ZOSMIGV1R11_CS_DNSBIND9 ..................................... 31
Discontinued SNA VTAM Equipment ..................................................... 31
Older Technology ...................................................................................... 31 3745 and 3746 (withdrawal from Marketing 2002) .................................................. 31
CIP ............................................................................................................................ 31
Token Ring................................................................................................................ 31
Native SNA ............................................................................................................... 31
Manuals ........................................................................................................ 32
z/OS Network Health Check
08/27/2014 © Copyright IBM Corporation, 2014 Page 6 of 34
www.ibm.com/support/techdocs item PRS5117 --- Last updated 08/12/2014
Registered Trademarks:
The following are Registered Trademarks of the International Business
Machines Corporation in the United States and/or other countries.
• IBM
• z/OS
Microsoft is a registered trademark of Microsoft Corporation in the United
States and other countries.
All other products may be trademarks or registered trademarks of their
respective companies.
Refer to www.ibm.com/legal/us for further legal information.
Note: This document is in no way a complete list of items reviewed as part
of a Health Check. In addition to everything covered in this document, the
latest release enhancements are also reviewed for their relevance. However,
this document is a good starting point for any Health Check.
Note: Statements are not listed in entirety; parameters and statements have
been left out. Only parameters and statements that are of interest to the topic
are listed. Items marked in blue are recommended and items marked in red
are not recommended.
z/OS Network Health Check
08/27/2014 © Copyright IBM Corporation, 2014 Page 7 of 34
www.ibm.com/support/techdocs item PRS5117 --- Last updated 08/12/2014
z/OS Network Health Check
08/27/2014 © Copyright IBM Corporation, 2014 Page 8 of 34
www.ibm.com/support/techdocs item PRS5117 --- Last updated 08/12/2014
TCP/IP INET or CINET Setting
z/OS Startup Settings
SYS1.PARMLIB(IEASYSxx)
OMVS statement points to BPXPRMxx files
• OMVS(suffix1,suffix2,…)
• OMVS(01,02) points to BPXPRM01 and BPXPRM02
SYS1.PARMLIB(BPXPRMxx)
BPXPRMxx Statements
• Resolver proc name
o RESOLVER_PROC(resv_proc_name)
o RESOLVER_PROC(RESOLVER) (default)
• TCP/IP stack
o FILESYSTYPE TYPE(type_name)
ENTRYPOINT(entry_name)
NETWORK DOMAINNAME(sockets_domain_name)
DOMAINNUMBER(sockets_domain_name)
MAXSOCKETS(nnnnn)
TYPE(type_name)
INADDRANYPORT(starting_port_number)
INADDRANYCOUNT(number_of_ports_to_reserve)
SUBFILESYSTYPE TYPE(type_name) NAME(stack_proc_name)
ENTRYOINT(entry_name) DEFAULT
o Single TCP/IP stack per z/OS (INET)
FILESYSTYPE TYPE(INET)
ENTRYPOINT(EZBPFINI)
NETWORK DOMAINNAME(AF_INET)
DOMAINNUMBER(2)
MAXSOCKETS(64000)
TYPE(INET)
INADDRANYPORT(5000)
INADDRANYCOUNT(100)
o Multiple TCP/IP stacks per z/OS (CINET)
FILESYSTYPE TYPE(CINET)
ENTRYPOINT(BPXTCINT)
NETWORK DOMAINNAME(AF_INET)
DOMAINNUMBER(2)
MAXSOCKETS(64000)
TYPE(CINET)
INADDRANYPORT(2000)
INADDRANYCOUNT(325)
z/OS Network Health Check
08/27/2014 © Copyright IBM Corporation, 2014 Page 9 of 34
www.ibm.com/support/techdocs item PRS5117 --- Last updated 08/12/2014
SUBFILESYSTYPE TYPE(CINET) NAME(TCPIP1)
ENTRYOINT(EZBPFINI) DEFAULT
SUBFILESYSTYPE TIME(CINET) NAME(TCPIP2)
ENTRYPOINT(EZBPFINI)
Display OMVS Configuration Files
D OMVS
Displays the SYS1.PARMLIB(IEASYSxx) suffixes for BPXPRMxx files defined on
OMVS statement.
Display CINET Active Routing Table
D OMVS,CINET=ALL
Displays the active CINET routing table which includes all TCP/IP stacks.
CINET z/OS Health Checker Item
There is no CINET Health Check, but INET is recommended. CINET is still used by
some customers for security reasons. When using CINET it is important not to connect
multiple TCP/IP stacks to the same network due to routing issues. The D
OMVS,CINET=ALL command should be used to confirm routing is as desired.
z/OS Network Health Check
08/27/2014 © Copyright IBM Corporation, 2014 Page 10 of 34
www.ibm.com/support/techdocs item PRS5117 --- Last updated 08/12/2014
TCP/IP Resolver See SYS1.PARMLIB(BPXPRMxx) for Resolver Proc name specification.
Resolver Procedure
SYS1.PROCLIB(resv_proc_name)
SYS1.PROCLIB(RESOLVER) (default)
Resolver Proc Statements
• SETUP DD statement points to Resolver Setup file
• SYS1.TCPPARMS(RSETUP)
• Examples in sample
//*SETUP DD DSN=TCPIP.TCPPARMS(SETUPRES),DISP=SHR,FREE=CLOSE
//*SETUP DD DSN=TCPIP.SETUP.RESOLVER,DISP=SHR,FREE=CLOSE
//*SETUP DD PATH=’/etc/setup.resolver’,PATHOPTS=(ORDONLY)
Resolver Setup file
SYS1.TCPPARMS(RSETUP)
Resolver Setup file statements
• GLOBALTCPIPDATA statement points to Global TCPIP.DATA
o GLOBALTCPIPDATA ‘dataset_name’
o GLOBALTCPIPDATA /path/file_name
• UNRESPONSIVETHRESHOLD(percentage,AUTOQUIESCE)
o UNRESPONSIVETHRESHOLD(25) (default)
o UNRESPONSIVETHRESHOLD(25,AUTOQUIESCE)
Global TCPDATA file
Global TCPIP.DATA file
Global TCPIP.DATA Statements
• RESOLVERTIMEOUT time_out_value_seconds
o RESOLVERTIMEOUT 5 (default)
• RESOLVEVIA
o RESOLVEVIA UDP (default)
o RESOLVEVIA TCP
Reslover z/OS Health Checker Items
z/OS CS Health Check CSRES_AUTOQ_GLOBALTCPIPDATA
In Resolver Setup file, if AUTOQUIESCE is coded on UNRESPONSIVETHRESHOLD
then GLOBALTCPIPDATA should be defined, otherwise AUTOQUIESCE is ignored.
z/OS Network Health Check
08/27/2014 © Copyright IBM Corporation, 2014 Page 11 of 34
www.ibm.com/support/techdocs item PRS5117 --- Last updated 08/12/2014
z/OS CS Health Check CSRES_AUTOQ_RESOLVEVIA
In Resolver Setup file, if AUTOQUIESCE is coded on UNRESPONSIVETHRESHOLD
then in Global TCPIP.DATA RESOLVEVIA TCP should not be coded (default is UDP).
z/OS CS Health Check CSRES_AUTOQ_TIMEOUT
In Resolver Setup file, if AUTOQUIESCE is coded on UNRESPONSIVETHRESHOLD
then in Global TCPIP.DATA RESOLVERTIMEOUT should not be coded > 5 (default is
5).
z/OS Network Health Check
08/27/2014 © Copyright IBM Corporation, 2014 Page 12 of 34
www.ibm.com/support/techdocs item PRS5117 --- Last updated 08/12/2014
TCP/IP Stack See SYS1.PARMLIB(BPXPRMxx) for TCP/IP stack name specification.
TCP/IP Procedure
SYS1.PROCLIB(tcp_stack_name)
SYS1.PROCLIB(TCPIP)
TCP/IP Proc Statements
• PROFILE DD statement points to TCP/IP Configuration file
• SYS1.TCPPARMS(PROFILE)
• Example in sample
o //PROFILE DD DISP=SHR,DSN=MVSA.PROD.PARMS(PROFILE)
• CTIEZBxx member in SYS1.PARMLIB is defined in TCP/IP Proc
o //TCPIP PROC PARMS=’CTRACE(CTIEZB00)’
TCP/IP Routing See SYS1.PROCLIB(TCPIP) for TCP/IP profile specification.
PROFILE.TCPIP Statements
BEGINROUTES/ENDBEGINROUTES
Use the BEGINROUTES statement to add static routes to the route table.
• BEGINROUTES
• ROUTE dest_ipaddr addr_mask = intf_name MTU mtu_size DELAYACKS
• ROUTE dest_ipaddr HOST gateway_addr intf_name MTU mtu_size DELAYACKS
• ROUTE dest_ipaddr/num_mask_bits = intf_name MTU mtu_size DELAYACKS
• ROUTE DEFAULT = intf_name MTU mtu_size DELAYACKS
• ROUTE DEFAULT6 = intf_name MTU mtu_size DELAYACKS
• ROUTE dest_ipaddr/prefix_length = intf_name MTU mtu_size DELAYACKS
• ROUTE dest_ipaddr HOST gateway_addr intf_name MTU mtu_size DELAYACKS
• ENDBEGINROUTES
GATEWAY
GATEWAY statement is an outdated way to add static routes to the route table. The
BEGINROUTES/ENDROUTES statement is the recommended statement for defining
static routes because it has more capabilities. Migrate to the BEGINROUTES statement.
OMPROUTE
OSPF
It is recommended that the mainframe be defined as an OSPF Stub Area to avoid the
overhead involved in being a non-Stub Area.
z/OS Network Health Check
08/27/2014 © Copyright IBM Corporation, 2014 Page 13 of 34
www.ibm.com/support/techdocs item PRS5117 --- Last updated 08/12/2014
Display Network Status Command ROUTE
NETSTAT ROUTE
Displays the active routing table which includes all routes defined by static routing and
learned by dynamic routing protocols, both IPv4 and IPv6 routes. Static routing is
defined in the PROFILE.TCPIP using the BEGINROUTES/ENDROUTES or
GATEWAY parameters. Dynamic routing is defined in the OMPROUTE configuration
file.
• /D TCPIP,tcp_proc_name,NETSTAT,ROUTE,MAX=*
• /D TCPIP,tcp_proc_name,NETSTAT,ROUTE,MAX=*
• /D TCPIP,tcp_proc_name,NETSTAT,ROUTE,ADDRTYPE=IPV4,MAX=*
• /D TCPIP,tcp_proc_name,NETSTAT,ROUTE,ADDRTYPE=IPV6,MAX=*
• OMVS netstat –r
• OMVS netstat –r ADDRTYPE IPV4
• OMVS netstat –r ADDRTYPE IPV6
• TSO NETSTAT ROUTE
• TSO NETSTAT ROUTE ADDRTYPE IPV4
• TSO NETSTAT ROUTE ADDRTYPE IPV6
TCP/IP Routing z/OS Health Checker Items
z/OS CS Health Check CSTCP_IPMAXRT4_tcpipstackname
In the output from the D TCPIP,,NETSTAT,ROUTE command, the total number of IPv4
routes should be less than 2000.
z/OS CS Health Check CSTCP_IPMAXRT6_tcpipstackname
In the output from the D TCPIP,,NETSTAT,ROUTE command, the total number of IPv6
routes should be less than 2000.
z/OS Network Health Check
08/27/2014 © Copyright IBM Corporation, 2014 Page 14 of 34
www.ibm.com/support/techdocs item PRS5117 --- Last updated 08/12/2014
TCP/IP Devices See SYS1.PROCLIB(TCPIP) for TCP/IP profile specification.
PROFILE.TCPIP Statements
DEVICE and LINK
The Device and Link statements configure your network devices (Network Interface
(NIC) cards).
These devices are not supported on the latest System z hardware:
• DEVICE device_name ATM PORTNAME port_name
LINK link_name ATM device_name
• DEVICE dev_name CLAW dev_num host_cl_name ws_cl_name
LINK link_name IP 0 device_name
• DEVICE device_name HCH base_device_number
LINK link_name HCH adapter_addr device_name
• DEVICE device_name LCS device_number
LINK link_name IBMTR link_number device_name
• DEVICE device_name LCS device_number
LINK link_name FDDI link_number device_name
• DEVICE device_name MPCIPA
LINK link_name IPAQTR device_name
• DEVICE device_name MPCOSA
LINK link_name OSAFDDI link_number device_name
• DEVICE device_name CDLC device_number
LINK link_name CDLC adapter_addr device_name
These devices should be migrated to OSA QDIO Interface statements:
• DEVICE device_name MPCIPA
LINK link_name IPAQENET device_name
• DEVICE device_name MPCOSA
LINK link_name OSAENET link_number device_name
• DEVICE device_name MPCPTP
LINK link_name MPCPTP device_name
o Manually defined MPCPTP IUTSAMEH and XCF between the TCP/IP stack
and VTAM for EE, as well as XCF to other members of the same sysplex are
not recommended. Migrate from manual MPCPTP definitions to dynamically
defined devices using the DynamicXCF parameter on the IPCONFIG and
IPCONFIG6 statements.
o Old MPCPTP channel attached devices like RS/6000, Cisco CIP, and CS/NT
are not supported on the latest System z hardware. Migrate from those devices
to Ethernet OSA QDIO devices defined with the Interface statement.
z/OS Network Health Check
08/27/2014 © Copyright IBM Corporation, 2014 Page 15 of 34
www.ibm.com/support/techdocs item PRS5117 --- Last updated 08/12/2014
These devices should be migrated to EE:
• DEVICE device_name LCS device_number
LINK link_name ETHERNET link_number device_name
LINK link_name 802.3 link_number device_name
LINK link_name ETHEROR802.3 link_number device_name
• DEVICE device_name SNAIUCV SNALINK lu_name proc_name
LINK link_name SAMEHOST link_number device_name
LINK link_name IUCV link_number device_name
• DEVICE device_name SNALU62 proc_name
LINK link_name SAMEHOST link_number device_name
LINK link_name IUCV link_number device_name
• DEVICE device_name X25NPSI proc_name
LINK link_name SAMEHOST link_number device_name
LINK link_name IUCV link_number device_name
HOME
Provides the list of home IPv4 addresses and associated link names.
• HOME
internet_addr link_name
• HOME
10.5.50.16 OSA15A
INTERFACE
Use the INTERFACE statement to specify an OSA QDIO Ethernet interface.
• Interface may be used instead of DEVICE, LINK, and HOME statements.
• INTERFACE int_name DEFINE IPAQENET PORTNAME port_name IPADDR
ipaddr_spec PRIROUTER VLANID vlan_id INBPERF DYNAMIC WORKLOADQ
VMAC mac_addr OLM
• INTERFACE int_name DEFINE IPAQENET CHPIDTYPE OSX CHPID chp_id
PORTNAME port_name IPADDR ipv4_addr/num_mask_bits VLANID vlan_id
• INTERFACE int_name DEFINE IPAQENET6 PORTNAME port_name IPADDR
ipaddr_spec
• INTERFACE int_name DEFINE IPAQIDIO6 CHPIDTYPE OSX CHPID chp_id
IPADDR ipaddr_spec
• INTERFACE LOOPBACK6 ADDR ipaddr_spec
• INTERFACE int_name DEFINE MPCPTP6 IPADDR ipaddr_spec TRLENAME
trle_name
• INTERFACE int_name DEFINE VIRTUAL6 IPADDR ipaddr_spec
o Interface is recommended instead of Device/Link.
o INBPERF DYNAMIC WORKLOADQ enables Inbound Workload Queuing
(IWQ) that automatically provides unique input queues for workload Sysplex
Distributor, Bulk Data, and Enterprise Extender (EE).
• WORKLOADQ requires z/OS V1.13
z/OS Network Health Check
08/27/2014 © Copyright IBM Corporation, 2014 Page 16 of 34
www.ibm.com/support/techdocs item PRS5117 --- Last updated 08/12/2014
• Prevents out of order packets (inbound and outbound) and the overhead
associated with them.
o PRIROUTER identifies a TCP/IP stack for packets with destination IP
addresses that are not loaded into the OSA.
• PRIROUTER designation for a shared OSA is not recommended.
• Use of VMAC is the preferred parameter for a shared OSA definition.
o OLM enables Optimized Latency Mode.
• OLM is rarely desired because it is only recommended when reducing
Latency is the most critical factor (ie. More important than reducing CPU
overhead, etc.)
• When OLM is defined QDIO Accelerator (or HiperSockets Accelerator)
will not accelerate the traffic.
• When OLM is specified INBPERF is automatically set to DYNAMIC.
• Interfaces sharing an OSA port using OLM is limited to four.
• Each Interface statement counts toward the 4 Interface limit:
� LPAR TCP/IP stack using the OSA port
� VLAN defined for this OSA port
� Protocol (IPv4 or IPv6) interface defined for this OSA port
� TCP/IP stack on the same LPAR using the OSA port
� TCP/IP stack activating the OSA-E Network Traffic Analyzer
(OSAENTA)
PRIMARYINTERFACE
Specify which interface is to be designated as default local host for use by the
GETHOSTID() function. The PRIMARYINTERFACE statement's IP address is not used
as the source IP address for any out-going datagrams.
• PRIMARYINTERFACE intf_name
SRCIP
Specifies the Source IP address.
• Use the SRCIP statement to do the following:
o Designate source IP addresses for certain outbound TCP connections or server
applications
o Designate whether to prefer a public or a temporary IPv6 address when the
algorithm for default source address selection is used to select the source IP
address for certain outbound TCP connections or for outbound UDP or RAW
packets
• The SRCIP block does not require you to specify the SOURCEVIPA parameter on
either the IPCONFIG statement or the IPCONFIG6 statement. o SRCIP DESTINATION dest_ipaddr_spec source_ipaddr_spec ENDSRCIP o SRCIP jobname source_ipaddr_spec ENDSRCIP
o SRCIP jobname TEMPADDRS ENDSRCIP
o SRCIP jobname PUBLICADDRS ENDSRCIP
z/OS Network Health Check
08/27/2014 © Copyright IBM Corporation, 2014 Page 17 of 34
www.ibm.com/support/techdocs item PRS5117 --- Last updated 08/12/2014
START
Starts a device or interface that is currently stopped.
• START device_name
• START interface_name
VIPADYNAMIC
Specifies a block of definitions related to Dynamic VIPAs (DVIPAs) and Sysplex
Distributor.
• VIPADEFINE is used to define a DVIPA.
• VIPADISTRIBUTE is used to define Sysplex Distributor.
• BASEWLM is the default distribution method. SERVERWLM is recommended
instead of BASEWLM because it provides distribution based on more granular WLM
information. BASEWLM is the default.
o VIPADYNAMIC
o VIPADEFINE address_mask ip_addr
o VIPADEFINE ipv6_intf ipv6_addr_spec o VIPADISTRIBUTE DISTMETHOD BASEWLM ip_addr_spec DISTIP ALL
o VIPADISTRIBUTE DISTMETHOD SERVERWLM ip_addr_spec DISTIP ALL o VIPADISTRIBUTE DISTMETHOD ROUNDROBIN ip_addr_spec DISTIP ALL o ENDVIPADYNAMIC
Display Network Status Commands
NETSTAT DEVLINKS
Displays the settings defined on the DEVICE, LINK, and INTERFACE statements in the
PROFILE.TCPIP file.
• /D TCPIP,tcp_proc_name,NETSTAT,DEVLINKS
• OMVS netstat –d
• TSO NETSTAT DEVLINKS
NETSTAT HOME
Displays the settings defined on the HOME and INTERFACE statements in the
PROFILE.TCPIP file.
• /D TCPIP,tcp_proc_name,NETSTAT,HOME
• OMVS netstat –h
• TSO NETSTAT HOME
NETSTAT SRCIP
Displays the settings defined on the SRCIP statement in the PROFILE.TCPIP file.
• /D TCPIP,tcp_proc_name,NETSTAT,SRCIP
• OMVS netstat –J
• TSO NETSTAT SRCIP
z/OS Network Health Check
08/27/2014 © Copyright IBM Corporation, 2014 Page 18 of 34
www.ibm.com/support/techdocs item PRS5117 --- Last updated 08/12/2014
NETSTAT VIPADCFG
Displays the settings defined on the VIPADYNAMIC statement in the PROFILE.TCPIP
file.
• /D TCPIP,tcp_proc_name,NETSTAT,VIPADCFG
• OMVS netstat –F
• TSO NETSTAT VIPADCFG
TCP/IP Devices z/OS Health Checker Item
There is no TCP/IP Devices Health Check, but IBM z/OS Resource Measurement
Facility (RMF) should always be used to identify hardware capacity usage for OSA-
Express, HiperSockets, Central Processor, zIIP (IBM System z Integrated Information
Processor), etc.
z/OS Network Health Check
08/27/2014 © Copyright IBM Corporation, 2014 Page 19 of 34
www.ibm.com/support/techdocs item PRS5117 --- Last updated 08/12/2014
TCP/IP Sysplex, Buffers, and Storage See SYS1.PROCLIB(TCPIP) for TCP/IP profile specification.
PROFILE.TCPIP Statements
GLOBALCONFIG
Global TCP/IP configuration parameter
• ECSA Storage Limit
o Specifies the maximum amount of extended common service area (ECSA)
storage that TCP/IP can use. While limiting the amount of ECSA that TCP/IP
can use may sound counter productive, the benefit of defining the ECSA limit
is messages that are generated when ECSA usage approaches the defined
limit. This is most beneficial to customers with ECSA usage concerns.
• ECSALIMIT ecsa_limitK
• ECSALIMIT ecsa_limitM
• HiperSockets Multiwrite
o HiperSockets multiple write might reduce CPU usage and might provide a
performance improvement for large outbound messages that are typically
generated by traditional streaming workloads such as file transfer, and
interactive web-based services workloads such as XML or SOAP.
• IQDMULTIWRITE
• Private Storage Limit
o Specifies the maximum amount of private storage that TCP/IP can use. While
limiting the amount of private storage that TCP/IP can use may sound counter
productive, the benefit of defining the private storage limit is messages that
are generated when private storage usage approaches the defined limit. This is
most beneficial to customers with private storage usage concerns.
• POOLLIMIT pool_limitK
• POOLLIMIT pool_limitM
• Segmentation Offload
o Outdated method of specifying whether the stack should offload TCP
segmentation for IPv4 packets to OSA. This parameter will be removed in a
later release.
o Specify Segmentation Offload on the IPCONFIG statement instead.
• SEGMENTATIONOFFLOAD
• Sysplex Monitor
o Defines the monitor subparameters for the sysplex autonomics function.
o RECOVERY option is a recommended setting.
• SYSPLEXMONITOR AUTOREJOIN
• SYSPLEXMONITOR DELAYJOIN
• SYSPLEXMONITOR MONINTERFACE DYNROUTE
• SYSPLEXMONITOR RECOVERY
• SYSPLEXMONITOR TIMERSECS seconds
z/OS Network Health Check
08/27/2014 © Copyright IBM Corporation, 2014 Page 20 of 34
www.ibm.com/support/techdocs item PRS5117 --- Last updated 08/12/2014
• WLM Priority Queue
o Specifies whether OSA QDIO write priority values should be assigned to
outbound packets associated with WorkLoad Manager (WLM) service
classes. This may be of benefit to different types of traffic, including
Enterprise Extender (EE) packets. However, WLM Priority Queue does have
CP overhead associated with it. The CP overhead must be evaluated with the
priority queuing.
• WLMPRIORITYQ
• zIIP Offload
o Specifies subparameters that control whether TCP/IP displaces CPU cycles
onto a System z Integrated Information Processor (zIIP).
• ZIIP IPSECURITY
• Specifies whether TCP/IP should displace CPU cycles for
IPsec workload to a zIIP. Since zIIP cycles are cheaper than
regular CP cycles it is always recommended to code this
parameter if zIIP is available and IPsec is in use.
• ZIIP IQDIOMULTIWRITE
• Specifies whether TCP/IP should displace CPU cycles for large
outbound TCP messages that are typically created by
traditional streaming work loads such as file transfer, and
interactive web-based service workloads such as XML or
SOAP. The TCP/IP outbound message must be at 32KB in
length before the write processing is off-loaded to an available
zIIP specialty engine.
• Specifies whether TCP/IP should displace CPU cycles for
HiperSockets workload to a zIIP. Since zIIP cycles are cheaper
than regular CP cycles it is always recommended to code this
parameter if HiperSockets is in use and the message size is at
least 32KB.
IPCONFIG and IPCONFIG6
IPv4 (IPCONFIG) and IPv6 (IPCONFIG6) IP layer settings
• Check Sum Offload (IPCONFIG only)
o Specifies whether the stack should offload inbound and outbound checksum
processing (IP header, TCP, and UDP checksums) for IPv4 packets to OSA.
o Check Sum Offload is recommended to offload CP cycles to the OSA.
• CHECKSUMOFFLOAD (default)
• CLAW Use Double NOP (IPCONFIG only)
o Forces channel programs for CLAW devices (channel attached routers) to
have two NOP CCWs to end the channel programs.
o Channel attached routers are not supported on the latest System z. Migrate
CLAW devices to Ethernet OSA QDIO defined with Interface statement.
• CLAWUSEDOUBLENOP
• Dynamic XCF (IPCONFIG and IPCONFIG6)
o Defines TCP/IP XCF support.
o DynamicXCF is recommended for XCF sysplex support.
z/OS Network Health Check
08/27/2014 © Copyright IBM Corporation, 2014 Page 21 of 34
www.ibm.com/support/techdocs item PRS5117 --- Last updated 08/12/2014
o The VTAM ISTLSXCF major node must be active for TCP/IP DynamicXCF,
except when there are multiple TCP/IP stacks on the same MVS image or
HiperSockets is configured and enabled across multiple z/OS systems that are
in the same sysplex.
o When using DynamicXCF for Sysplex configuration, make sure that
XCFINIT=YES or XCFINIT=DEFINE is coded in the VTAM start options,
or if XCFINIT=NO was specified, ensure that a VARY ACTIVATE
command is issued for the ISTLSXCF major node.
• DYNAMICXCF ipaddr_spec
• DYNAMICXCF ipv4_addr subnet_mask cost_metric
• DYNAMICXCF ipv4_addr/num_mask_bits cost_metric
• DYNAMICXCF ipv6_addr
• DYNAMICXCF ipv6_addr/prefix_route_len
• Command Output Format (FORMAT)
o Determines the format of the command output.
o Long format is automatic when the stack supports IPv6. When the system is
upgraded to a new operating system release it is always required to check
command output changes if automation is defined. Therefore, migration to
FORMAT LONG is recommended at the next z/OS upgrade in preparation for
future IPv6 implementation.
• FORMAT LONG
• FORMAT SHORT
• HiperSockets Accelerator (IPCONFIG only)
o Specifies that inbound/outbound packets that are to be forwarded by this
TCP/IP stack are eligible to be routed directly between a HiperSockets device
and an OSA device in QDIO mode without needing to be sent to this TCP/IP
stack for forwarding.
o Requires DATAGRAMFWD parameter to be specified or defaulted or it only
applies to Sysplex Distributor traffic.
o Not supported if IPSECURITY or QDIOACCELERATOR are specified.
o QDIOACCELERATOR is the preferred method of Accelerator.
o Migrate from IQDIOROUTING to QDIOACCELERATOR.
• IQDIOROUTING
• QDIO Accelerator (IPCONFIG only)
o Specifies that inbound packets that are to be forwarded by this TCP/IP stack
are eligible to be routed directly between any of the following combinations of
interface types:
• A HiperSockets interface and an OSA-Express QDIO interface
• Two OSA-Express QDIO interfaces
• Two HiperSockets interfaces
o Requires DATAGRAMFWD parameter to be specified or defaulted or it only
applies to Sysplex Distributor traffic.
o Not supported if IPSECURITY is specified.
o QDIOACCELERATOR is preferred over IQDIOROUTING.
• QDIOACCELERATOR
z/OS Network Health Check
08/27/2014 © Copyright IBM Corporation, 2014 Page 22 of 34
www.ibm.com/support/techdocs item PRS5117 --- Last updated 08/12/2014
• Path MTU Discovery (IPCONFIG only)
o Indicates that TCP/IP is to dynamically discover the the smallest MTU of all
the hops in the path. This parameter prevents fragmentation of datagrams.
o PathMTUDiscovery uses ICMP fragmentation-needed errors to detect the
PMTU for a path. It does not function if a firewall blocks ICMP errors.
o PathMTUDiscovery is recommended when defining Jumbo Frames, MTU
8992.
• PATHMTUDISCOVERY
• Segmentation Offload (IPCONFIG and IPCONFIG6)
o Specifies if stack should offload TCP segmentation for IPv4 packets to OSA.
o Definition here on the IPCONFIG statement is preferred to the GlobalConfig.
• SEGMENTATIONOFFLOAD
• SOURCEVIPA (IPCONFIG and IPCONFIG6)
o Causes TCP/IP to use the TCPSTACKSOURCEVIPA address (if specified)
or the corresponding virtual IP address VIPA in the HOME list as the source
IP address for outbound datagrams that do not have an explicit source address.
o SRCIP profile statement is the recommended method for identifying source IP
addresses. Migrate from SOURCEVIPA to SRCIP.
• SOURCEVIPA
• STOPONCLAWERROR (IPCONFIG only)
o Causes channel programs to stop (HALTIO and HALTSIO) when a device
error is detected.
o Channel attached routers are not supported on the latest System. Migrate from
CLAW devices to Ethernet OSA QDIO defined with the Interface statement.
• STOPONCLAWERROR
• SYSPLEXROUTING (IPCONFIG only)
o Specifies that this TCP/IP host is part of a sysplex domain.
o Communicates interface changes within a sysplex to the Workload Manager
(WLM).
• SYSPLEXROUTING
• TCPSTACKSOURCEVIPA (IPCONFIG and IPCONFIG6)
o The IPv4 address (vipa_addr) is used as the source IP address for outbound
TCP connections if SOURCEVIPA has been enabled.
o SRCIP profile statement is the recommended method for identifying source IP
addresses. Migrate from TCPSTACKSOURCEVIPA to SRCIP.
• TCPSTACKSOURCEVIPA vipa_addr
• TCPSTACKSOURCEVIPA intf_name
SMFCONFIG
Provides SMF logging for Telnet, FTP, IPSec, TCP API, and TCP stack activity.
• Type 119 records support IPv6 and are updated with the latest features. Type 119
records are recommended.
• TCPTERM records include all the information that is contained in TCPINIT records.
Therefore, TCPTERM records are recommended instead of TCPINIT records.
o SMFCONFIG TYPE 118 FTPCLIENT
z/OS Network Health Check
08/27/2014 © Copyright IBM Corporation, 2014 Page 23 of 34
www.ibm.com/support/techdocs item PRS5117 --- Last updated 08/12/2014
o SMFCONFIG TYPE 118 TCPINIT
o SMFCONFIG TYPE 118 TCPIPSTATISTICS
o SMFCONFIG TYPE 118 TCPTERM
o SMFCONFIG TYPE 118 TN3270CLIENT
o SMFCONFIG TYPE 119 FTPCLIENT
o SMFCONFIG TYPE 119 TCPINIT
o SMFCONFIG TYPE 119 TCPIPSTATISTICS
o SMFCONFIG TYPE 119 TCPTERM
o SMFCONFIG TYPE 119 TN3270CLIENT
SMFPARMS
Indicates logging TCP use by applications using SMF Type 118 log records. You can log
Telnet and FTP client activity, and TCP API activity.
• Type 119 records have default subtype values that are not installation-
configurable.
• Type 119 records support IPv6 and are updated with the latest features. Type 119
records are recommended, using the SMFCONFIG statement.
o SMFPARMS init_type term_type client_type
SOMAXCONN
Specifies the maximum number of connection requests queued for any listening socket.
• It is recommended to set SOMAXCONN to 1024 or higher.
• SOMAXCONN max_queue_depth
• SOMAXCONN 10 (default)
• SOMAXCONN 1024
TCPCONFIG
TCP layer settings
• Delay Acknowledgements
o Delays transmission of acknowledgments when a packet is received with the
PUSH bit on in the TCP header.
o NODELAYACKS on the PORT, PORTRANGE, BEGINROUTES, or
OMPROUTE statements is preferred to globally defining NODELAYACKS
on the TCPPARMS statement (allow to default to DELAYACKS).
� NODELAYACKS
• Finish Wait 2 Timer
o Number of seconds a TCP connection should remain in the FINWAIT2 state.
o When timer expires, it is reset to 75 seconds and when it expires a second
time, the connection is dropped.
o The default 600 seconds is correct for most applications but some applications
that do not complete properly may benefit from a lower value.
• FINWAIT2TIME finwait2_secs
• Restrict Low Ports
o Reserves ports 1- 1 023 for users by the PORT and PORTRANGE statements.
o When RESTRICTLOWPORTS is specified, an application cannot obtain a
port in the 1- 1 023 range unless it is authorized.
z/OS Network Health Check
08/27/2014 © Copyright IBM Corporation, 2014 Page 24 of 34
www.ibm.com/support/techdocs item PRS5117 --- Last updated 08/12/2014
� Applications defined on PORT or PORTRANGE can access the
port(s) they are defined to.
� APF authorized applications can access unreserved low ports.
� OMVS superuser (UID(0)) applications can access unreserved low
ports.
• RESTRICTLOWPORTS
• TCP Maximum Receive Buffer Size
o Maximum receive buffer size an application can set using SETSOCKOPT().
o If an FTP Server is running, then TCP Max Receive Buffer Size should be at
least 184320 (180K).
o Value must be at least 65536 (64K) or Dynamic Right Sizing (DRS) will not
occur.
• If DRS is performed the window size may grow up to 2M which can
benefit a reliable but high latency link (ie. satellite).
o The default has changed between releases.
• TCPMAXRCVBUFRSIZE tcp_max_receive_buffer_size
• TCPMAXRCVBUFRSIZE 256K
• TCP Receive Buffer Size
o The initial receive buffer size for those applications which do not explicitly set
the buffer size using SETSOCKOPT().
o Value must be at least 65536 (64K) or Dynamic Right Sizing (DRS) will not
occur.
• If DRS is performed the window size may grow up to 2M which can
benefit a reliable but high latency link (ie. satellite).
• TCPRCVBUFRSIZE tcp_receive_buffer_size
• TCP Send Buffer Size
o The initial send buffer size for those applications that do not explicitly set the
buffer size using SETSOCKOPT().
o Value must be at least 65536 (64K) or Dynamic Right Sizing (DRS) will not
occur.
• If DRS is performed the window size may grow up to 2M which can
benefit a reliable but high latency link (ie. satellite).
• TCPSENDBFRSIZE tcp_send_buffer_size
• TCP Time Stamp
o Specifies TCP Time Stamps to be sent on segments.
o This option should be enabled to help prevent wrapping of sequence numbers
or to prevent a connection from receiving a delayed segment that was
originally intended for an earlier incarnation of the connection.
o The sequence numbers can wrap more quickly with higher bandwidth
networks.
� TCPTIMESTAMP (default)
TRANSLATE
o Indicates the relationship between an IP address and the physical address, on a
specified link.
o Used for hosts that do not support ARP.
z/OS Network Health Check
08/27/2014 © Copyright IBM Corporation, 2014 Page 25 of 34
www.ibm.com/support/techdocs item PRS5117 --- Last updated 08/12/2014
o Translate is not required on current OSA hardware.
� TRANSLATE ip_addr NSAP physical_addr link_name
� TRANSLATE ip_addr HCH physical_addr link_name
� TRANSLATE ip_addr ETHERNET physical_addr link_name
� TRANSLATE ip_addr IBMTR physical_addr link_name
� TRANSLATE ip_addr FDDI physical_addr link_name
UDPCONFIG
UDP layer settings
• Restrict Low Ports
o Reserves ports 1- 1 023 for users by the PORT and PORTRANGE statements.
o When RESTRICTLOWPORTS is specified, an application cannot obtain a
port in the 1- 1 023 range unless it is authorized.
� Applications defined on PORT or PORTRANGE can access the
port(s) they are defined to.
� APF authorized applications can access unreserved low ports.
� OMVS superuser (UID(0)) applications can access unreserved low
ports.
• RESTRICTLOWPORTS
• UDP Check Sum
o Specifies UDP check summing.
� UDPCHKSUM (default)
• UDP Queue Limit
o Sets a UDP Queue Limit for all UDP applications.
o Policy Agent Intrusion Detection Services Traffic Regulation may be used to
define different UDP Queue Limits on different UDP applications.
� UDPQUEUELIMIT
Display Network Status Command CONFIG
NETSTAT CONFIG
Displays the settings defined on the GLOBALCONFIG, IPCONFIG, TCPCONFIG, and
UDPCONFIG statements in the PROFILE.TCPIP file.
• /D TCPIP,tcp_proc_name,NETSTAT,CONFIG
• OMVS netstat –f
• TSO NETSTAT CONFIG
TCP/IP Sysplex/Buffers/Storage z/OS Health Checker Items
z/OS CS Health Check CSTCP_SYSPLEXMON_RECOV_tcpipstackname
If DYNAMICXCF is defined on IPCONFIG or IPCONFIG6 then GLOBALCONFIG
SYSPLEXMONITOR RECOVERY should be defined.
z/OS CS Health Check CSTCP_TCPMAXRCVBUFRSIZE_tcpipstackname
In the output from the D A,L command, if an FTP Server is running, then TCPCONFIG
TCPMAXRCVBUFRSIZE should be at least 180K.
z/OS Network Health Check
08/27/2014 © Copyright IBM Corporation, 2014 Page 26 of 34
www.ibm.com/support/techdocs item PRS5117 --- Last updated 08/12/2014
TCP/IP Ports See SYS1.PROCLIB(TCPIP) for TCP/IP profile specification.
PROFILE.TCPIP Statements
PORT
Reserves a port for one or more specified job names or controls application access to
unreserved ports.
• NODELAYACKS on the PORT, PORTRANGE, or OMPROUTE statements is
preferred to globally defining NODELAYACKS on the TCPPARMS statement.
• PORT num TCP jobname NODELAYACKS
• PORT num UDP jobname NODELAYACKS
PORTRANGE
Port Reservation prevents application access of ports that not assigned to them.
• NODELAYACKS on the PORT, PORTRANGE, or OMPROUTE statements is
preferred to globally defining NODELAYACKS on the TCPPARMS statement.
• PORTRANGE first_port number_of_ports prot_type RESERVED
NODELAYACKS
o PORTRANGE 1150 3 TCP RESERVED
o PORTRANGE 1150 3 TCP RESERVED NODELAYACKS
Display Network Status Command PORTLIST
NETSTAT PORTLIST
Displays the settings defined on the PORT and PORTRANGE statements in the
PROFILE.TCPIP file.
• /D TCPIP,tcp_proc_name,NETSTAT,PORTLIST
• OMVS netstat –o
• TSO NETSTAT PORTLIST
TCP/IP Ports z/OS Health Checker Item
z/OS CS Health Check CSTCP_CINET_PORTRNG_RSV_tcpipstackname
If CINET is defined in BPXPRMxx then ports defined by INADDRANYPORT and
INADDRANYCOUNT should be reserved on each stack with PORTRANGE in
PROFILE.TCPIP.
A review of the ports might be helpful, especially if there are any problems with
application connections or shared ports.
z/OS Network Health Check
08/27/2014 © Copyright IBM Corporation, 2014 Page 27 of 34
www.ibm.com/support/techdocs item PRS5117 --- Last updated 08/12/2014
IPsec See SYS1.PROCLIB(TCPIP) for TCP/IP profile specification.
Display Active Policy Definitions
pasearch
Displays the active Policy Agent policies.
• pasearch –v
o Displays only the IPsec policies
IPsec z/OS Health Checker Item
z/OS CS Health Check ZOSMIGV1R11_CS_RFC4301
Prior to z/OS V1.12, IPsec filters rules for routed traffic should not be coded because it is
not available starting in z/OS V1.12. Use the pasearch command to check to see if any
IPsec filter rules for routed traffic are in use.
Limits and Trace Settings See SYS1.PROCLIB(TCPIP) for CTIEZBxx specification.
TCP/IP CTRACE Settings
SYS1.PARMLIB(CTIEZBxx)
CTIEZBxx Statements
• INT
• MINIMUM
• OPCMDS
• OPMSGS
CSM Storage Settings
SYS1.PARMLIB(IVTPRM00)
IVTPRMxx Statements
• FIXED max_size K
• FIXED max_size M
• FIXED 100 M
• ECSA max_size K
• ECSA max_size M
• ECSA 100 M
z/OS Network Health Check
08/27/2014 © Copyright IBM Corporation, 2014 Page 28 of 34
www.ibm.com/support/techdocs item PRS5117 --- Last updated 08/12/2014
VTAM Start Options
“LIST=” parameter on VTAM start command specifies ATCSTR suffixes.
SYS1.VTAMLST(ATCSTRxx)
ATCSTRxx statements
• T1BUF=16 (default)
o Buffer pool for HPR (High Performance Routing). Acts as a small packing
buffer for OSA QDIO and HiperSockets iQDIO.
• T2BUF=8 (default)
o Buffer pool for HPR (High Performance Routing). Acts as a large packing
buffer for OSA QDIO and HiperSockets iQDIO.
• TRACE
o Specifies the VTAM internal trace (VIT).
o TRACE,TYPE=VTAM,MODE=INT,SIZE=size,OPTION=(options)
o TRACE,TYPE=VTAM,MODE=INT,SIZE=4M,OPTION=(API,CIO,MSF,NI
RM,PIU,PSS,SMS,SSCP) – default
o TRACE,TYPE=VTAM,MODE=INT,SIZE=999M,OPTION=(API,CIO,MSF,
NIRM,PIU,PSS,SMS,SSCP) – default
• CSALIMIT=csa_limit,F
o CSALIMIT=csa_limit
o CSALIMIT=csa_limit,F
o CSALIMIT=0
o While limiting the amount of CSA that VTAM can use may sound counter
productive, limits might enable system dumps to complete before complete
system failure. This is most beneficial to customers with CSA usage concerns.
Display CSM Storage Usage
D NET,CSM
Displays the Common Storage Manager (CSM) storage usage and the limits defined in
SYS1.PARMLIB(IVTPRMxx).
Display VTAM HPR Buffer Usage
D NET,BFRUSE,BUF=(TI,T1,T2)
Displays the VTAM HPR buffer usage.
Display VTAM Trace Settings
D NET,TRACES
Displays the VTAM trace settings.
z/OS Network Health Check
08/27/2014 © Copyright IBM Corporation, 2014 Page 29 of 34
www.ibm.com/support/techdocs item PRS5117 --- Last updated 08/12/2014
Limits and Trace z/OS CS Health Checker Items
z/OS CS Health Check CSTCP_SYSTCPIP_CTRACE_tcpipstackname
If CINET then code CSTCP_SYSTCPIP_CTRACE_*
If SYS1.PARMLIB(CTIEZBxx) exists, then only default options (INT, MINIMUM,
OPCMDS, and OPMSGS) should be coded unless a problem is being worked on.
z/OS CS Health Check CSVTAM_CSM_STG_LIMIT
IVTPRM00 defaults FIXED 100M and ECSA 100M are usually too low. Use the D
NET,CSM command to determine peak usage for one week, then adjust settings to 1.5
times the peak.
z/OS CS Health Check CSVTAM_T1BUF_T2BUF_EE
If EE is used T1BUF and T2BUF default values are usually too low. Use the D
NET,BFRUSE,BUF=(TI,T1,T2) command to monitor buffer usage and change the
VTAM Start Options as necessary.
Default is T1BUF=(16,1004,0,60,15,) and T2BUF=(8,2028,0,32,7,)
(baseno,bufsize,slowpt,xpanno,xpanpt,xpanlim)
z/OS CS Health Check CSVTAM_T1BUF_T2BUF_NOEE
If EE is not used T1BUF and T2BUF default values should be used in VTAM Start
Options.
z/OS CS Health Check CSVTAM_VIT_DSPSIZE
If z/OS V1.13+, then VIT (VTAM Internal Trace) size should be at least 50M. Use the D
NET,TRACES command to check the VIT size (default is 4M). Adjust the VTAM Start
Option TRACE,TYPE=VTAM as necessary.
z/OS CS Health Check CSVTAM_VIT_OPT_ALL
The VIT (VTAM Internal Trace) should not have option ALL defined. Use the D
NET,TRACES command to check the VIT options. Adjust the VTAM Start Option
TRACE,TYPE=VTAM as necessary.
z/OS CS Health Check CSVTAM_VIT_OPT_PSSSMS
The VIT (VTAM Internal Trace) should have options PSS and SMS active, because they
are always needed when a problem occurs. Use the D NET,TRACES command to check
the VIT options. Adjust the VTAM Start Option TRACE,TYPE=VTAM as necessary.
z/OS CS Health Check CSVTAM_VIT_SIZE
If prior to z/OS V1.13, then VIT (VTAM Internal Trace) size should be 999M. Use the D
NET,TRACES command to check the VIT size (default is 999M). Adjust the VTAM
Start Option TRACE,TYPE=VTAM as necessary.
z/OS Network Health Check
08/27/2014 © Copyright IBM Corporation, 2014 Page 30 of 34
www.ibm.com/support/techdocs item PRS5117 --- Last updated 08/12/2014
Removed TCP/IP Applications
Display Network Status Command ALL
NETSTAT ALL
Displays the buffer information for active connections. This can be helpful if there is a
problem to a particular application.
• /D TCPIP,tcp_proc_name,NETSTAT,ALL,MAX=*
• /D TCPIP,tcp_proc_name,NETSTAT,ALL,CLIENT=client_name,MAX=*
• /D TCPIP,tcp_proc_name,NETSTAT,ALL,IPADDR=
ip_addr_specification,MAX=*
• /D TCPIP,tcp_proc_name,NETSTAT,ALL,PORT=port_num,MAX=*
• OMVS netstat –A
• OMVS netstat –A –E client_name
• OMVS netstat –A –I ip_addr_specification
• OMVS netstat –A –P port_num
• TSO NETSTAT ALL
• TSO NETSTAT ALL (CLIENT client_name
• TSO NETSTAT ALL (IPADDR ip_addr_specification
• TSO NETSTAT ALL (PORT port_num
Display System Activity List
D A,L
Displays the active application procedures.
Removed TCP/IP Applications z/OS Health Checker Items
z/OS CS Health Check ZOSMIGV1R10_CS_BIND4
Prior to z/OS V1.11, the DNS Server (BIND 4) should not be used because it is not
available starting in z/OS V1.11. Use the D A,L command to check to see if the DNS
Server is in use.
z/OS CS Health Check ZOSMIGV1R10_CS_BINL
Prior to z/OS V1.11, the BINL Server should not be used because it is not available
starting in z/OS V1.11. Use the D A,L command to check to see if the BINL Server is in
use.
z/OS CS Health Check ZOSMIGV1R10_CS_DHCP
Prior to z/OS V1.11, the DHCP Server should not be used because it is not available
starting in z/OS V1.11. Use the D A,L command to check to see if the DHCP Server is in
use.
z/OS Network Health Check
08/27/2014 © Copyright IBM Corporation, 2014 Page 31 of 34
www.ibm.com/support/techdocs item PRS5117 --- Last updated 08/12/2014
z/OS CS Health Check ZOSMIGV1R10_CS_NDB
Prior to z/OS V1.11, the NDB Server should not be used because it is not available
starting in z/OS V1.11. Use the D A,L command to check to see if the NDB Server is in
use.
z/OS CS Health Check ZOSMIGV1R11_CS_DNSBIND9
Prior to z/OS V1.12, the DNS Server (BIND 9) should not be used because it is not
available starting in z/OS V1.12. Use the D A,L command to check to see if the DNS
Server is in use.
Discontinued SNA VTAM Equipment
Older Technology
3745 and 3746 (withdrawal from Marketing 2002)
IBM Communication Controller for Linux on System z (CCL) supports the NCP and
subarea networking but the 3745 and 3746 hardware devices are not longer supported.
• CCL should be seen as a short term goal.
• The long term goal should always be Advanced Peer-to-Peer Networking (APPN)
and Enterprise Extender (EE).
CIP
IBM, Cisco, and other Channel Attached Routers (CIPs) are no longer supported.
Token Ring
Token Ring devices are no longer supported. OSA (Open System Adapter) devices only
support Ethernet attachment.
Native SNA
Native SNA flows over the network should be migrated to Advanced Peer-to-Peer
Networking (APPN) and Enterprise Extender (EE).
• EE allows TCP/IP flows over the network while still maintaining useful SNA
applications.
z/OS Network Health Check
08/27/2014 © Copyright IBM Corporation, 2014 Page 32 of 34
www.ibm.com/support/techdocs item PRS5117 --- Last updated 08/12/2014
Manuals z/OS UNIX System Services Command Reference, SA22-7802
z/OS UNIX System Services Planning, GA22-7800
• Display OMVS BPXPRMxx Configuration File suffixes
o D OMVS
• Display CINET Routing Table
o D OMVS,CINET=ALL
• Display OMVS Settings defined in BPXPRMxx files
o D OMVS,O
z/OS MVS Initialization and Tuning Reference, SA22-7592
• z/OS Start members that point to BPXPRMxx files
o SYS1.PARMLIB(IEASYSxx)
• OMVS Settings files
o SYS1.PARMLIB(BPXPRMxx)
• CSM Storage Settings files
o SYS1.PARMLIB(IVTPRMxx)
z/OS Communications Server IP Diagnosis Guide, GC31-8782
• TCP/IP CTRACE Settings file
o SYS1.PARMLIB(CTIEZBxx)
z/OS Communications Server IP Configuration Reference, SC31-8776
z/OS Communications Server IP Configuration Guide, SC31-8775
• TCP/IP Procedure file
o SYS1.PROCLIB(TCPIP)
• Resolver Procedure file
o SYS1.PROCLIB(RESOLVER)
• Resolver Setup file
o SYS1.TCPPARMS(RSETUP)
• TCPIP.DATA file
o SYS1.TCPPARMS(TCPDATA)
• PROFILE.TCPIP file
o SYS1.TCPPARMS(PROFILE)
z/OS Communications Server IP System Administrator's Commands, SC31-8781
• Display Active Routing Table
o D TCPIP,tcp_proc_name,NETSTAT,ROUTE
• Display Active Policy Definitions
o pasearch
z/OS IBM Health Checker for z/OS User's Guide, SA22-7994
• z/OS Communications Server Health Checks
z/OS MVS System Commands, SA22-7627
• Display System Activity List – Display Active Procedures
o D A,L
z/OS Communications Server SNA Network Implementation Guide, SC31-8777
• Display VTAM HPR Buffer Usage
z/OS Network Health Check
08/27/2014 © Copyright IBM Corporation, 2014 Page 33 of 34
www.ibm.com/support/techdocs item PRS5117 --- Last updated 08/12/2014
o D NET,BFRUSE,BUF=(TI,T1,T2)
z/OS Communications Server SNA Resource Definition Reference, SC31-8778
• VTAM Start Options
o SYS1.VTAMLST(ATCSTRxx)
z/OS Communications Server CSM Guide, SC31-8808
z/OS Communications Server SNA Operation, SC31-8779
• Display CSM Storage Usage and limits defined in SYS1.PARMLIB(IVTPRMxx)
o D NET,CSM
• Display VTAM Trace Settings
o D NET,TRACES
You Tube Video on Performance: http://www.youtube.com/watch?v=pMdAe4oAZcs&list=UUp9nwV_qXe9ue6C5iW0Mwxg