The maxusers command displays the number of licensed D3 users on the system, and/or sets the system in single or multiuser mode.
|options||a||Invokes the where command with the a option.|
|c||Indicates compatibility output, which produces the original style of output. Also displays the number of weeks remaining on temporary activations (for UNIX 7.4 or above and Windows 7.5 and above).|
|delay||Integer number that defines the grace period delay in seconds before logging users off when entering single-user mode. The default is five seconds.|
|e||Displays entire pool list.|
|f|| Logs off users currently logged on before entering single-user mode. A warning message is
broadcast unless the w option is also specified. Unless the
u option is specified, a prompt will be presented on the line issuing the
command for each line currently logged on before logging it off. The available responses
y: Yes. Logoff the line.
n: No. Do not logoff the line. Move onto the next line.
i: Information. Show a who, where, and if applicable, an nt_pinfo for the line and then re-prompt.
q: Quit. The system is returned to multiuser mode.
|l||Suppresses the message log in the system-errors file when changing the mode.|
|m||Sets multiuser mode. The number of allowed users is set to the maximum number of user licenses allowed by the pool.|
|m###|| For UNIX: Sets the maximum number of licenses used
in a given VME or allows even distribution across multiple VMEs. The
system does not remember to what the ceiling was last set. Therefore,
when switching from single-user mode back to multiuser mode, if no
ceiling is specified, then it will set it at the maximum.
For Windows: Not Supported
|o|| Invokes the where command with the a and o options. (User must set the a option). For example:
|p||Prints the results.|
|q||Quiet mode suppresses all output to the terminal.|
|r||Sets single-user mode and stops all new RPC clients from connecting to D3.|
|s||Sets single-user mode.|
|u||Unconditionally logs off users currently logged on when entering single-user mode (valid only with the f option).|
|w||Suppress the broadcast of the warning message indicating that the system is going to single-user mode.|
|z|| Invokes the where command with the a and z options. (User must set the a option). For example:
The maxusers command can accept the a and o option of the where command and execute a where.
The single-user mode is defined as the state where only the process that executes the command remains on the system.
On Unix platforms, line 0 is allowed on even if the system is in single user mode.
All other ports are optionally logged off before entering the single-user mode, after sending two warning messages, separated by an optional grace delay.
A message is logged in the errors file when entering single-user or multiuser mode. Additionally, if a user attempts to logon after the maximum allowed users limit has been reached, an error message is logged to the errors file.
To show current UNIX settings:
maxusers Pool Name Max Licenses Used Licenses Users Allowed Weeks User 100 2 100 0 Server 1 1 1 0 FlashCONNECT 50 0 50 0 ODBC 8 0 8 0 Phantoms 25 0 25 0
To show current Windows settings:
maxusers Pool Name Max Licenses Used Licenses Users Allowed Weeks User 8 1 8 0 Server 1 1 1 0 FlashCONNECT 1 0 1 0 ODBC 8 0 8 0 Phantoms 14 1 14 0 RPC Clients 8 0 8 0
To set single-user mode and log all users off in 30 seconds:
maxusers (sf30 Pool Name Max Licenses Used Licenses Users Allowed Weeks User 100 2 1 52 Server 1 1 1 52 FlashCONNECT 50 0 50 52 ODBC 8 0 8 52 Phantoms 25 0 25 52
This allows a grace period of 30 seconds after issuing the first warning message, before logging users off.
To switch to multiuser mode with a ceiling from a single-user mode:
maxusers (m50 Pool Name Max Licenses Used Licenses Users Allowed Weeks User 100 2 50 52 Server 1 1 1 52 FlashCONNECT 50 0 50 52 ODBC 8 0 8 52 Phantoms 25 0 25 52
To switch back to multiuser mode from a single-user mode:
maxusers (m Pool Name Max Licenses Used Licenses Users Allowed Weeks User 100 2 100 52 Server 1 1 1 52 FlashCONNECT 50 0 50 52 ODBC 8 0 8 52 Phantoms 25 0 25 52
To enter the single-user mode, log all users off unconditionally (f and u), immediately without any warning (w), and in quiet mode (q) so that no output displays type: