Filtering Resources

Enter the name of the library that contains the resources you want to include. Here is an example:

<LIBRARY VALUE="DEFLIB\MASTER.LBY"/>

Use this option if your script contains multiple Filter scripts. The LO tag tells the utility what to do with the matching records for this script.

If you use the Library Search wizard in Documaker Studio to create the library script, it automatically sets the LO option to the appropriate value.

The possible values are:

0 - Replace all current results with matching records.

1 - Search within current results only.

2 - Add matching records to current results.

3 - Remove matching records from current results.

Enter the name of the file you want to include, without the extension or path. You can include asterisks (*) as wildcards.

The default is "", which tells the utility to select all files in the source library.

Enter a description assigned to the resources you want to include. Here is an example

<DESC VALUE="Added using LBYPROC"/>

Enter the file extension, such as FAPThis lets you promote only specific types of files, like FAP files or LOG files.

The default is "", which tells the utility to select all types of files in the source library.

You can enter the version number, such as 00001, or you can set this tag to (last) to indicate you only want to include the latest version of each resource to disk.

The default is "", which tells the utility to select all versions in the source library.

You can enter a revision number, such as 00001, or you can set this tag to (last) to indicate you only want to include the latest revision of each resource to disk.

The default is "", which tells the utility to select all revisions in the source library.

Enter a specific user ID or enter "" for any user ID. This lets you promote include resources assigned to a specific user.

Enter the effective date of the resources you want to include.

Here is an example which shows an effective date of January 1, 2011

<EFFDATE VALUE="20110101"/>

Enter No if you do not want to include locked resources. Enter Yes if you want to promote only locked resources. The default is "", which tells the utility to promote both locked and unlocked resources.

This specifies the mode value the source library resources must have to be included in the operation. The default is "", which tells the utility to select all modes in the source library.

Here is an example:

<MODE VALUE="DEVELOPMENT"/>

This specifies the status value the source library resources must have to be included in the operation. The default is "", which tells the utility to select all statuses in the source library.

Here is an example:

<STATUS VALUE="PROMOTED"/>

This specifies the class value the source library resources must have to be included in the operation. The default is "", which tells the utility to select all classes in the source library. Here is an example:

<CLASS VALUE="GA"/>

This specifies the project value the source library resources must have to be included in the operation. The default is "", which tells the utility to select all projects in the source library. Here is an example:

<PROJECT VALUE="PROJECT1"/>

Enter an object type or enter "" for any type of object. Here is an example:

<OBJECTTYPE VALUE="TEXT"/>

Enter the name of the resource or enter "" for any resource. Here is an example:

<OBJECTNAME VALUE=""/>

Enter the text contained in the resource to filter on or enter "" for any text. Here is an example:

<OBJECTTYPE VALUE="TEXT"/>

<OBJECTTEXT VALUE="POLICY"/>

This tells the utility to filter for text objects that contain the word POLICY.