CONTENTS Title Page Copyright Page Preface Acknowledgment 1 Installing VAX DSM Required Operating System Components VAX DSM Distribution Kit Space and Time Requirements for Installing VAX DSM Installation Overview VAX DSM Installation Backing Up Your System Registering Your VAX DSM License Determining SYSGEN Requirements for Installation Installing VAX DSM Using VMSINSTAL VAX DSM Shareable Images Installing VAX DSM as Shared Images Installing VAX DSM in a VAXcluster Environment Postinstallation Activities Creating the VAX DSM Environment Manager's Account Running DSM$INIT.COM Configuring VAX DSM Editing the VMS System Files System Startup System Shutdown 2 Managing VAX DSM VAX DSM Environment Environment Directories, Files, and Protection VAX DSM Baseline Mode VAX DSM Configurations VAX DSM Accounts Overview of VAX DSM Databases Configuration Management ( ^CONMAN ) Defining Configurations ( ^CONFIG ) Starting Up and Shutting Down Configurations Starting a Configuration Shutting Down a Configuration Modifying Characteristics of a Configuration Running Multiple VAX DSM Configurations Initializing VAX DSM in a VAXcluster Environment Directory Structure in a VAXcluster Environment Defining VAXcluster Configurations VAX DSM Detached Processes Write Demon Garbage Collector Journal Process Recovery Process DDP Servers DDP DECnet Link Servers 3 Controlling Access to VAX DSM Controlling User Access VMS Access Control Environment Access Control Protecting Environment Files Maintaining Environment Security Configuration Access Control VAX DSM Access Modes Manager Mode Access Programmer Mode Access Application Mode Access Global Access Control Establishing VMS Accounts for Programmers and Application Users Configuration Access Control Utilities Granting Access Interactively ( ^ACL ) Granting Access Noninteractively ( ^ACLCALL ) Creating Dedicated Application Accounts Setting Up a Captive Account Creating a Captive Command Procedure Setting Up VAX DSM Tied Routine and Port Tables Controlling Access to the Callable Routines Interface Using the Login Control Utility ( ^LOGIN ) 4 Tuning VMS for Use with VAX DSM Overview Process Quotas for VAX DSM Users SYSGEN Parameters for VAX DSM Configurations Using the ^MEMORY Utility Modifying VMS System Parameters Page and Swap File Size Configuring VAX DSM Shared Memory Configuring Nonpaged Memory 5 Optimizing VAX DSM Optimizing VAX DSM Applications Using Mapped Routines Mapped Routine Utilities ( ^RMAP ) Determining Memory Requirements of Mapped Routine Sections Creating and Mapping Routine Sets Executing Mapped Routines Disabling Individual Mapped Routines Considerations when Using Mapped Routines Global Statistics ( ^GLSSTA ) Performance Statistics ( ^RTH ) Using the Performance Statistics Utility Database Event Counts and Derivative Ratios Histogram Individual Routine CPU Time as a Percentage of Total Routine CPU Time Histogram Individual Routine Loads as Percentage of Total Histogram Global References Per Second Histogram Distributed Data Processing Activity Histogram Optimizing VAX DSM Based on Performance Statistics 6 VAX DSM System Utilities Overview of VAX DSM Utilities Online Help Utility Conventions Running the VAX DSM System Utilities Configuration Management Utilities ( ^CONMAN ) Displaying Configurations ( DISPLAY^CONFIG ) Copying Configurations ( COPY^CONFIG ) Modifying Configurations ( MODIFY^CONFIG ) Deleting Configurations ( DELETE^CONFIG ) Database Set Management Utilities ( ^DBSMAN ) After-Image Journaling Utilities ( ^JOURNAL ) Before-Image Journaling Utilities Database Set Utilities Volume Set Utilities ( ^VOLUTL ) Disk Block Tally ( ^DBT ) Distributed Data Processing Utilities ( ^DDP ) Mapped Routine Utilities ( ^RMAP ) Option File Management Utilities ( ^OPTMAN ) Performance Utilities System Management Utilities ( ^SYSMAN ) Force Exit ( ^FORCEX ) Lock Table Display ( ^LOCKTAB ) Shutdown ( ^SHUTDWN ) A Installing VAX DSM Software in an Alternate Root Using VAX DSM from an Alternate System Root Installing VAX DSM in an Alternate Root Running the DSM$ALTROOT_INSTALL.COM Procedure Installing VAX DSM in an Alternate Root in a VAXcluster Environment Shutting Down VAX DSM Configurations that Use Alternate Root Software B Using the Configuration Option File Utility ( ^OPTMAN ) Using the Configuration Option File Configuration Option File Utilities ( ^OPTMAN ) Creating an Option File ( ^OPTBLD ) Converting the Option File ( ^OPTCON ) Starting Up a Configuration Configuration Option File Keywords EXAMPLES 1-1 VMSINSTAL Console Output 1-2 Running the DSM$INIT Command Procedure 2-1 Running the ^CONFIG Utility 5-1 ^GLSSTA Report B-1 Sample Configuration Option File FIGURES 1-1 VAX DSM Image Relationships 2-1 Directory Hierarchy in a Single-Node System 2-2 Directory Hierarchy in a VAXcluster Environment 3-1 Access Control Relationships 5-1 Database Event Counts and Derivative Ratios Histogram 5-2 Individual Routine CPU Time as a Percentage of Total Routine CPU Time Histogram 5-3 Individual Routine Loads as a Percentage of Total Routines Loads Histogram 5-4 Global References Per Second Histogram 5-5 Distributed Data Processing Activity Histogram A-1 System Root SYS0 Directory Structure A-2 Alternate Root Directory Structure TABLES 1-1 Space Requirements for Installing VAX DSM 3-1 VMS System Privileges Needed by VAX DSM Programmers 5-1 Routine Mapping Utilities B-1 Definition Keywords B-2 Data Keywords