(c) Copyright IBM Corporation 1990, 2008
LOGOFF
>>--.-LOGoff-.--.------.----------------------------------------------------><
'-LOGout-' '-HOld-'
Authorization
Privilege Class: Any
Purpose
Use LOGOFF or LOGOUT to end a virtual machine session.
Operands
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.
Usage Notes
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 non-SNA TTY display terminal, or a logical terminal, it is
accepted and processed. The HOLD option is accepted but ignored on all
other terminals.
6. If your installation has coded the E3270HLD feature in the system real
I/O configuration file for your TTY display terminal connected to your
DACU control unit 7171, the telecommunication connection always remains
in effect, regardless of the HOLD option.
7. Users who are being logged off from the system will be given QUICKDSP
designation to expedite the logoff of the user.
Responses
Response 1:
CONNECT= hh:mm:ss VIRTCPU= mmm:ss.hs TOTCPU= mmm:ss.hs
LOGOFF AT hh:mm:ss zone weekday mm/dd/yy
CONNECT= hh:mm:ss
is the actual clock time in hours, minutes, and seconds spent in the
current session.
VIRTCPU= mmm:ss.hs
is the virtual processor time in minutes, seconds, and hundredths of
seconds used in the current session.
TOTCPU= mmm:ss.hs
is the total processor time in minutes, seconds, and hundredths of seconds
(including virtual and overhead) used in the current session.
These times are either the elapsed time for the entire session or the
elapsed time since the ACNT command was entered for this user.
LOGOFF AT hh:mm:ss
is the current time in hours, minutes, and seconds of your logoff.
zone
is the time zone.
weekday
is the current day of the week.
mm/dd/yy
is the date in month/day-of-month/year format.
The system also responds with one of the following, depending on the type of
terminal being used:
Type of Terminal Message
3270 family Press ENTER or CLEAR key to continue
SNA/CCS terminal Press ENTER key to continue
Pressing the appropriate key on your terminal causes the logo to appear on the
terminal, which readies the terminal for the next session. For terminals not
listed above, control automatically returns to CP, and the logo is displayed.
Response 2:
<type <rdev> > LOGOFF AS userid USERS = nnnnn
< <ldev> >
<luname >
<SYSC >
is the response sent to the primary system operator when you log off. If your
virtual machine was logged on using the AUTOLOG command, this response is sent
to both the primary system operator and the user who issued AUTOLOG.
type
is the user's display type.
rdev
ldev
is the real or logical device number of the user's display.
luname
identifies an SNA/CCS terminal controlled by a VTAM service machine. It is
the name from the VTAM definition of the terminal as an SNA logical unit.
SYSC
identifies the system console.
userid
identifies the user who is logging off.
USERS = nnnnn
is the number of users still on the system.
Response 3:
XSTORE DETACHED FROM userid
is the response sent to the primary system operator when Expanded Storage is
detached from a user who has just logged off (if the primary system operator
is not the one logging off).
Messages
HCP003E Invalid option - <option|command contains extra option(s) starting
with option>
HCP6061I APPC wait canceled; virtual machine has been reset.