background image

294

Chapter 11

Managing SNAplus2 Clients

Managing Win16 Clients

The name of the local LU that this application uses.
This parameter is optional. If it is not specified, the
application attempts to use the default LU (the LU
associated with a local node's control point).

APPCTPN

The TP name of the application. This name is used in
log and trace files to identify the application. For an
invoked application (one that issues
Accept_Conversation), it is also used to match the TP
name on an incoming Allocate request with the correct
application; the invoked application can also use the
Specify_Local_TP_Name call to specify additional
names to be matched with incoming Allocate requests.
This parameter is optional. If it is not specified, the
default is

CPIC_DEFAULT_TPNAME

.

[CSV_data]

The

[CSV_data]

 section of the file specifies options for applications that

use the CSV interface. It applies only to applications that use the
CONVERT verb to perform character conversion with a user-defined
conversion table (Table G). For more information about the

CONVERT

verb, refer to HP-UX SNAplus2 CSV Programmers Guide.

If no applications on the client use this function, you do not need to
include this section.

The only option in this section is as follows:

CSVTBLG

The full path name of the file containing the
user-defined Table G conversion table. This parameter
is required if CSV applications need to perform Table G
character conversion (there is no default); otherwise it
is optional.

End of Section

Summary of Contents for HP-UX SNAplus2

Page 1: ...HP UX SNAplus2 Administration Guide Edition 2 J2740 90013 HP 9000 Networking E1098 Printed in United States Copyright 1998 Hewlett Packard Company 1998 All rights reserved ...

Page 2: ...Data and Computer Software clause at DFARS 252 227 7013 for DOD agencies and subparagraphs c 1 and c 2 of the Commercial Computer Software Restricted Rights clause at FAR 52 227 19 for other agencies HEWLETT PACKARD COMPANY 3000 Hanover Street Palo Alto California 94304 U S A Use of this manual and flexible disk s or tape cartridge s supplied for this pack is restricted to this product only Additi...

Page 3: ...990 1991 1992 Cornell University copyright 1989 1991 The University of Maryland copyright 1988 Carnegie Mellon University copyright 1989 1997 Data Connection Limited Trademark Notices UNIX is a registered trademark of The Open Group X Window System is a trademark of the Massachusetts Institute of Technology MS DOS and Microsoft are U S registered trademarks of Microsoft Corporation OSF Motif is a ...

Page 4: ...4 ...

Page 5: ...or Administrators 19 Publications for Programmers 20 Related Publications 21 1 SNA Terms and Concepts Overview 24 Systems Network Architecture 25 Basic SNA Concepts 26 Network Types 26 SNA Nodes 26 Connectivity 30 Transaction Programs 31 Application Programming Interfaces 31 Network Accessible Units 32 Sessions 36 Conversations 39 Modes 41 Route Selection 41 Class of Service 42 Basic APPN Concepts...

Page 6: ...onents 75 User Applications 79 Application Programming Interfaces 81 Client Server Support 85 SNAplus2 Resources 90 Connectivity Resources 91 Session Resources 94 Domain Resources 97 SNAplus2 Administration 98 Administration Responsibilities 98 Administration Tools 99 3 Administering SNAplus2 Overview 108 Planning for SNAplus2 Configuration 109 Planning Worksheets 109 Task Sheets 110 Enabling and ...

Page 7: ...g the Command Line Administration Program 130 4 Basic Configuration Tasks Overview 134 Configuring Client Server Functions 135 Configuring the Node 137 Node Configuration Parameters 137 Additional Configuration 138 Configuring Logging 139 5 Defining Connectivity Components Overview 144 Defining Ports DLCs and Connection Networks 147 Port Connection Network and DLC Configuration Parameters 148 Addi...

Page 8: ...rameters 173 Additional Configuration 173 7 Configuring APPC Communication Overview 176 Defining Local LUs 178 Local LU Configuration Parameters 179 Additional Configuration 179 Defining Remote Nodes 181 Remote Node Configuration Parameters 182 Additional Configuration 182 Defining Partner LUs 183 Partner LU Configuration Parameters 184 Additional Configuration 186 Defining TPs 187 TP Invocation P...

Page 9: ...plications Overview 210 Configuring 3270 Users and Sessions 213 Configuring 3270 Emulator Users 213 Configuring 3270 Sessions 216 Configuring 5250 Users 218 Configuring 5250 Emulator Users 218 Configuring RJE Workstations 220 RJE Workstation Configuration Parameters 220 Additional Configuration 221 9 Configuring Passthrough Services Overview 224 Configuring TN Server 225 Configuring TN Server Acce...

Page 10: ...acters 239 Using SPCF 241 Restrictions on Administration Commands Used with SPCF 241 Examples of SPCF Commands 242 Using UCF 243 UCF Command Syntax 243 Permitted Commands 244 Example of a UCF Command 245 Output from HP UX System Commands 245 Canceling a Command 246 UCF Security 247 11 Managing SNAplus2 Clients Overview 250 Client Networking Requirements 251 Setting Up IP Port Numbers 251 LAN Acces...

Page 11: ...ization File sna ini 278 Managing HP UX Clients 295 Enabling SNAplus2 on HP UX Clients 295 HP UX Client Network Data File sna_clnt net 296 A Configuration Planning Worksheets Overview 302 Node Worksheets 303 APPN End Node 303 LEN Node 304 Connectivity Worksheets 306 SDLC 306 Token Ring 310 Ethernet 312 FDDI 315 QLLC X 25 318 Passthrough Services Worksheets 322 DLUR 322 PU Concentration 323 TN Serv...

Page 12: ...okable TP Using snaptpinstall Overview 344 File Format for snaptpinstall 345 D Using SNAplus2 in a High Availability Environment Overview 354 What is High Availability 355 SNAplus2 High Availability Features 358 LU Pools for 3270 3179G and LUA 358 Client Server Configuration 359 Using SNAplus2 with MC ServiceGuard 365 Creating the HA SNAplus2 Package 366 Identifying Critical SNAplus2 Connectivity ...

Page 13: ...s 13 Specifying a Package IP Address 371 Customizing the SNAplus2 Package Control Script 376 I O Compatibility Constraints 378 Advanced Configuration Techniques 382 Writing Your Own SNAplus2 Service Script 383 ...

Page 14: ...14 Contents ...

Page 15: ...N Advanced Peer to Peer Networking concepts Chapter 2 Introduction to SNAplus2 Provides an overview of SNAplus2 including its components the resources it uses and the user applications that are supported by or provided with SNAplus2 Chapter 3 Administering SNAplus2 Explains how to prepare for SNAplus2 configuration enable and disable the SNAplus2 software on a server and how to use the Motif and t...

Page 16: ...ge SNAplus2 and run commands on SNAplus2 nodes from a host running NetView Chapter 11 Managing SNAplus2 Clients Explains how to configure and manage SNAplus2 clients Appendix A Configuration Planning Worksheets Provides configuration worksheets for SNAplus2 Appendix B APPN Network Management Using the Simple Network Management Protocol Provides information about the support provided by SNAplus2 fo...

Page 17: ...ameter or Motif field opcode LU name Literal value or selection that the user can enter including default values 255 On node startup Motif button Status Motif menu Services Motif menu item Configure node parameters User input 0p1 Computer output CLOSE Command or HP UX utility define_node cd General reference to all commands of a particular type query_ indicates all of the administration commands t...

Page 18: ...y The APIs for the Win32 and Win16 clients are fully compatible with Microsoft SNA Server and Windows Open System Architecture WOSA enabling applications written for SNA Server to run unchanged on the Win32 and Win16 clients End of Section This heading indicates the end of the operating system specific text The information following this heading applies regardless of the operating system SNAplus2 ...

Page 19: ...to the host list the queued jobs cancel a queued job and send commands to the host s job entry subsystem JES console HP UX SNAplus2 and TN3270 Glossary Provides a comprehensive list of terms and their definitions used in the SNAplus2 library Publications for Administrators SNAplus2 provides the following administrator guides HP UX SNAplus2 Installation Guide Explains how to install the SNAplus2 so...

Page 20: ... logging and tracing Publications for Programmers SNAplus2 provides the following programmer guides Each guide includes conceptual and detailed reference information HP UX SNAplus2 APPC Programmers Guide Contains the information you need to write application programs using Advanced Program to Program Communication APPC HP UX SNAplus2 CPI C Programmers Guide Contains the information you need to wri...

Page 21: ... Publications For information about SNA APPN or LU 6 2 architecture refer to the following IBM documents IBM APPN Architecture and Product Implementations Tutorial GG24 3669 IBM AS 400 Advanced Peer to Peer Networking GG24 3287 IBM eNetwork Communications Server for OS 2 APPC Programming Guide and Reference SC31 6160 System Management Programming Reference SC31 6173 IBM System 370 Principles of Op...

Page 22: ...22 ...

Page 23: ...23 1 SNA Terms and Concepts ...

Page 24: ...chapter is divided into the following parts Systems Network Architecture provides a definition of SNA Basic SNA Concepts explains terms and concepts that apply to any SNA network Basic APPN Concepts explains terms and concepts that apply only to SNA networks that support Advanced Peer to Peer Networking APPN Basic APPN Concepts introduces terms and concepts that apply to networks that combine SNA ...

Page 25: ...with a host computer Each network or sub network was controlled by the host other computers communicated directly with the host but not with each other This older host controlled style of network is often referred to as subarea SNA SNA has since developed to support direct peer to peer communications between computers in the network without requiring a host This newer peer level networking is APPN...

Page 26: ...evices Network Types SNA supports the following types of networks A subarea network is a hierarchically organized network consisting of subarea nodes and peripheral nodes Subarea nodes such as hosts and communication controllers handle general network routing Peripheral nodes such as terminals attach to the network without awareness of general network routing A peer network is a cooperatively orga...

Page 27: ...s type 5 nodes are also known as host nodes The devices and resources controlled by a type 5 subarea node constitute the domain of that node Type 4 nodes provide SNA functions that route and control the flow of data in a part of the network Because these functions are often provided by communication controllers type 4 nodes are also known as communication controller nodes Peripheral nodes serve su...

Page 28: ...onnects the host site with an end user site The users are usually on a separate site from the host so the two sites need to be connected by a communications link Terminal controller At the remote end of the communications link is a terminal controller also known as a cluster controller It is responsible for controlling the use of the link and routes data to the terminals The most well known IBM te...

Page 29: ...e terminals provide only simple data entry and display functions to and from the terminal controller the terminal controller is responsible for handling SNA communications between the terminals and the host The terminal controller and its terminals can be replaced by an SNA node using a product such as SNAplus2 From the host s point of view the node appears as a terminal controller However it prov...

Page 30: ...end node can communicate with adjacent nodes on its own but requires the services of a network node server to access nonadjacent nodes The domain of an APPN end node includes only itself Low entry networking nodes LEN nodes are type 2 1 nodes that do not support APPN functions They can communicate with adjacent nodes in an APPN network but do not participate in the APPN network In a LEN node all p...

Page 31: ... accesses the network through a logical unit LU that establishes and maintains a session with a partner LU on another node For more information about logical units see Logical Units NOTE SNAplus2 includes sample TPs for most supported APIs For more information on sample TPs refer to the programmer s guide for the API You can also purchase SNA TPs as part of other products or create your own TPs se...

Page 32: ...cation Programming Interfaces Network Accessible Units Communication between a TP and the SNA network occurs through network accessible units or NAUs formerly called network addressable units which are unique network resources that can be accessed through unique local addresses by other network resources SNA provides the following types of NAUs Physical units see Physical Units Logical units see L...

Page 33: ...a workstation that uses the HP UX operating system can communicate with a TP on an AS 400 computer as easily as it can with a TP on another HP UX workstation as long as both TPs use the same LU type SNAplus2 supports the following LU types LU 6 2 for APPC 5250 and CPI C LU 6 2 supports program to program communication in a distributed data processing environment The LU 6 2 data stream is either an...

Page 34: ...operative processing with the host LU 1 for 3270 printing and RJE LU 1 supports application programs and single or multiple device data processing workstations communicating in an interactive batch data transfer or distributed data processing environment The data streams used by LU type 1 conform to the SNA character string or Document Content Architecture DCA For example LU type 1 can support an ...

Page 35: ...rvices control point SSCP It manages and controls the network resources in a subarea network For example an SSCP can use a directory of network resources to locate a specific LU under its control and can establish communication between two LUs in its domain An SSCP can also cooperate with other SSCPs to establish connectivity between LUs in different subarea domains The SSCP also provides an inter...

Page 36: ...n communicate their LUs must establish a session The LU that manages the session on the local node is the local LU the LU that manages the session on the remote node is the partner LU Session Types SNAplus2 is primarily concerned with the following types of sessions LU LU sessions In order for two TPs to communicate the LUs that support the TPs must first establish an LU LU session In general a se...

Page 37: ...tivation by sending a BIND request to another LU A primary LU is the LU that sends the BIND request for a given LU LU session A secondary LU is the LU that receives the BIND request Peer networks do not use a fixed hierarchy of nodes and do not have predetermined primary or secondary LUs NOTE In a peer network an independent LU that is participating in multiple sessions see Multiple and Parallel S...

Page 38: ...ent An independent LU can act as a primary or as a secondary LU when establishing a session Multiple and Parallel Sessions An independent LU can participate in sessions with more than one remote LU at the same time multiple sessions An independent LU can also participate in parallel sessions or multiple concurrent sessions with the same remote LU Dependent LUs including dependent LU 6 2 cannot hav...

Page 39: ... of information is called a conversation Only one conversation can use a particular session at a time but sessions are serially reusable many conversations can use the same session one after another To initiate a conversation a source TP sends a request to its LU asking it to allocate a conversation with a remote TP The invoking TP or source TP initiates the conversation like the calling party in ...

Page 40: ...irectly the LUs on each node are the intermediaries in every exchange Figure 1 3 Communication between Transaction Programs and Logical Units SNA defines two types of conversations basic and mapped These two types of conversations use different methods to indicate the length of transmitted or received data packages to be passed between SNAplus2 and the TP In a basic conversation data must be forma...

Page 41: ...ion characteristics These session characteristics include throughput parameters session limits such as the maximum number of sessions between two LUs message sizes and routing parameters Each mode is identified by a unique mode name The mode name must be the same on all SNA nodes that use that mode Route Selection To establish an LU LU session a route must be calculated between the nodes where the...

Page 42: ... to establish a particular session The COS definition assigns relative values to factors such as acceptable levels of security cost per byte cost per connect time propagation delay and effective capacity In a subarea network a COS is derived from the mode associated with a session as defined in the host system APPN network nodes use the COS to compute session routes between independent LUs For mor...

Page 43: ... as the Application System 400 AS 400 the Enterprise System 9221 ES 9221 running under Distributed Processing Program Executive 370 DPPX 370 systems using Virtual Terminal Access Method VTAM and HP UX servers running SNAplus2 APPN provides the following functions Support for APPN network nodes and end nodes as well as non APPN peer nodes see APPN Node Types APPN control point functions see APPN Co...

Page 44: ...mple APPN network that includes all of these node types is shown in Figure 1 4 Portion of a Sample APPN Network Figure 1 4 Portion of a Sample APPN Network This example shows an APPN network that includes five network nodes NNs three end nodes ENs and a LEN node The network nodes form the backbone of the APPN network end nodes access the network through the network nodes LU 6 2 TPs on any node can...

Page 45: ... node is also referred to as the network node server for those nodes A network node provides the following services LU LU session services for its local LUs Directory searches and route selection for all LUs in its domain Intermediate session routing see Intermediate Routing Routing for management services MS data such as alerts between a served end node and an MS focal point APPN End Nodes An APP...

Page 46: ...upport APPN functions An APPN network node can provide routing services for an attached LEN node enabling the LEN node to participate in an APPN network without requiring link stations to be defined between the LEN node and all of the nodes in the APPN network LUs in the APPN network with which the LEN node may want to establish sessions must be defined to the LEN node as if they reside on the LEN...

Page 47: ...node These CP CP sessions are used to exchange directory topology and management services data Two parallel sessions are established between an APPN end node and the adjacent network node acting as the server for the end node These CP CP sessions are used to exchange directory topology and management services data LEN nodes do not support CP CP sessions The functions provided in CP CP sessions var...

Page 48: ...P name This name identifies each node to all other nodes in the network Similarly each logical unit is identified by a fully qualified LU name consisting of a network name and LU name Directory Services Each APPN node maintains a directory of network resources Directory services is the component of the node CP that manages the local directory database and in a network node searches for network res...

Page 49: ...end node can dynamically register its LUs with its network node server LEN nodes cannot register LUs with a network node server so LEN node LUs must be configured on their network node server A network node directory can also contain cached entries for LUs that are not in the network node s domain but whose location has been determined through a previous search Network nodes provide directory serv...

Page 50: ...s example Node LEN1 can establish a session with LU1 on Node EN1 through its network node server NNA However LU2 on Node EN1 is not defined in the directory for Node LEN1 so Node LEN1 cannot establish sessions with that LU End Node Directories When an LU is not represented in an end node directory the end node initiates a LOCATE search to find the desired LU To activate the search for a remote LU ...

Page 51: ...d to the end node However in order for Node EN3 to establish a session with LUX on Node LEN1 the LU on the LEN node must be configured as a partner LU on Node EN3 Network Node Directories A network node provides distributed directory services to the end nodes it serves An example of a network node directory is shown in Figure 1 7 Network Node Directory ...

Page 52: ...st from a LEN node An LU name specified by a TP on the network node 2 If the destination LU is not located in the network node but appears in its directory the network node sends a directed search request to the destination network node server to verify the location of the LU If the LU is not in the network node directory the node initiates a search of the network by sending a broadcast search to ...

Page 53: ...ute that does not change during the course of the session High Performance Routing HPR which includes the Rapid Transport Protocol RTP and automatic network routing ANR facilities RTP enables you to reroute session traffic around route failures or congestion and ANR minimizes cycles and storage requirements for routing network layer packets through intermediate nodes on a session route The APPN fu...

Page 54: ...des The end node provides this information to its network node server as part of the request to locate an LU and calculate a session route to that LU The network node server uses the end node topology information when calculating the session route for the end node The end node uses this information when establishing sessions with predefined LUs on adjacent nodes The end node topology database supp...

Page 55: ...epts Figure 1 8 Network Topology Database in Network Nodes The shared network topology database is duplicated at Nodes NNA NNB NNC and NND In addition each of those nodes includes local topology information except Node NNC which does not have any local ...

Page 56: ...the network topology database is kept current throughout the network Route Selection in an APPN Network APPN directory services locates a specific session partner topology and routing services calculates the optimal session route after the session partner has been located in the network Each network node provides route selection services for sessions originated by its own LUs and by LUs at the end...

Page 57: ...U to the node containing the destination LU Intermediate Routing Intermediate routing enables an APPN network node to receive and route data destined for another node The origin and destination of the data can be an end node another network node or a LEN Intermediate routing supports sessions between LUs that are not on adjacent nodes After a route has been selected for a session APPN network node...

Page 58: ...R route due to processing time at the endpoints For routes containing a larger number of intermediate nodes hops ANR routes are typically faster The exact location of the break even point depends on the efficiency of the RTP nodes Direct Connectivity Direct connectivity enables session traffic to travel directly between two nodes without the need for an APPN network node to route the session In ge...

Page 59: ... can establish a direct link to any node The link definitions needed to support direct links between Node EN1 and every other node in the APPN network are shown in Figure 1 10 Definitions Needed for Direct Links from Node EN1 to Every Node in an APPN Network For a network that includes five other nodes Node EN1 needs five link definitions EN1 to NNA EN1 to EN2 EN1 to EN3 EN1 to EN4 EN1 to EN5 ...

Page 60: ...in the network In a larger network the number of link definitions quickly becomes unwieldy Increasing the number of link definitions between network nodes also increases the number of TDUs flowing through the network which can degrade network performance APPN connection networks provide a solution to this problem APPN Connection Networks For APPN networks attached to a shared access transport faci...

Page 61: ...ons to an adjacent node In a connection network the SATF serves as a virtual routing node VRN that attaches directly to each node in the connection network The name of the connection network serves as the name of the control point for the VRN The VRN supports the direct routing of session data between any two nodes in the connection network but it does not establish CP CP sessions with other nodes...

Page 62: ...an have a much smaller number of link definitions 10 instead of 30 in this example In a larger network the difference in definition requirements becomes even more substantial A session between LUs on two nodes in the connection network is established as follows 1 Each end node first establishes CP CP sessions with its network node server If two end nodes have different network node servers those n...

Page 63: ... link between two end nodes as the optimal route for the LU LU session It provides the node with the primary LU the information it needs to establish a dynamic link to the node with the partner LU 4 The end nodes can then establish an LU LU session without the need for intermediate session routing ...

Page 64: ...network Dependent LU requester DLUR on a network node or end node provides a means of transporting session traffic from dependent LUs to a host through an APPN network This function enables dependent LU sessions to take advantage of the more versatile routing functions provided by APPN This combination of DLUR and DLUS generally known simply as DLUR allows dependent LU traffic to be transported ov...

Page 65: ...65 2 Introduction to SNAplus2 ...

Page 66: ...ew of SNAplus2 features and shows some of the basic configurations in which SNAplus2 can be used It describes the major components of SNAplus2 and the SNA resources that are configured for and used by SNAplus2 and provides an overview of SNAplus2 administration responsibilities and tools ...

Page 67: ...services SNAplus2 includes services that support communication between a host and computers on a LAN making it possible to reduce the number of communication links to the host simplify configuration of SNA nodes and provide host access for computers that have no direct link to a host For more information about passthrough services see Passthrough Services User applications SNAplus2 supports the fo...

Page 68: ...11 Windows for Workgroups Windows 95 and Windows NT enabling them to access SNA resources through SNAplus2 servers The APIs provided for Windows clients support 3270 and 5250 emulation and enable the development of custom applications These APIs implement the WOSA standards and are compatible with the APIs provided with Microsoft s SNA Server End of Section Administration facilities SNAplus2 inclu...

Page 69: ...ween a host and systems in a LAN A computer running SNAplus2 configured as a standalone system that communicates directly with a host computer is shown in Figure 2 1 Standalone SNAplus2 Node That Communicates Directly with a Host Figure 2 1 Standalone SNAplus2 Node That Communicates Directly with a Host Several SNAplus2 nodes configured as an APPN network are shown in Figure 2 2 SNAplus2 Nodes in ...

Page 70: ...ure 2 2 SNAplus2 Nodes in an APPN Network In Figure 2 3 SNAplus2 Node Providing PU Concentration and DLUR a computer running SNAplus2 provides TN server support for TN3270 and TN3270E clients The TN server node and the clients communicate through the TCP IP network ...

Page 71: ...e 2 3 SNAplus2 Node Providing PU Concentration and DLUR In Figure 2 4 SNAplus2 Node Configured for TN Server a computer running SNAplus2 provides TN server support for TN3270 and TN3270E clients The TN server node and the clients communicate through the TCP IP network ...

Page 72: ...ns Figure 2 4 SNAplus2 Node Configured for TN Server A network that includes SNA nodes SNAplus2 servers and non SNA computers SNAplus2 clients is shown in Figure 2 5 SNAplus2 Client Server Configuration The clients can access SNA resources through the servers ...

Page 73: ...5 SNAplus2 Client Server Configuration These examples show the most basic ways in which you can configure SNAplus2 nodes By combining nodes using these basic configuration types you can use SNAplus2 to support different types of communication within more complex networks ...

Page 74: ...onnectivity resources DLCs ports and link stations is implemented as a set of STREAMS components in the kernel of the HP UX system The 3270 emulation program RJE workstation APPC transaction programs CPI C applications LUA applications and the remote command facility RCF are user space programs SNAplus2 supports multiple copies of the 3270 and 5250 emulation programs and multiple APPC TPs CPI C ap...

Page 75: ...nfiguration Certain functions are supported only on end nodes as defined by the APPN architecture These differences are indicated where necessary in this manual where no differences are indicated the information applies to both node types Passthrough Services Passthrough services enable downstream computers on a LAN to access host resources through a server running SNAplus2 SNAplus2 provides the f...

Page 76: ...hrough the local node This enables a downstream computer to share a host connection with SNAplus2 or with other downstream computers instead of requiring a direct link For example you could set up several downstream computers connected to SNAplus2 over a local token ring network so that they could all access the same long distance leased line from SNAplus2 to the host Using PU concentration also s...

Page 77: ...ver DLUS at the host Together they route sessions across the network from dependent LUs in the APPN network to the DLUS host The route to the host can span multiple nodes and can take advantage of APPN s network management dynamic resource location and route calculation facilities TN Server 3270 emulation programs that communicate over TCP IP rather than over an SNA network are referred to as TN32...

Page 78: ...h other TN3270 users instead of requiring a direct link TN server also enables TN3270 users to access hosts that are not running TCP IP The SNAplus2 TN server function is shown in Figure 2 8 TN Server Figure 2 8 TN Server TN server provides an association between a TN3270 user and a 3270 LU on the SNAplus2 server All data from the TN3270 user is routed to the LU This means that the configuration f...

Page 79: ... to access as many sessions as there are available LUs in the pool User Applications SNAplus2 supports the following user applications 3270 emulation programs see 3270 Emulation 5250 emulation programs see 5250 Emulation RJE workstation daemon see RJE Workstation Daemon 3270 Emulation You can use 3270 emulation software to log on to and use SNA host systems from your computer control display and p...

Page 80: ...pport emulation across the domain Depending on the requirements of the 5250 emulation program you use you may need to configure the emulation program with additional information For more information about configuring support for 5250 emulation see Chapter 8 Configuring User Applications RJE Workstation Daemon SNAplus2 provides support for remote job entry RJE enabling you to submit jobs to a host ...

Page 81: ...m independent communication using independent LU 6 2 see CPI C API CSV Common Service Verb API for utility functions such as character translation and application trace control see CSV API HLLAPI high level language application programming interface for application programs that interact with the 3270 emulation program to automate standard 3270 tasks see HLLAPI LUA API for communications with host...

Page 82: ...communicate with a host you need a partner LU definition on the local node that specifies the uninterpreted name for the LU on the host When the TP requests a conversation from the local LU the local LU sends the host a session initialization request that contains the uninterpreted name for the host LU In the Motif administration program directory entries and partner LUs are not shown explicitly b...

Page 83: ...r APPC or CPI C application on a host or peer computer You define the same resources for a CPI C application as for an APPC application as described in APPC API In addition if the TP on the SNAplus2 computer is the invoking TP the TP that starts the conversation you may need to define one or more side information entries for it Each of these entries provides information about a partner TP the LU a...

Page 84: ...plus2 LUA Programmers Guide MS API The Management Services MS API enables an application to communicate with other MS products in an APPN network An application can be either NMVT level or MDS level depending on the type of MS data it sends and receives SNAplus2 performs any data conversion that is required For more information refer to the HP UX SNAplus2 MS Programmers Guide NOF API The NOF API c...

Page 85: ...plications on the local system or on other machines in the same domain A client does not contain SNA components but accesses them through a server A client can access one or more servers at the same time and can run concurrent applications as needed Servers must be HP UX computers clients can be running HP UX or Windows Servers and clients communicate across the SNAplus2 domain using TCP IP You ca...

Page 86: ...inates the need for each machine to have a physical SNA network connection Having multiple servers provides redundant connectivity for example by having multiple servers providing access to the same host Having multiple paths to an SNA resource enables load balancing across the different servers and provides immediate backup in the event that a particular server or link fails Using LU pools across...

Page 87: ... then takes over as the master If at any time the master server and all backup servers are inactive a node on a peer server can still operate and you can still change the node s configuration However you cannot access the domain configuration file and therefore cannot access the configuration of domain resources as opposed to node resources This means that you cannot start the 3270 emulation progr...

Page 88: ...sistent For more information about the SNA network data file refer to the HP UX SNAplus2 Administration Command Reference HP UX Clients For UNIX A client computer does not contain a configuration file or SNA network data file Instead the client has a client network data file that holds the information it needs to access servers on the SNAplus2 LAN The client relies on a server to provide the neces...

Page 89: ...ws 3 1 or Windows for Workgroups 3 11 or on Win16 subsystems on Windows NT Windows 95 or OS 2 SNA network information and other configuration information required by Win16 clients is held in the sna ini file The 32 bit version can be installed on machines running Windows 95 or Windows NT Configuration information required by Win32 clients is managed through the Windows Program Registry For more in...

Page 90: ... 2 for APPC and CPI C communications and for 5250 emulation Modes and their associated classes of service Directory information Domain resources are additional resources that are available to all nodes not defined as part of a particular node to support specific user programs Domain resources include the following 3270 user information 5250 user information RJE workstation information CPI C side i...

Page 91: ...ations Connection networks see Connection Networks If you use the Motif administration program you can define a connection network as part of port configuration For command line administration a connection network is configured separately DLCs A DLC is the component responsible for communication over a physical link or multiple links using a specific data link protocol such as SDLC or token ring E...

Page 92: ...ath through the SNA network between the SNAplus2 local node and a remote computer The remote computer can be any of the following A host computer on which SNAplus2 accesses a host program using 3270 RJE or LUA communications or uses APPC or CPI C for program to program communications A peer computer with SNAplus2 and the remote computer communicating as equal partners the typical arrangement in an...

Page 93: ...ode can establish communications with any other node that has a port associated with the same CN by accessing the VRN which represents all the other nodes attached to the SATF instead of requiring an explicitly defined communications path between each pair of nodes When two nodes on the SATF need to communicate and both have a port defined with the same VRN name APPN can dynamically establish a di...

Page 94: ...st computers running older versions of SNA host software LU types 0 3 are sometimes referred to as old LUs and are used to communicate with hosts using 3270 emulation RJE or LUA Type 0 3 LUs can also be grouped into LU pools as described in LU Pools In addition dependent type 6 2 LUs can be assigned to default pools as described in Default LUs Independent LUs LU type 6 2 is used to communicate wit...

Page 95: ...the LUs in a pool must be the same type For example you can define several 3270 display LUs in a single LU pool then configure multiple 3270 display sessions using this LU pool This makes configuring 3270 sessions easier and enables any 3270 session to use any LU in the pool LU pools can also span multiple SNAplus2 servers just define LU pools with identical names on the different servers Clients ...

Page 96: ...ween the two LUs such as maximum RU size and pacing window sizes and about whether the LUs can establish parallel sessions The definition of a mode can also include the name of a class of service COS which specifies minimum and maximum acceptable values for characteristics such as transmission time transmission cost and network security together with weightings associated with different ranges of ...

Page 97: ...sources Information about domain resources such as 3270 users RJE workstations access to the remote command facility CPI C side information and logging levels may be needed anywhere in the network For this reason only one definition is required for each such resource ...

Page 98: ... ensure that the SNAplus2 configuration matches that of the remote system Step 2 Initialize the SNAplus2 software Step 3 Optionally modify the configuration dynamically as your requirements change by adding or removing resources or by activating and deactivating the defined resources Step 4 Monitor the status of active resources and gather diagnostics information to diagnose any problems that occu...

Page 99: ...gram see Command Line Administration Program or refer to the HP UX SNAplus2 Administration Command Reference Service point command facility see Remote Command Facility Configuration files see Configuration Files Diagnostic tools see Diagnostic Tools Simple Network Management Protocol see Simple Network Management Protocol Support All of the SNAplus2 administration tools use the NOF API You can als...

Page 100: ...ific tasks Before starting the Motif administration program make sure the SNAplus2 software is enabled For more information see Chapter 3 Administering SNAplus2 To start the Motif administration program in the background issue the following command xsnapadmin All started SNAplus2 servers are shown on the main screen For those that have already been configured the program enables you to select a no...

Page 101: ...ration program to manage the modified configuration the program retains the changes you made using the other tools although the additional functions you have configured are not displayed in the Motif program Command Line Administration Program The command line administration program snapadmin enables you to issue commands to manage individual SNAplus2 resources You can use snapadmin either directl...

Page 102: ...UX commands on the SNAplus2 computer For more information about RCF see Chapter 10 Managing SNAplus2 from NetView Configuration Files Configuration information for the SNAplus2 system is held in the following text files Node configuration file The sna_node cfg file contains information about SNAplus2 node resources for a specific node This file resides on the computer where the node runs This file...

Page 103: ...rectly using a standard ASCII text editor such as vi or by means of a shell script using HP UX utilities such as awk or sed Any changes to configuration files using a text editor must be made before starting SNAplus2 Refer to the HP UX SNAplus2 Administration Command Reference for more information about SNAplus2 configuration file format NOTE SNAplus2 configuration is a dynamic process it is not n...

Page 104: ...le users or by the user to create his or her own customization The information in this file can be modified using the menu interface of the 3270 emulation program For more information about 3270 style files refer to the HP UX SNAplus2 3270 3179G Users Guide RJE workstation style file Information about the customization of the RJE workstation is held in a style file which can be set up either by th...

Page 105: ... preferred you can send both types of information to the same file On a client server system you can send messages from all servers to a central log file on one server central logging or send log messages to separate files on each server Log files are generated as text files and can be viewed using a standard ASCII text editor such as vi You can choose full logging which includes details of the ca...

Page 106: ... supplied by an application program using the MS API Refer to the HP UX SNAplus2 Diagnostics Guide for information about SNAplus2 log messages using SNAplus2 trace facilities and interpreting trace files For information about using the MS API refer to the HP UX SNAplus2 MS Programmers Guide Simple Network Management Protocol Support The Simple Network Management Protocol SNMP is an industry standa...

Page 107: ...107 3 Administering SNAplus2 ...

Page 108: ...nistration program guides you through the configuration needed to support SNA communication using SNAplus2 The Motif administration program is the recommended administration tool because it minimizes the configuration information you need to provide and guides you through each step you must perform to support different types of communication such as 3270 or APPC communication Alternatively you can...

Page 109: ... Once you determine the changes you need to make you can collect the configuration information that you need You can use the task sheets in the online help files for the Motif administration program or the planning worksheets described in Planning Worksheets to guide you in collecting configuration information for specific SNAplus2 functions Planning Worksheets Before you begin to configure resour...

Page 110: ...ask sheets contain pointers to all of the help screens for the dialogs that you will use to enter the configuration information You can use these to browse the help and see exactly what data you must collect The task sheets also refer to more detailed help for each of the individual windows and dialogs that you must use to enter configuration information Those help screens explain each field that ...

Page 111: ...plus2 when you run the programs you need to specify the path to this directory You can specify the path either by adding the directory to your PATH environment variable before you run the programs for the first time or by including the directory name each time you run the programs The Motif administration program is stored in the directory opt sna bin X11 and the other programs are stored in the d...

Page 112: ...ility automatically updates the startup file with this information The parameters and options for the snap start command are as follows s Specifies that SNAplus2 should not write messages to the system console If you do not use this option SNAplus2 writes messages to the console when it ends and also writes the text of certain error log messages to the console as well as to the log file m kernel_m...

Page 113: ... UX operating system error message The text written to standard error may also include a message indicating that you can find further information in the error log file The snap start command then ends with a nonzero exit code that indicates the nature of the error For more information about exit code values refer to the HP UX SNAplus2 Diagnostics Guide Disabling SNAplus2 Servers Disabling the SNAp...

Page 114: ...ts Applications using the APPC CSV LUA NOF or MS APIs are notified by a COMM_SUBSYSTEM_ABENDED return code HLLAPI applications by a HARC_SYSTEM_ERROR return code and CPI C applications by a CM_PRODUCT_SPECIFIC_ERROR return code To disable the SNAplus2 software enter the following command at the HP UX command prompt snap stop If SNAplus2 is disabled successfully snap stop returns an exit code of 0 ...

Page 115: ...istration program displays up to date status information through the same interface that is used for configuration providing easy access to status information for both domain and node resources Alternatively you can use SNAplus2 commands for configuration and system management A summary of configuration and management commands is provided in Using the Command Line Administration Program Invoking t...

Page 116: ...lete start and stop nodes Double clicking on any node brings up the Node window for that node The Node window shows all the key resources for a particular node The menus in the Domain and Node windows provide the following functions Selection The functions in this menu relate to the node that is currently selected in the Domain window or the item that is currently selected in the Node window From ...

Page 117: ...re using A node does not appear in the Domain window if SNAplus2 is not running on the node Each node is identified using the name of the system The Domain window also shows the current status of each node in the domain NOTE If a server is unexpectedly missing from the list of nodes in the Domain window verify that the server is switched on and that the SNAplus2 software is running on the server I...

Page 118: ...erform any of the following administration tasks from the Domain window Start or stop any node in the domain Select the line for the node and click on the Start or Stop button on this window Alternatively you can click on the line for the node then select Start node or Stop node from the Selection menu Administer a specific node Double click on the line for that node on the Domain window Alternati...

Page 119: ...g for all nodes in the domain Select Logging from the Diagnostics menu Turn tracing for a specific node on or off Click on the line for the node and select Tracing on selected node from the Diagnostics menu Get information about domain resources Choose any of the options on the Windows menu In addition to shared domain resources the Windows menu also lists each Node window in the domain NOTE If an...

Page 120: ... the relationships among resources and enables you to control which resources are displayed The Node box in the top right corner of the Node window indicates whether the node is Active or Inactive Any ports local LUs and remote nodes that are defined on the node are always displayed The Node window shows each link station below its parent port and each dependent LU below its parent link station It...

Page 121: ...ion for each remote node or partner LU To change the relative sizes of the panes click and drag on the boundaries between panes You can select a pane by clicking in it You can also select specific resources within a pane by clicking on the line for the resource To view or modify the configuration for an item you can double click on the item You can also use the buttons and menus on this window to ...

Page 122: ...elect Copy from the Selection menu In addition you can choose specific configuration tasks for the node from the Services menu control logging for the domain and tracing for the node from the Diagnostics menu and view or modify domain resources by selecting one of the items on the Windows menu Resource Items The layout of the resources in a window shows the relationships among them If an item has ...

Page 123: ...ce window If a button s operation is not valid for the currently selected item or an operation requires an item to be selected but none is the outline of the button is displayed in gray and the function cannot be selected the button cannot be pressed The following buttons can appear on resource windows Start Starts the selected item Stop Stops the selected item Add Adds a new resource item In the ...

Page 124: ...owever view an active resource s parameters by selecting the resource and clicking on the Zoom button to open its dialog or click on the Status button to view detailed status information for the resource Resource Dialogs Resource dialogs show the current configuration information for the resource A sample dialog for an LU of types 0 3 is shown in Figure 3 4 Sample Dialog ...

Page 125: ... process and supply default values whenever possible For example when you add a dependent LU the Motif administration program automatically fills in the LU number field with an available LU number on the link station you specify If you do not supply a required value the program presents a message pop up that indicates the information you need to provide ...

Page 126: ... configuration fields SNAplus2 supplies default values for advanced fields To access advanced configuration parameters click on the Advanced button If you decide to adjust advanced parameters complete the basic dialog before opening the advanced dialog because that dialog can change depending on the values you enter for basic parameters For information about advanced configuration fields see the o...

Page 127: ...mically as you view it Help Windows The online help for the Motif administration program provides detailed guidance for each configuration task you need to perform In particular task sheets can take you through each step you need to perform in configuring a particular resource The task sheet for configuring node parameters always the first step in configuring SNAplus2 is shown in Figure 3 6 Sample...

Page 128: ... Chapter3 Administering SNAplus2 Using the Motif Administration Program Figure 3 6 Sample Help Window Additional help windows are included for each window and dialog for error messages and for SNA concepts ...

Page 129: ...er based terminals The ASCII interface provides a subset of all functions availailable through the Motif Administration Program and can be used for configuration and management of SNAplus2 The ASCII program is used through the HP ObAM environment To start the program enter snap2adm Refer to the online help provided for more information on how to use the program ...

Page 130: ...u and dialog choices and fill in values based on available definitions Most administration commands are used with the snapadmin command line administration program You can issue snapadmin commands in the following form snapadmin command parameter1 value1 parameter2 value2 subrecord_name1 sub_param1 sub_value1 sub_param2 sub_value2 You can get help for snapadmin command line administration by using...

Page 131: ...information for types of resources define_ Creates a new define_ record in the configuration file or replaces an record for the same resource with the new definition delete_ Removes the corresponding define_ record from the file query_ Returns information from the configuration file on the appropriate component but does not modify the file For complete information about command line configuration ...

Page 132: ...132 Chapter3 Administering SNAplus2 Using the Command Line Administration Program ...

Page 133: ...133 4 Basic Configuration Tasks ...

Page 134: ...ks Overview Overview This chapter provides an overview of configuration tasks and explains how to configure the SNAplus2 node It also explains how to configure master and backup servers when SNAplus2 is used in a client server environment ...

Page 135: ...s2 maintains a list of these configuration servers The first server listed is the master server and any other servers listed are backup servers The servers are listed in order so that the second server listed the first backup server takes over if the master server is unavailable the third server listed the second backup server takes over if neither the master nor the first backup server is availab...

Page 136: ...uration servers are unavailable To remove a server select Remove configuration server from the Selection menu NOTE You cannot delete a server if it is the only server listed on which the SNAplus2 software is running because in this case there is no other server that can take over as the master server At least one enabled master server is required in a client server configuration You can also use t...

Page 137: ...e window Command line administration program Issue the define_node command Advanced parameters for node configuration provide control over sessions with undefined partner LUs reporting of security failures SNMP support and limited resource timeouts Node Configuration Parameters You need the following information for node configuration APPN support Level of APPN support for the node If your network...

Page 138: ... Node ID Identifier for the PU on the local node Supply a value only if the node will be used for dependent traffic using the default control point LU Additional Configuration After configuring the node continue with the following configuration tasks Configure connectivity as described in Chapter 5 Defining Connectivity Components Configure node resources LUs as described in Chapter 7 Configuring ...

Page 139: ...ge or an event that does not degrade the system but may indicate the cause of later exceptions or problems such as receiving an unexpected message from the remote system Audit A normal event such as starting a session To distinguish between logs relating to normal and error conditions the different message categories are logged to different files Problem and exception messages are logged to the er...

Page 140: ...nformation for a particular message number For most purposes the default settings for logging are sufficient but you can make the following types of changes Indicate what categories of messages are to be logged Problem messages are always logged and cannot be disabled Logging is normally disabled for the other two message categories but you can enable it if necessary Specify the level of detail in...

Page 141: ...n override the domain settings by configuring local log settings on a particular machine In addition to providing control over logging the Motif administration program provides node level control over tracing The command line interface provides greater control over both logging and tracing functions For more information about logging and tracing refer to HP UX SNAplus2 Diagnostics Guide ...

Page 142: ...142 Chapter4 Basic Configuration Tasks Configuring Logging ...

Page 143: ...143 5 Defining Connectivity Components ...

Page 144: ... node as described in Defining DLUR PUs When using the Motif administration program a data link control DLC is automatically configured as part of the configuration for the port In addition you have the option of defining the port as part of a connection network When using command line configuration this configuration is separate from port configuration The information required for link configurat...

Page 145: ...s available for 5250 and independent APPC but they do not apply to 3270 RJE or LUAunless you use DLUR DLUR supports communications between a host and dependent LUs on the local node or on downstream nodes in an APPN network You can use DLUR only if your host supports DLUS so you should consult your SNA network planner if you are interested in using DLUR Using 3270 RJE or LUA on Multiple Nodes If y...

Page 146: ...146 Chapter5 Defining Connectivity Components Overview For information about configuring PU concentration see Configuring PU Concentration ...

Page 147: ... When you use the Motif administration program to define a port for a particular link protocol SNAplus2 automatically defines a DLC for the port if a DLC of that type has not already been defined For command line configuration you must define the port and DLC using different commands In an APPN network using token ring Ethernet or FDDI link protocols you can also use the SAP Configuration dialog t...

Page 148: ...eters are required for port configuration When you use the Motif administration program port configuration also supplies information about the DLC and enables you to assign a port to a connection network SNA port name The locally known name of the port Adapter card number A number that identifies the adapter card to use if you have more than one card of the same type in this computer If you have o...

Page 149: ... following values Leased Line A dedicated line is used for the SDLC link between this computer and the remote system Switched incoming The standard telephone network is used for incoming calls For a nonprimary port as indicated by the Link role field you also need to configure the poll address for outgoing calls that address is configured on the link station The poll address is a one byte address ...

Page 150: ...tting enables the two ends to negotiate which end performs the primary role Choose this value if you do not know which role is configured for the remote system You can use this setting for a peer link but be aware that negotiating the role causes a short delay when the link is activated Primary Multi drop The link is leased and this port is to act as controller of a multi drop link to several seco...

Page 151: ...igure a switched incoming port you need to configure the following Dial string An ASCII string to be sent to your modem in order to prepare it to accept incoming calls By default the dial string is sent to the modem at the rate of 1200 bits per second the default baud rate using asynchronous communications You can match the baud rate to the modem s baud rate by placing one of the following numbers...

Page 152: ...ynamically without prior configuration This field applies only if the local node is not a LEN node because LEN nodes cannot use connection networks CN name The name of the connection network You do not need to enter the CN name unless you specified the Define on connection network option to define the SAP on a connection network The CN name is used as the name of a virtual routing node in order to...

Page 153: ...Port Parameters for Implicit PU Concentration Maximum active template instances Specify the maximum number of link station instances to be generated from the template Configure downstream LUs for implicit PU access Whether to configure downstream LUs that use this PU see Configuring PU Concentration Additional Configuration After performing the port configuration continue with the following config...

Page 154: ...tream computer that uses the SNAplus2 PU concentration feature or DLUR feature in order to access a host A link station is associated with a specific port you can define one or more link stations on each port Each link station that supports dependent traffic has an associated PU physical unit Because PUs are associated with link stations SNAplus2 does not treat them as separate resources they are ...

Page 155: ...ties and reactivation procedures Link Station Configuration Parameters In Motif the Link Station Configuration dialog contains the following sections each containing different categories of configuration parameters Link station Use this area of the dialog to provide information that is required for all link stations whether they support LU traffic for dependent LUs independent LUs or both For desc...

Page 156: ...ink station is started automatically when the node starts up On demand The link station is started automatically when required to provide connectivity for an application Link stations are activated separately from ports so the link station must be activated even if the port is already active Activating the port does not itself activate any link stations and configuring the port to be initially act...

Page 157: ...scribed in Parameters for Dependent LU Traffic in addition to those described in this section You also need to provide addressing information for contacting the adjacent node The type of addressing information needed depends on the DLC type of the port If you do not supply an address for the remote node the link station acts as a nonselective listening link station accepting incoming calls from an...

Page 158: ...e poll address is configured as the ADDR parameter in the VTAM PU definition On an AS 400 system the poll address is the STNADR parameter of the Line Description Line encoding The line encoding used on your SDLC line In the U S this is usually NRZ In Europe this is usually NRZI If you set this incorrectly you will find that the frames being received are all discarded and do not appear in any trace...

Page 159: ...ng refer to your modem s documentation Additional Link Station Parameters for Token Ring FDDI and Ethernet MAC address The MAC address of the remote station entered as a series of hexadecimal digits The MAC address uniquely identifies the adapter card on the remote system If you do not know what value to use consult your SNA network planner If the remote end of this link is a VTAM host you can fin...

Page 160: ...aximum of 4096 If you have only one permanent virtual circuit its channel ID is likely to be 1 Remote X 25 address The DTE address of the remote DTE as a series of hexadecimal digits only applicable if the circuit is a switched virtual circuit Adapter Port Number The card number if your card has only one port If you have only a single card use a value of 0 If your card has more than one port use t...

Page 161: ...ecifying a remote node type of Discover If the local node is a LEN node you do not need to specify the remote node type and the Remote node type field does not apply If the local node is an end node rather than a LEN node and if you specify a remote node type of Discover you do not have to supply the remote node name If you do not supply a remote node name any adjacent node can use the link statio...

Page 162: ...an 255 dependent LUs to access a specific host you must configure multiple link stations to the host each with up to 255 dependent LUs and each with a different local node ID To ensure that the remote node is configured to recognize the local node ID contact your SNA network planner In a VTAM configuration the first three digits should match the IDBLK parameter in the PU definition and the last fi...

Page 163: ...g PU concentration or DLUR the adjacent node role should still be set to Host even though the link is not directly to a host computer Downstream PU concentration The link station is to a downstream node that will communicate with a host using the PU concentration capabilities of the local node to the host the LUs on the downstream node appear to reside on the local node Additional Configuration Af...

Page 164: ...DLUR services DLUR on an APPN node such as a node running SNAplus2 works in conjunction with dependent LU server DLUS at the host to route sessions from dependent LUs on the DLUR node across the APPN network to the DLUS host The route to the host can span multiple nodes and can take advantage of APPN s network management dynamic resource location and route calculation facilities DLUR must be avail...

Page 165: ...igured on the host computer For each PU you need to define a DLUR PU on the SNAplus2 node The PU ID must match the PU ID configured at the host for this PU In many cases the PU ID is the same as the node ID so the node ID is the default However if you need more than 255 dependent LUs to access a specific host you need to configure multiple DLUR PUs each with up to 255 dependent LUs and each with a...

Page 166: ...ditional Configuration After configuring DLUR continue with the following configuration tasks To configure LUs for DLUR see Defining DLUR PUs To configure other passthrough services see Chapter 9 Configuring Passthrough Services To support specific user applications see Chapter 8 Configuring User Applications To support APPC communication see Chapter 7 Configuring APPC Communication ...

Page 167: ...167 6 Configuring Dependent LUs ...

Page 168: ...configure the resources described in this chapter you must perform the following configuration Configure the node as described in Configuring the Node Configure connectivity as described in Chapter 5 Defining Connectivity Components For 3270 TN3270 RJE and LUA you must configure the link to support dependent LU traffic You do not need to configure a direct link to the host if you are using upstrea...

Page 169: ...her New 3270 display LU or New 3270 printer LU RJE and New RJE LU LUA and New LUA LU TN server and New host LU Command line administration program Issue one of the following commands define_lu_0_to_3 define_lu_0_to_3_range You can use the advanced dialog to restrict access to a specific SSCP or to specify an inactivity timeout LU Types 0 3 Configuration Parameters The following parameters are requ...

Page 170: ...u are configuring For a 3270 display LU specify the appropriate model based on the screen size 3270 model 2 80x24 3270 model 3 80x32 3270 model 4 80x43 3270 model 5 132x27 For a printer LU specify one of the following 3270 printer SCS printer For an RJE workstation specify RJE Workstation If you do not know the LU type if the LU is used to support PU concentration from the local node to the host a...

Page 171: ... the LU type 0 3 configuration continue with the following configuration tasks To use a pool of dependent LUs for a 3270 display for TN3270 for RJE or for LUA define the LU pool as described in Defining LU Pools For 3270 define emulator users as described in Configuring 3270 Emulator Users For RJE define the RJE workstation as described in Configuring RJE Workstations For TN3270 define TN3270 clie...

Page 172: ...tion and makes it easy to increase capacity by adding another server or by adding LUs on an existing server You can view all of the LU pools for the SNAplus2 domain using the LU Pools window This window lists the LU pools configured in the system and enables you to select LUs to add to an LU pool The individual LUs in an LU pool are listed below the LU pool An LU is identified as follows 3270 disp...

Page 173: ...ly be a member of one pool RJE LUs cannot be used as members of a pool Each RJE LU is associated with a particular RJE workstation so different LUs of the same type are not identical in function Additional Configuration After performing the LU pool configuration continue with the following configuration tasks For 3270 define emulator users as described in Configuring 3270 Emulator Users For RJE de...

Page 174: ...174 Chapter6 Configuring Dependent LUs Defining LU Pools ...

Page 175: ...175 7 Configuring APPC Communication ...

Page 176: ...ode resources used to access it and any security information required The configuration steps for APPC depend on whether the LU 6 2 traffic is dependent or independent Unless the remote node is a host you must use independent traffic If the remote node is a host you can use either dependent or independent traffic Before you can configure APPC communication you must perform the following configurat...

Page 177: ...r LU as described in Defining Partner LUs Step 4 Define an invokable TP as described in Defining TPs Step 5 Define a mode as described in Defining Modes and Classes of Service Step 6 Define CPI C side information as described in Defining CPI C Side Information Step 7 Define APPC security as described in Configuring APPC Security Step 8 To configure 5250 communication see Configuring User Applicati...

Page 178: ... defining partner LUs for the applications the partner LUs must be defined on all nodes where default LUs are defined so that the application can contact the correct partner LU using any of the default local LUs defined on any node Independent APPC and 5250 use independent LUs Each LU LU session involves a local LU and a partner LU For the local LU you can use the predefined default LU associated ...

Page 179: ... LU name the network name is always the same as the first part of the CP name of the local node LU alias The LU alias of the LU If you do not enter an alias the LU name is used as the alias Host LS DLUR PU The name of the host link station or DLUR PU to which the LU belongs This field applies only if the LU is a dependent LU LU number The LU number of the dependent LU This field applies only if th...

Page 180: ...partner LU see Defining Partner LUs To define an invokable TP see Defining TPs To define a mode see Defining Modes and Classes of Service To define CPI C side information see Defining CPI C Side Information To define APPC security see Configuring APPC Security To configure 5250 communication see Configuring User Applications ...

Page 181: ...PPN network you must define the remote node because it cannot be dynamically located If you need to define the remote node and did not do so when you were defined the link station you must do so before you can use APPC communications over the link When you add a remote node definition a partner LU with the same name as the remote node is automatically added this is the control point LU for the rem...

Page 182: ...rtner LU issue the following command define_partner_lu Remote Node Configuration Parameters The following parameter is required for remote node configuration Node s SNA network name The fully qualified CP name of the remote node The value entered on this dialog must match the CP name configured at that remote node Additional Configuration After performing the remote node configuration continue wit...

Page 183: ...t LU was defined automatically when you defined the remote node You can use wildcards to configure multiple partner LUs that are all located on the same remote node and whose names start with the same characters Using wildcards means that you do not need to configure each partner LU individually To configure a partner LU use one of the following methods Motif administration program You can use the...

Page 184: ...plete SNA network name that matches the first part of the fully qualified partner LU names exactly or a wildcard prefix that matches the beginning of the network name for the partner LUs If you supply a wildcard prefix as the value for the first string leave the second string blank For example a wildcard entry of A would match all LUs in the SNA networks named A ANT or APPN but not BUFFALO or ZEBR...

Page 185: ...cond part of the partner LU name This is correct in most cases If in doubt consult your SNA network planner This field applies when you define partner LU on a specific remote node or when you define a partner LU alias Supports parallel sessions Whether the partner LU can support more than one session at a time In most cases the partner LU supports many sessions at one time but some LEN nodes do no...

Page 186: ...continue with the following configuration tasks To define an invokable TP see Defining TPs To define a mode see Defining Modes and Classes of Service To define CPI C side information see Defining CPI C Side Information To define APPC security see Configuring APPC Security To configure 5250 communication see Configuring User Applications ...

Page 187: ...versation security for the TP To indicate whether the TP uses basic or mapped conversations To specify sync point processing To specify handling of PIP data Invokable TPs To enable a TP to be started automatically in response to an incoming allocation request define it as an invokable TP as described in TP Invocation Parameters An invokable TP or target TP is one that is started in response to an ...

Page 188: ...hes for a TP definition with the TP name specified on the incoming Allocate If the definition exists SNAplus2 uses the information in this definition to start the TP if multiple instances are permitted or the TP is not already running or to determine that it should queue the incoming Allocate if the TP is already running and multiple instances are not permitted If necessary you can configure both ...

Page 189: ...stall command see Appendix C Configuring an Invokable TP Using snaptpinstall TP Invocation Parameters The following parameters are required for a TP that can be invoked on the local node TP name A TP name in one of the following forms Application TP If the remote TP is a user application supply the name as normal characters up to 64 characters in length Service TP If the remote TP is an SNA servic...

Page 190: ...g Allocate requests to this computer or if it is received by an LU on this computer that has no routing information configured If you select this option the TP is a nonqueued TP SNAplus2 starts a new copy of the TP each time an incoming Allocate request arrives for it A nonqueued TP cannot be started by an operator it is always started automatically by SNAplus2 For a nonqueued TP SNAplus2 permits ...

Page 191: ...provide the file name SNAplus2 assumes that the executable file name is the same as the TP name parameter If no path is specified the default path for HP UX systems is etc TPname where TPname is the TP name parameter For a Windows system the system uses the usual Windows mechanism to locate the executable file The file must have execute permission for the user specified by the User ID parameter In...

Page 192: ...ddition if User ID is set to root the file must be owned by root and must have setuid and setgid permission in order to be started automatically by SNAplus2 Group ID The group ID that SNAplus2 uses to start the TP This must be a valid HP UX group ID on the SNAplus2 computer This line is optional If it is not included the default is sna TP Definition Parameters You can configure an APPC TP to speci...

Page 193: ...ou do not select this option no verification is required Restrict access Select this option if the user name must be included on a security access list This field applies only if the Conversation level security required option is selected Security access list Name of a security access list that contains user IDs permitted to access this TP If the Restrict access option is selected you must provide...

Page 194: ...ty The COS also specifies weightings associated with different ranges of these values This enables the node to calculate the best route across the network when two or more routes to the same remote LU are available You do not need to associate a COS with the mode the COS name is determined dynamically SNA defines a number of standard modes and associated COSs that cover the requirements of most sy...

Page 195: ...ogram Select APPC and Modes from the Services menu on the Node window then choose New on the Mode window Mode Name Associated COS Name Purpose blank CONNECT Sessions that do not specify a mode name basic default COS parameters BATCH BATCH Sessions used by batch processing applications INTER INTER Sessions used by interactive applications BATCHSC BATCHSC Sessions used by batch processing applicatio...

Page 196: ...h local and remote applications may also use this name so check the name with your application developer or refer to your product documentation for a third party application Session limits Use the following fields to specify session limits Initial session limit The maximum number of sessions up to the maximum session limit that a pair of LUs can have using this mode unless a different maximum is n...

Page 197: ...2 must reserve for use by the local LU as the contention loser Together with the value in the Minimum contention winner sessions field this value determines how to resolve contention for a session This can usually safely be set to 0 but if you are not sure consult your SNA network planner The sum of the minimum contention winner sessions and the minimum contention loser sessions must not exceed th...

Page 198: ...acing window can be from 0 through 32767 bytes A value of 0 specifies an unlimited window If the adjacent node supports only fixed pacing these values determine the fixed pacing window size but the adjacent node can still set a window size through negotiation If the adjacent node uses adaptive pacing these values set the initial window size Session timeout The number of seconds 0 65535 that an LU ...

Page 199: ...e used to tune the session level throughput between the local and partner LUs If you do not know what values to use start with the default values and adjust them as needed to maximize throughput Reset to SNA defined values If you are modifying a standard mode using the Motif dialog you can click on this button to reset the values of the mode parameters to the SNA defined values Additional Configur...

Page 200: ...ion use one of the following methods Motif administration program Select APPC and CPI C from the Services menu on the Node window Command line administration program Issue the following command define_cpic_side_info CPI C Configuration Parameters For each CPI C symbolic destination name used by the application collect the following information Name The symbolic destination name used by the CPI C a...

Page 201: ... partner TP Mode The name of the APPC mode that is to be used to access the partner LU In most cases the mode is one of the following predefined modes A blank name BATCH BATCHSC INTER INTERSC QPCSUPP Partner TP The name of the transaction program with which the CPI C application communicates If the TP is a user application specify the name as normal characters up to 64 characters in length If the ...

Page 202: ...hat security parameters to use User ID If you have chosen a security level of Same Program or Program strong specify a user ID to be sent on the initiating message to the remote application This value must match a user ID that the application is defined to accept This user ID is not related to HP UX login user IDs on either the local or the remote node If the remote node is running SNAplus2 the us...

Page 203: ... Side Information Additional Configuration After performing the CPI C configuration continue with the following configuration tasks To define APPC security see Configuring APPC Security To configure 5250 communication see Chapter 8 Configuring User Applications ...

Page 204: ...cal LU and partner LU The passwords are not related to HP UX logon passwords To configure session security use one of the following methods Motif administration program Select APPC Security and Session level security from the Services menu on the Node window Command line administration program Issue the following command define_lu_lu_password Session Security Configuration Parameters The following...

Page 205: ... incoming conversations Each definition consists of a user ID and a password The user IDs and passwords are not related to HP UX logon user IDs and passwords To configure conversation security use one of the following methods Motif administration program Select APPC Security and Conversation level security from the Services menu on the Node window Command line administration program Issue the foll...

Page 206: ...P or both This list can be referred to by the definition for an APPC local LU or TP To configure a security access list use one of the following methods Motif administration program Select APPC Security and Conversation level security from the Services menu on the Node window then select the Security Access Lists pane and choose New Command line administration program Issue the following command d...

Page 207: ...ng APPC Communication Configuring APPC Security Additional Configuration After performing the security access list configuration continue with the following configuration tasks Configure TP access as described in Defining TPs ...

Page 208: ...208 Chapter7 Configuring APPC Communication Configuring APPC Security ...

Page 209: ...209 8 Configuring User Applications ...

Page 210: ...LUs Before you can configure the resources described in this chapter you must perform the following configuration Configure the node as described in Configuring the Node Configure connectivity as described in Chapter 5 Defining Connectivity Components For 3270 RJE LUA and dependent APPC communication you must configure the link to support dependent LU traffic For independent APPC and 5250 communic...

Page 211: ...e 3270 emulation features such as key mapping and display attributes SNAplus2 3270 emulation also enables you to use HLLAPI applications 5250 applications For 5250 communication configure the following resources Step 1 Configure the node for APPC communication a If you can use the local node s control point LU you do not need to configure a local LU If you need a local LU definition for example to...

Page 212: ...configuration For RJE communication configure the following resources Step 1 Define a dependent LU as described in Defining LU Types 0 3 Step 2 To enable an RJE workstation to select from a pool of LUs define an LU pool as described in Defining LU Pools If the RJE workstation uses a dedicated LU you can skip this step Step 3 Define RJE workstations as described in Configuring RJE Workstations LUA ...

Page 213: ... the group are available for all users in the group This means that you do not have to define each user individually reducing the time needed to configure users If there are several users with sessions using the same LUs or LU pools you should first define one user and add all the session definitions To add the other users you can copy the first user definition Emulator user information can be acc...

Page 214: ...on the Windows 95 or Windows NT system Group Name When adding a user group supply the name of the group to which the user belongs For users running the emulation program on HP UX systems this name is set up by the administrator of the HP UX system For Windows 3 1 or Windows for Workgroups 3 11 or on Win16 subsystems on Windows NT Windows 95 or OS 2 this name is the snagroup field in the Configurat...

Page 215: ...ed only by the SNAplus2 3270 emulation program Restricted The user cannot specify a style file at the command line when starting the emulation program and cannot modify the style file settings from within the emulator Normal The user can specify a style file from the command line and can modify its settings Initial The user can specify a style file at the command line but cannot modify its setting...

Page 216: ...sion information can be accessed by the SNAplus2 3270 emulator program To configure 3270 sessions use one of the following methods Motif administration program Select Emulator users and sessions from the Windows menu on the Node window then choose New Command line administration program Issue the following command define_emulator_user 3270 Session Configuration Parameters You can configure a singl...

Page 217: ...ividual LU from a pool but that LU is unavailable when the session is activated the session can use any other available LU from the pool To configure multiple sessions supply the following information Session base name The first five characters for the session name A unique name is constructed for each session using this base name and a session number NOTE If you want to add several 3270 sessions ...

Page 218: ... have to define each user individually reducing the time needed to configure users Emulator user information can be accessed by a Windows client running an emulation program that is compatible with Microsoft s SNA Server product To configure an emulator user or group use one of the following methods Motif administration program Select Emulator users and sessions from the Windows menu on the Node w...

Page 219: ...hen adding a user group supply the name of the group to which the user belongs For users running the emulation program on HP UX systems this name is set up by the administrator of the HP UX system For Windows 3 1 or Windows for Workgroups 3 11 or on Win16 subsystems on Windows NT Windows 95 or OS 2 this name is the snagroup field in the Configuration section of the sna ini file which usually resid...

Page 220: ...efine_rje_wkstn RJE Workstation Configuration Parameters The following parameters are required for RJE workstation configuration Workstation name A name by which users can identify the RJE workstation for example when they start the workstation or submit jobs The workstation name must be 1 4 characters long You may find it helpful to use the workstation name that is defined on the host computer bu...

Page 221: ...ned LUs The LUs that support the RJE workstation You can have a maximum of five assigned LUs The LUs must all be on the same host the Motif administration program warns you if the LUs you are trying to add are on different links During operation an assigned LU may be unavailable because the LU has been deleted or because the node on which it is defined cannot currently be contacted Additional Conf...

Page 222: ...222 Chapter8 Configuring User Applications Configuring RJE Workstations ...

Page 223: ...223 9 Configuring Passthrough Services ...

Page 224: ...ively referred to as TN3270 clients To configure this function see Configuring TN Server PU concentration provides connectivity between the host and local systems You can configure LUs on the local node to support this function or you can define a template that is used to support downstream LUs that have not been explicitly configured see Configuring PU Concentration DLUR supports dependent LU ses...

Page 225: ...e the TN3270 LUs on the local node that are used for communication with the host To add the LUs see Defining LU Types 0 3 If you are going use any LU pools define them as described in Defining LU Pools To configure TN server perform the following tasks Configure a TN server access record for each TN3270 client who will use the server or a default record that enables any client to access the server...

Page 226: ...are active To configure a TN server access record use one of the following methods Motif administration program Select TN server from the Services menu on the Node window and TN server from the submenu On the resulting window select the TN Server Client Access Permissions pane and choose New Command line administration program Issue the following command define_tn3270_access TN Server Access Recor...

Page 227: ...port to which the TN3270 client connects NOTE TCP IP ports are completely unrelated to SNA ports The well known port number for the TN3270 service is 23 but use of this port number is likely to clash with the HP UX system TELNET service SNAplus2 includes a utility to enable this port to be shared between the telnet and TN3270 daemons that utility must be installed for both to work For details abou...

Page 228: ...N3270E and TN3287 clients to request a specific LU for a session This option is not available to TN3270 clients Additional Configuration After performing the TN server access configuration continue with the following configuration tasks Configure TN server association records as described in Configuring TN Server Association Records To configure PU concentration see Configuring PU Concentration To...

Page 229: ...istration program Issue the following command define_tn3270_association TN Server Association Record Configuration Parameters The following parameters are required for TN server association record configuration Display LU The name of the display LU which must be defined on the local node Printer LU The name of the printer LU which must be defined on the local node Do not specify a printer LU that ...

Page 230: ...ad of requiring a direct link For example you can set up several downstream computers connected to SNAplus2 over a local token ring network so that they all access the same long distance SDLC leased line from SNAplus2 to the host Using PU concentration also simplifies the configuration at the host The host configuration needs to include only the SNAplus2 computer and its host communications link t...

Page 231: ...t are used on the downstream nodes and the name of the host LU The LUs that are defined on the downstream nodes can be any dependent LU type To configure downstream LUs use one of the following methods Motif administration program Select PU concentration and New downstream LU from the Services menu on the Node window Command line administration program Issue one of the following commands define_do...

Page 232: ...the downstream LUs will communicate Fake logon To reduce the number of LUs required SNAplus2 displays a fake logon screen a 3270 user must hit a key before the user is associated with an upstream LU Allow timeout To reduce the number of LUs required an LU without an active PLU SLU session is disassociated from the upstream LU after this number of seconds Additional Configuration After performing t...

Page 233: ...e advantage of APPN s network management dynamic resource location and route calculation facilities DLUR must be available on the node where the LUs are defined and DLUS must be available on the host node but you do not have to enable DLUR on any intermediate nodes in the session route NOTE You cannot configure DLUR on a LEN node To configure DLUR support on the local node you must perform the fol...

Page 234: ... Chapter9 Configuring Passthrough Services Configuring DLUR printer RJE or LUA Depending on the requirements of the user applications supported by the LUs you may also need to perform further configuration ...

Page 235: ...235 10 Managing SNAplus2 from NetView ...

Page 236: ...SNAplus2 RCF provides the following two functions Service point command facility SPCF enables a NetView operator to issue SNAplus2 administration commands from NetView using the same syntax as for the command line administration program snapadmin This facility is described in Using SPCF UNIX command facility UCF enables a NetView operator to issue HP UX operating system commands from NetView This ...

Page 237: ...n by using 3270 emulation to access NetView from SNAplus2 instead of accessing it directly from the host In this case you also require the following 3270 LU configured at the host 3270 session using this LU Consult your host administrator to obtain the necessary configuration information To access the NetView program follow these steps Step 1 Ensure that the SNAplus2 software is started using a do...

Page 238: ...the longer commands you need more than one line On some versions of NetView you can specify an input area of one two or three lines by using the input command To do this type the following command input n In this command n is 1 2 or 3 indicating the number of lines you want If this command does not work on the version of NetView you are using contact your NetView support personnel Overview of RCF ...

Page 239: ...e and lowercase alphabetic characters the NetView program does not Instead it translates all characters into uppercase before sending them to the HP UX computer Also the host character set may not support the square bracket characters and which are required in some commands RCF provides support for uppercase characters and square bracket characters using the backslash character as follows To inclu...

Page 240: ...terpreting special characters are not required with RCF For example do not use escape characters with strings containing the characters or as you would when entering them on the HP UX command line Also when using SPCF to issue administration commands be aware that constant names such as LIST_FROM_NEXT are not case sensitive You do not need to escape these characters to make them uppercase Characte...

Page 241: ...ation commands associated with a specific node s resources for example the query_node and define_local_lu commands are sent to the node associated with the service point name specified on the SPCF command You cannot use the n option to specify a different node name therefore you cannot issue commands to a specific node unless this node is associated with a service point name at NetView Commands th...

Page 242: ...ation Command Reference Examples of SPCF Commands The following example shows how you could issue the define_lu_0_to_3 command using SPCF This example uses backslash characters to indicate uppercase letters in the two character strings LU 01 and PU2 There is no need to make the characters in the constant name 3270_display_model_2 uppercase because the snapadmin program accepts this string in lower...

Page 243: ...from the UCF by starting a new HP UX shell for each command and running the command in that shell If UCF support is not included SNAplus2 does not start this program The configuration specifies the name of the UCF user which must be a valid login name on the SNAplus2 computer The UCF shell is started using the shell program login ID permissions and login or profile specified for that user If no sh...

Page 244: ...ers with strings containing the characters or as you would when entering them on the HP UX command line Permitted Commands The UCF is designed for use with commands that complete whether or not any output is produced without any further interaction from the user For example you can issue the command cat filename which completes after displaying the contents of filename or mv filename1 filename2 wh...

Page 245: ... ab c t e m p out The command that would run on the HP UX computer is grep Temp ab c TEMP out Output from HP UX System Commands When a command is issued successfully the following messages are displayed on the NetView screen EXECUTING UNIX COMMAND any output from the command including error messages UNIX COMMAND COMPLETED These messages may not appear on the NetView screen at the same time The EXE...

Page 246: ...stop the process In addition to canceling the command that is currently executing SNAplus2 cancels any commands that are queued after it The command syntax is the same as for the HP UX command with the string ux cancel instead of the command text For example runcmd sp myspname appl unix ux cancel For each outstanding command the one currently executing and any queued commands the following message...

Page 247: ... s ID and therefore with the access permissions of this user It is intended that you use the normal security features provided by HP UX to restrict the commands the UCF user can access in order to permit only those commands you consider reasonable for use from UCF The following guidelines may be useful The UCF user name should be one that is used solely for UCF you should not use an existing login...

Page 248: ...248 Chapter10 Managing SNAplus2 from NetView Using UCF ...

Page 249: ...249 11 Managing SNAplus2 Clients ...

Page 250: ...r name Such a command has the same effect as if it were issued at the named server For Windows There are two versions of the Windows client The 32 bit Win32 client can be run on Windows NT Version 3 51 or later and Windows 95 The 16 bit Win16 client can be run on Windows 3 1 and Windows for Workgroups 3 11 For Windows clients you must supply information that SNAplus2 can use to enable the client s...

Page 251: ...ounter problems enabling the SNAplus2 software check the error log file for messages indicating that the port number used by SNAplus2 clashes with the port number used by another program If you find such messages take the following steps Step 1 Check the etc services file on the computer where the error occurred to see if another program is listed as using the port number 1553 for either TCP IP or...

Page 252: ...s not automatically disable the SNAplus2 software on the client SNAplus2 remains active and attempts to re establish contact with a server if an application requires it at a later time The lan_access_timeout parameter in the sna_clnt net file for a HP UX client the Registry for the Win32 client or the sna ini file for the Win16 client enables you to disable the SNAplus2 software on the client The ...

Page 253: ... is down the client re starts the attempt to contact a server as described for the and servername parameters in HP UX Client Network Data File sna_clnt net Servers or Servers Incoming Attaches for invoked TPs on this client cannot be accepted while the TCP IP connection is down the Attach is rejected as though the target system were inactive This means that automatically started TPs on the client ...

Page 254: ... is held in the Windows Program Registry On a Win32 client the component that handles access to SNAplus2 servers is called the Win32 client The client must be enabled before you can use SNAplus2 applications or emulation programs on the client For more information see Enabling a Win32 Client When the client is enabled it contacts a server running SNAplus2 over the TCP IP network in order to access...

Page 255: ...es the information in the Windows Program Registry described in Win32 Client Configuration to locate a server running SNAplus2 On a Windows 95 system if the server is set up to validate user names for Win32 clients as described in Win32 Client Security SNAplus2 displays a pop up message requesting a password You must type in a password SNAplus2 uses this password and the user name configured for t...

Page 256: ...ssword to the HP UX system as a system user name Step 3 After enabling the SNAplus2 software on a server use the following command snapwinsec domain This command enables Win32 client security on all servers in the SNAplus2 domain You do not need to repeat the command when enabling the SNAplus2 software on other servers When a Win32 client starts up and tries to access a server on which Win32 clien...

Page 257: ...sible values for each Registry subkey are as follows Configuration domain domain_name snagroup group_name invoked_tps YES NO lan_access_timeout nn broadcast_attempt_count nn server_lost_timeout nn client_start_timeout nn Servers Server1 servername1 Server2 servername2 Server10 servername10 Logging exception_logging_enabled YES NO audit_logging_enabled YES NO log_directory directory error_file erro...

Page 258: ... NOTE The domain domain_name value is the only required value in the Registry The following sections explain the contents of the file Where a parameter in the file takes the values YES or NO any string beginning with Y or y is interpreted as YES and any string beginning with N or n is interpreted as NO Configuration The Configuration subkey contains configuration information for the client as foll...

Page 259: ... user records for groups of users this line of the file is optional If neither the user name nor the group name is specified 3270 or 5250 users on the client can use the DEFAULT user record if any in the domain configuration file If the client will not be running 3270 or 5250 emulation this line of the file is not required invoked_tps The Registry data type of this value is REG_SZ Specify one of t...

Page 260: ... one attempt to contact a server The valid range is 1 65535 The minimum value is 1 if a higher value is specified the client retries every 10 seconds until it contacts a server or until this count is reached If the count is reached without contacting a server the client then attempts to contact a named server as described in Servers This parameter is optional If it is not specified the default is ...

Page 261: ...r of seconds specified in this field to enable the Win32 client to get in first In this way the Win32 client can connect to a server to provide the resources required by the application before the application fails due to the lack of those resources Servers The Servers subkey contains information about SNAplus2 servers that the client can access as follows Server1 The Registry data type of this va...

Page 262: ...ame of the first server instead of Server2 Server10 The Registry data type of this value is REG_SZ Specify the names of additional SNAplus2 servers that the client should contact in order of preference If the client has tried to contact a server using a UDP broadcast or has tried to contact the server specified in Server1 but has received no response it then attempts to contact the server specifie...

Page 263: ...ritten to a central file on a server In this case only the exception_logging_enabled and audit_logging_enabled parameters specified here are used the remaining parameters are ignored The logging options are specified as follows exception_logging_enabled The Registry data type of this value is REG_SZ Set this parameter to one of the following values YES Record exception messages NO Do not record ex...

Page 264: ... the default is sna err To log error and audit messages to a single file specify the same file name for both this parameter and the audit_file parameter backup_error_file The Registry data type of this value is REG_SZ Name of the backup error log file When the error log file reaches the size specified in error_file_wrap_size SNAplus2 copies its contents to the backup file overwriting any existing ...

Page 265: ...t_file The Registry data type of this value is REG_SZ Name of the backup audit log file When the audit log file reaches the size specified in audit_file_wrap_size SNAplus2 copies its contents to the backup file overwriting any existing file then clears the audit log file This parameter is optional If it is not specified the default is bak aud To log error and audit messages to a single file specif...

Page 266: ... of the log and any action required you can use the snaphelp utility on a computer running HP UX NO Use verbose logging each message in the log file includes a full listing of the message header information the message text string and parameters and additional information on the cause of the log and any action required This parameter is optional If it is not specified the default is taken from the...

Page 267: ...iption of the file2 parameter This parameter is required if you want to enable API tracing file2 The Registry data type of this value is REG_SZ The full path name of the second trace file This parameter is optional to indicate that tracing is to one file instead of two files do not include this line If both file1 and file2 are specified tracing is to two files When the first file reaches the size ...

Page 268: ...avoid filling up the file with long messages This parameter is optional If it is not specified SNAplus2 does not truncate messages all the data from each message is written to the file all_api The Registry data type of this value is REG_SZ To trace messages for all APIs set this parameter to YES In this case SNAplus2 ignores the parameters from appc through nof To disable tracing for all APIs set ...

Page 269: ...Registry data type of this value is REG_SZ To trace LUA RUI messages set this parameter to YES otherwise set it to NO This parameter is optional If it is not specified the default is NO If the all_api parameter is set to YES this parameter is ignored and LUA RUI messages are traced nof The Registry data type of this value is REG_SZ To trace NOF API messages set this parameter to YES otherwise set ...

Page 270: ... is required if you want to enable message tracing you also need to set the fmi parameter file2 The Registry data type of this value is REG_SZ The full path name of the second trace file This parameter is optional To indicate that tracing is to one file instead of two files do not include this line If both file1 and file2 are specified tracing is to two files When the first file reaches the size s...

Page 271: ...age but avoid filling up the file with long messages This parameter is optional If it is not specified SNAplus2 does not truncate messages all the data from each message is written to the file fmi The Registry data type of this value is REG_SZ To trace 3270 messages set this parameter to YES otherwise set it to NO This parameter is optional If it is not specified the default is NO CS_tracing The C...

Page 272: ...approximately twice the value of the flip_size parameter flip_size The Registry data type of this value is REG_DWORD The maximum size of the trace file If two file names are specified tracing switches between the two files when the current file reaches this size If only one file name is specified this parameter is ignored the file size is not limited This parameter is optional If it is not specifi...

Page 273: ...o NO This parameter is optional If it is not specified the default is NO Appl_Name The Appl_Name subkey specifies options for a CPI C application To set these options for one or more applications include a section in this format for each application and replace the Appl_Name variable with the application program s executable name not including the exe file name extension For more information about...

Page 274: ...AULT_TPNAME CSV_data The CSV_data subkey specifies options for applications that use the CSV interface It applies only to applications that use the CONVERT verb to perform character conversion with a user defined conversion table Table G For more information about the CONVERT verb refer to HP UX SNAplus2 CSV Programmers Guide If no applications on the client use this function you do not need to in...

Page 275: ...er information required by Win16 clients is held in the sna ini file On a Win16 client the component that handles access to SNAplus2 servers is the network access process NAP The NAP must be enabled before you can use SNAplus2 applications or emulation programs on the client For more information see Enabling a Win16 Client When the NAP is enabled the client contacts a server running SNAplus2 over ...

Page 276: ... mechanisms to run wnap exe The client then uses the information in the sna ini file described in Win16 Client Initialization File sna ini to locate a server running SNAplus2 If the server is set up to validate user names for Win16 clients as described in Win16 Client Security SNAplus2 displays a pop up message requesting a password You must type in a password SNAplus2 uses this password and the u...

Page 277: ...e Win16 client computer define this user name For Windows 3 1 or Windows for Workgroups 3 11 this name is defined using the snauser parameter in the Configuration section of the sna ini file described in Win16 Client Initialization File sna ini Step 3 On all servers that this client can access define this user name and password to the HP UX system as a system user name The servers the client can a...

Page 278: ...nt initialization file sna ini contains SNA network information similar to the information held in the client network data file on HP UX clients This file also contains some additional configuration information that is specific to Win16 clients This file is stored in the directory where the Windows software was installed typically c windows it is set up during the client installation process and i...

Page 279: ... NO ms YES NO MSG_tracing file1 msg_trace_filename_1 file2 msg_trace_filename_2 flip_size filesize truncation_length length fmi YES NO CS_tracing file1 cs_trace_filename_1 file2 cs_trace_filename_2 flip_size filesize admin_msg YES NO datagram YES NO data YES NO send YES NO receive YES NO Appl_Name APPCTPN tp_name APPCLLU lu_name CSV_data CSVTBLG table_G_filename NOTE The domain domain_name line is...

Page 280: ...e defined as a system user name on all servers listed in the parameters Server1 Server10 as described in Servers or on all servers that can respond to UDP broadcasts if the client uses this method to locate a server If the client will be running 3270 or 5250 emulation and you want to configure the user explicitly instead of using the default emulator user configuration this name must be defined as...

Page 281: ...50 Emulator Users If you have not set up emulator user records for groups of users this line of the file is optional If neither the user name nor the group name is specified 3270 or 5250 users on the client can use the DEFAULT user record if any in the domain configuration file If the client will not be running 3270 or 5250 emulation this line of the file is not required invoked_tps Specify one of...

Page 282: ...d range is 1 65535 The minimum value is 1 if a higher value is specified the client retries every 10 seconds until it contacts a server or until this count is reached If the count is reached without contacting a server the client then attempts to contact a named server as described in Servers This parameter is optional If it is not specified the default is 5 server_lost_timeout If the client loses...

Page 283: ...client then tries using directed messages to one or more named servers specified by the following lines of the file In situations where the client cannot reach any servers using UDP broadcasts and must use directed messages specify the name of the first server it should try to contact This applies in the following cases When the SNAplus2 LAN spans multiple TCP IP subnets and there are no SNAplus2 ...

Page 284: ...to to indicate the use of UDP broadcasts Only the Server1 parameter can be used to indicate this because the value must precede any server names in the file Logging The Logging section of the file specifies logging options for the client These options can be used to specify client logging settings that override the logging options specified for the domain as a whole For more information about spec...

Page 285: ...ry where log files are stored on this client All the log files and backup log files specified in the following parameters are stored in this directory This parameter is optional If it is not specified the files are stored in the Windows installation directory typically c windows error_file Name of the file to which error messages are written This parameter is optional If it is not specified the de...

Page 286: ...e as the audit_file_wrap_size parameter audit_file Name of the file to which audit messages are written This parameter is optional If it is not specified the default is sna aud To log error and audit messages to a single file specify the same file name for both this parameter and the error_file parameter backup_audit_file Name of the backup audit log file When the audit log file reaches the size s...

Page 287: ...information such as the message number and log type and the message text string and parameters To obtain more details of the cause of the log and any action required you can use the snaphelp utility on a computer running HP UX NO Use verbose logging each message in the log file includes a full listing of the message header information the message text string and parameters and additional informati...

Page 288: ...eter is required if you want to enable API tracing file2 The full path name of the second trace file This parameter is optional to indicate that tracing is to one file instead of two files do not include this line If both file1 and file2 are specified tracing is to two files When the first file reaches the size specified by the flip_size parameter the second file is cleared and tracing continues t...

Page 289: ... APIs set this parameter to YES In this case SNAplus2 ignores the parameters from appc through nof To disable tracing for all APIs set all_api and all of the parameters from appc through nof to NO To trace only messages for specific APIs set all_api to NO and use the parameters from appc through nof to indicate which APIs to trace This parameter is optional If it is not specified the default is NO...

Page 290: ...set it to NO NOF messages are not used directly by applications on Win16 clients but are used internally by SNAplus2 components in obtaining configuration information This parameter is optional If it is not specified the default is NO If the all_api parameter is set to YES this parameter is ignored and NOF messages are traced ms To trace MS API messages set this parameter to YES otherwise set it t...

Page 291: ...racing can continue for long periods without using excessive disk space the maximum space required is approximately twice the value of the flip_size parameter flip_size The maximum size of the trace file If two file names are specified tracing switches between the two files when the current file reaches this size If only one file name is specified this parameter is ignored the file size is not lim...

Page 292: ...ond trace file This parameter is optional to indicate that tracing is to one file instead of two files do not include this line If both file1 and file2 are specified tracing is to two files When the first file reaches the size specified by the flip_size parameter the second file is cleared and tracing continues to the second file When this file then reaches the size specified by flip_size the firs...

Page 293: ... from the client to the server set this parameter to YES otherwise set it to NO This parameter is optional If it is not specified the default is NO receive To trace all data messages received by the client from the server set this parameter to YES otherwise set it to NO This parameter is optional If it is not specified the default is NO Appl_Name The Appl_Name section of the file specifies options...

Page 294: ... matched with incoming Allocate requests This parameter is optional If it is not specified the default is CPIC_DEFAULT_TPNAME CSV_data The CSV_data section of the file specifies options for applications that use the CSV interface It applies only to applications that use the CONVERT verb to perform character conversion with a user defined conversion table Table G For more information about the CONV...

Page 295: ...is as follows t Activates client server tracing This enables you to diagnose problems that occur during the client s attempt to connect to a server If you do not use this option client server tracing is inactive at all interfaces you can then activate it as required using the command line administration program snapadmin This option is equivalent to selecting the Set all tracing on field in the Mo...

Page 296: ...on file or the SNA network data file it holds only the information it needs to access servers on the SNAplus2 LAN and relies on a server to provide the necessary configuration information The SNA network information required is held in the file etc sna_clnt net This file is set up during the client installation process it is an ASCII text file that can be modified later as required using a standar...

Page 297: ...meout so that the TCP IP connection is kept active as long as the SNAplus2 software is running on the client do not specify this parameter This parameter is optional if it is not specified the default is no timeout broadcast_attempt_count If the client uses the broadcast method to contact a server specified by the entry this parameter specifies the maximum number of broadcasts to be made in one at...

Page 298: ...pecified by the broadcast_attempt_count parameter until it contacts a server If the limit specified by broadcast_attempt_count is reached before a server has been contacted the client then tries using directed messages to one or more named servers specified by the following lines of the file In situations where the client cannot reach any servers using UDP broadcasts do not include this line This ...

Page 299: ...listed and so on If the line to indicate the use of UDP broadcasts is not included at least one server name must be specified otherwise server names are optional If the client tries all the servers listed without success it waits for the time specified by server_lost_timeout above and then restarts the process of trying to contact a server either with UDP broadcasts or with the first server listed...

Page 300: ...300 Chapter11 Managing SNAplus2 Clients Managing HP UX Clients ...

Page 301: ...301 A Configuration Planning Worksheets ...

Page 302: ...es Node configuration Complete one of the worksheets contained in Node Worksheets depending on the capabilities of the node and the characteristics of the network in which it operates Connectivity configuration Complete one or more of the worksheets contained in Connectivity Worksheets depending on the link protocols used to communicate with the other systems in your network Passthrough services c...

Page 303: ...ng information but does not provide routing services for other nodes Motif Field Valid Entry Notes Your Implementation Value Node Parameters Dialog APPN support End node Control point name NETNAME CPNAME each 1 8 type A EBCDIC characters To connect to a VTAM host this name must match the NETID and CPNAME entries in the VTAM PU statement Control point alias Up to 8 characters Node ID 8 hexadecimal ...

Page 304: ...store information about domain resources in the SNAplus2 LAN Application Configuration See User Application Support Worksheets Motif Field Valid Entry Notes Your Implementation Value Motif Field Valid Entry Notes Your Implementation Value Node Parameters Dialog APPN support LEN node Control point name NETNAME CPNAME each 1 8 type A EBCDIC characters To connect to a VTAM host this name must match t...

Page 305: ...ion Not required for a standalone node Configuration server Should the node act as a configuration server to store information about domain resources in the SNAplus2 LAN Application Configuration See User Application Support Worksheets Motif Field Valid Entry Notes Your Implementation Value ...

Page 306: ...link station on a port SDLC Token Ring Ethernet FDDI QLLC X 25 SDLC Complete this worksheet to support connectivity using the SDLC link protocol Motif Field Valid Entry Notes Your Implementation Value SDLC Port Dialog SNA port name Up to 8 characters SDLC card number 0 to number_of_cards_minus_1 Port number 0 to number_of_ports_on_card_minus_1 Initially active Select if needed Line Details Type Le...

Page 307: ...ss is the STNADR parameter of the Line Description Encoding NRZ or NRZI only for switched incoming or leased port On a VTAM host this is the NRZI setting in the LINE GROUP definition Duplex Setting Half Duplex Full Duplex only for switched incoming or leased port Physical link type Select modem type Dial string String for modem initialization only for Smart Modem or V 25 switched incoming ports SD...

Page 308: ...eter of the VTAM Start command The last eight characters are in the SSCPNAME parameter of the VTAM Start command Remote node type Discover Network node End or LEN node Dependent LU traffic Remote node role Host Downstream DLUR Local node ID 8 hexadecimal digits defaults to node name In a VTAM configuration the first three digits should match the IDBLK parameter in the PU definition and the last fi...

Page 309: ...ing destination address unknown Unique addresses for primary to multi drop On a VTAM host the poll address is configured as the ADDR parameter in the VTAM PU definition On an AS 400 system the poll address is the STNADR parameter of the Line Description Line encoding NRZ or NRZI only for switched outgoing calls On a VTAM host this is the NRZI setting in the LINE GROUP definition Duplex Setting Onl...

Page 310: ...racters Token ring card number 0 to number_of_cards_minus_1 Local SAP number Hexadecimal multiple of 4 Initially active Select if needed Define on connection network Select if needed CN name NETNAME CNNAME each 1 8 type A EBCDIC characters Token Ring Link Station Dialog Link station fields Name Up to 8 characters SNA port name Up to 8 characters Activation By administrator On node startup On deman...

Page 311: ... node type Discover End or LEN node Network node Dependent LU traffic Remote node role Host Downstream DLUR Local node ID 8 hexadecimal digits defaults to node name In a VTAM configuration the first three digits should match the IDBLK parameter in the PU definition and the last five should match the IDNUM parameter On an AS 400 system the node ID is configured in the EXCHID parameter Remote node I...

Page 312: ... in the MACADDR parameter of the VTAM Port definition If you are configuring a link to an AS 400 system the MAC address is the ADPTADR parameter in the Line Description SAP number Hexadecimal multiple of 4 If the remote end of this link is a VTAM host the SAP number is the SAPADDR parameter of the VTAM PU definition If you are configuring a link to an AS 400 system the MAC address is the ADPTADR p...

Page 313: ...rds_minus_1 Local SAP number Hexadecimal multiple of 4 Initially active Select if needed Define on connection network Select if needed CN name NETNAME CNNAME each 1 8 type A EBCDIC characters Ethernet Link Station Dialog Link station fields Name Up to 8 characters SNA port name Up to 8 characters Activation By administrator On node startup On demand LU traffic Any Independent only Dependent only I...

Page 314: ...node type Discover Network node End or LEN node Dependent LU traffic Remote node role Host Downstream DLUR Local node ID 8 hexadecimal digits defaults to node name In a VTAM configuration the first three digits should match the IDBLK parameter in the PU definition and the last five should match the IDNUM parameter On an AS 400 system the node ID is configured in the EXCHID parameter Remote node ID...

Page 315: ... the MACADDR parameter of the VTAM Port definition If you are configuring a link to an AS 400 system the MAC address is the ADPTADR parameter in the Line Description SAP number Hexadecimal multiple of 4 If the remote end of this link is a VTAM host the SAP number is the SAPADDR parameter of the VTAM PU definition If you are configuring a link to an AS 400 system the MAC address is the ADPTADR para...

Page 316: ...s_minus_1 Local SAP number Hexadecimal multiple of 4 Initially active Select if needed Define on connection network Select if needed CN name NETNAME CNNAME each 1 8 type A EBCDIC characters FDDI Link Station Dialog Link station fields Name Up to 8 characters SNA port name Up to 8 characters Activation By administrator On node startup On demand LU traffic Any Independent only Dependent only Indepen...

Page 317: ... node type Discover Network node End or LEN node Dependent LU traffic Remote node role Host Downstream DLUR Local node ID 8 hexadecimal digits defaults to node name In a VTAM configuration the first three digits should match the IDBLK parameter in the PU definition and the last five should match the IDNUM parameter On an AS 400 system the node ID is configured in the EXCHID parameter Remote node I...

Page 318: ...s in the MACADDR parameter of the VTAM Port definition If you are configuring a link to an AS 400 system the MAC address is the ADPTADR parameter in the Line Description SAP number Hexadecimal multiple of 4 If the remote end of this link is a VTAM host the SAP number is the SAPADDR parameter of the VTAM PU definition If you are configuring a link to an AS 400 system the MAC address is the ADPTADR ...

Page 319: ...mber 0 to number_of_cards_minus_1 Port number 0 to number_of_ports_on_card_minus_1 Initially active Select if needed Match incoming X 25 address Local X 25 sub address QLLC Link Station Dialog Link station fields Name Up to 8 characters SNA port name Up to 8 characters Activation By administrator On node startup On demand LU traffic Any Independent only Dependent only Independent LU traffic ...

Page 320: ...Discover Network node End or LEN node Dependent LU traffic Remote node role Host Downstream DLUR Local node ID 8 hexadecimal digits defaults to node name In a VTAM configuration the first three digits should match the IDBLK parameter in the PU definition and the last five should match the IDNUM parameter On an AS 400 system the node ID is configured in the EXCHID parameter Remote node ID 8 hexadec...

Page 321: ... virtual circuit Switched virtual circuit Channel ID 1 4096 only for PVC Remote X 25 address Hexadecimal digits only for SVC Adapter port number mp n where m is an optional adapter number and n is the port number Subnet ID Up to 4 characters Motif Field Valid Entry Notes Your Implementation Value ...

Page 322: ...tation Value Node Configuration See Node Worksheets Connectivity Configuration See Connectivity Worksheets To support DLUR on the local node configure connectivity to the APPN network DLUR PU See User Application Support Worksheets PU name 1 8 type A EBCDIC characters DLUS name NETNAME LUNAME each 1 8 type A EBCDIC characters PU ID 8 hexadecimal digits In a VTAM configuration the first three digit...

Page 323: ...if Field Valid Entry Notes Your Implementation Value Motif Field Valid Entry Notes Your Implementation Value Node Configuration See Node Worksheets Connectivity Configuration See Connectivity Worksheets Configure connectivity for dependent traffic to host and links for dependent traffic to each downstream node Local LU and Application Configuration See User Application Support Worksheets LU Pool D...

Page 324: ...me or type AE EBCDIC string for LU pool name Motif Field Valid Entry Notes Your Implementation Value Motif Field Valid Entry Notes Your Implementation Value Node Configuration See Node Worksheets Connectivity Configuration See Connectivity Worksheets configure for dependent LU traffic to host Local LU and Application Configuration See User Application Support Worksheets LU Pool Dialog Pool name 1 ...

Page 325: ...ress of client TCP IP name or alias Support TN3270E Select to support TN3270E in addition to TN3270 and TN3287 TN3270 port and LUs TCP IP port number Usually 23 Display LU Assigned LU or pool name Printer LU Assigned LU or pool name Allow access to specific LU Select if needed TN Server Association Dialog Display LU LU name Printer LU LU name Motif Field Valid Entry Notes Your Implementation Value...

Page 326: ... this worksheet if the local node is to support APPC applications Motif Field Valid Entry Notes Your Implementation Value Node Configuration See Node Worksheets Connectivity Configuration See Connectivity Worksheets Local LU Dialog Not required if you can use the default control point LU LU name 1 8 type A EBCDIC characters LU alias Up to 8 characters Dependent LU parameters Host LS DLUR PU Name o...

Page 327: ...CP ID is defined in the SSCPID field of the VTAM Start statement Remote Node Dialog Only configure if the local node is a LEN node Node s SNA network name NETNAME CPNAME each 1 8 type A EBCDIC characters Partner LU Dialog Only required for communication with a LEN node to define a partner LU alias or if the local node is a LEN node Partner LU name NETNAME LUNAME each 1 8 type A EBCDIC characters A...

Page 328: ...Only required if you are using a nonstandard mode Name 1 8 type A EBCDIC characters COS name 1 8 type A EBCDIC characters Session limits Initial session limit Up to maximum session limit recommended value is 8 Maximum session limit Up to 32767 Minimum contention winner sessions Up to maximum session limit recommended value is 0 Minimum contention loser sessions Recommended value is 0 Auto activate...

Page 329: ...ystems TP name User application up to 64 ASCII characters Service TP up to 8 hexadecimal digits Restrict to specific LU Select if needed LU alias Up to 8 characters Multiple instances supported Select for nonqueued TPs If not selected incoming Allocate requests are queued if the TP is already running Route incoming Allocates to running TP Select for a broadcast queued TP Full path to TP executable...

Page 330: ...sts Restrict access Select to require that user names be included on a security access list Security access list Name of security access list Conversation type Basic Mapped Either Sync level None Confirm Sync point None or Confirm None Confirm or Sync point PIP allowed Select if needed Conversation Security Dialog Only required if conversation security is required for a local TP that is to be star...

Page 331: ...ialog Symbolic destination name 1 8 characters Local LU Alias up to 8 characters or fully qualified name NETNAME LUNAME each 1 8 type A EBCDIC characters Partner LU Alias up to 8 characters or fully qualified name NETNAME LUNAME each 1 8 type A EBCDIC characters Mode Type A EBCDIC string Partner TP name User application up to 64 characters Service TP up to 8 hexadecimal digits Security None Same P...

Page 332: ...nt traffic APPC Configuration See APPC Emulator User and Emulator Group Dialogs User name or group name Valid user login or group name or DEFAULT Motif Field Valid Entry Notes Your Implementation Value Node Configuration See Node Worksheets Connectivity Configuration See Connectivity Worksheets configure for dependent traffic LU Type 0 3 Dialog LU name 1 8 type A EBCDIC characters or 1 5 character...

Page 333: ...l 5 132x27 display 3270 PrinterSCS Printer LU in pool Select desired option only for display and unrestricted LUs Pool name 1 8 type AE EBCDIC characters LU Pool Dialog Pool name 1 8 type AE EBCDIC characters LU lists Names of the LUs type 0 3 to assign to the pool Emulator User and Emulator Group Dialogs User name or group name Valid user login or group name or DEFAULT Style file name Up to 8 cha...

Page 334: ...Send alerts 3270 Session Dialog Single session or Multiple sessions Select desired option Session name SESS0001 SESS0010 for single sessions only Session base name Up to 5 characters for multiple sessions only Session type For single sessions only select one Display Printer Number of sessions For multiple sessions only LU name For a single session LU Pool name 1 8 type AE EBCDIC characters for sin...

Page 335: ...or DLUR PU must be defined before defining an LU LU numbers 1 255 for a range supply first and last numbers This value must match the LOCADDR parameter in the VTAM NCP LU resource definition statement LU type RJE Workstation LU in pool Select desired option only for display and unrestricted LUs Pool name 1 8 type AE EBCDIC characters RJE Workstation Dialog Workstation name 1 4 characters Run on co...

Page 336: ...ype A EBCDIC characters or 1 5 characters for a base name for a range of LUs Host LS DLUR PU Name of dependent link station to host or DLUR PU must be defined before defining an LU LU numbers 1 255 for a range supply first and last numbers This value must match the LOCADDR parameter in the VTAM NCP LU resource definition statement LU type Unrestricted LU in pool Select desired option only for disp...

Page 337: ...337 B APPN Network Management Using the Simple Network Management Protocol ...

Page 338: ... Network Management Protocol Overview Overview This appendix briefly introduces the Simple Network Management Protocol SNMP the SNMP components manager agent subagent the APPN Management Information Base MIB and the APPN SNMP subagent component of SNAplus2 ...

Page 339: ...t runs on a system being managed and maintains the MIB database for the system An SNMP manager is an application that generates requests for MIB information and processes the responses The manager and agent communicate using the Simple Network Management Protocol SNMP agents like the SNMPD daemon typically have predefined MIB objects that they can access An SNMP subagent is used to extend the numb...

Page 340: ...ure B 1 Overview of SNMP The SNMP agent talks to both subagents and managers The SNMP manager which resides on one node in the network sends requests to the agent which resides on another The agent sends responses and traps to the manager For SNAplus2 the APPN MIB is implemented by the SNAplus2 SNMP subagent ...

Page 341: ...rted objects is included in APPN Management Information Base MIB The subagent requires that the SNMPD subsystem be configured and started in order to support APPN network management requests The subagent when started registers the objects it supports with the SNMPD daemon If SNMPD is not already running when the subagent is started the subagent polls for SNMPD When the subagent detects that SNMPD ...

Page 342: ...IB is located in the file named etc opt sna mib appn my which also provides a more detailed description of the APPN MIB objects This MIB definition should be used with your management application The SNAplus2 SNMP subagent supports all of the APPN MIB except for the following objects APPN generic DLC trace table ibmappnNodePortDlcTraceTable TCP IP specific link station table ibmappnNodeLslpTable L...

Page 343: ...343 C Configuring an Invokable TP Using snaptpinstall ...

Page 344: ...ut the required file format see File Format for snaptpinstall Remove an invokable TP definition For UNIX snaptpinstall r t TP_name l LU_alias For Windows snaptpinstall r t TP_name End of Section This command removes the entry that has both the same TP name and on HP UX machines the same LU alias The LU alias applies only on HP UX machines omit that parameter when removing a TP definition from a Wi...

Page 345: ... Windows SHOW MAXIMIZED MINIMIZED HIDDEN NORMAL NOACTIVATE MINNOACTIVATE SECURITY_TYPE APPLICATION SERVICE SERVICE_NAME name_of_installed_service End of Section The parameters are as follows For an operator started TP the only parameters used are the TP name the TP type and the timeout value the other parameters apply only to automatically started TPs For UNIX On HP UX machines SNAplus2 returns an...

Page 346: ...s not perform any conversion on a hexadecimal string which is assumed to be in EBCDIC already It then pads the name with EBCDIC spaces on the right to a total of 64 characters before matching against the specified TP name PATH The path and file name of the executable file for this TP If you specify a file name with no path SNAplus2 uses the normal Windows mechanisms for locating the executable fil...

Page 347: ...uting information configured it can dynamically locate the TP and route the Allocate request to it Using QUEUED BROADCAST instead of QUEUED avoids having to configure explicit routing information for LUs and enables load balancing by running more than one copy of the same TP on different computers However if you want to avoid broadcasting information in order to reduce LAN traffic or if you need t...

Page 348: ...by the TP should block if there is no incoming Allocate request pending If no incoming Allocate is received in this time the call fails with a return code indicating State check Allocate not pending A timeout value of 0 indicates that the call always fails unless an incoming Allocate is already pending when the call is issued A timeout value of 1 indicates that the call waits indefinitely for an i...

Page 349: ...ission in order to be started automatically by SNAplus2 GROUP Specify the group ID that SNAplus2 uses to start the TP This must be a valid HP UX group ID on the SNAplus2 computer it can be up to 64 characters unless your HP UX configuration restricts group names to fewer characters This line is optional if it is not included the default is other LUALIAS Specify the local LU alias from which the TP...

Page 350: ...ironment variable in order to determine how to issue RECEIVE_ALLOCATE This line is optional if it is not included the default is to accept incoming Attaches from any local LU ENV Specify any environment variables required by the TP Each variable is specified in the form environment_variable value on a separate ENV line Up to 64 ENV lines can be included the variables are set in the same order as t...

Page 351: ...pplication using the CreateProcess system call SERVICE The TP executable is started as a service using the StartService system call In this case the service must have been previously installed with the Service Control Manager using the name specified by the SERVICE_NAME parameter SERVICE_NAME This parameter applies only to Win32 clients The name of the service installed with the Service Control Ma...

Page 352: ...ored except in the string environment_variable value for the ENV parameter Each TP definition begins with the line identifying the TP name and ends with the end of the file or the next TP name Except for the ENV line which can occur up to 64 times do not specify the same parameter more than once for the same TP If you do specify the same parameter more than once only the last instance of each keyw...

Page 353: ...353 D Using SNAplus2 in a High Availability Environment ...

Page 354: ...354 AppendixD Using SNAplus2 in a High Availability Environment Overview Overview This appendix describes the high availability features of SNAplus2 and how it works with the HP MC ServiceGuard product ...

Page 355: ...ailures disk drive failures and I O interface failures If the result of any one failure is the complete loss of the mission critical application then a single point of failure exists The main goal of high availability is to achieve maximum uptime High availability networks should have sufficient redundancy of software and hardware components so that a single point of failure will not disrupt servi...

Page 356: ...components deliver SNA network connectivity to the end user in this picture Since the HP 9000 server plays such a critical role in maintaining the network connectivity for multiple end users it is important to minimize the impact of component failures in and around the server For example consider the following component failures The LAN between the client and the server systems The LAN adapter car...

Page 357: ...pter card on the server system The SNA network between the HP 9000 and the IBM Front End Processor Other failures to consider include power failures IBM mainframe outages client system failures etc This appendix focus es on what can be done to reduce the impact of failures in and around the HP 9000 server system Specifically it discuss es the high availability features built into SNAplus2 and how ...

Page 358: ...is the LU Pool feature This feature allows users of 3270 3179G and LUA to access a pool of LUs rather than a specific LU Configuration is simpler because you do not need to know the exact LU name to use Instead SNAplus2 allocates an available LU T he biggest benefit is that the LU pool is made up of LUs from separate SNAplus2 LSs spanning multiple servers This type of configuration vastly reduces ...

Page 359: ...ocates an available LU from the pool when you request it In this way high availability is built into the network with redundant port s If one port fails or if one of the servers fail SNAplus2 will continue to function through the other server Client Server Configuration SNAplus2 can be configured in either a standalone or client server configuration The standalone configuration requires SNAplus2 a...

Page 360: ...and the remote SNA system The SNAplus2 application can then access that LU LU session It is important to note that the SNAplus2 application does not specify which of the active servers should provide the LU I t is possible that more than one server can be configured to provide a suitable LU There are two ways that more than one server can provide a suitable LU to an SNAplus2 application running on...

Page 361: ...it does not contain information about which server will activate those components Let s suppose one system is designated a primary server and another is designated a backup server Most often the primary server is used in production to provide SNA connectivity for mission critical SNA applications that run on client systems The backup server provides non critical connectivity to the SNA network for...

Page 362: ... can be run under the SNAplus2 node HANODE Normally this configuration is run on the primary server hp_pri as shown below In addition five LUs are used by APPC transaction programs for development purposes These LUs are configured to use an SNAplus2 LS called DEVLS This LS is configured to use the SNAplus2 LAN port DEVPORT and can be run under the SNAplus2 node DEVNODE Normally this configuration ...

Page 363: ... SNAplus2 Port HAPORT is started on the backup server using the command snapadmin start_port port_name HAPORT Step 2 The SNAplus2 LS HALS is started on the backup server if it is configured to be operator started using the command snapadmin start_ls ls_name HALS Client Client Client Client 3xxx Communications Controller IBM Host LAN Primary HP UX Server hp_pri Production Configuration Node HANODE ...

Page 364: ...erlying SNAplus2 configuration SNAplus2 will automatically route data to and from the production applications through the backup server Figure D 5 SNAplus2 on Primary and Backup Servers This feature makes it easy to provide backup capability when the primary server needs to be taken offline Later sections describe how the MC ServiceGuard product can automate the switch from a primary to a backup s...

Page 365: ...ing SNAplus2 in a ServiceGuard cluster protects against many of the unexpected failures that can interrupt SNA network access to end users The strategy employed by ServiceGuard is to prevent a single failure from disrupting service by providing software and hardware redundancy The typical SNAplus2 environment might look like the following example when used with ServiceGuard Figure D 6 SNAplus2 env...

Page 366: ...gh availability products Step 3 Identify your critical SNAplus2 connectivity see the next section for details Step 4 Install SNAplus2 on the primary server and all backup servers Step 5 Create and configure your SNAplus2 package Follow the ServiceGuard product documentation to install and configure disk hardware volume groups logical volumes and file systems for high availability In addition Servi...

Page 367: ... that is at any one time only one system in a ServiceGuard cluster will be running a highly available SNAplus2 LS Backup systems in your cluster can provide SNAplus2 services for non mission critical applications Step 5 Define how the mission critical applications will be impacted by the migration from one server to another Since LU LU sessions will be lost specify what you will be required to do ...

Page 368: ... be highly available and access to the SNA network is mission critical Defining an SNAplus2 package will allow ServiceGuard to do the following Automatically start the SNAplus2 software when the SNAplus2 package starts Automatically start a process to monitor the state of the SNAplus2 software on the server Automatically migrate the SNAplus2 package to a backup server if the package ever fails to ...

Page 369: ... to check the status of an SNAplus2 LS is with the snapadmin start_ls command For example Item Suggestion Package Name Use a name that identifies how the SNAplus2 package is being used For example sna Service Name Use the name of the SNAplus2 LS that you are making highly available For example HALS Service Command This command will be used to monitor the SNAplus2 LS Use the snapmon command which h...

Page 370: ... continuously monitors the state of an SNAplus2 LS by querying SNAplus2 to determine if it is active If the LS is ever reported to be in a state other than active the program terminates The only exception is during initialization when certain errors can be ignored Usage snapmon i interval r retry_count conname conname identifies which SNAplus2 LS is being monitored interval specifies the number of...

Page 371: ...viceGuard that the SNAplus2 package is no longer providing SNA network connectivity and the package should be migrated to another server Once you have created the basic package read this section to determine how to customize your SNAplus2 package You will need to modify the SNAplus2 Package Control Script to complete your SNAplus2 package definition Specifying a Package IP Address An IP Address mu...

Page 372: ...ient systems HP 9000s or PCs that access an SNAplus2 server through the slim process running on the server system Figure D 7 SNAplus2 in Client Server Configuration SNAplus2 uses an internal mechanism to inform applications running on client systems about the IP addresses they should use to access each particular server This mechanism does not forward information about the IP address associated wi...

Page 373: ... LAN Connections Another way SNAplus2 uses LANs is when the SNAplus2 server is connected to the remote SNA system via a LAN Figure D 8 SNAplus2 Server connected to remote system via LAN For this type of communication SNAplus2 communicates with the LAN driver using a Streams DLPI interface Since ServiceGuard only supports local LAN failover for IP network traffic SNAplus2 will not be able to take a...

Page 374: ...e the IP address of the SNAplus2 package Figure D 9 SNAplus2 Server Running TNServer Since TN3270 and TN Server communicate over a telnet TCP IP connection this connection can be maintained during a local LAN failover or can be quickly reestablished when the package is migrated to another server The only requirement is that you specify the floating IP address associated with the SNAplus2 package o...

Page 375: ... on the server from another computer system via the LAN For example you might use telnet or rlogin to log in from a desktop workstation to an SNAplus2 server to run the SNAplus2 application Like the TN Server example above these TCP IP connections will be maintained during a local LAN failover or during a remote failover if you access the server using the floating IP address associated with the SN...

Page 376: ...ackage to the Package Control Script The commands you will use depend on your specific SNA network configuration If possible design the run and halt commands to migrate the SNAplus2 package to another server transparently that is without impacting the applications For the best level of application transparency we recommend that you use a client server configuration and that you configure ServiceGu...

Page 377: ...h HP 9000 server can activate the same PU configuration For example the remote SNA system allows communication from any MAC address in a Token Ring LAN This requirement is necessary to ensure that the backup server will be allowed to activate the same LS that the primary server used The primary server and the backup server both have a compatible I O configuration This is an important requirement t...

Page 378: ... and automatically attempt to reestablish LU LU sessions anytime a session outage occurs For standalone environments you will also have to consider how your applications will be impacted by various failures including entire server system failures I O Compatibility Constraints The previous section described how to customize your Package Control Script for the best level of application transparency ...

Page 379: ...me is also used in the Interface Card field of the SNAplus2 configuration in the QLLC Port configuration screen For example you might have the following line in the etc x25 x25config_0 file on the primary server name card0 which would correspond to the following entry in the QLLC Port configuration screen Client Client Client Client 3xxx Communications Controller IBM Host LAN D12 Primary HP UX Ser...

Page 380: ...up server the card can be accessed by the expected name Figure D 12 Client Server Configuration Using X 25 DLC SDLC Allowing multiple servers to use the same SDLC configuration is more difficult than with the other link types because SDLC DLCs are often dedicated lines from one HP 9000 server to a remote SNA system Client Client Client Client 3xxx Communications Controller IBM Host LAN Primary HP ...

Page 381: ...he HP servers to the single SDLC line The PSI adapter cards that support the SDLC protocol must have the same card numbers as configured in the SDLC Port configuration screen Figure D 13 Client Server Configuration Using SDLC DLC Client Client Client Client 3xxx Communications Controller IBM Host LAN Primary HP UX Server hp_pri PSI Adapter Backup HP UX Server hp_back PSI Adapter Card 0 Card 0 Mult...

Page 382: ...n SDLC DLC ready to use if the token ring is unavailable Figure D 14 Standalone Server using Token Ring Primary DLC and SDLC Backup DLC The idea is that when SNA networking problems occur simply switching to a different link type on the same HP 9000 server often restores network connectivity without having to perform a remote failover Previously we discussed how to use snapmon as a Service in the ...

Page 383: ...y during local failover t hat is applications do not experience outages while the system is switching from one network adapter to another SNAplus2 does not support Continuous Availability during local failovers Applications will experience session outages and must re establish LU LU sessions with the remote SNA system after the switch has occurred The following command is the previously discussed ...

Page 384: ...uses a port called SDLCPORT If the primary LS ever fails the script performs three steps to restore SNA network connectivity Step 1 Attempt local restart of TRLS If successful monitor the LS then return to Step 1 Otherwise go to Step 2 Step 2 Attempt local failover to SDLCLS Monitor the LS until it fails then go to Step 3 Step 3 Exit which will inform ServiceGuard of a complete package failure Ser...

Page 385: ...ivated Attempted local failover which means 1 Start the backup LS NOTE The active node must be configured to run the backup LS snapadmin start_ls ls_name SDLCLS Monitor the backup LS to see if local failover was successful Allow 90 seconds for the LS to become active snapmon i1 r90 SDLCLS STEP 3 Exit Since snapmon returned the backup LS is not active Inform ServiceGuard that this package has faile...

Page 386: ... server each application must have the ability to access LUs that are configured for each LS For 3270 3179G and LUA LU pools are often his will add more redundancy to your network and reduce even further used for this purpose APPC transaction programs would need to be designed and coded to be able to communicate with a remote TP over multiple LUs Local recovery is an excellent complement to the re...

Page 387: ...ser configuration methods 218 emulation user parameters 218 User Name 218 user configuration 218 worksheet 331 A Activation parameter 156 Adapter card number parameter 148 Adapter Port Number parameter 160 adjacent node 43 administration responsibilities 98 tools 99 Advanced Peer to Peer Networking APPN See APPN 15 advanced program to program communications APPC See APPC 16 Alias parameter 185 ali...

Page 388: ...iguration 278 Win32 configuration 257 client server benefits 86 configuration 135 example configuration 72 support 85 tracing on a client 295 Win16 client 292 Win32 client 271 cluster controller 28 CN connection network See connection network 43 CN name parameter 152 command line administration program command types 131 description 101 from a client 130 help 130 using 130 commands modifying config...

Page 389: ...ser ID 202 CSV Common Service Verb API 83 CSVTBLG Win16 client 294 Win32 client 274 Customer Information Control System CICS 34 D data file client network 104 domain configuration 103 invokable TP 103 network 88 node configuration 102 SNA network 103 TP definition 103 data link control DLC See DLC 144 data link protocol 91 DCA Document Content Architecture 34 DDDLU description 94 default LUs 96 De...

Page 390: ...t 276 Win32 client 255 end node APPN 45 description 30 directory 49 50 in sample APPN network 44 Enterprise System 9221 ES 9221 43 ENV parameter 350 error log file 105 ES 9221 Enterprise System 9221 43 escape characters RCF 239 Ethernet DLC 91 port configuration 147 worksheet 312 example configuration SNAplus2 client server 72 SNAplus2 node configured as a TN server 70 71 SNAplus2 nodes in an APPN...

Page 391: ...ails parameter 149 Line encoding parameter 158 link station additional configuration needs 163 configuration methods 155 overview 154 description 31 92 parameters Activation 156 Adapter Port Number 160 Channel ID 160 Circuit type 160 Dial string 158 Line encoding 158 Local node ID 162 LU traffic 157 MAC address 159 Name 156 Poll address 157 Remote node ID 162 Remote node name 161 Remote node role ...

Page 392: ...tch incoming X 25 address parameter 152 Maximum active template instances parameter 153 Maximum RU size parameter 198 Maximum session limit parameter 196 Maximum window size parameter 198 MC ServiceGuard 365 advanced configuration techniques 382 creating SNAplus package 366 defining SNAplus package 368 I O compatibility constraints 378 Package Control Script 376 package IP address 371 service comm...

Page 393: ...ver 30 45 NN network node See network node 30 node 75 additional configuration needs 138 configuration file 85 102 configuration methods 137 parameters APPN support 137 Control point alias 138 Control point name 137 Node ID 138 peer 26 peripheral 26 purpose 137 resources 90 SNA 26 subarea 26 types peer network 30 subarea network 27 worksheets 302 303 Node ID parameter 138 Node Operator Facility NO...

Page 394: ... DLUR 164 PU concentration description 75 purpose 230 worksheet 323 PU ID parameter 165 PU Name parameter 165 PUCP physical unit control point 35 Q QLLC DLC 91 port configuration 147 worksheet 318 qualified logical link control QLLC See QLLC 91 R Rapid Transport Protocol RTP See RTP 53 RCF command syntax 238 facilities 102 valid characters 239 Reactivate PU after failure parameter 166 Receive paci...

Page 395: ...36 service access point SAP 62 service point 237 service point command facility SPCF See SPCF 102 236 session description 36 resources 94 routing 53 types 36 Session base name parameter 217 Session name parameter 216 session security additional configuration needs 205 configuration methods 204 parameters Local LU 204 Partner LU 204 Password 204 Session timeout parameter 198 Sessions parameter 215 ...

Page 396: ...arameters Display LU 229 Printer LU 229 description 77 example configuration 70 71 user 79 worksheet 324 TN3270 multiple sessions 79 programs 77 79 Telnet 3270 standard extensions 77 TN3270E protocol 77 users 78 TN3270 client address parameter 226 token ring DLC 91 port configuration 147 worksheet 310 topology and routing services TRS 53 topology database update TDU 56 topology information 37 conn...

Page 397: ... in port configuration 93 VTAM Virtual Terminal Access Method 43 W Wildcard partner LU name parameter 184 wildcards 183 Win16 client 3270 message tracing information 290 admin_msg 293 all_api 289 API tracing information 288 appc 289 APPCLLU 294 APPCTPN 294 audit_file 286 audit_file_wrap_size 287 audit_logging_enabled 285 backup_audit_file 286 backup_error_file 285 broadcast_attempt_count 282 clien...

Page 398: ...p_size 267 270 flip_size CS_tracing 272 fmi 271 group name 259 invoked TPs 259 lan_access_timeout 259 log_directory 264 logging information 263 ms 269 network access process NAP 254 nof 269 password 255 256 receive 273 rui 269 security 255 256 send 273 server information 261 server_lost_timeout 260 Server1 261 Server2 Server10 262 succinct_audits 267 succinct_errors 266 truncation_length 268 271 u...

Reviews: