Google
 

Trailing-Edge - PDP-10 Archives - BB-JR93L-BB_1990 - 10,7/dil/dildoc/dil.rnh
There are 10 other files named dil.rnh in the archive. Click here to see a list.
.LM0;.RM70;.F;.J;.C
.;COPYRIGHT (c) DIGITAL EQUIPMENT CORPORATION 1988. ALL RIGHTS RESERVED.

             DATA INTERCHANGE LIBRARY VERSION 2.1 HELP FILE
.C
             ----------------------------------------------
.B1
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.
.B2
COBOL calls to the Data Interchange Library routines:
.B1;.LM5
    You should first use DILINI  to  identify  the  locations  in  which
    status information will be returned:
.B1
    DILINI: DILINI-STATUS, STATUS, MSG-ID, SEVERITY
.B1
    COBOL CALL: ENTER MACRO ROUTINE-NAME USING ARGUMENT-LIST.
.B1;.LM0
FORTRAN calls to the Data Interchange Library routines:
.B1;.LM5
    FORTRAN CALL:  STATUS = RTN (ARGS)
.B1;.LM0
Note that STATUS is declared as INTEGER.
.B2
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:
.B1;.LIT
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
.END LIT;.B3
For each Data Interchange  Library  routine  below,  the  arguments  are
listed  in  the  order  in  which they should be passed to the specified
routine.
.B2
I.  Task-to-Task Routines
.TS8;.B2;.LIT
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
.end lit;.B3
II.  Remote File Access Routines
.B2;.lit
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
.end lit;.B3
III.  Data Conversion Routines
.B2;.lit
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
.end lit