Parser error messages (CBKxx2800-3999)

The following messages are issued by the command parser for input parameters and commands. The command parser is a common component that issues messages on behalf of the following:

CBKxx2800E
Unknown or non-unique command. Request terminated.
Explanation:

The command being processed is either unknown or the abbreviation is not unique. The command is the first word within the input string.

System action:

The command is not processed.

User response:

Correct the command and retry.

Destination:

Console (communication server), message log (batch request utility), or 3270 terminal issuing the CICS BAC transaction.

CBKxx2801E
Invalid end of parameter string. Parameter string must end with a ‘)'.
Explanation:

The last non-blank character in a parameter value string is not a right parenthesis.

System action:

The command is not processed.

User response:

Each parameter value string must be enclosed in parentheses. Correct the input string and retry.

Destination:

Console (communication server), message log (batch request utility), or 3270 terminal issuing the CICS BAC transaction.

CBKxx2802E
Parameter at offset offset too long. Maximum parameter length is sixteen characters.
Explanation:

The input string being processed contains a command or parameter that is longer than the maximum of 16 characters. The offset value indicates the position of the field that is in error within the input string.

System action:

The command is not processed.

User response:

Correct the input string and retry.

Destination:

Console (communication server), message log (batch request utility), or 3270 terminal issuing the CICS BAC transaction.

CBKxx2803E
Unable to locate end of parameter beginning at offset offset.
Explanation:

The command processor cannot find the end of a parameter in an input string. The relative offset value indicates the position of the parameter that is in error.

System action:

The command is not processed.

User response:

Correct the input string and retry.

Destination:

Console (communication server), message log (batch request utility), or 3270 terminal issuing the CICS BAC transaction.

CBKxx2804E
Unknown parameter beginning at offset offset.
Explanation:

The command parser cannot identify the parameter. The offset value indicates the location of the unidentified parameter.

System action:

The command is not processed.

User response:

Correct the input string and retry.

Destination:

Console (communication server), message log (batch request utility), or 3270 terminal issuing the CICS BAC transaction.

CBKxx2805E
Length of parameter value beginning at offset offset is incorrect for associated parameter.
Explanation:

The command parser has detected that an operand is the wrong length for the parameter with which it is associated. This means it could be either too long or, in some cases, too short. The offset value indicates the position of the invalid value.

System action:

The command is not processed.

User response:

Correct the operand and retry.

Destination:

Console (communication server), message log (batch request utility), or 3270 terminal issuing the CICS BAC transaction.

CBKxx2806E
Expecting separator character "," at offset offset. Not found.
Explanation:

While parsing an input string, the parser was expecting the separator character (comma), but it found a different character. The offset value indicates the position of the unexpected character.

System action:

The command is not processed.

User response:

Correct the input string and retry.

Destination:

Console (communication server), message log (batch request utility), or 3270 terminal issuing the CICS BAC transaction.

CBKxx2807E
Invalid character in parameter value at offset offset.
Explanation:

The parser has found an invalid character in an operand field in an input string. The offset value indicates the position of the invalid character.

System action:

The command is not processed.

User response:

Correct the operand and retry.

Destination:

Console (communication server), message log (batch request utility), or 3270 terminal issuing the CICS BAC transaction.

CBKxx2808E
Invalid value for CICSSTARTMODE value at offset offset. SET or UPDATE required.
Explanation:

The operand value for the CICSSTARTMODE parameter is invalid. The valid values are SET and UPDATE. The offset value indicates the position of the invalid operand.

System action:

The command is not processed.

User response:

Correct the operand and retry.

Destination:

Console or 3270 terminal issuing the CICS BAC transaction.

CBKxx2809E
Invalid value for keyword parameter at offset offset. Possibly too high or low.
Explanation:

The parser has found an invalid numeric operand for the parameter keyword. For example, the operand value might be too high, too low, or contain non-numeric characters. The offset value indicates the position of the invalid operand.

System action:

The command is not processed.

User response:

Correct the numeric operand and retry.

Destination:

Console (communication server), message log (batch request utility), or 3270 terminal issuing the CICS BAC transaction.

CBKxx2810E
Command at offset offset too long. Maximum command length is sixteen characters.
Explanation:

The length of the command in the input string is too long. The maximum length of a valid command is 16 characters. The offset value indicates the position of the command in error.

System action:

The command is not processed.

User response:

Correct the input string and retry.

Destination:

Console (communication server), message log (batch request utility), or 3270 terminal issuing the CICS BAC transaction.

CBKxx2811E
Non-unique parameter beginning at offset offset.
Explanation:

There is a non-unique parameter in an input command, which means that it could be an abbreviation for more than one paraemter. The offset value indicates the position of the non-unique parameter.

System action:

The command is not processed.

User response:

Re-enter the command, ensuring that the parameter in error is a unique abbreviation.

Destination:

Console (communication server), message log (batch request utility), or 3270 terminal issuing the CICS BAC transaction.

CBKxx2814E
keyword1 keyword is mutually exclusive with the keyword2 keyword.
Explanation:

The command being processed contains both the keyword1 and keyword2 parameters. These two parameters are mutually exclusive for this command.

System action:

The command is not processed.

User response:

Remove the redundant parameter from the command and retry.

Destination:

Message log

CBKxx2815E
OPENSTATUS value at offset offset is invalid. OPEN or CLOSED required.
Explanation:

The operand value for the OPENSTATUS parameter is invalid. The valid values are OPEN and CLOSED. The offset value indicates the position of the invalid operand.

System action:

The batch request utility rejects the command.

User response:

Re-enter the command with a valid operand on the OPENSTATUS parameter.

Destination:

Message log

CBKxx2816E
ENABLESTATUS value at offset offset is invalid. ENABLE or DISABLE required.
Explanation:

The operand value for the ENABLESTATUS parameter is invalid. The valid values are ENABLE and DISABLE. The offset value indicates the position of the invalid operand.

System action:

The command is not processed.

User response:

Re-enter the command with a valid operand on the ENABLESTATUS parameter.

Destination:

Message log

CBKxx2817E
keyword value at offset offset is invalid. YES or NO required.
Explanation:

The operand value for the keyword parameter is invalid. The valid values are YES and NO. The offset value indicates the position of the invalid operand.

System action:

The command is not processed.

User response:

Re-enter the command with a valid operand on the parameter keyword.

Destination:

Message log

CBKxx2818E
DSN value at offset offset is invalid. PRIMARY or ALTERNATE required.
Explanation:

The operand value specified on the DSN parameter is invalid. The valid values are PRIMARY and ALTERNATE. The offset value indicates the position of the invalid operand.

System action:

The command is not processed.

User response:

Re-enter the command with a valid operand on the DSN parameter.

Destination:

Message log

CBKxx2820E
OPENSTATUS and ENABLESTATUS parameters missing. One or the other is required for a SET object command.
Explanation:

You have specified a SET object command that does not contain either the OPENSTATUS or the ENABLESTATUS parameter, and at least one of these is required on a SET object command.

System action:

The command is not processed.

User response:

Re-enter the command with at least one of the OPENSTATUS or ENABLESTATUS parameters to the command.

Destination:

Message log

CBKxx2821E
keyword parameter missing. It is required for a SET object command.
Explanation:

You have specified a SET object command without the required keyword.

System action:

The command is not processed.

User response:

Add the required parameter to the command and retry.

Destination:

Message log

CBKxx2822E
DISPOSITION value at offset offset is invalid. SHR or OLD required.
Explanation:

The operand value for the DISPOSITION parameter is invalid. The valid values are SHR and OLD. The offset value indicates the position of the invalid operand

System action:

The command is not processed.

User response:

Re-enter the command with either SHR or OLD on the DISPOSITION parameter.

Destination:

Message log

CBKxx2823E
Required object parameter is missing. FILE, TDQUEUE, TRANSID, PROGRAM, GROUP or LIST is required.
Explanation:

The SET command read by the batch request utility does not contain a valid object. The valid object parameters are FILE, TDQUEUE, TRANSID, PROGRAM, GROUP, and LIST.

System action:

The command is not processed.

User response:

Add the required object parameter to the command and retry.

Destination:

Message log

CBKxx2824E
Unable to determine CICS to send this request to.
Explanation:

The batch request utility is processing a command that does not specify a CICS applid, and the utility does not have a default applid either. This could be because the most recent DEFAULT command did not specify the CICS parameter, un-setting one that was defined earlier. The CICS parameter is needed, either on the command itself, or as a previously specified default value, to determine which CICS region to send the request to.

System action:

The command is not processed.

User response:

Add the CICS parameter to either the current command, the most recent DEFAULT command or to a new DEFAULT command and retry.

Destination:

Message log

CBKxx2825E
Request is not in command format. First field should contain the command name.
Explanation:

The first field in the input string is not a command, that is, it is in parameter format instead of command format. Parameter format means that the field is followed immediately, in the next character position, by an operand enclosed in parentheses. In command format the first field is followed by a blank.

System action:

The command is not processed.

User response:

Correct the command syntax to specify a command name in the first field and retry.

Destination:

Message log

CBKxx2826E
field is not the name of a valid command.
Explanation:

The first field in the input string, denoted by field, is not the name of a valid command. The valid command names are DEFAULT, LINK, RUNCEMT, SET and START.

System action:

The command is not processed.

User response:

Specify a valid command in the first field of the statement and retry.

Destination:

Message log

CBKxx2827E
Parameter keyword at offset offset has already been specified.
Explanation:

The parameter keyword is specified more than once in the current statement. The offset value indicates the position of the second occurrence.

System action:

The command is not processed.

User response:

Remove the duplicate parameter and retry.

Destination:

Message log

CBKxx2828E
NOTACTIVE value at offset offset is invalid. CONTINUE or TERMINATE required.
Explanation:

The NOTACTIVE operand value is invalid. The valid values for NOTACTIVE are CONTINUE and TERMINATE. The offset value indicates the position of the invalid operand.

System action:

The command is not processed.

User response:

Specify CONTINUE or TERMINATE on the NOTACTIVE parameter and retry.

Destination:

Message log

CBKxx2829E
keyword1 is not specified. It is required with the keyword2 parameter.
Explanation:

The command contains keyword2 but not keyword1. You must specify keyword1 parameter if you specify keyword2 .

System action:

The command is not processed.

User response:

Either remove the keyword2 parameter or add the keyword1 parameter and retry.

Destination:

Message log

CBKxx2830E
keyword is not specified. It is required with the command command.
Explanation:

The command does not contain keyword , which is a required parameter for the command command.

System action:

The command is not processed.

User response:

Add the required parameter to the command and retry.

Destination:

Message log

CBKxx2831E
Unable to locate end of operand for keyword parameter. Expected ‘)' not found.
Explanation:

The closing parenthesis is not present at the end of the operand for keyword. Instead, the parser has reached the end of the command string

System action:

The command is not processed.

User response:

This is probably because your command statement does not have the correct number of opening and closing parentheses within the operand value. You can nest open and close parentheses within an operand value, but each open parenthesis must be matched with a closing parenthesis. Check that the number of close parentheses matches the number of open parentheses for the operand.

Destination:

Message log