%ECHO--Print To Output
Display the value of a variable in the Agent's namespace.
Syntax
Parameters
Parameter |
|
|---|---|
string | string, including namespace variable macros to be resolved, which will be returned by the %ECHO command. |
Description
%ECHO displays the string parameter, after macros of namespace variables have been substituted.
Namespace variable macros take the following form:
The value of variable will be substituted for the macro before displaying the string.
If variable is a relative name and does not exist in the context of executing the %ECHO command, the command successively searches each ancestor's context until variable is found or until the search fails in the context of the computer.
Unlike the PSL get() function, that returns null when a variable is not found, %ECHO will trigger a user error message if the macro cannot be substituted, and string will be displayed without substituting the unknown variable.
For example, the command %ECHO Version %{/patrolVersion} of the
Unknown macro: confluence_display.
displays the following:
Version 3.6.50i of the PATROL Agent
If the variable unknown does not exist, the command %ECHO Value: %{ unknown } triggers a user error and displays the following:
Value: %{ unknown }
Where to go from here