networking part of ats parallel sysplex health check - ibm€¦ · networking part of ats parallel...

34
Networking Part of ATS Parallel Sysplex Health Check Linda Harrison [email protected]

Upload: buiphuc

Post on 20-Apr-2018

250 views

Category:

Documents


1 download

TRANSCRIPT

Networking Part of ATS

Parallel Sysplex Health Check

Linda Harrison

[email protected]

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

z/OS Network Health Check

08/27/2014 © Copyright IBM Corporation, 2014 Page 34 of 34

www.ibm.com/support/techdocs item PRS5117 --- Last updated 08/12/2014