Generalized command preprocessor messages (CSQ9...)
CSQ9000E'keyword' appears more than onceExplanation:The named keyword appears more than once in the command. This message will be issued for each occurrence of the keyword after the first.
System Action:Processing for the command is terminated.
System Programmer Response:Verify the command entry, and reissue the command correctly. See the WebSphere MQ Script (MQSC) Command Reference manual for information about the rules for building commands.
CSQ9001E'keyword' is invalidExplanation:The named keyword is unknown or undefined. It might be misspelled, or it might not be applicable to the command being processed.
System Action:Processing for the command is terminated.
System Programmer Response:Verify the command entry, and reissue the command correctly. See the WebSphere MQ Script (MQSC) Command Reference manual for information about the command.
CSQ9002EUnbalanced parentheses following 'keyword'Explanation:An invalid combination of parentheses has been found following the keyword keyword. A closing parenthesis must follow an opening parenthesis before any other opening parenthesis occurs.
System Action:Processing for the command is terminated.
System Programmer Response:Verify the command entry, and reissue the command correctly. See the WebSphere MQ Script (MQSC) Command Reference manual for information about the rules for building commands.
CSQ9003E'keyword' parameter contains unbalanced apostrophesExplanation:An odd number of apostrophes is present in a parameter value of keyword keyword. If the parameter is a quoted string, it must have one apostrophe at each end of the string. If an apostrophe is to appear within the string, two adjacent apostrophes must be entered. If the parameter is a hexadecimal value, it must be entered as X'hex-characters'.
System Action:Processing for the command is terminated.
System Programmer Response:Verify the command entry, and reissue the command correctly. See the WebSphere MQ Script (MQSC) Command Reference manual for information about the rules for building commands.
CSQ9004E'keyword' parameter specifies range (:) incorrectlyExplanation:A parameter of keyword keyword specifies a range of values incorrectly. The character used to denote a range is a colon (:); the format is lower-limit:upper-limit.
System Action:Processing for the command is terminated.
System Programmer Response:See the WebSphere MQ Script (MQSC) Command Reference manual to verify that the command you are using allows a range for the given keyword. Correct the error, and reissue the command.
CSQ9005E'keyword' parameter does not satisfy generic rulesExplanation:For the keyword keyword, parameter values may be generic, but the value specified does not conform to the rules for a generic value. Either:
- The value contains an asterisk (*) which is not the last character.
- The value contains a question mark (?) or colon (:).
- The keyword is WHERE and the value is a single asterisk.
System Action:Processing for the command is terminated.
System Programmer Response:Verify the command entry, correct the keyword parameter, and reenter the command. See the WebSphere MQ Script (MQSC) Command Reference manual for a description of the keyword and how to enter the command.
CSQ9006E'keyword' parameter uses asterisk (*) incorrectlyExplanation:For the keyword keyword, an asterisk (*) was used in a parameter value. Either:
- The asterisk was not the last or only character in the value. Incorrect examples are NAME(BL*CK) and NAME(*LUE); a correct specification is NAME(BL*) or NAME(*).
- There is a list of parameter values, for example DETAIL(1,*).
System Action:Processing for the command is terminated.
System Programmer Response:See the WebSphere MQ Script (MQSC) Command Reference manual to verify that the command you are using allows specification of '*' for the given keyword. Correct the error, and reissue the command.
CSQ9007EEither 'keyword1' or 'keyword2' must be specifiedExplanation:The command requires that either keyword keyword1 or keyword keyword2 is specified, but neither keyword was entered on the command. One of the two keywords must be present in order for the command to be processed.
System Action:Processing for the command is terminated.
System Programmer Response:Reissue the command and include whichever keyword is appropriate. See the WebSphere MQ Script (MQSC) Command Reference manual for descriptions of the two keywords, and for information about the rules for building commands.
CSQ9008E'keyword' may not be negatedExplanation:The negation characters (NO) appear in front of the keyword keyword, but negating this keyword is not allowed.
System Action:Processing for the command is terminated.
System Programmer Response:Verify the command entry, and reissue the command correctly. See the WebSphere MQ Script (MQSC) Command Reference manual for further information about this command.
CSQ9009E'keyword' not specifiedExplanation:The keyword keyword must be present, but it was not entered. This keyword must be present in order for the command to process properly.
System Action:Processing for the command is terminated.
System Programmer Response:Verify the command entry, and reissue the command including the specified keyword. See the WebSphere MQ Script (MQSC) Command Reference manual for further information about this command.
CSQ9010ERequired parameter for 'keyword' not specifiedExplanation:For the keyword keyword, either:
- One or more parameters must be specified, but no parameter was entered.
- A fixed number of parameters must be specified, but fewer parameters were entered.
For example, the keyword USERDATA must have a parameter that is a character string. Entering USERDATA() is meaningless; either enter a string (for example, USERDATA(MY_DATA)), or if you want to remove this attribute, enter USERDATA(' ').
System Action:Processing for the command is terminated.
System Programmer Response:Verify the command entry, supply appropriate parameters for the specified keyword, and reissue the command. See the WebSphere MQ Script (MQSC) Command Reference manual for further information about this command.
CSQ9011EParameter(s) not allowed for 'keyword'Explanation:No parameters can be specified for the keyword keyword. This message is issued for each invalid parameter, so it can be issued more than once for a command.
System Action:Processing for the command is terminated.
System Programmer Response:Verify the command entry, correct the error, and reissue the command. See the WebSphere MQ Script (MQSC) Command Reference manual for details on how to enter the command.
CSQ9012E'keyword' parameter is not hexadecimalExplanation:Parameter values for the keyword keyword must be hexadecimal values. Hexadecimal characters are the numeric digits 0 through 9 and the letters A through F, in either uppercase or lowercase. The value may optionally be specified using the hexadecimal string notation X'hex characters'; for example, keyword(123ABC) and keyword(X'123ABC') are synonymous.
System Action:Processing for the command is terminated.
System Programmer Response:Verify the command entry, and reissue the command, ensuring that the parameters for the named keyword are hexadecimal values.
CSQ9013E'keyword' parameter 'parameter-value' length is more than nnExplanation:The parameter value parameter-value for keyword keyword exceeds the limit of nn characters in length.
System Action:Processing for the command is terminated.
System Programmer Response:Verify the command entry. See the WebSphere MQ Script (MQSC) Command Reference manual for a list of acceptable parameters. Correct the error, and reissue the command.
CSQ9014EMore than nn parameter(s) for 'keyword'Explanation:Too many parameters have been specified for the keyword keyword. At most nn parameters can be specified. In addition to entering too many parameters, this could also be caused by a missing closing parenthesis that has not yet been detected.
System Action:Processing for the command is terminated.
System Programmer Response:Verify the command entry, and reissue the command, using no more than the specified limit of parameters for the given keyword. See the WebSphere MQ Script (MQSC) Command Reference manual for further details, and for information about the rules for building commands.
CSQ9015EParameter 'parameter-value' is unacceptable for 'keyword'Explanation:The parameter value parameter-value is not an acceptable value for keyword keyword. Either:
- The keyword parameter can be one of a set of character values, but the value specified is not one of them.
- The keyword parameter can be a bounded numeric value, but the value specified is outside the bounds.
- The keyword parameter can be either numeric or one of a set of character values, but the value specified is neither numeric nor one of the set.
- The keyword is WHERE and the first parameter (the filter keyword) is not one of the acceptable keywords for the command.
System Action:Processing for the command is terminated.
System Programmer Response:Verify the command entry, and reissue the command correctly. See the WebSphere MQ Script (MQSC) Command Reference manual for a list of acceptable values, and for information about the rules for building commands.
CSQ9016E'cmd' command request not authorizedExplanation:The command requires a level of authorization that you do not have, either for the command itself, or for the resource that it is operating on.
System Action:The command is not executed. Processing is terminated.
Operator Response:If the command must be executed on behalf of the user and your installation operating procedures permit it, enter the command on request.
System Programmer Response:Contact the system programmer responsible for system security, and request that this person grant you authorization to use the command. Otherwise, you must have someone who is authorized issue the command for you.
CSQ9017EFailure while processing 'cmd' commandExplanation:The command preprocessor ended abnormally while processing the command shown in the message. The error is recorded in SYS1.LOGREC, and an SVC dump is requested. The command might have partially completed. Look at any previous response messages to determine what has been done.
System Action:Processing for the command is terminated.
System Programmer Response:Verify the command entry, and reissue the command. If it fails again, collect the items listed in the Problem Determination section, and contact your IBM support center.
Problem Determination:Collect the following diagnostic items:
- A description of the action(s) that led to the error, or if applicable, a listing of the application program, or the input string to a utility program, being run at the time of the error
- Queue manager job log
- System dump resulting from the error
- The WebSphere MQ, z/OS, DB2, CICS, and IMS service levels
CSQ9018Ecsect-name Insufficient storage to process 'cmd' commandExplanation:The command preprocessor was unable to obtain sufficient storage to complete processing of any response messages generated by the command.
System Action:Processing for the command is terminated abnormally.
Operator Response:Notify the system programmer before attempting to reissue the command.
System Programmer Response:If the problem persists, you might need to increase the region size used by your queue manager or channel initiator, or you might need to reduce the number of jobs running in your system.
Problem Determination:The invoked command had completed processing and returned to the command preprocessor when an attempt was made to obtain storage from the address space from which the command was entered. Because sufficient storage was unavailable, no response messages from the invoked command are available.
CSQ9019E'cmd' command is invalidExplanation:The command, which starts with cmd, is invalid. This could be because:
- the command verb is unknown
- no keywords were specified, or none were specified that are valid as a secondary keyword for the command
- there is syntax error at the start of the command
System Action:Processing for the command is terminated.
System Programmer Response:Verify the command entry, and reissue the command correctly. See the WebSphere MQ Script (MQSC) Command Reference manual for the correct command format, and for information about the rules for building commands.
CSQ9020E'keyword1' and 'keyword2' cannot both be specifiedExplanation:The command does not allow keyword keyword1 and keyword keyword2 to be specified together.
System Action:Processing for the command is terminated.
System Programmer Response:Verify the command entry, and reissue the command, omitting the inappropriate keyword. See the WebSphere MQ Script (MQSC) Command Reference manual for descriptions of the two keywords and how to enter the command.
CSQ9022Icsect-name 'cmd' NORMAL COMPLETIONExplanation:All synchronous processing for the command completed successfully. Any tasks executing asynchronously on behalf of the command might still be executing when this message is displayed.
System Action:Synchronous processing for the command is complete.
CSQ9023Ecsect-name 'cmd' ABNORMAL COMPLETIONExplanation:The command has not completed successfully. The command has issued one or more error messages prior to this message.
System Action:Processing for the command has ended.
System Programmer Response:Follow the instructions for the other messages associated with the error.
CSQ9025E'parameter-value' is unacceptable with 'WHERE' parameter 'filter-keyword'Explanation:The parameter values for the WHERE keyword are incompatbile. The WHERE keyword must have three parameters, filter-keyword, operator, and filter-value. The error is one of the following:
- The operator parameter is not appropriate for the type of parameter values that the filter keyword requires. For example, the filter keyword requires one of a set of parameter values, but the operator is not EQ or NE.
- The filter value parameter exceeds the length limit for parameter values of the filter keyword.
- The filter value parameter is not a value that is valid as a value of the filter keyword. For example:
- The filter keyword requires a numeric parameter value but the filter value parameter is not numeric.
- The filter keyword requires one of a set of parameter values but the filter value parameter is not one of them.
- The filter keyword requires a bounded numeric parameter value but the filter value parameter is outside the bounds.
- The filter keyword requires an object or system name, but the filter value parameter does not consist only of characters that are valid for such a name.
Depending on the error, parameter-value may be the operator parameter or the filter value parameter.
System Action:Processing for the command is terminated.
System Programmer Response:Verify the command entry, and reissue the command correctly. See the WebSphere MQ Script (MQSC) Command Reference manual for information about the parameters for the WHERE keyword.
CSQ9026E'keyword' parameter does not satisfy name rulesExplanation:Parameter values for the keyword keyword are names, and therefore must consist only of characters that are valid for the particular type of name, object name or system name. The valid object name characters are uppercase A-Z, lowercase a-z, numerics 0-9, period (.), forward slash (/), underscore (_), and percent sign (%). The valid system name characters are uppercase A-Z, and numerics 0-9; the first character must not be numeric.
This message is issued if the name specified contains invalid characters, or if the name is all blank in cases where an all-blank name is not allowed.
System Action:Processing for the command is terminated.
System Programmer Response:Verify the command entry, and reissue the command ensuring that the parameters for the named keyword are of the required type. See the WebSphere MQ Script (MQSC) Command Reference manual for a description of the keyword and how to enter the command.
CSQ9028E'keyword' parameter is not numericExplanation:Parameter values for the keyword keyword must consist of numeric values only.
System Action:Processing for the command is terminated.
System Programmer Response:Verify the command entry, and reissue the command ensuring that the parameters for the named keyword are of the required type. See the WebSphere MQ Script (MQSC) Command Reference manual for a description of the keyword and how to enter the command.
CSQ9029Ecsect-name Failure while processing a commandExplanation:An error occurred while processing a command. The command might or might not have been executed. The error has been recorded in the system error log (the SYS1.LOGREC data set), and an SVC dump was attempted.
We can get this message if you have insufficient ECSA.
System Action:Processing for the command is terminated.
System Programmer Response:Verify the command entry, and reissue the command. If we cannot resolve the problem, collect the items listed in the Problem Determination section, and contact your IBM support center.
Problem Determination:Collect the following diagnostic items:
- A description of the action(s) that led to the error, or if applicable, a listing of the application program, or the input string to a utility program, being run at the time of the error.
- Queue manager job log
- System dump resulting from the error
- The WebSphere MQ, z/OS, DB2, CICS, and IMS service levels
CSQ9030E'keyword' parameter may not be genericExplanation:The parameter for the keyword keyword specifies a generic value using an asterisk (for example, ABC*), but a generic value is not allowed for that keyword.
System Action:Processing for the command is terminated.
System Programmer Response:Verify the command entry, correct the keyword parameter, and reenter the command. See the WebSphere MQ Script (MQSC) Command Reference manual for a description of the keyword and how to enter the command.
CSQ9031ESyntax error following 'keyword'Explanation:The text that follows the named keyword contains invalid syntax. This is typically caused by specifying an incorrect sequence of special characters, such as equals (=), comma (,), colon (:), or parentheses.
System Action:Processing for the command is terminated.
System Programmer Response:Verify the command entry, examining the text following the named keyword. Ensure that you have followed the rules for command entry, and reenter the command. See the WebSphere MQ Script (MQSC) Command Reference manual for information about the rules for building commands.
CSQ9032ERequested function is not availableExplanation:An attempt was made to invoke a command processor that was not loaded.
System Action:The requested function is not performed.
System Programmer Response:Verify the command entry, to determine which command caused the error.
CSQ9033ECommand exceeds allowable lengthExplanation:The command is so large that its internal form has exceeded the maximum length allowed. The size of the internal form of the command is affected by both the length, and the complexity of the command. (For example, an attempt has been made to use the operations and control panels to create a namelist containing too many names.)
This message could also be caused by commands entered through one of the following:
- the initialization input data sets
- the COMMAND function of the utility program CSQUTIL
- a user-written program that puts commands onto the system-command input queue, SYSTEM.COMMAND.INPUT
Severity:8
System Action:Processing of the command is terminated.
System Programmer Response:If you are using the operations and control panels to define a namelist, use the edit facility to reduce the number of names in the list. If you are entering a command from elsewhere, determine which command caused the error, and verify the syntax of that command from the WebSphere MQ Script (MQSC) Command Reference manual. Correct the command.
CSQ9034ECommand cannot be issued using command serverExplanation:An attempt was made to issue a command using the command server. The command cannot be issued in that way.
The command server is used by commands entered through one of the following:
- the COMMAND function of CSQUTIL
- the CSQINPX initialization input data set of the channel initiator
- a user-written program that puts commands onto the system-command input queue, SYSTEM.COMMAND.INPUT
Severity:8
System Action:The command is ignored.
CSQ9035Ecsect-name Required keyword not specifiedExplanation:The command requires one of a set of alternative keywords to be specified, but none was.
Severity:8
System Action:Processing for the command is terminated.
System Programmer Response:Verify the command entry, and reissue the command correctly. See the WebSphere MQ Script (MQSC) Command Reference manual for the proper format of the command, and for information about the rules for building commands.
CSQ9036ECommand with 'keyword>(parameter-value)' not allowed when queue manager is activeExplanation:The command has the specified parameter value for keyword keyword. The command with this keyword and value can be issued only when the queue manager is not active.
Severity:8
System Action:The command is ignored.
System Programmer Response:See the WebSphere MQ Script (MQSC) Command Reference manual for information about how to use the command.
CSQ9037ECommand must be issued from ddnameExplanation:An attempt was made to issue a command from the specified initialization input data set. The command cannot be issued from that data set.
Severity:8
System Action:The command is ignored.
System Programmer Response:See the WebSphere MQ Script (MQSC) Command Reference manual for information about how to use the command.
CSQ9038ECommand must be issued from consoleExplanation:An attempt was made to issue a command from other than the z/OS console or its equivalent. The command can only be issued in that way.
Severity:8
System Action:The command is ignored.
System Programmer Response:Issue the command from the z/OS console; it cannot be issued from elsewhere.
See the WebSphere MQ Script (