swutil QINFO Exit Codes and Error Messages

The following table lists the error codes and messages that may be returned by swutil QINFO.

swutil QINFO Exit Codes and Error Messages

Exit Code

Error Message

Description

0

n/a

Command succeeded.

1

Invalid user

You must be logged in as:

the IPEADMIN user or IPEBACKGROUND user, if you want to import CDQP configuration data (see Importing CDQP Configuration Data.)
an iProcess administrator, that is, with a MENUNAME of ADMIN), if you want to export CDQP configuration data (see Exporting CDQP Configuration Data.)

2

n/a

This code is currently not used.

3

Filename not found

The specified CDQP control file filename does not exist . See Importing CDQP Configuration Data.

4

Invalid control file

The specified CDQP control file is invalid. See CDQP Control File.

5

No CDQP data defined

You have tried to export CDQP configuration data, but no CDQPs are defined on the server.

6

No queue CDQPs defined

You have tried to export CDQP configuration data for a queue that has no queue mappings defined.

7

swutil usage message

You have tried to use a swutil QINFO command with either:

invalid keywords, or
an incorrect number of parameters.

8

Invalid queue name

You have tried to export CDQP configuration data for a queue, but the specified queuename either does not exist or is not a valid keyword. See Exporting CDQP Configuration Data.

9

System not configured for CDQP configuration

You cannot import CDQP configuration data because CDQP configuration is disabled on this server (by CDQP parameters in the SWDIR\etc\staffcfg file).

See "Tuning the iProcess Engine Using staffcfg Parameters" in TIBCO iProcess Engine Administrator's Guide for more information.

10

CDQP Configuration exceeds system limit global_message queue_message

You have attempted to import CDQP configuration data, but have exceeded current CDQP configuration limits for this server.

global_message appears only if the global CDQP limit is exceeded. The message displayed is:

Max Global CDQP limit is maxglobal, numCDQPs are configured

where:

maxglobal is the maximum number of CDQPs that can be defined on the server, as defined by the CDQPMAXGLOBAL parameter in the SWDIR\etc\staffcfg file. See "Tuning the iProcess Engine Using staffcfg Parameters" in TIBCO iProcess Engine Administrator's Guide for more information.
numCDQPs is the number of CDQPs defined on the server after processing the CDQP control file.

A queue_message appears for each queue for which the CDQP limit is exceeded. The message displayed is:

Max Queue CDQP limit is maxqueue, mappings are configured for queue queuename

where:

maxqueue is the maximum number of CDQPs that can be mapped to a specific queue, as defined by the CDQPMAXQUEUE parameter in the SWDIR\etc\staffcfg file. See "Tuning the iProcess Engine Using staffcfg Parameters" in TIBCO iProcess Engine Administrator's Guide for more information.
mappings is the number of CDQPs mapped to the queue after processing the CDQP control file.
queuename is the name of the affected iProcess queue.

11-14

n/a

These codes are currently not used.

15

Non-Fatal error(s) have occurred while processing Queue CDQP configuration. See the sw_warn file.

Errors affecting one or more queues have occurred during the import process. See TIBCO iProcess Engine System Messages Guide for more information.

16

A Fatal error has occurred. See the sw_warn or sw_error file.

The import process has failed with a fatal error. The status of the server’s CDQP configuration data depends on the phase at which the error occurred. See TIBCO iProcess Engine System Messages Guide for more information.