HP 3000 Manuals

SNA IMF Programmer's Reference Manual

SNA IMF Programmer's Reference Manual 

HP AdvanceNet
Printed in U.S.A.
HP Part No.  30293-61005
Edition Edition 2
E0692


(c) Copyright 1990, 1992 Hewlett-Packard Company.

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 
19420 Homestead Road 
Cupertino, CA 95014 U.S.A. 
Printed 06/92

Notice 

Hewlett-Packard makes no warranty of any kind with regard to this 
material, including, but not limited to, the implied warranties of 
merchantability and fitness for a particular purpose.  Hewlett-Packard
shall not be liable for errors contained herein or for incidental or
consequential damages in connection with the furnishing, performance, or
use of this material.

Hewlett-Packard assumes no responsibility for the use or reliability of
its software on equipment that is not furnished by Hewlett-Packard.

This document contains proprietary information, which is protected by
copyright.  All rights are reserved.  No part of this document may be
photocopied, reproduced, or translated to another language without the
prior written consent of Hewlett-Packard Company.  The information
contained in this document is subject to change without notice.

Printing History 

New editions are complete revisions of the manual.  Update packages,
which are issued between editions, contain additional and replacement
pages to be merged into the manual by the customer.  The dates on the
title page change only when a new edition or a new update is published.
No information is incorporated into a reprinting unless it appears as a
prior update; the edition does not change when an update is incorporated.

Note that many product updates and fixes do not require manual changes
and, conversely, manual corrections may be done without accompanying
product changes.  Therefore, do not expect a one-to-one correspondence
between product updates and manual updates.

       First Edition   ................................... December 1990

       Second Edition   ...................................... June 1992

List of Effective Pages 

The List of Effective Pages gives the date of the current edition and of
any pages changed in updates to that edition.  Within the manual, any
page changed since the last edition is indicated by printing the date the
changes were made on the bottom of the page.  Changes are marked with a
vertical bar in the margin.  If an update is incorporated when an edition
is reprinted, these bars are removed but the dates remain.  No
information is incorporated into a reprinting unless it appears as a
prior update.

       Pages                                              Effective Date 

       All  .................................................. June 1992

Preface 

Introduction 

This manual describes Hewlett-Packard's Systems Network Architecture
Interactive Mainframe Facility (SNA IMF) for both the MPE V (SNA IMF/V)
and MPE XL (SNA IMF/XL) operating systems.  Systems Network Architecture
(SNA) is IBM's specification for distributed data processing networks.
This manual describes the features and uses of Hewlett-Packard's SNA IMF,
which communicates in an SNA environment.


NOTE  In this manual, the term SNA IMF is used when the information being
      given is true for both SNA IMF/V and SNA IMF/XL. The terms SNA 
      IMF/V and SNA IMF/XL are used when a distinction between the two
      systems is necessary.

      MPE/iX, Multiprogramming Executive with Integrated POSIX, is the
      latest in a series of forward-compatible operating systems for the
      HP 3000 line of computers.

      In HP documentation and in talking with HP 3000 users, you will
      encounter references to MPE XL, the direct predecessor of MPE/iX.
      MPE/iX is a superset of MPE XL. All programs written for MPE XL
      will run without change under MPE/iX. You can continue to use MPE
      XL system documentation, although it may not refer to features
      added to the operating system to support POSIX (for example,
      hierarchical directories).

      Finally, you may encounter references to MPE V, which is the
      operating system for HP 3000s, not based on the PA-RISC
      architecture.  MPE V software can be run on the PA-RISC (Series
      900) HP 3000s in what is known as compatibility mode.


SNA IMF allows interactive and programmatic communications between an HP
3000 computer and an IBM host computer.  SNA IMF emulates an IBM 3274
cluster controller, with attached 3278 display stations and 3287
printers, functioning as a Type 2 node in an SNA network.

This manual describes SNA IMF intrinsics, the programmatic interface to
SNA IMF. SNA IMF intrinsics allow communication between applications on
the HP 3000 and applications on the remote host.

For information on Pass Thru, SNA IMF's interactive interface, see Using 
SNA IMF Pass Thru (30293-61008).

For information on installing, configuring, managing, and troubleshooting
SNA IMF, see the SNA IMF/XL Node Manager's Guide (30293-61000) for SNA
IMF/XL or Installing and Troubleshooting SNA IMF (30247-90002) for SNA
IMF/V.

Audience 

This manual is for anyone involved in 3270-type data communications
between an HP 3000 and an IBM host.  It is for any of the following types
of users:

   *   Application programmers, who develop applications that use SNA IMF
       intrinsics to communicate with applications running on a remote
       host.

   *   People responsible for training and supporting SNA IMF users.

   *   HP node managers or HP 3000 system managers responsible for HP
       3000 data communications.  The HP 3000 SNA node manager is
       responsible for overall HP-to-IBM data communications.

Some portions of this manual apply specifically to users of Asian
terminals and printers with double-byte characters sets (DBCS).

Each of these audience types should be familiar with the pertinent
operating characteristics of the host system in an SNA environment and
have a working knowledge of Multiprogramming Executive (MPE), the
operating system for the HP 3000.

Organization 

This manual is divided into the following chapters and appendixes:

Chapter 1, Introducing SNA IMF, gives an overview of SNA IMF, its
capabilities, and its operating environment, including software and
hardware requirements.

Chapter 2, Using SNA IMF Intrinsics, explains how to use SNA IMF
intrinsics to communicate programmatically with applications on a remote
host.

Chapter 3, Intrinsics Used with Standard MPE I/O, describes the SNA IMF
intrinsics that are used with standard (wait) I/O.

Chapter 4, Intrinsics Used with No-Wait I/O, explains how and when to use
no-wait I/O, and it describes the SNA IMF intrinsics that are used with
no-wait I/O.

Appendix A, Intrinsic Result Codes, lists all the result codes that can
be returned by SNA IMF intrinsics, describes their probable causes, and
recommends the actions you should take to resolve problems.

Appendix B, SNA Character String (SCS) Support, describes SCS control
codes and support for LU.T1 printers.

Appendix C, 3270 Bit Assignment and Character Translation Tables,
provides bit assignments for 3270 field attribute characters and write
control characters (WCC); lists the Attention ID codes generated by SNA
IMF; gives the command codes for the IBM cluster controller; supplies
3270 buffer control orders; and discusses character sets, character
translation tables, and Native Language Support.

Appendix D, Differences Between IMF/3000 and SNA IMF/V, compares the
similarities and differences between the two IMF products.  This appendix
is useful if you are migrating from the IMF/3000 product to SNA IMF/V.

Appendix E, HP and IBM Differences in DBCS Implementation, describes how
HP and IBM differ in their implementation of Asian Double-Byte Character
Sets (DBCS).

Appendix F, Sample Programs, gives examples of programs that call SNA IMF
intrinsics in transparent and non-transparent modes.

Appendix G, Migrating Applications from SNA IMF/V to SNA IMF/XL, 
describes the changes that must be made to an SNA IMF/V application
before it will run on SNA IMF/XL.

Related Publications 

You can find additional information about related topics in the following
manuals:

   *   Communicating With IBM (5957-4623)

   *   Getting Started With SNA Node Management (30246-90002) (MPE V
       only)

   *   SNA Link Services Reference Manual (30246-90003) (MPE V only)

   *   SNA Link/XL Node Manager's Guide (30291-61000) (MPE XL only)

   *   HP SNA Server/Access User's Guide (30254-61000)

   *   Using the Node Management Services Utilities (32022-61005)

   *   Installing and Troubleshooting SNA IMF (30247-90002) (MPE V only)

   *   SNA IMF/XL Node Manager's Guide (30293-61000) (MPE XL only)

   *   Using SNA IMF Pass Thru (30293-61008)

   *   SNA IMF/XL Taiwanese User Support Guide (30293-60211)

   *   SNA IMF/XL Japanese User Support Guide (30293-60221)

   *   SNA IMF/XL Korean User Support Guide (30293-60231)

   *   IMF/3000 User/Programmer Reference Manual (30250-90001) (for
       IMF/3000 on MPE V)

   *   MPE V Intrinsics Reference Manual (32033-90007)

   *   MPE V Commands Reference Manual (32033-90006)

   *   MPE XL Intrinsics Reference Manual (32650-60013)

   *   MPE XL Commands Reference Manual (32650-60002)

   *   Native Language Support Reference Manual (32414-90001)

   *   FORTRAN/3000 Reference Manual (30000-90040) (MPE V only)

   *   FORTRAN 77/XL Reference Manual (31501-60002) (MPE XL only)

   *   COBOL II/3000 Reference Manual (32233-90001) (MPE V only)

   *   COBOL II Reference Manual (31500-60001) (MPE XL only)

   *   HP Business BASIC Reference Manual (32115-90001) (MPE V only)

   *   BASIC/XL Reference Manual (32715-60001) (MPE XL only)

   *   Pascal/3000 Reference Manual (32106-90001) (MPE V only)

   *   Pascal Reference Manual (31502-60005) (MPE XL only)

   *   HP C/XL Reference Manual (31506-60001)

   *   HP SNA Products:  IBM Host System Programmer's Guides:

          *   HP SNA Products:  Manager Guide (5958-8542)

          *   HP SNA Products:  ACF/NCP and ACF/VTAM Guide (5958-8543)

          *   HP SNA Products:  IMS Guide (5958-8545)

          *   HP SNA Products:  CICS Guide (5958-8546)

          *   HP SNA Products:  AS/400 Guide (5960-1629)

Syntax Conventions 

nonitalics 

Words in syntax statements which are not in italics must be entered
exactly as shown.  Punctuation characters other than brackets, braces and
ellipses must also be entered exactly as shown.  For example:

     EXIT;

italics 

Words in syntax statements which are in italics denote a parameter which
must be replaced by a user-supplied variable.  For example:

     CLOSE  filename 

[ ] 

An element inside brackets in a syntax statement is optional.  Several
elements stacked inside brackets means the user may select any one or
none of these elements.  For example:

       [A]
       [B]            You may select A or B or C or none.
       [C]

{ } 

When several elements are stacked within braces in a syntax statement,
the user must select one of those elements.  For example:

       {A}
       {B}         User must select A or B or C.
       {C}

... 

A horizontal ellipsis in a syntax statement indicates that a previous
element may be repeated.  For example:

     [,itemname]...;

In addition, vertical and horizontal ellipses may be used in examples to
indicate that portions of the example have been omitted.

\_ 

When necessary for clarity, the symbol _ may be used in a syntax
statement to indicate a required blank or an exact number of blanks.  For
example:

     SET[modifier]_(variable)

underlining 

Output and input/output parameters are underlined.  A notation in the
description of each parameter distinguishes input/output from output
parameters.  For example:

     CREATE (parm1,parm2,flags,error)

Key Cap 

A string enclosed by brackets may be used to indicate a key on the
terminal's keyboard.  For example, Enter indicates the carriage return
key.

CTRL-char 

Control characters are indicated by CTRL followed by the character.  For
example, CTRL-y means the user presses the control key and the character
y simultaneously.

Documentation Map 


            

MPE/iX 5.0 Documentation