The maxusers command displays the number of licensed D3 users on the system, and/or sets the system in single or multiuser mode.
maxusers {(options}
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
are: 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: maxusers (ao |
|
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: maxusers (az |
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:
maxusers (swufq