XCOMN0602E/XCOMU0602E General error in queue function; rc=-xxxx and other XCOM queue errors.

Document ID : KB000009352
Last Modified Date : 14/02/2018
Show Technical Document Details
Introduction:

A number of different problems can cause errors in the XCOM queue function. Here is a summary of the most common ones and a list of the QUEUE error codes and their meaning.

Instructions:

Here are the most common scenarios that would generate a queue function error:

XCOMD service is not started.
Permissions on the %XCOM_HOME%\Q directory and/or 000026.idx file.
Program version mismatch.
Out of space.
The shared memory segment is not available or accessible.

The most commonly seen error is permissions.

Below is a list of CA XCOM for Windows QUEUE errors codes along with their associated functions, and error messages:

Queue Function         Error Code   Associated Error Message
----------------------------------------------------------------------------
QM_ERR_GET_SH_MEM            9900 - Could not get shared memory for queue.
QM_ERR_INVALID_ENTRY_NAME    9901 - Queue entry name is invalid.
QM_WRONG_VERSION             9902 - The queue version is incompatible.
PUT_GENNAME_FAIL             1000 - Unable to queue: Cannot generate TID.
PUT_IDX_OPEN_FAIL            1001 - Unable to open queue index file
PUT_IDX_WRITE_FAIL           1002 - Unable to write into queue index file.
PUT_IDX_CLOSE_FAIL           1003 - Unable to close queue index file.
PUT_DATA_OPEN_FAIL           1004 - Unable to queue: Cannot create data file.
PUT_DATA_WRITE_FAIL          1005 - Unable to queue: Cannot write data file.
PUT_DATA_CLOSE_FAIL          1006 - Unable to queue: Cannot close data file.
PUT_QUEUE_IS_FULL            1007 - Unable to queue: Queue is full.
UPD_IDX_OPEN_FAIL            1101 - Unable to open queue index file.
UPD_IDX_WRITE_FAIL           1102 - Unable to write into queue index file.
UPD_IDX_CLOSE_FAIL           1103 - Unable to close queue index file.
UPD_NOT_FOUND_IN_IDX         1100 - The queue entry does not exist.
UPD_DATA_OPEN_FAIL           1104 - Unable to open queue data file.
UPD_DATA_WRITE_FAIL          1105 - Unable to write queue data file.
UPD_DATA_CLOSE_FAIL          1106 - Unable to close queue data file.
DEL_IDX_OPEN_FAIL            1201 - Unable to open queue index file.
DEL_IDX_SEEK_FAIL            1202 - Unable to seek in queue index file.
DEL_IDX_WRITE_FAIL           1203 - Unable to write into queue index file.
DEL_IDX_CLOSE_FAIL           1204 - Unable to close queue index file.
DEL_NOT_FOUND_IN_IDX         1200 - The queue entry does not exist.
DEL_DATA_OPEN_FAIL           1205 - Unable to open queue data file.
GET_IDX_OPEN_FAIL            1301 - Unable to open queue index file.
GET_IDX_READ_FAIL            1302 - Unable to read queue index file.
GET_IDX_CLOSE_FAIL           1303 - Unable to close queue index file.
GET_NOT_FOUND_IN_IDX         1300 - The queue entry does not exist.
GET_DATA_OPEN_FAIL           1304 - Unable to open queue data file.
GET_DATA_READ_FAIL           1305 - Unable to read queue data file.
GET_DATA_CLOSE_FAIL          1306 - Unable to close queue data file.
GET_DATA_CHECKSUM_ERROR      1307 - Checksum error - queue is corrupted.
GET_MATCH_SUSPENDED_XFER     1308 - Search for matching suspended queue entry.
GET_NEXT_IDX_OPEN_FAIL       1401 - Unable to open queue index file.
GET_NEXT_IDX_READ_FAIL       1402 - Unable to read queue index file.
GET_NEXT_IDX_CLOSE_FAIL      1403 - Unable to close queue index file.
GET_NEXT_EMPTY_INDEX         1400 - Queue index is empty.
GET_ATTR_IDX_OPEN_FAIL       1501 - Unable to open queue index file.
GET_ATTR_IDX_READ_FAIL       1502 - Unable to read queue index file.
GET_ATTR_IDX_CLOSE_FAIL      1503 - Unable to close queue index file.
GET_ATTR_NOT_FOUND_IN_IDX    1500 - The queue entry does not exist.
PUT_ATTR_IDX_OPEN_FAIL       1601 - Unable to open queue index file.
PUT_ATTR_NOT_FOUND_IN_IDX    1600 - The queue entry does not exist.
PUT_ATTR_IDX_SEEK_FAIL       1602 - Unable to seek in queue index file.
PUT_ATTR_IDX_WRITE_FAIL      1603 - Unable to write into queue index file.
PUT_ATTR_IDX_CLOSE_FAIL      1604 - Unable to close queue index file
COMP_IDX_OPEN_FAIL           1701 - Unable to open queue index file.
COMP_IDX_CLOSE_FAIL          1702 - Unable to close queue index file.
COMP_IDX_REMOVE_FAIL         1703 - Unable to remove queue index.
COMP_TMP_OPEN_FAIL           1704 - Unable to open temporary file
COMP_TMP_WRITE_FAIL          1705 - Unable to write temporary file.
COMP_TMP_CLOSE_FAIL          1706 - Unable to close temporary file.
COMP_TMP_RENAME_FAIL         1707 - Unable to rename temporary file.
INQ_IDX_OPEN_FAIL            1801 - Unable to open queue index file.
INQ_IDX_CLOSE_FAIL           1802 - Unable to close queue index file.
INQ_INVALID_OPTION           1803 - Invalid option for inquiry function.
INQ_TYPE_UNSUPPORTED         1800 - Inquiry type not supported function.
LOCK_CANNOT_LOCK             1901 - Unable to lock queue.
LOCK_WAIT_TIMEOUT_EXCEEDED   1902 - Queue lock timeout.
LOCK_NAME_INCORRECT          1900 - Invalid queue name.
UNLOCK_CANNOT_UNLOCK         2001 - Unable to unlock queue.
UNLOCK_NAME_INCORRECT        2000 - Invalid queue name.
OPEN_ERR_CREATE_SEM          2100 - Unable to create semaphore.
OPEN_ERR_OPEN_SEM            2101 - Unable to open semaphore.
CLOSE_ERR_QUEUE_IN_USE       2201 - Queue is busy.
CLOSE_NAME_INCORRECT         2200 - Invalid queue name.
GET_STATS_IDX_OPEN_FAIL      2401 - Unable to open queue index file.
GET_STATS_IDX_READ_FAIL      2402 - Unable to read queue index file.
GET_STATS_IDX_CLOSE_FAIL     2403 - Unable to close queue index file.
GET_STATS_NOT_FOUND_IN_IDX   2400 - The queue entry does not exist.
PUT_STATS_IDX_OPEN_FAIL      2501 - Unable to open queue index file.
PUT_STATS_NOT_FOUND_IN_IDX   2500 - The queue entry does not exist.
PUT_STATS_IDX_SEEK_FAIL      2502 - Unable to seek in queue index file.
PUT_STATS_IDX_WRITE_FAIL     2503 - Unable to write into queue index file.
PUT_STATS_IDX_CLOSE_FAIL     2504 - Unable to close queue index file.
DUPLICATE_REMOTE_TRANSFER    2601 - Duplicate TID detected.
NO_QUEUE_CREATED             2701 - The XCOMD service is either down or the shared memory segment not accessible.