0718

Explanation

An error occurred during IMS initialization. Either a required module could not be found or a permanent I/O error was encountered while searching a PDS directory.

Analysis

This is a standard abend issued by one of these modules: DFSAINB0, DFSPLDR0, DFSPCC30, DFSPLPP0, DFSXBAT0, DFSXCTL0, DFSDINB0, DFSXLCI0, DFSXSL10, DFSXSTM0, and DFSXTRA0. The program status word (PSW) at entry-to-abend should be used to determine the failing module.

DFSPLDR0 is started using a BAL from DFSRRA00, which then loads DFSPLDT0 and BALs to DFSPLPP0, the module preload processor. DFSPLPP0 performs the BLDL processing of those modules specified by PROCLIB members DFSIIN10, DFSIIN20, and those modules specified by the user in member DFSMPLxx. When the BLDL processing is completed, DFSPLPP0 passes a list back to DFSPLDR0, which then performs the IMODULE LOAD function.

The work area DSECT, DFSPLDT0, addressed using register 11, is used as a common area for DFSPLPP0 and DFSPLDR0.

DFSXLIC0 is the first module to get control under the Common Services ITASK. The Common Services ITASK is created by DFSXSTM0.

DFSPCC30 is the application program controller for batch systems. When the batch program request handler module failed during loading, DFSPCC30 issued abend 0718.

For DFSAINB0:

Abend 0718 is issued by DFSAINB0 CSECT LOADXITS when the attempted load of DFSCCMD0 fails and ICMD security is implemented using RACF® (or equivalent), the Command Authorization exit routine, or both. No error messages are issued before this abend code is issued.

Key Label Description
Reg15=Return code LOADXITS The SVC for IMODULE LOAD of DFSCCMD0 returned a nonzero return code. The load failed.
Start of changeReg15=Return codeEnd of change Start of changeLOADSECXEnd of change Start of changeThe SVC for IMODULE LOAD of IRRSPW00 returned a non-zero return code. The load failed.End of change

Possible causes:

  • The required module is not on PDS.
  • The AOIS, CMDCMS, or CMDSEC parameter in the DBC, DCC, IMS, or CSL procedure is incorrect for the installation.
  • Start of changeThe IRRSPW00 module provided by RACF is not included in LPA, in a library in LINKLIST, or in one of the IMS.SDFSRESL concatenated data sets.End of change

For DFSPLDR0:

This is issued by DFSPLDR0 when the attempted load of the required modules failed for one of the following reasons:

  1. z/OS® failed.
  2. the IMS module manager, DFSMODU0, rejected the load request.

Message DFS677I or DFS678I is issued to the system console before the abend, along with message DFS679I. DFS677I indicates an I/O error, and DFS678I indicates that a module was not found. Message DFS679I contains the module names together with the associated IMODULE LOAD return code.

The program status word (PSW) at entry-to-abend points to the instruction within label ABNDBADL from which the abend (SVC 13) was issued. Register 12 in the abend SVRB is the base register.

Key Label Description
Reg1=X'800002CE' LLPCHECK A required IMS module failed to load.

Possible cause: The causes include:

  1. Hardware failure
  2. PDS directory damaged
  3. Required modules not on the PDS

For DFSPLPP0:

This abend is issued by DFSPLPP0 because BLDL processing encountered a permanent I/O error condition while scanning the PDS directory. Message DFS677I lists the modules that encountered the I/O error. This message is sent to the IMS master console before the abend.

The program status word (PSW) at entry-to-abend points to the instruction within label BLAR from which the abend (SVC 13) is issued. Register 15 in the abend SVRB contains the error return code from the BLDL macro instruction, and register 12 is the base register. The possible BLDL return codes are:

Code
Meaning
X'04'
One or more entries in the list could not be filled; the list supplied might be invalid.
X'08'
A permanent I/O error was detected.

Register 15 should be used to isolate to the specific label in the following table:

Key Label Description
Reg15>X'08' BLDLOOP The return from the BLDL macro instruction was out of the specified range.
Reg15=X'08' BLDLNXT A permanent I/O error condition was detected.

Possible cause: Hardware failure or PDS directory damaged.

For DFSXBAT0:

This is issued by DFSXBAT0 when an IMODULE LOAD fails for one of the following modules: DFSBSCD, DFSPCCC0, DFSRDSH0, DFSBNUC0, DFSKBDP0, DFSCST00, DFSCSS00, DFSCNS00, DFSPCC30, DFSBACM0, DFSFXC10, DFSRDBC0, DFSSDL90, DFS3DF10.

The program status word (PSW) at entry-to-abend points to the instruction within label ABEND from which the abend (SVC 13) was issued. Register 12 in the abend SVRB is the base register.

Key Label Description
Reg1=X'800002CE' ABEND4 An IMODULE LOAD failed for a required IMS module.
Reg14=BAL register   Register 14 points to the location in module DFSXBAT0 that detected the error.
Reg15=return code   Register 15 contains the return code from IMODULE LOAD.

For DFSXCTL0: This is a standard abend issued by DFSXCTL0.

Key Label Description
Reg15=return code ABEND3 The IMODULE LOAD of DFSXCIC0 or DFSKDP10 returned a nonzero return code. The load failed. Register 14 points to the location in module DFSXCTL0 that detected the error.

For DFSXLIC0: This is a standard abend issued by DFSXLIC0.

Key Label Description
Reg15=return code CALLXRIC SVC For IMODULE LOAD or DFSPCCC0 returned a nonzero return code. The load failed.

For DFSDINB0: An IMODULE LOAD failed during DB Control (DBCTL) initialization. Message DFS697I is issued along with this abend. The message contains the name of the module that IMODULE was unable to load and the return code from IMODULE.

For DFSXSL10: An IMODULE LOAD or IMODULE GETMAIN in DFSXSL10 failed during IMS initialization.

This is issued by DFSXSL10 when IMODULE LOAD fails for one of the following modules: DFSSINP0, DFSOCM10, or IMODULE GETMAIN fails.

The program status word (PSW) at entry-to-abend points to the instruction from which the abend (SVC 13) is issued. Register 15 in the abend SVRB contains the error return code. Register 12 is the base register.

Key Description
Reg14=A(caller)
IMODULE LOAD DFSOCM10
Reg15=1
An IMODULE LOAD failed for DFSOCM10.
Reg14=A(caller)
IMODULE GETMAIN
Reg15=2
An IMODULE GETMAIN failed.
Reg14=A(caller)
IMODULE LOAD DFSSINP0
Reg15=3
An IMODULE LOAD failed for DFSSINP0.

For DFSXSTM0:

This is issued by DFSXSTM0 when IMODULE LOAD fails for one of the following modules: DFSFSTM0, DFSXRPS0, DFSHINT0, DFSFDOT0, DFSXLIC0, DFSCNS00. Reg14 should be the return register from the routine that had the load failure, and Reg15 should contain the return code from the IMODULE LOAD.

Key Label Description
Reg14=BAL register   Register 14 points to the location in module DFSXSTM0 that detected the error.
Reg15=return code   Register 15 contains the return code from IMODULE LOAD.

For DFSXTRAO: The system was unable to load needed external trace modules or control blocks. The external trace TCB was abended, allowing OLDS external tracing only. Register 14 contains the BAL REG pointing to the routine that had the error. Register 15 contains the return code from IMODULE.

System action

IMS terminates abnormally.

Programmer response

If this abend was issued by either DFSPLPP0 or DFSPLDR0, the modules for which the I/O error occurred are listed in message DFS677I, DFS678I, or DFS679I. Refer to the appropriate message for the information necessary to correct the problem.

Source

IMS abends

Module

DFSAINB0, DFSPLDR0, DFSPCC30, DFSPLPP0, DFSXBAT0, DFSXCTL0, DFSDINB0, DFSXLCI0, DFSXSL10, DFSXSTM0, DFSXTRA0