_____________________________________________________ DECpage Installation Guide AA-W602F-TE This manual explains how to install and maintain DECpage. Revision/Update Information: This is a revised manual. Operating System: VMS Version 5.1 or higher Software Version: DECpage Version 3.1 digital equipment corporation maynard, massachusetts ii _____________________________________________________ December 1989 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. The software described in this document is furnished under a license and may be used or copied only in accordance with the terms of such license. No responsibility is assumed for the use or reliability of software on equipment that is not supplied by Digital Equipment Corporation or its affiliated companies. Restricted Rights: Use, duplication, or disclosure by the U.S. Government is subject to restrictions as set forth in subparagraph (c) (1) (ii) of the Rights in Technical Data and Computer Software clause at DFARS 252.227-7013. © Digital Equipment Corporation 1989. All Rights Reserved. Printed in U.S.A. The postpaid Reader's Comments forms at the end of this document request your critical evaluation to assist in preparing future documentation. The following are trademarks of Digital Equipment Corporation: ALL-IN-1 DECwindows VAXstation DEC PDP VMS DECnet ReGIS VT DECpage UNIBUS WPS-PLUS DECspell VAX DECUS VAXcluster DIGITAL PostScript[R] is a registered trademark of Adobe Systems Incorporated. Spelling Corrector licensed from Houghton Mifflin Company. English Copyright © 1987, 1985 by Houghton Mifflin Company, German © 1985 by Houghton Mifflin Company. German Spelling Database © 1985 Langenscheidt KG. The German spelling verification software contains unpublished copyrighted materials owned by Houghton Mifflin Company and Langenscheidt KG, licenses for use solely in Digital software. All rights reserved. U.S. Pat. Nos. 4,580,241; 4,730,269; and 4,771,401; Canadian Pat. No. 1,203,916. Reproduction or disassembly of embodied computer programs or algorithms prohibited. English based upon The American Heritage Dictionary. Licensed to Digital Equipment Corporation, Maynard Massachusetts Copyright © Studio Advertising Art 1988. All rights reserved. ZK5360 ________________________________________________________________ Contents About This Guide......................................... vii 1 Preparing to Install DECpage 1.1 Required Operating System Components............ 1-1 1.2 Prerequisite Software........................... 1-2 1.3 Optional Software............................... 1-3 1.4 Prerequisite Hardware........................... 1-3 1.5 License Registration............................ 1-4 1.6 Determining Saveset Names....................... 1-4 1.7 Performing an Update Installation............... 1-5 1.7.1Setting the System Protection ................ 1-5 1.7.2Saving Information Data Files ................ 1-5 1.8 Installing Laser Printers....................... 1-6 1.8.1Installing Non-PostScript Laser Printers ..... 1-7 1.9 VAXcluster Configurations....................... 1-8 1.9.1VAXcluster Configuration Types ............... 1-8 1.10 Installation Procedure Requirements............. 1-9 1.10.Time ......................................... 1-9 1.10.Privileges ................................... 1-9 1.10.Disk Space ................................... 1-9 iii 1.10.System Parameters ............................ 1-10 1.10.4.1Checking System Parameter Values........ 1-11 1.10.4.2Calculating the Value for GBLPAGES...... 1-11 1.10.4.3Changing System Parameter Values with AUTOGEN................................. 1-13 1.10.Process Account Quotas ....................... 1-14 1.10.VMSINSTAL Requirements ....................... 1-15 1.10.Backing Up Your System Disk .................. 1-16 2 Installing DECpage 2.1 General Information............................. 2-1 2.1.1Accessing the Online Release Notes ........... 2-1 2.1.2Running the Installation Verification Procedure.................................... 2-2 2.1.3Aborting the Installation .................... 2-2 2.2 The Installation Procedure...................... 2-2 2.2.1Invoking VMSINSTAL ........................... 2-2 2.2.2Answering Installation Questions ............. 2-4 2.2.3Checking Informational Messages .............. 2-11 2.2.4Running the Installation Verification Procedure.................................... 2-11 2.2.5Completing the Installation Procedure ........ 2-11 2.3 Error Recovery.................................. 2-12 3 After Installing DECpage 3.1 Replacing Information Data Files................ 3-2 3.2 Deleting Obsolete DECpage Command Procedures.... 3-2 3.3 Integrating DECpage into WPS-PLUS or ALL-IN-1... 3-3 3.4 Creating a DECPAGE Account on ALL-IN-1.......... 3-4 3.5 Associating DECpage Print Queues with VMS Print Queues.......................................... 3-5 3.6 Associating Additional DECpage Batch Queues with VMS Batch Queues................................ 3-7 3.6.1Remote DECpage Jobs .......................... 3-8 iv 3.7 Prerequisites for Remote Printing and Batch Processing...................................... 3-9 3.8 Modifying the System Startup Procedure.......... 3-10 3.9 Modifying Style Values.......................... 3-10 3.10 Replacing Canned Styles......................... 3-11 3.11 Installing DECpage on a VAXcluster System....... 3-12 3.12 Installing Multiple-Language Versions of DECpage......................................... 3-13 3.12.Establishing a Multiple-Language Environment.................................. 3-15 3.12.Resetting the User Default DECpage Language .. 3-16 3.12.Changing the Style Language for Batch Jobs ... 3-16 3.13 Reinstalling DECpage............................ 3-16 3.14 Modifying DECpage Batch Queue Priorities........ 3-17 3.15 Adding Logos to the System...................... 3-18 3.16 Converting LN03 Logos to PostScript............. 3-19 3.17 Upgrading the DECpage Font Package.............. 3-19 3.18 Making Modifications for VAX GKS Graphics....... 3-20 3.19 Changing Hyphenation Exception Dictionaries..... 3-20 3.20 Modifying the Login File........................ 3-21 3.20.Modifying the Login File for Batch Mode ...... 3-21 3.20.Redefining the DECPAGE$GRAPHIC Logical ....... 3-21 3.21 Running the Installation Verification Procedure Separately...................................... 3-22 3.22 Determining and Reporting Problems.............. 3-23 A Sample Installation B Files and Logical Names Installed on Your System B.1 File Names...................................... B-1 B.2 Logical Names................................... B-41 v C Error Messages During Installation Index Tables 1 DECpage Documentation............................ viii 1-1 VMS Classes Required............................. 1-2 1-2 DECpage Saveset Names............................ 1-5 1-3 Information Data Files to Be Saved............... 1-6 1-4 Disk Space for Installation on System Disk....... 1-10 1-5 Disk Space for Installation on Alternate Disk.... 1-10 1-6 Minimum Required System Parameter Value.......... 1-11 1-7 Process Account Quotas for the Installing Account.......................................... 1-14 3-1 Determining Language Values...................... 3-15 3-2 Batch Queue Default Characteristics.............. 3-17 B-1 DECpage Files Installed.......................... B-1 vi ________________________________________________________________ About This Guide This manual describes how to install and maintain DECpage. You should read the entire guide before you start the installation. Audience This manual is written for VMS system managers or others responsible for installing and maintaining the DECpage software. Prerequisites To install DECpage, you must have access to a privileged account and be familiar with the VMS installation procedure (VMSINSTAL). You should also be familiar with VMS system management. vii Structure of This Manual This manual is organized as follows: Chapter 1 Describes the preparations you must complete before you can install DECpage Version 3.1. Chapter 2 Describes the DECpage Version 3.1 installation procedure. Chapter 3 Describes the required and optional tasks to be completed after you install DECpage Version 3.1. Appendix A Contains a sample DECpage Version 3.1 installation. Appendix B Lists the files and logical names installed on the system during the DECpage installation. Appendix C Explains error messages that can be generated during the installation procedure. Related Documentation Table 1 lists the documentation for DECpage and indicates the software version for which the manuals were most recently revised. Table 1 DECpage Documentation _____________________________________________________________ Title________________________________Version_________________ DECpage Getting Started 3.0 DECpage User's Guide 3.0 (continued on next page) viii Table 1 (Cont.) DECpage Documentation _____________________________________________________________ Title________________________________Version_________________ DECpage Style Designer's Guide 3.0 DECpage Style Samples 3.0 DECpage Quick Lookup 3.0 DECpage Express 3.1 DECpage Version 3.1 Statement of 3.1 Supported_Versions___________________________________________ DECpage Version 3.1 comes with online release notes. See Section 2.1.1 for information about how to access them. For support information, refer to the Software Support Addendum in the DECpage Version 3.1 Software Product Description (SPD). For more information about the License Management Facility (LMF) or VMSINSTAL, see the VMS documentation set. For more information about using AUTOGEN, see the Extended VMS System Management documentation subkit. Conventions This manual uses the following conventions: DECpage Means the DECpage[TM] software. ALL-IN-1 Means the ALL-IN-1[TM] software. WPS-PLUS Means the WPS-PLUS[TM] software. ix Enter Means type your response and then press a terminator key, such as RETURN. $ Means the system prompt. It indicates that the VMS command interpreter is ready for command input. . Means information not directly related to the . example has been deleted. . Indicates that you press the CTRL key and another key. Tells you to press the GOLD key, labeled PF1 on some keypads, and then a function key. Tells you to press the RETURN key. Dot Indicates text that appears on your screen. matrix type Red text Indicates text you type in examples. or Bold dot matrix type x 1 ________________________________________________________________ Preparing to Install DECpage This chapter discusses the preparations and requirements necessary for installing DECpage. Your bill of materials (BOM) and indented bills report (BIL) specify 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 parts are missing, contact your Digital representative. DECpage provides online release notes. Digital strongly recommends that you read the release notes before proceeding with the installation. For information on accessing the online release notes, see Section 2.1.1. 1.1 Required Operating System Components The VMS operating system comes with a variety of support options, or classes, which include such features as support for VAXclusters, networking, and programming. To use DECpage Version 3.1, your system should be running a version of VMS that includes the classes listed in Table 1-1. Preparing to Install DECpage 1-1 Table 1-1 VMS Classes Required _____________________________________________________________ Class___________________________Abbreviation_________________ Base BASE Cluster Support CLUS Device Drivers DRVR System Management Files MNGR Network Support NET Programming Support PROG Secure User's Environment USER Utilities_______________________UTIL_________________________ 1.2 Prerequisite Software The following software must be installed on your system prior to the DECpage installation: _ A valid VMS operating system configuration running VMS Version 5.1 or higher _ WPS-PLUS/VMS or ALL-IN-1 See the DECpage Statement of Supported Versions for the versions supported. If you reinstall or upgrade WPS-PLUS or ALL-IN-1, you must rerun the DECpage post-installation procedures. See Chapter 3 for more information. If you plan to use an LN03 or LN03 PLUS device with DECpage, you must have one of the Version 1.3 font packages installed. If you want to use the entire set of DECpage print styles, you must have the DECpage Complete Office Font Package installed. The DECpage Basic Office Font Package handles a subset of the print styles. (See Section 3.17 for information about upgrading from the Basic to the Complete font package.) The DECpage installation checks for an LN03 font package. If this required software is not installed on your system, the installation terminates. 1-2 Preparing to Install DECpage 1.3 Optional Software This section lists software that can be used together with DECpage. See the System Software Addendum (SSA) for a complete list of compatible products and their required version numbers. The SSA is part of the Software Product Description (SPD). DECpage Version 3.1 is compatible with the following software products: _ VAX GKS _ Version 4.0 on PostScript devices _ Version 3.1 on LN03 and LN03 PLUS devices If you plan to use GKS, it must be installed prior to the DECpage installation. _ DECpage LN03 Upgrade and Complete Office Font Packages Version 1.3 These fonts are used by the LN03 and LNO3 PLUS laser printers and are required only if you plan to use the extended DECpage style set. (The other supported printers do not require additional fonts.) If you plan to use these font packages, they must be installed prior to the DECpage installation. _ VAX DECslide Version 1.3 _ VAX DECgraph Version 1.5 1.4 Prerequisite Hardware You must have a laser printer to run the Installation Verification Procedure (IVP) and use DECpage. DECpage can be used with the following laser printers: _ PrintServer 20 _ PrintServer 40 Plus _ PrintServer 40 _ LN03R ScriptPrinter _ LN03, with two RAM cartridges _ LN03 PLUS, with two RAM cartridges Preparing to Install DECpage 1-3 1.5 License Registration You must register the DECpage license through the VMS License Management Facility (LMF) in accordance with the license agreement signed by your site. The license registration information you need is contained in the Product Authorization Key (PAK) that is shipped with DECpage. The PAK is a paper certificate that contains information about the license you have purchased to run a particular piece of software. During the installation, the system asks if you have registered the DECpage license and loaded the appropriate authorization key. You must register and load your license for DECpage before you start the installation in order to run the Installation Verification Procedure and use the software. To register a license under VMS, first log in to the system manager's account, SYSTEM. You can register a license in one of two ways: _ Invoke the SYS$UPDATE:VMSLICENSE.COM procedure. When it prompts you for information, respond with data from your PAK. _ Issue the LICENSE REGISTER command at the DCL prompt, us- ing the qualifiers that correspond to the PAK information. If you plan to use DECpage 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. See Section 3.11 for DECpage installation instructions for VAXclusters. For complete information on using LMF, see the manual on the License Management Utility in the VMS documentation set. 1.6 Determining Saveset Names To install DECpage, you must know the saveset name of your kit. You can determine a saveset name by checking the label of your media. Table 1-2 lists the media labels and corresponding saveset names of all the DECpage installation kits, as well as the language of each. 1-4 Preparing to Install DECpage Table 1-2 DECpage Saveset Names _____________________________________________________________ Media_Label_________Saveset_Name____Language_________________ DECpage PAGE031 English (American) DECpage/DANSK DECPAGEDANS031 Danish DECpage/DEUTCH DECPAGEGERM031 German DECpage/ENGLISH DECPAGEENGL031 English (British) DECpage/ESPANOL DECPAGESPAN031 Spanish DECpage/FRANCAIS DECPAGEFREN031 French DECpage/ITALIANO DECPAGEITAL031 Italian DECpage/NEDERLANDS DECPAGEDUTC031 Dutch DECpage/SVENSKA_____DECPAGESWED031__Swedish__________________ 1.7 Performing an Update Installation The next two sections describe requirements for update installations. 1.7.1 Setting the System Protection If you are performing an update installation, you must set the system protection to delete (S:D) on the [DECpage] directory. 1.7.2 Saving Information Data Files If you have modified any of the information data files listed in Table 1-3, you must save them before upgrading from Version 3.0 to Version 3.1 of DECpage. (This does not apply to pre-Version 3.0 releases.) You can find these files as follows: _ In OA$DATA_LLV if the existing DECpage software was integrated into ALL-IN-1 Version 2.1 BEV (or LV), or ALL-IN-1 Version 2.2 U.S. (or UK) _ In OA$SITE_DATA_LLV if the existing DECpage software was integrated into ALL-IN-1 Version 2.3 Preparing to Install DECpage 1-5 _ In ddcu:[WPSPLUS.DATA_language] (where language is the language version of WPS-PLUS) if the existing DECpage software was integrated into WPS-PLUS/VMS Version 2.1 (U.S., UK, BEV, or LV) _ In ddcu:[WPSPLUS.SITE_DATA_language] (where language is the language version of WPS-PLUS) if the existing DECpage software was integrated into WPS-PLUS/VMS Version 3.0 Table 1-3 Information Data Files to Be Saved _____________________________________________________________ File_Changed:____By_Using:___________________________________ BATCHQ.DAT Batch Queue Definitions (BQ) option DEVICELST.DAT Device and Queue Association (DQ) option TEMPLST.DAT User-defined styles (UDS) option STYLELST.DAT_____User-defined_styles_(UDS)_option____________ 1.8 Installing Laser Printers You must have a laser printer installed before you can install and use DECpage. There are two groups of printers that can be used with DECpage: _ The LN03R ScriptPrinter, PrintServer 40, PrintServer 40 Plus, and PrintServer 20 You install these printers using the directions in the installation manuals that accompany them. _ The LN03 PLUS and LN03 (with two RAM cartridges) Section 1.8.1 describes how to install these printers and set the necessary printer characteristics. Note Make sure your queue manager has been started before you begin the DECpage installation. You can install additional printers after DECpage is running without reinstalling DECpage. 1-6 Preparing to Install DECpage 1.8.1 Installing Non-PostScript Laser Printers If you are using a non-PostScript laser printer with DECpage, you must modify the printer characteristics at the DCL level before installing DECpage. To make the printer characteristics permanent, you must also make the appropriate changes in the .COM file used to start your print queues. Use the following procedure for the new printer characteris- tics to take effect immediately: 1 Stop the printer queue and associated generic queue, if there is one, as follows: $ STOP/QUEUE/NEXT generic-queue $ STOP/QUEUE/NEXT printer-queue[:] 2 Set the printer to NOSPOOLED with the following command: $ SET DEVICE/NOSPOOLED printer-queue[:] 3 Modify the printer characteristics according to the type of line the printer is attached to, as follows: _ If your non-PostScript printer is attached to a terminal (DZ) line: $ SET TERMINAL/NOAUTOBAUD/NOBROADCAST - _$ /DEVICE_TYPE=LN03/EIGHT_BIT/FORM/LOWERCASE - _$ /PAGE=63/INTERACTIVE/PASTHRU/SPEED=9600/TTSYNC - _$ /WIDTH=511/NOWRAP terminal-name[:] _ If your non-PostScript printer is attached to an LP-11 line: $ SET PRINTER/CR/FF/LOWERCASE/PAGE=63/PASSALL - _$ /PRINTALL/NOTRUNCATE/UNKNOWN/WIDTH=511 - _$ /NOWRAP printer-name[:] 4 Set the printer queue to SPOOLED and reassociate the generic queue, if there is one, as follows: $ SET DEVICE/SPOOLED=generic-queue printer-queue[:] 5 Restart the printer queue and associated generic queue, if there is one, as follows: $ START/QUEUE generic-queue $ START/QUEUE printer-queue[:] Preparing to Install DECpage 1-7 1.9 VAXcluster Configurations You can install DECpage Version 3.1 software on any of three VAXcluster configuration types: Computer Interconnect-only VAXclusters Local Area VAXclusters Mixed-interconnect VAXclusters The section that follows describes the types of clusters, provides installation information specific to each type, and defines the operating environments. For information about installation procedures for VAXcluster configurations, see Section 3.11 in this manual, and the manual on VAXclusters in the VMS documentation set. 1.9.1 VAXcluster Configuration Types You can install DECpage Version 3.1 on the following types of clusters, using the procedure described in Section 3.11: _ Computer Interconnect (CI)-only VAXcluster configuration CI-only clusters use the computer interconnect for interprocessor communication, with the Star Coupler as the common connection point for all cluster nodes. Cluster nodes may be any VAX processors specified in the VAXcluster Software Product Description, or they may be Hierarchical Storage Controllers (HSCs). _ Local Area VAXcluster configurations Local area clusters consist of a boot server (a VAX or MicroVAX containing all the disks from which DECpage is run) connected by Ethernet to a number of satellite nodes. A satellite node is usually a MicroVAX. With local area clusters, install DECpage on the boot server only, using the pre-installation and installation procedures described in Chapters 1 and 2. Do not install DECpage on the satellite nodes. Satellite nodes, which are used by the individual work groups only, use the boot server to access DECpage. You must, however, check the VMS system parameters for each node on which you are going to run DECpage. See Section 1.10.4 for information on VMS system parameters. _ Mixed-interconnect VAXcluster configurations 1-8 Preparing to Install DECpage Mixed-interconnect clusters became available for the first time with VMS Version 5.0. A Mixed-interconnect cluster can include VAX processors, HSCs, and MicroVAX satellite nodes. The procedure for installing DECpage software on a Mixed-interconnect VAXcluster system is the same as that for installing on a Local Area VAXcluster system. 1.10 Installation Procedure Requirements The following sections discuss various requirements for installing DECpage. 1.10.1 Time The installation should take approximately 30 to 60 minutes, depending on your type of media and your system configuration. This does not include time needed for post- installation procedures. For example, installing DECpage on a standalone VAX 11/780 system takes from 40 to 60 minutes, and the Installation Verification Procedure (IVP) takes about 10 minutes. Multiple IVPs will take about 10 minutes per printer selected. 1.10.2 Privileges Install DECpage from the system manager's account, with full privileges. Note that the VMS installation procedure (VMSINSTAL) turns off the BYPASS privilege at the start of the installation. If you are performing an update installation, be sure to set the system protection to delete (S:D) on the DECpage directory. 1.10.3 Disk Space Installing DECpage requires a certain amount of free disk storage space during the installation. Once DECpage is installed, less disk space is required. You can install DECpage on the system disk or on an alternate disk. Table 1-4 gives the disk space requirements if you are installing DECpage on the system disk. Table 1-5 gives the disk space requirements if you are installing DECpage on an alternate disk. Preparing to Install DECpage 1-9 Table 1-4 Disk Space for Installation on System Disk _____________________________________________________________ Disk Where Blocks Blocks During Blocks After Are_Required________Installation________Installation_________ System______________40,000______________35,000_______________ Table 1-5 Disk Space for Installation on Alternate Disk _____________________________________________________________ Disk Where Blocks Blocks During Blocks After Are_Required________Installation________Installation_________ System 40,000[1] 600 Alternate 35,000 35,000 _____________________________________________________________ [1]These blocks are required for saveset expansion. DECpage does not support installations using alternate work directories. _____________________________________________________________ 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.10.4 System Parameters The following sections describe: _ The system parameter value required for the installation _ How to check system parameter values _ How to calculate values for the GBLPAGES system parameter _ How to change the GBLPAGES value, using the VMS AUTOGEN command procedure The Global Pages (GBLPAGES) value is the only value in the system parameter file that you need to check. Table 1-6 lists the minimum required system parameter value for the installation. The table lists only the nonstandard parameter setting. SYSGEN default values are adequate for those settings not listed. Depending on the kinds of programs and applications running at your site, you might need a higher value for this setting. 1-10 Preparing to Install DECpage Note If your system's current SYSGEN parameter is set at a higher value than the one listed in Table 1-6, do not reduce that value. Table 1-6 Minimum Required System Parameter Value _____________________________________________________________ System_Parameter______Value__________________________________ GBLPAGES[1] n + 950 _____________________________________________________________ [1]The value listed represents the number of free global pages required for the installation, not the total number you need to run your system and other software. _____________________________________________________________ 1.10.4.1 Checking System Parameter Values To check the values of your system parameters, invoke the System Generation Utility (SYSGEN) by entering the following command at the DCL prompt: $ RUN SYS$SYSTEM:SYSGEN SYSGEN> At the SYSGEN> prompt, enter the SHOW command to display the value of a system parameter. The value displayed should equal or exceed the value of the parameter listed in Table 1-6. The following example shows the use of the SHOW command for obtaining information for the GBLPAGES system parameter: SYSGEN> SHOW GBLPAGES After you finish checking the GBLPAGES parameter with the SHOW command, enter the EXIT command at the SYSGEN> prompt to return to DCL level. 1.10.4.2 Calculating the Value for GBLPAGES To install and run DECpage, you must have sufficient free global pages. First, you must find out how many free global pages you have on your system. Then use AUTOGEN if you need to increase the GBLPAGES system parameter. The n + 950 value for GBLPAGES in Table 1-6 indicates that you must have at least 5000 unused global pages available on your system for the installation to process successfully. Preparing to Install DECpage 1-11 If you are installing DECpage on a VMS Version 5.1 system, perform the following steps to calculate how many unused global pages your system has: 1 Run the VMS Install Utility (INSTALL) using the following DCL command: $ INSTALL LIST/GLOBAL/SUMMARY The Install Utility displays a summary of global pages and global sections used by your system, as well as the current number of unused global pages. For example: Summary of Local Memory Global Sections 158 Global Sections Used, 9744/365 Global Pages Used/Unused 2 Determine if the number of unused pages (365 in the example) is equal to or greater than 950, the number required by DECpage. If you are installing DECpage on a VMS Version 5.2 or higher system, you can use the WRITE command with the F$GETSYI lexical function to find the number of free global pages. The following example shows how to get this information at your terminal (the default for SYS$OUTPUT): $ WRITE SYS$OUTPUT F$GETSYI("FREE_GBLPAGES") 365 If the number of unused pages is less than the required number, you need to increase the value for GBLPAGES. For example, using the 365 figure from the examples, you would need to increase GBLPAGES by 585. The process used to calculate that value is: 9744 Used Global Pages + 365 Unused Global Pages ------- 10109 Current Value of GBLPAGES And: 950 Required GBLPAGES for DECpage - 365 Unused Global Pages ------ 585 Remainder Then: 1-12 Preparing to Install DECpage 10109 Current Value of GBLPAGES + 585 Remainder ------ 10694 New required GBLPAGES value Section 1.10.4.3 describes the procedure for increasing system parameter values using AUTOGEN. See the Extended VMS System Management documentation subkit for information on using AUTOGEN. 1.10.4.3 Changing System Parameter Values with AUTOGEN You use the AUTOGEN command procedure to change system parameters. You can add new parameters and modify incremental parameters. AUTOGEN automatically adjusts values for other system parameters that are associated with the values you reset manually. To change the GBLPAGES parameter with AUTOGEN: 1 Edit the following file: SYS$SYSTEM:MODPARAMS.DAT 2 Modify the incremental parameter for GBLPAGES by using ADD_. For example, add the following line to increase the value by 585: ADD_GBLPAGES = 585 3 Exit from the editor. 4 Run the AUTOGEN procedure to recalculate the system parameters by entering the following command at the DCL prompt: $ @SYS$UPDATE:AUTOGEN GETDATA REBOOT Specifying REBOOT causes AUTOGEN to perform an automatic shutdown and then reboot the system when it has finished. Any users logged on to the system are immediately disconnected during the shutdown. The automatic reboot puts any 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. Preparing to Install DECpage 1-13 For more information about using AUTOGEN, see the Extended VMS System Management documentation subkit. 1.10.5 Process Account Quotas The account you use to install DECpage must have sufficient quotas to enable you to perform the installation. Table 1-7 summarizes the process quotas DECpage requires for the installation account. Table 1-7 Process Account Quotas for the Installing Account _____________________________________________________________ Account_Quota____Value_______________________________________ ASTLM 100 BIOLM 50 BYTLM[1] 36500 DIOLM 50 ENQLM 200 FILLM 150 PGFLQUO 20000 TQELM 50 WSDEF 256 WSEXTENT[2] 2048 WSQUO[2] 512 _____________________________________________________________ [1]Using multiple VMSINSTAL options requires a higher value for BYTLM. [2]The values for WSEXTENT and WSQUO must be equal to or greater than the WSDEF value. _____________________________________________________________ VMS stores user account quotas in the file SYSUAF.DAT. Use the VMS Authorize Utility to verify and change user account quotas, as follows: 1-14 Preparing to Install DECpage 1 Set your directory to SYS$SYSTEM and then run AUTHORIZE by entering the following commands at the DCL prompt: $ SET DEFAULT SYS$SYSTEM $ RUN AUTHORIZE UAF> 2 At the Authorize Utility prompt (UAF>), use the SHOW command with an account name to check a particular account. For example: UAF> SHOW SMITH 3 To change a quota, use the MODIFY command at the UAF> prompt. MODIFY has the following format: MODIFY account-name /quota-name=nnn The following example changes the FILLM quota for the SMITH account: UAF> MODIFY SMITH /FILLM=50 4 Exit from the Authorize Utility when you have finished verifying user account quotas: UAF> EXIT After you exit from the utility, the VMS system displays messages indicating whether or not changes were made. After you make the changes, you must log out and log in again to enable the new quotas. For more information on modifying account quotas, see the description of the Authorize Utility in the Extended VMS System Management documentation subkit. 1.10.6 VMSINSTAL Requirements Before you invoke VMSINSTAL, you should complete the following steps: 1 Log in to a privileged account 2 Set your default device and directory to SYS$UPDATE 3 Ensure the system has adequate quotas for installation Preparing to Install DECpage 1-15 When you invoke VMSINSTAL, the procedure first checks to be sure you meet these requirements and then displays the following information: _ Whether DECnet is up and running on the system (VMS Version 5.1 only) _ Which, if any, users are logged in to the system It is not necessary to shut down DECnet. However, inform WPS- PLUS or ALL-IN-1 users that they are to log off while DECpage is being installed. 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 and press RETURN. Then correct the problem and restart the installation. 1.10.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 Extended VMS System Management documentation subkit. 1-16 Preparing to Install DECpage 2 ________________________________________________________________ Installing DECpage This chapter describes how to install DECpage. Section 2.2 contains a step-by-step description of the installation procedure, based on a U.S. installation. 2.1 General Information This section includes general information about accessing the online release notes, running the Installation Verification Procedure (IVP), and aborting the installation. 2.1.1 Accessing the Online Release Notes DECpage provides online release notes. You must specify OPTIONS N when you invoke VMSINSTAL to access the release notes. VMSINSTAL provides a list of options near the beginning of the installation that lets you decide how to review the release notes during the installation. You should review the release notes in case they contain any information about changes in the installation procedure. If you are restarting the installation procedure and you have already reviewed the release notes, you do not need to specify OPTIONS N. After you install DECpage, your system stores the release notes in the following file: SYS$HELP:saveset-name.RELEASE_NOTES For the saveset-name of your kit, see Table 1-2. Installing DECpage 2-1 2.1.2 Running the Installation Verification Procedure The Installation Verification Procedure (IVP) for DECpage verifies the installation. When you install DECpage, the VMSINSTAL procedure asks you if you want to run the IVP as part of the installation. If you respond YES, VMSINSTAL runs the IVP. It is recommended that you run the IVP to make sure that DECpage is installed correctly. After you install DECpage, 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 be sure that users can access DECpage. If you run the IVP during the installation, the IVP prints a representative sample of the DECpage styles. If you run the IVP separately as a post-installation procedure, you can select this brief IVP or an IVP that takes much longer and prints the complete set of DECpage styles, as shown in the DECpage Style Samples manual. See Chapter 3 for information about running the IVP separately. 2.1.3 Aborting the Installation You can stop the installation procedure at any time by pressing CTRL/Y. You can then restart the installation. When you press CTRL/Y, the installation procedure exits. You might see warning messages that some directories already exist when you restart the installation. 2.2 The Installation Procedure The DECpage installation procedure consists of a series of questions and informational messages. See Appendix A for a sample installation. 2.2.1 Invoking VMSINSTAL 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. Use the following syntax to invoke VMSINSTAL: @SYS$UPDATE:VMSINSTAL saveset-name device-name OPTIONS N 2-2 Installing DECpage saveset-name The installation name for the component. For example, PAGE031 is the saveset name for the U.S. kit. See Table 1-2 for the saveset names of all the DECpage kits. 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 remove once you complete the installation. OPTIONS N An optional parameter that gives you the option of accessing the release notes during the installation. If you do not include the OPTIONS N parameter, VMSINSTAL does not ask you about the release notes. You should always review the release notes before you proceed with the installation in case they contain new information about the installation. Note that there are several other options you can select when you invoke VMSINSTAL. See the VMS documentation on software installation in the Extended VMS System Management documentation subkit for information on these options. The following example displays the command you use to invoke VMSINSTAL to install DECpage from tape drive MTA0: and shows the system response. This example uses the OPTIONS N release note parameter. $ @SYS$UPDATE:VMSINSTAL PAGE031 MTA0: OPTIONS N VAX/VMS Software Product Installation Procedure V5.2 It is 17-JAN-1990 at 09:00. 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. Because VMSINSTAL does not prompt for options, be sure to include OPTIONS N on the VMSINSTAL command line if you want to access the release notes during the installation. Installing DECpage 2-3 2.2.2 Answering Installation Questions This section describes the questions that appear during the installation. Appendix A contains a sample installation procedure showing how the questions can be answered. VMSINSTAL marks each question in the installation with an asterisk (*) at the beginning of the line. Some questions show the default response in brackets, for example [YES]. To use the default response, press the RETURN key. The following list outlines the questions in the installation procedure: 1 DECnet status VMSINSTAL notifies you if DECnet is running and displays a list of all active processes. It then asks if you want to continue the installation. You can install DECpage with DECnet up and running. NO is the default response to the question. %VMSINSTAL-W-DECNET, Your DECnet network is up and running. . . . * Do you want to continue anyway [NO]? If you are installing on VMS Version 5.2 or higher, VMSINSTAL does not check the DECnet status. You can install DECpage while DECnet is up and running. 2 System backup 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 RETURN. Otherwise, enter NO to discontinue the installation. After you back up your system disk, you can restart the installation. * Are you satisfied with the backup of your system disk [YES]? 3 Mounting the media You should now mount the 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. 2-4 Installing DECpage If you respond YES to indicate that you are ready, VMSINSTAL displays a message indicating that the media containing DECpage is mounted on the specified device and that the installation has begun. For example: Please mount the first volume of the set on MTA0:. * Are you ready? YES %MOUNT-I-MOUNTED, PAGE MOUNTED ON _$$MTA0: (NODE 1) The following products will be processed: PAGE V3.1 Beginning installation of PAGE V3.1 at 09:01 %VMSINSTAL-I-RESTORE, Restoring product saveset A... If you entered the wrong device name when you invoked VMSINSTAL and you 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 Release notes If you specified OPTIONS N when you invoked VMSINSTAL, you are now asked to choose an option for reviewing the release notes. Under VMS Version 5.1, there are five release notes options. Under VMS Version 5.2 or higher, there are only four options. For VMS Version 5.1, the following options are displayed: Release Notes Options: 1. Display release notes 2. Print release notes 3. Both 1 and 2 4. Copy release notes to SYS$HELP 5. Do not display, print or copy release notes * Select option [2]: For VMS Version 5.2 or higher, the following options are displayed: Installing DECpage 2-5 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]: The following list explains the release notes options: _ Display the release notes. Select option 1 to display the release notes. VMSINSTAL displays the release notes immediately on the console terminal. You can terminate the display at any time by pressing CTRL/C. _ Print the release notes. Select option 2 to print the release notes. VMSINSTAL prompts you for the name of the print queue to use: * Queue name [SYS$PRINT]: Press RETURN to send the file to the default output print device, or enter another queue name. _ Display and print the release notes. Select option 3 to display and print the release notes. VMSINSTAL displays the release notes immediately on the console terminal and then prompts you for a queue name for the printed version. _ Copy the release notes to the help directory. Under VMS Version 5.1, select option 4 to copy the release notes to SYS$HELP, the system help directory. Even if you do not select option 4, the release notes for DECpage are copied to the SYS$HELP directory. Under VMS Version 5.2 or higher, the release notes are always copied to SYS$HELP. _ Take no action. Select option 4 (VMS Version 5.2 or higher) or option 5 (VMS Version 5.1) if you have already reviewed the release notes and are restarting the installation. 2-6 Installing DECpage For a typical installation, you should select option 2, the default option. 5 Continuing the installation The installation procedure now asks if you want to continue the installation. To continue, enter YES. Otherwise, press RETURN. In either case, the release notes are copied to a file in the SYS$HELP directory. For example: * Do you want to continue the installation [N]?: YES %VMSINSTAL-I-RELMOVED, The product's release notes have been successfully moved to SYS$HELP. VMSINSTAL copies the release notes for the American kit to the following file: SYS$HELP:PAGE031.RELEASE_NOTES Note The name of the release notes file installed by VMSINSTAL consists of the current saveset name and version number. Do not delete the release notes for previous versions of DECpage. After you enter YES to continue the installation, two copyright notices are displayed. At the end of their display, you are asked to press any key to continue the installation. For example, you can press RETURN. 6 Continuing the installation The installation procedure then displays the media label of the kit that is being installed. For example: This is the DECpage V3.1 installation kit. The installation procedure asks if you want to continue the installation. Check to make sure you are installing the correct DECpage kit. (See Table 1-2 for the media labels of all the DECpage kits.) If you are installing the correct kit, press RETURN to continue. If the kit is not correct, enter NO, and the installation procedure terminates. 7 Checking license registration Installing DECpage 2-7 The installation procedure displays license information about your product and then asks if you have registered and loaded your authorization key for DECpage. For example: Product: DECPAGE Producer: DEC Version: 3.1 Release Date: 15-JAN-1990 * 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. 8 Verifying the prerequisite software and hardware The installation procedure lists the following software and hardware requirements: DECpage requires that the following be present on your system BEFORE installation: VAX/VMS Version 5.1 or higher WPS-PLUS/VMS Version 3.0 or higher, or any language variant, or ALL-IN-1 Version 2.3 or higher, or any language variant LN03 Office Fonts (If you have an LN03 or LN03 PLUS) You must also have one of the following laser printers: LPS20 (PrintServer 20) LPS40 Plus (PrintServer 40 Plus) LPS40 (PrintServer 40) LN03R (ScriptPrinter) LN03 PLUS (with two RAM cartridges) LN03 (with two RAM cartridges) Do you wish to continue [YES]? If you have the necessary software and hardware, press RETURN for the installation to continue. If you do not, enter NO; the installation procedure terminates. 2-8 Installing DECpage 9 Specifying one or more laser printers The installation procedure now asks you to specify which types of laser printers are available on your system. For example: * Do you have an LN03 (LN03 PLUS) graphics printer [YES]? Specify the appropriate printer or printers. You can select one or more than one. Note If you select a printer that requires prerequisite installation of Office Fonts, such as an LN03, and the Office Fonts are not installed, the installation fails. 10Choosing to run the Installation Verification Procedure (IVP) Each time you select a printer, VMSINSTAL asks if you want to run the IVP on the selected printer: * Do you wish to run the IVP on this printer [NO]? If you enter YES, the installation procedure asks for the queue name. For example: * What is the LN03 queue name: The IVP for DECpage checks to be sure that the installa- tion is successful. Digital recommends that you run the IVP. You can choose not to run the IVP during the installation and run it later. See Chapter 3 for information about running the IVP separately. 11Selecting the paper size After you finish answering the laser printer questions for all the supported printers, the installation procedure asks you to select the paper size for your installation: What paper size will you be using? 1) American (8 1/2 x 11) 2) International (A4) * [1]: 12Choosing to copy the clip art Installing DECpage 2-9 The installation procedure displays the following message and asks if you want to copy the graphics provided with the kit to the clip art directory: This kit contains a library of Encapsulated PostScript(R) graphics. Their total size is approximately 3,000 blocks when they are copied to the DECpage clip art directory. * Do you want these graphics copied to the clip art directory [YES]? Press RETURN to copy the graphics to the clip art directory. Otherwise, enter NO. 13Specifying the installation location The installation procedure displays the disk space requirements for DECpage and then asks you where you want to install DECpage on your system: * Do you want the product files to reside on the system disk [YES]? Press RETURN to install DECpage on the system disk. Otherwise, enter NO. If you enter NO, you are prompted to supply a device name. Note Make sure the device is a disk and that it is mounted. The installation then asks you to confirm your choice of devices. For example: * Target device is DDCU:. Is this correct [YES]? If you answer NO to this question, you are prompted for a different device. 14Choosing to purge files You have the option to purge files from previous versions of DECpage 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. * Do you want to purge files replaced by this installation [YES]? 2-10 Installing DECpage 2.2.3 Checking Informational Messages At this point, there are no further questions. The installa- tion procedure displays a number of informational messages that report on the progress of the installation. 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. VMSINSTAL displays the following messages: %VMSINSTAL-I-RESTORE, Restoring product saveset B... %VMSINSTAL-I-RESTORE, Restoring product saveset C... . . . %VMSINSTAL-I-MOVEFILES, files will now be moved to their target directories... . . . 2.2.4 Running the Installation Verification Procedure If you chose to run the IVP, VMSINSTAL runs it now. The IVP tests the software by printing representative samples from the DECpage Style Samples on the printer you selected. This process takes approximately 15 minutes on a VAX 11/785. When the IVP runs successfully, you see the following message: DECpage Version 3.1 IVP completed successfully! >>>>> DECPAGE HAS BEEN SUCCESSFULLY INSTALLED <<<<< 2.2.5 Completing the Installation Procedure Before indicating that the installation is complete, the installation procedure displays important post-installation information about modifying the system startup command procedure and installing DECpage forms to integrate DECpage into WPS-PLUS or ALL-IN-1. The following messages then indicate that the entire installation procedure is complete: Installing DECpage 2-11 Installation of PAGE V3.1 completed at 11:13 VMSINSTAL procedure done at 11:14 You can now log out of the privileged account: $ LOGOUT SYSTEM logged out at 17-JAN-1990 11:15:00.00 Note that 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.3 Error Recovery If errors occur during the installation procedure or when the IVP is running, VMSINSTAL displays failure messages. If the installation fails, you see the following message: %VMSINSTAL-E-INSFAIL, The installation of PAGE V3.1 has failed. If the IVP fails, you see these messages: The PAGE V3.1 Installation Verification Procedure failed. %VMSINSTAL-E-IVPFAIL, The IVP for PAGE V3.1 has failed. Errors can occur during the installation if any of the following conditions exist: _ The operating system version is incorrect. _ A prerequisite software version is incorrect. _ Quotas necessary for successful installation are insufficient. _ Disk space is insufficient. _ System parameter values for successful installation are insufficient. _ The VMS help library is currently in use. _ The product license has not been registered and loaded. For descriptions of the error messages generated by these conditions, see the VMS documentation on system messages, recovery procedures, and VMS software installation. If you are notified that any of these conditions exist, you should take the appropriate action as described in the message. 2-12 Installing DECpage You might need to change a system parameter or increase an authorized quota value. For information on installation requirements, see Chapter 1. For descriptions of error messages generated by DECpage during the installation, see Appendix C. \ Installing DECpage 2-13 3 ________________________________________________________________ After Installing DECpage After installing DECpage, you need to perform the following tasks: _ Replace information data files _ Delete obsolete command procedures _ Integrate DECpage into WPS-PLUS or ALL-IN-1 _ Create a DECpage account on ALL-IN-1 _ Associate DECpage print queues with VMS print queues _ Associate additional DECpage batch queues with VMS batch queues _ Create a proxy account and proxy logins for remote printing and batch processing _ Modify the system startup procedure _ Modify certain style values _ Replace canned styles This chapter describes how to perform these required procedures, as well as how to perform the following optional post-installation tasks: _ Install DECpage on a VAXcluster system _ Install multiple-language versions _ Reinstall DECpage _ Modify DECpage batch queue priorities _ Add logos to the system After Installing DECpage 3-1 _ Convert LN03 logos to PostScript logos _ Upgrade the DECpage font package _ Perform post-installation procedures for VAX GKS graphics _ Change hyphenation exception dictionaries _ Assist users to modify their LOGIN.COM file for batch mode and to redefine the DECPAGE$GRAPHIC logical _ Run the Installation Verification Procedure separately 3.1 Replacing Information Data Files If you have performed an update installation from DECpage Version 3.0, you might have saved some of the following files prior to the update (see Section 1.7.2): BATCHQ.DAT DEVICELST.DAT TEMPLST.DAT STYLELST.DAT You must copy these files back to the directory from which you first copied them. You can check for these files in the following directories: _ For ALL-IN-1 systems, the directory OA$DATA_language or OA$SITE_DATA_language _ For WPS-PLUS systems, the directory ddcu:[WPSPLUS.DATA_ language] or ddcu:[WPSPLUS.SITE_DATA_language] For language, specify the language of your kit. Note You must replace these files before integrating DECpage into ALL-IN-1 or WPS-PLUS. 3.2 Deleting Obsolete DECpage Command Procedures If you have performed an update installation from a previous version of DECpage, there might be some obsolete command procedures on your system. Check the following directories: _ On ALL-IN-1 systems, the directory OA$LIB_LLV or OA$SITE_ LIB_LLV _ On WPS-PLUS systems, the directory ddcu:[WPSPLUS.LIB_ language] or ddcu:[WPSPLUS.SITE_LIB_language] For language, specify the language of your kit. 3-2 After Installing DECpage If you find any of the following files in those directories, you must delete the files: DECPAGEVM.COM DECPMOD.COM DECPR.COM UPDATE_STY.COM Note You must delete these files before running DECpage. 3.3 Integrating DECpage into WPS-PLUS or ALL-IN-1 After installation, you must integrate DECpage into WPS-PLUS or ALL-IN-1, as follows: 1 From the System Manager's account, invoke WPS-PLUS or ALL-IN-1. 2 At the WPS-PLUS Main Menu, or from ALL-IN-1, enter the following command: