Google
 

Trailing-Edge - PDP-10 Archives - bb-ee87b-sb - 10,7/dil/dil.doc
There are 26 other files named dil.doc in the archive. Click here to see a list.
 
DIL.DOC -- V2.0(137) 16-Nov-84                                  Page i
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
COPYRIGHT (C) DIGITAL EQUIPMENT CORPORATION 1983, 1985.
 
ALL RIGHTS RESERVED.
 
THIS SOFTWARE IS FURNISHED UNDER A LICENSE AND MAY BE USED AND  COPIED
ONLY  IN  ACCORDANCE  WITH  THE  TERMS  OF  SUCH  LICENSE AND WITH THE
INCLUSION OF THE ABOVE COPYRIGHT NOTICE.  THIS SOFTWARE OR  ANY  OTHER
COPIES  THEREOF MAY NOT BE PROVIDED OR OTHERWISE MADE AVAILABLE TO ANY
OTHER PERSON.  NO TITLE TO AND OWNERSHIP OF  THE  SOFTWARE  IS  HEREBY
TRANSFERRED.
 
THE INFORMATION IN THIS SOFTWARE IS SUBJECT TO CHANGE  WITHOUT  NOTICE
AND  SHOULD  NOT  BE  CONSTRUED  AS  A COMMITMENT BY DIGITAL EQUIPMENT
CORPORATION.
 
DIGITAL ASSUMES NO RESPONSIBILITY FOR THE USE OR  RELIABILITY  OF  ITS
SOFTWARE ON EQUIPMENT THAT IS NOT SUPPLIED BY DIGITAL.
DIL.DOC -- V2.0(137) 16-Nov-84                                 Page ii
Table of Contents
 
 
        1.0     INTRODUCTION . . . . . . . . . . . . . . . . . . . . 1
        2.0     SUMMARY  . . . . . . . . . . . . . . . . . . . . . . 1
        3.0     PRODUCT SOURCES  . . . . . . . . . . . . . . . . . . 1
        4.0     EXTERNAL CHANGES . . . . . . . . . . . . . . . . . . 2
        5.0     COMPATIBILITY WITH DIL V1.0  . . . . . . . . . . . . 2
        6.0     KNOWN BUGS AND DEFICIENCIES  . . . . . . . . . . . . 3
        7.0     DECSYSTEM-20 INSTALLATION INSTRUCTIONS . . . . . . . 4
        7.1       File Contents  . . . . . . . . . . . . . . . . . . 4
        7.1.1     First Save Set: Documentation Files  . . . . . . . 4
        7.1.2     Second Save Set: SUBSYS Files  . . . . . . . . . . 4
        7.1.3     Third Save Set: Sources  . . . . . . . . . . . . . 5
        7.1.4     Fourth Save Set: REL Files . . . . . . . . . . . . 7
        7.1.5     Fifth Save Set: Installation Verification Files  . 7
        7.2       DECSYSTEM-20 Installation  . . . . . . . . . . . . 7
        7.3       Special Considerations . . . . . . . . . . . . . . 9
        8.0     DECSYSTEM-10 INSTALLATION INSTRUCTIONS . . . . . .  10
        8.1       File Contents  . . . . . . . . . . . . . . . . .  10
        8.1.1     Documentation  . . . . . . . . . . . . . . . . .  10
        8.1.2     Libraries And Interface Support Files  . . . . .  10
        8.1.3     Sources  . . . . . . . . . . . . . . . . . . . .  11
        8.1.4     Autopatch Files  . . . . . . . . . . . . . . . .  12
        8.1.5     Installation Verification  . . . . . . . . . . .  13
        8.2       DECsystem-10 Installation  . . . . . . . . . . .  13
        8.3       Special Considerations . . . . . . . . . . . . .  16
        9.0     VAX/VMS INSTALLATION INSTRUCTIONS  . . . . . . . .  17
        9.1       CONVENTIONS  . . . . . . . . . . . . . . . . . .  17
        9.2       VAX DIL INSTALLATION PROCEDURE . . . . . . . . .  17
        9.2.1     Components Of The VAX DIL Facility . . . . . . .  17
        9.2.2     The Installation Procedure . . . . . . . . . . .  18
        9.2.3     Installing VAX DIL . . . . . . . . . . . . . . .  19
        9.2.4     Running The VMSINSTAL.COM Procedure  . . . . . .  19
        9.2.5     Phase 1: Copying The Kit To The Installation 
                  Device . . . . . . . . . . . . . . . . . . . . .  20
        9.2.5.1   Backing Up The System Disk . . . . . . . . . . .  20
        9.2.5.2   Specifying The Device Name . . . . . . . . . . .  20
        9.2.5.3   Specifying The Product Name  . . . . . . . . . .  21
        9.2.5.4   Copying The Kit Onto The Installation Device . .  21
        9.2.6     Phase 2: The Installation  . . . . . . . . . . .  21
        9.2.6.1   Deciding Whether To PURGE Files  . . . . . . . .  22
        9.2.6.2   Sources  . . . . . . . . . . . . . . . . . . . .  22
        9.2.6.3   The Installation . . . . . . . . . . . . . . . .  23
        9.2.7     Phase 3: The Installation Verification Procedure  23
        9.2.7.1   The COBOL IVP Tests  . . . . . . . . . . . . . .  24
        9.2.7.2   The FORTRAN IVP Tests  . . . . . . . . . . . . .  25
        9.2.7.3   End Of The IVP . . . . . . . . . . . . . . . . .  27
        9.2.7.4   End Of The Installation  . . . . . . . . . . . .  27
        9.3       LOG OF A SAMPLE INSTALLATION OF DIL  . . . . . .  27
        9.4       FILES CREATED OR MODIFIED BY THE DIL INSTALLATION 
                  PROCEDURE  . . . . . . . . . . . . . . . . . . .  31
        10.0    INSTALLATION VERIFICATION SYSTEM . . . . . . . . .  33
        10.1      TOPS-20 Installation Verification  . . . . . . .  35
        10.2      TOPS-10 Installation Verification  . . . . . . .  37
        10.3      VAX/VMS Installation Verification  . . . . . . .  39
DIL.DOC -- V2.0(137) 16-Nov-84                                Page iii
Table of Contents
 
 
        11.0    PRODUCT CHANGES  . . . . . . . . . . . . . . . . .  40
        12.0    SUGGESTIONS  . . . . . . . . . . . . . . . . . . .  41
        13.0    DATA INTERCHANGE LIBRARY SAMPLE APPLICATION  . . .  42
        13.1      Description  . . . . . . . . . . . . . . . . . .  42
        13.2      Running The Sample Application . . . . . . . . .  43
        14.0    BUILDING DIL . . . . . . . . . . . . . . . . . . .  44
        15.0    BUILDING DIL ON TOPS-10  . . . . . . . . . . . . .  44
        16.0    BUILDING DIL ON TOPS-20  . . . . . . . . . . . . .  47
        17.0    BUILDING DIL ON VAX/VMS  . . . . . . . . . . . . .  48
 
 
 
 
 
DIL.DOC -- V2(137) 16-Nov-84                                    Page 1
INTRODUCTION
 
 
1.0  INTRODUCTION
 
This document describes  how  to  install  version  2.0  of  the  Data
Interchange  Library  (DIL) on a DECSYSTEM-20, DECsystem-10 or VAX/VMS
system.
 
This manual  is  intended  for  the  system  manager  responsible  for
installing and maintaining the DIL.
 
You can find additional information in the DIL User Reference Manual.
 
 
 
2.0  SUMMARY
 
The Data Interchange Library (DIL)  is  a  set  of  subroutines  which
provide  some  basic  capabilities  for distributed applications.  The
capabilities include moving ASCII and binary data between  similar  or
dissimilar  systems,  and  converting between data formats in the same
class (string, fixed point  integer  (including  binary  fixed  point,
packed decimal and display numeric types), and floating point).  These
routines are callable from COBOL and FORTRAN on TOPS-10, TOPS-20,  and
VAX/VMS systems.
 
On TOPS-20 systems, DIL Version 2.0 will run under TOPS-20 version 5.1
or  later monitors and under TOPS-20 version 4.1 or later monitors for
KL model A and 2020 processors.  On VAX systems, DIL Version 2.0  will
run  under VMS 3.1 or later monitors.  On TOPS-10 systems, DIL Version
2.0 will run under TOPS-10 version 7.01 (for data conversion  routines
only),  or  7.02  (with  DECnet-10 V3 for task-to-task and remote file
access routines) or later monitors.
 
Refer to the beware file, DIL.BWR, for hints and potential problems.
 
 
 
3.0  PRODUCT SOURCES
 
The DIL V2.0 kit contains product sources in  machine  readable  form.
These  sources  are included only as a reference and are not warranted
or supported by Digital Equipment Corporation.
DIL.DOC -- V2(137) 16-Nov-84                                    Page 2
EXTERNAL CHANGES
 
 
4.0  EXTERNAL CHANGES
 
The following new functions were added to DIL for Version 2.0.
 
      o  DATA CONVERSION -- TOPS-10, TOPS-20 and VAX/VMS
 
         The data conversion routines have been  expanded  to  include
         two  new  data  classes:   packed decimal and display numeric
         types.
 
         Cross class conversion is now provided between all  types  of
         fixed point integer data.  Fixed point binary, packed decimal
         and display numeric classes can  all  be  converted  to  each
         other.
 
      o  TASK-TO-TASK and REMOTE FILE ACCESS -- TOPS-10
 
         The full set of task-to-task and remote file access  routines
         is  now  provided  for  TOPS-10  systems.   Previously, these
         routines were available for only TOPS-20 and VAX/VMS systems.
         DIL  Version  2.0  can be used in a network that supports any
         combination of of VAX/VMS, TOPS-10 and TOPS-20 systems.
 
      o  TASK-TO-TASK ROUTINES -- TOPS-10, TOPS-20 and VAX/VMS
 
         Two new  task-to-task  functions  have  been  added  for  all
         supported systems:
             
 
             Send a single interrupt data message over a logical link.
             
 
             Receive a single interrupt data message  over  a  logical
             link.
 
 
      o  DOCUMENTATION
 
         A new manual is provided with DIL Version 2.0.
 
 
 
 
5.0  COMPATIBILITY WITH DIL V1.0
 
You can use DIL V2.0 with any of your DIL V1.0 applications.
DIL.DOC -- V2(137) 16-Nov-84                                    Page 3
KNOWN BUGS AND DEFICIENCIES
 
 
6.0  KNOWN BUGS AND DEFICIENCIES
 
There are no known bugs or deficiencies as of 15-Oct-84.
DIL.DOC -- V2(137) 16-Nov-84                                    Page 4
DECSYSTEM-20 INSTALLATION INSTRUCTIONS
 
 
7.0  DECSYSTEM-20 INSTALLATION INSTRUCTIONS
 
7.1  File Contents
 
7.1.1  First Save Set:  Documentation Files -
 
DIL.BWR contains hints and information about potential problems.
 
DIL.DOC is this file.
 
DIL.HLP is the help file for TOPS-10/TOPS-20.
 
The following programs make up the DIL sample application.  These  are
provided   as   examples   only.   They  will  not  run  without  some
customization for your local network topology.
 
         IDXINI.CBL
         JTSERV.CBL
         JTTERM.CBL
         JTTERM.VAX-COB
         JTVRPT.CBL
         PROCES.MAC
 
 
 
 
7.1.2  Second Save Set:  SUBSYS Files -
 
DIL.REL is the library to search when linking programs with the DIL.
 
DIL.LIB is a COBOL copy library  containing  statements  which  define
names  for  various special codes used to select options and the like.
Elements in DIL.LIB may be COPY'd into user programs as  described  in
the  DIL manual.  DIL.LIB is not needed if your site will not be using
the DIL from COBOL programs.
 
DILV7.FOR,  DIXV7.FOR,  DITV7.FOR:   These  files  are   the   FORTRAN
equivalent  of  the  COBOL  copy library members contained in DIL.LIB,
above.  They may be INCLUDE'd into user programs to define  names  for
DIL  codes.   The  files are for use with TOPS-20 FORTRAN Version 7 or
later.  Details on when and how to include them, and how  to  use  the
codes,  are  given  in  the  DIL documentation.  None of the files are
necessary unless explicitly referenced  from  user  programs  (or  the
installation verification procedure).
 
B362LB.REL is the run-time support library for  BLISS.   Install  this
only  if  you  don't already have BLISS Version 3 or Version 4 on your
system.
 
XPORT.REL is a transportable support library needed by the  DIL  code.
Install this only if you don't already have BLISS Version 3 or Version
4 on your system.
DIL.DOC -- V2(137) 16-Nov-84                                    Page 5
DECSYSTEM-20 INSTALLATION INSTRUCTIONS
 
 
7.1.3  Third Save Set:  Sources -
 
The following are the DIL sources  for  TOPS-20.   These  sources  are
provided  for  reference  only  and  are not warranted or supported by
Digital Equipment Corporation.
      o  BLISSNET.REQ
      o  BLISSNET-DESCRIPTOR.REQ
      o  BLISSNET20.R36
      o  BUILD-DIL.CTL
      o  COMPDL.CTL
      o  COMPDT.CTL
      o  COMPDX.CTL
      o  CONDIT.REQ
      o  COPYRI.BLI
      o  CPYRIT.MAC
      o  DAP.BLI
      o  DAP-BLOCKS.REQ
      o  DAP-CODES.REQ
      o  DAP-MACROS.REQ
      o  DAP1A-DIL.CTL
      o  DAPERR.BLI
      o  DAPHST.BLI
      o  DAPPER.B36
      o  DAPSUB.BLI
      o  DAPT20.B36
      o  DIL-DEF.CMD
      o  DILC36.INT
      o  DILHST.BLI
      o  DILINT.BLI
      o  DILSWI.REQ
      o  DIR20.B36
      o  DIRECT.BLI
      o  DIRLST.BLI
      o  DITC36.INT
      o  DITHST.BLI
      o  DIXCST.BLI
      o  DIXDEB.BLI
      o  DIXDEB.REQ
      o  DIXDN.BLI
      o  DIXFBN.BLI
      o  DIXFP.BLI
      o  DIXGBL.BLI
      o  DIXGEN.BLI
      o  DIXHST.BLI
      o  DIXLIB.BLI
      o  DIXPD.BLI
      o  DIXREQ.REQ
      o  DIXSTR.BLI
      o  DIXSWI.REQ
      o  DIXUTL.BLI
DIL.DOC -- V2(137) 16-Nov-84                                    Page 6
DECSYSTEM-20 INSTALLATION INSTRUCTIONS
 
 
      o  EXT1A-DIL.CTL
      o  EXTHST.BLI
      o  FIELDS.BLI
      o  FT10.MAC
      o  FT20.MAC
      o  GETPUT.BLI
      o  INTERFILS.BLI
      o  INTERFILS.CTL
      o  JSYSDEF.R36
      o  M11FIL.B36
      o  MAKDIL.CTL
      o  NXTF20.B36
      o  NXTFIL.BLI
      o  OPEN.BLI
      o  POS20.BLI
      o  POSGEN.BLI
      o  RDWRIT.B36
      o  RMS.R36
      o  RMSBLK.R36
      o  RMSERR.B36
      o  RMSINT.R36
      o  RMSLIB.R36
      o  RMSUSR.R36
      o  SETAI.BLI
      o  STAR36.BLI
      o  STRING.B36
      o  TOPS20.R36
      o  TRACE.BLI
      o  TTT.MAC
      o  UNDECLARE.REQ
      o  VERSION.REQ
      o  XPN1A-DIL.CTL
      o  XPNCLO.B36
      o  XPNDIS.B36
      o  XPNERR.B36
      o  XPNEVE.B36
      o  XPNFAI.B36
      o  XPNGET.B36
      o  XPNHST.BLI
      o  XPNOPN.B36
      o  XPNPMR.B36
      o  XPNPSI.MAC
      o  XPNPUT.B36
      o  XPNUTL.B36
 
DIL.DOC -- V2(137) 16-Nov-84                                    Page 7
DECSYSTEM-20 INSTALLATION INSTRUCTIONS
 
 
7.1.4  Fourth Save Set:  REL Files -
 
These files are necessary to rebuild DIL with patches.  In particular,
this save set includes the files necessary to apply autopatch tapes to
the DIL.  These files should  be  installed  into  the  DIL  autopatch
directory.
 
     DIL2V2.REL
     DIT2V2.REL
     DIX2V2.REL
     DAP2V1.REL
     XPN2V1.REL
 
 
 
7.1.5  Fifth Save Set:  Installation Verification Files -
 
The following files are provided for installation verification:
 
      o  C36T2.CBL -- COBOL data conversion test
      o  CD36T1.CBL -- COBOL remote file access test
      o  CT36T1.CBL -- COBOL task-to-task test
      o  F7T2.FOR -- FORTRAN V7 data conversion test
      o  FD7T1.FOR -- FORTRAN V7 remote file access test
      o  FT7T1.FOR -- FORTRAN V7 task-to-task test
      o  ICSCBL.CTL -- COBOL verification control file
      o  ICSF7.CTL -- FORTRAN V7 verification control file
 
 
 
 
7.2  DECSYSTEM-20 Installation
 
The first step in installation should be to restore the files from the
documentation  save-set  to  disk,  and  read  DIL.DOC (this file) and
DIL.BWR.
 
This can be done by setting  MTA0:   unavailable  to  MOUNTR  (if  you
normally use labelled tapes), mounting the distribution tape on MTA0:,
defining DOC:  as the directory into which you  want  to  restore  the
documentation files, and typing the following commands:
 
     DUMPER
     TAPE MTA0:
     REWIND
     DENSITY 1600
     RESTORE PS:<*>*.* DOC:*.*.-1
     EXIT
     PRINT DOC:DIL.DOC, DOC:DIL.BWR
 
DIL.DOC -- V2(137) 16-Nov-84                                    Page 8
DECSYSTEM-20 INSTALLATION INSTRUCTIONS
 
 
After reading DIL.DOC and DIL.BWR, proceed with  the  installation  by
moving  the  help  file  to the help directory, and then restoring the
appropriate files from the tape to SYS:, as follows:
 
     COPY DOC:DIL.HLP HLP:
     DUMPER
     TAPE MTA0:
     REWIND
     DENSITY 1600
     SKIP 1
     RESTORE PS:<*>DIL.LIB SYS:*.*.-1, -
       PS:<*>DIL.REL SYS:*.*.-1, -
       PS:<*>DILV7.FOR SYS:*.*.-1, -
       PS:<*>DITV7.FOR SYS:*.*.-1, -
       PS:<*>DIXV7.FOR SYS:*.*.-1
     EXIT
 
There are two special files that may or may  not  be  needed  on  your
system.   Please refer to the discussion above in section "Second Save
set:  SUBSYS Files", and the  discussion  below  in  section  "Special
Considerations  (TOPS-20)".  To restore both of them to SYS:, type the
following commands:
 
     DUMPER
     TAPE MTA0:
     REWIND
     DENSITY 1600
     SKIP 1
     RESTORE PS:<*>B362LB.REL SYS:*.*.-1, -
       PS:<*>XPORT.REL SYS:*.*.-1
     EXIT
 
 
To be able to run the  installation  certification  system,  you  must
restore additional files.  Mount the tape on MTA0:, define DILTST:  to
point to the directory you want to put the ICS files  in  (we  suggest
PS:<DIL-TEST>;   see  6.0, "Installation Verification System", below),
and type the following commands:
 
     DUMPER
     TAPE MTA0:
     REWIND
     SKIP 4
     RESTORE PS:<*>C36T2.CBL DILTST:*.*.-1, -
       PS:<*>CD36T1.CBL DILTST:*.*.-1, -
       PS:<*>CT36T1.CBL DILTST:*.*.-1, -
       PS:<*>F7T2.FOR DILTST:*.*.-1, -
       PS:<*>FD7T1.FOR DILTST:*.*.-1, -
       PS:<*>FT7T1.FOR DILTST:*.*.-1, -
       PS:<*>ICSCBL.CTL DILTST:*.*.-1, -
       PS:<*>ICSF7.CTL DILTST:*.*.-1
     EXIT
DIL.DOC -- V2(137) 16-Nov-84                                    Page 9
DECSYSTEM-20 INSTALLATION INSTRUCTIONS
 
 
To be able to apply autopatch to the DIL, you must install  the  files
listed  below  into  the  DIL autopatch library directory, referred to
below by logical name DILAP:.   This  may  be  done  by  mounting  the
distribution tape on MTA0:, defining DILAP:  to point to the directory
you wish to restore the files into, and typing the following commands:
 
     DUMPER
     TAPE MTA0:
     REWIND
     SKIP 3
     RESTORE PS:<*>DAP2V1.REL DILAP:*.*.-1, -
       PS:<*>DIL2V2.REL DILAP:*.*.-1, -
       PS:<*>DIT2V2.REL DILAP:*.*.-1, -
       PS:<*>DIX2V2.REL DILAP:*.*.-1, -
       PS:<*>XPN2V1.REL DILAP:*.*.-1
     EXIT
 
 
To install the DIL sources for TOPS-20, mount the distribution tape on
MTA0:,  define  DILSRC:  to point to the directory you wish to restore
the sources into, and type the following commands:
 
     DUMPER
     TAPE MTA0:
     REWIND
     SKIP 2
     RESTORE PS:<*>*.* DILSRC:*.*.-1
     EXIT
 
 
 
 
7.3  Special Considerations
 
The  B362LB.REL   (BLISS   run-time   library)   and   the   XPORT.REL
(transportable  support  library) shipped with the DIL are the current
field-image versions;  if you have BLISS Version  3  or  4  installed,
there is no need to install either of these two files.
DIL.DOC -- V2(137) 16-Nov-84                                   Page 10
DECSYSTEM-10 INSTALLATION INSTRUCTIONS
 
 
8.0  DECSYSTEM-10 INSTALLATION INSTRUCTIONS
 
8.1  File Contents
 
8.1.1  Documentation -
 
DIL.BWR contains hints and information about potential problems.
 
DIL.DOC is this file.
 
DIL.HLP is the help file for TOPS-10/TOPS-20.
 
The following programs make up the DIL sample application.  These  are
provided   as   examples   only.   They  will  not  run  without  some
customization for your local network topology.
 
         IDXINI.CBL
         JTSERV.CBL
         JTTERM.CBL
         JTTERM.COB
         JTVRPT.CBL
         PROCES.MAC
 
 
 
 
8.1.2  Libraries And Interface Support Files -
 
DIL.REL is the library to search when linking programs with the DIL.
 
DIL.LIB is a COBOL copy library  containing  statements  which  define
names  for  various special codes used to select options and the like.
Elements in DIL.LIB may be COPY'd into user programs as  described  in
the  DIL manual.  DIL.LIB is not needed if your site will not be using
the DIL from COBOL programs.
 
DILV7.FOR,  DIXV7.FOR,  DITV7.FOR:   These  files  are   the   FORTRAN
equivalent  of  the  COBOL  copy library members contained in DIL.LIB,
above.  They may be INCLUDE'd into user programs to define  names  for
DIL  codes.   The  files  are  for use with TOPS-10 FORTRAN Version 7.
Details on when and how to include them, and how to use the codes, are
given  in  the  DIL  documentation.   None  of the files are necessary
unless explicitly referenced from user programs (or  the  installation
verification procedure).
 
B361LB.REL is a necessary run-time support library.  You  should  only
install  this  if  you  do not have Version 3 or Version 4 of BLISS-36
installed on your system.
 
XPORT.REL is a transportable support library needed by the  DIL  code.
You should only install this if you do not have Version 3 or Version 4
of BLISS-36 on your system.
DIL.DOC -- V2(137) 16-Nov-84                                   Page 11
DECSYSTEM-10 INSTALLATION INSTRUCTIONS
 
 
8.1.3  Sources -
 
The following are the DIL sources  for  TOPS-10.   These  sources  are
provided  for  reference  only  and  are not warranted or supported by
Digital Equipment Corporation.
      o  CPYRIT.MAC
      o  DILC36.INT
      o  DILHST.BLI
      o  DILINT.BLI
      o  DILSWI.REQ
      o  DLCM10.CTL
      o  DLMK10.CTL
      o  INTR10.CTL
      o  POS20.BLI
      o  POSGEN.BLI
      o  DIXCST.BLI
      o  DIXDEB.BLI
      o  DIXDN.BLI
      o  DIXFBN.BLI
      o  DIXFP.BLI
      o  DIXGBL.BLI
      o  DIXGEN.BLI
      o  DIXHST.BLI
      o  DIXLIB.BLI
      o  DIXPD.BLI
      o  DIXREQ.REQ
      o  DIXSTR.BLI
      o  DIXSWI.REQ
      o  DIXUTL.BLI
      o  DXCM10.CTL
      o  FIELDS.BLI
      o  INTERF.BLI
      o  STAR36.BLI
      o  VERSIO.REQ
      o  DAPPER.B36
      o  DITC36.INT
      o  DITHST.BLI
      o  DTCM10.CTL
      o  FT10.MAC
      o  RMSUSR.R36
      o  TTT.MAC
      o  BLISSN.REQ
      o  BLSN10.R36
      o  BLSNDE.REQ
      o  XPN1A.CTL
      o  XPNCLO.B36
      o  XPNDIS.B36
      o  XPNERR.B36
      o  XPNEVE.B36
      o  XPNFAI.B36
DIL.DOC -- V2(137) 16-Nov-84                                   Page 12
DECSYSTEM-10 INSTALLATION INSTRUCTIONS
 
 
      o  XPNGET.B36
      o  XPNHST.BLI
      o  XPNOPN.B36
      o  XPNPMR.B36
      o  XPNPSI.MAC
      o  XPNPUT.B36
      o  XPNUTL.B36
      o  COPYRI.BLI
      o  DAP.BLI
      o  DAP1A.CTL
      o  DAPBLK.REQ
      o  DAPCOD.REQ
      o  DAPERR.BLI
      o  DAPHST.BLI
      o  DAPMAC.REQ
      o  DAPSUB.BLI
      o  DAPT10.B36
      o  DIR10.B36
      o  DIRECT.BLI
      o  DIRLST.BLI
      o  GETPUT.BLI
      o  M11FIL.B36
      o  NXTF20.B36
      o  NXTFIL.BLI
      o  OPEN.BLI
      o  RDWRIT.B36
      o  SETAI.BLI
      o  STRING.B36
      o  TRACE.BLI
      o  CONDIT.REQ
      o  EXT1A.CTL
      o  EXTHST.BLI
      o  RMS.R36
      o  RMSBLK.R36
      o  RMSERR.B36
      o  RMSLIB.R36
      o  UUODEF.R36
      o  DIL.CTL
      o  DILDEF.CCL
 
 
 
 
8.1.4  Autopatch Files -
 
These files are necessary to rebuild DIL with patches.  In particular,
this save set includes the files necessary to apply autopatch tapes to
the DIL.  These files should  be  installed  into  the  DIL  autopatch
directory.
 
     DIL1V2.REL
     DIX1V2.REL
     DIT1V2.REL
DIL.DOC -- V2(137) 16-Nov-84                                   Page 13
DECSYSTEM-10 INSTALLATION INSTRUCTIONS
 
 
     DAP1V1.REL
     XPN1V1.REL
 
 
 
8.1.5  Installation Verification -
 
The following files are provided for installation verification:
 
      o  C36T2.CBL -- COBOL data conversion test
      o  CD36T1.CBL -- COBOL remote file access test
      o  CT36T1.CBL -- COBOL task-to-task test
      o  F7T2.FOR -- FORTRAN V7 data conversion test
      o  FD7T1.FOR -- FORTRAN V7 remote file access test
      o  FT7T1.FOR -- FORTRAN V7 task-to-task test
      o  ICSCBL.CTL -- COBOL verification control file
      o  ICSF7.CTL -- FORTRAN V7 verification control file
 
 
 
 
8.2  DECsystem-10 Installation
 
To install DIL Version 2.0 on your system,  copy  the  files  DIL.REL,
DIL.LIB, DILV7.FOR, DIXV7.FOR, DITV7.FOR from the distribution tape to
SYS:.  If you will not be using the DIL from  COBOL,  DIL.LIB  may  be
omitted.   If  you  will  not be using the DIL from FORTRAN, the *.FOR
files may be omitted.
 
If you do not have BLISS-36 Version 3 or Version 4 installed  on  your
system,  copy  the  file  B361LB.REL  to  SYS:.   See section "Special
Considerations (TOPS-10)" below.
 
If you do not have BLISS-36 Version 3 or Version 4 installed  on  your
system,  copy  the  file  XPORT.REL to SYS:.  See the section "Special
Considerations (TOPS-10)" below.
 
The autopatch library files for the DIL  are  DIL1V2.REL,  DIX1V2.REL,
DIT1V2.REL, DAP1V1.REL, XPN1V1.REL.  These should be restored from the
distribution tape to the autopatch library directory you establish for
DIL.
 
The  Installation  Verification  System  is  contained  in  the  files
ICSCBL.CTL,  ICSF7.CTL,  C36T2.CBL,  CD36T1.CBL, CT36T1.CBL, F7T2.FOR,
FD7T1.FOR, FT7T1.FOR.  These should be restored to some  directory  if
you  intend  to  run  the  installation  verification  system.   It is
recommended  that  you  use  the  directory  UTP:   ([5,33]).   It  is
recommended  that  you  run the installation verification system.  See
see 6.0, "Installation Verification System", below,  for  instructions
on running the installation verification.
DIL.DOC -- V2(137) 16-Nov-84                                   Page 14
DECSYSTEM-10 INSTALLATION INSTRUCTIONS
 
 
To copy the DIL files from the tape to your  system,  first  set  tape
drive  MTAx:   unavailable  to MOUNTR.  Mount the distribution tape on
MTAx:  and type the following commands:
 
     .ASSIGN MTAx:
     .R BACKUP
     /TAPE MTAx:
     /INTERCHANGE
     /SUPERSEDE ALWAYS
     /; DOCUMENTATION files
     /RESTORE DSKn:[5,14]DIL.BWR = DSKB:[10,7,DIL]DIL.BWR, -
     #DSKn:[5,14]DIL.DOC = DSKB:[10,7,DIL]DIL.DOC, -
     #DSKn:[5,14]DIL.HLP = DSKB:[10,7,DIL]DIL.HLP, -
     #DSKn:[5,14]IDXINI.CBL = DSKB:[10,7,DIL]IDXINI.CBL, -
     #DSKn:[5,14]JTSERV.CBL = DSKB:[10,7,DIL]JTSERV.CBL, -
     #DSKn:[5,14]JTTERM.CBL = DSKB:[10,7,DIL]JTTERM.CBL, -
     #DSKn:[5,14]JTTERM.COB = DSKB:[10,7,DIL]JTTERM.COB, -
     #DSKn:[5,14]JTVRPT.CBL = DSKB:[10,7,DIL]JTVRPT.CBL, -
     #DSKn:[5,14]PROCES.MAC = DSKB:[10,7,DIL]PROCES.MAC, -
     /; sys files
     #DSKn:[1,4]DIL.REL = DSKB:[10,7,DIL]DIL.REL, -
     #DSKn:[1,4]DIL.LIB = DSKB:[10,7,DIL]DIL.LIB, -
     #DSKn:[1,4]DILV7.FOR = DSKB:[10,7,DIL]DILV7.FOR, -
     #DSKn:[1,4]DIXV7.FOR = DSKB:[10,7,DIL]DIXV7.FOR, -
     #DSKn:[1,4]DITV7.FOR = DSKB:[10,7,DIL]DITV7.FOR, -
     #DSKn:[1,4]B361LB.REL = DSKB:[10,7,DIL]B361LB.REL, -
     #DSKn:[1,4]XPORT.REL = DSKB:[10,7,DIL]XPORT.REL, -
     /; sources -- you choose the SFD you'd like
     #DSKn:[??,??]CPYRIT.MAC = DSKB:[10,7,DIL]CPYRIT.MAC, -
     #DSKn:[??,??]DILBLD.MIC = DSKB:[10,7,DIL]DILBLD.MIC, -
     #DSKn:[??,??]DILC36.INT = DSKB:[10,7,DIL]DILC36.INT, -
     #DSKn:[??,??]DILHST.BLI = DSKB:[10,7,DIL]DILHST.BLI, -
     #DSKn:[??,??]DILINT.BLI = DSKB:[10,7,DIL]DILINT.BLI, -
     #DSKn:[??,??]DILSWI.REQ = DSKB:[10,7,DIL]DILSWI.REQ, -
     #DSKn:[??,??]DLCM10.CTL = DSKB:[10,7,DIL]DLCM10.CTL, -
     #DSKn:[??,??]DLDS10.MIC = DSKB:[10,7,DIL]DLDS10.MIC, -
     #DSKn:[??,??]DLMK10.CTL = DSKB:[10,7,DIL]DLMK10.CTL, -
     #DSKn:[??,??]DLVX10.MIC = DSKB:[10,7,DIL]DLVX10.MIC, -
     #DSKn:[??,??]INTR10.CTL = DSKB:[10,7,DIL]INTR10.CTL, -
     #DSKn:[??,??]POS20.BLI = DSKB:[10,7,DIL]POS20.BLI, -
     #DSKn:[??,??]POSGEN.BLI = DSKB:[10,7,DIL]POSGEN.BLI, -
     #DSKn:[??,??]DIXCST.BLI = DSKB:[10,7,DIL]DIXCST.BLI, -
     #DSKn:[??,??]DIXDEB.BLI = DSKB:[10,7,DIL]DIXDEB.BLI, -
     #DSKn:[??,??]DIXDN.BLI = DSKB:[10,7,DIL]DIXDN.BLI, -
     #DSKn:[??,??]DIXFBN.BLI = DSKB:[10,7,DIL]DIXFBN.BLI, -
     #DSKn:[??,??]DIXFP.BLI = DSKB:[10,7,DIL]DIXFP.BLI, -
     #DSKn:[??,??]DIXGBL.BLI = DSKB:[10,7,DIL]DIXGBL.BLI, -
     #DSKn:[??,??]DIXGEN.BLI = DSKB:[10,7,DIL]DIXGEN.BLI, -
     #DSKn:[??,??]DIXHST.BLI = DSKB:[10,7,DIL]DIXHST.BLI, -
     #DSKn:[??,??]DIXLIB.BLI = DSKB:[10,7,DIL]DIXLIB.BLI, -
     #DSKn:[??,??]DIXPD.BLI = DSKB:[10,7,DIL]DIXPD.BLI, -
     #DSKn:[??,??]DIXREQ.REQ = DSKB:[10,7,DIL]DIXREQ.REQ, -
     #DSKn:[??,??]DIXSTR.BLI = DSKB:[10,7,DIL]DIXSTR.BLI, -
DIL.DOC -- V2(137) 16-Nov-84                                   Page 15
DECSYSTEM-10 INSTALLATION INSTRUCTIONS
 
 
     #DSKn:[??,??]DIXSWI.REQ = DSKB:[10,7,DIL]DIXSWI.REQ, -
     #DSKn:[??,??]DIXUTL.BLI = DSKB:[10,7,DIL]DIXUTL.BLI, -
     #DSKn:[??,??]DXCM10.CTL = DSKB:[10,7,DIL]DXCM10.CTL, -
     #DSKn:[??,??]FIELDS.BLI = DSKB:[10,7,DIL]FIELDS.BLI, -
     #DSKn:[??,??]INTERF.BLI = DSKB:[10,7,DIL]INTERF.BLI, -
     #DSKn:[??,??]STAR36.BLI = DSKB:[10,7,DIL]STAR36.BLI, -
     #DSKn:[??,??]VERSIO.REQ = DSKB:[10,7,DIL]VERSIO.REQ, -
     #DSKn:[??,??]DAPPER.B36 = DSKB:[10,7,DIL]DAPPER.B36, -
     #DSKn:[??,??]DITC36.INT = DSKB:[10,7,DIL]DITC36.INT, -
     #DSKn:[??,??]DITHST.BLI = DSKB:[10,7,DIL]DITHST.BLI, -
     #DSKn:[??,??]DTCM10.CTL = DSKB:[10,7,DIL]DTCM10.CTL, -
     #DSKn:[??,??]FT10.MAC = DSKB:[10,7,DIL]FT10.MAC, -
     #DSKn:[??,??]RMSUSR.R36 = DSKB:[10,7,DIL]RMSUSR.R36, -
     #DSKn:[??,??]TTT.MAC = DSKB:[10,7,DIL]TTT.MAC, -
     #DSKn:[??,??]BLISSN.REQ = DSKB:[10,7,DIL]BLISSN.REQ, -
     #DSKn:[??,??]BLSN10.R36 = DSKB:[10,7,DIL]BLSN10.R36, -
     #DSKn:[??,??]BLSNDE.REQ = DSKB:[10,7,DIL]BLSNDE.REQ, -
     #DSKn:[??,??]XPN1A.CTL = DSKB:[10,7,DIL]XPN1A.CTL, -
     #DSKn:[??,??]XPNCLO.B36 = DSKB:[10,7,DIL]XPNCLO.B36, -
     #DSKn:[??,??]XPNDIS.B36 = DSKB:[10,7,DIL]XPNDIS.B36, -
     #DSKn:[??,??]XPNERR.B36 = DSKB:[10,7,DIL]XPNERR.B36, -
     #DSKn:[??,??]XPNEVE.B36 = DSKB:[10,7,DIL]XPNEVE.B36, -
     #DSKn:[??,??]XPNFAI.B36 = DSKB:[10,7,DIL]XPNFAI.B36, -
     #DSKn:[??,??]XPNGET.B36 = DSKB:[10,7,DIL]XPNGET.B36, -
     #DSKn:[??,??]XPNHST.BLI = DSKB:[10,7,DIL]XPNHST.BLI, -
     #DSKn:[??,??]XPNOPN.B36 = DSKB:[10,7,DIL]XPNOPN.B36, -
     #DSKn:[??,??]XPNPMR.B36 = DSKB:[10,7,DIL]XPNPMR.B36, -
     #DSKn:[??,??]XPNPSI.MAC = DSKB:[10,7,DIL]XPNPSI.MAC, -
     #DSKn:[??,??]XPNPUT.B36 = DSKB:[10,7,DIL]XPNPUT.B36, -
     #DSKn:[??,??]XPNUTL.B36 = DSKB:[10,7,DIL]XPNUTL.B36, -
     #DSKn:[??,??]COPYRI.BLI = DSKB:[10,7,DIL]COPYRI.BLI, -
     #DSKn:[??,??]DAP.BLI = DSKB:[10,7,DIL]DAP.BLI, -
     #DSKn:[??,??]DAP1A.CTL = DSKB:[10,7,DIL]DAP1A.CTL, -
     #DSKn:[??,??]DAPBLK.REQ = DSKB:[10,7,DIL]DAPBLK.REQ, -
     #DSKn:[??,??]DAPCOD.REQ = DSKB:[10,7,DIL]DAPCOD.REQ, -
     #DSKn:[??,??]DAPERR.BLI = DSKB:[10,7,DIL]DAPERR.BLI, -
     #DSKn:[??,??]DAPHST.BLI = DSKB:[10,7,DIL]DAPHST.BLI, -
     #DSKn:[??,??]DAPMAC.REQ = DSKB:[10,7,DIL]DAPMAC.REQ, -
     #DSKn:[??,??]DAPSUB.BLI = DSKB:[10,7,DIL]DAPSUB.BLI, -
     #DSKn:[??,??]DAPT10.B36 = DSKB:[10,7,DIL]DAPT10.B36, -
     #DSKn:[??,??]DIR10.B36 = DSKB:[10,7,DIL]DIR10.B36, -
     #DSKn:[??,??]DIRECT.BLI = DSKB:[10,7,DIL]DIRECT.BLI, -
     #DSKn:[??,??]DIRLST.BLI = DSKB:[10,7,DIL]DIRLST.BLI, -
     #DSKn:[??,??]GETPUT.BLI = DSKB:[10,7,DIL]GETPUT.BLI, -
     #DSKn:[??,??]M11FIL.B36 = DSKB:[10,7,DIL]M11FIL.B36, -
     #DSKn:[??,??]NXTF20.B36 = DSKB:[10,7,DIL]NXTF20.B36, -
     #DSKn:[??,??]NXTFIL.BLI = DSKB:[10,7,DIL]NXTFIL.BLI, -
     #DSKn:[??,??]OPEN.BLI = DSKB:[10,7,DIL]OPEN.BLI, -
     #DSKn:[??,??]RDWRIT.B36 = DSKB:[10,7,DIL]RDWRIT.B36, -
     #DSKn:[??,??]SETAI.BLI = DSKB:[10,7,DIL]SETAI.BLI, -
     #DSKn:[??,??]STRING.B36 = DSKB:[10,7,DIL]STRING.B36, -
     #DSKn:[??,??]TRACE.BLI = DSKB:[10,7,DIL]TRACE.BLI, -
     #DSKn:[??,??]CONDIT.REQ = DSKB:[10,7,DIL]CONDIT.REQ, -
DIL.DOC -- V2(137) 16-Nov-84                                   Page 16
DECSYSTEM-10 INSTALLATION INSTRUCTIONS
 
 
     #DSKn:[??,??]EXT1A.CTL = DSKB:[10,7,DIL]EXT1A.CTL, -
     #DSKn:[??,??]EXTHST.BLI = DSKB:[10,7,DIL]EXTHST.BLI, -
     #DSKn:[??,??]RMS.R36 = DSKB:[10,7,DIL]RMS.R36, -
     #DSKn:[??,??]RMSBLK.R36 = DSKB:[10,7,DIL]RMSBLK.R36, -
     #DSKn:[??,??]RMSERR.B36 = DSKB:[10,7,DIL]RMSERR.B36, -
     #DSKn:[??,??]RMSLIB.R36 = DSKB:[10,7,DIL]RMSLIB.R36, -
     #DSKn:[??,??]UUODEF.R36 = DSKB:[10,7,DIL]UUODEF.R36, -
     #DSKn:[??,??]DIL.CTL = DSKB:[10,7,DIL]DIL.CTL, -
     #DSKn:[??,??]DILDEF.CCL = DSKB:[10,7,DIL]DILDEF.CCL, -
     /; Autopatch area, -
     #DSKn:[7,6,CSP]DIL1V2.REL = DSKB:[10,7,DIL]DIL1V2.REL, -
     #DSKn:[7,6,CSP]DIT1V2.REL = DSKB:[10,7,DIL]DIT1V2.REL, -
     #DSKn:[7,6,CSP]DIX1V2.REL = DSKB:[10,7,DIL]DIX1V2.REL, -
     #DSKn:[7,6,CSP]DAP1V1.REL = DSKB:[10,7,DIL]DAP1V1.REL, -
     #DSKn:[7,6,CSP]XPN1V1.REL = DSKB:[10,7,DIL]XPN1V1.REL, -
     /; Installation verification stuff
     #DSKn:[5,33]C36T2.CBL = DSKB:[10,7,DIL]C36T2.CBL, -
     #DSKn:[5,33]CD36T1.CBL = DSKB:[10,7,DIL]CD36T1.CBL, -
     #DSKn:[5,33]CT36T1.CBL = DSKB:[10,7,DIL]CT36T1.CBL, -
     #DSKn:[5,33]F7T2.FOR = DSKB:[10,7,DIL]F7T2.FOR, -
     #DSKn:[5,33]FD7T1.FOR = DSKB:[10,7,DIL]FD7T1.FOR, -
     #DSKn:[5,33]FT7T1.FOR = DSKB:[10,7,DIL]FT7T1.FOR, -
     #DSKn:[5,33]ICSCBL.CTL = DSKB:[10,7,DIL]ICSCBL.CTL, -
     #DSKn:[5,33]ICSF7.CTL = DSKB:[10,7,DIL]ICSF7.CTL
     /REWIND
     /EXIT
     .UNLOAD MTAx:
 
 
 
8.3  Special Considerations
 
The  B361LB.REL   (BLISS   run-time   library)   and   the   XPORT.REL
(transportable  support  library) shipped with the DIL are the current
field-image versions;  if you have BLISS-36 Version  3  or  Version  4
installed, there is no need to install either of these two files.
DIL.DOC -- V2(137) 16-Nov-84                                   Page 17
VAX/VMS INSTALLATION INSTRUCTIONS
 
 
9.0  VAX/VMS INSTALLATION INSTRUCTIONS
 
 
 
                              IMPORTANT
 
               You must have  VMS  V3.1  or  higher  to
               install this kit.
 
 
 
 
 
9.1  CONVENTIONS
 
The following conventions are  used  in  this  document,  and  in  the
VMSINSTAL procedure:
 
[]      
        Square brackets enclose default answers to
        questions VMSINSTAL asks you throughout the
        installation procedure.  To give the default
        answer to a question, simply press the RETURN
        key.
 
 
 
 
9.2  VAX DIL INSTALLATION PROCEDURE
 
Read this entire section carefully before you attempt to  install  VAX
DIL.  The installation procedure should take less than 45 minutes.
 
 
 
9.2.1  Components Of The VAX DIL Facility -
 
An installed VAX DIL facility consists of:
 
      o  The library of Data Interchange routines, DIL.OLB.
 
      o  The sharable image format of the library,  DIL.EXE,  and  the
         LINKER options file to link with the sharable image, DIL.OPT.
 
      o  The text library for the Interface Support files, DIL.TLB.
 
      o  The message files, DITMSG.EXE and DIXMSG.EXE.
 
      o  The file DILTFR.OBJ which defines VMS  transfer  vectors  for
         DIL entry points.
DIL.DOC -- V2(137) 16-Nov-84                                   Page 18
VAX/VMS INSTALLATION INSTRUCTIONS
 
 
      o  XPORT.OLB, which is necessary for DIL and is  installed  only
         if it does not already exist on your system.
 
      o  The DIL Beware file, DIL.BWR.
 
      o  The DIL sources for VAX/VMS.  These sources are provided  for
         reference  only and are not warranted or supported by Digital
         Equipment Corporation.
 
 
 
 
9.2.2  The Installation Procedure -
 
The VAX DIL kit installs the shared image, the executable images,  and
their  associated files.  The kit also installs XPORT.OLB if it is not
present on your system.
 
This installation procedure:
 
      o  Verifies that VMS V3.1 or later is running and that there are
         at least 3000 free blocks for the installation to use.
 
      o  Copies the installation  kit  from  the  kit  medium  to  the
         installation medium.
 
      o  Installs the VAX DIL  images,  message  files  and  XPORT  if
         necessary.
 
      o  Installs the beware file and installs the help file into  the
         system help library.
 
      o  Checks to see if FORTRAN is installed and,  if  so,  compiles
         and  runs  the  FORTRAN  IVP  tests.   You  will  need SYSNAM
         privilege to successfully run the FORTRAN IVP tests.
 
      o  Checks to see if COBOL is installed and, if so, compiles  and
         runs  the COBOL IVP tests.  You will need SYSNAM privilege to
         successfully run the COBOL IVP tests.
 
      o  Optionally purges prior versions of the VAX DIL facility from
         your system.
 
      o  Deletes the files comprising this kit from  the  installation
         medium.
 
DIL.DOC -- V2(137) 16-Nov-84                                   Page 19
VAX/VMS INSTALLATION INSTRUCTIONS
 
 
9.2.3  Installing VAX DIL -
 
The VAX/VMS DIL product kit is a  standard  BACKUP  save  set,  called
DIL020.A.   You  should  use  the  standard VMSINSTAL.COM procedure to
install the VAX Data Interchange library kit.
 
The VAX DIL installation consists of three phases.   During  phase  1,
VMSINSTAL  copies  the  DIL  V2.0  kit  from  the  kit  media  to  the
installation device.  During phase 2,  VMSINSTAL  asks  you  questions
about  the installation and installs the DIL images and files.  During
phase 3, VMSINSTAL runs the Installation Verification Procedure.
 
You will need to be logged into an account which has SYSNAM  privilege
in  order to successfully run the Installation Verification Procedure.
If  an  Installation  Verification  program  fails  with  error   code
15302676, make sure you have SYSNAM privilege.
 
To install the VAX DIL you should:
 
     1.  Log into a system  account  (and  be  sure  you  have  SYSNAM
         privilege).
 
     2.  Execute the VMSINSTAL.COM procedure.
 
     3.  Mount the VAX DIL kit media.
 
     4.  Respond to the questions asked by the installation  procedure
         and VMSINSTAL.
 
 
 
 
9.2.4  Running The VMSINSTAL.COM Procedure -
 
After you have logged into a system account and have assured that  you
have  SYSNAM  privilege,  use  this  DCL  command to run the VMSINSTAL
procedure:
 
@SYS_$UPDATE:VMSINSTAL DIL020 dilu:
 
 
where dilu:  is the physical name of the device on which you mount the
kit  media.   VMSINSTAL  prompts  you for this parameter if you do not
include it.
DIL.DOC -- V2(137) 16-Nov-84                                   Page 20
VAX/VMS INSTALLATION INSTRUCTIONS
 
 
9.2.5  Phase 1:  Copying The Kit To The Installation Device -
 
During Phase 1, VMSINSTAL:
 
      o  Asks you if you need to back up the system disk.
 
      o  Asks you the name of the device on which the kit  media  will
         be  mounted  (only if you did not specify dilu:  as described
         in 9.2.4
 
      o  Asks you the names of the products you wish to install  (only
         if you did not specify DIL020 as described in 9.2.4.
 
      o  Copies the kit from the kit media to the installation device.
 
 
 
 
9.2.5.1  Backing Up The System Disk -
 
VMSINSTAL first asks you the following question:
 
* Are you satisfied with the backup of your system disk [YES]?
 
 
If you have not backed up your system disk, you  should  not  continue
with  the  installation  until  you do so.  If you need to back up the
system disk, type "N".  VMSINSTAL exits and returns  you  to  the  DCL
prompt.  Back up your system disk, and then start VMSINSTAL again.
 
If you have already backed up the system disk, type "Y" and press  the
RETURN key or simply press the RETURN key.
 
See the  appropriate  VMS  software  installation  guide  in  the  VMS
documentation   set   for   more   information   on   backups   before
installations.  For general information on backups,  see  the  VAX/VMS
Utilities Reference Manual.
 
 
 
9.2.5.2  Specifying The Device Name -
 
If you did not specify a physical device name on the DCL command line,
VMSINSTAL   asks  you  for  the  name  of  the  device  on  which  the
distribution media will be mounted.
 
* Where will the distribution volumes be mounted:
 
Type in the physical device name of the appropriate  drive  and  press
RETURN.   You  must  enter  the  physical device name according to the
format:
 
        dilu:
DIL.DOC -- V2(137) 16-Nov-84                                   Page 21
VAX/VMS INSTALLATION INSTRUCTIONS
 
 
 
 
 
 
9.2.5.3  Specifying The Product Name -
 
If you did not specify them on the command line,  VMSINSTAL  will  ask
you  for  the names of the products you wish to install from the first
volume of the distribution media:
 
* Products [EXIT]:
 
In response to this prompt, type:
 
        DIL020
 
 
 
 
9.2.5.4  Copying The Kit Onto The Installation Device -
 
VMSINSTAL then  instructs  you  to  mount  the  first  volume  of  the
distribution volume set on the proper device.  VMSINSTAL then asks:
 
* Are you ready?
 
After you have mounted the volume on the proper device, answer "Y".
 
VMSINSTAL then prints the following messages:
 
The following products will be installed:
 
  DIL    V2.0
 
 
           Beginning installation of DIL V2.0 at hh:mm
 
%VMSINSTAL-I-RESTORE, Restoring product saveset A...
 
After VMSINSTAL has restored the entire kit, Phase 1 is  complete  and
Phase 2 begins.
 
 
 
9.2.6  Phase 2:  The Installation -
 
Before VMSINSTAL installs the DIL images, message  files,  help  file,
source,  etc.,  it  asks  you  if  you  would  like to purge the files
replaced by this installation.  After you have answered this question,
VMSINSTAL will perform the installation for you.
DIL.DOC -- V2(137) 16-Nov-84                                   Page 22
VAX/VMS INSTALLATION INSTRUCTIONS
 
 
9.2.6.1  Deciding Whether To PURGE Files -
 
VMSINSTAL will ask you the following question:
 
* Do you want to purge files replaced by this installation [YES]?
 
 
If you would like VMSINSTAL  to  purge  the  files  replaced  by  this
installation,  type  "Y"  and press the RETURN key or simply press the
return key.  If you do not want VMSINSTAL to purge the files  replaced
by this installation, type "N" and press the RETURN key.
 
 
 
9.2.6.2  Sources -
 
After  you  have  answered  the  question  about  purging  files,  the
following message will appear:
 
    This kit contains a complete set of DIL sources for VMS. They will
    be installed in on the system device directory [DIL]. If this
    directory does not presently exist, this installation procedure
    will create it.  
 
 
The DIL VAX sources  will  all  be  installed  in  the  system  device
directory [DIL].  If that directory does not exist, it will be created
for you.  You do not  need  to  worry  about  creating  the  directory
yourself.   When  the directory is created, you will see the following
message:
 
%VMSINSTAL-I-SYSDIR, This product creates system directory [DIL].
 
If the system device directory [DIL] already exists, you will see  the
following message:
 
%CREATE-I-EXISTS, VMI$ROOT:[DIL] alreay exists
 
 
 
                                 NOTE
 
               The sources are provided for the VAX/VMS
               DIL product.  These sources are provided
               for reference only and are not warranted
               or   supported   by   Digital  Equipment
               Corporation.
 
 
DIL.DOC -- V2(137) 16-Nov-84                                   Page 23
VAX/VMS INSTALLATION INSTRUCTIONS
 
 
9.2.6.3  The Installation -
 
After the system device directory [DIL]  is  created  (if  necessary),
VMSINSTAL  will  perform  the  installation for you.  You will see the
following message from the installation procedure:
 
  This package includes a copy of the DIL Beware file (called DIL.BWR)
  which will be placed in SYS_$UPDATE.
 
 
Next, VMSINSTAL will print the following message:
 
%VMSINSTAL-I-MOVEFILES, Files will now be moved to their target directories... 
 
 
At this point the installation is completed and the IVP can be run.
 
 
 
9.2.7  Phase 3:  The Installation Verification Procedure -
 
 
                                 NOTE
 
 
               In   order    for    the    Installation
               Verification procedure to be useful, you
               should  have  either  COBOL  or  FORTRAN
               installed on your system.
 
 
 
Once the installation has completed, VMSINSTAL will run  the  IVP  for
you.  First, you will see the following message:
 
  WARNING:  You need SYSNAM privilege to run the Installation
            Verification Procedure.  If you do not have SYSNAM
            privilege, certain of the programs will fail with the
            error code 15302676.
 
 
If you are logged into an account which does not have SYSNAM privilege
then  you  will  not  be  able  to  successfully  run  some of the IVP
programs.  You should not run the installation unless you  are  logged
into an account which has SYSNAM privilege.
 
Next you will see the following message:
 
  Please wait while the installation verification is run...
 
which signifies that the IVP procedure has started.
DIL.DOC -- V2(137) 16-Nov-84                                   Page 24
VAX/VMS INSTALLATION INSTRUCTIONS
 
 
Since the Data Interchange Library is callable from COBOL and FORTRAN,
the  IVP consists of a set of COBOL test programs and a set of FORTRAN
test programs.
 
 
 
9.2.7.1  The COBOL IVP Tests -
 
The IVP first checks to see if COBOL is installed on your system.  You
will see the following message:
 
  First, let's see if you have COBOL installed on your system.
 
The IVP will simply do a directory  of  SYS$SYSROOT:[SYSEXE]COBOL.EXE.
If the file is there, then you will see the following message:
 
  Since COBOL is installed on your system, the COBOL IVP tests
  will be run.
 
and then the COBOL IVP is run.  The COBOL test programs are  compiled,
linked and then executed.
 
If the COBOL tests are run, you will see the following output from the
programs:
 
 Doing conversions... 
 Tests through 15 completed successfully.
 Tests through 22 completed successfully. 
 Tests through 24 completed successfully. 
 
 C36T2 successfully completed.
 NFOPP Status return: 000000001   
 NFOPA Status return: 000000001   
 NFGND status return: 015303467   
 NFACC Status return: 000000001   
 Enter some data to be sent over the link: 
 NFSND Status return: 000000001   
 NFRCV Status return: 000000001   
 Data received: 
This is data for CT32T1 for the first send                                                          
 Enter some data to be sent back over the link: 
 NFSND Status return: 000000001   
 NFRCV Status return: 000000001   
 Data received: 
This is data for CT32T1 for the second send                                                         
 NFCLS Status return: 000000001   
 NFGND Status return: 015303499   
 
 CT32T1 test successful
 Enter the value for the record format (RFM):
 0 = undefined,
 1 = fixed,
 2 = variable, 


DIL.DOC -- V2(137) 16-Nov-84                                   Page 25
VAX/VMS INSTALLATION INSTRUCTIONS
 
 
 3 = VFC, 
 4 = stream
 Enter a value for the record attributes (RAT):
 0 = unspecified,
 1 = implied <LF><CR> envelope,
 2 = print file format,
 3 = Fortran carriage control,
 4 = MACY11 format
 ROPEN Status return: 000000001   
 Enter data for the record for the remote file: 
 RWRITE Status return: 000000001   
 RCLOSE Status return: 000000001   
 ROPEN Status return: 000000001   
 RREAD returned 000000001   
 The record was: 
This is dat for CD32T1 for writing to the remote file DAP.TST.                                      
 RCLOSE Status return: 000000001   
 
 CD32T1 test successful. 
 
 
The IVP will then print the message:
 
  COBOL Tests completed.
 
 
If you do not have COBOL installed you will see the following message:
 
  Since COBOL is not installed on this system, the COBOL IVP tests
  cannot be run.
 
and the procedure will go on to the FORTRAN tests.
 
 
 
9.2.7.2  The FORTRAN IVP Tests -
 
The IVP first checks to see if FORTRAN is installed  on  your  system.
You will see the following message:
 
  Now, let's see if you have FORTRAN installed on your system.
 
The IVP will simply do a directory of SYS$SYSROOT:[SYSEXE]FORTRAN.EXE.
If the file is there, then you will see the following message:
 
  Since FORTRAN is installed on your system, the FORTRAN IVP tests
  will be run.
 
and then the FORTRAN IVP  is  run.   The  FORTRAN  test  programs  are
compiled, linked and then executed.
DIL.DOC -- V2(137) 16-Nov-84                                   Page 26
VAX/VMS INSTALLATION INSTRUCTIONS
 
 
If the FORTRAN tests are run, you will see the following  output  from
the programs:
 
Doing conversions
Tests through 15 completed successfully
Tests through 22 successfully completed
Tests through 24 successfully completed
F32T2 successfully completed
NFOPP Status return:            1
NFOPA Status return:            1
NFGND Status return:     15303467
NFACC Status return:            1
Enter some data to be sent over the link: 
NFSND Status return:            1
NFRCV Status return:            1
Data received: 
This is data for FT32T1 for the first send                                      
Enter some data to be sent over the link: 
NFSND Status return:            1
NFRCV Status return:            1
Data received: 
This is data for FT32T1 for the second send                                     
NFCLS Status return:            1
FT32T1 test successful. 
FORTRAN STOP
ROPEN status return:          1
Enter data for the record: 
RWRITE status return:          1
RCLOSE status return:          1
ROPEN status return:          1
RREAD status return:          1
The record read was: 
This is data for FD32T1 for writing to the remote file DAP.TST.                                     
RCLOSE status return:          1
** FD32T1 test successful ** 
FORTRAN STOP
 
 
The IVP will then print the message:
 
  FORTRAN Tests completed.
 
 
If you do not have  FORTRAN  installed  you  will  see  the  following
message:
 
  Since FORTRAN is not installed on this system the FORTRAN IVP tests
  cannot be run.
 
DIL.DOC -- V2(137) 16-Nov-84                                   Page 27
VAX/VMS INSTALLATION INSTRUCTIONS
 
 
9.2.7.3  End Of The IVP -
 
After the FORTRAN portion of  the  IVP  has  run,  you  will  see  the
following message:
 
        IVP FOR DIL V2.0 COMPLETED.
 
 
 
 
9.2.7.4  End Of The Installation -
 
After the IVP has run, the installation is completed and you will  see
the message:
 
        Installation of DIL V2.0 completed at hh:mm
 
        VMSINSTAL procedure done at hh:mm
 
 
 
 
9.3  LOG OF A SAMPLE INSTALLATION OF DIL
 
$ @vmsinstal.com dil020 disk$dracula:[sclemens]
 
        VAX/VMS Software Product Installation Procedure V4.0
 
 
It is 5-OCT-1984 at 11:30.
Enter a question mark (?) at any time for help.
%VMSINSTAL-W-NOTSYSTEM, You are not logged in to the SYSTEM account.
%VMSINSTAL-W-NOSETPRV, You are not running on an account with SETPRV privilege.
%VMSINSTAL-W-LOWQUOTA, One or more account quotas may be too low.
%VMSINSTAL-W-DECNET, Your DECnet network is up and running.
%VMSINSTAL-W-ACTIVE, The following processes are still active:
        SMITH
        BROWN
        MARTIN
* Do you want to continue anyway [NO]? Y
* Are you satisfied with the backup of your system disk [YES]? 
 
The following products will be processed:
  DIL    V2.0
 
        Beginning installation of DIL V2.0 at 11:30
%VMSINSTAL-I-RESTORE, Restoring product saveset A...
 
 
                     DATA INTERCHANGE LIBRARY (DIL)
 
                             Installation
 
DIL.DOC -- V2(137) 16-Nov-84                                   Page 28
VAX/VMS INSTALLATION INSTRUCTIONS
 
 
                              Version 2.0
 
 
* Do you want to purge files replaced by this installation [YES]? Y
 
    This kit contains a complete set of DIL sources for VMS. They will
    be installed in on the system device directory [DIL]. If this
    directory does not presently exist, this installation procedure
    will create it.  
 
%VMSINSTAL-I-SYSDIR, This product creates system directory [DIL].
 
  This package includes a copy of the DIL Beware file (called DIL.BWR)
  which will be placed in SYS$UPDATE.
 
%VMSINSTAL-I-MOVEFILES, Files will now be moved to their target directories...
 
 
  WARNING:  You need SYSNAM privilege to run the Installation
            Verification Proceedure.  If you do not have SYSNAM
            privilege, certain of the programs will fail with the
            error code 15302676.
 
 
  Please wait while the installation verification is run...
 
 
 
  First, let's see if you have COBOL installed on your system.
 
 
Directory SYS$SYSROOT:[SYSEXE]
 
COBOL.EXE;1         
 
Total of 1 file.
 
  Since COBOL is installed on your system, the COBOL IVP tests
  will be run.
 
 Doing conversions... 
 Tests through 15 completed successfully.
 Tests through 22 completed successfully. 
 Tests through 24 completed successfully. 
 
 C36T2 successfully completed.
 NFOPP Status return: 000000001   
 NFOPA Status return: 000000001   
 NFGND status return: 015303467   
 NFACC Status return: 000000001   
 Enter some data to be sent over the link: 
 NFSND Status return: 000000001   
 NFRCV Status return: 000000001   
DIL.DOC -- V2(137) 16-Nov-84                                   Page 29
VAX/VMS INSTALLATION INSTRUCTIONS
 
 
 Data received: 
This is data for CT32T1 for the first send                                                          
 Enter some data to be sent back over the link: 
 NFSND Status return: 000000001   
 NFRCV Status return: 000000001   
 Data received: 
This is data for CT32T1 for the second send                                                         
 NFCLS Status return: 000000001   
 NFGND Status return: 015303499   
 
 CT32T1 test successful
 Enter the value for the record format (RFM):
 0 = undefined,
 1 = fixed,
 2 = variable, 
 3 = VFC, 
 4 = stream
 Enter a value for the record attributes (RAT):
 0 = unspecified,
 1 = implied <LF><CR> envelope,
 2 = print file format,
 3 = Fortran carriage control,
 4 = MACY11 format
 ROPEN Status return: 000000001   
 Enter data for the record for the remote file: 
 RWRITE Status return: 000000001   
 RCLOSE Status return: 000000001   
 ROPEN Status return: 000000001   
 RREAD returned 000000001   
 The record was: 
This is dat for CD32T1 for writing to the remote file DAP.TST.                                      
 RCLOSE Status return: 000000001   
 
 CD32T1 test successful. 
 
 
 
  COBOL Tests completed.
 
 
 
  Now, let's see if you have FORTRAN installed on your system.
 
 
Directory SYS$SYSROOT:[SYSEXE]
 
FORTRAN.EXE;2       
 
Total of 1 file.
 
  Since FORTRAN is installed on your system, the FORTRAN IVP tests
  will be run.
 
DIL.DOC -- V2(137) 16-Nov-84                                   Page 30
VAX/VMS INSTALLATION INSTRUCTIONS
 
 
Doing conversions
Tests through 15 completed successfully
Tests through 22 successfully completed
Tests through 24 successfully completed
F32T2 successfully completed
NFOPP Status return:            1
NFOPA Status return:            1
NFGND Status return:     15303467
NFACC Status return:            1
Enter some data to be sent over the link: 
NFSND Status return:            1
NFRCV Status return:            1
Data received: 
This is data for FT32T1 for the first send                                      
Enter some data to be sent over the link: 
NFSND Status return:            1
NFRCV Status return:            1
Data received: 
This is data for FT32T1 for the second send                                     
NFCLS Status return:            1
FT32T1 test successful. 
FORTRAN STOP
ROPEN status return:          1
Enter data for the record: 
RWRITE status return:          1
RCLOSE status return:          1
ROPEN status return:          1
RREAD status return:          1
The record read was: 
This is data for FD32T1 for writing to the remote file DAP.TST.                                     
RCLOSE status return:          1
** FD32T1 test successful ** 
FORTRAN STOP
 
 
  FORTRAN Tests completed.
 
 
 
        IVP FOR DIL V2.0 COMPLETED.
 
 
        Installation of DIL V2.0 completed at 11:40
 
        VMSINSTAL procedure done at 11:41
 
$
DIL.DOC -- V2(137) 16-Nov-84                                   Page 31
VAX/VMS INSTALLATION INSTRUCTIONS
 
 
9.4  FILES CREATED OR MODIFIED BY THE DIL INSTALLATION PROCEDURE
 
Successful installation of the VAX Data  Interchange  Library  creates
the following files on your system:
 
         SYS$LIBRARY:DIL.EXE
         SYS$LIBRARY:DIL.OLB
         SYS$LIBRARY:DIL.OPT
         SYS$LIBRARY:DIL.TLB
         SYS$LIBRARY:DILTFR.OBJ
         SYS$MESSAGE:DITMSG.EXE
         SYS$MESSAGE:DIXMSG.EXE
         SYS$LIBRARY:XPORT.OLB
 
         [installed only if XPORT  is  not  presently  installed  your
         system]
         SYS$UPDATE:DILV2.MAN
         SYS$UPDATE.DIL.BWR
 
 
The following files will be installed in the system  device  directory
[DIL]:
 
         AAA.BLI
         BUILD.COM
         COMDIL.COM
         COMDIT.COM
         COMDIX.COM
         DAPPER.B32
         DILC32.INT
         DILC3220.INT
         DILDEF.COM
         DILF32.FOR
         DILF32A.FOR
         DILEXE.COM
         DILHST.BLI
         DILINT.BLI
         DILOLB.COM
         DILSWI.REQ
         DILTFR.MAR
         DIT32ANSI.INT
         DITC20.INT
         DITC32.INT
         DITF32.INT
         DITHST.BLI
         DITMSG.MSG
         DIXC32.INT
         DIXC3220.INT
         DIXCST.BLI
         DIXDEB.BLI
DIL.DOC -- V2(137) 16-Nov-84                                   Page 32
VAX/VMS INSTALLATION INSTRUCTIONS
 
 
         DIXDEB.REQ
         DIXDN.BLI
         DIXF32.INT
         DIXF32A.INT
         DIXFBN.BLI
         DIXFP.BLI
         DIXGBL.BLI
         DIXGEN.BLI
         DIXHST.BLI
         DIXLIB.BLI
         DIXPD.BLI
         DIXREQ.REQ
         DIXSTR.BLI
         DIXSWI.REQ
         DIXUTL.BLI
         FIELDS.BLI
         INTERFILS.BLI
         INTERFILS.COM
         MAKDIXMSG.BLI
         POS20.BLI
         POSGEN.BLI
         RMSSTUFF.R32
         TTT.B32
         VERSION.REQ
 
 
The installation procedure modifies the following files:
 
         SYS$HELP:HELPLIB.HLB
 
DIL.DOC -- V2(137) 16-Nov-84                                   Page 33
INSTALLATION VERIFICATION SYSTEM
 
 
10.0  INSTALLATION VERIFICATION SYSTEM
 
The Installation Verification System is a set of batch control  files.
Each  of  these batch control files contains commands to compile, link
and run the programs which have been provided with the DIL to  perform
Installation Verification.  There are batch control files for TOPS-10,
TOPS-20 and VAX/VMS systems.  For each of the supported  languages  on
each  of  these  systems  there is one installation verification batch
control file.  On VAX/VMS systems, the  installation  verification  is
run for you, automatically, by the VMSINSTAL command procedure.
 
A list of the the batch control files for  each  language  and  system
combination follows:
 
TOPS-20 files:             Language:
 
        ICSCBL.CTL         COBOL
        ICSF7.CTL          FORTRAN V7
 
TOPS-10 files:             Language:
 
        ICSCBL.CTL         COBOL
        ICSF7.CTL          FORTRAN V7
 
VAX/VMS files:             Language:
 
        ICSCOB.COM         COBOL
        ICSFOR.COM         FORTRAN
 
The programs which are  supplied  for  installation  verification  run
minimal tests on each set of the DIL routines provided for each of the
supported language/system combination.  The sets  of  routines  tested
are:   (1) Data Conversion (2) Remote File Access and (3) Task-to-Task
routines.
 
A list of the programs for each system and the set  of  routines  they
test (and the control file which runs them) is below:
 
Program name:     Routines tested:     System:  Control file:
 
C36T2.CBL         Data conversion      TOPS-20   ICSCBL.CTL
                                       TOPS-10   ICSCBL.CTL
CD36T1.CBL        Remote file access   TOPS-20   ICSCBL.CTL
                                       TOPS-10   ICSCBL.CTL
CT36T1.CBL        Task-to-task         TOPS-20   ICSCBL.CTL
                                       TOPS-10   ICSCBL.CTL
C32T2.COB         Data conversion      VAX/VMS   ICSCOB.COM
CD32T1.COB        Remote file access   VAX/VMS   ICSCOB.COM
CT32T1.COB        Task-to-task         VAX/VMS   ICSCOB.COM
F7T2.FOR          Data conversion      TOPS-20   ICSF7.CTL
                                       TOPS-10   ICSF7.CTL
FD7T1.FOR         Remote file access   TOPS-20   ICSF7.CTL
                                       TOPS-10   ICSF7.CTL
DIL.DOC -- V2(137) 16-Nov-84                                   Page 34
INSTALLATION VERIFICATION SYSTEM
 
 
FT7T1.FOR         Task-to-task         TOPS-20   ICSF7.CTL
                                       TOPS-10   ICSF7.CTL
F32T2.FOR         Data conversion      VAX/VMS   ICSFOR.COM
FD32T1.FOR        Remote file access   VAX/VMS   ICSFOR.COM
FT32T1.FOR        Task-to-task         VAX/VMS   ICSFOR.COM
 
 
All of the test programs use the DIL Interface Support files.
 
The task-to-task and  remote  file  access  installation  verification
programs use only the local network node.
 
The DIL must be installed in accordance with the instructions provided
with  the  DIL.  If it is not, the Installation Verification system is
irrelevant.
DIL.DOC -- V2(137) 16-Nov-84                                   Page 35
INSTALLATION VERIFICATION SYSTEM
 
 
10.1  TOPS-20 Installation Verification
 
On TOPS-20, the Installation Verification System consists of two batch
control  files;   one for COBOL and one for FORTRAN Version 7.  To run
the test system, you simply run the  batch  control  files  using  the
SUBMIT command, wait for the batch job to finish, and then examine the
resulting batch log file.  Before you run any  of  the  TOPS-20  batch
streams  you  should read this section and the section above to insure
that the test streams run properly.
 
For all of the TOPS-20 Installation Verification System batch streams,
you  will  need  a VALID login directory called PS:<DIL-TEST> with the
password DIL-TEST.  If this directory is not set up properly, some  of
the  test  programs  will fail.  If your system is set up with account
validation  enabled,  then  you  must  ensure   that   the   directory
PS:<DIL-TEST>   has  a  valid  account  default  for  login  set,  and
PS:<SYSTEM>ACCOUNTS-TABLE.BIN reflects that  this  account  is  indeed
valid  specifically for the directory PS:<DIL-TEST>.  (You may specify
any  valid  account  default  for  login  that  you  wish.)  For  more
information  on  account  validation,  see the TOPS-20 System Managers
Guide.
 
The  directory  PS:<DIL-TEST>  does  not   require   any   privileges.
Permanent and working disk quotas of 500 or more blocks are required.
 
If you do not want to use the directory PS:<DIL-TEST> you will have to
edit  the files listed below to change the directory name and password
to one of your choice:
 
         CD36T1.CBL
         FD7T1.FOR
         ICSCBL.CTL
         ICSF7.CTL
 
 
The programs that test DIT routines will exercise the FALs.  If  there
is  not  a FAL free for the program to use, it will die with the error
DIT-NETOPRFAIL (return code values 61210656 through 61210660).
 
To run the Installation Verification type the following commands:
        @SUBMIT ICSCBL.CTL
        @SUBMIT ICSF7.CTL
DIL.DOC -- V2(137) 16-Nov-84                                   Page 36
INSTALLATION VERIFICATION SYSTEM
 
 
Here is an example of running one  of  the  Installation  Verification
Test  streams  for TOPS-20.  The same procedure is used for all of the
Installation Verification tests on TOPS-20.
 
@; Begin sample run of TOPS-20 COBOL Installation Verification.
@
@; Make sure the Installation Verification programs for this test
@; stream are all in the directory that will be connected to when
@; the batch stream runs.
@
@dir icscbl.ctl, c36t2.cbl, cd36t1.cbl, ct36t1.cbl
 
   PS:<DIL-TEST>
 ICSCBL.CTL.3
 C36T2.CBL.1
 CD36T1.CBL.1
 CT36T1.CBL.1
 
 Total of 4 files
@
@
@; All the files needed are here.  Submit the control file
@; and run the test.
@
@submit icscbl.ctl/output:nolog
[Batch job ICSCBL queued, request #1261, limit 0:05:00]
@
@; Wait for the batch job to finish.
@
@information batch/user:DIL-TEST
[The queues are empty]
@
@; The batch job is done.  Print the log file and examine it to make
@; sure there are no errors.
@
@print ICSCBL.LOG
@
@; If a test program finishes without error, it will give a message
@; saying that it has completed successfully.  If there is an error
@; when you run the programs, there will be a message such as "Invalid
@; status returned from NFOPP".  If you get an error, make sure that
@; you have set up the proper directory for these tests.  Verify that
@; your network is up and that there are enough FALs running.  If you
@; get an error at link or compile time, make sure that the DIL is
@; installed as directed.
DIL.DOC -- V2(137) 16-Nov-84                                   Page 37
INSTALLATION VERIFICATION SYSTEM
 
 
10.2  TOPS-10 Installation Verification
 
On TOPS-10, the Installation Verification System consists of two batch
control  files;   one for COBOL and one for FORTRAN Version 7.  To run
the test system, you simply run the  batch  control  files  using  the
SUBMIT command, wait for the batch job to finish, and then examine the
resulting batch log file.  Before you run any  of  the  TOPS-10  batch
streams  you  should read this section to insure that the test streams
run properly.
 
For all of the TOPS-10 Installation Verification System batch streams,
you  will need a VALID PPN called [5,33] with the password DILTST.  If
this directory is not set up properly, some of the test programs  will
fail.
 
The PPN [5,33] does not require any privileges.  Disk quotas  of  1100
blocks or more are required.
 
If you do not want to use the PPN [5,33] you will  have  to  edit  the
files listed below to change the directory name and password to one of
your choice:
 
         CD36T1.CBL
         FD7T1.FOR
         ICSCBL.CTL
         ICSF7.CTL
 
 
The programs that test DIT routines will exercise the FALs.  If  there
is  not  a FAL free for the program to use, it will die with the error
DIT-NETOPRFAIL (return code values 61210656 through 61210660).
 
To run the Installation Verification type the following commands:
        .SUBMIT ICSCBL.CTL
        .SUBMIT ICSF7.CTL
DIL.DOC -- V2(137) 16-Nov-84                                   Page 38
INSTALLATION VERIFICATION SYSTEM
 
 
Below is a sample run of one of  the  Installation  Verification  Test
streams  for  TOPS-10.   The  same  procedure  is  used for ALL of the
Installation Verification tests on TOPS-10.
 
.; Begin sample run of TOPS-10 COBOL Installation Verification.
.
.; Make sure that the Installation Verification test program and batch
.; control file are in this directory.
.
.dir icscbl.ctl, c36t2.cbl, cd36t1.cbl, ct36t1.cbl
 
 
ICSCBL  CTL     6  <007>   12-Apr-84    DSKB:   [5,33]
C36T2   CBL    19  <007>   11-Apr-84
CD36T1  CBL    13  <007>   12-Apr-84
CT36T1  CBL    14  <007>    9-Apr-84
  Total of 52 blocks in 4 files
 
.
.
.; Submit the TOPS-10 COBOL Installation Verification batch stream.
.
.submit icscbl.ctl/notify:y/output:nolog
[Batch job ICSCBL queued, request #372, limit 1:00:00]
 
.
[From SYSTEM: Job ICSCBL request #372 finished executing at 15:19:20]
 
.
.; The batch job is finished.  You should examine the log file to
.; make sure that no errors have occured.
.
.; If a test program finishes without error, it will give a message
.; saying that it has completed successfully.  If there is an error
.; when you run the programs, there will be a message such as "Invalid
.; status returned from NFOPP".  If you get an error, make sure that
.; you have set up the proper directory for these tests.  Verify that
.; your network is up and that there are enough FALs running.  If you
.; get an error at link or compile time, make sure that the DIL is
.; installed as directed.
DIL.DOC -- V2(137) 16-Nov-84                                   Page 39
INSTALLATION VERIFICATION SYSTEM
 
 
10.3  VAX/VMS Installation Verification
 
On VAX/VMS systems, the installation  verification  procedure  is  run
automatically  by  the  VMSINSTAL command procedure.  The installation
verification proceedure checks to see if COBOL is  installed  on  your
system,  and  if it is, runs the COBOL tests.  Then a check is made to
see if FORTRAN is installed on your system, and if it is, the  FORTRAN
tests  are  run.   If  either language is NOT installed, the tests for
that language are skipped over.
 
You will need SYSNAM privilege to run  the  Installation  Verification
Procedure.   If  you  do  not  have  SYSNAM  privilege, certain of the
Installation Verification tests will fail with error code 15302676.
 
See  section  8.2.7  for  more  information  about  the  VAX/VMS   DIL
Installation Verification procedure.
DIL.DOC -- V2(137) 16-Nov-84                                   Page 40
PRODUCT CHANGES
 
 
11.0  PRODUCT CHANGES
 
 
      o  DATA CONVERSION
 
         The following new routines were added to the data  conversion
         modules for DIL V2.
 
             DIXPD/DIX$$CON_PD  --  Convert  packed  decimal  data  to
             packed decimal data.  (TOPS-10, TOPS-20, VAX/VMS).
 
             DIXDN/DIX$$CON_DN --  Convert  display  numeric  data  to
             display numeric data.  (TOPS-10, TOPS-20, VAX/VMS).
 
             XCPDDN -- Convert packed decimal data to display  numeric
             data.  (TOPS-10/TOPS-20 only).
 
             XCPDFB -- Convert packed  decimal  data  to  fixed  point
             binary data.  (TOPS-10/TOPS-20 only).
 
             XCDNFB -- Convert display numeric  data  to  fixed  point
             binary data.  (TOPS-10/TOPS-20 only).
 
             XCDNPD -- Convert display numeric data to packed  decimal
             data.  (TOPS-10/TOPS-20 only).
 
             XCFBDN -- Convert fixed  point  binary  data  to  display
             numeric data.  (TOPS-10/TOPS-20 only).
 
             XCFBPD -- Convert  fixed  point  binary  data  to  packed
             decimal data.  (TOPS-10/TOPS-20 only).
 
             The routines CVGEN/DIX$BY_DET,  XCGEN/DIX$BY_DIX_DES  and
             XDESCR/DIX$MAK_DES_DET  have  been  expanded to cover the
             new conversion capabilities.
 
 
      o  TASK-TO-TASK and REMOTE FILE ACCESS
 
         The full set of task-to-task and remote file access routines,
         previously  provided only for TOPS-20 and VAX/VMS systems, is
         now provided also for TOPS-10 systems.
 
         Two  new  task-to-task  routines  have  been  added  for  all
         supported systems (TOPS-20, TOPS-10, VAX/VMS):
 
             NFINT/DIT$NFINT -- Send an interrupt data message over  a
             logical link.
 
             NFRCI/DIT$NFRCI  --  Receive  a  single  interrupt   data
             message over a logical link.
 
DIL.DOC -- V2(137) 16-Nov-84                                   Page 41
SUGGESTIONS
 
 
12.0  SUGGESTIONS
 
None.
DIL.DOC -- V2(137) 16-Nov-84                                   Page 42
DATA INTERCHANGE LIBRARY SAMPLE APPLICATION
 
 
13.0  DATA INTERCHANGE LIBRARY SAMPLE APPLICATION
 
13.1  Description
 
The Data Interchange Library Sample Application is a distributed COBOL
application  which  uses the Task-to-task, Remote File Access and Data
Conversion routines of the DIL.
 
The application is a "Labor Ticket"  collection  system.   It  enables
each  employee  to enter weekly time card information from a terminal,
either on a  VAX,  a  DECSYSTEM-20,  or  a  DECsystem-10.   The  labor
information  collected  from remote and local terminals is stored in a
file on the DECSYSTEM-20, or  DECsystem-10,  depending  on  where  the
server is running.  A summary report, in the form of a sequential file
stored on the VAX, is written from a separate report  program  on  the
DECSYSTEM-20, or DECsystem-10.  Before running the sample application,
the program IDXINI.CBL should  be  run  on  the  DECSYSTEM-20  or  the
DECsystem-10  where  the  server is going to be running.  This program
initializes the indexed sequential data file used by the application.
 
The server program (JTSERV.CBL) can serve multiple users and therefore
has  the  capability  to  open  four  or  six  network  links.   (On a
DECSYSTEM-20,  a  process  which  is  running  without  enabled  WHEEL
privileges  can  only  open  four links.  If the process is an enabled
WHEEL, then six links will be opened.  PROCES.MAC checks  the  process
running  the  server  program to see if it is an enables WHEEL and can
therefore open six rather than four links.  PROCES is called from  the
server.   On  a  DECsystem-10,  PROCES.MAC checks to see if the job is
running under [1,2].) The server program opens passive links and waits
for connect events from remote tasks.  The terminal interface programs
(JTTERM.CBL which will run on either a DECSYSTEM-20 or a DECsystem-10)
and  JTTERM.COB  which  will  run  on  a  VAX/VMS system) are run from
terminals whenever a user wants to enter in labor ticket information.
 
When a user starts up the terminal interface program  on  his  system,
that  program  attempts  to connect to the remote server program.  The
server then accepts the link.  The  user  at  the  terminal  interface
program can then request to update labor ticket information or to exit
the program.  If an update is  requested,  the  employee's  badge  (or
identification)  number  is  collected  and  sent  to the server.  The
server will then query the data  file  to  see  if  the  badge  number
presently  exists.   The  server  will  send a message to the terminal
interface program with the result of the query.   The  user  can  then
continue  or  abort  the  update.   If  the  update  is continued, the
remainder of the labor ticket information is collected and sent to the
server to be stored.  Otherwise, the server is sent a message to abort
this particular update.  Once the update is finished (or aborted), the
user can then update again or exit.
 
The  report  program  (JTVRPT.CBL)  runs  on  the   DECSYSTEM-20,   or
DECsystem-10 and writes a remote file onto a VAX.  It is not a part of
the Task-to-task proces described above.   It  can  be  run  at  will,
either in batch or from a user terminal.
DIL.DOC -- V2(137) 16-Nov-84                                   Page 43
DATA INTERCHANGE LIBRARY SAMPLE APPLICATION
 
 
13.2  Running The Sample Application
 
To run the DIL Sample Application on your systems, you must first edit
the  programs  to reflect the node names and directory names which you
choose to use.  Once you have finished editing, you should compile and
link the DECSYSTEM-20 programs as follows:
 
@COBOL
COBOL>IDXINI.CBL
COBOL>JTSERV.CBL/STACK:2000
COBOL>JTTERM.CBL/STACK:2000
COBOL>JTVRPT.CBL/STACK:2000
COBOL>EXIT
@MACRO
*PROCES=PROCES
@
@LINK
*IDXINI/GO
@SAVE
@
@LINK
*JTSERV,PROCES,SYS:DIL/SE,SYS:XPORT/SE/EXCLUDE:XFUNCT/G
@SAVE
@
@LINK
*JTTERM,SYS:DIL/SE,SYS:XPORT/SE/EXCLUDE:XFUNCT/G
@SAVE
@
@LINK
*JTVRPT,SYS:DIL/SE,SYS:XPORT/SE/EXCLUDE:XFUNCT/G
@SAVE
@
@; initialize the data file JOBTIC.RMS
@RUN IDXINI
@
 
You should compile and link the DECsystem-10 programs as follows:
 
.r cbl74
*=IDXINI.CBL
*=JTSERV.CBL/D:2000
*=JTTERM.CBL/D:2000
*=JTVRPT.CBL/D:2000
*^Z
.r macro
*PROCES=PROCES
.
.r link
*IDXINI/G
.save
.
.r link
*JTSERV,PROCES
DIL.DOC -- V2(137) 16-Nov-84                                   Page 44
DATA INTERCHANGE LIBRARY SAMPLE APPLICATION
 
 
*/SEG:LOW SYS:DIL/SE,SYS:XPORT/SE/EXCLUDE:XFUNCT,SYS:B361LB/SEA/G
.save
.
.r link
*JTTERM
*/SEG:LOW SYS:DIL/SE,SYS:XPORT/SE/EXCLUDE:XFUNCT,SYS:B361LB/SEA/G
.save
.
.r link
*JTVRPT
*/SEG:LOW SYS:DIL/SE,SYS:XPORT/SE/EXCLUDE:XFUNCT,SYS:B361LB/SEA/G
.save
.
.; initialize the data file JOBTIC.RMS
.run IDXINI
.
 
On the VAX, you should compile and link  the  VAX  terminal  interface
program as below:
$ cobol JTTERM.COB
$
$ link JTTERM,SYS$LIBRARY:DIL/LIB,SYS$LIBRARY:XPORT/LIB
$
 
Then, you should start the  server  program  on  the  DECSYSTEM-20  as
follows:
 
@run JTSERV
 
Or, you should  start  the  server  program  on  the  DECsystem-10  as
follows:
 
.run JTSERV
 
Once this is done, you can run the terminal  interface  programs  from
either your VAX, DECSYSTEM-20, or DECsystem-10.
 
 
 
14.0  BUILDING DIL
 
This is a brief explanation of how to build DIL on a TOPS-10,  TOPS-20
or VAX/VMS system.
 
 
 
15.0  BUILDING DIL ON TOPS-10
 
DIL.DOC -- V2(137) 16-Nov-84                                   Page 45
BUILDING DIL ON TOPS-10
 
 
                                 NOTE
 
               Before  you  attempt  to  build  DIL  on
               TOPS-10,  make  sure  you have Autopatch
               Tape 8,  or  later,  installed  on  your
               system.
 
 
 
To build DIL  on  TOPS-10,  customers  should  submit  DIL.CTL.   This
control  file  submits  the  following  batch jobs in the order listed
below, with the switches specified:
 
   o  SUBMIT EXT1A.CTL/TIME/RESTART:YES/TAG:RENG
   o  SUBMIT XPN1A.CTL/DEPEND:1/TIME/RESTART:YES/TAG:RENG
   o  SUBMIT DAP1A.CTL/DEPEND:1/TIME/RESTART:YES/TAG:RENG
   o  SUBMIT DXCM10.CTL/DEPEND:1/TIME/RESTART:YES
   o  SUBMIT DLCM10.CTL/DEPEND:1/TIME/RESTART:YES/TAG:RENG
   o  SUBMIT DTCM10.CTL/DEPEND:1/TIME/RESTART:YES
   o  SUBMIT DLMK10.CTL/DEPEND:1/TIME/RESTART:YES/TAG:RENG
   o  SUBMIT INTR10.CTL/DEPEND:1/TIME/RESTART:YES
 
After the batch jobs  finish  processing,  check  the  log  files  for
errors.
 
On TOPS-10 (only) there is a BLISS bug which causes request blocks  to
be generated with references to specific disk structure names and UICs
of certain library files required by BLISS.   Since  not  all  systems
have  the  same  disk  structure names as the system used for building
DIL, it is necessary to patch the DIL.REL once the build is complete.
 
If you are building DIL for use on a single  system,  you  can  ignore
this  patching process.  However, if you intend to move DIL to another
DECsystem-10 with different  structure  names,  you  must  patch  your
version of DIL.
 
In order to patch the DIL.REL file  the  following  procedure  can  be
used.
 
First, determine which disk structure name  has  been  hardcoded  into
your  DIL.REL  file.   One  way  to do this is to copy the DIL.REL you
built onto a system with different structure names, and trying to link
a  DIL  application  program  there with the DIL.REL.  The LINKER will
question you about the invalid  structure  name.   For  this  example,
assume  it  is  DSKA:   that is discovered to be the invalid structure
name.  It will be necessary to change any occurances of "DSKA" in  the
DIL.REL  file  to  "SYS ".  In order to do this, all the occurances of
"DSKA" must first be located.
 
To find  the  address  of  every  occurance  of  "DSKA",  perform  the
following command sequence:
 
        .R FILDDT
DIL.DOC -- V2(137) 16-Nov-84                                   Page 46
BUILDING DIL ON TOPS-10
 
 
        *DIL.REL/D
        777777,,770000<ESC>m            ;create a mask
        446353,,410000<ESC>w            ;search for all occurances of "DSKA"
 
 
This command sequence will search for all  occurances  of  the  SIXBIT
code  for  "DSKA".   To  tailor  this to your system, change the value
"446353,,410000" in the command sequence above to be the SIXBIT  value
for your structure name.
 
After you type the command sequence above, FILDDT should  display  the
following sort of information.
 
        57227/   EQVM 7,410000(13)
        64734/   EQVM 7,410000(13)
        71701/   EQVM 7,410000(13)
        76053/   EQVM 7,410000(13)
        101027/   EQVM 7,410000(13)
        102071/   EQVM 7,410000(13)
        103651/   EQVM 7,410000(13)
        111710/   EQVM 7,410000(13)
        114053/   EQVM 7,410000(13)
        116332/   EQVM 7,410000(13)
        116517/   EQVM 7,410000(13)
        123513/   EQVM 7,410000(13)
        124627/   EQVM 7,410000(13)
        127270/   EQVM 7,410000(13)
        127435/   EQVM 7,410000(13)
        127637/   EQVM 7,410000(13)
        131173/   EQVM 7,410000(13)
        131315/   EQVM 7,410000(13)
        132541/   EQVM 7,410000(13)
        132613/   EQVM 7,410000(13)
        137627/   EQVM 7,410000(13)
        144672/   EQVM 7,410000(13)
        146242/   EQVM 7,410000(13)
        151473/   EQVM 7,410000(13)
        152043/   EQVM 7,410000(13)
        152411/   EQVM 7,410000(13)
        156602/   EQVM 7,410000(13)
        160006/   EQVM 7,410000(13)
        160571/   EQVM 7,410000(13)
        162037/   EQVM 7,410000(13)
        163223/   EQVM 7,410000(13)
 
You have now isolated the addresses of the culprit DSKA specifiations.
Next,  using  the  addresses you found above, you should create a file
called PATCH.DDT, which can be used by FILDDT to  patch  the  product,
replacing  the  occurances of "DSKA" with "SYS".  The file should look
something like the following:
 
        57227/<ESC>"/SYS/
        64734/<ESC>"/SYS/
DIL.DOC -- V2(137) 16-Nov-84                                   Page 47
BUILDING DIL ON TOPS-10
 
 
        71701/<ESC>"/SYS/
        76053/<ESC>"/SYS/
        101027/<ESC>"/SYS/
        102071/<ESC>"/SYS/
        103651/<ESC>"/SYS/
        111710/<ESC>"/SYS/
        114053/<ESC>"/SYS/
        116332/<ESC>"/SYS/
        116517/<ESC>"/SYS/
        123513/<ESC>"/SYS/
        124627/<ESC>"/SYS/
        127270/<ESC>"/SYS/
        127435/<ESC>"/SYS/
        127637/<ESC>"/SYS/
        131173/<ESC>"/SYS/
        131315/<ESC>"/SYS/
        132541/<ESC>"/SYS/
        132613/<ESC>"/SYS/
        137627/<ESC>"/SYS/
        144672/<ESC>"/SYS/
        146242/<ESC>"/SYS/
        151473/<ESC>"/SYS/
        152043/<ESC>"/SYS/
        152411/<ESC>"/SYS/
        156602/<ESC>"/SYS/
        160006/<ESC>"/SYS/
        160571/<ESC>"/SYS/
        162037/<ESC>"/SYS/
        163223/<ESC>"/SYS/
 
Once you have created PATCH.DDT, submit a  batch  control  file  which
contains the following commands:
 
        .R FILDDT
        *DIL.REL/D/P
        =^[Y
        *PATCH.DDT
        =^Z
 
 
Once this control  file  has  successfully  finished  processing,  the
patching is complete.
 
 
 
16.0  BUILDING DIL ON TOPS-20
 
DIL.DOC -- V2(137) 16-Nov-84                                   Page 48
BUILDING DIL ON TOPS-20
 
 
                                 NOTE
 
               Before  you  attempt  to  build  DIL  on
               TOPS-20,  make  sure  you have Autopatch
               Tape 8,  or  later,  installed  on  your
               system.
 
 
 
To build DIL on TOPS-20, submit the following  control  files  in  the
following order, with the switches specified:
 
   o  SUBMIT EXT1A-DIL.CTL /TAG:COMBIN
   o  SUBMIT XPN1A-DIL.CTL /TAG:COMBIN /DEPEND:1 /TIME:00:10:00
   o  SUBMIT DAP1A-DIL.CTL /TAG:COMBIN /DEPEND:1 /TIME:00:10:00
   o  SUBMIT COMPDX.CTL /TAG:RENG /DEPEND:1 /TIME:00:15:00
   o  SUBMIT COMPDL.CTL /TAG:RENG /DEPEND:1
   o  SUBMIT COMPDT.CTL /TAG:RENG /DEPEND:1
   o  SUBMIT MAKDIL.CTL /TAG:RENG /DEPEND:1
   o  SUBMIT INTERFILS.CTL /TAG:RENG /DEPEND:1
 
After the batch jobs  finish  processing,  check  the  log  files  for
errors.
 
 
 
17.0  BUILDING DIL ON VAX/VMS
 
 
 
                                 NOTE
 
               Before you attempt to  build  DIL  on  a
               VAX/VMS  system,  make sure you have VMS
               Version 3.1 or later installed  on  your
               system.
 
 
 
The file BUILD.COM can be used to build the VAX DIL.   BUILD.COM  runs
five  command  files  which compile and build all the image and object
files required.
 
BUILD.COM expects to find the following logical names:  DILL:,  DIXL:,
and  DITL:.  DILL:  is the library of DIL specific sources while DIXL:
is the library of DIX specific sources, and DITL:  is the  library  of
DIT  specific sources.  You can either define the logicals to point to
your build directory, or you can modify BUILD.COM and the six  command
files  which  it uses so that they do not use these logical names.  If
you decide to modify the command files, you will have  to  modify  the
following files only:
 
DIL.DOC -- V2(137) 16-Nov-84                                   Page 49
BUILDING DIL ON VAX/VMS
 
 
      o  BUILD.COM
      o  COMDIX.COM
      o  COMDIT.COM
      o  COMDIL.COM
      o  DILOLB.COM
      o  DILEXE.COM
      o  INTERFILS.COM
 
 
Simply submit BUILD.COM for  batch  processing  and  wait  for  it  to
finish.   Verify  that the build completed correctly by looking at the
log file, BUILD.LOG
 
[End of DIL.DOC]