CDA_Converter_Library_________________________ Installation Guide Order Number: AA-Q2H3A-TE December 1993 This document contains instructions for installing the CDA[TM] Converter Library on the OpenVMS[TM] for VAX[TM] operating system. 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 2.2 and all maintenance updates throughout that version. Revision/Update Information This revised manual supersedes the CDA Converter Library Installation Guide (Order Number AA- PD7VB-TE). Operating Systems andVersionsOpenVMS for VAX V5.0 or higher Future maintenance releases of the CDA Converter Library may require higher versions. Software Version CDA Converter Library Version 2.2 Digital Equipment Corporation Maynard, Massachusetts __________________________________________________________ First Printing, July 1989 Revised, August 1992 Revised, December 1993 The information in this document is subject to change without notice and should not be construed as a commitment by Digital Equipment Corporation. Digital Equipment Corporation assumes no responsibility for any errors that may appear in this document. Possession, use, duplication, or dissemination of the software described in this documentation is authorized only pursuant to a valid written license from Digital or the third-party owner of the software copyright. No responsibility is assumed for the use or reliability of software or equipment that is not supplied by Digital Equipment Corporation. © Digital Equipment Corporation 1989, 1992, 1993. All Rights Reserved. Digital Equipment Corporation makes no representation that the use of its products in the manner described in this publication will not infringe on existing or future rights, nor do the descriptions contained in this publication imply the granting of licenses to make, use, or sell equipment or software in accordance with the description. The following are trademarks of Digital Equipment Corporation: ALL-IN-1, Bookreader, CDA, DDIF, DECcalc, DECcalc-PLUS, DECdecision, DECimage, DECnet, DECpresent, DECwrite, DIGITAL, DTIF, OpenVMS, PATHWORKS, Runoff, VAX, WPS-PLUS, and the Digital Logo. The following are third-party trademarks: OSF/1 is a registered trademark of the Open Software Foundation, Inc. Adobe and PostScript are registered trademarks of Adobe Systems, Inc. Hewlett-Packard, HP, and LaserJet are registered trademarks of Hewlett-Packard Company. IBM is a registered trademark of International Business Machines Corporation. Helvetica, Times, and Times Roman are registered trademarks of Linotype AG and/or its subsidiaries. Courier is a registered trademark of Smith-Corona Corporation. Lotus 1-2-3 is a registered trademark of Lotus Development Corporation. Supercomp-Twenty and 20/20 are trademarks of Access Technology, Inc. Macintosh and MacDraw are trademarks of Apple Computer, Inc. MacPaint and MacWrite are registered trademarks of Claris Corporation. DIF is a trademark of Software Arts Production Corp. Microsoft, Microsoft Word, Microsoft Windows, and MS-DOS are registered trademarks of Microsoft Corporation. UNIX is a registered trademark of X/Open Company Limited. WordPerfect is a registered trademark of WordPerfect Corporation. All other trademarks and registered trademarks are the property of their respective owners. This document was prepared using VAX DOCUMENT Version 2.1. ________________________________________________________________ Contents Preface.................................................. vii 1 Preparing to Install the CDA Converter Library on OpenVMS 1.1 Preparing for the CDA Converter Library Installation................................. 1-1 1.2 Prerequisite and Optional Software........... 1-2 1.2.1 CDA Run-Time Services V1.0 Kit Included with the CDA Converter Library........... 1-3 1.3 Installation Procedure Requirements.......... 1-4 1.3.1 Installation Time........................ 1-4 1.3.2 Removing Previous Known Images........... 1-5 1.3.3 Privileges and Disk Space................ 1-5 1.3.4 System Parameters........................ 1-6 1.3.4.1 Checking System Parameter Values....... 1-7 1.3.4.2 Calculating the Values for GBLPAGES and GBLSECTIONS............................ 1-8 1.3.4.3 Changing System Parameter Values with AUTOGEN................................ 1-8 1.3.4.4 Setting Dynamic System Parameter Values................................. 1-10 1.4 ALL-IN-1 Special Requirements................ 1-10 1.4.1 Installation Restrictions for ALL-IN-1... 1-11 1.4.2 Known Image Requirements for ALL-IN-1.... 1-11 1.5 Process Account Quotas....................... 1-11 1.6 VMSINSTAL Requirements....................... 1-13 1.7 Backing up Your System Disk.................. 1-13 1.8 CDA Converter Library Requirements........... 1-14 iii 2 Installing the CDA Converter Library on OpenVMS 2.1 The Installation Procedure................... 2-1 2.2 Error Recovery............................... 2-9 3 After Installing the CDA Converter Library on OpenVMS 3.1 After Installing the CDA Converter Library... 3-1 3.2 Running the Installation Verification Procedure Separately......................... 3-2 3.3 Setting User Account Requirements............ 3-2 3.3.1 Privileges............................... 3-2 3.3.2 User Account Quotas...................... 3-2 3.3.3 Installing the CDA Converter Library as a Known Image.............................. 3-3 3.4 Determining and Reporting Problems........... 3-4 A Sample Installation on OpenVMS B Files Installed on OpenVMS B.1 File Names Created when the CDA Converter Library is Installed......................... B-1 B.2 Sample Options File Names Created when the CDA Run-Time Services is Installed........... B-7 Index Examples A-1 Sample CDA Converter Library Installation Procedure................................ A-1 Tables 1-1 Prerequisite and Optional Software....... 1-2 1-2 Disk Space Requirements.................. 1-6 1-3 Minimum Required System Parameter Values................................... 1-6 1-4 Required Dynamic Parameter Values........ 1-10 iv 1-5 Process Account Quotas for the Installing Account.................................. 1-11 3-1 User Account Quotas for Using the CDA Converter Library........................ 3-3 B-1 CDA Converter Library Directories and File Names............................... B-1 B-2 Directories and File Names for CDA Run-Time Services Sample Options......... B-8 v ________________________________________________________________ Preface Purpose of This Guide This guide describes how to install the CDA Converter Library on VAX processors that are running the OpenVMS operating system. Keep this document with your distribution kit. You will need it to install maintenance updates or to reinstall the CDA Converter Library for any other reason. At the back of this document are two Reader's Comments forms. If you have any comments about this document, fill out one form and mail it; your comments will be considered for the next revision of the installation guide. Audience This guide is for the system manager who installs the CDA Converter Library software. Structure of this Document This guide contains three chapters and two appendices as follows: o Chapter 1 describes how to prepare for installing the CDA Converter Library on OpenVMS systems. o Chapter 2 describes how to install the CDA Converter Library on OpenVMS systems. o Chapter 3 describes what you must do after installing the CDA Converter Library on OpenVMS systems. o Appendix A contains a sample installation of the CDA Converter Library on OpenVMS systems. vii o Appendix B contains the names of all files and directories created on your system when you install the CDA Converter Library. Manuals in the CDA Converter Library Documentation Set In addition to this guide, the CDA Converter Library documentation set includes the following books: o Using the CDA Converter Library o Technical Guide to the CDA Converter Library o Conversion Messages Guide The Conversion Messages Guide is supplied as an online text file. This file is available at the following location: SYS$COMMON:[SYSHLP]CDACVTLIB$MESSAGES.TXT Online bookreader[TM] files of this product are also available as part of the OpenVMS Consolidated Software Distribution on CD-ROM. Conventions The following conventions are used in this guide: __________________________________________________________ Convention_____________Description________________________ UPPERCASE TEXT Uppercase letters indicate the name of a command, a file, a parameter, a procedure, or utility. $@SYS$UPDATE:VMSINSTAL In interactive examples, user input is printed in courier font. $ The dollar sign is used to indicate the DCL prompt. This prompt may be different on your system. Ctrl/x In procedures, a sequence such as Ctrl/x indicates that you must hold down the key labeled Ctrl while you press another key or a pointing device button. viii __________________________________________________________ Convention_____________Description________________________ In procedures, a key name is shown enclosed to indicate that you press a key on the keyboard. . . . Horizontal ellipsis indicates that additional parameters, values, or information can be entered. Note A note contains information of special importance to the user. [logical-name] Square brackets indicate that the enclosed item is optional. (Square brackets are not, however, optional in the syntax of a directory name in a file specification or in the syntax of a substring specification _______________________in_an_assignment_statement.)_______ ix 1 ________________________________________________________________ Preparing to Install the CDA Converter Library on OpenVMS This chapter gives information about the preparations and requirements necessary for installing the CDA Converter Library. This chapter contains the following: o Preparing for the CDA Converter Library installation o Prerequisite and optional software o Installation procedure requirements o Process account quotas o VMSINSTAL requirements o Backing up your system disk o CDA Converter Library requirements 1.1 Preparing for the CDA Converter Library Installation This section applies to Version 2.2 of the CDA Converter Library and all subsequent maintenance releases up to the next major product release. Your bill of materials (BOM) specifies the number and contents of your media. Be sure to verify the contents of your kit with this information. If your kit is damaged or if you find that parts of it are missing, contact your Digital[TM] representative. The CDA Converter Library provides online release notes. Digital strongly recommends that you read the release notes before proceeding with the installation. For information about accessing the online release notes, see Section 2.1. Preparing to Install the CDA Converter Library on OpenVMS 1-1 Preparing to Install the CDA Converter Library on OpenVMS 1.2 Prerequisite and Optional Software 1.2 Prerequisite and Optional Software Table 1-1 provides information about the software that you must have installed on your system before installing the CDA Converter Library. Table 1-1 also includes information about optional software that you can use with the CDA Converter Library. The System Software Addendum (SSA) and Software Product Description (SPD) contains a complete list of prerequisite and optional software and their required version numbers. Table_1-1_Prerequisite_and_Optional_Software______________ Prerequisite Products____________Purpose_______________________________ OpenVMS Version 5.0 DECimage[TM] Required for the TIFF and MacPaint[R] Application converters Services Version 2.0 or Version 3.0 Digital's Image Required when using the Graphics Applications Hardcopy converter. DAS V3.0 is Services (DAS) distributed as part of the Motif kit. V3.0 or later DEC GKS[TM] Required when using the Graphics Version 4.2 Hardcopy converter (Runtime System) (continued on next page) 1-2 Preparing to Install the CDA Converter Library on OpenVMS Preparing to Install the CDA Converter Library on OpenVMS 1.2 Prerequisite and Optional Software Table_1-1_(Cont.)_Prerequisite_and_Optional_Software______ Prerequisite Products____________Purpose_______________________________ Digital CDA Run- A version of CDA Run-Time Services is Time Services or supplied with the Converter Library CDA Base Services kit, but DECwindows[TM] non-Motif systems cannot run CDA Run-Time Services V1.0. The Converter Library installation procedure will not update your CDA Base Services software if you are running a pre-Motif version of DECwindows. Digital recommends that you upgrade your system to a Motif[R] version of DECwindows. The CDA Converter Library V2.2 is not warranted to run under older versions of CDA, but if you have a pre-Motif version of DECwindows and cannot upgrade, it is possible the performance of the CDA Converter Library V2.2 will be adequate to your ____________________needs.________________________________ 1.2.1 CDA Run-Time Services V1.0 Kit Included with the CDA Converter Library The Converter Library V2.2 installation kit includes the CDA Run-Time Services V1.0 kit for the CDA base components such as the CDA Viewer and the CDA toolkit. The Converter Library V2.2 installation procedure automatically installs the CDA Run-Time Services kit if your CDA base software needs to be updated.[1] ___________________ [1]If you have a non-Motif version of DECwindows currently installed, CDA Run-Time Services V1.0 will not be installed on your system. CDA Run-Time services is not compatible with DECwindows non-Motif systems. Preparing to Install the CDA Converter Library on OpenVMS 1-3 Preparing to Install the CDA Converter Library on OpenVMS 1.2 Prerequisite and Optional Software The CDA Run-Time Services V1.0 kit is packaged as a layered product, and is equivalent to the CDA Base Services software installed with your OpenVMS Motif software. The CDA Run-Time Services update ensures that the latest CDA Base Services product is available on your system. ________________________Note ________________________ Since your system may have an existing version of the CDA base software, you will not need to make adjustments to quotas as a result of the installation of the new CDA Run-Time Services V1.0 kit. For more information about the CDA Run-Time Services installation requirements, see the CDA Run- Time Installation Guide for VMS which is available from the following location: SYS$HELP:CDART010_INS_GUIDE.TXT This manual contains useful information about the CDA base software files updated with this kit. _____________________________________________________ Digital recommends that you run the Converter Library V2.2 with this latest version of CDA Base Services software. 1.3 Installation Procedure Requirements The following sections outline various requirements for installing the CDA Converter Library. 1.3.1 Installation Time The installation takes approximately 12 minutes to complete, depending on your type of media and your system configuration. If the CDA Run-Time Services V1.0 is installed, the installation takes approximately 17 minutes to complete. 1-4 Preparing to Install the CDA Converter Library on OpenVMS Preparing to Install the CDA Converter Library on OpenVMS 1.3 Installation Procedure Requirements 1.3.2 Removing Previous Known Images None of the converter images are installed using the VMS Install Utility (INSTALL). If you have installed a previous converter image as a known image, ensure that you remove it as a known image before running the installation procedure. To check that a converter is not INSTALLED, enter the following at the DCL prompt: $ INSTALL LIST converter-name To remove a converter as a known image before running the installation procedure, enter the following at the DCL prompt: $ INSTALL DELETE converter-name 1.3.3 Privileges and Disk Space To install the CDA Converter Library, you must be logged in to an account that has SETPRV or at least the following privileges: o CMKRNL o WORLD o SYSPRV ________________________Note ________________________ VMSINSTAL turns off the BYPASS privilege at the start of the installation. _____________________________________________________ The CDA Converter Library's requirements for free disk storage space are different during installation and after installation. Table 1-2 summarizes the storage requirements. ________________________Note ________________________ Most OpenVMS systems will contain a version of the CDA Run-Time Services software. Hence, the disk space requirements listed in Table 1-2 contains the maximum storage requirements for systems that do Preparing to Install the CDA Converter Library on OpenVMS 1-5 Preparing to Install the CDA Converter Library on OpenVMS 1.3 Installation Procedure Requirements not contain an existing version of the CDA Run-Time Services software. _____________________________________________________ Table_1-2_Disk_Space_Requirements_________________________ Blocks During Blocks After Kit______________Installation__________Installation_______ CDA Converter 28 000 16 500 Library Version 2.2_______________________________________________________ To determine the number of free disk blocks on the current system disk, enter the following command at the DCL prompt: $ SHOW DEVICE SYS$SYSDEVICE 1.3.4 System Parameters Installing the CDA Converter Library requires certain system parameter settings. Table 1-3 lists the minimum required system parameter values for the installation. Depending on the kinds of programs and applications running at your site, you might need higher values for some settings. Table_1-3_Minimum_Required_System_Parameter_Values________ System_Parameter___________Minimum_Value__________________ GBLPAGES[1] 10 000 + 0 GBLPAGFIL 1024 GBLSECTIONS[1] 250 + 0 [1]The_values_listed_for_these_system_parameters_represent the number of free global pages and global sections required for the installation, not the total number you need to run your system and other software. (continued on next page) 1-6 Preparing to Install the CDA Converter Library on OpenVMS Preparing to Install the CDA Converter Library on OpenVMS 1.3 Installation Procedure Requirements Table 1-3 (Cont.) Minimum Required System Parameter __________________Values__________________________________ System_Parameter___________Minimum_Value__________________ PQL_DASTLM[2] 24 PQL_DBIOLM[2] 18 PQL_DDIOLM[2] 18 RESHASHTBL 64 SRPCOUNTV 250 VIRTUALPAGECNT 100 000 WSMAX 10 000 [2]These_dynamic_system_parameters_must_be_set_permanently to values equal to or greater than the values listed. Do not lower these values after the installation. __________________________________________________________ The following sections show you how to: o Check system parameter values. o Calculate values for the GBLPAGES and GBLSECTIONS system parameters. o Change parameter values with the OpenVMS AUTOGEN command procedure. o Set dynamic parameters [such as PQL_DASTLM] with the OpenVMS System Generation Utility (SYSGEN). 1.3.4.1 Checking System Parameter Values To check the values of your system parameters, enter the following command at the DCL prompt to invoke the System Generation Utility (SYSGEN): $ RUN SYS$SYSTEM:SYSGEN SYSGEN> At the SYSGEN> prompt, enter the SHOW command to display the value of a system parameter. The values displayed should equal or exceed the value of each system parameter listed in Table 1-3. The following example displays the value for the WSMAX system parameter: SYSGEN> SHOW WSMAX Preparing to Install the CDA Converter Library on OpenVMS 1-7 Preparing to Install the CDA Converter Library on OpenVMS 1.3 Installation Procedure Requirements After checking the parameters with the SHOW command, enter the EXIT command at the SYSGEN> prompt to return to the DCL level. 1.3.4.2 Calculating the Values for GBLPAGES and GBLSECTIONS To install and run the CDA Converter Library, you must have sufficient free global pages and global sections. You must first find out how many free global pages and sections you have on your system. Then use AUTOGEN if you need to increase the GBLPAGES and GBLSECTIONS system parameters. If you are installing the CDA Converter Library on an OpenVMS Version 5.2 system, you can use the WRITE command with the F$GETSYI lexical function to find the number of free global pages and global sections. The following example shows how to get this information at your terminal (the default for SYS$OUTPUT): $ WRITE SYS$OUTPUT F$GETSYI("FREE_GBLPAGES") 15848 $ WRITE SYS$OUTPUT F$GETSYI("FREE_GBLSECTS") 24 If the values displayed by the system are greater than the values in Table 1-3, you do not need to increase the values for these parameters. If the value of free global pages or global sections is less than the value in Table 1-3, you must increase the system parameter setting. Section 1.3.4.3 describes the procedures for increasing these values using AUTOGEN. 1.3.4.3 Changing System Parameter Values with AUTOGEN Use the AUTOGEN command procedure to change system parameters. AUTOGEN automatically adjusts values for parameters that are associated with the values you reset manually. To change system parameters with AUTOGEN, edit the following file: SYS$SYSTEM:MODPARAMS.DAT Use an editor to access the file. To change a parameter value listed in this file, delete the current value associated with that parameter and enter the new value. 1-8 Preparing to Install the CDA Converter Library on OpenVMS Preparing to Install the CDA Converter Library on OpenVMS 1.3 Installation Procedure Requirements To add a new parameter, add a line to the file that includes both the name of the parameter and its value. For example: WSMAX = 1024 Use ADD_GBLPAGES or ADD_GBLSECTIONS to modify incremental parameters such as GBLPAGES and GBLSECTIONS. The following example increases the global page setting by 2000: ADD_GBLPAGES = 2000 ________________________Note ________________________ When you set the page file quota, do not use a value that exceeds the amount of page file space available on the system. _____________________________________________________ After you make all your changes, exit from the editor and execute the AUTOGEN procedure to recalculate your system parameters. Enter the following command at the DCL prompt: $ @SYS$UPDATE:AUTOGEN GETDATA REBOOT When you specify REBOOT, AUTOGEN performs an automatic system shutdown and then reboots the system. Any users logged on to the system are immediately disconnected during the shutdown. The automatic reboot puts the new parameter values into effect. The AUTOGEN Utility automatically adjusts some of the SYSGEN parameters based on the consumption of resources since the last reboot. If you do not want to take advantage of this automatic adjustment, include the NOFEEDBACK qualifier on the AUTOGEN command line. For more information about using AUTOGEN, see the OpenVMS System Management Subkit. Preparing to Install the CDA Converter Library on OpenVMS 1-9 Preparing to Install the CDA Converter Library on OpenVMS 1.3 Installation Procedure Requirements 1.3.4.4 Setting Dynamic System Parameter Values Use the System Generation Utility (SYSGEN) to set dynamic parameters. Dynamic parameters changed with the SYSGEN WRITE ACTIVE command become active immediately without any need to reboot your system. In fact, rebooting returns dynamic system parameter values to their previous settings. Once you change dynamic parameter values, you should complete the installation before rebooting the system. After you finish with the installation, you can reset the dynamic parameters to their previous values or let them be reset automatically when you next reboot your system. The CDA Converter Library requires the dynamic parameter value listed in Table 1-4. Table_1-4_Required_Dynamic_Parameter_Values_______________ Dynamic_Parameter__________Value__________________________ PQL_DASTLM 24 PQL_DBIOLM 18 PQL_DDIOLM_________________18_____________________________ If the dynamic parameter values on your system are less than the values previously listed, use the following series of commands to change the values. This example changes the PQL_DASTLM value to 24. $ RUN SYS$SYSTEM:SYSGEN SYSGEN> USE ACTIVE SYSGEN> SET PQL_DASTLM 24 SYSGEN> WRITE ACTIVE SYSGEN> EXIT 1.4 ALL-IN-1 Special Requirements The following sections contain information about restrictions and requirements specific to ALL-IN-1[TM] users. The information is structured as follows: o Installation restrictions for ALL-IN-1 1-10 Preparing to Install the CDA Converter Library on OpenVMS Preparing to Install the CDA Converter Library on OpenVMS 1.4 ALL-IN-1 Special Requirements o Known image requirements for ALL-IN-1 1.4.1 Installation Restrictions for ALL-IN-1 The Converter Library V2.2 bundles CDA Run Time V1.0 (equivalent software to Base Services V1.7), therefore the CDAPAT011 patch kit is no longer required. The CDAPAT011 patch kit checks the version number of your current CDA Base Services software, therefore it will not replace CDA Run-Time Services V1.0. You can install CDA Run-Time Services V1.0 if you are in doubt as to how up-to-date your CDA Base Services software is. ______________________ Caution ______________________ You must not install the CDAPAT011 patch kit after installing the Converter Library V2.2. _____________________________________________________ 1.4.2 Known Image Requirements for ALL-IN-1 ALL-IN-1 is a privileged image, therefore any converters used by ALL-IN-1 must be installed as a known image with privileges using the OpenVMS command, INSTALL. This also applies to the various CDA Base Services images. See Section 3.3.3 for more information about how to install converters as known images. 1.5 Process Account Quotas The account you use to install the CDA Converter Library must have sufficient quotas to enable you to perform the installation. Table 1-5 summarizes the process quotas required for the installation account. Table 1-5 Process Account Quotas for the Installing __________Account_________________________________________ Account_Quota____Value____________________________________ ASTLM 24 (continued on next page) Preparing to Install the CDA Converter Library on OpenVMS 1-11 Preparing to Install the CDA Converter Library on OpenVMS 1.5 Process Account Quotas Table 1-5 (Cont.) Process Account Quotas for the __________________Installing_Account______________________ Account_Quota____Value____________________________________ BIOLM 18 BYTLM 18 000 DIOLM 18 ENQLM 30 FILLM 20 PRCLM 0 WSDEF 256[1] [1]The_values_for_WSEXT_and_WSQUO_must_be_equal_to_or_____ greater than the WSDEF value. __________________________________________________________ User account quotas are stored in the file SYSUAF.DAT. Use the OpenVMS Authorize Utility (AUTHORIZE) to verify and change user account quotas. First set your directory to SYS$SYSTEM and then run AUTHORIZE: $ SET DEFAULT SYS$SYSTEM $ RUN AUTHORIZE UAF> At the UAF> prompt, enter the SHOW command with an account name to check a particular account. For example: UAF> SHOW SMITH To change a quota, enter the MODIFY command. The following example changes the FILLM quota for the SMITH account and then exits from the utility: UAF> MODIFY SMITH /FILLM=50 UAF> EXIT After you exit from the utility, the system displays messages indicating whether or not changes were made. Once the changes have been made, you must log out and log in again for the new quotas to take effect. For more information about modifying account quotas, see the description of the Authorize Utility in the OpenVMS System Management Subkit. 1-12 Preparing to Install the CDA Converter Library on OpenVMS Preparing to Install the CDA Converter Library on OpenVMS 1.6 VMSINSTAL Requirements 1.6 VMSINSTAL Requirements When you invoke VMSINSTAL, it checks the following: o Whether you have set your default device and directory to SYS$UPDATE o Whether you are logged in to a privileged account o Whether you have adequate quotas for installation o Whether DECnet is running o Whether any users are logged in to the system Note that VMSINSTAL requires that the installation account have a minimum of the following quotas: ASTLM = 24 BIOLM = 18 BYTLM = 18 000 DIOLM = 18 ENQLM = 30 FILLM = 20 If VMSINSTAL detects any problems during the installation, it notifies you and asks if you want to continue the installation. In some instances, you can enter YES to continue. To stop the installation process and correct the situation, enter NO or press RETURN. Then correct the problem and restart the installation. 1.7 Backing up Your System Disk At the beginning of the installation, VMSINSTAL asks if you have backed up your system disk. Digital recommends that you do a system disk backup before installing any software. Use the backup procedures that are established at your site. For details on performing a system disk backup, see the section on the Backup Utility in the OpenVMS System Management Subkit. Preparing to Install the CDA Converter Library on OpenVMS 1-13 Preparing to Install the CDA Converter Library on OpenVMS 1.8 CDA Converter Library Requirements 1.8 CDA Converter Library Requirements The CDA Converter Library installation procedure checks that the following software is installed: o DECimage Application Services Version 2.0 or Version 3.0 o DEC CDA Run-Time Services V1.0, (which is equivalent to CDA Base Services Version 1.7) 1-14 Preparing to Install the CDA Converter Library on OpenVMS 2 ________________________________________________________________ Installing the CDA Converter Library on OpenVMS This chapter explains how to install the CDA Converter Library on OpenVMS systems. Section 2.1 contains a step- by-step description of the installation procedure. This chapter contains the following: o The installation procedure o Error recovery 2.1 The Installation Procedure The CDA Converter Library installation procedure consists of a series of questions and informational messages. See Appendix A for a sample installation. 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 exits. You can then start the installation again. To install the CDA Converter Library, do the following: 1. Invoke VMSINSTAL @SYS$UPDATE:VMSINSTAL saveset-name device-name OPTIONS N To start the installation, invoke the VMSINSTAL command procedure from a privileged account, such as the SYSTEM account. VMSINSTAL is in the SYS$UPDATE directory. The following list defines the elements of the VMSINSTAL command procedure: Installing the CDA Converter Library on OpenVMS 2-1 Installing the CDA Converter Library on OpenVMS 2.1 The Installation Procedure saveset-name The installation name for the component. For the CDA Converter Library, use the following installation name: CDACVTLIB022 device-name The name of the device on which you plan to mount the media. For example, MTA0: is the device name for a tape drive. It is not necessary to use the console drive for this installation. However, if you do use the console drive, you should replace any media you removed once the installation is complete. OPTIONS N An optional parameter that indicates you want to see the question on release notes. If you do not include the OPTIONS N parameter, VMSINSTAL does not ask you about the release notes. You should review the release notes before proceeding with the installation in case they contain additional information about the installation. If you are restarting the installation and have already reviewed the release notes, you do not need to specify OPTIONS N. There are several other options as follows that you can select when you invoke VMSINSTAL: o Auto_answer option (A): Initially creates a file that contains your answers to VMSINSTAL questions and prompts. You can then use the option (and the answer file) to save time during a reinstallation (typically after upgrading your system). o Get save set option (G): Allows you to store product save sets temporarily on a magnetic tape or in a disk directory. o File log option (L): Logs all activity to the terminal during installation. o Alternate root option (R): Allows you to install the product to a system root other than that of the running system. 2-2 Installing the CDA Converter Library on OpenVMS Installing the CDA Converter Library on OpenVMS 2.1 The Installation Procedure See the OpenVMS documentation on software installation in the OpenVMS System Management Subkit for detailed information about these options. If you specify more than one option, separate the options with commas (for example, OPTIONS A, N). The following example invokes VMSINSTAL to install the CDA Converter Library from tape drive MTA0: and shows the system response. This example uses the OPTIONS N release note parameter. $ @SYS$UPDATE:VMSINSTAL CDACVTLIB022 MTA0: OPTIONS N VAX/VMS Software Product Installation Procedure V5.4-3 It is 01-Aug-1993 at 10:30.) Enter a question mark (?) at any time for help. If you do not supply either the product name or the device name, VMSINSTAL prompts you for this information later in the installation procedure. VMSINSTAL does not prompt you for any options, so be sure to include OPTIONS N on the VMSINSTAL command line to access the release notes during the installation. If you are installing on OpenVMS Version 5.2 or higher, VMSINSTAL does not check the DECnet status. You can install the CDA Converter Library while DECnet is up and running. 2. Confirm system backup * Are you satisfied with the backup of your system disk [YES]? VMSINSTAL asks if you are satisfied with your system backup. You should always back up your system disk before performing an installation. If you are satisfied with the backup of your system disk, press . Otherwise, enter NO to discontinue the installation. After you back up your system disk, you can restart the installation. 3. Mount the media Installing the CDA Converter Library on OpenVMS 2-3 Installing the CDA Converter Library on OpenVMS 2.1 The Installation Procedure Please mount the first volume of the set on MTA0:. * Are you ready? YES %MOUNT-I-MOUNTED, CDACVTLIB MOUNTED ON _$$MTA0: (NODE 1) The following products will be processed: CDACVTLIB V2.2 Beginning installation of CDACVTLIB V2.2 at 20:01 %VMSINSTAL-I-RESTORE, Restoring product saveset A... You should now mount the first distribution volume on the device you specified when you invoked VMSINSTAL. The device name appears in the line preceding the question. VMSINSTAL then asks you if you are ready to continue with the installation. If you respond YES to indicate that you are ready, VMSINSTAL displays a message that the media containing the CDA Converter Library has been mounted on the specified device and that the installation has begun. If you entered the wrong device name when you invoked VMSINSTAL and need to restart the installation, enter NO in response to the "Are you ready?" question. To abort the installation for other reasons, press Ctrl/y. 4. Mount additional media volumes %BACKUP-I-READYREAD, mount volume 2 on _MTA0: for reading Enter "YES" when ready: If your installation kit contains more than one volume, VMSINSTAL prompts you to mount the additional volumes and then asks you to indicate that you are ready for the installation to proceed. 5. Select a release notes option 2-4 Installing the CDA Converter Library on OpenVMS Installing the CDA Converter Library on OpenVMS 2.1 The Installation Procedure 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]: If you specified OPTIONS N when you invoked VMSINSTAL, you are now asked to choose one of the four options for reviewing the release notes. If you select option 1, VMSINSTAL displays the release notes immediately on the console terminal. You can terminate the display at any time by pressing Ctrl/c. If you select option 2, VMSINSTAL prompts you for the name of the print queue that you want to use: * Queue name [SYS$PRINT]: You can press to send the file to the default output print device or you can enter another queue name. If you select option 3, VMSINSTAL displays the release notes immediately on the console terminal and then prompts you for a queue name for the printed version. Select option 4 if you have already reviewed the release notes and are restarting the installation. Next, VMSINSTAL displays the following question: * Do you want to continue the installation [N]?: YES %VMSINSTAL-I-RELMOVED, The product's release notes have been successfully moved to SYS$HELP. To continue the installation, enter YES. Otherwise, press . In either case, the release notes are copied to a file in the SYS$HELP directory: Installing the CDA Converter Library on OpenVMS 2-5 Installing the CDA Converter Library on OpenVMS 2.1 The Installation Procedure SYS$HELP:CDACVTLIB022.RELEASE_NOTES ________________________Note ________________________ The name of the release notes file installed by VMSINSTAL consists of the current product name and version number. Do not delete release notes for previous versions of the CDA Converter Library. _____________________________________________________ 6. Purge files * Do you want to purge files replaced by this installation [YES]? You have the option to purge files from previous ver- sions of the CDA Converter Library that are superseded by this installation. Purging is recommended; however, if you need to keep files from the previous version, enter NO in response to the question. ________________________Note ________________________ If you choose to purge the files, the Installation Verification Procedure (IVP) will not be initiated. See Section 3.2 for more information. _____________________________________________________ 7. Choose the Installation Verification Procedure (IVP) option * Do you want to run the IVP after the installation [YES]? The installation procedure now asks if you want to run the IVP. The IVP for the CDA Converter Library checks to be sure that the installation is successful. It is recommended that you run the IVP. After the CDA Converter Library is installed, you can run the IVP independently to verify that the software is available on your system. You might need to run the IVP after a system failure to make sure that users can access the CDA Converter Library. 2-6 Installing the CDA Converter Library on OpenVMS Installing the CDA Converter Library on OpenVMS 2.1 The Installation Procedure 8. Respond to license registration queries Product: CDA-CONVERTER-LIBRARY Producer: DEC Version: 2.2 Release Date: 01-Jan-1994 * Does this product have an authorization key registered and loaded? The installation procedure displays license information about your product and then asks if you have registered and loaded your Product Authorization Key (PAK). If you have not registered and loaded your PAK, you must answer NO to this question. You must register and load your PAK to successfully complete the installation. If you have not done so, you should stop the installation, register and load your PAK, and then restart the installation. 9. Read informational messages At this point, the installation procedure displays a number of informational messages that report on the progress of the installation. There are no further questions. If the installation procedure has been successful up to this point, VMSINSTAL moves the new or modified files to their target directories, updates help files, and updates DCL tables, if necessary. If you chose to have files purged, that work is done now. The following messages are displayed: %VMSINSTAL-I-MOVEFILES, files will now be moved to their target directories... See Appendix B for a complete list of all the files that are installed on your system when you install the CDA Converter Library. 10.Observe the Installation Verification Procedure (IVP) If you chose to run the IVP, VMSINSTAL runs it at this point. When the IVP runs successfully, you see the following display: CDA Converter Library V2.2 IVP completed successfully. Installing the CDA Converter Library on OpenVMS 2-7 Installing the CDA Converter Library on OpenVMS 2.1 The Installation Procedure 11.End the installation procedure Installation of CDACVTLIB V2.2 completed at 10:30 VMSINSTAL procedure done at 10:30 The previous messages indicate that the entire installation procedure is complete. You can now log out of the privileged account: $ LOGOUT SYSTEM logged out at 01-Jan-1994 10:30:25.10 2-8 Installing the CDA Converter Library on OpenVMS Installing the CDA Converter Library on OpenVMS 2.1 The Installation Procedure ________________________Note ________________________ 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. _____________________________________________________ 2.2 Error Recovery If errors occur during the installation itself or when the Installation Verification Procedure (IVP) is running, VMSINSTAL displays failure messages. If the installation fails, you see the following message: %VMSINSTAL-E-INSFAIL, The installation of CDACVTLIB V2.2 has failed. If the IVP fails, you see these messages: The CVTLIB V2.2 Installation Verification Procedure failed. %VMSINSTAL-E-IVPFAIL, The IVP for CDACVTLIB V2.2 has failed. Errors can occur during the installation if any of the following conditions exist: o The operating system version is incorrect. o A prerequisite software version is incorrect. o Quotas necessary for successful installation are insufficient. o System parameter values for successful installation are insufficient. o The OpenVMS help library is currently in use. o The product license has not been registered and loaded. For descriptions of the error messages generated by these conditions, see the OpenVMS documentation on system messages, recovery procedures, and software installation. If you are notified that any of these conditions exist, you should take the appropriate action as described in the Installing the CDA Converter Library on OpenVMS 2-9 Installing the CDA Converter Library on OpenVMS 2.2 Error Recovery message. See Section 1.3 for more information about the CDA Converter Library installation requirements. 2-10 Installing the CDA Converter Library on OpenVMS 3 ________________________________________________________________ After Installing the CDA Converter Library on OpenVMS This chapter explains what to do after installing the CDA Converter Library on OpenVMS systems. This chapter contains the following: o After installing the CDA Converter Library o Running the installation verification procedure separately o Setting user account requirements o Determining and reporting problems 3.1 After Installing the CDA Converter Library The following tasks take place after installing the CDA Converter Library: o Running the Installation Verification Procedure separately. o Editing the system startup and shutdown files. o Modifying system parameter settings. o Making the product usable on a VAXcluster. o Setting user account quotas. o Tailoring your system. o Enhancing performance. o Reporting problems. After Installing the CDA Converter Library on OpenVMS 3-1 After Installing the CDA Converter Library on OpenVMS 3.2 Running the Installation Verification Procedure Separately 3.2 Running the Installation Verification Procedure Separately The Installation Verification Procedure (IVP) is usually run during installation. If you want to run the IVP separately to ensure the integrity of installed files in the event of system problems occurring, execute the following command procedure: $ @SYS$COMMON:[SYS$TEST.CDACVTLIB]CDACVTLIB$IVP ________________________Note ________________________ If you choose to purge the files, the Installation Verification Procedure (IVP) will not be initiated. See Section 2.1 for more information. _____________________________________________________ 3.3 Setting User Account Requirements To work with the CDA Converter Library, user accounts on your system must have certain privileges and quotas. The following sections contain information about these requirements. 3.3.1 Privileges To use the CDA Converter Library, each account must have at least the TMPMBX and NETMBX privileges. Use the OpenVMS Authorize Utility to determine whether users have the privileges they require. 3.3.2 User Account Quotas You must make sure that the appropriate user accounts have sufficient quotas to be able to use the CDA Converter Library. Table 3-1 summarizes the required user account quotas. 3-2 After Installing the CDA Converter Library on OpenVMS After Installing the CDA Converter Library on OpenVMS 3.3 Setting User Account Requirements Table 3-1 User Account Quotas for Using the CDA Converter __________Library_________________________________________ Account_Quota____Value____________________________________ ASTLM 24 BIOLM 18 BYTLM 18 000 DIOLM 18 ENQLM 30 FILLM 20 PRCLM 0 WSDEF 256[1] [1]The_values_for_WSEXT_and_WSQUO_must_be_equal_to_or_____ greater than the WSDEF value. __________________________________________________________ See Section 1.5 for a description of how to verify and change account quotas. 3.3.3 Installing the CDA Converter Library as a Known Image If you expect the CDA Converter Library to be used extensively on your system, you can reduce the system overhead and memory requirements by installing it as a known image. To install the CDA Converter Library as a shared image on a system that is currently running, use the OpenVMS Install Utility (INSTALL). It is recommended that you install the CDA Converter Library as known on a system that has been rebooted recently because the available space in the global page table is less likely to be fragmented. To install the CDA Converter Library as a known image, first, determine the number of available global pages and global sections on your system. See Section 1.3.4.2 for information about how to verify and modify the number of global pages and global sections. Table 1-3 contains the guidelines for setting these parameters. After Installing the CDA Converter Library on OpenVMS 3-3 After Installing the CDA Converter Library on OpenVMS 3.3 Setting User Account Requirements Once you have reset the system parameter values, invoke the OpenVMS Install Utility from a privileged account and then install the CDA Converter Library as a known image: $ INSTALL INSTALL> ADD/LOG SYS$SHARE:DDIF$READ_AFS.EXE /OPEN /SHARED INSTALL> ADD/LOG SYS$SHARE:DDIF$WRITE_AFS.EXE /OPEN /SHARED INSTALL> EXIT See Appendix B for a complete list of all the files installed when you install the CDA Converter Library. When you install the CDA Converter Library as a known image you need to increase the global pages and global sections parameters. See Section 1.3.4 for information about changing these parameters. 3.4 Determining and Reporting Problems If you encounter a problem while using the CDA Converter Library, report it to Digital. Depending on the nature of the problem and the type of support you have, you can take one of the following actions: o Call Digital if your software contract or warranty agreement entitles you to telephone support. o Submit a Software Performance Report (SPR). o Fill out and submit a Reader's Comments form if the problem has to do with the CDA Converter Library documentation. There are Reader's Comments forms at the back of each manual. Use the form from the manual in which you found the error. Include the section and page number. Review the Software Product Description (SPD) and Warranty Addendum for an explanation of warranty. If you encounter a problem during the warranty period, report the problem as indicated above or follow alternate instructions provided by Digital for reporting SPD nonconformance problems. 3-4 After Installing the CDA Converter Library on OpenVMS A ________________________________________________________________ Sample Installation on OpenVMS This section contains a sample installation of the CDA Converter Library on OpenVMS systems. This sample was run on a system that had no previous version of the CDA Converter Library installed. Depending on which layered products you have on your system, you might see additional messages and questions when you perform your installation. The sample installation assumes that DECnet has been shut down, that no users are logged on to your system, and that OPTIONS N is specified to print the release notes. The Installation Verification Procedure (IVP) runs at the end of the installation. Example A-1 Sample CDA Converter Library Installation Procedure @sys$update:vmsinstal VAX/VMS Software Product Installation Procedure V5.5-2 It is 14-DEC-1993 at 22:02. Enter a question mark (?) at any time for help. %VMSINSTAL-W-ACTIVE, The following processes are still active: _FTA78: VTA21 _RTA19: * Do you want to continue anyway [NO]? y * Are you satisfied with the backup of your system disk [YES]? (continued on next page) Sample Installation on OpenVMS A-1 Sample Installation on OpenVMS Example A-1 (Cont.) Sample CDA Converter Library Installation Procedure * Where will the distribution volumes be mounted: KITS$: Enter the products to be processed from the first distribution volume set. * Products: CDACVTLIB * Enter installation options you wish to use (none): The following products will be processed: CDACVTLIB V2.2 Beginning installation of CDACVTLIB V2.2 at 22:04 %VMSINSTAL-I-RESTORE, Restoring product save set A ... %VMSINSTAL-I-RELMOVED, Product's release notes have been moved to SYS$HELP. Note: None of the converter images are installed using the VMS Install Utility (INSTALL). If any converter fails the IVP ensure that converter is not INSTALLED by typing the Open VMScommand $INSTALL LIST CONVERTER-NAME If any converter is INSTALLED it is suggested that it be removed by typing the OpenVMS command $INSTALL DELETE CONVERTER-NAME before this installation. See the installation guide for more information. When using DECwindows Mail for versions up to and including DECwindows Motif V1.0, you may experience problems when extracting messages. This is addressed in later releases of DECwindows Mail. The problem may be eliminated by deleting or renaming converters such that less than 25 CDA converters are in SYS$SHARE. * Do you want to purge files replaced by this installation [YES]? * Do you want to run the IVP after the installation [YES]? To complete the installation on a VAX 6000 series system will take approximately: 10 minutes to install 7 minutes to run the IVP (continued on next page) A-2 Sample Installation on OpenVMS Sample Installation on OpenVMS Example A-1 (Cont.) Sample CDA Converter Library Installation Procedure All required questions have been asked. You can terminate the installation procedure at this time. * Do you want to continue the installation [YES]? %CDACVTLIB-I-MOTIF, DECwindows Motif is installed on this system -CDACVTLIB-I-MOTIF, Image converters for DEC Image Application -CDACVTLIB-I-MOTIF, Services V3.0 and later will be installed. Converters involved are: -CDACVTLIB-I-MOTIF, TIFF,MACPAINT Installing the CDA Run Times CDA Base Services of equal or newer version already installed. CDA-RT installation will not be performed. %VMSINSTAL-W-NOFILE, File GKSRTLIB.EXE does not exist. %CDACVTLIB-NOGKSRT-W, GKS Runtime not found on this system -CDACVTLIB-NOGKSRT-W, This is a prerequisite for the GRAPHICS converter Product: CDA-CONVERTER-LIBRARY Producer: DEC Version: V2.2 Release Date: 1-SEP-1993 * Does this product have an authorization key registered and loaded? y WRHS$:[I14Y.PRODUCTS.CV22.V22_SSB.KITBLD] %VMSINSTAL-I-RESTORE, Restoring product save set B ... %VMSINSTAL-I-RESTORE, Restoring product save set D ... %VMSINSTAL-I-SYSDIR, This product creates system disk directory VMI$ROOT:[SYSTEST.CDACVTLIB]. %CREATE-I-EXISTS, VMI$ROOT:[SYSTEST.CDACVTLIB] already exists A messages text file, CDACVTLIB$MESSAGES.TXT, is installed. in SYS$HELP. Example Options files for converters are moved to SYS$EXAMPLES: Adding CDA_CONVERTERS help topic to the VMS HELP facility %VMSINSTAL-I-MOVEFILES, Files will now be moved to their target directories... COPYRIGHT (c) 1993 BY DIGITAL EQUIPMENT CORPORATION, MAYNARD, MASSACHUSETTS. ALL RIGHTS RESERVED. Beginning the CDA Converter Library V2.2 Installation Verification Procedure (continued on next page) Sample Installation on OpenVMS A-3 Sample Installation on OpenVMS Example A-1 (Cont.) Sample CDA Converter Library Installation Procedure Starting verification of the WORDP front end Starting verification of the RTF front end Starting verification of the RNO front end Starting verification of the WORD5 front end Starting verification of the GIF front end Starting verification of the TIFF front end Starting verification of the WK1 front end %TCV-I-STARTCONVERSION, WK1 Front End V2.2 starting at 14-December-1993 22:12:01 %TCV-I-ENDCONVERSION, WK1 Front End V2.2 ending at 14-December-1993 22:12:02 Starting verification of the WK3 front end %TCV-I-STARTCONVERSION, WK3 Front End V2.2 starting at 14-December-1993 22:12:03 %TCV-I-ENDCONVERSION, WK3 Front End V2.2 ending at 14-December-1993 22:12:04 Starting verification of the ASCII_TABULAR front end %TCV-I-STARTCONVERSION, ASCII Tabular front end V2.2 starting at 14-December-1993 22:12:05 %TCV-I-ENDCONVERSION, ASCII Tabular front end V2.2 ending at 14-December-1993 22:12:06 Starting verification of the ASCII_FIELD front end %TCV-I-STARTCONVERSION, ASCII Field front end V2.2 starting at 14-December-1993 22:12:07 (continued on next page) A-4 Sample Installation on OpenVMS Sample Installation on OpenVMS Example A-1 (Cont.) Sample CDA Converter Library Installation Procedure %TCV-I-ENDCONVERSION, ASCII Field front end V2.2 ending at 14-December-1993 22:12:08 Starting verification of the CALCGRD front end %TCV-I-STARTCONVERSION, CALCGRD front end V2.2 starting at 14-December-1993 22:12:09 %TCFB-W-CGRDFE_EVALORD, GLOBAL MATH EVALUATION-ORDER setting lost %TCFB-W-CGRDFE_TABORD, GLOBAL TAB-ORDER setting lost %TCFB-W-CGRDFE_SCRLOST, GLOBAL MODE SCREEN setting lost %TCFB-W-CGRDFE_ZEROBLK, FORMAT BOX (ZERO-IF-BLANK/UNDEFINED-IF-BLANK) settings are lost for every box in the CALCGRD i %TCV-I-ENDCONVERSION, CALCGRD front end V2.2 ending at 14-December-1993 22:12:10 Starting verification of the DIF front end %TCV-I-STARTCONVERSION, DIF front end V2.2 starting at 14-December-1993 22:12:11 %TCV-I-ENDCONVERSION, DIF front end V2.2 ending at 14-December-1993 22:12:12 Starting verification of the SGML front end %SGML-I-CALLOPEN, CDACVTLIB$TEST:CVT$IVP_SGML.SGML opened %SGML-I-CALLSUCCESS, Document successfully parsed Starting verification of the AFS front end %AFS-I-NOSTRUCT, Line 1 : Structure information either not available or missing -- full validation will not be perform Starting verification of the DX front end %DXF-S-LOG_CREATED, The log file SYS$COMMON:[SYSTEST.CDACVTLIB]CVT$IVP_DX.LOG;2 has been created. (continued on next page) Sample Installation on OpenVMS A-5 Sample Installation on OpenVMS Example A-1 (Cont.) Sample CDA Converter Library Installation Procedure Starting verification of the MACPAINT front end MACP-E-CFAIL, Error creating log file Starting verification of the MACWRITE front end Starting verification of the PICT front end Starting verification of the ROFF front end Starting verification of the WPL front end %CNV-S-LOG-CREATED, The log file SYS$COMMON:[SYSTEST.CDACVTLIB]CVT$IVP_WPL.LOG;1 has been created. Starting verification of the CGM front end Starting verification of the DCA front end Starting verification of the WORDP back end Starting verification of the RTF back end Starting verification of the WORD5 back end Starting verification of the SGML back end %SDC-I-DIFMINVER, DDIF document minor version (4 ) differs from minor version on which the converter is based (0 ) %SGML-I-CALLOPEN, CDACVTLIB$TEST:CVT$IVP_RES_SGML.SGML opened %SGML-I-PROOPENTDEF, line 49: Opening external definition document "SYS$COMMON:[SYSTEST.CDACVTLIB]CVT$IVP_RES_SGML.DTD" %SGML-I-PROCLSTDEF, line (49)87: Closing external definition document "SYS$COMMON:[SYSTEST.CDACVTLIB]CVT$IVP_RES_SGML.DTD %SGML-I-CALLSUCCESS, Document successfully parsed Starting verification of the AFS back end (continued on next page) A-6 Sample Installation on OpenVMS Sample Installation on OpenVMS Example A-1 (Cont.) Sample CDA Converter Library Installation Procedure Starting verification of the DX back end %DXB-I-ERROR-LOG, Errors are logged in SYS$COMMON:[SYSTEST.CDACVTLIB]CVT$IVP_RES_DX.LOG;2. Starting verification of the MACPAINT back end MACP-E-CFAIL, Error creating log file Starting verification of the MACWRITE back end Starting verification of the TIFF back end Starting verification of the WK1 back end %TCV-I-STARTCONVERSION, WK1 back end V2.2 starting at 14-December-1993 22:13:30 %TCV-I-ENDCONVERSION, WK1 back end V2.2 ending at 14-December-1993 22:13:31 Starting verification of the WK3 back end %TCV-I-STARTCONVERSION, WK3 back end V2.2 starting at 14-December-1993 22:13:33 %TCBB-W-WK3BE_SCLINTFLT, Scaled integer at (column 1, row 2) converted to float in Lotus 1-2-3 %TCV-I-ENDCONVERSION, WK3 back end V2.2 ending at 14-December-1993 22:13:34 Starting verification of the WPL back end %CNV-S-LOG-CREATED, The log file SYS$COMMON:[SYSTEST.CDACVTLIB]CVT$IVP_RES_WPL.LOG;1 has been created. Starting verification of the CGM back end Starting verification of the ASCII_TABULAR back end %TCV-I-STARTCONVERSION, ASCII Tabular Back End V2.2 starting at 14-December-1993 22:16:22 %TCV-I-ENDCONVERSION, ASCII Tabular Back End V2.2 ending at 14-December-1993 22:16:23 Starting verification of the PICT back end PBE-W-ERRLOG Conversion messages are logged in CDACVTLIB$TEST:CVT$IVP_RES_PICT.LOG Starting verification of the DCA back end (continued on next page) Sample Installation on OpenVMS A-7 Sample Installation on OpenVMS Example A-1 (Cont.) Sample CDA Converter Library Installation Procedure CDA Converter Library V2.2 IVP completed successfully. Installation of CDACVTLIB V2.2 completed at 22:16 Enter the products to be processed from the next distribution volume set. * Products: VMSINSTAL procedure done at 22:17 A-8 Sample Installation on OpenVMS B ________________________________________________________________ Files Installed on OpenVMS The CDA Converter Library installation procedure installs a number of files on your system and defines some logical names. Section B.1 lists the files installed when the CDA Converter Library is installed. Section B.2 lists the files that are installed on your system when the CDA Run-Time Services sample options files are installed. B.1 File Names Created when the CDA Converter Library is Installed. Table B-1 contains the names of all files and directories created on your system when the CDA Converter Library is installed. Table_B-1_CDA_Converter_Library_Directories_and_File_Names______ Directory________File____________________________Description____ SYS$COMMON: CDACVTLIB022.RELEASE_NOTES CDA Converter [SYSHLP] Library release notes CDACVTLIB$MESSAGES.TXT CDA Converter Library Conversion Messages Guide (text file) (continued on next page) Files Installed on OpenVMS B-1 Files Installed on OpenVMS B.1 File Names Created when the CDA Converter Library is Installed. Table B-1 (Cont.) CDA Converter Library Directories and File __________________Names_________________________________________ Directory________File____________________________Description____ SYS$COMMON: AFS$CVT$IVP_AFS.DDIF Installation [SYSTEST.CDACVTLIB] Verification Procedure (IVP) files CVT$IVP_AFS.AFS CVT$IVP_ASCII_FIELD.ASCII_ FIELD CVT$IVP_ASCII_FIELD.DEF CVT$IVP_ASCII_TABULAR.ASCII_ TABULAR CVT$IVP_CALCGRD.CALCGRD CVT$IVP_CGM.CGM CVT$IVP_DCA.DCA CVT$IVP_DIF.DIF CVT$IVP_DX.DX CVT$IVP_GRAPHICS.GRAPHICS CVT$IVP_DIF.GIF CVT$IVP_MACPAINT.MACPAINT CVT$IVP_MACWRITE.MACWRITE CVT$IVP_PICT.PICT CVT$IVP_RNO.RNO CVT$IVP_ROFF.ROFF CVT$IVP_RTF.RTF CVT$IVP_SGML.SGML CVT$IVP_TIFF.TIFF CVT$IVP_WK1.WK1 CVT$IVP_WK3.WK3 CVT$IVP_WORD5.WORD5 CVT$IVP_WORDP.WORDP (continued on next page) B-2 Files Installed on OpenVMS Files Installed on OpenVMS B.1 File Names Created when the CDA Converter Library is Installed. Table B-1 (Cont.) CDA Converter Library Directories and File __________________Names_________________________________________ Directory________File____________________________Description____ CVT$IVP_WPL.WPL CDACVTLIB$IVP.COM IVP command files CDACVTLIB$CONV_NAMES.COM SYS$COMMON: CONV_MSG.DAT WPL message [SYSMSG] file SYS$COMMON: DX_COUR.DOC_STYLE Style files [CDA$LIBRARY] DX_GUIDE.DOC_STYLE DX_HELV.DOC_STYLE DX_SYCO_JUSTIFIED_TIMES_ 12PT.DOC_STYLE DX_SYCO_LEFT_COURIER_10PT.DOC_ STYLE DX_TIMES.DOC_STYLE SYS$COMMON: DDIF$READ_ASCII_FIELD.DEF Sample [SYSHLP.EXAMPLES] definition files DDIF$READ_ASCII_FIELD.FIELD DDIF$READ_ASCII_TABULAR.DEF DDIF$READ_ASCII_TABULAR.TAB SYS$COMMON: EXAMPLE_READ_AFS.CDA$OPTIONS Sample options [SYSHLP.EXAMPLES] files EXAMPLE_ASCII_TABULAR.CDA$OPTIONS EXAMPLE_READ_ASCII_FIELD.CDA$OPTIONS EXAMPLE_READ_ASCII_TABULAR.CDA$OPTIONS (continued on next page) Files Installed on OpenVMS B-3 Files Installed on OpenVMS B.1 File Names Created when the CDA Converter Library is Installed. Table B-1 (Cont.) CDA Converter Library Directories and File __________________Names_________________________________________ Directory________File____________________________Description____ EXAMPLE_READ_CALCGRD.CDA$OPTIONS EXAMPLE_READ_CGM.CDA$OPTIONS EXAMPLE_READ_DCA.CDA$OPTIONS EXAMPLE_READ_DIF.CDA$OPTIONS EXAMPLE_READ_DX.CDA$OPTIONS EXAMPLE_READ_GIF.CDA$OPTIONS EXAMPLE_READ_MACPAINT.CDA$OPTIONS EXAMPLE_READ_MACWRITE.CDA$OPTIONS EXAMPLE_READ_PICT.CDA$OPTIONS EXAMPLE_READ_RNO.CDA$OPTIONS EXAMPLE_READ_ROFF.CDA$OPTIONS EXAMPLE_READ_ROFF_MAN.CDA$OPTIONS EXAMPLE_READ_ROFF_ME.CDA$OPTIONS EXAMPLE_READ_ROFF_MM.CDA$OPTIONS EXAMPLE_READ_ROFF_MS.CDA$OPTIONS EXAMPLE_READ_ROFF_MU.CDA$OPTIONS EXAMPLE_READ_RTF.CDA$OPTIONS EXAMPLE_READ_SGML.CDA$OPTIONS EXAMPLE_READ_TIFF.CDA$OPTIONS EXAMPLE_READ_WK1.CDA$OPTIONS EXAMPLE_READ_WK3.CDA$OPTIONS EXAMPLE_READ_WORD5.CDA$OPTIONS EXAMPLE_READ_WORD5_FONTMAP.CDA$OPTIONS EXAMPLE_READ_WORDP.CDA$OPTIONS EXAMPLE_READ_WPL.CDA$OPTIONS EXAMPLE_WRITE_AFS.CDA$OPTIONS EXAMPLE_WRITE_ASCII_ TABULAR.CDA$OPTIONS (continued on next page) B-4 Files Installed on OpenVMS Files Installed on OpenVMS B.1 File Names Created when the CDA Converter Library is Installed. Table B-1 (Cont.) CDA Converter Library Directories and File __________________Names_________________________________________ Directory________File____________________________Description____ EXAMPLE_WRITE_CGM.CDA$OPTIONS EXAMPLE_WRITE_DCA.CDA$OPTIONS EXAMPLE_WRITE_DX.CDA$OPTIONS EXAMPLE_WRITE_GRAPHICS.CDA$OPTIONS EXAMPLE_WRITE_MACPAINT.CDA$OPTIONS EXAMPLE_WRITE_MACWRITE.CDA$OPTIONS EXAMPLE_WRITE_PICT.CDA$OPTIONS EXAMPLE_WRITE_RTF.CDA$OPTIONS EXAMPLE_WRITE_SGML.CDA$OPTIONS EXAMPLE_WRITE_TIFF.CDA$OPTIONS EXAMPLE_WRITE_WK1.CDA$OPTIONS EXAMPLE_WRITE_WK3.CDA$OPTIONS EXAMPLE_WRITE_WORD5.CDA$OPTIONS EXAMPLE_WRITE_WORDP.CDA$OPTIONS EXAMPLE_WRITE_WPL.CDA$OPTIONS SYS$COMMON: ROFF_MAN.MAP roff mapping [SYSLIB] files ROFF_ME.MAP ROFF_MM.MAP ROFF_MS.MAP ROFF_MU.MAP SYS$COMMON: ROFF_MAN.DOC_STYLE roff style [CDA$LIBRARY] files ROFF_ME.DOC_STYLE ROFF_MM.DOC_STYLE ROFF_MS.DOC_STYLE (continued on next page) Files Installed on OpenVMS B-5 Files Installed on OpenVMS B.1 File Names Created when the CDA Converter Library is Installed. Table B-1 (Cont.) CDA Converter Library Directories and File __________________Names_________________________________________ Directory________File____________________________Description____ ROFF_MU8.DOC_STYLE SDC$SAMPLE.DOC_STYLE SYS$COMMON: DDIF$READ_AFS.EXE Converter [SYSLIB] executable files DDIF$READ_CGM.EXE DDIF$READ_DCA.EXE DDIF$READ_DX.EXE DDIF$READ_GIF.EXE DDIF$READ_MACPAINT.EXE DDIF$READ_MACWRITE.EXE DDIF$READ_PICT.EXE DDIF$READ_RNO.EXE DDIF$READ_ROFF.EXE DDIF$READ_RTF.EXE DDIF$READ_SGML.EXE DDIF$READ_TIFF.EXE DDIF$READ_WORD5.EXE DDIF$READ_WORDP.EXE DDIF$READ_WPL.EXE DDIF$WRITE_AFS.EXE DDIF$WRITE_CGM.EXE DDIF$WRITE_DCA.EXE DDIF$WRITE_DX.EXE DDIF$WRITE_GRAPHICS.EXE DDIF$WRITE_MACPAINT.EXE DDIF$WRITE_MACWRITE.EXE (continued on next page) B-6 Files Installed on OpenVMS Files Installed on OpenVMS B.1 File Names Created when the CDA Converter Library is Installed. Table B-1 (Cont.) CDA Converter Library Directories and File __________________Names_________________________________________ Directory________File____________________________Description____ DDIF$WRITE_PICT.EXE DDIF$WRITE_RTF.EXE DDIF$WRITE_SGML.EXE DDIF$WRITE_TIFF.EXE DDIF$WRITE_WORD5.EXE DDIF$WRITE_WORDP.EXE DDIF$WRITE_WPL.EXE SGML$PARSE.EXE DTIF$READ_ASCII_FIELD.EXE DTIF$READ_ASCII_TABULAR.EXE DTIF$READ_CALCGRD.EXE DTIF$READ_DIF.EXE DTIF$READ_WK1.EXE DTIF$READ_WK3.EXE DTIF$WRITE_WK1.EXE DTIF$WRITE_ASCII_TABULAR.EXE DTIF$WRITE_WK3.EXE SYS$COMMON: DDIF$READ_CGM_MESSAGES.EXE Executable [SYSMSG] messages files _________________DDIF$WRITE_CGM_MESSAGES.EXE____________________ B.2 Sample Options File Names Created when the CDA Run-Time Services is Installed. Table B-2 contains the names of all the sample options files and directories that are created on your system when the CDA Run-Time Services is installed. ________________________Note ________________________ For more information about the CDA Run-Time Services installation requirements, see the CDA Run-Time Files Installed on OpenVMS B-7 Files Installed on OpenVMS B.2 Sample Options File Names Created when the CDA Run-Time Services is Installed. Installation Guide for VMS which is available from the following location: SYS$HELP:CDART010_INS_GUIDE.TXT This manual contains useful information about the CDA base software files updated with this kit. _____________________________________________________ Table B-2 Directories and File Names for CDA Run-Time Services __________Sample_Options________________________________________ Directory________File____________________________Description____ SYS$COMMON: EXAMPLE_DTIF_TO_DDIF.CDA$OPTIONSSample options [SYSHLP.EXAMPLES] files EXAMPLE_READ_DDIF.CDA$OPTIONS EXAMPLE_READ_DTIF.CDA$OPTIONS EXAMPLE_READ_TEXT.CDA$OPTIONS EXAMPLE_WRITE_ANALYSIS.CDA$OPTIONS EXAMPLE_WRITE_DDIF.CDA$OPTIONS EXAMPLE_WRITE_DTIF.CDA$OPTIONS EXAMPLE_WRITE_PS.CDA$OPTIONS _________________EXAMPLE_WRITE_TEXT.CDA$OPTIONS_________________ B-8 Files Installed on OpenVMS ________________________________________________________________ Index A__________________________ E__________________________ Accessing the release notes Error recovery on OpenVMS systems, 2-2 on OpenVMS systems, 2-9 After installing the CDA Converter Library F__________________________ on OpenVMS systems, 3-1 Files installed on your to 3-4 system ALL-IN-1 on OpenVMS systems, B-1 image requirements, 1-11 restrictions, 1-11 to B-8 ___________________________ I__________________________ Backing up your system disk Image requirements on OpenVMS systems, 1-13 ALL-IN-1, 1-11 Installation procedure C__________________________ on OpenVMS systems, 2-1 CDA Converter Library Installation procedure requirements requirements on OpenVMS systems, 1-14 on OpenVMS systems, 1-4 CDAPAT011 Installation Verification ALL-IN-1, 1-11 Procedure Checking system parameters IVP, 2-6 on OpenVMS systems, 1-7 Installing the CDA Converter Library D on OpenVMS systems, 2-1 ___________________________ to 2-10 Determining and reporting Installing the CDA problems Converter Library as on OpenVMS systems, 3-4 a known image on OpenVMS systems, 3-3 Index-1 IVP Running the installation Installation Verification verification procedure Procedure, 2-6 separately on OpenVMS systems, 3-2 P__________________________ Preparing to install the S__________________________ CDA Converter Library Sample installation on OpenVMS systems, 1-1 on OpenVMS systems, A-1 Prerequisite and optional to A-8 software system disk on OpenVMS systems, 1-2 backing up Privilege and disk space on OpenVMS systems, on OpenVMS systems, 1-5 1-13 Privileges System parameters on OpenVMS systems, 3-2 on OpenVMS systems, 1-6 Problems determining and reporting U__________________________ on OpenVMS systems, User account quotas 3-4 on OpenVMS systems, 3-2 Process account quotas User account requirements on OpenVMS systems, 1-11 on OpenVMS systems, 3-2 R__________________________ V__________________________ Release notes VMSINSTAL requirements accessing on OpenVMS on OpenVMS systems, 1-13 systems, 2-2 Index-2