Shutting Down the System

If both a Table of Contents and Search form are not displayed in separate frames along with this one, you may wish to redisplay this book in a frameset, beginning with the first page.

HP OpenVMS System Manager's Manual, Volume 1:...

Starting Up and Shutting Down the System

Writing a New Boot Block on the System Disk

Customizing the Operating System

Shutting Down the System

The operating system provides the following shutdown procedures:

Procedure Purpose For More Information

SHUTDOWN.COM
An orderly shutdown procedure. This procedure shuts down the system while performing housekeeping functions such as disabling future logins, stopping the batch and output queues, dismounting mounted volumes, and stopping user processes.
Performing an Orderly Shutdown with SHUTDOWN.COM

OPCCRASH.EXE
An emergency shutdown program. Run the OPCCRASH emergency shutdown program if you are unable to perform an orderly shutdown with SHUTDOWN.COM.
Performing an Emergency Shutdown with the OPCCRASH.EXE Program

Shutdown using console commands
Emergency shutdown commands. Use these console shutdown commands only if OPCCRASH.EXE fails.
Performing an Emergency Shutdown Using Console Commands

Procedure	Purpose	For More Information
SHUTDOWN.COM	An orderly shutdown procedure. This procedure shuts down the system while performing housekeeping functions such as disabling future logins, stopping the batch and output queues, dismounting mounted volumes, and stopping user processes.	Performing an Orderly Shutdown with SHUTDOWN.COM
OPCCRASH.EXE	An emergency shutdown program. Run the OPCCRASH emergency shutdown program if you are unable to perform an orderly shutdown with SHUTDOWN.COM.	Performing an Emergency Shutdown with the OPCCRASH.EXE Program
Shutdown using console commands	Emergency shutdown commands. Use these console shutdown commands only if OPCCRASH.EXE fails.	Performing an Emergency Shutdown Using Console Commands

Performing an Orderly Shutdown with SHUTDOWN.COM

Use SYS$SYSTEM:SHUTDOWN.COM to shut down the system in an orderly fashion. See Understanding the Order of Shutdown Events for the order of shutdown events.

Do not modify SHUTDOWN.COM. To perform site-specific operations during shutdown, see Customizing SHUTDOWN.COM to Perform Site-Specific Operations.

Ordinarily, you shut down the system from the SYSTEM account, which includes all privileges by default. To execute SHUTDOWN.COM, you must have either the SETPRV privilege or all of the following privileges:

AUDIT

CMKRNL

EXQUOTA

LOG_IO

NETMBX

OPER

SECURITY

SYSNAM

SYSPRV

TMPMBX

WORLD

You can cancel a shutdown without any side effects by pressing Ctrl/Y before SHUTDOWN.COM displays the following message:

%SHUTDOWN-I-SITESHUT, The site-specific shutdown procedure will now be invoked.

If you press Ctrl/Y after this display, certain system components might have already been shut down, and you will need to recover manually. For example, you might have to manually restart processes, mount disks, or reboot the system.

How to Perform This Task

Log in to the system manager's account (SYSTEM), or any privileged account, and enter the following command:
```
$ @SYS$SYSTEM:SHUTDOWN.COM
```
This command invokes the orderly shutdown procedure. The procedure prompts you with a series of questions and messages. The default responses appear in brackets at the end of each question. Press Return to select the default response.

The system displays the following question:

How many minutes until final shutdown [0]?

Enter an integer. If you have defined the system logical name SHUTDOWN$MINIMUM_MINUTES, its integer value is the minimum value that you can enter. For example, if the logical name is defined as 10, you must specify at least 10 minutes to final shutdown or an error message is returned. If you do not enter a value, SHUTDOWN.COM uses the logical name value.

The default is 0 minutes. If you have not defined the logical name SHUTDOWN$MINIMUM_MINUTES, and you do not enter a value, the system will be shut down immediately after you answer the last question.

The system displays the following question:
```
Reason for shutdown [standalone]:
```
Enter a one-line reason for shutting down the system. For example, "Monthly preventive maintenance."

The system displays the following question:
```
Do you want to spin down the disk volumes [No]?
```
Enter YES or NO (Y or N). Note, however, that you cannot spin down the system disk. Also, many disks, particularly SCSI disks, do not spin down in response to this option.

The system displays the following question:
```
Do you want to invoke the site-specific shutdown procedure [Yes]?
```
If you have entered site-specific commands in SYSHUTDWN.COM, press Return to accept the default answer, YES. For more information, see Modifying the Site-Specific Shutdown Command Procedure.

The system displays the following question:
```
Should an automatic system reboot be performed [No]?
```
By default, the system does not automatically reboot. However, if you respond YES, the system attempts to reboot automatically when the shutdown is complete. For example, you would specify YES if you are rebooting the system after modifying values for nondynamic system parameters with SYSMAN or SYSGEN. (When you change nondynamic system parameters, you must reboot the system for the new values to take effect.)

The system displays a question similar to the following one:
```
When will the system be rebooted [later]?
```
If you entered YES in step 6, the default answer to this question is "[shortly via automatic reboot]".

Press Return to take the default, or enter the expected reboot time in the format you want users to see. For example, you could specify IMMEDIATELY, or IN 10 MINUTES, or a time such as 2 P.M. or 14:00. If you do not know when the system will be available again, press Return to specify "later" as the time when the system will reboot.

The procedure prompts you to specify one or more shutdown options, as follows (if your system is not a member of an OpenVMS Cluster environment, the procedure lists only the REBOOT_CHECK and SAVE_FEEDBACK options):

Shutdown options (enter as a comma-separated list):
 REMOVE_NODE         Remaining nodes in the cluster should adjust quorum
 CLUSTER_SHUTDOWN    Entire cluster is shutting down
 REBOOT_CHECK        Check existence of basic system files
 SAVE_FEEDBACK       Save AUTOGEN feedback information from this boot
 DISABLE_AUTOSTART   Disable autostart queues
Shutdown options [NONE]

Specify the options you want to use. Choose from the options in the following table:

Option Description

REMOVE_NODE
Causes other nodes in the cluster to decrease the value of the EXPECTED_VOTES system parameter. (This parameter is automatically increased each time a node joins the cluster.) Specifying REMOVE_NODE will not decrease the EXPECTED_VOTES below the quorum value.

Use this option if the node you are shutting down will be out of the cluster a considerable period of time.

When you use this option, all locally attached disks are dismounted clusterwide. Therefore, you must shut down applications on other nodes that have open files on the locally attached disks. Failure to do so might cause mount verify timeout problems as well as application problems.

CLUSTER_SHUTDOWN
Synchronizes the shutdown of a cluster; only when the shutdown of each node has progressed to a certain point will the shutdown be completed.

Use this option on each node in the cluster to synchronize the shutdown.

REBOOT_CHECK
Verifies the presence of files necessary to reboot the system after shutdown completes.

The procedure checks for the necessary files and notifies you if any are missing. Replace missing files before proceeding.

SAVE_FEEDBACK
Records feedback data collected from the system since it was last booted and creates a new version of the AUTOGEN feedback data file, which AUTOGEN can use the next time it runs.

For detailed information about using the AUTOGEN feedback mechanism, see HP OpenVMS System Manager's Manual, Volume 2: Tuning, Monitoring, and Complex Systems.

DISABLE_AUTOSTART
Specifies the time interval between the DISABLE AUTOSTART/QUEUES command and system shutdown. For more information, see Stopping Queues Before Shutting Down a System.

Option	Description
REMOVE_NODE	Causes other nodes in the cluster to decrease the value of the EXPECTED_VOTES system parameter. (This parameter is automatically increased each time a node joins the cluster.) Specifying REMOVE_NODE will not decrease the EXPECTED_VOTES below the quorum value. Use this option if the node you are shutting down will be out of the cluster a considerable period of time. When you use this option, all locally attached disks are dismounted clusterwide. Therefore, you must shut down applications on other nodes that have open files on the locally attached disks. Failure to do so might cause mount verify timeout problems as well as application problems.
CLUSTER_SHUTDOWN	Synchronizes the shutdown of a cluster; only when the shutdown of each node has progressed to a certain point will the shutdown be completed. Use this option on each node in the cluster to synchronize the shutdown.
REBOOT_CHECK	Verifies the presence of files necessary to reboot the system after shutdown completes. The procedure checks for the necessary files and notifies you if any are missing. Replace missing files before proceeding.
SAVE_FEEDBACK	Records feedback data collected from the system since it was last booted and creates a new version of the AUTOGEN feedback data file, which AUTOGEN can use the next time it runs. For detailed information about using the AUTOGEN feedback mechanism, see HP OpenVMS System Manager's Manual, Volume 2: Tuning, Monitoring, and Complex Systems.
DISABLE_AUTOSTART	Specifies the time interval between the DISABLE AUTOSTART/QUEUES command and system shutdown. For more information, see Stopping Queues Before Shutting Down a System.

Example

$ @SYS$SYSTEM:SHUTDOWN


         SHUTDOWN -- Perform an Orderly System Shutdown
How many minutes until final shutdown [0]: 10
Reason for shutdown: [Standalone] MONTHLY PREVENTIVE MAINTENANCE
Do you want to spin down the disk volumes [No]? [Return] 
Do you want to invoke the site-specific shutdown procedure [Yes]? [Return] 
Should an automatic system reboot be performed [No]? [Return] 
When will the system be rebooted [later]? 12:30
Shutdown options (enter as a comma-separated list):
 REMOVE_NODE         Remaining nodes in the cluster should adjust quorum
 CLUSTER_SHUTDOWN    Entire cluster is shutting down
 REBOOT_CHECK        Check existence of basic system files
 SAVE_FEEDBACK       Save AUTOGEN feedback information from this boot
 DISABLE_AUTOSTART   Disable autostart queues
Shutdown options [NONE] [Return] 

SHUTDOWN message on AVALON, from user SYSTEM at _AVALON$OPA0:   12:00:00.20
AVALON will shut down in 10 minutes; back up 12:30. Please log off node AVALON.
MONTHLY PREVENTIVE MAINTENANCE

%SHUTDOWN-I-OPERATOR, This terminal is now an operator's console.
%%%%%%%%%%%  OPCOM, 16-MAY-2000 12:01:00.15  %%%%%%%%%%%
Operator status for operator _AVALON$OPA0:
CENTRAL, PRINTER, TAPES, DISKS, DEVICES, CARDS, NETWORK, OPER1, OPER2,
OPER3, OPER4, OPER5, OPER6, OPER7, OPER8, OPER9, OPER10, OPER11,
OPER12

%SHUTDOWN-I-DISLOGINS, Interactive logins will now be disabled.
%SET-I-INTSET, login interactive limit = 0 current interactive value = 17
%SHUTDOWN-I-SHUTNET, The DECnet network will now be shut down.


SHUTDOWN message on AVALON, from user SYSTEM at _AVALON$OPA0:   12:05:00.20
AVALON will shut down in 5 minutes; back up 12:30. Please log off node AVALON.
MONTHLY PREVENTIVE MAINTENANCE

17 terminals have been notified on AVALON.

SHUTDOWN message on AVALON from user SYSTEM at _AVALON$OPA0:   12:06:55.28
AVALON will shut down in 3 minutes; back up 12:30. Please log off node AVALON.
MONTHLY PREVENTIVE MAINTENANCE

%%%%%%%%%%%  OPCOM, 16-MAY-2000 12:07:12.30  %%%%%%%%%%%
Message from user DECnet on AVALON
DECnet event 2.0, local node state change
From node 2.161 (AVALON), 16-MAY-2000 12:07:22.26
Operator command, Old state = On, New state = Shut
SHUTDOWN message on AVALON user SYSTEM at _AVALON$OPA0:   12:08:12.56
AVALON will shut down in 2 minutes; back up 12:30. Please log off node AVALON.
MONTHLY PREVENTIVE MAINTENANCE

%%%%%%%%%%%  OPCOM, 16-MAY-2000 12:08:12:30  %%%%%%%%%%%
Message from user SYSTEM on AVALON
-SYSTEM-S-NORMAL, normal successful completion

%%%%%%%%%%%  OPCOM, 16-MAY-2000 12:08:42.30  %%%%%%%%%%%
Message from user DECNET on AVALON
DECnet shutting down

%SYSTEM-I-STOPQUEUES, The queues on this node will now be stopped.
SHUTDOWN message on AVALON from user SYSTEM at _AVALON$OPA0:   12:09:12.56
AVALON will shut down in 1 minute; back up 12:30. Please log off node AVALON.
MONTHLY PREVENTIVE MAINTENANCE

SHUTDOWN message on AVALON, from user SYSTEM at _AVALON$OPA0:   12:10:00.20
AVALON will shut down in 0 minutes; back up 12:30. Please log off node AVALON.
MONTHLY PREVENTIVE MAINTENANCE

17 terminals have been notified on AVALON
%SHUTDOWN-I-SITESHUT, The site-specific shutdown procedure will now be invoked.
%SHUTDOWN-I-STOPUSER, All user processes will now be stopped.
%SHUTDOWN-I-REMOVE, All installed images will now be removed.
%SHUTDOWN-I-DISMOUNT, All volumes will now be dismounted.
%%%%%%%%%%%  OPCOM, 16-MAY-2000 12:09:42.30  %%%%%%%%%%%
Message from user System on AVALON
_AVALON$OPA0:, AVALON shutdown was requested by the operator.

%%%%%%%%%%%  OPCOM, 16-MAY-2000 12:10:02.44  %%%%%%%%%%%
Logfile was closed by operator _AVALON$OPA0:
Logfile was SYS$SYSROOT:[SYSMGR]OPERATOR.LOG;8

%%%%%%%%%%%  OPCOM, 16-MAY-2000 12:10:32.20  %%%%%%%%%%%
Operator _AVALON$OPA0: has been disabled, username SYSTEM

        SYSTEM SHUTDOWN COMPLETE

On VAX systems, the following message is also displayed:

USE CONSOLE TO HALT SYSTEM

Halt the system after you see this message.

Understanding the Order of Shutdown Events

The following events occur as the shutdown proceeds. The procedure displays the corresponding messages on the terminal.

At decreasing time intervals, SHUTDOWN.COM broadcasts, to all users on the system, a message requesting users to log out.

SHUTDOWN.COM defines the system logical name SHUTDOWN$TIME to be the absolute time of shutdown. For example, if you execute SHUTDOWN.COM, and at 12:00 you specify the value 10 in response to the first question, SHUTDOWN defines the logical name to be 12:10 on that day. To see if a shutdown is in progress or to determine the actual time of shutdown, you can enter the command SHOW LOGICAL SHUTDOWN$TIME. This feature is useful if you miss a shutdown broadcast message.

At 6 minutes or less before system shutdown, the terminal from which you invoked SHUTDOWN becomes an operator's console. SHUTDOWN disables all future nonoperator logins and shuts down the DECnet network if it is running. At this point, users logged in to the system with the SET HOST command lose their sessions.

One minute before shutdown, SHUTDOWN.COM stops batch and output execution queues and stops the queue manager.

At the absolute time of shutdown, SHUTDOWN.COM invokes the site-specific shutdown command procedure SYS$MANAGER:SYSHUTDWN.COM, if you requested it.

SHUTDOWN.COM stops all remaining user processes; however, system processes continue. Ancillary control processes (ACPs) might delete themselves when their mounted volumes are finally dismounted.

On multiprocessor systems, SHUTDOWN.COM stops the secondary processors.

SHUTDOWN.COM removes all installed images.

SHUTDOWN.COM dismounts all mounted volumes and, if you requested it, spins down the disks. If you defined SHUTDOWN$VERBOSE, the procedure lists each disk as it is dismounted.

The procedure does not spin down the system disk, nor does it dismount or spin down the quorum disk (if one exists on your system).

SHUTDOWN.COM closes the operator log file.

SHUTDOWN.COM runs the program SYS$SYSTEM:OPCCRASH.EXE to shut down the system.

If you requested an automatic reboot, the system reboots, provided you set the necessary controls. You requested an automatic reboot if you answered YES to the following question:
```
Should an automatic system reboot be performed [No]?
```
If you did not request an automatic reboot, a message similar to the following one appears on the system console:
```
SYSTEM SHUTDOWN COMPLETE 
```
On VAX systems, the following message is also displayed:
```
USE CONSOLE TO HALT SYSTEM  
```
Halt the system after you see this message.

Customizing SHUTDOWN.COM to Perform Site-Specific Operations

In addition to choosing shutdown options when you execute SHUTDOWN.COM, you can customize SHUTDOWN.COM to meet the needs of your site in the following ways.

Method For More Information

Defining logical names
Defining Logical Names

Modifying the site-specific shutdown command procedure
Modifying the Site-Specific Shutdown Command Procedure

Method	For More Information
Defining logical names	Defining Logical Names
Modifying the site-specific shutdown command procedure	Modifying the Site-Specific Shutdown Command Procedure

Defining Logical Names

Before executing SHUTDOWN.COM, you can define the following logical names to control the operations of the command procedure:

Logical Name Description

SHUTDOWN$DECNET_MINUTES
Defines the number of minutes remaining before DECnet is shut down; must be defined with the /SYSTEM qualifier. The default is 6 minutes.

SHUTDOWN$DISABLE_AUTOSTART
Specifies the number of minutes between the time autostart is disabled for queues and the time the system is shut down; must be defined with the /SYSTEM qualifier. For more information, see Stopping Queues Before Shutting Down a System.

SHUTDOWN$INFORM_NODES
Specifies a list of OpenVMS Cluster nodes to be notified when the system is shutting down. This logical name is described in detail in this section.

SHUTDOWN$MINIMUM_MINUTES
Defines the minimum number of minutes you can specify as number of minutes to shutdown. For example, if your users require 30 minutes' notice before a system shutdown, define this logical name to be 30. This logical must be defined with the /SYSTEM qualifier.

SHUTDOWN$QUEUE_MINUTES
Defines the number of minutes remaining before shutdown when queues are shut down; must be defined with the /SYSTEM qualifier. The default is 1 minute.

SHUTDOWN$TIME
Defines the absolute time of the shutdown; must be defined with the /SYSTEM qualifier.

SHUTDOWN$VERBOSE
If defined to any string, specifies that the shutdown command procedure is to list each disk as it is dismounted.

Logical Name	Description
SHUTDOWN$DECNET_MINUTES	Defines the number of minutes remaining before DECnet is shut down; must be defined with the /SYSTEM qualifier. The default is 6 minutes.
SHUTDOWN$DISABLE_AUTOSTART	Specifies the number of minutes between the time autostart is disabled for queues and the time the system is shut down; must be defined with the /SYSTEM qualifier. For more information, see Stopping Queues Before Shutting Down a System.
SHUTDOWN$INFORM_NODES	Specifies a list of OpenVMS Cluster nodes to be notified when the system is shutting down. This logical name is described in detail in this section.
SHUTDOWN$MINIMUM_MINUTES	Defines the minimum number of minutes you can specify as number of minutes to shutdown. For example, if your users require 30 minutes' notice before a system shutdown, define this logical name to be 30. This logical must be defined with the /SYSTEM qualifier.
SHUTDOWN$QUEUE_MINUTES	Defines the number of minutes remaining before shutdown when queues are shut down; must be defined with the /SYSTEM qualifier. The default is 1 minute.
SHUTDOWN$TIME	Defines the absolute time of the shutdown; must be defined with the /SYSTEM qualifier.
SHUTDOWN$VERBOSE	If defined to any string, specifies that the shutdown command procedure is to list each disk as it is dismounted.

If you plan to use an option every time you use SHUTDOWN.COM, define the logical name in the site-specific startup command procedure SYLOGICALS.COM. For more information, see Modifying SYLOGICALS.COM to Define Systemwide Logical Names.

Specifying a List of Nodes to Be Notified When the System Is Shutting Down

You can define the logical name SHUTDOWN$INFORM_NODES to be a list of OpenVMS Cluster nodes that are notified when the system is shut down. You must define SHUTDOWN$INFORM_NODES before executing SYS$SYSTEM:SHUTDOWN.COM.

To define SHUTDOWN$INFORM_NODES, enter a command in the following format:DEFINE SHUTDOWN$INFORM_NODES "node-list"

where node-list specifies the list of nodes to be informed. For example:

$ DEFINE SHUTDOWN$INFORM_NODES "NODE1,NODE2,NODE3"

If you plan to inform the same nodes every time you shut down the system, add the command to the site-specific startup command procedure SYLOGICALS.COM. For more information, see Modifying SYLOGICALS.COM to Define Systemwide Logical Names.

If you define SHUTDOWN$INFORM_NODES, all member nodes included in the list are notified when you execute SHUTDOWN.COM. Users on the node that is being shut down are always notified, regardless of whether you define SHUTDOWN$INFORM_NODES. If you omit the name of the node that is being shut down from the list specified in the DEFINE command, SHUTDOWN.COM automatically adds the name to the list.

The information in Node Notification During Shutdown indicates which nodes are notified at different phases of the shutdown sequence, depending on whether SHUTDOWN$INFORM_NODES is defined.

Table 3 Node Notification During Shutdown
Shutdown Phase If SHUTDOWN$INFORM_NODES Is Not Defined If SHUTDOWN$INFORM_NODES Is Defined

First shutdown notification
Notify all terminals on all nodes
Notify all terminals on all listed nodes

Between first shutdown notification and 2 minutes before final shutdown
Notify all terminals logged in to the node that is shutting down
Notify all users logged in on all listed nodes

Between 2 minutes before final shutdown notification until final shutdown
Notify all users logged in on all nodes
Notify all users logged in on all listed nodes

Shutdown canceled
Notify all terminals on all nodes
Notify all terminals on all listed nodes

**Table 3** **Node Notification During Shutdown**
Shutdown Phase	If SHUTDOWN$INFORM_NODES Is Not Defined	If SHUTDOWN$INFORM_NODES Is Defined
First shutdown notification	Notify all terminals on all nodes	Notify all terminals on all listed nodes
Between first shutdown notification and 2 minutes before final shutdown	Notify all terminals logged in to the node that is shutting down	Notify all users logged in on all listed nodes
Between 2 minutes before final shutdown notification until final shutdown	Notify all users logged in on all nodes	Notify all users logged in on all listed nodes
Shutdown canceled	Notify all terminals on all nodes	Notify all terminals on all listed nodes

Modifying the Site-Specific Shutdown Command Procedure

You can add site-specific commands to the site-specific shutdown procedure SYS$MANAGER:SYSHUTDWN.COM. An empty SYSHUTDWN.COM file is included in your distribution kit.

SHUTDOWN.COM prompts you to indicate if you want to execute the site-specific procedure SYSHUTDWN.COM:

Do you want to invoke the site-specific shutdown procedure [Yes]?

Press Return to accept the default answer YES.

Dismounting Shadow Sets in Site-Specific Shutdown Procedures

The default SHUTDOWN.COM procedure that ships with the operating system performs a DISMOUNT/ABORT/OVERRIDE=CHECKS operation on all mounted volumes. If files are left open on any mounted shadow sets, a merge operation is required for these shadow sets when the system is rebooted.

To prevent such unnuecessary merge operations, HP recommends that you modify each site-specific SYSHUTDWN.COM command procedure to dismount the shadow sets without using the /ABORT/OVERRIDE=CHECKS command qualifiers. If you find open files, close them.

Performing an Orderly Shutdown with SYSMAN

The advantage of using the System Management Utility (SYSMAN) for shutdown is that you can shut down a group of nodes quickly. SYSMAN enables you to enter all of the shutdown parameters in one command line, rather than responding to the interactive dialog in SHUTDOWN.COM. SYSMAN does not wait for the nodes to shut down before you can use other SYSMAN commands; the interface returns immediately.

How to Perform This Task

Enter the following command at the DCL prompt ($):
```
$ RUN SYS$SYSTEM:SYSMAN
```

At the SYSMAN> prompt, enter the following command:
```
SYSMAN> SHUTDOWN NODE/[qualifier]
```

Qualifiers can be any of the following options:

Qualifier Function

MINUTES_TO_SHUTDOWN
Indicates the number of minutes until shutdown occurs.

REASON
Indicates the reason for the shutdown.

REBOOT_TIME
Indicates the time you expect to reboot the system, such as LATER, 2 P.M., or 14:00. This time is displayed in the shutdown message to users.

[NO]SPIN_DOWN_DISKS
Spins down disks. The default is NO. You cannot spin down the system disk.

[NO]INVOKE_SYSHUTDOWN
Invokes the site-specific shutdown procedure. The default is INVOKE_SYSHUTDOWN.

[NO]AUTOMATIC_REBOOT
Reboots the system automatically when the shutdown is complete. The default is NO.

[NO]REBOOT_CHECK
Checks for basic operating system files and notifies you if any are missing. The default is NO.

[NO]CLUSTER_SHUTDOWN
Shuts down the entire OpenVMS Cluster system. The default is NO.

[NO]REMOVE_NODE
Removes the node from the active cluster quorum; use this when you do not expect the shut-down node to rejoin the cluster for an extended period. The default is NO.

When you use this option, all locally attached disks are dismounted clusterwide. Therefore, you must shut down applications on other nodes that have open files on the locally attached disks. Failure to do so might cause mount verify timeout problems as well as application problems.

[NO]SAVE_FEEDBACK
Records feedback data from the system since it was last booted and creates a new version of the AUTOGEN feedback data file, which you can use the next time you run AUTOGEN. The default is NO.

Qualifier	Function
MINUTES_TO_SHUTDOWN	Indicates the number of minutes until shutdown occurs.
REASON	Indicates the reason for the shutdown.
REBOOT_TIME	Indicates the time you expect to reboot the system, such as LATER, 2 P.M., or 14:00. This time is displayed in the shutdown message to users.
[NO]SPIN_DOWN_DISKS	Spins down disks. The default is NO. You cannot spin down the system disk.
[NO]INVOKE_SYSHUTDOWN	Invokes the site-specific shutdown procedure. The default is INVOKE_SYSHUTDOWN.
[NO]AUTOMATIC_REBOOT	Reboots the system automatically when the shutdown is complete. The default is NO.
[NO]REBOOT_CHECK	Checks for basic operating system files and notifies you if any are missing. The default is NO.
[NO]CLUSTER_SHUTDOWN	Shuts down the entire OpenVMS Cluster system. The default is NO.
[NO]REMOVE_NODE	Removes the node from the active cluster quorum; use this when you do not expect the shut-down node to rejoin the cluster for an extended period. The default is NO. When you use this option, all locally attached disks are dismounted clusterwide. Therefore, you must shut down applications on other nodes that have open files on the locally attached disks. Failure to do so might cause mount verify timeout problems as well as application problems.
[NO]SAVE_FEEDBACK	Records feedback data from the system since it was last booted and creates a new version of the AUTOGEN feedback data file, which you can use the next time you run AUTOGEN. The default is NO.

Example

$ RUN SYS$SYSTEM:SYSMAN
SYSMAN> SHUTDOWN NODE/MINUTES_TO_SHUTDOWN=10/REBOOT_TIME="later" -
_SYSMAN> /REASON="DISK CORRUPTION PROBLEMS"/REBOOT_CHECK/SAVE_FEEDBACK

If you enter this command example on NODE21, it requests a shutdown on NODE21 with:

A message to users on all the cluster nodes, specifying:

SHUTDOWN message on node NODE21, from user SYSTEM at _NODE21$0PA0: 
12:00:00:20. NODE21 will shut down in 10 minutes; back up later. 
Please log off node NODE21. DISK CORRUPTION PROBLEMS

A check for any missing operating system files and notification any are missing

Creation of a new AUTOGEN feedback data file based on the feedback data collected since the system was last booted

For more information, refer to the HP OpenVMS System Management Utilities Reference Manual .

Performing an Emergency Shutdown with the OPCCRASH.EXE Program

Ordinarily, you shut down the system using the orderly shutdown procedure SHUTDOWN.COM. After SHUTDOWN.COM performs orderly housekeeping tasks, it invokes the program SYS$SYSTEM:OPCCRASH.EXE to shut down the system. OPCCRASH.EXE performs only the following minimal housekeeping functions:

Writes the modified page list back to disk. This ensures that all writable section files are updated to their correct state before the system crashes and all in-memory data is lost.

Unless the logical name OPC$NODUMP is defined, creates a crash dump by writing physical memory to the system dump file. For more information about the system dump file, see HP OpenVMS System Manager's Manual, Volume 2: Tuning, Monitoring, and Complex Systems.

In an emergency, if you cannot invoke SHUTDOWN.COM, you can run the OPCCRASH.EXE program to shut down your system immediately without performing any of the housekeeping functions that ensure an orderly shutdown.

Run the OPCCRASH.EXE program directly only if SHUTDOWN.COM fails.

How to Perform This Task

To run the OPCCRASH.EXE program directly, you must have the CMKRNL privilege. You can enter the commands from any terminal and any privileged account. Follow these steps:

Enter the following command:
```
$ RUN SYS$SYSTEM:OPCCRASH
```

If the system fails to respond after a few minutes, use the CRASH procedure or, if your system does not have a CRASH procedure, enter the emergency shutdown commands described in one of the following manuals:
- On VAX systems, refer to the most recent versions of the OpenVMS VAX Upgrade and Installation Manual and the upgrade and installation supplement for your VAX computer.
- On Alpha systems, refer to the HP OpenVMS Alpha Version 7.3-2 Upgrade and Installation Manual.

A message similar to the following one is displayed at the console:
```
SYSTEM SHUTDOWN COMPLETE 
```
On VAX systems, the following message is also displayed:
```
USE CONSOLE TO HALT SYSTEM 
```
Halt the system when you see this message.

Example

The following example runs the OPCCRASH program to force a system crash, and halts the system:

$ RUN SYS$SYSTEM:OPCCRASH
 
         SYSTEM SHUTDOWN COMPLETE
 
[Ctrl/P] 
>>>HALT
 
     HALTED AT 8000708A

On VAX systems, the following message is also displayed:

USE CONSOLE TO HALT SYSTEM

Halt the system when you see this message.

Performing an Emergency Shutdown Using Console Commands

Certain computer consoles have an additional emergency CRASH command. If your computer has the CRASH command, it is located on the console media; you can execute it only from the console prompt on the console terminal. For example:

P00>>> CRASH

If the CRASH command does not exist on your console, you can shut down the system manually from the console.

Use CRASH commands from the console only if the OPCCRASH.EXE program fails.

On VAX systems, enter the following commands:

P00>>> D PSL 041F0000
P00>>> D PC FFFFFFFF
P00>>> CON

On Alpha systems, enter the following commands:

P00>>> D PS 1F00
P00>>> D PC FFFFFFFFFFFFFF00
P00>>> CON

See one of the following manuals for a description of the CRASH command or for equivalent commands to use to force an abrupt emergency shutdown:

On VAX systems, see the most recent versions of the OpenVMS VAX Upgrade and Installation Manual and the upgrade and installation supplement for your VAX computer.

On Alpha systems, see the HP OpenVMS Alpha Version 7.3-2 Upgrade and Installation Manual.

Writing a New Boot Block on the System Disk

Customizing the Operating System