GET_ATT_PLAIN

Use the GET_ATT_PLAIN script function to retrieve the value of a task attribute as defined during the generation of the task. The script function does not resolve variables. This function is similar to the GET_ATT script function, with the difference that script, object and predefined variables are replaced by values in the attribute. GET_ATT_PLAIN retrieves the variable name instead of the value. For more information, see GET_ATT.

Syntax

GET_ATT_PLAIN (Attribute)

Parameters

Parameter	Description	Format	Allowed Values	Default Value
Attribute	Defines the name of the attribute to read. For more information, see List of Object Attributes.	AE name, script literal or script variable	n.a.	n.a.

Important Considerations

GET_ATT and GET_ATT_PLAIN do not retrieve values of placeholders for VARA objects that are enclosed in curly brackets {}.

Return Codes

The GET_ATT_PLAIN function returns the variable name of the specified task attribute instead of the resolved value.

Examples

The following example uses a script variable to define an object attribute (the internal account) of a Job. The script retrieves the content of the INT_ACCOUNT attribute, returning both the script variable name and the resolved variable value. The results are printed in the activation report of the Job.

:PUT_ATT INT_ACCOUNT = "&&test#"

:SET &test# = "testvalue"

:SET &att# = GET_ATT(INT_ACCOUNT)

:SET &attplain# = GET_ATT_PLAIN(INT_ACCOUNT)

:PRINT "The variable value is &att#"

:PRINT "The variable name is &attplain#"

The lines in the activation report look like this:

2019-04-15 12:19:19 - U00020408 The variable value is testvalue

2019-04-15 12:19:19 - U00020408 The variable name is &test#

See also: