$Bump: Difference between revisions

From m204wiki
Jump to navigation Jump to search
mNo edit summary
m (1 revision)
(No difference)

Revision as of 21:21, 22 November 2011

Bump a user

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 (system manager 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

<section begin="syntax" /> %RESULT = $Bump(user_num, userid) <section end="syntax" />

$Bump Function

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

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.

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

$Bump return codes

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

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