$GETROLE (get role of user)

$GETROLE reads a list of user roles currently executing asset management jobs in operation windows into the specified array.

Organization of this page

Syntax

$GETROLE(array-name)

The following table lists and describes the possible statuses:

Status	Description
`NORMAL`	Normal end
`NODATA`	—
`ERROR`	—
Script execution interrupted	Indicates one of the following: Database access error An invalid argument was specified, or an error other than the above occurred.

If no roles have been set for users, the process ends normally, but no information is set into the array variable.

The following example acquires user roles, then outputs the role (administrator) in array number 1:

[SET_VALUE]
  $GETROLE(ARY)
  VAL = $GETARRAY(ARY, 1)
  MSG = 'ROLE = ' + VAL
  $ECHO(MSG)