                                             H                     Compaq_ACMSxp_for_OpenVMS_Alpha_____________________&                     Installation Guide    -                     Order Number: AA-QRFXE-TE                          June 1999   G                     This document provides information about installing F                     Compaq ACMSxp software on an OpenVMS Alpha system.              C                     Revision/Update Information:  This is a revised 9                                                   manual.   G                     Software Version:             Compaq ACMSxp Version H                                                   3.2A for OpenVMS Alpha          /                     Compaq Computer Corporation "                     Houston, Texas                 J           ________________________________________________________________           June 1999   B           The information in this publication is subject to change           without notice.   =           COMPAQ COMPUTER CORPORATION SHALL NOT BE LIABLE FOR >           TECHNICAL OR EDITORIAL ERRORS OR OMISSIONS CONTAINED=           HEREIN, NOR FOR INCIDENTAL OR CONSEQUENTIAL DAMAGES ?           RESULTING FROM THE FURNISHING, PERFORMANCE, OR USE OF A           THIS MATERIAL. THIS INFORMATION IS PROVIDED "AS IS" AND ?           COMPAQ COMPUTER CORPORATION DISCLAIMS ANY WARRANTIES, A           EXPRESS, IMPLIED, OR STATUTORY, AND EXPRESSLY DISCLAIMS @           THE IMPLIED WARRANTIES OF MERCHANTABILITY, FITNESS FORC           PARTICULAR PURPOSE, GOOD TITLE, AND AGAINST INFRINGEMENT.   <           This publication contains information protected byC           copyright. No part of this publication may be photocopied A           or reproduced in any form without prior written consent +           from Compaq Computer Corporation.   D            1999 Digital Equipment Corporation. All Rights Reserved.  C           The software described in this guide is furnished under a D           license agreement or nondisclosure agreement. The softwareD           may be used or copied only in accordance with the terms of           the agreement.  A           Compaq and the Compaq logo are registered in the United -           States Patent and Trademark Office.   B           ACMS, ACMS Desktop, ACMSxp, ACMSxp Desktop, AlphaServer,?           AltaVista, DEC, DECnet, DECthreads, DIGITAL, OpenVMS, D           Tru64 UNIX, VAX, and VMS are trademarks of Compaq Computer           Corporation.  ;           Microsoft, Windows, and Windows NT are registered .           trademarks of Microsoft Corporation.  A           Oracle is a registered trademark of Oracle Corporation.   @           UNIX and X/Open are registered trademarks and The OpenE           Group is a trademark of The Open Group in the United States            and other countries.  D           Other product names mentioned herein may be trademarks andB           /or registered trademarks of their respective companies.  D           This document was prepared using VAX DOCUMENT Version 2.1.                                 C   _________________________________________________________________   C                                                            Contents       C   Preface...................................................    vii   0   1  Preparing to Install Compaq ACMSxp Software  3         1.1   Installing Product Authorization Keys C               (PAKs)........................................    1-1 C         1.2   Required Layered Software.....................    1-2 7         1.3   Privileges Required for Installing ACMSxp C               Software......................................    1-2 9         1.4   System Parameter Values Required for ACMSxp C               Software......................................    1-3 C         1.5   Disk Space Requirements.......................    1-4 C         1.6   Required Order for Installing Software........    1-5 C         1.7   Required Operating System Components..........    1-6 C         1.7.1     Debugger Kit..............................    1-6 C         1.8   Required Operating System Patches.............    1-7 C         1.9   Optional Layered Software.....................    1-8 C         1.10  DCE Procedures for the IVP....................    1-8   &   2  Installing Compaq ACMSxp Software  C         2.1   Backing Up Your System Disk...................    2-1 4         2.2   Installing Compaq ACMSxp Software withC               VMSINSTAL.....................................    2-1 :         2.3   Running the ACMSxp Installation VerificationC               Procedure (IVP)...............................    2-8 C         2.4   Error Recovery................................    2-9               C                                                                 iii                    .     3  After Installing Compaq ACMSxp Software  E           3.1   Installing the ACMSxp Management GUI Option...    3-1 E           3.1.1     Prerequisite Software.....................    3-1 E           3.1.2     System Requirements.......................    3-2 4           3.1.3     Procedures to Install the ACMSxpE                     Management GUI............................    3-2 7           3.1.4     Installing on a Japanese Windows NT E                     System....................................    3-3 E           3.2   Creating and Modifying User Accounts..........    3-3 E           3.2.1     Setting Privileges for User Accounts......    3-3 ;           3.2.2     Setting Minimum Process Quotas for User E                     Accounts..................................    3-4 E           3.3   System Tuning.................................    3-7 ;           3.3.1     Physical I/O Pages Parameter for ACMSxp E                     Queuing...................................    3-7 6           3.3.2     Working Set Parameters for RequestE                     Queuing...................................    3-8 4           3.3.3     System Parameter for DECnet-PlusE                     Software..................................    3-8 <           3.3.4     Checking and Modifying System ParametersE                     for ACMSxp Software.......................    3-8 E           3.3.5     Setting UCX Parameters for DCE Software...   3-11 E           3.3.6     Maintaining DECnet Configuration Values...   3-11 E           3.3.6.1     Guidelines for Calculating Links........   3-12 9           3.3.7     Maintaining DECnet-Plus Configuration E                     Values....................................   3-13 ;           3.4   Configuring DECdtm-Journal File and Logical E                 Name..........................................   3-15 E           3.4.1     Logical Name..............................   3-15 E           3.4.2     Journal File..............................   3-15 E           3.5   Modifying Node Startup Procedures.............   3-16 E           3.6   VMScluster Considerations.....................   3-16 :           3.6.1     Setting Up a Systemwide Default ACMSxpE                     Version...................................   3-17 8           3.7   Setting Up ACMSxp with Japanese LanguageE                 Support.......................................   3-18                      iv                   '         4  Deinstalling ACMSxp Software   I               4.1   Deinstallation Requirements...................    4-1 I               4.2   Actions Performed During Deinstallation.......    4-2 I               4.3   Rerunning an Incomplete Deinstallation........    4-4 I               4.4   Questions Asked During Deinstallation.........    4-5   %         A  Sample ACMSxp Installation             B  ACMSxp-Supplied Files  I               B.1   Examples Directory............................    B-1 I               B.2   Executable Directory..........................    B-4 I               B.3   Help Directory................................    B-5 I               B.4   Library Directory.............................    B-5 I               B.5   Manager Directory.............................    B-6 I               B.6   Messages Directory............................    B-6 I               B.7   Test Directory................................    B-7   
         Index              Examples  I               3-1       Examining NSP Attributes..................   3-13            Tables  I               1-1       Required Layered Software.................    1-2   =               1-2       Privileges Required to Install ACMSxp I                         Software and Run the IVP..................    1-2   :               1-3       System Parameter Values for ACMSxpI                         Software..................................    1-3   I               1-4       ACMSxp Software Disk Space Requirements...    1-5   I               1-5       Required Operating System Components......    1-6   I               1-6       Required Operating System Patches.........    1-7   I               1-7       Optional Layered Software.................    1-8   I               3-1       Prerequisite Software Version Numbers.....    3-2   9               3-2       Minimum Process Quotas for ACMSxp I                         Commands..................................    3-4   I               3-3       DECnet Phase IV Parameters................   3-11   I                                                                         v                              I         _________________________________________________________________   I                                                                   Preface       ?               This manual presents information about installing F               Compaq ACMSxp software on the OpenVMS Alpha platform andF               deinstalling earlier versions of Compaq ACMSxp software.           Intended Audience   E               Read this manual if you are responsible for installing, >               maintaining, or deinstalling software for ACMSxp;               applications. To perform the installation and E               deinstallation procedures described in this manual, you G               must have access to a privileged OpenVMS system manager's D               account, and be familiar with the OpenVMS installation#               procedure, VMSINSTAL.   $         Operating System Information  E               Information about the versions of the OpenVMS operating G               system and other software compatible with this version of 9               ACMSxp software is included in this manual.   C               For information on the relationship of other software I               products with this version of ACMSxp software, refer to the G               Software Product Description (SPD). Use the SPD to verify I               which versions of your operating system are compatible with .               this version of ACMSxp software.                  I                                                                       vii                    
     Structure   C           This manual has the following components, as shown in the            following table:  E           ___________________________________________________________ E           Component___Description____________________________________   =           Chapter 1   Describes preparations and requirements ?                       necessary for installing ACMSxp software, 3                       including dependent software.   D           Chapter 2   Describes the installation of ACMSxp software.  A           Chapter 3   Describes actions that may be necessary for D                       the successful running of ACMSxp and dependentE                       software after you install the ACMSxp software.   <           Chapter 4   Describes the deinstallation of ACMSxp                       software.   2           Appendix A  Shows a sample installation.  E           Appendix_B__Lists_the_files_from_the_ACMSxp_savesets.______        Conventions   7           This document uses the following conventions:   E     _________________________________________________________________ E     Convention____Description________________________________________   B     Ctrl/x        Ctrl/x indicates that you hold down the Ctrl keyD                   while you press another key (indicated here by x).  B     { }           In format descriptions, braces indicate required@                   elements. You must choose one of the elements.  D     [ ]           In format descriptions, brackets indicate optionalC                   elements. You can choose none, one, or all of the B                   options. (Brackets are not optional, however, inC                   the syntax of a directory name in an OpenVMS file !                   specification.)   A     ( )           In format descriptions, parentheses delimit the -                   parameter or argument list.        viii                 I         _________________________________________________________________ I         Convention____Description________________________________________   H          . . .        In format descriptions, horizontal ellipsis pointsI                       indicate an item that is repeated, an omission such E                       as additional optional arguments, or additional G                       parameters, values, or other information that you                         can enter.  G         .             Vertical ellipsis points indicate the omission of H         .             information from an example or command format. TheH         .             information is omitted because it is not important3                       to the topic being discussed.   >         italic type   Italic type in text emphasizes importantF                       information; indicates variables, product names,E                       or sub-brands; and indicates complete titles of                        manuals.  G         boldface      Boldface type in examples indicates user input or H         type          highlights important information. Boldface type inG                       text highlights new terms defined in the text and #                       the glossary.   I         UPPERCASE     Words in uppercase indicate a command, a parameter, G                       a routine, the name of a file, the name of a file F                       protection code, or an abbreviation for a system                        privilege.  I         lowercase     In format descriptions, words in lowercase indicate I         ______________parameters_or_arguments_that_you_specify.__________                               I                                                                        ix                          I                                                                         1 I         _________________________________________________________________   I                               Preparing to Install Compaq ACMSxp Software     %               This chapter describes:   G               o  Preparations and requirements necessary for installing '                  Compaq ACMSxp software   G               o  Dependencies among Compaq ACMSxp software, the OpenVMS 7                  operating system, and layered products   H               Compaq strongly recommends that you read the release notesD               for important installation information that might haveF               been omitted from this manual, and then proceed with the               installation.   8         1.1 Installing Product Authorization Keys (PAKs)  C               Before you install and run ACMSxp on a newly licensed @               node or cluster, you must first register a LicenseG               Product Authorization Key (License PAK) using the License D               Management Facility (LMF). To execute ACMSxp software,I               install the ACMS-DEV or ACMS-RT License PAK on each node or 8               cluster on which ACMSxp software executes.  C               PAKs are mailed online or in hardcopy (paper) format.   C               To install each License PAK, do one of the following:   9               o  Execute the following command procedure:   *                  SYS$UPDATE:VMSLICENSE.COM  I                  Answer each prompt according to the information included 5                  in the hard copy of the License PAK.   F               o  At the DCL prompt, enter the LICENSE REGISTER commandC                  with the appropriate qualifiers that correspond toF)                  License PAK information.   I                           Preparing to Install Compaq ACMSxp Software 1-1                    !     1.2 Required Layered Softwarep  E           Table 1-1 lists the dependent layered products that must be:6           installed before installing ACMSxp software.  E           Table_1-1_Required_Layered_Software________________________   E           Software_Product_Title__________Version____________________   -           Compaq DCE                      1.4   3           Compaq TCP/IP Services for      4.1 ECO-4            OpenVMS               RMS Journaling License  E           Compaq_C________________________5.6-3______________________1  C           In some cases, the layered product must be started beforen4           the ACMSxp installation or ACMSxp startup.  :     1.3 Privileges Required for Installing ACMSxp Software  C           Table 1-2 lists the privileges required to install ACMSxp B           software and run the Installation Verification ProcedureB           (IVP). Depending on the security setup of the filesystemE           directory in which ACMSxp software is installed, additionalO%           privileges may be required.   B           Table 1-2 Privileges Required to Install ACMSxp SoftwareE           __________and_Run_the_IVP__________________________________L  E           Privilege___InstallationIVP________________________________i  #           GRPNAM                  Xy  #           GRPPRV                  Xp  #           NETMBX                  X   #           PRMGBL                  Xo             SHARE       X   &           SYSNAM      X           X[1]  E           [1]This_privilege_is_not_required_if_the_process_has_the___   .           rights identifier NET$DECLAREOBJECT.  E                                              (continued on next page)h  3     1-2 Preparing to Install Compaq ACMSxp Softwareo n  w              E               Table 1-2 (Cont.) Privileges Required to Install ACMSxpeI               __________________Software_and_Run_the_IVP_________________   I               Privilege___InstallationIVP________________________________   *               SYSPRV      X           X[2]  '               TMPMBX                  XV                 WORLD       XpI               [2]This_privilege_is_not_required_if_the_process_has_the___T  4               rights identifier ACMS_START_TPSYSTEM.I               ___________________________________________________________n  @         1.4 System Parameter Values Required for ACMSxp Software  I               The system parameter values shown in Table 1-3 are required E               to install ACMSxp software, run the IVP, and run ACMSxp                software.a  I               Table_1-3_System_Parameter_Values_for_ACMSxp_Software______                  System ParameterI               Name__________________Value_________________________________  9               Contiguous free       0 + size in blocks of ;               GBLPAGES              SYS$SHARE:DCLTABLES.EXEC  +               Free GBLSECTIONS          100.  +               CHANNELCNT              2 047e  +               MIN_PQL_DASTLM          4 096   +               MIN_PQL_DBIOLM          1 000   +               MIN_PQL_DBYTLM         50 000.  +               MIN_PQL_DCPULM              0L  +               MIN_PQL_DDIOLM            100   +               MIN_PQL_DENQLM         10 000A  +               MIN_PQL_DFILLM            200.  +               MIN_PQL_DJTQUOTA        1 024t  +               MIN_PQL_DPGFLQUOTA    100 000   +               MIN_PQL_DPRCLM             12.  I                                                  (continued on next page)   I                           Preparing to Install Compaq ACMSxp Software 1-3                    >           Table 1-3 (Cont.) System Parameter Values for ACMSxpE           __________________Software_________________________________u             System ParameterE           Name__________________Value________________________________.  '           MIN_PQL_DTQELM            100d  '           MIN_PQL_MASTLM          4 096   '           MIN_PQL_MBIOLM          1 000   '           MIN_PQL_MBYTLM         50 000.  '           MIN_PQL_MCPULM              0n  '           MIN_PQL_MDIOLM            100   '           MIN_PQL_MENQLM         10 000.  '           MIN_PQL_MFILLM            200h  '           MIN_PQL_MJTQUOTA            0   '           MIN_PQL_MPGFLQUOTA    100 000.  '           MIN_PQL_MPRCLM             12e  E           MIN_PQL_MTQELM____________100______________________________   D           These are minimum values required for running the IVP. YouC           may have to further tune the parameters. For running user A           applications, at a minimum, all values must be nonzero..  ?           Refer to Section 3.3.4 for guidelines on checking and &           modifying system parameters.  A           See Sections 3.2.1 and 3.2.2 and for the privileges and 1           quotas required to run ACMSxp software..       1.5 Disk Space Requirements   >           Table 1-4 lists the minimum disk space requirements.    3     1-4 Preparing to Install Compaq ACMSxp Software                    I         Table_1-4_ACMSxp_Software_Disk_Space_Requirements________________   "                               PeakI         Usage_________________(BlocksNet_________________________________   5         ACMSxp Saveset        30     20 000 + size of >         On system disk        000    SYS$LIBRARY:DCLTABLES.EXE           On another disk.  2         System disk           24     425 + size of>                               252    SYS$LIBRARY:DCLTABLES.EXE  +         Target disk           25     26 601r!                               000n  )         For IVP at            +20    +100 I         installation__________000________________________________________o  H               To determine the number of free disk blocks on the currentI               system disk, enter the following command at the DCL prompt:.  *               $  SHOW DEVICE SYS$SYSDEVICE                  .                  .                  .               $   @               This command displays the number of free blocks onB               the system disk to which the systemwide logical nameH               SYS$SYSDEVICE points. To determine the number of free diskG               blocks on another disk, enter at the DCL prompt a command &               in the following format:                 SHOW DEVICE disk  I               This command displays the number of free blocks on the disk.               specified.  2         1.6 Required Order for Installing Software  E               To ensure problem-free installation of software on your.A               system, install OpenVMS and layered software in the.               following order:  $               1. Compaq C (required)  8               2. Compaq TCP/IP Services (UCX) (required)  1               3. DECnet or DECnet-Plus (required)   I                           Preparing to Install Compaq ACMSxp Software 1-5. .  .              6           4. RDB (optional)-install before DECnet-Plus  "           5. Compaq DCE (required)  >           The order of installation for the remaining software9           products is not important for ACMSxp operation.o  ,     1.7 Required Operating System Components  E           Table 1-5 lists the operating system components required byn           ACMSxp.s  E           Table_1-5_Required_Operating_System_Components_____________   E           Component:____________Including:___________________________.  &           OpenVMS Alpha         DECdtm:           Version 7.1 or        OpenVMS Debugger V7.2X-010           OpenVMS Alpha.E           Version_6.2________________________________________________        1.7.1 Debugger Kit  @           To have STDL source level debugging function properly,D           ACMSxp software requires the proper version of the OpenVMS=           Debugger. If you are installing ACMSxp software for A           development purposes, check whether the following image B           is present on the system on which you are performing the           installation..  (           SYS$SHARE:DEBUGSRVSHR_V72X.EXE  B           If the image is present, check the version of the image.           For example:  C           $  ANAL/IMAGE/HEADER/INTER SYS$SHARE:DEBUGSRVSHR_V72X.EXEt              .              .              .2                   Image Identification Information  3                           image name: "DEBUGSRVSHR".@                           image file identification: "V7.2X-010"  E           Press Return until you see the heading Image IdentificationrD           Information and the line image file identification. If theE           version is V7.2X-010 or later, you have the proper Debugger-           version.  3     1-6 Preparing to Install Compaq ACMSxp Software                    F               If the image is not present or its version is not at theG               appropriate revision level, you must install the Debugger.D               kit provided with the ACMSxp kit. Find the installableH               kit ADX072.* in the same directory in which you locate theF               ACMSxp kit and use VMSINSTAL to make it available on the               ACMSxp system.  H               Installing the debugger kit does not supersede the currentF               version of the debugger on your system. Both the old andH               new versions are available; unless you change the default,H               the old version remains the default. The ACMS DEBUG SERVERH               command uses the newer version of the debugger. You do notH               need to run any other debugger command procedures providedE               with the OpenVMS Debugger kit to make the newer version E               available to ACMSxp software. To make the newer version F               the default systemwide debugger, follow the instructions@               displayed by the OpenVMS Debugger kit installation               procedure.  -         1.8 Required Operating System Patches   F               Table 1-6 lists the operating system patches required by               ACMSxp software.  I               Table_1-6_Required_Operating_System_Patches________________p  I               VersionPatch_________________Comment:______________________i  I               6.2    ALPBOOT12_062         Or later patch revision level.w  "                      ALPCMAR04_062  !                      ALPRMS02_062   !                      ALPSYS14_062D  !                      ALPY2K02_062f  "               7.1    ALPACRT04_071  "                      ALPPTHR01_071  !                      ALPRMS02_071S  I               _______ALPSYSA01_071_______________________________________   I                           Preparing to Install Compaq ACMSxp Software 1-7  h  m              !     1.9 Optional Layered Softwareh  B           Table 1-7 lists the optional dependent software products'           that can be used with ACMSxp.   E           Table_1-7_Optional_Layered_Software________________________              Software           ProductdE           Name_____________Version_____Notes_________________________o             COBOL            2.5  >           DECset                       Facilitates application3                                        development.e  E           Oracle_Rdb_______6.1_______________________________________   C           These products can be installed and used independently ofo,           ACMSxp installation and operation.  #     1.10 DCE Procedures for the IVP   =           The following DCE setup is required to run the IVP:   (           o  Server principal acmsxp_svr  8           o  Server key file in the following directory:                 DCE$SPECIFIC:[KRB5]  5           o  User principal(s) in the DCE group userss             Follow these steps:_  )           1. Log in to DCE as cell_admin.   $              $  dce_login cell_admin              Enter Password:              $  D              The command logs you in to DCE and gives you the proper<              credentials to execute the security operations.  C              ________________________ Note ________________________   1              All DCE commands are case sensitive.   C              ______________________________________________________   3     1-8 Preparing to Install Compaq ACMSxp Softwarer l                 F               2. Create a group called users under which the IVP runs.                    $  rgy_editE                  Current site is: registry server at /.../avertz_cell (                  rgy_edit=> domain group)                  Domain changed to: groupe5                  rgy_edit=> add users -f "IVP access"                    rgy_edit=> exit                  $  I                  The add subcommand creates the DCE group users. The exit_F                  command leaves the program and returns control to the                  DCL prompt   F               3. Provide namespace directory creation access for groupD                  users. In the commands shown, replace the cell name8                  avertz_cell with the name of your cell.  D                  $  acl_edit /.../avertz_cell -m group:users:rwdtciaH                  $  acl_edit /.../avertz_cell -ic -m group:users:rwdtciaF                  $  acl_edit /.../avertz_cell -io -m group:users:rwdtc'                  $  cdscp show cell /.:i&                                   SHOW8                                    CELL /.../avertz_cell7                                    AT 1998-2-9-16:27:01oX                                    Namespace Uuid = e484c407-d0b8-11cd-835b-08002b187bb3\                                    Clearinghouse Uuid = e2a64d26-d0b8-11cd-835b-08002b187bb3R                                    Clearinghouse Name = /.../avertz_cell/avertz_ch8                                    Replica Type = MasterF                                    Tower = ncacn_ip_tcp:16.119.0.166[]F                                    Tower = ncadg_ip_udp:16.119.0.166[]L                  $  acl_edit /.../avertz_cell/avertz_ch -m group:users:rwdtc                  $  D                  The first command modifies the parent directory ACLC                  in the cell namespace with a group entry of users,iD                  allowing all permissions to any principal that is aC                  member of the group. The second and third commands F                  modify the initial container creation ACL and initialF                  object creation ACL similarly to the first command soI                  that any subdirectories and objects subsequently created_2                  have the appropriate permissions.      I                           Preparing to Install Compaq ACMSxp Software 1-9  h  c              8              The fourth command displays the name of theE              clearinghouse to be used in the fifth command. The fifth E              command modifies the clearinghouse directory in the cell A              with a group entry of users, allowing the permission C              w to any principal that is a member of that group. Any E              principal belonging to the group can specify a namespace B              directory during TPsystem creation. For example, thisB              access allows a member principal to create the ACMSxpA              default namespace directory in the cell avertz_cell.   E           4. Create the DCE server principal and account for the IVP.t       $  rgy_edit      rgy_edit=> domain principal       Domain changed to: principalH     rgy_edit=> add acmsxp_svr -f "IVP TPsystem default server principal"     rgy_edit=> domain accounto     Domain changed to: accountR     rgy_edit=> add acmsxp_svr -g users -o none -mp Celladmin_Passwd -pw SvrPasword     rgy_edit=>  =              The add subcommand creates the acmsxp_svr servereC              principal in the namespace and adds an account for theeE              server principal. The string Celladmin_Passwd on the -mpCB              option is the cell_admin account password. The stringC              SvrPasword on the -pw option is the acmsxp_svr accountPA              password. Use this same password when you create theT/              server key in the local directory.   :           5. Create the server key in the local directory.  ?              a. Use rgy_edit subcommands to create the file anda-                 specify the key. For example:   O     rgy_edit=> ktadd -p acmsxp_svr -f dce$local:[krb5]acmsxp_svr -pw SvrPasword A     rgy_edit=> ktlist -p acmsxp_svr -f dce$local:[krb5]acmsxp_svrp!     /.../avertz_cell/acmsxp_svr 1e     rgy_edit=>  A                 The ktadd subcommand with the -p option gives the_D                 name of the server principal acmsxp_svr and with theA                 -f option specifies the key file for the TPsystemCC                 server principal. Specify the same name for the key :                 file and the name of the server principal.  4     1-10 Preparing to Install Compaq ACMSxp Software e  a              B                     The string SvrPasword on the -pw option is theI                     acmsxp_svr account password. The utility verifies the I                     password and creates the server key for the principalIH                     in the named key file. Supply the same password hereF                     that you supplied when you created the DCE accountG                     for the server principal. This ensures that the key E                     in the DCE registry is the same as the key in the                      local file._  G                  b. Ensure that the operating system user account under_B                     which the IVP is to run has read access to the(                     acmsxp_svr key file.  &               6. Terminate DCE access.                     rgy_edit=> exit                    bye.                   $  kdestroy                  $  G                  The commands erase the cell_admin security credentials "                  from the network.  E               Refer to Compaq DCE for OpenVMS Alpha Release Notes for G               information on UCX TCP settings and to the Compaq DCE for I               OpenVMS Alpha Installation and Configuration Guide for cellA(               configuration information.                                  I                          Preparing to Install Compaq ACMSxp Software 1-11_ _                       I                                                                         2 I         __________________________________________________________________  I                                         Installing Compaq ACMSxp SoftwareS    C               This chapter describes the installation of the Compaq_F               ACMSxp software from the Compaq ACMSxp for OpenVMS Alpha               kit.  '         2.1 Backing Up Your System Disk1  B               At the beginning of the installation, VMSINSTAL asksA               whether you have backed up your system disk. Compaq_@               recommends that you do a system disk backup before&               installing any software.  E               Use the backup procedures that have been established at I               your site to do this backup. For details about performing a G               system disk backup, see the section on the BACKUP Utility /               in the OpenVMS documentation set.   <         2.2 Installing Compaq ACMSxp Software with VMSINSTAL  (               To start the installation:  .               1. Log in to the SYSTEM account.  F               2. Set default to the SYS$UPDATE directory. For example:  "                  USERNAME:  SYSTEM                  PASSWORD:*                  $  SET DEFAULT SYS$UPDATE                  $  A               3. If you want to run the Installation Verification @                  Procedure (IVP) during the installation, do the                  following:   H                  a. Ensure that the DECdtm software is configured on the,                     system. See Section 3.4.  I                                     Installing Compaq ACMSxp Software 2-1                    @              b. Log in to DCE using the DCE principal created as7                 described in Section 1.10. For example:_  '                 $  DCE_LOGIN acmsxp_svr_                 Enter Password:                  $M  C              DCE software prompts for the password for the account.   8           4. Invoke VMSINSTAL. Use the following syntax:  0              @VMSINSTAL product-name device-name  #     [ OPTIONS option-1 [, . . . ] ]   '           The VMSINSTAL parameters are:   C           product-name     The installation name for the component.IA                            For ACMSxp software, use the following                              name.  *                            ACMSXPAVME01032  C           device-name      The name of the device on which you plan B                            to mount the medium. For example, MTA0:B                            is the device name for a tape drive. ItD                            is not necessary to use the console driveA                            for this installation. However, if you2A                            do use the console drive, complete the @                            installation, remove the installation=                            medium, and replace any medium you #                            removed.   @           OPTIONS          An optional parameter indicating thatB                            one or more VMSINSTAL options are beingD                            supplied. This parameter is followed by aE                            space, and the requested options. Separate D                            multiple options with commas (,);  do not>                            include spaces in the options list.  D           You can use the following VMSINSTAL options for the ACMSxp           installation:a  @           A      The auto_answer option initially creates a fileB                  that contains your answers to VMSINSTAL questionsB                  and prompts. You can then use the option (and theB                  answer file) to save time during a reinstallation9                  (typically after upgrading your system).   )     2-2 Installing Compaq ACMSxp SoftwareS S  E                F               AWD    The alternate working device option allows you toH                      specify an alternate disk device on which to createF                      the temporary working directory used by VMSINSTALC                      during a product installation. Specify the AWD 7                      option using the following format:m                        AWD=deviceg  F                      This option allows you to perform an installationG                      with fewer free blocks on the system disk than are (                      otherwise required.  B               G      The get saveset option lets you store productD                      savesets temporarily on a magnetic tape or in a$                      disk directory.  A               L      The file log option logs all activity to them2                      terminal during installation.  ?               N      The notes option prints the release notes.   C               R      The alternate root option lets you install the D                      product to a system root other than that of the$                      running system.  D               See the OpenVMS documentation on software installationB               in the OpenVMS System Management Subkit for detailed+               information on these options.t  I               The following command invokes VMSINSTAL and installs ACMSxp 1               software from the MTA0: tape drive:_  F               $  @SYS$UPDATE:VMSINSTAL ACMSXPAVME01032 MTA0: OPTIONS N  N                     OpenVMS Alpha Software Product Installation Procedure V7.2  )               It is 09-JUN-1999 at 10:21.n=               Enter a question mark (?) at any time for help._  H               If you do not supply either the product name or the deviceD               name, VMSINSTAL prompts you for this information laterG               in the installation procedure. If you are not logged intoaG               the system under the SYSTEM account, VMSINSTAL displays a                warning message.  C               The installation procedure continues in the followingt               stages:   .               1. Displaying existing processes  I                                     Installing Compaq ACMSxp Software 2-3                    K              %VMSINSTAL-W-ACTIVE, The following processes are still active:.                OSITPCM_SERVER                EPC$REGISTRARr               DCE$RPCD               DCE$LDSD6              * Do you want to continue anyway [NO]?  Y  =              These are the processes for the software that ist3              required prior to ACMSxp installation.o             2. System backup  A              VMSINSTAL asks the following question to ensure that 4              your system disk is properly backed up:  K              * Are you satisfied with the backup of your system disk [YES]?   A              Always back up your system disk before performing an B              installation. If you are satisfied with the backup ofA              your system disk, press Return. Otherwise, answer No D              to stop the installation. After you back up your system4              disk, you can restart the installation.             3. Mounting the mediaS  E              VMSINSTAL instructs you to mount the ACMSxp distributione@              medium on the device you specified when you invoked              VMSINSTAL.   ?              Please mount the first volume of the set on MTA0:.               *Are you ready?  Ya  D              Mount the medium and answer Yes to the question Are you              ready?e  B              If you entered the wrong device name when you invoked<              VMSINSTAL and need to restart the installation,@              answer NO in response to the question. To abort the=              installation for any other reason, press Ctrl/Y.l?              If you abort the installation, you must delete anypB              subdirectories in the root installation directory and0              restart the installation procedure.  :              VMSINSTAL then reads the media and begins theC              installation of ACMSxp software. The following messagel              appears:g  )     2-4 Installing Compaq ACMSxp Software     s              I                  %MOUNT-I-MOUNTED, ACMSXPAVME01032 MOUNTED ON _$200$MTA0:2  :                  The following products will be processed:  $                    ACMSXPAVME01 V3.2  M                          Beginning installation of ACMSXPAVME01 V3.2 at 10:24A  E                  %VMSINSTAL-I-RESTORE, Restoring product saveset A...                      .                      ._                     ._  *               4. Product Authorization Key  <                  VMSINSTAL asks whether you have the product#                  authorization key:   U                  * Does this product have an authorization key registered and loaded?d  F                  Answer Yes or No. You can install the product withoutI                  having registered and loaded the key, but you cannot run                   the IVP.r  *               5. Specifying a kit location  E                  VMSINSTAL asks where to install the ACMSxp software:   U                  * Where would you like to install ACMSxp [SYS$COMMON:[ACMSxpV0321]]:   =                  Enter the device and directory. For example:_  0                    DISK1:[ACMS.ACMS_INSTALL_DIR]  I                  The directory must either not yet exist, or exist and betG                  empty. If the directory is not empty, the installationhF                  procedure prompts you to supply another directory, or                  you may exit.                  6. Running the IVP  D                  If you are logged in to DCE, VMSINSTAL asks whetherH                  you want to run the Installation Verification Procedure                  (IVP):E  L                  * Do you want to run the IVP after the installation [YES] ?  D                  You can run the IVP during the installation, or youC                  can run it separately after installation. For morei<                  information about the IVP, see Section 2.3.  I                                     Installing Compaq ACMSxp Software 2-5                    D              If the disk you chose has enough free space to completeD              the installation but not to run the IVP, you can eitherE              stop the installation or complete it without running the <              IVP. See Table 1-4 for disk space requirements.  C              If you are not logged in to DCE, you see the followingp              message:i  Z              %ACMSXP-W-IVPDCELGN, You must be logged in to DCE (use dce_login) to run IVP.  7           7. Specifying the System Default Installatione  B              VMSINSTAL asks whether you want this to be the system,              default installation of ACMSxp:  V              * Do you want this to be the system default installation of ACMSxp? [YES]  D              If you answer No, each user must execute this version'sB              ACMS_SET_VERSION.COM in order to use ACMSxp software.  ?              If you answer Yes, this version becomes the systemo?              default version. That is, when the system runs thei?              ACMSxp startup procedure, users do not have to runzD              ACMS_SET_VERSION.COM, because this version of ACMSxp isD              defined systemwide. For information on changing a localD              version to a system default version, see Section 3.6.1.  E           8. Displaying information on the ACMS_START_TPSYSTEM rights4              identifier0  ?              VMSINSTAL displays this next section if it detects2B              that the rights identifier ACMS_START_TPSYSTEM is notE              present. If the rights identifier is present, then after D              you answer the question about the default installation,)              no more questions are asked.   O                 In order to run  ACMSxp without the sysprv privilege the rights L                 identifier ACMS_START_TPSYSTEM will be added to your system.  P                 If ACMSxp is being installed in a cluster and the rightslist.datJ                 file is not shared amongst cluster members then the rightsQ                 identifier must be created on all other cluster members that willtW                 run ACMSxp.  You can run the image ACMS_SYS_DIR:ACMS_ADD_IDENTIFIER.EXErP                 to create or recreate the ACMS_START_TPSYSTEM rights identifier.  )     2-6 Installing Compaq ACMSxp Softwarer o  s              X                     The identifier ACMS_START_TPSYSTEM is used in creating an ACE on theX                     LNM$SYSTEM_DIRECTORY logical name table.  This ACE will allow ACMSxpR                     to create logical name tables as needed and attach them to theZ                     LNM$SYSTEM_DIRECTORY logical name table.   The following example showsW                     how to add this ACE to the  LNM$SYSTEM_DIRECTORY logical name table =                     using the ACMS_START_TPSYSTEM identifier.p  R                     $ SET SECURITY LNM$SYSTEM_DIRECTORY/CLASS=LOGICAL_NAME_TABLE -T                       /ACL=(IDENTIFIER=ACMS_START_TPSYSTEM,ACCESS=WRITE+READ+CREATE)  R                     You should place this command in a system startup file such asV                     sylogicals.com or sysecurity.com so that the ACL will be preserved*                     across system reboots.  W                     The rights identifier ACMS_START_TPSYSTEM will now be added to yourV                     system.n  Q                     %ACMSXP01-I-ADDID, This installation adds an IDENTIFIER named>(                     ACMS_START_TPSYSTEM.  X                     The rights identifier ACMS_START_TPSYSTEM will now be granted to theW                     logical name table LNM$SYSTEM_DIRECTORY.  This identifier should be X                     granted to those accounts that will start ACMSxp tpsystems using the&                     following command:  =                     UAF> GRANT/IDENTIFIER ACMS_START_TPSYSTEMvY                         %UAF-I-GRANTMSG, identifier ACMS_START_TPSYSTEM granted to CRAMER   M                             The command in this example grants the identifier Y                             ACMS_START_TPSYSTEM to the user named Cramer.  Cramer becomes U                             the holder of the identifier and any resources associatedo$                             with it.  ,               9. Continuing the installation  E                  If the rights identifier ACMS_START_TPSYSTEM was not I                  present, then you are asked to enter return to allow the *                  installation to continue.  ,                  * Press return to Continue:  F                  After you enter Return, VMSINSTAL ends the questions.  D               VMSINSTAL signals the end of the questions as follows:  F               %ACMSXP-I-DONEASK, No more questions will be asked . . .  I                                     Installing Compaq ACMSxp Software 2-7w t                 E           The procedure copies files and prints some instructions for D           you to follow. The elapsed time should be no more than tenC           minutes. When a message similar to the following appears,r#           the installation is done:s  5                    VMSINTSTAL procedure done at 12:07   D           See Section 2.4 for discussion of errors that might occur.  D     2.3 Running the ACMSxp Installation Verification Procedure (IVP)  9           The ACMSxp IVP verifies that the ACMSxp productr#           installation is sound by:   D           o  Checking that all ACMSxp installation prerequisites are              met.s  C           o  Compiling and linking STDL servers to ensure that STDL B              task servers can be compiled and linked (if an ACMSxp*              developer license is active).  C           o  Executing ACMSxp run-time system operations, to ensure *              that STDL servers can be run.  A           o  Performing ACMSxp system management operations usingnD              the ACMSxp director software, to ensure that management!              software can be run.n  >           o  Checking that ACMSxp request queuing services are              functional.  @           Run the ACMSxp IVP automatically from VMSINSTAL during=           ACMSxp product installation or at any time after an -           installation of the ACMSxp product.   D           To run the ACMSxp IVP outside of the installation, perform           the following steps:  A           1. Ensure that the DECdtm software is configured on the %              system. See Section 3.4.s  C           2. Log in to DCE using the DCE principal that you created C              for the IVP as described in Section 1.10. For example:p  $              $  DCE_LOGIN acmsxp_svr              Enter Password:              $  C              DCE software prompts for the password for the account.   )     2-8 Installing Compaq ACMSxp Software  k  c              B               3. Execute the following commands at the DCL prompt:  ?                  $  @USER1:[ACMSXPV0321.SYSEXE]ACMS_SET_VERSION 0                  ACMSxp V3.2-1 for OpenVMS Alpha`                  Copyright (c) 1993, 1999 by Digital Equipment Corporation. All Rights Reserved.;                  Using ACMSxp in USER1:[ACMSXPV0321.SYSEXE]C2                  $  @ACMS_SYS_DIR:ACMS_RUN_IVP.COM                     .                      .                      .                   $  I                  These commands set the ACMSxp version and start the IVP,NF                  which displays status messages about operations beingF                  performed. More detailed information is stored in log                  files.t  E               To examine the contents of ACMSxp IVP log files, follow                these steps:  E               1. To read about the operations performed during an IVPeH                  run, enter at the DCL prompt a command in the following                  format:  B                  TYPE device-name:[ install_root ]ACMS_IVP_RUN.TXT  I                  The variable install_root is the directory specificationiA                  of the location holding the ACMSxp software kit.   G               2. To examine the IVP log file, enter at the DCL prompt af1                  command in the following format:   D                  ACMS LIST LOG [install_root.SYSTEST]IVP_TPSYS_name_         DEFAULT.LOGa  F                  The binary file IVP_TPSYS_name_DEFAULT.LOG is createdH                  by the ACMSxp event logger during the IVP. This file isF                  generated using the local language in effect when the!                  IVP is executed.            2.4 Error Recovery  H               If errors occur during the installation itself or when theI               IVP is running, VMSINSTAL displays failure messages. If them@               installation fails, you see the following message:  O               %VMSINSTAL-E-INSFAIL, The installation of ACMSxp V3.2 has failed.o  I                                     Installing Compaq ACMSxp Software 2-9                    3           If the IVP fails, you see these messages:   )           The ACMSxp IVP aborted on errorn  @           Use the following commands to obtain more information:1           $ TYPE/PAGE <directory>ACMS_IVP_RUN.TXT O           $ ACMS LIST LOG [<install_root>.SYSTEST>]IVP_TPSYS_<name>_DEFAULT.LOG   K           %VMSINSTAL-E-INSFAIL, The installation of ACMSxp V3.2 has failed.l  D           If any of the following conditions exist, errors can occur"           during the installation:  /           o  The operating system is incorrect.c  E           o  A version of prerequisite software product is incorrect.o  >           o  Quotas necessary for successful installation were              insufficient.  D           o  System parameters necessary for successful installation              were insufficient.o  :           o  The OpenVMS help library is currently in use.  C           For descriptions of the error messages generated by thesee=           conditions, see the OpenVMS documentation on system(=           messages, recovery procedures, and OpenVMS softwareCE           installation. Use the online message facility with a searche5           string from the error message. For example:   #           $  HELP/MESSAGES LOWQUOTAdB            LOWQUOTA,  the following account quotas may be too low:  7             Facility:     VMSINSTAL, Install Procedures   X             Explanation:  When VMSINSTAL begins an installation, it makes sure that yourF                           process quotas are valid. This check failed.  Q             User Action:  You are asked if you want to continue the installation.kS                           Compaq recommends that this situation is corrected before %                           continuing.y                .              .              .           $a  *     2-10 Installing Compaq ACMSxp Software    e              D               The command tells the software to display all messagesD               containing the specified string. The software displaysF               the name of the facility responsible for the message, anI               explanation of what the message means, and recommended user E               actions to follow the recover from the error condition.e  E               If you are notified that any of these conditions exist,nF               take the appropriate action as described in the message.H               For information on installation requirements, see Sections               1.3 and 1.4.  <               If the installation fails, you must delete anyC               subdirectories in the root installation directory and:1               restart the installation procedure.t                                                              I                                    Installing Compaq ACMSxp Software 2-11m o  e                    I                                                                         3 I         _________________________________________________________________e  I                                   After Installing Compaq ACMSxp Softwarem    E               This chapter describes actions to take after installingsE               ACMSxp software but before running the installed ACMSxpw               software.s  7         3.1 Installing the ACMSxp Management GUI Option   D               With the Compaq ACMSxp for OpenVMS Alpha software, youG               have an option for the ACMSxp Administration Graphic UsercH               Interface (GUI) that you can install on a Windows NT IntelG               platform and use to manage your ACMSxp applications. This E               software provides ACMSxp system management capabilitieseE               for a PC Windows environment. Referred to as the ACMSxpMB               Management GUI, the software provides easy access toH               similar functionality available through the ACMSxp CommandB               Line Interface (CLI) director. The GUI comes with an*               extensive Windows Help file.  #         3.1.1 Prerequisite Softwaree  G               Before you install the GUI option, ensure that you do thee7               following on the Windows NT Intel system:s  B               o  Configure the Windows NT system to use the TCP/IP                  protocol.  3                  This can be a local configuration..  F               o  Establish a local disk, either NTFS or FAT, with long                  file names.  E               o  Install either the Compaq DCE for Windows NT Runtime >                  Services kit or the Compaq DCE for Windows NT-                  Application Developer's kit.   H               o  Establish access to a DCE CDS server and a DCE security:                  server either locally or on your network.  I                               After Installing Compaq ACMSxp Software 3-1o s  t              @           The versions of the prerequisite software are shown in           Table 3-1.  E           Table_3-1_Prerequisite_Software_Version_Numbers____________   E           Software______________Version_Number_______________________e  #           Compaq DCE            2.0   E           Windows_NT____________4.0_with_Service_Pack_3______________        3.1.2 System Requirements   @           Install the GUI software on Windows NT Intel platforms&           only. The software requires:  ;           o  A minimum screen resolution of 800x600 pixels.   E           o  20 megabytes of free disk space during the installation.   ;           o  10 megabytes of disk space after installation.   9     3.1.3 Procedures to Install the ACMSxp Management GUIi  D           To install the ACMSxp Management GUI option on the Windows7           NT Intel system, perform the following steps.   E           1. On the Windows NT system, create a new disk directory to 4              contain the GUI option set-up software.  D           2. On the Windows NT system, change directory to the newly              created directory.D  >           3. From the system on which you installed the ACMSxp>              software, copy the self-expanding file containing@              the GUI option set-up software to the newly created              directory.   >              Named gui_kit_intel.exe, this file resides in theE              directory to which the ACMS_SYS_DIR logical name points.a  ?           4. From the newly created directory on the Windows NTSB              system, run the gui_kit_intel.exe file to extract the              set-up files.  ?           5. From the newly created directory on the Windows NT D              system, run the setup.exe program to install the ACMSxp              Management GUI.  /     3-2 After Installing Compaq ACMSxp Softwarep e  e              A               The setup.exe program asks you to choose either the I               companion or the standalone software option. The standaloneDG               software option is designed to run on a Windows NT systemtE               that does not have ACMSxp software installed. If you do G               not have ACMSxp base software installed on the Windows NT I               system, install the GUI standalone software option. Because B               the standalone software option registers environmentD               variables that are used by other ACMSxp components, doG               not install this option if you have any version of ACMSxp H               software installed on the Windows NT system. The companionG               software option is designed to run on a Windows NT system F               with Compaq ACMSxp for Windows NT software also running.  C               The gui_kit_readme_intel.txt file in the directory to F               which the ACMS_SYS_DIR logical name points contains more,               information about the options.  8         3.1.4 Installing on a Japanese Windows NT System  G               During the installation of the ACMSxp management GUI on aSH               Japanese Windows NT platform, a dialog box may appear with*               the following error message:  C               There is not enough disk space in one or more drives.   @               If this message appears, click Install Now and the-               installation proceeds normally.   0         3.2 Creating and Modifying User Accounts  4               To run ACMSxp software, users require:  G               o  User account privileges to create, delete, and start a F                  TPsystem; issue management directives; and use ACMSxp                  commandsM  >               o  Minimum process quotas to use ACMSxp commands  C               Sections 3.2.1 and 3.2.2 describe these requirements.o  2         3.2.1 Setting Privileges for User Accounts  G               To perform the following operations, a user account needsN0               to follow prescribed requirements.  ,               o  Create or delete a TPsystem  !               o  Start a TPsystemt  I                               After Installing Compaq ACMSxp Software 3-3h u  i              @           o  Run task servers and processing servers under a UIC5              different from that of the TP controllery  >           o  Execute any management directive and ACMS command  ?           o  Debug a server using the ACMS command DEBUG SERVER   D           See Compaq ACMSxp Developing and Managing Applications for;           information on user account and UIC requirements.   E           If you need to modify privileges, use the OpenVMS AuthorizetC           Utility (described in Section 3.2.2). To add a privilege,I@           enter the MODIFY command at the UAF> prompt, using the           following format:s  D           MODIFY account-name/PRIVILEGE=([NO]privilege-name [, . . .     ])  >           The command accesses the system account file and the?           account record specified. Messages displayed tell youY+           whether the modification is made.S  :     3.2.2 Setting Minimum Process Quotas for User Accounts  @           Table 3-2 lists the process quotas required for ACMSxp           commands.T  E           Table_3-2_Minimum_Process_Quotas_for_ACMSxp_Commands_______e  "                            MinimumE           Quota____________Setting___________________________________   "           ASTLM                 24  "           BIOLM                 18  "           BYTLM[1]         100 000  "           CPU               (none)  "           DIOLM                 22  "           ENQLM              3 200  "           FILLM                200  "           JTQUOTA            4 096  "           MAXACCTJOBS            0  E           [1]BYTLM_must_be_at_least_150_000_to_run_the_IVP.__________i  E                                              (continued on next page)   /     3-4 After Installing Compaq ACMSxp Software- D  ,              A               Table 3-2 (Cont.) Minimum Process Quotas for ACMSxpSI               __________________Commands_________________________________n  &                                MinimumI               Quota____________Setting___________________________________   &               MAXDETACH              0  &               MAXJOBS                0  &               PBYTLM                 0  &               PGFLQUO           75 000  &               PRCLM                 10  &               PRIO                   4  &               QUEPRIO                0  &               SHRFILLM               0  &               TQELM                100  &               WSDEF              1 024  &               WSEXTENT           8 192  I               WSQUO______________4_096___________________________________e  G               If you compile large task groups (for example, 600 tasks) F               or large processing groups (for example, 300 procedures)I               with a page file quota set to the minimum required, you cann>               see the following error from the DEC C compiler:  J               %CC-F-TEXT, Compiler abort - virtual memory limits exceeded.  D               To eliminate the error, increase the paging file quota#               (Pgflquo) to 300 000.:  H               The minimum BYTLM quota for the user process that starts a-               TPsystem is shown in Table 3-2.g  H               If your application uses large audit records, you may need=               to set the BYTLM quota to an even larger value.o  E               Use the VMS Authorize Utility (AUTHORIZE) to verify andW=               change user account quotas. Follow these steps:   A               1. Set your default directory to SYS$SYSTEM and rune                  AUTHORIZE:e  *                  $  SET DEFAULT SYS$SYSTEM!                  $  RUN AUTHORIZEp                  UAF>i  I                               After Installing Compaq ACMSxp Software 3-5c                   C           2. At the AUTHORIZE prompt (UAF>), enter the SHOW commandiD              with an account name to check a particular account. For              example:o                UAF>  SHOW SYSTEM                 .c                 .(                 .               UAF>c  E              The command displays the current settings for the SYSTEMo              account.   D           3. To change a quota, enter the MODIFY command at the UAF>0              prompt, using the following format:  0              MODIFY account-name/quota-name=nnnn  B              The following example changes the Bytlm quota for the'              SYSTEM account to 100 000:   -              UAF>  MODIFY SYSTEM/BYTLM=100000a              UAF>M  E              The command access the SYSTEM account record to make ther              change.  C           4. Exit from the Authorize Utility with the EXIT command:d                UAF>  EXITo                 .o                 .                  .h              $  A              When you exit from the Authorize Utility, the system A              displays messages that indicate whether changes weree              made.  C           You must log out and log in again for the changes to take C           effect. For more information on modifying account quotas, E           see the description of the Authorize Utility in the OpenVMS @           System Management Subkit. See Compaq ACMSxp Developing@           and Managing Applications for information on using theD           ACMS_PROCESS_QUOTAS logical name to set process quotas for%           ACMSxp application servers.V  /     3-6 After Installing Compaq ACMSxp Software  D  t                       3.3 System Tuningr  H               ACMSxp software requires certain system software resourcesC               to run properly. The system parameter values shown in <               Table 1-3 are required to run ACMSxp software.  =         3.3.1 Physical I/O Pages Parameter for ACMSxp Queuings  D               If your ACMSxp application uses queuing, determine theF               requirements for the system parameter PIOPAGES (used forD               RMS journaling). To determine the minimum value that aI               queuing feature might require, use the following variables:   H               num_piopages          Minimum number of physical I/O pagesH                                     needed for the ACMSxp queuing server  G               m_threads             Maximum number of threads in one ofCG                                     the ACMSxp system servers supplyingt7                                     the queuing servicei  B               Use the formula in (3-1) for each server supplying a1               queuing service used in a TPsystem.   I                           num_piopages = (18*m_threads)*1.05        (3-1)_  A               The number of threads m_threads equals value of the B               maximum threads attribute for ACMS_RECQU_SVR (recordF               queue server) or ACMS_RSEND_SVR (recoverable send serverH               which uses the send queue). The value can be found throughE               ACMSxp system administration software under the maximumfB               threads attribute. For ACMS_QUEUE_SVR (request queueE               server), multiply the maximum thread attribute value by G               2. For example, if the value for the request queue server H               displayed through ACMSADMIN is 15, use 30 for m_threads in)               the formula shown in (3-1).g  C               Refer to Section 3.3.4 for guidelines on checking andP*               modifying system parameters.              I                               After Installing Compaq ACMSxp Software 3-7  o  t              4     3.3.2 Working Set Parameters for Request Queuing  E           Compaq recommends that the ACMSxp system server acms_queue_ B           svr process run with the following working set parameter           values.   '           WSEXTENT              100 000   '           WSQUO                 100 000a  C           If all processes on the system can run with these values, ?           refer to Section 3.3.4 for guidelines on checking and >           modifying system parameters. If all processes on theE           system do not have to run with these values, use the ACMSxpfC           director to add in the environment variables attribute of E           the queue server entity an entry for the name ACMS_PROCESS_eE           QUOTAS and values for the parameter values. Refer to CompaqoD           ACMSxp Developing and Managing Applications for guidelinesB           on configuring servers and setting values for this name.  3     3.3.3 System Parameter for DECnet-Plus Softwaret  A           If a TPsystem uses DECnet-Plus software, set the systemG+           parameter KSTACKPAGES as follows:w              KSTACKPAGES    =     2  ?           Refer to Section 3.3.4 for guidelines on checking and &           modifying system parameters.  =     3.3.4 Checking and Modifying System Parameters for ACMSxp            Software  B           If you need to check current values of system parameters?           for ACMSxp and related product requirements listed in ?           Sections 1.4, 3.3.1, and 3.3.3, follow the procedures #           outlined in this section.y  =           To check the values of system parameters, enter the ?           following command at the DCL prompt to invoke SYSGEN:   "           $  RUN SYS$SYSTEM:SYSGEN           SYSGEN>   ?           The command starts the SYSGEN program, which displaysf=           its prompt, at which you can enter commands. At theb@           SYSGEN> prompt, enter the SHOW command and the name of%           the parameter. For example:   /     3-8 After Installing Compaq ACMSxp Softwarer n  i              &               SYSGEN>  SHOW CHANNELCNT                  .                  .                  .               SYSGEN>   F               The command accesses the current value of the CHANNELCNTC               parameter in memory and displays its value. After youaD               examine the parameter with the SHOW command, enter the1               EXIT command at the SYSGEN> prompt.e  @               Use the AUTOGEN command procedure to change systemB               parameters. AUTOGEN automatically adjusts values forF               parameters that are associated with the values you resetF               manually. To change system parameters with AUTOGEN, edit!               the following file:_  &               SYS$SYSTEM:MODPARAMS.DAT  E               Use an editor to access the file. To change a parameter A               value listed in this file, delete the current valueaE               associated with that parameter and enter the new value.A  A               To add a new parameter, add a line to the file that D               includes both the name of the parameter and its value.               For example:                 CHANNELCNT = 2047A  H               You can help tune your system. Specify a minimum value forE               parameters in the parameters file to let AUTOGEN decideaH               the most efficient value at or above the specified amount.E               To indicate parameters with minimum values, precede thenH               parameter name with MIN_ and supply the minimum value. For               example:  #               MIN_CHANNELCNT = 2047   C               The values for GBLPAGES and GBLSECTIONS represent the)H               number of contiguous free global pages and global sectionsE               required for the installation, not the total number youi9               need to run your system and other software.   ?               To install and run ACMSxp software, you must havenE               sufficient contiguous free global pages and free globaloD               sections. You must first find out how many free globalH               pages and sections you have on your system. If you need to  I                               After Installing Compaq ACMSxp Software 3-9o N  u              B           increase the GBLPAGES and GBLSECTIONS system parameters,           use AUTOGEN.  A           You can use the WRITE command with the F$GETSYI lexical E           function to find the number of contiguous free global pageseC           and free global sections. The following example shows howpC           to get this information at your terminal (the default forr           SYS$OUTPUT):  9           $  WRITE SYS$OUTPUT F$GETSYI("CONTIG_GBLPAGES")i           15848s7           $  WRITE SYS$OUTPUT F$GETSYI("FREE_GBLSECTS")_           24           $_  ?           To modify incremental parameters such as GBLPAGES andiC           GBLSECTS, precede the parameter name with ADD_ and supply.A           the incremental value. The following line increases thed%           global page setting by 100:              ADD_GBLPAGES = 100  @           After you make all your changes, exit from the editor.  B           Execute the AUTOGEN procedure to recalculate your systemD           parameters. Enter the following command at the DCL prompt:  /           $  @SYS$UPDATE:AUTOGEN GETDATA REBOOT               .              .              .           $n  @           When you specify REBOOT, AUTOGEN performs an automatic@           system shutdown and then reboots the system. Any usersE           logged in to the system are immediately disconnected during.C           the shutdown. The automatic reboot puts the new parameter            values into effect.   ?           The AUTOGEN utility automatically adjusts some of the A           SYSGEN parameters based on the consumption of resourceseE           since the last reboot. If you do not want to take advantagey<           of this automatic adjustment or if your system hasA           been running less than 24 hours, include the NOFEEDBACKm=           qualifier on the AUTOGEN command line. For example:t  0     3-10 After Installing Compaq ACMSxp Software t  e              >               $  @SYS$UPDATE:AUTOGEN GETDATA REBOOT NOFEEDBACK                  .                  .                  .               $e  G               For more information about using AUTOGEN, see the OpenVMSf'               System Management Subkit.e  5         3.3.5 Setting UCX Parameters for DCE Softwares  E               DCE software operation on a node requires the followingo+               minimum UCX parameter values:   I               ___________________________________________________________tI               Parameter_____________Value________________________________e  (               Device sockets         600  (               Large buffers          600  I               Small_buffers_________2000_________________________________   D               To correct an inadequate number of UCX device sockets,A               increase the number of UCX device sockets and smallf#               buffers. For example:   0               UCX>  SET COMMUNICATION/DEVICE=600:               UCX>  SET COMMUNICATION/SMALL=(MAXIMUM=2000)               UCX>  B               See DCE 1.3 Release Notes for details on setting UCXC               parameters and DEC TCP/IP Services for OpenVMS Systeme5               Management for more information on UCX.g  5         3.3.6 Maintaining DECnet Configuration Values   H               The number of servers that can be run on a DECnet Phase IVE               node is dependent on the parameters shown in Table 3-3.I  I               Table_3-3_DECnet_Phase_IV_Parameters_______________________i  I               Parameter__________________Value___________________________e  -               MAX BROADCAST NONROUTER    1023   -               MAX DECLARED OBJECTS       1023w  I                                                  (continued on next page)i  I                              After Installing Compaq ACMSxp Software 3-11  u  :              E           Table_3-3_(Cont.)_DECnet_Phase_IV_Parameters_______________   E           Parameter__________________Value___________________________   E           MAXIMUM_LINKS_______________240____________________________   =           The value for MAX BROADCAST NONROUTER is set at the B           maximum; MAX DECLARED OBJECTS can be a maximum of 16383.E           Compaq recommends that you set the listed parameters to thee           values shown.l  >           If the Max broadcast nonrouters and Maximum Declared@           Objects parameters are not set as listed in Table 3-3,?           you possibly see the DCE error "can't listen socket".   ,     3.3.6.1 Guidelines for Calculating Links  B           DECnet allows a maximum of 960 logical links. This value>           is reduced to 512 if the alias maximum links is also?           specified. The default value for maximum links is 32.C  B           To determine the maximum number of links that a TPsystem1           might use, use the following variables:n  :           cl_proc               Number of client processes  7           l_links               Number of logical links   <           p_svrs                Number of processing servers  E           p_svrs_proc           Number of processing server processeso  6           t_svrs                Number of task servers  E           If the client processes reside on the same node as the taskt;           and processing servers, use the formula in (3-2).i  D             l_links = 2(t_svrs*p_svrs*p_svrs_proc)+4(cl_proc*t_svrs)E                                                                 (3-2)   E           For example, if a TPSYSTEM has 5 clients, 3 task servers, 3 D           processing servers, and 4 processes per processing server,?           all running on the same node, calculate the number of $           logical links as in (3-3).  E                           l_links = 2(3*3*4)+4(5*3)             (3-3)   ?           The maximum number of logical links that the TPSYSTEM *           utilizes in this example is 132.  0     3-12 After Installing Compaq ACMSxp Software                   H               If the client processes reside on different nodes than theB               task and processing servers, calculate two formulas.  H               o  For each each node running client processes, use (3-4).  I                                 l_links = 2(cl_proc*t_svrs)         (3-4)p  F               o  For the node running the task and processing servers,                  use (3-5).   I                  l_links = 2(t_svrs*p_svrs*p_svrs_proc)+2(cl_proc*t_svrs) I                                                                     (3-5)g  E               Using the above example, if the clients are all running F               on one node, that node requires 30 logical links and theG               node running the task and processing servers requires 102                logical links.  :         3.3.7 Maintaining DECnet-Plus Configuration Values  F               To run 20 or more ACMSxp users, increase the NSP MAXIMUMG               TRANSPORT CONNECTIONS parameter. If this parameter is set H               too low, applications may fail with RPC connection abortedI               messages appearing in your ACMSxp default event log file asl               follows:  "                   SEVERITY:  error  Q                   rpc MESSAGE TEXT:  connection aborted by local host (dce / rpc)qW                   tps MESSAGE TEXT:  %%TPS-E-INTFTEMPUNAVAIL, RPC interface temporarilye                   unavailable   E               Use the NCL utility to observe parameters necessary for G               NSP communications. Use the NCL SHOW directive to examine G               the NSP maximum transport connections and maximum receive .               buffers as shown in Example 3-1.  2               Example 3-1 Examining NSP Attributes  I                                                  (continued on next page)T          I                              After Installing Compaq ACMSxp Software 3-13T I                 6           Example 3-1 (Cont.) Examining NSP Attributes  J           $  MCR NCL SHOW NODE 0 NSP TRANSPORT MAX TRAN CONN,MAX RECE BUFF             Node 0 NSP.           at 1998-07-09-17:01:59.553-04:00Iinf             Characteristics   6               Maximum Transport Connections     = 10006               Maximum Receive Buffers           = 8000           $   B           The values for the indicated attributes must be equal toA           or greater than those shown. If they are not, check theo>           configuration script file at the following location:  3           SYS$MANAGER:NET$NSP_TRANSPORT_STARTUP.NCL   E           Ensure that similar lines having values equal to or greatern>           than the values shown are in the configuration file.  ;           SET NODE 0 NSP MAXIMUM TRANSPORT CONNECTIONS 1000 ;           SET NODE 0 NSP MAXIMUM RECEIVE BUFFER        8000M  E           To increase the NSP maximum transport connections parameterc5           and related parameters, proceed as follows:o  %           1. Edit the following file:D  6              SYS$STARTUP:NET$NSP_TRANSPORT_STARTUP.NCL  B           2. Increase the following parameters for the NSP entity:  $              A. Maximum remote NSAPs  -              B. Maximum transport connections   D                 Value must be less than the value for maximum remote                 NSAPs.                C. Maximum window  D                 Value must be greater than or equal to the number ofD                 maximum receive buffers divided by maximum transport                 connections.  '              D. Maximum receive bufferst  D                 Value of maximum receive buffers must be eight times?                 the value of the maximum transport connections.y  0     3-14 After Installing Compaq ACMSxp Software                   G               The SET commands that set the parameters must precede theA0               line that enables NSP on the node.  I               After editing the startup file, create a backup copy of thewI               file. The system overwrites the file when NET$CONFIGURE.COMS9               is run, so a backup copy should be created.   F               Shut down and restart the network either from the system/               console or from a LAT connection:r  3               1. Shut down the network by entering:M  -                  $  @SYS$STARTUP:NET$SHUTDOWNi                     .t                     .                      .s                  $  1               2. Restart the network by entering:e  /                  $  @SYS$SYSTEM:STARTUP NETWORKn                     .,                     .a                     .                   $  F               When the network restarts, the new values are in effect.  <         3.4 Configuring DECdtm-Journal File and Logical Name  F               To create and start ACMSxp TPsystems and to execute taskH               servers, DECdtm must be running and have a journal file to7               which it can log transaction information.h           3.4.1 Logical Name  B               The logical name SYS$DECDTM_INHIBIT must not be set.F               Setting this logical name prevents DECdtm from starting.7               If this logical name is set, deassign it.a           3.4.2 Journal File  I               DECdtm requires a journal file with a name in the followinge               format:   (               SYSTEM$nodename.LM$JOURNAL  F               The node name is the DEC/net Phase IV simple name of theI               node. The file must reside in the SYS$JOURNAL directory. If G               this file does not exist, no DECdtm calls are successful.i  I                              After Installing Compaq ACMSxp Software 3-15t v  e              C           If you have DECdtm-related problems, look for the journaleC           file. If none exists, use the Log Manager Control Program +           (LMCP) to create one, as follows:i  ?           1. Run the program with the MCR command. For example:                 $  MCR LMCP  -              Log Manager Control Program V1.1w                LMCP>  <           2. Use the CREATE command in the following format:  8              CREATE LOGFILE SYS$JOURNAL:SYSTEM$node_name  =              This creates a journal file with an extension ofgE              LM$JOURNAL and a default size of 4000 blocks. A suitable0D              file size depends on the expected transaction load. ForA              example, Compaq recommends that a system running teneD              users, three task servers, and three processing servers8              start with a journal file of 10 000 blocks:  D              CREATE LOGFILE /SIZE=10000 SYS$JOURNAL:SYSTEM$node_name  B              The command creates the file with the specified size.  )     3.5 Modifying Node Startup ProceduresC  B           The installation creates a startup procedure that may be@           added to the system startup file, SYS$MANAGER:STARTUP_:           VMS.COM. For this kit, the startup procedure is:  ,           SYS$STARTUP:ACMSXPV032$STARTUP.COM  E           This procedure runs the ACMS_SET_VERSION.COM procedure from-A           the SYSEXE subdirectory where the product is installed.f  !     3.6 VMScluster Considerations=  C           If you want to run ACMSxp software on multiple nodes of anB           VMScluster network, first check to see that you have theA           appropriate software licenses. After you install ACMSxp 0           software, perform the following steps:  ;           1. Issue the LICENSE LOAD command to activate thee@              appropriate licenses on each node in the VMSclusterA              on which ACMSxp software is to be executed. Refer too7              OpenVMS License Management Utility Manual.   0     3-16 After Installing Compaq ACMSxp Software N                 E               2. Execute the ACMSXPV032$STARTUP.COM procedure on eachrI                  node of the VMScluster on which ACMSxp software is to bec+                  executed. See Section 3.5.   A               3. If logged-in users want to use the ACMS and STDLeD                  commands, they must log out and log in again or use%                  the DCL SET command:G  <                  $  SET COMMAND/TABLES=SYS$LIBRARY:DCLTABLES                  $  C                  The command runs the Command Definition utility tovC                  add the ACMSxp commands from the specified commands"                  definition table.  I                  This step is required. The ACMSxp installation procedurecF                  modifies the DCL command table so that the ACMSxp andE                  STDL commands are recognized and processed. However,aH                  the previous command table is still in effect for those3                  users who are currently logged in.g  F               4. Execute the following command on all other VMScluster                  members:M  9                  $  INSTALL REPLACE SYS$LIBRARY:DCLTABLESi                  $  E                  The command associates the latest version of the DCLaE                  tables image with the current known installed image.A  D               When these procedures are complete, ACMSxp software is$               installed clusterwide.  <         3.6.1 Setting Up a Systemwide Default ACMSxp Version  F               To change a local default version of ACMSxp software (inF               which each user must run ACMS_SET_VERSION.COM to use) toG               a systemwide default version (in which all users at logina@               have the same ACMSxp version available), you must:  <               1. In the ACMSxp startup procedure (located inD                  SYS$STARTUP:) remove the comment from the line thatE                  passes the SYSTEM parameter to ACMS_SET_VERSION.COM.f  G               2. Place the comment on the other line invoking ACMS_SET_o                  VERSION.COM.   I                              After Installing Compaq ACMSxp Software 3-17o                   C           3. In all other versions of ACMSxp software that you haveaC              installed, comment out the line that passes the SYSTEMi@              parameter to ACMS_SET_VERSION.COM and uncomment the6              other invocation of ACMS_SET_VERSION.COM.  @           Only one ACMSxp version is the system default version.  8     3.7 Setting Up ACMSxp with Japanese Language Support  B           If you are running on an ACMSxp system with the JapaneseC           language environment, you need to check for the existence E           of catalog files. If the ACMSxp catalog files do not exist,c@           you need to adjust your environment. Do the following:  E           1. If you are not running with an ACMSxp systemwide defaultoC              version (see Section 3.6.1), set the ACMSxp version toY#              the one you installed.O  E           2. Determine the ACMSxp product root directory. The catalogSC              files are found in a language-specific subdirectory of D              the SYSMSG directory under the ACMSxp root directory toE              which the ACMS_SYS_DIR logical name points. From the DCL               prompt:  *              $  SHOW LOGICAL $ACMS_SYS_DIRP                 "ACMS_SYS_DIR" = "USER1:[ACMSXPV032.SYSEXE]" (LNM$PROCESS_TABLE)              $  E           3. Look for the ACMSxp message catalogs in the subdirectoryrB              for the Japanese language under the SYSMSG directory.  D              $   DIRECTORY USER1:[ACMSXPV032.SYSMSG.JA_JP_SDECKANJI]  @              Directory USER1:[ACMSXPV032.SYSMSG.JA_JP_SDECKANJI]  !              TPS_API_LOCALE.CAT;1B                Total of 1 files.              $  D              The ACMSxp catalog files TPS.CAT and TPS_API.CAT should"              be in this directory.  @           4. If the files are not in the directory, define a new7              value for NLSPATH logical name as follows:   b     $  DEFINE NLSPATH "USER1:[ACMSXPV032.SYSMSG.%L]%N,USER1:[ACMSXPV032.SYSMSG.EN_US_ISO8859-1]%N"C     %DCL-I-SUPERSEDE, previous value of NLSPATH has been supersededn     $   0     3-18 After Installing Compaq ACMSxp Software e  o              A                  This setting allows access to the ACMSxp defaultE+                  English-language catalogs.m  G               If the files are in the directory, do not change NLSPATH.e                                                                                  I                              After Installing Compaq ACMSxp Software 3-19                          I                                                                         4mI         _________________________________________________________________r  I                                              Deinstalling ACMSxp Software     E               This chapter describes the deinstallation of the ACMSxp_F               software using the ACMS_DEINSTALL.COM command procedure.=               This process frees up resources for other uses.   '         4.1 Deinstallation Requirements   E               The ACMS_DEINSTALL.COM procedure requires the following0               privileges:_  C               o  CMKRNL-Allows the command procedure to replace theo8                  following file and remove known images:  (                  SYS$SHARE:DCLTABLES.EXE  H               o  SYSNAM-Allows the command procedure to deassign logical/                  names in the system name table   F               o  SYSPRV or BYPASS-Allows the command procedure to copy+                  DCLTABLES.EXE to SYS$SHAREC  @               Deinstalling either a nondefault or system defaultF               installation requires the same privileges. The procedure?               attempts to acquire all the above privileges. Any F               privileges acquired by the procedure are released before               it completes.   F               To deinstall ACMSxp software, use the ACMS_DEINSTALL.COMD               procedure found in the [.SYSEXE] product subdirectory.D               Invoke ACMS_DEINSTALL.COM either directly by using itsG               OpenVMS directory specification or by using the ACMS_SYS_ 9               DIR logical name (if defined). For example:   -               $  @ACMS_SYS_DIR:ACMS_DEINSTALL3                  .                  .                  .               $e  I                                          Deinstalling ACMSxp Software 4-1_ _  _              D           You must use the OpenVMS directory specification to locateE           the procedure on a system in which a partial deinstallation A           was done and ACMSxp logical names are now undefined, or @           to delete an installation for which the ACMSxp startup%           procedure has not been run.f  B           The deinstallation procedure deletes both system default@           and nondefault installations and can be invoked before?           or after ACMS_SET_VERSION.COM has been run. If ACMSxpd>           logical names are defined, those exclusive to ACMSxp?           are removed and those modified to include informationfD           related to ACMSxp have that information removed. All filesD           associated with the installation are then removed from theA           system, including the deletion procedure itself. If thegB           procedure is unable to delete one or more files, it doesB           not delete itself so that the system manager can correctA           the problem and rerun the procedure. ACMS_DEINSTALL can D           delete partially deleted installation trees. Before makingD           any changes, ACMS_DEINSTALL verifies that no TPsystems are8           present that were created by the installation.  7           Because the procedure uses relative directory-A           specifications, it must remain in the [.SYSEXE] productc           subdirectory.   /     4.2 Actions Performed During Deinstallation2  B           The deinstallation command procedure does the following:  6           o  Checks for stopped and running TP systems  :              The deinstallation procedure checks the ACMS_@              TPSYSTEMS.DAT file to see whether TPsystems relatedD              to this installation are present, and possibly running.C              If TPsystems are present, the deinstallation procedure A              notifies the user that the TPsystems must be stoppednE              (if necessary) and deleted before the deinstallation cani0              continue. The procedure then exits.  #           o  Modifies logical namesr  C              If the logical name ACMS_SYS_DIR is defined and pointsnE              to the location of the ACMS_DEINSTALL.COM being run, thekB              deinstallation modifies logical names associated withC              this installation. ACMSxp logical names are defined by)E              the startup procedure associated with each installation.*@              Logical names defined for use exclusively by ACMSxp  $     4-2 Deinstalling ACMSxp Software h  b              B                  software (ACMS_SYS_DIR and ACMS_EXAMPLES_DIR, forG                  example) are undefined by the deinstallation procedurenE                  and those that are modified by the startup (NLSPATH, C                  for example) have the information specific to this H                  installation removed. The deinstallation procedure thenE                  either redefines the logical name or, if the logical F                  name is empty after the information has been removed,,                  deassigns the logical name.  E                  The only way to guarantee that all logical names are D                  correctly set is to log out of the process in whichF                  ACMS_SET_VERSION.COM and ACMS_DEINSTALL.COM were run.  G                  The procedure searches logical name tables in standard F                  order, so that if you delete a system default versionG                  of ACMSxp for which you have also run ACMS_SET_VERSION F                  yourself, ACMS_DEINSTALL considers this to be a localF                  installation and does not modify the logical names in"                  the system table.  6               o  Deletes other shared files and images  F                  After modifying the logical names, the deinstallationF                  procedure asks whether you want to delete those itemsH                  shared by any other versions of ACMSxp installed on the                  system:  8                  -  Verb deletion from the command table  G                     You can remove the verbs related to ACMSxp from theu#                     following file:   ,                     SYS$SHARE:DCLTABLES.EXE.                     -  On-line Help  H                     You can delete the ACMSxp online help. Note that allF                     installations of ACMSxp on a system share the sameI                     online help. The help describes the latest version ofP                      the product.  >               o  Deletes files created during kit installation  A                  You must install ACMSxp into an empty directory.EE                  However, after the installation completes, users canNE                  place any files they wish into the product directory D                  tree. ACMS_DEINSTALL.COM deletes only the files andI                  directories that were either installed or created during I                  the installation. An exception is the [.SYSTEST] product G                  subdirectory in which the IVP runs. The deinstallatione  I                                          Deinstalling ACMSxp Software 4-3  a                 >              procedure deletes all files in [.SYSTEST] and theA              [.TEMP] and [.WORK] subdirectories under [.SYSTEST],               if present.  <              ACMS_DEINSTALL.COM also deletes the most recentB              version of the startup procedure for the kit from theE              SYS$STARTUP directory. If another copy of the ACMSxp kitsC              with the same version number has been installed on thecB              system and the startup procedure has been purged, theB              deinstallation procedure deletes the only copy of the&              ACMSxp startup procedure.  <           See Section 4.4 for the questions related to these           deletions made.a  .     4.3 Rerunning an Incomplete Deinstallation  B           If the deinstallation procedure cannot delete a file, it?           does not delete itself and can be rerun to delete then>           remaining files. Make any necessary changes to allowB           deletion, then rerun the deinstallation procedure. ACMS_>           DEINSTALL.COM can be run against a product directory;           tree in which not all files have been deleted. If :           ACMS_DEINSTALL.COM cannot delete a file, open or>           read an existing ACMS_TPSYSTEMS.DAT file, obtain theC           necessary privileges, or, if you enter a Control Y during D           deinstallation, the procedure exits with a status of 2. In2           all other cases, the return status is 1.  =           Each time the procedure runs, it attempts to delete A           from SYS$STARTUP the most recent version of the startup A           procedure for this version of ACMSxp. Because the firstoC           attempt at running the deinstallation procedure undefines @           the ACMSxp logical names associated with the kit being@           deinstalled, you cannot specify the logical name ACMS_@           SYS_DIR when invoking the procedure for any subsequent@           runs. Instead, use the OpenVMS directory specificationA           to point to the procedure. The deinstallation procedure B           then notifies you that ACMS_SET_VERSION has not been runC           and asks whether you wish to continue the deinstallation. '           Answer Yes (see Section 4.4).i        $     4-4 Deinstalling ACMSxp Software h  f              1         4.4 Questions Asked During Deinstallation   E               The deinstallation procedure can ask several questions. 8               Each question requires a Yes or No answer:  :               ACMS_SET_VERSION has not been run. Continue?  B               If the logical name ACMS_SYS_DIR is not defined, theD               procedure concludes that ACMS_SET_VERSION has not beenD               run and asks if deinstallation should continue. If youC               continue, any ACMSxp logical names that are currentlyo'               defined are not modified.   E               Deleting the type ACMSxp in product-directory Continue?a  5               The value type is one of the following:$  H               o  System default-for an installation that has been set up.                  as the default for the system  D               o  Local-for an installation to which a user points by.                  running ACMS_SET_VERSION.COM.  I               The value product-directory is the top-level directory into B               which this version of ACMSxp software was installed.  1               Delete ACMS and STDL command verbs?t  7               The command verbs ACMS and STDL reside inuE               SYS$SHARE:DCLTABLES.EXE. This question is asked whether D               or not the verbs have already been deleted. These verbI               definitions are shared by all installed versions of ACMSxp.$;               Answer No if other ACMSxp kits are installed.n  -               Delete all ACMSxp on-line help?   ?               There is only one set of online help text for all E               instances of ACMSxp software on a system. If other kitsoH               are installed, do not delete online help. This question isH               asked only if the deinstallation procedure determines that,               ACMSxp online help is present.        I                                          Deinstalling ACMSxp Software 4-5h                         I                                                                         AwI         _________________________________________________________________t  I                                                Sample ACMSxp Installation     H               The following sample listing shows a complete installationC               of Compaq ACMSxp software, including running the IVP.e            $  @sys$update:vmsinstalB         OpenVMS Alpha Software Product Installation Procedure V7.2!         It is 9-JUL-1999 at 16:11 7         Enter a question mark (?) at any time for help.   1         * Do you want to continue anyway [NO]?  y F         * Are you satisfied with the backup of your system disk [YES]?G         * Where will the distribution volumes be mounted: dka0:[000000]   R         Enter the products to be processed from the first distribution volume set.$         * Products:  ACMSXPAVME01032  <         * Enter installation options you wish to use (none):1         The following products will be processed:              ACMSXPAVME01 V3.2D  D                 Beginning installation of ACMSXPAVME01 V3.2 at 16:11  >         %VMSINSTAL-I-RESTORE, Restoring product save set A ...S         %VMSINSTAL-I-RELMOVED, Product's release notes have been moved to SYS$HELP.m  U         *****************************************************************************ET         Copyright (c) Digital Equipment Corporation 1993, 1999. All rights reserved.  F         Restricted Rights: Use, duplication, or disclosure by the U.S.J         Government is subject to restrictions as set forth in subparagraphJ         (c) (1) (ii) of DFARS 252.227-7013, or in FAR 52.227-19, or in FAR*         52.227-14 Alt. III, as applicable.  E         This software is proprietary to and embodies the confidential F         technology of Compaq Computer Corporation. Possession, use, orK         copying of this software and media is authorized only pursuant to aaG         valid written license from Compaq or an authorized sublicensor.:U         *****************************************************************************S  I                                            Sample ACMSxp Installation A-1Y M  r              /             Product:      ACMSXP-DEV, ACMSXP-RTc             Producer:     DECn             Version:      0.0V              Release Date: (NONE)  K     * Does this product have an authorization key registered and loaded?  y   @         The installation directory is where the files and imagesA       for this release are kept.  This directory and its contentsE;       may be placed in a disk and directory of your choice.e  F         The  directory  should  be  on  a  disk that is always mountedL       and accessible to all users of ACMSXP V3.2.  You must pick a directoryH       that can be used exclusively by ACMSXP V3.2; the directory must be       empty or not yet exist.e  G     * Where would you like to install ACMSxp [SYS$COMMON:[ACMSxpV032]]: >     * Do you want to run the IVP after the installation [YES]?Q     * Do you want this to be the system default installation of ACMSxp [YES]?  NO   F        In order to run  ACMSxp without the sysprv privilege the rightsC        identifier ACMS_START_TPSYSTEM will be added to your system.   G        If ACMSxp is being installed in a cluster and the rightslist.datdA        file is not shared amongst cluster members then the rightssH        identifier must be created on all other cluster members that willN        run ACMSxp.  You can run the image ACMS_SYS_DIR:ACMS_ADD_IDENTIFIER.EXEG        to create or recreate the ACMS_START_TPSYSTEM rights identifier.S  K        The identifier ACMS_START_TPSYSTEM is used in creating an ACE on theSK        LNM$SYSTEM_DIRECTORY logical name table.  This ACE will allow ACMSxp E        to create logical name tables as needed and attach them to theSM        LNM$SYSTEM_DIRECTORY logical name table.   The following example showsDJ        how to add this ACE to the  LNM$SYSTEM_DIRECTORY logical name table0        using the ACMS_START_TPSYSTEM identifier.  E        $ SET SECURITY LNM$SYSTEM_DIRECTORY/CLASS=LOGICAL_NAME_TABLE - G          /ACL=(IDENTIFIER=ACMS_START_TPSYSTEM,ACCESS=WRITE+READ+CREATE)   E        You should place this command in a system startup file such as I        sylogicals.com or sysecurity.com so that the ACL will be preserved         across system reboots.,  J        The rights identifier ACMS_START_TPSYSTEM will now be added to your        system.  A     %ACMSXP03-I-ADDID, This installation adds an IDENTIFIER namedx      ACMS_START_TPSYSTEM.   "     A-2 Sample ACMSxp Installation s  c              O            The rights identifier ACMS_START_TPSYSTEM will now be granted to theeN            logical name table LNM$SYSTEM_DIRECTORY.  This identifier should beO            granted to those accounts that will start ACMSxp tpsystems using the             following command:x  4            UAF> GRANT/IDENTIFIER ACMS_START_TPSYSTEMP                %UAF-I-GRANTMSG, identifier ACMS_START_TPSYSTEM granted to CRAMER  D                    The command in this example grants the identifierP                    ACMS_START_TPSYSTEM to the user named Cramer.  Cramer becomesL                    the holder of the identifier and any resources associated                    with it..  #         * Press return to Continue:h  B         %ACMSXP03-I-DONEASK, No more questions will be asked . . .  U         *****************************************************************************wB              This installation takes approximately 10 minutes on aB              DEC 4000 Model 620.  Your installation time will varyE              accordingly depending on your specific hardware platform U         *****************************************************************************   N         After installation, the IVP can be run with @ACMS_SYS_DIR:ACMS_RUN_IVP                                          I                                            Sample ACMSxp Installation A-3d u  o              C     %VMSINSTAL-I-SYSDIR, This product creates system disk directorye"           SYS$COMMON:[ACMSXPV032].C     %VMSINSTAL-I-SYSDIR, This product creates system disk directory +           SYS$COMMON:[ACMSXPV032.EXAMPLES]. C     %VMSINSTAL-I-SYSDIR, This product creates system disk directorys5           SYS$COMMON:[ACMSXPV032.EXAMPLES.AVERTZ_VM]. C     %VMSINSTAL-I-SYSDIR, This product creates system disk directoryN/           SYS$COMMON:[ACMSXPV032.EXAMPLES.STD]. C     %VMSINSTAL-I-SYSDIR, This product creates system disk directory 3           SYS$COMMON:[ACMSXPV032.EXAMPLES.STD_TPC]. C     %VMSINSTAL-I-SYSDIR, This product creates system disk directory 5           SYS$COMMON:[ACMSXPV032.EXAMPLES.AVERTZ_VR].eC     %VMSINSTAL-I-SYSDIR, This product creates system disk directoryw4           SYS$COMMON:[ACMSXPV032.EXAMPLES.EMPLOYEE].C     %VMSINSTAL-I-SYSDIR, This product creates system disk directoryr;           SYS$COMMON:[ACMSXPV032.EXAMPLES.EMPLOYEE.SERVER].aC     %VMSINSTAL-I-SYSDIR, This product creates system disk directoryd;           SYS$COMMON:[ACMSXPV032.EXAMPLES.EMPLOYEE.CLIENT]. C     %VMSINSTAL-I-SYSDIR, This product creates system disk directorye)           SYS$COMMON:[ACMSXPV032.SYSEXE]. C     %VMSINSTAL-I-SYSDIR, This product creates system disk directoryr)           SYS$COMMON:[ACMSXPV032.SYSHLP].xC     %VMSINSTAL-I-SYSDIR, This product creates system disk directory )           SYS$COMMON:[ACMSXPV032.SYSLIB].nC     %VMSINSTAL-I-SYSDIR, This product creates system disk directory )           SYS$COMMON:[ACMSXPV032.SYSMGR].tC     %VMSINSTAL-I-SYSDIR, This product creates system disk directoryd)           SYS$COMMON:[ACMSXPV032.SYSMSG]. C     %VMSINSTAL-I-SYSDIR, This product creates system disk directory 9           SYS$COMMON:[ACMSXPV032.SYSMSG.EN_US_ISO8859-1].rC     %VMSINSTAL-I-SYSDIR, This product creates system disk directorya9           SYS$COMMON:[ACMSXPV032.SYSMSG.JA_JP_SDECKANJI].BC     %VMSINSTAL-I-SYSDIR, This product creates system disk directoryT*           SYS$COMMON:[ACMSXPV032.SYSTEST].C     %VMSINSTAL-I-SYSDIR, This product creates system disk directoryl<           SYS$COMMON:[ACMSXPV032.SYSTEST.PRECOMPILED_FILES].:     %VMSINSTAL-I-RESTORE, Restoring product save set B ...:     %VMSINSTAL-I-RESTORE, Restoring product save set C ...:     %VMSINSTAL-I-RESTORE, Restoring product save set D ...  F         Please add the following line to SYS$MANAGER:SYSTARTUP_VMS.COM  '     @SYS$STARTUP:ACMSXPV032$STARTUP.COM     "     A-4 Sample ACMSxp Installation s  e              H          ***************************************************************H          * If this installation is performed on a cluster, for each    *H          * cluster node on which you want to run ACMSxp, you must:     *H          *      Load an ACMSxp license                                 *H          *      Run the ACMSxp startup procedure                       *H          *      $ INSTALL REPLACE SYS$LIBRARY:DCLTABLES                *H          ***************************************************************  V         %VMSINSTAL-I-MOVEFILES, Files will now be moved to their target directories...%         ACMSxp V3.2 for OpenVMS Alpha)W         Copyright (c) 1993, 1999 by Digital Equipment Corporation. All Rights Reserved.g?         Using ACMSxp in OKEEFE$DKA0:[SYS0.SYSCOMMON.ACMSXPV032]t  X         ================================================================================M           ACMSxp V3.2-1 for OpenVMS Alpha Installation Verification Proceduret+           beginning at  9-JUL-1998 16:14:50aX         ================================================================================           Setting up logicals...  '         ACMSxp V3.2-1 for OpenVMS AlphaoW         Copyright (c) 1993, 1999 by Digital Equipment Corporation. All Rights Reserved. $          Setting logicals succeeded.  *         Checking current process quotas.../          Current process quota check succeeded.   '         Cleaning namespace directory...a4          IVP namespace directory cleaning succeeded.  "         Cleaning work directory.../          IVP work directory cleaning succeeded.C           Checking disk space...$          Disk space check succeeded.  *         Creating ACMSADMIN symbols file...3          ACMSADMIN symbols file creation succeeded.   !         Creating IVP TP system...l*          IVP TP system creation succeeded.  %         Building IVP server images... +          IVP server Images build succeeded.   !         Starting IVP TP system... '          IVP TP system start succeeded.   I                                            Sample ACMSxp Installation A-5m f  g                   Creating IVP servers... #      IVP server creation succeeded.o       Starting IVP servers...        IVP server start succeeded.  )     Checking IVP server running status...        Invoking ACMS Client...        Stopping IVP servers...c$      IVP servers stopping succeeded.       Deleting IVP servers...t$      IVP servers deletion succeeded.       Stopping IVP TP system... %      IVP TPsystem stopping succeeded.        Deleting IVP TP system... &      IVP TP system deletion succeeded.  #     Cleaning namespace directory... 0      IVP namespace directory cleaning succeeded.  "     Cleaning IVP work directory...+      IVP work directory cleaning succeeded.n  T     ================================================================================V     ACMSxp V3.2-1 for OpenVMS Alpha IVP completed successfully at  9-JUL-1999 16:18:08T     ================================================================================  5      Installation of ACMSXP V3.2-1 completed at 16:18   B         Adding history entry in VMI$ROOT:[SYSUPD]VMSINSTAL.HISTORY  L         Creating installation data file: VMI$ROOT:[SYSUPD]ACMSXP032.VMI_DATA  M     Enter the products to be processed from the next distribution volume set.      * Products:  exitw+           VMSINSTAL procedure done at 16:19        $   B           When the installation procedure is done, refer to CompaqD           ACMSxp Developing and Managing Applications for proceduresC           to set up ACMSxp security and configure the ACMSxp systemS%           and your STDL applications.   "     A-6 Sample ACMSxp Installation e  s                    I                                                                         BSI         _________________________________________________________________   I                                                     ACMSxp-Supplied Filest    ?               This appendix lists the files that are created incD               subdirectories of the ACMSxp root directory you supply-               during the ACMSxp installation.i  /               Directory SYS$COMMON:[ACMSXPV032]   @               EXAMPLES.DIR       SYSLIB.DIR          SYSTEST.DIR+               SYSEXE.DIR         SYSMGR.DIR +               SYSHLP.DIR         SYSMSG.DIRb           B.1 Examples Directory  8               Directory SYS$COMMON:[ACMSXPV032.EXAMPLES]  *               AVERTZ_VM.DIR      STD.DIR;1.               AVERTZ_VR.DIR      STD_TPC.DIR;1               EMPLOYEE.DIR  B               Directory SYS$COMMON:[ACMSXPV032.EXAMPLES.AVERTZ_VM]  B               CONTROL_WKSP.STDL;1          VM_CREATE_APPL_DB.COM;1B               EDIT.COM;1                   VM_CREATE_SERVERS.COM;1C               LINK_OPTIONS.OPT;1           VM_CREATE_TPSYSTEM.COM;1lB               LIST_CONTROL_WKSP.STDL;1     VM_DELETE_SERVERS.COM;1C               RO_CONTEXT.SQL;1             VM_DELETE_TPSYSTEM.COM;1rI               RW_CONTEXT.SQL;1             VM_DELETE_WORK_DIR_FILES.COM;1v;               VEHICLES_ARRAY_WKSP.STDL;1   VM_DESCRIP.MMS;1oA               VEHICLES_WKSP.STDL;1         VM_DISPLAY_TASK.STDL;1s9               VM_ADD_TASK.STDL;1           VM_FORM.IFDL;1lA               VM_BUILD_SERVERS.COM;1       VM_GET_LIST_PROC.SCO;1n            I                                                 ACMSxp-Supplied Files B-1n u  q              ;           VM_GET_VEHICLE_PROC.SCO;1       VM_RUN_DEMO.TXT;1 9           VM_INDEXES.SQL;1                VM_SCHEMA.SQL;1rA           VM_INVOKE_TASK.COM;1            VM_SETUP_LOGICALS.COM;1r@           VM_LIST_TASK.STDL;1             VM_START_SERVERS.COM;1A           VM_LOAD_VEHICLES.SCO;1          VM_START_TPSYSTEM.COM;1e?           VM_MENU_FORM.IFDL;1             VM_STOP_SERVERS.COM;1s@           VM_MENU_TASK.STDL;1             VM_STOP_TPSYSTEM.COM;1E           VM_MENU_WKSP.STDL;1             VM_STORE_VEHICLE_PROC.SCO;1 >           VM_MODIFY_TASK.STDL;1           VM_TASK_GROUP.STDL;1<           VM_MSG_GROUP.STDL;1             VM_UPDATE_VEHICLE_     PROC.SCO;1;           VM_PROC_GROUP.STDL;1            VM_VEHICLES.DAT;1M7           VM_RO_PROC_GROUP.STDL;1         VM_WAIT.COM;1            VM_RUN_DEMO.COM;1e  >           Directory SYS$COMMON:[ACMSXPV032.EXAMPLES.AVERTZ_VR]  B           CUSTOMERS_WKSP.STDL;1           RESERVATIONS_WKSP.STDL;1>           CU_ARRAY_WKSP.STDL;1            RS_ARRAY_WKSP.STDL;1;           DESTINATION_WKSP.STDL;1         SITES_WKSP.STDL;1 >           EDIT.COM;1                      SI_ARRAY_WKSP.STDL;1>           HIST_RW_CONTEXT.SQL;1           VEHICLES_WKSP.STDL;1A           HIST_WKSP.STDL;1                VEHICLE_RENTAL_HISTORY_      WKSP.STDL;1A=           LINK_OPTIONS.OPT;1              VE_RO_CONTEXT.SQL;1r=           RENTAL_CLASSES_WKSP.STDL;1      VE_RW_CONTEXT.SQL;1rA           RENT_RO_CONTEXT.SQL;1           VR_CANCEL_RS_PROC.SCO;1 @           RENT_RW_CONTEXT.SQL;1           VR_CHECKIN_TASK.STDL;1  :           VR_CHECKOUT_TASK.STDL;1         VR_DESCRIP.MMS;1>           VR_CHECK_VE_AVAIL_PROC.SCO;1    VR_DO_CKOUT_OR_CNCL_     TASK.STDL;1l?           VR_CHECK_VE_AVAIL_TASK.STDL;1   VR_FIND_CU_PROC.SCO;1t@           VR_COMPLETE_CHECKIN_PROC.SCO;1  VR_FIND_CU_TASK.STDL;1C           VR_COMPLETE_CHECKOUT_PROC.SCO;1 VR_FIND_RS_CU_TASK.STDL;1p@           VR_COMPUTE_BILL_PROC.COB;1      VR_FIND_RS_TASK.STDL;1?           VR_CONTROL_WKSP.STDL;1          VR_FIND_SI_PROC.SCO;1o@           VR_COUNT_RS_PROC.SCO;1          VR_FIND_SI_TASK.STDL;1?           VR_COUNT_RS_TASK.STDL;1         VR_FIND_VE_PROC.SCO;1n@           VR_CUSTOMERS.DAT;1              VR_FIND_VE_TASK.STDL;1               B-2 ACMSxp-Supplied Files                    E               VR_FORM.IFDL;1                  VR_LOAD_CUSTOMERS.SCO;1 =               VR_GETRESV_TASK.STDL;1          VR_LOAD_RENTAL_          CLASSES.SCO;1_A               VR_GET_RESV_CU_PROC.SCO;1       VR_LOAD_SITES.SCO;1 D               VR_GET_RESV_PROC.SCO;1          VR_LOAD_VEHICLES.SCO;1A               VR_GET_VE_DATA_PROC.SCO;1       VR_MENU_FORM.IFDL;1 A               VR_GET_VE_DATA_TASK.STDL;1      VR_MENU_TASK.STDL;1 A               VR_GET_VE_HIST_PROC.SCO;1       VR_MENU_WKSP.STDL;1PH               VR_GET_VE_HIST_TASK.STDL;1      VR_MOD_VE_AVAIL_PROC.SCO;1I               VR_HISTORY_DB.COM;1             VR_MOD_VE_AVAIL_TASK.STDL;1w?               VR_HIST_PROC_GRP.STDL;1         VR_MSG_GRP.STDL;1h  E               VR_RENTALS_DB.COM;1             VR_STORE_CU_TASK.STDL;1tF               VR_RENTALS_INDEX.COM;1          VR_UPDATE_RS_TASK.STDL;1?               VR_RENTAL_CLASSES.DAT;1         VR_VEHICLES.DAT;1rB               VR_RENT_TASK_GRP.STDL;1         VR_VEHICLES_DB.COM;1E               VR_RESERVE_TASK.STDL;1          VR_VEHICLES_INDEX.COM;1 F               VR_RESV_TASK_GRP.STDL;1         VR_VE_RO_PROC_GRP.STDL;1F               VR_RS_RO_PROC_GRP.STDL;1        VR_VE_RW_PROC_GRP.STDL;1C               VR_RS_RW_PROC_GRP.STDL;1        VR_VE_TASK_GRP.STDL;1rC               VR_RUN_DEMO.COM;1               VR_WRITE_HIST_RECORD_*         PROC.SCO;1D               VR_SITES.DAT;1                  VR_WRITE_RS_PROC.SCO;1E               VR_STORE_CU_PROC.SCO;1          VR_WRITE_RS_TASK.STDL;1e  A               Directory SYS$COMMON:[ACMSXPV032.EXAMPLES.EMPLOYEE]   -               CLIENT.DIR;1       SERVER.DIR;1h  H               Directory SYS$COMMON:[ACMSXPV032.EXAMPLES.EMPLOYEE.CLIENT]  C               EMPL_UWC.C;1       EMPL_UWC.H;1        EMPL_UWC.MMS;1   H               Directory SYS$COMMON:[ACMSXPV032.EXAMPLES.EMPLOYEE.SERVER]  D               ADMIN_SETUP.COM;1            EMPLOYEE_SERVER_RDB.MMS;1?               CONTROL_RECORD.STDL;1        EMPLOYEE_SETUP.COM;1 C               EMPLOYEE_MSG_GRP.STDL;1      EMPLOYEE_SETUP_RDB.SQL;1r@               EMPLOYEE_PROCS_RDB.SC;1      EMPLOYEE_TASKS.STDL;1C               EMPLOYEE_PROC_GRP.STDL;1     EMPLOYEE_TASK_GRP.STDL;1 8               EMPLOYEE_RECORD.STDL;1       OPTIONS.OPT;1  <               Directory SYS$COMMON:[ACMSXPV032.EXAMPLES.STD]    I                                                 ACMSxp-Supplied Files B-3)                   2           CREATE_ORACLE_DB.COM;1       STD14.COM;12           CREATE_ORACLE_DB.SQL;1       STD15.COM;12           EMPLOYEE.H;1                 STD16.COM;12           EMPLOYEE_RDB.H;1             STD18.COM;12           LINK_OPTIONS.OPT;1           STD19.COM;12           PROFILE.H;1                  STD20.COM;11           PROFILE_RDB.H;1              STD3.COM;1r8           READ_ME_VMS.TXT;1            STD3A_UWC_UWP.C;11           STD.MMS;1                    STD4.COM;1y1           STD10.COM;1                  STD5.COM;1h  :           STD6.COM;1                   STD_PROC_COB.STDL;1>           STD6A.COM;1                  STD_PROC_DEC_COB.STDL;1<           STD6_UWC_UWP.C;1             STD_PROC_SVR_A.STDL;1<           STD7.COM;1                   STD_PROC_SVR_B.STDL;17           STD8.COM;1                   STD_RDB_SQL.SC;1C9           STD9.COM;1                   STD_READ_SQL.SCO;1I6           STD_COBOL.COB;1              STD_SETUP.COM;13           STD_CWP.STDL;1               STD_SQL.SC;1e=           STD_FORMS.IFDL;1             STD_TASK_GROUPS.STDL;1l?           STD_MT_UWC.C;1               STD_TASK_GROUPS_A.STDL;1   5           STD_TASK_GROUPS_B.STDL;1     STD_WAIT.COM;1 9           STD_TASK_SVR.STDL;1          STD_WKSP_DEF.COB;1r:           STD_TASK_SVR_A.STDL;1        STD_WKSP_DEF.STDL;1:           STD_TASK_SVR_B.STDL;1        STD_WRITE_SQL.SCO;1=           STD_UWC.C;1                  UWC_LINK_OPTIONS.OPT;1c           STD_UWP.C;1d  <           Directory SYS$COMMON:[ACMSXPV032.EXAMPLES.STD_TPC]  9           STD_CLEAN_UP.COM;1           STD_SHUTDOWN.COM;1h8           STD_SETUP_TPC.COM;1          STD_STARTUP.COM;1       B.2 Executable Directory  2           Directory SYS$COMMON:[ACMSXPV032.SYSEXE]                     B-4 ACMSxp-Supplied FilesC I  T              E               ACMS$SERVER_STARTUP.COM;1    ACMS_FIND_SYSTEM_MSG.COM;1c<               ACMS$SERVER_STARTUP.DBG;1    ACMS_IDENTS.COM;1D               ACMS.EXE;1                   ACMS_LIST_PROCESSES.COM;1@               ACMSADMIN.EXE;1              ACMS_PRINT_MSGS.COM;1D               ACMS_ADD_IDENTIFIER.EXE;1    ACMS_PRODUCT_BANNER.TXT;1E               ACMS_CREATE_TPSYSTEM.COM;1   ACMS_PRODUCT_VERSION.TXT;1 ?               ACMS_DEINSTALL.COM;1         ACMS_QUEUE_SVR.EXE;1 ?               ACMS_DELETE_TPSYSTEM.COM;1   ACMS_QUEUE_SVR.IDF;1t;               ACMS_EVENT_SVR.EXE;1         ACMS_QUOTA.COM;1Y?               ACMS_EVENT_SVR.IDF;1         ACMS_RECQU_SVR.EXE;1s  D               ACMS_RECQU_SVR.IDF;1         ACMS_START_TPSYSTEM.COM;1F               ACMS_RSEND_SVR.EXE;1         ACMS_VERIFY_PRINCIPAL.EXE;17               ACMS_RSEND_SVR.IDF;1         CATMSG.EXE;1t>               ACMS_RUN_IVP.COM;1           GUI_KIT_INTEL.EXE;1E               ACMS_SEND_ERRORS_1_0.IDF;1   GUI_KIT_README_INTEL.TXT;1r6               ACMS_SETUP_CDB.EXE;1         GWLOG.EXE;15               ACMS_SETUP_TPSYSTEM.EXE;1    STDL.EXE;1 @               ACMS_SET_VERSION.COM;1       TPS_SMI_LITERAL.CAT;1B               ACMS_SHOW_ENVIRONMENT.COM;1  TPS_SVR_ACMSDEBUG.EXE;1           B.3 Help Directory  6               Directory SYS$COMMON:[ACMSXPV032.SYSHLP]  @               ACMSADMIN_HELP.HLB;1            ACMSXP_MGT_CONFIG_         CHAP.TXT;1=               ACMSXP_ERROR_MESSAGES.TXT;1     STDL-HELP.HLP;1 ,               ACMSXP_MGT_CONFAPPS_CHAP.TXT;1           B.4 Library Directory*  6               Directory SYS$COMMON:[ACMSXPV032.SYSLIB]  D               ECLASS.COB;1                 STDL_SRTL$SHAREV032.EXE;1B               ECLASS.H;1                   STDL_SYSTEM_WKSP.STDL;1D               EINFO.COB;1                  STDL_SYSTEM_WKSP_X.STDL;1E               EINFO.H;1                    STDL_XOPEN$SHAREV032.EXE;1y>               FORMSDEF.H;1                 TPS$SHAREV032.EXE;12               FORMS_DEF.H;1                TPS.H;16               MC_DCL.CLD;1                 TPS_CDB.H;16               STDLDEFS.H;1                 TPS_CFE.H;1&               STDL_MIA$SHAREV032.EXE;1    I                                                 ACMSxp-Supplied Files B-5y m  s              5           TPS_COMMON.H;1               TPS_PS_IDL.H;1V6           TPS_COMMON_IDL.H;1           TPS_PTHREAD.H;1:           TPS_COMMON_IDL.IDL;1         TPS_PTHREAD_EXC.H;12           TPS_COS.H;1                  TPS_QUE.H;12           TPS_EVT.H;1                  TPS_REC.H;18           TPS_FIL.H;1                  TPS_REC_AGENT.H;12           TPS_LST.H;1                  TPS_RPC.H;1=           TPS_MSG.H;1                  TPS_RPC_APINFO_IDL.H;1T?           TPS_PS.H;1                   TPS_RPC_APINFO_IDL.IDL;1[:           TPS_PS_DECFORMS.H;1          TPS_RPC_CONTEXT.H;1  3           TPS_RPC_CONTEXT.IDL;1        TPS_STDL.H;1 5           TPS_RQS.H;1                  TPS_STDL.IDL;1 2           TPS_RQS_INVOKE.H;1           TPS_SVR.H;12           TPS_RQS_TYPES.H;1            TPS_TAS.H;12           TPS_SEC.H;1                  TPS_TXN.H;19           TPS_SHM.H;1                  TPS_TXN_GW_IDL.H;12;           TPS_SI.H;1                   TPS_TXN_GW_IDL.IDL;1t:           TPS_SI_I18N.H;1              TPS_TXN_RPC_IDL.H;1<           TPS_SM.H;1                   TPS_TXN_RPC_IDL.IDL;12           TPS_SMA.H;1                  TPS_VDB.H;12           TPS_SRTL.H;1                 TPS_WRM.H;1       B.5 Manager Directory   2           Directory SYS$COMMON:[ACMSXPV032.SYSMGR]  9           ACMS_TEST_TPC_READY.EXE;1    TPCONTROLLER.EXE;1        B.6 Messages Directory  2           Directory SYS$COMMON:[ACMSXPV032.SYSMSG]  <           EN_US_ISO8859-1.DIR;1        JA_JP_SDECKANJI.DIR;1  B           Directory SYS$COMMON:[ACMSXPV032.SYSMSG.EN_US_ISO8859-1]  ;           TPS.CAT;1                    TPS_API_LOCALE.CAT;12           TPS_API.CAT;1L  B           Directory SYS$COMMON:[ACMSXPV032.SYSMSG.JA_JP_SDECKANJI]             TPS_API_LOCALE.CAT;1         B-6 ACMSxp-Supplied FilesO    t                       B.7 Test Directory  7               Directory SYS$COMMON:[ACMSXPV032.SYSTEST]T  I               ACMS_IVP.COM;1                     CREATE_IVP_SERVERS.COM;1o<               ACMS_IVP_RUN.TXT;1                 CREATE_IVP_         TPSYSTEM.COM;1G               BUILD_IVP_IMAGES.COM;1             DELETE_IVP_FILES.COM;1*I               CHECK_COBOL_DATA.COM;1             DELETE_IVP_SERVERS.COM;1II               CHECK_PROCESSES.COM;1              DELETE_IVP_SYMBOLS.COM;1u<               CHECK_SQL_DATA.COM;1               DELETE_IVP_         TPSYSTEM.COM;1=               CLEAN_NAMESPACE.COM;1              EMPLOYEE.H;1 E               CREATE_IVP_ACMSADMIN_SYMBOLS.COM;1 IVP_COBOL_PROC.COB;1 A               CREATE_IVP_APPL_DB.COM;1           IVP_FORMS.IFDL;1 G               CREATE_IVP_APPL_DB.SQL;1           IVP_LINK_OPTIONS.OPT;1   E               IVP_SQL.SC;1                       SAVE_TPSYSTEMS.COM;1r@               IVP_TASK_SVR_A.STDL;1              SETUP_IVP.COM;1H               IVP_TASK_SVR_A_NOCOBOL.STDL;1      START_IVP_SERVERS.COM;1I               IVP_UWP_SVR.C;1                    START_IVP_TPSYSTEM.COM;1=G               IVP_UW_CLIENT.C;1                  STOP_IVP_SERVERS.COM;1=H               IVP_WKSP_DEF.STDL;1                STOP_IVP_TPSYSTEM.COM;1E               OBTAIN_TID.C;1                     STOP_PROCESSES.COM;1=G               PRECOMPILED_FILES.DIR;1            SUBMIT_ACMS_TASK.COM;1=H               PROFILE.H;1                        VERIFY_DISK_SPACE.COM;1C               RUN_ACMS_CLIENT.COM;1              VERIFY_PRIVS.COM;1oD               RUN_UW_CLIENT.COM;1                VERIFY_QUOTAS.COM;1  I               Directory SYS$COMMON:[ACMSXPV032.SYSTEST.PRECOMPILED_FILES]s  I               IVP_FORMS_CWP.OBJ;1                IVP_TASK_GRP_A_1_0.IDF;1eI               IVP_PROC_GRP_A_1_0.IDF;1           IVP_TASK_GRP_A_CLI.OBJ;1 I               IVP_PROC_GRP_A_CLI.OBJ;1           IVP_TASK_GRP_A_SVR.OBJ;1.E               IVP_PROC_GRP_A_SVR.OBJ;1           IVP_TASK_SVR_A.OBJ;1m@               IVP_PROC_GRP_B_1_0.IDF;1           IVP_TASK_SVR_A_         NOCOBOL.OBJ;1PA               IVP_PROC_GRP_B_CLI.OBJ;1           IVP_WKSP_DEF.H;1 G               IVP_PROC_GRP_B_SVR.OBJ;1           IVP_WKSP_DEF_NOEPV.H;1d            I                                                 ACMSxp-Supplied Files B-7                                  F      _________________________________________________________________  F                                                                  Index      F      A______________________________   B______________________________  2      Account                           BIOLM,  3-47        cell_admin, 1-8                 BYTLM,  3-4, 3-5c        DCE for IVP, 1-10(        SYSTEM, 2-1                     CF        user                            _______________________________?           IVP access, 1-11             cell_admin account,  1-8d7           privileges, 3-3              CHANNELCNT,  1-3 .           process quotas, 3-4          ClusterE           requirements, 3-3              ACMSxp considerations,  3-16iF      acmsxp_svr account                Companion software option,  3-3/        creation, 1-10                  Compiler =        IVP access, 1-11                  virtual memory,  3-512      ACMS_CREATE_TPSYSTEM              Connections;        user accounts to run, 3-3         configuring,  3-13f0      ACMS_DEINSTALL                    CPU,  3-4          running, 4-1$F      ACMS_DELETE_TPSYSTEM              D______________________________3        user accounts to run, 3-3       DCE softwarehD      ACMS_START_TPSYSTEM                 UCX parameter values,  3-11/        rights identifier, 1-2, 2-6     Debuggerr>        user accounts to run, 3-3         kit requirement,  1-6<      Alternate working device            version check,  1-6-        VMSINSTAL option, 2-3           DECdtm ;      ASTLM,  3-4                         configuring,  3-15S-      Audit records                     DECnet =        BYTLM quota, 3-5                  configuration,  3-11 A      Autoanswer                          links calculation,  3-12 :        VMSINSTAL option, 2-2             NSP values,  3-13B      AUTOGEN                             setting parameters,  3-11E        running, 3-9                      system parameter for DECnet-   5                                             Plus, 3-8o  F                                                                Index-1 l  i              
     DeinstallrF       actions,  4-2                    H______________________________:       questions,  4-5                  Help directory, B-5       requirements,  4-1(       rerunning,  4-4                  IF     DIOLM,  3-4                        _______________________________1     Directory                          InstallingR<       ACMSxp root,  B-1                 error recovery,  2-9@     Disk                                privilege required,  1-2<       space required,  1-4              required order,  1-5;       system back-up,  2-1              sample,  A-1 to A-6 4                                         stages,  2-36     E______________________________     starting,  2-1:     ENQLM,  3-4                         verification,  2-8*     Error                              IVP?       recovery,  2-9                    actions performed,  2-8 <     Examples directory,  B-1            DCE procedures,  1-87     Executable directory,  B-4          log files,  2-9I@                                         privilege required,  1-2@                                         running standalone,  2-9#     F______________________________.  F     File                               J______________________________3       ACMSxp-supplied,  B-1 to B-7     Journal file 7       DECdtm journal,  3-15             creation,  3-16 5       MODPARAMS.DAT,  3-9               DECdtm,  3-15 3       VMSINSTAL autoanswer,  2-2       JTQUOTA, 3-4C     FILLM,  3-4   F     G                                  K______________________________7     _______________________________    KSTACKPAGES, 3-8      GBLPAGES,  1-3(       changing,  3-9                   LF     GBLSECTIONS,  1-3                  _______________________________=       changing,  3-9                   Library directory, B-5 ,     GUI                                LinksB       installing management,  3-1       guidelines for calculating8          procedures,  3-2                  maximum, 3-12+       Japanese system,  3-3            LMCPMD       prerequisite software,  3-1       journal file creation,  3-16*       software option                  Log>          companion,  3-3                VMSINSTAL option,  2-3            standalone,  3-3L       system requirements,  3-21      gui_kit_intel.exe file,  3-2       Index-2N O  K                I         M______________________________   O______________________________S  :         Management software option        Operating systemD          See GUI                            required components, 1-6A         Manager directory, B-6              required patches, 1-7            MAXACCTJOBS, 3-4I         MAXDETACH, 3-5                    P______________________________R?         MAXJOBS, 3-5                      Page file quota,  3-5T-         Messages directory, B-6           PAKLI         MIN_PQL_DASTLM, 1-3                 See Product authorization key 3         MIN_PQL_DBIOLM, 1-3               Parameter 9         MIN_PQL_DBYTLM, 1-3                 changing, 3-9 @         MIN_PQL_DCPULM, 1-3                 checking system, 3-8=         MIN_PQL_DDIOLM, 1-3                 incremental, 3-10;1         MIN_PQL_DENQLM, 1-3               PatchesB<         MIN_PQL_DFILLM, 1-3                 required OS, 1-76         MIN_PQL_DJTQUOTA, 1-3             PBYTLM,  3-57         MIN_PQL_DPGFLQUOTA, 1-3           PGFLQUO,  3-5 F         MIN_PQL_DPRCLM, 1-3               Physical I/O pages parameter8         MIN_PQL_DTQELM, 1-4                 queuing, 3-78         MIN_PQL_MASTLM, 1-4               PIOPAGES,  3-75         MIN_PQL_MBIOLM, 1-4               PRCLM,  3-5R4         MIN_PQL_MBYTLM, 1-4               PRIO,  3-53         MIN_PQL_MCPULM, 1-4               Privilege;B         MIN_PQL_MDIOLM, 1-4                 installing ACMSxp, 1-2<         MIN_PQL_MENQLM, 1-4                 running IVP, 1-2>         MIN_PQL_MFILLM, 1-4                 user accounts, 3-3C         MIN_PQL_MJTQUOTA, 1-4             Product authorization key_;         MIN_PQL_MPGFLQUOTA, 1-4             installing, 1-1RC         MIN_PQL_MPRCLM, 1-4                 VMSINSTAL question, 2-5M         MIN_PQL_MTQELM, 1-4          MODPARAMS.DATOI          location,  3-9                   Q______________________________P  7                                           QUEPRIO,  3-5A1         N______________________________   Queuing H         NET$DECLAREOBJECT                   physical I/O pages parameter?          rights identifier,  1-2              requirement,  3-7 0         NSP                               QuotasE          configuration,  3-13               ACMSxp commands, 3-4, 3-5_9                                             changing, 3-5 @                                             minimum process, 3-4  I                                                                   Index-3  V  A              8                                        TPsystem (cont'd)@     R______________________________     BYTLM for starting,  3-5  1     Request queue server               TQELM, 3-5R2       working set parameters,  3-8     Tuning, 3-7D     Rights identifier                   physical I/O pages parameter8       ACMS_START_TPSYSTEM,  1-2,           queuing,  3-7?          2-6                            system parameters,  1-3I9       NET$DECLAREOBJECT,  1-2              checking,  3-8 <     Root alternate                         DECnet-Plus,  3-8=       VMSINSTAL option,  2-3            UCX parameters,  3-11;  F     _______________________________    U______________________________  *     Saveset                            UAF4       temporary storage,  2-3           change,  3-56     Server                             UAF quotas, 3-4;       account requirements,  3-3       UCX parameters, 3-11E  #       setting parameters for,  3-11YF     setup.exe program,  3-2            V______________________________  .     SHRFILLM,  3-5                     VersionA     Software                            setting systemwide,  3-17 E       optional layered,  1-8           Virtual memory limit exceeded, ,       required layered,  1-2             3-50     Standalone software option,        VMSINSTAL5        3-3                              options,  2-2 8     Startup                             parameters,  2-24       modifying node,  3-16             sample,  A-16     SYS$DECDTM_INHIBIT logical          starting,  2-1        name, 3-15 F     SYSGEN                             W______________________________1       running,  3-8                    WSDEF, 3-5;9     System parameter                   WSEXTENT, 3-5, 3-8T6       running ACMSxp,  1-3             WSQUO, 3-5, 3-8     System parameters        tuning,  3-7          DECnet-Plus,  3-8  #     T______________________________   
     TCP/IP       UCX parameters,  3-11M     Test directory,  B-7     TPsystem       account requirements          create or delete,  3-3           starting,  3-3        Index-4S