Documentation Center

Syntax for verilk

OSCommand
Windows

verilk -dbase dbname@SID -user sysadmin -password sysadmin_passwd [-nolog] [-lf logfile] [-relations] [-nosubcfgs] [-fastmode] [-max_proc_time <hh:mm>]

Linux

verilk -dbase dbname@SID -user sysadmin -password sysadmin_passwd [-nolog] [-lf logfile] [-relations] [-nosubcfgs] [-fastmode] [-max_proc_time <hh:mm>]

SwitchesDescription

Windows:

dbname

—or—

Linux:

dbname@SID

dbname is required if XYV_PDM_DBASE is not defined.

The name of the Contenta database.

Default: XYV_PDM_DBASE

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

Troubleshooting 1:

If this switch is not used and XYV_PDM_DBASE is not defined, verilk exits with the following error message: No database specified on command line. Exiting...

Resolution:

Use the -dbase switch and specify the name of the Contenta database to check or define the database in the XYV_PDM_DBASE variable.

Troubleshooting 2:

If you do not specify a valid database name, verilk exits with the following message: Database not found ERROR: Unable to connect to database name Exiting...

Resolution:

Use the database list command to list valid database names. If executing with Oracle, make certain you specified the (correct) SID on Linux or ODBC_DSN if on Windows.

Troubleshooting 3:

If users are connected to the database when the command is issued, verilk exits with the following error message:

ERROR: Unable to connect to database dbname Exiting...

Resolution:

Use the pcmsessions command to list active user sessions. Ask users to exit their session and Contenta. If necessary, clear the sessions; execute the pcmsessionscommand with the -clear switch.

Note that CHECKOUT sessions do not affect the execution of verilk but they are removed when you run verilk. Ask users to check in documents prior to running verilk.

-user sysadmin

Optional

Specifies to execute the verilk command as the sysadmin user.

Default: sysadmin
Troubleshooting 1:

The verilk command should be executed by the sysadmin user. If you do not specify sysadmin, verilk exits with the following message:

ERROR: Sorry, verilk can only be run by sysadmin. Exiting...

Resolution:If using this switch, use as shown.
-password password

Required

Where password is the sysadmin user’s password.

Troubleshooting:

If no password or an invalid password is entered for the sysadmin, verilk exits with the following message:

ERROR: Invalid username/password. Exiting...

Resolution:

Make certain that you specify the (correct) password for sysadmin, even if you do not specify the -user switch.

-nologOptional

Diverts command messages from the log file to your screen.

When this switch is used, no messages are written to the log file.

Default: If you do not use this switch or the -lf logfile switch, the command creates or appends messages to the default log file, locks_log in the Contenta_home/logs directory.

-lf logfile Optional

Specifies an alternate location and name for the log file.

Where logfile is a (optional) directory path and name for the log file.

If you use this switch, you must specify a filename. It is not mandatory that you specify a directory path.

Defaults: If this switch is used but no path is specified, the log file is written to the current directory—the directory from where the command is issued.

If you do not use this switch or the -nolog switch, the command creates or appends messages to the default log file, locks_log in the Contenta_home/Logs directory.

-relations

Verifies the parent_list relation in the database.

It is recommended that you execute verilk with this switch prior to executing reap_delete.

INFO: relations option ignored in fastmode.

-fastmode

Optional

Does not update the parent list; use for quicker execution of the command.

INFO: relations option ignored in fastmode.

-max_proc_time hh:mmOptional

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.

Troubleshooting:

If the time format is not valid, verilk exits with the following message:

ERROR: Invalid -max_proc_time time argument Exiting...

Resolution:

Make certain that the format of hours and minutes is as shown.

hh and mm must be entered as a two digit number

hh cannot exceed 99

mm cannot exceed 59