You are here: Available Utilities > L > LBYPROC > Promoting Resources

Promoting Resources

The LBYPROC utility lets you promote resources from one library to another. Promotions and extractions operate on the set of records defined by the library filter. A library script can contain these sections:

This table defines the XML tags used in the following Promote script examples. For information on the Filter section XML tags, see Filtering Resources.

XML tag

Description

LIBRARY

Enter the name of the source library. You can also use this tag to indicate a target library, to which you want the resources promoted. Here is an example:

<LIBRARY SRC="LBYDEV" TGT="LBYTEST"/>

NAME

Enter the name of the file, without the extension or path, such as Q1ADDR. You can include asterisks (*) as wildcards. The default is "", which tells the utility to select all files in the source library.

TYPE

 

Enter the file extension, such as FAPThis lets you promote only specific types of files, like FAP files or LOG files. You can include asterisks (*) as wildcards.

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

VERSION

Enter the version number, such as 00001.

Set this tag to (last) to indicate you only want to promote the latest version of each resource.

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

REVISION

Enter the revision number such as 00001.

Set this tag to (last) to indicate you only want to promote the latest revision of each resource.

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

USERID

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

EFFDATE

Enter the effective date you want the utility to assign to the resources it will promote.

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

<EFFDATE VALUE="20110101"/>

MODE *

This specifies the mode value the source library resources must have to be promoted. You can include these attributes:

  • SRC - Specifies the mode the source library resources must have to be promoted. Enter a specific mode or "" for any mode.
  • TGT - (Optional) Specifies the mode the resources in the target library must have to be promoted. Enter a specific mode or "" if you want the mode to remain unchanged.
  • FINAL - (Optional) Specifies the mode the utility will write into the source library resource record after the promotion Enter a specific mode or "" if you want the mode to remain unchanged.

Here is an example:

<MODE SRC="" TGT="" FINAL=""/>

STATUS *

This specifies the status value the source library resources must have to be included in the promotion. You can include these attributes:

  • SRC - Specifies the status the source library resources must have to be promoted. Enter a specific status or "" for any status.
  • TGT - (Optional) Specifies the status the utility will write into the target library resource record after the promotion. Enter a specific status or "" if you want the status to remain unchanged.
  • FINAL - (Optional) Specifies the status the utility will write into the source library resource record after the promotion. Enter a specific status or "" if you want the status to remain unchanged.

Here is an example:

<STATUS SRC="PASSED" TGT="TEST" FINAL="PROMOTED"/>

CLASS *

This specifies the class value the source library resources must have to be included in the promotion. You can include these attributes:

  • SRC - Specifies the class the source library resources must have to be promoted. Enter a specific class or "" for any class:
  • TGT - (Optional) Specifies the class the utility will write into the target library resource record after the promotion. Enter a specific status or "" if you want the class to remain unchanged.
  • FINAL - (Optional) Specifies the class the utility will write into the source library resource record after the promotion. Enter a specific class or "" if you want the class to remain unchanged.

Here is an example:

<CLASS SRC="" TGT="" FINAL=""/>

PROJECT *

This specifies the project value the source library resources must have to be included in the promotion. You can include these attributes:

  • SRC - Specifies the project code the source library resources must have to be promoted. Enter a specific project or "" for any project:
  • TGT - (Optional) Specifies the project the utility will write into the target library resource record after the promotion. Enter a specific project or "" if you want the project to remain unchanged.
  • FINAL - (Optional) Specifies the project the utility will write into the source library resource record after the promotion. Enter a specific project or "" if you want the project to remain unchanged.

Here is an example:

<PROJECT SRC="" TGT="" FINAL=""/>

* You define modes, statuses, classes, and projects when you check in a resource using Documaker Studio. See the Documaker Studio User Guide for more information.

Note In newer scripts that contain both a Promote section and a Filter section, the promote SRC values are ignored because the Filters section defines the resources to promote. For more information on the XML tags you can use in Filter sections, see Filtering Resources.

Here are some examples of how you can promote resources:

© Copyright 2012, Oracle and/or its affiliates. All rights reserved. Legal notices.