Creating Composite Parameter Expressions Using the Wizard

This task describes how to create composite parameters using the expression entry wizard.

Before you begin

You must be using a BMC PATROL Console in developer mode.

To Create a Composite Parameter Expression Using the Expression Entry Wizard

1. From the COMPOSITES_COLLECTOR menu, choose KM Commands > Create Expressions. BMC PATROL displays the Create Expression dialog box.

   Warning

   Note

   To return to the previous dialog box or redisplay the Create Expressions dialog box, you can click*Cancel* at any time while you are using the expression entry wizard.

2. Type a name for the new expression.
    A valid composite parameter name consists of alphanumeric characters. It cannot contain a space character or any special characters, such as _, /, * or #.
3. Click Create.
   BMC PATROL displays the Edit Expression dialog box.

   1. If you do not want the composite parameter to be active when you finish defining it, clear the Activecheck box.

      Warning

      Note

      The active state for the composite parameter does not affect the active state for the parameters used in the definition of the composite parameter.

   2. Select the Warning state or the Alarm state button to indicate the parameter state that BMC PATROL sets when the condition specified by the expression occurs.
   3. Select the True or False button to indicate whether BMC PATROL should set the condition when the expression is true or false.
4. To start the expression entry wizard, click Wizard. BMC PATROL displays the Select Expression Term Type dialog box.
5. Select the term type that you want to use:
   • If you select PATROL KM Parameter and then click Continue, BMC PATROL displays the Select PATROL application dialog box. Go to Step 6 to continue.
   • If you select Constant value and then click Continue, BMC PATROL displays the Enter Constant Value dialog box. Go to step 8 to continue.
6. Select the application class that contains the parameter that you want to use in the expression and then click Continue. The parameters associated with the selected application class are displayed in the parameter list box.
7. Select the application parameter that you want to use in the expression.
   1. If there is more than one instance of the application, select the instance you want to use in the definition and then click Continue.

   2. If the application has only one instance, select the PATROL application parameter you want to use in the expression and then click Continue.

      Warning

      Note

      Although collector parameters are listed in the dialog box, they cannot be used in composite parameter calculations.

      BMC PATROL displays the Select Relational Operator dialog box. Go to step 10 to continue.

8. Enter the constant you want to use in the composite parameter expression. The constant can be either an integer value or a string expression. See Syntax-rules-for-COMPOSITES-parameter-expressions for information about string expressions.
9. Click Continue to continue entering the expression. BMC PATROL displays the Select Relational Operator dialog box.
10. Select the relational operator you want to use in the relational clause and then click Continue. After you complete entry of the second term, BMC PATROL displays the Expression Complete dialog box.
    • If you do not want to add another relational clause to the expression, click Done. BMC PATROL displays the Save or Discard dialog box. The procedure continues with step 12.
    • If you want to add another relational clause to the expression, click More. BMC PATROL displays the Select Boolean Operator dialog box. The procedure continues with step 11.
11. Select the Boolean operator you want to use to join relational clauses. BMC PATROL displays the Select Expression Term Type dialog box. Return to step 5 to add another relational clause to the expression.
12. Click Save to save the composite parameter expression. After you click Save, the KM analyzes the expression to make sure that all terms are valid.
    • If the KM detects no errors, the new composite parameter appears in the COMPOSITES container after the next collection cycle.
    • If the KM detects errors in the expression, the Syntax Errors dialog box appears, which contains text identifying the error. Click OK to display the Edit Expression dialog box and correct the error.