Documentation Center

Syntax for pltrim

OSCommand
Windowspltrim -dbase dbase@ODBC_DSN -v -n -max_proc_time <HH:MM>
Linuxpltrim -dbase dbase@SID -v -n -max_proc_time <HH:MM>
SwitchDescription

Windows:

dbname@ODBC_DSN

—or—

Linux:

dbname@SID

Required: dbname.

The name of the Contenta database.

Optional: ODBC_DSN (Windows)

The ODBC data source name. If not specified, the default is used—as defined in the registry for XYV_PDM_ODBC_DSN

Optional: SID (Linux)

The system identifier. If not specified, the default is used—as defined in the registry for XYV_PDM_DATABASE_SID

-v

Optional.

Verbose; send output to stdout (the screen)

-n

Optional.

Don't remove entries, just report to stdout (the screen)—only the first is level shown.

-max_proc_time <HH:MM>

Optional.

Runs the command for a specified length of time represented by <HH:MM> (hours and minutes) then stops.

Use the -max_proc_time switch to limit the amount of processing time for the current execution of the command.

The following are examples of output (messages) from the pltrim program (where <N> is a whole number).

MessageCondition

INFO: Reached time limit searching for orphans

INFO: at least <N> orphans not removed

If -max_proc_time limit is reached while still looking for orphans to delete

INFO: prune ran <N> loops, found <N> orphans On completion of the search for orphans

INFO: Reached time limit during orphan removal

INFO: <N> orphans not removed

If -max_proc_time limit is reached while deleting orphans

INFO: Delete <N> of <N> orphans from parent_list

INFO: You should now run verilk with -relations option

If pltrim completes deletion of all orphans found
INFO: No orphans found on parent_list If pltrim found no orphans to delete