HP 3000 Manuals

Using SNA IMF Pass Thru

Using SNA IMF Pass Thru 

HP AdvanceNet
Printed in U.S.A.
HP Part No.  30293-61008
Edition Edition 1
E1290


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

Hewlett-Packard Company
19420 Homestead Road
Cupertino, CA 95014 U.S.A.

Printed 19901201

Notice 

HEWLETT-PACKARD COMPANY MAKES NO WARRANTY OF ANY KIND WITH REGARD TO THIS
MATERIAL, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES OF
MERCHANT ABILITY AND FITNESS FOR A PARTICULAR PURPOSE. Hewlett-Packard
Company 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 Company assumes no responsibility for the use or
reliability of its software on equipment that is not furnished by
Hewlett-Packard Company.

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 into 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

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                   December 1990
Documentation Map 


            

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.


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 Pass Thru, the interactive interface to SNA IMF.

SNA IMF intrinsics, the programmatic interface to SNA IMF, allow
communication between applications on the HP 3000 and applications on the
remote host.  SNA IMF intrinsics are described in the SNA IMF 
Programmer's Reference Manual (30293-61005).

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:

   *   Interactive terminal users who use SNA IMF Pass Thru to access the
       host directly from a terminal attached to an HP 3000.

   *   HP 3000 application programmers who use SNA IMF Pass Thru to help
       develop and debug their SNA IMF programs.

   *   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, Configuring Pass Thru, explains how to create the file
PTCONFIG.PUB.SYS, which SNA IMF Pass Thru uses to determine the functions
of your rolling softkeys and various other Pass Thru options.

Chapter 3, Starting Pass Thru, explains how to start up SNA IMF Pass Thru
for terminals and printers.

Chapter 4, Stopping Pass Thru, explains how to terminate a Pass Thru
session for a terminal or a printer.

Chapter 5, Using Terminals with Pass Thru, describes the Pass Thru
characteristics and features of HP terminals and how they compare with
IBM terminals.  It also describes how to set terminal transmission
speeds, how to display session status information on your terminal, and
how to access the MPE command interpreter from a Pass Thru session.

Chapter 6, Using Printers with Pass Thru, explains how to use Pass Thru
to emulate an LU.T1 or LU.T3 printer.

Chapter 7, Pass Thru Over X.25, explains how to use Pass Thru to
communicate with the remote host from a PAD device in an X.25 network.

Appendix A, Pass Thru Messages, lists the messages that Pass Thru can
generate, the probable causes of the messages, and the actions you can
take to resolve problems.

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

Appendix C, Pass Thru Terminal and Printer Specifications, lists the HP
terminals and printers that you can use with Pass Thru.

Appendix D, Sample PTCONFIG File, provides a sample Pass Thru
configuration file for you to use as a guideline when you create your own
PTCONFIG file.

Appendix E, 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 F, 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 G, HP and IBM Differences in DBCS Implementation, describes how
HP and IBM differ in their implementation of Asian Double-Byte Character
Sets (DBCS).

Related Publications 

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

   *   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)

   *   SNA IMF Programmer's Reference Manual (30293-61005)

   *   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)

   *   HP SNA Products:  Manager's 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)

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 that are in italics denote a parameter that
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 indicates the user may select any one or
none of these elements.  For example:

     [A]
     [B]            User 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)

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 Y key
simultaneously.

MPE/iX 5.0 Documentation