home *** CD-ROM | disk | FTP | other *** search
/ The Hacker's Encyclopedia 1998 / hackers_encyclopedia.iso / hacking / systems / vaxa.txt < prev    next >
Encoding:
Text File  |  2003-06-11  |  63.9 KB  |  1,397 lines
  1.                                     VMS
  2.                             System Managers Manual
  3.                             ORDER NUMBER AA-LA00A-TE
  4.                        Typed in by: Guardian Of Time
  5.  
  6.  
  7. This Manual provides the basic concepts and procedures for VMS system
  8. management; it is especially inteded for managers of small clusters and
  9. systems.
  10.  
  11. Chapter 1
  12. Introduction
  13.  
  14. The VMS operating system and the other software products that run on your
  15. computer provide you and the other users on your system w/ a wide range of
  16. computing capabilities.  In order to create and maintain a proper and
  17. efficient computing environment, certain administrative tasks must be
  18. undertaken.  These tasks are called SYSTEM MANAGEMENT, and they include the
  19. following:
  20.  
  21. : Setting up the system
  22. : Giving individual users access to the system
  23. : Installing software (and software updates)
  24. : Managing acceptable performance levels
  25. : Preventing the loss of important information that you keep on line
  26. : Making sure that the system is secure
  27. : Handling media (such as disks/magnetic tapes)
  28. : setting up the software to allow for printers and for batch jobs
  29. : Setting up a cluster
  30. : Setting up a network
  31.  
  32. As system manager, you may need to do some of these tasks only once (for
  33. example, setting up software to allow for printers or batch jobs, or setting
  34. up a network); others are done on a continuing basis (for example, maintaining
  35. system security and preventing the loss of data).  At some sites, one or more
  36. people are designated as SYSTEM MANAGERS, and other individuals are designated
  37. as OPERATORS.  In these cases, operators are responsible for tasks such as
  38. physically mounting magnetic tapes and disks, monitoring printers, responding
  39. to emergencies or security alarms, and maintaining system log files.
  40.  
  41. Not all of the tasks described in this manual may be necessary for your site.
  42. This chapter provides an overview of the information that this manual
  43. contains.  You should read this introductory chapter to determine which parts
  44. of the manual may be applicable to your site.
  45.  
  46. <NOTE:  I overlooked section 1.1 because all it does is say that system      >
  47. <       Managers should use this chapter / Operators should use this Chapter >
  48. <       there was NO usefull information on that part...Guardian of Time     >
  49.  
  50. 1.2  SYSTEM MANAGEMENT CONCEPTS AND TERMS
  51.  
  52. Some concepts and terms are used frequently in system management, and you
  53. should become familiar w/ them.  The following terms and concepts are used
  54. both in the context of everday general use in a VMS system and in the context
  55. of system management; they are described in the VMS GENERAL USER'S MANUAL:
  56.  
  57. :  Accounts and directories
  58. :  Command Procedures
  59. :  Digital Command Language (DCL)
  60.  
  61. The following concepts and terms apply primarily to system management:
  62.  
  63. :  SYSTEM account and [SYSMGR] directory
  64.  
  65.    The SYSTEM account is reserved for use by the system manager.  When you
  66.    are logged into the SYSTEM ACCOUNT, your default directory (Which is also
  67.    reserved for the system manager) is SYS$SYSROOT:[SYSMGR].
  68.  
  69.    Always be carefule when you are logged into the SYSTEM account.  When you
  70.    are logged into the SYSTEM account, all privileges are enabled, by default.
  71.    You need these privileges to perform many system management tasks; however,
  72.    they can also produce unwanted or even destructive results if you use them
  73.    carelessly.
  74.  
  75. :  CONSOLE (OPERATOR'S) TERMINAL
  76.  
  77.    You can perform most system management tasks from any terminal that is
  78.    connected to the processor (or the cluster).  However, certain tasks such
  79.    as bootstrapping the system and communicating w/ the VAX processor's
  80.    console subsystem must be performed at a special terminal called the
  81.    CONSOLE TERMINAL.
  82.  
  83.    The console terminal, which always has the designation OPA0, is also
  84.    usually designated as the OPERATOR'S TERMINAL.  You use the operator's
  85.    terminal to send messages to system users and respond to user requests,
  86.    using the operator communication process (OPCOM).
  87.  
  88. CHAPTER 2 -- STARTING UP THE SYSTEM
  89.  
  90. The system startup procedure establishes the computing environment for your
  91. system
  92.  
  93. This chapter covers three major topics:
  94.  
  95. : How to start your system for the first time
  96. : How to create the proper computing environment whenever you restart your
  97.   system
  98. : How to shut down your system
  99.  
  100. Before you can use the procedures described in this chapter, you must girst
  101. set up the hardware for each VAX processor.  To set up the hardware and
  102. install the VMS operating system, refer to the instructions in your VAX
  103. processor installation and operations guide.  After you have installed the
  104. operating system, you will be able to log into the SYSTEM account on your
  105. computer.
  106.  
  107. After the operating system has been successfully loaded, you can set up the
  108. proper computing environment for your system.  The site-specific system
  109. startup file, SYSTARTUP_V5.COM, is an essential aspect of establishing an
  110. environment specific to the needs of your site.  Section 2.4 describes how to
  111. modify SYSTARTUP_V5.COM to meet the needs of your site.
  112.  
  113. 2.1 STARTING UP YOUR SYSTEM FOR THE FIRST TIME
  114.  
  115. Instufctions for installing the VMS operating system are included in the
  116. installation and operations guide for your processor.  You must choose whether
  117. you are installing the VMS operating systsm as a new installation or as an
  118. upgrade.  If you are installing the VMS operating system for the first time,
  119. you must use the new installation procedure.  If you already have a previous
  120. version of the VMS operating system on your processor, then you should use the
  121. upgrade prodcedure.  Instructions for a new unstallation are found in your
  122. processor installation and operations guide; instructions for an upgrade
  123. procedure are found in the Release Notes for the VMS operating system.
  124.  
  125. When you install the VMS operating system using the new installation
  126. procedure, the disk on which you install the operating system is first erased,
  127. and then a directory structuure and the operating system itself is put in
  128. place.  When you use the upgrade procedure, the files for the VMS operating
  129. system are replaced (w/ files for the upgraded operating system), and all
  130. other files on your system disk (for example, data files, executable images
  131. that are NOT part of the operating system, and so on) remain as they are.
  132.  
  133. CAUTION:  if you use the new installation procedure for a processor that
  134. already has a previous version of the VMS operating system, you will DESTROY
  135. the previous contents of the disk that you designate as they system disk.
  136.  
  137. 2.2 BOOTING THE SYSTEM
  138.  
  139. Booting is the process of loading the operating system from the system disk
  140. into processor memory.  You can perform either a nonstop boot or a
  141. conversational boot.  A nonstop boot is the quickest and easiest method, and
  142. the operating system will automatically set system parameters that are
  143. appropriate for most computing activities for your system's hardware
  144. configuration.  A conversational boot requires you to supply more information
  145. during the boot process, but it allows you to change system parameters during
  146. the boot procedure.  See your VAX processor installation and operations guide
  147. for detailed booting instructions.
  148.  
  149. After a system shuts down, it must be rebooted before you can use it.  Some
  150. processors provide the capability of an automatice reboot; when you enable
  151. this feature, the system automatically attempts to reboot itself after it has
  152. been shut down.  For example, if your site experiences a power failure, a
  153. processor that has automatic reboot enabled restarts itself automatically
  154. after the power has been restored.  See your VAX processor installation and
  155. operations guide for information about automatic rebooting.
  156.  
  157. In unusual cases, the normal startup procedures will NOT work properly and
  158. troubleshooting may be necessary.  Section 2.9 describes procedures that you
  159. should follow if the normal startup procedure fails, or if you find yourself
  160. locked out of your system.
  161.  
  162. 2.3 LOGGING INTO THE NEW SYSTEM
  163.  
  164. When the boot procedure is complete, a message is displayed on the terminal
  165. from which the system is booted (except on workstations, where the message is
  166. displayed on the operators window).  The message is similar to the following:
  167.  
  168. VAX/VMS VERSION 5.0 08-JUN-1989 07:00:00.00
  169.  
  170. %%%%%%%%%%% OPCOM, <08-JUN-1980 07:00:01.P> %%%%%%%%%%%
  171. Logfile has been initialized by operator _OPA0:
  172. Logfile is SYS$SYSROOT: [SYSMGR]OPERATOR.LOG;1
  173.  
  174. %SET-I-INTSET, login interactive limit = 64, Current interactive value = 0
  175.   SYSTEM       job terminated at <08-JUN-1980 07:00:00.00
  176.  
  177. After you see this display, you can then log into the system managers account,
  178. using the following procedure:
  179.  
  180. 1.  Press the RETURN/ENTER key on the console terminal.
  181. 2.  In response to the system's request for your USERNAME, type SYSTEM.
  182. 3.  In response to the system's request for your PASSWORD, type the password
  183.     that you chose for the sysstem account during installation.  You should
  184.     change your system password immediatly after logging into the system for
  185.     the first time.  To change your password, enter the DCL command SET
  186.     PASSWORD.
  187.  
  188. CAUTION: DIGITAL recommends that you change the system manager's account
  189. password frequently to maintain system security.  The system manager's account
  190. has full privileges by default; therefore, you should exercise caution when
  191. using it.
  192.  
  193. After you enter your password, the system prints a welcome message on the
  194. console terminal.  If it is not your first time loggin in, the system also
  195. prints the time of your last login, for example:
  196.  
  197.      Welcome to VAX/VMS Version n.n
  198.  
  199.      Last interactive login at 01-Jun-1989 15:13:21.07
  200.  
  201. The command procedure SYS$EXAMPLES:MGRMENU.COM generates the system manager
  202. menu.  This command procedure can serve as a sample for designin site-specific
  203. system manager menus.
  204.  
  205. 2.4  STARTUP COMMAND PROCEDURE FOR YOUR SITE (SYSTARTUP_V5.COM)
  206.  
  207. A command procedure that sets up a computing environment for the specific
  208. needs of your site is executed each time that your system starts up.  This
  209. file is located in the system manager's directory, [SYSMGR], and it is called
  210. SYSTARTUP_V5.COM.  In order to customize SYSTARTUP_V5.COM for the needs of
  211. your site, you must make the appropriate edits to the file.  This section
  212. describes how to customize the SYSTARTUP_V5 command procedure.
  213.  
  214. After you install the VMS operating system, the file SYSTARTUP_V5.COM is
  215. placed in the [SYSMGR] directory.  SYSTARTUP_V5.COM is a template file, which
  216. means that it can be used as a basis or guide for creating a startup file that
  217. suits your own system.  In particular, the SYSTARTUP_V5.COM template includes
  218. sections that can perform the following tasks at startup time:
  219.  
  220. :  Mounting public disks
  221. :  Setting the charactersistics of terminals and other devices
  222. :  Initializing and starting queues
  223. :  Installing known images
  224. :  Starting up the DECnet network
  225. :  Running the System Dump Analyzer
  226. :  Purging the operator's log file
  227. :  Submitting batch jobs that are run at system startup time
  228. :  Limiting the number of interactive users
  229. :  Starting up the LAT network
  230. :  Site-specific LAT command procedure
  231. :  Creating systemwide announcements
  232. :  Defining a system login command procedure
  233. :  Backing up the system
  234.  
  235. To modify SYSTARTUP_V5.COM, you can use any text editor.  This file is a
  236. command procedure, so any changes that you make must conform to the rules for
  237. command procedures, as described in the VMS GENERAL USER'S MANUAL.  In order
  238. tobe used as a site-specific startup file, be sure to keep the file in the
  239. [SYSMGR] directory and use the file name SYSTARTUP_V5.COM.
  240.  
  241. To allow SYSTARTUP_V5.COM to continue in the event of an error, include the
  242. DCL command SET NOON at the beginning of the file, as follows:
  243.  
  244.                   $ SET NOON
  245.  
  246. This command disables error checking after the execution of each command in
  247. the SYSTARTUP_V5.COM.
  248.  
  249. The following sections describe many of the elements of your userr environment
  250. that you can establish w/ SYSTARTUP_V5.COM.
  251.  
  252. 2.4.1  MOUNTING PUBLIC DISKS
  253.  
  254. A public disk is a disk that can be accessed by any system process.  In order
  255. to make a public disk available for use, the disk must be physically mounted
  256. and you must then use the MOUNT command.  You do not need to use the mount
  257. command for the system disk, because the system disk is alreadymounted when
  258. the system starts up.
  259.  
  260. This section describes how to mount disks in the SYSTARTUP_V5.COM file.  If
  261. your system uses any disks that should be mounted whenever the system is
  262. running, you should read this section.
  263.  
  264. To include MOUNT commands in SYSTARTUP_V5.COM to mount your public disks for
  265. systemwide access, use the following MOUNT command syntax:
  266.  
  267.                 $ MOUNT/SYSTEM ddcu:  volume_label logical_name
  268.  
  269. You use the /SYSTEM qualifier to mount the disk for systemwide access; this is
  270. caolled a public volume.  If you are in a VAXcluster environment, then you
  271. should also use the /CLUSTER qualifier in order to make the volume accessible
  272. to any user in the cluster.
  273.  
  274. The expression ddcu represents the physical device name.  You must always
  275. include a colon after the device name.  The expression volume_label is a label
  276. that you choose for the disk.  For example, if you mount a disk w/ the
  277. physical device name DRA1, and you choose USERFILES as the volume label for
  278. this disk, then you would include the following command in the
  279. SYSTARTUP_V5.COM file:
  280.  
  281.                             $ MOUNT DRA1:  USERFILES
  282.  
  283. The expression logical_name, in the context of the MOUNT command, is a logical
  284. volume name that is associated q/ the volume that you mount.  You can use the
  285. logical volume name (instead of the physical device name) in programs and
  286. procedures that are used on your system, and it is not necessary to know the
  287. physical drive on which the volume is mounted.
  288.  
  289. If you do not specify a logical volume name in the MOUNT command, then the
  290. logical volume name is in the form DISK$volume_label.  In the previous
  291. example, where no logical name was specified and the volume label was
  292. USERFILES, the MOUNT cammand would automatically assign the logical name
  293. DISK$USERFILES to the disk.
  294.  
  295. The following command produces the logical volume name USER and equates it to
  296. DRA1, the device name.  Note that the logical volume name USER is equivalent
  297. to DRA1 only while the disk is actually mounted; if the volume is dismounted,
  298. then the logical volume name no longer has any systemwide meaning.
  299.  
  300.                      $ MOUNT/SYSTEM  DRA1:  USERFILES USER
  301.  
  302. 2.4.2 SETTING DEVICE CHARACTERISTICS
  303.  
  304. On some systems, certain devices (such as terminals or printers) should have
  305. the same characteristics whenever the system is running.  Characteristics
  306. includ defining the device as a printer, setting the transmission speed for
  307. terminals, and so on.  You can define these characteristics in the
  308. SYSTARTUP_V5.COM procedure.  REad this section you want to define certain
  309. characteristics for specific devices on your system.
  310.  
  311. To establish the characteristics of the terminals and other devices on the
  312. system, use a series of SET commands in SYSTARTUP_V5.COM.  Use the SET
  313. TERMINAL command for terminals; you may want to include comments to remind
  314. yourself of the user to whom specific terminals may be assigned.
  315.  
  316. Use the SET PRINTER command for printers.  Printer characteristics must be
  317. seet before you establish queues for the printers.
  318.  
  319. The following example shows how you could modify SYSTARTUP_V5.COM to set up
  320. characterisitcs for terminals and a printer:
  321.  
  322. $ SET TERMINAL TTC2: /SPEED=300 /DEVICE_TYPE=LA36 /PERMANENT !JONES
  323. $ SET TERMINAL TTD1: /SPEED=9600 /PERMANENT                  !WRENS
  324. $ SET TERMINAL TTD4: /SPEED=1200 /PERMANENT                  !JRSMITH
  325. $ SET TERMINAL TTG4: /SPEED=1200 /MODEM /PERMANENT           !DIALUP1
  326. $ SET PRINTER /LA11 /PAGE=60 /WIDTH=80  LPA0:
  327.  
  328. For more information about the qualifiers available w/ the SET TERMINAL and
  329. SET PRINTER commands, see the VMS General Users Manual (NOTE: I'm going to
  330. start to type that manual up at the same time as this one starting 19-Jun-89).
  331.  
  332. 2.4.3 PRINTERS AND BATCH PROCESSING: INITALIZING AND STARTING QUEUES
  333.  
  334. If your system has a printer that you want to make available for general use
  335. (that is, a printer that is not connected directly to an individual terminal),
  336. youmust establish a print queue.  Similarly, if you want to allow batch
  337. processing on your system, you must establish a batch queue.  A quese allows
  338. users to submit requests for printing or batch processing, and the system
  339. prints or processes the user' jobs as resources allow.
  340.  
  341. If you want to include printing or batch processing capabliities on your
  342. system, you should include commands in SYSTARTUP_V5.COM that do the following:
  343.  
  344. 1:  Start the system job queue manager
  345. 2:  Initialize and start each queue w/ a separate INITALIZ/QUEUE/START command
  346.     line
  347.  
  348. The following example shows how to start the system job queue manager and
  349. initialize and start queues in SYSTARTUP_V5.COM:
  350.  
  351. $ !
  352. $ ! Start the system job queue manager
  353. $ !
  354. $ START/QUEUE/MANAGER
  355. $ !
  356. $ ! Set printers spooled and establish printer queues
  357. $ !
  358. $ SET PRINTER/LOWER LAO:
  359. $ SET DEVICE/SPOOLED=SYS$PRINT LPA0:
  360. $ INITIALIZE/QUEUE/START/DEFAULT=FLAG/NOENABLE_GENERIC LPA0:
  361. $ !
  362. $ SET PRINTER/LOWER LPA0:
  363. $ SET DEVICE/SPOOLED=SYS$PRINT LPB0:
  364. $ ITITIALIZE/QUEUE/START/DEFAULT=FLAG/NOENABLE_GENERIC LPB0:
  365. $ !
  366. $ INITIALIZE/QUEUE/START/GENERIC=(LPA0,LPB0) SYS$PRINT
  367. $ !
  368. $ !Establish batch queues
  369. $ !
  370. $ INITIALIZE/QUEUE/START/BATCH/JOB_LIMIT=2/BASE_PRIORITY=3 SYS$BATCH
  371.  
  372. NOTE:  DIGITAL recommends using the /RESTART qualifier w/ the
  373. START/QUEUE/MANAGER command.  This qualifier causes the queue manager to
  374. restart automatically if the job controller should abort.
  375.  
  376. A spooled device directs the output of an application to an intermediate file
  377. until the application program finishes.  When the application completes, the
  378. file is submitted for printing.  A spooled device can help balance the
  379. workload deman on line printers if you are running applications on a
  380. time-shared system.  Use the SET DEVICE/SPOOLED command to establish spooled
  381. devices.
  382.  
  383. 2.4.4 INSTALLING KNOW IMAGES
  384.  
  385. You can install commonly used programs as known images to reduce the I/O
  386. overhead in activating those images and to assign attributes or privileges to
  387. the images.  If you have programs on your system that meet any of the
  388. following conditions, you should read this section and install such programs
  389. as known images in the SYSTARTUP_V5.COM startup file:
  390.  
  391. :  Programs that are frequently run
  392. :  Programs that are usually run concurrently by several processes
  393. :  Programs that require special privileges
  394.  
  395. All known images must be reinstalled each time the system is rebooted, because
  396. known file lists are not saved if the system is shut down or fails.  You
  397. include INSTALL commands in SYSTARTUP_V5.COM to install programs as known
  398. images.  Chaper 9 includes a discussion about performance characteristics and
  399. known images.
  400.  
  401. The following example shows a command sequence that might appear in
  402. SYSTARTUP_V5.COM for installing additional known images:
  403.  
  404. $ INSTALL
  405.  
  406. ADD/OPEN/SHARED/HEADER_RESIDENT BLISS32
  407. ADD/OPEN/SHARED MACRO32
  408. ADD/OPEN DIRECTORY
  409.  
  410. 2.4.5  STARTING UP THE DECNET NETWORK
  411.  
  412. The DECnet software lets your system communicate w/ other computers.  If you
  413. install DECnet software on your system, you must include commands in
  414. SYSTARTUP_V5.COM that start up the DECnet network.  REad this section if you
  415. have the DECnet software on your system.
  416.  
  417. If you have started a batch queue on your system (as described in an earlier
  418. section), then you should start the network using the following commands in
  419. SYSTARTUP_V5.COM:
  420.  
  421.  $ IF F$SEARCH("SYS$SYSTEM:NETACP.EXE")  .NES.  "" - ! This is faster, if you
  422.  $ THEN SUBMIT SYS$MANAGER:STARTNET.COM              ! have batch queues setup.
  423.  
  424. These commands submit the network startup procedure (SYS$MANAGER:STARTNET.COM)
  425. as a batch job, which reduces the amount of time it takes to boot your system.
  426. Alternatively, if you have not started a batch queue, use the following
  427. command in SYSTARTUP_V5.COM to start up the network:
  428.  
  429.  $ IF F$SEARCH("SYS$SYSTEM: NETACP.EXE")  .NES.  "" THEN @SYS$MANAGER:STARTNET
  430.  
  431. 2.4.6 RUNNING THE SYSTEM DUMP ANALYZER
  432.  
  433. In the event of a system failure, the System Dump Analyzer (SDA) can help you
  434. determine why the system failed.  In order to use SDA for this purpose, you
  435. should make sure that the system dump file is available for analysis and not
  436. overwritten by a new crash.  REad the rest of this section if you want to
  437. learn about using SDA w/ SYSTARTUP_V5.COM.
  438.  
  439. You can start SDA in your site-specific startup file by using the following
  440. lines in SYSTARTUP_V5.COM:
  441.  
  442.                  $ ANALYZE/CRASH_DUMP  SYS$SYSTEM: SYSDUMP.DMP
  443.                   COPY SYS$ERRORLOG: SYSDUMP.DMP  SYSDUMP.BACK
  444.  
  445. For further information, invoke the SDA for an intereactive session upon
  446. completion of startup, or refer to the SDA documentation in the extended VMS
  447. documentation set.
  448.  
  449. CAUTION:  If you use the page file for the crash dump file, when the system
  450. reboots, you MUST enter the SDA command COPY to copy the dump[ from the page
  451. file to another file suitable for analysis.  If you fail to perorm the copy
  452. operation, pages used to save the crash dump information are not released for
  453. paging, and your system hangs while executing STARTUP.COM in the rebooting
  454. process.
  455.  
  456. 2.4.7 PURGING OPERATORS LOG FILE
  457.  
  458. Each time the system is rebooted, a new version of OPERATOR.LOG is created in
  459. the SYS$MANAGER directory.  You should devise a plan for regular maintenance
  460. of these files.  Adding the following command to SYSTARTUP_V5.COM purges all
  461. but the last two (2) versions of the operator's log file:
  462.  
  463.                    $ PURGE/KEEP=2  SYS$MANAGER: OPERATOR.LOG
  464.  
  465. See Chapter 10 for additional suggestions for maintaining the operators log
  466. files.
  467.  
  468. 2.4.8 SUBMITTING BATCH JOBS THAT ARE RUN AT STARTUP TIME
  469.  
  470. Some sites may have batch jobs that are submitted at system startup time.  To
  471. submit such batch jobs, add SUBMIT commands to your SYSTARTUP_V5 file, in the
  472. following format:
  473.  
  474.                       $  SUBMIT [/qualifier,...] file-spec
  475.  
  476. In the following example, a batch job is submitted to run a command procedure
  477. that rebuilds the disks each time the system is initalized.
  478.  
  479.                     $  SUBMIT  SYS$MANAGER: SYSDISK_REBUILD
  480.  
  481. If you submit batch processing jobs in SYSTARTUP_V5.COM, make sure that the
  482. batch processing jobs are submitted after the batch queues have been
  483. initialized.  See Chapter 5 for more information on submitting batch jobs.
  484.  
  485. 2.4.9  DEFINING THE NUMBER OF INTERACTIVE USERS
  486.  
  487. You can set a limit for the number of interactive unsers that are allowed to
  488. be logged into your system at one time.  To do this, include the following
  489. command in SYSTARTUP_V5.COM:
  490.  
  491.    $  STARTUP$INTERACTIVE_LOGINS ==n <- where n is is where you would put a #
  492.  
  493. Where n is the maximum number of interactive users that are perrmitted to log
  494. in at one time.
  495.  
  496. NOTE:  the number of interactive users mujst be set to a value no greater than
  497. that which is authorized by your VAX processor license.
  498.  
  499. 2.4.10  STARTING UP THE LAT NETWORK
  500.  
  501. A LAT network is any local area network where terminal servers and operating
  502. systems use the Local Area Transport (LAT) protocol.  A LAT network can
  503. coexist on the same Ethernet w/ other protocols.  If your system uses a LAT
  504. network, you should read this section.
  505.  
  506. To configure your system as a service node w/in a LAT network, execute the
  507. command procedure SYS$MANAGER:LTLOAD.COM from w/in SYSTARTUP_V5.COM.LTLOAD.COM
  508. starts up the LAT protocl.  In the LAT protocol, a VMS operating system
  509. advertises its services over the Ethernet and responds to connection requests
  510. from terminal servers supporting user terminals and oterh asynchronous
  511. devices.
  512.  
  513. to start up the LAT network, add the following command line to
  514. SYSTARTUP_V5.COM:
  515.  
  516.                              $ @SYS$MANAGER: LTLOAD
  517.  
  518. To configure a node as a service node that connects only to interactive
  519. terminals on a terminal server, include the command line shown in the last
  520. example in SYSTARTUP_V5.COM.
  521.  
  522. However, if you want to use remote printers on a terminal server or to create
  523. dedicated application services on the VMS service node, you must modify
  524. LTLOAD.COM
  525.  
  526. SUPPORTING USER TERMINALS ON A TERMINAL SERVER
  527.  
  528. To create a VMS service node on a LAT network that supports only interactive
  529. terminals is a one-step procedure.  You insert the command @SYS$MANAGER:LTLOAD
  530. into SYSTEARTUP_V5.COM and append any of the following arguments:
  531.  
  532.                    $ @SYS$MANAGER:LTLOAD "P1" "P2" "P3" "P4"
  533.  
  534. The arguments P1/P4 have the following meanings:
  535.  
  536. P1..Service name..Name of the VMS service.  For clustered VMS service nodes,
  537. use the cluster name as the service name.  For independent VMS service nodes,
  538. use the physical node name.
  539.  
  540. P2 - P4..any of the following: /IDENTIFICATION="string"..Description of the
  541. node and its services that are advertised over the Ehternet.  The default is
  542. the string defined by the logical name SYS$ANNOUNCE.
  543.  
  544. /ENABLE=group-list..Terminal server groups qualified to establish connections
  545. w/ the VMS servic node.  By defauld, Group 0 is enabled.
  546.  
  547. /DISABLE=group-list..Removes previously enabled terminal server groups.
  548.  
  549. The argument P1 assigns a service name to the node, using the LATCP command
  550. CREATE SERVICE.  Arguments P2 through P4 can be any valid qualifier to the SET
  551. NODE command.
  552.  
  553. For example, the following command creates the service OFFICE on the VMS node,
  554. MOE, which is part of the OFFICE cluster.
  555.  
  556.               $ @SYS$MANAGER:LTLOAD OFFICE "/ENABLE=1" "/DIABLE=0"
  557.  
  558. 2.4.11 CREATING SYSTEMWIDE ANNOUCEMENTS
  559.  
  560. This section describes how to define the following types of systemwide
  561. announcements in your SYSTARTUP_V5.COM file:
  562.  
  563. : A message to users informing them that the system is available for use
  564.   (after a system boot)
  565.  
  566. : A message to users when first accessing the system for login
  567.  
  568. : A welcoming message when a user logs in
  569.  
  570. When your system has completed the startup procedure and is up and running,
  571. you can send a message to all connected terminals announcing the system's
  572. availability.  To do this, include a line, w/ an appropriate message w/in the
  573. quotation marks, before the $EXIT command in your SYSTARTUP_V5.COM file:
  574.  
  575. $ REPLY/ALL/BELL "VMS Operating System at NIGHTMARE 589-7840..READ FOR USE."
  576.  
  577. if you want to display at the beginning of each user's login procedure,
  578. include a line, w/ an appropriate message w/in the quotation marks, in
  579. SYSTARTUP_V5.COM:
  580.  
  581. $ DEFINE/SYSTEM SYS$ANNOUNCE "NIGHTMARE, 589-7840 -- AUHTORIZED USE ONLY"
  582.  
  583. You can also display a messge to all interactive users immediately after they
  584. log in by including a line similar to the folling in SYSTARTUP_V5.COM:
  585.  
  586. $ DEFINE/SYSTEM SYS$WELCOME "Welcome to the VMS Operating System at Nightmare,
  587.   589-7840."
  588.  
  589. If you do not define SYS$WELCOME, the following standard messaged is
  590. displayed:
  591.  
  592. Welcome to VMS version n.n
  593.  
  594. The SYSTARTUP_V5 command file supplied as a template w/ DIGITAL'S distribution
  595. kit includes additional command examples for SYS$ANNOUNCE and SYS$WELCOME.
  596.  
  597. You may also want to display various system announcements to users at the time
  598. they log in. You do this w/ a command in the systemwide login command
  599. procedure, SYLOGIN.COM, as explained later in this chapter.
  600.  
  601. 2.5 DEFINING A SYSTEM LOGIN COMMAND PROCEDURE
  602.  
  603. A system login command procedure is executed for each interactive usree when
  604. the user logs in. W/ a system login command procedure, you can establish
  605. elements of a computing environment that are the same for all interactive
  606. users.  To use a system login procedure, you should do as follows:
  607.  
  608. 1. Define the logical name SYS$SYLOGIN, usually in your site-specific startup
  609. file (SYSTARTUP_V5.COM).
  610.  
  611. 2. Create a system login command procedure.
  612.  
  613. To define the logical name SYS$SYLOGIN and point to a system login command
  614. file name SYS$MANAGER:SYLOGIN.COM, include the following line in
  615. SYSTARTUP_V5.COM:
  616.  
  617. $ DEFINE/SYSTEM/EXEC/NOLOG SYS$SYSLOGIN SYS$MANAGER:SYLOGIN.COM
  618.  
  619. A template for a system login command procedure is found in
  620. SYS$MANAGER:SYLOGIN.COM.  This file includes commands that you can modify and
  621. add to according to the needs of your site.
  622.  
  623. You can use the system login command procedure to display announcements for
  624. your site.  Todo this, you would do the following:
  625.  
  626. 1.  Create a text file that has current announcements, for example w/ the
  627. filename SYS$MANAGER:ANNOUNCEMENTS.TXT.  You could then update this file
  628. (adding/deleting announcements) as needed.
  629.  
  630. 2.  Include a line at the end of your system login command procedure that
  631. displays the announcements file, such as the following:
  632.  
  633. $ TYPE SYS$MANAGER: ANNOUNCEMENTS.TXT
  634.  
  635. In addition to a system login command procedure, users can also have their own
  636. login command procedures.  User login command procedures are executed
  637. immediately after the system login command procedure.
  638.  
  639. 2.6  BACKING UP THE SYSTEM
  640.  
  641. To limit the risk of losing your operating system environment, you should
  642. perform the following sequential operations after installing and customizing
  643. your system:
  644.  
  645. 1.  Back up the console volume
  646.  
  647. 2.  Build a standalone backup kit
  648.  
  649. 3.  Back up the system disk
  650.  
  651. If your processor has a console storage device, DIGITAL recommends that you
  652. make a backup copy of your console volume, it is useful to have a backup copy
  653. in case your original becomes corrupted.  The VMS operating system provides a
  654. command procedure called CONSCOPY.COM in the SYS$UPDATE directory that copies
  655. your console volume to a blank one.
  656.  
  657. To back up your system disk, DIGITAL recommends that you use standalone
  658. BACKUP, which uses a subset of Backup Utility qualifiers.  If your system was
  659. not distributed on magnetic tape, youmust build a standalone BACKUP kit either
  660. on console media or on disk.  You can then boot standalone directory root SYSE
  661. on a Files-11 disk.
  662.  
  663. Installing and using standalone BACKUP in an alternate root on your system
  664. disk saves time when you are backing up your system disk,  because you do not
  665. have to boot standalone BACKUP from your console volume.
  666.  
  667. NOTE:  The procedures for backing up the console volume and backing up the
  668. system disk vary for different VAX processors.  See your VAX processor
  669. installation and operations guide for the setp-by-step procedures that apply
  670. to your processor.
  671.  
  672. 2.7 BUILDING AND COPYING A VMS SYSTEM DISK
  673.  
  674. The command procedure SYS$UPDATE:VMSSKITBLD is used for building and copying a
  675. VMS system disk.  The procedure provides you w/ the following options:
  676.  
  677. :  BUILD -- Destroys all previous information on the target disk and then
  678.             builds the new system disk.
  679.  
  680. :  ADD   -- Adds another copy of the operating system to an alternate system
  681.             root directory on the same system disk.
  682.  
  683. :  COPY  -- Copies the operating system files to a target disk w/out
  684.             destroying the files that are currently on the target disk.
  685.  
  686. :  COMMON - Initializes the target disk and builds it as a cluster-common
  687.             system disk.
  688.  
  689. CAUTION:  The VMSKITBLD BUILD and COMMON options initialize the target disk,
  690. deleting, all of its previous contents.
  691.  
  692. In some cases, you may want the operating system to exist on another disk.
  693. The following paragraphs describe two such cases and the procedures that you
  694. would use.
  695.  
  696. You may want to move your operating system files to another disk.  for
  697. example, assume that your operating system is initally stored on a disk
  698. together w/ some ofyour user files.  Suppose that you want to move only the
  699. operating system files from original disk to a smaller disk.  You can build
  700. the operating system on the smaller disk (called the target/destination disk)
  701. w/out affecting the user files on the original disk (the source disk) by using
  702. the BUILD option of the VMSKITBLD command procedure.
  703.  
  704. You may want to create a separate test envionment where you can modify the
  705. operating system w/out affecting current operations.  You could use the ADD
  706. option to copy the operating system to an alternate system root directory and
  707. create a boot command procedure to select that version for testing sessions.
  708. In addition, you may want to preserve the current version of the operating
  709. system before upgrading your system to the next major version.  To do so, use
  710. the ADD option to make a copy of the current operating system in an alternate
  711. system root directory (SYSA) and then upgrade and run the new version of the
  712. operating system in SYSO.
  713.  
  714. CAUTION:  When you copy the system disk using VMSKITBLD.COM, SYSUAF.DAT and
  715. all user-modified command files are NOT copied onto the target disk.
  716. VMSKITBLD.COM uses the site-specific template files w/ the TEMPLATE file type
  717. in building the new system disk.
  718.  
  719. 2.8 SYSTEM STARTUP PROCEDURES
  720.  
  721. This section describes the process that the VMS operating system follows when
  722. you boot your system.  This section is mostly informational -- that is, you
  723. usually do NOT have todo anything during the booting process, but you may want
  724. to know how the operating system is set up.
  725.  
  726. Each time that your systesm is booted, the VMS operating system initiates a
  727. startup procedure.  The startup procedure includes the execution of the
  728. following series of command procedures:
  729.  
  730. :  SYS$SYSTEM:STARTUP.COM -- A file containing a series of procedures that
  731.                              must execute at system startup time in order for
  732.                              the system to run properly.  STARTUP.COM is the
  733.                              site-independent startup command procedure
  734.                              supplied by DIGITAL.  Do not modify this command
  735.                              procedure.  The STARTUP.COM procedure invokes
  736.                              the site-specific procedures that are described
  737.                              in this section.
  738.  
  739. :  SYS$MANAGER:SYCONFIG.COM -- A template file suplied by DIGITAL to which you
  740.                                can add site-specific configuration commands.
  741.  
  742. :  SYS$MANAGER:SYLOGICALS.COM -- A termplate file supplied by DIGITAL for
  743.                                  defining logical names.  This file contains
  744.                                  a command procedure for adding system logical
  745.                                  names for a MicroVAX that is not in a cluster
  746.                                  If your processor is not a standalone Micro
  747.                                  Vax, you can ignore that section of the
  748.                                  procedure that pertains only to MicroVax
  749.                                  systems and add any systemwide logical name
  750.                                  assignments for your own system to the end
  751.                                  of this file.
  752.  
  753. :  SYS$MANAGER:SYLOGIN.COM -- A template file supplied by DIGITAL to which you
  754.                               can add commands that are executed whenever a
  755.                               user logs in.
  756.  
  757. :  SYS$MANAGER:SYSTARTUP_V5.COM -- A template file supplied by DIGITAL to
  758.                                    which you can add various commands for
  759.                                    setting up site-specific operations that
  760.                                    are executed at startup time.  The template
  761.                                    contains commands that you can modify to
  762.                                    meet the needs of your processing
  763.                                    environment.
  764.  
  765. :  SYS$MANAGER:SYPAGSWPFILES.COM -- A file supplied by DIGITAL to which you
  766.                                     can add commands to install page and swap
  767.                                     files on any disk.
  768.  
  769. Two versions of the template files are included in your VMS distribution kit:
  770. an executable version w/ the file name extension COM, and a nonexecutable
  771. version w/ the file exetension TEMPLATE (for example, SYS$MANAGER:SYCONFIG.COM
  772. and SYS$MANAGER:SYCONFIG.TEMPLATE).  The files w/ the COM filetype are
  773. executed at startup time, and those are the files that you should modify to
  774. meet the needs of your site.  The files w/ the TEMPLATE filetype should NOT be
  775. modifed.
  776.  
  777. CAUTION:  Do NOT delete the DIGITAL-supplied template command files w/ the
  778. TEMPLATE file type.  The VMSKITBLD.COM procedure uses the TEMPLATE versions to
  779. create a new system disk.
  780.  
  781. More information on STARTUP.COM and the site-specific command procedures is
  782. provided in the sections that follow.
  783.  
  784. 2.8.1  STARTUP COMMAND PROCEDURE FOR THE SYSTEM (STARTUP.COM)
  785.  
  786. This section describes the system startup file (STARTUP.COM).  STARTUP.COM is
  787. executed whenever the system is booted, and it creates the basic environment
  788. for the operating system and some software products.  It is not a startup file
  789. that is customized for your site.  You should not modify the STARTUP.COM file.
  790. Read this section if you are interested in learnig about the startup porcess.
  791.  
  792. The file SYSTARTUP_V5.COM, which is also executed each time the system is
  793. booted, is the startup file where you include features specific to your site.
  794. To learn how to customize the startup process for your site by modifying
  795. STARTUP_V5.COM, see section 2.4.
  796.  
  797. The file SYS$SYSTEM:STARTUP.COM executes immediately after the operating
  798. system is booted.  It is a driver that uses a series of component files to
  799. perform the following startup tasks:
  800.  
  801. :  Defines systemwide logical names required for the symbolic debugger,
  802. language processors, linker, image activator, and help processor.
  803.  
  804. :  Start processes that control error logging, SMISERVER (the system
  805. management server), the job controller, and the operator's log.  (on a
  806. standalone workstation the operator's log is not automatically started.)
  807.  
  808. :  Connects and configures devices that are physically attached to the system
  809. and loads their I/O drivers by invoking the SYCONFIG.COM procedure.
  810.  
  811. : Installs known images to reduce I/O overhead in activating the most commonly
  812. fun images or to identify images that must have special privileges.
  813.  
  814. CAUTION:  Do not modify SYS$SYSTEM:STARTUP.COM. This file is deleted and
  815. replaced each time you upgrade your system w/ the next version of the VMS
  816. operqating system.  Leaving STARTUP.COM intact prevents you from inadvertently
  817. altering any commands in the file, which in turn could cause the startup
  818. procedure to fail.
  819.  
  820. All of the component files used by STARTUP.COM are in the directories w/ the
  821. logical name SYS$STARTUP.  SYS$STARTUP is actually a searchlist that includes
  822. both SYS$SYSROOT:[SYSMGR] (the SYS$MANAGER directory) and
  823. SYS$SYSROOT:[SYS$STARTUP].
  824.  
  825. In VMS Version 5.0, the following three data files are involved in startup
  826. process and located in SYS$STARTUP:
  827.  
  828. 1.  VMS$PHASES.DAT--This file determines the order of the phases of the
  829. startup procedure.  It is a sequential list of phases that will be started by
  830. STARTUP.COM.  It includes a series of four (4) basic phases ( INITIAL,
  831. CONFIGURE, SYSFILES, & BASEENVIRON)  needed to bring the VMS operating system
  832. up to a basic working evironment, followed by a series of phases for optional
  833. software products.  This fule must not be modified.
  834.  
  835. 2.  VMS$VMS.DAT--This is a component data file for starting the vase VMS
  836. operating system environment.  You should NOT modify this file.
  837.  
  838. 3.  VMS$LAYERED.DAT--This is a component file for optional software products
  839. that are installed using the callback procedure of VMSINSTAL.  It is an
  840. indexedsequential file, containing the following fields for each file:
  841.  
  842.    1.  Name of the component file(either .EXE or .COM) to be run.
  843.  
  844.    2.  Phase in which the comonent file is to be run.  The valid phases are
  845.        LPBEGIN, LPMAIN (default), LPBETA, & END.
  846.  
  847.    3.  Method (or mode) by which the component file is to run.  The valid
  848.        choices are DIRECT(the default, where the command procedure or image
  849.        is executed immediately), BATCH(valid only for command procedures,
  850.        or SPAWN.
  851.  
  852.    4.  Node restrictions for the component.  This is either the node or nodes
  853.        on which the component file should ONLY be run, or the node or nodes on
  854.        which the component file should NOT be run.
  855.  
  856.  
  857.    5.  Node restriction byte field.  This field determines whether the nodes
  858.        listed in the previous field are allowed or disallowed (for running
  859.        the component).
  860.  
  861.    6.  Parameters passes to the component file for execution.  You can pass up
  862.        to eight parameters, using the following format:
  863.  
  864.        (P1:args, P2: args,...)
  865.        (The paretheses can be omitted if you pass only a single parameter.)
  866.  
  867. An important function of each phase is to meet the prerequisites of the
  868. following phase; therefore, the ordering of the phases is extrememly
  869. important.  Components that occur in a phase cannot have dependencies on
  870. components that are in the smae phase or in subsequent phases.  When
  871. installing optional software products as known images using the STARTUP.COM
  872. procedure, be sure that all requisite components occur in a previous phase.
  873.  
  874. If an optional software product can use the callback procedure included in
  875. VMSINSTALL, then you can install it as a known image at system startup using
  876. the method described earlier in this section, and you do not have to include
  877. the product in the site-specific startup file(SYSTARTUP_V5.COM).  In these
  878. cases, the component files must be in the SYS$STARTUP directory.  Software
  879. products that do not use the callback procedure should be installed as known
  880. images at system startup using SYSTARTUP_V5.COM.
  881.  
  882. You can also use the System Management Utility (SYMAN) to manage the new
  883. startup process.  W/ the STARTUP command of SYSMAN, you can add, modify,
  884. display, or remove elements of existing component files, create a new startup
  885. file and perform other startup functions.  A description of SYSMAN commands is
  886. found in the Reference section.
  887.  
  888. Several site-specific command procedures are executed from w/in STARTUP.COM.
  889. You can add commands to these files or modify the template files supplied in
  890. your VMS distribution kit.  Remember, however, to modify only the executable
  891. version of the file(w/ the file extension .COM)and not the template version
  892. (w/ the file extension TEMPLATE).  If you have an existing .COM file and you
  893. want to modify a version of the original TEMPLATE  file, then you should first
  894. make a copy of the TEMPLATE file(giving the copy a filetype of .COM).
  895.  
  896. STARTUP.COM executes the site-specific command procedures in the following
  897. sequence:
  898.  
  899. 1.  SYS$MANAGER:SYPAGSWPFILES.COM
  900. 2.  SYS$MANAGER:SYCONFIG.COM
  901. 3.  SYS$MANAGER:SYLOGICALS.COM
  902. 4.  SYS$MANAGER:SYSTARTUP_V5.COM
  903.  
  904. 2.8.2  SETTING UP LOGICAL NAMES FOR YOUR SITE (SYLOGICALS.COM)
  905.  
  906. A logical name is a name that is equivalent to a file specification, a
  907. directory, a device name, another logical name, or some other equivalence
  908. string.  For example, when you have a logical name associated w/ a device
  909. name, you can use the logical name instead of the formal device name.
  910.  
  911. You can assign logical names that apply for the entire system; these are
  912. called systemwide logical names, and they can be used by any process on the
  913. system.  For example, if a systemwide logical name equated the logical name
  914. FINANCE_DISK to the device DRA2, any user on the system (and any program
  915. running on the system) could use the name FINANCE_DISK in place of DRA2.
  916.  
  917. The file SYS$MANAGER:SYLOGICALS.COM can be used for assigning systemwide
  918. logical names.  SYLOGICALS.COM is executed as part of the STARTUP.COM
  919. procedure whenever your system is booted.  The logical names defined in
  920. SYLOGICALS.COM (as well as the logical names assigned automatically in
  921. STARTUP.COM) are always included in the system logical name table.
  922.  
  923. If your system is a MicroVAX that is NOT in a cluster, you should use the file
  924. SYLOGICALS.COM as a template for assigning systemwide logical names.  If you
  925. have a MicroVAX that is not in a VAXcluster environment and you want to have
  926. systemwide logical names, you should read this section.
  927.  
  928. Unless your processor ia a MicroVAX that is NOT in a VAXcluster environment,
  929. the template procedure that is found in SYLOGICALS.COM has NO effect.
  930. However, if your processor is on where the template procedure does not apply,
  931. you can still use SYLOGICALS.COM to assign systemwide logical names by adding
  932. them to SYLOGICALS.COM before the EXIT command, as indicated in the
  933. SYLOGICALS.COM template.
  934.  
  935. During VMS system operations when the integrity of the system could be
  936. compromised by incorrect logical names, such as the activation of priviledged
  937. images (LOGINOUT,MAIL, etc...) only executive-mode and kernel-mode logical
  938. names are used; supervisor-mode and user-mode names are ignored.  DIGITAL
  939. therefore recommends that logical names for system components (for example,
  940. public disks/directories) be defined in executive mode, for example:
  941.  
  942. $ DEFINE/SYSTEM/EXECUTIVE/NOLOG SYSDSK SYS$SYSDEVICE:
  943.  
  944. See the VMS General Users Manual for information about logical name
  945. assignments and the privilege modes.
  946.  
  947. 2.9  EMERGENCY STARTUP PROCEDURES
  948.  
  949. The startup and login procedures provided by DIGITAL should always work;
  950. however, certian user interventions may cause them to fail.  For example, if
  951. you modify the startup of login procedures, or modify the login accounts, you
  952. may accidentally lock yourself out of the system.  A very simple way to lock
  953. yourself out of the system is to set passwords and forget them.  Another way
  954. to lock yourself out of the system is to introduce an error condition or an
  955. infinite loop into a startup or login procedure.  Under such circumstances,
  956. use the emergency startup procedure described in this section.
  957.  
  958. 2.9.1  BYPASSING THE USER AUTHORIZATION FILE
  959.  
  960.  
  961. The preferred method of breaking into a locked system isto set the alternate
  962. user authorization file.  This method requires setting the system parameter
  963. UAFALTERNATE, which defines the logical name SYSUAF to refer to the file
  964. SYS$SYSTEM:SYSUAFALT.DAT.  If this file is found during a normal login, the
  965. system uses it to validate the account and prompts you for the user
  966. name/password.
  967.  
  968. If this file is not located, the system assumes that the UAF is corrup and
  969. accepts any user name/password to log you into the system from the system
  970. console.  Logins are prohibited from all other locations.
  971.  
  972. NOTE:  You can use this method only to log into the system from the console
  973. terminal; you cannot use other terminal lines.
  974.  
  975. To set the alternate user authorization file, use the following procedure:
  976.  
  977. 1.  Perform a conversational boot by following the instructions in your VAX
  978.     processor installation/operations guide.
  979.  
  980. 2.  When the SYSBOOT> prompt appears, enter the following command:
  981.  
  982. SYSBOOT> SET UAFALTERNATE 1
  983.  
  984. 3.  Type CONTINUE and press RETURN/ENTER KEY.
  985.  
  986. 4.  When the startup procedure completes, log in on the console terminal by
  987.     entering any user name/password in sresponse to the USERNAME: and then the
  988.     PASSWORD: prompts.
  989.  
  990.     The system assigns the following values to your user account:
  991.     : NAME -User Name
  992.     : UIC  -[001,004]
  993.     : command Interpreter -DCL (Digital Command Language)
  994.     : Login Flags -None
  995.     : Priority -Value of the system parameter DEFPRI
  996.     : Resources -Values of the PQL system parameters
  997.     : Privileges -All
  998.     The process name is usually the name of the device on which you logged in
  999.     (for example, _OPA0:).
  1000.  
  1001. 5.  Fix the problem that caused you to be locked out of the system.  That is,
  1002.     make the necessary repairs to the UAF or to the startup or login
  1003.     procedures.  (If you modify a login or startup procedure and the problem is
  1004.     still not solved, you should restore the procedure to its previous state.)
  1005.     If the problem is a forgotten password, reset the UAFALTERNATE system
  1006.     parameter to 0, as explained in the next step.  Then invoke the Authorize
  1007.     Utility and type HELP MODIFY for information on modifying passwords.
  1008.  
  1009. 6.  Clear the UAFALTERNATE parameter by running SYSGEN and giving appropriate
  1010.     SYSGEN commands.  To run SYSGEN, enter the following command at the DCL
  1011.     prompt:
  1012.     $ RUN SYS$SYSTEM:SYSGEN
  1013.  
  1014.     The SYSGEN> prompt is displayed, and you should enter the following
  1015.     commands:
  1016.     SYSGEN> SET UAFALTERNATE 0
  1017.     SYSGEN> WRITE CURRENT
  1018.     SYSGEN> EXIT
  1019.  
  1020. 7.  Shut down and reboot the system.
  1021.  
  1022. 2.9.2  EMERGENCY STARTUP AFTER MODIFYING SYSTEM PARAMTERS
  1023.  
  1024. In some cases, modifying system parameters may cause the system to become
  1025. unbootable.  If this occurs, use the following emergency startup procedure to
  1026. restore to normal operation:
  1027.  
  1028. 1.  Perform a conversational boot by following the instructions in your VAX
  1029.     processor installation/operations guide.
  1030.  
  1031. 2.  When the SYSBOOT> prompt appears, enter the following commands:
  1032.     SYSBOOT> USE DEFAULT.PAR
  1033.     SYSBOOT> CONTINUE
  1034.  
  1035. 3.  When the system finishes booting, review any changes you made to SYSGEN
  1036. parameters, modify MODPARAMS.DAT as necessary, and reexecute AUTOGEN.
  1037.  
  1038. 2.9.3  BYPASSING STARTUP/LOGIN
  1039.  
  1040. If the system does not complete the startup procedures or does not allow you
  1041. to log in, bypass the startup/login procedures by following these steps:
  1042.  
  1043. 1.  Perform a conversational boot by following the isntructions in your VAX
  1044.     processor installation/operations guide.
  1045.  
  1046. 2.  Define the console tobe the startup procecdure by entering the following
  1047.     command at the SYSBOOT> promt:
  1048.  
  1049.     SYSBOOT> SET/STARTUP OPA0:
  1050.  
  1051.     type CONTINUE and press Return/Enter in response to the next SYSBOOT>
  1052.     prompt.  Wait for the DCL prompt to return.
  1053.  
  1054. 3.  Correct the error condition that caused the login failure.  That is, make
  1055.     the necessary repairs to the startup/login procedures, or to the UAF.  You
  1056.     may want to enter the following DCL commands because bypassing the startup
  1057.     procedures leaves the system in a partially initalized state:
  1058.  
  1059.     $ SET NOON
  1060.     $ SET DEFAULT SYS$SYSROOT: [SYSEXE]
  1061.  
  1062.    Invoke a text editor to correct the startup/login procedure file.  Note
  1063.    that some system consoles may NOT supply a screen/mode editor.  You can
  1064.    also copy a corrected file and delete the incorrect version by using
  1065.    the RENAME/DELETE commands.
  1066.  
  1067. 4.  Reset the startup procedure by invoking SYSGEN and entering the following
  1068.     commands:
  1069.  
  1070.     $ RUN SYS$SYSTEM:SYSGEN
  1071.     SYSGEN> SET/STARTUP SYS$SYSTEM:STARTUP.COM
  1072.     SYSGEN> WRITE CURRENT
  1073.     SYSGEN> EXIT
  1074.  
  1075. 5. Perform a normal startup by entering the following command:
  1076.  
  1077.    $ @SYS$SYSTEM:STARTUP
  1078.  
  1079. 2.9.4 STARTUP PROBLEMS
  1080.  
  1081. Sometimes the operating system does not boot after you enter the BOOT command.
  1082. This can be caused by either a hardware/software malfunction.
  1083.  
  1084. A read error on a disk drive or console medium, or a machine check error, may
  1085. indicate a hardware malfunction.  When a hardware problem occurs, a question
  1086. mark (?) usually precedes the error message that is displayed on the system
  1087. console terminal.  You should then do the following:
  1088.  
  1089. 1.  Consult the hardware manual for your VAX processor.
  1090.  
  1091. 2.  If you still cannot correct the problem, contact your DIDGITAL FIELD
  1092.     REPRESENTITIVE.
  1093.  
  1094. When the operating system is loaded into memory but the STARTUP.COM command
  1095. procedure does not execute, a softsare malfunction has probably occured.  You
  1096. should suspect this condition if the usual message specifying the number of
  1097. interactive users does not appear.
  1098.  
  1099. Perform one or both of the following actions to correct the situation:
  1100.  
  1101. 1.  Try again, by repeating the boot procedure to restart the system.
  1102.  
  1103. 2.  Leave the system disk in the original drive.  Restore a backup copy of the
  1104.     system disk using Standalong Backup.
  1105.  
  1106. 2.10  SHUTDOWN PROCEDURES
  1107.  
  1108. The VMS operating system provides the folowing types of shutdown procedures:
  1109.  
  1110. :  An orderly shutdown w/ SYS$SYSTEM:SHUTDOWN.COM.  This procedure shuts down
  1111.    the system while performing housekeeping functions such as disabling
  1112.    future logins, stopping the batch and output queues, dismounting mounted
  1113.    volumes, and stopping user processes.
  1114.  
  1115.    SHUTDOWN.COM optionally invokes a site-specific command procedure named
  1116.    SYS$MANAGER:SYSHUTDWN.COM, which you can modify to meed the needs of your
  1117.    basic installation.  An empty SYSHUTDWN.COM file is included in your VMS
  1118.    distribution kit.
  1119.  
  1120. :  An emergency shutdown w/ OPCCRASH.  If you are unable to perform an orderly
  1121.    shutdown w/ SHUTDOWN.COM, run the OPCCRASH emergency shutdown program.
  1122.  
  1123. :  An emergency shutdown w/ CRASH.  Use this emergency shutdown procedure if
  1124.    OPCCRASH fails.  Note that not all VAX processors have the CRASH program.
  1125.    If your VAX processor has the CRASH procedure, it is located on the console
  1126.    media, and it can only be executed from the console terminal.  See your
  1127.    VAX processor installation/operations guide for a description of the CRASH
  1128.    procedure or for the equivalent commands to use to force an abrupt
  1129.    emergency shutdown.
  1130.  
  1131. 2.10.1  ORDERLY SHUTDOWN W/ SHUTDOWN.COM
  1132.  
  1133. Use SHUTDOWN.COM to shut down the system in an orderly fashion.  Do not
  1134. mnodify SHUTDOWN.COM.  Add commands to the SYS$MANAGER:SYSHUTDWN.COM command
  1135. procedure to perform site-specific functions.
  1136.  
  1137. To execute SHUTDOWN.COM, you must have either the SETPRV privilege or all the
  1138. following privileges:  CMKRNL, EXQUOTA, LOG_IO, OPER, SYSNAM, SYSPRV, TMPMBX,
  1139. and WORLD.  Usually, you shut down the system from the SYSTEM account, which
  1140. includes these privileges by default.
  1141.  
  1142. 2.10.1.1  SHUTDOWN.COM SEQUENCE OF PROMPTS AND MESSAGES
  1143.  
  1144. To perform an orderly shutdown of the system, invoke SHUTDOWN.COM from any
  1145. terminal and any privileged account w/ the following DCL command:
  1146.  
  1147. $  @SYS$SYSTEM:SHUTDOWN
  1148.  
  1149. The procedure then prompts you w/ a series of questions and messages.  The
  1150. default response appear in brackets at the end of each question.  Press the
  1151. RETURN key to select the default response.  A summary of the questions
  1152. follows:
  1153.  
  1154. :  Minutes until shutdown:
  1155.    How many minutes until final shutdown [0]?
  1156.  
  1157.    Enter an integer.  If the system logical name SHUTDOWN$MINIMUM_MINUTES is
  1158.    defined, its integer value is the minimum value that you can enter.
  1159.    Therefore, if the logical name is defined as 10, you must specify at least
  1160.    10 minutes to final shutdown or an error message is returned.  If you do
  1161.    not enter a value, the logical name value is used.  If the logical name is
  1162.    not defined, and you do not enter a value, 0 minutes is the default.
  1163.  
  1164. :  Reson for shutdown:
  1165.    Reason for shutdown [standalone]:
  1166.  
  1167.    Enter a one-line reason for shutting down the system.
  1168.  
  1169. :  Decide if you want to spin down the disk volumes:
  1170.    Do you want to spin down the disk volumes [No]?
  1171.  
  1172.    Enter Yes or No (Y or N).  Note, however,  that the system disk cannot
  1173.    be spun down.
  1174.  
  1175. :  Decide if you want to invoke a site-specific shutdown procedure:
  1176.    Do you want to invoke the site-specific shutdown procedure [Yes]?
  1177.  
  1178.    Enter Yes or No.  This refers to SYS$MANAGER:SYSHUTDWN.COM.
  1179.  
  1180. :  Decide if you want an automatic system reboot:
  1181.    Should an automatic system reboot be performed [No]?
  1182.  
  1183.    By default, the system does not automatically reboot.  However, if you
  1184.    respond w/ YES, the system attempts to reboot automatically when the
  1185.    shutdown is complete.
  1186.  
  1187. :  Message broadcast to users about rebooting the system:
  1188.    When will the system be rebooted [later]?
  1189.  
  1190.    Enter the expected reboot time in the format you want printed in the
  1191.    message that will be broadcast to users.  For example, you could specify
  1192.    IMMEDIATELY, or IN 10 MINUTES, or a time such as 2 PM, or 14:00.  If you
  1193.    do not know when the system will be abailable again, press RETURN to
  1194.    specify 'later' as the time when the system will reboot.
  1195.  
  1196. :  Shutdown options:
  1197.    Shutdown options (enter as a comma--separated list):
  1198.    SAVE_FEEDBACK      : Saves feedback data for AUTOGEN calculations
  1199.    REMOVE_NODE        : Remaining nodes in the cluster should be adjust quorum
  1200.    CLUSTER_SHUTDOWN   : Entire cluster is shutting down
  1201.    REBOOT_CHECK       : Check exestence of basic system files
  1202.    Shutdown options [NONE]
  1203.  
  1204.    The procedure prompts you to specify one or more shutdown options.
  1205.  
  1206. Entering the SAVE_FEEDBACK option records feedback data collected from the
  1207. system since it was last booted.  This option creates a new version of the
  1208. AUTOGEN feedback data file, which can be used when you next run AUTOGEN.
  1209.  
  1210. If your system is a cluster member, all options are listed.  When the
  1211. REMOVE_NODE option is specified on one cluster member system, users on all
  1212. member systems are notified.  Clusterwide notification is required, because
  1213. users logged in to any member system may be affected by the shutdown of another
  1214. system, for example:
  1215.  
  1216. :  Users may have batch jobs running on other systems.
  1217. :  If therminal servers are in operation, users may have alternate terminal
  1218.    sessions in progress on the system being shut down.
  1219.  
  1220. Otherwise, only the REBOOT_CHECK and SAVE_FEEDBACK options are listed.  Enter
  1221. REBOOT_CHECK to verifty the presence of a subset of files necessary to reboot
  1222. the system after shutdown completes.  (if you are certain that the files exist,
  1223. press RETURN.)
  1224.  
  1225. If you select the REBOOT_CHECK option, the procedure checks for the necessary
  1226. files and notifies you if any are missing.  Replace missing files before
  1227. proceeding.  If all files are present, the following success message appears:
  1228.  
  1229. %SHUTDOWN-I-CHECKOK, Basic reboot consistency check completed.
  1230.  
  1231. The following events occur as the shutdown procedure continues, and the
  1232. corresponding messages are printed on the terminal:
  1233.  
  1234. 1.  A message requesting users to log out is broadcast at decreasing time
  1235.     intervals to all users on the system.
  1236.  
  1237. 2.  The system logical name SHUTDOWN$TIME is defined as the absolute time of
  1238.     shutdown.  For example, if the value 10 is specified at 12:00 in response
  1239.     to the first question, the logical name is assigned the absolute time value
  1240.     12:10 along w/ the date.  By requesting the logical name definition
  1241.     SHUTDOWN$TIME (w/ the SHOW LOGICAL command), you can see if a shutdown is
  1242.     in progress or determine the actual time of shutdown.  This feature is
  1243.     useful if a user missed the shutdown broadcast message.
  1244.  
  1245. 3.  At six minutes or less until system shutdown, the terminal from which
  1246.     shutdown was invoked is made an operator's console and all future
  1247.     nonoperator logins are disabled.  If the DECnet network is running, it
  1248.     is shuto down.
  1249.  
  1250. 4.  When there is one minute left until system shutdown, batch and device
  1251.     queues and the system job queue manager are stopped.
  1252.  
  1253. 5.  At zero minutes before system shutdown the site-specific command procedure
  1254.     SYS$MANAGER:SYSHUTDWN.COM is invoked.
  1255.  
  1256. 6.  All user processes are stopped; however, system processes continue.
  1257.     Ancillary Control Processes (ACP's) may delete themselves when their
  1258.     mounted volumes are finally dismounted.
  1259.  
  1260. 7.  For dual-processor systems, the secondary processor is stoped.
  1261.  
  1262. 8.  All installed images are removed.
  1263.  
  1264. 9.  All mounted volumes are dismounted and, if you request it, the disks are
  1265.     spun down.  Note, however, that the system disk cannot be spun down.  Also,
  1266.     the quorum disk (if present on your system) is not dismounted or spun down.
  1267.  
  1268. 10.  The operator's log file is closed.
  1269.  
  1270. 11.  The program SYS$SYSTEM:OPCCRASH is invoked to shut down the system.
  1271.  
  1272. 12.  If you did not request an automatic reboot, the following message appears
  1273.      on the system console:
  1274.  
  1275.      SYSTEM SHUTDOWN COMPLETE -- USE CONSOLE TO HALT SYSTEM
  1276.  
  1277.      iF you requested an automatic reboot, the system reboots, provided the
  1278.      necessary controls are set.
  1279.  
  1280. 13.  If you are not automatically rebooting, halt the system after the
  1281.      previous message is printed at the console terminal.
  1282.  
  1283. Example 2-1 demonstrates an orderly system shutdown on standalone node AVALON.
  1284.  
  1285. EXAMPLE 2-1:  ORDERLY SYSTEM SHUTDOWN W/ SHUTDOWN.COM
  1286. -----------------------------------------------------
  1287.  
  1288. $ @SYS$SYSTEM:SHUTODOWN
  1289.  
  1290.          SHUTDOWN -- Perform an Orderly System Shutdown
  1291.  
  1292. How many minutes until final shutdown [0]:  10
  1293. Reason for shutdown:  [Standalone]  MONTHLY PREVENTIVE MAINTENACNE.
  1294. Do you want to spin down the disk volumes [NO]? RETURN
  1295. Do you want to invoke the site-specific shutdown procedure [Yes]?  RETURN
  1296. Should an automatic system reboot be performed [NO]? RETURN
  1297. When will the system be rebooted [Later]? 12:30
  1298. Shutdown options:
  1299. REBOOT_CHECK     :  Check existence of basic system files
  1300.  
  1301. shutdown options [NONE]:  RETURN
  1302.  
  1303. SHUTDOWN message on AVALON, from user SYSTEM at _AVALON$OPA0:  12:00:00.20
  1304. AVALON will shut down in 10 minutes; back up 12:30. Please log off node AVALON.
  1305. MONTHLY PREVENTIVE MAINTENACE
  1306.  
  1307. %SHUTDOWN-I-OPERATOR, This terminal is now an operator's console.
  1308. %%%%%%%%%%% OPCOM, 16JUL1988 12:01:00.15 (NOTE THE TIME WILL BE ACUTAL TIME)
  1309. Operator status for operator _AVALON$OPA0:
  1310. CENTRAL, PRINTER, TAPES, DISKS, DEVICES, CARDS, NETWORK, OPER1, OPER2, OPER3,
  1311. OPER4, OPER5, OPER6, OPER7, OPER8, OPER9, OPER10, OPER11, OPER12
  1312.  
  1313. %SHUTDOWN-I-DISLOGINS, Interactive logins will now be disabled.
  1314. %SET-I-INTSET, login interactive limit = 0 current interactive value = 17
  1315. %SHUTDOWN-I-SHUTNET, the DECnet network will now be shut down.
  1316. %SHUTDOWN-I-STOPQUEMAN, The queue manager will now be stopped.
  1317.  
  1318. SHUTDOWN message on AVALON, from user SYSTEM at _AVALON$OPA0: 12:05:00.20
  1319. AVALON will shut down in 5 minutes; back up 12:30.  Please log off node AVALON.
  1320. MONTHLY PREVENTIVE MAINTENACE
  1321.  
  1322. 17 terminals have been notified on AVALON.
  1323.  
  1324. SHUTDOWN message on AVALON from user SYSTEM at _AVALON$OPA0:  12:06:55.28.
  1325. AVALON will shut down in 4 minutes; back up 12:30.  Please log off node AVALON.
  1326. MONTHLY PREVENTIVE MAINTENANCE
  1327.  
  1328. %%%%%%%% OPCOM, 16-Jul-1988 12:07:12:30  %%%%%%%%
  1329.  
  1330. Message from user DECnet on AVALON
  1331. DECnevt even 2.0, local node state change
  1332. From node 2.161 (AVALON), 16-Jul-1988 12:07:22.26
  1333. Operator command, old state = on, New state = Shut
  1334.  
  1335. SHUTDOWN message on AVALON from user SYSTEM at _AVALON$OPA0: 12:07:12:56
  1336. AVALON will shut down in 3 minutes; back up 12:30.  Please log off node AVALON.
  1337. MONTHLY PREVENTIVE MAINTENANCE
  1338.  
  1339. %SHUTDOWN-I-STOPQUEMAN, The queue manager will now be stopped.
  1340. SHUTDOWN message on AVALON user SYSTEM at _AVALON$OPA0: 12:08:12.56
  1341. AVALON will shut down in 2 minutes; back up 12:30.  Please log off node AVALON.
  1342. MONTHLY PREVENTIVE MAINTENANCE
  1343.  
  1344. %%%%%%%%% OPCOM, 16-JUL-1988 12:08:12:30 %%%%%%%%%%
  1345. Message from user JOB_CONTROL on AVALON
  1346. -SYSTEM-S-NORMAL, normal successful completion
  1347.  
  1348. %%%%%%%%% OPCOM, 16-JUL-1988 12:08:42:30
  1349. Message from user DECNET on AVALON
  1350. DECnet shutting down
  1351.  
  1352. SHUTDOWN message on AVALON from user SYSTEM at _AVALON$OPA0:  12:09:12.56
  1353. AVALON will shut down in 1 minute; back up 12:30.  Please log off node AVALON.
  1354. MONTHLY PREVENTIVE MAINTENANCE.
  1355.  
  1356. 17 terminals have been notified on AVALON
  1357. %SHUTDOWN-I-SITESHUT,  The site-specific shutdown procedure will now be
  1358. invoked.
  1359. %SHUTDOWN-I-STOPUSER, All user processes will now be stopped.
  1360. %SHUTDOWN-I-REMOVE, All installed images will now be removed.
  1361. %SHUTDOWN-I-DISMOUNT, All volumes will now be dismounted.
  1362. %%%%%%%%%% OPCOM, 16-JUL-1988 12:09:42.30
  1363. Message from user System on AVALON
  1364. _AVALON$OPA0:, AVALON shutdown requested by the operator.
  1365.  
  1366. %%%%%%%%%% OPCOM, 16-JUL-1988 12:10:02.44 %%%%%%%%%%%%%
  1367. Logfile was closed by operator _AVALON$OPA0:
  1368. Logfile was SYS$SYSROOT: [SYSMGR] OPERATOR.LOG;8
  1369.  
  1370. %%%%%%%%%% OPCOM, 16-JUL-1988 12:10:32.20
  1371. Operator _AVALON$OPA0: has been disabled, username SYSTEM
  1372.  
  1373.            SYSTEM SHUTDOWN COMPLETE -- USE CONSOLE TO HALT SYSTEM
  1374.  
  1375. ------------------------------------------------------------------
  1376.  
  1377. 2.10.1.2 DEFINING SHUTDOWN$INFORM_NODES
  1378.  
  1379. Before you execute SYS$SYSTEM:SHUTDOWN.COM, you can define the logical name
  1380. SHUTDOWN$INFORM_NODES to be a list of cluster member nodes.  The nodes listed
  1381. in SHUTDOWN$INFORM_NODES will be notified when the system is shutdown, as shown
  1382. in the following example:
  1383.  
  1384. $  DEFINE SHUTDOWN$INFORM_NODES "NODE1,NODE2,NODE3"
  1385. $   @SYS$SYSTEM:SHUTDOWN
  1386.  
  1387. If you define SHUTDOWN$INFORM_NODES and then execute SYS$SYSTEM:SHUTDOWN.COM,
  1388. all cluster member nodes included in the list are notified of the shutodwn.
  1389. Users on the node that is being shut down are always notified regardless of
  1390. whether you define SHUTDOWN$INFORM_NODES.  If you omit the name of the node
  1391. that is being shut down from the list specified in the DEFINE command, the name
  1392. is automatically added to the list by the SHUTDOWN.COM procedure.
  1393.  
  1394. 2.10.2  EMERGENCY SHUTDOWN W/ OPCCRASH
  1395.  
  1396.  
  1397.