maxusers command

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: 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	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: maxusers (az

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