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

FORCE
Usage Notes
Responses
1. FORCE may not be able to cause the logoff of a hung-up user, nor of a user
with I/O outstanding, because either of these conditions may prevent completion
of the LOGOFF function. As an alternative, the DISCONNECT option may be
used to disassociate the user ID from its terminal, thus freeing up the device.
2. If the user’s virtual machine is hung waiting for a device which is not operational
or the system operator can determine the I/O device involved and either make
that device ready or enter a HALT command; this allows the user to continue
operation or be forced from the system. (Use QUERY to determine the status of
all or selected devices) For more information see the description of the HALT
command.
3. The disconnect performed by the FORCE command may take significant time to
complete because of the attempt made to process the disconnect even in the
case of a hung terminal.
4. If a user is force disconnected while a read is posted from the user’s virtual
machine or from CP, and that user does not have a logged on secondary user,
the user then has some installation-defined grace period (usually 15 minutes) in
which to log on or else his virtual machine is automatically logged off.
5. Users who are being forced from the system will be given QUICKDSP
designation to expedite the logoff of the user.
6. If the user who is being forced from the system has an open RDR file and the
user’s virtual reader is spooled NOHOLD and NOKEEP, the open file will be
retained on the user’s RDR queue in USER hold status.
7. If none of the WITHIN, BY, and IMMEDIATE options are specified, and if the
default signal timeout interval is set, it is used to delay the FORCE and give the
guest system an opportunity to terminate. Refer to “SET SIGNAL” on page 1388
for additional information about this behavior.
Response 1:
{LOGOFF } AT hh:mm:ss zone weekday mm/dd/yy {DISCONNECT} {userid}
In addition, if logoff has been selected, then this response will accompany the
normal accounting message produced at logoff.
LOGOFF
DISCONNECT
indicates whether the virtual machine was logged off or disconnected.
hh:mm:ss
identifies the current time in hours:minutes:seconds.
zone
identifies the time zone.
442 z/VM: CP Commands and Utilities Reference
weekday
identifies the current day of the week.
mm/dd/yy
identifies the current date in month/day-of-month/year format.
SYSTEM
userid
indicates who forced the logoff or disconnect your virtual machine. If you were
forced by another user, and not the system, that user’s userid appears in the
message.