Performing the Shutdown Process [ Performing System Management Tasks ] MPE/iX 5.0 Documentation
Performing System Management Tasks
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:
1. Erase the existing welcome message by entering:
WELCOME
#Return
2. 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.
3. 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.
1. To limit the number of concurrently running jobs and sessions,
enter:
LIMIT 0,0
2. 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:
1. 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
2. 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
3. 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)
MPE/iX 5.0 Documentation