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`	e	(Echo) Displays selected messages even if capturing is on.
	f	Allows logging off the same port from two different lines simultaneously.
	k	Kills a shell if the process is shelled out.
	x	Kills the underlying UNIX pid or Windows thread.

Warning: Logging off a port should be treated as a last resort. It should be used by a system administrator only when the status of the PIB and potential problems that could arise have been assessed.

Example(s)

logoff
line: 677
[534] logoff successful.

logoff 677
[534] logoff successful.

logoff command

Syntax

Parameter(s)

Example(s)

See also