---

5. LIBQM Messages 1500-1599

---

1500	ERROR: Heuristic or one-phase commit - out of queue space
	Description	While executing the qcommittrans command to heuristically commit a transaction, qmadmin was unable to record the heuristic commit because the queue space had no more room for messages. If the IPC resources for the queue space are removed before the transaction manager asks about the status of the heuristically completed transaction, the status will be lost. This can also occur if the transaction manger does a one-phase commit. If the one-phase commit is interrupted before completion, the transaction may be inconsistent.
	Action	No action required.
	See Also	qmadmin(1)
1501	ERROR: Heuristic rollback - out of queue space
	Description	While executing the qrollbacktrans command to heuristically rollback a transaction, qmadmin was unable to record the heuristic rollback because the queue space had no more room for messages. If the IPC resources for the queue space are removed before the transaction manager asks about the status of the heuristically completed transaction, the status will be lost.
	Action	No action required.
	See Also	qmadmin(1)
1502	ERROR: xa_open() - system time is older than the last restart time
	Description	When opening (warm starting) a queue space, the current system time was found to be older than the last time that the queue space was started.
	Action	Re-set the system time appropriately.
1505	ERROR: Blocking factor must be numeric
	Description	While executing the qspacecreate command, a non-numeric blocking factor was specified.
	Action	Re-enter the qspacecreate command using a numeric blocking factor.
	See Also	qmadmin(1)
1507	ERROR: Must specify queue space name
	Description	While executing the qspacechange command, the queue space name specified is the null string (that is, the name was entered on the command line as "", or return was entered for the prompt for the Queue Space Name).
	Action	Re-enter the qspacechange command with the correct queue space name.
	See Also	qmadmin(1)
1508	ERROR: Queue space name length must be less than len characters
	Description	While executing the qspacechange command, the queue space name was too long (that is, len characters or more).
	Action	Re-enter the command with a queue space name that is 15 characters or less in length.
	See Also	qmadmin(1)
1510	ERROR: IPC key must be numeric
	Description	While executing the qspacechange command, a non-numeric IPC key was specified.
	Action	Re-enter the qspacechange command using a numeric value for the IPC key used to create the queue space shared memory and semaphores.
	See Also	qmadmin(1)
1512	ERROR: Transaction count must be numeric
	Description	While executing the qspacechange command, a non-numeric transaction count was specified.
	Action	Re-enter the qspacechange command using a numeric value for the maximum number of concurrent transactions in the queue space.
	See Also	qmadmin(1)
1514	ERROR: Process count must be numeric
	Description	While executing the qspacechange command, a non-numeric process count was specified.
	Action	Re-enter the qspacechange command using a numeric value for the maximum number of concurrent processes accessing the queue space.
	See Also	qmadmin(1)
1516	ERROR: Message count must be numeric
	Description	While executing the qspacechange command, a non-numeric message count was specified.
	Action	Re-enter the qspacechange command using a numeric value for the maximum number of messages concurrently stored in the queue space.
	See Also	qmadmin(1)
1518	ERROR: Error queue name length must be less than len characters
	Description	While executing the qspacechange command, the error queue name was too long (that is, len characters or more).
	Action	Re-enter the command with an error queue name that is 15 characters or less in length.
	See Also	qmadmin(1)
1521	ERROR: Blocking factor must be numeric
	Description	While executing the qspacechange command, a non-numeric blocking factor was specified.
	Action	Re-enter the qspacechange command using a numeric blocking factor.
	See Also	qmadmin(1)
1522	ERROR: Queue space change failed
	Description	While executing the qspacechange command, qmadmin failed to change the specified queue space parameters. There are many possible reasons for the failure and the specific reason is written to the standard output or the userlog.
	Action	Re-enter the command when the problem has been resolved.
	See Also	qmadmin(1)
1525	ERROR: List queue space - invalid parameter
	Description	While executing the qspacelist command, an invalid parameter was specified. The following are invalid: the device is not specified; the queue space name is not specified or is greater than 15 characters in length.
	Action	Re-enter the command with the correct parameters.
	See Also	qmadmin(1)
1526	ERROR: Queue space change - invalid parameter
	Description	While executing the qspacechange command, an invalid parameter was specified. The following are invalid: the IPC key is less than or equal to 0; the number of queues, transactions, processes, or messages is less than or equal to 0; the configuration device is not specified; or the queue space name is not specified or is greater than 15 characters in length. or the extent size is less than or equal to 0.
	Action	Re-enter the command with the correct parameters.
	See Also	qmadmin(1)
1527	ERROR: Queue space change - cannot lock queue space queue_space_name
	Description	While executing the qspacechange command, qmadmin failed to lock the QMCONFIG device for exclusive update.
	Action	Check the userlog for further information about the process that has the configuration locked. Re-enter the command after the configuration has been unlocked.
	See Also	qmadmin(1)
1528	ERROR: Queue space create - Memory allocation failure
	Description	An attempt to dynamically allocate memory from the operating system using malloc () failed while allocating a buffer based on the specified blocking factor.
	Action	Ensure that the operating system parameters are set correctly for the amount of memory on the machine and the amount of memory that can be used by a process. Reduce the memory usage on the machine or increase the amount of physical memory on the machine. Reduce the blocking factor specified when creating the queue space.
	See Also	qmadmin(1)
1529	ERROR: Add extent - Memory allocation failure
	Description	An attempt to dynamically allocate memory from the operating system using malloc () failed while allocating a buffer based on the specified blocking factor.
	Action	Ensure that the operating system parameters are set correctly for the amount of memory on the machine and the amount of memory that can be used by a process. Reduce the memory usage on the machine or increase the amount of physical memory on the machine. Reduce the blocking factor specified when changing the queue space.
	See Also	qmadmin(1)
1563	ERROR: QMCONFIG must be an absolute pathname
	Description	The value of QMCONFIG, the device containing the queue space, as specified on the qmadmin command line or in the shell environment is not an absolute pathname, meaning it does not begin with a /.
	Action	Specify a full pathname for the QMCONFIG environment variable or qmadmin command line argument.
	See Also	qmadmin(1)
1564	ERROR: Device name must be an absolute pathname
	Description	While executing the crdl command, the device name specified is not an absolute pathname, meaning it does not begin with a /.
	Action	Re-enter the command with an absolute pathname for the device name.
	See Also	qmadmin(1)
1565	ERROR: Device name must be an absolute pathname
	Description	While executing the chdl command, the device name specified is not an absolute pathname, meaning it does not begin with a /.
	Action	Re-enter the command with an absolute pathname for the device name.
	See Also	qmadmin(1)
1566	ERROR: Must specify queue space name
	Description	While executing the ipcrm command, the queue space name specified is the null string (that is, the name was entered on the command line as "", or return was entered for the prompt for the Queue Space Name).
	Action	Re-enter the ipcrm command with the correct queue space name.
	See Also	qmadmin(1)
1567	ERROR: Queue space name length must be less than len characters
	Description	While executing the ipcrm command, the queue space name was too long (that is, len characters or more).
	Action	Re-enter the command with a queue space name that is 15 characters or less in length.
	See Also	qmadmin(1)
1568	ERROR: Must specify queue space name
	Description	While executing the ipcs command, the queue space name specified is the null string (that is, the name was entered on the command line as "", or return was entered for the prompt for the Queue Space Name).
	Action	Re-enter the ipcs command with the correct queue space name.
	See Also	qmadmin(1)
1569	ERROR: Queue space name length must be less than len characters
	Description	While executing the ipcs command, the queue space name was too long (that is, len characters or more).
	Action	Re-enter the command with a queue space name that is 15 characters or less in length.
	See Also	qmadmin(1)
1570	ERROR: Must specify queue space name
	Description	While executing the qopen command, the queue space name specified is the null string (that is, the name was entered on the command line as "", or return was entered for the prompt for the Queue Space Name).
	Action	Re-enter the qopen command with the correct queue space name.
	See Also	qmadmin(1)
1571	ERROR: Queue space name length must be less than len characters
	Description	While executing the qopen command, the queue space name was too long (that is, len characters or more).
	Action	Re-enter the command with a queue space name that is 15 characters or less in length.
	See Also	qmadmin(1)
1572	ERROR: Must specify queue space name
	Description	While executing the qspacedestroy command, the queue space name specified is the null string (that is, the name was entered on the command line as "", or return was entered for the prompt for the Queue Space Name).
	Action	Re-enter the qspacedestroy command with the correct queue space name.
	See Also	qmadmin(1)
1573	ERROR: Queue space name length must be less than len characters
	Description	While executing the qspacedestroy command, the queue space name was too long (that is, len characters or more).
	Action	Re-enter the command with a queue space name that is 15 characters or less in length.
	See Also	qmadmin(1)
1574	ERROR: Invalid queue name
	Description	While executing the qset command, an invalid queue name was specified.
	Action	Use the qinfo command to get a list of the existing queue names. Re-execute the command with a valid queue name.
	See Also	qmadmin(1)
1575	ERROR: command - cannot change value that is not part of the queue ordering.
	Description	If command is qchangeprio, then the command was executed on a queue without the "priority" sort criteria. If command is qchangetime, then the command was executed on a queue without the "time" sort criteria.
	Action	Re-execute the command on a queue with the proper sort criteria.
	See Also	qmadmin(1)
1577	ERROR: xa_open() - failed to get enough semaphores
	Description	When opening (warm starting) a queue space, there were not enough system semaphores available.
	Action	The qsize command can be used to compute the number of semaphores needed. Either shut down other applications that are using semaphores, or increase the operating system semaphore parameters.
	See Also	qmadmin(1)
1578	ERROR: Destroy queue - queue messages involved in one or more transactions
	Description	The qdestroy, command was executed while transactions are outstanding for messages on that queue (either being enqueued or dequeued).
	Action	Re-execute the command again. It may be necessary to shut down any processes accessing the queue space.
	See Also	qmadmin(1)
1579	INFO: Queue list - no messages queue name
	Description	While executing the qlist command for queue name, no messages were found on the queue.
	Action	No action required.
	See Also	qmadmin(1)
1580	ERROR: Queue space change - ipckey is already used -- choose another one or check existing semaphores
	Description	While executing the qspacechange command, an IPC key was specified for which a semaphore already exists. This probably means that another application is using the IPC key.
	Action	Choose another IPC key and re-execute the command.
	See Also	qmadmin(1)
1582	ERROR: Change queue - invalid parameter
	Description	While executing the qchange command, an invalid parameter was specified. The following are invalid: an invalid out-of-order value; retries or delay time less than 0; the queue space name is not specified or greater than 15 characters in length; the upper threshold less than or equal to 0 or less than the lower threshold value; or an invalid threshold type or a threshold type of '%' with a upper threshold value greater than 100.
	Action	Re-enter the command with the correct parameters.
	See Also	qmadmin(1)
1585	ERROR: Queue change failed for queue name
	Description	While executing the qchange command, qmadmin failed to change the specified queue. There are many possible reasons for the failure and the specific reason is written to the standard output or the userlog.
	Action	Re-enter the command when the problem has been resolved.
	See Also	qmadmin(1)

---

---