Performing the Shutdown Process

A planned system shutdown typically consists of the steps listed below. Each of them is explained in the following sections.

Tell users well in advance of a planned shutdown via the welcome message
Send users a warning a few minutes before the shutdown
Prevent users from starting a new job or session
Prevent users from sending new reports to the printer and, optionally, clear the backlog of reports in the spool queue
Answer any pending device requests
Close any open communication lines
Issue the SHUTDOWN command

To tell users in advance of the shutdown

It's a good idea to include shutdown information in the welcome message so that users can plan accordingly. Remember to include information about the time of the shutdown and whom a user should contact if he or she has any questions.

You can create the welcome message either interactively with the WELCOME command or programmatically from a text file. Unless the WELCOME command is distributed to users through the ALLOW command, you can only create a new message at the console.

For example, to replace the current message with a new one interactively, do the following:

Erase the existing welcome message by entering:
WELCOME #Return
Create a new message by entering the WELCOME command again. When the pound sign prompt (#) appears, enter the message line by line, terminating each line with Return.
When you finish writing the message, enter Return at the # prompt.

To create a new welcome message programmatically, edit the welcome message text file (usually named WELCOME.PUB.SYS), then implement it with the following command:

   WELCOME filename

To warn users a few minutes before the shutdown

Approximately 15 minutes before the shutdown, use the TELL command to alert users. For example:

   TELL @S;Shutdown in 15 minutes.  Please log off.

This message reaches all active terminals except those in quiet mode. (A few minutes before the shutdown, you will issue a WARN command, which reaches all terminals, including those that are "quiet.")

To prevent new system activity

Use the LIMIT and JOBFENCE commands to prevent any new users from logging on or any scheduled jobs from starting.

To limit the number of concurrently running jobs and sessions, enter:
LIMIT 0,0
To raise the minimum input priority that a job or session must have to execute to the highest level, enter:
JOBFENCE 14

To clear the backlog of reports

To verify that the printer is available, to shut down spool queues, and begin removing backlogged reports, complete the following steps:

Verify that the printer is active by issuing either the SHOWDEV or SPOOLER command followed by the printer's LDEV number. For example, to check the activity of LDEV 21, enter:
SHOWDEV 21
Or:
SPOOLER 21;SHOW
Enter the SHUTQ command to prevent users from sending reports to the printer. For example, to shut the queue for LDEV 21, enter:
SHUTQ 21
Or, you can refer to the printer by its device name or device class. For example:
SHUTQ LJMFG
Or:
SHUTQ PRN
List the backlog of unprinted reports (spool files) by entering the SHOWOUT or LISTSPF commands. For example:
SHOWOUT JOB=@;SP
Or:
LISTSPF @
If the system responds NO SUCH FILE(S), you have no spool files.




	NOTE: Since output spool files are permanent files, they remain on the system when it is restarted.

To answer any pending requests

It is possible that an outstanding request from the system or a processing job may hang your system and keep it from shutting down cleanly. For this reason, you should find out if there are any requests that need a reply.

To display all pending requests, enter:

   RECALL

To answer pending requests, enter:

   REPLY pin#,reply

The pin# is the process identification number and reply is one of the following:

a logical device number
either "YES" or "NO"
a string expression consisting of nn characters or fewer

To close any open communication lines

Close any of the system's open communication lines. Enter both of the following commands to deactivate the NS3000/XL product:

   NSCONTROL STOP

   NETCONTROL STOP

Consult the manuals of any other communications products for instructions to deactivate them.

To shut down the system

To shut down the system, enter:

   CTRL A

   =SHUTDOWN

You may also enter any of the keywords listed below in the SHUTDOWN command to document the shutdown. They are intended to indicate why you are shutting down the system.

SYSTEM
NETWORK
DTC
TERMINAL
TAPE
DISC
OTHER

For example, if you shut down to clear a dtc hang, use the dtc option.

   CTRL A

   =SHUTDOWN DTC

The console responds by listing shutdown messages similar to these:

Shutdown of operating system begins. (Shut 1)

Shutdown of user processes begins (Shut 2)

Shutdown of jobs & sessions begins. (Shut 3)

Spoolers notified of a shutdown. (Shut 16)

Shutdown of system processes begins. (Shut 4)

Shutdown of system managers begins. (Shut 5)

Shutdown of operating system complete. (Shut 6)

Performing the Shutdown Process

Technical documentation

» Table of Contents

» Glossary

» Index