$Bump

Bump a user

Note: Most Sirius $functions have been deprecated in favor of Object Oriented methods. There is currrently no OO equivalent for the $Bump function as we have yet to implement a User Class.

The $Bump function allows a privileged user ( or system administrator) to bump another user as with the BUMP command.

$Bump accepts one or two arguments and returns a numeric code.

The first argument is the number of the user to be bumped.

The second argument is an optional userid. If this argument is provided, the user number indicated by argument one will only be bumped if the userid matches the second argument. This helps prevent accidentally bumping a user that just logged onto a thread previously occupied by another user.

Syntax

%result = $Bump(user_num, [userid])

%result is set to indicate the success of the function.

Return codes

0 - User bumped 1 - User not found 2 - Not privileged to issue BUMP command

Usage notes

The behavior of $Bump is affected by the FUNCOPTS system parameter: If the FUNCOPTS X'01' bit is set, a caller of $Bump can bump any thread that has the same user ID as that of the caller, whether or not the caller is a system administrator or system manager.

Example

The following program bumps userid 'HOMER' with user number 13.

B %RC = $Bump( 13, 'HOMER' ) END