SYS_USER_ALIVE

Script Function: Checks whether a user is logged on to AE with a UserInterface.

Syntax

SYS_USER_ALIVE (Name, Department)

Syntax	Description/Format
Name	Name of the user. Format: script literal or script variable
Department	User's department. Format: script literal or script variable

Return codes
"Y" - The user is logged on to the UserInterface. "N" - The user is not logged on to the UserInterface or the User object does not exist.

Comments

This script function checks if a user is logged on to AE.

Name and Department identify a user (for example, SMITH/DEV). You can only check users of your own client.

Users who are logged on via a utility or Call Interface cannot be identified .

The script function returns "N" if the user is not logged on or if the User object does not exist in the current client. If the specified user does not exist, you can react to this error by using the script statement :ON_ERROR and analyze it by using the script functions for error handling. Depending on the settings that have been specified, script processing either continues or aborts.

Example

The following example checks whether a user has logged on to DEV. The user's name and department are passed on to the script function in the form of script variables. The script aborts if the user "SMITH/DEV" is not defined. The result is output to the activation protocol.

:ON_ERROR ABEND
:SET &USR# = "SMITH"
:SET &DEP# = "DEV"
:SET &RET# = SYS_USER_ALIVE(&USR#, &DEP#)
:PRINT &RET#

See also:

Script element	Description
SYS_USER_DEP	Supplies the department of the user who has started the task.
SYS_USER_LANGUAGE	Supplies the language in which the Server generates the log files.
SYS_USER_LNAME	Supplies the first and last name of the user who has started the task.
SYS_USER_NAME	Supplies the name of the user who has started the task.

Script Elements - User Data

About Scripts
Script Elements - Alphabetical Listing
Script Elements - Ordered by Function