                   DATA INTERCHANGE LIBRARY VERSION 2.1 HELP FILE
                   ----------------------------------------------

This file gives a brief description of the function and parameters for
each  of  the  available  Data Interchange Library routines.  For more
information on the Data Interchange Library see the  Data  Interchange
Library manual.


COBOL calls to the Data Interchange Library routines:

     You should first use DILINI to identify the  locations  in  which
     status information will be returned:

     DILINI:  DILINI-STATUS, STATUS, MSG-ID, SEVERITY

     COBOL CALL:  ENTER MACRO ROUTINE-NAME USING ARGUMENT-LIST.

FORTRAN calls to the Data Interchange Library routines:

     FORTRAN CALL:  STATUS = RTN (ARGS)

Note that STATUS is declared as INTEGER.


In the descriptions of the  Data  Interchange  Library  routines  that
follow,  symbolic  names  are used for the parameters.  The parameters
which have an asterisk (*) in front of them are returned values.   All
of the parameters are one word integers except for those corresponding
to the following symbolic names:

ACCT   : A 39-character ASCII account
DESCR  : A 16-character ASCII DECnet descriptor
DST-FFD: A three word destination foreign field descriptor
DST-REC: A destination data record
FFD    : A three word foreign field descriptor
FSPEC  : A 39 character ASCII field containing a file specification
HOST   : A 16-character ASCII hostname
INTDAT : 16 ASCII characters containing interrupt data
OBJID  : A 16-character ASCII DECnet object id
OPTDAT : 16 ASCII characters containing optional data
PASSWD : A 39-character ASCII password
RECORD : A data record
SRC-FFD: A three word source foreign field descriptor
SRC-REC: A source data record 
TASK   : A 16-character ASCII DECnet taskname
USERID : A 39-character ASCII userid



For each Data Interchange Library routine  below,  the  arguments  are
listed  in  the  order in which they should be passed to the specified
routine.


I.  Task-to-Task Routines


NFGND:  Get information on asynchronous network events or wait for an event
        NETLN, WAIT
NFOPA:  Open an active link for the transmission of ASCII data
        *NETLN, HOST, OBJID, DESCR, TASK, USERID, PASSWD, ACCT,
        OPTDAT, WAIT
NFOPB:  Open an active link for the transmission of binary data
        *NETLN, HOST, OBJID, DESCR, TASK, USERID, PASSWD, ACCT,
        OPTDAT, WAIT
NFOP8:  Open an active link for the transmission of 8-bit bytes of data
        *NETLN, HOST, OBJID, DESCR, TASK, USERID, PASSWD, ACCT,
        OPTDAT, WAIT
NFOPP:  Open a passive link
        *NETLN, OBJID, DESCR, TASK, WAIT
NFACC:  Accept a connection on a passive link which has been opened by
        a call to NFOPP and which has had a connect event
        NETLN, LTYPE, OPTCNT, OPTDAT
NFRCV:  Receive data over a logical link
        NETLN, USIZE, *COUNT, *RECORD, MSGMOD, WAIT
NFSND:  Send data over a logical link
        NETLN, USIZE, COUNT, RECORD, MSGMOD
NFREJ:  Reject a connection request received on a passive link which
        was opened using NFOPP and which has had a connect event.
        NETLN, REJCOD, OPTCNT, OPTDAT
NFCLS:  Disconnect or abort a logical link.
        NETLN, REJCOD, OPTCNT, OPTDAT
NFINF:  Get information about a logical link.
        NETLN, TYPE, *COUNT, *RECORD
NFINT:  Send an interrupt data message over a logical link.
        NETLN, COUNT, INTDAT
NFRCI:  Receive a single interrupt data message over a logical link.
        NETLN, COUNT, *INTDAT



II.  Remote File Access Routines


ROPEN:  Open a remote file
        *FNUM, FSPEC, USERID, PASSWD, ACCT, MODE, DTYPE, RFM,
        RAT, RSIZE, RUNIT
RREAD:  Read an ASCII record from a remote file
        FNUM, USIZE, *COUNT, *RECORD
RWRITE: Write an ASCII record into a remote file
        FNUM, USIZE, COUNT, RECORD
RCLOSE: Close a remote file
        FNUM, OPTION
RDEL:   Delete a (closed) file
        FSPEC, USERID, PASSWD, ACCT
RSUB:   Submit a remote file for remote batch processing
        FSPEC, USERID, PASSWD, ACCT
RPRINT: Print a remote file on the remote system's printer
        FSPEC, USERID, PASSWD, ACCT



III.  Data Conversion Routines


XDESCR: Make an FFD
        *FFD, RECORD, SYSTEM, BYTSIZE, OFFSET, BIT-OFFSET, DATA-TYPE,
        LENGTH, SCALE
XCGEN:  Convert given two FFD's
        SRC-FFD, DST-FFD
XCVST:  Convert strings given two FFD's
        SRC-FFD, DST-FFD
XCVFB:  Convert fixed-point binary values given two FFD's
        SRC-FFD, DST-FFD
XCVFP:  Convert floating-point values given two FFD's
        SRC-FFD, DST-FFD
XCVDN:  Convert display numeric values given two FFD's
        SRC-FFD, DST-FFD
XCVPD:  Convert packed decimal values given two FFD's
        SRC-FFD, DST-FFD
XCPDDN: Convert a packed decimal value to a display numeric value
        given two FFD's
        SRC-FFD, DST-FFD
XCPDFB: Convert a packed decimal value to a fixed point binary value
        given two FFD's
        SRC-FFD, DST-FFD
XCDNPD: Convert a display numeric value to a packed decimal value
        given two FFD's
        SRC-FFD, DST-FFD
XCDNFB: Convert a display numeric value to a fixed point binary value
        given two FFD's
        SRC-FFD, DST-FFD
XCFBPD: Convert a fixed point binary value to a packed decimal value
        given two FFD's
        SRC-FFD, DST-FFD
XCFBDN: Convert a fixed point binary value to a display numeric value
        given two FFD's
        SRC-FFD, DST-FFD
CVGEN:  Convert given detailed descriptions of both fields
        SRC-REC, SRC-SYSTEM, SRC-BYTE-SIZE, SRC-OFFSET, SRC-BIT-OFFSET, 
        SRC-DATA-TYPE, SRC-LENGTH, SRC-SCALE, *DST-REC, DST-SYSTEM,
        DST-BYTE-SIZE, DST-OFFSET, DST-BIT-OFFSET, DST-DATA-TYPE,
        DST-LENGTH, DST-SCALE
