Q Messages 1100-1199

1100

ERROR: Invalid option - option

Description

An invalid option, option, was specified on the qmadmin command line.

Action

Select the appropriate option(s) from the usage line that follows the error message.

See Also

qmadmin(1)

1101

ERROR: QMCONFIG not set

Description

The value of QMCONFIG, the device containing the queue space, was not specified on the qmadmin command line or in the shell environment.

Action

The QMCONFIG environment variable must be set and exported or must be specified on the qmadmin command line.

See Also

qmadmin(1)

1102

ERROR: Invalid argument arg

Description

An invalid argument, arg, was specified on the qmadmin command line following the QMCONFIG value.

Action

Select the appropriate command line option(s) and argument from the usage line that follows the error message.

See Also

qmadmin(1)

1104

ERROR: Failed to get status of qmconfig_device

Description

qmadmin was unable to get the status of the device, qmconfig_device, specified for QMCONFIG.

Action

Check that QMCONFIG is properly set to a raw disk slice or a regular file accessible to qmadmin, or to a file name to be created in an existing directory.

See Also

qmadmin(1)

1105

ERROR: Effective user id, userid, must match the owner of QMCONFIG, qmconfig_userid

Description

qmadmin was run by a user whose effective user identifier, userid, is not the same as the owner of the device specified for QMCONFIG, qmconfig_userid.

Action

Change the ownership of the QMCONFIG device or file, or run the program as the corresponding user.

See Also

qmadmin(1)

1107

ERROR: Must have white space following quoted string

Description

While entering a qmadmin command, a double quoted string was entered without white space, spaces and/or tabs, preceding and following the string.

Action

Re-enter the command line surrounding any quoted strings with white space (spaces and/or tabs).

See Also

qmadmin(1)

1108

ERROR: No matching double quote

Description

While entering a qmadmin command, a double quoted string was started without a matching quote to terminate the string.

Action

Re-enter the command line with matching double quotes.

See Also

qmadmin(1)

1109

ERROR: Failed to execute command, errno = errno

Description

A shell command, command, was specified for execution using the qmadmin exclamation mark (!) command, but the shell command failed to execute. The error number, errno, is printed as part of the message.

Action

Check that the PATH environment variable is set appropriately and that the shell command to be executed exists, and re-enter the command.

See Also

qmadmin(1)

1110

ERROR: Syntax -

Description

An invalid option or argument was entered for a qmadmin command. The correct syntax is printed as part of the message as syntax.

Action

Re-enter the command with the correct syntax.

See Also

qmadmin(1)

1111

ERROR: Command command not found

Description

A command, command, was entered that does not exist in qmadmin.

Action

Use the help command to get a list of valid qmadmin commands.

See Also

qmadmin(1)

1120

ERROR: Queue space must be opened first

Description

A qmadmin command was executed before a queue space was opened. This can happen with the queue commands qcreate, qchangeprio, qchangequeue, qchangetime, qdeletemsg, qdestroy, qinfo, qlist, qprinttrans, qaborttrans, qcommittrans, and qset.

Action

Open a queue space using the qopen command and re-enter the command.

See Also

qmadmin(1)

1121

WARN: xa_close() returned rc

Description

The xa_close() function was called to close the currently open queue space as part of executing a qmadmin command (qaddext, qclose, qopen, qspacecreate, qspacedestroy, or quit) and it returned an error, rc.

Action

Further information about the cause of the failure should be printed in the userlog. Check the userlog for further information.

See Also

qmadmin(1)

1122

ERROR: Queue name must be set with qset

Description

A qmadmin command (qchangeprio, qchangequeue, qchangetime, qdeletemsg, or qlist) was executed without setting the target queue name using the qset command.

Action

Execute the qinfo command to get a list of queues in the queue space. Select a queue name in currently open queue space by executing qset and re-enter the command.

See Also

qmadmin(1)

1125

ERROR: Cannot read the device list

Description

While executing the chdl command, qmadmin failed to read the volume table of contents and universal device list associated with QMCONFIG.

Action

Check to see that QMCONFIG is set correctly (that the device or file exists) and has been properly initialized, and re-enter the command. The livtoc command can be used to list the current volume table of contents and lidl can be used to list the current universal device list.

See Also

qmadmin(1)

1126

ERROR: Invalid device index

Description

While executing the chdl command, a device index was specified for a device that has not been created on the universal device list associated with the QMCONFIG device.

Action

Use the lidl command to list the current contents of the universal device list and re-enter the chdl command with a valid device index.

1129

ERROR: Device name length must be less than len characters

Description

While executing the chdl command, the new device name was too long (that is, len characters or more).

Action

Re-enter the command with a device name that is 64 characters or less in length.

See Also

qmadmin(1)

1130

ERROR: Cannot lock the device list

Description

While executing the chdl 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)

1131

ERROR: Cannot read the device list

Description

While executing the chdl command, qmadmin failed to re-read the volume table of contents and universal device list associated with QMCONFIG after locking the configuration for exclusive access.

Action

Check to see that the device or file specified by QMCONFIG still exists, is properly initialized, and re-enter the command. The livtoc command can be used to list the current volume table of contents and lidl can be used to list the current universal device list.

See Also

qmadmin(1)

1132

ERROR: Invalid device index

Description

While executing the chdl command, a device index was specified for a device that has not been created on (or has been deleted from) the universal device list associated with the QMCONFIG device.

Action

Use the lidl command to list the current contents of the universal device list and re-enter the chdl command with a valid device index.

1133

ERROR: Cannot write the device list

Description

While executing the chdl command, the update of the universal device list associated with the QMCONFIG device failed.

Action

Check the userlog for any messages and use the lidl command to list the current contents of the universal device list.

See Also

qmadmin(1)

1135

ERROR: Device name length must be less than len characters

Description

While executing the crdl command, the device name was too long (that is, len characters or more).

Action

Re-enter the command with a device name that is 64 characters or less in length.

See Also

qmadmin(1)

1140

ERROR: Cannot create device device, offset offset, size size on config

Description

The operation to create a new extent on the universal device list, UDL, during the execution of crdl failed. The device name, device, offset value, offset, extent size, size, and configuration device, config, are printed in the message. If the QMCONFIG file exists, this command can fail if the file open fails; if a read on the device fails; if the file is not a configuration file; or if the file is not a normal file or a raw device (for example, a fifo file). If the file doesn't exist, the command can fail if file creation fails (for example, if the directory in which the file is to be created doesn't exist). The command can also fail if it failed to lock the configuration file; if there are no slots available in the UDL; if the extent to be created overlaps with an existing device on the UDL; if the first entry is being created and the device doesn't match QMCONFIG or the offset is not 0 or there is not enough space allocated to store the UDL and volume table of contents; or if a write fails on the device.

Action

Check that the device specified is correct, the directory exists, and that the extent doesn't overlap with existing devices that are listed with the lidl command.

See Also

qmadmin(1)

1145

WARN: Device not destroyed

Description

While destroying a device with the dsdl command, the user did not respond with Y or y to the prompt for confirmation and the operation was not done.

Action

No action required.

See Also

qmadmin(1)

1146

ERROR: Cannot list device dlindex on config

Description

While executing the dsdl command, qmadmin failed to get the status of the specified device entry, dlindex, for the QMCONFIG device, config. Either device index is invalid or qmadmin was unable to open and read the universal device list, or config does not contain a valid configuration.

Action

Check that the device is correct and check the universal device list with the lidl command.

See Also

qmadmin(1)

1147

ERROR: Cannot destroy device dlindex on config

Description

While executing the dsdl command, qmadmin failed to destroy the device entry for the specified dlindex and QMCONFIG device, config. The command can fail if it can't lock the configuration exclusively for update; if it can't open and read the universal device list, UDL; if dlindex is 0 and the UDL has other entries or the volume table of contents, VTOC, has tables other than the VTOC and UDL.

Action

Check that the device is correct and check the universal device list with the lidl command.

See Also

qmadmin(1)

1151

ERROR: Command command not found

Description

While executing the help command, an invalid command name was specified.

Action

Execute the help command without any arguments to get a complete list of available commands.

See Also

qmadmin(1)

1154

WARN: IPC resources not removed

Description

While removing IPC resources with the ipcrm command and the -f option specified, the user did not respond with Y or y to the prompt for confirmation and the operation was not done.

Action

No action required.

See Also

qmadmin(1)

1157

ERROR: Device list not initialized on config

Description

The lidl command was executed for a configuration, config, that is not initialized (that is, for a device or file that does not exist, or does not have at least one device defined in the universal device list). This message can also occur if the user does not have proper permissions to access the device.

Action

Check that the configuration device or file specified for QMCONFIG is correct and initialize it using the crdl command. Also check the permissions on the device or file.

See Also

qmadmin(1)

1166

ERROR: Cannot get VTOC on config

Description

The livtoc command was executed for a configuration, config, that is not initialized (that is, for a device or file that does not exist, or does not have at least one device defined in the universal device list).

Action

Check that the configuration device or file specified for QMCONFIG is correct and initialize it using the crdl command.

See Also

qmadmin(1)

1172

ERROR: Must specify queue space name

Description

While executing the qaddext 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 qaddext command with the correct queue space name.

See Also

qmadmin(1)

1173

ERROR: Queue space name length must be less than len characters

Description

While executing the qaddext 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)

1176

ERROR: Failed to add extent

Description

While executing the qaddext command, qmadmin failed to add the extent. There are many possible reasons for the failure and the specific reason is written to the standard output or the userlog ranging from an invalid queue space name to other processes being attached to the queue space.

Action

Re-enter the command when the problem has been resolved.

See Also

qmadmin(1)

1177

WARN: No queue space is currently open

Description

The qclose command was executed when a queue space is not currently open.

Action

No action required.

See Also

qmadmin(1)

1179

ERROR: Queue name length must be less than len characters

Description

While executing the qcreate or qchange command, the queue name was too long (that is, len characters or more).

Action

Re-enter the command with a queue name that is 15 characters or less in length.

See Also

qmadmin(1)

1181

ERROR: 'fifo' specified multiple times

Description

While executing the qcreate command, the 'fifo' option was specified multiple times for the queue ordering value. The values 'fifo', 'lifo', 'priority', 'expiration' and 'time' may be entered once; 'fifo' and 'lifo' may not both be specified and must be specified as the last (least significant) option. Multiple values may be specified separated by commas.

Action

Re-enter the qcreate command specifying a valid value for the queue ordering option.

1182

ERROR: 'lifo' specified multiple times

Description

While executing the qcreate command, the value 'lifo' was specified multiple times for the queue ordering argument. The values 'fifo', 'lifo', 'priority', 'expiration' and 'time' may be entered once; 'fifo' and 'lifo' may not both be specified and must be specified as the last (least significant) option. Multiple values may be specified separated by commas.

Action

Re-enter the qcreate command specifying a valid value for the queue ordering argument.

See Also

qmadmin(1)

1183

ERROR: 'priority' specified multiple times

Description

While executing the qcreate command, the value 'priority' was specified multiple times for the queue ordering argument. The values 'fifo', 'lifo', 'priority', 'expiration' and 'time' may be entered once; 'fifo' and 'lifo' may not both be specified and must be specified as the last (least significant) option. Multiple values may be specified separated by commas.

Action

Re-enter the qcreate command specifying a valid value for the queue ordering argument.

See Also

qmadmin(1)

1184

ERROR: 'time' specified multiple times

Description

While executing the qcreate command, the value 'fifo' was specified multiple times for the queue ordering argument. The values 'fifo', 'lifo', 'priority', 'expiration' and 'time' may be entered once; 'fifo' and 'lifo' may not both be specified and must be specified as the last (least significant) option. Multiple values may be specified separated by commas.

Action

Re-enter the qcreate command specifying a valid value for the queue ordering argument.

See Also

qmadmin(1)

1185

ERROR: Invalid queue ordering

Description

While executing the qcreate command, an argument other than 'fifo', 'lifo', 'priority', 'expiration' or 'time' was specified for the queue ordering value or an invalid format was entered. The values 'fifo', 'lifo', 'priority', 'expiration' and 'time' may be entered once; 'fifo' and 'lifo' may not both be specified and must be specified as the last (least significant) option. Multiple values may be specified separated by commas.

Action

Re-enter the qcreate command specifying a valid value for the queue ordering argument.

See Also

qmadmin(1)

1186

ERROR: Device name for entry 0 must match QMCONFIG - device

Description

While executing the chdl command, device entry 0 is being changed and the new device name does not match the value for the QMCONFIG environment variable (or the configuration device specified on the command line). The device must match QMCONFIG for entry 0 so that the software can find the Volume Table of Contents and Device List.

Action

chdl is used to re-name a device. If re-naming the device for entry 0, first copy, move, or re-name the device, then set QMCONFIG to match the new device name, and then re-enter the chdl command specifying the QMCONFIG name for the device name.

See Also

qmadmin(1)

1187

ERROR: 'fifo/lifo' must be last in sort order

Description

While executing the qcreate command, a 'fifo' or 'lifo' value was specified in the queue ordering argument prior to the 'priority', 'expiration' or 'time' option, or both 'fifo' and 'lifo' were specified. The values 'fifo', 'lifo', 'priority', 'expiration' and 'time' may be entered once; 'fifo' and 'lifo' may not both be specified and must be specified as the last (least significant) option. Multiple values may be specified separated by commas'

Action

Re-enter the qcreate command specifying a valid value for the queue ordering argument.

See Also

qmadmin(1)

1189

ERROR: Cannot specify 'none' with any other argument for out-of-order option

Description

While executing the qcreate or qchange command, the value 'none' was specified with either 'top' or 'msgid' in the out-of-order enqueuing argument. The values 'top' and/or 'msgid' may be entered once or the value may be 'none' (with no other arguments). Multiple values may be specified separated by commas.

Action

Re-enter the qcreate or qchange command specifying a valid value for the out-of-order enqueuing argument.

See Also

qmadmin(1)

1190

ERROR: Queue name must be specified

Description

While executing the qcreate or qchange command, the queue name was not entered at the prompt or an empty string was specified on the command line.

Action

Re-enter the qcreate or qchange command specifying a valid queue name.

See Also

qmadmin(1)

1191

ERROR: Cannot specify 'none' with any other argument for out-of-order option

Description

While executing the qcreate or qchange command, the value 'none' was specified with either 'top' or 'msgid' in the out-of-order enqueuing argument. The values 'top' and/or 'msgid' may be entered once, or the value may be 'none' (with no other arguments). Multiple values may be specified separated by commas.

Action

Re-enter the qcreate or qchange command specifying a valid value for the out-of-order enqueuing argument.

See Also

qmadmin(1)

1192

ERROR: 'top' specified multiple times

Description

While executing the qcreate or qchange command, the value 'top' was specified more than once in the out-of-order enqueuing argument. The values 'top' and/or 'msgid' may be entered once or the value may be 'none' (with no other arguments). Multiple values may be specified separated by commas.

Action

Re-enter the qcreate or qchange command specifying a valid value for the out-of-order enqueuing argument.

See Also

qmadmin(1)

1193

ERROR: Cannot specify 'none' with any other argument for out-of-order option

Description

While executing the qcreate or qchange command, the value 'none' was specified with either 'top' or 'msgid' in the out-of-order enqueuing argument. The values 'top' and/or 'msgid' may be entered once or the value may be 'none' (with no other arguments). Multiple values may be specified separated by commas.

Action

Re-enter the qcreate or qchange command specifying a valid value for the out-of-order enqueuing argument.

See Also

qmadmin(1)

1194

ERROR: 'msgid' specified multiple times

Description

While executing the qcreate or qchange command, the value 'msgid' was specified more than once in the out-of-order enqueuing argument. The values 'top' and/or 'msgid' may be entered once or the value may be 'none' (with no other arguments). Multiple values may be specified separated by commas.

Action

Re-enter the qcreate or qchange command specifying a valid value for the out-of-order enqueuing argument.

See Also

qmadmin(1)

1195

ERROR: Invalid out-of-order option

Description

While executing the qcreate or qchange command, a value other than 'top', 'msgid' or 'none' was entered for the out-of-order enqueuing argument, or the value is not formatted correctly. The values 'top' and/or 'msgid' may be entered once or the value may be 'none' (with no other options). Multiple values may be specified separated by commas.

Action

Re-enter the qcreate or qchange command specifying a valid value for the out-of-order enqueuing argument.

See Also

qmadmin(1)