Use this subcommand to perform a preview of objects
to be deleted by a save offline and delete scope. Then, use the subcommand
to create a preview object list that deletes the objects found by
the preview.
The query selection set matches
the results from the preview object list. When you run this command,
the preview object list is cleared. The list is also cleared when
you delete an object from the preview object list or by using a scope
command.
This subcommand populates the object
list with results of the preview so you can use it with subsequent
commands, such as ccm query. You can use the results
for the current session only.
The role required
to run the command depends on the specified scope. Each scope defines
the roles that are permitted to execute or preview that scope.
Note: The
preview results are not overwritten if you perform a query after a
preview and before you use the object list for a ccm soad
-delete command.
About this task
ccm soad|save_offline_and_delete -preview -scope scope_name
[-so|-save_offline] [-f|-format format] [-nf|-noformat]
([-ch|-column_header] | [-nch|-nocolumn_header])
[-sep|-separator separator] ([-sby|-sortby sortspec] |
[-ns|-nosort|-no_sort]) [-gby|-groupby groupformat]
[-u|-unnumbered] [-v|-verbose]
[argument...]
- argument...
- Specifies the arguments required for the specified scope. For
example, the scope "My working projects and products for a
specified release" requires one argument, which is a release
name. If a scope requires multiple arguments, the arguments must be
specified in the order defined in the scope definition.
- -ch|-column_header
- Specifies to use a column header in the output format. See -ch|-column_header for details.
- -f|-format format
- Specifies the command output format. See -f|-format for details.
- -gby|-groupby groupformat
- Specifies how to group the command output. See -gby|-groupby for details.
- -nch|-nocolumn_header
- Specifies not to use a column header in the output format. See -nch|-nocolumn_header for details.
- -nf|-noformat
- Specifies not to use column alignment. See -nf|-noformat for details.
- -ns|-no_sort
- Specifies not to sort the command output. See -ns|-nosort for details.
- -sby|-sortby sortspec
- Specifies how to sort the command output. See -sby|-sortby for details.
- -sep|-separator separator
- Used only with the -f|-format option. Specifies
a different separator character. See -sep|-separator for details.
- -scope scope_name [argument...]
- Specifies the scope (modified query) used to save offline or delete
objects.
- -so|-save_offline
- Creates an object list that preserves in the database any object
that would be the last remaining version of that object name and instance.
- -u|-unnumbered
- Suppresses automatic numbering of the command output. See -u|-unnumbered for details.
- -v|-verbose
- Generates messages detailing why objects are being included in
or excluded from the list.