GET_LOGIN

Script Function: Reads information from Login objects.

Syntax

GET_LOGIN (Login object, Name, Type, Information)

Syntax

Description/Format

Login object

The name of a Login object.
Format: script variable, AE name or script literal

Name

The name of the entry in the Login object.
Format: script variable, AE name or script literal

Type

The type of the login entry.
Format: script variable, AE name or script literal

Information

The information that should be read.
Format: AE name

Allowed values:
LOGIN_INFO - Reads the login information (user, domain).
PASSWORD - Password


Return Code

The relevant information.

20476 - The specified object does not exist or is not of login type.
20482 - The specified name could not be found in the Login object.
20493 - Invalid specification of the information that should be read.

Comments

This script function supplies the login information or the password of a certain entry in the specified Login object. The parameters Name and Type decide upon the entry.

You can only read the login entries of self-defined systems or applications, not from operating systems!! Make sure that the specified Type is also available in the variable UC_LOGIN_TYPES.

The password is returned in encrypted form. You can use the password with the Agent Job Messenger(start parameter CMD) where it will be decrypted.

You can use "*" for the Name (use single or double quotation marks). Note that "*" in this case is an own entry in the Login object and not a filter.

Examples

The following example reads the login information and the password of the backend-system entry SVN from the Login object and runs a command run via the Job Messenger afterwards that specifies the login data.

:SET &LOGIN# GET_ATT(LOGIN)
:SET &LI#GET_LOGIN(&LOGIN#,SVN,SVN,LOGIN_INFO)
:SET &PW#GET_LOGIN(&LOGIN#,SVN,SVN,PASSWORD)

&UC_JOBMD CMD="&SVN_CMD# checkout ""&SVN_URI#"" ""&SVN_DIR#"" --username &LI# --password &PW#"

See also: