HP 3000 Manuals HP 3000 Manuals
Net IPC 3000/XL Programmer's Reference Manual HP AdvanceNet Printed in U.S.A. HP Part No. 5958-8600 HP Customer Order No. 36920-61005 Edition 3 Printed Oct 1989 E1089
Notice The information contained in this document is subject to change without 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. Æ Copyright 1988, 1989, Hewlett-Packard Company. Hewlett-Packard Company Business Networks Division 19420 Homestead Road 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 DEC 1987 Edition 2 NOV 1988 Edition 3 OCT 1989 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.Documentation Cross-Reference List The list below provides a cross-reference between manuals shown on the documentation map and their associated part numbers and, where appplicable, kit numbers. When kit numbers exist use those numbers for direct orders. Manual Name Manual Part Kit Number (for Number Direct Orders) --------------------------------------------------------------------------------------- Guide to NS3000/XL Documentation 5959-2837 36923-61001 HP 36923A LAN 3000/XL Link and Terminal LAN Link 36923-90001 Hardware Reference Manual LAN Cable and Accessories Installation Manual 5955-7680 Central Bus Programmable Serial Interface 30263-90001 Installation and Reference Guide HP 28663A StarLAN 10 Hub Installation Guide 28663-90001 HP2345A Datacommunications and Terminal Controller 02345-90021 Installation and Service Manual Using the Node Management Services (NMS) Utilities 5959-2805 32022-61005 Getting Started with the DTC 32098-90010 32098-61000 NS3000/XL Configuration Planning and Design Guide 36922-90007 36922-61002 NS3000/XL Local Area Network Configuration Guide 36922-90005 36922-61000 NS Point-to-Point 3000/XL Network Configuration 36922-90006 36922-61001 Guide NS3000/XL Operations and Maintenance Reference 36922-90010 36922-61005 Manual NS3000/XL Error Messages Reference Manual 5959-2836 36923-61000 NS3000/XL Screens Reference Manual 36922-90008 36922-61003 X.25 XL System Access Configuration Guide 36939-90001 36939-61001 Using the OpenView DTC Manager D2355-90001 Using NS3000/XL Network Services 36920-90001 36920-61000 NetIPC 3000/XL Programmer's Reference Manual 5958-8600 36920-61005 NS Cross-System NFT Reference Manual 5958-8563 36920-61003 Preface Network InterProcess Communication (NetIPC) is a set of programmatic calls that can be used to exchange data between peer-to-peer processes on the same or different nodes in an Hewlett-Packard NS network. Any process can initiate communication, and any process can send or receive messages by means of common intrinsics. NetIPC3000/XL is a version of NetIPC that can be used in programs written for MPE XL based computer systems. NetIPC provides programmatic access to the Transmission Control Protocol (TCP), which is the Transport-Layer protocol used by NS3000/XL link products. NetIPC3000/XL is provided with the purchase of any NS3000/XL link product. With the purchase of the X.25 XL System Access link product , NetIPC access to TCP (level 4) and X.25 (level 3) is provided. Intended Audience of this Manual In order for you to use NetIPC, you should be familiar with MPE XL, the operating system on which NetIPC3000/XL can be used. You should also be familiar with the TCP protocol and a high-level language such as Pascal. If you are using direct access to level 3 (X.25), you should be familiar with the X.25 protocol and the HP 3000 products that provide X.25 network communication. Organization of the Manual Following is a summary of how this manual is organized: * Chapter 1, "Introduction", explains how to establish connections, send and receive data over connections, and shutdown connections between processes using NetIPC TCP access or X.25 level 3. This chapter also introduces some of the NetIPC calls. * Chapter 2, "Cross-System NetIPC", describes what NetIPC calls need to be considered for a cross-system application (using TCP access) between an HP 3000 series 900 and either an HP 1000, HP 9000, or personal computer. Preface (continued) * Chapter 3, "NetIPC Intrinsics", provides a detailed description of each NetIPC intrinsic, in alphabetical order. This chapter also explains programming considerations, syntax, and the structure and function of several parameters that are common to multiple NetIPC intrinsics. * Chapter 4, "NetIPC Examples", provides sample programs using NetIPC intrinsics for peer-to-peer process communication for both TCP access and X.25 level 3 access. * Appendix A, "IPC Interpreter (IPCINT)", describes how to use the IPCINT software utility which provides an interactive interface to the NetIPC intrinsics used for programmatic access to X.25 level 3. * Appendix B, "Cause and Diagnostic Codes" lists the possible cause and diagnostic codes generated by NS X.25 packets. * Appendix C, "NetIPC Error Messages", includes a list of SOCKERRs and the corresponding protocol module errors returned in the IPCCHECK intrinsic, and provides a table of NetIPC errors (SOCKERRs) returned in the result parameter of the NetIPC intrinsics. * Appendix D, "Migration from PTOP to NetIPC and RPM", explains how to translate programs written in the Program-to-Program communication service to NetIPC and RPM. * Appendix E, "C Programming Language Considerations", describes program language differences that affect how NetIPC intrinsics are used in programs written in C programming language. Preface (continued) Related Publications The following publications contain additional information that can assist you in using NetIPC. NS3000/XL * Using NS3000/XL Network Services Manual (manual kit # 36920-61000) * NS3000/XL Error Messages Reference Manual (manual kit # 36923-61000) * NS3000/XL Configuration, Planning and Design Guide (manual kit # 36922-61002) * NS3000/XL NMMGR Screens Reference Manual (manual kit # 36922-61003) * NS Cross-System NFT Reference Manual (manual kit # 36920-61003) * NS Cross-System Network Manager Reference Manual (manual kit # 36920-61004) X.25 Networking * X.25 XL System Access Configuration Guide (manual kit # 36939-61001) * Using the OpenView DTC Manager (part number D2355-90001) MPE XL * MPE XL Commands Reference Manual (32650-90003) * MPE XL Intrinsics Reference Manual (32650-90028) * HP PASCAL Reference Manual (31502-90001) * HP COBOL II/XL Reference Manual (31500-90001) * FORTRAN 77/XL Reference Manual Supplement (31501-90001) 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. Conventions (continued) , For NetIPC option variable inrinsics, the "," 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) Conventions (continued)> 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. 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 OCT 1989
![[DOCMAPG]](../../pic3k/M010427/DOCMAPG.gif)