Chapter 6. IRIS SNA SERVER Product Features and Implemented Functions

This appendix describes the product features and supported function sets for the IRIS SNA SERVER and the LU 0-3 API. Refer to the IRIS SNA LU 6.2 Programming Guide if you have the optional IRIS SNA LU 6.2 product.

Product Features

This section describes the product features of the IRIS SNA SERVER,
LU 0-3 API, IRIS SNA LU 6.2, IRIS Token Ring, and IRIS SDLC.

IRIS SNA SERVER

These features are provided by the IRIS SNA SERVER:

  • IRIS SNAView

The SNA Graphical User Interface for the IRIS SNA SERVER. It is an X Window and Motif-based network management tool that facilitates configuring and operating the IRIS SNA SERVER and managing IRIS SNA LU 6.2 sessions. The main window serves as the central information and operations panel. All of the pertinent information needed to configure and use the IRIS SNA SERVER is accessible through this window and its secondary windows and related dialog boxes.

  • PU 2.0/PU 2.1 Support

The IRIS SNA SERVER can function as a PU 2.1 peer node, communicating with another peer node, or as a PU 2.0 peripheral node in an SNA network controlled by a Systems Services Control Point (SSCP). This function makes the product upwardly compatible with current SNA networks and provides support for LU 6.2 sessions with a host running Customer Information Control System (CICS). When multiple links (physical connections) are supported, the product simultaneously can act as a PU 2.0 node on one link and as a PU 2.1 node on another link.

  • SDLC Protocol

The IRIS SNA SERVER supports communications through an SDLC link. The IRIS SNA SERVER is capable of performing either the primary or secondary link-station role. The link-station role can be pre-configured or negotiated with the partner when the link is activated. Switched lines are supported in either calling or answering mode.

  • Token Ring Protocol

The IRIS SNA SERVER supports communications over both 4 or 16 megabit token ring links (user selectable). It can be configured as a Downstream PU (DSPU) to connect to an IBM host or as a peer node to communicate with other ring stations that support peer communications protocol. Token ring supports IBM Source Routing.

  • Multiple Concurrent Link Support

The IRIS SNA SERVER supports multiple physical links. Each link can be connected to any combination of PU 2.1, PU 4, or PU 5 devices. Individual link activation and deactivation are independent of other physical connections.

  • Application Program Interface

The API provides you with the tools and routines to write applications that define network resources and control network operations. These verb-interface functions are implemented as C- language library functions. The libraries are installed as
/user/lib/libsna.a and /usr/lib/liblu03.a. Also, a directory of header files required for the verbs is installed in /usr/include/sna. See the IRIS SNA SERVER Programming Guide and the IRIS SNA LU 6.2 Programming Guide for additional information on programming with the API interface.

  • Different Modes of Service

LUs can be configured to support different modes of service since transaction programs identify the desired mode of service when a conversation is requested. This means some sessions can be reserved for very short conversations. You can associate line characteristics with these modes. For example, you can configure some sessions to use a high-speed line and others to use a slower line.

LU 0-3 API

This section summarizes the LU 0-3 API product features.

  • Distributed Verb Interface

The PI verbs, as well as all the API verbs of SNA, are implemented so that the application using them does not have to execute on the same workstation or server as the IRIS SNA Scheduler. This functionality supports configurations in which the applications run in processors connected to an IRIS SNA Scheduler by a Local Area Network.

  • Dynamic or Static Allocation of LU Addresses

A logical unit session can be configured to utilize a specific address or any available address from a pool of addresses. If host security requires each end user to have a pre-defined network address, then this can be enforced by requiring the logical unit session to utilize the same network address for all host communications. If, however, network addresses can be shared among the end-user community, then the logical unit sessions can be configured to utilize the first available address on a network link.

  • Dynamic Allocation of LUs to an Application

An application can allocate an LU during execution and does not have to preconfigure itself to a particular LU.

  • Sequential Sharing of Sessions

Sessions may be brought up by one application, then used by other applications in turn, which enables cooperating applications to reduce the overhead associated with session establishment.

  • Individual Access to SSCP-LU and LU-LU Sessions

Data can be sent or received on both the SSCP-LU (System Service Control Point to Logical Unit) and LU-to-LU sessions.

  • Data Received at the Segment Level

The application can request that it receive the data when an entire chain has arrived, when a single Request/Response Unit (RU) has arrived, or as each segment arrives. This capability is a performance option, typically used by screen-emulation programs.

  • Sync-Point Services

The application can obtain and set sync-point values.

  • Network Management Support

An application can send and receive Function Management Data Network Server (Maintenance) or FMD NS(MA) request units on the SSCP-PU session. Sending and receiving data is similar to exchanging data on the LU sessions. Internal statistics are also maintained by the IRIS SNA Scheduler. These statistics can be retrieved by an application and reported to the appropriate network management facility.

  • Multiple Host Connections

Since the underlying PU 2.1 supports multiple links, the same IRIS SNA Scheduler can connect to several different hosts simultaneously, or appear as several Physical Units to the same host.

  • TCP/IP Support

The IRIS SNA SERVER communicates with LU 0-3 application programs through sockets. An end user can run these application programs at a workstation other than the one on which the IRIS SNA SERVER is running.

IRIS SNA LU 6.2

This section describes the major features of IRIS SNA LU 6.2. For additional information, see the IRIS SNA LU 6.2 Programming Guide.

  • Parallel Sessions

IRIS SNA LU 6.2 supports parallel sessions. The number of Logical Units that can be active within a single node is limited by the memory size established for the IRIS SNA SERVER. Each active LU is capable of initiating up to 254 sessions per physical link and accepting up to 254 sessions initiated by each partner LU. Each LU is configured to accept automatically, at LU start-up, a preset number of sessions with each partner LU. A maximum number of sessions is also configured. If a free session is not available when a transaction program requires one, the LU automatically initiates sessions up to the configured limit.

  • Remote Program Initiation

The LU has the capability to start processes at the request of its partner and to pass Program Initialization Parameter (PIP) data. The new process is connected to its partner program at the initiating LU by the conversation that carried the initiation request.

  • The Application Program Interface

The Application Program Interface (API) provides tools and routines that enable programmers to write Advanced Program-to-Program Communication (APPC) programs that use the resources of IRIS SNA LU 6.2. The verb-interface functions are implemented as C-language library functions. These functions are fully documented in Appendix C, Man Pages, in the IRIS SNA LU 6.2 Programming Guide.

  • Different Modes of Service

It is possible to configure an LU to support different modes of service. Transaction programs identify the desired mode of service when a conversation request is made. This feature can be used to reserve some sessions for very short conversations. You can associate line characteristics with these modes. For example, some sessions can be configured to use a high-speed line while others use a slower one.

  • Sessions within the Same Node

The partner LU does not have to reside in another node, or even be a different LU, which is advantageous for server programs. For instance, a transaction program can be written to access a database server using the LU services. Whether that database server happens to be physically located on the same node, or is on another node is transparent to the transaction program.

  • Conversations

The LU can initiate and maintain sessions that are not in current use by any transaction program. When a transaction program requests a session, the LU allocates a session to it. When the transaction program is through with it, the session is returned to the list of free sessions. Each session use by a transaction program is considered a conversation. (A conversation is a logical connection between a pair of transaction programs that permits them to share an LU-LU session serially from transaction to transaction.) This use of conversations eliminates the need to initiate and terminate a session each time a program needs one, thereby reducing system overhead.

IRIS SNA LU 6.2 provides mapped conversation, as well as basic conversation capabilities. With mapped conversations, application programs do not need to be concerned with any specialized data streams used by a specific product. All data that is sent is converted into a standard format and original form at the receiving end. No automatic conversion is performed with basic conversations.

  • Delayed Acquisition of Sessions

A transaction program can obtain a conversation and begin to use it while delaying the acquisition of a session until it is needed.

  • TCP/IP Support

The IRIS SNA SERVER communicates with IRIS SNA LU 6.2 transaction programs by means of the TCP/IP socket. An LU 6.2 transaction program can be executed from a TCP/IP node and can engage a conversation with another SNA LU 6.2 transaction program, using an IRIS SNA SERVER workstation as a gateway.

IRIS Token Ring

IRIS Token Ring software provides token-ring connectivity for the IRIS-4D system at either 4 or 16 megabits per second, compliant with IEEE 802.2 and 802.5 standards. IRIS Token Ring software also provides:

  • Source Routing support

  • Concurrent support of up to 4 token ring and/or SDLC adapters

  • TCP/IP protocols for IRIS SNA SERVER access over Ethernet or token ring from IRIS SNA application software such as IRIS SNA 3270, IRIS SNA 3770, or IRIS SNA LU 6.2.

IRIS SDLC

IRIS SDLC communications connectivity provides these features:

  • SDLC link protocol support, primary or secondary

  • Multiple concurrent link support (up to four ports)

  • Up to 56 Kbps SDLC link speed

  • Leased and dial-up SDLC line support

  • Synchronous auto dial language (SADL) support over the SDLC line

IRIS SNA SERVER Function Set

The basic functions of the IRIS SNA SERVER are outlined below.

PU Type 2.1 Base Set Capabilities

The following PU Type 2.1 base set capabilities are supported:

  • Support one LU-LU session per LU (session limit = 1)

  • Act as a PU 2.0 peripheral node

  • Attach to an SNA host-controlled network

  • Initiate and receive negotiable BINDs

  • Receive actlu and actpu

  • Receive dactlu (Normal and SON) and dactpu (Final, Not Final, and SON)

  • Support for one link station

PU Type 2.1 Option Sets Supported

The following PU Type 2.1 options sets are supported:

  • Session limit >1 (multiple session, one per partner LU)

  • Parallel sessions (multiple sessions with the same partner)

  • Ability to send REQDISCONT (Request Disconnect)

  • Support for more than one link station, with the necessary Directory Service to support this option

  • Session-level segmentation and segment assembly

Additional Node-level Capabilities

The following additional node-level capabilities are supported:

  • Multipoint line support when acting as a primary SDLC station

  • Multiple concurrently active physical links

  • Dial-in and dial-out capability for switched connections

  • Programmable node operator verb interface

  • Logging of both error and status messages

SNA RU Support by Category

A listing of the SNA RU support by category follows.

Session Control

  • ACTLU TYPE (COLD, ERP)

  • ACTPU TYPE (COLD, ERP)

  • BIND

  • DACTLU TYPE (NORMAL, SON)

  • DACTPU TYPE (FINAL, NOT FINAL, SON)

  • UNBIND

Data Flow Control

  • BIS

  • LUSTAT

  • RTR

  • SIG

SDLC Support

A list of the unnumbered and supervisory commands and responses follow:

SNRM Set Normal Response Mode

RR Ready to Receive

RD Request Disconnect

RNR Receiver Not Ready

DISC Disconnect

UA Unnumbered Acknowledgment

DM Disconnect Mode Information Frames

FRMR Frame Reject

TEST Test Information

XID Exchange Identification (XID Format 3)

LU 0-3 API Function Set

This section lists the Function Management (FM) and Transmission Services (TS) profiles and the RU support provided by the product.

Function Management Profiles

FM Profile 0: SSCP-PU and SSCP-LU Sessions
Profile 0 specifies the following session rules:

  • Primary and secondary half-sessions use immediate request mode and immediate response mode.

  • Only single-RU chains are allowed.

  • Primary and secondary half-session chains indicate definite response.

  • No compression.

  • Primary half-session sends no DFC RUs.

  • Secondary half-session may send LUSTAT.

  • No FM headers.

  • No brackets.

  • No alternate code.

  • Normal-flow send/receive mode is full-duplex.

FM Profile 3: LU-LU Sessions
Profile 3 specifies the following session rules:

  • Primary LU half-session and secondary LU half-session use immediate response mode.

  • Primary LU half-session and secondary LU half-session support the following DFC functions:

    • CANCEL

    • SIGNAL

    • LUSTAT (allowed secondary to primary only)

    • CHASE

    • SHUTD

    • SHUTC

    • RSHUTD

    • BID and RTR (allowed only if brackets are used)

These FM usage fields define the options for Profile 3:

  • Chaining use (primary and secondary).

  • Request control-mode selection (primary and secondary).

  • Chain response protocol (primary and secondary).

  • Compression indicator (primary and secondary).

  • Send EB indicator (primary and secondary).

  • FM header usage.

  • Bracket usage and reset state.

  • Bracket termination rule.

  • Alternate Code Set Allowed indicator.

  • Normal-flow send/receive mode.

  • Recovery responsibility.

  • Contention winner/loser.

  • Half-duplex flip-flop reset states.

Product exceptions to the profile are:

  • Normal-flow send/receive mode of full-duplex is not supported.

  • Secondary LU is always first speaker.

FM Profile 4: LU-LU Sessions
Profile 4 specifies the following session rules:

  • Primary LU half-session and secondary LU half-session use immediate-response mode.

  • Primary LU half-session and secondary LU half-session support the following DFC functions:

    • CANCEL

    • SIGNAL

    • LUSTAT

    • QEC

    • QC

    • RELQ

    • SHUTD

    • SHUTC

    • RSHUTD

    • CHASE

    • BID and RTR (allowed only if brackets are used)

These FM usage fields define the options for Profile 4:

  • Chaining use (primary and secondary).

  • Request control-mode selection (primary and secondary).

  • Chain-response protocol (primary and secondary).

  • Compression indicator (primary and secondary).

  • Send EB indicator (primary and secondary).

  • FM header usage.

  • Bracket usage and reset state.

  • Bracket-termination rule.

  • Alternate Code Set Allowed indicator.

  • Normal-flow send/receive mode.

  • Recovery responsibility.

  • Contention winner/loser.

  • Half-duplex flip-flop reset states.

Product exceptions to the profile are:

  • Normal-flow send/receive mode of full-duplex is not supported.

  • Secondary LU is always first speaker.

Transmission Services Profiles

TS Profile 1: SSCP-PU and SSCP-LU Sessions
Profile 1 specifies the following session rules:

  • No pacing.

  • Identifiers, rather than sequence numbers, are used on the normal flows (whenever the TH format used includes a sequence number field).

  • SDT, CLEAR, RQR, STSN, and CRV are not supported.

  • Maximum RU size on the normal flow for either half-session is 256, unless a different value is specified in RSP(ACTLU).

This profile does not require the use of the TS usage field.

TS Profile 3: LU-LU Sessions
Profile 3 specifies the following session rules:

  • Primary-to-secondary and secondary-to-primary normal flows are paced.

  • Sequence numbers are used on the normal flows (whenever the TH format used includes a sequence number field).

  • CLEAR and SDT are supported.

  • RQR and STSN are not supported.

These TS usage subfields define this profile's options:

  • Pacing window counts.

  • Maximum RU sizes on the normal flow.

The product exception to the profile is:

  • Session-level cryptography.

TS Profile 4: LU-LU Sessions
Profile 4 specifies the following session rules:

  • Primary-to-secondary and secondary-to-primary normal flows are paced.

  • Sequence numbers are used on the normal flows (whenever the TH format used includes a sequence number field).

  • SDT, CLEAR, RQR, and STSN are supported.

These TS usage subfields define this profile's options:

  • Pacing window counts.

  • Maximum RU sizes on the normal flow.

The product exception to the profile is Session-level cryptography.

RU Support

Table A-1 shows the SNA RUs supported by the interface and the type of support provided. The word SEND indicates that the RU can be sent by an application; RECEIVE indicates that the SNA Scheduler forwards the RU to the application untouched (the application is responsible for the response); and NOTIFIED indicates that the SNA Scheduler creates and sends a response to the RU, then forwards the RU to the application.

Interface Send Receive Notified

Session Control RQR BIND ACTLU
UNBIND ACTPU
CLEAR
DACTLU
DACTPU
STSN
SDT
UNBIND

Data Flow Control CANCEL BID CANCEL
CHASE CHASE LUSTAT
LUSTAT SIGNAL QC
QC QEC
QEC RELQ
RELQ SHUTD
RSHUT
RTR
SHUTC
SIGNAL

FMD INITSELF ECHOTEST NOTIFY
NMVT NMVT NSPE
NOTIFY REQMS
RECFMS
REQECHO
TERMSELF

SNA RU Support