MACRO--64 Assembler

MACRO--64 Assembler

Installation Guide for
OpenVMS Alpha Systems

Order Number: AA--PT9LC--TE


October 1998

This guide describes how to install MACRO--64 Assembler on an Alpha processor system running the OpenVMS operating system. It also describes how to read the online release notes.

Revision/Update Information: This manual supersedes all previous MACRO--64 Assembler installation guides for OpenVMS Alpha systems.

Operating System: OpenVMS Alpha Version 6.1 (or higher; see Section 1.1)

Software Version: MACRO--64 Assembler Version 1.2 (or higher)

Digital Equipment Corporation
Maynard, Massachusetts


First Printing, November 1992 Revised, November 1993 Revised, October 1998

The information in this document is subject to change without notice and should not be construed as a commitment by Digital Equipment Corporation. Digital Equipment Corporation assumes no responsibility for any errors that may appear in this document.

The software described in this document is furnished under a license and may be used or copied only in accordance with the terms of such license.

Copyright ©1998

The following are trademarks of Digital Equipment Corporation: DEC, DEC, DECwindows, Digital, OpenVMS, POLYCENTER, VAX, VMS, and the DIGITAL logo.

The following is a third-party trademark:

PostScript is a registered trademark of Adobe Systems, Inc.

ZK6340

This document is available on CD-ROM.

This document was prepared using VAX DOCUMENT, Version V3.2-1m.

Contents


Preface

This guide explains how to install MACRO--64 Assembler on an Alpha processor system running the OpenVMS operating system. It also describes how to read the online release notes.

Keep this guide with your distribution kit. You will need it to install maintenance updates or to reinstall MACRO--64 Assembler for any other reason.

This manual applies to Version 1.2 of MACRO--64 Assembler and all subsequent releases until a revised installation guide is issued.

Intended Audience

This guide is intended for system managers who install MACRO--64 Assembler.

Structure of This Document

This guide contains the following chapters:

Associated Documentation

In addition to this guide, the MACRO--64 Assembler documentation set includes the following:

For the location of the MACRO--64 Assembler "read first" cover letter and the release notes, see Section 1.1.

Once installed, you can use MACRO--64 Assembler online HELP, which describes the command qualifiers, explains run-time messages, and provides a quick-reference summary of language topics. To use online HELP, type HELP followed by the command name as in the following examples:


$ HELP MACRO/ALPHA

The following manuals in the OpenVMS Alpha documentation set contain information relevant to installing software:

For help understanding OpenVMS system error messages, see the OpenVMS System Messages and Recovery Procedures Reference Manual or the online HELP/MESSAGE facility.

Sending Digital Your Comments on This Manual

We welcome your comments on this or any other DIGITAL manual. You can send comments in the following ways:

If you have suggestions for improving a particular section or find any errors, please indicate the title, order number, and section (if available). We also welcome general comments.

Getting Help from Digital

If you have a customer support contract and have comments or questions about MACRO--64 Assembler, you can contact the Customer Support Center (CSC), preferably using electronic means such as DSNlink. In the United States, customers can call the CSC at 1-800-354-9000 (see Section 3.8).

Conventions

Table 1 lists the conventions used in this document.

Table 1 Conventions Used in This Document
Convention Meaning
UPPERCASE_TEXT Uppercase letters indicate the name of a command, a file, a parameter, a procedure, or a utility.
$ SHOW DEFAULT In interactive examples, prompts or displayed text appears in a monospaced font. User input appears in bold.
$ The dollar sign indicates the DCL prompt. This prompt may be different on your system.
Ctrl/x In interactive examples, a sequence such as Ctrl/x indicates that you must hold down the key labeled Ctrl while you press another key or a pointing device button; for example, Ctrl/C or Ctrl/Z.
[Return] In code examples, a key name is shown enclosed to indicate that you press a key on a keyboard.
[YES] Square brackets indicate that the enclosed item is a default value in an installation prompt. Also, square brackets serve as delimiters for a directory name in a file specification.
OpenVMS,
OpenVMS Alpha,
OpenVMS AXP
References to OpenVMS, OpenVMS AXP, or OpenVMS Alpha refer to the OpenVMS Alpha operating system.
MACRO--64 References to MACRO--64 refer to the DIGITAL MACRO--64 Assembler. For more information, see the Read Before Installing or Using MACRO--64 Assembler Version n.n for OpenVMS Alpha Systems.

In this manual, some version numbers are given as "Vn.n". When you install MACRO--64 Assembler, the actual version numbers appear on your screen.


Chapter 1
Preparing for MACRO--64 Assembler Installation

Before starting the installation procedure in Chapter 2, you should complete the preparations explained in this chapter. This chapter includes the following sections:

1.1 The Software Product Library CD-ROM and Installation-Related Documentation Files

The OpenVMS Alpha Software Product Library CD-ROM (media CD-ROM) set provides the following files:

To determine whether the appropriate media CD-ROM is already mounted on your system, contact the appropriate system manager.

MACRO--64 Assembler provides online release notes and an online "read first" cover letter:

For information about using the CDMENU utility and locating the appropriate media CD-ROM and directory that contains the MACRO--64 Assembler cover letter, see the first few steps in Chapter 2.

Once the appropriate media CD-ROM has been mounted and the appropriate MACRO--64 Assembler documentation directory located, do one of the following:

For information about reading the online release notes before installation, use the PRODUCT EXTRACT RELEASE_NOTES command described in Chapter 2 (step 7).

DIGITAL strongly recommends that you read the release notes and the cover letter before installing MACRO--64 Assembler. They contain information about changes to the installation and use of MACRO--64 Assembler, such as the minimum version of the OpenVMS Alpha operating system required for this release of MACRO--64 Assembler.

After installation, the release notes are installed in:


  SYS$HELP:MACRO64.RELEASE_NOTES 

1.2 Required Operating System Components

MACRO--64 Assembler Version 1.2 requires the OpenVMS Alpha operating system Version 6.1 or higher.

Future MACRO--64 Assembler releases may require higher versions of the operating system, as described in the online release notes or the Read Before Installing or Using MACRO--64 Assembler Version n.n for OpenVMS Alpha Systems (cover) letter.

The OpenVMS Alpha operating system comes with a variety of support options (or components). To use MACRO--64 Assembler, your system should be running a version of the OpenVMS Alpha operating system that includes the base component and the following other components:

For a complete list of the required components, see MACRO--64 Assembler Software Product Description (SPD) on the media CD-ROM.

1.3 License Registration

Before you install and run MACRO--64 Assembler Version 1.2 on a newly-licensed node (or cluster), you must first register a License Product Authorization Key (License PAK), using the License Management Facility (LMF). The specific LMF product name used by the MACRO--64 Assembler is: MACRO64.

The License PAK may be shipped along with the kit if you ordered the license and media together; otherwise, it is shipped separately to a location based on your license order. If you are installing MACRO--64 Assembler as an update on a node or cluster already licensed for this software, you have already completed the License PAK registration requirements.

If you are installing prerequisite or optional software along with MACRO--64 Assembler, review the PAK status and install the PAKs for any prerequisite or optional software before you install MACRO--64 Assembler.

You must register and load your license for MACRO--64 Assembler before you start the installation in order to run the Installation Verification Procedure (IVP) and use the software.

Log in to a privileged account, such as the system manager's account, SYSTEM. You have a choice of two ways to register a license:

If you plan to use MACRO--64 Assembler on more than one node in a cluster, you will need to perform a license load on the other nodes after you complete this installation. See Section 3.2.

For complete information on using LMF, see the OpenVMS License Management Utility Manual.

1.4 Installation Procedure Requirements

After you have registered and loaded the license PAK and have previously read the appropriate parts of this installation guide, the installation takes approximately 2 to 5 minutes, depending on your system configuration.

1.4.1 Installation Account Privileges and Disk Space

To install MACRO--64 Assembler, you must be logged in to an account that has at least the following privileges enabled:

Table 1-1 lists MACRO--64 Assembler's requirements for free disk storage space.

Table 1-1 Disk Space Requirements
Kit Component During Installation After Installation
Digital MACRO--64 Assembler 1000 blocks 1000 blocks

To determine the number of free disk blocks on the current system disk, enter the following DCL command:


$ SHOW DEVICE SYS$SYSDEVICE

1.4.2 System Parameters

Installing MACRO--64 Assembler (both compilers) requires certain system parameter settings.

The minimum number of free global pagelets (512-byte subpage unit) and global sections needed is two (2) global sections and approximately 20 contiguous free global pagelets, plus a sufficient number of contiguous free global pagelets to contain the file SYS$LIBRARY:DCLTABLES.EXE (see Section 1.4.2.1).

These values represent the number of free global pagelets and global sections required for the installation, not the total number you need to run your system and other software.

Note

If you do not ensure that your system has the necessary global pagelets and global section SYSGEN parameters for the installation, the DCL tables can become corrupted in some situations.

1.4.2.1 Calculating Values for GBLPAGES and GBLSECTIONS

To install and run MACRO--64 Assembler, you must have sufficient free global pagelets and global sections.

Enter the following DCL command to determine the number of global pagelets required by SYS$LIBRARY:DCLTABLES.EXE:


$ DIRECTORY/SIZE SYS$LIBRARY:DCLTABLES.EXE

This command returns the size (in blocks) of SYS$LIBRARY:DCLTABLES.EXE. As an approximation, use this figure as the number of global pagelets for the file.

You can use the WRITE command with the F$GETSYI lexical function to find the number of free contiguous global pagelets and free global sections. The following example shows how to get this information at your terminal (the default for SYS$OUTPUT):


$ WRITE SYS$OUTPUT F$GETSYI("CONTIG_GBLPAGES")
15848
$ WRITE SYS$OUTPUT F$GETSYI("FREE_GBLSECTS")
24

If the value of free global pagelets or global sections is less than the required value (see Section 1.4.2), you must increase the system parameter setting.

Section 1.4.2.2 describes the procedures for increasing these values using AUTOGEN.

1.4.2.2 Changing System Parameter Values with AUTOGEN

If you do not have enough free global pagelets or free global sections to install MACRO--64 Assembler, you can use the AUTOGEN command procedure to increase the GBLPAGES or GBLSECTIONS system parameters.

AUTOGEN automatically adjusts values for parameters that are associated with the values you reset manually. To change system parameters with AUTOGEN, edit the following file:


SYS$SYSTEM:MODPARAMS.DAT

To change a parameter value listed in this file, delete the current value associated with that parameter and enter the new value.

To add a new parameter, add a line to the file that specifies the name of the parameter and its value. To modify incremental parameters such as GBLPAGES and GBLSECTIONS, use the ADD_ prefix.

After you make all your changes, exit from the editor.

When you execute the AUTOGEN procedure to recalculate your system parameters, AUTOGEN uses the information in your MODPARAMS.DAT file and also can automatically adjust some of the SYSGEN parameters based on the consumption of resources since the last reboot.

For information about using AUTOGEN and its command-line parameters, see the OpenVMS System Manager's Manual: Tuning, Monitoring, and Complex Systems.

1.5 Backing Up Your System Disk

Digital recommends that you do a system disk backup before installing any software. Use the backup procedures that are established at your site. For details on performing a system disk backup, see the Using VMS BACKUP manual.

1.6 Recovering from Installation Errors

Errors can occur during the installation if any of the following conditions exist:

For descriptions of error messages generated by these and related conditions, see the OpenVMS Alpha documentation on system messages and software installation or the online HELP/MESSAGE command. Take the appropriate action described in the message.

For information on system requirements for installing MACRO--64 Assembler, see Section 1.2.

For a list of problems that can cause an unsuccessful installation, see Section 3.7.

To report a problem to Digital, see Section 3.8.


Next Contents