Generalized command preprocessor messages (CSQ9...)

CSQ9000E: 'keyword' appears more than once
Explanation: 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 Running MQSC commands from text files for information about the rules for building commands.

CSQ9001E: 'keyword' is invalid
Explanation: 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 MQSC commands for information about the command.

CSQ9002E: Unbalanced 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 Running MQSC commands from text files for information about the rules for building commands.

CSQ9003E: 'keyword' parameter contains unbalanced apostrophes
Explanation: 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 Running MQSC commands from text files for information about the rules for building commands.

CSQ9004E: 'keyword' parameter specifies range (:) incorrectly
Explanation: 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 MQSC commands to verify that the command we are using allows a range for the given keyword. Correct the error, and reissue the command.

CSQ9005E

'keyword' parameter does not satisfy generic rules

Explanation

For the keyword keyword, parameter values can be generic, but the value specified does not conform to the rules for a generic value. The value does not conform to these rules due to one of the following reasons:

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 MQSC commands for a description of the keyword and how to enter the command.

CSQ9006E

'keyword' parameter uses asterisk (*) incorrectly

Explanation

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 MQSC commands to verify that the command we are using allows specification of '*' for the given keyword. Correct the error, and reissue the command.

CSQ9007E: Either 'keyword1' or 'keyword2' must be specified
Explanation: 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 MQSC commands for descriptions of the two keywords. See Running MQSC commands from text files for information about the rules for building commands.

CSQ9008E: 'keyword' may not be negated
Explanation: 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 Running MQSC commands from text files for further information about this command.

CSQ9009E: 'keyword' not specified
Explanation: 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 MQSC commands for further information about this command.

CSQ9010E

Required parameter for 'keyword' not specified

Explanation

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; we must either enter a string (for example, USERDATA(MY_DATA)), or if we want to remove this attribute, we must 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 MQSC commands for further information about this command.

CSQ9011E: Parameter(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 Running MQSC commands from text files for details on how to enter the command.

CSQ9012E: 'keyword' parameter is not hexadecimal
Explanation: 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 can 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 nn
Explanation: 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 MQSC commands for a list of acceptable parameters. Correct the error, and reissue the command.

CSQ9014E

More 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 MQSC commands for further details. See Running MQSC commands from text files for information about the rules for building commands.

If this error occurs while we are using connection names with the CSQUTIL program we must enclose certain variables within single quotation marks. See CSQUTIL for more information.

CSQ9015E

Parameter '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 MQSC commands for a list of acceptable values. See Running MQSC commands from text files for information about the rules for building commands.

CSQ9016E: 'cmd' command request not authorized
Explanation: The command requires a level of authorization that we 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.
System programmer response: Contact the system programmer responsible for system security, and request that this person grant you authorization to use the command. Otherwise, we must have someone who is authorized issue the command for you.

CSQ9017E: Failure while processing 'cmd' command
Explanation: 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 the IBM support center.

CSQ9018E: csect-name Insufficient storage to process 'cmd' command
Explanation: 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.
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 the system.

CSQ9019E

'cmd' command is invalid

Explanation

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 MQSC commands for the correct command format. See Running MQSC commands from text files for information about the rules for building commands.

CSQ9020E: 'keyword1' and 'keyword2' cannot both be specified
Explanation: 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 MQSC commands for descriptions of the two keywords. See Running MQSC commands from text files for information about the rules for building commands.

CSQ9022I: csect-name 'cmd' NORMAL COMPLETION
Explanation: 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.

CSQ9023E: csect-name 'cmd' ABNORMAL COMPLETION
Explanation: 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 incompatible. 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 MQSC commands for information about the parameters for the WHERE keyword.

CSQ9026E

'keyword' parameter does not satisfy name rules

Explanation

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 MQSC commands for a description of the keyword. See Running MQSC commands from text files for information about the rules for building commands.

CSQ9028E: 'keyword' parameter is not numeric
Explanation: 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 MQSC commands for a description of the keyword. See Running MQSC commands from text files for information about the rules for building commands.

CSQ9029E

csect-name Failure while processing a command

Explanation

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 the IBM support center.

CSQ9030E: 'keyword' parameter may not be generic
Explanation: 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 MQSC commands for a description of the keyword. See Running MQSC commands from text files for information about the rules for building commands.

CSQ9031E: Syntax 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 we have followed the rules for command entry, and reenter the command. Running MQSC commands from text files for information about the rules for building commands.

CSQ9032E: Requested function is not available
Explanation: 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.

CSQ9033E

Command exceeds allowable length

Severity

Explanation

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

System action

Processing of the command is terminated.

System programmer response

If we 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 we are entering a command from elsewhere, determine which command caused the error, and verify the syntax of that command from MQSC commands. Correct the command.

CSQ9034E

Command cannot be issued using command server

Severity

Explanation

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

System action

The command is ignored.

CSQ9035E: csect-name Required keyword not specified
Severity: 8
Explanation: The command requires one of a set of alternative keywords to be specified, but none was.
System action: Processing for the command is terminated.
System programmer response: Verify the command entry, and reissue the command correctly. See MQSC commands for the proper format of the command. See Running MQSC commands from text files for information about the rules for building commands.

CSQ9036E: Command with 'keyword(parameter-value)' not allowed when queue manager is active
Severity: 8
Explanation: 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.
System action: The command is ignored.
System programmer response: See MQSC commands for information about how to use the command.

CSQ9037E: Command must be issued from ddname
Severity: 8
Explanation: An attempt was made to issue a command from the specified initialization input data set. The command cannot be issued from that data set.
System action: The command is ignored.
System programmer response: See MQSC commands for information about how to use the command.

CSQ9038E

Command must be issued from console

Severity

Explanation

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.

System action

The command is ignored.

System programmer response

Issue the command from the z/OS console; it cannot be issued from elsewhere.

If we issued the DEFINE PSID command from the console, we must include the additional DSN parameter for the command to complete successfully.

See MQSC commands for information about how to use the command.

CSQ9039E: Command cannot be issued from console
Severity: 8
Explanation: An attempt was made to issue a command from the z/OS console or its equivalent. The command cannot be issued in that way.
System action: The command is ignored.
System programmer response: See MQSC commands for information about how to use the command.

CSQ9040E: Command cannot be issued from ddname
Severity: 8
Explanation: An attempt was made to issue a command from the specified initialization input data set. The command cannot be issued from that data set.
System action: The command is ignored.
System programmer response: See MQSC commands for information about how to use the command.

CSQ9041E: Command not allowed during restart
Severity: 8
Explanation: An attempt was made to issue a command before restart had completed, but the command cannot be issued at that time. This could be because the command was in the CSQINP1 initialization input data set.
System action: The command is ignored.
System programmer response: If the command was in the CSQINP1 initialization input data set, delete it.

CSQ9042E: Command with 'keyword()' cannot be issued from ddname
Severity: 8
Explanation: The command was issued with the specified keyword from an initialization input data set. The command with this keyword cannot be issued from that data set.
System action: The command is ignored.
System programmer response: See MQSC commands for information about how to use the command.

CSQ9045E: 'keyword' has parameter(s) and is a 'WHERE' parameter
Explanation: The command specifies the WHERE keyword with a filter keyword parameter keyword. That keyword is also specified explicitly with with parameters, which is not allowed.
System action: Processing for the command is terminated.
System programmer response: Verify the command entry, and reissue the command correctly. See MQSC commands for information about the parameters for the WHERE keyword.

Parent topic: Messages for IBM MQ for z/OS