You are here: Available Utilities > L > LBYPROC > Reversing Changes to Resources

Reversing Changes to Resources

The LBYPROC utility lets you roll back changes to resources, such as promotions.

This table defines the XML tags used in the following Rollback 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 rolled back. Here is an example:

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

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 roll back 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 roll back 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 roll back 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 roll back resources tied to a specific user.

EFFDATE

Enter the effective date you want the utility to assign to the resources you want to roll back.

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 rolled back. You can include these attributes:

  • SRC - Specifies the mode the source library resources must have to be rolled back. Enter a specific mode or "" for any mode.
  • TGT - (Optional) Specifies the mode the resources in the target library must have to be rolled back. 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 roll back. 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 rolled back. Enter a specific status or "" for any status.
  • TGT - (Optional) Specifies the status the resources in the target library must have to be rolled back. 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 roll back. Enter a specific status or "" if you want the status to remain unchanged.

Here is an example:

<STATUS SRC="PASSED" TGT=""/>

CLASS *

This specifies the class value the source library resources must have to be rolled back. You can include these attributes:

  • SRC - Specifies the class the source library resources must have to be rolled back. Enter a specific class or "" for any class:
  • TGT - (Optional) Specifies the class the utility will write into the target library resource record to be rolled back. 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 roll back. 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 rolled back. You can include these attributes:

  • SRC - Specifies the project code the source library resources must have to be rolled back. Enter a specific project or "" for any project:
  • TGT - (Optional) Specifies the project the resources in the target library must have to be rolled back. 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 roll back. 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.

Here are some examples of how you can roll back changes: