z/OS Communications Server: SNA Diagnosis Vol 1, Techniques and Procedures
Previous topic |
Next topic
|
Contents
|
Contact z/OS
|
Library
|
PDF
Contents (exploded view)
z/OS Communications Server: SNA Diagnosis Vol 1, Techniques and Procedures
GC27-3667-00
Abstract for SNA Diagnosis Volume 1
Summary of changes
Diagnostic techniques
Diagnosing VTAM problems: Where to begin
Determining whether the problem is VTAM or non-VTAM
Common problems and symptoms
Common problems in subarea networks
Descriptions of common problems in subarea networks
Abend 0C4 occurs in ISTTSCPF
Abend in user exit ISTEXCCS, ISTEXCSD, ISTEXCAA, or ISTEXCVR
LU hung in PNFYx state
Message IKT029I (return code 061001) received with TSO logon failure
Message IST259I received with INOP RU
Message IST259I received and sessions end unexpectedly
Message IST467I received with CONTACTED ERROR TYPE 05, 07, 08, or 0B
Message IST530I or IST1278I received with GUNBIND PENDING or session hangs in PSESEND state
Message IST530I or IST1278I received with NMVT PENDING
Message IST530I or IST1278I received with pending DSRLST condition
Message IST663I (sense code 08210000) and cannot log on to CICS
Message IST663I (sense code 08610000) and IST264I received for undefined CoS entry
Message IST718I and IST719I received when activating a CDRM
Messages IST154I, IST561I, IST999E, IST566I, and IST930I received for APPL-APPL storage expansion failure
Missing VTAM trace records
Partial input for TGET received by TSO
Sense code 08010000 received with CINIT failure
Sense code 083500xx or 08210000 received with BIND failure
Sense code 800A0000 or no message, and sessions end unexpectedly
Sense codes 10030000 and 08090000 received when activating an NCP
Session failure with sense code 0888000x
Common problems in APPN networks
Descriptions of common problems in APPN networks
Message IST489I or IST1272I received during session takeover
Message IST663I (sense code 08610000) and IST264I received for undefined CoS entry
Messages IST1097I and IST1280I (sense code 08A00005) received with CP-CP session failure
Messages IST1110I, IST1112I, IST1765I, and IST1766I received during CP-CP session activation failure
Messages IST1110I and IST1113I received during CP-CP session activation failure
Messages IST1110I and IST1246I received during CP-CP session activation failure
Messages IST1110I, IST1246I, and IST1280I received during CP-CP session activation failure
Messages IST1110I, IST1356I, and IST1280I (sense code 101E000A) received during CP-CP session activation failure
Messages IST1110I and IST1280I (sense code 08910006) received during CP-CP session activation failure
Messages IST1110I and IST1280I (sense code of 08B50000) received during CP-CP session activation failure
Messages IST1774I and IST1775I received during LU-LU session activation
Resource not found but resource exists in network
Sense code 08210002 received with session activation failure
Sense code 0821000A received with session activation failure
Sense code 087D0001 received with session activation failure
Sense Code 087D000A or 083B0001 received and session lost during takeover
Sense code 10145046 received with session activation failure
Sense code 80130000 received with session activation failure
Sense code 80140001 received with session activation failure
Sense code 80140002 received with session activation failure
Sense code 80140005 received with session activation failure
Session established with nonlocal instead of local application program
Session did not take the best path
MNPS session recovery error
Common problems in HPR networks
Descriptions of common problems in HPR networks
LU-LU session initiation fails
LU-LU session initiation does not complete
No RTP connection established for CP-CP session pair
LU-LU session established using ISR routing
RTP connection for LU-LU session does not include entire session path
RTP connection experiences a path switch
RTP path switch fails
Deactivate or MODIFY RTP for Route_Setup RTP ALS fails
Sense code 08770026 received on dial-out or dial-in for Enterprise Extender
Sense code 1016000B received on dial-in for Enterprise Extender
Sense code FFC80004 received with dial-out for Enterprise Extender
Common symptoms and associated VTAM problem types
VTAM internal trace (VIT) analysis tool problems
Checklist for isolating the problem
Common symptoms and actions
Documenting an APAR for VIT analysis tool problems
VTAM dump analysis tool problems
Checklist for isolating the problem
Documenting an APAR for dump analysis tool problems
Recommended documentation for VTAM problems
Methods for submitting documentation
Submitting documentation using FTP
Obtaining PUTDOC
Obtaining TRSMAIN
Using electronic transfer through email attachments
Submitting documentation on tape
Necessary documentation
Collecting documentation for specific types of problems
Common problem determination procedures
Abnormal end (abend)
Wait
VTAM locks
Using the VARY INACT,FORCE command
Loop
Message problem
Incorrect output
Performance problem
Storage problem procedure
Procedure steps
Documentation problem
Failing module
Symptom string structure
Reporting the problem to IBM
Collecting documentation for TSO/VTAM problems
Initial TSO/VTAM problem analysis
Logon problems
TSO/VTAM abends
ABEND0AB
ABEND0AC
ABEND0AD
ABEND15D
Parameter initialization problems
Hung terminal problems
Incorrect output problems
Screen management problems
Function error
Exception responses
Extra or missing data
Data is misplaced on the screen or page
Data appears to be translated incorrectly
Screen size problems
Screen is never the expected size
The screen is not the expected size for the mode
Performance problems
Diagnostic procedures
Using DISPLAY and MODIFY operator commands
Using VTAM DISPLAY commands for problem determination
Display buffer pool use
DISPLAY CSDUMP
DISPLAY CSMUSE
DISPLAY EE
DISPLAY EEDIAG
Using the REXMIT option on D EEDIAG
Using the SRQRETRY option on D EEDIAG
How Enterprise Extender times out an inactive connection
Enterprise Extender inactivity example
Using the DISPLAY EEDIAG output to tune your Enterprise Extender timers
Tuning your HPRPST values for your EE network
DISPLAY EEDIAG,TEST=YES
New EE connection will not activate
Sample console log of the dial failure
Analyzing the problem
Performing an EE connectivity test
Performing a basic EE connectivity test
Understanding the EE connectivity test output
Solving EE connectivity problems
RTP performance problems over EE with multipath routing enabled
Using the EE connectivity test to verify multipath routing
EE connection or RTP pipe fails to activate when using policy-based routing for EE traffic
Using the EE connectivity test to verify policy-based routing
DISPLAY EEDIAG,TEST=PENDING
Display Enterprise Extender connection network unreachable partner information
Display HPR route test
Display ID for an RTP connection
Display ID for an RTP PU with HPRDIAG=YES
Display ID for an RTP PU with HPRDIAG=YES and CLEAR=ALL
Display NCP storage
Display path tables
Display resource status
Display resources in a pending state
Display route status
Example: Solving path problems
Rules for routing
Configuration and situation
Analyzing the problem
Finding the problem
Steps for displaying routes
Fixing the problem
Dynamic path update
Coding the path in the NCP
Display route test
Successful route test
Failed route test
Location of failure in a route test
Display RTPS options
Using the CLEAR option on D RTPS
Display TDU information
Display traces
Display VTAM storage
Display workload information for a device
Using VTAM MODIFY commands for problem determination
Issuing the MODIFY CSDUMP command
Modifying input/output problem determination
Modifying message module identification
Modifying NCP intensive mode recording
Modifying SDLC link level 2 test
Issuing the MODIFY TOPO command to clear EE connection network unreachable partner information
Modifying tuning statistics
Issuing the MODIFY VTAMOPTS command to change start option values
Using dumps
Dumps on MVS operating system
Abend dump
Coupling facility structures dump
FFST dump
Stand-alone dump
SVC dump
Network control program (NCP) dump
When to use the NCP dump
Using the NCP option on MODIFY DUMP
Using the independent NCP dump utility (channel-attached controller only)
Communication scanner processor dump (3720, 3725, and 3745 only)
Maintenance and operator subsystem dump (3720, 3725, and 3745 only)
Formatting and printing dump output
IPCS service aids
ABDUMP service aid
SADMP service aid
Using VTAM dump analysis tools
Enhanced VTAM dump analysis tools
Operating environment
Using VTAM interactive problem control system (IPCS) CLISTs
Obtaining online help for CLISTs
Debugging CLIST errors
Printing CLIST output
Sample VTAM dump analysis functions
Using the panel interface
Using the IPCS command line
Using the batch option
VTAM formatted dump procedures
ALL
APPLCONV
APPLMODE
APPMODAL
APPNBASE
ATMDATA
CSMALL
CSMBUF
CSMCMPID
CSMOWNER
CSMPOOL
FINDDSIB
FINDSIB
FNDADJCP
FNDANDCB
FNDCOS
FNDDECB
FNDENDEL
FNDLCB
FNDNDREC
FNDNDWGT
FNDNODE
FNDREREC
FNDSCCB
FNDSITCB
FNDTGREC
FNDTGWGT
HOST
HPRIP
ISTVABND
ISTVDUMP
SDUMP parameter list
ISTVMAP
ISTVSAVE
ISTVSLIP
MNPSC, MNPSD, MNPSF
PABSCAN
PARTNRLU
RDTCHECK
RDTFULL
RDTHIER
RDTSUM
ROUTES
RTPINFO
SES
SIBCHECK
SPANC
SRTFIND
STORAGE
TOPOLOGY
TRSTRACE
VITAL
VTAM
VTBASIC
VTBUF
VTCVTPAB
VTFNDMOD
VTMODS
VTNODE
VTREADYQ
VTRPH
VTVIT
VTVRBLK
VTWRE
Using traces
Traces provided by VTAM
Activating network traces
APPN route selection trace
Buffer contents trace
CCW trace
CNM trace (communication network management)
GPT (generalized PIU trace)
I/O trace
Line trace
Module Trace
NetView session trace
Network controller line trace
QDIOSYNC trace
Resource state trace
Resource state trace (continued)
SIT (scanner interface trace)
SME Buffer trace (Session Management Exit)
SMS (buffer use) trace
TG trace (transmission group)
TSO/VTAM TGET/TPUT trace
VTAM internal trace (VIT)
Starting the generalized trace facility (GTF)
Formatting and printing trace records
Using ACF/TAP
Using IPCS with the GTF trace option
Trace output
VTAM trace record formats
APPN route selection trace
APPN route selection trace operation
APPN route selection trace output
Buffer contents trace for VTAM API and TSC
Buffer contents trace for CMIP services API
Line trace
Buffer contents trace
Buffer contents trace for the VTAM API and TSC
When to use the buffer contents trace for the VTAM API and TSC
Buffer contents trace for CMIP services API
When to use the buffer contents trace for CMIP services API
Choosing between partial and full buffer contents trace
Buffer contents trace operation
Buffer contents trace output
Fields in the buffer contents trace
Configuration services XID exit (CSX) buffer trace
When to use the configuration services XID exit (CSX) buffer trace
Configuration services XID exit (CSX) buffer trace operation
Configuration services XID exit (CSX) trace record output
Directory services session management exit (DSME) buffer trace
When to use the directory services session management exit (DSME) buffer trace
Directory services session management exit (DSME) buffer trace operation
Directory services session management exit formatted output
I/O trace
When to use the I/O trace
I/O trace operation
QDIOSYNC trace
When to use the QDIOSYNC trace
QDIOSYNC trace operation
Using QDIOSYNC to synchronize OSA diagnostic data with host diagnostic data
Resource state trace
When to use the resource state trace
Resource state trace operation
Session management exit (SME) buffer trace
When to use the session management exit (SME) buffer trace
Session management exit (SME) buffer trace operation
Session management exit trace record output
SMS (buffer use) trace
When to use the SMS trace
SMS trace operation
SMS trace record output
TGET/TPUT trace for TSO/VTAM
When to use the TGET/TPUT trace
TGET/TPUT trace operation
TGET/TPUT trace output
Traces provided by NCP
Generalized PIU trace
When to use the generalized PIU trace
Generalized PIU trace operation
Line trace
When to use the line trace
Line trace operation
Line trace output (CS type 2)
Line trace output (CS type 3)
Network controller line trace (3710 only)
When to use the network controller line trace
Network controller line trace operation
Network controller line trace output
Scanner interface trace (3720, 3725, and 3745 only)
When to use the scanner interface trace
Scanner interface trace operation
Transmission group trace
When to use the transmission group trace
Transmission group trace operation
Transmission group trace output
Traces provided by TCP/IP
Using the VIT analysis tool
Setting up and running the VIT analysis tool
Step 1. Record a VIT
Step 2. Set up to run the tool
Create a data set
Batch mode
Interactive mode
Step 3. Create the parameters for the job
Step 4. Run the job
Step 5. Check the output
Return codes
Environment
Analyzing storage
Matching
Unmatched allocates
Storage lengths
GBLK pools, GETS pools, VTAL pools, REQS buffer pools, and CSM buffers
Address space identifiers (ASIDs) and data spaces
Parameter syntax
Sample output for storage analysis
Counting request/response units (RUs)
Requests/responses
RUs
Network addresses
Sorting order
Parameter syntax
RU parameter coding
Combinations of RU options
Sample output for RU counting
Extracting information from the VIT
Using the template
Creating a Boolean expression without the template
Operands
Operators
Parameter syntax
Sample output for VIT extraction
Using the timing options
Start and stop time
Report interval
Parameter syntax
Using the I/O options
Trace wrapped
Format output
Parameter syntax
Operands
Creating your own parameter data set
Using other problem-solving tools
Alert messages from NCP
Recording NMVT alerts in LOGREC
Messages issued for 3745 bus switching
Message IST881I
Message IST882I
Hardware error recording
Logical unit connection test (IBMTEST)
NCP error recording
Patch areas
VTAM patch area
TSO/VTAM patch area
VTAM load module list
Using save-area module linkage conventions—Subarea
Using save-area module linkage conventions—APPN
Channel programs
Channel programs for channel-attached type 2 and type 4 physical units
Channel commands for channel-attached type 2 and type 4 physical units
Format of transfer-in-channel (TIC) CCWs
Channel program sequences
PUNS-related channel programs
Channel programs for channel-to-channel adapters (CTCA), multipath channel (MPC), and APPN host-to-host channels
Channel programs for activating the CTC connection
Protocol choice
X-side / Y-side
I/O buffering
Channel commands for channel-to-channel (CTC) adapters
XID channel program (X-side)
XID channel program (Y-side)
Channel programs for CTC data transfer: Blocking protocol
Normal data transfer (X-side)
Normal data transfer (Y-side)
Channel programs for channel-to-channel adapters: Nonblocking protocol
Normal data transfer (X-side) for nonblocking protocols
Normal data transfer (Y-side) for nonblocking protocols
Channel programs for multipath channel (MPC)
Channel programs for activating the MPC connection
Channel program (X-side or Y-side)
I/O buffering
Channel commands for activating the MPC connection
Channel programs for MPC data transfer
Channel program for HPDT MPC data transfer
SECP read channel program
SECP write channel program
Channel programs for channel-attached non-SNA 3270 devices
Channel command words
Channel programs
Write data channel program
Read Modified channel program
Read buffer channel program
Erase/Write channel program
Erase/Write Alternate channel program
Erase All Unprotected channel program
Network flows
Generic BIND (GBIND) AMRUs
Index of generic BIND (GBIND) AMRU flows
Resource activation flows
Index of resource activation flows
Session establishment flows
Index of session establishment flows
Deactivation and session termination flows
Index of deactivation and session termination flows
Error detection and recovery and SSCP management services
Index of error detection and recovery and SSCP management services flows
APPN flows
CP-CP session flows
Index of CP-CP session flows
Activating a CP-CP contention-winner session
Activating a CP-CP contention-loser session
Host CP initiating deactivation of CP-CP session
Remote node initiating deactivation of CP-CP session
Activating a leased APPN node type 2.1
Activating an APPN host-to-host channel
Directory services flows
Index of directory services flows
Register resource flows
Resource registration: EN to NN to CDS
Resource registration with error recovery
Locate resource flows
Locate resource: EN to NN
Locate resource: EN to NN to EN
Locate resource: EN to NN to two ENs
Locate resource: EN to NN to NN to NN
Locate resource: CP network broadcast initiation
Locate resource: EN to NN to subarea network
Locate resource: Complex APPN network
Locate resource: Complex APPN network using more than one CDS
Locate resource: Network node server, NN1, of the originating logical unit (OLU) is at pre-V4R2 level
Locate resource: APPN and subarea network
Locate resource: Directory search verification reduction
Locate resource: SLU-initiated session
Locate resource: CP-CP session terminates
Locate resource: Network node receives network broadcast request
LU-LU session flows
Index of LU-LU session flows
EN (PLU)--NNS...APPN network, PLU-initiated, with no queueing
EN (PLU)--NNS...APPN network, PLU-initiated, queued by the PLU
EN (PLU)--NNS...APPN network, PLU-initiated, queued by the SLU
EN (SLU)--NNS...APPN network, SLU-initiated, with no queueing
EN (SLU)--NNS...APPN network, SLU-initiated, queued by the PLU
APPN network...NNS--EN (SLU), PLU-initiated, no queueing
APPN network...NNS--EN (SLU), PLU-initiated, queued by the SLU
APPN network...NNS--EN (PLU), SLU-initiated, no queueing
APPN network...NNS--EN (PLU), SLU-initiated, queued by the PLU
SA (PLU)==ICN...APPN network (SLU), DSRLIST transforming into PLU-initiated, search-only
SA (PLU)==ICN...APPN network (SLU), PLU-initiated, with no queueing
SA (PLU)==ICN...APPN network (SLU), PLU-initiated, USERVAR resolution required
SA (PLU)==ICN...APPN network (SLU), PLU-initiated, queued by the SLU
SA (SLU)==ICN...APPN network (PLU), SLU-initiated, no queueing
SA (SLU)==ICN...APPN network (PLU), SLU-initiated, queued by the PLU
SA (SLU)==ICN...APPN network (PLU), autologon, PLU not available initially
SA(PLU)==ICN…APPN network(SLU), orderly termination of active session
APPN network (PLU)…ICN==(SA)SLU, orderly termination of active session
SA(SLU)==ICN…APPN network(PLU), forced termination of pending active session
SA(PLU)==ICN…APPN network(SLU), forced termination of pending active session (PLU accessible without going into APPN)
SA(PLU)==ICN…APPN network(SLU), forced termination of queued session
SA(PLU)==ICN…APPN network(SLU), forced termination of queued session (PLU accessible without going into APPN)
SA (PLU)==ICN...APPN network (SLU), session release request
SA (SLU)==ICN...APPN network (PLU), session release request
CLSDST PASS through APPN
CLSDST PASS from APPN to subarea
EN-NN-EN, PLU-initiated, no queueing
Intermediate network node (INN) BIND
APPN network (PLU)...ICN==SA(SLU), PLU-initiated, search-only flow transformed into a DSRLST
APPN network (PLU)…ICN==SA(SLU), PLU-initiated, no queueing
APPN network (PLU)...ICN==SA(SLU), PLU-initiated, directed search without required precomputed RSCV
APPN network (PLU)...ICN==SA(SLU), PLU-initiated, USERVAR resolution required
APPN network (PLU)...ICN==SA(SLU), PLU-initiated, queued by the SLU
APPN network (SLU)...ICN==SA(PLU), SLU-initiated, no queueing
APPN network (SLU)...ICN==SA(PLU), SLU-initiated, queued by the PLU
APPN network (SLU)...ICN==SA(PLU), autologon (PLU not available initially)
APPN network (PLU)...ICN==VR-based TG==ICN...APPN network (SLU)
Dependent LU server flows
Index of dependent LU server flows
Single subnetwork flows
DLUR-initiated CPSVRMGR pipe activation
DLUS-initiated CPSVRMGR pipe activation
Dynamic PU activation
Dynamic registration and activation of dependent LUs
Activation of predefined dependent LUs
SSCP-PU session activation race
CPSVRMGR pipe deactivation
Downstream PU outage
Receipt of REQDISCONT (normal) from downstream PU
Receipt of REQDISCONT (immediate) from downstream PU
Normal SSCP-PU/SSCP-LU session deactivation
Forced SSCP-PU/SSCP-LU session deactivation
Giveback SSCP-PU/SSCP-LU session deactivation (ANS=STOP)
Giveback SSCP-PU/SSCP-LU session deactivation (ANS=CONT)
APPN PLU-initiated LU-LU session to a dependent SLU
USS SLU-initiated LU-LU session to APPN PLU
USS SLU-initiated LU-LU session to subarea PLU
USS flows for LU-LU session termination
Cross subnetwork flows
PLU-initiated session with DLUS and DLUR within different subnetworks, PLU Is through the subarea
PLU-initiated session with DLUS and PLU in one subnetwork and DLUR in another
SLU-initiated session with DLUS and DLUR within different subnetworks
High-Performance Routing flows
Index of High-Performance Routing flows
Two Rapid-Transport Protocol (RTP) nodes with a T2.1 connection
Two Rapid-Transport Protocol (RTP) nodes with a virtual-route-based transmission group
Rapid-Transport Protocol (RTP) connection over portion of session path
Rapid-Transport Protocol (RTP) across composite nodes with T2.1 connection through NCP
Rapid-Transport Protocol (RTP) across composite nodes with T2.1 connection through VTAM
Rapid-Transport Protocol (RTP) across composite nodes with a virtual-route-based transmission group, NCP does ANR routing
Rapid-Transport Protocol (RTP) across composite nodes with a virtual-route-based transmission group, VTAM does ANR routing
Control point/control block (CPCB) operation codes
Storage and control block ID codes
VTAM control block ID codes
Installing dump analysis and VIT analysis tools
Concatenating target data sets used in the installation
Customizing IPCS interface
Verifying dump formatter panels
Customizing ISPF interface
Verifying trace formatter panels
Problem topics in other libraries
Architectural specifications
Accessibility
Bibliography
Index for SNA Diagnosis Volume 1: Techniques and Procedures
Copyright IBM Corporation 1990, 2014