| log-status | Index Level | logoff.error |
| Syntax | logoff {port.number} |
| Category | TCL |
| Type | Verb |
| 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 as of 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". |
| Options |
k kills a shell if process is "shelled out"
z reinitializes a process that is stuck or has aborted (R83 only) |
| See Also | logon logon (R83) power-off check-ws list-logoffs reset-user port.number system privileges admin.control off ua116 u0032 end hung port exit :background-stop |
| Example |
logoff<return>
line:677<return> [534] logoff successful. logoff 677<return> [534] logoff successful. |
| Warnings | Logging off a port should be treated as a last resort, and should be used by a System Administrator only when the status of the pib and potential problems which could arise have been assessed. |
| Compatibility | D3 7.0 AP R83 |
| log-status | Index Level | logoff.error |