The maxusers command displays the number of licensed D3 users on the system, and/or sets the system in single or multiuser mode.
Syntax
maxusers {(options} |
Parameter(s)
options |
a |
Invokes the where command with the a option. |
c |
Indicates compatibility output (user pool only, also sets the n option) and produces the original style 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 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 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 |
No warning message. Goes to single-user mode. |
|
z |
Invokes the where command with the a and z options. (User must set the a option). For example:
|
Description
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, is allowed on the system.
If the process that executes the command is not port 0 though, port 0 is always allowed in. This makes the command forgiving to log on, in the case when the terminal that sets the single-user mode becomes unavailable (for example, following a modem problem).
All other ports are optionally logged off before entering the single-user mode, after sending two warning messages, separated by an optional grace delay.
NOTE |
Confirmation is required before logging a user off. |
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.
WARNING |
Use with extreme caution on a live system. |
Example 1
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 |
Example 2
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 |
Example 3
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.
Example 4
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 |
NOTE |
This can only be used from a single-user mode. |
Example 5
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 |
Example 6
To enter the single-user mode, log all users off unconditionally (f and u), immediately without any warning (n), and in quiet mode (q) so that no output displays type:
maxusers (snufq |
See Also
coldstart Command, d3 Command, system-coldstart Macro, uf070 User Exit, user-coldstart Macro, what Command