Importing CDQP Configuration Data

To import new or updated CDQP configuration data to TIBCO iProcess Engine, use the following command:

swutil QINFO –|filename [PARSEONLY|PUBLISH]

•

– indicates that CDQP commands will be entered from the command line. Commands must be entered using the same syntax and structure as if they were in a control file. Use the appropriate end-of-file key sequence to terminate the command input, for example, CTRL + D on many UNIX systems.

•

filename is the full path of the CDQP control file, containing CDQP commands. See CDQP Control File for more information about the content and format of this file.

•

PARSEONLY indicates that the CDQP commands should be validated for correctness, without changing current CDQP configuration data. See CDQP Command Errors for more information.

•

PUBLISH indicates that affected work queues should be updated immediately with the new data, without having to restart the iProcess Engine. (An event is published to the WIS processes as soon as the import operation has successfully completed, informing them that new CDQP configuration data is available.) See "Configuring CDQP Updates" in TIBCO iProcess Engine Administrator's Guide for more information.

If the PUBLISH parameter is omitted, you must restart the iProcess Engine to make the new CDQP configuration data available to affected work queues.

Note that you can use this command only when:

•

you are logged in as the IPEADMIN user or the IPEBACKGROUND user.

•

CDQP configuration is enabled in the SWDIR/etc/staffcfg file. See "Tuning the iProcess Engine Using staffcfg Parameters" in TIBCO iProcess Engine Administrator's Guide for more information.

The server processes the CDQP commands, and reports and logs any errors it encounters:

•

Progress is reported to the console and logged to the qinfoimp.log file located in the SWDIR\logs directory.

•

Serious errors, that is, those that are fatal either for the entire import process or for a particular queue, are logged either to the sw_warn file or to the sw_error file located in the SWDIR\logs directory. See "Error Handling" in TIBCO iProcess Engine Administrator's Guide for more information about errors.


	If you have changed the log files directory in the staffpms file, errors will be logged to the qinfoimp.log, sw_error, and sw_warn file located in the directory you have specified.

See swutil QINFO Exit Codes and Error Messages for a list of exit codes and error messages that the command can return.

Examples

To enter CDQP commands, use the following command:

swutil QINFO -

To validate a set of new or updated CDQP configuration data before importing it, use the following command:

swutil QINFO C:\TEMP\MYPROC.XFR PARSEONLY

To import a set of new or updated CDQP configuration data to the server, use the following command:

swutil QINFO C:\TEMP\MYPROC.XFR

To import a set of new or updated CDQP configuration data to the server and publish it immediately, use the following command:

swutil QINFO C:\TEMP\MYPROC.XFR PUBLISH