HP 3000 Manuals

Programming Considerations [ Net IPC 3000/XL Programmer's Reference Manual ] MPE/iX 5.0 Documentation


Net IPC 3000/XL Programmer's Reference Manual

Programming Considerations 

Compatibility vs.  Native Mode 

Compatibility mode allows you to run application programs compiled on an
MPE V computer system on an MPE XL computer system without change.
Native mode refers to application programs compiled and executed on an
MPE XL computer system.

NetIPC applications written for MPE V based HP 3000s can be migrated to
MPE XL HP 3000s (series 900s) and run in compatibility mode as follows.
On the MPE-V system, use the MPE STORE command to save your program's
object code.  On the MPE XL system, use the MPE RESTORE command on your
object code.

To take advantage of the optimizing compilers and improved performance on
the XL, you must recompile your application program on the MPE XL system
that will execute in native mode (NM). Some applications contain code
that must be altered before migrating to native mode.

Application migration considerations are documented in the Application 
Migration Guide (part number 30367-90006).

Example 2 in Chapter 4, NetIPC Examples, shows the differences in
declarations required for compiling a NetIPC program in compatibility
mode and in native mode.

Option Variable 

Many of the NetIPC intrinsics are option variable meaning they can be
called with a variable number of parameters.  Required parameters are
listed in the discussion of each intrinsic.  If you omit an optional
parameter, the comma delimiter (,) is required to preserve parameter
position.

For example, a call using  IPCCONNECT could be entered as follows:

     IPCCONNECT(CALLDESC, DEST, , , VCDESC, RESULT)

In this example, note that following the parameter DEST, commas delimit
the omitted optional parameters  flags and  opt.

Syntax 

The syntax description provided for each NetIPC intrinsic is the syntax
required for Pascal programs.  Differences in parameter declarations for
other languages (if any) are documented in Appendix E, Programming
Language Considerations.

Capabilities 

Some NetIPC intrinsics require special capabilities if you use the
functions described below.

User-specified Protocol Addressing.  NetIPC intrinsics  IPCCONNECT,
IPCCREATE, and IPCDEST allow you to specify protocol relative addresses.
Addresses in the range 30767 to 32767 decimal (%74057 to %77777) can be
used without special capabilities.  In privileged programs you can
specify protocol relative addresses between 1 and 30766 decimal (%1 and
%74056).


NOTE The protocol relative address range 1 to 30766 decimal, (%1 to %74056) is administered by HP. Contact your HP representative before using an address within this reserved range.
X.25 Catch-all Socket. Using access to X.25 (level 3), network administrator (NA) capability is required to create a catch-all socket for an X.25 network. NA capability is required to run a program that creates a catch-all socket.


MPE/iX 5.0 Documentation