The information in this document is subject to change without notice.
Hewlett-Packard makes no warranty of any kind with regard to this
manual, including, but not limited to, the implied warranties of
merchantability and fitness for a particular purpose. Hewlett-Packard
shall not be held liable for errors contained herein or direct, indirect,
special, incidental or consequential damages in connection with the
furnishing, performance, or use of this material.
Warranty. A copy of the specific warranty terms applicable to your
Hewlett- Packard product and replacement parts can be obtained from
your local Sales and Service Office.
Restricted Rights Legend. Use, duplication or disclosure by the U.S.
Government is subject to restrictions as set forth in subparagraph (c) (1)
(ii) of the Rights in Technical Data and Computer Software clause at
DFARS 252.227-7013 for DOD agencies, and subparagraphs (c) (1) and
(c) (2) of the Commercial Computer Software Restricted Rights clause at
FAR 52.227-19 for other agencies.
HEWLETT-PACKARD COMPANY
3000 Hanover Street
Palo Alto, California 94304 U.S.A.
Use of this manual and flexible disk(s) or tape cartridge(s) supplied for
this pack is restricted to this product only. Additional copies of the
programs may be made for security and back-up purposes only. Resale of
the programs in their present form or with alterations, is expressly
prohibited.
Writing Your Own SNAplus2 Service Script . . . . . . . . . . . . . . . . . . .383
13
Contents
14
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. For a list of books that provide this information, see
“Related Publications”.
About This Book
This guide explains how to enable, configure, and manage SNAplus2.
Organization of This Book
This book is organized as follows:
Chapter 1, “SNA Terms and Concepts.”
Provides an overview of SNA and APPN (Advanced
Peer-to-Peer Networking) concepts.
Chapter 2, “Introduction to SNAplus2.”
Provides an overview of SNAplus2, including its
components, the resources it uses, and the user
applications that are supported by or provided with
SNAplus2.
Chapter 3, “Administering SNAplus2.”
Explains how to prepare for SNAplus2 configuration,
enable and disable the SNAplus2 software on a server,
and how to use the Motif and the command-line
administration programs.
Chapter 4, “Basic Configuration Tasks.”
Explains how to perform basic configuration tasks for
SNAplus2 servers, including configuring client/server
operations, configuring the SNA node, and configuring
message logging for SNAplus2.
Chapter 5, “Defining Connectivity Components.”
15
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, “Configuring User Applications.”
Explains how to configure user applications.
Chapter 9, “Configuring Passthrough Services.”
Explains how to configure passthrough services, which
support communication between host systems and
local systems that are not directly connected.
Chapter 10, “Managing SNAplus2 from NetView.”
Explains how to use the SNAplus2 remote command
facility (RCF) to manage SNAplus2 and run commands
on SNAplus2 nodes from a host running NetView.
Chapter 11, “Managing SNAplus2 Clients.”
Explains how to configure and manage SNAplus2
clients.
Appendix A, “Configuration Planning Worksheets.”
Provides configuration worksheets for SNAplus2.
Appendix B, “APPN Network Management Using the Simple Network
Management Protocol.”
Provides information about the support provided by
SNAplus2 for the Simple Network Management
Protocol (SNMP). This appendix also provides a list of
the APPN Management Information Base (MIB)
databases that SNAplus2 supports.
Appendix C, “Configuring an Invokable TP Using snaptpinstall.”
Provides information about the snappinstall utility and
how it can be used to define an invokable TP.
Appendix D, “Using SNAplus2 in a High Availability Environment.”
Describes the high availability features of SNAplus2
and how it works with the HP MC/ServiceGuard
product.
16
Typographic Conventions
The typographic styles used in this document are shown in Table 1.
Table 1Typographic Conventions
Special ElementSample of Typography
Emphasized wordsback up files before deleting
Document titleHP-UX SNAplus2 Administration Guide
File or path name/usr/spool/uucp/myfile.bkp
Directory name/usr/spool/uucp/
Program or applicationsnapadmin
Parameter or Motif fieldopcode; LU name
Literal value or selection that the user
can enter (including default values)
Motif buttonStatus
Motif menuServices
Motif menu itemConfigure node parameters
User input0p1
Computer outputCLOSE
Command or HP-UX utilitydefine_node; cd
General reference to all commands of a
particular type
Option or flag-i
Variable representing a supplied valuefilename; LU_name; user_ID
Return value0; −1
3270 keyENTER
Keyboard keysCtrl+D; Enter
255; On node startup
query_* (indicates all of the
administration commands that query
details of a resource)
For UNIXThis heading is used to indicate the start of a section of text that applies
only to the HP-UX operating system.
For WindowsThis heading is used to indicate the start of a section of text that applies
to the Win32 client, which runs on the Microsoft NT (Version 3.51 or
later) and Windows 95 operating systems.
SNAplus2 also provides a Win16 client that runs on Microsoft Windows
3.1 and Windows for Workgroups 3.11. The Win16 client is very similar
to the Win32 client, except that you enable and configure the client
software differently.
The APIs for the Win32 and Win16 clients are fully compatible with
Microsoft SNA Server and Windows Open System Architecture (WOSA),
enabling applications written for SNA Server to run unchanged on the
Win32 and Win16 clients.
End of SectionThis heading indicates the end of the operating system specific text. The
information following this heading applies regardless of the operating
system.
SNAplus2 Publications
SNAplus2 publications include user guides, administrator guides, and
programmer guides. The following sections describe the contents of each
book.
Publications for Users
SNAplus2 provides the following user guides:
18
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 remapping
your keyboard and displaying colors
• Interpreting status-line information
• Sending NetView user alerts
• Viewing response times
HP-UX SNAplus2 RJE Users Guide
Explains how to start and stop the RJE workstation,
queue a job for submission to the host, list the queued
jobs, cancel a queued job, and send commands to the
host's job entry subsystem (JES) console.
HP-UX SNAplus2 and TN3270 Glossary
Provides a comprehensive list of terms and their
definitions used in the SNAplus2 library.
Publications for Administrators
SNAplus2 provides the following administrator guides:
HP-UX SNAplus2 Installation Guide
Explains how to install the SNAplus2 software and set
up system files.
HP-UX SNAplus2 Upgrade Guide
Provides information about upgrading to the current
version of SNAplus2 from previous versions. It includes
information about converting configuration files,
rebuilding applications that use the SNAplus2
application program interfaces (APIs), and changes in
other SNAplus2 functions.
HP-UX SNAplus2 Administration Guide
19
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 SNAplus2 Administration Command Reference
Explains how to use the SNAplus2 command-line
administration program and shows the syntax of all
SNAplus2 administration commands.
HP-UX SNAplus2 Diagnostics Guide
Explains how to investigate and resolve common
problems and provides an overview of diagnostic tools,
including logging and tracing.
Publications for Programmers
SNAplus2 provides the following programmer guides. Each guide
includes conceptual and detailed reference information.
HP-UX SNAplus2 APPC Programmers Guide
Contains the information you need to write application
programs using Advanced Program-to-Program
Communication (APPC).
HP-UX SNAplus2 CPI-C Programmers Guide
Contains the information you need to write application
programs using Common Programming Interface for
Communications (CPI-C).
Contains the information you need to write application
programs using High-Level Language Application
Program Interface (HLLAPI).
HP-UX SNAplus2 LUA Programmers Guide
Contains the information you need to write
applications using the Conventional LU Application
Programming Interface (LUA).
HP-UX SNAplus2 CSV Programmers Guide
20
Contains the information you need to write application
programs using the Common Service Verbs (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 write
applications using the Node Operator Facility (NOF)
API.
Related Publications
For information about SNA, APPN, or LU 6.2 architecture, refer to the
following IBM documents:
• IBM APPN Architecture and Product Implementations Tutorial,
GG24-3669
• IBM AS/400 Advanced Peer-to-Peer Networking, GG24-3287
• IBM eNetwork Communications Server for OS/2:
• APPC Programming Guide and Reference, SC31-6160
• System Management Programming Reference, SC31-6173
• IBM System/370 Principles of Operation, GA22-7000
• IBM Systems Network Architecture:
• LU 6.2 Reference—Peer Protocols, SC31-6808
• APPN Architecture Reference, SC30-3422.
• Management Services, SC30-3346
• Formats, GA27-3136
• Technical Overview, GC30-3073
21
22
1SNA Terms and Concepts
23
SNA Terms and Concepts
Overview
Overview
This chapter defines Systems Network Architecture (SNA) terms and
concepts that are important to understanding and using SNAplus2. For
information about SNAplus2 and its capabilities, see Chapter 2,
“Introduction to SNAplus2.”
If you are already familiar with SNA and SNAplus2, you can begin with
Chapter 3, “Administering SNAplus2.”
This chapter is divided into the following parts:
• “Systems Network Architecture” provides a definition of SNA.
• “Basic SNA Concepts” explains terms and concepts that apply to any
SNA network.
• “Basic APPN Concepts” explains terms and concepts that apply only
to SNA networks that support Advanced Peer-to-Peer Networking
(APPN).
• “Basic APPN Concepts” introduces terms and concepts that apply to
networks that combine SNA and APPN.
NOTEThis chapter is not intended as a complete reference to SNA concepts.
Detailed information about SNA can be found in the SNA publications
listed in “Related Publications”.
24Chapter 1
SNA Terms and Concepts
Systems Network Architecture
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 software data communication
products. This architecture consists of two kinds of definitions: formats
that define the layout of messages exchanged by network components,
and protocols that define the actions that network components take in
response to messages.
An SNA network is a collection of computers that are linked together and
communicate using SNA.
Originally, SNA was designed to enable communications with a host
computer . Each network or sub-network w as controlled by the host; other
computers communicated directly with the host, but not with each other.
This older , host-controlled style of network is often referred to as subarea
SNA. SNA has since developed to support direct peer-to-peer
communications between computers in the network, without requiring a
host. This newer, peer-level networking is APPN.
Many SNA networks have elements of both subarea and peer-to-peer
networking. As networks migrate from subarea SNA to APPN, an
APPN-capable host may act to control older systems while also acting as
a peer to newer systems. Similarly, a single computer may access both
peer computers (in an APPN network) and an older host; its
communications with the host are controlled by the host, but its
communications with other computers are peer-to-peer and do not
involve the host.
Chapter 125
SNA Terms 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 of functions. This division of
network functions into layers enables network devices to share
information and processing resources without having detailed
information about each device on the network. A user at a workstation
can communicate with another user without knowing anything about the
physical devices on the network or the connections between those
devices.
Network Types
SNA supports the following types of networks:
• A subarea network is a hierarchically organized network consisting of
subarea nodes and peripheral nodes. Subarea nodes, such as hosts
and communication controllers, handle general network routing.
Peripheral nodes, such as terminals, attach to the network without
awareness of general network routing.
• A peer network is a cooperatively organized network consisting of
peer nodes that all participate in general network routing.
• A mixed network is a network that supports both host-controlled
communications and peer communications.
NOTEHP-UX workstations running SNAplus2 can be part of a subarea
network, a peer network, or both.
SNA Nodes
In SNA networks, a node is a system, workstation, or other device—with
associated software components—that implements SNA protocols and
has at least one communication path to another node in the network.
26Chapter 1
SNA Terms 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
describe the roles that nodes play in the network).
Node Types in a Subarea Network
SNA subarea networks support the following node types:
• Subarea nodes control communication and network resources for all
attached nodes. SNA classifies subarea nodes according to their
capabilities and the amount of control they have over other nodes:
• Type 5 nodes provide SNA functions that control network
resources, support transaction programs, support network
operators, and provide end-user services. Because these functions
are often provided by host processors, type 5 nodes are also known
as host nodes. The devices and resources controlled by a type 5
subarea node constitute the domain of that node.
• Type 4 nodes provide SNA functions that route and control the
flow of data in a part of the network. Because these functions are
often provided by communication controllers, type 4 nodes are also
known as communication controller nodes.
• Peripheral nodes serve subordinate roles in subarea networks. For
example, a peripheral node can support 3270 emulation or dependent
LU 6.2 communication. Peripheral nodes are devices such as
distributed processors, cluster controllers, or workstations; they are
also classified into type 2.0 and type 2.1 nodes:
• Type 2.0 nodes are always controlled by a type 4 or 5 node. They
cannot establish communication with other nodes without the
participation of a type 4 or 5 node. Type 2.0 nodes are referred to
as dependent nodes.
• Type 2.1 nodes can act as dependent nodes, but they can also
communicate directly with other type 2.1 nodes.
NOTEHP-UX workstations running SNAplus2 can function as type 2.1 or type
2.0 nodes.
Chapter 127
SNA Terms 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 components:
Host
A host is a mainframe computer compatible with the
original IBM System/370. A host is a type 5 node.
Communication controller
A communication controller, also known as a front-end
processor (FEP), is a separate processor attached to the
host. It manages the host's communications with other
computers.
Communications link
A communications link connects the host site with an
end-user site. The users are usually on a separate site
from the host, so the two sites need to be connected by
a communications link.
Terminal controller
At the remote end of the communications link is a
terminal controller, also known as a cluster controller.
It is responsible for controlling the use of the link, and
routes data to the terminals. The most well-known
IBM terminal controllers are the 3174 and 3274.
Terminals
Users run host applications or submit work to the host
from terminals. The best-known IBM terminal is the
3270. A terminal can be connected through a terminal
controller or directly connected to a communication
controller.
Printers
Printers such as the IBM 3287 can also be attached to
the terminal controller. They can receive output from
the host.
As shown in Figure 1-1, “SNA Subarea Network,” a diagram of a subarea
network looks like an inverted tree.
28Chapter 1
Figure 1-1SNA Subarea Network
SNA Terms and Concepts
Basic SNA Concepts
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 terminals
or printers attached to these computers, which are accessed by users.
The traditional subarea SNA set-up described here enables the users to
use the resources of a single host system. The terminals provide only
simple data entry and display functions to and from the terminal
controller; the terminal controller is responsible for handling SNA
communications between the terminals and the host.
The terminal controller and its terminals can be replaced by an SNA
node using a product such as SNAplus2. From the host's point of view,
the node appears as a terminal controller. However, it provides the users
with additional functions, such as the ability to access more than one
host system and facilities for customizing screen displays. In addition,
SNAplus2 runs on HP-UX computers that can also be used for other
tasks not related to SNA (unlike the terminal controller, which is used
solely for communications with the host).
Chapter 129
SNA Terms and Concepts
Basic SNA Concepts
Node Types in a Peer Network
Peer 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 composed of type 2.1 nodes. The nodes in a peer
network can serve the following roles:
• APPN network nodes (NNs) identify the locations of network
resources, determine routes for sessions between these resources,
route sessions, and serve end nodes (EN) and low-entry networking
(LEN) nodes directly attached to the network node. The domain of an
APPN network node consists of itself and any end nodes for which it
provides network services.
• APPN end nodes can access remote resources without requiring that
those resources be configured on the end node. An end node can
communicate with adjacent nodes on its own, but requires the
services of a network node server to access nonadjacent nodes. The
domain of an APPN end node includes only itself.
• Low-entry networking nodes (LEN nodes) are type 2.1 nodes that do
not support APPN functions. They can communicate with adjacent
nodes in an APPN network, but do not participate in the APPN
network. In a LEN node, all potential sessions with remote LUs must
be predefined, either specifically or through a single default entry
indicating that all remote LUs reside in an adjacent network node
that can be accessed using a certain link. The domain of a LEN node
includes only itself.
For more information about peer-oriented node types, see “APPN Node
Types”.
Connectivity
For two nodes to communicate, each node must have a combination of
hardware and software that supports data flow between the nodes. The
hardware component consists of an adapter at each node and the
transmission medium that connects the two adapters. The software
component provides control of the hardware and the data exchanged over
it.
30Chapter 1
SNA Terms and Concepts
Basic SNA Concepts
Each node connected to a network has one or more link stations, which
are the hardware and software 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
nodes.
Transaction Programs
Programs that exchange information across the SNA network are called
transaction programs (TPs).
Following are examples of application programs that can include SNA
TPs:
• Emulation programs
• File transfer
• Database transaction processing
• Network management
• Centralized data services
The TP accesses the network through a logical unit (LU) that establishes
and maintains a session with a partner LU on another node. For more
information about logical units, see “Logical Units”.
NOTESNAplus2 includes sample TPs for most supported APIs. For more
information on sample TPs, refer to the programmer's guide for the API.
You can also purchase SNA TPs as part of other products or create your
own TPs (see “Application Programming Interfaces”).
Application Programming Interfaces
SNA TPs are written using application programming interfaces (APIs).
APIs provide specific subroutines that enable SNA TPs to access SNA
functions, such as those for exchanging data and performing control
functions. These subroutines enable an SNA TP to communicate with
another SNA TP on a remote node.
SNAplus2 includes the following APIs on all platforms:
• APPC—LU type 6.2 only
Chapter 131
SNA Terms and Concepts
Basic SNA Concepts
• CPI-C (Common Programming Interface for Communications)—LU
type 6.2 only
• CSV (Common Service Verb) API
• HLLAPI (high-level language application programming
interface)—as part of the SNAplus2 3270 emulation program
• LUA API
In addition, SNAplus2 includes the following proprietary programming
interfaces (only for HP-UX systems):
• MS (Management Services) API
• NOF (Node Operator Facility) API
For an overview of the APIs provided with SNAplus2, see “Application
Programming Interfaces”.
Network Accessible Units
Communication between a TP and the SNA network occurs through
network accessible units or NAUs (formerly called “network addressable
units”), which are unique network resources that can be accessed
(through unique local addresses) by other network resources.
SNA provides the following types of NAUs:
• Physical units (see “Physical Units”)
• Logical units (see “Logical Units”)
• Control points (see “Control Points”)
NOTEBecause TPs are considered users of the network, not components, they
are not classified as NAUs.
Physical Units
Each SNA node contains a physical unit (PU). The PU manages
resources (such as link resources) and supports communication with a
host.
32Chapter 1
SNA Terms and Concepts
Basic SNA Concepts
NOTEOn type 2.1 nodes (which can be APPN nodes), the control point provides
PU services in addition to providing other services (see “Control Points”).
Two type 2.1 nodes (such as SNAplus2 nodes) can communicate directly,
without requiring the services of a host to establish communications.
Logical Units
Each SNA node contains one or more logical units (LUs). An LU provides
a set of functions that are used by TPs and end users to provide access to
the network. LUs communicate directly with local TPs and devices.
SNA defines several types of LUs, each optimized for a specific class of
applications. LUs of different types cannot communicate with each other,
but LUs of the same type can communicate even though they reside on
different kinds of systems.
For example, a TP running on a workstation that uses the HP-UX
operating system can communicate with a TP on an AS/400 computer as
easily as it can with a TP on another HP-UX workstation, as long as both
TPs use the same LU type.
SNAplus2 supports the following LU types:
LU 6.2 (for APPC, 5250 and CPI-C)
LU 6.2 supports program-to-program communication
in a distributed data processing environment. The LU
6.2 data stream is either an SNA general data stream
(GDS), which is a structured-field data stream, or a
user-defined data stream. LU 6.2 can be used for
communication between two type 5 nodes, a type 5
node and a type 2.0 or 2.1 node, or two type 2.1 nodes.
(Type 2.1 nodes can serve as APPN nodes.)
This LU type provides more functions and greater
flexibility than any other LU type. Unless you are
constrained by existing hardware or software, LU 6.2 is
the logical choice when developing new applications.
NOTEOnly LU 6.2 can provide independent LU functions.
LU 3 (for 3270 printing)
LU 3 supports application programs and printers using
the SNA 3270 data stream.
Chapter 133
SNA Terms and Concepts
Basic SNA Concepts
For 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 communicating in an interactive
environment using the SNA 3270 data stream. Type 2
LUs also use the SNA 3270 data stream for file
transfer.
For example, the LU 2 protocol can support 3270
emulation programs, which enable workstations to
perform the functions of IBM 3270-family terminals. In
addition, LU 2 is used by other programs to
communicate with host applications that normally
provide output to 3270 display devices. Such TPs
enable the workstation to achieve a form of cooperative
processing with the host.
LU 1 (for 3270 printing and RJE)
LU 1 supports application programs and single- or
multiple-device data processing workstations
communicating in an interactive, batch-data transfer,
or distributed data processing environment. The data
streams used by LU type 1 conform to the SNA
character string or Document Content Architecture
(DCA).
For example, LU type 1 can support an application
program running under Information Management
System/Virtual Storage (IMS/VS) and communicating
with an IBM 8100 Information System. This enables a
workstation operator to correct a database that the
application program maintains.
Applications that use LU 1 are often described as
remote job entry (RJE) applications.
LU 0 (for LUA)
LU 0, an early LU definition, supports primitive
program-to-program communication. Certain host
database systems, such as IMS/VS (Information
Management System/Virtual Storage) and some
point-of-sale systems for the retail and banking
industries (such as the IBM 4680 Store System
34Chapter 1
SNA Terms 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.
NOTEFor information about the data streams used by SNA logical units, refer
to Systems Network Architecture Technical Reference.
Control Points
A control point (CP) is an NAU that manages network resources within
its domain, controlling resource activation, deactivation, and status
monitoring. The CP manages both physical resources such as links, and
logical information such as network addresses.
SNA defines the following types of network control points:
System services control point
On a type 5 node, the CP is called a system services
control point (SSCP). It manages and controls the
network resources in a subarea network. For example,
an SSCP can use a directory of network resources to
locate a specific LU under its control, and can establish
communication between two LUs in its domain. An
SSCP can also cooperate with other SSCPs to establish
connectivity between LUs in different subarea
domains.
The SSCP also provides an interface to network
operators at the host system, who can inspect and
control resources in the network.
Physical unit control point
On type 4 nodes and type 2.0 nodes in a subarea
network, the control point is called a physical unit
control point (PUCP).
Control point
On type 2.1 nodes, the control point provides both PU
and LU functions, such as activating local link stations,
interacting with a local operator, and managing local
resources. It can also provide network services, such as
partner LU location and route selection for local LUs.
Chapter 135
SNA Terms 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 can also function as an
independent LU of type 6.2. The CP acts as the default
LU for TPs on the local node. For more information
about the APPN control point, see “APPN Control
Point”.
Sessions
NAUs communicate with NAUs in other nodes over temporary logical
communication channels called sessions. Before two TPs can
communicate, their LUs must establish a session. The LU that manages
the session on the local node is the local LU; the LU that manages the
session on the remote node is the partner LU.
Session Types
SNAplus2 is primarily concerned with the following types of sessions:
LU-LU sessions
In order for two TPs to communicate, the LUs that
support the TPs must first establish an LU-LU session.
In general, a session is established when a TP in one
SNA node tries to communicate with a TP in another
node and no existing session between the LUs on the
two nodes is available.
SSCP-LU sessions
A dependent LU (see “Dependent and Independent
LUs”) must have an active SSCP-LU session with an
SSCP on a type 5 node before it can have a session with
an LU in the subarea network. Once an SSCP-LU
session is active, a dependent LU can solicit an LU-LU
session.
SSCP-PU sessions
36Chapter 1
SNA Terms 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 establish CP-CP
sessions. These sessions are used to search for a
resource in the APPN network and to maintain
topology information (see “APPN Control Point”).
Logical Unit Attributes for Sessions
Logical units have attributes that determine how they interact during
LU-LU sessions. These attributes are determined by the architecture of
SNA. LUs can be primary or secondary, and dependent or independent.
Primary and Secondary LUs. To establish a session, one LU
requests session activation by sending a BIND request to another LU:
• A primary LU is the LU that sends the BIND request for a given
LU-LU session.
• A secondary LU is the LU that receives the BIND request.
Peer networks do not use a fixed hierarchy of nodes and do not have
predetermined primary or secondary LUs.
NOTEIn a peer network, an independent LU that is participating in multiple
sessions (see “Multiple and Parallel Sessions”) can act as a primary LU
for one session and a secondary LU in another.
Dependent and Independent LUs. All type 0, 1, 2, and 3 LUs are
dependent LUs. Type 6.2 LUs can be configured as either dependent or
independent LUs.
• A dependent LU (also known as an SSCP-dependent LU) requires the
services of an SSCP to establish a session with another LU. An
SSCP-LU session must be established before a dependent LU-LU
session can be established.
A dependent LU can be in session only with LUs on an SNA host.
Because of this restriction, dependent LUs usually use subarea
networks (also known as host-mediated networks). However, the
Chapter 137
SNA Terms and Concepts
Basic SNA Concepts
dependent LU requester (DLUR) function enables session traffic from
dependent LUs to flow over APPN networks. For more information
about DLUR, see “Accessing Subarea Networks from APPN
Networks”.
A dependent LU on a peripheral node is always the secondary LU.
• An independent LU can establish sessions with other independent
LUs without the aid of an SNA host. LU 6.2 is the only LU type that
can be independent.
An independent LU can act as a primary or as a secondary LU when
establishing a session.
Multiple and Parallel Sessions
An independent LU can participate in sessions with more than one
remote LU at the same time (multiple sessions).
An independent LU can also participate in parallel sessions, or multiple
concurrent sessions with the same remote LU.
Dependent LUs (including dependent LU 6.2) cannot have multiple
sessions.
LUs with multiple and parallel sessions are shown in Figure 1-2,
“Multiple and Parallel Sessions.” LUA and LUB have parallel sessions.
LUA also has multiple sessions: two with LUB and one with LUD. LUD
has multiple sessions with LUA and LUC.
38Chapter 1
Figure 1-2Multiple and Parallel Sessions
SNA Terms and Concepts
Basic SNA Concepts
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 exchange of
information is called a conversation. Only one conversation can use a
particular session at a time, but sessions are serially reusable (many
conversations can use the same session, one after another).
To initiate a conversation, a source TP sends a request to its LU, asking
it to allocate a conversation with a remote TP. The invoking TP (or
source TP) initiates the conversation, like the calling party in a
telephone conversation. The invokable TP or target TP (the remote TP) is
the partner in the conversation, like the party who receives a telephone
call.
Chapter 139
SNA Terms and Concepts
Basic SNA Concepts
As shown in Figure 1-3, “Communication between Transaction Programs
and Logical Units,” information is exchanged 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 every exchange.
Figure 1-3Communication between Transaction Programs and Logical
Units
SNA defines two types of conversations: basic and mapped. These two
types of conversations use different methods to indicate the length of
transmitted or received data packages to be passed between SNAplus2
and the TP.
• In a basic conversation, data must be formatted by the TP as logical
records before being presented to the SEND function.
40Chapter 1
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 the SEND function.
• In a mapped conversation, information is passed to the SEND function
as a pointer to a single, unformatted block of data; the length of the
block is passed as another parameter. The block cannot be received as
one or more logical records; the receiving TP must do whatever
record-level formatting is required.
NOTEOnly LU type 6.2 supports mapped conversations.
Modes
Each LU-LU session has an associated mode that defines a set of session
characteristics. These session characteristics include throughput
parameters, session limits (such as the maximum number of sessions
between two LUs), message sizes, and routing parameters.
SNA Terms and Concepts
Basic SNA Concepts
Each mode is identified by a unique mode name. The mode name must be
the same on all SNA nodes that use that mode.
Route Selection
To establish an LU-LU session, a route must be calculated between the
nodes where the two LUs reside. A route is an ordered sequence of links
and nodes that represents a path between the two nodes.
SNA networks support the following methods of route selection:
• For subarea networks , you must predefine all routes between subarea
nodes.
• For peer networks that do not support APPN, type 2.1 nodes can
support sessions only with adjacent nodes; their sessions cannot be
routed through intermediate nodes.
• For APPN networks, SNA can compute routes dynamically at the
time of session initiation, using a class of service specified for the
mode used by the session (see “Class of Service”).
Chapter 141
SNA Terms 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 relative values
to factors such as acceptable levels of security, cost per byte, cost per
connect-time, propagation delay, and effective capacity.
In a subarea network, a COS is derived from the mode associated with a
session, as defined in the host system.
APPN network nodes use the COS to compute session routes between
independent LUs. For more information about session routing in APPN
networks, see “Session Routing”.
42Chapter 1
SNA Terms and Concepts
Basic APPN Concepts
Basic APPN Concepts
Advanced Peer-to-Peer 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 2.1 nodes. Each node in the
network is connected by a link to at least one other node in the APPN
network. CP-CP sessions are established over each of these links to
adjacent nodes (nodes in the same network that can establish direct
links without going through a third node). All of the nodes in an APPN
network share a common network name.
APPN nodes can include processors of various sizes, such as the
Application System/400 (AS/400), the Enterprise System/9221 (ES/9221)
running under Distributed Processing Program Executive/370
(DPPX/370), systems using Virtual Terminal Access Method (VTAM),
and HP-UX servers running SNAplus2.
APPN provides the following functions:
• Support for APPN network nodes and end nodes as well as non-APPN
peer nodes (see “APPN Node Types”)
• APPN control point functions (see “APPN Control Point”)
• Directory services to support finding specific logical units (see
“Locating Resources”)
• Topology and routing services to support session establishment using
intermediate session routing (ISR), automatic network routing
(ANR), or connection networks (CNs) (see “Session Routing” and
“APPN Connection Networks”)
NOTEAn APPN node can also be connected to a subarea network, serving as
both an APPN node in a peer network and a peripheral node in a subarea
network.
APPN Node Types
The following types of nodes can be part of an APPN network:
Chapter 143
SNA Terms 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 is shown in
Figure 1-4, “Portion of a Sample APPN Network.”
Figure 1-4Portion of a Sample APPN Network
This example shows an APPN network that includes five network nodes
(NNs), three end nodes (ENs), and a LEN node. The network nodes form
the backbone of the APPN network; end nodes access the network
through the network nodes. LU 6.2 TPs on any node can communicate
with any other LU 6.2 TPs in the network.
44Chapter 1
SNA Terms 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 network. Through this network node, LU type 6.2
LUs on other nodes in the APPN network can establish LU-LU sessions
with LU type 6.2 LUs on the host.
APPN Network Nodes
An APPN network node is a type 2.1 node that provides distributed
directory and routing services for all LUs in its domain. These LUs can
be located on the network node itself, or on an APPN end node or LEN
node for which the network node provides services. Because an APPN
network node acts as the network entry point for end and LEN nodes in
its domain, the network node is also referred to as the network node
server for those nodes.
A network node provides the following services:
• LU-LU session services for its local LUs
• Directory searches and route selection for all LUs in its domain
• Intermediate session routing (see “Intermediate Routing”)
• Routing for management services (MS) data, such as alerts, between
a served end node and an MS focal point
APPN End Nodes
An APPN end node is a type 2.1 node that serves as an end point in an
APPN network. It maintains directory information only for local
resources. An APPN end node can independently establish sessions
between local LUs and LUs on adjacent nodes. For sessions with LUs on
nodes not directly connected to the end node, an end node requests
routing and directory information from its network node server using
CP-CP sessions.
APPN end nodes can register their local LUs with their network node
server. This capability means the network operator at the network node
server does not have to predefine the names of all LUs on the attached
end nodes to which the network node provides services.
Chapter 145
SNA Terms and Concepts
Basic APPN Concepts
An APPN end node can be attached to multiple network nodes (see EN3
in Figure 1-4, “Portion of a Sample APPN Network,”) but it can have
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 routing for the end node or as substitute network
node servers if the main network node server becomes unavailable.
An APPN end node can also have a direct link to another APPN end node
or a LEN node, but CP-CP sessions are never established between two
end nodes.
LEN Nodes
A low-entry networking node (LEN node) is a type 2.1 node that uses
independent LU 6.2 protocols, but does not support CP-CP sessions. It
can be connected to an APPN network node or end node, but does not
support APPN functions.
An APPN network node can provide routing services for an attached
LEN node, enabling the LEN node to participate in an APPN network
without requiring link stations to be defined between the LEN node and
all of the nodes in the APPN network.
LUs in the APPN network with which the LEN node may want to
establish sessions must be defined to the LEN node as if they reside on
the LEN 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 node in the network where the
LU actually resides. LUs on the LEN node must be predefined to the
network node that serves the LEN node. LU resources on LEN nodes
(unlike those on end nodes) cannot be registered on the network node
server.
An APPN end node cannot provide intermediate routing. When a LEN
node's only link is to an APPN end node, the LEN node can communicate
only with LUs on the end node through the direct link between the two
nodes.
46Chapter 1
SNA Terms and Concepts
Basic APPN Concepts
APPN Control Point
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 (such as activating and
deactivating adapters and links), provides directory and topology
information, and assists LUs in session initiation and termination.
Adjacent nodes in an APPN network use a pair of parallel CP-CP
sessions to exchange network information and to provide directory and
route selection services. Both sessions of a given pair must be active in
order for the partner CPs to begin and sustain their interactions.
Different node types use these sessions differently, as follows:
• Two parallel CP-CP sessions are established between an APPN
network node and each adjacent network node. These CP-CP sessions
are used to exchange directory, topology, and management services
data.
• Two parallel sessions are established between an APPN end node and
the adjacent network node acting as the server for the end node.
These CP-CP sessions are used to exchange directory, topology, and
management services data.
• LEN nodes do not support CP-CP sessions.
The functions provided in CP-CP sessions vary based on the types of
nodes involved, as follows:
• All CP-CP sessions conduct directory searches.
• CP-CP sessions between an end node and a network node provide the
following functions:
• Registering resources.
• Routing management services data (such as alerts) between the
end node and a focal point.
• Routing topology data from each end node to its network node
servers. This information can be used by the network node server
to compute a route that does not flow through the network node
server.
• CP-CP sessions between adjacent network nodes exchange topology
information. As a result of this exchange, each network node creates
an internal network topology database.
Chapter 147
SNA Terms 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
To support communication between TPs, SNAplus2 first establishes a
session between the logical units that control those TPs. APPN enables
the CP on a node to locate LUs throughout the APPN network without
requiring that the node have any configuration information for the
remote LU. The APPN function that dynamically locates LUs in the
network is called directory services. Once a resource has been located, a
route for the session is calculated through the APPN network.
Resource Names
Each node has a unique name consisting of two parts: a network name
and a control point name. Together they constitute a fully qualified CP
name. This name identifies each node to all other nodes in the network.
Similarly, each logical unit is identified by a fully qualified LU name,
consisting of a network name and LU name.
Directory Services
Each APPN node maintains a directory of network resources. Directory
services is the component of the node CP that manages the local
directory database and, in a network node, searches for network
resources throughout an APPN network.
When the node is initialized, it includes the following information:
• Node type (APPN network node, APPN end node, or LEN node)
• Network ID of node
• CP name of node
Each node directory maintains entries for resources (LUs and CPs),
including each resource's fully qualified name, type, and registration
status. The specific resources stored in each local directory depend on the
node type:
• A LEN node maintains a directory that includes its own LUs. It must
also be configured with directory entries for all of its possible partner
LUs. LUs in the APPN network with which the LEN node may want
to establish sessions must be defined to the LEN node as if they
48Chapter 1
SNA Terms 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
multiple partner LUs that can be accessed over a specific link.
• An APPN end node maintains a directory that includes its own LUs.
It can also be configured to store directory entries for partner LUs in
adjacent nodes. This enables local LUs to establish peer-to-peer
sessions with those LUs without using APPN functions.
If a resource is not locally defined to an end node or currently cannot
be reached by the end node, the end node sends a request to its
network node server asking it to search the APPN network for the
resource.
• An APPN network node maintains a directory that includes its own
LUs and the end node and LEN node LUs in its domain. An end node
can dynamically register its LUs with its network node server. (LEN
nodes cannot register LUs with a network node server, so LEN node
LUs must be configured on their network node server.) A network
node directory can also contain cached entries for LUs that are not in
the network node's domain, but whose location has been determined
through a previous search.
Network nodes provide directory services to other nodes in two ways:
• Searching for remote resources in response to session requests
from end nodes or LEN nodes
• Responding positively to directory search requests from other
network nodes when a named resource is found in the local
directory
LEN Node Directories. An example of a LEN node directory is
shown in Figure 1-5, “LEN Node Directory.” Since LEN nodes do not
support CP-CP sessions, the directory for Node LEN1 must contain all
the LUs with which it communicates. The directory for Node LEN1
identifies its network node server (NNA) as the location for any LUs that
are not on an adjacent peer end node. Since Node LEN1 can access the
LUs only through Node NNA, it defines the CP on the network node as
the “owning CP” of all the LUs, including LUs located on the end nodes.
Chapter 149
SNA Terms and Concepts
Basic APPN Concepts
Figure 1-5LEN Node Directory
To 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.
NOTEIn this example, Node LEN1 can establish a session with LU1 on Node
EN1 through its network node server, NNA. However, LU2 on Node EN1
is not defined in the directory for Node LEN1, so Node LEN1 cannot
establish sessions with that LU.
End Node Directories. When an LU is not represented in an end
node directory, the end node initiates a LOCATE search to find the desired
LU. To activate the search for a remote LU, the end node invokes the
services of its network node server. An example of an end node directory
is shown in Figure 1-6, “End Node Directory.”
50Chapter 1
Figure 1-6End Node Directory
Potential 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.
SNA Terms and Concepts
Basic APPN Concepts
Network Node Directories. A network node provides distributed
directory services to the end nodes it serves.
An example of a network node directory is shown in Figure 1-7,
“Network Node Directory.”
Chapter 151
SNA Terms and Concepts
Basic APPN Concepts
Figure 1-7Network 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 specified in a LOCATE search request from an end
node
• An LU name specified in a BIND request from a LEN node
• An LU name specified by a TP on the network node
2. If the destination LU is not located in the network node—but appears
in its directory—the network node sends a directed search request to
the destination network node server to verify the location of the LU.
If the LU is not in the network node directory, the node initiates a
search of the network by sending a broadcast search to every adjacent
network node.
3. Each node in turn propagates the broadcast and returns replies
indicating success or failure.
For its future needs, a network node caches information obtained from
successful broadcast searches.
52Chapter 1
SNA Terms 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 registration message. In this way, the
network node maintains current directory information for the end nodes
in its domain. A LEN node cannot register LUs with its network node
server. Therefore, all LUs on the LEN node must be predefined, through
configuration, to the network node server.
Session Routing
APPN supports the following dynamic route selection procedures:
• For sessions with adjacent nodes, direct session routing.
• For sessions that traverse one or more intermediate nodes, one of the
following:
• Intermediate session routing (ISR), which provides a route that
does not change during the course of the session.
• High-Performance Routing (HPR), which includes the Rapid
Transport Protocol (RTP) and automatic network routing (ANR)
facilities. RTP enables you to reroute session traffic around route
failures or congestion, and ANR minimizes cycles and storage
requirements for routing network layer packets through
intermediate nodes on a session route.
The APPN functions that provide dynamic route selection are known as
topology and routing services (TRS).
Topology and Routing Services
Each APPN node includes a topology database that stores information
about other APPN nodes and about transmission groups, which are sets
of links between a specific pair of nodes. The contents of the database for
a specific node depend on the node type:
• All network nodes share a copy of the network topology database.
This shared database includes information about all other network
nodes—including network IDs, CP names, and other node
characteristics—and about the transmission groups between each
pair of network nodes. This database provides a complete view of the
Chapter 153
SNA Terms 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 nodes or LEN nodes.
The network node uses the topology database to calculate routes for
sessions between LUs in its domain and remote LUs, or to provide
information to other network nodes to enable them to calculate
session routes.
• Each end node has a local topology database with information about
transmission groups from that end node to adjacent nodes.
The end node provides this information to its network node server as
part of the request to locate an LU and calculate a session route to
that LU. The network node server uses the end node topology
information when calculating the session route for the end node. The
end node uses this information when establishing sessions with
predefined LUs on adjacent nodes. The end node topology database
supports communication only with adjacent nodes.
NOTEAPPN network nodes and end nodes also maintain topology information
about links to a connection network (see “APPN Connection Networks”).
LEN nodes maintain local topology information. They do not forward this
information to a network node server.
As shown in Figure 1-8, “Network Topology Database in Network
Nodes,” network topology information is replicated at all network nodes,
and local topology information is stored at network nodes and end nodes.
54Chapter 1
Figure 1-8Network Topology Database in Network Nodes
SNA Terms and Concepts
Basic APPN Concepts
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
Chapter 155
SNA Terms and Concepts
Basic APPN Concepts
topology information because it does not have any links to end nodes).
For 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 adjacent nodes. For
example, Node EN2 includes information about Link f to Node NNB and
Link i to Node EN3.
Topology Database Updates. APPN network nodes use CP-CP
sessions to exchange network topology information when a resource
(such as a node or a link between two network nodes) is activated or
deactivated, or when the characteristics of an existing resource change.
When such a change occurs, a network node generates a topology
database update (TDU) that contains node identification node and link
characteristics, and update sequence numbers identifying the resource to
be updated and the changes for the resource. Each TDU is sent to all
active network nodes to ensure that the network topology database is
kept current throughout the network.
Route Selection in an APPN Network. APPN directory services
locates a specific session partner; topology and routing services
calculates the optimal session route after the session partner has been
located in the network. Each network node provides route selection
services for sessions originated by its own LUs and by LUs at the end
nodes or LEN nodes that it serves. A network node uses its own local
topology information, plus information from the shared network topology
database, to dynamically calculate routes between nodes.
Once the session partner has been located, the network node performs
the following steps to select a route:
1. Obtains required characteristics for the session route.
The LU requesting the session specifies a mode name that identifies
session characteristics. The associated mode identifies a class of
service that specifies requirements for the links used to route session
traffic.
2. Obtains all transmission groups and network nodes for possible
routes:
• If the session request comes from an end node, the end node
provides information about links it has to its network node server
and to a connection network, if one exists.
56Chapter 1
SNA Terms 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, the end node (or its
network node server) provides information about the link between
the network node server and that end node (or the link between
the end node and a connection network).
3. Excludes all network nodes and transmission groups that do not meet
the specified characteristics for the session route.
4. Computes the optimal route for the session.
Depending on the specified class of service, the route calculation
algorithm computes a weight value for each node and logical link and
then totals the weights for each route. To select the optimal path, the
network node computes the current least-weight route from the node
containing the originating LU to the node containing the destination LU.
Intermediate Routing
Intermediate routing enables an APPN network node to receive and
route data destined for another node. The origin and destination of the
data can be an end node, another network node, or a LEN.
Intermediate routing supports sessions between LUs that are not on
adjacent nodes. After a route has been selected for a session, APPN
network nodes in the route use intermediate routing to forward session
data to the next node in the route.
Resource characteristics maintained by the topology database can
include congestion status. If a network node becomes heavily congested,
the network node can relay this information to other network nodes in
the network, making the congested network node less likely to be
included in session routes calculated for new sessions.
APPN provides two types of intermediate routing:
• In intermediate session routing (ISR), available in all network nodes,
the network node keeps track of each intermediate session. Each
intermediate node adjusts the pacing of session data to control the
rate at which data flows between adjacent nodes. Each intermediate
node can also perform segmentation and reassembly of segmented
Chapter 157
SNA Terms 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-Performance Routing (HPR) function,
intermediate network nodes can dynamically reroute session traffic if
part of the route fails. ANR does not provide intermediate session
pacing or segmentation and reassembly.
ANR enables intermediate nodes to route session traffic much faster
than is possible with traditional APPN ISR. However, ANR requires
additional overhead at the RTP (Rapid Transport Protocol) endpoints. In
routes with few intermediate nodes, an ANR route might actually be
slower than an ISR route, due to processing time at the endpoints. For
routes containing a larger number of intermediate nodes (hops), ANR
routes are typically faster. The exact location of the break-even point
depends on the efficiency of the RTP nodes.
Direct Connectivity
Direct connectivity enables session traffic to travel directly between two
nodes without the need for an APPN network node to route the session.
In general, sessions between directly connected nodes can exchange data
more quickly than sessions for which data is routed through a network
node. For nodes on a shared-access transport facility (SATF)—for
example, for nodes on a token ring as shown in Figure 1-9—efficiency
would be increased by defining links between every pair of nodes in your
network. However, this can be a difficult task—the number of link
stations is n × (n−1), where n is the number of nodes in the network.
An APPN network on a token ring is shown in Figure 1-9, “APPN
Network Using a Shared-Access Transport Facility.”
58Chapter 1
SNA Terms and Concepts
Basic APPN Concepts
Figure 1-9APPN Network Using a Shared-Access Transport Facility
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 are shown in Figure 1-10, “Definitions Needed for Direct
Links from Node EN1 to Every Node in an APPN Network.” For a
network that includes five other nodes, Node EN1 needs five link
definitions:
• EN1 to NNA
• EN1 to EN2
• EN1 to EN3
• EN1 to EN4
• EN1 to EN5
Chapter 159
SNA Terms and Concepts
Basic APPN Concepts
Figure 1-10Definitions 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 definitions can be calculated
as n × (n−1), where n is the number of nodes in the network. In a larger
network, the number of link definitions quickly becomes unwieldy.
Increasing the number of link definitions between network nodes also
increases the number of TDUs flowing through the network, which can
degrade network performance.
APPN connection networks provide a solution to this problem.
APPN Connection Networks
For APPN networks attached to a shared-access transport facility
(SATF), an APPN connection network greatly reduces the number of link
definitions needed to support direct connectivity between nodes in the
network. In a connection network, an APPN end node needs to configure
60Chapter 1
SNA Terms 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.
To use the connection network feature , an APPN network must meet the
following conditions:
• The nodes in the APPN network must be linked using switched media
such as token ring or Ethernet (see “DLCs”).
• All of the links in the APPN network must use the same media.
• The APPN network that contains the connection network must be
fully connected. In a fully connected network, each node has at least
one link that supports CP-CP sessions to an adjacent node.
In a connection network, the SATF serves as a virtual routing node
(VRN) that attaches directly to each node in the connection network. The
name of the connection network serves as the name of the control point
for the VRN. The VRN supports the direct routing of session data
between any two nodes in the connection network, but it does not
establish CP-CP sessions with other nodes and it does not generate
TDUs. Each node in the connection network requires only a link to its
network node server.
The link definitions needed when using a connection network are shown
in Figure 1-11, “Definitions Needed for Direct Links Using a Virtual
Node.” By using a virtual node, the connection network supports direct
links between Node EN1 and every other node in the APPN network, yet
it requires only two link definitions.
Chapter 161
SNA Terms and Concepts
Basic APPN Concepts
Figure 1-11Definitions Needed for Direct Links Using a Virtual Node
To 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.)
Compared to the direct connectivity requirements for an APPN network
that does not use a connection network (see Figure 1-10), you can have a
much smaller number of link definitions (10 instead of 30 in this
example). In a larger network, the difference in definition requirements
becomes even more substantial.
A session between LUs on two nodes in the connection network is
established as follows:
1. Each end node first establishes CP-CP sessions with its network node
server. (If two end nodes have different network node servers, those
network nodes must have a link that supports CP-CP sessions.)
2. End nodes also report their VRN links and local address information
to the network node server. The local address information can be a
service access point (SAP) address and a medium access control
(MAC) address.
62Chapter 1
SNA Terms 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 without the need
for intermediate session routing.
Chapter 163
SNA Terms and Concepts
Accessing Subarea Networks from 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 nodes in the APPN network while still providing an SSCP to
control any old subarea SNA function.
Many SNA networks contain elements of both subarea SNA and APPN.
The backbone of the network is built from network nodes that must
bridge the gap between a dependent LU and the facilities on the host.
Two additional services are required to achieve this:
• Dependent LU server (DLUS) on the host provides access to the old
SSCP functions and interfaces to the APPN network.
• Dependent LU requester (DLUR) on a network node or end node
provides a means of transporting session traffic from dependent LUs
to a host through an APPN network. This function enables dependent
LU sessions to take advantage of the more versatile routing functions
provided by APPN.
This combination of DLUR and DLUS (generally known simply as
DLUR) allows dependent LU traffic to be transported over the APPN
backbone. Existing SNA applications that use dependent LUs can be
retained without modification, while taking advantage of APPN's
network management, dynamic resource location, and route selection
capabilities. In this way, DLUR provides a useful migration path from
subarea SNA to APPN.
The dependent LU does not need to reside on the node that provides the
DLUR function. If the DLUR function is provided by a network node, the
dependent LU can be on an adjacent network node, end node, or LEN
node. If the DLUR function is provided by an end node, the dependent
LU must be on the end node itself.
64Chapter 1
2Introduction to SNAplus2
65
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 administration responsibilities and tools.
66Chapter 2
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 power.
SNAplus2 includes the following facilities:
SNA communication facilities
SNAplus2 nodes can operate within an SNA subarea
network, within an APPN network, or within both at
the same time. For more information about SNA
support supplied by SNAplus2, see “SNA Support”.
Passthrough services
SNAplus2 includes services that support
communication between a host and computers on a
LAN, making it possible to reduce the number of
communication links to the host, simplify configuration
of SNA nodes, and provide host access for computers
that have no direct link to a host. F or more information
about passthrough services, see “Passthrough
Services”.
User applications
SNAplus2 supports the following user applications:
• 3270 emulation
• 5250 emulation
• Remote job entry (RJE)
For more information about user applications, see
“User Applications”.
Application programming interfaces
SNAplus2 includes application programming
interfaces (APIs) that you can use to write user
application programs or SNAplus2 administration
programs. F or more information about SNAplus2 APIs ,
see “Application Programming Interfaces”.
LAN facilities
Chapter 267
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). For more
information about client/server facilities on a LAN, see
“Client/Server Support”.
Windows clients
For WindowsSNAplus2 provides support for Windows clients
(running Windows 3.11, Windows for Workgroups,
Windows 95, and Windows NT), enabling them to
access SNA resources through SNAplus2 servers. The
APIs provided for Windows clients support 3270 and
5250 emulation and enable the development of custom
applications. These APIs implement the WOSA
standards and are compatible with the APIs provided
with Microsoft's SNA Server.
End of Section
Administration facilities
SNAplus2 includes several methods and tools you can
use to configure and manage SNAplus2 servers and
clients. For more information about SNAplus2
administration, see “Client/Server Support”.
68Chapter 2
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 running SNAplus2 configured as a standalone system that
communicates directly with a host computer is shown in Figure 2-1,
“Standalone SNAplus2 Node That Communicates Directly with a Host.”
Figure 2-1Standalone SNAplus2 Node That Communicates Directly with a
Host
Several SNAplus2 nodes configured as an APPN network are shown in
Figure 2-2, “SNAplus2 Nodes in an APPN Network.” SNA is used for
peer communication within the LAN as well as over the SDLC link.
Chapter 269
Introduction to SNAplus2
Example Configurations
Figure 2-2SNAplus2 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.
70Chapter 2
Introduction to SNAplus2
Example Configurations
Figure 2-3SNAplus2 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.
Chapter 271
Introduction to SNAplus2
Example Configurations
Figure 2-4SNAplus2 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.
72Chapter 2
Figure 2-5SNAplus2 Client/Server Configuration
Introduction to SNAplus2
Example Configurations
These examples show the most basic ways in which you can configure
SNAplus2 nodes. By combining nodes using these basic configuration
types, you can use SNAplus2 to support different types of communication
within more complex networks.
Chapter 273
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-6Components of SNAplus2
The local node—including its associated connectivity resources (DLCs,
ports, and link stations)—is implemented as a set of STREAMS
components in the kernel of the HP-UX system.
The 3270 emulation program, RJE workstation, APPC transaction
programs, CPI-C applications, LUA applications, and the remote
command facility (RCF) are user-space programs. SNAplus2 supports
multiple copies of the 3270 and 5250 emulation programs, and multiple
APPC TPs, CPI-C applications, and LUA applications running
concurrently.
74Chapter 2
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; it also implements an
APPN node, providing end node function.
SNAplus2 implements an APPN node to communicate with other nodes
on the SNA network. This provides logical unit (LU) 6.2 support for
APPC and CPI-C capabilities and for 5250 emulation, in addition to LU
0, 1, 2, and 3 support for 3270, RJE, and LUA communications.
SNAplus2 can operate either as a LEN node or as an APPN end node,
depending on its configuration. Certain functions are supported only on
end nodes, as defined by the APPN architecture. These differences are
indicated where necessary in this manual; where no differences are
indicated, the information applies to both node types.
Passthrough Services
Passthrough services enable downstream computers on a LAN to access
host resources through a server running SNAplus2. SNAplus2 provides
the following passthrough services:
• PU concentration (see “PU Concentration”).
• Dependent LU requester (see “Dependent LU Requester”).
• TN server (see “TN Server”).
• UNIX command facility (see “Remote Command Facility”).
PU Concentration. In addition to providing direct access to a host
computer, SNAplus2 can provide PU concentration facilities. This
feature enables other computers to access a host computer through the
SNAplus2 node, instead of requiring a separate connection to the host
from each computer.
The PU concentration feature is shown in Figure 2-7, “PU
Concentration.”
Chapter 275
Introduction to SNAplus2
SNAplus2 Components
Figure 2-7PU 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 concentration feature, all the
data transferred between the host and the downstream computer is
routed through the local node. This enables a downstream computer to
share a host connection with SNAplus2 or with other downstream
computers, instead of requiring a direct link. For example, you could set
up several downstream computers connected to SNAplus2 over a local
token ring network, so that they could all access the same long-distance
leased line from SNAplus2 to the host.
Using PU concentration also simplifies the configuration at the host,
because you do not need to define the downstream computers and the
communication links to them. The host configuration needs to include
only the SNAplus2 computer and its host communication link; the LUs
76Chapter 2
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 aware 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, SNAplus2 can
provide dependent LU requester (DLUR) facilities. This feature enables
sessions for dependent LUs to span multiple nodes in an APPN network,
instead of requiring a direct connection to the host.
DLUR on the SNAplus2 node works in conjunction with dependent LU
server (DLUS) at the host. Together, they route sessions across the
network from dependent LUs in the APPN network to the DLUS host.
The route to the host can span multiple nodes and can take advantage of
APPN's network management, dynamic resource location, and route
calculation facilities.
TN Server. 3270 emulation programs that communicate over TCP/IP
(rather than over an SNA network) are referred to as TN3270 programs
(Telnet 3270 emulation programs).
TN3270 programs can also include support for TN3270E (Telnet 3270
standard extensions). TN3270E supports 3270 device emulation
(including both terminals and printers) using Telnet. It enables a Telnet
client to select a particular device (by specifying the LU name), and
provides enhanced support for various functions, including the ATTN
and SYSREQ keys and SNA response handling.
Chapter 277
Introduction to SNAplus2
SNAplus2 Components
NOTEThis 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 with other TN3270 users, instead of
requiring a direct link. TN server also enables TN3270 users to access
hosts that are not running TCP/IP.
The SNAplus2 TN server function is shown in Figure 2-8, “TN Server.”
Figure 2-8TN Server
TN server provides an association between a TN3270 user and a 3270
LU on the SNAplus2 server. All data from the TN3270 user is routed to
the LU. This means that the configuration for both the host and the
TN3270 user is as though they were connected directly; neither needs to
be aware that data is being routed through TN server.
78Chapter 2
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 program is running. SNAplus2 cannot distinguish between two
different TN3270 programs being used by different users on the same
computer. In the SNAplus2 manuals, the term TN server user refers to
the computer where a TN3270 program is running, not to an individual
user of that program.
Each TN server user is normally configured to access a single 3270 LU,
and so is restricted to one host session at a time. However, you can also
configure a TN server user to access a pool of 3270 LUs, instead of having
a single dedicated 3270 LU for each user. This enables the user to access
as many sessions as there are available LUs in the pool.
User Applications
SNAplus2 supports the following user applications:
• 3270 emulation programs (see “3270 Emulation”).
• 5250 emulation programs (see “5250 Emulation”).
• RJE workstation daemon (see “RJE Workstation Daemon”).
3270 Emulation
You can use 3270 emulation software to log on to and use SNA host
systems from your computer, control display and printer emulation
sessions, and to transfer files between the local and host computers. 3270
emulation uses the node's LU type 0–3 resources.
To use 3270 emulation, you need to define the 3270 users on your system,
identified by their login IDs, and the 3270 features available to each user
or group of users. 3270 users and sessions are defined as domain
resources, which simplifies the configuration required to support
emulation across the domain.
The SNAplus2 3270 emulation program provides session control and file
transfer capabilities. In addition, you can customize some 3270
emulation features, such as key-mapping and display attributes.
SNAplus2 3270 emulation also enables you to use HLLAPI applications.
Chapter 279
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.
For more information about configuring support for 3270 emulation, see
Chapter 8, “Configuring User Applications.”
5250 Emulation
Using 5250 emulation software, you can log on to and use AS/400
systems from your computer. You can use emulation software to control
display and printer emulation sessions and to transfer files between the
local computer and the AS/400. 5250 emulation uses the node's LU type
6.2 resources.
NOTESNAplus2 does not provide a 5250 emulation program; it just provides
support for third party 5250 emulation software.
To use 5250 emulation with SNAplus2, you need to define the 5250 users
on your system. 5250 users are defined as domain resources, which
simplifies the configuration required to support emulation across the
domain.
Depending on the requirements of the 5250 emulation program you use,
you may need to configure the emulation program with additional
information.
For more information about configuring support for 5250 emulation, see
Chapter 8, “Configuring User Applications.”
RJE Workstation Daemon
SNAplus2 provides support for remote job entry (RJE), enabling you to
submit jobs to a host computer for processing. The RJE workstation
daemon is the SNAplus2 component that handles transfer of jobs to the
host, and also handles the output returned from the host.
You can prepare jobs for submission to the host and add them to the
queue for an RJE workstation at any time, regardless of whether the
RJE workstation is running. When the workstation runs, it submits any
outstanding jobs to the host (in the order in which they were submitted).
It also routes any output received from the host to the appropriate
destination, as determined by the configuration.
The RJE workstation uses the node's LU type 0–3 resources. In addition,
you need to define (as domain resources) the RJE workstations on your
system.
80Chapter 2
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 workstation
style file.
Application Programming Interfaces
SNAplus2 provides several standard programming interfaces that you
can use to develop application programs:
• APPC API for peer-to-peer communications between application
programs (see “APPC API”).
• CPI-C (Common Programming Interface for Communications) for
platform-independent communication using independent LU 6.2 (see
“CPI-C API”).
• CSV (Common Service Verb) API for utility functions such as
character translation and application trace control (see “CSV API”).
• HLLAPI (high-level language application programming interface) for
application programs that interact with the 3270 emulation program
to automate standard 3270 tasks (see “HLLAPI”).
• LUA API for communications with host applications (see “LUA API”).
In addition, SNAplus2 includes the following proprietary programming
interfaces:
• MS (Management Services) API for network messaging functions (see
“MS API”).
• NOF (Node Operator Facility) API for applications that configure and
manage SNAplus2 resources (see “NOF API”).
For WindowsWindows client APIs (see “Windows APIs”).
End of Section
For more detailed information about an API, refer to the programming
guide for the API (see “SNAplus2 Publications”).
Chapter 281
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
transaction programs (TPs) and distributing conversations to those TPs.
If the TP on the SNAplus2 computer is the invoking TP (the TP that
starts the APPC conversation), the additional node resources required
depend on the APPC features used by the TP, and on the type of remote
system it is communicating with:
• If the local node or the remote system with which the TP
communicates is a LEN node, you need to define directory entries for
the remote node and its LUs.
• If the TP specifies its local APPC LU using an LU alias, you need to
define the partner LU in order to associate this alias with a fully
qualified LU name.
• If the TP uses a dependent local LU to communicate with a host, you
need a partner LU definition on the local node that specifies the
uninterpreted name for the LU on the host. When the TP requests a
conversation from the local LU, the local LU sends the host a session
initialization request that contains the uninterpreted name for the
host LU.
In the Motif administration program, directory entries and partner LUs
are not shown explicitly, but are included under the “Remote Systems”
heading in the Node window for the local node.
If the TP on the SNAplus2 computer is the invoked TP (the TP that
accepts a conversation started by the invoking TP), the additional
resources required depend on the APPC features used by the TP, and on
how it is to be started:
• To restrict the TP to using particular options for conversation
security, confirm synchronization, or conversation type (mapped or
basic), or to restrict the number of instances of the TP that can be
running at any time, you must define the TP as a node resource.
• To start the TP automatically when another TP requests a
conversation with it, you must provide the information that
SNAplus2 needs to start the TP. For more information, see Chapter 7,
“Configuring APPC Communication.”
82Chapter 2
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_ALLOCATE issued
by the TP.
• Specify that the TP is a broadcast queued TP (which means that
incoming conversation requests can be routed dynamically to the
TP wherever it is running).
For more information about TP configuration, see “Defining TPs”.
For more information about the APPC API, refer to the HP-UXSNAplus2 APPC Programmers Guide.
CPI-C API
A CPI-C application uses the node's LU type 6.2 and mode resources to
communicate with another APPC or CPI-C application on a host or peer
computer. You define the same resources for a CPI-C application as for
an APPC application, as described in “APPC API”.
In addition, if the TP on the SNAplus2 computer is the invoking TP (the
TP that starts the conversation), you may need to define one or more side
information entries for it. Each of these entries provides information
about a partner TP, the LU and mode resources used to access the
partner TP, and any security information required.
For more information, refer to the HP-UX SNAplus2 CPI-CProgrammers Guide.
CSV API
The Common Service Verb (CSV) API provides utility verbs that enable
an application program to perform functions such as character set
conversion and trace file control.
For more information, refer to the HP-UX SNAplus2 CSV ProgrammersGuide.
HLLAPI
HLLAPI (high-level language application programming interface)
enables applications that use the SNAplus2 3270 emulator program to
communicate with a host.
Chapter 283
Introduction to SNAplus2
SNAplus2 Components
For more information, refer to the HP-UX SNAplus2 3270 & TN3270
HLLAPI Programmers Guide or HP-UX SNAplus2 3270/3179G Users
Guide.
LUA API
The LUA API enables application programmers to write applications
that communicate with host applications at the request unit and
response unit (RU) level, and to send and receive data on both the
SSCP-LU session and the PLU-SLU session. This API can be used to
support LU 0, 1, 2, or 3 communication with the host.
An LUA application uses the node's LU type 0–3 resources to
communicate with a host application. You do not need to define any
additional resources.
For more information, refer to the HP-UX SNAplus2 LUA ProgrammersGuide.
MS API
The Management Services (MS) API enables an application to
communicate with other MS products in an APPN network. An
application can be either NMVT-level or MDS-level, depending on the
type of MS data it sends and receives. SNAplus2 performs any data
conversion that is required.
For more information, refer to the HP-UX SNAplus2 MS ProgrammersGuide.
NOF API
The NOF API can be used to write applications that administer
SNAplus2 configuration and management resources. For more
information, refer to the HP-UX SNAplus2 NOF Programmers Guide.
Windows APIs
For WindowsThe SNAplus2 client software includes API libraries that are fully
compatible with Microsoft SNA Server and the Windows Open Systems
Architecture (WOSA), enabling applications written for SNA Server to
run unchanged on the SNAplus2 Windows client.
SNAplus2 supports the following WOSA APIs:
• Windows APPC
84Chapter 2
End of Section
Introduction to SNAplus2
SNAplus2 Components
• Windows CPI-C
• Windows LUA
• Windows CSV
• 3270 Emulator Interface Specification
For more information about Windows SNA APIs, see the documentation
provided with Microsoft SNA Server.
Client/Server Support
Computers running SNAplus2 can be configured to communicate using
client/server protocols. When client/server protocols are used in a
network, all the computers using client/server protocols to communicate
in that network are referred to as a domain. Each computer in the
network specifies the same domain name when SNAplus2 is installed.
The computers running SNAplus2 in a client/server configuration can
take the following roles:
• A server contains an SNA node and its associated connectivity
components. The server provides SNA connectivity to applications on
the local system or on other machines in the same domain.
• A client does not contain SNA components, but accesses them
through a server. A client can access one or more servers at the same
time, and can run concurrent applications as needed.
Servers must be HP-UX computers; clients can be running HP-UX or
Windows. Servers and clients communicate across the SNAplus2 domain
using TCP/IP.
You can configure one or more separate SNAplus2 domains on the same
physical network, using a unique name for each different domain. Use
the same domain name for all SNAplus2 servers and clients that belong
the same domain. A single SNAplus2 domain can correspond to a TCP/IP
subnet, can be part of a TCP/IP subnet (so that there are two or more
separate SNAplus2 domains in the same subnet), or can span multiple
subnets.
Each server maintains information about its own node configuration in a
node configuration file. You can use the SNAplus2 administration tools,
described in “Administration Tools”, to examine and modify the node's
Chapter 285
Introduction to SNAplus2
SNAplus2 Components
configuration. You 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 complete
SNAplus2 LAN is held in a domain configuration file. If you have more
than one server on the LAN, SNAplus2 ensures that this domain
configuration information is consistent across all servers.
Benefits of Client/Server Operation
Client/server configuration provides the following benefits:
• Concentrating SNA resources on servers reduces the load on clients,
improving client performance and minimizing the storage needed to
provide SNA services to clients.
• Sharing a single data link among multiple users on different
machines eliminates the need for each machine to have a physical
SNA network connection.
• Having multiple servers provides redundant connectivity (for
example, by having multiple servers providing access to the same
host). Having multiple paths to an SNA resource enables load
balancing across the different servers and provides immediate
backup in the event that a particular server or link fails.
• Using LU pools across multiple servers makes it easy to configure
and add servers and users.
• Having fewer links and PUs for host connectivity reduces the size of
the host VTAM definition.
• Using SNAplus2 administration utilities makes it easy to configure
and manage both node resources (for any specific computer in the
domain) and shared resources (across the domain). The client/server
support provided by SNAplus2 administration tools enables
transparent administration of all domain resources from any
computer in the domain.
Master Server and Backup Servers
If you are using SNAplus2 with all programs on one computer, or on a
LAN that contains only one server, you do not need to read this section.
86Chapter 2
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. You can define other servers on the LAN to
be backup servers. The domain configuration file is copied to backup
servers—either when they are started, or when the master copy is
changed—so that all backup servers hold a copy of the latest
information.
In general, you should define at least one backup server in addition to
the master server. Any remaining servers can be defined as additional
backup servers, or they can be left as peer servers. A peer server obtains
domain configuration information from the master server as required,
but cannot act as a backup server.
If the master server fails, the first backup server on the list of servers
defined for the domain takes over as the master. The domain
configuration file on this server is used as the master copy, and is copied
to other servers as necessary. When the master server is restarted, it
receives a copy of the domain configuration from the backup server
currently acting as master, and then takes over as the master.
If at any time the master server and all backup servers are inactive, a
node on a peer server can still operate, and you can still change the
node's configuration. However, you cannot access the domain
configuration file, and therefore cannot access the configuration of
domain resources (as opposed to node resources). This means that you
cannot start the 3270 emulation program, start the RJE programs, or
allocate CPI-C conversations using symbolic destination names defined
in the configuration file.
NOTEIf the LAN is split by a network failure into two noncommunicating
domains, each containing one or more backup servers, SNAplus2 cannot
maintain a consistent configuration of domain resources across the LAN.
In this situation, each domain has an acting master server , each trac king
changes made to the domain configuration file in its own domain but
unaware of any changes made in the other domain. When the LAN
connection is re-established, the domain configuration file from the
original master server becomes the domain configuration file across the
LAN, and any domain resource files on other servers are overwritten. (If
the master is inactive at this point, the domain configuration file from
the highest backup server available in either of the two domains is used.)
Because changes to a domain configuration file are not necessarily
Chapter 287
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 sna.net, known as the SNA network data file. The
master copy of this file is stored on the master server; any changes made
to it are automatically copied to all other servers in the same way that
changes to the domain configuration file are copied to backup servers.
You cannot edit the contents of the SNA network data file directly;
instead, SNAplus2 provides administration facilities to access the file.
(You can edit node configuration files directly when SNAplus2 is not
running; but in general you should use SNAplus2 administration
facilities to ensure that all configuration information is valid and
internally consistent.)
For more information about the SNA network data file, refer to the
HP-UX SNAplus2 Administration Command Reference.
HP-UX Clients
For UNIXA client computer does not contain a configuration file or SNA network
data file. Instead, the client has a client network data file that holds the
information it needs to access servers on the SNAplus2 LAN. The client
relies on a server to provide the necessary configuration information.
Most of the details of using HP-UX client computers are the same as
those for a server, except that the client has no node resources to define
and manage. The following references provide more details about using a
client:
• To start and stop the SNAplus2 software, see Chapter 3,
“Administering SNAplus2.”
• To set up information required to support invokable TPs on the client,
see “Defining TPs”.
• To manage the SNA network information required to access servers
on the SNAplus2 LAN, see Chapter 11, “Managing SNAplus2
Clients,” or refer to the HP-UX SNAplus2 Administration CommandReference.
• To manage diagnostics information (logging and tracing), see
“Diagnostic Tools”, or for more detailed information, refer to the
HP-UX SNAplus2 Diagnostics Guide.
88Chapter 2
Introduction to SNAplus2
SNAplus2 Components
End of Section
Windows Clients
For WindowsSNAplus2 enables machines running Microsoft Windows 3.1, Windows
for Workgroups 3.11, Windows 95, Windows NT, and OS/2 to act as
clients in the SNAplus2 domain. You can run either a 16-bit version of
the SNAplus2 client software (referred to in this guide as “Win16”) or a
32-bit version (referred to in this guide as “Win32”):
• The 16-bit version can be installed on machines running Windows 3.1
or Windows for Workgroups 3.11, or on Win16 subsystems on
Windows NT, Windows 95, or OS/2. SNA network information, and
other configuration information required by Win16 clients, is held in
the sna.ini file.
• The 32-bit version can be installed on machines running Windows 95
or Windows NT. Configuration information required by Win32 clients
is managed through the Windows Program Registry.
For more information about the sna.ini file and the Windows Program
Registry, and about managing Windows clients, see Chapter 11,
“Managing SNAplus2 Clients.” For information about Windows SNA
APIs, see “Windows APIs”, or refer to the documentation provided with
Microsoft SNA Server.
End of Section
Chapter 289
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
• Ports
• Link stations
• Connection networks
• Session resources including the following:
• LUs (types 0–3 for 3270, RJE, and LUA communications, and
type 6.2 for APPC and CPI-C communications and for 5250
emulation)
• Modes and their associated classes of service
• Directory information
• Domain resources are additional resources that are available to all
nodes (not defined as part of a particular node) to support specific
user programs. Domain resources include the following:
• 3270 user information
• 5250 user information
• RJE workstation information
• CPI-C side information
• Logging levels
• Information about access to the UNIX command facility and
service point command facility
The following sections describe the various SNAplus2 resources, and
explain how those resources work together to support each type of user
program.
90Chapter 2
Introduction to SNAplus2
SNAplus2 Resources
NOTESome 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:
• DLCs (see “DLCs”).
If you use the Motif administration program to configure a port, the
corresponding DLC definition is created automatically. For
command-line administration, the DLC is configured separately.
• Ports (see “Ports”).
• Link stations (see “Link Stations”).
• Connection networks (see “Connection Networks”)
If you use the Motif administration program, you can define a
connection network as part of port configuration. For command-line
administration, a connection network is configured separately.
DLCs
A DLC is the component responsible for communication over a physical
link (or multiple links) using a specific data link protocol, such as SDLC
or token ring. Each DLC can manage one or more ports, as described in
“Ports”.
SNAplus2 provides support for the following data link protocols:
• Synchronous data link control (SDLC)
• X.25 QLLC (qualified logical link control), for which the X.25
communications software may be provided by your SNAplus2
supplier or by another supplier
• Token ring
• Ethernet (standard or IEEE 802.3)
• FDDI (Fiber Distributed Data Interface)
Chapter 291
Introduction to SNAplus2
SNAplus2 Resources
NOTEIn 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.
Ports
A port represents the local end of a communications link as a unique
access point in the network. In general, this corresponds to a single
physical access point such as an adapter card. However, some link
protocols (such as token ring) enable you to define multiple ports for a
single adapter; in this case, the different ports are distinguished by
addresses (such as the SAP address).
Each port is associated with a specific DLC. One or more ports can use
the same DLC.
Link Stations
A link station represents the logical path through the SNA network
between the SNAplus2 local node and a remote computer. The remote
computer can be any of the following:
• A host computer on which SNAplus2 accesses a host program using
3270, RJE, or LUA communications (or uses APPC or CPI-C for
program-to-program communications)
• A peer computer with SNAplus2 and the remote computer
communicating as equal partners (the typical arrangement in an
APPN network)
• A downstream computer that uses the SNAplus2 PU concentration
feature or DLUR feature as a gateway to access a host.
A link station is associated with a specific port. One or more link stations
can be defined on the same port.
Connection Networks
Connection networks cannot be used by LEN nodes.
Nodes that are connected to the same token ring, Ethernet, or FDDI
network have a direct communications path between all nodes, so that in
theory any two nodes can communicate directly. Such a network is
referred to as a shared-access transport facility (SATF).
92Chapter 2
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 information flowing on the network.
APPN enables you to set up this type of configuration without having to
define each link station explicitly, by defining a connection network (CN)
that represents the SATF. For each node on the SATF, you define one or
more ports used to access the connection network. Instead of defining a
link station to each remote node, you specify the name of a virtual
routing node (VRN) as part of the port definition.
You can think of the VRN as an imaginary node that represents all the
other nodes on the SATF; you can give it any name you like, but all nodes
on the SATF must use the same VRN name (and it must not match the
name of any of the real nodes on the SATF). The local node can establish
communications with any other node that has a port associated with the
same CN, by accessing the VRN (which represents all the other nodes
attached to the SATF), instead of requiring an explicitly defined
communications path between each pair of nodes.
When two nodes on the SATF need to communicate and both have a port
defined with the same VRN name, APPN can dynamically establish a
direct connection between them; you do not need any additional
configuration.
Because the connection is direct and does not need to go through any
intermediate nodes, using a connection network reduces traffic on the
LAN and improves performance. You should use connection networks
wherever possible to take advantage of this.
You can define CNs for communications using token ring, FDDI or
Ethernet DLCs.
To use this feature, you first define a DLC and port for each node that
accesses the SATF, and indicate that the port should be defined on the
connection network. You do not need to define any link stations;
SNAplus2 sets up a dynamic link station to the CN (and hence to any
port on it) when required.
NOTEIn the Motif administration program, CNs are not shown as a separate
resource, but are included as part of the configuration of SATF ports.
Chapter 293
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 node's point of contact with a user program (3270
emulation program, RJE workstation, APPC TP, CPI-C application, or
LUA application). LUs are divided into two categories:
Dependent LUs
Type 0–3 LUs are referred to as dependent LUs; they
can support only one user session at a time, and a
session is controlled by the host program. Type 6.2 LUs
can also be dependent LUs if they are used to
communicate with host computers running older
versions of SNA host software.
LU types 0–3 are sometimes referred to as “old LUs,”
and are used to communicate with hosts using 3270
emulation, RJE,or LUA.
Type 0–3 LUs can also be grouped into LU pools, as
described in “LU Pools”. In addition, dependent type
6.2 LUs can be assigned to default pools, as described
in “Default LUs”.
Independent LUs
LU type 6.2 is used to communicate with either hosts
or peer computers using APPC or CPI-C.
Type 6.2 LUs that are used to communicate with peer
computers, or with newer SNA software on host
computers, are referred to as independent LUs.
Independent LUs can support multiple user sessions
simultaneously.
Dynamic Definition of Dependent LUs. Dynamic definition of
dependent LUs (DDDLU) is a host feature that enables dependent LUs
on the SNA system to be added to the host configuration when the
communication link from the SNA system to the host is established.
94Chapter 2
Introduction to SNAplus2
SNAplus2 Resources
With DDDLU, LUs do not have to be configured statically at the host.
(You 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-capable hosts, with no difference in the configuration
required. When the communications link from the SNAplus2 node to the
host is established, a DDDLU-capable host informs the node that it
supports DDDLU; the node then sends the required information to
define the dependent LUs that use the link. If the host is not
DDDLU-capable, SNAplus2 does not send this information; it assumes
that the LUs have already been defined statically at the host.
LU Pools. Type 0–3 LUs can also be grouped into LU pools, so that a
user session can be assigned to a pool of LUs. For 3270, RJE, and LUA
applications, you can use LU pools to simplify configuration and give
greater flexibility.
All of the LUs in a pool must be the same type. For example, you can
define several 3270 display LUs in a single LU pool, then configure
multiple 3270 display sessions using this LU pool. This makes
configuring 3270 sessions easier and enables any 3270 session to use any
LU in the pool.
LU pools can also span multiple SNAplus2 servers—just define LU pools
with identical names on the different servers. Clients that use the LU
pool can then use any server. This means that the clients can still be
used if a server fails or is taken out of service. Using LU pools also
simplifies client configuration and makes it easy to increase capacity by
adding another server or by adding LUs on an existing server.
LU pools support the following operations:
• Assigning LUs to users on a “first come, first served” basis when there
are more users than LUs.
• Balancing the traffic from user sessions across multiple servers or
multiple host links, by defining a pool containing LUs on more than
one node or on more than one host link.
• Permitting access to more than one host system from the same
configuration, so that if one host system becomes unavailable,
sessions can still be established to another system without requiring
reconfiguration.
Chapter 295
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 may 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 an unused LU from the pool of default LUs.
An application requesting a default LU can be assigned to any of these
LUs as available; the LU does not need to be on the same computer as
the application. However, if you are defining partner LUs for the
applications, the partner LUs must be defined on all nodes where default
LUs are defined, so that the application can contact the correct partner
LU using any of the default local LUs defined on any node.
Modes and Classes of Service
A mode specifies a set of characteristics that a type 6.2 local LU uses to
communicate with its partner LU. These characteristics include
information about the way data is transmitted between the two LUs
(such as maximum RU size and pacing window sizes), and about whether
the LUs can establish parallel sessions.
The definition of a mode can also include the name of a class of service
(COS), which specifies minimum and maximum acceptable values for
characteristics such as transmission time, transmission cost, and
network security, together with weightings associated with different
ranges of these values. This enables the node to calculate the best route
across the network when two or more routes to the same remote LU are
available. The configuration of the SNAplus2 node specifies whether the
node performs explicit mapping between modes and COSs. If explicit
mapping is not supported, you do not need to associate a COS with the
mode; the COS name is determined dynamically.
Directory Information
APPN network and end nodes maintain dynamic directory information
about remote nodes and partner LUs. In addition, you can configure such
information directly. On a LEN node, you must configure directory
entries for each partner LU. You can also configure such resources
directly on an APPN end node or network node (for example, to eliminate
the need for a network node to locate a frequently used resource).
96Chapter 2
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.
For this reason, only one definition is required for each such resource .
Chapter 297
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
administration tasks you must perform and the tools you can use to
perform them.
Administration Responsibilities
To administer the SNAplus2 system, you need to do the following:
Step 1. Define the resources of the SNAplus2 system, as required by the user
programs that will be running. Work with the administrators of the host
or peer computers with which SNAplus2 communicates, to ensure that
the SNAplus2 configuration matches that of the remote system.
Step 2. Initialize the SNAplus2 software.
Step 3. Optionally, modify the configuration dynamically as your requirements
change—by adding or removing resources, or by activating and
deactivating the defined resources.
Step 4. Monitor the status of active resources and gather diagnostics
information to diagnose any problems that occur.
Step 5. Optionally, create application programs or shell scripts to automate
standard management operations.
These tasks are normally performed by a System Administrator at the
site where the SNAplus2 system is installed. However, SNAplus2 also
provides the service point command facility (SPCF), which enables an
operator using the NetView program to perform Steps 3 and 4 remotely
by issuing management commands at the NetView console. For more
information about SPCF, see Chapter 10, “Managing SNAplus2 from
NetView.”
98Chapter 2
Introduction to SNAplus2
SNAplus2 Administration
Administration Tools
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.
NOTEThis document provides general information about SNAplus2
administration, which you can perform using any of the tools described
in this section. For most purposes, the Motif administration program is
recommended, because it provides context-sensitive guidance for node
configuration and management.
SNAplus2 includes the following administration tools:
• Motif administration program (see “Motif Administration Program”).
• Command-line administration program (see “Command-Line
Administration Program”, or refer to the HP-UX SNAplus2Administration Command Reference).
• Service-point command facility (see “Remote Command Facility”).
All of the SNAplus2 administration tools use the NOF API. You can also
use that API to write your own administration tools. For more
information, see “NOF Applications”.
Motif Administration Program
The easiest way to define and modify the SNAplus2 configuration is to
use the Motif administration program (xsnapadmin). This program
provides a graphical user interface from which you can view and manage
SNAplus2 resources.
The following management operations are available:
• Defining SNAplus2 resources
• Starting and stopping a node and its connectivity resources
• Changing the configuration of defined resources
Chapter 299
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) and domain resources. For each type of
communications (such as 3270 or APPC), the program guides you in
setting up the configuration of the required resources.
NOTEThe windows and dialogs in the Motif administration program may differ
from those shown in this guide, depending on the functions included with
your installation of SNAplus2 and the choices you make on a particular
dialog.
The Motif administration program includes help screens that provide
overview information for SNA and SNAplus2, reference information for
SNAplus2 dialogs, and guidance for performing specific tasks.
Before starting the Motif administration program, make sure the
SNAplus2 software is enabled. For more information, see Chapter 3,
“Administering SNAplus2.”
To start the Motif administration program in the background, issue the
following command:
xsnapadmin &
All started SNAplus2 servers are shown on the main screen. For those
that have already been configured, the program enables you to select a
node, and then displays the selected node's configuration. Otherwise, the
program prompts you to select a node and leads you through the
required steps to define it.
For more information about how to use the Motif administration
program to define and manage SNAplus2 resources, see “Invoking the
Motif Administration Program”, or refer to the help screens provided by
the program.
NOTEThe Motif administration program enables you to set up all required
parameters for standard SNAplus2 configurations. For advanced
parameters, the Motif administration program supplies default values.
You need to supply only the essential configuration information, which
enables you to set up SNA communications quickly and easily.
100Chapter 2
Loading...
+ hidden pages
You need points to download manuals.
1 point = 1 manual.
You can buy points or you can get point for every manual you upload.