210 | HP UX SNAplus2 manual

Conﬁguring User Applications

Overview

Overview

This chapter provides instructions for conﬁguring SNA resources to support user applications that use any of the following communication: 3270, RJE, 5250, and LUA. The SNA resources required by such applications include LUs, session deﬁnitions, and user deﬁnitions. For 3270, RJE, LUA, and dependent APPC communication, you must conﬁgure dependent LUs. For independent APPC and 5250 communication, you can use the default control point LU (deﬁned automatically when you conﬁgure the local node) or deﬁne independent LUs.Before you can conﬁgure the resources described in this chapter, you must perform the following conﬁguration:

•Conﬁgure the node as described in “Conﬁguring the Node”.

•Conﬁgure connectivity as described in Chapter 5, “Deﬁning Connectivity Components.” For 3270, RJE, LUA, and dependent APPC communication, you must conﬁgure the link to support dependent LU trafﬁc. For independent APPC and 5250 communication, the link must support independent LU trafﬁc.

You do not need to conﬁgure a direct link to the host if you are using upstream PU Concentration or DLUR. For more information, see “Deﬁning DLUR PUs”.

The following list describes the conﬁguration tasks required for each type of user application:

3270 applications

For 3270 communication, conﬁgure the following resources:

210

Chapter 8

Image 210

HP UX SNAplus2 manual 210

Contents

Edition J2740-90013 HP 9000 Networking E1098 Legal Notices HEWLETT-PACKARD CompanyPage Page Contents Administering SNAplus2 Introduction to SNAplus2 Basic Conﬁguration Tasks Deﬁning Connectivity Components Conﬁguring Dependent LUs Conﬁguring Appc Communication Conﬁguring Passthrough Services Conﬁguring User Applications Managing SNAplus2 from NetView Managing SNAplus2 Clients Conﬁguration Planning Worksheets Conﬁguring an Invokable TP Using snaptpinstall Using SNAplus2 in a High Availability Environment Contents Contents About This Book PrefacePrerequisite Knowledge Organization of This BookPage 0p1 Typographic ConventionsOpcode LU name Definenode cd Publications for Users Operating System ConventionsSNAplus2 Publications 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 GuidePage SNA Terms and Concepts Overview Systems Network Architecture Basic SNA Concepts Network TypesSNA 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 Directory Services Locating ResourcesResource 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 Deﬁnitions 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 Example Conﬁgurations Standalone SNAplus2 Node That Communicates Directly with aHost SNAplus2 Nodes in an Appn Network SNAplus2 Node Providing PU Concentration and Dlur SNAplus2 Node Conﬁgured for TN Server SNAplus2 Client/Server Conﬁguration SNAplus2 Components Components of SNAplus2 Passthrough Services Node ComponentsSNA 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 Beneﬁts of Client/Server Operation A domain with multiple SNAplus2 servers, one server holds HP-UX Clients Reference Windows Clients SNAplus2 Resources Connectivity Resources DLCs Ports Link StationsConnection Networks Local node can have an explicit link station deﬁned 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 Conﬁguration Files Chapter 103 NOF Applications Diagnostic Tools Simple Network Management Protocol Support Administering SNAplus2 108 Planning for SNAplus2 Conﬁguration Planning Worksheets Task Sheets Enabling and Disabling SNAplus2 on Local SystemSpecifying the Path to SNAplus2 Programs Enabling SNAplus2 Servers Snap start -s -m kernelmemorylimit -tMkernelmemorylimit 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 Delete StatusDefine Query Using the Command-Line Administration Program 132 Basic Conﬁguration Tasks 134 Conﬁguring Client/Server Functions Addbackup DeletebackupQuerysnanet Appn support Conﬁguring the NodeNode Conﬁguration Parameters Control point name Additional Conﬁguration Control point aliasNode ID Conﬁguring Logging Tail Setcentrallogging Setgloballogtype Setlogtype Setlogfile Chapter 141 Conﬁguring Logging 142 Deﬁning Connectivity 144 Chapter 145 146 Deﬁning Ports, DLCs, and Connection Networks Adapter card number Port, Connection Network, and DLC Conﬁguration ParametersSNA port name Port number Line details Additional Port Parameters for SdlcInitially active Type Encoding Dial string 6AT &&D3 &&Q1 DT7,012345678 Deﬁne on connection network Additional Port Parameters for X.25 QllcLocal SAP number CN name Concentration Conﬁgure downstream LUs for implicit PU accessAdditional Port Parameters for Implicit PU Maximum active template instances Deﬁning Link Stations Link Station Conﬁguration Parameters Definetypels Activation Common Link Station ParametersName LU trafﬁc Additional Link Station Parameters for Sdlc Poll address Line encoding MAC address SAP number Remote X.25 address Circuit typeChannel ID Adapter/Port Number Parameters for Independent LU Trafﬁc Remote node nameRemote node type Parameters for Dependent LU Trafﬁc Local node IDRemote node ID Remote node role Defineinternalpu Deﬁning Dlur PUsDlur PU Conﬁguration Parameters PU Name Dlus Name Reactivate PU after failure 166 Conﬁguring Dependent LUs 168 Definelu0to3 Definelu0to3range Deﬁning LU TypesLU Types 0-3 Conﬁguration Parameters LU name LU numbers LU typeLU in pool Pool name Deﬁning LU Pools Definelupool LU Pool Conﬁguration Parameters Assigned LUs Deﬁning LU Pools 174 Conﬁguring Appc 176 Chapter 177 Deﬁning Local LUs Definelocallu Member of default poolLocal LU Conﬁguration Parameters LU alias 180 Deﬁning Remote Nodes Definepartnerlu Remote Node Conﬁguration ParametersDefinedirectoryentry Nodes SNA network name Deﬁning Partner LUs Defineadjacentlennode definedirectoryentry Wildcard partner LU name Partner LU Conﬁguration ParametersPartner LU name Alias Uninterpreted Name Supports parallel sessionsLocation 186 Deﬁning TPs Issue the snapadmin definetp command TP Invocation Parameters TP nameParameters are for invocation on any LU/on speciﬁc LU Multiple instances supported Route incoming Allocates to running TP Full path to TP executable ArgumentsUser ID TP Deﬁnition Parameters Group IDConversation level security required Restrict access Security access list Deﬁning Modes and Classes of Service 194 Standard Mode and COS Names Mode Associated Purpose Name COS Name Initial session limit Mode Conﬁguration ParametersSession limits Maximum session limit Auto-activated sessions Minimum contention winner sessionsMinimum contention loser sessions Receive pacing window Session timeout Maximum window sizeMaximum RU size Chapter 199 CPI-C Conﬁguration Parameters Use default LUDeﬁning CPI-C Side Information Local LU Partner TP Partner LUMode Security Password Chapter 203 Conﬁguring Session Security DefinelulupasswordConﬁguring Appc Security Session Security Conﬁguration Parameters Additional Conﬁguration DefineuseridpasswordConﬁguring Conversation Security Conversation Security Conﬁguration Parameters Definesecurityaccesslist Conﬁguring a Security Access ListSecurity Access List Conﬁguration Parameters Users in access list Chapter 207 Conﬁguring Appc Security 208 Conﬁguring User Applications 210 Chapter 211 212 Conﬁguring 3270 Users and Sessions Conﬁguring 3270 Emulator UsersDefineemulatoruser Group Name Emulation User and Group Conﬁguration ParametersUser Name Style File Style ﬁle access SessionsPermissions Conﬁguring 3270 Sessions Session Conﬁguration ParametersSession name Session base name Display or PrinterLU/Pool name Number of sessions Conﬁguring 5250 Users Conﬁguring 5250 Emulator Users Chapter 219 Workstation name Conﬁguring RJE WorkstationsRJE Workstation Conﬁguration Parameters Run on computer Unix group name Conﬁguring RJE Workstations 222 Conﬁguring Passthrough 224 Conﬁguring TN Server Definetn3270access Conﬁguring TN Server Access RecordsTN Server Access Record Conﬁguration Parameters TN3270 client address Support TN3270E TCP/IP port number Display LU assigned Allow access to speciﬁc LUConﬁguring TN Server Association Records Printer LU assigned Display LU TN Server Association Record Conﬁguration ParametersDefinetn3270association Printer LU Conﬁguring PU Concentration Downstream LU Conﬁguration Parameters Downstream LU name Allow timeout Upstream LU nameFake logon Conﬁguring Dlur 234 Managing SNAplus2 from NetView 236 Using the Host NetView Program NetView Screen Display Changing the Size of the Command Input AreaOverview of RCF Command Syntax 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 Using UCF UCF Command SyntaxRuncmd sp=spname, appl=unix, HP-UXcommand Permitted Commands HP-UXcommand Example of a UCF Command Output from HP-UX System CommandsGrep 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 Deﬁning Client TPs NOF verbs querycentrallogger or querynodeall Managing Win32 Clients Enabling a Win32 Client Disabling SNAplus2 for a Win32 Client Win32 Client Security Snapwinsec domainSnapwinsec off Win32 Client Conﬁguration Possible values for each Registry subkey are as follows Conﬁguration DomainSnagroup Lanaccesstimeout Invokedtps Serverlosttimeout Broadcastattemptcount Clientstarttimeout ServersServer1 Server2-Server10 Exceptionloggingenabled AuditloggingenabledLogging Errorﬁlewrapsize ErrorﬁleBackuperrorﬁle Logdirectory Backupauditﬁle AuditﬁleAuditﬁlewrapsize Succincterrors Succinctaudits ﬁle2 APItracingﬁle1 ﬂipsize Appc TruncationlengthAllapi Cpic Csv RuiNof MSGtracing CStracing Fmi Adminmsg DatagramData 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 Managing HP-UX Clients Enabling SNAplus2 on HP-UX ClientsSnap start -t HP-UX Client Network Data File snaclnt.net Chapter 297 Server names End of Section Chapter 299 Managing HP-UX Clients 300 Conﬁguration Planning Worksheets 302 Node Worksheets Appn End Node Your LEN NodeYour Motif FieldValid Entry/Notes Implementation Value LEN node Conﬁguration server? Number Port number Leased line Switched outgoing Switched incomingConnectivity Worksheets Initially active Select if needed Line Details Type Physical link type Duplex SettingNegotiable Primary Primary multi-drop Secondary 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 trafﬁc Appendix a 317 Qllc Appendix a 319 320 Subnet ID Passthrough Services Worksheets Your Motif FieldValid Entry/NotesImplementation Value LU lists PU ConcentrationLU Pool Dialog Pool name Downstream LU Dialog TN Server Access Dialog TN Server Allow access to speciﬁc TN Server Association Dialog Display LU User Application Support Worksheets Appc 255 Supports parallel Ebcdic characters Minimum contentionMotif Field Valid Entry/Notes Implementation Value Location LS name Supported Restrict to speciﬁc LUMultiple instances Route incoming Sync level User ID Up to 10 characters PasswordBasic Mapped Either PIP allowed Select if needed 5250 Name Local LUPartner TP name 3270 LU Type 0-3 Dialog LU name Emulator User and Emulator Group Dialogs User name or group Style ﬁle name Session Dialog Single session or Multiple sessions Session nameSession type RJE Workstation Dialog Workstation name LUA 337 338 Introduction to Snmp 340 SNAplus2 Appn Snmp Subagent Appn Management Information Base MIB Conﬁguring an Invokable TP Using snaptpinstall Snaptpinstall -r -t TPname Snaptpinstall -aﬁlenameSnaptpinstall -r -t TPname -l LUalias 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 Conﬁguration 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 Specifying the Service Command Table D-2 Suggestions for Deﬁning the SNAplus2 PackageOpt/sna/bin/snapmon HALS. See Specifying 370 Specifying a Package IP Address SNAplus2 Client/Server LAN Connections Figure D-7 SNAplus2 in Client/Server Conﬁguration 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 Modifying the Path variable Customizing the SNAplus2 Package ControlScript Adding Customer Deﬁned Functions Snapadmin startls, lsname=HALS Compatibility Constraints Lans Qllc Sdlc Appendix D 381 Advanced Conﬁguration 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