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.

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.

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

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 NT 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

 

 

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