Summary -

In this topic, we described about the 16 INVREQ with detailed example.

If this error condition occurred, the task gets abnormally terminated.

CommandRESP2, Description & Solution
DELAY 4 - Hours are out of range.

Solution: - Modify the program logic to limit the hours value with in the range.

5 - Minutes are out of range.

Solution: - Modify the program logic to limit the minutes value with in the range.

6 - Seconds are out of range.

Solution: - Modify the program logic to limit the seconds value with in the range.
DELETE 20 - Delete operations are not allowed according to the resource definition.

Solution: - Change the resource definitions if the deletion is valid or do not perform delete if the file definitions are correct.

21 - Command is issued for a file referring to a VSAM ESDS.

Solution: - You can’t delete the record from a VSAM ESDS. Change the program to remove the delete command.

22 - A GENERIC DELETE is issued for a file that is not a VSAM KSDS.

Solution: - GENERIC option applicable to VSAM KSDS only. Change the program to remove the delete command.

25 - The KEYLENGTH and GENERIC options specified and the length value in the KEYLENGTH option is greater than or equal to the length of a full key.

Solution: - When a KEYLENGTH and GENERIC options specified, it is a generic key and the length value should be less than the length of the full key. Change the program to modify the length value.

26 - The KEYLENGTH option is specified and the length does not equal the length defined for the data set.

Solution: - If only KEYLENGTH option specified, the length value should match the dataset full key. Change the program to modify the length value.

27 - Command is issued for a file referring to a BDAM data set.

Solution: - You can’t delete the record from a BDAM dataset. Change the program to remove the delete command.

31 - Command without the RIDFLD option is issued for a file where no previous READ UPDATE command has been issued.

Solution: - The record should be locked first to delete it from file and RIDFLD plays important role in it. Change the program to make sure the READ UPDATE should be preceded before DELETE command.

42 - The KEYLENGTH and GENERIC options are specified, and the length in the KEYLENGTH option is less than zero.

Solution: - When a KEYLENGTH and GENERIC options specified, it is a generic key and the length value should be less than the length of the full key and should be greater than zero. Change the program to modify the length value.

47 - Command includes a token whose value can’t be matched against any token in use for an existing READ with UPDATE request.

Solution: - DELETE command token value should be matched with READ UPDATE token value. Change the program to modify the token value.

51 - Command specifying the RBA or XRBA keyword is issued against a KSDS file that is being accessed in RLS mode.

Solution: - RBA or XRBA option is not valid for KSDS file accessing in RLS mode. Modify the program to remove RBA option for files which are accessing in RLS mode.

55 - NOSUSPEND is specified for a non-RLS file.

Solution: - NOSUSPEND option is valid for only VSAM files accessed in RLS mode. Modify the program to remove NOSUSPEND option for files which are not accessing in RLS mode.

59 - XRBA was specified, but the data set is not an extended ESDS.

Solution: - XBRA only for extended ESDS. Modify the program to remove XBRA option for writing the files other than extended ESDS.
DELETEQ TD Occurs if deleting an extra-partition queue.

Solution: - This might occur when deleting a queue which is already gets deleted. Debug the program flow to correct it.
DELETEQ TS Queue name specifies consisting of binary zeroes or queue locked and waiting for ISC recovery or queue created by CICS internal code.

Solution: - If queue name consists binary zeroes, modify the queue name and try again.If the queue is recoverable TSQ and waiting for ISC recovery, wait until the TSQ is recovered.If the queue is created by CICS internal code, use some other name for TSQ and try again.
ENDBR 35 - The REQID, SYSID or file name does not match any successful STARTBR command.

Solution: - Modify the programming logic to pass the correct values to ENDBR command that matches with previous STARTBR command.
FORMATTIME 1 - The ABSTIME value is less than zero or not in packed-decimal format.

Solution: - Modify the program logic to pass valid value to the ABSTIME.

2 - Invalid CVDA value for the STRINGFORMAT option.

Solution: - Modify the program logic to pass valid value to the CVDA.
FREEMAIN 1 - The storage specified by the DATA or DATAPOINTER parameter is not storage acquired by a GETMAIN command.

Solution: - Modify the application program to specify the correct storage in FREEMAIN request.

2 - The storage area specified by the DATA or DATAPOINTER parameter is in key storage and the program issuing the FREEMAIN command is in user-key.

Solution: - FREEMAIN command should not be issued on storage area in key. The storage automatically gets released. Modify the program to remove the FREEMAIN command.
HANDLE AID The command was issued by a distributed program link server application.

Solution: - The command issued from remote server application and the key pressed is invalid. Check the valid key options and press the allowable keys only.Solution: - The command issued from remote server application and the key pressed is invalid. Check the valid key options and press the allowable keys only.
LINK 8 - A LINK command with the INPUTMSG option is issued for a program that is not associated with a terminal, or that is associated with an APPC logical unit, or an IRC session.

Solution: - LINK with INPUTMSG option should be issued from a program that is associated with local terminal or APPC logical unit or an IRC session. Modify the program to remove it.

14 - The SYNCONRETURN option is specified but the program issuing the link request is already in conversation with a mirror task in the remote region specified on the SYSID option.

Solution: - In this case, the client program is in an incorrect state to support the SYNCONRETURN option. Modify the program to remove it.

15 - The program issuing the link request is already in conversation with a mirror task and the TRANSID specified is different from the transaction identifier of the active mirror.

Solution: - Correct the transaction id in the program if required to be different or contact the system administrator if the behaviour is as expected.

16 - The TRANSID specified is all blanks.

Solution: - Modify the Application program if the transaction is coded or debug the program if the transaction is passing from somewhere else.

17 - The TRANSID supplied by the dynamic routing program is all blanks.

Solution: - Debug the program why the transaction id having all blanks and correct it.

19 - A LINK command with the INPUTMSG option is issued for a program that is the subject of a DPL request.

Solution: - LINK with INPUTMSG should not be coded in the program invoked by DPL. Modify the application program to correct it.
LOAD 30 - The program manager domain is not yet initialized.

Solution: - This might be because the load request was made in a first stage PLT. Contact the system administrator to resolve the error.
POP HANDLE Occurs if no matching PUSH HANDLE command has been executed at the current link level.

Solution: - Modify the application program to remove the currently executing POP HANDLE command. Every PUSH HANDLE should have corresponding POP HANDLE, not more or not less.
READ 20 - READ is not allowed according to the resource definition.

Solution: - Change the resource definitions if the deletion is valid or do not perform delete if the file definitions are correct.

25 - The KEYLENGTH, GENERIC options specified and the length in the KEYLENGTH option is greater than or equal to the length of a full key.

Solution: - When a KEYLENGTH and GENERIC options specified, it is a generic key and the length value should be less than the length of the full key. Change the program to modify the length value.

26 - The KEYLENGTH option is specified but the GENERIC option is not specified, and the length specified does not equal the length defined for the data set.

Solution: - If only KEYLENGTH option specified, the length value should match the dataset full key. Change the program to modify the length value.

28 - Following a READ UPDATE command without TOKEN, another READ UPDATE without TOKEN was issued against the same file without an REWRITE, DELETE without RIDFLD, UNLOCK, or SYNCPOINT command in middle.

Solution: - Two READ UPDATE commands should not be issued side by side without specified TOKEN value. Because the same TOKEN value assumed. Change the program to modify the logic.

42 - The KEYLENGTH, GENERIC options and the length specified in the KEYLENGTH option is less than zero.

Solution: - When a KEYLENGTH and GENERIC options specified, it is a generic key and the length value should be less than the length of the full key and should be greater than zero. Change the program to modify the length value.

51 - A READ to a KSDS file that is being accessed in RLS mode specifies the RBA keyword.

Solution: - RBA option is not valid for KSDS file accessing in RLS mode. Modify the program to remove RBA option for files which are accessing in RLS mode.

55 - NOSUSPEND is specified on a READ request to a non-RLS mode file.

Solution: - NOSUSPEND option is valid for only VSAM files accessed in RLS mode. Modify the program to remove NOSUSPEND option for files which are not accessing in RLS mode.

59 - XRBA was specified, but the data set is not an extended ESDS.

Solution: - XBRA only for extended ESDS. Modify the program to remove XBRA option for writing the files other than extended ESDS.Solution: - Change the resource definitions if the deletion is valid or do not perform delete if the file definitions are correct.
READNEXT 20 - The FILE definition does not allow updates.

Solution: - Change the resource definitions if the deletion is valid or do not perform delete if the file definitions are correct.

25 - The KEYLENGTH, GENERIC was specified on the STARTBR or the last RESETBR and the value of KEYLENGTH was greater than the full key length.

Solution: - When a KEYLENGTH and GENERIC options specified, it is a generic key and the length value should be less than the length of the full key. Change the program to modify the length value.

26 - The KEYLENGTH option is specified for a nongeneric browse and the specified length does not equal the length defined for the data set.

Solution: - If only KEYLENGTH option specified, the length value should match the dataset full key. Change the program to modify the length value.

34 - The REQID, SYSID or file name does not match with any successful STARTBR command.A SYNCPOINT was issued causing STARTBR, READNEXT/READPREVs position to be lost.

Solution: -

37 - The type of record identification used to access a data set during the browse has been changed.

Solution: - The record identification used for browse should be same until the browse completion. Modify the programming logic to resolve the issue.

42 - The KEYLENGTH, GENERIC was specified on the STARTBR or the last RESETBR and the value of KEYLENGTH was less than zero.

Solution: - When a KEYLENGTH and GENERIC options specified, it is a generic key and the length value should be less than the length of the full key and should be greater than zero. Change the program to modify the length value.

54 - UPDATE is not allowed because the file is not a VSAM file that is accessed in RLS mode.

Solution: - UPDATE option is allowed on VSAM file. Modify the program to remove UPDATE as the file is not VSAM.

55 - NOSUSPEND is specified on a READ request to a non-RLS mode file.

Solution: - NOSUSPEND option is valid for only VSAM files accessed in RLS mode. Modify the program to remove NOSUSPEND option for files which are not accessing in RLS mode.
READPREV 20 - The FILE definition does not allow updates.

Solution: - Change the resource definitions if the deletion is valid or do not perform delete if the file definitions are correct.

24 - A READPREV command is issued for a file which the previous STARTBR or RESETBR command has the GENERIC option.

Solution: - READPREV option should not be issued on previous browse which has a generic option. Modify the programming logic to resolve the issue.

26 - The KEYLENGTH and the length specified does not equal the length defined for the data set.

Solution: - If only KEYLENGTH option specified, the length value should match the dataset full key. Change the program to modify the length value.

37 - The type of record identification used to access a data set during the browse has been changed.

Solution: - The record identification used for browse should be same until the browse completion. Modify the programming logic to resolve the issue.

39 - A READPREV is issued for a BDAM file.

Solution: - READPREV command used only for VSAM file and should not be issued on BDAM file. Modify the program to remove the READPREV for BDAM file.

41 - The REQID, SYSID or file name does not match with any successful STARTBR command.

Solution: - Modify the programming logic to pass the correct values to READNEXT command that matches with previous STARTBR command.

54 - UPDATE is not allowed because the file is not a VSAM file that is accessed in RLS mode.

Solution: - UPDATE option is allowed on VSAM file. Modify the program to remove UPDATE as the file is not VSAM.

55 - NOSUSPEND is specified on a READ request to a non-RLS mode file.

Solution: - NOSUSPEND option is valid for only VSAM files accessed in RLS mode. Modify the program to remove NOSUSPEND option for files which are not accessing in RLS mode.
READQ TD This condition only occurs for extra-partition queue.Occurs if the queue specified has been opened for output.

Solution: - The READQ operation should not be performed on the queue opened for output. If READQ operation required to perform on the same queue, open the queue in the input mode.
READQ TS Queue name specifies consisting of binary zeroes or queue created by CICS internal code.

Solution: - If queue name consists binary zeroes, modify the queue name and try again.If the queue is created by CICS internal code, use some other name for TSQ and try again.
RECEIVE MAP Occurs if a RECEIVE MAP command is issued in a non-terminal task.

Solution: - Avoid issuing a RECEIVE MAP command in non-terminal task.
RELEASE 5 - An invalid attempt is made by the program to release itself.

Solution: - A program can’t release itself. Modify program to resolve the error.

6 - The command is issued for a program that is not loaded.

Solution: - RELEASE command issued to release loaded programs. Modify program to resolve the error.

7 - Either the command is issued for a program that was loaded without the HOLD option by another task or the program has been enabled as a global user exit.

Solution: - A program loaded without hold option can release automatically and the program enabled as a global user exit can’t be released. Modify the program to remove the coding.

17 - The program is defined with RELOAD=YES.

Solution: - Release the program by a FREEMAIN rather than a RELEASE command.

30 - The program manager domain is not yet initialized because a load request was made in a first stage PLT.

Solution: - Contact the system administrator to resolve the error.
RESETBR 25 - The KEYLENGTH and GENERIC options are specified. The length specified in the KEYLENGTH option is greater than or equal to the length of a full key.

Solution: - When a KEYLENGTH and GENERIC options specified, it is a generic key and the length value should be less than the length of the full key. Change the program to modify the length value.

26 - The KEYLENGTH option is specified and the length does not equal the length defined for the data set.

Solution: - If only KEYLENGTH option specified, the length value should match the dataset full key. Change the program to modify the length value.

36 - The REQID, SYSID or file name does not match that of any successful STARTBR command.

Solution: - Modify the programming logic to pass the correct values to RESETBR command that matches with previous STARTBR command.

37 - The type of record identification used to access a data set during the browse has been changed.

Solution: - The record identification used for browse should be same until the browse completion. Modify the programming logic to resolve the issue.

42 - The KEYLENGTH and GENERIC options are specified. The length specified in the KEYLENGTH option is less than zero.

Solution: - When a KEYLENGTH and GENERIC options specified, it is a generic key and the length value should be less than the length of the full key and should be greater than zero. Change the program to modify the length value.

51 - A RESETBR command to a KSDS file accessed in RLS mode specifies the RBA keyword.

Solution: - RBA option is not valid for KSDS file accessing in RLS mode. Modify the program to remove RBA option for files which are accessing in RLS mode.
RETURN 1 - The program issuing RETURN command with the TRANSID option is not associated with a terminal.

Solution: - Use the transaction that is associated with the terminal (local transaction) and do not use remote transactions.

2 - A RETURN command with the CHANNEL, COMMAREA, or IMMEDIATE option is issued by a program that is not at the highest logical level.

Solution: - CHANNEL, COMMAREA or IMMEDIATE options should be used in the program that are at highest logical level. Modify the program to remove the options.

4 - A RETURN command with the TRANSID option is issued in the program associated with an APPC logical unit.

Solution: - The programs associated with APPC logical unit should not use in RETURN command. Modify the program to remove it.

8 - A RETURN command with the INPUTMSG option is issued in the program that is not associated with a terminal, or that is associated with an APPC logical unit, or an IRC session.

Solution: - RETURN with INPUTMSG option should be issued from a program that is associated with local terminal or APPC logical unit or an IRC session. Modify the program to remove it.

200 - A RETURN command with an INPUTMSG option invoked by a program invoked by DPL.

Solution: - RETURN with INPUTMSG should not be coded in the program invoked by DPL. Modify the application program to remove it.

203 - The CHANNEL option was specified, but the remote region which got the control does not support channels.

Solution: - The remote region specified with SYSID doesn’t support channels. Modify application program to remove the CHANNEL option if the specified region is correct or modify the remote region name if it is wrongly specified.
REWRITE 30 - REWRITE command is issued without a token and no previous READ for UPDATE can be found.

Solution: - The previous READ for UPDATE not being found is that failed for some reason and the failure has not been correctly handled or has been ignored.

46 - Attempted to change the length of a BDAM variable length record or block.

Solution: - Do not change length of the record after the READ with UPDATE. This might be a logic issue. Modify the program logic to resolve the issue.

47 - REWRITE instruction includes a token whose value cannot be matched against any token with an existing READ for UPDATE request.

Solution: - READ with UPDATE or REWRITE tokens should match. This might be a logic issue. Modify the program logic to resolve the issue.

55 - NOSUSPEND is not allowed because the file is not a VSAM file accessed in RLS mode.

Solution: - NOSUSPEND option is valid for only VSAM files accessed in RLS mode. Modify the program to remove NOSUSPEND option for files which are not accessing in RLS mode.
SEND CONTROL RESP2 not set
Control information is output to the same partition or LDC while a BMS logical message is active.

Solution: - Both serving the same purpose. Debug the application program and remove any one of them or prioritize them to work one after other.
SEND MAP 200 - Command not allowed for a distributed program link server program.

Solution: - Remove the command from the distributed link server program as it is not allowed. Code the program with SEND MAP and call it if want to receive the input from the terminal. RESP2 not set
  • Text data is output to the same partition while a BMS logical message is active.

    Solution: - Both serving the same purpose. Debug the application program and remove any one of them.
  • A separate SEND MAP command with the ACCUM option is issued to the terminal that initiated the transaction while a routed logical message is being built.

    Solution: - In this case, both serving the same purpose. Either remove the ACCUM in SEND MAP command or remove the transaction initiation.
  • A SEND MAP command is issued for a map without field specifications by specifying the FROM option and without the DATAONLY option.

    Solution: - Specify DATAONLY along with FROM option.
  • A SEND MAP command with the DATAONLY option is issued with a data area that resides above the 16MB line.

    Solution: - Reduce the data area size and resend it.
SEND TEXT RESP2 not set
  • The length of a header on a SEND TEXT command is negative.

    Solution: - Modify the application program to make sure the length of header having a positive value that is greater than zero.
  • The length of a trailer on a SEND TEXT command is negative.

    Solution: - Modify the application program to make sure the length of trailer having a positive value that is greater than zero.
STARTBR 20 - Browse operations are not allowed according to the resource definition.

Solution: - Change the resource definitions if the deletion is valid or do not perform delete if the file definitions are correct.

25 - The KEYLENGTH and GENERIC options are specified and the length in the KEYLENGTH option is greater than or equal to the length of a full key.

Solution: - When a KEYLENGTH and GENERIC options specified, it is a generic key and the length value should be less than the length of the full key. Change the program to modify the length value.

26 - The KEYLENGTH option is and the specified length does not equal the length defined for the data set.

Solution: - If only KEYLENGTH option specified, the length value should match the dataset full key. Change the program to modify the length value.

33 - An attempt is made to start a browse with a REQID already in use for another browse.

Solution: - One REQID for one browse and should not use for multiple browses. Modify the program to resolve the issues.

42 - The KEYLENGTH and GENERIC options and the length specified in the KEYLENGTH option is less than zero.

Solution: - When a KEYLENGTH and GENERIC options specified, it is a generic key and the length value should be less than the length of the full key and should be greater than zero. Change the program to modify the length value.

51 - STARTBR command to a KSDS file that is being accessed in RLS mode specifies the RBA keyword.

Solution: - RBA option is not valid for KSDS file accessing in RLS mode. Modify the program to remove RBA option for files which are accessing in RLS mode.

59 - XRBA was specified but the data set is not an extended ESDS.

Solution: - XBRA only for extended ESDS. Modify the program to remove XBRA option for writing the files other than extended ESDS.
SYNCPOINT 200 - SYNCPOINT was in a program from a remote system that has not specified the SYNCONRETURN option or if it has been linked to locally and is defined with EXECUTIONSET=DPLSUBSET.

Solution: - SYNCONRETURN should be specified along with SYNCPOINT issuing from remote system. Modify the program to include SYNCONRETURN.Contact System administrator if it has been linked to locally and is defined with EXECUTIONSET=DPLSUBSET to resolve the issue.
SYNCPOINT ROLLBACK 200 - SYNCPOINT ROLLBACK was in a program from a remote system that has not specified the SYNCONRETURN option or if it has been linked to locally and is defined with EXECUTIONSET=DPLSUBSET

Solution: - SYNCONRETURN should be specified along with SYNCPOINT ROLLBACK issuing from remote system. Modify the program to include SYNCONRETURN.
UNLOCK 47 - An UNLOCK includes a token whose value cannot be matched against any token in use for an existing READ with the UPDATE option.

Solution: - READ with UPDATE or UNLOCK tokens should match. This might be a logic issue. Modify the program logic to resolve the issue.
WRITE 20 - Write operations are not allowed according to the resource definition.

Solution: - Change the resource definitions if the deletion is valid or do not perform delete if the file definitions are correct.

23 - The key in the record area (FROM option) and the key in RIDFLD do not match.

Solution: - This the logic error. The record area key and RIDFID key should be same while performing WRITE operation. Debug the program logic to resolve the issue.

26 - The KEYLENGTH option specified length does not equal the length defined for the data set.

Solution: - The value specified in KEYLENGTH option should be same as the length specified while file definition.

38 - WRITE with the MASSINSERT option is issued against a BDAM file.

Solution: - MASSINSERT option should not be issued on BDAM file. Correct the program logic to resolve the issue.

51 - WRITE command specifying the RBA keyword was issued against a KSDS file accessed in RLS mode.

Solution: - RBA option is not valid for KSDS file accessing in RLS mode. Modify the program to remove RBA option for files which are accessing in RLS mode.

55 - NOSUSPEND is not allowed because the file is not a VSAM file accessed in RLS mode.

Solution: - NOSUSPEND option is valid for only VSAM files accessed in RLS mode. Modify the program to remove NOSUSPEND option for files which are not accessing in RLS mode.

59 - XRBA was specified but the data set is not an extended addressing ESDS.

Solution: - XBRA only for extended addressing ESDS. Modify the program to remove XBRA option for writing the files other than extended ESDS.
WRITEQ TS Queue name specifies consisting of binary zeroes or queue locked and waiting for ISC session recovery or queue created by CICS internal code.

Solution: - If queue name consists binary zeroes, modify the queue name and try again.
If the queue is recoverable TSQ and waiting for ISC recovery, wait until the TSQ is recovered.
If the queue is created by CICS internal code, use some other name for TSQ and try again.
WRITEQ TD Occurs if WRITEQ names an extra-partition queue that has been opened for input.This condition cannot be raised for intra-partition queues.

Solution: - The WRITEQ operation should not be performed on the queue opened for input. If WRITEQ operation required to perform on the same queue, open the queue in the output mode.
XCTL 8 - A XCTL command with the INPUTMSG option is issued for a program that is not associated with a terminal, or that is associated with an APPC logical unit, or an IRC session.

Solution: - RETURN with INPUTMSG option should be issued from a program that is associated with local terminal or APPC logical unit or an IRC session. Modify the program to remove it.

29 - EXEC XCTL is not allowed in a GLUE or TRUE.

Solution: - The EXEC XCTL is not allowed to code in global user exit (GLUE) or task-related user exit (TRUE). Modify the program to remove the command.

30 - The program manager domain has not yet been initialized because an XCTL request was made in a first stage PLT.

Solution: - Contact the system administrator to resolve the error.

31 - An XCTL command is issued from a program that is an application entry point.

Solution: - Issuing a XCTL from application entry point unpredictable results. So it is always suggestable to not code the XCTL in a programs which starts the application.

200 - An XCTL command with the INPUTMSG option is issued in a program invoked by DPL.

Solution: - XCTL with INPUTMSG should not be coded in the program invoked by DPL. Modify the application program to remove it.