This chapter describes:

• How to read the online release notes before installation.
• How to install MACRO--64 Assembler using POLYCENTER Software Installation (PCSI) software. PCSI software is bundled with the OpenVMS operating system.

Before you start the installation, read Chapter 1, which describes the general options and requirements for installing MACRO--64 Assembler.

The installation procedure loads MACRO--64 Assembler product distribution files on to the system disk on the system where you perform the installation.

Follow these steps to install MACRO--64 Assembler from the OpenVMS Alpha Software Products Library CD-ROM set:

1. Log in to a privileged account on the system (or cluster) where you will install MACRO--64 Assembler. This account must have the following privileges enabled:
   • CMKRNL
   • SYSLCK
   • SYSPRV
   
   Do not proceed with the installation unless your account has the CMKRNL, SYSLCK, and SYSPRV privileges enabled. If your process has the SETPRV privilege, you can enable the CMKRNL, SYSLCK, and SYSPRV privileges by typing the following command:

   $ SET PROCESS/PRIVILEGE=(CMKRNL,SYSLCK,SYSPRV)

   
   To check whether your process has these privileges enabled, type the following command:

   $ SHOW PROCESS/PRIVILEGES

2. To obtain the kit directory location of the MACRO--64 Assembler product distribution files on the appropriate OpenVMS Alpha Software Product Library CD-ROM (media CD-ROM), do one of the following:
   • Use the CDMENU utility provided on the media CD-ROM.
   • View the CD-ROM master index file on the media CD-ROM.
   • Contact the appropriate system manager.
   
   For information about using the CDMENU utility and the CD-ROM files on the media CD-ROM set, see the Software Product Library CD--ROM User's Guide (media CD-ROM user guide), which accompanies the media CD-ROM distribution kit. The media CD-ROM user guide and CD-ROM master index file are provided as online files in the [README] directory on the first media CD-ROM.
3. To determine whether the appropriate media CD-ROM is already mounted on your system, type the following command:

   $ SHOW DEVICE DKA400

   Note DKA400 is the device name used in examples in this document to show where the appropriate media CD-ROM has been mounted.

4. If the media CD-ROM containing the MACRO--64 Assembler installation files is not mounted, either contact the appropriate system manager or insert the appropriate media CD-ROM (write down the volume label) into an available CD-ROM drive. Type the appropriate MOUNT command to mount the media CD-ROM (omit the /FOREIGN qualifier), such as the following:

   $ MOUNT DKA400 label

   
   Where label is the volume label of that media CD-ROM.

5. To check that you have located the correct CD-ROM device and directory, use the following DIRECTORY command:

   $ DIRECTORY Directory DKA400:[dir.subdir] DEC-AXPVMS-MACRO64-Vnnnn-x-1.PCSI Total of 1 files.

6. To extract the MACRO--64 Assembler online release notes before you install MACRO--64 Assembler, type the following command:

   $ PRODUCT EXTRACT RELEASE_NOTES MACRO64 /SOURCE=disk:[dir] - $_/FILE=MACRO64.RELNOTES

   
   In this command, disk:[dir] is the specification of the disk and directory containing the product installation files.
   You can view or print the file MACRO64.RELNOTES before you continue with the installation (next command). For example:

   $ TYPE/PAGE MACRO64.RELNOTES

7. If the MACRO64 Assembler was previously installed on this system, it must be removed before MACRO--64 Assembler is installed. To determine if an older version of MACRO64 present, type the following command:

   $ PRODUCT SHOW PRODUCT MACRO64

   
   If MACRO64 is present, the following text appears:

   PRODUCT ------- DEC AXPVMS MACRO64 V1.1-1 1 item found

   
   If MACRO64 is not present, the following text appears:

   PRODUCT ------- 0 items found

   
   If MACRO64 is present, remove it by typing the following PRODUCT REMOVE command:

   $ PRODUCT REMOVE MACRO64

   
   The following text appears:

   The following product has been selected: DEC AXPVMS MACRO64 Vn.n Layered Product Do you want to continue? [YES] The following product will be removed: DEC AXPVMS MACRO64 V1.2 Layered Product Portion done: 0%...30%...40%...50%...60%...70%...80%...90%...100% The following product has been removed: DEC AXPVMS MACRO64 V1.2 Layered Product

8. To install the MACRO--64 Assembler Assembler, type the following PRODUCT INSTALL command:

   $ PRODUCT INSTALL MACRO64 /SOURCE=disk:[dir] /HELP

   
   Where disk:[dir] is the specification of the disk and directory containing the product installation files.
   The following text appears:

   The following product has been selected: DEC AXPVMS MACRO64 Vn.n Layered Product Configuration phase starting ... You will be asked to choose options, if any, for each selected product and for any products that may be installed to satisfy software dependency requirements. DEC AXPVMS MACRO64 V1.2: MACRO-64 Assembler for OpenVMS Alpha COPYRIGHT (c) 1998 -- All rights reserved Digital Equipment Corporation Do you want the defaults for all options? [YES] Do you want to review the options? [NO]

   
   If you wish to review the options, type YES, otherwise type NO.
   Installation continues with the following text displayed:

   Execution phase starting ... The following product will be installed: DEC AXPVMS MACRO64 Vn.n Layered Product Portion done: 0%...50%...60%...70%...80%...90%...100% The following product has been installed: DEC AXPVMS MACRO64 V1.2 Layered Product %PCSI-I-IVPEXECUTE, test procedure executing ... %PCSI-I-IVPSUCCESS, test procedure completed successfully

   
   

9. Installation takes about 2-5 minutes (depending on your system). When installation has been completed, the DCL $ prompt reappears.
10. To obtain a list of files installed, type the following command:

    $ PRODUCT SHOW OBJECT /PRODUCT=MACRO64

To use other features of the PCSI utility, see the POLYCENTER Software Installation Utility User's Guide.

The following tasks can be performed after MACRO--64 Assembler is installed:

• Running the Installation Verification Procedure (IVP) separately
• Making the recently installed MACRO64 commands available to users after installation
• Making the product usable on a VMScluster
• Setting user account quotas
• Enhancing performance
• Getting help and reporting problems

The MACRO--64 Assembler Installation Verification Procedure (IVP) runs automatically during MACRO--64 Assembler installation.

If system problems occur, you should run the IVP separately to ensure the integrity of the installed files. To run the IVP, type the following command:

$ @SYS$TEST:MACRO64$IVP.COM

If any problems are encountered, a message such as the following appears:

Digital MACRO64 Version 1.n TEST FAILED

3.2 VMScluster Considerations

If you want to run MACRO--64 Assembler on multiple nodes of a VMScluster, first check to see that you have the appropriate software license (see Section 1.3). Then perform the following steps after you install MACRO--64 Assembler:

1. Issue the LICENSE LOAD command, as described in the OpenVMS License Management Utility Manual, to activate the license on each node in the VMScluster on which MACRO--64 Assembler is to be executed.
2. The commands in this step should be executed on all cluster nodes, whether or not they are licensed to use MACRO--64 Assembler; failure to do so may cause unexpected errors for users.

   Note If you are using a dual-architecture (VAX and Alpha systems) heterogeneous cluster, before executing these commands, make sure the appropriate logical names have been set to define the scope of the SYSMAN DO commands. For more information, see the OpenVMS System Manager's Manual.

   
   While logged in as SYSTEM, or as another username that has the CMKRNL and SYSPRV privileges enabled, use the OpenVMS SYSMAN utility to make the new versions of DCLTABLES.EXE available, as follows:

   $ RUN SYS$SYSTEM:SYSMAN SYSMAN> SET ENVIRONMENT/CLUSTER %SYSMAN-I-ENV, current command environment: Clusterwide on local cluster Username SYSTEM will be used on nonlocal nodes SYSMAN> DO INSTALL REPLACE SYS$LIBRARY:DCLTABLES.EXE %SYSMAN-I-OUTPUT, command execution on node NODE1 %SYSMAN-I-OUTPUT, command execution on node NODE2

   
   The SYSMAN utility will cause each DO command to be executed on all nodes of the local cluster.

3. Finally, exit from SYSMAN.

   SYSMAN> EXIT $

MACRO--64 Assembler is now installed and can be invoked by all users with the MACRO64 commands.

The installation procedure modifies the DCL command table so that the MACRO64 commands are recognized and processed. However, the previous command table is still in effect for those users who are currently logged in.

All logged-in users who want to use the MACRO64 commands must log out and log in again, or use the following DCL command:

$ SET COMMAND /TABLES=SYS$LIBRARY:DCLTABLES

3.4 User Account Requirements

No special privileges are needed to use MACRO--64 Assembler. There is no benefit from installing the compilers with privileges.

To use MACRO--64 Assembler, a user account does not need to meet any special quota requirements. However, for users who will be compiling very large programs (many program units compiled together) or running very large performance-critical programs, consider the adjusting working set (WSDEF, WSQUOTA, WSEXTENT) and page file (PGFLQUOTA) account quotas to improve performance.

Use the OpenVMS Authorize Utility from a suitably privileged account to change the process quotas in the user authorization file (UAF). Some sites may restrict the use of the Authorize Utility to certain accounts or people.

After the quotas for the account have been changed, the user should log out of the account and log in again for the new quotas to take effect.

For information on using the Authorize Utility, see the OpenVMS System Manager's Manual: Essentials.

3.5 Enhancing MACRO--64 Assembler Performance

This section includes information on system tuning and explains how to install MACRO--64 Assembler as a shared image.

After you install MACRO--64 Assembler, you might want to adjust your system to enhance performance or lower the use of some system resources.

If users will be compiling very large programs (many program units compiled together) or running very large performance-critical programs, consider the following:

• Check that adequate page file space exists. Large programs need more virtual memory during compilation and execution than small programs. Use the INSTALL command to extend an existing page file or create one or more new page files.
• The SYSGEN parameter virtual page count is related to the total amount of page file space. If you create more page file space, review the virtual page count parameter and increase it if necessary.
• The SYSGEN parameter maximum working set (WSMAX) might also be checked if a larger process working set is needed.

For more information on page file use and SYSGEN parameters, see the OpenVMS System Manager's Manual: Tuning, Monitoring, and Complex Systems. For information about system tuning and performance investigation, see the Guide to OpenVMS Performance Management.

3.6 Removing Digital MACRO64

To remove Digital MACRO64 from the system, use the following command:

$ PRODUCT REMOVE MACRO64

3.7 Troubleshooting Tips

If your installation is not successful, check for the following possible problems:

• The appropriate PAK must be available to the user performing the installation. The PAK must be registered and loaded before you can install MACRO--64 Assembler. For information about registering a PAK, see Section 1.3. Then reinstall MACRO--64 Assembler.
• The DCLTABLES.EXE file should be in the SYS$COMMON:[SYSLIB] directory. There should not be a copy of DCLTABLES.EXE in SYS$SPECIFIC:[SYSLIB].
  If a copy of DCLTABLES.EXE is found in a SYS$SPECIFIC root, rename it to DCLTABLES.OLD, do an INSTALL REPLACE SYS$LIBRARY:DCLTABLES, then reinstall MACRO--64 Assembler.
• The system logical name SYS$SYSROOT should not be modified from the preset definition provided by the OpenVMS Alpha operating system.

If you encounter a problem while using MACRO--64 Assembler, report it to Digital.

If an error occurs while MACRO--64 Assembler is in use and you believe the error is caused by a problem with MACRO--64 Assembler, take one of the following actions:

• If you have a Software Product Services Support Agreement, consider contacting your Customer Support Center (CSC) by telephone (in the United States, 1-800-354-9000) or by using the electronic means provided with your support agreement. You can use DSNlink or other electronic means to report the problem to the CSC.
• Customers without a service contract can arrange for per-call CSC support.

When you initially contact the CSC, please indicate the following:

• The name and version number of the operating system (OpenVMS Alpha) you are using
• The name (MACRO--64 Assembler) and version number of MACRO--64 Assembler you are using
• The hardware system you are using (such as a model number)
• How critical the problem is
• A very brief description of the problem (one sentence if possible)

When you submit information electronically or are speaking on the phone to the appropriate support specialist, you can provide more detailed information. This includes the specific commands used to compile and link the program, the error messages displayed, and relevant detailed information (possibly including source program listings). Please try to narrow the cause of the problem to a specific source module or lines of code.

CSC personnel may ask for additional information, such as listings of any command files, INCLUDE files, relevant data files, and so forth. If the program is longer than 50 lines, submit a copy of it electronically or provide machine-readable media (floppy diskette or magnetic tape).

Experience shows that problem reports sometimes do not contain enough information to duplicate or identify the problem. Concise, complete information helps Digital give accurate and timely service to software problems.

To obtain information about purchasing Digital support services, please contact your local Digital sales representative.

This appendix provides listings of the following procedures:

• A MACRO--64 Assembler installation from CD-ROM ( Section A.1)
• A procedure for removing MACRO--64 Assembler after installation ( Section A.2)

This installation guide is not revised for each release of MACRO--64 Assembler. When installing later versions of MACRO--64 Assembler, the displayed numbers for the subsets, version, and subset directory will differ.

A.1 Sample MACRO--64 Assembler Installation

This appendix shows a new installation (all lines are displayed). The actual menu display shown on your system might not include certain lines if you have a recent version of MACRO--64 Assembler installed.

The install command assumes that the .pcsi file:
DEC-AXPVMS-MACRO64-V0102--1.PCSI is in sys$login.

# $ product install/producer=dec/base_system=axpvms/version=1.2/source=sys$login macro64 [Return]

The following product has been selected: DEC AXPVMS MACRO64 V1.2 Layered Product Configuration phase starting ... You will be asked to choose options, if any, for each selected product and for any products that may be installed to satisfy software dependency requirements. DEC AXPVMS MACRO64 V1.2: MACRO-64 Assembler for OpenVMS Alpha COPYRIGHT (c) 1998 -- All rights reserved Digital Equipment Corporation Do you want the defaults for all options? [YES] Do you want to review the options? [NO] Execution phase starting ... The following product will be installed: DEC AXPVMS MACRO64 V1.2 Layered Product Portion done: 0%...50%...60%...70%...80%...90%...100% The following product has been installed: DEC AXPVMS MACRO64 V1.2 Layered Product %PCSI-I-IVPEXECUTE, test procedure executing ... %PCSI-I-IVPSUCCESS, test procedure completed successfully

A.2 Sample MACRO--64 Assembler Installation Removal Procedure

This sample shows MACRO--64 Assembler being removed.

# product remove macro64 [Return]

The following product has been selected: DEC AXPVMS MACRO64 V1.2 Layered Product Do you want to continue? [YES] The following product will be removed: DEC AXPVMS MACRO64 V1.2 Layered Product Portion done: 0%...30%...40%...50%...60%...70%...80%...90%...100% The following product has been removed: DEC AXPVMS MACRO64 V1.2 Layered Product

Previous

Contents

Contents