Back to files

$Id: README.VMS,v 1.4 2006/02/06 03:04:18 lacos Exp $

Installation

To build on OpenVMS, issue the following command in the source directory:

$ @VMSBUILD

If you get some errors about missing unsigned integer type definitions, try it like this (and see the comment at the top of "udp_copy2.h"):

$ @VMSBUILD "/DEFINE=(BROKEN_VMS_TYPES)"

The compilation of "bigpipe.c" may cause some warnings to appear, but I think they are harmless.

If the build is finished, copy the executables into your home directory, for example:

$ COPY UDP_RECV2.EXE,UDP_SEND2.EXE,BIGPIPE.EXE SYS$LOGIN:

"Configuration"

In order to pass arguments to the executables, you need to define foreign commands, which can be done automatically by adding your installation directory (for example, your home directory) to DCL$PATH:

$ DEFINE DCL$PATH SYS$LOGIN

or, if your DCL$PATH is not empty:

$ DEFINE DCL$PATH dir1,dir2,dir3,SYS$LOGIN

It's convenient to put this line into your SYS$LOGIN:LOGIN.COM.

I/O Redirection

(This section has not yet been updated to reflect on "bigpipe". Please read the chronologically first entry about it in the ChangeLog file.)

This small program was written with pipelines in mind. Fortunately, you can use the PIPE command line prefix under OpenVMS:

$ HELP PIPE

You will want to redirect input from files and output to files. They should have a "UNIX-like" structure as much as possible, thus enter the following File Definition Language script from your terminal for later use (terminate with ^Z):

$ COPY SYS$INPUT SYS$LOGIN:SEQSTMLF.FDL FILE
ORGANIZATION Sequential
RECORD
FORMAT Stream_LF

Invocation of "UDP_SEND2"

Convert an existing non-Stream_LF file, and send packets from it:

        $ PIPE CONVERT /FDL=SYS$LOGIN:SEQSTMLF.FDL IN.DAT SYS$OUTPUT -
        | UDP_SEND2 -b bps "-H" host -p port

(Don't forget to put "-H" between quotes.)

Invocation of "UDP_RECV2"

Save packets into a new file:

        $ DEFINE /USER SYS$OUTPUT OUT.DAT
        $ UDP_RECV2

The newly created file's attributes should happen to match those specified in SYS$LOGIN:SEQSTMLF.FDL above, check with

$ DIRECTORY /FULL OUT.DAT

(Look at the fields "File organization" and "Record format".)

In this example we didn't use the PIPE command line prefix, because that would have redirected SYS$ERROR too.

Acknowledgements

Many thanks go to Adam Maulis who helped me with DCL and RMS.