DFHKExxxx messages

DFHKE0001
applid An abend (code aaa/bbbb) has occurred at offset X'offset' in module modname.
Explanation:

An abnormal end (abend) or program check has occurred in module modname. This implies that there may be an error in CICS code. Alternatively, unexpected data has been input, or storage has been overwritten.

The code aaa/bbbb is a three digit hexadecimal MVS code (if applicable), followed by a four digit alphanumeric CICS code. The MVS code is a system completion code (for example, 0C1 or D37). If an MVS code is not applicable, this field is filled with three hyphens. The CICS code is an abend code or a number referring to a CICS message (for example, AKEA is a CICS abend code; 1310 refers to message DFHTS1310).

During initialization, CICS may not have access to the user’s applid coded in the SIT. If CICS produces this message in these circumstances, it uses the default applid value DBDCCICS.

System action:

An exception entry is made in the trace table. A system dump is taken, unless you have specifically suppressed dumps in the dump table.

CICS continues unless you have specified in the dump table that CICS should terminate.

Message DFHME0116 is normally produced containing the symptom string for this problem.

User response:

If CICS is still running, it is necessary to decide whether to terminate CICS.

Look up the MVS code, if there is one, in OS/390 MVS System Codes.

Next, look up the CICS alphanumeric code in this manual. This tells you, for example, whether the error was a program check, an abend, or a runaway, and may give you some guidance concerning user response.

If module modname is not crucial to the running of your CICS system, you may decide to continue to run and bring CICS down at a convenient time to resolve the problem.

If you cannot run without the full use of module modname you should bring CICS down in a controlled shutdown.

You need further assistance from IBM to resolve this problem. See CICS® Problem Determination Guide for guidance on how to proceed.

Destination:

Console

Modules:

DFHKEDD, DFHKEDS, DFHKEGD, DFHKETI

XMEOUT Parameters: applid, aaa/bbbb, X'offset', modname

DFHKE0002
applid A severe error (code X'code') has occurred in module modname.
Explanation:

An error has been detected in module modname. The code code is the exception trace point id which uniquely identifies what the error is and where the error was detected.

For further information about CICS exception trace entries, see the CICS Problem Determination Guide.

During initialization, CICS may not have access to the user’s applid coded in the SIT. If CICS produces this message in these circumstances, it uses the default applid value DBDCCICS.

System action:

An exception entry (code X'code' in the message) is made in the trace table. A system dump is taken, unless you have specifically suppressed dumps in the dump table.

CICS will continue unless you have specified in the dump table that CICS should terminate. If appropriate, an error return code is sent to the caller of this domain. In this case, CICS could be terminated by the caller (for example, the domain manager, DFHDMDM). A message will be issued to this effect.

Message DFHME0116 is normally produced containing the symptom string for this problem.

User response:

This indicates a possible error in CICS code. The severity of its impact depends on the importance of the function being executed at the time of the error.

CICS may not have been terminated.

If the message occurs once and module modname is not crucial to the running of your CICS system, you may decide to continue to run and bring CICS down at a convenient time to resolve the problem.

If the message recurs or if you cannot run without the full use of module modname you should bring CICS down in a controlled shutdown.

You need further assistance from IBM to resolve this problem. See CICS Problem Determination Guide for guidance on how to proceed.

Destination:

Console

Modules:

DFHKEDD, DFHKEGD, DFHKEIN

XMEOUT Parameters: applid, X'code',modname

DFHKE0004
applid A possible loop has been detected at offset X'offset' in module modname.
Explanation:

A CICS function is taking more time to process than CICS expects. A possible loop has been detected in module modname at offset X'offset'. This is the offset of the instruction which was executing at the time the error was detected.

During initialization, CICS may not have access to the user’s applid coded in the SIT. If CICS produces this message in these circumstances, it uses the default applid value DBDCCICS.

System action:

An exception entry is made in the trace table. A system dump is taken, unless you have specifically suppressed dumps in the dump table.

CICS continues unless you have specified in the dump table that CICS should terminate.

Message DFHME0116 is normally produced containing the symptom string for this problem.

User response:

Notify the system programmer. If CICS has not been terminated, it is necessary to decide whether the problem is serious enough to bring CICS down.

Since some CICS functions can use a lot of CPU time, this message may have been caused by a long-running function. So there may not be an error here. Usually, CICS purges a CICS function which exceeds the runaway task time interval which you have specified in the SIT (this is the ICVR which is measured in milliseconds). This means that module modname is terminated and CICS continues.

But if you have declared ICVR=0 in the SIT and you consider that module modname has gone into a loop, you have to terminate CICS in order to terminate the runaway function.

If CICS has terminated module modname and you consider that it was not a runaway, you should increase the ICVR time interval in the SIT. You have to bring CICS down at a suitable time to do this permanently. However, you can change the ICVR time interval temporarily online, using the CEMT transaction.

If raising the ICVR time does not solve the problem, you will need further assistance from IBM. See CICS Problem Determination Guide for guidance on how to proceed.

Destination:

Console

Modules:

DFHKEDD, DFHKEDS, DFHKEGD, DFHKETI

XMEOUT Parameters: applid, X'offset', modname

DFHKE0005
applid A hardware error has occurred (module modname, code X'code'). The MVS store clock was found inoperative.
Explanation:

A hardware error has occurred during the running of module modname. The MVS store clock facility is the timing mechanism for the operating system.

The code code is the exception trace point ID which uniquely identifies the place where the error was detected.

During initialization, CICS may not have access to the user’s applid coded in the SIT. If CICS produces this message in these circumstances, it uses the default applid value DBDCCICS.

System action:

An exception entry (code code in the message) is made in the trace table. A system dump is taken, unless you have specifically suppressed dumps in the dump table.

CICS continues unless you have specified in the dump table that CICS should terminate.

User response:

If CICS is still running, it is necessary to decide whether to terminate CICS. This is probably a hardware error and you should first investigate the MVS store clock and find out whether it is working properly. If this is the cause, you should take the appropriate action to have it repaired or replaced.

In the unlikely event that this is not a hardware problem, you will need further assistance from IBM. See CICS Problem Determination Guide for guidance on how to proceed.

Note:
This message cannot be changed with the message editing utility.
Destination:

Console

Modules:

DFHKETI

DFHKE0006
applid Insufficient storage to satisfy Getmain (code X'code') in module modname. MVS code mvscode.
Explanation:

An MVS GETMAIN was issued by module modname but there was insufficient storage available to satisfy the request.

The code X'code' is the exception trace point ID which uniquely identifies the place where the error was detected.

The code mvscode is the MVS GETMAIN return code.

During initialization, CICS may not have access to the user’s applid coded in the SIT. If CICS produces this message in these circumstances, it uses the default applid value DBDCCICS.

System action:

CICS will terminate with a system dump. An exception entry is made in the trace table (code code in the message).

Message DFHME0116 is normally produced containing the symptom string for this problem.

User response:

Inform the system programmer.

You can get diagnostic information about the MVS return code by consulting the relevant MVS codes manual which is listed in the book list at the front of this book.

Try decreasing the overall size limit of the DSAs or EDSAs. Or, try increasing the size of the whole region, if it is not already at maximum size. If CICS is not already terminated, you will need to bring CICS down to do this. See the CICS System Definition Guide or the CICS Performance Guide for further information on CICS storage.

Destination:

Console

Modules:

DFHKEIN

XMEOUT Parameters: applid, X'code',modname, mvscode

DFHKE0101
applid DFHSIP IS NOT APF-AUTHORIZED. CICS WILL TERMINATE.
Explanation:

Part of CICS initialization must be done in an APF-authorized state. The kernel has detected that DFHSIP is not APF-authorized.

During initialization, CICS may not have access to the user’s applid coded in the SIT. If CICS produces this message in these circumstances, it uses the default applid value DBDCCICS.

System action:

CICS will terminate. The CICS job step terminates with return code 12.

User response:

All libraries concatenated in the STEPLIB concatenation should be APF-authorized, and DFHSIP should be link-edited with an authorization code of 1.

Note:
This message cannot be changed with the message editing utility.
Destination:

Console

Modules:

DFHKESIP

DFHKE0102
applid UNSUCCESSFUL PRE-INITIALIZATION OF domain DOMAIN. CICS WILL TERMINATE.
Explanation:

A domain has failed to pre-initialize and as a result the system will terminate.

During initialization, CICS may not have access to the user’s applid coded in the SIT. If CICS produces this message in these circumstances, it uses the default applid value DBDCCICS.

Since this problem has occurred so early in CICS initialization, possible causes include a severe lack of storage or corruption of the local catalog.

System action:

CICS terminates.

User response:

Examine all earlier messages sent to the console to look for any obvious cause of the domain pre-initialisation failure.

If you cannot find the cause of the failure from the messages, inform the system programmer. Start of changeIf a dump is taken, investigate this problemEnd of change using the exception trace which is issued by the failing domain.

You may need further assistance to resolve this problem. See CICS Problem Determination Guide for guidance on how to proceed.

Note:
This message cannot be changed with the message editing utility.
Destination:

Console

Modules:

DFHKETCB.

DFHKE0103
applid IDENTIFY FAILED IN MODULE modname. MVS CODE mvscode. CICS WILL TERMINATE.
Explanation:

The kernel has issued an MVS IDENTIFY which has failed.

The code mvscode is the MVS IDENTIFY return code.

During initialization, CICS may not have access to the user’s applid coded in the SIT. If CICS produces this message in these circumstances, it uses the default applid value DBDCCICS.

System action:

CICS terminates. The CICS job step terminates with return code 12.

User response:

Inform the system programmer.

To resolve the problem, use the MVS IDENTIFY return code mvscode and the MVS/XA Supervisor Services and Macro Instructions manual, (GC28-1154), to determine why the IDENTIFY failed.

Note:
This message cannot be changed with the message editing utility.
Destination:

Console

Modules:

DFHKETCB.

DFHKE0104
applid CICS HAS BEEN SUPPLIED WITH INCORRECT SVC NUMBER svcno.
Explanation:

CICS has validated the SVC number svcno, but it does not correspond to the correct CICS Type 3 SVC for this release of CICS. CICS cannot function without the correct CICS SVC.

The SVC number svcno has been specified in the SIT, or as an override, by the CICSSVC= parameter.

During initialization, CICS may not have access to the user’s applid coded in the SIT. If CICS produces this message in these circumstances, it uses the default applid value DBDCCICS.

System action:

Control is returned to the parameter manager for interaction with the operator. Further action depends upon which PARMERR= parameter has been specified.

User response:

The CICS Type 3 SVC is defined to MVS in SYS1.PARMLIB member IEASVCxx. SVC svcno must be defined as a Type 3 SVC with an entry point equal to the entry point name specified when the SVC module was installed into SYS1.LPALIB. Ensure that this is the case.

Note:
This message cannot be changed with the message editing utility.
Destination:

Console

Modules:

DFHKEGD.

Start of changeDFHKE0105End of change
Start of changeapplid CICS INITIALIZATION IS NOT SUPPORTED ON THIS LEVEL OF OPERATING SYSTEM.End of change
Start of change
Explanation:

The kernel has detected that the release level of the operating system is earlier than the pre-requisite release level required to run CICS.

End of change
Start of change
System action:

CICS will terminate. The CICS job step terminates with return code 12.

End of change
Start of change
User response:

Refer to the CICS Program Directory and install the pre-requisite operating system release level or higher.

Note:
This message cannot be changed with the message editing utility.
End of change
Start of change
Destination:

Console

End of change
Modules:

Start of changeDFHKESIPEnd of change

DFHKE0201
applid ABOUT TO TAKE SDUMP. DUMPCODE: dumpcode, DUMPID: dumpid. (MODULE modname).
Explanation:

An error during pre-initialization or termination, possibly signalled by a previous message, has caused the kernel domain to take a dump, which will issue this message immediately before calling the MVS SDUMP facility.

The dump code dumpcode is the 8-character dump code ‘KERNDUMP’.

The dumpid dumpid is the string ‘0/0000’.

During initialization, CICS may not have access to the user’s applid coded in the SIT. If CICS produces this message in these circumstances, it uses the default applid value DBDCCICS.

System action:

When the dump is complete, message number DFHKE0202 is issued.

User response:

Inform the system programmer. See the associated dump and error messages for further guidance.

Note:
This message cannot be changed with the message editing utility.
Destination:

Console

Modules:

DFHKEDD, DFHKEDS, DFHKEGD, DFHKEIN, DFHKESTX

DFHKE0202
applid SDUMP COMPLETE. (MODULE modname).
Explanation:

This message is issued on successful completion of an SDUMP.

During initialization, CICS may not have access to the user’s applid coded in the SIT. If CICS produces this message in these circumstances, it uses the default applid value DBDCCICS.

System action:

CICS will terminate.

User response:

Print off the system dump if required. A previous MVS message will identify in which SYS1.DUMP data set this dump can be found.

Note:
This message cannot be changed with the message editing utility.
Destination:

Console

Modules:

DFHKEDD, DFHKEDS, DFHKEGD, DFHKEIN, DFHKESTX

DFHKE0208
applid SDUMP BUSY - CICS WILL RETRY IN FIVE SECONDS. (MODULE modname).
Explanation:

At the time of the MVS SDUMP request issued by CICS, another address space in the same MVS system was in the process of taking an SDUMP. This causes MVS to reject the new request. A nonzero value for the DURETRY parameter on the SIT means that CICS waits for five seconds before reissuing the SDUMP request.

System action:

CICS issues an MVS STIMERM macro which causes CICS to stop for five seconds. The request is reissued when the delay interval has expired. CICS delays and retries every five seconds for a total time equal to the number of seconds specified on the DURETRY system initialization parameter.

User response:

None.

Note:
This message cannot be changed with the message editing utility.
Destination:

Console

Modules:

DFHKEDD, DFHKEDS, DFHKEGD, DFHKEIN, DFHKESTX

DFHKE0209
applid RETRYING SDUMP. (MODULE modname).
Explanation:

At the time of the MVS SDUMP request issued by CICS, another address space in the same MVS system was in the process of taking an SDUMP. This caused MVS to reject the new request. CICS has waited for five seconds (as indicated by message DFHKE0208) and is now reissuing the SDUMP request.

System action:

CICS reissues the SDUMP request.

User response:

None.

Note:
This message cannot be changed with the message editing utility.
Destination:

Console

Modules:

DFHKEDD, DFHKEDS, DFHKEGD, DFHKEIN, DFHKESTX

DFHKE0210
applid SDUMP REQUEST FAILED. (MODULE modname) - reason.
Explanation:

An MVS SDUMP request from CICS signalled by message DFHKE0201 has failed to complete successfully. The possible reasons reason for the failure are detailed below.

SDUMP RETURN CODE X'nn' ONLY PARTIAL DUMP
The SYS1.DUMP data set to which the dump was written was not large enough to contain all of the dumped storage.
SDUMP RETURN CODE X'nn' REASON X'mm' SDUMP BUSY
At the time of the MVS SDUMP request issued by CICS, another address space in the same MVS system was in the process of taking an SDUMP. This caused MVS to reject the new request.

If a nonzero value has been specified for the DURETRY SIT parameter, CICS will have retried the SDUMP request every five seconds for the specified period. This message is issued if SDUMP is still busy after the final retry.

SDUMP RETURN CODE X'nn' REASON X'mm' NO DATA SET AVAILABLE
No data set is available for the SDUMP request.
SDUMP RETURN CODE X'nn' REASON X'mm'
MVS rejected the SDUMP request for some other reason than those listed above. X'nn' gives the hexadecimal SDUMP return code and X'mm' gives the hexadecimal SDUMP reason.
NOT AUTHORIZED IN CICS
SDUMP is not authorized for this CICS run.
INSUFFICIENT STORAGE
CICS issued an MVS GETMAIN for Subpool 253 storage during the processing of the SDUMP request. The GETMAIN was rejected by MVS.
STIMERM FAILED
In order to delay for five seconds before retrying SDUMP after an SDUMP busy condition, CICS issues an MVS STIMERM macro request. MVS has indicated that the STIMERM request has failed.
DFHDUSVC FESTAE FAILED
CICS issued an MVS FESTAE request from DFHDUSVC during the processing of the SDUMP request. The FESTAE has been rejected by MVS.
DFHDUSVC FUNCTION INVALID
CICS called DFHDUSVC during the processing of the SDUMP request. The function passed to DFHDUSVC was invalid.

During initialization, CICS does not have access to the user’s applid coded in the SIT. If CICS produces this message in these circumstances, it uses the default applid value DBDCCICS.

System action:

CICS proceeds as if the dump had been successful.

User response:

The user response depends on the reason for the failure. For:

SDUMP RETURN CODE X'nn' ONLY PARTIAL DUMP
Examine the reason code that explains why the partial dump was taken. This code is contained in the MVS message IEA911E. See the OS/390 MVS System Messages, Volume 1 for a description of this reason code.
SDUMP RETURN CODE X'nn' REASON X'mm' SDUMP BUSY
Cause the SDUMP to be reissued by increasing the DURETRY value on the SIT. See the OS/390 MVS Programming: Authorized Assembler Services Reference for an explanation of the SDUMP return code X'nn' and reason X'mm'.
SDUMP RETURN CODE X'nn' REASON X'mm' NO DATA SET AVAILABLE
Clear a SYS1.DUMP data set and then cause the SDUMP request to be reissued. See the OS/390 MVS Programming: Authorized Assembler Services Reference for an explanation of the SDUMP return code X'nn' and reason X'mm'.
SDUMP RETURN CODE X'nn' REASON X'mm'
No action is required if the dump was suppressed deliberately. If the dump failed because of an error in the MVS SDUMP routine, use MVS problem determination methods to fix the error and then cause the SDUMP request to be reissued. See the OS/390 MVS Programming: Authorized Assembler Services Reference for an explanation of the SDUMP return code X'nn' and reason X'mm'.
NOT AUTHORIZED IN CICS
This reason should not appear, because an SDUMP is unconditionally authorized during CICS initialization, and should be authorized throughout the CICS run. If you do get this reason, the CICS AFCB (Authorized Function Control Block) has probably been accidentally overwritten.
INSUFFICIENT STORAGE
Ensure sufficient storage is available to MVS for subpool 253 requests.
STIMERM FAILED
Use MVS problem determination methods to fix the STIMERM failure and then cause the SDUMP request to be reissued.
DFHDUSVC FESTAE FAILED
Use MVS problem determination methods to fix the FESTAE failure and then cause the SDUMP to be reissued. See the OS/390 MVS Programming: Authorized Assembler Services Reference for an explanation of the FESTAE macro.
DFHDUSVC FUNCTION INVALID
The CICS DAFPB (dump authorized function parameter block) has probably been accidentally overwritten.

Notify the system programmer. If CICS is still running, it will be necessary to decide whether to terminate CICS.

You may decide to continue to run and bring CICS down at a convenient time to resolve the problem.

To resolve the problem, collect any dumps and any relevant messages and contact your IBM Support Center.

Further guidance on how to prepare information for IBM support is given in the CICS Problem Determination Guide If you are not familiar with this process, refer to the guide before contacting IBM support.

Note:
This message cannot be changed with the message editing utility.
Destination:

Console

Modules:

DFHKEDD, DFHKEDS, DFHKEGD, DFHKEIN, DFHKESTX

DFHKE0301
applid Insufficient storage to satisfy Getmain in module modname. MVS code mvscode.
Explanation:

The kernel (KE) domain has issued an MVS GETMAIN for kernel stack storage, but there was insufficient storage available to satisfy the request.

The code mvscode is the MVS GETMAIN return code.

During initialization, CICS may not have access to the user’s applid coded in the SIT. If CICS produces this message in these circumstances, it uses the default applid value DBDCCICS.

System action:

CICS terminates abnormally with a system dump. No exception entry is made in the trace table since a call to the trace (TR) domain would itself require kernel stack storage.

User response:

Inform the system programmer.

You can get diagnostic information about the MVS return code by consulting the relevant MVS codes manual which is listed in the book list at the front of this book. Also look at the kernel domain section of the system dump to see how the kernel stack storage has been used up.

Try decreasing the size limits of the DSAs or EDSAs. Or, try increasing the size of the whole region, if it is not already at maximum size. See the CICS System Definition Guide or the CICS Performance Guide for further information on CICS storage.

Note:
This message cannot be changed with the message editing utility.
Destination:

Console

Modules:

DFHKESGM

DFHKE0302
applid Freemain of stack storage failed in module modname. MVS code mvscode.
Explanation:

The kernel (KE) domain has issued an MVS FREEMAIN for kernel stack storage, but a bad return code was returned.

The code mvscode is the MVS FREEMAIN return code.

During initialization, CICS may not have access to the user’s applid coded in the SIT. If CICS produces this message in these circumstances, it uses the default applid value DBDCCICS.

System action:

CICS terminates abnormally with a system dump. No exception entry is made in the trace table since a call to the trace (TR) domain would itself require kernel linkage.

User response:

Inform the system programmer.

You can get diagnostic information about the MVS return code by consulting the OS/390 MVS System Codes manual.

Note:
This message cannot be changed with the message editing utility.
Destination:

Console

Modules:

DFHKEDS

DFHKE0303
applid A RECURSIVE ABEND HAS BEEN DETECTED BY THE KERNEL DOMAIN.
Explanation:

The kernel (KE) domain has detected that the current task is recursively abending while attempting to recover from an abend.

System action:

CICS terminates abnormally with a system dump. No exception entry is written to the trace table because the trace (TR) domain may be the cause of the loop.

User response:

Use the dump provided to investigate the kernel error table to diagnose the earlier abends for the failing task.

Note:
This message cannot be changed with the message editing utility.
Destination:

Console

Modules:

DFHKERRI

DFHKE0401
applid CICS REGISTER CALL TO AUTOMATIC RESTART MANAGER FAILED (RETURN CODES X'resp', X'reason').
Explanation:

An attempt to invoke a REGISTER request against the MVS automatic restart manager (ARM) failed.

The codes resp, reason are the hexadecimal response and reason codes from ARM.

System action:

A system dump is taken.

CICS continues, but cannot subsequently be restarted by ARM.

User response:

It is necessary to decide whether to terminate CICS.

Start of changeFor problem diagnosis look up the return codes from the IXCARM macro in the OS/390 MVS Sysplex Services Reference manual.End of change

Start of changeFurther information about how to use ARM can also be found in OS/390 MVS Setting Up a Sysplex.End of change

You need further assistance from IBM to resolve this problem. See CICS Problem Determination Guide for guidance on how to proceed.

Note:
This message cannot be changed with the message editing utility.
Destination:

Console

Modules:

DFHKEAR

DFHKE0402
applid CICS DEREGISTER CALL TO AUTOMATIC RESTART MANAGER FAILED (RETURN CODES X'resp', X'reason').
Explanation:

An attempt to invoke a DEREGISTER request against the MVS automatic restart manager (ARM) failed.

The codes resp, reason are the hexadecimal response and reason codes from ARM.

System action:

If the request failed during startup, a dump is taken and CICS continues.

If the request failed during shutdown, an exception entry is made in the trace table, and a system dump is taken unless you have specifically suppressed dumps in the dump table. CICS continues to shut down unless you have specified in the dump table that CICS should terminate. The DEREGISTER failed so a subsequent failure of CICS or an IMMEDIATE shutdown may result in ARM restarting CICS.

User response:

Start of changeFor problem diagnosis look up the return codes from the IXCARM macro in the OS/390 MVS Sysplex Services Reference manual.End of change

Start of changeFurther information about how to use ARM can also be found in the MVS/ESA Setting Up a Sysplex manual.End of change

You need further assistance from IBM to resolve this problem. See CICS Problem Determination Guide for guidance on how to proceed.

Destination:

Console

Modules:

DFHKEAR

XMEOUT Parameters: applid, X'resp',X'reason'

DFHKE0403
applid CICS WAITPRED call to automatic restart manager failed (return codes X'resp', X'reason').
Explanation:

An attempt to invoke a WAITPRED request against the MVS automatic restart manager (ARM) failed.

The codes resp, reason are the hexadecimal response and reason codes from ARM.

System action:

An exception entry is made in the trace table. A system dump is taken, unless you have specifically suppressed dumps in the dump table.

CICS continues unless you have specified in the dump table that CICS should terminate. The failure of the WAITPRED request may result in other subsystems not being available when CICS initialization completes.

User response:

If CICS is still running, it is necessary to decide whether to terminate CICS.

Start of changeFor problem diagnosis look up the return codes from the IXCARM macro in the OS/390 MVS Sysplex Services Reference manual.End of change

Start of changeFurther information about how to use ARM can also be found in the MVS/ESA Setting Up a Sysplex manual.End of change

You need further assistance from IBM to resolve this problem. See CICS Problem Determination Guide for guidance on how to proceed.

Destination:

Console

Modules:

DFHKEAR

XMEOUT Parameters: applid, X'resp',X'reason'

DFHKE0404
applid CICS READY call to automatic restart manager failed (return codes X'resp', X'reason').
Explanation:

An attempt to invoke a READY request against the MVS automatic restart manager (ARM) failed.

The codes resp, reason are the hexadecimal response and reason codes from ARM.

System action:

An exception entry is made in the trace table. A system dump is taken, unless you have specifically suppressed dumps in the dump table.

CICS continues unless you have specified in the dump table that CICS should terminate. Other subsystems which are waiting for CICS are not be informed that CICS is ready for work and continue to wait until timed out.

User response:

If CICS is still running, it is necessary to decide whether to terminate CICS.

Start of changeFor problem diagnosis look up the return codes from the IXCARM macro in the OS/390 MVS Sysplex Services Reference manual.End of change

Start of changeFurther information about how to use ARM can also be found in the MVS/ESA Setting Up a Sysplex manual.End of change

You need further assistance from IBM to resolve this problem. See CICS Problem Determination Guide for guidance on how to proceed.

Destination:

Console

Modules:

DFHKEAR

XMEOUT Parameters: applid, X'resp',X'reason'

DFHKE0405
applid CICS WAITPRED call to automatic restart manager timed out (return codes X'resp', X'reason').
Explanation:

A WAITPRED request against the MVS automatic restart manager (ARM) timed out.

The codes resp, reason are the hexadecimal response and reason codes from ARM.

System action:

An exception entry is made in the trace table. A system dump is taken, unless you have specifically suppressed dumps in the dump table.

CICS continues unless you have specified in the dump table that CICS should terminate. The WAITPRED request time out may result in other subsystems not being available when CICS initialization completes.

User response:

If CICS is still running, it is necessary to decide whether to terminate CICS.

Start of changeFor problem diagnosis look up the return codes from the IXCARM macro in the OS/390 MVS Sysplex Services Reference manual.End of change

Start of changeFurther information about how to use ARM can also be found in the MVS/ESA Setting Up a Sysplex manual.End of change

You need further assistance from IBM to resolve this problem. See CICS Problem Determination Guide for guidance on how to proceed.

Destination:

Console

Modules:

DFHKEAR

XMEOUT Parameters: applid, X'resp',X'reason'

DFHKE0406I
applid CICS is about to wait for predecessors defined in the MVS automatic restart management policy for this region.
Explanation:

CICS is about to invoke a WAITPRED request against the automatic restart manager. This may result in a delay before CICS processing continues.

System action:

CICS continues.

User response:

None.

Destination:

Console

Modules:

DFHKEAR

XMEOUT Parameter: applid

DFHKE0407
applid XRF IS INCOMPATIBLE WITH AUTOMATIC RESTART MANAGER. CICS IS TERMINATING.
Explanation:

CICS has registered with the MVS automatic restart manager (ARM) after having been restarted but the restart JCL specifies XRF=YES. XRF is incompatible with ARM.

System action:

CICS terminates.

User response:

Ensure that the XRF=YES option in the restart JCL is correct.

Note:
This message cannot be changed with the message editing utility.
Destination:

Console

Modules:

DFHKEAR

DFHKE0408D
applid PLEASE SPECIFY START TYPE, 'ASIS' OR 'AUTO'.
Explanation:

An attempt to REGISTER with the MVS automatic restart manager (ARM) has failed when a cold or initial start has been specified in the SIT.

When the CICS region has been restarted with JCL that specifies START=COLD or START=INITIAL, CICS relies on ARM to determine whether to override the start type and change it to AUTO. As the REGISTER has failed, CICS cannot determine whether the region is being restarted by ARM, and so does not know whether to override the start type.

System action:

CICS waits until the operator supplies the START type to be used by this region.

User response:

If the region is being restarted by ARM, specify AUTO. If the startup type of COLD or INITIAL in the SIT should be preserved, specify ASIS.

See the previously issued message DFHKE0401 for guidance on dealing with the underlying REGISTER failure.

Note:
This message cannot be changed with the message editing utility.
Destination:

Console Routecodes 1 and 11

Modules:

DFHKEAR

Start of changeDFHKE0410End of change
Start of changeapplid CICS REGISTER CALL TO AUTOMATIC RESTART MANAGER FAILED BECAUSE THE JOB TYPE IS INVALID.End of change
Start of change
Explanation:

An attempt to invoke a REGISTER request against the MVS automatic restart manager (ARM) failed because the job type is invalid to ARM. CICS can only register with ARM if it is being run as a started task or a batch job.

End of change
Start of change
System action:

CICS continues, but cannot subsequently be restarted by ARM.

End of change
Start of change
User response:

None.

Note:
This message cannot be changed with the message editing utility.
End of change
Start of change
Destination:

Console

End of change
Modules:

Start of changeDFHKEAREnd of change

DFHKE0411
applid CICS REGISTER CALL TO AUTOMATIC RESTART MANAGER FAILED BECAUSE MAXIMUM NUMBER OF USERS WAS REACHED.
Explanation:

An attempt to invoke a REGISTER request against the MVS automatic restart manager (ARM) failed because the maximum number of ARM users allowed for in the ARM couple data set has been reached. This response is never given by ARM if ARM is restarting CICS.

System action:

CICS continues, but cannot subsequently be restarted by ARM.

User response:

None.

Note:
This message cannot be changed with the message editing utility.
Destination:

Console

Modules:

DFHKEAR

Start of changeDFHKE0412IEnd of change
Start of changeapplid CICS WAITPRED call to automatic restart manager has completed.End of change
Start of change
Explanation:

A WAITPRED request against the MVS automatic restart manager (ARM) has completed.

Further information about how to use ARM can also be found in the MVS/ESA Setting Up a Sysplex manual.

You need further assistance from IBM to resolve this problem. See CICS Problem Determination Guide for guidance on how to proceed.

End of change
Start of change
Destination:

Console

End of change
Modules:

Start of changeDFHKEAREnd of change

Start of changeXMEOUT Parameter:End of changeStart of change End of changeStart of changeapplidEnd of change

Start of changeDFHKE0413End of change
Start of changeapplid CICS REGISTER CALL FAILURE IN MODULE DFHKESVC (RETURN CODE X'resp').End of change
Start of change
Explanation:

An attempt to invoke a REGISTER request against the MVS automatic restart manager (ARM) failed in module DFHKESVC.

The code resp is the hexadecimal response from DFHKESVC and its meanings are:

End of change
Start of change
System action:

CICS continues, but cannot subsequently be restarted by ARM.

End of change
Start of change
User response:

It is necessary to decide whether to terminate CICS.

Further information about how to use ARM can also be found in OS/390 MVS Setting Up a Sysplex.

You need further assistance from IBM to resolve this problem. See CICS Problem Determination Guide for guidance on how to proceed.

Note:
This message cannot be changed with the message editing utility.
End of change
Start of change
Destination:

Console

End of change
Modules:

Start of changeDFHKEAREnd of change

DFHKE0414
BAD RETURN FROM MVS SERVICE CSRL16J.
Explanation:

An attempt to invoke the MVS service CSRL16J (Load 16 and Jump) has returned to CICS with a non-zero return code. This service is called from the CICS Kernel 'Reset Address' function.

System action:

CICS continues by deliberately executing a privileged instruction which causes a program exception with code 0C2 which leads to an ASRA abend. Register 4 has been loaded with the return code from the CSRL16J service.

User response:

Inform the systems programmer.

Note:
This message cannot be changed with the message editing utility.
Destination:

Console

Modules:

DFHKERET

Start of changeDFHKE0500End of change
Start of changeapplid MAXPROCUSER exceeded while executing 'service-routine'.End of change
Start of change
Explanation:

The Kernel issued a call to the service-routine callable service, and received a response of EMVSINITIAL with a reason code of X'0012', indicating that the number of processes for the current CICS region userid has been exceeded.

End of change
Start of change
System action:

CICS initialization continues.

End of change
Start of change
User response:

If this error occurs frequently, consider increasing the MAXPROCUSER value in the BPXPRMxx member of SYS1.PARMLIB.

End of change
Start of change
Destination:

Console

End of change
Modules:

Start of changeDFHKETCBEnd of change

Start of changeXMEOUT Parameters:End of changeStart of change End of changeStart of changeapplid, End of changeStart of changeservice-routineEnd of change

Start of changeDFHKE0501End of change
Start of changeapplid The Kernel received a return value of X'rvalue', a return code of X'rcode' and a return reason of X'rreason' from the uss service-routine.End of change
Start of change
Explanation:

Unix System Services has returned a non-zero return code/reason code to a service-routine call made by the Kernel during CICS initialization.

End of change
Start of change
System action:

CICS initialization continues since it is too early to tell whether Unix System Services will be required later in the CICS run.

End of change
Start of change
User response:

Determine the reason for this response. The return code and reason code included in the message text should be described in the z/OS UNIX System Services Messages and Codes manual.

End of change
Start of change
Destination:

Console

End of change
Modules:

Start of changeDFHKETCBEnd of change

Start of changeXMEOUT Parameters:End of changeStart of change End of changeStart of changeapplid, End of changeStart of changeX'rvalue', End of changeStart of changeX'End of changeStart of changercode', End of changeStart of changeX'End of changeStart of changerreason', End of changeStart of changeussEnd of change

DFHKE0999
applid MVS HAS CALLED DFHKESTX WITH NO SDWA. ABEND CODE X'code'.
Explanation:

MVS has made a call to the CICS ESTAE-type recovery routine DFHKESTX, but it supplied no system diagnostic work area (SDWA). DFHKESTX is unable to continue with the recovery.

During initialization, CICS may not have access to the user’s applid coded in the SIT. If CICS produces this message in these circumstances, it uses the default applid value DBDCCICS.

System action:

Module DFHKESTX produces a system dump and percolates the error to the next ESTAE routine. This is potentially a serious error. CICS continues processing pending the result of the error percolation.

User response:

The abend code X'code' is the reason the CICS ESTAE was called. You need to find out which product has produced the abend. Typically it is an MVS system completion code, for example D37. However the abend may have been issued by CICS, for example abend 1596, or another product such as IMS.

Since there is little further diagnostic information in this case, look for any messages that may indicate the reason for the abend. The entry in the appropriate manual for the abend code gives user guidance regarding the error, and may also give some guidance concerning the appropriate user response.

The reason why no SDWA was passed and subsequently no recovery was attempted is probably a shortage of storage. This storage shortage may also be an influencing factor in the abend itself.

Note:
This message cannot be changed with the message editing utility.
Destination:

Console

Modules:

DFHKESTX

Start of change
DFHKE1798
applid FO TCB FORCED TO TERMINATE.
Explanation:

During an immediate shutdown of CICS the file owning TCB is detached before VSAM is able to close all data sets normally.

The detaching of this TCB can cause abends during shutdown. At CICS restart VSAM may need to perform a VERIFY for any data set that is open for update when the immediate shutdown is performed, and this can cause a long delay.

During initialization, CICS may not have access to the user’s applid coded in the SIT. If this is the case CICS uses the default applid value DBDCCICS.

System action:

The immediate shutdown of CICS continues.

User response:

None.

If this message occurs frequently, you may wish to issue a CEMT SET FILE ALL CLOSED before immediate shutdown is performed.

Note:
This message cannot be changed with the message editing utility.
Destination:

Console

Modules:

DFHKESIP

End of change
DFHKE1799
applid TERMINATION OF CICS IS COMPLETE.
Explanation:

This message is issued when CICS has terminated.

During initialization, CICS may not have access to the user’s applid coded in the SIT. If CICS produces this message in these circumstances, it uses the default applid value DBDCCICS.

System action:

Control is given back to the operating system.

User response:

None.

Note:
This message cannot be changed with the message editing utility.
Destination:

Console

Modules:

DFHKESIP

DFHKE1800
applid ABNORMAL TERMINATION OF CICS IS COMPLETE.
Explanation:

CICS issues this message when it terminates abnormally.

During initialization, CICS may not have access to the user’s applid coded in the SIT. If CICS produces this message in these circumstances, it uses the default applid value DBDCCICS.

System action:

The abnormal termination of CICS continues. The kernel returns control to the operating system by issuing a user 1800 abend.

The original error which caused the abnormal termination may also have produced a dump. No specific dump is produced to accompany this message.

User response:

If a dump is produced, check the dump to determine the cause of the error. Use the CICS Problem Determination Guide to assist you to determine the problem.

If no dump is produced, check for other CICS and MVS messages and abend codes to help you to determine the cause of the problem.

Note:
This message cannot be changed with the message editing utility.
Destination:

Console

Modules:

DFHKESIP

[[ Contents Previous Page | Next Page Index ]]