Configuring VAX DSM

From Datashed Retrocomputing Wiki
Jump to navigation Jump to search

This procedure assumes DSM is installed, and you are configuring it in an account that has not yet been used with DSM. The user account will need SYSPRV and TMPMBX process privileges.

Initializing User Account for DSM

  1. Type SET PROC/PRIV=(SYSPRV,TMPMBX)
  2. Create a DSM subdirectory in your home directory (i.e., if your account name is MYACCT and your home directory is DSA1:[MYACCT], type CRE/DIR DSA1:[MYACCT.DSM]
  3. Run @SYS$MANAGER:DSM$INIT
    1. Enter your username at the Enter the account name to use with DSM > prompt
    2. Press ENTER at the Do you want to continue [Y OR N] ? <Y> prompt
    3. Press ENTER at the Are there any additional Cluster members not currently booted that you would like to add to this list [Y OR N] ? <N> prompt
    4. Press ENTER at the Create similar directories on other disk devices [Y OR N] ? <N> prompt
    5. Press ENTER at the Press RETURN to continue listing ... prompts until you reach the Do you want to edit this command procedure [Y OR N] ? <N> prompt
    6. Press ENTER at the Do you want to edit this command procedure [Y OR N] ? <N> prompt
    7. Press Y and ENTER at the Do you want to run this command procedure now [Y OR N] ? > prompt
    8. Press ENTER at the Account initialized - press return to continue prompt

Creating a DSM Volume Set

  1. Type @SYS$MANAGER:DSM$CONFIGURE
  2. Press ENTER at the Do you want to create a new DSM database volume Set [Y OR N] ? <Y> prompt
  3. Enter a 3-character identifier at the Enter the 3-character name for the volume set > prompt (best to choose an identifier that makes sense for the application(s) to be hosted in this DSM configuration)
  4. Press ENTER at the Create a DSM Volume in which file ? prompt
  5. Enter a block count at the Enter desired size of this volume in 1 KB DSM blocks > prompt (I typically start with 120000 blocks)
  6. Press ENTER at the Initialize as a SYSTEM or APPLICATION volume set [S or A] <s> prompt to create an SYSTEM volume set (APPLICATION volume sets are outside the scope of this article)
  7. Enter the maximum number of globals you'll use in the volume set at the Enter the maximum number of globals allowable on this volume set <90>
  8. Enter Y at the Allow expanded string lengths on this volume set [Y OR N] ? <N> prompt
  9. Choose a volume label at the What would you like the new label of this volume to be ? (up to 20 characters) > prompt (again, it is best practice to choose a volume label that makes sense for the application(s))
  10. DSM will initialize the volume set at this point, which may take a few minutes, depending on the I/O performance of your VAX

Defining a DSM Configuration

This will happen automatically as soon as the volume set is configured.

  1. You can choose either Y or N at the Would you like extended help [Y OR N] ? <N> prompt
  2. Press ENTER at the Enter the configuration identifier <1> prompt
  3. Press ENTER at the 1 is not currently defined, define it now [Y OR N] ? <Y> prompt
  4. For disk buffers, I typically choose a small number to reduce memory footprint (say, 300), but you can go higher if memory capacity permits for increased performance
  5. I typically do NOT use nonpaged memory for these buffers, but again, for a performance-sensitive environment, I would recommend using nonpaged memory to avoid thrashing the swap volume
  6. Enter the desired number of maximum users at the Enter the maximum number of DSM users <128> prompt (for a development system, I typically go with 10, but some applications may require more users to run at all)
  7. I typically answer N at the Enable configuration access control [Y OR N] ? > prompt for a dev system, but it is strongly recommended that you enable it for production usage, which is outside the scope of this article
  8. I typically choose N at the Include support for Routine/Global Performance Histograms [Y OR N] ? <N>
  9. Press ENTER at the Number of database sets in this configuration <1> prompt
  10. Press ENTER at the Name of database set #1 ... prompt (this prompt will also show the 3-character identifier chosen in step 3 of Creating a DSM Volume Set)
  11. Press ENTER at the NNN not defined. Define it now [Y OR N] ? <Y> prompt (where NNN represents the 3-character identifier of the volume set)
  12. Press ENTER at the Is this a VMS DSM, Transaction or DSM-11 database set [V, T or D] <V> prompt
  13. Press ENTER at the Mount NNN for READ-ONLY access [Y OR N] ? <N> prompt
  14. Press Y and ENTER at the Mount NNN for clusterwide access [Y OR N] ? <N> prompt
  15. Press ENTER at the Name of the volume set <NNN> prompt
  16. Press ENTER at the Enter the number of volumes in volume set NNN <1> prompt
  17. Press ENTER at the File name of NNN volume 1 prompt
  18. Press ENTER at the BIJ Journal file name prompt
  19. Press Y and ENTER at the Are you sure you want to include this file [Y OR N] ? prompt (we will create the before-image journal in a future step)
  20. Press Y and ENTER at the Enable After-Image Journaling for this database set [Y OR N] ? <N> prompt
  21. Press ENTER at the Number of AIJ journal files <1> prompt
  22. Press ENTER at the File name of AIJ file #1 prompt
  23. Press Y and ENTER at the Are you sure you want to include this file [Y OR N] ? <N> prompt (we will create the after-image journal in a future step)
  24. Press ENTER at the Message text when closing this AIJ file > prompt
  25. Press Y and ENTER at the Print console message when database set is nearly full [Y OR N] ? <N> prompt
  26. Press ENTER at the Send message at what percentage full <90> prompt
  27. Press ENTER at the Is this configuration a database set master for SMX [Y OR N] ? <Y> prompt
  28. Press ENTER at the Modify default After-Image Journaling characteristics [Y OR N] ? <N> prompt
  29. Enter a 3-character name at the Enter a unique 3 character DDP node name > prompt (I use the same name as the volume set identifier, typically)
  30. Press ENTER at the Start DDP servers during configuration startup [Y OR N] ? <Y> prompt
  31. Press ENTER at the Enter the number of DDP servers to start ? <3>
  32. Press ENTER at the Send DDP status messages to the operator's console [Y OR N] ? <Y> prompt
  33. Press ENTER at the Enter DDP GROUPS to enable <0>, Enter the REQUEST RETRY MAXIMUM <4>, Enter the REQUEST RETRY INTERVAL <3>, Enter the REQUEST CREDIT MAXIMUM <20>, and Press <RETURN> to continue: prompts
  34. Press ENTER at the Enter the TRANSMIT BUFFER DELAY increment <0>, Enter the DDP MULTICAST ADVERTISING INTERVAL <6>, and Include CIRCUIT CONNECTION SECURITY [Y OR N] ? <N> prompts
  35. Enter 0 at the Enter the number of DDP links in this configuration > prompt (configuring non-dummy DDP links is outside the scope of this article)
  36. Press ENTER at the Modify GLOBAL characteristics [Y OR N] ? <N> prompt
  37. Press ENTER at the Include support for mapped routines [Y OR N] ? <N> prompt
  38. Press ENTER at the Modify DSM default command line qualifiers [Y OR N] ? <N> prompt
  39. Press ENTER at the Modify Global Translation Tables [Y OR N] ? <N> prompt
  40. Press ENTER at the Modify $H date for this configuration [Y OR N] ? <N> prompt
  41. Press ENTER at the Show configuration memory requirements [Y OR N] ? <N> prompt
  42. Enter N at the Startup configuration 1 [Y OR N] ? > prompt (we still need to create before-image and after-image journals before starting up the configuration)

Defining After-Image Journals

  1. At the DCL prompt, type DSM/MANAGER
  2. Type D ^JRNINIT
  3. At the Initialize DSM After-Image Journal file for which volume set > prompt, enter the 3-character volume set identifier you chose in step 3 of Creating a DSM Volume Set
  4. Press ENTER at the File name of DSM Volume 1 prompt
  5. Press ENTER at the Enter the journal file name prompt
  6. Enter 2000 or more at the Enter the maximum size of this file in 512 byte blocks > prompt
  7. Press Y and ENTER at the Are you sure you want to continue [Y OR N] ? <N> prompt

DSM will now initialize the after-image journal file, which may take a few moments.

Defining Before-Image Journals

  1. Type D ^BIJINIT at the DSM prompt
  2. At the Initialize DSM Before-Image Journal file for which volume set > prompt, enter the 3-character volume set identifier you chose in step 3 of Creating a DSM Volume Set
  3. Press ENTER at the File name of DSM Volume 1 for NNN prompt
  4. Press ENTER at the Name of BEFORE-IMAGE journal file for NNN prompt
  5. Press ENTER at the Enter the SIZE (in DSM 1024-byte blocks) of the file <8000> prompt

DSM will now initialize the before-image journal file, which may take a few moments.

Starting the Configuration

  1. At the DSM prompt, type D ^STU
  2. Press ENTER at the Enter the configuration identifier <1> prompt
  3. Press ENTER at the Enable user logins on startup [Y OR N] ? <Y> prompt
Retrieved from "https://datashed.tech/wiki/index.php?title=Configuring_VAX_DSM&oldid=902"