logoff Command

The logoff BASIC program terminates a process on a given port and sends the port to the logon prompt.

The logoff process first attempts a normal log off by simulating a break and off sequence on the target port. If that times 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.

The phantom ports (that is, the scheduler, transaction logger, and those hung ports) may now be properly logged off.

NOTE	It is not recommended to log off the transaction logger before entering stoplog.

Process locks are released during a logoff and the tapes are detached. The errors file contains a history of logoffs.

Syntax

logoff {port.number}{(options }

Parameter(s)

port.number	Specifies the port number to be set. If not specified, the port number is requested.
options	k	Kills a shell if process is shelled out.
	e	(Echo) displays selected messages even if capturing is on.
	x	Kills the underlying UNIX pid or Windows thread.

WARNING

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.

Example(s)

logoff

line:677

[534] logoff successful.

logoff 677

[534] logoff successful.