 












             CDA Converter Library Installation Guide

             Order Number: AA-PD7VA-TE



             November 1990

             This document contains instructions for installing the CDA
             Converter Library on the VMS and ULTRIX operating systems. It
             also explains how to read the online release notes before or
             after installing the product. This document applies to the
             CDA Converter Library Version 1.1.




             Revision/Update Information:  This manual supersedes the CDA
                                           Converter Library Installation
                                           Guide (Order Number: AA-NG87B-
                                           TE).

             Operating System and Version: VMS Version 5.3 or higher
                                           ULTRIX Version 3.1 or higher
                                           UWS Version 2.2 or higher
                                           Future maintenance releases
                                           of the CDA Converter Library
                                           may require higher versions.

             Software Version:             CDA Converter Library Version
                                           1.1
             digital equipment corporation
             maynard, massachusetts

 















             ___________________________________________________

             First Printing, November 1990

               1990.

             The following are trademarks of Digital Equipment Corporation:

             CDA              DECwindows       UNIBUS
             DDIF             DECwrite         VAX
             DDIS             DIGITAL          VAXcluster
             DEC              DTIF             VAX RMS
             DECalc           LN03             VAXstation
             DECalc-PLUS      PrintServer 40   VMS
             DECchart         Q-bus            XUI
             DECdecision      ReGIS            Xway
             DECnet           TEAMDATA
             DECUS            ULTRIX           DIGITAL

                                                                    ZK5479

 






             This document was prepared using VAX DOCUMENT, Version 1.2






































                                                                        -3

 















                                                                  Contents
          ________________________________________________________________

          Preface .........................................................  v


          ________________________________________________________________
          Chapter 1  Installing the CDA Converter Library for VMS


               1.1   Before You Install the CDA Converter Library
                     on VMS...............................................   1-1
                     1.1.1 Prerequisite Software.....................  1-1
                     1.1.2 Optional Software.......................... 1-1
                     1.1.3 Accessing the Online Release Notes......    1-2
                     1.1.4 Installation Procedure Requirements.....    1-2
                     1.1.5 User Account Quotas and Privileges......    1-2
                     1.1.6 VMS License Management Facility .........   1-3
                     1.1.7 Special Requirements ...................... 1-4
                     1.1.8 Using VMSINSTAL............................ 1-4

               1.2   Installing the CDA Converter Library on VMS ...   1-6

               1.3   Running the Installation Verification
                     Procedure Separately on VMS...................... 1-14

               1.4   Error Conditions on VMS........................... 1-15

               1.5   Sample Installation on VMS ....................... 1-16


                                                                       iii

 






          ________________________________________________________________
          Chapter 2  Installing the CDA Converter Library for
                     ULTRIX (VAX)

               2.1   Before You Install the CDA Converter Library
                     on ULTRIX (VAX).................................... 2-1
                     2.1.1 Installation Prerequisites ...............  2-1
                     2.1.2 Distribution Media......................... 2-2
                     2.1.3 Accessing the Online Release Notes and
                           Command Files .............................. 2-10

               2.2   Installing the CDA Converter Library on ULTRIX
                     (VAX)................................................    2-10

               2.3   Performing the Installation on ULTRIX (VAX) ...  2-11
                     2.3.1 9-Track Magnetic Tape and TK50 Tape
                           Cartridge Users............................ 2-12

               2.4   After the Installation on ULTRIX (VAX) ......... 2-12

               2.5   Sample Installation on ULTRIX (VAX)............. 2-13


          ________________________________________________________________
          Chapter 3  Installing the CDA Converter Library for
                     ULTRIX (RISC)

               3.1   Before You Install the CDA Converter Library
                     on ULTRIX (RISC)................................... 3-1
                     3.1.1 Installation Prerequisites ...............  3-1
                     3.1.2 Distribution Media......................... 3-2
                     3.1.3 Accessing the Online Release Notes and
                           Command Files .............................. 3-10

               3.2   Installing the CDA Converter Library on ULTRIX
                     (RISC)...............................................    3-11

               3.3   Performing the Installation on ULTRIX (RISC) ..  3-11

          iv

 






                     3.3.1 9-Track Magnetic Tape and TK50 Tape
                           Cartridge Users............................ 3-12

               3.4   After the Installation on ULTRIX (RISC)........  3-13

               3.5   Sample Installation on ULTRIX (RISC)............ 3-13


          ________________________________________________________________
          Index





























                                                                         v

 














                                                                   Preface
          ________________________________________________________________



             This document describes how to install the CDA Converter
             Library on the VMS, ULTRIX (VAX), and ULTRIX (RISC) operating
             systems. It is intended for system managers. Keep this docu-
             ment with your distribution kit. You will need it to install
             maintenance updates or to reinstall the CDA Converter Library
             for any other reason.

             Maintenance Updates

             This document applies to the CDA Converter Library Version
             1.1. A major version number is represented by the digits
             to the left of the decimal point, and a maintenance update
             version number is indicated by the digits to the right of the
             decimal point.

             Digital may periodically issue maintenance updates of the
             CDA Converter Library. Each update consists of an instal-
             lation kit. You should install this kit as described in
             this document or in any documentation that may accompany
             the maintenance update.

             Each time a maintenance update is released, the version num-
             ber changes. For example, if the current version is 1.0, the
             version number of the first maintenance update will be 1.1.
             In addition, each maintenance update includes new release

                                                                         v

 






             notes. The release notes describe the changes that have been
             made to the CDA Converter Library since the previous release.

             The updated release notes are provided on line. You should
             read the release notes when you first install the CDA
             Converter Library; they are also accessible at any time after
             the product is installed. For information on reading the re-
             lease notes when you are installing the CDA Converter Library
             on VMS systems, follow the installation procedure through
             step 4 in Section 1.2.

             To locate the release notes after the CDA Converter
             Library is installed on VMS, display or print the file
             SYS$HELP:CDACVTLIB011.RELEASE_NOTES. To locate the re-
             lease notes after the CDA Converter Library is installed
             on ULTRIX (VAX) display or print the file /usr/kits/CDA110
             /release.notes To locate the release notes after the CDA
             Converter Library is installed on ULTRIX (RISC) display or
             print the file /usr/kits/CDR110/release.notes

             Determining and Reporting Problems

             If an error occurs while you are using the CDA Converter
             Library and you believe that the error is caused by a problem
             with the CDA Converter Library, take one of the following
             actions:

              o If you purchased the CDA Converter Library within the past
                90 days and you think the problem is caused by a software
                error, you can submit a Software Performance Report (SPR).

              o If you have a Basic or DECsupport Software Agreement,
                you should call your Customer Support Center. With these
                services, you receive telephone support that provides
                high-level advisory and remedial assistance. For more
                information, contact your local Digital representative.

              o If you have a Self-Maintenance Software Agreement, you can
                submit a Software Performance Report (SPR).

          vi

 






             If you find an error in the CDA Converter Library documen-
             tation, you should fill out and submit a Reader's Comments
             form from the back of the document in which the error was
             found. Include the section and page number where the error
             was found.

             Preparing to Install the CDA Converter Library

             Your bill of materials (BOM) and indented bills report (BIL)
             specify the number and contents of your media. Be sure to
             check the contents of your kit against this information.
             If your kit is damaged or if you find that parts of it are
             missing, call your Digital representative.

             Distribution media must be mounted in numerical order. The
             installation procedure prompts you to mount the volumes. For
             more information on how to mount distribution media, see your
             processor-specific installation/operations guide, which also
             details several options to the installation procedure.

             The installation procedure is described step-by-step and is,
             for the most part, self-explanatory. The system prompts you
             to answer questions and to change volumes, and waits for you
             to tell it to continue.

             Conventions

             Defaults appear in brackets ([])  throughout the installation
             procedure. Text you type is shown in bold.

             For more information about installing the CDA Converter
             Library on VMS or ULTRIX systems, see your processor-specific
             installation/operations guide.






                                                                       vii

 

















                                                                      Chapter 1


                                   Installing the CDA Converter Library for VMS
               ________________________________________________________________


                  This chapter describes how to install the CDA Converter
                  Library on VMS systems.

               ____________________________________________________________

               1.1  Before You Install the CDA Converter Library on VMS

                  This section describes the prerequisites for installing the
                  CDA Converter Library on VMS systems.

               ____________________________________________________________

               1.1.1  Prerequisite Software

                  The CDA Converter Library Version 1.1 requires VMS Version
                  5.3 or higher and DECwindows with the application files
                  option.

               ____________________________________________________________

               1.1.2  Optional Software

                  The Graphics back end that is installed with the CDA
                  Converter Library Version 1.1 requires the DEC GKS Run-Time
                  Library (RTL) Version 4.0. The installation procedure in-
                  stalls the Graphics back end, but does not check whether the
                  DEC GKS Run-Time Library is installed on your system.





                              Installing the CDA Converter Library for VMS  1-1

 











                  If the DEC GKS RTL is not installed on your system at the
                  time of the CDA Converter Library installation, the IVP dis-
                  plays an informational message and does not attempt to test
                  the Graphics back end. Users who need to use the Graphics
                  back end can install the DEC GKS Run-Time Library later. To
                  determine which version of DEC GKS is currently installed on
                  your system, use the following command:

                    $ ANALYZE/IMAGE SYS$LIBRARY:GKSRTLIB

                  Look at the version number field that is displayed.

               ____________________________________________________________

               1.1.3  Accessing the Online Release Notes

                  The CDA Converter Library provides online release notes.
                  The prompt to display or print the release notes during the
                  installation appears in step 4 of the installation procedure
                  when you invoke VMSINSTAL with the OPTIONS N parameter.

                  To obtain the release notes after the installation, type or
                  print the file SYS$HELP:CDACVTLIB011.RELEASE_NOTES.

               ____________________________________________________________

               1.1.4  Installation Procedure Requirements

                  The installation takes approximately 12 to 20 minutes, de-
                  pending on the type of media and your system configuration.
                  Before installing the CDA Converter Library, you must have
                  the following privileges and resources:

                   o SETPRV privileges, or CMKRNL, WORLD, and SYSPRV privileges

                   o A minimum of 5000 blocks of free disk space during instal-
                     lation; 4200 blocks are used after installation

               ____________________________________________________________

               1.1.5  User Account Quotas and Privileges

                  To use the CDA Converter Library, each account must have
                  TMPMBX and NETMBX privileges and the following requirements:

                   o AST limit (ASTLM) 24 (minimum)

                   o Buffered I/O quota (BIOLM) 18 (minimum)

                   o Buffered I/O byte count quota (BYTLM) 18000 (minimum)

               1-2  Installing the CDA Converter Library for VMS

 











                   o Direct I/O quota (DIOLM) 18 (minimum)

                   o Enqueue quota (ENQLM) 30 (minimum)

                   o Open file limit (FILLM) 20 (minimum)

                   o Paging file quota (PGFLQUOTA) 10240 pages (minimum)

                   o Subprocess creation quota (PRCLM) 0 (minimum)

                   o Working set size (WSDEF) 256 pages (minimum) 256 pages
                     (optimum)

                  Use the VMS Authorize Utility (AUTHORIZE) to compare the
                  current values of these quotas with the requirements for the
                  CDA Converter Library. For example, the account used in the
                  following example is the SYSTEM account:

                    $ SET DEFAULT SYS$SYSTEM <RETURN>
                    $ RUN AUTHORIZE <RETURN>
                    UAF> SHOW SYSTEM <RETURN>

                  To change the values of these quotas, use the VMS Authorize
                  Utility's MODIFY command. For more information, see the VMS
                  Authorize Utility Manual.

               ____________________________________________________________

               1.1.6  VMS License Management Facility

                  You must register the CDA Converter Library license through
                  the VMS License Management Facility (LMF) in accordance
                  with the license agreement signed by your site. The li-
                  cense registration information you need is contained in
                  the Product Authorization Key (PAK) that is shipped with
                  the CDA Converter Library. The PAK is a paper certificate
                  that contains information about the license you have to run a
                  particular piece of software.

                  During the installation, the system asks whether you have
                  registered the CDA Converter Library license and loaded the
                  appropriate authorization key. You must register and load
                  your license for the CDA Converter Library before you start
                  the installation in order to use the software.

                              Installing the CDA Converter Library for VMS  1-3

 











                  To register a license under VMS, first log in to the system
                  manager's account, SYSTEM. You then have a choice of two ways
                  to perform the registration:

                   o Invoke the SYS$UPDATE:VMSLICENSE.COM procedure. When it
                     prompts you for information, respond with data from your
                     Product Authorization Pak (PAK).

                   o At the DCL prompt, issue the LICENSE REGISTER command
                     with the appropriate qualifiers that correspond to PAK
                     information.

                  If you plan to use the CDA Converter Library on more than one
                  node in a VAXcluster, you will need to perform a license load
                  on the other nodes after you complete this installation.

                  For complete information on using LMF, see the manual on the
                  License Management Utility in the VMS documentation set.

               ____________________________________________________________

               1.1.7  Special Requirements

                  For a list of VMS classes that are required to enable full
                  functionality of the CDA Converter Library, see the System
                  Software Addendum (SSA). The SSA accompanies the Software
                  Product Description (SPD).

                  The CDA Converter Library commences version checking to
                  ensure that the most recent version of the CDA Converter
                  Library is always in use and is not overwritten by an earlier
                  version.

               ____________________________________________________________

               1.1.8  Using VMSINSTAL

                  After you log in to a privileged account to install the CDA
                  Converter Library, invoke VMSINSTAL. VMSINSTAL is the command
                  procedure that installs this product. An example of invoking
                  VMSINSTAL is shown in steps 1 and 2 of Section 1.2.

                  The VMSINSTAL command procedure has the following syntax:

                    $ @SYS$UPDATE:VMSINSTAL CDACVTLIB011 ddcu: [OPTIONS N]

               1-4  Installing the CDA Converter Library for VMS

 











                  You can also type an asterisk (*)  in place of CDACVTLIB011.
                  If you are installing from magnetic tape, you can use the
                  asterisk to save installation time; the asterisk causes the
                  CDA Converter Library to be installed with a minimum of tape
                  passes.

                  ddcu:
                  Represents a device name where the distribution volumes will
                  be mounted for the CDA Converter Library installation media,
                  where dd is the device code, c is the controller code, and u
                  is the unit number. It is not necessary to use the console
                  drive to install the CDA Converter Library. If you do use the
                  console drive, you should replace any media you removed from
                  the drive. SYS$UPDATE: is the device name used in examples in
                  this document.

                  OPTIONS N
                  Is an optional parameter you should provide if you want to be
                  prompted to display or print the release notes. If you do not
                  include the OPTIONS N parameter, VMSINSTAL does not prompt
                  you to display or print the release notes. VMSINSTAL permits
                  the use of several other options. For more information on
                  the other options, see your processor-specific installation
                  /operations guide.

                  If you do not supply the first two parameters, VMSINSTAL
                  prompts you for the product and device names. If you wish to
                  be prompted for the product and device names and to display
                  or print the release notes, type the following:

                    $ @SYS$UPDATE:VMSINSTAL <RETURN>

                  When you invoke VMSINSTAL, it checks the following:

                   o Whether you logged in to a privileged account. Digital
                     recommends that you install software from the system
                     manager's account with your default device and directory
                     set to SYS$UPDATE.

                   o Whether you have adequate quotas for installation.
                     VMSINSTAL checks for the following quota values:

                      _ ASTLM = 24

                      _ BIOLM = 18

                      _ BYTLM = 18000

                              Installing the CDA Converter Library for VMS  1-5

 











                      _ DIOLM = 18

                      _ ENQLM = 30

                      _ FILLM = 20

                  VMSINSTAL then checks whether the following conditions ex-
                  ist. If so, discontinue the conditions before resuming the
                  installation procedure.

                   o Whether any users are logged in to the system

                  If VMSINSTAL detects either of these conditions, you will
                  be asked whether you want to continue the installation.
                  If you want to continue, type YES. If you want to stop the
                  installation, press RETURN.

                  Before you begin the installation, register the information
                  contained in the Product Authorization Key (PAK) that is
                  shipped with the CDA Converter Library by using either the
                  VMS License command procedure (VMSLICENSE) or the LICENSE
                  REGISTER and LICENSE LOAD commands, as described in the VMS
                  License Management Utility Manual.

               ____________________________________________________________

               1.2  Installing the CDA Converter Library on VMS

                  This section contains excerpts from the installation pro-
                  cedure and explains each step. Defaults appear in brackets
                  throughout the installation procedure.

                  To abort the installation procedure at any time, press
                  CTRL/Y. When you press CTRL/Y, the installation procedure
                  deletes all files it has created up to that point and then
                  returns you to DCL level. If you want to retry the installa-
                  tion procedure after pressing CTRL/Y, you must proceed from
                  step 2.

                  Step 1: Log in to a privileged account and set your default
                  device and directory to SYS$UPDATE.

               <RETURN>

                    Username: SYSTEM  <RETURN>
                    Password:         <RETURN>
                    $ SET DEFAULT SYS$UPDATE <RETURN>

               1-6  Installing the CDA Converter Library for VMS

 











                  Step 2: Invoke VMSINSTAL.

                    $ @VMSINSTAL CDACVTLIB011 SYS$UPDATE: OPTIONS N <RETURN>

                          VAX/VMS Software Product Installation Procedure V5.3

                    It is dd-mmm-yyyy at hh:mm.
                    Enter a question mark (?) at any time for help.

                    * Are you satisfied with the backup of your system disk [YES]? <RETURN>

                  If you are satisfied with the backup of your system disk,
                  press RETURN. Otherwise, type NO and press RETURN to discon-
                  tinue the installation.

                  Step 3: Insert the first installation kit volume.

                    Please mount the first volume of the set on SYS$UPDATE:.
                    * Are you ready? Y <RETURN>
                    %MOUNT-I-MOUNTED, CDACVT mounted on _FOO$SYS$UPDATE:
                    The following products will be processed:
                      CDA Converter Library V1.1

                       Beginning installation of CDACVTLIB V1.1 at hh:mm

                    %VMSINSTAL-I-RESTORE, Restoring product save set A...

                  To indicate that you want to continue the installation, mount
                  volume 1, type YES, and press RETURN.

                  Step 4: Select a release notes option.

                  This step applies only if you specified OPTIONS N in step 2.

                        Release notes included with this kit are always copied to SYS$HELP.

                    Additional Release Notes Options:

                        1. Display release notes
                        2. Print release notes
                        3. Both 1 and 2
                        4. None of the above

                    * Select option [2]: <RETURN>

                              Installing the CDA Converter Library for VMS  1-7

 











                  If you select option 1, VMSINSTAL displays the release notes
                  on line immediately. You can terminate the display at any
                  time by pressing CTRL/C.

                  If you select option 2, VMSINSTAL prompts you for a queue
                  name. Either type a queue name or press RETURN to send the
                  file to the default output print device.

                    * Queue name [SYS$PRINT]: <RETURN>

                  If you select option 3, VMSINSTAL displays the release notes
                  on line immediately. You can terminate the display at any
                  time by pressing CTRL/C. VMSINSTAL then prompts you for
                  a queue name. Either type a queue name or press RETURN
                  to send the file to the default output print device. The
                  CDA Converter Library release notes are then copied to
                  SYS$HELP:CDACVTLIB011.RELEASE_NOTES.

                  If you select option 4, VMSINSTAL neither displays nor prints
                  the release notes.

                                               NOTE

                      This version of the release notes file installed by
                      VMSINSTAL is labeled with the current product name and
                      version number. Take care not to delete release notes
                      for previous versions of the CDA Converter Library.

                  Next, VMSINSTAL displays the following message:

                    * Do you want to continue the installation [N]?: Y <RETURN>

                  If you want to continue the installation, type YES and press
                  RETURN. If you type NO or press RETURN, VMSINSTAL discon-
                  tinues the installation. In either case, VMSINSTAL moves the
                  release notes to SYS$HELP.

                    %VMSINSTAL-I-RELMOVED, The product release notes have been successfully
                        moved to SYS$HELP.






               1-8  Installing the CDA Converter Library for VMS

 











                  Step 5: Respond to license registration queries.

                  CDA Converter Library supports the VMS License Management
                  Facility (LMF). The installation procedure displays license
                  information about your product and then asks if you have reg-
                  istered and loaded your authorization key for CDA Converter
                  Library. The following is an example of such information:

                    Product:       CDA-CONVERTER-LIBRARY
                    Producer:      DEC
                    Version:       1.1
                    Release Date:  31-JUL-89

                    * Does this product have an authorization key registered and loaded?

                  If you have not registered and loaded your authorization key,
                  you must answer "NO" to this question. You have to register
                  and load your product authorization key to successfully
                  complete the installation. If you have not done so, you
                  should stop the installation, register and load your product
                  authorization key, and then restart the installation.

                  Step 6: Select installation options.

                    * Do you want to purge files replaced by this installation [YES]? <RETURN>

                  The directories SYS$LIBRARY, SYS$SYSTEM, and CDA$LIBRARY
                  may contain earlier versions of the CDA Converter Library
                  files. These files are replaced during the installation with
                  new files, but the old files are not automatically purged.
                  Purging is recommended. In response to the purging prompt,
                  press RETURN to purge the files or type NO to keep them.

                    * Do you want to run the IVP after the installation [YES]? <RETURN>

                  The Installation Verification Procedure (IVP) runs tests
                  to check whether the installation procedure was successful.
                  Press RETURN to run the IVP after the installation. If you do
                  not want to run the IVP, type NO in response to the prompt.

                  Step 7: Read informational messages.

                  The CDA Converter Library installation procedure produces a
                  number of informational messages that report on the progress
                  of the installation. These messages can be similar to the
                  following:

                              Installing the CDA Converter Library for VMS  1-9

 











                        To complete the installation on a standalone VAX 11/780
                        will take approximately:

                            15 minutes to install
                            4 minutes to run the IVP

                        All required questions have been asked.
                        You can terminate the installation procedure at this time.

                  Next, VMSINSTAL displays the following message:

                    * Do you want to continue the installation [YES]? Y<RETURN>

                  If you type NO and press RETURN, VMSINSTAL discontinues the
                  installation. If you want to continue the installation, type
                  YES and press RETURN, or simply press RETURN. If you type
                  YES, VMSINSTAL continues with informational messages which
                  can be similar to the following:

                    %VMSINSTAL-I-RESTORE, Restoring product save set B ...
                    %VMSINSTAL-I-SYSDIR, This product creates system disk directory
                    VMI$ROOT:[SYSTEST.CDACVTLIB].

                  If you have previously installed the CDA Converter Library on
                  your system, you will receive the following message:

                    %CREATE-I-EXISTS, VMI$ROOT:[SYSTEST.CDACVTLIB] already exists

                  The success of the installation is indicated by the following
                  message:

                    %VMSINSTAL-I-MOVEFILES, files will now be moved to their target directories...

                  If the installation procedure is successful, the new or
                  modified files are moved to their target directories.

                  The kit checks each additional converter's image and replaces
                  it as needed.

                                               NOTE

                      The installation requires that CDA$LIBRARY: be de-
                      fined in the DECW$LOGICAL_NAMES table (defined by
                      DECwindows). The default style guides will be placed
                      in CDA$LIBRARY:.

                  The procedure creates the directory SYS$COMMON:[SYSTEST.CDACVTLIB],
                  where the IVP procedures and files are installed.

               1-10  Installing the CDA Converter Library for VMS

 











                  The following files are created or modified by the installa-
                  tion procedure:

               ________________________________________________________________
               Directory________File_Name_______________Description____________

               SYS$COMMON:      CDACVTLIB$IVP.CDA$OPTIONIVP procedures and
               [SYSTEST.CDACVTLIB]                      files

                                TCV$IVP_INPUT.CALC$GRD

                                TCV$IVP_INPUT.DIF

                                TCV$IVP_INPUT.TAB

                                TCV$IVP_INPUT.WK1

                                TCV$IVP_INPUT.DTIF

                                ACCEPT.DX               Example files

                                AUTUMN.TIFF

                                EXAMPLE_DDIF.DDIF

                                STD_TEST.CGM

                                CHART_1.DDIF

                                CHAMPAGNE.MACPAINT

               SYS$TEST:        CDACVTLIB$IVP.COM

               ________________________________________________________________

               SYS$HELP:        CDACVTLIB011.RELEASE_   Release notes
                                NOTES

                                HELPLIB.HLB             Modified

               ________________________________________________________________




                             Installing the CDA Converter Library for VMS  1-11

 










               ________________________________________________________________
               Directory________File_Name_______________Description____________

               SYS$LIBRARY:     DDIF$READ_CGM_          CGM message file
                                MESSAGES.EXE

                                SGML$PARSE.EXE          SGML parse file

                                DDIF$READ_AFS.EXE       AFS front end

                                DDIF$WRITE_AFS.EXE      AFS back end

                                DDIF$READ_DCA.EXE       DCA front end

                                DDIF$WRITE_DCA.EXE      DCA back end

                                DDIF$READ_DX.EXE        DX front end

                                DDIF$WRITE_DX.EXE       DX back end

                                DDIF$READ_CGM.EXE       CGM front end

                                DDIF$READ_SGML.EXE      SGML front end

                                DDIF$WRITE_SGML.EXE     SGML back end

                                DDIF$READ_TIFF.EXE      TIFF front end

                                DDIF$WRITE_TIFF.EXE     TIFF back end

                                DDIF$WRITE_GRAPHICS.EXE Graphics back end

                                DDIF$READ_MACPAINT.EXE  Macpaint front end

                                DDIF$WRITE_MACPAINT.EXE Macpaint back end

                                DTIF$READ_ASCII_        ASCII tabular front end
                                TABULAR.EXE

                                DTIF$WRITE_ASCII_       ASCII tabular back end
                                TABULAR.EXE





               1-12  Installing the CDA Converter Library for VMS

 










               ________________________________________________________________
               Directory________File_Name_______________Description____________

                                DTIF$READ_CALCGRD.EXE   CALCGRD front end

                                DTIF$READ_DIF.EXE       DIF front end

                                DTIF$READ_WK1.EXE       WK1 front end

                                DTIF$WRITE_WK1.EXE      WK1 back end


               ________________________________________________________________

               CDA$LIBRARY:     DX_COUR.DOC_STYLE       DX style guide

                                DX_HELV.DOC_STYLE       DX style guide

                                DX_TIMES.DOC_STYLE      DX style guide

               ________________________________________________________________

               SYS$EXAMPLES:    SDC$SAMPLE.DOC_STYLE    Sample SGML style guide

               _________________SDC$SAMPLE.SGML_________Sample_SGML_document___

                  If you typed YES in response to the prompt that requests a
                  file purge at step 6, previous versions of the CDA Converter
                  Library files are now purged.

                  Step 8: Observe the Installation Verification Procedure
                  (IVP).

                  If you chose to run the IVP in step 6, VMSINSTAL now calls
                  the IVP to verify that the CDA Converter Library was in-
                  stalled successfully. The IVP gives you messages which can be
                  similar to the following:

                    Beginning the CDA Converter Library V1.1 Installation Verification Procedure

                    Starting verification of the AFS front and back ends

                    Starting verification of the CGM front end

                    Starting verification of the DCA front and back ends

                    Starting verification of the DX front and back ends

                             Installing the CDA Converter Library for VMS  1-13

 











                    Starting verification of the Graphics back end

                    Starting verification of the MACPAINT front and back ends

                    Starting verification of the SGML front and back ends

                    Starting verification of the TIFF front and back ends

                    Starting verification of the ASCII Tabular front and back ends

                    Starting verification of the CALCGRD front end

                    Starting verification of the DIF front end

                    Starting verification of the WK1 front and back ends

                  When the IVP has completed, you receive the following mes-
                  sage:

                    CDA Converter Library V1.1 IVP completed successfully.
                     Installation of CDACVTLIB V1.1 completed at 15:11

                     VMSINSTAL procedure done at 15:12

                  Step 9: Log out or install more products.

                    $ LOGOUT <RETURN>
                    SYSTEM     logged out at dd-mmm-yyyy hh:mm:ss.ss

                  When the product installation procedure and the IVP are
                  complete, you can choose to install more products or to
                  log out (as shown above). If you removed any media from the
                  console drive before beginning the installation, you should
                  replace it now.

                  VMSINSTAL deletes or changes entries in the process symbol
                  tables during the installation. Therefore, if you are going
                  to continue using the system manager's account and you want
                  to restore these symbols, you should log out and log in
                  again.

               ____________________________________________________________

               1.3  Running the Installation Verification Procedure Separately
                    on VMS

                  The Installation Verification Procedure (IVP) is usually run
                  at installation. If you want to run the IVP separately to
                  ensure the integrity of installed files if system problems
                  occur, execute the following command procedure:

               1-14  Installing the CDA Converter Library for VMS

 











                    $ @SYS$TEST:CDACVTLIB$IVP.COM<RETURN>

                  If the IVP fails for any reason, messages such as the follow-
                  ing are displayed:

                    "Verification failed - CGM front end"

                  Normally, a failed IVP does not indicate a failed installa-
                  tion, but any converters that did fail should be reported to
                  a Digital field service representative.

               ____________________________________________________________

               1.4  Error Conditions on VMS

                  If the installation procedure fails for any reason, a message
                  like the following is displayed:

                    %VMSINSTAL-E-INSFAIL, The installation of the CDA Converter Library
                    V1.1 has failed.

                  An error during the installation can occur if one or more of
                  the following conditions exist:

                   o Operating system version is incorrect.

                   o Prerequisite software version is incorrect.

                   o Quotas necessary for successful installation are insuffi-
                     cient (see Section 1.1.4).

                   o Process quotas required by VMSINSTAL are incorrect (see
                     Section 1.1.8).

                   o The product was registered incorrectly or not registered.

                  For descriptions of the error messages generated by these
                  conditions, see the VMS System Messages and Recovery
                  Procedures Reference Volume, Part I and Part II, your
                  processor-specific installation/operations guide, or the
                  VMS License Management Utility Manual.

                  If you are notified that any of these conditions exist, you
                  should take the appropriate action as described in the mes-
                  sage. You may need to change a system parameter or increase
                  an authorized quota value.

                  If the installation fails, you must restart the installation
                  procedure from step 2. If the installation fails due to an
                  IVP failure, contact a Digital field service representative.

                             Installing the CDA Converter Library for VMS  1-15

 










               ____________________________________________________________

               1.5  Sample Installation on VMS

                  This section contains a sample installation of the CDA
                  Converter Library. Note that this is only a sample. Sometimes
                  the installation procedure is modified in maintenance up-
                  dates of this product. Because this installation guide is
                  not usually revised for maintenance updates, be sure to read
                  the Read Before Installing or Using the CDA Converter Library
                  letter before you install this product. This letter notes any
                  significant changes in the installation that vary from this
                  sample.

                  Sample CDA Converter Library Installation Procedure

               $ @VMSINSTAL CDACVTLIB011 MUA0: OPTIONS N<RETURN>

                VAX/VMS Software Product Installation Procedure V5.3

               It is 6-SEP-1990 at 14:54.

               Enter a question mark (?) at any time for help.
               * Are you satisfied with the backup of your system disk [YES]? Y<RETURN>

               Please mount the first volume of the set on  MUA0:.
               * Are you ready? Y<RETURN>
               %MOUNT-I-MOUNTED, CDACVT mounted on _FOO$MUA0:
               The following products will be processed:
                 CDACVTLIB V1.1

                Beginning installation of CDACVTLIB V1.1 at 14:55

               %VMSINSTAL-I-RESTORE, Restoring product save set A ...

                   Release notes included with this kit are always copied to SYS$HELP.

                   Additional Release Notes Options:

                1.  Display release notes
                2.  Print release notes
                3.  Both 1 and 2
                4.  None of the above

               * Select option [2]: 4
               * Do you want to continue the installation [NO]? Y<RETURN>
               %VMSINSTAL-I-RELMOVED , The product's release notes have been successfully moved to SYS$HELP.

               1-16  Installing the CDA Converter Library for VMS

 











                       Product:      CDA-CONVERTER-LIBRARY
                       Producer:     DEC
                       Version:      1.1
                       Release Date: MM-DD-YYYY

               * Does this product have an authorization key registered and loaded? Y<RETURN>
               * Do you want to purge files replaced by this installation [YES]? Y <RETURN>
               * Do you want to run the IVP after the installation [YES]?Y <RETURN>

                   To complete the installation on a standalone VAX 11/780
                   will take approximately:

                       15 minutes to install
                       4 minutes to run the IVP

                   All required questions have been asked.
                   You can terminate the installation procedure at this time.

               * Do you want to continue the installation [YES]? Y<RETURN>
               %VMSINSTAL-I-RESTORE, Restoring product save set B ...
               %VMSINSTAL-I-SYSDIR, This product creates system disk directory  VMI$ROOT:[SYSTEST.CDACVTLIB].
               %CREATE-I-EXISTS, VMI$ROOT:[SYSTEST.CDACVTLIB] already exists
               %VMSINSTAL-I-MOVEFILES, Files will now be moved to their target directories...

               Beginning the CDA Converter Library V1.1 Installation Verification Procedure

               Starting verification of the AFS front and back ends

               Starting verification of the CGM front end

               Starting verification of the DCA front and back ends

               Starting verification of the DX front and back ends

               Starting verification of the Graphics back end

               Starting verification of the MACPAINT front and back ends

               Starting verification of the SGML front and back ends

               Starting verification of the TIFF front and back ends

               Starting verification of the ASCII Tabular front and back ends

               Starting verification of the CALCGRD front end

               Starting verification of the DIF front end

               Starting verification of the WK1 front and back ends

               CDA Converter Library V1.1 IVP completed successfully.
                Installation of CDACVTLIB V1.1 completed at 15:11

                VMSINSTAL procedure done at 15:12

                             Installing the CDA Converter Library for VMS  1-17

 

















                                                                      Chapter 2


                          Installing the CDA Converter Library for ULTRIX (VAX)
               ________________________________________________________________


                  This chapter describes how to install the CDA Converter
                  Library on ULTRIX [TM] (VAX) systems.

               ____________________________________________________________

               2.1  Before You Install the CDA Converter Library on ULTRIX
                    (VAX)

                  This section describes the prerequisites for installing the
                  CDA Converter Library on ULTRIX (VAX) systems.

               ____________________________________________________________

               2.1.1  Installation Prerequisites

                  Before you begin, you should perform a system disk(s) backup
                  and make sure that your system meets the following prerequi-
                  sites:

                   o Access to the root or super_user account.

                   o A valid ULTRIX operating system image with ULTRIX Version
                     3.1 or higher or ULTRIX Worksystem Software Version 2.2 or
                     higher.

                   o The required hardware, as detailed in the CDA Converter
                     Library Software Product Description (SPD).

                   o Adequate system disk space. The CDA Converter Library
                     installation requires approximately 10.5 megabytes in
                     the /usr/kits structure, depending on the converters you
                     choose to install.

               ___________________

            [TM] ULTRIX is a trademark of Digital Equipment Corporation.

                     Installing the CDA Converter Library for ULTRIX (VAX)  2-1

 











                  The installation requires approximately 5 to 30 minutes,
                  depending on the type of media and your system configuration.

               ____________________________________________________________

               2.1.2  Distribution Media

                  Your distribution kit contains one of the following sets of
                  media:

                   o One 9-track magnetic tape

                   o One TK50 cartridge tape

                  This media contains the CDA Converter Library files.

                  The following table lists these files and their location on
                  your system after you install them:

               ________________________________________________________________
               Directory
               and_Subset____File_Name_______Description_______________________

               /usr/bin

               CDABASE110    cda_read_cda    Symbolic link to ../kits/CDA110
                                             /cda_read_cda

                             cda_write_      Symbolic link to ../kits/CDA110
                             analysis        /cda_write_analysis

                             cdoc            Symbolic link to ../kits/CDA110
                                             /cdoc

                             ddif_read_text  Symbolic link to ../kits/CDA110
                                             /ddif_read_text

                             ddif_write_ps   Symbolic link to ../kits/CDA110
                                             /ddif_write_ps

                             ddif_write_     Symbolic link to ../kits/CDA110
                             text            /ddif_write_text



               2-2  Installing the CDA Converter Library for ULTRIX (VAX)

 










               ________________________________________________________________
               Directory
               and_Subset____File_Name_______Description_______________________

                             vdoc            Symbolic link to ../kits/CDA110
                                             /vdoc

               Version 3.1   defstyle.ddif   Symbolic link to ../kits/CDA110
               only                          /defstyle.ddif



               CDACVTDOC110  ddif_read_dca   Symbolic link to ../kits/CDA110
                                             /ddif_read_dca

                             ddif_read_sgml  Symbolic link to ../kits/CDA110
                                             /ddif_read_sgml

                             ddif_write_afs  Symbolic link to ../kits/CDA110
                                             /ddif_write_afs

                             ddif_write_dca  Symbolic link to ../kits/CDA110
                                             /ddif_write_dca

                             ddif_write_     Symbolic link to ../kits/CDA110
                             sgml            /ddif_write_sgml



               CDACVTDX110   ddif_read_dx    Symbolic link to /kits/CDA110
                                             /ddif_read_dx

                             ddif_write_dx   Symbolic link to ../kits/CDA110
                                             /ddif_write_dx



               CDACVTGRA110  ddif_read_cgm   Symbolic link to /kits/CDA110
                                             /ddif_read_cgm

                             ddif_read_      Symbolic link to ../kits/CDA110
                             macpaint        /ddif_read_macpaint




                     Installing the CDA Converter Library for ULTRIX (VAX)  2-3

 










               ________________________________________________________________
               Directory
               and_Subset____File_Name_______Description_______________________

                             ddif_read_tiff  Symbolic link to ../kits/CDA110
                                             /ddif_read_tiff

                             ddif_write_     Symbolic link to ../kits/CDA110
                             graphics        /ddif_write_graphics

                             ddif_write_     Symbolic link to ../kits/CDA110
                             macpaint        /ddif_write_macpaint

                             ddif_write_     Symbolic link to ../kits/CDA110
                             tiff            /ddif_write_tiff



               CDACVTTBL110  dtif_read_      Symbolic link to ../kits/CDA110
                             ascii_tabular   /dtif_read_ascii_tabular

                             dtif_read_      Symbolic link to ../kits/CDA110
                             calcgrd         /dtif_read_calcgrd

                             dtif_read_dif   Symbolic link to ../kits/CDA110
                                             /dtif_read_dif

                             dtif_read_wk1   Symbolic link to ../kits/CDA110
                                             /dtif_read_wk1

                             dtif_write_     Symbolic link to ../kits/CDA110
                             ascii_tabular   /dtif_write_ascii_tabular

                             dtif_write_wk1  Symbolic link to ../kits/CDA110
                                             /dtif_write_wk1


               ________________________________________________________________

               /usr/lib






               2-4  Installing the CDA Converter Library for ULTRIX (VAX)

 










               ________________________________________________________________
               Directory
               and_Subset____File_Name_______Description_______________________

               Version 4.0   libddif.a       Symbolic link to ../kits/CDA110
               only                          /libddif.a

               Version 4.0   libddif_fe.a    Symbolic link to ../kits/CDA110
               only                          /libddif_fe.a


               ________________________________________________________________

               /usr/lib/cda
               /

               CDACVTDX110

                             dx_cour.doc_    Symbolic link to .../kits/CDA110
                             style           /dx_cour.doc_style

                             dx_guide.doc_   Symbolic link to .../kits/CDA110
                             style           /dx_guide.doc_style

                             dx_helv.doc_    Symbolic link to .../kits/CDA110
                             style           /dx_helv.doc_style

                             dx_times.doc_   Symbolic link to .../kits/CDA110
                             style           /dx_times.doc_style

               ________________________________________________________________

               /usr/doc/



               CDABASE110    convert_        Symbolic link to ../kits/CDA110
                             messages.mem    /convert_messages.mem


               ________________________________________________________________





                     Installing the CDA Converter Library for ULTRIX (VAX)  2-5

 










               ________________________________________________________________
               Directory
               and_Subset____File_Name_______Description_______________________

               /usr/kits
               /CDA110/



               CDABASE110    cda_read_cda    DTIF to DDIF domain converter

                             cda_write_      Analysis back end
                             analysis

                             cdoc            Converters invocation command

                             convert_        Table and Document Conversion
                             messages.mem    Messages

                             ddif_read_text  Text front end

                             ddif_write_ps   PostScript back end

                             ddif_write_     Text back end
                             text

                             release.notes   release notes

                             saved           Directory for saving CDABASE110
                                             files

                             vdoc            CDA Viewer character cell command

                             libddif.a       CDA toolkit library

                             libddif_fe.a    CDA front-end converter library

                             defstyle.ddif   Default style guide for text back
                                             end







               2-6  Installing the CDA Converter Library for ULTRIX (VAX)

 










               ________________________________________________________________
               Directory
               and_Subset____File_Name_______Description_______________________

               CDACVTDOC110  ddif_read_afs   AFS front end

                             ddif_read_dca   DCA front end

                             ddif_read_sgml  SGML front end

                             ddif_write_afs  AFS front end

                             ddif_write_dca  DCA front end

                             ddif_write_     SGMS front end
                             sgml



               CDACVTDX110   ddif_read_dx    DX front end

                             ddif_write_dx   DX back end

                             dx_guide.doc_   DX style guide
                             style



               CDACVTGRA110  ddif_read_cgm   CGM front end

                             ddif_read_      Macpaint front end
                             macpaint

                             ddif_read_tiff  TIFF front end

                             ddif_write_     Graphic back end
                             graphics

                             ddif_write_     Macpaint back end
                             macpaint






                     Installing the CDA Converter Library for ULTRIX (VAX)  2-7

 










               ________________________________________________________________
               Directory
               and_Subset____File_Name_______Description_______________________

                             ddif_write_     TIFF back end
                             tiff

                             ghc_font1       Font file used by ddif_write_
                                             graphics



               CDACVTTBL110  dtif_read_      ASCII tabular front end
                             ascii_tabular

                             dtif_read_      CALCGRD front end
                             calcgrd

                             dtif_read_dif   DIF front end

                             dtif_read_wk1   WK1 front end

                             dtif_write_     ASCII tabular back end
                             ascii_tabular

                             dtif_write_wk1  WK1 back end


               ________________________________________________________________

               /usr/kits
               /CDA110/ivp/



               CDABASE110    CDABASE110.IVP  Base system IVP

                             base.ddif       example file

                             base.options    options file






               2-8  Installing the CDA Converter Library for ULTRIX (VAX)

 










               ________________________________________________________________
               Directory
               and_Subset____File_Name_______Description_______________________

               CDACVTDOC110  CDACVTDOC110.IVPDocument subset IVP

                             doc.ddif        DDIF example file

                             doc.options     Document options file

                             latin.dca       DCA example file



               CDACVTDX110   CDACVTDX110.IVP DX subset IVP

                             accept.dx       DX example file



               CDACVTGRA110  CDACVTGRA110.IVPGraphics subset IVP

                             autumn.tiff     TIFF example file

                             champagne.macpaiMacpaint example file

                             gra.ddif        Graphics DDIF file

                             gra.options     Graphics options file

                             std_test.cgm    CGM example file



               CDACVTTBL110  CDACVTTBL110.IVPTable subset IVP

                             input.calc_grd  CALCGRD example file

                             input.dif       DIF example file

                             input.dtif      DTIF example file





                     Installing the CDA Converter Library for ULTRIX (VAX)  2-9

 










               ________________________________________________________________
               Directory
               and_Subset____File_Name_______Description_______________________

                             input.tab       ASCII tabular example file

                             input.wk1       WK1 example file

               ______________tbl.options_____Table_options_file________________


               ____________________________________________________________

               2.1.3  Accessing the Online Release Notes and Command Files

                  The CDA Converter Library provides online release notes in
                  the directory /usr/kits/CDA110/release.notes

               ____________________________________________________________

               2.2  Installing the CDA Converter Library on ULTRIX (VAX)

                  This section tells you how to install the CDA Converter
                  Library files on an ULTRIX system. It also tells you how
                  to restore normal operation, if necessary.

                  During installation, the system prompts you for a response
                  to several questions. Some prompts have accompanying default
                  responses that appear in brackets ([]).  To choose a default
                  response, press the RETURN key.

                  You can request help at any step by typing help in response
                  to a prompt. If the prompt requests a YES or NO answer, you
                  can also type anything that does not begin with a y or n to
                  get help.

                  When you invoke the installation procedure at step 4, the
                  process is the same if you are using either 9-track magnetic
                  tape or TK50 tape cartridge media, and you should proceed to
                  Section 2.3.1.

                  At any point during the procedure, you can return to the
                  beginning of step 4 by pressing CTRL/C.



               2-10  Installing the CDA Converter Library for ULTRIX (VAX)

 










               ____________________________________________________________

               2.3  Performing the Installation on ULTRIX (VAX)

                  When you have met the prerequisites listed in Section 2.1.1,
                  you are ready to install the CDA Converter Library product.

                  Perform the installation at your system console, in the
                  following order:

                  Step 1: Log in to the root account with the root user name
                  and its password.

                    login: root
                    password:
                    #

                  If you are currently logged into another account, you can
                  switch to the root account by issuing the su command:

                    %   su -
                    password:
                    #

                  Step 2: Ensure that no one attempts to use the CDA Converter
                  Library during installation.

                  If necessary, place your system into single-user mode by
                  issuing the following shutdown command:

                    # /etc/shutdown +5 "Installing CDA Converter Library"

                  This command notifies other users that the system will shut
                  down in 5 minutes (as specified by the +5). Then, in five
                  minutes, it logs them out and enters single-user mode. You
                  should note that, in single user mode, the only valid input
                  device is the console.

                  Step 3: Invoke the installation procedure as appropriate for
                  your particular media.

                  If you use 9-track magnetic tape or TK50 tape cartridges,
                  proceed to Section 2.3.1.



                    Installing the CDA Converter Library for ULTRIX (VAX)  2-11

 










               ____________________________________________________________

               2.3.1  9-Track Magnetic Tape and TK50 Tape Cartridge Users

                  Step 1: Invoke the ULTRIX installation procedure with the
                  following command, substituting your device file unit number
                  for the question mark.

                    # setld -l /dev/rmt0h<RETURN>

                  When you invoke the installation procedure, the following
                  message and prompt appears, identifying your specific media:

                    Please make sure your installation media is mounted and on-line.
                    Are you ready (y/n)?: y<RETURN>

                  Step 2: Respond to the ready prompt.

                  If you type NO, the system repeats the prompt. If you type
                  YES, the following messages appear, identifying your specific
                  media:

                    The subsets listed below are optional:
                    *** Enter Subset Selections ***
                     1 CDA Base System                      2) CDA DX Converters)
                     3 CDA Document Converters              4) CDA Graphics Converters)
                     5 CDA Table Converters)

                     6 All of the Above)
                     7 None of the Above)

                    Enter your choice(s): 6<RETURN>

                    You are installing the following subsets:
                       CDA Base System                         CDA DX Converters
                       CDA Document Converters                 CDA Graphics Converters
                       CDA Table Converters

                    Is this correct? (y/n): y<RETURN>

                  The system proceeds to display a list of verification mes-
                  sages for the base system and for each subset you installed.

               ____________________________________________________________

               2.4  After the Installation on ULTRIX (VAX)

                  The CDA Converter Library is now installed and can be invoked
                  by all users with the cdoc command.

               2-12  Installing the CDA Converter Library for ULTRIX (VAX)

 










               ____________________________________________________________

               2.5  Sample Installation on ULTRIX (VAX)

                  This section contains a sample installation of the CDA
                  Converter Library. Note that this is only a sample. The in-
                  stallation procedure is sometimes modified in maintenance
                  updates of this product. Because this installation guide is
                  not usually revised for maintenance updates, be sure to read
                  the Read Before Installing or Using the CDA Converter Library
                  letter before you install this product. This letter notes any
                  significant changes in the installation that vary from this
                  sample.

                  Sample CDA Converter Library Installation Procedure

               # setld -l /dev/rmt0h<RETURN>

               Please make sure your installation tape is mounted and on-line.

               Are you ready? (y/n):Y<RETURN>
               Positioning tape...done.

               The subsets listed below are optional:
               *** Enter Subset Selections ***
                1 CDA Base System                      2) CDA DX Converters)
                3 CDA Document Converters              4) CDA Graphics Converters)
                5 CDA Table Converters)

                6 All of the Above)
                7 None of the Above)

               Enter your choice(s):6<RETURN>

               You are installing the following subsets:
                  CDA Base System                         CDA DX Converters
                  CDA Document Converters                 CDA Graphics Converters
                  CDA Table Converters

               Is this correct? (y/n):y<RETURN>

               Copying CDA Base System (CDABASE110) from tape
               Verifying CDA Base System (CDABASE110)

               Copying CDA DX Converters (CDACVTDX110) from tape
               Verifying CDA DX Converters (CDACVTDX110)

               Copying CDA Document Converters (CDACVTDOC110) from tape
               Verifying CDA Document Converters (CDACVTDOC110)

                    Installing the CDA Converter Library for ULTRIX (VAX)  2-13

 











               Copying CDA Graphics Converters (CDACVTGRA110) from tape
               Verifying CDA Graphics Converters (CDACVTGRA110)

               Copying CDA Table Converters (CDACVTTBL110) from tape
               Verifying CDA Table Converters (CDACVTTBL110)

               # setld -v CDACVTDOC110 CDACVTTBL110 CDACVTGRA110 CDACVTDX110 CDABASE110
               Checking setld data files.

               Verifying the installation of CDACVTDOC110
                   Checking afs back-end and front-end converters
                   Checking dca front-end and back-end converters
                   Checking sgml back-end and front-end converters
               The CDACVTDOC110 IVP has completed successfully

               Verifying the installation of CDACVTTBL110
                   Checking ascii_tabular front-end and back-end converters
                   Checking calcgrd front-end converter
                   Checking dif front-end converter
                   Checking wk1 front-end and back-end converters
               The CDACVTTBL110 IVP has completed successfully

               Verifying the installation of CDACVTGRA110
                   Checking cgm front-end converter
                   Checking macpaint front-end and back-end converters
                   Checking tiff front-end and back-end converters
                   Checking graphics back-end converter
               The CDACVTGRA110 IVP has completed successfully

               Verifying the installation of CDACVTDX110
                   Checking dx front-end and back-end converters
               The CDACVTDX110 IVP has completed successfully

               Verifying the installation of CDABASE110
                   Checking text back-end and front-end converters
                   Checking analysis back-end converter
                   Checking ps back-end converter
               The CDABASE110 IVP has completed successfully

               #





               2-14  Installing the CDA Converter Library for ULTRIX (VAX)

 

















                                                                      Chapter 3


                         Installing the CDA Converter Library for ULTRIX (RISC)
               ________________________________________________________________


                  This chapter describes how to install the CDA Converter
                  Library on ULTRIX (RISC) systems.

               ____________________________________________________________

               3.1  Before You Install the CDA Converter Library on ULTRIX
                    (RISC)

                  This section describes the prerequisites for installing the
                  CDA Converter Library on ULTRIX (RISC) systems.

               ____________________________________________________________

               3.1.1  Installation Prerequisites

                  Before you begin, you should perform a system disk(s) backup
                  and make sure that your system meets the following prerequi-
                  sites:

                   o Access to the root or super_user account.

                   o A valid ULTRIX operating system image with ULTRIX Version
                     3.1 or higher or ULTRIX Worksystem Software Version 2.2 or
                     higher.

                   o The required hardware, as detailed in the CDA Converter
                     Library Software Product Description (SPD).

                   o Adequate system disk space. The CDA Converter Library
                     installation requires up to a maximim of approximately
                     15 megabytes in the /usr structure, depending on the
                     converters you choose to install.

                  The installation requires approximately 5 to 30 minutes,
                  depending on the type of media and your system configuration.

                    Installing the CDA Converter Library for ULTRIX (RISC)  3-1

 










               ____________________________________________________________

               3.1.2  Distribution Media

                  Your distribution kit contains one of the following sets of
                  media:

                   o One 9-track magnetic tape

                   o One TK50 cartridge tape

                  This media contains the CDA Converter Library files.

                  The following table lists these files and their location on
                  your system after you install them:

               ________________________________________________________________
               Directory
               and_Subset____File_Name_____Description_________________________

               /usr/bin

               CDRBASE110    cda_read_cda  Symbolic link to ../kits/CDR110/cda_
                                           read_cda

                             cda_write_    Symbolic link to ../kits/CDR110/cda_
                             analysis      write_analysis

                             cdoc          Symbolic link to ../kits/CDR110/cdoc

                             ddif_read_    Symbolic link to ../kits/CDR110
                             text          /ddif_read_text

                             ddif_write_   Symbolic link to ../kits/CDR110
                             ps            /ddif_write_ps

                             ddif_write_   Symbolic link to ../kits/CDR110
                             text          /ddif_write_text

                             vdoc          Symbolic link to ../kits/CDR110/vdoc

               Version 3.1   defstyle.ddif Symbolic link to ../kits/CDR110
               only                        /defstyle.ddif



               3-2  Installing the CDA Converter Library for ULTRIX (RISC)

 










               ________________________________________________________________
               Directory
               and_Subset____File_Name_____Description_________________________



               CDRCVTDOC110  ddif_read_    Symbolic link to ../kits/CDR110
                             dca           /ddif_read_dca

                             ddif_read_    Symbolic link to ../kits/CDR110
                             sgml          /ddif_read_sgml

                             ddif_write_   Symbolic link to ../kits/CDR110
                             afs           /ddif_write_afs

                             ddif_write_   Symbolic link to ../kits/CDR110
                             dca           /ddif_write_dca

                             ddif_write_   Symbolic link to ../kits/CDR110
                             sgml          /ddif_write_sgml



               CDRCVTDX110   ddif_read_dx  Symbolic link to /kits/CDR110/ddif_
                                           read_dx

                             ddif_write_   Symbolic link to ../kits/CDR110
                             dx            /ddif_write_dx



               CDRCVTGRA110  ddif_read_    Symbolic link to /kits/CDR110/ddif_
                             cgm           read_cgm

                             ddif_read_    Symbolic link to ../kits/CDR110
                             macpaint      /ddif_read_macpaint

                             ddif_read_    Symbolic link to ../kits/CDR110
                             tiffd_tiff    /ddif_read_tiff

                             ddif_write_   Symbolic link to ../kits/CDR110
                             graphics      /ddif_write_graphics




                    Installing the CDA Converter Library for ULTRIX (RISC)  3-3

 










               ________________________________________________________________
               Directory
               and_Subset____File_Name_____Description_________________________

                             ddif_write_   Symbolic link to ../kits/CDR110
                             macpaint      /ddif_write_macpaint

                             ddif_write_   Symbolic link to ../kits/CDR110
                             tiff          /ddif_write_tiff



               CDRCVTTBL110  dtif_read_    Symbolic link to ../kits/CDR110
                             ascii_        /dtif_read_ascii_tabular
                             tabular

                             dtif_read_    Symbolic link to ../kits/CDR110
                             calcgrd       /dtif_read_calcgrd

                             dtif_read_    Symbolic link to ../kits/CDR110
                             dif           /dtif_read_dif

                             dtif_read_    Symbolic link to ../kits/CDR110
                             wk1           /dtif_read_wk1

                             dtif_write_   Symbolic link to ../kits/CDR110
                             ascii_        /dtif_write_ascii_tabular
                             tabular

                             dtif_write_   Symbolic link to ../kits/CDR110
                             wk1           /dtif_write_wk1


               ________________________________________________________________

               /usr/lib



               Version 4.0   libddif.a     Symbolic link to ../kits/CDR110
               only                        /libddif.a





               3-4  Installing the CDA Converter Library for ULTRIX (RISC)

 










               ________________________________________________________________
               Directory
               and_Subset____File_Name_____Description_________________________

               Version 4.0   libddif_fe.a  Symbolic link to ../kits/CDR110
               only                        /libddif_fe.a


               ________________________________________________________________

               /usr/lib/cda
               /



               CDRCVTDX110

                             dx_cour.doc_  Symbolic link to ../kits/CDR110/dx_
                             style         cour.doc_style

                             dx_           Symbolic link to ../kits/CDR110/dx_
                             guide.doc_    guide.doc_style
                             style

                             dx_helv.doc_  Symbolic link to ../kits/CDR110/dx_
                             style         helv.doc_style

                             dx_           Symbolic link to ../kits/CDR110/dx_
                             times.doc_    times.doc_style
                             style

               ________________________________________________________________

               /usr/doc/



               CDRBASE110    convert_      Symbolic link to ../kits/CDR110
                             messages.mem  /convert_messages.mem


               ________________________________________________________________




                    Installing the CDA Converter Library for ULTRIX (RISC)  3-5

 










               ________________________________________________________________
               Directory
               and_Subset____File_Name_____Description_________________________

               /usr/kits
               /CDR110/



               CDRBASE110    cda_read_cda  DTIF to DDIF domain converter

                             cda_write_    Analysis back end
                             analysis

                             cdoc          Converters invocation command

                             convert_      Table and Document Conversion
                             messages.mem  Messages

                             ddif_read_    Text front end
                             text

                             ddif_write_   PostScript back end
                             ps

                             ddif_write_   Text back end
                             text

                             release.notes release notes

                             saved         Directory for saving CDRBASE110
                                           files

                             vdoc          CDA Viewer character cell command

                             libddif.a     CDA toolkit library

                             libddif_fe.a  CDA front-end converter library

                             defstyle.ddif Default style guide for text back
                                           end





               3-6  Installing the CDA Converter Library for ULTRIX (RISC)

 










               ________________________________________________________________
               Directory
               and_Subset____File_Name_____Description_________________________



               CDRCVTDOC110  ddif_read_    AFS front end
                             afs

                             ddif_read_    DCA front end
                             dca

                             ddif_read_    SGML front end
                             sgml

                             ddif_write_   AFS front end
                             afs

                             ddif_write_   DCA front end
                             dca

                             ddif_write_   SGMS front end
                             sgml



               CDRCVTDX110   ddif_read_dx  DX front end

                             ddif_write_   DX back end
                             dx

                             dx_cour.doc_  DX courier style guide
                             style

                             dx_           DX style guide
                             guide.doc_
                             style

                             dx_helv.doc_  DX helvetica style guide
                             style






                    Installing the CDA Converter Library for ULTRIX (RISC)  3-7

 










               ________________________________________________________________
               Directory
               and_Subset____File_Name_____Description_________________________

                             dx_           DX times style guide
                             times.doc_
                             style



               CDRCVTGRA110  ddif_read_    CGM front end
                             cgm

                             ddif_read_    Macpaint front end
                             macpaint

                             ddif_read_    TIFF front end
                             tiff

                             ddif_write_   Graphic back end
                             graphics

                             ddif_write_   Macpaint back end
                             macpaint

                             ddif_write_   TIFF back end
                             tiff

                             ghc_font1     Font file used by ddif_write_
                                           graphics



               CDRCVTTBL110  dtif_read_    ASCII tabular front end
                             ascii_
                             tabular

                             dtif_read_    CALCGRD front end
                             calcgrd

                             dtif_read_    DIF front end
                             dif




               3-8  Installing the CDA Converter Library for ULTRIX (RISC)

 










               ________________________________________________________________
               Directory
               and_Subset____File_Name_____Description_________________________

                             dtif_read_    WK1 front end
                             wk1

                             dtif_write_   ASCII tabular back end
                             ascii_
                             tabular

                             dtif_write_   WK1 back end
                             wk1


               ________________________________________________________________

               /usr/kits
               /CDR110/ivp/



               CDRBASE110    CDRBASE110.IVPBase system IVP

                             base.ddif     example file

                             base.options  options file



               CDRCVTDOC110  CDRCVTDOC110.IDocument subset IVP

                             doc.ddif      DDIF example file

                             doc.options   Document options file

                             latin.dca     DCA example file



               CDRCVTDX110   CDRCVTDX110.IVDX subset IVP

                             accept.dx     DX example file



                    Installing the CDA Converter Library for ULTRIX (RISC)  3-9

 










               ________________________________________________________________
               Directory
               and_Subset____File_Name_____Description_________________________



               CDRCVTGRA110  CDRCVTGRA110.IGraphics subset IVP

                             autumn.tiff   TIFF example file

                             champagne.macpMacpaint example file

                             gra.ddif      Graphics DDIF file

                             gra.options   Graphics options file

                             std_test.cgm  CGM example file



               CDRCVTTBL110  CDRCVTTBL110.ITable subset IVP

                             input.calc_   CALCGRD example file
                             grd

                             input.dif     DIF example file

                             input.dtif    DTIF example file

                             input.tab     ASCII tabular example file

                             input.wk1     WK1 example file

               ______________tbl.options___Table_options_file__________________


               ____________________________________________________________

               3.1.3  Accessing the Online Release Notes and Command Files

                  The CDA Converter Library provides online release notes in
                  the directory /usr/kits/CDR110/release.notes




               3-10  Installing the CDA Converter Library for ULTRIX (RISC)

 










               ____________________________________________________________

               3.2  Installing the CDA Converter Library on ULTRIX (RISC)

                  This section tells you how to install the CDA Converter
                  Library files on an ULTRIX system. It also tells you how
                  to restore normal operation, if necessary.

                  During installation, the system prompts you for a response
                  to several questions. Some prompts have accompanying default
                  responses that appear in brackets ([]).  To choose a default
                  response, press the RETURN key.

                  You can request help at any step by typing help in response
                  to a prompt. If the prompt requests a YES or NO answer, you
                  can also type anything that does not begin with a y or n to
                  get help.

                  When you invoke the installation procedure at step 4, the
                  process is the same if you are using either 9-track magnetic
                  tape or TK50 tape cartridge media, and you should proceed to
                  Section 3.3.1.

                  At any point during the procedure, you can return to the
                  beginning of step 4 by pressing CTRL/C.

               ____________________________________________________________

               3.3  Performing the Installation on ULTRIX (RISC)

                  When you have met the prerequisites listed in Section 3.1.1,
                  you are ready to install the CDA Converter Library product.

                  Perform the installation at your system console, in the
                  following order:

                  Step 1: Log in to the root account with the root user name
                  and its password.

                    login: root
                    password:
                    #

                  If you are currently logged into another account, you can
                  switch to the root account by issuing the su command:

                    % su -
                    password:
                    #

                   Installing the CDA Converter Library for ULTRIX (RISC)  3-11

 











                  Step 2: Ensure that no one attempts to use the CDA Converter
                  Library during installation.

                  If necessary, place your system into single-user mode by
                  issuing the following shutdown command:

                    # /etc/shutdown +5 "Installing CDA Converter Library"

                  This command notifies other users that the system will shut
                  down in 5 minutes (as specified by the +5). Then, in five
                  minutes, it logs them out and enters single-user mode. You
                  should note that, in single user mode, the only valid input
                  device is the console.

                  Step 3: Invoke the installation procedure as appropriate for
                  your particular media.

                  If you use 9-track magnetic tape or TK50 tape cartridges,
                  proceed to Section 3.3.1.

               ____________________________________________________________

               3.3.1  9-Track Magnetic Tape and TK50 Tape Cartridge Users

                  Step 1: Invoke the ULTRIX installation procedure with the
                  following command, substituting your device file unit number
                  for the question mark.

                    # setld -l /dev/rmt?h

                  When you invoke the installation procedure, the following
                  message and prompt appears, identifying your specific media:

                    Please make sure your installation media is mounted and on-line.
                    Are you ready (y/n)?: y<RETURN>

                  Step 2: Respond to the ready prompt.

                  If you type NO, the system repeats the prompt. If you type
                  YES, the following messages appear, identifying your specific
                  media:

                    Positioning tape...done.

                    *** Enter Subset Selections ***

               3-12  Installing the CDA Converter Library for ULTRIX (RISC)

 











                    The subsets listed below are optional:
                     1 CDA Base System                      2) CDA DX Converters)
                     3 CDA Document Converters              4) CDA Graphics Converters)
                     5 CDA Table Converters)

                     6 All of the Above)
                     7 None of the Above)

                    Enter your choice(s): 6<RETURN>

                    You are installing the following subsets:
                       CDA Base System                         CDA DX Converters
                       CDA Document Converters                 CDA Graphics Converters
                       CDA Table Converters

                    Is this correct? (y/n): Y<RETURN>

                  The system proceeds to display a list of verification mes-
                  sages for the base system and for each subset you installed.

               ____________________________________________________________

               3.4  After the Installation on ULTRIX (RISC)

                  The CDA Converter Library is now installed and can be invoked
                  by all users with the cdoc command.

               ____________________________________________________________

               3.5  Sample Installation on ULTRIX (RISC)

                  This section contains a sample installation of the CDA
                  Converter Library. Note that this is only a sample. The in-
                  stallation procedure is sometimes modified in maintenance
                  updates of this product. Because this installation guide is
                  not usually revised for maintenance updates, be sure to read
                  the Read Before Installing or Using the CDA Converter Library
                  letter before you install this product. This letter notes any
                  significant changes in the installation that vary from this
                  sample.





                   Installing the CDA Converter Library for ULTRIX (RISC)  3-13

 











                  Sample CDA Converter Library Installation Procedure

               # setld -l /dev/rmt0h<RETURN>

               Please make sure your installation tape is mounted and on-line.

               Are you ready? (y/n): y<RETURN>
               Positioning tape...done.

               *** Enter Subset Selections ***

               The subsets listed below are optional:
                1 CDA Base System                      2) CDA DX Converters)
                3 CDA Document Converters              4) CDA Graphics Converters)
                5 CDA Table Converters)

                6 All of the Above)
                7 None of the Above)

               Enter your choice(s): 6<RETURN>

               You are installing the following subsets:
                  CDA Base System                         CDA DX Converters
                  CDA Document Converters                 CDA Graphics Converters
                  CDA Table Converters

               Is this correct? (y/n): Y<RETURN>

               Copying CDA Base System (CDRBASE110) from tape
               Verifying CDA Base System (CDRBASE110)

               Copying CDA DX Converters (CDRCVTDX110) from tape
               Verifying CDA DX Converters (CDRCVTDX110)

               Copying CDA Document Converters (CDRCVTDOC110) from tape
               Verifying CDA Document Converters (CDRCVTDOC110)

               Copying CDA Graphics Converters (CDRCVTGRA110) from tape
               Verifying CDA Graphics Converters (CDRCVTGRA110)

               Copying CDA Table Converters (CDRCVTTBL110) from tape
               Verifying CDA Table Converters (CDRCVTTBL110)



               3-14  Installing the CDA Converter Library for ULTRIX (RISC)

 











               #setld -v CDRBASE110 CDRCVTDOC110 CDRCVTDX110 CDRCVTGRA110 CDRCVTTBL110<RETURN>
               Checking setld data files.

               Verifying the installation of CDRBASE110
                   Checking text back-end and front-end converters
                   Checking analysis back-end converter
                   Checking ps back-end converter
               The CDRBASE110 IVP has completed successfully

               Verifying the installation of CDRCVTDOC010
                   Checking afs back-end and front-end converters
                   Checking dca front-end and back-end converters
                   Checking sgml back-end and front-end converters
               The CDRCVTDOC010 IVP has completed successfully

               Verifying the installation of CDRCVTDX010
                   Checking dx front-end and back-end converters
               The CDRCVTDX010 IVP has completed successfully

               Verifying the installation of CDRCVTGRA010
                   Checking cgm front-end converter
                   Checking macpaint front-end and back-end converters
                   Checking tiff front-end and back-end converters
                   Checking graphics back-end converter
               The CDRCVTGRA010 IVP has completed successfully

               Verifying the installation of CDRCVTTBL010
                   Checking ascii_tabular front-end and back-end converters
                   Checking calcgrd front-end converter
                   Checking dif front-end converter
                   Checking wk1 front-end and back-end converters
               The CDRCVTTBL010 IVP has completed successfully

               #











                   Installing the CDA Converter Library for ULTRIX (RISC)  3-15

 




















                                                                      Index
               ________________________________________________________________


               A___________________________    Distribution media

               Accessing the online command      for ULTRIX (RISC), 3-2
                  files                          for ULTRIX (VAX), 2-2
                 for ULTRIX, 2-10, 3-10        E
               Accessing the release notes     ____________________________
                 for ULTRIX, 2-10, 3-10        Error conditions
                 for VMS, 1-2                    on VMS, 1-15
               After the installation
                 on ULTRIX (RISC), 3-13        F___________________________
                 on ULTRIX (VAX), 2-12         Files created or modified
               Authorize Utility                 during ULTRIX (RISC)
                 for VMS, 1-3
                                                   installation, 3-2
               C___________________________      during ULTRIX (VAX)
               Command files                       installation, 2-2
                 accessing on line for           during VMS installation,
                    ULTRIX, 2-10, 3-10             1-11

               Conventions                     I
                 described in the preface,     ____________________________
                    vii                        Installation prerequisites
                                                 for ULTRIX (RISC), 3-1
               D___________________________      for ULTRIX (VAX), 2-1
               Determining and reporting       Installation procedure
                  problems                       for ULTRIX (RISC), 3-11
                 described in the preface,         to 3-13
                    vi                           for ULTRIX (VAX), 2-10  to
                                                   2-12

                                                                        Index-1

 






          Installation procedure          Prerequisites (Cont.)
             (Cont.)                        to install on ULTRIX
            for VMS, 1-6  to 1-14             (RISC), 3-1
          Installation procedure            to install on ULTRIX (VAX)
             requirements                     , 2-1
            for VMS, 1-2                  Prerequisite software for
          Installation Verification          VMS, 1-1
             Procedure (IVP)              Product Authorization Key
            on VMS, 1-14                     (PAK)
          L                                 for VMS, 1-3

          ____________________________    R
          License Management Facility     ____________________________
             (LMF)                        Release notes
            for VMS, 1-3                    accessing on ULTRIX, 2-10,
          M                                   3-10
          ____________________________      accessing on VMS, 1-2

          Maintenance updates             S
            described in the preface,     ____________________________
               v                          Sample installation
          Media                             on ULTRIX (RISC), 3-13
            for ULTRIX (RISC), 3-2          on ULTRIX (VAX), 2-13
            for ULTRIX (VAX), 2-2           on VMS, 1-16

          O___________________________    U___________________________

          Optional software for VMS,      ULTRIX (RISC) installation
             1-1                             procedure, 3-11  to 3-13
                                          ULTRIX (VAX) installation
          P___________________________       procedure, 2-10  to 2-12

          PAK                             User account quotas and
            for VMS, 1-3                     privileges
          Preface, v  to vii                for VMS, 1-2
            conventions, vii              Using VMSINSTAL
            determining and reporting       to install on VMS, 1-4

               problems, vi               V
            maintenance updates, v        ____________________________
            preparing to install, vii     VMSINSTAL
          Preparing to install              using to install on VMS,
            described in the preface,         1-4
               vii
          Prerequisites

          Index-2

 






          VMS installation procedure,
             1-6  to 1-14





































                                                                   Index-3
