                                                     PATHWORKS=          for_OpenVMS_(Macintosh)_____________________________ "          Server Installation Guide              AA-PBFDE-TE              January 1995                   4          Revision/Update Information:  This document5                                        supersedes the <                                        PATHWORKS for OpenVMS9                                        (Macintosh) Server :                                        Installation Guide,8                                        Version 1.2, part:                                        number AA-PBFDD-TE.  <          Software Version:             PATHWORKS for OpenVMS;                                        (Macintosh), Version *                                        1.3  &          Digital Equipment Corporation          Maynard, Massachusetts                  @ ________________________________________________________________ First Published, September 1990 ; Revised, January 1991, January 1992, February 1993, January  1995  5 The information in this document is subject to change : without notice and should not be construed as a commitment3 by Digital Equipment Corporation. Digital Equipment 9 Corporation assumes no responsibility for any errors that  may appear in this document.  : The software described in this document is furnished under; a license and may be used or copied only in accordance with  the terms of such license.  7 No responsibility is assumed for the use or reliability 8 of software on equipment that is not supplied by Digital2 Equipment Corporation or its affiliated companies.  9 Restricted Rights: Use, duplication, or disclosure by the : U.S. Government is subject to restrictions as set forth in7 subparagraph (c)(1)(ii) of the Rights in Technical Data 3 and Computer Software clause at DFARS 252.227-7013.   7  Digital Equipment Corporation 1990, 1991, 1992, 1993,  1995.    All Rights Reserved. Printed in U.S.A.   1 The following are trademarks of Digital Equipment  Corporation:  5 Alpha, DEC, DECconnect, DEClaser, DECnet, DECnet-DOS, 7 DECnet-VAX, DECprint, DECshare, DECwindows, EtherWORKS, 7 LN03, LN03 Plus, LN03 ScriptPrinter, MicroVAX, OpenVMS, 8 PATHWORKS, PrintServer, Rdb/VMS, ReGIS, VAX, VAXcluster,9 VAXmail, VAXserver, VAX SQL, VMS, VMScluster, VT, and the 
 DIGITAL logo.   ) The following are third-party trademarks:   6 PostScript is a registered trademark of Adobe Systems,8 Inc. Apple, AppleShare, AppleTalk, LocalTalk, Macintosh,2 and MacTerminal are registered trademarks of Apple: Computer, Inc. MacX is a trademark of Apple Computer, Inc.9 MacWrite is a registered trademark of Claris Corporation. 2 PATH Manager is a registered trademark of Verisoft; Corporation. All other trademarks and registered trademarks - are the property of their respective holders.   $ This document is available on CDROM.  ; This document was prepared using VAX DOCUMENT, Version 2.1.                                  8 ________________________________________________________  9                                                  Contents       9 .................................................     vii       9  and          Configuration Overview.............     1-1 9  the      Physical Layout of a Network...........     1-2   0  to    Install PATHWORKS for OpenVMS (Macintosh)  9  Which      Components to Install................     2-2 9  You  Need.......................................     2-3 9  Hardware...............................              2-3 9  Software...............................              2-4 9  Software.........................                    2-4 9  Software..................................           2-4 9  Tasks...............................                 2-5 9  In     to a Privileged Account..................     2-5 9  Up     Your System Disk.........................     2-5 9  Disk         Space Requirements.................     2-5 9  Account     Quotas..............................     2-6 9  System     Parameters...........................     2-6 9  Current      Values.............................     2-7 9  the         CHANNELCNT Value....................     2-8 9  Values....................................           2-9 9  Steps..........................................     2-10                   9                                                       iii                    )  PATHWORKS        for OpenVMS (Macintosh)   ; Starting VMSINSTAL..................................    3-2 ; Interrupting the Installation Procedure.............    3-3 ; Responding to VMSINSTAL Questions...................    3-3 ; General VMSINSTAL Questions.........................    3-4 ; Questions About Components..........................    3-6 ; AppleTalk for OpenVMS Questions.....................    3-8 ; AppleTalk/DECnet Transport Gateway Questions........    3-9 ; DECshare File Server Questions......................   3-10 ; DECshare Print Server Question......................   3-11 ; Online Documentation Questions......................   3-12 ; Completing the Installation.........................   3-12 ; Error Messages and Conditions.......................   3-13 ; Next Steps..........................................   3-14     Tasks  * Modifying Your System Startup and Shutdown; Procedures..........................................    4-2 ; Rebooting to Load AppleTalk for OpenVMS.............    4-3 ; Starting the Software and Running the IVP...........    4-3 ; Next Steps..........................................    4-4     a         VMScluster System  ; Replacing DCL Tables................................    5-2 ; Running the ATK$CONFIG Configuration Procedure......    5-2 ; Starting ATK$CONFIG.................................    5-3 ; Setting Up the Primary Port.........................    5-3 ; Assigning Network Ranges............................    5-4 ; Enabling/Disabling Event Logging....................    5-4 ; Defining the AppleTalk/DECnet Transport Gateway.....    5-5 ; Completing the Configuration Procedure..............    5-5 ; Starting PATHWORKS for OpenVMS (Macintosh)..........    5-6 ; Creating a DECshare File Server on Other Servers....    5-7 ; Next Steps..........................................    5-9                       Sample Installation Script      Files Installed on Your System    1   DECnet Objects Created by PATHWORKS for OpenVMS  (Macintosh)      Installing the XQP+   ?    Installation Steps..................................     D-1 ?    Responding to VMSINSTAL Questions...................     D-2 ?    XQP+ Sample Installation............................     D-5      Configuringing the XQP+   ?    New Features........................................     E-1 ?    Controlling the New Features on Version 5.5-2.......     E-2 ?    Controlling the New Features on Version 6.x.........     E-3 ?    Controlling XQP+ in a VMScluster....................     E-4 .    Mixed OpenVMS Version 5.5-2 and Version 6.x?    Clusters............................................     E-4 0    VMSclusters Running OpenVMS Version 5.5-2 and?    Version 6.x.........................................     E-4 ?    Controlling DECshare XQP+ Usage.....................     E-4 ?    Deinstalling the XQP+...............................     E-5 ?    Known Problems......................................     E-6             ?    2-1       Checklist for Preparing to Install........     2-1   0    2-2       Components of PATHWORKS for OpenVMS?              (Macintosh)...............................     2-2   ?    2-3       Disk Space Requirements...................     2-6   ?    2-4       System Parameter Values...................     2-7   3    3-1       Checklist for Installing PATHWORKS for ?              OpenVMS (Macintosh).......................     3-1   ?    4-1       Checklist for Postinstallation Tasks......     4-1   ?                                                               v                    . 5-1       Checklist for Configuring VMScluster;           Systems...................................    5-1   ; B-1       Directory: SYS$COMMON:[MSA]...............    B-2   ; B-2       Directory: SYS$COMMON:[MSA.MSAF$ICONS]....    B-2    B-3       Directory:;           SYS$COMMON:[MSA.MSAP$UTILITY].............    B-3   ; B-4       Directory: SYS$COMMON:[SYS$LDR]...........    B-5   ; B-5       Directory: SYS$COMMON:[SYS$STARTUP].......    B-5   ; B-6       Directory: SYS$COMMON:[SYSEXE]............    B-5   ; B-7       Directory: SYS$COMMON:[SYSHLP]............    B-6    B-8       Directory:;           SYS$COMMON:[SYSHLP.EXAMPLES.MSA]..........    B-7   ; B-9       Directory: SYS$COMMON:[SYSLIB]............    B-7   ; B-10      Directory: SYS$COMMON:[SYSMGR]............    B-9   ; B-11      Directory: SYS$COMMON:[SYSMSG]............    B-9   ; B-12      Directory: SYS$COMMON:[SYSTEST]...........   B-10   ; B-13      Directory: SYS$COMMON:[SYSTEST.ATK].......   B-10   ; B-14      Directory: SYS$COMMON:[SYSTEST.ATKGW].....   B-10                              > ______________________________________________________________  ?                                                         Preface         3    The purpose of this manual is to help the system :    administrator install PATHWORKS for OpenVMS (Macintosh)<    server software after all the network hardware components    are installed and connected.       :    This manual is intended for the system administrator of;    PATHWORKS for OpenVMS (Macintosh). This person should be =    an experienced user of the Macintosh computer, the OpenVMS -    operating system, and knowledgeable about:   5    o  Configuring and monitoring the OpenVMS system's        performance   9    o  Analyzing problems that might occur with an OpenVMS        system  <    The system administrator should also be familiar with the=    hardware and software configuration of the network and the (    specific software needs of the users.                        ?                                                             vii                      8 The following list can help you find information in this manual.   6 Chapter 1   Provides an overview of the steps involved7             in installing and configuring PATHWORKS fort              OpenVMS (Macintosh).  : Chapter 2   Describes how to prepare for the installation.  2 Chapter 3   Describes how to install the software.  5 Chapter 4   Describes postinstallation tasks you need 7             to perform before you can use PATHWORKS for               OpenVMS (Macintosh).  9 Chapter 5   Describes how to configure other servers in at             VMScluster system.  9 Appendix A  Provides the script for a sample installation              procedure.  ; Appendix B  Lists the files installed on your system by theP#             installation procedure.:  9 Appendix C  Lists the DECnet objects created by PATHWORKS $             for OpenVMS (Macintosh).  : Appendix D  Provides information about the XQP+ and how to             install it.   : Appendix E  Describes how to install XQP+ on a VMS cluster             system._  
  Documents  ; In addition to this book, PATHWORKS for OpenVMS (Macintosh)n6 documentation includes the following online documents:  / o  Introduction to the AppleTalk Network Systema   o  Server Administrator's Guide   * o  Server Administrator's Reference Manual  7 At your option, these books are installed in PostScripto; format as part of the installation described in this guide.m  7 Information about installing and configuring the clientd4 software can be found in the following PATHWORKS for Macintosh documentation:   o  Client Administrator's Guidet s  s              #    o  Network Services User's Guideu                                                                                        ?                                                              ix  .  v                ) This book uses the following conventions:g  ; ___________________________________________________________S; Convention____Meaning______________________________________   7 <Return>      Press the <Return> or <Enter> key on yourR               keyboard.A  ; <Ctrl/Y>      While you hold down the <Ctrl> key, press ther               <Y> key.  7 "enter"       Type all letters, spaces, and punctuationi5               marks exactly as they are printed. Then,:               press <Return> or <Enter>, depending on your               keyboard.,  5 two-line      Some commands are continued on a secondr7 commands      line. In OpenVMS, a continued command may-9               be indicated by a hyphen (-)  at the end ofo9               the first line. Enter the hyphen, and pressa:               <Return>. The system displays the _$ prompt.9               Continue entering the text that follows ther'               _$ prompt in your manual.k  : lowercase     Lowercase letters in command syntax indicate7               variables for which you must substitute ai7               word or value. You can enter commands andh;               parameters in uppercase or lowercase letters,m-               or in a combination of the two.1  7 bold type     In examples of dialog between you and the_:               workstation, bold type indicates information5               that you enter. For online (Bookreader).4               versions, user input is shown in bold.  8 .             A vertical ellipsis means that not all the .             data is shown. .N  2 Note          Notes provide information of special               importance.   5 Caution       Cautions provide information to prevent ; ______________damage_to_equipment_or_software._____________  r  r                    ?                                                               1.> ______________________________________________________________  ?                                                    Introduction         This chapter provides:.  3    o  An overview and chart of the installation andP       configuration tasks.  =    o  A brief introduction to planning the physical layout of.       a network   $  and          Configuration Overview  8    The installation of PATHWORKS for OpenVMS (Macintosh)    involves:  '    o  Installing software on the server.  >    o  Configuring additional servers, if you have a VMScluster       system  8    You must also make the PATHWORKS for Macintosh client<    software available on your server and Macintosh computers9    to fully utilize the services of PATHWORKS for OpenVMS     (Macintosh).   5    The installation procedures described in this book ;    establish default values for system parameters that work ;    for any network configuration. However, you may discover :    that the needs of your site require you to make changes:    to those default values. For information about changing<    the network configuration, see the Server Administrator's	    Guide.i  >    If you want to improve the performance of the PATHWORKS for=    OpenVMS (Macintosh) file server, you can install the XQP+.E>    For information on how to install the XQP+, see Appendix D.    ?                                               Introduction  1-1  s  n              #  the   Physical Layout of a Networkn  8 PATHWORKS for OpenVMS (Macintosh) includes AppleTalk for5 OpenVMS. AppleTalk for OpenVMS is networking softwareg8 that allows a server node to participate in an AppleTalk network.  9 Before installation, you should be familiar with conceptsy# of the AppleTalk networking system.   6 If you are planning a new network, be sure to plan for8 growth, efficiency, and high performance. Although a new7 network may be small and easy to maintain, you probably.5 will connect more networks and devices in the future..  ; To help you plan the physical layout, you should draw a mapC: of the network, including cables, devices such as printers( and workstations, and network locations.  6 Before setting up a network, you should understand the following terms:   o  Interneta   o  Primary port.   o  Network numbers and rangese   o  AppleTalk zones  
 o  Routing  9 The Introduction to the AppleTalk Network System provides.6 valuable information about AppleTalk network concepts.7 The Server Administrator's Guide provides more specifice6 information about setting up and using the server node4 in an AppleTalk internet. Refer to these manuals for: explanations of terms and for more information on planning
 your network.. .  .                    ?                                                               2e> ______________________________________________________________  ?          Preparing to Install PATHWORKS for OpenVMS (Macintosh)     ;    This chapter discusses the requirements and preparationso=    necessary for installing PATHWORKS for OpenVMS (Macintosh)e    server software..  >    Table 2-1 is a checklist of the steps you need to follow to*    prepare for the installation procedure.  >    Table_2-1__Checklist_for_Preparing_to_Install______________    >    <   >Plan which software components you want to install and!         verify your kit contents.   =    <   >Make sure your system meets the hardware and softwarer:         requirements of PATHWORKS for OpenVMS (Macintosh).    5    <   >Complete the following preinstallation tasks:e  8         <  >Log in to a fully privileged SYSTEM account.  %         <  >Back up your system disk.i  >         <  >Make sure you have sufficient disk space available4             for installation of selected components.  <         <  >Make sure your system meets the system parameter>    _________requirements._____________________________________                ?     Preparing to Install PATHWORKS for OpenVMS (Macintosh)  2-1( i  s                Which   Components to Install  4 The software package consists of several components.8 Table 2-2 provides a brief description of each component& and specifies prerequisite components.  ; Table_2-2_Components_of_PATHWORKS_for_OpenVMS_(Macintosh)__t  ; Component________Description_and_Dependencies______________f  6 AppleTalk        The network transport for most of the7 for OpenVMS,     software components that reside on the ; Version 3.2      OpenVMS server. It is used by the DECsharer3                  file and print servers, the DECnet.6                  Gateway, and the DECwindows AppleTalk7                  Data Stream Protocol (ADSP) transport.M  ; AppleTalk        Provides a network transport relay betweenO3 /DECnet          the AppleTalk and DECnet networks. 6 Transport        To use the AppleTalk/DECnet Transport9 Gateway          Gateway, you must also install AppleTalk-  )                  for OpenVMS Version 3.2.]  9 DECshare File    Provides AppleShare-compatible MacintoshL. Server           volumes to Macintosh clients.  :                  To use the DECshare file server, you must;                  also install AppleTalk for OpenVMS Version                   3.2.:  8 DECshare Print   Provides printer spooling for Macintosh5 Server           clients. The spooled printers can be 6                  connected directly to the VAX server,:                  available to the VAX server over a DECnet7                  network, or available on the AppleTalk                   network.   ;                  To use the DECshare print server, you must_;                  also install AppleTalk for OpenVMS Version                   3.2.   ;                                    (continued on next page)n    4  to        Install PATHWORKS for OpenVMS (Macintosh)    t              9    Table 2-2 (Cont.)  Components of PATHWORKS for OpenVMSe>    ___________________(Macintosh)_____________________________  >    Component________Description_and_Dependencies______________  ;    DECwindows ADSP  Provides a transport for Macintosh MacXn9    Transport        servers to allow access to DECwindowso!                     applications.e  <                     To use the ADSP transport, you must also9                     install AppleTalk for OpenVMS Versions:                     3.2 and the AppleTalk/DECnet Transport                     Gateway.  ;    PATHWORKS Mail   Allows access to VAXmail from Macintoshr    Server           clients.  >                     You can use the PATHWORKS Mail server with>                     the AppleTalk/DECnet Transport Gateway, if,                     the latter is installed.  <    Online           Allows access to online PostScript files9    PostScript       of the Server Adminsistrator's Guide,o=    Documentation    Server Reference Manual, and Introductiono4                     to the AppleTalk Network System.  >    ___________________________________________________________  9    Your Part Listing specifies the number and contents of 9    your media. Be sure to verify the contents of your kitn:    with this information. If your kit is damaged or if you:    find that parts of it are missing, contact your Digital    representative.  
  You  Need  3    This section describes the hardware and software 5    requirements of PATHWORKS for OpenVMS (Macintosh).t      Prerequisite Hardware  9    Be sure that the network components, including cables,d8    Macintosh computers, workstations, servers, and other    hardware, are connected.d  ?     Preparing to Install PATHWORKS for OpenVMS (Macintosh)  2-3y m                  Prerequisite Softwareo  8 The following software must be installed on your OpenVMS; server before you install PATHWORKS for OpenVMS (Macintosh)A	 software:t  7 o  OpenVMS VAX Version 5.5-2 or higher or OpenVMS Alphae    Version 6.1 or higher  2 o  DECnet software is required if you plan to use:  3    -  AppleTalk for OpenVMS, if you plan to turn onr.       AppleTalk routing and use DECnet tunnels  (    -  AppleTalk/DECnet Transport Gateway      -  PATHWORKS Mail serverT  .    -  DECshare remote management (MSA$MANAGER)   Component-Required Software   2 Depending on the PATHWORKS for OpenVMS (Macintosh)7 components you install, the following software products 
 are required:   ; o  DECprint Printing Services (DCPS) software, for selected .    Digital PostScript and third-party printers  9 o  DECwindows/Motif(an optional part of OpenVMS), for the_    DECwindows ADSP transport   AppleTalk Software  2 Two versions of the AppleTalk network protocol are: currently available: AppleTalk Phase 1 and AppleTalk Phase9 2. PATHWORKS for OpenVMS (Macintosh) uses AppleTalk PhaseC 2.  4 If you have AppleTalk Phase 1, you need to plan your6 migration to Phase 2. A migration utility is available6 with the AppleTalk internet router for large AppleTalk; internetworks that are being upgraded in steps, rather than ; all at once. For smaller networks, you can upgrade to Phasea 2 in one step.  9    ________________________ Note ________________________   4    If you previously installed AppleTalk for OpenVMS4    Version 2.1, you cannot run it with this product.7    PATHWORKS for OpenVMS (Macintosh) includes AppleTalk.  4  to        Install PATHWORKS for OpenVMS (Macintosh) r                 9       for OpenVMS Version 3.2, which is incompatible with (       AppleTalk for OpenVMS Version 2.1.  <       ______________________________________________________    Tasks  7    Before installing PATHWORKS for OpenVMS (Macintosh):e  =    1. Log in to a system account with full system privileges.f      2. Back up the system disk.  *    3. Check the disk space on your system.  6    4. Make sure your system meets the system parameter       requirements.r  3    These steps are described in the following text.r  %    Logging In to a Privileged Account   <    Install PATHWORKS for OpenVMS (Macintosh) from the SYSTEM:    account at the OpenVMS server. You must have the SETPRV
    privilege.       Backing Up Your System Disk  8    Digital recommends that you do a system backup before:    installing any layered product on the operating system.  :    Use the backup procedures that have been established at
    your site..  &    Determining Disk Space Requirements  6    The OpenVMS server requires a larger amount of free8    disk space during installation than it requires after8    installation. Table 2-3 specifies the amount of space;    required by each component after installation on the VAXn    or the Alpha computer.a  =    To determine the number of free disk blocks on the currentw>    system disk, enter the following command at the DCL prompt:  ?     Preparing to Install PATHWORKS for OpenVMS (Macintosh)  2-5f r                  $ SHOW DEVICE SYS$SYSDEVICEr  9    ________________________ Note ________________________i  .    All components except the online PostScript6    documentation files must reside on the system disk.  9    ______________________________________________________a  ; Table_2-3_Disk_Space_Requirements__________________________t  ; Component_Blocks_Required_for___VAX______Alpha_____________n  / AppleTalk for OpenVMS            1,450    2,250   / AppleTalk/DECnet Transport         300      450t Gatewaye  / DECshare file server             2,350    4,550e  / DECshare print server            2,350    2,550r  / DECwindows ADSP transport          400      500f  / PATHWORKS Mail server              450      800)  / Online PostScript files         10,000   10,000f  / Miscellaneous files              1,200    1,200.  / Total Blocks Required After     18,300   22,100  Installation  / Total Blocks Needed During      20,800   24,600o; Installation_______________________________________________p   Process Account Quotas  0 PATHWORKS for OpenVMS (Macintosh) has no special7 requirements for process account quotas. Default SYSTEM 4 process account quotas are sufficient for installing" PATHWORKS for OpenVMS (Macintosh).   Setting System Parametersn  9 PATHWORKS for OpenVMS (Macintosh) has required values for . some system parameters, as shown in Table 2-4.  4  to        Install PATHWORKS for OpenVMS (Macintosh) r  e              >    Table_2-4__System_Parameter_Values_________________________  >    Parameter_____________VAX___________Alpha__________________  0    CHANNELCNT               256[1]        256[1]  2    GBLPAGES               1,540 free    3,524 free  2    GBLSECTIONS               35 free       28 free  -    MAXBUF                 8,192         8,192A  -    PQL_MBYTLM            16,384        16,384t>    [1]This_is_the_minimum_allowable_value_if_you_are_going_to_  $    install the DECshare file server.>    ___________________________________________________________  -    The rest of this section describes how to:   9    o  Check the current values of other system parameterso  9    o  Determine the appropriate CHANNELCNT value for your        system  *    o  Modify other system parameter values      Checking Current Values  ;    Use the F$GETSYI lexical function to check the number of_)    free global pages and global sections:K  /    $ WRITE SYS$OUTPUT F$GETSYI("FREE_GBLPAGES")c    890/    $ WRITE SYS$OUTPUT F$GETSYI("FREE_GBLSECTS")r    40l  >    If these values are less than those specified in Table 2-4,>    increase each parameter to the number required as described    under Modifying Values.  >    Use the SYSGEN utility to check the current values of other    system parameters:   +    1. Start the SYSGEN utility by entering:s         $ RUN SYS$SYSTEM:SYSGEN 
       SYSGEN>   :    2. Determine the current value of a system parameter by       entering:n         SYSGEN> SHOW parameter  ?     Preparing to Install PATHWORKS for OpenVMS (Macintosh)  2-7e                   :    For example, to determine the current value of the PQL_"    MBYTLM system parameter, enter:      SYSGEN> SHOW PQL_MBYTLM  5    Following is an example of the information that ise7    displayed. The information on your screen may differt:    slightly, depending on the configuration of your server4    node. This example shows a current value of 1700:  >    Parameter Name Current Default Minimum Maximum Unit Dynamic>    ______________ _______ _______ _______ ____________ _______>    PQL_MBYTLM        1700    1024      -1     -1 Bytes       D  : 3. Exit the SYSGEN utility and return to the DCL prompt by    entering:      SYSGEN> EXIT_    $    Determining the CHANNELCNT Value  : If you are going to configure the AppleTalk/DECnet gateway7 for a large number of sessions, you need 2 channels foro9 each session plus 5 additional channels. In addition, yous8 need to calculate a value of CHANNELCNT for the DECshare file server.  6 To determine the appropriate CHANNELCNT value for your: system, use whichever value is larger, as derived from the following two formulas:a   For the file server:  2 CHANNELCNT = (volumes*6) + catalog + (users*files)            + managers + 25   For the gateway:  / CHANNELCNT = 2*(AppleTalk Gateway sessions) + 5s  ; ___________________________________________________________-; Parameter___Description____________________________________l  + volumes     Number of volumes being served.   6 catalog     Value of the CATALOG_CACHE characteristic.  9 users       Maximum number of simultaneous user connects.   4  to        Install PATHWORKS for OpenVMS (Macintosh)                 >    ___________________________________________________________>    Parameter___Description____________________________________  -    files       Number of open files per user.   >    managers____Number_of_concurrent_ADMIN/MSA_connections.____  <    For example, on a 14-volume file server with 34 users and:    a default CATALOG_CACHE of 64 (estimating users with an;    average of 4 files opened at once and only one ADMIN/MSAn2    connection), the CHANNELCNT value would be 310:  *    CHANNEL = 3 + 14*6 + 64 + 34*4 + 1 + 25  ;    See Modifying Values for information on modifying system     parameter values.      Modifying Valuesp  -    To modify the value of a system parameter:_  7    1. Using any text editor, add or edit the lines thate:       set minimum values for your system parameters in the1       SYS$SYSTEM:MODPARAMS.DAT file. For example:M         MIN_PQL_MBYTLM = 16384  ;    2. Run the AUTOGEN command procedure to recalculate youro       system parameter values:  5       $ @SYS$UPDATE:AUTOGEN GETDATA REBOOT NOFEEDBACK          The AUTOGEN procedure:  +       o  Gets new values from MODPARAMS.DATl  >       o  Runs SYSGEN to update the new system parameter values  8       o  Installs the new system parameter values on the          system   ;       o  Reboots the system so that all of the changes takeh          effect   <       The NOFEEDBACK qualifier causes AUTOGEN to recalculate+       only the new system parameter values.   <       ________________________ Note ________________________  <       Running AUTOGEN with the NOFEEDBACK qualifier does not9       modify system files (page file, swap file, and dump        file).  <       ______________________________________________________  ?     Preparing to Install PATHWORKS for OpenVMS (Macintosh)  2-9e n  o                      2 Now you are ready to install PATHWORKS for OpenVMS7 (Macintosh) according to the instructions in Chapter 3.                                                                               5  to         Install PATHWORKS for OpenVMS (Macintosh)e d  f                    ?                                                               3d> ______________________________________________________________  ?                    Installing PATHWORKS for OpenVMS (Macintosh)r    7    VMSINSTAL is the standard installation procedure forf>    OpenVMS layered products. It displays a series of questions    and informational messages.  9    This chapter describes how to use VMSINSTAL to installt:    PATHWORKS for OpenVMS (Macintosh). See Appendix A for a    sample installation script.  <    Table 3-1 is a checklist of the steps you need to follow.  =       _______________________ Caution _______________________,  9       Be sure you understand the information and completen9       the tasks described in Chapter 2 before you perform -       the installation tasks in this chapter.m  <       ______________________________________________________  <    Table 3-1  Checklist for Installing PATHWORKS for OpenVMS>    ___________(Macintosh)_____________________________________      <   >Start VMSINSTAL.  *    <   >Respond to installation questions.  >    <___>Take_appropriate_action_in_response_to_error_messages.                    ?               Installing PATHWORKS for OpenVMS (Macintosh)  3-1     s              
  VMSINSTAL  $ To start the installation procedure:  8 1. Log in to a privileged account on the server, such as    the SYSTEM account.  9    ________________________ Note ________________________o  0    If you are upgrading to PATHWORKS for OpenVMS7    (Macintosh) Version 1.3, you must shut down whateverr7    version of PATHWORKS for OpenVMS (Macintosh) you aree9    running before you start the installation. To do this,n)    from the SYS$MANAGER directory, enter:_         $ @MSA$SHUTDOWNe  5    If you are installing on a VMScluster, you must dol8    this on all nodes within the cluster that are running%    PATHWORKS for OpenVMS (Macintosh).O  9    ______________________________________________________P  ) 2. Set the default directory by entering:       $ SET DEFAULT SYS$UPDATEs   3. Start VMSINSTAL by entering:   ,    $ @VMSINSTAL MSA013 device_name OPTIONS N  ;    ________________________________________________________T;    Parameter___Description_________________________________)      MSA013      Product name.  6    device_     Name of the device on which you plan to8    name        mount the media. For example, MTA0, MUA0,5                and MKA500 are device names for a tapet                drive.r          *  PATHWORKS         for OpenVMS (Macintosh)                 >       ________________________________________________________>       Parameter___Description_________________________________  4       OPTIONS N   Optional parameter that causes the<                   installation procedure to prompt you about;                   accessing online release notes during thei:                   installation. Because the online release9                   notes can contain important informatione>                   about changes to the installation procedure,=                   Digital recommends that you specify OPTIONS >       ____________N.__________________________________________  *    Interrupting the Installation Procedure  :    You can abort the installation procedure at any time by8    pressing <Ctrl/Y>. The installation procedure deletes<    all the files it has created and exits. You can start the    installation again.    to        VMSINSTAL Questions  7    Each VMSINSTAL question you need to answer is marked_;    with an asterisk (*)  at the beginning of the line. Somem>    questions show a default response in brackets. Following is<    an example of a VMSINSTAL question with a default answer:  )    * Do you want to continue anyway [NO]?k  0    To accept a default response, press <Return>.  <    The following sections list the questions in the order in-    which they appear during the installation.   <       ________________________ Note ________________________  <       Depending on the configuration of your OpenVMS system,9       the dialog that occurs during your installation mayn;       differ slightly from the examples that appear in this        section.  <       ______________________________________________________          ?               Installing PATHWORKS for OpenVMS (Macintosh)  3-3  8  0               General VMSINSTAL Questionse   1. Active Processes   9    %VMSINSTAL-W-ACTIVE, The following processes are still_
    active:       .c       .t       .H)    * Do you want to continue anyway [NO]?l      Answer YES to this question.q  9    The active processes and the installation procedure do !    not interfere with each other.M   2. System Backup  5    * Are you satisfied with the backup of your systemo    disk [YES]?  6    If you have not made a backup, or are not satisfied4    with the backup you made, enter NO to discontinue8    the installation. After you back up your system disk,    restart the installation.  6    If you are satisfied with the backup of your system    disk, press <Return>.   3. Mounting the Media   ;    VMSINSTAL displays the following prompt for you to mounte
    the media:O  5    Please mount the first volume of the set on MUA0:.     * Are you ready?   :    Answer YES after you have mounted the media on the tape/    drive. Answer NO to cancel the installation.e  9    VMSINSTAL displays messages stating that the volume is_8    mounted and the installation of PATHWORKS for OpenVMS    (Macintosh) is beginning:  2    %MOUNT-I-MOUNTED, MSA013 mounted on SRVR2$MUA0:  ,    The following products will be processed:  
      MSA V1.3C  2        Beginning installation of MSA V1.3 at 11:43  *  PATHWORKS         for OpenVMS (Macintosh) a  s              <       %VMSINSTAL-I-RESTORE, Restoring product save set A ...      4. Release Notese  5       Release notes included with this kit are always"       copied to SYS$HELP.O  '       Additional Release Notes Options:   "           1. Display release notes            2. Print release notes           3. Both 1 and 2u           4. None of the above         * Select option [2]:  ;       VMSINSTAL prompts you about release notes only if yous5       specified OPTIONS N when you started VMSINSTAL.   <       o  If you select option 1 or 3, VMSINSTAL displays the;          release notes immediately on the console terminal.   >          You can terminate the display at any time by pressing          <Ctrl/C>.  ;       o  If you select option 2 or 3, VMSINSTAL prompts youp>          for the name of the print queue that you want to use:  "          * Queue name [SYS$PRINT]:  :          Enter a queue name, or press <Return> to send the1          file to the default output print device.n  <       The file name for the release notes is MSA013.RELEASE_;       NOTES. VMSINSTAL moves the release notes to SYS$HELP,:-       whether or not you specified OPTIONS N.a  /    5. Installation Verification Procedure (IVP)_  @       * Do you want to run the IVP after the installation [YES]?  <       o  To run the IVP automatically after the installation#          procedure, press <Return>.:  9       o  To run the IVP independently of the installatione>          procedure, enter NO. Instructions for running the IVP;          independently of the installation procedure are inh          Chapter 4.i  ?               Installing PATHWORKS for OpenVMS (Macintosh)  3-5N N  o              9    ________________________ Note ________________________a  1    If you have a version of AppleTalk for OpenVMSa4    already installed on your system, the IVP may not7    run automatically. If it does not, you should reboots9    your system and run the IVP as described in Chapter 4.   9    _______________________________________________________   6. Purging Files  0    * Do you want to purge files replaced by this    installation [YES]?  9    Purging deletes the old versions of the files replacedv:    by the installation and saves disk space. If you choose6    not to have the installation procedure purge files,:    you can purge the files manually after you complete the    installation successfully._   Questions About Components   1. Selection of Components  <    Component #  Component Name                      Requires<    ---------------------------------------------------------$       1        AppleTalk for OpenVMS:       2        AppleTalk/DECnet Gateway                [1]:       3        DECshare File Server                    [1]:       4        DECshare Print Server                   [1];       5        DECwindows AppleTalk (ADSP) Transport  [1,2]d$       6        PATHWORKS Mail Server:       7        PATHWORKS Online Documentation (PostScript)  1    * Do you wish to install all components [YES]?f  2    The column on the right identifies prerequisite5    components. For example, the DECshare print servere7    component requires AppleTalk for OpenVMS Version 3.2r    (component 1).   9    ________________________ Note ________________________Q  1    The PATHWORKS for Macintosh Version 1.3 clientc9    software kit requires AppleTalk for OpenVMS (component 7    1) and the DECshare file server (component 3). Refer   *  PATHWORKS         for OpenVMS (Macintosh) e  a              ;       to the PATHWORKS for Macintosh Client Administrator'sa!       Guide for more information.   <       ______________________________________________________  3       o  To install all components, press <Return>.h  <       o  To install some, but not all, components, enter NO.  9          When you enter NO, VMSINSTAL asks you about eachs          individual component:  2  you  wish to install AppleTalk for OpenVMS [YES]?*  you  wish to install the AppleTalk/DECnet  [YES]?o'  you  wish to install the DECshare Filea  [YES]? (  you  wish to install the DECshare Print  [YES]?_.  you  wish to install the DECwindows AppleTalk  Transport      [YES]?6  you  wish to install the PATHWORKS Mail Server [YES]?F  you  wish to install the online documentation PostScript files [YES]?  5          -  If you want to install a component, press              <Return>.   6          -  If you do not want to install a particular              component, enter NO.       2. Verification of Components  =       If you chose to install only some components, VMSINSTAL_:       displays the components you selected and asks you to'       confirm that the list is correct:M  7       The following components have been selected to beo       installed:             AppleTalk for OpenVMSp"           AppleTalk/DECnet Gateway           DECshare File Server&           DECshare Print Server (ADSP)(           DECwindows AppleTalk Transport           PATHWORKS Mail Server 5           PATHWORKS Online Documentation (PostScript)l  ?               Installing PATHWORKS for OpenVMS (Macintosh)  3-7_ a  o                  * Is this correct [YES]?   -    o  If the list is correct, press <Return>.   )    o  If the list is incorrect, enter NO.   7       VMSINSTAL displays the series of questions again, 6       so that you can select individual components for       installation.   * 3. System Check for Component Requirements  8    VMSINSTAL checks the system to make sure it meets the/    requirements of the components you selected:n  7    %MSA-I-CHECKSYS, Now checking component requirementst    against system...  3    o  If all requirements are met, the installationi       proceeds.O  9    o  If the system does not meet the requirements of any 9       component, VMSINSTAL tells you what requirement wasi*       not met, and the installation fails.  8       After you correct the condition, you can start the       installation again.   " 4. Verification of Product License  9    VMSINSTAL displays a list of Product Authorization Keyr9    (PAK) names. The terms for use of this product require !    that you have a valid license.t  4    VMSINSTAL asks if one of these authorization keys3    is registered and loaded. If you answer YES, the 0    installation continues. If you answer NO, the9    installation also continues. However, the InstallationR9    Verification Procedure is not run and you are prompted_2    to load the license before starting the server.   AppleTalk for OpenVMS QuestionsT  % 1. Keeping the Existing ConfigurationL  5    If AppleTalk for OpenVMS was previously installed,O8    VMSINSTAL gives you the option of using your existing    configuration data file:s  .    * Do you want to use the existing AppleTalk      configuration [YES]?   *  PATHWORKS         for OpenVMS (Macintosh) a  o              9       If you answer YES, VMSINSTAL skips to the AppleTalk *       /DECnet Transport Gateway questions.  #    2. Choosing a Network ControllerR  =       If there are multiple network controllers (Ethernet and_>       FDDI) installed on your server, VMSINSTAL lists them and2       asks which one you want to use. For example:  F       The following suitable communications devices were found on your
       system:p  "                               XQA0"                               XQB0  6       * Which device do you want used as the AppleTalk       primary port? [XQA0]:   :       If you want to use AppleTalk for OpenVMS on multiple=       network communications devices, you need to set up your :       system as an AppleTalk router after you complete the9       installation procedure. For instructions on setting ;       up your system as an AppleTalk router, see the Servert       Administrator's Guide.  7       If you have only one network controller installede9       on your server, the following informational messagen7       is displayed, and VMSINSTAL continues to the nextL       component:  F       %MSA-I-ONEETHER, Only one suitable communications controller was       found on this system6       -MSA-I-ONEETHER, AppleTalk will configure device       ESA0 as its primary port  <       %MSA-I-ENDATKQ, End of AppleTalk for OpenVMS questions  /    AppleTalk/DECnet Transport Gateway Questionsd  (    1. Keeping the Existing Configuration  =       If an AppleTalk/DECnet Transport Gateway was previouslye=       installed, VMSINSTAL gives you the option of using your_%       existing gateway configuration:   /       * Do you want to use the existing gateways       configuration [YES]?  ?               Installing PATHWORKS for OpenVMS (Macintosh)  3-9t e  p              :    If you answer YES, VMSINSTAL skips to the DECshare file9    server questions. If you answer NO, VMSINSTAL asks yout    to name a gateway.e   2. Naming the Gateway8  9    * Enter the name for the gateway [DECnet on nodename]:   7    The name you enter is the name that later appears ine:    the Macintosh Gateway dialog box. The default answer is:    "DECnet on nodename", where nodename is the DECnet node    name of your OpenVMS server.r  ;    The gateway name must be 32 characters or fewer and mustt8    be unique among DECnet gateways in the same AppleTalk4    zone. VMSINSTAL automatically retains the case of7    the letters you use for the gateway name. Do not use     quotation marks.m   DECshare File Server Questions  8 If a DECshare file server has not yet been configured on, this system, VMSINSTAL asks these questions:   1. Server Name  1    * Enter the server name for DECshare [DECsharet    on nodename]:  ;    The name you enter is the name that later appears in the      Macintosh Chooser dialog box.  6    The default answer is "DECshare on nodename," where;    nodename is the DECnet node name of your OpenVMS server.e  :    The server name must be 31 characters or fewer and must6    be unique among AppleShare file servers in the same;    AppleTalk zone. VMSINSTAL automatically retains the casei9    of the letters you use for the server name. Do not use     quotation marks.T   2. Guest Accesst  8    * Do you want to allow guest access to DECshare [NO]?  8    Guest access allows all Macintosh users access to the9    DECshare file server without a user name and password.I  +  PATHWORKS          for OpenVMS (Macintosh)     e              >       If you enable guest access, VMSINSTAL creates an account7       named MSAF$GUEST and asks you to specify the usero6       identification code (UIC) for the guest account:  =       * Enter the UIC for the MSAF$GUEST account [[360,200]]:n  3       If you are reinstalling PATHWORKS for OpenVMSM;       (Macintosh), and if the MSAF$GUEST account is alreadyp.       defined, this question is not displayed.  <       The UIC consists of a group number and a member number<       separated by a comma and enclosed in brackets. The UIC<       is used to determine whether the account has access to       files.  ;       Accept the default UIC unless one of the following ism       true:   ;       o  You already have [360,200] assigned to a different           account.   ;       o  You follow a different assignment scheme for UICs.t  :    If you are doing an upgrade and a guest account already:    exists for which the UAF CAPTIVE is set, VMSINSTAL asks    this question:V  9    * Clear the CAPTIVE flag for account MSAF$GUEST [YES]?   7    For each account that DECshare found to be used as af:    guest account, VMSINSTAL asks whether you wish to clear7    the CAPTIVE flag. Refer to the PATHWORKS for OpenVMSV<    (Macintosh) Server Reference Manual for more information.  !    DECshare Print Server Question   =    If you are reinstalling PATHWORKS for OpenVMS (Macintosh), 4    and if the DECshare print server has already been7    installed, VMSINSTAL does not display this question.a  =    The DECshare print server requires an account for printingt!    jobs from Macintosh computers.   5    If you chose to install the DECshare print server, ;    VMSINSTAL creates an account named MSAP$ACCOUNT and asksa*    you to specify the UIC for the account:  ;    * Enter the UIC for the MSAP$ACCOUNT account [[360,210]]y  ?              Installing PATHWORKS for OpenVMS (Macintosh)  3-11_ _  _              6 The UIC consists of a group number and a member number9 separated by a comma and enclosed in brackets. The UIC is : used to determine whether the account has access to files.  ; Accept the default UIC unless one of the following is true:h  5 o  You already have [360,210] assigned to a differente    account.n  5 o  You follow a different assignment scheme for UICs.a   Online Documentation Questions  ( o  Online Documentation PostScript Files  $    * Enter location to install files    [SYS$COMMON:[SYSHLP]:  9    By default, VMSINSTAL places all files associated with-9    the online documentation PostScript files in a defaultp9    directory [SYS$COMMON:[SYSHLP]. If you prefer to placeC6    them in a different directory, you must specify the    directory name.   Completing the Installation   . VMSINSTAL displays a series of messages as it:    1. Restores the product save set  1 2. Installs the files and images for the selected 
    components    3. Creates directories  * 4. Moves files to their target directories  7 5. Runs the IVP and starts components (if you specifiede2    that the IVP should run automatically after the    installation procedure)  3 If you chose to run the IVP automatically after the_2 installation procedure, the following messages are
 displayed:  +  PATHWORKS          for OpenVMS (Macintosh)s p  a              @    *************************************************************@    *                                                           *@    *    Now starting Installation Verification Procedure for   *@    *    PATHWORKS for OpenVMS (Macintosh) V1.3                 *@    *                                                           *@    *************************************************************  (    Starting AppleTalk for OpenVMS IVP...    .    .    .E    ******************************************************************tE    *                                                                *TE    *    Installation Verification Procedure for PATHWORKS           * E    *    for OpenVMS (Macintosh) V1.3 has completed successfully.    *tE    *                                                                *tE    ******************************************************************d  >    When the installation is complete, the following message is
    displayed:o  1       Installation of MSA V1.3 completed at 12:04f  '       VMSINSTAL procedure done at 12:04   ;    If you do not plan to complete postinstallation tasks atn0    this time, log out of the privileged account:      $ LOGOUTA       Error Messages and Conditions      VMSINSTAL Error Messages   >    If errors occur during the installation, VMSINSTAL displays!    the following failure message:   A    %VMSINSTAL-E-INSFAIL, The installation of MSA V1.3 has failed./  9    Errors can occur during the installation if any of thes    following conditions exists:   0    o  The operating system version is incorrect.  1    o  A prerequisite software version is missing.i  6    o  Quotas necessary for successful installation are       insufficient.   ?              Installing PATHWORKS for OpenVMS (Macintosh)  3-13f e  s              : o  System parameter values for successful installation are    insufficient.   o  Disk space is inadequate.  8 If you are notified that any of these conditions exists,8 take the appropriate action as indicated by the message.8 For example, you might need to change a system parameter' value or install prerequisite software.t  6 For more information about the error messages that can2 be generated by these conditions, see your OpenVMS6 documentation on system messages, recovery procedures," and OpenVMS software installation.   IVP Error Messages  9 If errors occur with the software during the Installationw9 Verification Procedure, it displays the following failurea message:  ? %MSA-E-IVPFAIL, IVP for PATHWORKS for OpenVMS  (Macintosh) V1.3l has failed.   4 In most cases, you can solve the problem by manually8 starting the software and running the IVP separately, as6 described in Chapter 4. See the Server Administrator's9 Guide for more information about error messages generatedh by the software.  5 Now that you have installed the PATHWORKS for OpenVMS 2 (Macintosh) software, you are ready to perform the. postinstallation tasks described in Chapter 4.                        +  PATHWORKS          for OpenVMS (Macintosh)_                         ?                                                               4.> ______________________________________________________________  ?                                          Postinstallation Tasksf    ;    Before you can use the PATHWORKS for OpenVMS (Macintosh) :    software, you must perform some postinstallation tasks.  ;    Table 4-1 is a checklist of the steps you need to follow     for postinstallation tasks.  >    Table_4-1__Checklist_for_Postinstallation_Tasks____________    ;    <   >Modify your system startup and shutdown procedures.t  9    <   >If a previous version of AppleTalk for OpenVMS isD2         installed, reboot to load the new version.    7    <   >If you did not run the IVP during the VMSINSTAL ;         procedure, start PATHWORKS for OpenVMS (Macintosh),          and run the IVP.  >    <___>Determine_the_steps_you_still_need_to_complete._______                                ?                                     Postinstallation Tasks  4-1  f  u              /  Your    System Startup and Shutdown Procedureso  8 You must modify your system startup command file so that9 the components of PATHWORKS for OpenVMS (Macintosh) startl9 automatically whenever your system is booted. The name ofu9 the file that starts PATHWORKS for OpenVMS (Macintosh) isi MSA$STARTUP.COM.  9    ________________________ Note ________________________   6    The system startup command file for VMS Version 5.x6    is SYSTARTUP_V5.COM; for OpenVMS Version 6.x, it is    SYSTARTUP_VMS.COM.   9    ______________________________________________________o  6 Use any text editor to edit the system startup command: file, inserting the line that starts PATHWORKS for OpenVMS9 (Macintosh) after the lines that start the queue manager,S5 DECnet network, and DECprint Printing Services (DCPS)s software (if it is installed).  9    ________________________ Note ________________________G  6    If you are running DCPS and are using printers over7    AppleTalk, you need to execute MSA$STARTUP first andi    then execute DCPS$STARTUP.n  9    ______________________________________________________   +  $ START/QUE/MANAGER/BUFFER_COUNT=10/ . . .(    .    .    .0  $ IF F$SEARCH(SYS$SYSTEM:NETACP.EXE") .NES "" -' _$ THEN SUBMIT SYS$MANAGER:STARTNET.COM   9 o  If you want to use a batch procedure to submit networka:    startup, edit the line that starts the batch procedure.    For example:D  4     $ IF F$SEARCH("SYS$SYSTEM:NETACP.EXE") .NES "" --    _$ THEN SUBMIT SYS$MANAGER:STARTNET.COM, -w    _$ SYS$STARTUP:MSA$STARTUPe    Tasks n  o              <    o  If you want to start your network interactively, place<       the command @SYS$STARTUP:MSA$STARTUP after the command       that starts the network:  6        $ IF F$SEARCH("SYS$SYSTEM:NETACP.EXE") .NES ""-#       _$ THEN @SYS$MANAGER:STARTNETl!        $ @SYS$STARTUP:MSA$STARTUP.  :    You must also modify the SYSHUTDWN.COM file so that all9    file server volumes are properly dismounted before theu9    system completely shuts down. If this is not done, allS<    mounted volumes require a full verification each time the    server is restarted.   5    Add the following line to your SYSHUTDWN.COM file:   (    $ @SYS$MANAGER:MSA$SHUTDOWN NOCONFIRM  $  to       Load AppleTalk for OpenVMS  9    If you had a previous version of AppleTalk for OpenVMS <    installed, VMSINSTAL informed you that you need to reboot>    to load the new version. Reboot your system now by entering    the shutdown command:      $ @SYS$SYSTEM:SHUTDOWNe  ;    If you modified your system startup procedure correctly,s>    PATHWORKS for OpenVMS (Macintosh) starts automatically when    the system reboots.  &  the      Software and Running the IVP  ;    You can start the network and run the IVP now if you didh;    not run it before either because you chose not to run itn>    as part of the installation procedure or because a previous:    version of AppleTalk for OpenVMS already exists on your
    system.      To run the IVP:  1    1. Log in to the SYSTEM account at the server.o  5    2. Enter the following to start the components you[9       installed if you did not modify your system startup 9       procedure file to invoke MSA$STARTUP automatically:i          $ @SYS$STARTUP:MSA$STARTUP  ?                                     Postinstallation Tasks  4-3a a  m              :    Messages are displayed identifying the components being    started.   ( 3. Enter the following to start the IVP:      $ @SYS$TEST:MSA$IVP.COM  ;    When the IVP successfully completes all tests, a message     to that effect is displayed.0  2 Depending on your system and whether this is a new/ installation, you must do one of the following:   : o  If you have a VMScluster system, you must configure the$    system as described in Chapter 5.  - o  If you have a standalone system, you must:n  7    1. Make changes to the default network configurationE*       established by VMSINSTAL, if needed.  8       See Chapter 2 in the Server Administrator's Guide.  .    2. Add volumes to the DECshare file server.  8       See Chapter 6 in the Server Administrator's Guide.  2    3. Change the default file server configuration*       established by VMSINSTAL, if needed.  8       See Chapter 7 in the Server Administrator's Guide.      4. Add print services.n  8       See Chapter 8 in the Server Administrator's Guide.  :    5. Install the PATHWORKS for Macintosh client software.  8       See the installation instructions in the PATHWORKS1       for Macintosh Client Administrator's Guide.c            Tasks e  S                    ?                                                               5C> ______________________________________________________________  ?                                 Configuring a VMScluster System     4    If you have a VMScluster system, you must perform6    configuration tasks at each of the servers on which:    you want to run PATHWORKS for OpenVMS (Macintosh). In a;    VMScluster system, if you have multiple system disks andr:    you want to run PATHWORKS from all systems, you need to)    install PATHWORKS on each system disk.n  >    Table 5-1 is a checklist of the steps you need to follow to!    configure a VMScluster system.t  >    Table_5-1__Checklist_for_Configuring_VMScluster_Systems____    4    <   >Replace the DCL tables at each server on the         VMScluster system.  :    <   >Run the ATK$CONFIG configuration procedure at each:         server where you want to run PATHWORKS for OpenVMS         (Macintosh).    5    <   >Create a DECshare file server on each server.l  >    <___>Determine_the_steps_you_still_need_to_complete._______                        ?                            Configuring a VMScluster System  5-1o t                   DCL    Tables  9 To use PATHWORKS for OpenVMS (Macintosh) on other serversn9 in the VMScluster system, you must replace the version ofu8 the DCL tables that is installed on the other VMScluster servers:  , 1. Log in to the SYSTEM account on a server.  ) 2. Start the INSTALL program by entering:s      $ INSTALL    3. At the INSTALL prompt, enter:  -    INSTALL> REPLACE SYS$LIBRARY:DCLTABLES.EXE*  1 4. Repeat steps 1 through 3 at each server in the     VMScluster system.   (  the  ATK$CONFIG Configuration Procedure  5 The VMSINSTAL procedure configures your system to run 7 PATHWORKS for OpenVMS (Macintosh) at one server. If you 8 have a VMScluster system, you need to run the ATK$CONFIG6 configuration procedure at each additional server node8 where you want to run PATHWORKS for OpenVMS (Macintosh).  : ATK$CONFIG uses as defaults the same parameter values used: by the VMSINSTAL installation procedure. If you accept the8 defaults displayed by the ATK$CONFIG procedure, you will have equivalent setups.c  ) The procedure accomplishes the following:    o  Sets up the primary port1  . o  Assigns network ranges for the primary port  + o  Controls whether to enable event logging   ' o  Sets up the AppleTalk/DECnet gateway*  0 The procedure does not set up AppleTalk routing.    a          VMScluster Systemo w                     Starting ATK$CONFIG  3    To start the ATK$CONFIG configuration procedure:I  +    1. Log in to the OpenVMS SYSTEM account.n  4    2. Start the configuration procedure by entering:         $ @SYS$MANAGER:ATK$CONFIGo  7    The procedure leads you through a series of prompts. :    Default answers appear in brackets after the questions.'    To accept a default, press <Return>.e  >    The following sections list the questions in the order they-    appear during the configuration procedure.a  <       ________________________ Note ________________________  ;       You can abort the configuration procedure at any timer7       by pressing <Ctrl/Y>. The configuration procedurei9       deletes all the files it has created and exits. You $       can start the procedure again.  <       ______________________________________________________      Setting Up the Primary Port      1. Primary Port Namei  =       What name do you want for your primary port? [Primary]:u  9       Enter a name or use the default name, Primary, thata+       appears in brackets after the prompt..  <       The primary port is where AppleTalk name registrations<       occur and where AppleTalk node addresses are acquired.7       The primary port must always be an Ethernet port.o      2. Zone NameO  7       What zone name do you want for your primary port?e  =       Enter a valid zone name for the primary port, or use anf>       asterisk (*)  to select the default zone name defined by       another router.s  >       If you enter an invalid zone name, AppleTalk for OpenVMS0       uses the default zone as the primary port.  ?                            Configuring a VMScluster System  5-3i t  s               Assigning Network Ranges   1. Start of Network Rangee  ?    What do you want for the start of the network range? [65280]r  4    Enter a valid number for the start of the network7    range, or use the default value, 65280. The start oft:    the network range must be less than or equal to the end    of the range.  7    If the primary port is a seed port on a seed router,M:    the start and end of the network range must match other     routers on the same Ethernet.  :    Otherwise, accept the defaults for the start and end of    the network range.    2. End of Network Range   =    What do you want for the end of the network range? [65534]A  9    Enter a valid number for the end of the network range,r#    or use the default value, 65534.T  0    If you enter a number that conflicts with the;    established range for the network, AppleTalk for OpenVMSs;    uses the network's correct range provided by a router ony    the network.p  7    You can manually reconfigure the permanent database.     Enabling/Disabling Event Logging  
 1. Logging  !    Do you want to enable logging?   :    All error messages are displayed on the console screen.  8    o  If you want to store these messages in a log file,       press <Return>.   9    o  If you do not want to store messages in a log file,_       enter NO.    2. Name of Log File   6    If you chose to store error messages in a log file,3    ATK$CONFIG prompts you for the name of the file.t  9    What log file do you want? [SYS$MANAGER:ATK$EVENT.LOG]n    a          VMScluster System  H  K              :       Use the default file name, or enter a different file       name.e  2    Defining the AppleTalk/DECnet Transport Gateway      1. Start AppleTalk Gateway?  1       Do you want to start the AppleTalk Gateway?_  :       o  If you want a gateway on this server, answer YES.  9       o  If you do not want a gateway configured for thisS          server, answer NO._      2. Gateway Name  $       What gateway name do you want?  =       Use the default name, or enter a name such as DECnet on 
       BOSTON.s  )    Completing the Configuration Procedure       1. Continue?e  8       ATK$CONFIG gives you the opportunity to cancel the       configuration procedure.         Do you want to continue?         o  To cancel, enter NO._  <       o  To complete the configuration procedure, enter YES.      2. Execute Commands?   ;       If you chose to complete the configuration procedure, ;       ATK$CONFIG displays the OpenVMS commands that execute 6       the answers you entered to prompts. For example:            ?                            Configuring a VMScluster System  5-5S N  R              9    Here are the commands necessary to set up your system.r    $DEFINE/USER SYS$OUTPUT NL:    $DEFINE/USER SYS$ERROR NL:     $RUN SYS$SYSTEM:ATK$MANAGER     DEFINE EXECUTOR STATE ON8     DEFINE LOGGING FILE NAME "SYS$MANAGER:ATK$EVENT.LOG"      DEFINE LOGGING FILE STATE ON4     DEFINE GATEWAY APPLETALK NAME "DECnet ON BOSTON"     DEFINE GATEWAY STATE ONl4     DEFINE PORT DEVICE XQA0: NAME "Primary" STATE ON2     DEFINE PORT NAME "Primary" PRIMARY ON ZONE "*"8     DEFINE PORT NAME "Primary" NETWORK RANGE 65280 65534     EXIT  -    Do you want these commands to be executed?S  )    o  To execute the commands, enter YES.H  ;       A message is displayed notifying you that the changes +       to your configuration have been made.s  6    o  To cancel the configuration procedure, enter NO.   3. Start AppleTalk?i  !    Do you want AppleTalk started?t  6    Enter NO. AppleTalk for OpenVMS is started when you6    start PATHWORKS for OpenVMS (Macintosh) in the next    section.p  $  PATHWORKS   for OpenVMS (Macintosh)  5 If this is an upgrade, you need to reboot your systemM6 to get the latest AppleTalk features. If this is a new3 installation, you need to start the network and the 7 components of PATHWORKS for OpenVMS (Macintosh) at each 7 server you configured with the ATK$CONFIG configurationy
 procedure:  . 1. Log in to the SYSTEM account at the server.   2. Enter the following:.      $ @SYS$STARTUP:MSA$STARTUPg  :    Messages are displayed identifying the components being    started.     a          VMScluster System     s              <    3. When the DCL prompt ($)  is displayed, you can log out       of the SYSTEM account:         $ LOGOUT  -  a      DECshare File Server on Other Servers:  <    To balance the load on servers in a VMScluster system, it:    is a good idea to create a DECshare file server on each
    server.  7    To create and make available a DECshare file server:t  /    1. Log in to the SYSTEM account on a server.S  -    2. Start the DECshare Manager by entering:          $ ADMINISTER/MSA  -    3. Add a DECshare file server by entering:r  -       MSA$MANAGER> ADD FILE_SERVER servernames  >       ________________________________________________________>       Parameter___Description_________________________________  7       servername  The name of the new file server as itd9                   appears to AppleShare workstations. The >                   server name must be unique and can be from 1>                   to 31 characters long. If you include spaces=                   in the server name, enclose the server name1>       ____________in_quotation_marks_(")._____________________  >       For example, to add a DECshare file server with the name       DECshare on SRVR1, enter:2  6       MSA$MANAGER> ADD FILE_SERVER "DECshare on SRVR1"  :    4. Make an OpenVMS file directory for users by adding a
       volume:           ?                            Configuring a VMScluster System  5-7e h  e              ;    MSA$MANAGER> ADD VOLUME volumename/ROOT=disk:[directory]   ;    ________________________________________________________ ;    Parameter___Description_________________________________   7    volumename  The name of the volume you are adding aso9                it appears to AppleShare workstations. Thes;                volume name must be unique among all volumes 9                managed by a file server and can be from 1_;                to 27 characters long. If you include spaces :                in the volume name, enclose the volume name&                in quotation marks (").  4    disk:[directThe]OpenVMS location of the files and1                folders (subdirectories) that wills;    ____________constitute_the_volume.______________________i  6    For example, to add a volume with the name VOL1 and;    place the files for the volume in the MAC_VOL1 directoryT    on DUA0:, enter:s  4    MSA$MANAGER> ADD VOLUME VOL1/ROOT=DUA0:[MAC_VOL1]  9    ________________________ Note ________________________M  6    DECshare volumes cannot be shared by servers across5    nodes in a cluster. Each volume can be served by a<    single server only.  9    ______________________________________________________   9    For more information about adding file server volumes, (    see the Server Administrator's Guide.  % 5. Start the file server by entering:_  ,    MSA$MANAGER> START FILE_SERVER servername  7    For example, to start the DECshare file server named     DECshare on SRVR1, enter:  5    MSA$MANAGER> START FILE_SERVER "DECshare on SRVR1"i  1 6. Repeat steps 1 through 5 at each server in theo    VMScluster system.i    a          VMScluster Systems l  o                Steps  ;    Now that you have configured your VMScluster system, you.    must:  7    1. Make changes to the default network configuration *       established by VMSINSTAL, if needed.  8       See Chapter 2 in the Server Administrator's Guide.  <    2. Install the XQP+ software if you want to increase your       server performance.   :       See Appendix D for information on how to install the       XQP+ software.  .    3. Add volumes to the DECshare file server.  8       See Chapter 6 in the Server Administrator's Guide.  >    4. Change the default file server configuration established       by VMSINSTAL, if needed.  8       See Chapter 7 in the Server Administrator's Guide.      5. Add print services.r  8       See Chapter 8 in the Server Administrator's Guide.  :    6. Install the PATHWORKS for Macintosh client software.  <       See the installation instructions in the PATHWORKS for-       Macintosh Client Administrator's Guide.                         ?                            Configuring a VMScluster System  5-9a a                       ?                                                               A > ______________________________________________________________  ?                                      Sample Installation Script       DEF   SYS$UPDATE2  MSA013          MUA0 OPTIONS Nr  :   OpenVMS VAX Software Product Installation Procedure V6.0    is 20-DEC-1994 at 13:32.s  ,  a   question mark (?) at any time for help.  A  You                     are not logged in to the SYSTEM account.>;  The                  following processes are still active:e  left fieldp'  you  want to continue anyway [NO]? YES >  you   satisfied with the backup of your system disk [YES] YES  &  following products will be processed:    V1.3t  )  installation        of MSA V1.3 at 13:33o  3  Restoring                   product save set A ...hH  Product's                    release notes have been moved to SYS$HELP.  A          +------------------------------------------------------+U>          | PATHWORKS for OpenVMS (Macintosh), V1.3           |A          +------------------------------------------------------+a  E     *****************************************************************eE     *                                                               *r?     *                   Copyright (C) 1990,1995 by            *eE     *     Digital Equipment Corporation, Maynard, Massachusetts     *oE     *                              and                              * E     *          Apple Computer, Inc., Cupertino, California          *sE     *                      All rights reserved.                     *oE     *                                                               *SE     *****************************************************************   ?                                 Sample Installation Script  A-1  s  n              9  want   to run the IVP after the installation [YES]?  YESo?  want   to purge files replaced by this installation [YES]? YESm  B   PATHWORKS  for  OpenVMS  (Macintosh)  is  composed  of   severalB   components.   This  installation  allows  you to select which of6   these components you wish to install on your system.  B   Note that many of these components will require  that  AppleTalkB   for  OpenVMS  be installed.  These dependencies are noted in theB   table below in parenthesis (where [1] indicates that  'AppleTalk   for OpenVMS' is required).  B   Component #     Component Name                          RequiresD   ------------------------------------------------------------------'       1           AppleTalk for OpenVMS @       2           AppleTalk/DECnet Gateway                   [1]@       3           DECshare File Server                       [1]@       4           DECshare Print Server                      [1]A       5           DECwindows AppleTalk (ADSP) Transport     [1,2]g'       6           PATHWORKS Mail Server =       7           PATHWORKS Online Documentation (PostScript)   ,  wish   to install all components [YES]? YES  @  Now           checking component requirements against system...     Product:      PWXXMACAT01.03   Producer:     DEC    Version:      V1.3   Release Date: 1-DEC-1994     Product:      PWASMACCC01.03   Producer:     DECC   Version:      V1.3   Release Date: 1-DEC-1994     Product:      PWASXXXFP01.02   Producer:     DECn   Version:      V1.3   Release Date: 1-DEC-1994  9  of   these authorization keys registered and loaded? YES   :   Questions will now be asked for the selected components.    Installation     Script T                 % *************************************G% *                                   *w% *  AppleTalk for OpenVMS Questions  * % *                                   *r% *************************************O  7  Now               configuring AppleTalk for OpenVMS...w  R  Only              one suitable communications controller was found on this systemF  AppleTalk              will configure device ESA0 as its primary port  3  End             of AppleTalk for OpenVMS questions   ( ****************************************( *                                      *( *  AppleTalk/DECnet Gateway Questions  *( *                                      *( ****************************************  E      The AppleTalk/DECnet Gateway allows you to specify a name  which E      will  identify  the  gateway on the AppleTalk network.  The namesE      you specify can be up to 32 characters long and must  be  uniqueS6      among DECnet Gateways in the same AppleTalk zone.  1  the     name for the gateway [DECnet on PICKLE]:E  8  End               of AppleTalk/DECnet Gateway questions  $ ************************************$ *                                  *$ *  DECshare File Server Questions  *$ *                                  *$ ************************************  E      You will now be asked for the name of the DECshare File  Server.NE      This  is  the  name that appears in the Macintosh Chooser dialog"E      box.  It must be a unique name  (32  characters  or  less)  that E      isn't the same as any other AppleShare file server's name in thee      same AppleTalk zone.   <  the     server name for DECshare [DECshare on PICKLE]:  YES  E      The DECshare File Server will allow guest access  for  MacintoshtE      users  if you wish to enable it.  Enabling guest access requireseE      creating a non-privileged account  (MSAF$GUEST)  which  will  beu(      used as the DECshare guest account.  ?                                 Sample Installation Script  A-3)    t              4  want   to allow guest access to DECshare [NO]?  YES1  the  UIC for the MSAF$GUEST account [[360,200]]:nF  This                installation creates an ACCOUNT named MSAF$GUEST.'  user         record successfully addednS  identifier             MSAF$GUEST value: [000360,000200] added to rights data baseoL  identifier             MSA value: [000360,177777] added to rights data baseF  This                installation updates an ACCOUNT named MSAF$GUEST.   user          record(s) updatedF  This                installation updates an ACCOUNT named MSAF$GUEST.   user          record(s) updated  0  End           of DECshare File Server questions  $                                    *"  Print         Server Questions  *$                                    *    B   The DECshare Print Server requires an account which will be usedB   for  printing  jobs  received  from the Macintosh.  You must now1   enter a unique non-system UIC for this account.e  3  the  UIC for the MSAP$ACCOUNT account [[360,210]]:3H  This                installation creates an ACCOUNT named MSAP$ACCOUNT.'  user         record successfully added_U  identifier             MSAP$ACCOUNT value: [000360,000210] added to rights data base_H  This                installation updates an ACCOUNT named MSAP$ACCOUNT.   user          record(s) updatedH  This                installation updates an ACCOUNT named MSAP$ACCOUNT.   user          record(s) updatedH  This                installation updates an ACCOUNT named MSAP$ACCOUNT.   user          record(s) updated  1  End           of DECshare Print Server questions_  -                                             *E+  Online          Documentation Questions  *a-                                             *F                Installation     Script e                 E      PATHWORKS Online Documentation (in PostScript format) by default E      is installed in SYS$HELP.  You may specify an alternate location E      to install the documentation or accept the default  location  by_      hitting RETURN.  5  location     to install files [SYS$COMMON:[SYSHLP]]:i  <  End             of PATHWORKS Online Documentation questions  E      After this installation procedure completes, you  will  need  to E      edit   your   site-specific   startup   command  file  found  in +      SYS$MANAGER to add the following line:r  4                       $ @SYS$STARTUP:MSA$STARTUP.COM  E      This command procedure will start all  components  of  PATHWORKStE      for  OpenVMS  (Macintosh)  which  have  been  installed  on thisc      system.  1                           * * *   N O T E   * * *d  9                  PATHWORKS for OpenVMS (Macintosh) should_9                  be  started  only  after  DECnet and thei1                  queue manager have been started.l  E      We will now begin the installation of files and images  for  theD      selected components.C  .  No            further questions will be asked  3  Restoring                   product save set B ...r3  Restoring                   product save set C ...u3  Restoring                   product save set E ..._N  This                  product creates system directory [SYSHLP.EXAMPLES.MSA].;  Now              installing AppleTalk for OpenVMS files...i=  Now               installing AppleTalk for OpenVMS images... @  Now                installing AppleTalk/DECnet Gateway files...B  Now                 installing AppleTalk/DECnet Gateway images...;  Now               installing DECshare File Server files....  >  This                  product creates system directory [MSA].  E  If you intend to execute this layered product on other nodes in your D  VAXcluster, and you have the appropriate software license, you mustD  prepare the system-specific roots on the other nodes by issuing theF  following command on each node (using a suitably privileged account):  5  CREATE /DIRECTORY SYS$SPECIFIC:[MSA]/OWNER_UIC=[1,4]   ?                                 Sample Installation Script  A-5e p  d              F  This               product creates system directory [MSA.MSAF$ICONS].Q  This               product creates system specific directory [MSA.MSAF$SERVER0].u:  Now              installing DECshare management images...:  Now             installing DECshare File Server images...=  Now              deleting old DECshare Print Server forms...e9  Now            installing DECshare Print Server files...'H  This               product creates system directory [MSA.MSAP$UTILITY].O  This               product creates system specific directory [MSA.MSAP$SPOOL].e;  Now             installing DECshare Print Server images... I  Now            installing DECwindows AppleTalk (ADSP) Transport files... K  Now             installing DECwindows AppleTalk (ADSP) Transport images..._;  Now             installing PATHWORKS Mail Server images... B  Now            installing PATHWORKS Online Documentation files...1  Now            installing miscellaneous files... 3  Now             installing miscellaneous images...cH  Files                  will now be moved to their target directories...    AppleTalk   for OpenVMS...     AppleTalk/DECnet   Gateway...    DECshare   File Server...+  "DECshare           on PICKLE" is startingi    DECshare   Print Server...t  =  updating          printer device control library MSAP$DEVCTL W  module              MSAP$PROCSET0 inserted in SYS$COMMON:[SYSLIB]MSAP$DEVCTL.TMP_TLB;1lW  module              MSAP$PROCSET1 inserted in SYS$COMMON:[SYSLIB]MSAP$DEVCTL.TMP_TLB;1hW  module              MSAP$PROCSET2 inserted in SYS$COMMON:[SYSLIB]MSAP$DEVCTL.TMP_TLB;1-W  module              MSAP$PROCSET3 inserted in SYS$COMMON:[SYSLIB]MSAP$DEVCTL.TMP_TLB;1(W  module              MSAP$PROCSET4 inserted in SYS$COMMON:[SYSLIB]MSAP$DEVCTL.TMP_TLB;1-W  module              MSAP$PROCSET5 inserted in SYS$COMMON:[SYSLIB]MSAP$DEVCTL.TMP_TLB;1 )  SYS$COMMON:[SYSLIB]MSAP$DEVCTL.TMP_TLB;1 *  to   SYS$COMMON:[SYSLIB]MSAP$DEVCTL.TLB;2  no              files purged ,  printer                 data file not found  +  DECwindows   AppleTalk (ADSP) Transport...   ?   ************************************************************* ?   *                                                           * ?   *    Now starting Installation Verification Procedure for   * ?   *    PATHWORKS for OpenVMS (Macintosh) V1.3                 * ?   *                                                           **?   *************************************************************t    Installation     Script                   "  AppleTalk      for OpenVMS IVP...  L  for       OpenVMS Version 3.2 component versions as of 20-DEC-1994 14:34:21                          Version  &  interface                    ATK V3.2&  driver                       ATK V3.2&  stack                        ATK V3.2&  ACP                          ATK V3.2&  messages                     ATK V3.2&  library                      ATK V3.2&  Runtime      Library         ATK V3.2&  driver                       ATK V3.2(  driver                       ATKGW V1.3(  ACP                          ATKGW V1.3(  messages                     ATKGW V1.3  7  Installation         Verification on AppleTalk for VMS-  #                  version 03.02-0000   .  Verification           Completed Successfully  %  AppleTalk/DECnet      Gateway IVP...[  F  AppleTalk/DECnet               Gateway IVP has completed successfully  !  DECshare      File Server IVP... U  connection               established to file server "MSAF$IVP Test Server on PICKLE"2:  "MSAF$IVP              Test Server on PICKLE" is startingU  connection               established to file server "MSAF$IVP Test Server on PICKLE"YB  "MSAF$IVP                  Test Server on PICKLE" is stopping now  E  the              DECshare File Server IVP has completed successfullyo  "  DECshare      Print Server IVP...4  "MSAP$IVP              PICKLE Receiver" is starting4  "MSAP$IVP              PICKLE Symbiont" is startingW  MSAP$IVP (queue MSAP$IVP_PICKLE_SYMBIONT, entry 3) started on MSAP$IVP_PICKLE_SYMBIONT 4  "MSAP$IVP              PICKLE Symbiont" is stopping4  "MSAP$IVP              PICKLE Receiver" is stopping  F  the              DECshare Print Server IVP has completed successfully  2  DECwindows      AppleTalk (ADSP) Transport IVP...  ?                                 Sample Installation Script  A-7o                   ;  AppleTalk Data Stream Protocol (ADSP) DECwindows Transport*3           Installation Verification Procedure (IVP)e  8  beginning         part one (of two) - file verificationE  checking            for all required DECwindows ADSP Transport filesu$  all            required files found  part            one completeo  C  DECwindows           ADSP Transport IVP has completed successfully   A   ***************************************************************iA   *                                                             **A   *    Installation Verification Procedure for PATHWORKS for    *yA   *    OpenVMS (Macintosh) V1.3 has completed successfully.     *tA   *                                                             *cA   ***************************************************************     procedure     done at 14:35    /        logged    out at 20-DEC-1994 14:36:13.92d                                                  Installation     Script *  *                    ?                                                               B*> ______________________________________________________________  ?                                  Files Installed on Your Systemh    5    The PATHWORKS for OpenVMS (Macintosh) installationn:    procedure installs a number of files in your SYS$COMMON    root device.r  <    This appendix lists the files installed, their locations,8    and the component with which each file is associated.  9    Files are listed by directory in the following tables:   ,    SYS$COMMON:[MSA]                Table B-1  ,    SYS$COMMON:[MSA.MSAF$ICONS]     Table B-2  ,    SYS$COMMON:[MSA.MSAP$UTILITY]   Table B-3  ,    SYS$COMMON:[SYS$LDR]            Table B-4  ,    SYS$COMMON:[SYS$STARTUP]        Table B-5  ,    SYS$COMMON:[SYSEXE]             Table B-6  ,    SYS$COMMON:[SYSHLP]             Table B-7  ,    SYS$COMMON:[SYSHLP.EXAMPLES.MSA]Table B-8  ,    SYS$COMMON:[SYSLIB]             Table B-9  -    SYS$COMMON:[SYSMGR]             Table B-10   -    SYS$COMMON:[SYSMSG]             Table B-11.  -    SYS$COMMON:[SYSTEST]            Table B-12t  -    SYS$COMMON:[SYSTEST.ATK]        Table B-130  -    SYS$COMMON:[SYSTEST.ATKGW]      Table B-14   ?                             Files Installed on Your System  B-1                    ; Table_B-1_Directory:_SYS$COMMON:[MSA]______________________(  ; File_Name__________________Component_______________________T  / MSA$CREATE_ACCOUNTS.COM    DECshare file serverd  / MSAF$CLEANUP.COM           DECshare file servers  / MSAF$COMPRESS.COM          DECshare file server   / MSAF$DELETE_INTRUSION.COM  DECshare file server   / MSAF$EXCLUDE.TEMPLATE      DECshare file servers  / MSAF$FILE_TYPES.TEMPLATE   DECshare file serverb  / MSAF$GET_AND_HOLD_VOLUME_  DECshare file servern LOCK.EXE  / MSAF$ICONS.DAT             DECshare file servero  / MSAF$PROMISE_VOLUME_WAS_   DECshare file server  ONLY_MOVED.EXE  / MSAF$REPLACE_CONTROL_      DECshare file servere FILE.EXE  / MSAF$REPORT.COM            DECshare file server   / MSAF$RUN.COM               DECshare file server   / MSAF$SHOW_INTRUSION.COM    DECshare file servere  ; MSAF$SYRUN.TEMPLATE________DECshare_file_server____________t  ; Table_B-2_Directory:_SYS$COMMON:[MSA.MSAF$ICONS]___________M  ; File_Name__________________Component_______________________   / DDIF_CDAD.DAT              DECshare file serverO  / DOTS_CDAD.DAT              DECshare file server   / DTIF_CDAD.DAT              DECshare file server   / EXE_VMSS.DAT               DECshare file server   / MBIN_DECM.DAT              DECshare file server   / NOGO_MSAF.DAT              DECshare file serverl  / OBJ_VMSS.DAT               DECshare file serverR  / OLB_VMSS.DAT               DECshare file servere  / PICT_MDRW.DAT              DECshare file serverc  ;                                    (continued on next page)r    Installed    on Your System                   >    Table_B-2_(Cont.)__Directory:_SYS$COMMON:[MSA.MSAF$ICONS]__  >    File_Name__________________Component_______________________  2    PNTG_MPNT.DAT              DECshare file server  2    TEXT_TTXT.DAT              DECshare file server  2    TEXT_VMSS.DAT              DECshare file server  2    TEXT_XCEL.DAT              DECshare file server  2    UNKN_MSAF.DAT              DECshare file server  2    WDBM_MSWD.DAT              DECshare file server  >    WORD_MACA.DAT______________DECshare_file_server____________  >    Table_B-3__Directory:_SYS$COMMON:[MSA.MSAP$UTILITY]________  >    File_Name__________________Component_______________________  3    APLWIIF1.PPD               DECshare print serveri  3    APLWIIF2.PPD               DECshare print server   3    APLWIIG1.PPD               DECshare print servera  3    APLWIIG2.PPD               DECshare print server   3    APLWSEL.PPD                DECshare print server   3    APPLE380.PPD               DECshare print server   3    APPLE422.PPD               DECshare print server   3    APTOLLD1.PPD               DECshare print server   3    APTOLLW1.PPD               DECshare print server.  3    DC1152F1.PPD               DECshare print serverl  3    DC1152_1.PPD               DECshare print servern  3    DC2150P1.PPD               DECshare print serverk  3    DC2250P1.PPD               DECshare print servern  3    DC3250_1.PPD               DECshare print server   3    DC3500_1.PPD               DECshare print server   3    DCCOLOR1.PPD               DECshare print server   3    DCL11501.PPD               DECshare print server   3    DCL21501.PPD               DECshare print servert  ?                                        (continued on next page)   ?                             Files Installed on Your System  B-3i a  i              ; Table_B-3_(Cont.)_Directory:_SYS$COMMON:[MSA.MSAP$UTILITY]_I  ; File_Name__________________Component_______________________   0 DCL22501.PPD               DECshare print server  0 DCLF02F1.PPD               DECshare print server  0 DCLF02_1.PPD               DECshare print server  0 DCLN03R1.PPD               DECshare print server  0 DCLPS171.PPD               DECshare print server  0 DCLPS201.PPD               DECshare print server  0 DCLPS321.PPD               DECshare print server  0 DCLPS401.PPD               DECshare print server  0 DCPS1721.PPD               DECshare print server  0 DCPS1761.PPD               DECshare print server  0 DCPS17L1.PPD               DECshare print server  0 DCTPS201.PPD               DECshare print server  0 ENGLISH.TXT                DECshare print server  0 LWNTX470.PPD               DECshare print server  0 LWNTX518.PPD               DECshare print server  0 LWNT_470.PPD               DECshare print server  0 MSAP$BUILD_FORM.COM        DECshare print server  0 MSAP$CONVERT_OUTPUT.EXE    DECshare print server  0 MSAP$DECPREP0_0.PS         DECshare print server  0 MSAP$DECPREP5_0.PS         DECshare print server  0 MSAP$DECPREP5_1.PS         DECshare print server  0 MSAP$DECPREP5_2.PS         DECshare print server  0 MSAP$DECPREP6_0.PS         DECshare print server  0 MSAP$DECPREP7_0.PS         DECshare print server  0 MSAP$INSERT_DECPREP.COM    DECshare print server  0 MSAP$SET_PARAMS.PS         DECshare print server  ; MSAP$SHOW_PARAMS.PS________DECshare_print_server___________:    Installed    on Your System d                 >    Table_B-4__Directory:_SYS$COMMON:[SYS$LDR]_________________  >    File_Name__________________Component_______________________  3    ATK$APPLETALK_PROTOCOL_    AppleTalk for OpenVMSR    STACK.EXE[2]n  6    ATKGW$GWDRIVER.EXE[1]      AppleTalk/DECnet Gateway  3    ATK$PSDRIVER.EXE[1]        AppleTalk for OpenVMSP  3    ATK$EVDRIVER.EXE[1]        AppleTalk for OpenVMSi  3    EVDRIVER.EXE[2]            AppleTalk for OpenVMSS  8    GWDRIVER.EXE[2]            AppleTalk/DECnet Transport%                               Gateway   3    PSDRIVER.EXE[2]            AppleTalk for OpenVMSt>    [1]Alpha_only______________________________________________      [2]VAX only>    ___________________________________________________________  >    Table_B-5__Directory:_SYS$COMMON:[SYS$STARTUP]_____________  >    File_Name__________________Component_______________________  3    ATK$STARTUP.COM            AppleTalk for OpenVMS   8    ATKGW$STARTUP.COM          AppleTalk/DECnet Transport%                               Gateway*  ,    MSA$STARTUP.COM            All components  ,    MSA$SYSTARTUP.TEMPLATE     All components  2    MSAF$STARTUP.COM           DECshare file server  2    MSAX$STARTUP.COM           DECshare file server  3    MSAP$STARTUP.COM           DECshare print server2  >    MSAX$STARTUP.COM___________DECwindows_ADSP_transport_______  >    Table_B-6__Directory:_SYS$COMMON:[SYSEXE]__________________  >    File_Name__________________Component_______________________  3    ATK$APPLETALK_ACP.EXE      AppleTalk for OpenVMS   3    ATK$MANAGER.EXE            AppleTalk for OpenVMS   ?                                        (continued on next page)   ?                             Files Installed on Your System  B-5o p  T              ; Table_B-6_(Cont.)_Directory:_SYS$COMMON:[SYSEXE]___________   ; File_Name__________________Component_______________________P  5 ATKGW$APPLETALK_           AppleTalk/DECnet Transporto" GATEWAY.EXE                Gateway  . MSA$MANAGER.EXE            DECshare Management  . MSA$RMI_AGENT.EXE          DECshare Management  ) MSA$STOP_DEVICE_           All componentse
 OWNERS.EXE  / MSAF$SERVER.EXE            DECshare file server   0 MSAP$RECEIVER.EXE          DECshare print server  0 MSAP$SYMBIONT.EXE          DECshare print server  ) MSAX$CLIENT.COM            All componentsl  ) MSAX$ERROR.EXE             All componentsD  4 MSAX$MODMAP.EXE            DECwindows ADSP transport  ) MSAX$NORESTART.EXE         All components   ) MSAX$SET_LOGICAL.EXE       All components$  ) MSAX$TEST.COM              All components   ) MSAX$VERIFY.EXE            All componentsI  0 PCSA$MAIL_SERVER.EXE       PATHWORKS Mail server  ; PCSA_CLAIM_NAME.EXE________PATHWORKS_Mail_server___________   ; Table_B-7_Directory:_SYS$COMMON:[SYSHLP]___________________C  ; File_Name__________________Component_______________________   7 ATK$HELP.HLB               AppleTalk for OpenVMS online                             helpe  . MSA$MANAGER.HLB            DECshare Management  : MSA013$ADMIN_GUIDE.PS      Online documentation PostScript                             files  : MSA013$ADMIN_REF.PS        Online documentation PostScript                             files  : MSA013$INSTALL_GUIDE.PS    Online documentation PostScript                             files  : MSA013$INTRO_APPLETALK.PS  Online documentation PostScript; ___________________________files___________________________     Installed    on Your System                   >    Table_B-8__Directory:_SYS$COMMON:[SYSHLP.EXAMPLES.MSA]_____  >    File_Name__________________Component_______________________  3    ATK$TERMINAL.EXE           AppleTalk for OpenVMS   3    ATK$TERMINAL_STARTUP.COM   AppleTalk for OpenVMS*  3    ATKVMS_SAMPLE.BCK          AppleTalk for OpenVMS   ,    BACKUP-MAC.COM             All components  ,    BROADCAST.COM              All components  ,    BUILD_TALKER.COM           All components  2    MSAF$COMMENT.EXE           DECshare file server  2    MSAF$COPYPROTECT.EXE       DECshare file server  2    MSAF$MBIN_DUMP.C           DECshare file server  2    MSAF$MBIN_DUMP.EXE         DECshare file server  7    MSAX$INSCRIPTIONAL_        DECwindows ADSP transporte    EXTENDED_KEYBOARD.DAT  7    MSAX$POSITIONAL_EXTENDED   DECwindows ADSP transportd    _KEYBOARD.DAT  7    MSAX$STANDARD_EXTENDED     DECwindows ADSP transportc    _KEYBOARD.DAT  ,    TALKER.C                   All components  ,    TALKER.EXE                 All components  ,    TALKER.H                   All components  ,    ZONELIST.C                 All components  >    ZONELIST.EXE_______________All_components__________________  >    Table_B-9__Directory:_SYS$COMMON:[SYSLIB]__________________  >    File_Name__________________Component_______________________  3    ATK$API_SYMBOLS.ADA        AppleTalk for OpenVMST  3    ATK$API_SYMBOLS.FOR        AppleTalk for OpenVMS9  3    ATK$API_SYMBOLS.H          AppleTalk for OpenVMS   3    ATK$API_SYMBOLS.MAR        AppleTalk for OpenVMSC  3    ATK$API_SYMBOLS.PAS        AppleTalk for OpenVMS:  ?                                        (continued on next page)   ?                             Files Installed on Your System  B-7u y  m              ; Table_B-9_(Cont.)_Directory:_SYS$COMMON:[SYSLIB]____________  ; File_Name__________________Component________________________  0 ATK$API_SYMBOLS.PLI        AppleTalk for OpenVMS  0 ATK$API_SYMBOLS.R32        AppleTalk for OpenVMS  0 ATK$MESSAGES.ADA           AppleTalk for OpenVMS  0 ATK$MESSAGES.FOR           AppleTalk for OpenVMS  0 ATK$MESSAGES.H             AppleTalk for OpenVMS  0 ATK$MESSAGES.MAR           AppleTalk for OpenVMS  0 ATK$MESSAGES.PAS           AppleTalk for OpenVMS  0 ATK$MESSAGES.PLI           AppleTalk for OpenVMS  0 ATK$MESSAGES.R32           AppleTalk for OpenVMS  0 ATK$APPLETALK_RTL.EXE      AppleTalk for OpenVMS  0 ATK$PAP_RTL.EXE            AppleTalk for OpenVMS  5 ATKGW$SSI_ROUTINES.OLB     AppleTalk/DECnet TransportF"                            Gateway  5 ATKGW$SSI_SYMBOLS.ADA      AppleTalk/DECnet Transporte"                            Gateway  5 ATKGW$SSI_SYMBOLS.FOR      AppleTalk/DECnet TransportS"                            Gateway  5 ATKGW$SSI_SYMBOLS.H        AppleTalk/DECnet Transport_"                            Gateway  5 ATKGW$SSI_SYMBOLS.MAR      AppleTalk/DECnet Transporth"                            Gateway  5 ATKGW$SSI_SYMBOLS.PAS      AppleTalk/DECnet Transport "                            Gateway  5 ATKGW$SSI_SYMBOLS.PLI      AppleTalk/DECnet TransportA"                            Gateway  5 ATKGW$SSI_SYMBOLS.R32      AppleTalk/DECnet TransportL"                            Gateway  4 DECW$TRANSPORT_ADSP.EXE    DECwindows ADSP transport  ;                                    (continued on next page)     Installed    on Your System t                 >    Table_B-9_(Cont.)__Directory:_SYS$COMMON:[SYSLIB]__________  >    File_Name__________________Component_______________________  2    MSAF$SYS_STB_SHR.EXE       DECshare file server  3    MSAP$DEVCTL.TLB            DECshare print servere  3    MSAP$TRANS_POSTSCRIPT.EXE  DECshare print serverv  3    MSAP$TRANS_TEXT.EXE        DECshare print serverr  3    NETBIOS.EXE                PATHWORKS Mail server   3    NETBIOSSHR.EXE             PATHWORKS Mail server   >    PCSA_MAILSHR.EXE___________PATHWORKS_Mail_server___________  >    Table_B-10__Directory:_SYS$COMMON:[SYSMGR]_________________  >    File_Name__________________Component_______________________  3    ATK$CONFIG.COM             AppleTalk for OpenVMS   3    EVLOAD.COM                 AppleTalk for OpenVMS   >    MSA$SHUTDOWN.COM___________All_components__________________  >    Table_B-11__Directory:_SYS$COMMON:[SYSMSG]_________________  >    File_Name__________________Component_______________________  3    ATK$MESSAGES.EXE           AppleTalk for OpenVMS   8    ATKGW$MSG.EXE              AppleTalk/DECnet Transport%                               Gateway   1    MSA$MI_MSG.EXE             DECshare Management   2    MSAF$MSG.EXE               DECshare file server  2    MSAF$PWL_MSG.EXE           DECshare file server  3    MSAP$MSG.EXE               DECshare print server.  >    MSAX$ADSP_MSG.EXE__________DECwindows_ADSP_transport_______  ?                             Files Installed on Your System  B-9s e  i              ; Table_B-12_Directory:_SYS$COMMON:[SYSTEST]_________________L  ; File_Name__________________Component_______________________P  ) MSA$IVP.COM                All components   / MSAF$IVP.COM               DECshare file serverx  0 MSAP$IVP.COM               DECshare print server  ; MSAX$IVP.COM_______________DECwindows_ADSP_transport_______.  ; Table_B-13_Directory:_SYS$COMMON:[SYSTEST.ATK]______________  ; File_Name__________________Component_______________________   ; ATK$IVP.EXE________________AppleTalk_for_OpenVMS___________D  ; Table_B-14_Directory:_SYS$COMMON:[SYSTEST.ATKGW]___________n  ; File_Name__________________Component_______________________   5 ATKGW$IVP.EXE              AppleTalk/DECnet Transport2; ___________________________Gateway_________________________                                             Installed     on Your Systemr    v                    ?                                                               CD> ______________________________________________________________  ?     DECnet Objects Created by PATHWORKS for OpenVMS (Macintosh)L    <    The following DECnet objects are created by PATHWORKS for    VMS (Macintosh):n  > ______________________________________________________________            Object k  Name      Number  Used by...     Description______________________________________________________________D  8     85             AppleTalk for  Used by the router for6                    OpenVMS        DECnet tunnel ports.  6     0              AppleTalk      Used to make DECnet-6                    /DECnet        to-AppleTalk gateway.                    Transport      connections.                    Gateway  >        0           DECshare file  A DECshare remote management7                    and print      interface object used :                    servers        for remote management of9                                   DECshare file and print *                                   servers.  >    0               MacX X         Used for starting DECwindows6                    Window server  client applications.                    (MacintoshA                    application)X  >      0             PATHWORKS      Used for accessing PATHWORKSx                    Mail server    Mail from the Macintosh.______________________________________________________________                ?  Objects      Created by PATHWORKS for OpenVMS (Macintosh)  C-1                          ?                                                               D[> ______________________________________________________________  ?                                             Installing the XQP+_    =    The DECshare file server supports an improved OpenVMS file_=    system (XQP+). The XQP+ is an enhanced version of the XQP,_:    and helps improve the performance of your PATHWORKS for    OpenVMS (Macintosh) server.  >    A single separately installable kit is provided for OpenVMS.    VAX Version 5.5-2 a nd Version 6.0 systems.  =    VAX and Alpha OpenVMS Version 6.1 systems include the XQP+$=    features as part of the standard system. All that needs toO=    be done on Version 6.1 is to enable the appropriate SYSGEN >    parameters (see the OpenVMS Version 6.1 New Features Manual    for details).  =    For more information on the XQP+ features and installation_#    on a VMScluster, see Appendix E._    Steps  +    To install the XQP+, follow these steps:A  =    1. Check that you are running OpenVMS VAX Version 5.5-2 or 
       6.0.  0    2. Check that you do not have an XQP image in       SYS$SPECIFIC:[SYSEXE].  6       The installation procedure aborts if it finds an0       F11BXQP.EXE file in SYS$SPECIFIC:[SYSEXE].      3. Back up your system disk._  (    4. Choose a time when you can reboot.  =    5. Enter the following command to run VMSINSTAL to installk3       the XQP+ on OpenVMS VAX Version 5.5-2 or 6.0:y  5       $ @SYS$UPDATE:VMSINSTAL VAXPWF11X01_060 device:$  ?                                        Installing the XQP+  D-1     l              :    where device: is the name of the tape drive or the disk;    and directory where the VAXPWF11X01_060.A kit is stored.P  9    ________________________ Note ________________________O  2    This single installable kit (VAXPWF11X01_060.A)0    contains versions of the XQP+ for OpenVMS VAX    Versions 5.5-2 and 6.0.  9    ______________________________________________________C  7 6. If you are running the XQP+ in a VMScluster, set theA7    XQP+ related system parameters to the same values ont5    all the nodes (VMSD2 and ACP_WRITEBACK for OpenVMS 9    VAX Version 5.5-2 and XQPCTLD1, XQPCTL2, ACP_WRITEBACK_6    for OpenVMS VAX Version 6.x). See the next section,;    Responding to VMSINSTAL Questions, for more information._  8    The installation procedure sets the system parameters:    only on the node on which you run the procedure. If you:    have a VMScluster with multiple system disks, make sure:    you run the installation procedure on each system disk.    to     VMSINSTAL QuestionsF  4 Each VMSINSTAL question you need to answer is marked8 with an asterisk (*)  at the beginning of the line. Some8 questions show a default response in square brackets. To# accept the default, press <Return>.   8 The following is a list of questions that VMSINSTAL asks6 during the installation. Depending on your system, you4 might see additional messages and questions when you perform your installation:   1. Active Processes_  A    %VMSINSTAL-W-ACTIVE, The following processes are still active:X    .    .    .)    * Do you want to continue anyway [NO]?.  
    Enter YES.o    the         XQP+M A  E                  2. System Backup   D       * Are you satisfied with the backup of your system disk [YES]?  >       If you have not made a backup, or are not satisfied with=       the backup you made, enter NO to stop the installation. <       After you have backed up your system disk, restart the       installation.   9       If you are satisfied with the backup of your systeme(       disk, press <Return> to enter YES.      3. XQP+ Save Set Location  7       * Where will the distribution volumes be mounted:E  ;       The XQP+ installation kit is stored in the same placeE;       as the PATHWORKS for OpenVMS (Macintosh) kit. If this ;       was a CDROM distribution, VAXPWF11X01_060.A is in the 9       same directory. If this was a magtape distribution, ,       VAXPWF11X01_060.A is on the same tape.      4. Product Name  D       Enter the products to be processed from the first distribution       volume set.S         *    Products:         Enter VAXPWF11X01_060.      5. Installation Options  :       * Enter installation options you wish to use (none):  #       Press <Return> to enter NONE.   !    6. Continuing the InstallationA  '       * Continue the Installation? [Y]?   "       Press <Return> to enter YES.      7. Purging Files   G       * Do you want to purge files replaced by this installation [YES]?   "       Press <Return> to enter YES.  ?                                        Installing the XQP+  D-3  u  y               8. System Shutdown  E    * Will you allow a system shutdown after this product is installed_      [YES]?_      Press <Return> to enter NO.  ;    If you enter NO, the installation procedure continues as ;    normal, but the system does not reboot. The XQP+ becomesp)    active whenever you reboot the system.   8 On some systems, the installation procedure may make the  following additional statements:   o  Location of the XQP  ;  image          does not reside in SYS$COMMON:[SYSEXE]. The >  will       abort because of this. Please see the Installation  more    information.a  /    This indicates that a version of the XQP maya2    have been placed in SYS$SPECIFIC:[SYSEXE]. This7    installation replaces the XQP image only if it is inC    SYS$COMMON:[SYSEXE].    o  Special Versions of the XQP  ?  procedure           has detected that there may be a danger of >  bugfixes   to your current F11BXQP.EXE. The installation will     consult the installation guide.  5    This indicates that the installation procedure has 4    detected a special version of the old XQP on your;    system. Bug fixes made to the old XQP may not be present 4    in the XQP+, resulting in regression. Consult the0    supplier of the old XQP for further guidance.                  the         XQP+.                     Sample  Installation   6    The following is a sample XQP+ installation script:  '      Welcome to OpenVMS VAX Version 6.0     SYSTEMG  >      Welcome to OpenVMS VAX version Version 6.0 on node JUGGLE4  Last interactive login on Friday, 16-DEC-1994 10:308  Last non-interactive login on Friday, 16-DEC-1994 11:48  ,  VAXPWF11X01_060                     MKA500:  D      OpenVMS VAX Software Product Installation Procedure Version 6.0      It is 16-DEC-1994 at 13:54.  ,  a   question mark (?) at any time for help.  ?  you   satisfied with the backup of your system disk [YES]? YEST  &  following products will be processed:    Version            6.0e  @      Beginning installation of VAXPWF11X01_ Version 6.0 at 13:54  3  Restoring                   product save set A ...eH  Product's                    release notes have been moved to SYS$HELP.  F    o Depending on your system, this installation procedure will change=      the following system parameters to the following values:C  ,        System         Parameter        Value,        ------         ---------        -----(        Standalone or  XQPCTLD1         8(        XQP+ only      XQPCTL2          1(        VMScluster     ACP_WRITEBACK    1  (        VMScluster     XQPCTLD1         0(        with XQP+ and  XQPCTL2          0(        original XQP   ACP_WRITEBACK    1        nodes  0    o The original XQP will be saved in the file:  '              SYS$SYSTEM:F11BXQP_OLD.EXE   ?                                        Installing the XQP+  D-5X                   <  The  following deinstallation procedure will be provided to5   allow you to back out the changes made by this kit:s  (           SYS$UPDATE:PWF11X$DEINSTAL.COM  8  To  activate the XQP+, a reboot is required. During the:   installation, a question will ask if it is convenient to8   shutdown the system. If you enter NO, the installation<   will continue as normal but will not shutdown your system.     the     Installation?  [Y]? YES  7  procedure             will change the following systems  to       the following values:        Parameter      Value     ---------      -----     XQPCTLD1       8     XQPCTL2        1     ACP_WRITEBACK  1  )  add     these settings to MODPARAMS.DAT._  ?  want   to purge files replaced by this installation [YES]? YES_  =  complete the installation of this product, you should rebootc?  system.   If it is not convenient to reboot at this time, then_!  NO    to the following question._  8  you enter NO, the installation procedure will continue.  <  you allow a system shutdown after this product is installed  NO <  This                installation procedure will not ask any
  questions0  Restoring                product save set C ...H  Files                  will now be moved to their target directories...  =   Installation of VAXPWF11X01_ Version 6.0 completed at 13:55A  #   VMSINSTAL procedure done at 13:55           the         XQP+t r  r                    ?                                                               E_> ______________________________________________________________  ?                                         Configuringing the XQP+_    9    The OpenVMS file system is implemented by the XQP. Thed<    XQP+ is an enhanced version of the XQP, and helps improve<    the performance of your PATHWORKS for OpenVMS (Macintosh)
    server.  )    This appendix discusses the following:g      o  New features  3    o  Controlling the new features on Version 5.5-2t  1    o  Controlling the new features on Version 6.xr  &    o  Controlling XQP+ in a VMScluster  :    o  Mixed OpenVMS Version 5.5-2 and Version 6.x clusters  %    o  Controlling DECshare XQP+ usage       o  Deinstalling the XQP+e      o  Known problems  	  Features   <    The XQP+ provides new features to improve the performance    of the DECshare file server:                   ?                                    Configuringing the XQP+  E-1                  ; ___________________________________________________________i New_; Feature_____Description____________________________________t  6 MultithreadiAllows the DECshare file server to perform6             up to eight concurrent OpenVMS file system#             operations in parallel.   5 Improved    Allows the OpenVMS file system to process 7 concur-     multiple file create operations on a single_7 rency       disk in parallel. Normally in a VMScluster, :             only one process can create files on a disk at             a time.   5 AsynchronousAllows the DECshare file server to return 2 cache       control to the PATHWORKS client before2 writes      completing certain OpenVMS file system7             operations. This improves the response times5             for accessing files from the file server.5  ; Multiblock  Reduces the time the OpenVMS file system spendsn" bitmap      allocating disk space.; reads______________________________________________________   '  the      New Features on Version 5.5-2p  4 Three of the new XQP+ features are controlled by the7 following OpenVMS Version 5.5-2 SYSGEN parameters. Note 9 that OpenVMS Version 6.x uses different SYSGEN parameters - (see the next section for Version 6.x usage).                                   the             XQP+h y  a            >    ___________________________________________________________>    Parameter_____Description__________________________________  =    VMSD2         Enables and disables multithreading. EnablesQ3                  and disables improved concurrency. >                  _____________________________________________>                  Value_Result_________________________________  7                  1     Disables multithreading. Enables ,                        improved concurrency.  6                  8     Enables multithreading. Enables,                        improved concurrency.  8                  32769 Disables multithreading. Disables,                        improved concurrency.  9                        Note that a disk benefits from the_<                        improved concurrency only if VMSD2 is>                  ______set_to_8_when_the_disk_is_mounted._____  8    ACP_          Enables and disables asynchronous cache    WRITEBACK     writes.>                  _____________________________________________>                  Value_Result_________________________________  :                  0     Disables asynchronous cache writes.  >                  1_____Enables_asynchronous_cache_writes._____  >    ___________________________________________________________  (  the         New Features on Version 6.x  5    The new features of the XQP+ are controlled by the ;    following three OpenVMS 6.x SYSGEN parameters. Note thatw>    OpenVMS Version 5.5-2 uses different SYSGEN parameters (see1    the previous section for Version 5.5-2 usage).A  >    ___________________________________________________________>    Parameter_Description______________________________________  1    XQPCTLD1  Enables and disables multithreading.o>              _________________________________________________>              Value_Result_____________________________________  *              8     Enables multithreading.  >              0_____Disables_multithreading.___________________  ?                                    Configuringing the XQP+  E-3s                 ; ___________________________________________________________]; Parameter_Description______________________________________   4 XQPCTL2   Enables and disables improved concurrency.;           _________________________________________________ ;           Value_Result_____________________________________p  -           1     Enables improved concurrency.   ;           0_____Disables_improved_concurrency._____________   9 ACP_      Enables and disables asynchronous cache writes.p; WRITEBACK _________________________________________________ ;           Value_Result_____________________________________b  2           1     Enables asynchronous cache writes.  ;           0_____Disables_asynchronous_cache_writes.________r  ; ___________________________________________________________i    XQP+      in a VMScluster  + On each system in a VMScluster, you should:   8 o  Set each parameter to the same value. For example, if:    the installation procedure sets ACP_WRITEBACK to 1, set%    ACP_WRITEBACK to 1 on each system.   8 o  Update the MODPARAMS.DAT file so that it reflects the    new parameter values.  .  Version        5.5-2 and Version 6.x Clusters  9 VMSclusters Running OpenVMS Version 5.5-2 and Version 6.xO  6 In a VMScluster, OpenVMS Version 5.5-2 and Version 6.x: systems that run their respective versions of the XQP+ can8 coexist. Make sure, however, that all the systems in the cluster run the XQP+.t    DECshare      XQP+ Usage   ; You can use two logical names to control multithreading and : asynchronous cache writes within the DECshare file server:   o  MSAF$SERVER_MAX_XQP_THREADS  % o  MSAF$SERVER_XQP_ASYNC_CACHE_WRITESu    the             XQP+E _                 6    If you have enabled multithreading, you can use the:    MSAF$SERVER_MAX_XQP_THREADS logical name to specify the>    maximum number of concurrent OpenVMS file system operations     for the DECshare file server.  5    $ DEFINE/SYSTEM/EXEC MSAF$SERVER_MAX_XQP_THREADS 8a  <    If the logical name is not defined, the default is 8. The9    minimum is 0. If you specify a value of 1 or 0, multi-s    threading is switched off.l  9    If you have enabled asynchronous cache writes, you canr=    use the MSAF$SERVER_XQP_ASYNC_CACHE_WRITES logical name toX     switch the feature on or off:       $ DEFINE/SYSTEM/EXEC -,    _$ MSAF$SERVER_XQP_ASYNC_CACHE_WRITES YES       $ DEFINE/SYSTEM/EXEC -+    _$ MSAF$SERVER_XQP_ASYNC_CACHE_WRITES NOa  8    You must restart the DECshare file server for the new    values to take effect.e  =    See the PATHWORKS for OpenVMS (Macintosh) Server Referencer<    Manual appendix for a description of these logical names.    the          XQP+  ;    You need to install the XQP+ only on OpenVMS VAX Versione9    5.5-2 and Version 6.0 systems. The XQP+ is standard onX9    Alpha and VAX OpenVMS Version 6.1 systems and does not.    require installation.  :    Use the VMSINSTAL command procedure to install the XQP+2    from the PATHWORKS for OpenVMS (Macintosh) kit.  5    $ @SYS$UPDATE:VMSINSTAL VAXPWF11X01_060 kit_media:o  >    VAXPWF11X01_060 contains XQP+ versions for both OpenVMS VAX!    Version 5.5-2 and Version 6.0.t  <    To make sure you can restore the old XQP at any time, the=    installation procedure copies the old XQP and stores it int;    SYS$SYSTEM:F11BXQP_OLD.EXE (on OpenVMS VAX Version 5.5-25!    and Version 6.0 systems only).   ?                                    Configuringing the XQP+  E-5i [  ]              9 To deinstall the XQP+, follow these steps for each system.% disk on which you installed the XQP+:X  $ 1. Run the deinstallation procedure:       $ @SYS$UPDATE:PWF11X$DEINSTAL  9    The deinstallation procedure fails if it cannot locateb    the old XQP.H  9 2. Reset the SYSGEN parameters to their default values one!    every node in your VMScluster:g  ;    ________________________________________________________ ;    On_...______The_default_values_are_...__________________   (    An OpenVMS  VMSD2=0, ACP_WRITEBACK=1.
    Version    5.5-2	    system   6    An OpenVMS  XQPCTLD1=0, XQPCTL2=0, ACP_WRITEBACK=1.
    Version;    6.x_system______________________________________________C   3. Reboot the system.i   o  Location of the current XQP  8    If the installation procedure finds a copy of the XQP7    in SYS$SPECIFIC:[SYSEXE], the XQP+ is installed. The 8    procedure only replaces the file F11BXQP.EXE if it is;    in SYS$COMMON:[SYSEXE], and there are no copies of it ine    SYS$SPECIFIC:[SYSEXE].o  4 o  VMSclusters running both the XQP+ and the old XQP  7    Under very exceptional circumstances, deadlocks haveQ7    occurred in VMScluster systems running both the XQP+u6    and the original XQP. These deadlocks have occurred:    only under extremely heavy loads created by special XQP6    stressing software. The deadlocks have not occurred4    under typical system loads, and do not occur with6    VMScluster systems running the XQP+ on all systems.    the             XQP+  V  e              8       To accommodate this problem, the XQP+ installation8       procedure asks you if you are going to install the;       XQP+ on all systems in your VMScluster. If you answeri<       No, the procedure disables multithreading and improved;       concurrency. In this case, disable multithreading ando;       improved concurrency on all the other systems in your        VMScluster.i  =    o  To control improved concurrency and multithreading, theo=       Version 6.0 parameters XQPCTLD1 and XQPCTL2 replace thei$       Version 5.5-2 parameter VMSD2.  4       The following table shows you how to set these;       parameters consistently in a VMScluster that has bothr,       Version 5.5-2 and Version 6.0 systems.  >       ________________________________________________________"                       On a Version;       If you want to  5.5-2 system  On a Version 6.0 system >       ..._____________...___________..._______________________  8       Enable          Set VMSD2 to  Set XQPCTL2 to 1 and2       improved        8.            XQPCTLD1 to 8.       concurrencyy	       andl       multithreading  8       Disable         Set VMSD2 to  Set XQPCTL2 to 0 and2       improved        32769.        XQPCTLD1 to 0.       concurrencys	       and >       multithreading__________________________________________  #    o  Upgrading OpenVMS VAX systems   9       If you upgrade your OpenVMS VAX system from Versiono8       5.5-2 to Version 6.0, you must reinstall the XQP+.                ?                                    Configuringing the XQP+  E-7e P  s                            ; ___________________________________________________________   <                                                        Index      /                              Checklist (cont'd) 9 _________________________      preinstallation tasks, 2-1 8  Transport                     VMScluster configuration,  $                                  5-1,   5-5                        Client software9  of,         2-2               standalone system and, 4-4 '  space  requirements, 2-6    Componentsy2   3-9                          description of, 2-2;   3-9                          disk space requirements, 2-5 /  for     OpenVMS               location of, 2-6c1  of,         2-2               prerequisites, 3-6 -  space  requirements, 2-6      selecting, 3-6 *   3-8                        Configuration5  a     new version, 4-3        overview of tasks, 1-1 6  port     and, 5-3             standalone systems, 4-46  requirements,     2-4         VMScluster systems, 5-14   5-3                        Configuration procedure  ,                                aborting, 5-3f                                canceling, 5-5                                            ConfigurationZ                                running, 5-2                                        command    system      parameter<                              D______________________2-9_____  '                              DCL tablesVF                                replacing, 5-2_________________________T                              DECnet                                 recommendations,3                                objects created, C-1_9                                prerequisite software for,_$ _________________________        2-47  parameter                     status while installing, )   2-8                            3-4, 5-3u8  value,      2-7               version requirements, 2-4    tasks,          3-1  tasks,              4-1  <                                                      Index-1 t  r              .  file   server              GBLPAGES parameter,  volumes,   5-7               checking,  2-72   5-7                         required value,  2-71  of,        2-2             GBLSECTIONS parametera,  space requirements, 2-6      checking,  2-72  performance      on,         required value,  2-7;                             Guest access to DECshare,  3-10c   3-10;   3-10                      H______________________________s$  print   server             Hardware;  of,        2-2               required before installation,i$  space requirements, 2-6         2-3   3-11  ADSP     transport         I q                             _______________________________                                                   of,.t                             Installation checklist,  3-1                                                       spacec                             Installation procedure                                         softwaret,                               aborting,  3-3e                               completing,  3-12                                          requirementspf                               files installed by,  B-1                                             2-50                               for the XQP+,  D-5H                               overview of,  1-1_________________________R                               planning,  2-2                                   and+                               running,  3-3 j                               sample script,  A-1                                              controllersV                               starting,  3-2                                       for5                             Installation Verification_(                                ProcedureY                               error messages,  3-14                                   5-4 :                               running automatically,  3-5,%                                  3-12_R                               running independently,  4-3_________________________                               IVP_;   B-1                         See Installation Verification *   3-6                            Procedure  ;  file         server        L_______________________________  $                             Log file* _________________________     naming,  5-4"                            Logging6                               enabling/disabling,  5-4    Gateway _  _              4                                 PQL_MBYTLM parameterK                                  checking,  2-7____________________________ n                                  required value,  2-7                                                   servert                                 Preinstallation checklist, 2-1                                                   of,y                                 Prerequisite hardware, 2-3                                                      parameternm                                 Prerequisite software, 2-4                                                2-7tV                                 Primary port                                    value,\                                  setting up,  5-3                                      filesa                                  zone name,  5-3                                            space   Q                                 Print server                                 filee  :   2-9                            See DECshare print server*                                 PrivilegesW                                  required for installation,____________________________E'                                     2-5 j                                 Process account quotas                                             ranges,q                                  required for installation,                                                   theP'   1-2                               2-6s2                                 Product components5                                  description of,  2-2 2 ____________________________     location of,  2-6  PostScriptT? Documentation                   Q______________________________w&  of,            2-3             Quotas;   3-12                           required for installation,n  T                                     2-6                                requirements,    N     parameter to ? VMSINSTAL command,  3-3,        R______________________________h  - 3-5                             Release notesV0                                  file name,  3-5V                                  OPTIONS N parameter,  3-3____________________________l                                  ways to view,  3-5                                                 Listing,U                                 Requirements                                     Mail p                                  prerequisite hardware,  2-3                                                 of,y                                  prerequisite software,  2-4                                                        space   !  improving,           1-1,      S ? D-1                             _______________________________ov                                 Sample installation script,                                                     layoutC                                   A-1                           1-2fz                                 Shutdown                         tasks,                                                5-9o                                  AppleTalk upgrade and,  4-3                                              tasks_Z                                  automating,  4-3                                      4-12                                  upgrade and,  3-2  ?                                                         Index-3_ _  _                h                             U______________________of______                                     product,#  before     installation,   UpgradeE  0                               shutdown for,  3-2/  system                       startup for,  5-6O   4-4Y  q                             V______________________________                                                   4-2o  \                             VMScluster systems                                          and,l                               checklist for configuring,                                                file                                  5-1                              to                                                           dismod                               installing on,  3-2                                                4-3X                             VMSINSTAL procedure                                     fileT                               aborting,  3-3                                      to/                               completing,  3-12mg                               description of,  3-1                                                 diskcv                               error messages and conditions                                                       2-5,W                                  , 3-13                                      parameters i                               files installed by,  B-1                                                2-9lk                               OPTIONS N parameter,  3-3                                                 2-7_O                               running,  3-3                                 2-6yi                               sample script,  A-1                                                shutdown_h                               sample XQP+ script,  D-5                                                to,                               starting,  3-2L                             Volumes                                  startupP                               adding,  5-7                                    to  ;                             X_______________________________  8                             XQP_________________________0                               and the XQP+,  D-4N                             XQP+,  1-1                              standalonei                               installation script,  D-5                                               4-4_^                               installing,  D-1                                      VMScluster     5-1                       Z o                             _______________________________                                                 3-1 6                             Zones                  5-9  +   4-1                         See AppleTalk    2-1C