Equinox Online Help - Language Reference - A to Z

Home

FirstUserName

Applies to
SyntaxFirstUserName [LoginNameItem][, FullNameItem][, UserGroupExpression]
Action[Statement] Returns the login and full name of the first user for a particular user group, no user group or any user group.
ScopeUsable anywhere.
Notes

This statement is normally used with NextUserName to return the users defined within a particular user group. UserGroupExpression is an optional parameter used to specify the user group. If it is omitted the first user in all user groups is passed to the LoginNameItem and FullNameItem parameters. If a null string is supplied in UserGroupExpression, only users with no user group are returned.

FullNameItem will contain the full name as entered in the User Management dialog. LoginNameItem will contain the login name as specified in the user details section of the user management dialog. All of the parameters are optional.

The system workarea SysError is set to a non-zero value if an error occurs, otherwise zero.

CategoryUser, groups and ESS
See Also ChangeRecordGroup, CurrentRecordGroup, FieldPermissions, FirstUserGroup, NextUserGroup, NextUserName, RecordPermissions, SetUserGroup, ShowRecordGroup, UserAccountExpiry, UserGroup, UserName, UserPasswordExpiry, UserPermission
Example

The first example prints the Fullname of the first user in the user group called Managers.

string FullName

FirstUserName , FullName, "Managers"
If Not SysError Then Print FullName

The next example outputs the user name and full name of all users currently defined in all user groups.


FirstUserName LoginName, FullName
Print "Users currently defined in the Application: "

while not syserror
NextUserName LoginName, FullName
end while