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