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

Document ID : KB000009352
Last Modified Date : 01/08/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.
Things to check:

  1. Insufficient permissions on the %XCOM_HOME%\Q directory and/or 000026.idx file.  Lack of access to the queue folder by the userid used in a transfer. Add the userid(s) in question to the permission list for the Q directory and for xcom.log.
  2. Verify the xcom.tid is listing the correct 6 digit you would expect to be the next transfer in the queue. Otherwise delete the file or put a 6 digit number in there and recycle xcomd.
  3. We have seen this happen when the file system is almost full.  Check the file system or hard drive space.
  4. The shared memory segment is not available or accessible. In Linux or UNIX, check on the shared memory segments. 
  5. Program version mismatch. Was XCOM recently upgraded?  Please send in install log from uninstall directory to CA support.

Please also refer to KB000056038 Queue Corruption and Maintenance.
See also KB000009380  XCOMU0602E Unable to QUEUE: Cannot Create Data File or Queue is Full

Please contact CA Support if you need assistance.

Additional Information:

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.