action parameter query

This allows data entry of parameters to be available via relevance during action execution. Parameter names may include blanks, and are case sensitive. The parameter name, description, and value must each be enclosed inside double quotation marks ("). Once entered, the user input becomes the default in subsequent invocations (for BigFix, the user is the console operator approving the action for deployment).

Syntax

action parameter query "<parameter name>" [with description "<description>"] [and] [with default [value] "<default value>"]

Where parameter name is the name of the relevance parameter and the with description option lets you present a prompt to the user. The and with default option lets you specify a default value for the parameter.

Examples

action parameter query "InstallationPoint" with description "Please enter 
  the location of the shared installation point:"
action parameter query "Registry key" with description "Please enter your
  desired registry key" and with default value "null"
action parameter query "tips" with description "Enter 'on' or 'off' to control
  Fixlet tips." With default "on" regset "[HKEY_CURRENT_USER\Software\BigFix]" 
  "tips"="{parameter "tips" of action}"
Note: The parameter values input by the user may include %xx where xx stands for a two-digit hexadecimal number to specify the character you want to embed. To embed a percent sign, use %25. To embed a double quote, use %22.

While the action is executing, you can retrieve the action parameter value entered by the console operator. For example, in your action you could use relevance substitution: {parameter "parameter name" of action}.

Relevance substitution is NOT performed on the action parameter query command line itself. This is because the command is interpreted in the IBM BigFix Console before the action is sent out, allowing the Fixlet author to ask the operator for deployment-specific parameters needed to run the action.

Version 5.1 and above