HP (Hewlett-Packard) HP-UX SNAplus2 manual

HP-UX SNAplus2 Administration Guide Edition 2 J2740-90013 HP 9000 Networking E1098 Printed in: United States © Copyright 1998 © Hewlett-P ackard Company , 1998. All rights reserved[...]

2 Legal Notices The information in this document is subject to change without notice . Hewlett-P ac kard makes no warranty of any kind with regard to this manual, including , but not limited to , the implied warranties of merchantability and fitness f or a particular purpose . Hewlett-P ackard shall not be held liable for errors contained herein o[...]

3 ©copyright 1980, 1984, 1986 Novell, Inc. ©copyright 1986-1992 Sun Microsystems , Inc. ©copyright 1985-86, 1988 Massachusetts Institute of T echnology . ©copyright 1989-93 The Open Software F oundation, Inc. ©copyright 1986 Digital Equipment Corporation. ©copyright 1990 Motorola, Inc. ©copyright 1990, 1991, 1992 Cornell University ©copyrig[...]

4[...]

Contents 5 Preface . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 15 Prerequisite Knowledge . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 15 About This Book. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 15 Organization of Th[...]

6 Contents APPN Control P oint . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 47 Locating Resources . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 48 Session Routing . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 53 Accessing Subarea Networks from[...]

Contents 7 Specifying the P ath to SNAplus2 Programs . . . . . . . . . . . . . . . . . . . . 111 Enabling SNAplus2 Servers . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 112 Disabling SNAplus2 Servers . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 113 Using the Motif Administration Program . . . . . . . . . . . . .[...]

8 Contents Defining DLUR PUs . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 164 DLUR PU Configuration P arameters . . . . . . . . . . . . . . . . . . . . . . . . 164 Additional Configuration . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 166 6. Configuring Dependent LUs Overview . . . . . . [...]

Contents 9 Mode Configuration P arameters . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 196 Additional Configuration . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 199 Defining CPI-C Side Information . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 200 CPI-C Configuration P arameters . . . . . . . .[...]

10 Contents Additional Configuration . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 232 Configuring DLUR . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 233 10. Managing SNAplus2 from NetView Overview . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . [...]

Contents 11 Disabling SNAplus2 for a Win32 Client . . . . . . . . . . . . . . . . . . . . . . . 255 Win32 Client Security . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 256 Win32 Client Configuration . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 257 Managing Win16 Clients . . . . . . . . . . . . . . .[...]

12 Contents CPI-C . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 330 5250 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 331 3270 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 332 RJE . [...]

Contents 13 Specifying a P ackage IP Address . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 371 Customizing the SNAplus2 P ackage Control Script . . . . . . . . . . . . . 376 I/O Compatibility Constraints . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 378 Advanced Configuration T echniques . . . . . . . . . . . . . . . . [...]

14 Contents[...]

15 Preface The HP-UX SNAplus2 Administration Guide provides information on enabling, configuring , and managing SNAplus2. Prerequisite Knowledge Before reading this manual, you should have a knowledge of SNA and APPN concepts . F or a list of books that provide this information, see “Related Publications”. About This Book This guide explains h[...]

16 Explains how to configure connectivity for the SNAplus2 node. Chapter 6, “Configuring Dependent LUs . ” Explains how to configure dependent LUs (logical units) for LU types 0–3 and LU pools. Chapter 7, “Configuring APPC Communication. ” Explains how to configure APPC (advanced program-to-program communications). Chapter 8, “Con?[...]

17 Typographic Conventions The typographic styles used in this document are shown in T able 1. T able 1 Typographic Conventions Special Element Sample of Typography Emphasized words back up files bef ore deleting Document title HP-UX SNAplus2 Administration Guide File or path name /usr/spool/uucp/myfile.bkp Directory name /usr/spool/uucp/ Program [...]

18 Operating System Conventions For UNIX This heading is used to indicate the start of a section of text that applies only to the HP-UX operating system. For Windows This heading is used to indicate the start of a section of text that applies to the Win32 c lient, which runs on the Microsoft NT (V ersion 3.51 or later) and Windows 95 operating syst[...]

19 HP-UX SNAplus2 General Information Provides an introduction to SNAplus2 and explains key product concepts and features. HP-UX SNAplus2 3270/3179G Users Guide Explains how to perform the following functions when you use 3270 emulation: • Starting and stopping 3270 emulation • Transferring files • Using customization features such as remapp[...]

20 Explains how to enable, configure , and manage SNAplus2. This guide provides information about SNA concepts , and an overview of the features provided by SNAplus2. It describes how to configure and manage SNAplus2 using the Motif administration program and provides guidance for users of the SNAplus2 command-line administration program. HP-UX S[...]

21 Contains the information you need to write application programs using the Common Service V erbs (CSV) application program interface (API). HP-UX SNAplus2 MS Programmers Guide Contains the information you need to write applications using the Management Services (MS) API. HP-UX SNAplus2 NOF Programmers Guide Contains the information you need to wr[...]

22[...]

23 1 SNA T erms and Concepts[...]

24 Chapter 1 SNA T erms and Concepts Overview Overview This chapter defines Systems Network Architecture (SNA) terms and concepts that are important to understanding and using SNAplus2. F or information about SNAplus2 and its capabilities , see Chapter 2, “Introduction to SNAplus2. ” If you are already familiar with SNA and SNAplus2, you can b[...]

Chapter 1 25 SNA T erms and Concepts Systems Network Ar chitecture Systems Network Architecture Systems Network Architecture (SNA) is an IBM data communication architecture that specifies common conventions for communicating among a wide variety of hardware and softw are data communication products . This architecture consists of two kinds of de?[...]

26 Chapter 1 SNA T erms and Concepts Basic SNA Concepts Basic SNA Concepts SNA defines the standards , protocols, and functions used by devices—from mainframes to terminals—to enable them to communicate with each other in SNA networks . SNA functions are divided into a hierarchical structure of separate layers , each performing a specific set[...]

Chapter 1 27 SNA T erms and Concepts Basic SNA Concepts Each node manages its end of the network communication paths , and uses SNA protocols to communicate with the node at the other end of each path. Because subarea networks and peer networks define the relationships among nodes differently , they also use different terms for node types (to desc[...]

28 Chapter 1 SNA T erms and Concepts Basic SNA Concepts A type 4 or 5 subarea node to which a peripheral node is attached acts as a boundary node. It performs a boundary function by translating between the network addresses used by a subarea node and the local addresses used by a peripheral node. A simple subarea network includes the following comp[...]

Chapter 1 29 SNA T erms and Concepts Basic SNA Concepts Figure 1-1 SNA Subarea Network The root of the tree (at the top of the diagram) is the computer controlling the network. The branches are the communications links from the host to the other computers in the network (terminal controllers); the leaves (at the bottom of the diagram) are the termi[...]

30 Chapter 1 SNA T erms and Concepts Basic SNA Concepts Node Types in a P eer Network P eer networks do not classify nodes hierarchically , as is done in a subarea network. Exchanges with other nodes are not controlled by a host or other centralized processor . Instead, any node can establish communication with any other node. A peer network is com[...]

Chapter 1 31 SNA T erms and Concepts Basic SNA Concepts Each node connected to a network has one or more link stations , which are the hardware and softw are in a node that control data flow to a specific adjacent node. T o establish communication between two adjacent nodes , one of the link stations must first activate the link between the node[...]

32 Chapter 1 SNA T erms and Concepts Basic SNA Concepts • CPI-C (Common Programming Interface for Communications)—LU type 6.2 only • CSV (Common Service V erb) API • HLLAPI (high-level language application programming interface)—as part of the SNAplus2 3270 emulation program • LU A API In addition, SNAplus2 includes the following propri[...]

Chapter 1 33 SNA T erms and Concepts Basic SNA Concepts NO TE On type 2.1 nodes (which can be APPN nodes), the control point provides PU services in addition to providing other services (see “Control P oints”). Two type 2.1 nodes (such as SNAplus2 nodes) can communicate directly , without requiring the services of a host to establish communicat[...]

34 Chapter 1 SNA T erms and Concepts Basic SNA Concepts F or example, LU 3 can support an application program running under Customer Information Control System (CICS) and sending data to an IBM 3262 printer attached to an IBM 3174 Establishment Controller . LU 2 (for 3270 displays) LU 2 supports application programs and display workstations communi[...]

Chapter 1 35 SNA T erms and Concepts Basic SNA Concepts Operating System) use LU 0. Current releases of these products also support LU 6.2 communication, which is the preferred protocol for new applications. NO TE F or information about the data streams used by SNA logical units, refer to Systems Network Arc hitecture T echnical Reference . Control[...]

36 Chapter 1 SNA T erms and Concepts Basic SNA Concepts In a subarea network, the CP on an SNA node acts as a type 2.0 PU . It communicates with an SSCP on a host and does not communicate with other CPs in the subarea network. When participating in an APPN network, the CP exchanges network control information with the CPs in adjacent nodes . The CP[...]

Chapter 1 37 SNA T erms and Concepts Basic SNA Concepts Before an SSCP-LU session can be established, the PU controlling the LU must have an active SSCP-PU session with an SSCP on a type 5 node. The SSCP-PU session is used to pass control data and network management data between the PU and SSCP . CP-CP sessions In an APPN network, adjacent nodes es[...]

38 Chapter 1 SNA T erms and Concepts Basic SNA Concepts dependent LU requester (DLUR) function enables session traffic from dependent LUs to flow over APPN networks. F or more information about DLUR, see “ Accessing Subarea Networks from APPN Networks”. A dependent LU on a peripheral node is alwa ys the secondary LU . • An independent LU ca[...]

Chapter 1 39 SNA T erms and Concepts Basic SNA Concepts Figure 1-2 Multiple and P arallel Sessions Conversations This section applies to LU 6.2 only . Once a session is established between two LUs, the LU-LU session supports the exchange of information between two TPs , which have the exclusive use of the session to execute a transaction. This exch[...]

40 Chapter 1 SNA T erms and Concepts Basic SNA Concepts As shown in Figure 1-3, “Communication between Transaction Programs and Logical Units ,” information is exc hanged between TPs and LUs to enable one node to communicate with another . Although the TPs appear to be communicating directly , the LUs on each node are the intermediaries in ever[...]

Chapter 1 41 SNA T erms and Concepts Basic SNA Concepts A logical record consists of a two- or four -byte header starting with a two-byte length field, often represented as “LL,” followed by up to 32,765 bytes of data. Logical records can be grouped together and sent as a block, transmitting more than one logical record with a single call to t[...]

42 Chapter 1 SNA T erms and Concepts Basic SNA Concepts Class of Service Class of service (COS) is a definition of the transport network (data link control and path control) characteristics—such as route security , transmission priority , and bandwidth—that the local node can use to establish a particular session. The COS definition assigns r[...]

Chapter 1 43 SNA T erms and Concepts Basic APPN Concepts Basic APPN Concepts Advanced P eer -to-P eer Networking (APPN) is a network architecture that supports distributed network control. It makes networks easy to configure and use, provides centralized network management, and supports flexible connectivity . An APPN network is composed of type [...]

44 Chapter 1 SNA T erms and Concepts Basic APPN Concepts • Network nodes (see “ APPN Network Nodes”) • End nodes (see “ APPN End Nodes”) In addition, low-entry networking (LEN) nodes can be connected to an APPN network, but they do not use APPN features (see “LEN Nodes”). A sample APPN network that includes all of these node types i[...]

Chapter 1 45 SNA T erms and Concepts Basic APPN Concepts One of the APPN network nodes (NNA) also participates in a subarea network, connecting to a host through a communication controller . This node functions as an APPN node when communicating with nodes in the APPN network, and as a peripheral node when communicating with nodes in the subarea ne[...]

46 Chapter 1 SNA T erms and Concepts Basic APPN Concepts An APPN end node can be attached to multiple network nodes (see EN3 in Figure 1-4, “P ortion of a Sample APPN Network,”) but it can ha ve CP-CP sessions active with only one network node at a time—its network node server . The other network nodes can be used only to provide intermediate[...]

Chapter 1 47 SNA T erms and Concepts Basic APPN Concepts APPN Control P oint An APPN control point is a set of functions that manages node resources and supports both physical unit and logical unit functions on a type 2.1 node. An APPN CP directs local node functions (suc h as activating and deactivating adapters and links), provides directory and [...]

48 Chapter 1 SNA T erms and Concepts Basic APPN Concepts When setting up a workstation, you must define the CP name. The CP is also an LU that can support user sessions, and it can be the only LU defined in your workstation, if you so choose. Locating Resources T o support communication between TPs, SNAplus2 first establishes a session between t[...]

Chapter 1 49 SNA T erms and Concepts Basic APPN Concepts reside on the LEN node's network node server . The LEN node establishes sessions with LUs on its network node server . The network node routes the session through the APPN network to the proper node in the network. A LEN node can also use wildcards in a directory entry to specify multipl[...]

50 Chapter 1 SNA T erms and Concepts Basic APPN Concepts Figure 1-5 LEN Node Directory T o establish a session with an LU on a node that is not directly attached, Node LEN1 sends an LU-LU session activation (BIND) request to its network node server (Node NNA). The server automatically locates the destination LU and forwards the BIND . NO TE In this[...]

Chapter 1 51 SNA T erms and Concepts Basic APPN Concepts Figure 1-6 End Node Directory P otential partner LUs in the APPN network do not need to be defined 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. [...]

52 Chapter 1 SNA T erms and Concepts Basic APPN Concepts Figure 1-7 Network Node Directory A network node locates a remote LU as follows: 1. The network node receives a request to locate an LU . The request can be any of the following: • The name of a destination LU sent by an end node or a LEN node to its network node server • An LU name speci[...]

Chapter 1 53 SNA T erms and Concepts Basic APPN Concepts An APPN end node can also receive (and respond to) LOCATE search requests from its network node server to search for , or confirm the continued presence of , specific LUs in the end node. Each APPN end node registers its LUs with its network node server by sending the network node a registr[...]

54 Chapter 1 SNA T erms and Concepts Basic APPN Concepts network backbone topology—the nodes and transmission groups that can be used for routing sessions between any pair of nodes in the network. In addition, the topology database on each network node contains local information about transmission groups from that network node to adjacent end nod[...]

Chapter 1 55 SNA T erms and Concepts Basic APPN Concepts Figure 1-8 Network T opology 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[...]

56 Chapter 1 SNA T erms and Concepts Basic APPN Concepts topology information because it does not have any links to end nodes). F or example, Node NNB includes information for Link f to Node EN2 and Link g to Node EN3, but it does not include information for Link i, which connects Nodes EN2 and EN3. End nodes include information only for links to a[...]

Chapter 1 57 SNA T erms and Concepts Basic APPN Concepts • If the session partner is not on an adjacent node, the network node server for the LU requesting the session uses the network topology database to identify network nodes and intermediate transmission groups in the route to the session partner . • If the session partner is on an end node[...]

58 Chapter 1 SNA T erms and Concepts Basic APPN Concepts data. In ISR, once a session route has been established, all data on that session uses the same route. If part of the route fails , the session ends . • In automatic network routing (ANR), available in network nodes that support APPN's High-P erformance Routing (HPR) function, intermed[...]

Chapter 1 59 SNA T erms and Concepts Basic APPN Concepts Figure 1-9 APPN Network Using a Shared-Access Transport F acility If Node EN1 has a link definition for each of the links in the network, it 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[...]

60 Chapter 1 SNA T erms and Concepts Basic APPN Concepts Figure 1-10 Definitions Needed for Direct Links from Node EN1 to Every Node in an APPN Network If all of the nodes in the network are to support direct links to every other node, a total of 30 link definitions are needed on the six nodes in this example. In general, the number of link defi[...]

Chapter 1 61 SNA T erms and Concepts Basic APPN Concepts only a single link to an adjacent network node server and a link to the connection network, instead of configuring every possible link to every node. T o use the connection network feature, an APPN network must meet the following conditions: • The nodes in the APPN network must be linked u[...]

62 Chapter 1 SNA T erms and Concepts Basic APPN Concepts Figure 1-11 Definitions Needed for Direct Links Using a Virtual Node T o support direct links between any two end nodes in the APPN network, a total of ten link definitions is required. (Each end node needs two link definitions: one to a network node server and one to the virtual node.) Co[...]

Chapter 1 63 SNA T erms and Concepts Basic APPN Concepts 3. The server normally selects the direct 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[...]

64 Chapter 1 SNA T erms and Concepts Accessing Subarea Networks fr om APPN Networks Accessing Subarea Networks from APPN Networks Although APPN networks do not require a host to control resources in the network, hosts often participate in APPN networks . APPN has been implemented on many host platforms, and allows the hosts to perform as network no[...]

65 2 Introduction to SNAplus2[...]

66 Chapter 2 Introduction to SNAplus2 Overview Overview This chapter provides an overview 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 administrati[...]

Chapter 2 67 Introduction to SNAplus2 What Is SNAplus2? What Is SNAplus2? SNAplus2 is a software product that enables HP-UX computers to participate in an SNA network that includes mainframes , PCs, and other HP-UX computers . With SNAplus2, you can access data and programs that reside on other computer systems , thereby increasing your computing p[...]

68 Chapter 2 Introduction to SNAplus2 What Is SNAplus2? Within a TCP/IP local area network (LAN), SNAplus2 supports communication between servers (SNA nodes) and clients (HP-UX or Windows computers). F or more information about client/server facilities on a LAN , see “Client/Server Support”. Windows c lients For Windows SNAplus2 provides suppor[...]

Chapter 2 69 Introduction to SNAplus2 Example Configurations Example Configurations SNAplus2 can be used as a standalone system to support direct communication with a host or another SNA node, within a LAN to support SNA communications across the LAN , or as a gatew ay to support communication between a host and systems in a LAN . A computer runn[...]

70 Chapter 2 Introduction to SNAplus2 Example Configurations Figure 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.[...]

Chapter 2 71 Introduction to SNAplus2 Example Configurations Figure 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.[...]

72 Chapter 2 Introduction to SNAplus2 Example Configurations 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.[...]

Chapter 2 73 Introduction to SNAplus2 Example Configurations Figure 2-5 SNAplus2 Client/Server Configuration These examples show the most basic wa ys 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.[...]

74 Chapter 2 Introduction to SNAplus2 SNAplus2 Components SNAplus2 Components The components of SNAplus2 and their relationships are shown in Figure 2-6, “Components of SNAplus2. ” Figure 2-6 Components of SNAplus2 The local node—including its associated connectivity resources (DLCs , ports, and link stations)—is implemented as a set of STR[...]

Chapter 2 75 Introduction to SNAplus2 SNAplus2 Components Node Components A server running SNAplus2 implements an SNA node. It can also provide passthrough services between an SNA host and computers in an APPN or TCP/IP network. SNA Support SNAplus2 provides SNA node type 2.0 and 2.1 (LEN node) support for communicating with host and peer computers[...]

76 Chapter 2 Introduction to SNAplus2 SNAplus2 Components Figure 2-7 PU Concentration The downstream computer must contain an SNA PU type 2.0 or 2.1 to support dependent LUs. F or example, the downstream computer could be a PC running Microsoft SNA Server for Windows NT , or another SNAplus2 computer . When the local SNAplus2 node uses the PU conce[...]

Chapter 2 77 Introduction to SNAplus2 SNAplus2 Components at the downstream computers are configured as part of the resources of the SNAplus2 computer . The host computer is not aw are that PU concentration is being used. Dependent LU Requester. This section does not apply to LEN nodes. In addition to providing direct access to a host computer , S[...]

78 Chapter 2 Introduction to SNAplus2 SNAplus2 Components NO TE This guide uses the term TN3270 for information that applies equally to the TN3270, TN3287, and TN3270E protocols . SNAplus2 TN server provides access to 3270 host computers for TN3270 users on other computers. TN server enables TN3270 users to share a host connection with SNAplus2 or [...]

Chapter 2 79 Introduction to SNAplus2 SNAplus2 Components SNAplus2 TN server supports all TN3270 client emulation programs that correctly implement the protocols defined in RFCs 1123, 1576, 1646, and 1647. When a TN3270 program communicates with TN server , SNAplus2 identifies the program by the TCP/IP address of the computer where the TN3270 pro[...]

80 Chapter 2 Introduction to SNAplus2 SNAplus2 Components Refer to the HP-UX SNAplus2 3270/3179G Users Guide for information about using the 3270 emulation software to communicate with a host. F or more information about configuring support for 3270 emulation, see Chapter 8, “Configuring User Applications .” 5250 Emulation Using 5250 emulatio[...]

Chapter 2 81 Introduction to SNAplus2 SNAplus2 Components The users of an RJE workstation can define workstation style files to supplement the SNAplus2 configuration and to control the operation of the workstation. Refer to the HP-UX SNAplus2 RJE Users Guide for information about using RJE to submit jobs to a host and about setting up the workst[...]

82 Chapter 2 Introduction to SNAplus2 SNAplus2 Components APPC API An APPC application uses the node's LU type 6.2 resources to communicate with another APPC or CPI-C application on a host or peer computer , using a specified mode . The APPC API includes TP server support, enabling applications to have greater control over starting transactio[...]

Chapter 2 83 Introduction to SNAplus2 SNAplus2 Components • If the TP is operator -started (not started automatically by SNAplus2), and the use of the TP does not need to be restricted, you do not need to define any additional resources. The only exceptions are when you want to do the following: • Change the default timeout for a RECEIVE_ALLOC[...]

84 Chapter 2 Introduction to SNAplus2 SNAplus2 Components F or more information, refer to the HP-UX SNAplus2 3270 & TN3270 HLLAPI Programmers Guide or HP-UX SNAplus2 3270/3179G Users Guide . LUA API The LU A API enables application programmers to write applications that communicate with host applications at the request unit and response unit (R[...]

Chapter 2 85 Introduction to SNAplus2 SNAplus2 Components • Windows CPI-C • Windows LU A • Windows CSV • 3270 Emulator Interface Specification F or more information about Windows SNA APIs , see the documentation provided with Microsoft SNA Server . End of Section Client/Server Support Computers running SNAplus2 can be configured to commun[...]

86 Chapter 2 Introduction to SNAplus2 SNAplus2 Components configuration. Y ou can configure a node from any other computer in the domain, as long as the SNA software is running on the node where the configuration is performed (whether or not the node being configured is started). Information about the configuration of domain resources for the [...]

Chapter 2 87 Introduction to SNAplus2 SNAplus2 Components In a domain with multiple SNAplus2 servers , one server holds the master copy of the SNAplus2 domain configuration file. This server is known as the master server. Y ou can define other servers on the LAN to be backup servers. The domain configuration file is copied to backup servers—[...]

88 Chapter 2 Introduction to SNAplus2 SNAplus2 Components preserved when the connection is re-established, do not make any changes to the file in either domain while the LAN connection is broken. Changes can still be made to the configuration of individual nodes. SNAplus2 stores information about the master server and backup servers in the file [...]

Chapter 2 89 Introduction to SNAplus2 SNAplus2 Components End of Section Windows Clients For Windows SNAplus2 enables machines running Microsoft W indows 3.1, Windows for W orkgroups 3.11, Windows 95, W indows NT , and OS/2 to act as clients in the SNAplus2 domain. Y ou can run either a 16-bit version of the SNAplus2 client softw are (referred to i[...]

90 Chapter 2 Introduction to SNAplus2 SNAplus2 Resources SNAplus2 Resources The resources of the SNAplus2 system can be divided into the following types: • Node resources define the communications capabilities of a particular APPN node. The following are node resources: • Connectivity resources including the following: • DLCs • P orts • [...]

Chapter 2 91 Introduction to SNAplus2 SNAplus2 Resources NO TE Some of the resources listed here do not appear in the Motif administration program, or are presented differently . These differences are indicated in the following sections where they apply . Connectivity Resources Connectivity to remote systems is supported by the following resources:[...]

92 Chapter 2 Introduction to SNAplus2 SNAplus2 Resources NO TE In the Motif administration program, DLCs are not shown directly . The information required for configuring a DLC is displayed as part of the configuration of a port owned by the DLC . P orts A port represents the local end of a communications link as a unique access point in the netw[...]

Chapter 2 93 Introduction to SNAplus2 SNAplus2 Resources The local node can have an explicit link station defined for its communication path to another node on the SATF , but enabling communications between every pair of nodes on the SATF requires a large number of link station definitions, and results in a large volume of network topology inform[...]

94 Chapter 2 Introduction to SNAplus2 SNAplus2 Resources Session Resources The following session resources are used by SNAplus2: • Logical units (see “Logical Units”) • Modes and their associated classes of service (see “Modes and Classes of Service”) • Directory information (see “Directory Information”) Logical Units An LU is the[...]

Chapter 2 95 Introduction to SNAplus2 SNAplus2 Resources With DDDLU , LUs do not have to be configured statically at the host. (Y ou must still define dependent LUs on the SNAplus2 node .) This reduces the initial configuration required at the host, and makes later expansion easier . SNAplus2 can communicate with both DDDLU-capable and non-DDDLU[...]

96 Chapter 2 Introduction to SNAplus2 SNAplus2 Resources Default LUs. If you are configuring type 6.2 dependent LUs for use with APPC or CPI-C applications, you ma y wish to define them as members of the default pool. The default pool can include LUs from more than one node. An application that does not specify a particular local LU is assigned a[...]

Chapter 2 97 Introduction to SNAplus2 SNAplus2 Resources Domain Resources 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. F or this reason, only one definition is required for each such resource .[...]

98 Chapter 2 Introduction to SNAplus2 SNAplus2 Administration SNAplus2 Administration As the SNAplus2 administrator , you are responsible for installing the SNAplus2 software and for managing its resources . Before beginning SNAplus2 administration, you must understand the main features of the SNAplus2 product. This section describes the administra[...]

Chapter 2 99 Introduction to SNAplus2 SNAplus2 Administration Administration T ools SNAplus2 provides a range of tools for administering the system. Depending on your requirements , you may not need to use all of them. This section summarizes the functions provided by each of these tools . NO TE This document provides general information about SNAp[...]

100 Chapter 2 Introduction to SNAplus2 SNAplus2 Administration • Querying the configuration of defined resources and their current status if they are active • Deleting resources The Motif administration program can be used to manage both node resources (for any server on the LAN , as long as the SNAplus2 software is running on that server) an[...]

Chapter 2 101 Introduction to SNAplus2 SNAplus2 Administration The other SNAplus2 administration tools, inc luding command-line configuration, and NOF application programs , provide access to a wider range of configuration parameters and options than those shown in the Motif administration program. In most cases, however , you can perform all nee[...]

102 Chapter 2 Introduction to SNAplus2 SNAplus2 Administration • snapadmin -h -d command provides detailed help for the named command , including a list of the configuration parameters that can be specified with the command. Refer to the HP-UX SNAplus2 Administration Command Reference for more information. Remote Command F acility The remote co[...]

Chapter 2 103 Introduction to SNAplus2 SNAplus2 Administration The sna_domn.cfg file contains information about SNAplus2 domain resources (resources not associated with a particular local node). The master copy of this file resides on the master server . Invokable TP data file The sna_tps file contains information that SNAplus2 needs to start i[...]

104 Chapter 2 Introduction to SNAplus2 SNAplus2 Administration F or more information about this file, refer to the HP-UX SNAplus2 Administration Command Reference . Client network data file The sna_clnt.net file contains information about how to access SNAplus2 servers , required by a client computer . This text file resides on the client compu[...]

Chapter 2 105 Introduction to SNAplus2 SNAplus2 Administration Refer to the HP-UX SNAplus2 NOF Programmers Guide for more information. Diagnostic T ools SNAplus2 provides several diagnostics tools to help you diagnose and correct problems encountered during SNAplus2 operation: • Any component detecting a problem or an exception (an abnormal condi[...]

106 Chapter 2 Introduction to SNAplus2 SNAplus2 Administration • Using command-line utilities, you can filter trace files to extract or interpret specific information or to produce a summary of message flows . The resulting output files can be viewed using a standard ASCII text editor such as vi . • SNAplus2 can generate alerts and send th[...]

107 3 Administering SNAplus2[...]

108 Chapter 3 Administering SNAplus2 Overview Overview The first step in administering SNAplus2 is configuring the node and its resources . Begin by planning for configuration as described in “Planning for SNAplus2 Configuration”. Before you can configure SNAplus2, you must enable the SNAplus2 software as described in “Enabling and Disab[...]

Chapter 3 109 Administering SNAplus2 Planning for SNAplus2 Configuration Planning for SNAplus2 Configuration Before you make any configuration changes it is very important to plan thoroughly . Changes that you make can cause disruption, not only to the users of your local node but possibly to users all around the network. Y ou may find it usefu[...]

110 Chapter 3 Administering SNAplus2 Planning for SNAplus2 Configuration T ask Sheets The online help screens in the Motif administration program contain task sheets that provide guidance for specific configuration tasks . The task sheets contain pointers to all of the help screens for the dialogs that you will use to enter the configuration in[...]

Chapter 3 111 Administering SNAplus2 Enabling and Disabling SNAplus2 on the Local System Enabling and Disabling SNAplus2 on the Local System Y ou must enable the SNAplus2 softw are before you can use any SNAplus2 tools (including the Motif administration program). Normally , the software is enabled automatically after you install SNAplus2, but if n[...]

112 Chapter 3 Administering SNAplus2 Enabling and Disabling SNAplus2 on the Local System Enabling SNAplus2 Servers This section describes how to enable SNAplus2 on a computer that was installed as a server (that is , with the SNA node components installed). If you are enabling SNAplus2 on a client, see “Enabling SNAplus2 on HP-UX Clients”. Y ou[...]

Chapter 3 113 Administering SNAplus2 Enabling and Disabling SNAplus2 on the Local System tracing .) Tracing enables you to diagnose problems that occur during startup. If you do not use this option, tracing is inactive at all interfaces; you can then activate it on specific interfaces as required, using the command-line administration program snap[...]

114 Chapter 3 Administering SNAplus2 Enabling and Disabling SNAplus2 on the Local System If a 3270 emulation program is using LUs on the node when you disable the SNAplus2 software , all 3270 emulation sessions using these LUs end. The program continues to run, but the user cannot use the sessions until the software is re-enabled. If the RJE workst[...]

Chapter 3 115 Administering SNAplus2 Using the Motif Administration Program Using the Motif Administration Program The Motif administration program provides a user -friendly interface for configuring SNAplus2. This program is the recommended tool for administering SNAplus2, because it guides you through the configuration process and minimizes the[...]

116 Chapter 3 Administering SNAplus2 Using the Motif Administration Program In a client/server environment, SNAplus2 displays the Domain window . F or a standalone system, SNAplus2 displays the Node window . NO TE This guide uses the term window to describe Motif windows that display information about SNAplus2 resources . A window can contain one o[...]

Chapter 3 117 Administering SNAplus2 Using the Motif Administration Program Y ou can easily access other windows from this menu. These windows include the following: • Emulator Users and Sessionswindow • RJE W orkstations window • LU P ools window • CPI-C Destination Names window Depending on the resources you select and the options you cho[...]

118 Chapter 3 Administering SNAplus2 Using the Motif Administration Program Figure 3-1 SNAplus2 Domain Window If any active nodes in the domain (nodes on which SNAplus2 is running) are not configured, SNAplus2 prompts you to configure the node. NO TE The Domain window does not list SNAplus2 clients . Clients use the resources of SNAplus2 servers [...]

Chapter 3 119 Administering SNAplus2 Using the Motif Administration Program When you select a node to be administered, SNAplus2 displays the Node window as shown in Figure 3-2, “Node Window . ” (F or a standalone system, SNAplus2 does not display the Domain window , because the domain has only one node. Instead, SNAplus2 immediately displays th[...]

120 Chapter 3 Administering SNAplus2 Using the Motif Administration Program Figure 3-2 Node Window From the Node window , you can add, delete, modify , and manage all of the resources and components for the SNAplus2 node. The la yout of the resources in the window shows the relationships among resources and enables you to control which resources ar[...]

Chapter 3 121 Administering SNAplus2 Using the Motif Administration Program The body of the Node window is split into the following panes for the different types of resources for the node: Connectivity pane The top pane of the Node window lists connectivity resources for the node, including ports , link stations or PUs on each port, and dependent L[...]

122 Chapter 3 Administering SNAplus2 Using the Motif Administration Program Select the resource and click on the Start or Stop button. (Alternatively , you can select Start item or Stop item from the Selection menu.) Add a resource for an item Select the item and click on the New button (or select New from the Selection menu). F or example, to add [...]

Chapter 3 123 Administering SNAplus2 Using the Motif Administration Program list of associated link stations is shown or hidden. Similarly , link stations with a list of associated LUs can be expanded to show the LUs , or contracted to hide them. A parent resource must alwa ys be configured before its child resources, and deleting the parent resou[...]

124 Chapter 3 Administering SNAplus2 Using the Motif Administration Program Many resources , such as ports and link stations, cannot be modified while they are active. Y ou can, however , 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 de[...]

Chapter 3 125 Administering SNAplus2 Using the Motif Administration Program Figure 3-4 Sample Dialog Resource dialogs guide you through the configuration process and supply default values whenever possible. F or example, when you add a dependent LU , the Motif administration program automatically fills in the LU number field with an available LU[...]

126 Chapter 3 Administering SNAplus2 Using the Motif Administration Program Most dialogs provide a Description field; the information you enter there is displayed on the window where the resource is displayed. Press the Done button when you are finished, or the Cancel button to exit without changing the configuration for the resource . F or cont[...]

Chapter 3 127 Administering SNAplus2 Using the Motif Administration Program Figure 3-5 Sample Status Dialog Status dialogs show information about the current state of the resource. The information is updated dynamically as you view it. Help W indows The online help for the Motif administration program provides detailed guidance for each configurat[...]

128 Chapter 3 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 .[...]

Chapter 3 129 Administering SNAplus2 ASCII Administration Program ASCII Administration Program A menu-based ASCII administration program is available for character -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 SNAplu[...]

130 Chapter 3 Administering SNAplus2 Using the Command-Line Administration Program Using the Command-Line Administration Program Command-line configuration enables you to change all SNAplus2 configuration parameters . Y ou can use it to configure any of the resources that are available through the Motif administration program, and can set or cha[...]

Chapter 3 131 Administering SNAplus2 Using the Command-Line Administration Program The remainder of this section summarizes administration commands for different types of resources. Some of the types of commands listed are as follows: status_ * Provides summary information for types of resources . define_ * Creates a new define_ * record in the con[...]

132 Chapter 3 Administering SNAplus2 Using the Command-Line Administration Program[...]

133 4 Basic Configuration T asks[...]

134 Chapter 4 Basic Configuration T asks 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.[...]

Chapter 4 135 Basic Configuration T asks Configuring Client/Server Functions Configuring Client/Server Functions This section is relevant only if you installed SNAplus2 to run in a client/server environment (with multiple SNAplus2 nodes in the same network). Many resources , such as ports and LUs, are configured on an individual node. These are[...]

136 Chapter 4 Basic Configuration T asks Configuring Client/Server Functions NO TE Y ou cannot directly indicate which node acts as the master server; the master server is selected based on the order in which nodes are added to the configuration server list. If you wish to move a server to the top of the list, remove all other nodes from the lis[...]

Chapter 4 137 Basic Configuration T asks Configuring the Node Configuring the Node The first step in configuring SNAplus2 on a system is to configure the local node. Node configuration provides the basic information that the node needs in order to participate in an APPN network. Y ou must configure the node before you can define connectivi[...]

138 Chapter 4 Basic Configuration T asks Configuring the Node When you define the control point, SNAplus2 automatically defines a local LU with the same name. That LU can act as a default local LU for the node. Control point alias Local alias for the default local LU . Supply this value if the default local LU is used by independent LU 6.2 LUs [...]

Chapter 4 139 Basic Configuration T asks Configuring Logging Configuring Logging SNAplus2 writes log messages describing abnormal events (and, optionally , normal events) to log files. When you try to diagnose a problem, the first place to look is in the log files , because the log messages provide information about the cause of the problem a[...]

140 Chapter 4 Basic Configuration T asks Configuring Logging If your favorite editor is installed on the server , you can use it to view the log files . If not, you can use the standard HP-UX system utilities: pg View a file one page at a time . This utility is simple and easy to use but useful only if the log file is small. tail View the tail[...]

Chapter 4 141 Basic Configuration T asks Configuring Logging The Logging dialog in the Motif administration program affects log settings throughout the domain. Using the command line, you can override the domain settings by configuring local log settings on a particular machine . In addition to providing control over logging , the Motif administ[...]

142 Chapter 4 Basic Configuration T asks Configuring Logging[...]

143 5 Defining Connectivity Components[...]

144 Chapter 5 Defining Connectivity Components Overview Overview In order for the SNAplus2 node to communicate with other nodes, you must configure connectivity with at least one adjacent node. A connecting link can be configured to carry dependent traffic, independent traffic, or both.Y ou can have adapter cards for one or more link protocols[...]

Chapter 5 145 Defining Connectivity Components Overview and they must be configured on the adjacent nodes as well as on the SNAplus2 node, so you ma y need to consult your SNA network planner . Operating as an APPN Node If the SNAplus2 node is an end node in an APPN network, the number of links that you need to configure can be greatly reduced. [...]

146 Chapter 5 Defining Connectivity Components Overview F or information about configuring PU concentration, see “Configuring PU Concentration”.[...]

Chapter 5 147 Defining Connectivity Components Defining P orts, DLCs, and Connection Networks Defining P orts, DLCs, and Connection Networks A port represents the local end of a communications link as a unique access point in the network. Each port is associated with a specific link protocol, which can be any of the following: • SDLC • T ok[...]

148 Chapter 5 Defining Connectivity Components Defining P orts, DLCs, and Connection Networks Select Connectivity and New port from the Services menu on the Node window . Command-line administration program T o configure a port: define_ type _port T o configure a DLC: define_ type _dlc In these commands , type indicates the link protocol type ([...]

Chapter 5 149 Defining Connectivity Components Defining P orts, DLCs, and Connection Networks This field applies only if the adapter card can support more than one port. This field is not used for SDLC or QLLC ports. Initially active Whether to activate the port automatically when the node is started. This setting enables link stations that use[...]

150 Chapter 5 Defining Connectivity Components Defining P orts, DLCs, and Connection Networks Select a value that describes the role of the local node for link stations defined on this port. In SDLC communication, one end manages the link and is called the primary link station. The other end is the secondary link station. Use one of the followin[...]

Chapter 5 151 Defining Connectivity Components Defining P orts, DLCs, and Connection Networks Select NRZ (typically used in the U .S .) or NRZI (typically used in Europe) for the encoding used on your SDLC line. This value must match the encoding scheme used by the modem at the remote end of the link. If you set this field incorrectly , you will[...]

152 Chapter 5 Defining Connectivity Components Defining P orts, DLCs, and Connection Networks Consult your SNA network planner if you do not know how to configure any of these parameters . Additional P ort P arameters for T oken Ring, FDDI and Ethernet Local SAP number The address of the SAP , usually 04 . Use a different value only if you need [...]

Chapter 5 153 Defining Connectivity Components Defining P orts, DLCs, and Connection Networks NO TE The underlying stack is also configured with an address and accepts only calls that specify an address starting with the configured address. Any address configured on the port must start with the address configured on the stack; otherwise , cal[...]

154 Chapter 5 Defining Connectivity Components Defining Link Stations Defining Link Stations T o communicate with other nodes in an SNA network, you must configure the characteristics of a link station (LS) to an adjacent node in the SNA network. Before you can define a link station, you must define a port for the adapter (and link protocol) [...]

Chapter 5 155 Defining Connectivity Components Defining Link Stations the local node. This dynamically created link station appears in the connectivity section of the Node window for the duration of the connection. T o configure a link station, use one of the following methods: Motif administration program Select Connectivity and New link statio[...]

156 Chapter 5 Defining Connectivity Components Defining Link Stations Common Link Station P arameters The following parameters are required for all link stations, whether they support dependent traffic, independent traffic , or both. F or more information about the parameters on this dialog, refer to the online help or to HP-UX SNAplus2 Adminis[...]

Chapter 5 157 Defining Connectivity Components Defining Link Stations The type of LU traffic to flow over the link. This choice determines what other parameters are needed for link definition. Any The link station can be used for both independent and dependent LU traffic. F or this option, you must supply values for the fields described in ?[...]

158 Chapter 5 Defining Connectivity Components Defining Link Stations • If you are configuring a primary switched outgoing link station, and you do not know the poll address of the remote secondary with which you wish to communicate, you can specify a poll address of 0xFF on the primary . This value enables the node to accept responses from a [...]

Chapter 5 159 Defining Connectivity Components Defining Link Stations 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 . Y ou can match the baud rate to the modem's baud rate by placing one of the following numbers (enclosed by parentheses) in front[...]

160 Chapter 5 Defining Connectivity Components Defining Link Stations 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, the SAP number is the SAP ADDR= parameter of the VTAM PU definition. If you are configuring a link to an AS/400 system, the MAC address is the ADPT ADR para[...]

Chapter 5 161 Defining Connectivity Components Defining Link Stations P arameters for Independent LU Traffic Y ou need the following information to configure this link station for use by independent LUs (LUs of type 6.2 for use by APPC , 5250, or CPI-C applications): Remote node name The fully qualified CP name of the remote node. If the remot[...]

162 Chapter 5 Defining Connectivity Components Defining Link Stations slightly , so if you do know the type it is better to specify it. This also helps to ensure network configuration consistency . Y ou cannot choose Discover if the link station is activated on demand. If the local node is a LEN node, this field does not apply . P arameters for[...]

Chapter 5 163 Defining Connectivity Components Defining Link Stations CP name of the remote node, but for remote nodes that do not send their CP name when activating a link, the remote node ID must be used instead. If you do not specify the remote node ID , the node ID of the remote node is not checked when the link is activated. Remote node role[...]

164 Chapter 5 Defining Connectivity Components Defining DLUR PUs Defining DLUR PUs Normally , a dependent LU session requires a direct communications link to the host computer . If many nodes (including a host node) are connected together in an APPN network, some of them may not have a direct connection to the host, but only an indirect connecti[...]

Chapter 5 165 Defining Connectivity Components Defining DLUR PUs F or each DLUR PU on the local node, specify a PU name. The name does not need to matc h the PU name configured on the host. DLUS Name The fully qualified LU name of the host LU that supports DLUS . In order to use DLUR, the DLUR component of SNAplus2 has to establish an LU-LU ses[...]

166 Chapter 5 Defining Connectivity Components Defining DLUR PUs Whether the DLUR PU is to be activated automatically after a failure (once the cause of the failure has been remedied). Additional Configuration After configuring DLUR, continue with the following configuration tasks: • T o configure LUs for DLUR, see “Defining DLUR PUs”.[...]

167 6 Configuring Dependent LUs[...]

168 Chapter 6 Configuring Dependent LUs Overview Overview This chapter provides instructions for configuring LUs and LU pools to support user applications that use 3270, TN3270, RJE and LU A communications . T o use these, you must configure dependent LUs. Before you can configure the resources described in this chapter , you must perform the f[...]

Chapter 6 169 Configuring Dependent LUs Defining LU T ypes 0–3 Defining LU Types 0–3 Y ou must configure dependent LUs of types 0–3 to support communication with a host system. Y ou can use the information in this section to define an LU to support 3270, RJE, or LU A. Y ou can also define a range of LUs , to configure multiple LUs of t[...]

170 Chapter 6 Configuring Dependent LUs Defining LU T ypes 0–3 The link station that provides the link to the host. The LU definition belongs to the link station you select. (If the dependent LU resides on a node that supports DLUR, this field identifies the DLUR PU that provides connectivity to the host.) LU numbers An LU number or range of[...]

Chapter 6 171 Configuring Dependent LUs Defining LU T ypes 0–3 Whether the LU is assigned to an LU pool. Only printer , display , and unrestricted (unknown) LUs can be members of a pool. P ool name The name of the LU pool. Additional Configuration After performing the LU type 0–3 configuration, continue with the following configuration tas[...]

172 Chapter 6 Configuring Dependent LUs Defining LU P ools Defining LU P ools F or 3270, TN3270, RJE,and LUA, you can define LU pools to simplify user configuration and provide greater flexibility in establishing host sessions . F or example, you can define several 3270 LUs in a single LU pool, then configure multiple 3270 sessions using th[...]

Chapter 6 173 Configuring Dependent LUs Defining LU P ools LU P ool Configuration P arameters The following parameters are required for LU pool configuration: Name A name to identify the LU pool. This field applies only when you are adding a new LU pool. Y ou cannot change the name of an existing pool. Assigned LUs LUs to be assigned to the po[...]

174 Chapter 6 Configuring Dependent LUs Defining LU P ools[...]

175 7 Configuring APPC Communication[...]

176 Chapter 7 Configuring APPC Communication Overview Overview APPC applications , 5250 emulation programs, and CPI-C applications all require that you configure APPC first. An APPC application uses the node's LU type 6.2 resources to communicate with another APPC or CPI-C application on a host or peer computer , using a specified mode . I[...]

Chapter 7 177 Configuring APPC Communication Overview Step 1. Define a local LU as described in “Defining Local LUs”. Step 2. Define a remote node as described in “Defining Remote Nodes”. Step 3. Define a partner LU as described in “Defining P artner LUs”. Step 4. Define an invokable TP as described in “Defining TPs”. Step [...]

178 Chapter 7 Configuring APPC Communication Defining Local LUs Defining Local LUs In many cases , applications can use the local node's control point LU , which is automatically defined when you configure the node . This is the default LU—if your application does not specify a particular LU , it can use this one. If the application use[...]

Chapter 7 179 Configuring APPC Communication Defining Local LUs Command-line administration program Issue the following command: define_local_lu Y ou can use the advanced dialog to specify sync point support, attach routing characteristics , restrictions on SSCP access, and security . Local LU Configuration P arameters The following parameters a[...]

180 Chapter 7 Configuring APPC Communication Defining Local LUs • T o define a remote node, see “Defining Remote Nodes”. • T o define a partner LU , see “Defining P artner LUs”. • T o define an invokable TP , see “Defining TPs”. • T o define a mode, see “Defining Modes and Classes of Service”. • T o define CPI-C[...]

Chapter 7 181 Configuring APPC Communication Defining Remote Nodes Defining Remote Nodes Y ou must define a remote node (and the partner LUs on the node) in the following situations: • If the local node is a LEN node, you must define all of the remote nodes and any partner LUs on the remote node with which it communicates using APPC . A LEN [...]

182 Chapter 7 Configuring APPC Communication Defining Remote Nodes defined a remote node and SNAplus2 establishes CP-CP sessions with it, the entry is temporarily converted into a dynamic one. Y ou should correct the fault by deleting the remote node definition when the node is inactive. T o configure a remote node, use one of the following me[...]

Chapter 7 183 Configuring APPC Communication Defining Partner LUs Defining P artner LUs If both the local node and the remote node are end nodes or network nodes and your application uses an LU name to refer to the partner LU , there is no need to define the partner LU , because it can be dynamically located using APPN . If both nodes are end n[...]

184 Chapter 7 Configuring APPC Communication Defining Partner LUs P artner LU Configuration P arameters The following parameters are required for partner LU configuration: P artner LU name The fully qualified LU name of the partner LU . This name must match the name that is configured at the remote node for this LU . If you do not know what t[...]

Chapter 7 185 Configuring APPC Communication Defining Partner LUs A locally displayable alias for the partner LU . Y ou do not have to specify an LU alias if there is no local application that refers to the partner LU using an LU alias . This field applies when you define partner LU on a specific remote node or when you define a partner LU al[...]

186 Chapter 7 Configuring APPC Communication Defining Partner LUs Additional Configuration After performing the partner LU configuration, continue with the following configuration tasks: • T o define an invokable TP , see “Defining TPs”. • T o define a mode, see “Defining Modes and Classes of Service”. • T o define CPI-C sid[...]

Chapter 7 187 Configuring APPC Communication Defining TPs Defining TPs This section explains how to define an APPC TP . In most cases, you do not need to define TPs that run on the SNAplus2 system; but you do need to configure a TP definition in the following cases: APPC Characteristics If the TP on the SNAplus2 computer is the invoking TP ([...]

188 Chapter 7 Configuring APPC Communication Defining TPs F or an invokable TP , you can also specify a timeout value, to limit the w ait for an allocation request. (Y ou can only configure this option using command-line administration.) SNAplus2 uses the invokable TP definition for the following purposes: • When a TP issues Receive_Allocate,[...]

Chapter 7 189 Configuring APPC Communication Defining TPs The configuration methods for servers and clients are different: • On a server , use either of the following methods: Motif administration program Select APPC and Transaction Programs from the Services menu on the Node window . When SNAplus2 displays the TP window , select the top pane [...]

190 Chapter 7 Configuring APPC Communication Defining TPs The local LU alias from which the TP is to accept incoming Attaches . This name must match the name of a local APPC LU on the SNAplus2 node. If you do not specify an LU alias, the TP accepts incoming Attac hes from any local LU . This field applies only if you specify that the parameters [...]

Chapter 7 191 Configuring APPC Communication Defining TPs about the TP is broadcast to all servers on the LAN; if an LU on another computer receives an incoming Allocate request and has no routing information configured, it can dynamically locate the TP and route the Allocate request to it. Using this option avoids having to configure explicit [...]

192 Chapter 7 Configuring APPC Communication Defining TPs The TP is started in the home directory associated with this user ID . This home directory is also the default path for trace files and any other files accessed by the TP (unless the application overrides it by specifying a full path). If the application specifies a file name without a[...]

Chapter 7 193 Configuring APPC Communication Defining TPs Select this option if an allocation request must include a valid user name and password (or an indicator that the password has already been verified). If you do not select this option, no verification is required. Restrict access Select this option if the user name must be included on a [...]

194 Chapter 7 Configuring APPC Communication Defining Modes and Classes of Service Defining Modes and Classes of Service A mode specifies a set of characteristics that a local LU (LU type 6.2) uses to communicate with its partner LU . These characteristics inc lude information about the wa y data is transmitted between the two LUs (such as maxi[...]

Chapter 7 195 Configuring APPC Communication Defining Modes and Classes of Service T able 7-1 Standard Mode and COS Names Once a mode has been configured, it can be used by any APPC or CPI-C application to activate a session between a local LU and a partner LU . An APPC application must specify the mode to use, but a CPI-C application can use CP[...]

196 Chapter 7 Configuring APPC Communication Defining Modes and Classes of Service Command-line administration program T o define a mode, issue the following command: define_mode T o change the default mode, issue the following command: define_defaults T o define a class of service, issue the following command: define_cos Mode Configuration P [...]

Chapter 7 197 Configuring APPC Communication Defining Modes and Classes of Service This field is usually set to the same value as the initial session limit. If you are in doubt, consult your SNA network planner or APPC application developer (or for a third-party application, the product documentation). Minimum contention winner sessions The numb[...]

198 Chapter 7 Configuring APPC Communication Defining Modes and Classes of Service The initial setting for the number of request units (RUs) that the local LU can receive before it must send a pacing response to the remote LU . This can be safely set to 4 . Setting it higher can improve performance in some circumstances , but doing so also increa[...]

Chapter 7 199 Configuring APPC Communication Defining Modes and Classes of Service The lower limit can be 0 or a value from 256 through the upper limit you specify . If the value in this field is different from the RU size defined for the remote node, the size used for a session with that node can be negotiated to establish an appropriate RU si[...]

200 Chapter 7 Configuring APPC Communication Defining CPI-C Side Information Defining CPI-C Side Information If you are supporting a CPI-C application that uses CPI-C symbolic destination names , you need to define the CPI-C side information. The side information associates the symbolic destination name with information about the partner TP , p[...]

Chapter 7 201 Configuring APPC Communication Defining CPI-C Side Information Specify this option to use a member of the default pool (if one exists) or the node control point LU (if no default pool is defined). If the APPCLLU environment variable is set, the local LU information you supply is ignored, and the LU specified for the environment va[...]

202 Chapter 7 Configuring APPC Communication Defining CPI-C Side Information Same The partner TP uses security , but accepts verification by the local TP of the user ID and password provided by the initiating TP . If you choose a security level of Same , you also need to specify a valid user ID that is accepted by the partner TP . Program The pa[...]

Chapter 7 203 Configuring APPC Communication Defining CPI-C Side Information Additional Configuration After performing the CPI-C configuration, continue with the following configuration tasks: • T o define APPC security , see “Configuring APPC Security”. • T o configure 5250 communication, see Chapter 8, “Configuring User Applica[...]

204 Chapter 7 Configuring APPC Communication Configuring APPC Security Configuring APPC Security Y ou can perform the following configuration tasks for APPC security: • Configuring session security as described in “Configuring Session Security” • Configuring conversation security as described in “Configuring Conversation Security?[...]

Chapter 7 205 Configuring APPC Communication Configuring APPC Security used to create a key , which is exchanged when the session is established. This password is not related to HP-UX login passwords on either the local or the remote node. Additional Configuration After performing the session security configuration, continue with the following [...]

206 Chapter 7 Configuring APPC Communication Configuring APPC Security The password to be accepted in an incoming conversation from a remote node. The password can be up to 10 characters long . This password is not related to HP-UX login passwords on either the local or the remote node. Additional Configuration After configuring conversation se[...]

Chapter 7 207 Configuring 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”.[...]

208 Chapter 7 Configuring APPC Communication Configuring APPC Security[...]

209 8 Configuring User Applications[...]

210 Chapter 8 Configuring User Applications Overview Overview This chapter provides instructions for configuring SNA resources to support user applications that use any of the following communication: 3270, RJE, 5250, and LU A. The SNA resources required by such applications include LUs , session definitions, and user definitions . F or 3270, R[...]

Chapter 8 211 Configuring User Applications Overview Step 1. F or a 3270 display or printer , define a dependent LU as described in “Defining LU Types 0–3”. Step 2. T o enable 3270 displa ys to select from a pool of LUs , define an LU pool as described in “Defining LU P ools”. If a display uses a dedicated LU , you can skip this step[...]

212 Chapter 8 Configuring User Applications Overview RJE applications SNAplus2 provides support for remote job entry (RJE), enabling you to submit jobs to a host computer for processing . The RJE workstation daemon handles transfer of jobs to the host, and also handles the output returned from the host. Y ou can prepare jobs for submission to the [...]

Chapter 8 213 Configuring User Applications Configuring 3270 Users and Sessions Configuring 3270 Users and Sessions T o enable 3270 communications, you must define emulator users or groups of users as described in “Configuring 3270 Emulator Users”, and 3270 emulator sessions as described in “Configuring 3270 Sessions”. Configuring 32[...]

214 Chapter 8 Configuring User Applications Configuring 3270 Users and Sessions Emulation User and Group Configuration P arameters The following parameters are required for each 3270 emulator user definition: User Name The name of the emulator user . F or users running the emulation program on HP-UX systems, this is the name used to log in on t[...]

Chapter 8 215 Configuring User Applications Configuring 3270 Users and Sessions If the user has a style file, enter the file name . If there is no style file, the user runs the emulation program with a default style. The style file determines the appearance and behavior of the emulation screens and keyboard for the emulator user . These may b[...]

216 Chapter 8 Configuring User Applications Configuring 3270 Users and Sessions The user can view RTM data. Send alerts The user can send alerts to NetView . Additional Configuration After performing the emulation user configuration, you can define 3270 sessions for users or groups as described in “Configuring 3270 Sessions”. Configuring[...]

Chapter 8 217 Configuring User Applications Configuring 3270 Users and Sessions Display or Printer Specify whether the session is a display or printer session. LU/P ool name The name of the LU or pool to be used by the session. Assign printer LUs for printer sessions, and display LUs or pools of display LUs for displa y sessions. The LU should be[...]

218 Chapter 8 Configuring User Applications Configuring 5250 Users Configuring 5250 Users T o enable 5250 communications, you must define emulator users or groups of users as described in “Configuring 5250 Emulator Users”. Configuring 5250 Emulator Users Y ou must add emulator user definitions for each user who requires access to a 5250 [...]

Chapter 8 219 Configuring User Applications Configuring 5250 Users F or users running the emulation program on HP-UX systems , this is the name used to log in on that computer . The name is set up by the administrator of the HP-UX system. F or Windows 3.1 or W indows for W orkgroups 3.11, or on Win16 subsystems on W indows NT , Windows 95, or OS/[...]

220 Chapter 8 Configuring User Applications Configuring RJE W orkstations Configuring RJE W orkstations Y ou can define an RJE workstation to submit jobs to a host computer for processing . The RJE workstation also handles the output returned by the host. NO TE Y ou must configure at least one RJE LU before defining an RJE workstation. T o co[...]

Chapter 8 221 Configuring User Applications Configuring RJE W orkstations The RJE workstation runs using this user name, and all files created by the RJE workstation are owned by this user . UNIX group name The HP-UX system group name for the users who use the RJE workstation. The name must be a valid group name on the HP-UX system on which the [...]

222 Chapter 8 Configuring User Applications Configuring RJE W orkstations[...]

223 9 Configuring P assthrough Services[...]

224 Chapter 9 Configuring Passthrough Services Overview Overview P assthrough services on a server running SNAplus2 enable communication between an SNA host and local systems that are not directly connected to the host. SNAplus2 includes TN server support for TN3270, TN3287, and TN3270E clients , collectively referred to as “TN3270 clients .” [...]

Chapter 9 225 Configuring Passthrough Services Configuring TN Server Configuring TN Server TN server enables TN3270 clients to communicate with a host through an intermediate SNAplus2 node that implements the TN server . The TN3270 clients connect to the TN server using TCP/IP , and use LUs defined on the TN server . The TN server LUs establish[...]

226 Chapter 9 Configuring Passthrough Services Configuring TN Server Configuring TN Server Access Records TN server access records indicate which TN3270 clients can access the TN server and which LUs they should use . Each access record identifies a TN3270 client that is permitted to access the TN server , the TCP/IP port that the client connec[...]

Chapter 9 227 Configuring Passthrough Services Configuring TN Server P ermit access from a specific TCP/IP address . If you know the TCP/IP address of the TN3270 client, select this option and enter the address in the standard TCP/IP dotted decimal address format. Support TN3270E The level of TN3270 support provided by the node: TN3270 Support o[...]

228 Chapter 9 Configuring Passthrough Services Configuring TN Server If you want a TN3270 c lient to be able to use more than one LU or LU pool, define multiple access records, eac h with a different TCP/IP port number , so that you can identify the different LUs or LU pools by specifying different port numbers. Display LU assigned The name of t[...]

Chapter 9 229 Configuring Passthrough Services Configuring TN Server Motif administration program Select TN Server from the Services menu on the Node window , then select the Association Records pane on the TN Server window and choose New . Command-line administration program Issue the following command: define_tn3270_association TN Server Associ[...]

230 Chapter 9 Configuring Passthrough Services Configuring PU Concentration Configuring PU Concentration Normally , a dependent LU session requires a direct communications link to the host computer . However , a node running SNAplus2 that has a direct communications link to the host can also provide PU concentration facilities to LUs on downstre[...]

Chapter 9 231 Configuring Passthrough Services Configuring PU Concentration • Define the LUs on the local node that are used for communication with the host (the upstream LUs). Upstream LUs must be defined using the LU Type 0-3 Configuration dialog, specifying an LU type of unrestricted (unknown). T o add the LUs, see “Defining LU Types 0[...]

232 Chapter 9 Configuring Passthrough Services Configuring PU Concentration The LU number must match the LU number defined on the downstream node. Contact your SNA network planner if you do not know what LU number to use. Y ou can configure several LUs with consecutive LU numbers by defining a range of LUs . Upstream LU name The name of the ho[...]

Chapter 9 233 Configuring Passthrough Services Configuring DLUR Configuring DLUR Normally , a dependent LU session requires a direct communications link to the host computer . If many nodes (including a host node) are connected together in an APPN network, some of them may have an indirect connection through another node instead of a direct conn[...]

234 Chapter 9 Configuring Passthrough Services Configuring DLUR printer , RJE, or LU A. Depending on the requirements of the user applications supported by the LUs , you may also need to perform further configuration.[...]

235 10 Managing SNAplus2 from NetV iew[...]

236 Chapter 10 Managing SNAplus2 from NetView Overview Overview SNAplus2 includes a remote command facility (RCF) that operates in conjunction with the NetView program at a host computer , enabling a NetView operator to issue commands from the host NetV iew program to the SNAplus2 computer . F or a brief overview of NetView and RCF commands , see ?[...]

Chapter 10 237 Managing SNAplus2 from NetView Using the Host NetView Pr ogram Using the Host NetV iew Program The SNAplus2 RCF operates in conjunction with the NetView program at a host computer . The host must be running NetV iew V ersion 1 Release 2, or a later version; SNAplus2 does not support NetView V ersion 1 Release 1. T o use the NetView p[...]

238 Chapter 10 Managing SNAplus2 from NetView Using the Host NetView Pr ogram Step 5. If you are using 3270 emulation to access NetView , follow the instructions in HP-UX SNAplus2 3270/3179G Users Guide for ending 3270 emulation when you have finished issuing commands . NetV iew Screen Display The layout of the NetV iew screen varies with differen[...]

Chapter 10 239 Managing SNAplus2 from NetView Using the Host NetView Pr ogram node The SNAplus2 node associated with the service point name spname (for SPCF commands) unix The UCF daemon program running on the SNAplus2 computer associated with the service point name spname (for UCF commands) commandtext Supplies the text of the command being issued[...]

240 Chapter 10 Managing SNAplus2 from NetView Using the Host NetView Pr ogram T able 10-1 Using Escape Characters in RCF Commands The escape characters you would normally use on the HP-UX command line, to prevent the HP-UX shell from interpreting special c haracters, are not required with RCF . F or example, do not use escape characters with string[...]

Chapter 10 241 Managing SNAplus2 from NetView Using SPCF Using SPCF SPCF enables you to issue commands from the NetView console to manage the running SNAplus2 system. These commands are the same as those you can issue using the SNAplus2 command-line management program snapadmin (as described in HP-UX SNAplus2 Administration Command Reference ). F o[...]

242 Chapter 10 Managing SNAplus2 from NetView Using SPCF T o provide security , you can set up the SNAplus2 configuration so that only certain types of commands are permitted from SPCF . F or example, you can permit remote users to issue query_ * commands, but not to activate or deactivate SNAplus2 components. Y ou can control access separately fo[...]

Chapter 10 243 Managing SNAplus2 from NetView Using UCF Using UCF UCF enables a NetView operator to issue HP-UX commands on a computer running SNAplus2 by typing the command text at the NetView console, and to view output from these commands . The facility is not restricted to commands related to SNAplus2; subject to the restrictions in “P ermitt[...]

244 Chapter 10 Managing SNAplus2 from NetView Using UCF Specify spname , which is the name of your service point as defined at NetView . The host NetV iew personnel can give you this information. appl =unix Instruct NetView to send the command to the UCF daemon program on the SNAplus2 computer associated with the service point name spname . HP-UX_[...]

Chapter 10 245 Managing SNAplus2 from NetView Using UCF • The UCF cannot be used with a command that requires further input from the user before it completes (for example, a command such as vi filename that starts an interactive process , or a command such as tail -f filename that does not complete until it is stopped by the user). Because all [...]

246 Chapter 10 Managing SNAplus2 from NetView Using UCF If you issue a command when a previous command is still in progress (that is , before the UNIX COMMAND COMPLETED message is received), the following message is displayed: = = = COMMAND QUEUED = = = The second command is queued, and is executed when the previous command has completed. Canceling[...]

Chapter 10 247 Managing SNAplus2 from NetView Using UCF In this case, the ux-cancel command is ignored. No action is necessary . This message can be displayed when the ux-cancel command is issued after the previous command finishes but before the UNIX COMMAND COMPLETED message is received. UCF Security Because the UCF enables a remote operator to [...]

248 Chapter 10 Managing SNAplus2 from NetView Using UCF[...]

249 11 Managing SNAplus2 Clients[...]

250 Chapter 11 Managing SNAplus2 Clients Overview Overview A domain for SNAplus2 can include both servers (SNA nodes) and clients (which can access SNA connectivity through a server). Clients can be computers running the HP-UX operating system or the Windows 3.1, Windows for W orkgroups 3.11, Windows 95, or W indows NT operating systems. Servers an[...]

Chapter 11 251 Managing SNAplus2 Clients Client Networking Requirements Client Networking Requirements Before you can run SNAplus2 on a client computer , you must configure TCP/IP port addresses on both the clients and servers in your network. If you encounter problems with the default port assignments, you ma y need to resolve conflicts as descr[...]

252 Chapter 11 Managing SNAplus2 Clients Client Networking Requirements For Windows Step 4. If your SNAplus2 domain includes W indows clients, add the same two lines to the services file on each Windows computer . The services file is in the same format as the HP-UX file, and is generally stored in the home directory of the Windows TCP/IP softw [...]

Chapter 11 253 Managing SNAplus2 Clients Client Networking Requirements • The administration commands query_central_logger or query_node_all (these return the information that was available before the TCP/IP connection w as dropped, and so may not match the current status of the LAN). • The NOF verbs query_central_logger or query_node_all (as f[...]

254 Chapter 11 Managing SNAplus2 Clients Managing Win32 Clients Managing W in32 Clients For Windows SNAplus2 enables machines running Microsoft W indows 95 and Windows NT to act as c lients in the SNAplus2 domain. The SNAplus2 client softw are includes API libraries that are fully compatible with Microsoft SNA Server and the Windows Open Systems Ar[...]

Chapter 11 255 Managing SNAplus2 Clients Managing Win32 Clients • Logging and tracing options for applications running on the client • Additional options for CPI-C and CSV applications running on the client • Invokable TPs (APPC or CPI-C) that can run on the client F or more information, see “Win32 Client Configuration”. Enabling a W in3[...]

256 Chapter 11 Managing SNAplus2 Clients Managing Win32 Clients W in32 Client Security SNAplus2 provides a facility for validating the user name and password of any Win32 c lient running on Windows 95 and attempting to contact a server running SNAplus2. This enables you to ensure that only authorized Windows users are able to access the SNAplus2 sy[...]

Chapter 11 257 Managing SNAplus2 Clients Managing Win32 Clients W in32 Client Configuration On both Windows NT and W indows 95, configuration information is managed through the Windows Program Registry . The Windows Program Registry contains SNA network information (similar to the information held in the client network data file on HP-UX clients[...]

258 Chapter 11 Managing SNAplus2 Clients Managing Win32 Clients rui = YES | NO nof = YES | 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[...]

Chapter 11 259 Managing SNAplus2 Clients Managing Win32 Clients The group_name value indicates the group name of the SNAplus2 user on this client. This name must match the SNAplus2 configuration on servers, as follows: • If the client will be running 3270 or 5250 emulation, and you have set up the SNAplus2 configuration to include emulator reco[...]

260 Chapter 11 Managing SNAplus2 Clients Managing Win32 Clients Specify the time in seconds for which the TCP/IP connection from the client to a server should be kept active while no applications on the client are using SNAplus2 resources . F or more information, see “LAN Access Timeout”. The valid range is 0 – 65535 . The minimum timeout is [...]

Chapter 11 261 Managing SNAplus2 Clients Managing Win32 Clients This parameter is optional. The valid range is 5 – 65535 . If it is not specified, the default is 200 (seconds). client_start_timeout The Registry data type of this value is REG_DWORD . Specify the time in seconds that an application waits while the Win32 client starts and tries to [...]

262 Chapter 11 Managing SNAplus2 Clients Managing Win32 Clients 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 , and must use directed messages , specify the name o[...]

Chapter 11 263 Managing SNAplus2 Clients Managing Win32 Clients The parameters Server2 – Server10 cannot be set 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 subkey specifies logging options for the client.[...]

264 Chapter 11 Managing SNAplus2 Clients Managing Win32 Clients This parameter is optional. If it is not specified, the Win32 c lient uses the global domain settings to determine whether audit messages are recorded. (The initial default is that audit messages are recorded.) log_directory The Registry data type of this value is REG_SZ . The full pa[...]

Chapter 11 265 Managing SNAplus2 Clients Managing Win32 Clients amount of disk space taken up by error log files is approximately twice the value of the error_file_wrap_size parameter . This parameter is optional. If it is not specified, the default is 1000000 (bytes). If you are logging error and audit messages to the same file, this parameter[...]

266 Chapter 11 Managing SNAplus2 Clients Managing Win32 Clients This parameter is optional. If it is not specified, the default is 1000000 (bytes). If you are logging error and audit messages to the same file, this parameter must be set to the same value as the error_file_wrap_size parameter . succinct_errors The Registry data type of this value[...]

Chapter 11 267 Managing SNAplus2 Clients Managing Win32 Clients The Registry data type of this value is REG_SZ . Specifies whether to use succinct logging or verbose logging in the audit log file. The permitted values and their meanings are the same as for the succinct_errors parameter . API_tracing The API_tracing subkey specifies API tracing o[...]

268 Chapter 11 Managing SNAplus2 Clients Managing Win32 Clients 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 i[...]

Chapter 11 269 Managing SNAplus2 Clients Managing Win32 Clients The Registry data type of this value is REG_SZ . T o trace CPI-C API 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 CPI-C me[...]

270 Chapter 11 Managing SNAplus2 Clients Managing Win32 Clients 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 MS messages are traced. MSG_tracing The MSG_tracing subkey specifies options for tracing on Win32 client 3270 emulation programs . F or more[...]

Chapter 11 271 Managing SNAplus2 Clients Managing Win32 Clients 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[...]

272 Chapter 11 Managing SNAplus2 Clients Managing Win32 Clients 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 . Whe[...]

Chapter 11 273 Managing SNAplus2 Clients Managing Win32 Clients T o trace data messages, set this parameter to YES ; otherwise, set it to NO . This parameter is optional. If it is not specified, the default is NO . send The Registry data type of this value is REG_SZ . T o trace all data messages sent from the client to the server , set this parame[...]

274 Chapter 11 Managing SNAplus2 Clients Managing Win32 Clients The TP name of the application. This name is used in log and trace files to identify the application. F or 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 appli[...]

Chapter 11 275 Managing SNAplus2 Clients Managing Win16 Clients Managing W in16 Clients SNAplus2 enables machines running Microsoft W indows 3.1 and Windows for W orkgroups 3.11 to act as clients in the SNAplus2 domain. The SNAplus2 client softw are includes API libraries that are fully compatible with Microsoft SNA Server and the Windows Open Syst[...]

276 Chapter 11 Managing SNAplus2 Clients Managing Win16 Clients • Servers that the client can access • Logging and tracing options for applications running on the client • Additional options for CPI-C and CSV applications running on the client F or more information about this file, see “W in16 Client Initialization File (sna.ini)”. sna_t[...]

Chapter 11 277 Managing SNAplus2 Clients Managing Win16 Clients T o disable the NAP , click on the Windows NAP icon and c hoose Close . If any SNAplus2 applications are running , the Close option is not selectable; if you are sure you want to disable the NAP , stop the relevant applications before retrying. W in16 Client Security SNAplus2 provides [...]

278 Chapter 11 Managing SNAplus2 Clients Managing Win16 Clients password, or if the user name and password cannot be matched with a user name and password on the server , the server rejects the client's access attempt. T o stop using Win16 client security , so that any W in16 client user can access SNAplus2 servers without having to specify a [...]

Chapter 11 279 Managing SNAplus2 Clients Managing Win16 Clients backup_error_file = backup_error_filename error_file_wrap_size = error_file_size audit_file = audit_filename backup_audit_file = backup_audit_filename audit_file_wrap_size = audit_file_size succinct_errors = YES | NO succinct_audits = YES | NO [API_tracing] file1 = trace_filename[...]

280 Chapter 11 Managing SNAplus2 Clients Managing Win16 Clients [Configuration] The [Configuration] section of the file contains configuration information for the client, as follows: domain The domain_name argument indicates the domain name of the SNAplus2 LAN , as specified during the client installation. This line is required. snauser The use[...]

Chapter 11 281 Managing SNAplus2 Clients Managing Win16 Clients The group_name argument indicates the group name of the SNAplus2 user on this client. This name must match the SNAplus2 configuration on servers , as follows: • If the client will be running 3270 or 5250 emulation, and you have set up the SNAplus2 configuration to include emulator [...]

282 Chapter 11 Managing SNAplus2 Clients Managing Win16 Clients Specify the time in seconds for which the TCP/IP connection from the client to a server should be kept active while no applications on the client are using SNAplus2 resources . F or more information, see “LAN Access Timeout”. The valid range is 0 – 65535 . The minimum timeout is [...]

Chapter 11 283 Managing SNAplus2 Clients Managing Win16 Clients [Servers] The [Servers] section of the file contains information about SNAplus2 servers that the client can access , as follows: Server1 Enter an asterisk ( * ) or a server name: • T o indicate that the client should attempt to find a server running SNAplus2 by using a UDP broadcas[...]

284 Chapter 11 Managing SNAplus2 Clients Managing Win16 Clients attempts to contact the server specified in Server2 using a directed message. If this fails , it tries the server specified in Server3 , and so on. These server names are optional, but provide a backup mechanism if the broadcast method of locating a server fails or if the server spec[...]

Chapter 11 285 Managing SNAplus2 Clients Managing Win16 Clients This parameter is optional. If it is not specified, the Win16 c lient uses the global domain settings to determine whether exception messages are recorded. (The initial default is that exception messages are recorded.) audit_logging_enabled Set this parameter to one of the following v[...]

286 Chapter 11 Managing SNAplus2 Clients Managing Win16 Clients T o log error and audit messages to a single file, specify the same file name for both this parameter and the backup_audit_file parameter . error_file_wrap_size The maximum size of the log file specified by error_file . When a message written to the file causes the file size t[...]

Chapter 11 287 Managing SNAplus2 Clients Managing Win16 Clients clears the log file . This means that the maximum amount of disk space taken up by audit log files is approximately twice the value of the audit_file_wrap_size parameter . This parameter is optional. If it is not specified, the default is 10000 (bytes). If you are logging error and[...]

288 Chapter 11 Managing SNAplus2 Clients Managing Win16 Clients either be from the set_global_log_type command, or from a set_log_type command issued to that server to override the default. succinct_audits Specifies whether to use succinct logging or verbose logging in the audit log file. The permitted values and their meanings are the same as fo[...]

Chapter 11 289 Managing SNAplus2 Clients Managing Win16 Clients This parameter is optional. If it is not specified, the default is 100000 (bytes). truncation_length The maximum length, in bytes , of the information written to the trace file for each message. If a message is longer than this , SNAplus2 writes only the start of the message to the t[...]

290 Chapter 11 Managing SNAplus2 Clients Managing Win16 Clients T o trace CSV API 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 CSV messages are traced. rui T o trace LU A RUI messages, s[...]

Chapter 11 291 Managing SNAplus2 Clients Managing Win16 Clients The full path name of the trace file, or of the first trace file if tracing is to two files (see the description of the file2 parameter). This parameter is required if you want to enable message tracing; you also need to set the fmi parameter . file2 The full path name of the sec[...]

292 Chapter 11 Managing SNAplus2 Clients Managing Win16 Clients T o 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 [CS_tracing] section of the file specifies options for client/server tracing (tracing on messages between the clien[...]

Chapter 11 293 Managing SNAplus2 Clients Managing Win16 Clients T o trace internal messages relating to client/server topology , set this parameter to YES ; otherwise, set it to NO . This parameter is optional. If it is not specified, the default is NO . datagram T o trace datagram messages, set this parameter to YES ; otherwise, set it to NO . Th[...]

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 tra[...]

Chapter 11 295 Managing SNAplus2 Clients Managing HP-UX Clients Managing HP-UX Clients For UNIX Client information for a client running on a HP-UX system is stored in the sna_clnt.net file, whic h is created when you install the SNAplus2 software on the c lient. That file must be present before you can enable SNAplus2 on the client. Enabling SNAp[...]

296 Chapter 11 Managing SNAplus2 Clients Managing HP-UX Clients HP-UX Client Network Data F ile (sna_clnt.net) The sna_clnt.net file defines the SNAplus2 facilities available on a client computer running on a HP-UX system, and the servers the client can access . F or information about the equivalent file on a Windows client, see Chapter 11, “M[...]

Chapter 11 297 Managing SNAplus2 Clients Managing HP-UX Clients that issue the Accept_Conversation or Accept_Incoming verbs). In this case, you ma y also need to define the TP on this client. F or more information, see “Defining TPs”. Specify invoked_tps = NO if this client is not used to run invoked TPs . This line is optional; if it is not [...]

298 Chapter 11 Managing SNAplus2 Clients Managing HP-UX Clients before beginning or restarting the attempt to contact a server . If the client has lost contact with the server , SNAplus2 does not wait for the full timeout period, but retries after a random period between 5 seconds and the specified timeout; this is to avoid bursts of network traf?[...]

Chapter 11 299 Managing SNAplus2 Clients Managing HP-UX Clients received no response, the c lient attempts to contact the first server listed using a directed message. If this fails , the client tries the second server listed, and so on. If the * line (to indicate the use of UDP broadcasts) is not included, at least one server name must be speci?[...]

300 Chapter 11 Managing SNAplus2 Clients Managing HP-UX Clients[...]

301 A Configuration Planning W orksheets[...]

302 Appendix A Configuration Planning W orksheets Overview Overview This appendix provides worksheets for configuring specific functions of SNAplus2. The worksheets summarize the basic configuration parameters needed to enable each function; for information about advanced configuration parameters, see the appropriate section in the body of thi[...]

Appendix A 303 Configuration Planning W orksheets Node W orksheets Node W orksheets Complete only one of the following worksheets: • “ APPN End Node” • “LEN Node” APPN End Node Complete this worksheet if the local node is an APPN end node (a node that can use dynamic routing information but does not provide routing services for other n[...]

304 Appendix A Configuration Planning W orksheets Node W orksheets LEN Node Complete this worksheet if the local node is a LEN node (a node that does not support APPN functions or a standalone system that communicates only with a host computer). Client/Server Configuration: Not required for a standalone node. Configuration server? Should the nod[...]

Appendix A 305 Configuration Planning W orksheets Node W orksheets Client/Server Configuration: 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 W orksheets”. Mot[...]

306 Appendix A Configuration Planning W orksheets Connectivity W orksheets Connectivity W orksheets F or each link protocol used to communicate with another node, complete one of the following worksheets . If necessary , you can configure more than one link station on a port. • “SDLC” • “T oken Ring” • “Ethernet” • “FDDI” [...]

Appendix A 307 Configuration Planning W orksheets Connectivity W orksheets Link role Negotiable Primary Primary multi-drop Secondary F or switched incoming or leased line: P oll address Only for nonprimary , switc hed incoming ports On a VTAM host, the poll address is configured as the ADDR= parameter in the VTAM PU definition. On an AS/400 syst[...]

308 Appendix A Configuration Planning W orksheets Connectivity W orksheets Activation By administrator On node startup On demand LU traffic Any Independent only Dependent only Independent LU traffic Remote node NETNAME . CPNAME (each 1–8 type A EBCDIC characters; optional) If the remote system is a VTAM host, you can find the network name (th[...]

Appendix A 309 Configuration Planning W orksheets Connectivity W orksheets Downstream PU name 1–8 type A EBCDIC characters Upstream DLUS name NETNAME . LUNAME (each 1–8 type A EBCDIC characters) Contact information P oll address F or switched incoming ports , only configured on the port. 2 hexadecimal digits: • C1 for point-to-point • 0xF[...]

310 Appendix A Configuration Planning W orksheets Connectivity W orksheets T oken Ring Complete this worksheet to support connectivity using the token ring link protocol. Motif Field V alid Entry/Notes Y our Implementation V alue T oken Ring SAP Dialog SNA port name Up to 8 characters T oken ring card number 0 to number_of_cards_minus_1 Local SAP [...]

Appendix A 311 Configuration Planning W orksheets Connectivity W orksheets Remote node NETNAME . CPNAME (each 1–8 type A EBCDIC characters; optional) If the remote system is a VTAM host, you can find the network name (the first eight characters of the fully qualified name) in the NETID parameter of the VTAM Start command. The last eight chara[...]

312 Appendix A Configuration Planning W orksheets Connectivity W orksheets Ethernet Complete this worksheet to support connectivity using the Ethernet link protocol. Contact information MAC address Hexadecimal digits If the remote end of this link is a VTAM host, you can find its MAC address in the MACADDR= parameter of the VTAM P ort definition[...]

Appendix A 313 Configuration Planning W orksheets Connectivity W orksheets Motif Field V alid Entry/Notes Y our Implementation V alue Ethernet SAP Dialog SNA port name Up to 8 characters Ethernet 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 Sel[...]

314 Appendix A Configuration Planning W orksheets Connectivity W orksheets Remote node NETNAME . CPNAME (each 1–8 type A EBCDIC characters; optional) If the remote system is a VTAM host, you can find the network name (the first eight characters of the fully qualified name) in the NETID parameter of the VTAM Start command. The last eight chara[...]

Appendix A 315 Configuration Planning W orksheets Connectivity W orksheets FDDI Complete this worksheet to support connectivity using the FDDI link protocol. Contact information MAC address Hexadecimal digits If the remote end of this link is a VTAM host, you can find its MAC address in the MACADDR= parameter of the VTAM P ort definition. If you[...]

316 Appendix A Configuration Planning W orksheets Connectivity W orksheets Motif Field V alid Entry/Notes Y our Implementation V alue FDDI SAP Dialog SNA port name Up to 8 characters FDDI 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 n[...]

Appendix A 317 Configuration Planning W orksheets Connectivity W orksheets Remote node NETNAME . CPNAME (each 1–8 type A EBCDIC characters; optional) If the remote system is a VTAM host, you can find the network name (the first eight characters of the fully qualified name) in the NETID parameter of the VTAM Start command. The last eight chara[...]

318 Appendix A Configuration Planning W orksheets Connectivity W orksheets QLLC (X.25) Complete this worksheet to support connectivity using the QLLC (X.25) link protocol. Contact information MAC address Hexadecimal digits If the remote end of this link is a VTAM host, you can find its MAC address in the MACADDR= parameter of the VTAM P ort defi[...]

Appendix A 319 Configuration Planning W orksheets Connectivity W orksheets Motif Field V alid Entry/Notes Y our Implementation V alue QLLC P ort Dialog SNA port name Up to 8 characters X.25 card number 0 to number_of_cards_minus_1 P ort number 0 to number_of_ports_on_card_minus_1 Initially active Select if needed Match incoming X.25 address Local [...]

320 Appendix A Configuration Planning W orksheets Connectivity W orksheets Remote node NETNAME . CPNAME (each 1–8 type A EBCDIC characters; optional) If the remote system is a VTAM host, you can find the network name (the first eight characters of the fully qualified name) in the NETID parameter of the VTAM Start command. The last eight chara[...]

Appendix A 321 Configuration Planning W orksheets Connectivity W orksheets Circuit type Permanent virtual circuit Switched virtual circuit Channel ID 1 – 4096 (only for PVC) Remote X.25 address Hexadecimal digits (only for SVC) Adapter/port number [ m p ] n , where m is an optional adapter number and n is the port number Subnet ID Up to 4 charac[...]

322 Appendix A Configuration Planning W orksheets Passthr ough Ser vices W orksheets P assthrough Services W orksheets Complete worksheets for any of the passthrough services described in the following sections , if the service is to be supported by the local node: • “DLUR” • “TN Server” DLUR Complete this worksheet to support DLUR on [...]

Appendix A 323 Configuration Planning W orksheets Passthr ough Ser vices W orksheets PU Concentration Complete this worksheet if the local node is to support PU concentration. Initially active Select if needed Reactivate PU after failure Select if needed Local LU and Application Configuration: See “User Application Support W orksheets”. Y ou [...]

324 Appendix A Configuration Planning W orksheets Passthr ough Ser vices W orksheets TN Server Complete this worksheet if the local node is to support TN3270 clients . Downstream PU name Type A EBCDIC string LU numbers 1-255 (for a range, supply first and last numbers) Upstream LU name Type A EBCDIC string (for LU name) or type AE EBCDIC string ([...]

Appendix A 325 Configuration Planning W orksheets Passthr ough Ser vices W orksheets TN3270 client address Specify one of the following: • Default record (any TN3270 client) • TCP/IP address (dotted decimal address of client) • TCP/IP name or alias Support TN3270E Select to support TN3270E (in addition to TN3270 and TN3287) TN3270 port and L[...]

326 Appendix A Configuration Planning W orksheets User Application Support W orksheets User Application Support W orksheets Complete the following worksheets if the corresponding user -level applications are to be supported by the local node: • “ APPC” • “CPI-C” • “5250” • “3270” • “RJE” • “LU A ” APPC Complete [...]

Appendix A 327 Configuration Planning W orksheets User Application Support W orksheets LU number 1 – 255 This value must match the LOCADDR parameter in the VTAM/NCP LU resource definition statement. Member of default pool Select if needed (only for dependent LU) Local LU parameters Support syncpoint Select if needed Disable password substitutio[...]

328 Appendix A Configuration Planning W orksheets User Application Support W orksheets Location NETNAME . CPNAME (each 1–8 type A EBCDIC characters) LS Routing Dialog: Only required if partner LU is located by link station. LU name 1–8 type A EBCDIC characters LS name Up to 8 characters P artner LU name ( NETNAME . LUNAME (each 1–8 type A EB[...]

Appendix A 329 Configuration Planning W orksheets User Application Support W orksheets Maximum RU size Recommended upper limit is 1024 . Session Security Dialog: Only required if session security is required for sessions between a specific local and partner LU . Local LU 1–8 type A EBCDIC characters P artner LU 1–8 type A EBCDIC characters P [...]

330 Appendix A Configuration Planning W orksheets User Application Support W orksheets CPI-C Complete this worksheet if the local node is to support CPI-C applications . TP name User application: up to 64 ASCII characters Service TP: up to 8 hexadecimal digits Conversation level security required Select to require a valid user name and password on[...]

Appendix A 331 Configuration Planning W orksheets User Application Support W orksheets 5250 Complete this worksheet if the local node is to support 5250 communications . Motif Field V alid Entry/Notes Y our Implementation V alue Node Configuration: See “Node W orksheets”. Connectivity Configuration: See “Connectivity W orksheets”. APPC C[...]

332 Appendix A Configuration Planning W orksheets User Application Support W orksheets 3270 Complete this worksheet if the local node is to support 3270 communications . Motif Field V alid Entry/Notes Y our Implementation V alue Node Configuration: See “Node W orksheets”. Connectivity Configuration: See “Connectivity W orksheets” (confi[...]

Appendix A 333 Configuration Planning W orksheets User Application Support W orksheets 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 3270 model 2 (80x24) display 3270 model 3 (80x32) display 3270 model 4 (80x43) display 3270 [...]

334 Appendix A Configuration Planning W orksheets User Application Support W orksheets RJE Complete this worksheet if the local node is to support RJE communications with a host. 3270 permissions Select any of the following: • Session Limit (indicate number of sessions) • View RTM data • Change LU • Send alerts 3270 Session Dialog Single s[...]

Appendix A 335 Configuration Planning W orksheets User Application Support W orksheets Motif Field V alid Entry/Notes Y our Implementation V alue Node Configuration: See “Node W orksheets”. Connectivity Configuration: See “Connectivity W orksheets” (configure for dependent traffic). LU Type 0–3 Dialog LU name 1–8 type A EBCDIC char[...]

336 Appendix A Configuration Planning W orksheets User Application Support W orksheets LU A Complete this worksheet if the local node is to support LU A applications . Motif Field V alid Entry/Notes Y our Implementation V alue Node Configuration: See “Node W orksheets”. Connectivity Configuration: See “Connectivity W orksheets” (configu[...]

337 B APPN Network Management Using the Simple Network Management Protocol[...]

338 Appendix B APPN Network Management Using the Simple 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.[...]

Appendix B 339 APPN Network Management Using the Simple Network Management Protocol Introduction to SNMP Introduction to SNMP The Simple Network Management Protocol (SNMP) is an industry-standard management protocol, originally designed for managing TCP/IP networks . SNMP is described by a series of Request for Comments (RFCs) that specifies and s[...]

340 Appendix B APPN Network Management Using the Simple Network Management Protocol Introduction to SNMP Figure 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 mana[...]

Appendix B 341 APPN Network Management Using the Simple Network Management Protocol SNAplus2 APPN SNMP Subagent SNAplus2 APPN SNMP Subagent SNAplus2 implements an SNMP subagent to provide support for the APPN MIB defined in RFC 1593. The subagent uses the services of the SNMPD daemon, which communicates with a management application using TCP/IP .[...]

342 Appendix B APPN Network Management Using the Simple Network Management Protocol APPN Management Information Base (MIB) APPN Management Information Base (MIB) The APPN MIB is defined by informational RFC 1593. The ASN .1 representation of the APPN MIB is located in the file named /etc/opt/sna/mib/appn.my , which also provides a more detailed d[...]

343 C Configuring an Invokable TP Using snaptpinstall[...]

344 Appendix C Configuring an Invokab le TP Using snaptpinstall Overview Overview The snaptpinstall utility is a command-line application that enables a user or the writer of a TP installation program to define an invokable TP . Y ou can run snaptpinstall on a server or client. The syntax of the command is different depending on whether you are d[...]

Appendix C 345 Configuring an Invokab le TP Using snaptpinstall File Format for snaptpinstall F ile F ormat for snaptpinstall The file that supplies configuration information for an invokable TP is an ASCII text file that can be modified using any standard text editor . Each entry in the file has the following format: [ TPname ] PATH = full_p[...]

346 Appendix C Configuring an Invokab le TP Using snaptpinstall File Format for snaptpinstall on the RECEIVE_ALLOCA TE verb when it starts up, to enable SNAplus2 to route the incoming Attach to the correct TP . This name must be enclosed within square brackets . The name can be specified as an ASCII string, enc losed in double quotation marks (fo[...]

Appendix C 347 Configuring an Invokab le TP Using snaptpinstall File Format for snaptpinstall The TP is a queued TP . Any incoming Allocate requests arriving while the TP is running are queued until the TP issues another Receive_Allocate, or until it finishes running and can be restarted. An incoming Allocate request is routed to this TP only if [...]

348 Appendix C Configuring an Invokab le TP Using snaptpinstall File Format for snaptpinstall If you use NON-QUEUED , more than one copy of the TP can be running at a time. If the TP writes to files on the Windows computer , you need to ensure that different copies of the TP do not overwrite each other's files . T o do this , use one of the[...]

Appendix C 349 Configuring an Invokab le TP Using snaptpinstall File Format for snaptpinstall TP (unless the application overrides it by specifying a full path). If the application specifies a file name without a path, SNAplus2 searches for the file in this home directory; if the application specifies a file name with a relative path, SNAplus[...]

350 Appendix C Configuring an Invokab le TP Using snaptpinstall File Format for snaptpinstall If the LU alias is specified for an automatically started TP , the TP must use the extended form of the RECEIVE_ALLOCA TE verb and specify this LU alias as a parameter to the verb. This enables SNAplus2 to route the incoming Attach to the correct TP . F [...]

Appendix C 351 Configuring an Invokab le TP Using snaptpinstall File Format for snaptpinstall The application is displayed at its normal size and position. NOACTIVATE The application is displayed at its normal size and position, and the focus remains on the previously active window . This application's window does not become the active window[...]

352 Appendix C Configuring an Invokab le TP Using snaptpinstall File Format for snaptpinstall • White space (space characters and tab characters) at the start or end of a line, or before or after the = character , is ignored (except in the string environment_variable = value for the ENV parameter). • Each TP definition begins with the line id[...]

353 D Using SNAplus2 in a High A vailability Environment[...]

354 Appendix D Using SNAplus2 in a High A vailability En vironment Overview Overview This appendix describes the high availability features of SNAplus2 and how it works with the HP MC/ServiceGuard product.[...]

Appendix D 355 Using SNAplus2 in a High A vailability En vironment What is High A vailability? What is High A vailability? High availability is a term used to describe an environment in which mission critical applications are protected from severe impact of various failures . These failures might include entire computer system failures , network fa[...]

356 Appendix D Using SNAplus2 in a High A vailability En vironment What is High A vailability? Figure D-1 SNAplus2 client/server network In this environment, applications run on client systems (HP9000s or PCs) and access the IBM mainframe through an HP9000 S800 server . The application might be SNAplus2 3270 or a custom application like an APPC tra[...]

Appendix D 357 Using SNAplus2 in a High A vailability En vironment What is High A vailability? • The LAN networking software on the server system • The SNAplus2 Link software on the server system • The operating system on the server system • Disk drives attached to the server system • The SNA network adapter card on the server system • [...]

358 Appendix D Using SNAplus2 in a High A vailability En vironment SNAplus2 High A vailability Features SNAplus2 High A vailability F eatures SNAplus2 already has high availability features built in, namely , LU pools , and client/server configurations. LU P ools for 3270, 3179G, and LUA One of the most significant fault-tolerant feature s of SNA[...]

Appendix D 359 Using SNAplus2 in a High A vailability En vironment SNAplus2 High A vailability Features Figure D-2 LU P ools The LU pool gives you the ability to add a logical layer on top of the two servers. Clients access the SNA network by referring to the LU pool name, not to a specific LU in the pool. W ithin the SNAplus2 configuration above[...]

360 Appendix D Using SNAplus2 in a High A vailability En vironment SNAplus2 High A vailability Features for high availability environments in that applications running on client systems can access ports on multiple servers . By providing applications with multiple paths to the remote SNA system, the client/server configuration greatly reduces the [...]

Appendix D 361 Using SNAplus2 in a High A vailability En vironment SNAplus2 High A vailability Features Figure D-3 Applications using multiple servers The second wa y an application can use multiple servers is to have one SNAplus2 configuration that is used by multiple HP 9000 systems. F or example, suppose two server systems are connected to an S[...]

362 Appendix D Using SNAplus2 in a High A vailability En vironment SNAplus2 High A vailability Features T able D-1 NO TE The above example will be used throughout this appendix to explain many different aspects of high availability systems . In this example, nine LUs are used by APPC production applications that run on the client systems . These LU[...]

Appendix D 363 Using SNAplus2 in a High A vailability En vironment SNAplus2 High A vailability Features Figure D-4 SNAplus2 on Primary and Backup Servers Whenever the primary server is about to become unavailable (during preventative maintenance periods, for example), the SNA connectivity is switched to the backup server through the following steps[...]

364 Appendix D Using SNAplus2 in a High A vailability En vironment SNAplus2 High A vailability Features At this point, the backup server has completely taken over the primary server and is providing the HALU01 ... HALU09 LUs for the production applications . The less important development LUs are no longer available . The key point is that the prod[...]

Appendix D 365 Using SNAplus2 in a High A vailability En vironment Using SNAplus2 with MC/ServiceGuard Using SNAplus2 with MC/ServiceGuard MC/ServiceGuard (product number B3935AA) is a specialized facility for protecting mission critical applications from hardware and softw are failures by allowing you to organize groups of servers into clusters an[...]

366 Appendix D Using SNAplus2 in a High A vailability En vironment Using SNAplus2 with MC/ServiceGuard Some of the reasons that ServiceGuard works well with SNAplus2 in a high availability environment are as follows: 1. ServiceGuard is designed for general software resiliency . This means that ServiceGuard packages can easily be built for SNAplus2 [...]

Appendix D 367 Using SNAplus2 in a High A vailability En vironment Using SNAplus2 with MC/ServiceGuard Step 1. List all of the mission critical applications that use SNAplus2 for SNA network connectivity . Step 2. Diagram your network topology so that you know the location of the servers that are part of the ServiceGuard cluster and any other syste[...]

368 Appendix D Using SNAplus2 in a High A vailability En vironment Using SNAplus2 with MC/ServiceGuard Assuming the applications attempt to activate a new LU-LU session when they lose the LU-LU session they were using , you simply need to wait for the migration to occur . The applications require no restart ing because they run on client systems . [...]

Appendix D 369 Using SNAplus2 in a High A vailability En vironment Using SNAplus2 with MC/ServiceGuard T able D-2 Suggestions for Defining the SNAplus2 P ackage Specifying the Service Command The Service Command starts a Service, whic h is an HP-UX process that ServiceGuard monitors. The termination of the process indicates to ServiceGuard that th[...]

370 Appendix D Using SNAplus2 in a High A vailability En vironment Using SNAplus2 with MC/ServiceGuard snapadmin start_ls, ls_name=HALS LS details are: Activation state = active P ort name = HAPORT In this example, the state of the LS is active , which means the server is currently providing SNA network connectivity to a remote SNA system. The snap[...]

Appendix D 371 Using SNAplus2 in a High A vailability En vironment Using SNAplus2 with MC/ServiceGuard and become active. If this parameter is not specified, 10 retries will be allowed. Any number between 0 and 600 (inclusive) can be specified. The return code of snapmon is 0 if the LS was active at some time while snapmon was running . Otherwise[...]

372 Appendix D Using SNAplus2 in a High A vailability En vironment Using SNAplus2 with MC/ServiceGuard capability . F ollowing are four different ways in which applications can gain SNA network connectivity through an SNAplus2 server using a LAN . SNAplus2 Client/Server LAN Connections As described above, SNAplus2 can use either a standalone or a c[...]

Appendix D 373 Using SNAplus2 in a High A vailability En vironment Using SNAplus2 with MC/ServiceGuard T o protect against a failure of a server’s LAN adapter , you can configure a standby LAN adapter for the server . Y ou can configure ServiceGuard to assign the primary LAN adapter’s IP address to the standby LAN adapter in the event of a fa[...]

374 Appendix D Using SNAplus2 in a High A vailability En vironment Using SNAplus2 with MC/ServiceGuard TN Server LAN Connections One application that can take advantage of both local LAN failover and floating IP addresses in an SNAplus2 network is TN3270. When you run TN3270, you specify a particular IP address to contact. When an SNAplus2 server [...]

Appendix D 375 Using SNAplus2 in a High A vailability En vironment Using SNAplus2 with MC/ServiceGuard Using the LAN to Access Standalone Servers When SNAplus2 is used in a standalone configuration, the LAN can still be used to access the server system. Although you do not run applications on SNAplus2 client systems , you access the applications r[...]

376 Appendix D Using SNAplus2 in a High A vailability En vironment Using SNAplus2 with MC/ServiceGuard Customizing the SNAplus2 P ackage Control Script The last step in defining an SNAplus2 package is customizing the P ackage Control Script to instruct ServiceGuard how to start and stop the SNAplus2 software associated with the pac kage. The examp[...]

Appendix D 377 Using SNAplus2 in a High A vailability En vironment Using SNAplus2 with MC/ServiceGuard the SNAplus2 software . Insert this command in the customer_defined_halt_cmds section of the P ackage Control Script as follows: function customer_defined_halt_cmds { snap stop } After ServiceGuard stops the SNAplus2 package on the primary server [...]

378 Appendix D Using SNAplus2 in a High A vailability En vironment Using SNAplus2 with MC/ServiceGuard start the node on the backup server until SNAplus2 recognizes that the primary server is down. This time period can be lengthy (up to 30 minutes). Therefore, if the bac kup server is running SNAplus2, it is safest to completely stop the SNAplus2 s[...]

Appendix D 379 Using SNAplus2 in a High A vailability En vironment Using SNAplus2 with MC/ServiceGuard Figure D-11 Client/Server configuration using T oken Ring LAN DLC QLLC If you are using QLLC links , both servers must have the same name configured in the X.25 interface card configuration file. This name is also used in the Interface Card ?[...]

380 Appendix D Using SNAplus2 in a High A vailability En vironment Using SNAplus2 with MC/ServiceGuard Interface card. . . . . . . . . . [card0.......] The backup server should also be configured so that its X.25 card uses the name card0 . That way , when ServiceGuard attempts to start the same configuration on the backup server , the card can be[...]

Appendix D 381 Using SNAplus2 in a High A vailability En vironment Using SNAplus2 with MC/ServiceGuard T o create a network where multiple HP systems can share the same SDLC line, use a multidrop modem to connect the HP servers to the single SDLC line. The PSI adapter cards that support the SDLC protocol must have the same card numbers , as config[...]

382 Appendix D Using SNAplus2 in a High A vailability En vironment Adv anced Configuration T echniques Advanced Configuration T echniques The following advanced configuration techniques are useful in networks where there are multiple DLC (Data Link Control) types connecting one or more HP 9000 server s to the remote SNA system. F or example, a s[...]

Appendix D 383 Using SNAplus2 in a High A vailability En vironment Adv anced Configuration T echniques to add more intelligence to the Service in the P ackage Control Script that will allow you to attempt local recovery before informing ServiceGuard that a remote failover is necessary . Writing Y our Own SNAplus2 Service Script By customizing the [...]

384 Appendix D Using SNAplus2 in a High A vailability En vironment Adv anced Configuration T echniques commands in the script. The ability to add other SNAplus2 commands gives you a wa y to specify local recovery actions before allowing the script to end. F or example, suppose you w ant to monitor a T oken Ring LS called TRLS . If it fails , you ?[...]

Appendix D 385 Using SNAplus2 in a High A vailability En vironment Adv anced Configuration T echniques # # Attempt to start the LS. If the LS is configured to # be initially active, the command will have no effect. # snapadmin start_ls, ls_name=TRLS # # Monitor the primary LS again to see if local restart # was successful. Only allow 30 seconds fo[...]

386 Appendix D Using SNAplus2 in a High A vailability En vironment Adv anced Configuration T echniques quits trying to perform a local restart of the T oken Ring LS , and attempts to start the SDLC LS . When that LS fails, the script exits , to allow ServiceGuard to perform a remote failover . Notice also that this solution does not provide the be[...]

Index 387 Numerics 3270 emulation group additional configuration needs , 216 emulation group parameters 3270 permissions , 215 Group Name , 214 Sessions , 215 Style File , 214 Style file access , 215 emulation program description , 79 style file , 104 emulation user additional configuration needs , 216 emulation user parameters 3270 permissions[...]

388 Index port facility , 58 network example , 44 network node , 30 , 45 node , 75 node types , 43 route selection , 56 SNMP subagent , 341 APPN support parameter , 137 Arguments parameter , 191 AS/400 (Application System/ 400) , 43 ASCII Administration Program , 129 Assigned LUs parameter , 173 , 221 audit log file , 105 Auto-activated sessions p[...]

Index 389 additional configuration needs , 153 APPN , 60 configuration , 147 parameters , 148 configuration methods , 147 description , 43 , 92 , 93 topology information , 54 connectivity configuration overview , 143 description , 30 direct , 58 resources , 91 worksheets , 302 , 306 control data , 37 control point (CP) , 35 Control point alias [...]

390 Index additional configuration needs , 166 configuration , 233 description , 64 , 77 worksheet , 322 DLUR PU configuration methods , 164 parameters DLUS Name , 165 Initially active , 165 PU ID , 165 PU Name , 165 Reactivate PU after failure , 166 DLUS description , 64 with DLUR , 77 DLUS Name parameter , 165 Document Content Architecture (DC[...]

Index 391 HLLAPI , 32 , 83 host , 28 host communication example configuration , 69 Host LS/DLUR PU parameter , 170 , 179 host node , 27 HPR description , 53 HP-UX client * , 298 broadcast_attempt_count , 297 domain name , 296 lan_access_timeout , 297 server names , 299 server_lost_timeout , 298 HP-UX commands , 236 I IMS/VS (Information Management[...]

392 Index description , 16 , 33 independent , 94 pool , 95 types , 33 , 94 LU 0 description , 34 LU 1 , 34 LU 2 , 34 LU 3 , 33 LU 6.2 configuration , 176 description , 33 LU alias parameter , 179 , 190 LU in pool parameter , 171 LU name parameter , 169 , 179 LU number parameter , 170 , 179 , 232 LU pool additional configuration needs , 173 confi[...]

Index 393 Domain window , 117 help , 127 invoking , 115 Node window , 119 resource items , 122 resource windows , 116 tool bar buttons , 123 using , 115 MS (Management Services) , 45 , 84 Multiple instances supported parameter , 190 multiple servers on a LAN , 87 multiple sessions , 38 multiple sessions parameter , 217 N Name parameter CPI-C symbol[...]

394 Index path for SNAplus2 executable programs , 111 peer network , 26 node types , 30 route selection , 41 peer server , 87 peer -to-peer communications See APPN , 25 peripheral node , 27 physical unit (PU) See PU , 32 physical unit control point (PUCP) , 35 planning worksheets , 109 P oll address parameter , 157 P ool name parameter , 171 , 217 [...]

Index 395 configuration methods , 220 parameters Assigned LUs , 221 Run on computer , 220 UNIX group name , 221 UNIX user name , 221 W orkstation name , 220 style file , 104 route , 41 Route incoming Allocates to running TP parameter , 190 route selection , 41 , 53 , 56 RTP description , 53 endpoints , 58 RU (request unit) , 198 Run on computer p[...]

396 Index start command , 112 stop command , 114 STREAMS components , 74 style file 3270 emulation program , 104 RJE workstation , 104 Style file access parameter , 215 Style File parameter , 214 subarea network description , 26 example , 28 node types , 27 route selection , 41 subarea node , 27 subarea SNA , 25 succinct logging , 105 Support TN3[...]

Index 397 transport network , 42 troubleshooting , 105 TRS (topology and routing services) , 53 type 2.0 node , 27 type 2.1 node , 27 type 4 node , 27 type 5 node , 27 U UCF access to files , 247 canceling a command , 246 command syntax , 238 , 243 daemon program , 243 description , 102 , 236 output , 245 permissions , 243 permitted commands , 244[...]

398 Index Win32 client 3270 message tracing information , 270 admin_msg , 272 all_api , 268 API tracing information , 267 appc , 268 APPCLLU , 273 APPCTPN , 273 audit_file , 265 audit_file_wrap_size , 265 audit_logging_enabled , 263 backup_audit_file , 265 backup_error_file , 264 broadcast_attempt_count , 260 client/server tracing information ,[...]