Syntax for verilk
| OS | Command |
|---|---|
| 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>] |
| Switches | Description |
|---|---|
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. |
| -nolog | Optional 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: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. |
| 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 |