DFS4401E RM requestname ERROR, RC=rc RSN=rsn ERRORTEXT=errortext
Explanation
An error occurred while processing the specified RM request type.
If the error message is issued during IMS autoexport to the IMSRSC repository, then the autoexport was not successful. The error return and reason code indicate the error. Once the error is resolved, you can issue an EXPORT DEFINITION(CHANGESONLY) command or wait for the next autoexport to trigger the write of the changed resource definitions to the IMSRSC repository.
- requestname
- Indicates the RM request type that failed or that an IMS, OM, RM, or SCI function failed when automatic import or automatic export was preparing to issue an RM request.
- rc
- The high-order byte of the return code helps you identify
the address space that returned the error.
- X'00'
- Identifies an IMS error, where the return code and reason code is mapped by the DFSCMDRR macro.
- X'01'
- Identifies an SCI error, where the return code and reason code is mapped by the CSLSRR macro.
- X'02'
- Identifies an OM error, where the return code and reason code is mapped by the CSLORR macro.
- X'03'
- Identifies an RM error, where the return code and reason code is mapped by the CSLRRR macro.
- rsn
- Indicates the reason code from the specified RM request type. For a description of the reason code, see the CSLSRR or CSLRRR macro.
- errortext
- Indicates error text. errortext can be blank
or the error text from the RM request type, which provides more information
about the error.errortext can have the following value:
- CHANGE LIST
- Indicates that the attempt to delete the change list failed. If the change list exists, it is processed the next time IMS warm starts or emergency restarts, or deleted the next time IMS cold starts.
- During IMS cold start
- While the IMS change list is being imported internally during IMS warm or emergency restart
- While the IMS change list is being deleted during IMS warm start, emergency restart, or cold start
- During IMS automatic export to the IMSRSC repository
System action
If this message is issued during IMS cold start while resource definitions are being imported automatically from the IMSRSC repository, the IMS system ends abnormally with abend code 3368. If the message is issued during IMS change list processing, the IMS system continues processing.
If the DFS4401E message with
ERRORTEXT=CHANGE LIST is issued after the IMS
restart is complete, IMS initiates a simple checkpoint to be
able to log the change list time in the checkpoint log record. The IMS checkpoint is taken so that the residual change list that was not deleted is not
reprocessed at IMS restart.
The DFS4401E message might be accompanied by a DFS4744E message to provide additional information for an RM error that occurred.
If the DFS4401E message is issued during the autoexport processing after the DFS4390I AUTOEXPORT INITIATED message, then IMS continues processing. The resource definitions are not yet exported to the IMSRSC repository. If the DFS4401E message is issued during autoexport processing during IMS shutdown processing, the IMS shutdown is aborted. You cannot shut down IMS until the resource definitions are successfully exported to the repository or automatic export to the repository is turned off.
System programmer response
The RM return and reason codes are described in the CSLRRR macro.
If this message resulted in termination of IMS, fix the problem that resulted in the RM error and then restart IMS. If this message is issued while IMS is processing the change list, the resource definitions that were being imported might be in NOTINIT-xx-REPOCHGLIST state. The resources and descriptors remain NOTINIT until IMS is restarted and the next internal import from the change list succeeds, or until you issue an IMPORT DEFN SOURCE(REPO) command to successfully import the resource and the descriptor definitions from the repository. You can issue the QUERY DB, QUERY PGM, QUERY RTCODE, and QUERY TRAN commands to display the resources that are in the NOTINIT-xx-REPOCHGLIST state. There are no QUERY commands for displaying descriptors in NOTINIT state because descriptors do not have status. See message DFS4414I for names of the descriptors that are still in NOTINIT state if the internal import from the change list failed.
If the DFS4401E message
with ERRORTEXT=CHANGE LIST is issued by IMS during restart processing, it indicates that IMS was not able to delete the IMS change list from the IMSRSC repository.
You must issue a DELETE DEFN TYPE(CHGLIST) command
to delete the change list from the repository.
If the DFS4401E message is issued during the autoexport processing after the DFS4390I AUTOEXPORT INITIATED message, then IMS continues processing. Because the resource definitions are not yet exported to the IMSRSC repository, after the error is resolved, you can issue an EXPORT DEFN TARGET(REPO) OPTION(CHANGESONLY) command to manually export the resource definitions or wait for the next automatic export.
If the DFS4401E message is issued during autoexport processing during IMS shutdown processing, the IMS shutdown is aborted. You cannot shut down IMS until the resource definitions are successfully exported to the repository or automatic export to the repository is turned off. After the error is resolved, you can attempt to shut down IMS so that the automatic export is successful or you can turn off automatic export by using the UPDATE IMS SET(AUTOEXPORT(N)) command.