GET_LOGIN

Script Function: Reads information from a Login object. For more information, see Login (LOGIN).

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.

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.

Warning! 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 UC_LOGIN_TYPES variable. For more information, seeUC_LOGIN_TYPES - Defining Additional Platform and System Types for Login Objects

Note: 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. For more information, see Agent Job Messenger.

Note: 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 afterward 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: