Edition
J2740-90013 HP 9000 Networking E1098
Legal Notices
HEWLETT-PACKARD Company
Page
Page
Contents
Administering SNAplus2
Introduction to SNAplus2
Basic Configuration Tasks
Defining Connectivity Components
Configuring Dependent LUs
Configuring Appc Communication
Configuring Passthrough Services
Configuring User Applications
Managing SNAplus2 from NetView
Managing SNAplus2 Clients
Configuration Planning Worksheets
Configuring an Invokable TP Using snaptpinstall
Using SNAplus2 in a High Availability Environment
Contents
Contents
Preface
Prerequisite Knowledge
About This Book
Organization of This Book
Page
Typographic Conventions
Opcode LU name
0p1
Definenode cd
Operating System Conventions
SNAplus2 Publications
Publications for Users
Special Element Sample of Typography
Publications for Administrators
HP-UX SNAplus2 3270/3179G Users Guide
HP-UX SNAplus2 Administration Command Reference
Publications for Programmers
Related Publications
HP-UX SNAplus2 MS Programmers Guide
Page
SNA Terms and Concepts
Overview
Systems Network Architecture
Network Types
Basic SNA Concepts
SNA Nodes
Node Types in a Subarea Network
Basic SNA Concepts
SNA Subarea Network
Connectivity
Node Types in a Peer Network
Transaction Programs
Application Programming Interfaces
Network Accessible Units
Physical Units
Logical Units
LU 6.2 for APPC, 5250 and CPI-C
LU 2 for 3270 displays
Control Points
Sessions
Session Types
Logical Unit Attributes for Sessions
Multiple and Parallel Sessions
Conversations
Multiple and Parallel Sessions
Communication between Transaction Programs and Logical
Units
Modes
Route Selection
Class of Service
Basic Appn Concepts
Appn Node Types
Portion of a Sample Appn Network
Appn Network Nodes
Appn End Nodes
LEN Nodes
Appn Control Point
Locating Resources
Directory Services
Resource Names
Basic Appn Concepts
LEN Node Directory
End Node Directory
Network Node Directory
Topology and Routing Services
Session Routing
Basic Appn Concepts
Network Topology Database in Network Nodes
Basic Appn Concepts
Intermediate Routing
Direct Connectivity
Appn Network Using a Shared-Access Transport Facility
Appn Connection Networks
Basic Appn Concepts
11 Definitions Needed for Direct Links Using a Virtual Node
Basic Appn Concepts
Accessing Subarea Networks from Appn Networks
Introduction to SNAplus2
Introduction to SNAplus2
What Is SNAplus2?
Within a TCP/IP local area network LAN, SNAplus2
Standalone SNAplus2 Node That Communicates Directly with a
Example Configurations
Host
SNAplus2 Nodes in an Appn Network
SNAplus2 Node Providing PU Concentration and Dlur
SNAplus2 Node Configured for TN Server
SNAplus2 Client/Server Configuration
SNAplus2 Components
Components of SNAplus2
Node Components
Passthrough Services
SNA Support
PU Concentration
SNAplus2 Components
TN Server
User Applications
Emulation
RJE Workstation Daemon
Windows client APIs see Windows APIs
Appc API
CPI-C API
LUA API
Windows APIs
Client/Server Support
Master Server and Backup Servers
Benefits of Client/Server Operation
A domain with multiple SNAplus2 servers, one server holds
HP-UX Clients
Reference
Windows Clients
SNAplus2 Resources
Connectivity Resources
DLCs
Link Stations
Ports
Connection Networks
Local node can have an explicit link station defined for its
Session Resources
SNAplus2 Resources
Modes and Classes of Service
Directory Information
Domain Resources
SNAplus2 Administration
Administration Responsibilities
Administration Tools
Motif Administration Program
Xsnapadmin
Command-Line Administration Program
Remote Command Facility
Configuration Files
Chapter 103
NOF Applications
Diagnostic Tools
Simple Network Management Protocol Support
Administering SNAplus2
108
Planning for SNAplus2 Configuration
Planning Worksheets
Task Sheets
Local System
Enabling and Disabling SNAplus2 on
Specifying the Path to SNAplus2 Programs
Snap start -s -m kernelmemorylimit -t
Enabling SNAplus2 Servers
Mkernelmemorylimit
Disabling SNAplus2 Servers
Snap stop
Using the Motif Administration Program
Invoking the Motif Administration Program
Resource Windows
Domain Window
SNAplus2 Domain Window
Node Window
Node Window
Chapter 121
Resource Items
Tool Bar Buttons
SNAplus2 Tool Bar
Resource Dialogs
Sample Dialog
Status Dialogs
Help Windows
Sample Status Dialog
Sample Help Window
Ascii Administration Program
Snap2adm
Using the Command-Line Administration Program
Status
Define
Delete
Query
Using the Command-Line Administration Program 132
Basic Configuration Tasks
134
Configuring Client/Server Functions
Deletebackup
Addbackup
Querysnanet
Configuring the Node
Node Configuration Parameters
Appn support
Control point name
Control point alias
Additional Configuration
Node ID
Configuring Logging
Tail
Setcentrallogging Setgloballogtype Setlogtype Setlogfile
Chapter 141
Configuring Logging 142
Defining Connectivity
144
Chapter 145
146
Defining Ports, DLCs, and Connection Networks
Port, Connection Network, and DLC Configuration Parameters
SNA port name
Adapter card number
Port number
Additional Port Parameters for Sdlc
Initially active
Line details
Type
Encoding
Dial string
6AT &&D3 &&Q1 DT7,012345678
Additional Port Parameters for X.25 Qllc
Local SAP number
Define on connection network
CN name
Configure downstream LUs for implicit PU access
Additional Port Parameters for Implicit PU
Concentration
Maximum active template instances
Defining Link Stations
Link Station Configuration Parameters
Definetypels
Common Link Station Parameters
Name
Activation
LU traffic
Additional Link Station Parameters for Sdlc
Poll address
Line encoding
MAC address
SAP number
Circuit type
Channel ID
Remote X.25 address
Adapter/Port Number
Remote node name
Parameters for Independent LU Traffic
Remote node type
Local node ID
Parameters for Dependent LU Traffic
Remote node ID
Remote node role
Defining Dlur PUs
Dlur PU Configuration Parameters
Defineinternalpu
PU Name
Dlus Name
Reactivate PU after failure
166
Configuring Dependent LUs
168
Defining LU Types
LU Types 0-3 Configuration Parameters
Definelu0to3 Definelu0to3range
LU name
LU type
LU numbers
LU in pool
Pool name
Defining LU Pools
Definelupool
LU Pool Configuration Parameters
Assigned LUs
Defining LU Pools 174
Configuring Appc
176
Chapter 177
Defining Local LUs
Member of default pool
Local LU Configuration Parameters
Definelocallu
LU alias
180
Defining Remote Nodes
Remote Node Configuration Parameters
Definedirectoryentry
Definepartnerlu
Nodes SNA network name
Defining Partner LUs
Defineadjacentlennode definedirectoryentry
Partner LU Configuration Parameters
Partner LU name
Wildcard partner LU name
Alias
Supports parallel sessions
Uninterpreted Name
Location
186
Defining TPs
Issue the snapadmin definetp command
TP name
TP Invocation Parameters
Parameters are for invocation on any LU/on specific LU
Multiple instances supported
Route incoming Allocates to running TP
Arguments
Full path to TP executable
User ID
Group ID
TP Definition Parameters
Conversation level security required
Restrict access
Security access list
Defining Modes and Classes of Service
194
Standard Mode and COS Names
Mode Associated Purpose Name COS Name
Mode Configuration Parameters
Session limits
Initial session limit
Maximum session limit
Minimum contention winner sessions
Minimum contention loser sessions
Auto-activated sessions
Receive pacing window
Maximum window size
Session timeout
Maximum RU size
Chapter 199
Use default LU
Defining CPI-C Side Information
CPI-C Configuration Parameters
Local LU
Partner LU
Mode
Partner TP
Security
Password
Chapter 203
Definelulupassword
Configuring Appc Security
Configuring Session Security
Session Security Configuration Parameters
Defineuseridpassword
Configuring Conversation Security
Additional Configuration
Conversation Security Configuration Parameters
Configuring a Security Access List
Security Access List Configuration Parameters
Definesecurityaccesslist
Users in access list
Chapter 207
Configuring Appc Security 208
Configuring User Applications
210
Chapter 211
212
Configuring 3270 Emulator Users
Configuring 3270 Users and Sessions
Defineemulatoruser
Emulation User and Group Configuration Parameters
User Name
Group Name
Style File
Sessions
Style file access
Permissions
Session Configuration Parameters
Configuring 3270 Sessions
Session name
Display or Printer
LU/Pool name
Session base name
Number of sessions
Configuring 5250 Users
Configuring 5250 Emulator Users
Chapter 219
Configuring RJE Workstations
RJE Workstation Configuration Parameters
Workstation name
Run on computer
Unix group name
Configuring RJE Workstations 222
Configuring Passthrough
224
Configuring TN Server
Configuring TN Server Access Records
TN Server Access Record Configuration Parameters
Definetn3270access
TN3270 client address
Support TN3270E
TCP/IP port number
Allow access to specific LU
Configuring TN Server Association Records
Display LU assigned
Printer LU assigned
TN Server Association Record Configuration Parameters
Definetn3270association
Display LU
Printer LU
Configuring PU Concentration
Downstream LU Configuration Parameters
Downstream LU name
Upstream LU name
Allow timeout
Fake logon
Configuring Dlur
234
Managing SNAplus2 from NetView
236
Using the Host NetView Program
Changing the Size of the Command Input Area
Overview of RCF Command Syntax
NetView Screen Display
Input n
Commandtext
Uppercase Characters and Escape Characters
Using Escape Characters in RCF Commands
Characters to Produce Input ABcd
Using Spcf
Restrictions on Administration Commands Used with Spcf
Examples of Spcf Commands
Runcmd sp=myspname, appl=node, -a -d querylu0to3
UCF Command Syntax
Using UCF
Runcmd sp=spname, appl=unix, HP-UXcommand
Permitted Commands
HP-UXcommand
Output from HP-UX System Commands
Example of a UCF Command
Grep Temp ab*.c TEMP.out
Canceling a Command
Runcmd sp=myspname, appl=unix, ux-cancel
UCF Security
Using UCF 248
Managing SNAplus2 Clients
End of Section 250
Setting Up IP Port Numbers
Client Networking Requirements
LAN Access Timeout
Client Networking Requirements For Windows
Defining Client TPs
NOF verbs querycentrallogger or querynodeall
Managing Win32 Clients
Enabling a Win32 Client
Disabling SNAplus2 for a Win32 Client
Snapwinsec domain
Win32 Client Security
Snapwinsec off
Win32 Client Configuration
Possible values for each Registry subkey are as follows
Domain
Configuration
Snagroup
Lanaccesstimeout
Invokedtps
Serverlosttimeout
Broadcastattemptcount
Servers
Clientstarttimeout
Server1
Server2-Server10
Auditloggingenabled
Exceptionloggingenabled
Logging
Errorfile
Backuperrorfile
Errorfilewrapsize
Logdirectory
Auditfile
Backupauditfile
Auditfilewrapsize
Succincterrors
Succinctaudits
APItracing
file1
file2
flipsize
Truncationlength
Allapi
Appc
Cpic
Rui
Csv
Nof
MSGtracing
CStracing
Fmi
Datagram
Adminmsg
Data
Send
Receive
CSVdata
Csvtblg
Managing Win16 Clients
Enabling a Win16 Client
Disabling SNAplus2 for a Win16 Client
Win16 Client Security
Win16 Client Initialization File sna.ini
Chapter 279
Snauser
Chapter 281
282
Chapter 283
284
Chapter 285
286
Chapter 287
288
Chapter 289
290
Chapter 291
292
Chapter 293
End of Section 294
Enabling SNAplus2 on HP-UX Clients
Managing HP-UX Clients
Snap start -t
HP-UX Client Network Data File snaclnt.net
Chapter 297
Server names
End of Section Chapter 299
Managing HP-UX Clients 300
Configuration Planning Worksheets
302
Node Worksheets
Appn End Node
LEN Node
Your Motif FieldValid Entry/Notes Implementation Value
Your
LEN node
Configuration server?
Leased line Switched outgoing Switched incoming
Connectivity Worksheets
Number Port number
Initially active Select if needed Line Details Type
Duplex Setting
Negotiable Primary Primary multi-drop Secondary
Physical link type
Sdlc Link Station Dialog
By administrator On node startup On demand
Any Independent only Dependent only
Name Upstream Dlus
Token Ring
Appendix a 311
Ethernet
Motif Field Valid Entry/Notes Implementation Value
Appendix a 313
314
Fddi
NETNAME.CNNAME each
Independent LU traffic
Appendix a 317
Qllc
Appendix a 319
320
Subnet ID
Passthrough Services Worksheets
Your Motif FieldValid Entry/NotesImplementation Value
PU Concentration
LU Pool Dialog Pool name
LU lists
Downstream LU Dialog
TN Server Access Dialog
TN Server
Allow access to specific
TN Server Association Dialog Display LU
User Application Support Worksheets
Appc
255
Supports parallel
Minimum contention
Motif Field Valid Entry/Notes Implementation Value Location
Ebcdic characters
LS name
Restrict to specific LU
Multiple instances
Supported
Route incoming
User ID Up to 10 characters Password
Basic Mapped Either
Sync level
PIP allowed Select if needed
Name Local LU
5250
Partner TP name
3270
LU Type 0-3 Dialog LU name
Emulator User and Emulator Group Dialogs User name or group
Style file name
Multiple sessions Session name
Session Dialog Single session or
Session type
RJE Workstation Dialog Workstation name
LUA
337
338
Introduction to Snmp
340
SNAplus2 Appn Snmp Subagent
Appn Management Information Base MIB
Configuring an Invokable TP Using snaptpinstall
Snaptpinstall -afilename
Snaptpinstall -r -t TPname -l LUalias
Snaptpinstall -r -t TPname
Snaptpinstall -q -t TPname -l LUalias
File Format for snaptpinstall
TPname
346
Appendix C 347
348
Appendix C 349
350
Securitytype is Service
Securitytype
352
Using SNAplus2 in a High Availability Environment
354
What is High Availability?
356
Appendix D 357
SNAplus2 High Availability Features
LU Pools for 3270, 3179G, and LUA
Client/Server Configuration
Figure D-2 LU Pools
360
Appendix D 361
Table D-1 Component Primary Server Backup Server
Appendix D 363
364
Using SNAplus2 with MC/ServiceGuard
Figure D-6 SNAplus2 environment with ServiceGuard
Creating the HA SNAplus2 Package
Identifying Critical SNAplus2 Connectivity
Appendix D 367
SNAplus2 Package
Table D-2 Suggestions for Defining the SNAplus2 Package
Specifying the Service Command
Opt/sna/bin/snapmon HALS. See Specifying
370
Specifying a Package IP Address
SNAplus2 Client/Server LAN Connections
Figure D-7 SNAplus2 in Client/Server Configuration
SNA LAN Connections
TN Server LAN Connections
Figure D-9 SNAplus2 Server Running TNServer
Using the LAN to Access Standalone Servers
Figure D-10 Accessing SNAplus2 Server via LAN
Customizing the SNAplus2 Package Control
Script
Modifying the Path variable
Adding Customer Defined Functions
Snapadmin startls, lsname=HALS
Compatibility Constraints
Lans
Qllc
Sdlc
Appendix D 381
Advanced Configuration Techniques
Writing Your Own SNAplus2 Service Script
384
Appendix D 385
386
Index
Numerics
388
389
390
391
392
393
394
395
396
397
398