tcl.maxusers Verb: Access/TCL

tcl.maxusers

Command tcl.maxusers Verb: Access/TCL
Applicable release versions: AP, AP 6.0
Category TCL (746)
Description displays the number of licensed Pick users on the system, and/or sets the system in single or multi-user mode.

The "single-user mode" is defined as the state where only the process which executes the command is allowed on the system.

If the process which executes the command is not port 0, though, port 0 will always be allowed in. This makes the command forgiving to logon, in the case when the terminal which sets the single-user mode becomes unavailable (following a modem problem, for instance).

All other ports are optionally logged off before entering the single-user mode, after sending two warning messages, separated by an optional grace delay. Confirmation is required before logging a user off.

A message is logged in the "errors" file when entering single or multi-user mode.
Syntax maxusers {(options}
Options number (integer number) Defines the "grace" period delay in seconds before logging users off when entering single-user mode. The default is five seconds.

f Logs off users currently logged on before entering single-user mode. A warning message is sent to users, unless the "n" option is also specified. When a user is logged on, confirmation is asked, unless the "u" option is also specified.

l Suppresses the message log in the "errors" file when changing the mode.

m Sets multi-user mode. The number of allowed users is set back to the maximum user license.

n Suppresses the warning message to users when entering single-user mode (valid only with "f" option).

p Prints the results.

q Quiet mode. Suppresses all output to the terminal.

s Sets single-user mode.

u Unconditionally logs off users currently logged on when entering single-user mode (valid only with "f" option).
Example
maxusers
Number of licensed users            : 128
Number of users currently logged on : 8
Number of users allowed on system   : 128
Number of ports on system           : 128

maxusers (sf30

This enters single-user mode, allowing a grace period of 30 seconds after 
issuing the first warning message, before logging users off. This command 
displays the following information, after entering single-user mode: 

Number of licensed users            : 128
Number of users currently logged on : 1
Number of allowed users             : 1 
Number of ports on system           : 128

maxusers (m
Number of licensed users            : 128
Number of users currently logged on : 8
Number of users allowed on system   : 128
Number of ports on system           : 128

Enters multi-user mode. 

maxusers (snufq

This enters single-user mode ("s"), logs all users off 
unconditionally ("f" and "u"), immediately -- without any 
warning ("n"), in "quiet" mode ("q") -- so no 
output displays.
Purpose
Related tcl.what
ue.f070
tcl.config.options
tcl.config.ports
tcl.system-coldstart
tcl.user-coldstart
tcl.:files
tcl.coldstart
tcl.ap.unix