Search Policy Overview

ZENworks for Handhelds policies are associated to a handheld device object in any of the following ways:

• To the handheld device object itself
• To a Handheld Group where the handheld device is a member
• To a parent container of the handheld device object

The search order that ZENworks for Handhelds uses is consistent with standard eDirectory behavior and any search policies that are in the tree. ZENworks for Handhelds starts at the handheld device object, followed by any Handheld Groups that the device is a member of, and then starts walking up the tree looking for policies to enforce. All handheld policies are merged and the culmination is applied to the handheld device. If any conflicts occur, such as two Palm Configuration policies (one associated directly to the handheld device object and the other associated to a parent container of the handheld device object), the first policy found is enforced. In this case, the Palm Configuration policy directly associated to the handheld device object is enforced.

The File Retrieval policies (Palm File Retrieval and WinCE File Retrieval) present exceptions to rule that the first policy found is enforced. These policies are both plural (meaning they can be added many times to a policy package) and cumulative (meaning that many different File Retrieval policies with different settings can be effective for a single handheld device object, handheld group object, or container object). Because the File Retrieval policies are plural and cumulative, no conflicts occur when ZENworks for Handhelds encounters multiple File Retrieval policies: every effective File Retrieval policy will be enforced.

The Search policy is used to limit how far up the tree ZENworks for Handhelds will search for the effective policies. The ZENworks for Handhelds Application Search policy is used to limit how far up the tree ZENworks for Handhelds will search for handheld application objects. In addition to limiting how far up the tree ZENworks for Handhelds will search for policies, both policies let you determine the searching order (object, group, container) that ZENworks for Handhelds will use as it searches for policies. The search order is significant because the first policy found is enforced (except for the File Retrieval policies, as explained previously).

If your directory contains many objects, ZENworks for Handhelds will perform significant tree-walking if no search policies are enabled. For this reason, you should make use of both the Search policy and the ZENworks for Handhelds Application Search policy.

The Search policy and the ZENworks for Handhelds Application Search policy provide the following benefits

• Improved security
• The ability to reorder a search
• Better search performance by limiting the search levels traversed in eDirectory and by avoiding unnecessary LAN traffic

The Search policy specifies how ZENworks for Handhelds determines which policies are associated with handheld device objects. The ZENworks for Handhelds Application Search policy specifies how ZENworks for Handhelds determines which handheld application objects are associated with handheld device objects. To make either search policy effective, you associate it with a container. Both search policies apply to handheld device objects within or beneath a given container.

You can specify the number of levels above or below the location to begin the search:

Number	Description
0	Limits the search to the selected level.
1	Limits the search to one level above the selected level. For example, if you selected the handheld device object's parent container, this would limit the search to one level above the parent level.
-1	Limits the search to one level below the selected level. For example, if you selected [Root], -1 would limit the search to one level below [Root].

Without a search policy in effect, the default is to search from the parent container clear to [Root] hourly. The search checks each container up the tree towards [Root] for policy packages and handheld application objects associated with those containers.

The default search policy will recognize the policy package associated with the handheld device object before it will look in any group or container where such an object resides.

The default search order, Object > Group > Container, can be reordered and can include as few as one of the locations. For instance, you can exclude Group objects by setting the search order to Object > Container.

You can avoid unnecessary LAN traffic by searching to an associated container instead of [Root].

The Search policy is required for finding other policies. You set up Search policies at a container level. Set up as many Search policies as you will need to help minimize network traffic.

Search Policy

The Search policy is used to limit how far up the tree ZENworks for Handhelds will search for the effective policies.

To set up a Search policy:

1. In ConsoleOne, right-click the newly created Container Package, then click Properties.

   
   

2. Check the check box under the Enabled column for the Search policy.

   This both selects and enables the policy.

3. Click Properties to display the Search Level page.

   
   

4. Select the level to search to from the drop-down list:

   [Root]: Search from the handheld device object to the root of the tree.

   Object Container: Search from the handheld device object to the parent container of the object.

   Partition: Search from the handheld device object to the partition boundary.

   NOTE:  If you are using ZENworks for Desktops 4 (ZfD 4), Partition has been replaced with Associated Container. If you select Associated Container, ZENworks for Handhelds will search to the partition boundary.

   Selected Container: Search from the handheld device object to the selected container.

5. If you chose Selected Container, browse to select the container.

6. To determine the searching limits in either direction, specify a number between -25 and 25.

7. Click the Search Order tab.

   
   

8. Specify the policy searching order, using the arrow keys, the Add button, and the Remove button as necessary.

   NOTE:  Depending on which other ZENworks products (ZENworks for Desktops and ZENworks for Servers) are present, ConsoleOne may display a Refresh Interval page; however, ZENworks for Handhelds does not use the settings on the Refresh Interval page.

9. Click OK.

10. When you have finished configuring all of the policies for this package, continue with the steps under Associating the Container Package to associate the policy package.

ZENworks for Handhelds Application Search Policy

The ZENworks for Handhelds Application Search policy is used to limit how far up the tree ZENworks for Handhelds will search for Handheld Application objects.

To set up the ZENworks for Handhelds Application Search policy:

1. In ConsoleOne, right-click the Container Package, then click Properties.

   
   

2. Check the check box under the Enabled column for the ZENworks for Handhelds Application Search policy.

   This both selects and enables the policy.

3. Click Properties to display the Search Level page.

   
   

4. Select the level to search to:

   [Root]: Search from the handheld device object to the root of the tree.

   Object Container: Search from the handheld device object to the parent container of the object.

   Partition: Search from the handheld device object to the partition.

   NOTE:  If you are using ZfD 4, Partition has been replaced with Associated Container. If you select Associated Container, ZENworks for Handhelds will search to the partition boundary.

   Selected Container: Search from the handheld device object to the selected container.

5. If you chose Selected Container, browse to select the container.

6. To determine the searching limits in either direction, specify a number between -25 and 25.

7. Click the Search Order tab.

   
   

8. Specify the policy searching order.

   Use the arrow keys, the Add button, and the Remove button as necessary to create your search order.

9. Click OK.

10. When you have finished configuring all of the policies for this package, continue with the steps under Associating the Container Package to associate the policy package.

Associating the Container Package

The policies you configured and enabled will not be in effect until you associate their policy package with a container object.

1. In ConsoleOne, right-click the Container Package, then click Properties.

2. Click the Associations tab > Add.

3. Browse for the container for associating the package, then click OK.