z/VM: CP Commands and Utilities Reference - z/VM - IBM

LOGOFF
►►
LOGoff
LOGout
Authorization
Purpose
Operands
Usage Notes
HOld
Privilege Class: Any
Use LOGOFF or LOGOUT to end a virtual machine session.
LOGOFF
HOld
causes the non-SNA TTY terminal telecommunication connection to remain in
effect after your session is disconnected. If you specify the HOLD option from a
logical device, you log off from the logical device without losing the connection
between the logical device and the system.
1. When the LOGOFF command is entered from the virtual machine console as
the first or only command on a CP command line (that is, while TERMINAL
MODE is CP, or CP READ is displayed or the command line begins with #CP),
z/VM attempts to break out of certain wait conditions that might exist. Thus the
LOGOFF command may be entered to cause breakout of certain virtual
machine wait conditions.
The breakout attempt occurs when the LOGOFF command is entered, not when
the command is processed. Command errors do not prevent the breakout
attempt. In some cases, a breakout resets the virtual machine.
2. When you log off, all active spool files are closed, all virtual devices (including
temporary minidisks and virtual disks in storage) are detached (virtual disks in
storage are also destroyed if you are the last user), dedicated devices are
detached, all Concurrent Copy (CONCOPY) sessions on your virtual machine
are terminated, and an accounting record is created for your session.
3. The LOGOFF command performs a system-reset-clear function on your virtual
machine as if the SYSTEM CLEAR command had been processed. The effects
of this system-reset-clear function are described in detail in the description for
the SYSTEM CLEAR command.
4. Always log off your display in addition to turning off the power; turning off your
display is not the same as logging off.
If you turn off the power at your display without logging off, your virtual machine
is logged off at some installation–defined grace period (usually 15 minutes) after
the host system determines that your display has been turned off. If you again
turn on the display, your virtual machine is disconnected. You can reconnect the
display to your virtual machine by logging on within the grace period; if you do
not log on within the interval, your virtual machine is automatically logged off.
5. If you specify the HOLD option on an SNA/CCS terminal, the command is not
valid, and an error message is issued. If you specify the HOLD option on a
►◄
Chapter 2. CP Commands 575