9.3 Defining a Variable

You can create variables in three locations:

9.3.1 Defining Default Variables for All Subscribers

You can use the Tiered Electronic Distribution policy to define default variables for all Subscribers. Any variables you set in this policy as defaults for all Subscribers are overridden by any same-named variables defined on the Subscriber (see Section 9.3.2, Defining Variables for a Specific Subscriber).

To define default variables:

  1. In ConsoleOne®, right-click a Service Location Package object, click Properties, select the check box for the Tiered Electronic Distribution policy to both select and enable it, click Properties, then select the Variables tab.

  2. Click Add.

  3. Provide the name of the variable.

    The name can be user-defined, an environment variable (Java or native), or a predefined variable.

  4. Provide the value for the variable.

    The value is what the variable resolves to. It can also be another variable for nesting variables.

    To ensure that extraction takes place, provide an absolute path to all Subscribers. For example, if the path is only the data: volume, make sure the colon (:) is included, because it is a necessary part of the full path.

  5. Provide a description (optional), then click OK.

  6. Repeat Step 2 through Step 5 to define another variable for the Subscribers.

  7. Click OK when you have finished defining the default variables.

  8. On the Service Location Package properties page, select the Associations tab.

  9. If there are no associations listed that include all Subscriber objects, click Add.

  10. Browse for an eDirectory container that includes all Subscriber objects, click OK.

    This ensures that the policy is enforced for all Subscribers. For more information, see Tiered Electronic Distribution.

  11. Click OK to exit the policy package’s properties.

9.3.2 Defining Variables for a Specific Subscriber

  1. In ConsoleOne, right-click a Subscriber object, then select the Variables tab.

  2. Click Add.

  3. Provide the name of the variable.

    The name can be user-defined, an environment variable (Java or native), or a predefined variable.

    Enter only the variable’s name. Do not include the % symbols that would accompany the variable when you use it.

  4. Provide the value for the variable.

    The value is what the variable resolves to. It can also be another variable for nesting variables.

    To ensure that extraction takes place, provide an absolute path to the Subscriber. For example, if the path is only the data: volume, make sure the colon (:) is included, because it is a necessary part of the full path.

  5. Provide a description (optional), then click OK.

  6. Repeat Step 2 through Step 5 to define another variable for this Subscriber.

  7. Click OK to exit the Subscriber’s properties.

9.3.3 Defining Variables for a Server Software Package

  1. In ConsoleOne, right-click a software package, then select the Variables tab.

  2. Click Add.

    New Variable #1 is defaulted in the Variables column.

    Enter only the variable’s name. Do not include the % symbols that would accompany the variable when you use it.

  3. To provide a different name for the variable, use the Backspace key to delete the default name, type a new variable name, then press the Tab key.

    The name can be user-defined, an environment variable (Java or native), or a predefined variable.

  4. Provide the value for the variable.

    The value is what the variable resolves to. It can also be another variable for nesting variables.

  5. Repeat Step 2 through Step 4 to define another variable.

  6. Click OK to exit the Server Software Package’s properties.