HP 3000 Manuals HP 3000 Manuals
Product HP AdvanceNet SNA NRJE User/Programmer Reference Manual HP Part No. 30292-61001 Printed Apr 1990 Edition 4 E0490 Printed in U.S.A.
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. Æ Copyright 1990, 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 to another language without the prior written consent of Hewlett-Packard Company. The information contained in this document is subject to change without notice. Hewlett-Packard Co. 19420 Homestead Rd. Cupertino, CA 95014 U.S.A. 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. Edition 1 February 1984 Edition 2 January 1986 Edition 3 May 1988 Edition 4 April 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 April 1990
Documentation Map The following documentation map is intended to be a general guideline to the manuals containing information related to the product described in this manual. You may need information from one or all the manuals listed here.Preface Introduction This manual describes Hewlett-Packard Company's Systems Network Architecture Network Remote Job Entry (SNA NRJE) for both the MPE V (NRJE/V) and MPE XL (NRJE/XL) operating systems. Systems Network Architecture (SNA) is a comprehensive specification for distributed data processing networks developed by IBM.
NOTE In this manual, the term NRJE is used when the information being given is true for both NRJE/V and NRJE/XL. The terms NRJE/V and NRJE/XL are used when a distinction between the two subsystems is necessary.
NRJE allows HP 3000 users to submit batch jobs to a remote host system for processing. The host system uses one of the supported job entry subsystems in an SNA environment. NRJE can be used in two ways: with commands or with programmatically callable intrinsics. Commands are processed by a user interface. Both user commands and NRJE manager commands are available. NRJE intrinsics are called from HP 3000 user-written programs. Both user intrinsics and NRJE manager intrinsics are available. Audience Two kinds of NRJE users exist: * NRJE managers, those with Node Manager (NM) user capability. An NRJE manager is responsible for managing the NRJE workstation. The NRJE manager has the capability of controlling all files transmitted from the workstation and all data sets returned from the host to the workstation. * Users, those without NM user capability. An NRJE user submits batch jobs to a host system for processing. An NRJE manager can do everything that a user can do, with some extended capabilities. An NRJE manager can determine and alter the status of the job of any user, and can cancel the job of any user. An NRJE manager plans and monitors the operation of the NRJE subsystem. NRJE manager responsibilities include maintenance and problem solving. Logging capabilities allow an NRJE manager to monitor network and NRJE events. Tracing capabilities permit an NRJE manager to examine internal NRJE processes and the use of NRJE commands and intrinsics. Logging and tracing capabilities are provided through the HP 3000 Multiprogramming Executive (MPE) operating system, and through the HP SNA link product.
NOTE In this manual, the term SNA link product is used when the information being given is true for all of the SNA link products: SNA Link/V, SNA/SDLC Link/XL, and SNA/X.25 Link/XL. The terms SNA Link/V, SNA/SDLC Link/XL, and SNA/X.25 Link/XL are used when a distinction among the three products is necessary.
An NRJE user submits jobs to a remote host system. Users can determine the status of their jobs to be submitted to a host, alter the status of their jobs, and cancel their jobs. Users also can display information about the status of NRJE. The NRJE manager is directly responsible for NRJE operation and usage, but another level of responsibility is assigned to the HP 3000 SNA node manager. The HP 3000 SNA node manager is responsible for overall HP-IBM data communications. The node manager builds the configuration file, which defines the following: * The communications link * The SNA node and logical units * Logging and tracing characteristics * The SNA workstation The node manager also monitors operations of the node. Node management functions are described in the SNA Link Services Reference Manual and the SNA Link/XL Node Manager's Guide. Organization This manual is divided into the following chapters and appendix: CHAPTER 1, Introducing NRJE, provides an overview of NRJE, its operating environment, what it can do, and hardware and software requirements. CHAPTER 2, Getting Started, describes, in general terms, how to get NRJE to submit a job to your host and how output is handled for your job. CHAPTER 3, User Commands, provides a description of every NRJE user command, its syntax, and its parameters. A discussion and example follow the command description. A text reference relates a command to NRJE intrinsics. Commands are in alphabetic order for easy reference. CHAPTER 4, Job Output, provides a description of how SNA NRJE handles job output from a host system to the HP 3000. NRJE job management and output management capabilities are described. Carriage control translation, special forms processing, and use of the HP2680A laser printer are discussed. The relationship between host output classes and logical writers is described. CHAPTER 5, User Intrinsics, has a description of every NRJE user intrinsic, its syntax, and its parameters. Parameter data types are identified in the syntax description. A discussion follows each intrinsic description. A text reference relates each intrinsic to a command. Intrinsics are in alphabetic order for easy reference. CHAPTER 6, NRJE Manager Intrinsics, is a description of every NRJE manager intrinsic, its syntax, and its parameters. Parameter data types are identified in the syntax description. A discussion follows each intrinsic description. A text reference relates each intrinsic to a command. Intrinsics are in alphabetic order for easy reference. CHAPTER 7, Support Utilities and MPE Commands, describes the MPE commands and subsystems that can be used with NRJE. APPENDIX A, Parsing Algorithms and User Exit Procedures, describes two exits from SNA NRJE, and describes and lists the procedures called from the exits: * Host "Job Received" message parsingprocedure * Host banner page decode procedure These procedures are supplied with SNA NRJE and are required for the full job and output management capabilities of NRJE to function. Related HP Publications Installing and Troubleshooting SNA NRJE, Node Manager's Guide 30245-90002 SNA NRJE Node Manager's Guide 30292-61000 SNA Link Services Reference Manual 30246-90003 SNA Link/XL Node Manager's Guide 30291-61000 Getting Started With SNA Node Management 30246-90002 HP30020A/B Intelligent Network Processor (INP) Installation and 30020-90001 Service Manual MPE Commands Reference Manual 30000-90009 Console Operator's Guide 320090-90013 MPE System Utilities 30000-90044 System Operation and Resource Management Reference Manual 32033-90005 MPE Software Pocket Guide 30000-90049 MPE Quick Reference Guide 32033-90023 Data Communications Handbook, Fundamental Chapter 5957-4634 Data Communications Handbook, Chapter H, SNA NRJE Network Remote 30245-90006 Job Entry MPE XL Commands Reference Manual 32650-90003 Series 9xx System Administrator manuals: System Startup and Shutdown 32650-90034 Managing Jobs and Sessions 32650-90036 Managing Peripherals 32650-90037 Storing and Restoring Files 32650-90038 Backup and Recovery 32650-90039 Account Structure and Security 32650-90041 System Configuration 32650-90042 Volume Management 32650-90045 Localizing and Customizing System Information 32650-90046 Related IBM Publications Systems Network Architecture Reference Summary GA27-3136 IBM Synchronous Data Link Control GA27-3093 Marketing Publications KWIC Index G320-1621 Field Engineering Handbook, SNA G226-3548 System Network Architecture - Sessions between Logical Units GC20-1868 IBM 3704, 3705-I, and 3705-II Communication Controllers GC30-3004 Principles of Operation ACF/NCP/VS Publications: Introduction to the IBM 3704 and 3705 Communications Controllers GA27-3051 Introduction to the IBM 3725 Communications Controller GA33-0010 Guide to Using the IBM 3705 Communications Controller Panel GA27-3087 Network Control Program Logic Manual LY30-3057 ACF/TAP User's Guide SC30-3115 Advanced Communication Function for Network Control Program, for GC30-3058 IBM 3705 Advanced Communication Function for System Support Programs, for IBM 3705 General Information Manual ACF/NCP/VS Network Control Program / System Support Programs SC30-3142 Installation Manual ACF / Network Control Program / VS Handbook SY30-3029 Network Control Program / VS Generation and Utilities Guide and GY30-3012 Reference Manual (for OS/VS and DOS/VS VTAM Users), IBM 3704 and 3705 Program Reference Handbook ACF/VTAM Publications: ACF/VTAM Operator's Guide SC27-0466 ACF/VTAM Messages and Codes SC27-0470 ACF/VTAM Library Summary GX27-0042 ACF/VTAM General Information: Introduction GC27-0462 ACF/VTAM General Information: Concepts GC27-0463 ACF/VTAM Planning and Installation Reference GC27-0584 ACF/VTAM Reference Summary SX27-0008 8100 DPPX Publications: 8100 DPPX Host Connect Cookbook for DSC, DSX, HCF GG22-9047 JES2 Publications (version 1): Operator's Library: JES2 Commands SC23-0048 Systems Programming Library: JES2 Initialization and Tuning SC23-0046 Operator's Library: OS/VS2 Remote Terminals (JES2) GC38-0225 Operator's Library: JES2 Command Language Reference Summary SX23-0008 JES2 Publications (version 2): JES2 Operations: XA JES2 Commands SC23-0064 JES2 System Programming Library: XA Initialization and Tuning SC38-0065 JES2 Operations: XA JES2 Command Syntax SX23-0010 MVS/XA JES2 Licensed Program Specifications GC28-1144 Message Library: XA JES2 Messages GC28-1353 JES2 Publications (version 3): MVS/ESA Program Directory (JES2) GC28-1018 MVS/SP Version 3-JES2 LPS GC28-1561 MVS/ESA Operations: JES2 Commands SC28-1039 MVS/ESA Operations: JES2 Command Syntax SX22-0011 MVS/ESA System Programming Library: JES2 Initialization and SC28-1038 Tuning MVS/ESA Message Library: JES2 Messages GC28-1040 MVS/ESA JES2 Directory of Programming Interfaces for Customers GC28-1050 MVS/ESA Remote Workstation Generation GC28-1842 MVS/ESA JES2 Logic LY28-1006 MVS/ESA System Programming Library: JES2 Customization LY28-1010 JES3 Publications (version 1): JES3 Introduction GC23-0039 JES3 Operator's Library Reference Summary SX23-0007 JES3 Programming Library: Initialization and Tuning SC23-0041 JES3 System Programming Library: Diagnosis LC28-1369 JES3 Messages GC23-0044 JES3 Publications (version 2): JES3 Command Syntax SX23-0012 JES3 Introduction GC23-0049 JES3 Initialization and Tuning SC23-0059 JES3 Messages GC23-0062 JES3 Commands SC23-0063 MVS/SP JES3 Licensed Program Specifications GC28-1285 JES3 Conversion Notebook, Version 2 Release 2.1 SC23-1412 JES3 Conversion Notebook, Version 2 Release 1.5 SC28-1501 VSE/POWER Publications (version 2): Introduction to the VSE System GC33-6108 VSE/POWER Remote Job Entry User's Guide SH12-5328 VSE/POWER Shared Spooling User's Guide SH12-5330 VSE/POWER Messages SH12-5520 VSE/POWER Installation and Operations Guide SH12-5329 VSE/POWER Networking User's Guide SC33-6140 VSE/POWER Reference Summary: Local Processing SH12-5435 VSE/POWER Reference Summary: Remote Processing SH12-5434 VSE/POWER Publications (version 4): VSE/SP General Information GC33-6401 VES/SP Messages and Codes SC33-6407 VSE/POWER Licensed Program Specifications GC33-6370 VSE/POWER Installation and Operations Guide SC33-6371 VSE/POWER Remote Job Entry User's Guide SC33-6372 VSE/POWER Networking User's Guide SC33-6373 VSE/POWER Application Programming SC33-6374 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 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. , A shaded delimiter preceding a parameter in a syntax statement indicates that the delimiter must be supplied whenever (a) that parameter is included or (b) that parameter is omitted and any other parameter that follows is included. For example: itema[,itemb][,itemc] means that the following are allowed: itema itema,itemb itema,itemb,itemc itema,,itemc Å 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 Brackets, braces, or ellipses appearing in syntax or format statements which must be entered as shown will be underlined. For example: LET var[[subscript]] = value 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) shading Shading represents user input on the terminal's screen. For example: NEW NAME? ALPHA [Key Cap] A string in bold font 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.
![[]](../../pic3k/M010428/MAP3c50.gif)