Compaq Multimedia Services for OpenVMS Alpha

Compaq Multimedia Services
for OpenVMS Alpha

Installation Guide

Order Number: AA-QN8KC-TE


April 2000

This guide describes how to install the Compaq Multimedia Services for OpenVMS Alpha run-time environment and the developer's kit on AlphaStation workstations running the OpenVMS Alpha operating system.

Revision/Update Information: This document supercedes the Multimedia Services OpenVMS Alpha Installation Guide, Version 2.0

Operating System: OpenVMS Alpha Version 7.1--2 or 7.2--1 and higher

Software Version: MMS Version 2.2 for OpenVMS Alpha




Compaq Computer Corporation Houston, Texas


© 2000 Compaq Computer Corporation

COMPAQ, AlphaStation, VAX, VMS, the Compaq logo, and the DIGITAL logo Registered in U.S. Patent and Trademark Office.

OpenVMS is a trademark of Compaq Information Technologies Group, L.P.

Microsoft and Windows are trademarks of Microsoft Corporation.
Motif is a trademark of the Open Group.

All other product names mentioned herein may be the trademarks or registered trademarks of their respective companies.

Confidential computer software. Valid license from Compaq or authorized sublicensor required for possession, use, or copying. Consistent with FAR 12.211 and 12.212, Commercial Computer Software, Computer Software Documentation, and Technical Data for Commercial Items are licensed to the U.S. Government under vendor's standard commercial license.

Compaq shall not be liable for technical or editorial errors or omissions contained herein.

The information in this publication is subject to change without notice and is provided "AS IS" WITHOUT WARRANTY OF ANY KIND. THE ENTIRE RISK ARISING OUT OF THE USE OF THIS INFORMATION REMAINS WITH RECIPIENT. IN NO EVENT SHALL COMPAQ BE LIABLE FOR ANY DIRECT, CONSEQUENTIAL, INCIDENTAL, SPECIAL, PUNITIVE, OR OTHER DAMAGES WHATSOEVER (INCLUDING WITHOUT LIMITATION, DAMAGES FOR LOSS OF BUSINESS PROFITS, BUSINESS INTERRUPTION, OR LOSS OF BUSINESS INFORMATION), EVEN IF COMPAQ HAS BEEN ADVISED OF THE POSSIBILITY OF SUCH DAMAGES. THE FOREGOING SHALL APPLY REGARDLESS OF THE NEGLIGENCE OR OTHER FAULT OF EITHER PARTY AND REGARDLESS OF WHETHER SUCH LIABILITY SOUNDS IN CONTRACT, NEGLIGENCE, TORT, OR ANY OTHER THEORY OF LEGAL LIABILITY, AND NOTWITHSTANDING ANY FAILURE OF ESSENTIAL PURPOSE OF ANY LIMITED REMEDY.

The limited warranties for Compaq products are exclusively set forth in the documentation accompanying such products. Nothing herein should be construed as constituting a further or additional warranty.

6625

This document was prepared using VAX DOCUMENT, Version V3.3-1b.

Contents Index


Preface

This guide contains instructions for installing the Compaq Multimedia Services for OpenVMS Alpha run-time environment and Compaq Multimedia Services for OpenVMS Alpha development kit on AlphaStations running the OpenVMS operating system.

The installation procedure installs all files in subdirectories under the following directories:

SYS$COMMON:[SYS$LDR]
SYS$COMMON:[SYSEXE]
SYS$COMMON:[SYSLIB]
SYS$COMMON:[SYSHLP.EXAMPLES.MMOV]
SYS$COMMON:[MMOV_INCLUDES]

Keep this guide with your distribution kit. You will need it to install maintenance updates or to reinstall Compaq Multimedia Services for OpenVMS Alpha, if necessary.

Intended Audience

This guide is for OpenVMS system managers and others who install layered products on OpenVMS systems. In addition, system managers must have experience with the following OpenVMS utilities:

The release notes are intended for all users of Compaq Multimedia Services for OpenVMS Alpha. The release notes are located in:

SYS$HELP:MMOV-V2_2.RELEASE_NOTES

Document Structure

This document contains the following:

Chapter 1 describes the hardware and software requirements for Compaq Multimedia Services for OpenVMS Alpha installation and related procedures that you must complete before installing Compaq Multimedia Services for OpenVMS Alpha.

Chapter 2 describes how to install Compaq Multimedia Services for OpenVMS Alpha.

Chapter 3 describes the Installation Verification Procedure (IVP), how to remove Compaq Multimedia Services for OpenVMS Alpha from your system, and the files that you need to run Compaq Multimedia Services for OpenVMS Alpha applications.

Appendix A contains sample scripts for interactive Compaq Multimedia Services for OpenVMS Alpha installation and Installation Verification Procedure.

Appendix B lists the files installed for Compaq Multimedia Services for OpenVMS Alpha on your system.

Related Documents

For more information on:

For additional information about OpenVMS products and services, access the following OpenVMS World Wide Web address:


http://www.compaq.com 

Support

If errors occur during product installation, the system displays failure messages. For descriptions of error messages, see the OpenVMS Alpha documentation on system messages, recovery procedures, and software installation.

If an error occurs while Compaq Multimedia Services for OpenVMS Alpha is in use and you believe the error is caused by a problem with the product, contact your Compaq support representative.

Reader's Comments

Compaq welcomes your comments on this manual. Please send comments to either of the following addresses:
Internet openvmsdoc@compaq.com
Mail Compaq Computer Corporation
OSSG Documentation Group, ZKO3-4/U08
110 Spit Brook Rd.
Nashua, NH 03062-2698

How To Order Additional Documentation

Use the following World Wide Web address to order additional documentation:


http://www.compaq.com 

If you need help deciding which documentation best meets your needs, call 800.282.6672.

Conventions

This document uses the following conventions:
Convention Description
boldface text Boldface text indicates data structures, data types, and field names, and user input in interactive examples. New terms also appear in boldface text the first time they are introduced.
italic text Italic text indicates function arguments and emphasizes important information.
monospace type Monospace type is used in code segments and programming examples, and to indicate function names and chunk names.
literalString Literal strings that appear in text, examples, and syntax descriptions must be entered exactly as shown.

Multimedia Services for OpenVMS Alpha Documentation

In addition to this guide, the Compaq Multimedia Services for OpenVMS Alpha documentation set includes the following:


Chapter 1
Preparing for Multimedia Services for OpenVMS Installation

1.1 Registering Your Software License

If you are installing Multimedia Services Version 2.2 for OpenVMS Alpha 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 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 on your license order.

If you are installing Multimedia Services Version 2.2 for OpenVMS Alpha as an update on a node or cluster already licensed for this software, you must register the Service Update PAK (SUP) that is included in your Service Update Kit. If you already registered a License PAK or a SUP for this product on this node or cluster, you do not need to register the SUP.

If you are installing an update of Multimedia Services Version 2.2 for OpenVMS Alpha but lack a service contract, call your Compaq representative for instructions on how to get a License PAK.

If you are installing prerequisite or optional software along with Multimedia Services Version 2.2 for OpenVMS Alpha, review the PAK status and install the PAKs for any prerequisite or optional software before you install Multimedia Services Version 2.2 for OpenVMS Alpha.

You must register and load your license for Multimedia Services Version 2.2 for OpenVMS Alpha before you start the installation in order to run the Installation Verification Procedure (IVP) and use the software.

To register a license under the OpenVMS operating system, first log in to the system manager's account, SYSTEM. You then can choose one of two ways to perform the registration:

If you plan to use Multimedia Services Version 2.2 for OpenVMS Alpha on more than one node in a VMScluster system, you need to perform a license load on the other nodes after you complete this installation.

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

1.2 Required Operating System Components and Software

The OpenVMS operating system comes with a variety of support options, or classes. Classes include such features as networking and RMS journaling. Multimedia Services Version 2.2 for OpenVMS Alpha requires OpenVMS Alpha Version 7.1--2 or 7.2--1 and higher.

If you are installing any device options or the multimedia development kit, you need both the OpenVMS required save set and the programming support save set.

For a complete list of the required classes, see the Software Product Description (SPD). The SPD contains a complete list of prerequisite and optional software and their required version numbers.

1.3 Special Checks and Requirements for Installing Multimedia Services Version 2.2 for OpenVMS Alpha

The product "DEC AXPVMS VMS Vxx" must be registered in the POLYCENTER software installation database. To determine if the product is registered, enter the following command line:


$product show product

If the product is not registered, use the following command:


$product register product VMS/source=SYS$COMMON:[000000]

1.4 Installation Requirements

This section describes the requirements for installing Multimedia Services Version 2.2 for OpenVMS Alpha (process account quotas, system parameters, disk space, and so on).

Standard procedures for checking and setting various parameters are described in Section 1.5.

1.4.1 Privileges

To install Multimedia Services Version 2.2 for OpenVMS Alpha, you must be logged in to an account that has SETPRV or at least the following privileges:

1.4.2 Process Account Quotas

The account you use to install Multimedia Services Version 2.2 for OpenVMS Alpha must have sufficient quotas to enable you to perform the installation. Table 1-1 summarizes the requirements.

Table 1-1 Process Account Quotas for the Installing Account
Account Quota Value
ASTLM 250
BIOLM 150
BYTLM 64,000
DIOLM 150
ENQLM 2000
FILLM 100
PGFLQUO 50,000
PRCLM 10
JTTQUOTA 4096
WSEXTENT 16,400
WSDEF 2000 1
WSQUO 4000


1The values for WSEXTENT and WSQUO must be equal to or greater than the WSDEF value.

1.4.3 System Parameters

Table 1-2 lists the minimum required system parameter values for the installation. Depending on the kinds of programs and applications running at your site, you might need higher values for some settings.

Table 1-2 Minimum Required System Parameter Values
System Parameter Minimum Value
GBLPAGES 1 20,000
GBLPAGFIL 4096
GBL sections 1 600
MAXBUF 2 8200
PQL_DASTLM 2 24
PQL_DBIOLM 2 32
PQL_DDIOLM 2 32
VIRTUALPAGECNT 500,000
WSMAX 65,600


1These 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.
2These dynamic system parameters must be set permanently to values equal to or greater than the values listed. Do not lower these values after the installation.

1.4.4 Disk Space

Table 1-3 summarizes the storage requirements for all options for Multimedia Services Version 2.2 for OpenVMS Alpha.

Table 1-3 Disk Space Requirements
Options Blocks Required
Multimedia Services Version 2.2 for OpenVMS Alpha Run-Time 18,038
Multimedia Services Version 2.2 for OpenVMS Alpha Development Kit 5,611
Multimedia Services Version 2.2 for OpenVMS Alpha Sample Clips 28,777

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


$ SHOW DEVICE SYS$SYSDEVICE

1.4.5 Backing Up Your System Disk

Compaq recommends that you do a system disk backup before installing any software.

Use the backup procedures that are established at your site. For details on performing a system disk backup, see the section on the Backup Utility in the OpenVMS System Management Subkit.

1.5 Standard System Maintenance Procedures

This section explains how to do various standard procedures:

1.5.1 Checking and Setting Process Account Quotas

User account quotas are stored in the file SYSUAF.DAT. Use the OpenVMS Authorize Utility (AUTHORIZE) to verify and change user account quotas. First set your directory to SYS$SYSTEM and then run AUTHORIZE:


$ SET DEFAULT SYS$SYSTEM
$ RUN AUTHORIZE
UAF>

At the UAF> prompt, enter the SHOW command with an account name to check a particular account. For example:


UAF> SHOW SMITH

To change a quota, enter the MODIFY command. The following example changes the FILLM quota for the SMITH account and then exits from the utility:


UAF> MODIFY SMITH /FILLM=50
UAF> EXIT

After you exit from the utility, the system displays messages indicating whether or not changes were made. Once the changes have been made, you must log out and log in again for the new quotas to take effect.

For more information on modifying account quotas, see the description of the Authorize utility in the OpenVMS System Management Subkit.

1.5.2 Checking System Parameter Values

To check the values of your system parameters, enter the following command at the DCL prompt to invoke the System Generation utility (SYSGEN):


$ RUN SYS$SYSTEM:SYSGEN
SYSGEN>

At the SYSGEN> prompt, enter the SHOW command to display the value of a system parameter. The following example displays the value for the WSMAX system parameter:


SYSGEN> SHOW WSMAX

After checking the parameters with the SHOW command, enter the EXIT command at the SYSGEN> prompt to return to DCL level.

1.5.3 Calculating the Values for Global Pagelets and Global Sections

To install and run Multimedia Services Version 2.2 for OpenVMS Alpha, you must have sufficient free global pagelets and global sections. You must first find out how many free global pagelets and sections you have on your system. Then, use AUTOGEN if you need to increase the global pagelets and global sections system parameters.

You can use the WRITE command with the F$GETSYI lexical function to find the number of free global pagelets and 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 values displayed by the system are greater than the values in Table 1-2, you do not need to increase the values for these parameters. If the values of free global pagelets or global sections are less than the values in Table 1-2, you must increase the system parameter setting.

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

1.5.4 Changing System Parameter Values with AUTOGEN

Use the AUTOGEN command procedure to change 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 SYS$SYSTEM:MODPARAMS.DAT file.

To change a parameter value listed in the SYS$SYSTEM:MODPARAMS.DAT file, delete the current value associated with that parameter and enter the new value.

To add a new parameter to the SYS$SYSTEM:MODPARAMS.DAT file, add a line that includes both the name of the parameter and its value. For example:


WSMAX = 8096

To modify incremental parameters such as free global pagelets and global sections, use ADD_. The following example increases the global page setting by 2000:


ADD_GBLPAGES = 2000

When you set the page file quota, do not use a value that exceeds the amount of page file space available on the system.

After you make all your changes, exit from the editor and execute the AUTOGEN procedure to recalculate your system parameters. The following command recalculates your system parameters and reboots the system:


$ @SYS$UPDATE:AUTOGEN GETDATA REBOOT

When you specify REBOOT, AUTOGEN performs an automatic system shutdown and then reboots the system. Any users logged in to the system are immediately disconnected during the shutdown. The automatic reboot puts the new parameter values into effect.

The AUTOGEN utility automatically adjusts some of the SYSGEN parameters based on the consumption of resources since the last reboot. If you do not want to take advantage of this automatic adjustment, include the NOFEEDBACK qualifier on the AUTOGEN command line.

For more information about using AUTOGEN, see the OpenVMS System Management Subkit.


Next Contents Index