MQWB11xx: REST API messages

MQWB1100I
MQWB1100I: The <insert_0> command completed successfully.
MQWB1101E
MQWB1101E: Argument <insert_0> requires other prerequisite arguments.
Explanation
The combination of supplied arguments is invalid.
Response
Reissue the command with the correct arguments.
MQWB1102E
MQWB1102E: Mandatory arguments missing from command.
Explanation
Mandatory arguments missing from command.
Response
Reissue the command with the correct arguments.
MQWB1103E
MQWB1103E: No value specified for argument <insert_0>.
Explanation
The specified argument requires a value.
Response
Reissue the command with the argument and value.
MQWB1104E
MQWB1104E: Unknown arguments specified.
Explanation
The specified argument is not valid for the command.
Response
Validate the command syntax and reissue the command.
MQWB1105E
MQWB1105E: Unknown command scope specified <insert_0>.
Explanation
The specified command scope is not valid for the command.
Response
Validate the command syntax and reissue the command.
MQWB1106E
MQWB1106E: Failed to execute native command <insert_0>.
Explanation
A request was made to execute a native command however the operation was unsuccessful. Reasons for the failure may include a shortage of available system resources or a problem with the command to be started.
Response
Ensure that the correct operating environment has been initialised. The Operating System error recording facilities should also be consulted for information relating to shortage of system resources.
MQWB1107E
MQWB1107E: Unexpected exception caught <insert_0>.
Explanation
An exception has been thrown which is not otherwise handled.
Response
Use the message from the exception to resolve the problem if possible, if necessary, seek assistance from IBM support.
MQWB1108E
MQWB1108E: Program <insert_0> cannot be run with root privileges.
Explanation
A request was made to execute a program, however the operation was unsuccessful because the program cannot be run with root privileges.
Response
Reissue the command under a non-root user.
MQWB1109E
MQWB1109E: Unable to locate MQ installation and data directories.
Explanation
The location of the MQ installation and data directories could not be established.
Response
On z/OS, ensure that the WLP_USER_DIR environment variable is set correctly. On all other platforms contact your IBM support representative.
MQWB1110E
MQWB1110E: Permission denied when attempting to run program <insert_0>
Explanation
A request was made to execute a program, however the operation was unsuccessful because the IBM MQ operating environment has insufficient permissions to access the program file.
Response
Check the access permissions of the program to be executed and if necessary alter them to include execute permission for the IBM MQ user ID. Also check that the IBM MQ user ID has search access on all directories which compose the path to the program file.
MQWB1111E
MQWB1111E: Program <insert_0> cannot be located
Explanation
The program cannot be found.
Response
Check that the program specified is available on your system and ensure that the correct operating environment has been initialised.
MQWB1112E
MQWB1112E: Incorrect argument specified with corresponding argument <insert_0>.
Explanation
The combination of supplied arguments is invalid.
Response
Reissue the command with the correct arguments.
MQWB1113E
MQWB1113E: Configuration file <insert_0> cannot be located.
Explanation
The configuration file is not in the expected location.
Response
Check that the expected file exists in the correct location and has not been moved or renamed. If the file cannot be recovered, seek assistance from IBM support.
MQWB1114E
MQWB1114E: Permission denied when attempting to read configuration file <insert_0>.
Explanation
A request was made to read the configuration file, however the operation was unsuccessful because the IBM MQ operating environment has insufficient permissions to read the file.
Response
Check the access permissions of the file to be read and if necessary alter them to include read permission for the IBM MQ user ID. Also check that the IBM MQ user ID has search access on all directories which compose the path to the file.
MQWB1115E
MQWB1115E: The specified command is not applicable for the IBM MQ Appliance.
Explanation
The specified command can not be issued when operating on the IBM MQ Appliance.
MQWB1116E
MQWB1116E: Specified property <insert_0> is invalid.
Explanation
The specified property is not recognised as a valid property.
Response
Refer to IBM Documentation for a list of valid properties and reissue the command.
MQWB1117E
MQWB1117E: Set the JAVA_HOME environment variable and rerun the command.
Explanation
The JAVA_HOME environment variable has not been initialised.
Response
Set the JAVA_HOME environment variable to refer to your Java installation and reissue the command.
MQWB1118E
MQWB1118E: An unexpected internal error has occurred.
Explanation
An unexpected internal error has occurred.
Response
Contact your IBM support representative.
MQWB1119E
MQWB1119E: The WLP_USER_DIR environment variable was not specified.
Explanation
The WLP_USER_DIR environment variable must be specified for this command to locate the mqweb server definition.
Response
Set the WLP_USER_DIR environment variable so that it refers to the mqweb server definition and reissue the command.
MQWB1120E
MQWB1120E: Permission denied when attempting to update configuration file <insert_0>.
Explanation
A request was made to update the configuration file, however the operation was unsuccessful because the IBM MQ operating environment has insufficient permissions to update the file.
Response
Check the access permissions of the file to be updated and if necessary alter them to include write permission for the IBM MQ user ID. Also check that the IBM MQ user ID has search access on all directories which compose the path to the file.
MQWB1121E
MQWB1121E: The status of the mqweb server applications cannot be determined.
Explanation
A request was made to read the status of the deployed mqweb server applications, however the data was not available. This may indicate that there is already an mqweb server started on this system, probably related to another IBM MQ instance.
Response
Check the startup logs for the mqweb server, looking in particular for conflicting usage of network ports. Ensure that if you have multiple mqweb servers on a system, they are configured to use distinct network ports. Restart the mqweb server and ensure it started correctly. If the problem persists, seek assistance from IBM support.
MQWB1122I
MQWB1122I: No user-defined properties could be found.
Explanation
A request was made to display the user-defined mqweb server properties, but none have been defined.
MQWB1123E
MQWB1123E: The status of the mqweb server applications cannot be determined.
Explanation
A request was made to read the status of the deployed mqweb server applications, however the data appears corrupt. This may indicate that there is already an mqweb server started on this system, probably related to another IBM MQ instance.
Response
Check the startup logs for the mqweb server, looking in particular for conflicting usage of network ports. Ensure that if you have multiple mqweb servers on a system, they are configured to use distinct network ports. Restart the mqweb server and ensure it started correctly. If the problem persists, seek assistance from IBM support.
MQWB1124I
MQWB1124I: Server <insert_0> is running.
MQWB1125I
MQWB1125I: Server <insert_0> is not running.
MQWB1126E
MQWB1126E: Directory <insert_0> does not exist.
Explanation
The directory does not exist. This message might also be issued if the current user ID has insufficient permissions to access the directory.
Response
Investigate why the directory does not exist, recreate it, and reissue the command. If the directory cannot be recreated, seek assistance from IBM support. Ensure that the user ID that the command runs under has permission to access to directory.
MQWB1127E
MQWB1127E: <insert_0> is not a directory.
Explanation
The path name exists but is not a directory.
Response
Investigate why the path exists but is not a directory, recreate it as a directory, and reissue the command. If the directory cannot be recreated, seek assistance from IBM support.
MQWB1128E
MQWB1128E: Permission denied when attempting to read from directory <insert_0>.
Explanation
The current user ID has insufficient permissions to read from the directory.
Response
Check the access permissions of the directory and if necessary alter them to include read permission for the current user ID. Then reissue the command.
MQWB1129E
MQWB1129E: Permission denied when attempting to write to directory <insert_0>.
Explanation
The current user ID has insufficient permissions to write to the directory.
Response
Check the access permissions of the directory and if necessary alter them to include write permission for the current user ID. Then reissue the command.
MQWB1130E
MQWB1130E: Directory <insert_0> is expected to contain <insert_1> file(s) but actually contains <insert_2> file
Explanation
An unexpected number of files was found in the directory.
Response
If the directory has previously been manually altered, undo the alteration, and reissue the command, otherwise seek assistance from IBM support.
MQWB1131E
MQWB1131E: The contents of <insert_0> is incorrect.
Explanation
The contents of the mqweb.properties file is incorrect. It should contain two properties, one called com.ibm.websphere.productInstall which should be a path, and another called com.ibm.websphere.productId which should have a value of either com.ibm.mqvue or com.ibm.mqadv.
Response
If the mqweb.properties file has previously been manually altered, correct the contents of the file, and reissue the command, otherwise seek assistance from IBM support.
MQWB1132E
MQWB1132E: Directory <insert_0> did not contain the expected properties file. Expected product ID is <insert_1>.
Explanation
The directory should contain a single properties file called either mqVue.properties or mqAdvancedVue.properties. The property file should match the specified product ID.
Response
If the directory, or its contents, have previously been manually altered, undo the alteration, and reissue the command, otherwise seek assistance from IBM support.
MQWB1133I
MQWB1133I: The product ID of the mqweb server has been set to <insert_0>.
MQWB1134E
MQWB1134E: The product ID should be one of: MQ, VUE, ADVANCEDVUE.
Explanation
The value of the -p argument is not correct.
Response
Correct the value of the -p argument and reissue the command.
MQWB1135E
MQWB1135E: Command only supported on z/OS.
Explanation
This command is only supported on z/OS.
Response
Read the IBM MQ documentation to understand which commands are supported on the current operating system.
MQWB1136E
MQWB1136E: The properties files in <insert_0> are not correct.
Explanation
The directory should contain an mq.properties file. It should not contain either of the mqVue.properties or mqAdvancedVue.properties files.
Response
If either the mqVue.properties or mqAdvancedVue.properties files exist in the directory then delete them. If the mq.properties file does not exist then copy it from the MQ_USS_INSTALL/web/mq/etc directory. Then reissue the command.
MQWB1137E
MQWB1137E: The contents of the <insert_0> file is incorrect.
Explanation
The file is expected to contain at most one WLP_PRODUCT_EXT_DIR property. The value of this property must be the WLP_USER_DIR/mqweb_extension directory.
Response
If the file has previously been manually altered, undo the alteration, and reissue the command, otherwise seek assistance from IBM support. Note that this file might contain other properties in addition to WLP_PRODUCT_EXT_DIR.
MQWB1138E
MQWB1138E: The WLP_PRODUCT_EXT_DIR property is not set in <insert_0> but the product extension directory <insert_1> exists.
Explanation
The product extension directory should only exist if the WLP_PRODUCT_EXT_DIR is set.
Response
Delete the product extension directory and reissue the command.
MQWB1139I
Usage: setmqweb pid -p PID [ -l ] [ -? ]nn -p The product ID that the mqweb server will run as. Use MQ for @MQBASEPID@, VUE for @MQVUEPID@, or ADVANCEDVUE for @MQADVPID@.n -l Enable verbose logging.n -? Print this help message.
MQWB1140I
Usage: crtmqweb [ target_directory ] -p PID [ -l ] [ -? ]nn target_directory Target directory for the mqweb server configuration
MQWB1141E
MQWB1141E: Directory <insert_0> is not empty.
Explanation
The directory is expected to be empty but is not.
Response
Delete the contents of the directory and reissue the command, or specify a different directory.
MQWB1142W
MQWB1142W: chtag of <insert_0> failed.
Explanation
An attempt was made to use chtag to set the CCSID of the file, or the contents of the directory, to ISO8859-1.
Response
If you do not use tools which rely on file tagging then ignore this message. Otherwise consider issuing the chtag command to resolve the issue.
MQWB1143I
Usage: setmqweb
MQWB1144E
MQWB1144E: The queue manager identifier can contain only the following characters: 0-9 A-Z a-z - _
Explanation
The value of the queue manager identifier parameter is not correct.
Response
Correct the value of the queue manager identifier parameter and reissue the command.
MQWB1145E
MQWB1145E: The contents of the remote queue manager configuration file <insert_0> is incorrect.
Explanation
The remote queue manager configuration file should contain valid JSON created by the setmqweb remote command.
Response
Correct the contents of the remote queue manager configuration file if it has been edited. If necessary, recreate the file using the setmqweb remote -r command.
MQWB1146E
MQWB1146E: Error writing to file <insert_0>.
Explanation
An error occurred when attempting to write to the indicated file. This might indicate that the IBM MQ operating environment has insufficient permissions to update or create the file.
Response
Check the access permissions of the file, if it exists, and if necessary alter them to include write permission for the IBM MQ user ID. Also check that the IBM MQ user ID has write permission to the directory that contains the file, and search access on all other directories which compose the path to the file.
MQWB1147I
Enter a value for <insert_0>:
MQWB1148E
MQWB1148E: No remote queue manager defined with identifier <insert_0>.
Explanation
There is no remote queue manager defined with the identifier specified.
Response
Re-enter the command, specifying a valid queue manager identifier. To list the identifiers of all remote queue managers that are defined, use the command dspmqweb remote -li.
MQWB1149E
MQWB1149E: Property <insert_0> is required.
Explanation
The specified property is required for a remote queue manager definition. It must be specified when adding a new remote queue manager, and cannot be removed.
Response
Ensure that the required property is specified when adding a new remote queue manager definition. When updating the remote queue manager configuration, do not attempt to delete the specified property.
MQWB1150E
MQWB1150E: Encryption key file <insert_0> does not exist or cannot be read.
Explanation
An encryption key file was specified, but the file either does not exist or cannot be accessed.
Response
Ensure that the correct encryption key file is specified, that the encryption key file exists, and that the user running the command has read access to the file.
MQWB1151I
MQWB1151I: Configuration file <insert_0> created.
Explanation
The specified configuration file has been created.
Response
Ensure that the owner and permissions are set appropriately for the configuration file that has been created.
MQWB1152E
MQWB1152E: Argument <insert_0> is specified more than once.
Explanation
The specified command argument can only be specified once.
Response
Validate the command syntax and reissue the command.
MQWB1153E
MQWB1153E: Encryption key file <insert_0> is not correctly formatted.
Explanation
The contents of the specified password encryption key file is not in the correct format.
Response
Ensure that the password encryption key file contains at least one character, and only one line of text.
MQWB1154E
MQWB1154E: An error occurred when encrypting a password.
Explanation
An error occurred when encrypting a password to be stored in the remote queue manager configuration.
Response
Investigate the cause of the error in the exception that follows this message.
MQWB1155E
MQWB1155E: Unknown argument <insert_0> specified.
Explanation
The specified argument is not valid for the command.
Response
Validate the command syntax and reissue the command.
MQWB1156E
MQWB1156E: Duplicate entry found.
Explanation
The remote queue manager definition already exists. If you are trying to update an entry, remove the 'add' parameter.
Response
Validate the command syntax and reissue the command.
MQWB1157E
MQWB1157E: Argument <insert_0> is not the correct type.
Explanation
The specified command argument must be a boolean. That is, the value must be true or false.
Response
Validate the command syntax and reissue the command.
MQWB1158E
MQWB1158E: Configuration arguments missing from command.
Explanation
A request was made to update the configuration file, however no arguments were provided.
Response
Reissue the command with the additional arguments.