NetIPC 3000/XL Programmer’s Reference Manual

	MPE documents
	Complete PDF
	Table of Contents
	Glossary
	Index
⇓ Page Bottom

⇑ Page Top

Table of Contents

Preface

1 NetIPC Fundamentals

NetIPC Concepts

Sockets

Connections

Using NetIPC for Interprocess Communication

Establishing a Level 4 Connection

Sending and Receiving Data Over a Connection

Shutting Down Sockets and Connections

Additional NetIPC Functions

Direct Access to Level 3 (X.25)

Features

Limitations

Switched Virtual Circuits (SVCs)

Permanent Virtual Circuits (PVCs)

Access to the Call User Data (CUD) Field

Fast Select Facility

Facility Field

Access to X.25 Protocol Features

NetIPC Between MPE-XL and MPE-V Systems

2 Cross-System NetIPC

Software Required

Calls Affecting the Local Process

Calls Affecting the Remote Process

HP 3000 to HP 1000 NetIPC

HP 3000 to HP 9000 NetIPC

HP 3000 to PC NetIPC

NetIPC Error Codes

Program Startup

HP 3000 Program Startup

HP 1000 Program Startup

HP 9000 Program Startup

PC NetIPC Program Startup

3 NetIPC Intrinsics

Programming Considerations

Compatibility vs. Native Mode

Option Variable

Syntax

Capabilities

User-specified Protocol Addressing

Common Parameters

Flags Parameter

Opt Parameter

Data Parameter

Result Parameter

Summary of NetIPC Intrinsics

NetIPC Reference Pages

ADDOPT

Syntax

Parameters

Description

INITOPT

Syntax

Parameters

Description

IPCCHECK

Syntax

Parameters

Description

IPCCONNECT

Syntax

Parameters

Description

Protocol-Specific Considerations

X.25 Considerations

TCP Access

Cross-System Considerations for TCP

IPCCONTROL

Syntax

Parameters

Description

IPCCREATE

Syntax

Parameters

Description

Protocol-Specific Considerations

IPCDEST

Syntax

Parameters

Description

Protocol-Specific Considerations

IPCERRMSG

Syntax

Parameters

Description

IPCGET

Syntax

Parameters

Description

IPCGIVE

Syntax

Parameters

Description

IPCLOOKUP

Syntax

IPCNAME

Syntax

Parameters

Description

IPCNAMERASE

Syntax

Parameters

Description

IPCRECV

Syntax

Parameters

Description

Protocol-Specific Considerations

X.25 Considerations

IPCRECVCN

Syntax

Parameters

Description

Protocol-Specific Considerations

IPCSEND

Syntax

Parameters

Description

Protocol-Specific Considerations

IPCSHUTDOWN

Syntax

Parameters

Description

Protocol-Specific Considerations

X.25 Considerations

TCP

OPTOVERHEAD

Syntax

Parameters

Description

READOPT

Syntax

Parameters

Description

Asynchronous I/O

Steps for Programming with Asynchronous I/O

IO[DONT]WAIT

Syntax

Parameters

Description

4 NetIPC Examples

Example 1

Program 1A

Program 1B

Example 2

Program 2A (Vector1)

Program 2B (Vector2)

Example 3

Program 3A (X25CHECK)

Program 3B (X25SERV)

Example 4

Program 4A (SNMIPC1)

Program 4B (SNMIPC2)

A IPC Interpreter (IPCINT)

Using IPCINT

Comparison of IPCINT to Programmatic NetIPC

Example: Programmatic Access to X.25

Example: IPCINT for X.25 Direct Access

Syntax of IPCINT

Abbreviated Intrinsic Names

Pseudovariables

Prompts for Parameters

Call User Data Field

Sample IPCINT Session

B Cause and Diagnostic Codes

Diagnostic Codes in X.25 Clear Packets

Diagnostic Codes From a Remote Host

C Error Messages

NetIPC Errors

SOCKERRS

Submitting an SR

D Migration From PTOP to NetIPC and RPM

Creating Remote Processes

Creating Remote Processes: In the Master Program

Syntax

Creating Remote Processes: In the Slave Program

Syntax

Syntax

Exchanging Data

Exchanging Data: In the Master Program

Syntax

Syntax

Exchanging Data: In the Slave Program

Syntax

Syntax

Terminating Processes

Syntax

Example: Client-Server Application

PCLIENT: Sample PTOP Master Program

PSERVER: Sample PTOP Slave Program

RCLIENT: Sample NetIPC/RPM Master Program

RSERVER: Sample NetIPC/RPM Slave Program

E C Program Language Considerations

C Program Language Differences

Parameters

Example

Glossary

Index

List of Figures

1-1 Telephone Analogy

1-2 IPCCREATE (Processes A and B)

1-3 IPCNAME (Process B)

1-4 IPCLOOKUP (Process A)

1-5 IPCCONNECT (Process A)

1-6 IPCRECVCN (Process B)

1-7 IPCRECV (Process A)

1-8 Establishing a Connection (Summary)

1-9 Using IPCDEST

1-10 SVC Requestor Processing Example

1-11 SVC Server Processing Example

1-12 NS X.25 Call User Data Field (four bytes)

1-13 Fast Select No Restriction

1-14 Fast Select Restricted

3-1 OPT Parameter Structure

3-2 Option Entry Structure.

3-3 Data Location Descriptor — Vectored Data

List of Tables

1-1 Descriptor Summary

2-1 NetIPC Calls Affecting the Local Process

2-2 NetIPC Calls Affecting the Remote Process

2-3 Cross-System Calls (HP 3000 — HP1000)

2-4 Cross-System Calls (HP 3000 — HP9000

2-5 Cross-System Calls (HP 3000 — PC)

3-1 NetIPC Intrinsics

3-2 IPCCONNECT Protocol Specific Parameters

3-3 readdata Meanings

3-4 IPCCONTROL Protocol Specific Parameters

3-5 IPCCREATE Protocol Specific Parameters

3-6 IPCDEST Protocol Specific Parameters

3-7 IPCRECV Protocol Specific Parameters

3-8 TCP Urgent and More Data Bit Combinations

3-9 IPCRECVCN Protocol Specific Parameters

3-10 IPCSEND Protocol Specific Parameters

3-11 IPCSEND Protocol Specific Parameters

A-1 NetIPC Intrinsics IPCINT Abbreviations

B-1 Diagnostic Codes Sent/Received in Clear Packets

B-2 X.25 Diagnostic Codes From a Remote Host