CONTENTS Title Page Copyright Page Preface 1 Overview 1.1 DECnet/SNA Network 1.1.1 DECnet Network 1.1.2 SNA Network 1.1.3 Gateway Node 1.1.3.1 Gateway-ST Components 1.1.3.2 Gateway-CT Components 1.2 Managing a DECnet/SNA Network 1.2.1 DECnet Components 1.2.2 SNA Components 1.2.3 Managing Gateway Components 1.2.3.1 Gateway Management Tasks 1.2.3.2 Getting HELP 1.2.3.3 Required Privileges 1.2.3.4 Configuring the Gateway 1.2.3.4.1 Initial Configuration 1.2.3.4.2 Reconfiguration 1.2.3.5 Event Logging 1.2.3.6 Error Messages 1.2.3.7 Diagnostic Tools 2 Gateway Security 2.1 Securing the Gateway Hardware 2.2 Securing the Remote Console 2.2.1 Defining a Service Password 2.2.1.1 MicroServer 2.2.1.2 ChannelServer 2.2.2 Clearing the Service Password 2.2.2.1 MicroServer 2.2.2.2 ChannelServer 2.3 Securing DECnet and SNA Components 2.3.1 Privileged Username and Password 2.3.2 Nonprivileged Username and Password 2.4 Securing System Files 2.5 Securing LUs 2.6 Securing RJE Files 3 Gateway Management Utilities 3.1 SNANCP 3.1.1 Starting SNANCP 3.1.2 Specifying the Gateway Node 3.1.3 SNANCP Command Syntax 3.1.4 Entering SNANCP Commands 3.1.4.1 Command Line Editing 3.1.4.2 SNANCP Prompting Mode 3.1.5 Exiting From SNANCP 3.1.6 SNANCP Command Summary 3.2 DECnet-VAX NCP 3.2.1 Starting NCP 3.2.2 Specifying the Gateway Node 3.2.3 NCP Command Syntax 3.2.4 Entering NCP Commands 3.2.4.1 Command Line Editing 3.2.4.2 NCP Prompting Mode 3.2.5 Exiting From NCP 3.2.6 NCP Command Summary 3.3 SNAP 3.3.1 Starting SNAP 3.3.2 Exiting From SNAP 3.3.3 SNAP Command Summary 3.3.4 SNAP Display Format 3.3.4.1 Obtaining a Copy of the SNAP Display 4 Line Management 4.1 DECnet Lines 4.1.1 Defining DECnet Lines 4.1.2 Monitoring DECnet Lines 4.1.2.1 Displaying NCP Line Counters 4.1.2.2 Zeroing NCP Line Counters 4.1.3 Clearing DECnet Lines 4.1.4 Testing DECnet Lines 4.2 Gateway to IBM Lines 4.2.1 SDLC Lines 4.2.1.1 DEC MicroServer-SP Line Support 4.2.1.2 DEC MicroServer Line Support 4.2.1.3 SDLC Line States 4.2.2 Channel-Attached Lines 4.2.3 Defining Gateway to IBM Lines 4.2.4 Monitoring Gateway to IBM Lines 4.2.4.1 Displaying SNANCP Line Counters 4.2.4.2 Zeroing SNANCP Line Counters 4.2.5 Clearing Gateway to IBM Lines 4.2.6 Testing Gateway to IBM Lines 5 Circuit Management 5.1 DECnet Circuits 5.1.1 Defining DECnet Circuits 5.1.2 Monitoring DECnet Circuits 5.1.2.1 Displaying NCP Circuit Counters 5.1.2.2 Zeroing NCP Circuit Counters 5.1.3 Clearing DECnet Circuits 5.2 Gateway to IBM Circuits 5.2.1 SDLC Circuits 5.2.2 Channel-Attached Circuits 5.2.3 Defining Gateway to IBM Circuits 5.2.4 Monitoring Gateway to IBM Circuits 5.2.4.1 Displaying SNANCP Circuit Counters 5.2.4.2 Zeroing SNANCP Circuit Counters 5.2.5 Clearing Gateway to IBM Circuits 6 PU Management 6.1 Gateway PUs 6.2 Defining PUs 6.3 Monitoring PUs 6.3.1 Displaying PU Counters 6.3.2 Zeroing PU Counters 6.4 Clearing PUs 7 LU Management 7.1 Gateway LUs 7.2 Defining LUs 7.2.1 Defining Authorization Entries with Component Qualifiers 7.2.2 Defining LU Parameters 7.3 Monitoring LUs 7.3.1 Displaying LU Authorization Information 7.3.2 Displaying LU Counters 7.3.3 Zeroing LU Counters 7.4 Clearing LU Parameters 8 Access Name Management 8.1 Gateway Access Names 8.2 Defining Access Names 8.3 Displaying Access Names 8.4 Clearing Access Names 8.5 Sample Access Name Task 9 Server Management 9.1 Gateway Servers 9.1.1 Server States 9.1.2 Server Identification 9.1.3 Outbound Connection Initiation Through Servers 9.2 Defining Server Parameters 9.3 Monitoring Servers 9.3.1 DHCF 9.3.2 RJE 9.3.3 SNA-ACCESS 9.3.4 Displaying Server Counters 9.3.5 Zeroing Server Counters 9.4 Clearing Server Parameters 9.5 Sample Server Tasks 10 Event Logging 10.1 Starting the Event Logger 10.2 Gateway Logging Commands 10.3 Where to Log Event Messages 10.4 Specifying Severity for Event Messages 10.5 Displaying Event Logging Information 10.6 Clearing Event Logging 11 Using NETTRACE 11.1 Privileges Required for NETTRACE 11.2 Starting NETTRACE 11.2.1 Performing LIVE Tracing 11.2.2 Running NETTRACE as a Detached Process 11.3 NETTRACE Commands 11.3.1 ANALYZE 11.3.2 ATTACH 11.3.3 BACK 11.3.4 CLEAR 11.3.5 DEFINE/KEY 11.3.6 DELETE/KEY 11.3.7 EXIT 11.3.8 HELP 11.3.9 NEXT 11.3.10 REFRESH 11.3.11 SHOW 11.3.12 SPAWN 11.3.13 START 11.3.14 STOP 11.4 Examples of NETTRACE Commands and Output 11.4.1 CHAN Tracepoint Example 11.4.2 SDLC Tracepoint Example 11.4.3 PU Tracepoint Example 11.4.4 Session Tracepoint Example 11.5 NETTRACE Messages 12 Using SNATRACE 12.1 Starting SNATRACE 12.2 How SNATRACE Works 12.2.1 Trace Levels 12.2.1.1 Circuit Level Trace - SDLC Circuits 12.2.1.2 Circuit Level Trace - Channel-Attached Circuits 12.2.1.3 Physical Unit Level Trace 12.2.1.4 Session Level Trace 12.3 SNATRACE Commands 12.3.1 TRACE 12.3.2 ANALYZE 12.3.3 HELP 12.3.4 SHOW 12.3.5 EXIT 12.3.6 SNATRACE Example 12.4 Interpreting SNATRACE Messages 12.4.1 SDLC Circuit Level Trace 12.4.2 ADDR and CTL Fields in Messages 12.4.3 Channel-Attached Circuit Level Trace 12.4.4 STS and CMD Fields in Messages 13 SNANCP Commands CLEAR ACCESS NAME CLEAR CIRCUIT CLEAR LINE CLEAR LOGGING CLEAR LU CLEAR PU CLEAR SERVER EXIT HELP LOOP LINE SET ACCESS NAME SET CIRCUIT SET LINE SET LOGGING SET LU SET PU SET SERVER SHOW ACCESS NAME SHOW CIRCUIT SHOW LINE SHOW LOGGING SHOW LU SHOW PU SHOW SERVER SPAWN USE SYSTEM ZERO CIRCUIT ZERO LINE ZERO LU ZERO PU ZERO SERVER 14 NCP Commands CLEAR CIRCUIT CLEAR EXECUTOR CLEAR EXECUTOR NODE CLEAR LINE CLEAR LOGGING EVENTS CLEAR NODE CONNECT NODE CONNECT VIA HELP LOAD NODE LOAD VIA LOOP CIRCUIT LOOP EXECUTOR LOOP NODE SET CIRCUIT SET EXECUTOR SET EXECUTOR NODE SET LINE SET LOGGING EVENTS SET NODE SHOW CIRCUIT SHOW EXECUTOR SHOW LINE SHOW LOGGING SHOW NODE TELL TRIGGER NODE TRIGGER VIA ZERO CIRCUIT ZERO LINE ZERO NODE A EBCDIC/DMCS Translation Tables A.1 Macros for Modifying the Translation Tables A.2 Building Translation Tables A.3 Examples B Counter Summary B.1 Counter and Qualifier Definitions B.1.1 SDLC Line Counters B.1.2 Channel-Attached Line Counters B.1.3 SDLC Circuit Counters B.1.4 Channel-Attached Circuit Counters B.1.5 PU Counters B.1.6 LU Counters B.1.7 Server Counters B.1.7.1 SNA-ACCESS Server Counters B.1.7.2 DHCF Server Counters B.2 IBM RECFMS Messages C Gateway Management Utility Messages D Event Messages D.1 Line Events-256. x D.2 Circuit Events-257. x D.3 PU Events-258. x D.4 Session Events-259. x D.5 Counter Events-265. x D.6 Initialization Events-266. x D.7 Logging Events-266. xx D.8 SNA-ACCESS Server Events-268.0 D.9 DHCF Server Events-268.10 D.10 RJE Server Events-269.0 EXAMPLES 11-1 Sample Output of a CHAN Tracepoint 11-2 Sample Output of an SDLC Tracepoint 11-3 Sample Output of a PU Tracepoint 11-4 Sample Output of a Session Tracepoint 12-1 SNATRACE Output for SDLC Circuit 12-2 SNATRACE Output for Channel A-1 Example 1 A-2 Example 2 FIGURES 1 Gateway-ST Manuals 2 Gateway-CT Manuals 1-1 DECnet/SNA Network 1-2 DECnet/SNA Gateway-ST Node 1-3 DECnet/SNA Gateway-CT Node 3-1 Sample SNAP Display 11-1 Tracepoints 11-2 NETTRACE Keypad 12-1 System Components Used by SNATRACE 12-2 SDLC Circuit Level Trace Message 12-3 Channel-Attached Circuit Level Trace Message 12-4 PU Level Trace Message TABLES 2-1 Protection of Gateway System Files 3-1 SNANCP Commands 3-2 NCP Commands Executed by the Gateway 3-3 NCP Commands Executed on the Load Host 3-4 SNAP Commands 4-1 DEC MicroServer-SP Port Speeds 4-2 DEC MicroServer Port Speeds 11-1 NETTRACE Commands 11-2 DISPLAY Qualifier Options 11-3 Default Protocol Identifiers 12-1 ADDR and CTL Fields for Normal Response Mode (Modulo 8) 12-2 ADDR and CTL Fields for Extended Reponse Mode (Modulo 128) 12-3 CMD Field Values and Associated Commands 12-4 STS Field Values and Associated Conditions 13-1 Default Values for Server Parameters 13-2 A-1 Modifications to Translation Tables B-1 Gateway Counters and Qualifiers