tcl.power-off Verb: Access/TCL

tcl.power-off

Command tcl.power-off Verb: Access/TCL
Applicable release versions: AP, R83
Category TCL (746)
Description brings the system to an "orderly shutdown" by logging off all users, flushing memory to disk, and parking the disk heads prior to halting the system.

This is used prior to system shutdown to ensure that all work spaces are returned to overflow and all updated frames in memory are written to disk. "power-off" puts the machine in a HALT state.

The status of the Spooler is displayed and an option to continue is offered . If "y" is entered to continue, any user still logged on is logged off, all process work spaces are released, all printers are stopped, and all updated memory frames are written to disk. The system is shut down.

If the "u" option is not specified and any port, other than the port executing "power-off", is logged on, the system prompts for each port to be logged off.

If the port is not logged off by the time the "power-off" reaches its final phase, the port is automatically logged off.
Syntax power-off {(u}
Options u Unconditionally logs all ports off.
Example
power-off
Test the logon state of each line...

If any ports are still active, the following message appears:

Line 1 is logged on as lw ts
Do you want to log it off (y/n)?

If the response to the question is "n", the following message appears 
and the process stops, and returns to TCL:

Shutdown procedure aborted.

If the response to the question is "y", it attempts to log the port 
off and the following message appears:

[534] logoff successful.

This question is repeated for all ports which are still active.

After all ports are logged off, the following messages appear:

Detaching tape...
Spooler status:

  The spooler is inactive.

Do you wish to continue (y/n)?

If the response to the question is "n", the following message appears 
and the process stops, and returns to TCL:

Shutdown procedure aborted.

If the response to the question is "y", the following messages appear:

Terminating all print jobs.
Wrapping up process on line 1.
Wrapping up process on line 2.

After all the lines are "wrapped up", the following message appears:

Pause for wrapup processing to complete...

Flushing memory, boot when disk is quiescent...

After the disk settles down, the following message appears:

Flush complete.
Purpose
Related tcl.:shutdown
tcl.pick
tcl.fdisk
tcl.reboot
tcl.halt-system
tcl.which-line
tcl.logoff
dos.pick
dos.pickstop
hung.port
tcl.exit
TCL.SHUTDOWN