xxv
getVariable("Agent Working Directory Path", " ", "agentWorkDir", "All Operating
Systems", "Halt on Fail"
Store the secure agent working directory path. This is sub-directory of the agent working directory
called “System” with ACL permissions restricted to System account and Administrators. It should be
used for saving executable files or any data files containing sensitive information.
getVariable("Secure Agent Working Directory Path", " ", "agentWorkDir", "All
Operating Systems", "Halt on Fail"
Prompt the user to enter a value when the procedure is scheduled.
getVariable("Prompt When Procedure is Scheduled", "URL:", "site", "All Operating
Systems", "Halt on Fail"
getVariableRandomNumber()
Generates a random number which can then be accessed as the variable #global:rand# in a
subsequent step.
Operating systems supported: Windows, OS X, Linux
Example
getVariableRandomNumber("All Operating Systems", "Halt on Fail")
sendMessage("#global:rand#", "Display now", "All Operating Systems", "Halt on Fail")
getVariableUniversalCreate()
Gets a variable that persists outside of the immediate procedure's execution. This can be useful for
passing a variable to another agent procedure using the scheduleProcedure() (page xxviii) step. You
store values in three variables: #global:universal1#, #global:universal2#, and
#global:universal3#. You can enter either string data or variables created in an earlier step.
Variables created using this step can only be read after using the getVariableUniversalRead() (page
xxv) step in any subsequent step. The three variables are specific to each agent machine. You can
optionally read the values from a different agent machine.
Operating systems supported: Windows, OS X, Linux
Example
getVariableUniversalCreate("red", "green", "blue", "All Operating Systems", "Halt on
Fail")
getVariableUniversalRead(" ", false, "All Operating Systems", "Halt on Fail")
sendMessage("#global:universal1#, #global:universal2#, #global:universal3#,
"Display now", "All Operating Systems", "Halt on Fail")
getVariableUniversalRead()
Reads up to three variables you have previously created using the getVariableUniversalCreate()
(page xxv) step. These variables must be referred to as #global:universal1#,
#global:universal2#, and #global:universal3#. Please see the initial getVariableUniversalCreate()
step for more detail. The three variables are specific to each agent machine. You can optionally read
the values from a different agent machine.
Operating systems supported: Windows, OS X, Linux
Example
getVariableUniversalCreate("red", "green", "blue", "All Operating Systems", "Halt on
Fail")
getVariableUniversalRead(" ", false, "All Operating Systems", "Halt on Fail")
sendMessage("#global:universal1#, #global:universal2#, #global:universal3#,
"Display now", "All Operating Systems", "Halt on Fail")
giveCurrentUserAdminRights()
Adds the current user on the agent machine to the local administrator’s group on the agent machine,
either permanently or for a temporary period of time. This change does not take effect until the user
logs off. It is recommended you leverage the logoffCurrentUser() (page xxvii) step.