Purge Business Object or Business Object List

The Purge Businessobject command is used to purge all but the last updated file of the associated business object.

This page discusses:

Syntax

If the Purge businessobject command is used without a location name, it does a purge on all locations. The syntax is:

purge businessobject OBJECTID [location LOCATION_TARGET{,LOCATION_TARGET}];

  • OBJECTID is the OID or Type Name Revision of the business object.
  • LOCATION_TARGET is one or more location names that are associated with the specified business object. Locations are separated by a comma but no space.

The keyword businessobject can be shortened to bus.

Location Clause

To specify a subset of locations that you want purged, include the location clause. For example:

purge bus Assembly R123 A location London,Paris,Milan;

When listing locations, delimit with a comma but no space.

The Purge Businessobjectlist command is used to purge files associated with a list of business objects. The syntax is:

purge businessobjectlist BUS_OBJECT_COLLECTION_SPEC [continue] [commit N] [location LOCATION_TARGET{,LOCATION_TARGET}];

BUS_OBJECT_COLLECTION_SPEC includes:

| set NAME                                                 |
    | query NAME                                               |
    | temp set BO_NAME{,BO_NAME}                               |
    | temp query [TEMP_QUERY_ITEM {TEMP_QUERY_ITEM}]           |
    | expand [EXPAND_ITEM {EXPAND_ITEM}]                       |

You can also use these specifications in Boolean combinations.

The keyword businessobjectlist can be shortened to buslist.

Continue Clause

Include the keyword continue if you do not want the command to stop if an error occurs. If the log file is enabled, failures are listed in the file. For more information, see trace Command. For example:

purge businessobjectlist set MyAssemblies continue;

If an error occurs when using the continue clause, the existing transaction is rolled back, so any database updates that it contained are not committed. The command starts again with the next business object. For this reason, when using the continue clause you should also include the commit clause, described below.

Commit N Clause

Include the commit N clause when purging large business object lists. The number N that follows specifies that the command should commit the database transaction after this many objects have been purged. The default is 10. For example:

purge buslist set MyAssemblies continue commit 20;