/Net/cernvax/userd/tbl/rpc/doc/User/MSDOS.html

# MS-DOS Run Time Support

The RPC compiler is available for MSDOS, and is provided in Turbo-Pascal.

The runtime system is available in two versions. in Turbo pascal, it runs over Ethernet, RS232, or ISO TP4. In C, it runs over ethernet, RS232, or TCP/IP. The C version is recommended.

The RPC compiler command line syntax is the same as for VMS.

## TurboPascal Version

The stubs should be generted with the /CPCTURBO or /SPCTURBO option, and compiled using TurboPascal. (No INCLUDE preprocessing is required.)

The program should declare the name of any stubs which it uses in a "USES" clause. This will cause the stubs to be linked in and automatically initialised The NOAUTOINIT option of the compiler may be used to inhibit this. See the chapter on "Running the compiler". at run time. The library files provided in the release must be made available to turbopascal for linking.

Communication may be over

Ethernet
  See the section on ethernet addressing for the address format.
RS232
  The addressing format is the same as for the M680x0 under MoniCa.
ISO Tranport protocol class 4, running over ethernet.
  The address format is the same as under VMS, but with a medium name of "IEEE" (not IEEE.CATS).

For either raw ethernet or TP4 communication, the BICC "ISOLAN" card is used.

In the initial release, a separate library must be used for ISO tranport communication, from the one or ethernet and RS232 communication.

This version is not likely to be supported in the long term.

## Turbo-C version

This is basically a port of the main portable implmentation. See the "msdos" subdirectory, in conjunction with the installation guide for unix.

Communication may be over raw ethernet, RS232 line, or TCP/IP.For either raw ethernet or TCP/IP communication, the BICC "ISOLAN" card is used.

## Hardware required

The system runs over RS232 ports (COM1: or COM2:). For raw ethernet, TCP/IP or ISO TP4 protocol, a BICC ethernet interface card is required. This is delivered with necessary interface libraries which you should link with your code, along with the RPC library.

## Defining the RPC addresses

Under MSDOS, the RPC address strings are defined using the environment variables. The command is SET:

    	>  SET <logical>=<physical>

This takes the place of the DEFINE command, for example, under VMS. Note that there should bve no spaces on either side of the = sign. For example,

    	> SET RPC_TRACE_FLAG=TRUE

    	> SET RPC_CLIENT_NAME=*_5150.ETHERNET

    	> SET MYPKG=GRAPHICS@AA0004007758_5150.ETHERNET

The address syntax for RPC addresses is the same as for other systems.