tcl.logoff Verb: Access/TCL

tcl.logoff

Command tcl.logoff Verb: Access/TCL
Applicable release versions: AP, R83
Category TCL (746)
Description terminates a process on a given port and sends the port to the "logon" prompt.

If the "port.number" is not specified, it is requested.

The options to this verb have been removed and logoff has been made more robust in AP (release 5.2). The logoff process first attempts a "normal" logoff by simulating a "<break>" and "off" sequence on the target port. If that time out, logoff escalates and "forces the process into the debugger and simulates an "off". If THAT fails, the target port is reinitialized, without attempting to clean up or recover its workspace.

"phantom" ports, the scheduler, the transaction loger and those nasty "hung" ports may now be properly logged off.

It is not recommended to logoff the transaction logger before entering "stoplog".

A process' locks are released during a logoff and the tape(s) are detached.

The "errors" file contains a history of logoffs. See "list-logoffs".
Syntax logoff {port.number}
Options k kills a shell if process is "shelled out"
z reinitializes a process that is stuck or has aborted (R83 only)
Example
logoff<return>
line:677<return>
[534] logoff successful.

logoff 677<return>
[534] logoff successful.
Purpose
Related tcl.logon
tcl.logon_rp
tcl.power-off
tcl.check-ws
tcl.list-logoffs
tcl.reset-user
port.number
system.privileges
tcl.admin.control
tcl.off
ue.a116
ue.0032
tcl.end
hung.port
tcl.exit
tcl.:background-stop