Professional Documents
Culture Documents
Messages and Codes Reference, Volume 1 DFS Messages
Messages and Codes Reference, Volume 1 DFS Messages
Messages and Codes Reference, Volume 1 DFS Messages
Version 11
GC19-4232-00
IMS
Version 11
GC19-4232-00
Note
Before using this information and the product that it supports, be sure to read the general information under “Notices” on
page 921.
This edition applies to IMS Version 11 (program number 5635-A02) and to all subsequent releases and modifications
until otherwise indicated in new editions.
© Copyright IBM Corporation 1974, 2014.
US Government Users Restricted Rights – Use, duplication or disclosure restricted by GSA ADP Schedule Contract
with IBM Corp.
Contents
About this information . . . . . . . . vii Chapter 14. DFS messages, DFS0501I
Prerequisite knowledge . . . . . . . . . . viii - DFS550I . . . . . . . . . . . . . 123
IMS function names used in this information . . . viii
How new and changed information is identified viii Chapter 15. DFS messages, DFS551I -
Accessibility features for IMS Version 11 . . . . . ix
How to send your comments . . . . . . . . ix
DFS600I. . . . . . . . . . . . . . 137
Chapter 10. DFS messages, DFS301A - Chapter 26. DFS messages, DFS1101I
DFS350A . . . . . . . . . . . . . . 75 - DFS1150I. . . . . . . . . . . . . 273
Chapter 11. DFS messages, DFS351W Chapter 27. DFS messages, DFS1151I
-DFS400I . . . . . . . . . . . . . . 85 - DFS1200I . . . . . . . . . . . . 283
Chapter 12. DFS messages, DFS401I - Chapter 28. DFS messages, DFS1201I
DFS0450I. . . . . . . . . . . . . . 95 - DFS1250I . . . . . . . . . . . . 293
Chapter 13. DFS messages, DFS0451A Chapter 29. DFS messages, DFS1251I
- DFS0500I . . . . . . . . . . . . 109 - DFS1300I . . . . . . . . . . . . 299
Chapter 32. DFS messages, DFS1401I Chapter 50. DFS messages, DFS2301I
- DFS1450I . . . . . . . . . . . . 323 - DFS2350I . . . . . . . . . . . . 475
Chapter 33. DFS messages, DFS1451I Chapter 51. DFS messages, DFS2351A
- DFS1500I . . . . . . . . . . . . 329 - DFS2400I . . . . . . . . . . . . 483
Chapter 34. DFS messages, DFS1501I Chapter 52. DFS messages, DFS2401I
- DFS1550I . . . . . . . . . . . . 335 - DFS2450I . . . . . . . . . . . . 491
Chapter 37. DFS messages, DFS1651I Chapter 55. DFS messages, DFS2551I
- DFS1700I . . . . . . . . . . . . 357 - DFS2600A . . . . . . . . . . . . 519
Chapter 38. DFS messages, DFS1701I Chapter 56. DFS messages, DFS2601I
- DFS1750I . . . . . . . . . . . . 363 - DFS2650A . . . . . . . . . . . . 527
Chapter 39. DFS messages, DFS1751I Chapter 57. DFS messages, DFS2651A
- DFS1800I . . . . . . . . . . . . 369 - DFS2700A . . . . . . . . . . . . 535
Chapter 41. DFS messages, DFS1851I Chapter 59. DFS messages, DFS2751A
- DFS1900I . . . . . . . . . . . . 381 - DFS2800I . . . . . . . . . . . . 551
Chapter 42. DFS messages, DFS1901I Chapter 60. DFS messages, DFS2801A
- DFS1950 . . . . . . . . . . . . . 391 - DFS2850E . . . . . . . . . . . . 557
Chapter 43. DFS messages, DFS1951 - Chapter 61. DFS messages, DFS2851I
DFS2000I . . . . . . . . . . . . . 401 - DFS2900I . . . . . . . . . . . . 567
Chapter 44. DFS messages, DFS2001I Chapter 62. DFS messages, DFS2901I
- DFS2050 . . . . . . . . . . . . . 417 - DFS2950A . . . . . . . . . . . . 573
Chapter 45. DFS messages, DFS2051I Chapter 63. DFS messages, DFS2951I
- DFS2100 . . . . . . . . . . . . . 427 - DFS3000I . . . . . . . . . . . . 589
Chapter 47. DFS messages, DFS2151 - Chapter 65. DFS messages, DFS3051A
DFS2200I . . . . . . . . . . . . . 451 - DFS3100I . . . . . . . . . . . . 613
Chapter 67. DFS messages, DFS3151 - Chapter 85. DFS messages, DFS4051I
DFS3200 . . . . . . . . . . . . . 629 - DFS4100I . . . . . . . . . . . . 821
Chapter 68. DFS messages, DFS3201 - Chapter 86. DFS messages, DFS4101A
DFS3250 . . . . . . . . . . . . . 635 - DFS4150I . . . . . . . . . . . . 833
Chapter 71. DFS messages, DFS3351E Chapter 89. DFS messages, DFS4251 -
- DFS3400I . . . . . . . . . . . . 667 DFS4300 . . . . . . . . . . . . . 851
Chapter 72. DFS messages, DFS3401I Chapter 90. DFS messages, DFS4301E
- DFS3450 . . . . . . . . . . . . . 677 - DFS4350E . . . . . . . . . . . . 861
Chapter 73. DFS messages, DFS3451 - Chapter 91. DFS messages, DFS4351E
DFS3500W . . . . . . . . . . . . 687 - DFS4400E . . . . . . . . . . . . 867
Chapter 75. DFS messages, DFS3551I Chapter 93. DFS messages, DFS4451I
- DFS3600I . . . . . . . . . . . . 707 - DFS4500E . . . . . . . . . . . . 871
Chapter 76. DFS messages, DFS3601 - Chapter 94. DFS messages, DFS4501 -
DFS3650I . . . . . . . . . . . . . 715 DFS4600I . . . . . . . . . . . . . 875
Chapter 77. DFS messages, DFS3651I Chapter 95. DFS messages, DFS4601E
- DFS3700 . . . . . . . . . . . . . 735 - DFS4650I . . . . . . . . . . . . 881
Chapter 78. DFS messages, DFS3701I Chapter 96. DFS messages, DFS4651I
- DFS3750A . . . . . . . . . . . . 745 - DFS4810I . . . . . . . . . . . . 883
Chapter 79. DFS messages, DFS3751A Chapter 97. DFSD messages (DRD
- DFS3800 . . . . . . . . . . . . . 763 utilities) . . . . . . . . . . . . . . 885
Contents v
Chapter 101. DFSS messages (IMS Trademarks . . . . . . . . . . . . . . 923
abend search and notification) . . . . 917 | Privacy policy considerations . . . . . . . . 924
This information provides reference information for the abend codes, messages,
status codes, and return codes that are produced by IMS.
Volume 1 provides reference information for the IMS messages that have the DFS
prefix, along with their associated return codes. It also provides diagnostic
information that helps programmers, operators, and system-support personnel
diagnose problems in IMS.
Volume 2 provides reference information for non-DFS prefixed IMS messages that
are associated with IMS Base Primitive Environment (BPE); IMS Common Queue
Server (CQS); IMS Common Service Layer (CSL); Database Recovery Control
(DBRC) facility; IMS Connect; IBM® Resource Lock Manager (IRLM), and so on. It
provides diagnostic reference information that helps programmers, operators, and
system-support personnel diagnose problems in IMS.
Volume 3 provides reference information for all IMS abnormal termination (abend)
codes, including analysis, explanation, possible causes, and APAR processing
instructions.
Volume 4 provides return, reason, sense, function, and status codes for IMS Base
Primitive Environment (BPE); IMS Common Queue Server (CQS); IMS Common
Service Layer (CSL); Database Recovery Control (DBRC) facility; IMS Connect; IBM
Resource Lock Manager (IRLM), and so on. It also provides diagnostic reference
information that helps programmers, operators, and system-support personnel
diagnose problems in IMS.
Before using this book, you should have knowledge of either IMS Database
Manager (DB) or IMS Transaction Manager (TM). You should also understand
basic z/OS and IMS concepts, the IMS system for your installation, and have
general knowledge of the tasks involved in project planning.
You should be familiar with z/OS, its system generation, and telecommunications,
and the access methods used by IMS. Related publications are listed in the
Bibliography.
You can learn more about z/OS by visiting the “z/OS basic skills education” topics
in IBM Knowledge Center.
IBM offers a wide variety of classroom and self-study courses to help you learn
IMS. For a complete list of courses available, go to the IMS home page at
ibm.com/ims and link to the Training and Certification page.
Accessibility features
The following list includes the major accessibility features in z/OS products,
including IMS Version 11. These features support:
v Keyboard-only operation.
v Interfaces that are commonly used by screen readers and screen magnifiers.
v Customization of display attributes such as color, contrast, and font size.
Keyboard navigation
You can access IMS Version 11 ISPF panel functions by using a keyboard or
keyboard shortcut keys.
For information about navigating the IMS Version 11 ISPF panels using TSO/E or
ISPF, refer to the z/OS TSO/E Primer, the z/OS TSO/E User's Guide, and the z/OS
ISPF User's Guide Volume 1. These guides describe how to navigate each interface,
including the use of keyboard shortcuts or function keys (PF keys). Each guide
includes the default settings for the PF keys and explains how to modify their
functions.
See the IBM Human Ability and Accessibility Center at www.ibm.com/able for more
information about the commitment that IBM has to accessibility.
| The titles of all PDF publications in the IMS Version 11 library have been changed
| so that the publication titles match the contents view (navigation tree) titles in IBM
| Knowledge Center. For example, the IMS Diagnosis Guide has been renamed to IMS
| Diagnosis. In addition, the titles for the three IMS Command Reference PDF volumes
| have been renamed so that their titles better reflect the contents of each
| publication, as follows:
| v IMS Version 11 Commands, Volume 1: IMS Commands A-M
| v IMS Version 11 Commands, Volume 2: IMS Commands N-V
| v IMS Version 11 Commands, Volume 3: IMS Component and z/OS Commands
| IMS Version 11 Exit Routines is now organized by the call interface and available
| services for each group of exit routines, as follows:
| v IMS system exits, database manager exits, and transaction manager exit routines
| are grouped under “IMS control region exit routines.”These exit routines use
| IMS interfaces and callable services, as described in the topic “Overview of exit
| routines for IMS.”
| v Exit routines that run in an address space with BPE support, including those for
| CQS, BPE-based DBRC, and most CSL components, are grouped under “Base
| Primitive Environment-based exit routines.” BPE-based exit routines use the
| interfaces and services provided by the Base Primitive Environment, as
| described in the topic “BPE user-supplied exit routine interfaces and services.”
| v The CQS exit routines are now divided into two groups: those that run in the
| CQS address space and have access to BPE services are grouped under
| “BPE-based CQS user-supplied exit routines,” and those that execute in a CQS
| client address space are grouped under “CQS client exit routines.”
In the table, an asterisk (*) indicates that the message text is changed.
Table 2. Changed messages and codes for Version 11
BPE, CQS, and DFS and DSP and other Abend, AIB, Component
CSL messages DSP messages messages and DL/I codes codes
| BPE0003E DFS030I DFS1987I DSP0012I AC6 BA
DSP0077I
Chapter 1. New, changed, and deleted messages and codes for IMS Version 11 3
4 Messages and Codes, Volume 1: DFS Messages
Chapter 2. IMS problem determination
IMS messages and codes problem determination is accomplished by using
procedures established by IBM.
DFS messages have the form DFSnnnnZ. The nnnn are 3 or 4-digit numbers; the
letter Z represents a suffix code. The messages are sorted according to the numeric
value of nnnn.
Keycall messages bound for the system console have the suffix I appended to the
message.
Some messages have an IMS system ID appended to identify the IMS system
receiving the message when multiple IMS systems are being run.
Explanation: States what the message means; why it appears; what caused it; what
its variable entry fields are.
System action: States what is happening as a result of the condition causing the
message; whether the system is waiting for responses. If this information is not
shown, it does not apply.
Those messages that refer to function “ff” apply to one of the following utilities as
denoted by the 2-character codes shown below:
Code Meaning
PO Prereorganization
CA Change Accumulation
IM Image copy
RV Database Recovery
SU HISAM Reorganization Unload
RU Secondary Index Unload
SR HISAM Reorganization Reload
RR Secondary Index Reload
DU HD Reorganization Unload
DR HD Reorganization Reload
ZB Database Zap
ZM Module Zap
SN Database Scan
PR Prefix Resolution
PU Prefix Update
Severity: The chart below applies to the MFS Language utility program severity
codes. The severity code indicates the seriousness of the message.
Messages produced by the preprocessor phase of the MFS Language utility place
the severity code to the right of each message number. Messages produced by the
other phases do not include the severity code in the message text. Consult the
individual message descriptions for specific severity codes associated with each
message.
Severity code
Meaning
0 Message is an information message only.
4 Severity code 4 is produced by warnings, minor errors, and assumed
defaults that are probably valid. The creation of valid blocks is probable.
8 This error is significant and it results in questionable defaults, or ignored
specifications. The creation of invalid blocks is possible.
12 Required operand is omitted or contradictory specifications have been
supplied. Creation of invalid blocks is probable.
16 Language translation continues with limited function. Created blocks are
invalid, or creation of blocks is suppressed.
20 Language translation cannot continue and is terminated immediately.
Created blocks are invalid.
The highest severity code issued by the MFS Language Utility Program during a
job step is returned as the completion code to the operating system.
Module: DFSXLGI0
DFS000I various
Explanation: This message number is used for the
DFS003I xxx MODE COMPLETED.
following situations:
v An IMS message number prefixed to user messages
sent to the system console through the IMS queues. or
v A message ID for /DISPLAY responses.
v A message number for messages switched to the DUP MODE COMPLETED. nnnnn ERRORS.
system console. Explanation: Either form of this message can be
v Continuation lines on messages of more than one issued, and both indicate that the Log Recovery utility
segment. successfully completed the DUP, REP or CLS function.
v Name of DBRC region to be included online. nnnnn specifies the number of error records written on
System action: IMS continues processing. the interim log data set during the DUP processing. xxx
represents the CLS or REP mode.
Module: DFSCINB0, DFSDNSC0, DFSFDR60
System action: The Log Recovery utility terminates
normally.
DFS001 UNDETERMINED ERROR ON 3270.
LINE x PTERM y Programmer response: For CLS mode and REP mode,
no response is required.
Explanation: An undetermined error was detected in
module DFSDN130 (remote 3270), or in DFSDN140 For DUP mode, if nnnnn=0, the output log is error free
(local 3270). and can be used as the online log data set (OLDS). If
nnnnn=1 and you specified ERRC=00000, an error
System action: The line has been stopped. A log occurred on the input log and the output log was
record type X'67' sub-record X'01' has been written truncated at the point of error. Check the input log at
using the IMS TRACE facility, which provides a snap of the error point to determine if the output log was
the IMS control blocks and save areas. truncated at the correct point. Otherwise, use the Log
Operator response: (master terminal) You can attempt Recovery utility in REP mode to produce an error free
to restart the line with a /START LINE x PTERM ALL OLDS.
command. If the failure occurs consistently, please print Module: DFSULG10
the log data set to determine the cause of the error.
Problem determination: 1, 5, 6, 36 | DFS0004I PARDLI NOT ALLOWED FOR THIS
Module: DFSDN130, DFSDN140 | BMP DUE TO THE USE OF FASTPATH
| 64 BIT PRIVATE BUFFERS
Related information:
Chapter 2, “IMS problem determination,” on page 5 | Explanation: Parallel DL/I processing in the IMS
| control region (PARDLI=1) is not allowed when
| running FPBP64=Y on z/OS V1R9.0. If you must run
DFS002I MONITOR WILL NOT BE | with PARDLI=1, consider running on z/OS V1R10.0 or
AVAILABLE-NOT SL TAPE | later.
Explanation: The data communication monitor tape | System action: PARDLI=1 is changed to PARDLI=0
must be a scratch tape with a standard label or | and processing continues as normal.
standard user label.
| Operator response: No action is required.
System action: IMS continues processing without
monitor logging. | Module: DBFPARDL
PENDING CONNECTIVITY LOST status for the System action: The command is rejected.
structure. If you are employing a DASD mirroring
Programmer response: Reenter the command from an
solution for disaster recovery with CFRM policies
OM API with an authorized USERID, or update the
identical at both the disaster recovery remote sites
authorization information for the current USERID and
(DRRS) and the production site, answering Y identifies
reenter the command from the OM API.
this system as an IMS at a disaster recovery site. It
bypasses the error status. Be sure to include both the Module: DFS0CM30
production site and disaster recovery site CF in the
preference list for the SVSO structures.
DFS0011W AREA=areaname DD=ddname
System action: If you indicate that this system is a ALLOCATION FAILED
remote disaster recovery site, IMS proceeds with the
area open processing by creating and connecting to a Explanation: The named DD could not be allocated by
new structure. the /START AREA command. The named DD is not
specified by a DD statement nor is it specified in the
If you indicate that this system is not a remote disaster ALLOCATE/DEALLOCATE parameter list.
recovery site, the area open processing is terminated
with message DFS3702I with reason code 41. System action: Processing continues without the
named DD allocation.
System programmer response: Reply Y or y if this
IMS is at the remote disaster recovery site. Any other Programmer response: Correct the DD in the
reply indicates this IMS is not at disaster recovery site. ALLOCATE/DEALLOCATE parameter list, and reenter
the /START AREA command or issue the UPDATE
Module: DBFVXAS0 AREA START(ACCESS) command.
Module: DBFARDA0
DFS0007I /STA MADSIO COMMAND IGNORED.
MADSIOT ALREADY ACTIVE.
DFS0012I SPOOL DATASET UNALLOCATION
Explanation: The MADSIOT function was already ERROR - aaaaaaaa,bbbb,
active when the /START MADSIO command was cccccccc,dddd,eeee,ff,gggg,hhhh,ii..ii
issued. Issue the /START MADSIO command to
resume MADSIOT function if it is stopped. Explanation: An error occurred during deallocation of
an IAFP JES SPOOL data set.
System action: The /START MADSIO command was
not processed. In the message text:
aaaaaaaa
Operator response: No action is required. Job name of the IMS-dependent region for
which the deallocation failed.
Module: DBFCST00
bbbb Job number corresponding to job aaaaaaaa
cccccccc The ddname of SPOOL data set.
DFS0008I /STO MADSIO COMMAND dddd Dependent region number.
IGNORED. MADSIOT IS NOT eeee Return code from SPOOL data set deallocation
ACTIVE. processing.
ff Deallocation request type. Possible values are
Explanation: The MADSIOT function was not active
as follows:
when the /STOP MADSIO command was issued.
80 No special request
System action: The /STOP MADSIO command was 40 Remove from hold status
not processed. 20 Send to remote destination
08 Delete data set
Operator response: No action is required. gggg Dynamic deallocate error code.
Module: DBFCST00 hhhh Dynamic deallocate error information.
ii..ii data set name for 44 bytes.
DFS009 timestamp COMMAND NOT This message is returned only if the application
AUTHORIZED AS ENTERED FROM program requested “Messages” for the data set in the
OM API IAFP= options parameter.
Explanation: The command that was entered is not
authorized from the entering OM API. The command During IMS sync point or Terminate Thread processing,
authorization was specified on the CMDSEC= the referenced print data set was not deallocated. The
parameter of the CSL PROCLIB member DFSCGxxx print data set remains allocated to the dependent
(RACF® or equivalent, DFSCCMD0, or both), but it region until the dependent region terminates. The
does not authorize the user ID of the OM API to issue dependent region must be terminated as soon as
the command. practical so MVS can deallocate the data set. The MVS
operator might need to control the proper disposition text for an indication of the IMS or z/OS service being
of the print data set. See message DFS0013E for used. Additional information about the error is also
detailed information about the deallocation error. available on the IMS system log, log record type 67D0.
Additional information about the error is also available
Problem determination: See the z/OS MVS
on the IMS system log, log record type 67D0.
Programming: Authorized Assembler Services Guide
System action: Processing continues uninterrupted. (SA22-7608) for return and reason codes.
Programmer response: Review the ff section of this Module: DFSIAFP0
message. If ff=8, the deallocation failure occurred while Related reference:
attempting to delete the data set. Delete the data set as
soon as the dependent region terminates. If ff contains Deallocating Resources
any other value, print the data set after the dependent
region terminates. Interpreting Error Reason Codes from DYNALLOC
Explanation: DBFARD30, DBFARD40, DBFMLCL0, Programmer response: If the dynamic backout was
DBFHDEP0, or DBFSTAP0 issued UNAUTH request to unsuccessful, the Batch Backout utility can be used to
DBRC, but DBRC returned a nonzero return code less attempt the backout.
or equal to 16.
Problem determination: 1, 2, 8, 11, 36
System action: The unsuccessful return code is passed
Module: DFSDLA00
to the caller.
Related information:
User response: For the meaning of the return code,
Chapter 2, “IMS problem determination,” on page 5
see the “Return codes from Unauthorization call” topic.
Contact the IBM Software Support if additional help is
needed. DFS0023I COMMAND REJECTED. MADSIOT
KEYWORD NOT FOUND IN
Module: DBFARD30, DBFARD40, DBFMLCL0,
DFSVSMxx.
DBFHDEP0, DBFSTAP0
Related reference: Explanation: The /START MADSIO or /STOP
MADSIO command was issued, but the MADS I/O
DBRC request return codes (Messages and Codes) Timing function was not enabled in this IMS.
Return codes from Unauthorization call (Messages System action: Processing continues.
and Codes) Operator response: To enable the MADS I/O Timing
function, specify the keyword MADSIOT in the
DFS0020I DMAC HAS BAD POINTER TO DFSVSMxx PROCLIB member by using the format:
DMCB, /DIS STATUS DB COMMAND MADSIOT=(StructureName,IOTime)
REJECTED
Where:
or v StructureName is 16 characters.
v IOTime is a 3-digit value (0-255) that specifies the
NO DDIR WAS FOUND, /DIS STATUS DB time span in which the Media Manager returns the
COMMAND REJECTED status of the IO request.
The MADSIOT function will be enabled after IMS
or
recycles.
Operator response: Reenter the data with the correct record type X'67', subrecord X'01' was written using the
password format. IMS TRACE facility, which provides a snap of the IMS
control blocks and save areas.
Module: DFSICIO0
Operator response: (master terminal) Notify your IMS
system programmer. The line cannot be reactivated
DFS025 UNABLE TO FIND INPUTTING
until the IMS control region has been shut down and
TERMINAL. LINE STOPPED. LINE x
reactivated.
PTERM y
Programmer response: Determine the cause of failure.
Explanation: Input was received on the indicated line,
and the originating terminal could not be determined. Problem determination: 14, 36
System action: The line has been stopped. A log Module: DFSICIO0
record type X'67', sub-record X'01' was written using Related information:
the IMS TRACE facility, which provides a snap of the
Chapter 2, “IMS problem determination,” on page 5
IMS control blocks and save areas.
Operator response: (master terminal) Contact your
DFS028 INVALID ATTENTION INPUT
IMS system programmer for assistance. Determine the
DETECTED
cause of the failure (possible hardware malfunction, or
terminal not defined to IMS). The line can be restarted Explanation: Input that required action was received,
with the /START LINE command. but the DFSCFEP0 (MFS Paging Processor) did not
recognize it.
Programmer response: Determine the cause of the
failure. System action: Input is ignored, and the terminal is
made inoperable.
Problem determination: 5, 6, 14, 36
Programmer response: If the terminal is
Module: DFSDN030
programmable, check the logic—how is attention sent
Related information: to the host? If the terminal is not programmable, there
Chapter 2, “IMS problem determination,” on page 5 is a probable hardware error. If the problem recurs,
take a DC trace or a GTF trace.
DFS026 UNABLE TO FIND INPUTTING Module: DFSCFEP0
TERMINAL. LINE DEACTIVATED.
LINE x PTERM y
DFS029 DDM LOGIC ERROR DETECTED
Explanation: Input was received on the indicated line,
Explanation: An invalid request was returned to the
and the originating terminal or control unit could not
MFS output control module (DFSCFEO0) from a
be determined.
device-dependent module. The device-dependent
System action: The line was deactivated. A log record module requested the data after the EOM or EOD
type X'67', subrecord X'01' was written using the IMS occurred.
TRACE facility, which provides a snap of the IMS
System action: The terminal is made inoperable.
control blocks and save areas.
Programmer response: Check for any discrepancy
Operator response: (master terminal) Notify your IMS
between the actual terminal and its definition in IMS. If
system programmer. The line cannot be reactivated
the terminal is programmable, also check for logic
until the IMS system has been shut down and
errors in the output.
restarted.
Module: DFSCFEO0
Programmer response: Determine the cause of failure.
Problem determination: 14, 36
DFS030I DBRC VERUOR REQUEST FAILED,
Module: DFSFTRM0 RC=yy
Related information:
or
Chapter 2, “IMS problem determination,” on page 5
DBRC REQUEST FAILED, REASON=xx, RC=yy
DFS027 I/O ROUTINE ERROR
or
Explanation: The device module has failed to interface
correctly with the communications analyzer. This was
DBRC SIGNOFF REQUEST FAILED xx, RC=yy
caused by a device-dependent module logic error.
System action: The line has been shut down. A log or
record specified was not found. The begin Programmer response: Check the return code and
HSSP Image Copy call should create that take appropriate action.
image copy record.
Problem determination: 1, 4, 10, 35
10 DBRC received an end HSSP Image Copy call
during image copy termination. The DBRC Module: DFSDDUI0, DFSDLOC0, DFSPCCC0,
return code indicates that the database/area DBFPICT0
was not registered in the RECON data set. Related reference:
HSSP Image Copy can only process a
registered database/area. DBRC request return codes (Messages and Codes)
20 DBRC received an end HSSP Image Copy call Related information:
during image copy termination. The DBRC
return code indicates that the end HSSP Image Chapter 2, “IMS problem determination,” on page 5
Copy call was already made for this image
copy processing. Abend 3275 is issued if DFS031I IRLM QUIT REQUEST FAILED,
DBRC returns this code and the system is not RC=xx-yy
being emergency restarted.
30 DBRC received an end HSSP Image Copy call Explanation: During normal termination of IMS, the
during Image Copy termination. The DBRC quit request to the IRLM failed. The return code xx and
return code indicates that an internal DBRC reason code yy indicate the error condition. To
error occurred. determine the cause of the failure, see IRLM request
40 DBRC received an end HSSP Image Copy call return and reason code information for the QUIT
during image copy termination. The DBRC request codes.
return code indicates that an invalid parameter System action: IMS terminates abnormally.
was found.
50 DBRC was called to unauthorize a database Operator response: Inform the system programmer.
during close DMB processing for RSR DL/I Programmer response: Check the cause of the
database tracking. The DBRC return code, problem and, if necessary, restart IMS with /ERE.
X'48', indicated there was a bad parameter
passed during the unauthorize call. Problem determination: 1, 4, 10, 36
51 DBRC was called to unauthorize a database
Module: DFSPCCC0
during close DMB processing for RSR DL/I
database tracking. The DBRC return code, Related tasks:
X'04', indicated the database was not currently
IRLM return and reason codes
authorized.
52 DBRC was called to unauthorize a database Related information:
during close DMB processing for RSR DL/I Chapter 2, “IMS problem determination,” on page 5
database tracking. The DBRC return code,
X'08', indicated the authorized USID was not
DFS032I DUPLICATE ENTRY ON IDENTIFY
complete.
REQUEST, RESTART ABORTED
53 DBRC was called to create a REORG record
for the database. The return code from DBRC Explanation: An identify request was issued to the
indicates there was a problem processing the IRLM and the return code received indicated that an
request. For additional information about entry existed by that name.
return codes from the RELOAD Utility, and to
determine the cause of the failure, see the System action: Restart is terminated.
DBRC request return codes information in IMS Operator response: If no backout is required, enter
Version 11 Messages and Codes, Volume 4: IMS /ERE COLDSYS to restart IMS.
Component Codes.
54 DBRC was called to create a REORG record Module: DFSRST00
for the database. The return code, X'04',
indicated that the database was not registered. DFS033I DUPLICATE ENTRY ON SIGNON
55 DBRC was called to create a REORG record REQUEST, RESTART ABORTED
for the database. The return code, X'08',
indicated there was an I/O error reading the Explanation: A sign-on request was issued to DBRC
RECON data set. and the return code received indicated that an entry
56 An invalid partition reorganization number already existed in the RECON data set for the IMS
was passed on the notify reorganization call to system.
DBRC. System action: Restart is aborted.
System action: IMS terminates abnormally with abend Operator response:
3275.
If an XRF alternate system is being started, enter the
/ERE BACKUP command; otherwise, enter /ERE – Run the Batch Backout utility to a checkpoint that
OVERRIDE. occurred after the program made some updates.
Then use the XRST call to restart the program at
Module: DFSRST00
the checkpoint used in the batch backout job.
DFS034I DATA BASE AUTHORIZATION AND If a batch backout is required, you must either restart
LOCKS RELEASED the program from the last checkpoint or from an earlier
checkpoint. The option of restarting a job from an
Explanation: An emergency COLDSYS start, using
earlier checkpoint is not available in a data-sharing
/ERE COLDSYS command, was specified, and the
environment.
database and global locks authorized from the previous
v To restart the program from the last checkpoint, run
run of IMS were released.
the Batch Backout utility. Then use the XRST call to
System action: IMS continues with the execution. restart the program.
v To restart the program from an earlier checkpoint
Programmer response: Ensure that offline recovery or than the last one, do one of the following:
batch, or both, backout is performed. – Run the Batch Backout utility to the first
Module: DFSRST00 checkpoint that occurred before the program made
any updates. Then rerun the program.
– Run the Batch Backout utility to a checkpoint that
DFS035I TYPE INITIALIZATION COMPLETE occurred after the program made some updates.
Explanation: This message indicates that the Then use the XRST call to restart the program at
initialization process is completed. After the issuance of the checkpoint used in the batch backout job.
this message, the process links to the application Module: DFSPCCC0, DFSFLST0
program.
When BATCH is displayed in the TYPE field, the DFS036I BATCH BACKOUT /NOT
initialization process is completed for a DL/I batch REQUIRED/IS REQUIRED/ FOR
environment. When IMBATCH is displayed in the jobname
TYPE field, the initialization process is completed for a
DCCTL batch environment. Explanation: This message indicates whether batch
backout is required for a batch job that is terminating
System action: Execution continues. abnormally. If batch backout is not required, the
Module: DFSPCC30 application program terminated abnormally for one of
the following reasons:
v No database updates were made
DFS036A BATCH BACKOUT /NOT v The job has no log
REQUIRED/IS REQUIRED/ FOR v The dynamic backout in batch ran successfully.
jobname
Explanation: This message indicates whether a batch If batch backout is required, the application program
backout is required after a batch job was terminated makes database updates, but no CHKPT checkpoint call
abnormally and updates were committed. If batch is made. Message DFS681I is not issued.
backout is not required, the application program made
all updates before the last checkpoint or the dynamic Batch backout can also be required for a job where
backout in batch (BKO=Y) ran successfully. If batch there have been no updates but where GET TYPE calls
backout is required, the application program made resulted in extended pointer set corrections.
updates after the last checkpoint. System action: The batch job terminated.
System action: The batch job terminated. Programmer response: If a batch backout is required,
Programmer response: If a batch backout is not run the Batch Backout utility. Rerunning the backout
required, you must either restart the program from the from the beginning or using XRST is your or your
last checkpoint or from an earlier checkpoint. The application's option; there are no IMS integrity issues
option of restarting a job from an earlier checkpoint is after backout is done successfully.
not available in a data-sharing environment. Module: DFSPCCC0, DFSFLST0
v To restart the program from the last checkpoint, use
the XRST call. Related information:
v To restart the program from an earlier checkpoint, do “DFS681I” on page 168
one of the following:
– Run the Batch Backout utility to the first
checkpoint that occurred before the program made
any updates. Then rerun the program.
DFS037I IRLM SPECIFIED, DBRC NOT ACTIVE DFS039A imsid ACTIVE, REPLY RETRY, CANCEL,
OR DUMP.
Explanation: For this execution of IMS, IRLM=Y was
specified but DBRC was not specified in the IMSGEN.
or
It might have been overridden in the JCL EXEC
statement.
xxxx NOT ACTIVE. REPLY RETRY, CANCEL, OR
System action: IMS terminates abnormally with IRLM DUMP.
abend 0037.
Explanation: Message DFS039I is followed by this
Programmer response: Ensure that DBRC was message.
specified in the IMSGEN or that DBRC=N was not
specified in the EXEC job control statement parameter Message DFS039I is first issued when an IDENTIFY
list. request to the IRLM fails. Return code xx and reason
code yy indicate an error condition. Return code 00 or
Problem determination: 8, 10 04 are returned if IRLM is holding subsystem
information for a DL/I batch job. Use the F
Module: DFSXLIC0, DFSRST00
IRLMPROC,STATUS command to display information.
Related information: Run batch backout for the DL/I batch job that
Chapter 2, “IMS problem determination,” on page 5 encountered RC=00 or RC=04.
To determine the cause of the failure for message
DFS038I PURGE REQUEST FAILURE, UNABLE DFS039I, see the IDENTIFY request explanation in the
TO RELEASE LOCKS IRLM request return and reason code information. This
message is followed by a second DFS039I or a
Explanation: A purge command to release all locks
DFS039A message.
held by this subsystem from the previous execution
failed. Upon completion of an emergency restart or The second version of DFS039I might be issued if IMS
batch backout execution, a purge command is issued to and IRLM are enabled for the z/OS automatic restart
the IRLM to release all locks. The attempt to release the manager. The message indicates IMS restart is
locks resulted in a bad return code. Register 15 contains WAITING for IRLM to send READY to the automatic
the return code. To determine the cause of the failure, restart manager.
see the PURGE request codes in IRLM request return
The DFS039A message is a WTOR. The first form of the
and reason code information.
message is issued if the xx-yy fields indicate the file
System action: IMS terminates abnormally with abend IRLM named in the xxxx field is not active. The second
0038. form of the message is issued if the IMS ID that is
identified to IRLM is already active.
Programmer response: Ensure that the IRLM is active.
System action: If IMS is not registered with the
Problem determination: 1, 4, 10, 35
automatic restart manager and the xx-yy fields indicate
Module: DFSPCCC0, DFSRST00 that IRLM is not active or that this IMS subsystem is
Related tasks: already identified to IRLM, the WTOR form of the
message is issued. Other error return and reason codes
IRLM return and reason codes causes IMS to abend with 0039.
Related information: If IMS is in the process of being restarted by the
Chapter 2, “IMS problem determination,” on page 5 automatic restart manager and the xx-yy fields indicate
that IRLM is not active or that this IMS subsystem is
already identified to IRLM, IMS determines if IRLM
DFS039I IMS WAITING FOR IRLM ARM was registered to the automatic restart manager in the
READY. previous IMS run. In the case when IRLM was
previously registered with the automatic restart
or manager, IMS issues the second form of the DFS039I
and WAIT until the automatic restart manager is aware
IRLM IDENTIFY REQUEST FAILED, RC=xx-yy that IRLM is ready for work. Other error return and
Explanation: This message accompanies DFS039A. See reason codes cause IMS to end abnormally with abend
the information for that message for a detailed 0039.
explanation and actions. For the return code xx-yy, see Operator response: Operator action is required for the
IRLM return and reason codes. WTOR form of the message.
Related information:
If the IRLM named in the xxxx field is not active,
DFS039A ensure the xxxx name is correct. If xxxx is not the
correct name, the operator can reply ABEND to the
WTOR and then start IMS again specifying the correct
IRLMNM. If xxxx is correct, the operator can wait until communication has been reestablished between sharing
the IRLM is active and then reply RETRY to the WTOR. IRLMs. If data sharing is required, shut down IMS and
restart it.
If the IMS subsystem is already identified to the IRLM,
the operator should investigate the status of the Module: DFSRST00, DFSPCCC0
subsystem currently identified to IRLM. There are at
least two situations where a delay in identifying to
DFS041I DBRC SIGNON REQUEST RC=cc
IRLM might be needed. First, the submission of two or
more IMS Batch jobs with accidentally the same job Explanation: A sign-on request to DBRC completed
name could happen. Waiting for the first batch job to with the return code cc specified. For the definition of
finish and then replying RETRY would allow the the return code, see the DBRC request return codes
second job to then proceed. If the same job is information.
accidentally submitted twice, the job will probably only
run once and the installation might want the operator System action: If the return code indicates a severe
to terminate the second job by replying CANCEL. error, IMS terminates with abend 0041; otherwise,
execution continues.
Second, some failures for which a CICS® XRF alternate
takes over can result in the identify return code Return codes 16 and 24 might cause IMS to terminate
indicating the subsystem is already active. IRLM with abend 0041.
corrective action to force IRLM into an in-doubt state Return codes 8, 12, 20, 28, 32, and 41 cause IMS to
and then a failure state can be called before replying terminate with abend 0041.
RETRY in this case.
Programmer response: A sign-on failure can occur if
The WTOR replies and their meaning follow. the sign-on request specified a subsystem ID existing in
RETRY This causes IMS to retry the IRLM IDENTIFY. the RECON data set. See the DBRC CHANGE.SUBSYS
If the situation has not been corrected, the or DELETE.SUBSYS command for information about
DFS039I and DFS039A messages occur again. updating the subsystem record in RECON.
CANCEL
This causes IMS subsystem initialization to You can take the following actions depending on the
terminate with abend 0039 without a memory return code cc. All other return codes indicate a
dump. If the IRLM was not active when the possible system error; see DBRC request return codes
OS operator modified IMS with the information for any return codes not listed here.
RECONNECT command, responding 8,12,16,20
CANCEL only terminates the IRLM reconnect This problem occurs during a cold or warm
processing; as a result, the OS operator start of an online system or during
receives message DFS625I with a 08 code. initialization of a batch system. The code
DUMP This problem causes the IMS subsystem to indicates that there is a conflict between the
abend 0039 with a memory dump. subcode system ID in this system and DBRC.
The subsystem ID is the IMSID for online
Problem determination: 1, 4, 10, 35 systems or the job name for batch systems.
Module: DFSRST00, DFSPCCC0 Either change the subsystem ID for this system
and resubmit the job, or list the subsystem
Related tasks: entry already known to DBRC and determine
IRLM return and reason codes why a duplicate exists.
24 This problem occurs during emergency restart
Related information: or batch backout, for information only, and
“DFS039I” on page 19 indicates that the previous execution failed
without informing DBRC of the abnormal
IMS abend 0039 termination. No action is required.
Chapter 2, “IMS problem determination,” on page 5 28 This problem occurs during batch backout and
indicates that DBRC is not aware of the
subsystem entry for the log supplied to batch
DFS040I UNABLE TO ACQUIRE COMMAND
backout. Ensure that the proper log is used. If
LOCK, DATA SHARING
it is, then batch backout was not needed and
DISCONTINUED
no further action is required. This occurs
Explanation: IMS attempted to acquire the command during batch backout and indicates that DBRC
lock after linkage was established with the IRLM. The is not aware of the subsystem entry. The batch
command lock is used for communication between backout probably does not have to be done,
sharing IMS subsystems and is required when data is and no action is required.
shared. 32 This problem occurs during emergency restart
or batch backout and indicates that a change
System action: IMS continues without data sharing.
has been made in the IRLM name. Rerun the
Operator response: (master terminal) Ensure that
A global service group (GSG) name was specified Chapter 2, “IMS problem determination,” on page 5
during IMS system definition or as an execution
parameter, but DBRC is not active (that is, DBRC=NO
DFS046A PROCESSING INTENT ppppppp FOR
was specified during system definition or DBRC=N was
DATA BASE xxxxxxxx NOT
specified as an execution parameter). DBRC is
COMPATIBLE WITH ACCESS zz.
required for RSR processing.
PSB=PSB name.
v DBRC TURNED OFF FOR THIS EXECUTION
Explanation: One of the DB-PCBs contained in the
Database backout is running. DBRC=N was specified
named PSB referenced the named database xxxxxxxx
for this execution, and DBRC was active in the
which had an incompatible PROCESSING INTENT
previous execution. Processing continues normally
ppppppp with the ACCESS parameter zz defined in the
without DBRC.
database statement for the IMS online subsystem. The
System action: When DBRC REQUIRED FOR THIS PROCESSING INTENT, READ-GO, READ, UPDATE,
EXECUTION appears, the job terminates abnormally. or EXCL is derived from the PROCOPT specifications
When DBRC TURNED OFF THIS EXECUTION in the PSBGEN. The PSB name only appears in the
appears, processing continues normally. DBRC is not message text if the IMS is an online subsystem.
used during this execution.
System action: A batch region (DL/I or DBB region)
Programmer response: When DBRC REQUIRED FOR will terminate with abend 0046. Dependent regions
THIS EXECUTION appears, ensure that DBRC is continue processing, but the programs cannot access
present for this execution. For database backout, an the database. An attempt to access the database will
execution-time parameter of DBRC=N can be specified result in either a 'BA' status code, if the program has
if IRLM was not present in the previous execution. issued the INIT call, or in abend 3303, if the program
has not issued the INIT call. If the database is a Fast
When DBRC TURNED OFF FOR THIS EXECUTION
Path DEDB, the PSB is stopped.
occurs, processing continues without DBRC. Before
reactivating DBRC, record the information about the Operator response: (master terminal) Notify your IMS
OLDS data set (IMS log) created by this backout system programmer of the message.
execution while DBRC was inactive in RECON using
Programmer response: One of the following responses
the DBRC commands NOTIFY.PRILOG and
should be taken:
NOTIFY.SECLOG.
v Contact the master terminal operator to change the
Problem determination: 2, 8 database ACCESS parameter to the level compatible
with your PROCESSING INTENT.
Module: DBFUMIN0, DFSRLP00, DFSBCKI0
v Change the PROCOPT operand specifications to the
Related information: level compatible with the ACCESS parameter defined
Chapter 2, “IMS problem determination,” on page 5 in the database statement for the IMS online
subsystem. Rerun ACBGEN, and then the job.
Reason codes 10 through 14 indicate that a system error DFS049I UNABLE TO OBTAIN STORAGE TO
has occurred. If these problems persist, contact IBM for BUILD DATA BASE AUTHORIZATION
problem determination assistance. REQUEST LIST. PSB yyyyyyyy
STOPPED.
For reason code 33, check the DBDLIB level of the Explanation: A conditional GETMAIN was issued in
databases to make sure that they match the RECON an attempt to obtain a larger work storage area to build
level. the database authorization request list. However, the
GETMAIN failed. The reason for the failure is due
| For reason codes 41 and 42, wait for the quiesce to end either to the PSB yyyyyyyy, which contains too many
| and rerun the job which failed authorization. The status database PCBs, or to the small REGION size specified
| of the database can be determined by issuing in the JOB startup JCL.
| /DISPLAY DB QSC, /DISPLAY STATUS DB, or Query
System action: The named PSB is stopped. For an
| DB, or LIST.DB DBD(dbname), and examining the
MPP, the input message is placed back into the
| output. If the image copy failed, wait for the quiesce to
message queue. For a BMP, IFP, DBB, or DLI region
| end or until the QUIESCE HELD flag is set on. You can
type, the region terminates abnormally with abend
| set the QUIESCE HELD flag on by UPD
0047.
| START(QUIESCE) OPTION(HOLD) command
| processing when quiesce has occurred. While processing a command such as a /START DB
command, no program specification block (PSB) exists
Problem determination: 35
and abend 0047 is not issued. If the failure occurs
during a restart with in-doubt units of recovery, abend “DFS0730I” on page 181
0484 is issued. Chapter 2, “IMS problem determination,” on page 5
Operator response: (master terminal) Notify your IMS
system programmer of the message.
Programmer response: Take one of the following
actions:
v For an online subsystem, increase the size of the
REGION parameter in the IMS control region startup
JCL. For a batch subsystem, increase the size of the
REGION parameter in the JOB startup JCL.
v Change the PSB to contain a lesser number of
database PCBs. Rerun ACBGEN and then the job.
Problem determination: 6, 10, 19
Module: DFSDBAU0
Related information:
Abend 0047
Abend 0484
Chapter 2, “IMS problem determination,” on page 5
X'35'–X'63'
DFS055 INCORRECT RESPONSE REQUESTED
Reserved
Explanation: The response requested by a logical unit
The fields out of the BTAM DECB are shown as they did not agree with the INQUIRY= parameters specified
are passed to IMS from BTAM. See OS/VS BTAM for this transaction at system definition.
(GC27-6980) for an explanation of these fields. Also, in
System action: The input is rejected.
addition to the error information contained in the
message, the device-dependent module logs out, on the Operator response: Reinitiate the session.
IMS log data set, all of the IMS control blocks from the
Problem determination: This problem is a probable
time of failure in an X'6703' record.
user error in the system definition or the Intelligent
Module: DFSC3270 Remote program in the logical unit. Update
transactions, recoverable inquiry transactions, and
message switches must request a positive response.
DFS052 CARD ENTRY INDICATED, NO CARD
Unrecoverable transactions can optionally request a
DATA FOUND
positive response.
Explanation: A hardware malfunction occurred on a
Module: DFSICIO0
3270 magnetic card reader. The AID byte indicated that
a read operation was requested, but the card data was
not received in the TP buffer. DFS056 COMMAND NOT VALID WITH MFS
OPTION 3
System action: Input is ignored.
Explanation: You entered a command, and the
Operator response: Carefully reinsert the card. If the
Message Input Description (MID) has the parameter
problem recurs, perform the terminal troubleshooting
OPT=3 coded.
procedures.
System action: The command is not processed.
Module: DFSCFE00
Operator response: (remote terminal) Because this
message was formatted using the default blocks, which
DFS053 TERMINAL RESTARTED-PLEASE
do not use option 3, the command can be reentered at
REFORMAT SCREEN
this time.
Explanation: As a result of an I/O error, a terminal
Module: DFSICL30
that was in conversation or exclusive mode, was
stopped and has now been restarted.
DFS057I REQUESTED BLOCK NOT
System action: The system continues normal
AVAILABLE: blockname RC = reason
processing.
Explanation: MFS cannot fetch the control blocks
Operator response: If the terminal was in
required to process an output message or to process the
conversational mode, enter a /HOLD followed by a
/FORMAT request. blockname in the message identifies
/RELEASE command to reformat the screen with the
the block that could not be fetched and is either the
last format sent before this message.
MOD or the DOF name. If it is the DOF name, the first
Module: DFSDN130 two bytes of the name are the device type and features
printed in hexadecimal. For an interpretation of these
two bytes, see Format library member selection
DFS054 INPUT NOT ALLOWED TILL (Application Programming APIs).
PRINTER IS AVAILABLE
The reason code reason indicates the type of failure that
Explanation: Input from a 3277 is not permitted while occurred:
a 3284/3286 printer is busy processing a copy
operation. Code (hex)
Meaning
System action: The input is ignored. 04 The indicated block name was not found in
Operator response: (terminal operator) Wait until the the active format data set library. The
printer becomes available. following conditions can cause this reason
code to be produced:
Module: DFSCFEP0 v There is a misspelled message output
descriptor (MOD) name or the MOD does
not exist in the active format data set
library.
v A device output format (DOF) for the
specified MOD with the device type and
feature indicated does not exist in the active format buffer pool. In both cases, the X'67' log record
format data set library. contains helpful information.
08 There is a permanent I/O error in the active
For reason codes 38 and 78:
format data set library.
0C The main storage space required for the MOD Stop using the transactions using the MOD, the DOF,
or DOF, or both, is greater than the maximum or both until the blocks can be replaced. The MOD or
space currently available in the message DOF and its format set must be recompiled and then
format buffer pool. Alternatively, no fetch replaced using the online change process. The invalid
request elements (FREs) were available. This block might have been destroyed in the FORMAT
return code is issued only by prefetch routines, library, an error might have been compiled into the
not by immediate fetch routines. block, or an error exists in one of the MFS online
14 A MOD block was to be fetched. The fetched modules.
block was not a MOD.
18 The MOD block fetched was compiled before Two X'67' log records are written to the IMS log. The
Release 1.1.1 of IMS. first record has an ID of MTRP and has information
1C The MOD and DOF fetched were incompatible useful for diagnosing the reason for potential
(not compiled at the same time). The use of overwrite. The second record has an ID of FERR and
z/OS utilities to alter the active format data records the unavailability of the MOD or DOF.
set library can cause this problem. Programmer response: Take the following action to
20 The MOD or DOF contains an invalid field. correct the errors.
This problem can be caused by modification
of, or damage to, the format or test format For reason code 04:
library. v Ensure that the MOD name provided from the
24 The requested MOD or DOF is too large for application program, by the previous Message Input
the message format buffer pool (MFBP). The Description (MID) NXT= parameter, or in a
MFBP must be increased. Notify the system /FORMAT command is spelled correctly and that the
programmer. MOD exists in the active format data set library.
28 The DOF and CIB screen sizes are v Ensure that the DOF exists in the active format data
incompatible. This problem occurs only for set library with the device type and features of the
3270-AN device types. The screen size defined terminal receiving the error message. If the MOD
for system definition was different from the specifies the IGNORE option, the DOF must have the
size in the device characteristics table, IGNORE feature specified.
DFSUDTOX. The system programmer should
ensure that the correct device characteristics For reason code 0C:
table is used.
38 The MOD is not available because use of the Use the MFS utility to determine the combined size of
MOD causes the HIOP storage pool to be the MOD and DOF. Increase the space available for
overwritten. format blocks in the message format buffer pool using
78 The DOF is not available because use of the the "HHH" parameter on the IMS control region EXEC
DOF causes the HIOP storage pool to be statement.
overwritten.
For reason codes 14 and 1C:
System action: Since the requested blocks were not
available, IMS formatted and sent the message using
Reprocess the message source definition using the MFS
the 'default block error message format (DFSMO3)', and
Language utility.
then dequeued the message.
If TRACE is set on for this NODE/PTERM, an X'67' For reason code 18:
record is created on the IMS log with the ID of "FERR".
Operator response: (master terminal) Take the The MFS libraries from previous versions cannot be
following action to correct the errors: used. All message and format source definitions must
be recompiled using the MFS Language utility.
For reason code 20:
Problem determination: 5, 14, 16
Stop using the transactions using the MOD or the DOF,
or both, for a time sufficient to allow the blocks to be Module: DFSCFEO0
replaced by others in the Message Format. Try the Related reference:
failing transaction again. If the error persists, the block
was destroyed in the FORMAT or TFORMAT library, Format library member selection (Application
an error was compiled into the block, or there is an Programming APIs)
error in one of the MFS online modules. If the error Related information:
does not recur, data was overlaid in the message Chapter 2, “IMS problem determination,” on page 5
When an exception is found while processing a generic A module within IMS called the message generator and
parameter, up to 10 of the specific resource names in failed to provide a proper call interface.
error that match the generic parameter are moved to
the end of the condensed command buffer. They are Problem determination: 1, 6, or 7
then marked in error. Thus, if 20 resources matching Module: DFSCLMR0
the generic parameter could not be processed by the
command, only ten of them are moved into the Related information:
condensed command buffer and are marked in error. Chapter 2, “IMS problem determination,” on page 5
The number 10 is selected to guarantee that ETC
appears at the end of the DFS058 message. It is
DFS0062W LOAD FAILED FOR DRU EXIT
assumed that the display line of the message is a
xxxxxxxx TMEMBER=yyyyyyyyyyyyyyyy
maximum of 79 bytes.
Explanation: The OTMA Destination Resolution
System action: The system continues processing.
(DRU) exit, that was specified on the client-bid or a
Programmer response: Verify that the present partner create request, failed to load.
command is correct.
In the message text:
Module: DFSCLMO0 xxxxxxxx
The name of the DRU exit
yyyyyyyyyyyyyyyy
DFS059I TERMINAL status The transaction member (tmember) name
Explanation: Information at a local or remote terminal System action: Client-bid or partner-create continues
informs the operator of terminal status. without the DRU exit.
Operator response: (local/remote terminal) Take the Programmer response: Verify that the DRU exit
action required depending on the status information. specified is needed. If not, you can ignore this message.
Module: DFSCLMO0 If the DRU exit is needed, disconnect the client and
correct the problem by ensuring that the DRU name is
correct and that the module resides in the IMS
STEPLIB. Then reconnect the client.
16 A DFSUSRX interface error occurred. 38 The exit overlaid the 512–byte user
17 Change destination error. User exit work area buffer.
requested to change the destination 39 The exit overlaid the MSEB BCB
name by setting MSTR2CHG or block name.
MSLR2CHG or MSPR2CHG. The new 40 The exit overlaid the parameter list.
destination name at MSTRDEST,
MSLRDEST, OR MSPRDEST was not Codes 41 through 52 apply to the /FORMAT
be found. command.
18 The exit changed the destination 41 The CNT for the terminal to be
name of the I/O PCB message. formatted was not found.
19 The exit requested rerouting for the 42 The specified terminal is a remote
I/O PCB message. LTERM.
20 The exit changed the destination 43 The specified terminal is a dynamic
name to a command (for example, MSNAME (LNB).
/CMDVERB). 44 The destined terminal (which is
21 The user exit override of MSNAME different from the input terminal) is
was invalid. not MFS-formatted.
22 Local share queue registration failed 45 The destined terminal is in line
for rerouting the transaction to the response mode.
local shared queues. 46 The destined terminal is in
23 The exit routed the transaction to an TERMINAL response mode.
invalid, remote destination. 47 Conversation is active on the destined
24 The exit rerouted the message to an terminal (when LTERM was specified
invalid MSC system identification (for in the command).
example, SYSID). 48 The terminal is in input only mode.
25 The exit routed the message to an 49 The terminal is in the exclusive mode
invalid MSNAME. (when LTERM was specified in the
26 The exit routed an intermediate command).
message to this local IMS, but the 50 The call to Queue Manager failed for
source SYSID is unknown to this local a put locate call.
IMS. 51 The inset prefix call to Queue
27 The exit indicated routing to a remote Manager failed.
IMS but did not set the destination 52 The call to enqueue the message
SYSID or MSNAME. failed.
28 The exit requested rerouting to the
source system but MSC was not sss1/name1
system defined or the source SYSID The source SYSID and source LTERM name
was not valid. for the input system.
29 The exit requested that direct route sss2/name2
override but override was The destination SYSID and destination LTERM
unsuccessful. or TRAN code of the processing system.
30 The exit requested invalid rerouting
for a front-end switch message to a System action: The /Format command or message
remote IMS. routing request is canceled.
31 The exit requested rerouting for a If one of the exits attempted to reroute a message or
response message. IMS attempted to enqueue a message, a log record type
33 DFSMSCE0 initialization failed X'67', subcode X'01' (ID=AER1, ID=MSCE, or both) is
because DFSMSCSV is not supported. written to the log. More than one record might be
34 DFSMSCE0 initialization failed written to record the error. These records contain the
because the DFSMSCSV length is IMS control blocks and save areas used by IMS or the
invalid. user exit when the error was encountered.
35 DFSMSCE0 initialization failed
because the character string VECTOR is Operator response: (master terminal) Notify the
not present. system programmer.
36 The user prefix segment (MSCEUPR) System programmer response: One of the following
was invalid when the exit returned to situations might have caused the error:
IMS. v Operator error. For example, an incorrect transaction
37 The internal prefix segment code or LTERM name might have been entered.
(MSCEIPR) was invalid when the exit v A user routing exit error occurred.
returned to IMS. Internal prefixes are v An IMS internal error occurred.
reserved for IMS internal tools.
If the error is caused by the DFSMSCE0 user exit, see indicate a failure in the CQSPUT process during insert
TM and MSC Message Routing and Control User exit processing or a problem due to a CQS structure failure
routine (DFSMSCE0) (Exit Routines) and the prologue or CQS unavailability.
of the sample DFSMSCE0 exit for an explanation of the
The reason code RSN=xxyy is optional and is not
routing option.
always included. If the reason code is present, it can be
one of the following values:
For all other situations, see Data communication service
xx IMS module that detected the error:
aids (Diagnosis) for diagnostic information about
01 /DIS CPLOG (DFSDCPL0)
message DFS070. Check the RSN, and follow the
02 Communications analyzer (DFSICIO0)
instructions for determining the cause. Print the 6701
03 /DIS controller (DFSICLD0)
log records for additional information.
04 /NRE, /ERE (DFSICL20)
Module: DFSCMS00, DFSDLA30, DFSICLK0, 05 /CQQUERY STATISTICS (DFSICQ20)
DFSICIO0, DFSIINB0, DFSRLM10, DFSTRM00, 06 OTMA SYNC processor (DFSYTIB0)
DFSYTIB0 yy Reason for the error:
01 The requested size is less than 1 byte;
for example, LLZZ + 1 byte or larger.
DFS071 SYSTEM DISCONNECT 02 A QMGR or CQS ISRT error occurred.
Explanation: Five attempts to sign on were invalid. 03 A queue buffer reposition error
occurred.
System action: This message notifies the switched 04 User exit DFSQSPC0 or IQCQMRI0
terminal operator that IMS is disconnecting this line. error occurred. If IBM IMS Queue
Operator response: (master terminal) Establish the Control Facility for z/OS is being
correct sign-on command before trying to sign on used, the requested message was
again. canceled because the node and client
are using too many queue buffers.
Module: DFSICA10, DFSICIO0
System action: The queue buffer is canceled. Type
6701-AER1 and 67D0 records are logged for some
DFS072I UNABLE TO OUTPUT LINE x PTERM errors.
y
For OTMA, message DFS1269E RC4011 is also issued
Explanation: A permanent I/O error was detected and a X'67D0' trace entry is written to the log.
attempting to write a message to the indicated IMS line
and physical terminal. System programmer response: This error might occur
for one of the following reasons:
System action: The terminal has been PSTOPPED. v An IMS or CQS internal error occurred.
Operator response: (master terminal) After the v The message queue is filling up.
malfunction has been corrected, a /START LINE x v A problem with the shared queue was encountered.
PTERM y or a /RSTART LINE x PTERM y command v A user queue space notification user exit
can be used to resume operations on the terminal. (DFSQSPC0) or a tool using the exit, such as the IMS
Queue Control Facility exit tool (IQCQMRI0), has
rejected the queue buffer request.
DFS073 /IAM COMMAND REQUIRED
Explanation: An /IAM command is required to The response depends on the reason code yy, as
identify the logical or physical terminal name of the follows:
dial or switched terminal operator to IMS. 01 Size requested is less than 1 byte.
System action: The data entered is ignored. Response: This problem is an IMS internal
error. Print the 6701 and 67D0 records if
Operator response: (local/remote terminal) Enter the available.
/IAM command. 02 QMGR ISRT or CQS error
Module: DFSICIO0 Response: QMGR returned a nonzero return
code. If IMS is not using shared queues, This
situation could be a problem with the local
DFS074 QUEUE ERROR-MESSAGE CANCELED
queues. If you are using shared queues, this
RSN=xxyy
could be a CQS or a problem with the shared
Explanation: An attempt was made to acquire a queue queues. Print the 6701 and 67D0 records if
buffer. An ISRT locate, ISRT move, or reposition call available.
was issued, but an error was detected with the call or 03 Queue buffer reposition error
the call could not be processed.
In a shared-queues environment, this message can
Response: This problem is an IMS internal This information appears only when the error is
error. Print the 6701 and 67D0 records if detected in a remote system (sss2).
available.
System action: The message was canceled. If the input
04 User exit DFSQSPC0 or IMS Queue Control
was processed by the MFS Utility, the input message
Facility exit IQCQMRI0 requested that the
was defined with multiple segments.
message be canceled because the node and
client are using too many queue buffers. Operator response: Reenter the message properly.
Response: The user exit DFSQSPC0 or IMS If the optional part of the message is printed, notify the
Queue Control Facility exit IQCQMRI0 set system programmer that the blocks are not
QSPCFLG2 = QSPCF2NO in the exit synchronized.
DFSPARM area, because it determined that the
caller was using too many queue buffers. The Problem determination: 14
QMGR then set the QMGRO3NO flag in the Module: DFSCON00, DFSICIO0
DFSQMGR parameter area of the caller and
Related information:
canceled the ISRT, releasing the queue buffers.
To determine the pool usage, print the 6701 Chapter 2, “IMS problem determination,” on page 5
records if available. Then refer to the
DFSQSPC0 exit, or IQCQMRI0 exit if you are DFS077 COMMAND INPUT EXCEEDS
using the IMS Queue Control Facility, and the MAXIMUM LENGTH
queue usage from the /DIS POOL QBUF
command for more information. Explanation: The maximum length of a command is
defined as that which fits in a queue message buffer.
Module: DFSICIO0, DFSICLD0, DFSICL20, DFSYTIB0,
DFSDGS96 System action: The data entered is ignored.
Operator response: (local/remote terminal) Reduce
DFS075I REQUESTED BLOCK NOT the length of the command and reenter. If commands of
AVAILABLE: MID name this length are required, the system can be redefined
with increased message buffer size.
Explanation: The Message Format Service (MFS)
cannot fetch the control blocks required to process an Module: DFSICIO0
input message. The message identifies the MID name
for the MID and DIF pair requested. The MID or DIF DFS078 COMMAND INVALID AS SECOND
contains an invalid field, which is probably caused by SEGMENT
modification or damage to the Format or Test Format
libraries. Explanation: A multi-segment input message was in
process when this command was entered.
System action: MFS ignores the input message.
System action: Both the message and the command
Programmer response: Stop using the transaction are canceled.
requiring this MID or DIF, or both, block long enough
to allow the blocks to be replaced by others from the Operator response: (local/remote terminal) Reenter
Message Format Library. Then retry the failing the message and command separately.
transaction. If the error persists, the blocks were
Module: DFSICIO0
damaged in the Format or Test Format library, an error
was compiled into the blocks, or an error exists in an
MFS online module. DFS079 INPUT IGNORED-SYSTEM IN
SHUTDOWN
Module: DFSCFEI0
Explanation: A shutdown checkpoint is in process,
and all input from terminals is suspended.
DFS076 MULTI-SEGMENT INPUT INVALID [I:
sss1/name1, D: sss2/name2] System action: The data entered is ignored.
Explanation: A buffered terminal device attempted to Operator response: (local/remote terminal) Reenter
send multiple segments of an input transaction which the data after the system has been restarted.
was defined as a single segment transaction.
Module: DFSICIO0
In the message text:
sss1/name1
DFS080 MESSAGE CANCELED BY INPUT
The source SYSID and source LTERM name
EDIT ROUTINE
for the input system.
sss2/name2 Explanation: A user-supplied edit routine has rejected
The destination SYSID and destination LTERM and canceled the last input message.
or TRAN code of the processing system
System action: The entered message is ignored. instructions for determining the cause. You might need
to print the 6701 log records for additional information.
Operator response: Reenter the message in a format
acceptable to the edit specifications. Module: DFSICLN5
Module: DFSICIO0
DFS082 ERROR READING QUEUE, QUEUE
SHUTDOWN [I: sss1/name1, D:
DFS081 TRACE EXIT COMMAND
sss2/name2] [name RC = nn]
UNSUCCESSFUL RSN=xxyy
Explanation: An unrecoverable I/O error occurred
Explanation: The /TRACE EXIT command was
attempting to read a record from a logical terminal
entered incorrectly, the command is not supported on
queue.
this IMS system, or this problem is an IMS internal
error. In the message text: In the message text:
xx The IMS module that detected the error: sss1/name1
| 01 Trace Command Processor The source SYSID and source LTERM name
| (DFSICLN5) for the input system.
yy The reason for the error: sss2/name2
01 An invalid keyword was specified for The destination SYSID and destination LTERM
the trace exit. or TRAN code of the processing system
02 An invalid parameter type was
specified for the trace exit command. This information appears only when the error is
03 No parameter type was specified for detected in a remote system (sss2):
the trace exit command. nn The decimal value of the queue manager
04 Multiple parameter types were return code. Possible queue manager return
specified for the trace exit command. codes are:
05 The DFSMSCD control block is 04 No segment returned for destination
missing for the trace exit name.
(DFSMSCE0) command. 08 No more messages on the queue for
06 An Invalid parameter subtype was destination name.
specified for the trace exit command. 12 Destination name is in use.
07 The trace exit is not supported for 36 MSC prefix does not exist. The
this environment. message has been dequeued.
08 The required exit was not loaded for 40 ISC prefix does not exist. The
the start trace command. message has been dequeued.
09 Required exit not loaded for start
trace command. System action:
10 A system command failure occurred. That queue was stopped. A log record type X'6701',
11 The parameter length was invalid. ID=MER1, was written using the IMS TRACE facility,
System action: The entire command was ignored, or which provides a snap of the IMS control blocks and
one or more parameters were ignored. save areas.
Operator response: (master terminal) Check the Operator response: (master terminal) If the optional
syntax of the command to ensure that it is correct. part of the message is printed, coordinate restarting the
Reissue the command with the proper keyword and resource with the destination system master terminal
parameters. Issue the /DISPLAY TRACE EXIT operator and its system programmer.
command to determine which parts of the command System programmer response: If the message has
ran successfully and if the exit is installed. If the exit is been dequeued, examine the MER1 record to determine
not installed, the status of all the exit entry points is which message was dequeued.
N/A on the display output. If the problem persists,
contact the system programmer. Module: DFSCM7A0, DFSCM7B0, DFSICIO0
See "DC–Data Communication Service Aids" in IMS System action: The requested conversation is not
Version 11 Diagnosis for diagnostic information about started.
message DFS081. See the RSN and follow the Operator response: (master terminal) Reenter the
/IAM command with the proper parameters before Operator response: Take the appropriate action:
attempting the conversation. v NO PREVIOUS OUTPUT MESSAGE
Module: DFSCON00, DFSICA10 IMS will probably never be able to continue this
conversation. Terminate the conversation with an
/EXIT command. For OTMA users, the conversation
DFS084 CONVERSATION IN PROCESS
will be terminated by IMS.
Explanation: A conversational program has not yet v STORAGE ERROR
responded to the last input message. Conversation is a
Reenter the input data after waiting a for some time
two-way exchange. If this message is paged, it must be
for the storage shortage to be eliminated.
completely viewed and deleted by the operator before
the response is complete. v SPA NOT FOUND IN OUTPUT MESSAGE
IMS will probably never be able to continue this
System action: IMS discards the entered data. The
conversation. Terminate the conversation with an
application program responds to the last accepted
/EXIT command. For OTMA users, the conversation
input, unless the terminal is page protected.
will be terminated by IMS.
Operator response: Await reply from the program, v CQS ERROR OR CQS NOT AVAILABLE
and reenter data; or delete last page, and reenter data;
Reenter the input data after waiting a some time for
or /EXIT to terminate the conversation, and reenter the
CQS to become available. If the problem is caused by
data; or, if paging has been specified, you might have
a CQS error, you might have to terminate the
to press the PA2 key to delete the message.
conversation with an /EXIT command. For OTMA
Programmer response: Screen protection has been users, the conversation will be terminated by IMS.
specified as either a terminal option or an MFS option. v SPA HAD BAD DATA OR FORMAT
Determine whether this is necessary for this
IMS will not be able to continue this conversation.
transaction.
Terminate the conversation with an /EXIT command.
Module: DFSCON00, DFSICLH0
Module: DFSCON00, DFSYTIB0
v SPA NOT FOUND IN OUTPUT MESSAGE Explanation: The user physical terminal input edit exit
The SPA could not be found in the previous routine attempted to insert a transaction code or
conversational output message. password and:
v MFS bypass was not active.
v CQS ERROR OR CQS NOT AVAILABLE v The total size of the attempted insert was less than 6
Either the Common Queue Server (CQS) was or greater than 22.
unavailable or a CQS error occurred.
System action: A log record type X'67', subrecord
v SPA HAD BAD DATA OR FORMAT X'01', has been written using the IMS TRACE facility,
IMS attempted to convert the SPA from an internal which provides a snap of the IMS control blocks and
packed format to an unpacked format, but was save areas. The data entered is ignored.
unsuccessful.
Operator response: Notify the system programmer.
System action: The input data is ignored.
System programmer response: Correct the error in the provides a snap of the IMS control blocks and save
user physical terminal input edit exit routine. areas. If the last message segment moved into the line
buffer (=OUTBUF) by DD6 fitted exactly, the contents
Module: DFSICIO0
of this line buffer was already sent to the terminal. The
terminal is made inoperable, and message DFS998I is
DFS0088I LS0 INITIALIZATION FAILED - sent to the master terminal operator.
identifier
Operator response: (master terminal): Upon receipt of
Explanation: Initialization for the Local Storage message DFS998I, the LTERM should be reassigned or
Option failed for the reason indicated by identifier. The the message dequeued. The terminal can then be
module or control block identified in message DFS0088I restarted. Notify the system programmer.
was being processed when the error occurred.
System programmer response: Take one of the
Identifier following actions:
Reason v Increase OUTBUF value in TERMINAL macro for
1. DFSKLSM system definition.
IMODULE GETMAIN failed. v Restrict the application program not to send
2. DFSKLSM0 or DFSKLSD0 messages greater in length than OUTBUF value.
IMODULE LOAD failed for one of these
Module: DFSCD600, DFSCD610, DFSCD620
modules.
3. DFSXMCTL Related information:
Not initialized for LS0. “DFS998I” on page 252
4. SAP Insufficient SAPs were assigned for LS0.
System action: This message is followed by abend DFS0090 USE OF MODNAME DFS.EDTN
0088. REQUIRES TERMINAL INPUT EDIT
ROUTINE
System programmer response:
Explanation: When MFS BYPASS option is selected
Reason Action
and the MODNAME DFS.EDTN is used, the user must
1. Increase the IMS control region size.
provide a Physical Terminal Input edit routine.
2. Correct the JOB/STEPLIB DD statement or
bind the LS0 modules into the correct library. System action: The data entered is ignored.
3. Determine the DFSXMCTL problem by
Operator response: Notify the system programmer.
referencing module DFSMINIO. Contact IBM
for assistance. System programmer response: Include a user Physical
4. Determine the SAP problem by referencing Terminal Input edit routine in system definition. See
module DFSXLIC0. Contact IBM for assistance. the topic on “Physical Terminal (Input) edit routine” in
IMS Version 11 Exit Routines.
Problem determination: 1, 2, 3, 4, 8, 12
Module: DFSICIO0
Module: DFSKLSI0
Related reference:
Related information:
Chapter 2, “IMS problem determination,” on page 5 Physical Terminal (Input) edit routine (DFSPIXT0)
(Exit Routines)
DFS0089 OUTPUT EXCEEDS BUFFER SIZE
LTERM xxxxxxxx LINE yyy PTERM zzz DFS091I UNABLE TO LOCATE X'42' LOG
OUTPUT EXCEEDS BUFFER SIZE RECORD
LTERM xxxxxxxx NODE yyyyyyyy
Explanation: Batch backout was being initialized but
Explanation: An application program using the MFS no X'42' log record was found on the input log volume.
bypass attempted to send an output message that is
System action: Batch backout is terminated.
longer than the length specified in the OUTBUF
parameter of the TERMINAL macro during system Programmer response: This error can occur if only
definition. In addition, the access method in use is one input volume was supplied to database backout
either VTAM non-SNA or another IMS-supported and the X'42' log record had not yet been written on
terminal with OPTIONS=NOXPAR. The OUTBUF value that volume. Rerun the database backout specifying the
should be set equal to the maximum RU size acceptable last two volumes as input. If more than one volume
to the terminal (and VTAM and its NCP) because IMS was already supplied or if only one volume was
does not send an output message inserted by an created, then a system error has occurred.
application that exceeds this value.
Problem determination: 1, 4, 5
System action: A log record type X'67' subrecord X'01'
has been written using the IMS trace facility, which Module: DFSBCKI0
Related information:
DFS098 PTERM LOCKED/STOPPED
Chapter 2, “IMS problem determination,” on page 5
Explanation: The physical terminal was locked,
stopped, or inoperable.
DFS092I IMS LOG TERMINATED
Operator response: (local/remote terminal) Have the
Explanation: This informational message indicates that master terminal operator start or unlock the PTERM.
the IMS system log has been terminated.
Module: DFSICA10
System action: IMS has terminated.
Module: DFSFDLS0 DFS099 MULTIPLE LINE PARAMETERS ARE
INVALID
DFS093 COMMAND NOT AUTHORIZED AS Explanation: A command that refers to one or more
ENTERED WITH CRC FROM MCS OR physical terminals can only specify one line. For
E-MCS CONSOLE example:
Explanation: The command is not allowed from the v PTERM ALL can only be specified for a single line.
MCS console. The command authorization, which was v PTERM ALL cannot be specified when displaying
specified on the CMDMCS execution parameter (RACF lines by attribute.
(or equivalent), DFSCCMD0, or both) did not authorize System action: The command is ignored.
the user ID of the console to issue the command.
Operator response: (local/remote terminal) Reenter
System action: The command is ignored. the command properly.
Operator response: (master terminal) Reenter the Module: DFSICL10, DFSICL30, DFSIC440
command from an authorized console, or update
authorization information to allow the command from
the console. DFS100 LINE KEYWORD NOT PRESENT
DFS0096W DATA BASE BUFFERS PURGED, System action: The command is ignored.
UPDATE INTENT, NOLOG SELECTED. Operator response: (local/remote terminal) Reenter
Explanation: A batch IMS job ran without an IMS log the command properly.
data set and abended while using a PSB with UPDATE Module: DFSICL10
INTENT. The database buffers were purged, but the
database might still be bad.
System action: IMS (E)STAE continues processing an
abend.
Programmer response: Determine if the database still
has its integrity by interrogating the type of abend and
the abending program.
Module: DFSFLST0
Module: DFSICL20
DFS110I COMMAND KEYWORD yyyyyyyyyyyy
INVALID FOR imstype
DFS113 LINE KEYWORD PARAMETER NOT
Explanation: Keyword yyyyyyyyyyyy is not supported
PRESENT
with commands for this imstype of IMS. Up to 12
characters of the invalid keyword are included in the Explanation: The LINE keyword was present, but was
error message. The imstype is one of the following: not followed by any parameters.
ACTIVE
DBCTL System action: The command is ignored.
DCCTL Operator response: (local/remote terminal) Reenter
XRF ALTERNATE with proper specifications.
TRACKER
Module: DFSICLJ0, DFSICLN0, DFSICL10, DFSICL50,
Keywords that are not supported on an active DFSICL80, DFSIC440, DFSIDP60, DFSIDP70, DFSIDP80
subsystem include BACKUP, which is only supported on
an XRF alternate, ISOLOG and TRKAUTOARCH, which are DFS114 LTERM KEYWORD PARAMETER NOT
only supported on an RSR tracking subsystem. PRESENT
Keywords that are not supported in DBCTL relate to Explanation: The LTERM keyword was not followed
DC. by any parameters.
System action: The command is ignored.
Keywords that are not supported in DCCTL relate to
DB. Operator response: Check the syntax of the command
and reenter it.
Keywords that are not supported on an XRF alternate Module: DFSICA10, DFSICLJ0, DFSICL80, DFSICL90,
system include most keywords, except those required DFSICV10, DFSIC440, DFSIDP40, DFSIDP70
with commands that operate the XRF alternate.
DFS115 PTERM KEYWORD PARAMETER NOT
Keywords that are not supported on an RSR tracker
PRESENT
include most keywords, except those required with
commands that operate the remote tracking subsystem. Explanation: The PTERM keyword was not followed
by any parameter.
System action: The command is rejected.
System action: The command is ignored.
Operator response: Check the keywords and run the
command again. Local/remote terminal operator response:
Module: DFSICL30 Reenter the command properly.
Module: DFSICLJ0, DFSICLN0, DFSICL10, DFSICL50,
DFS111 TIMEOUT-RESEND MESSAGE DFSICL80, DFSIC440, DFSIDP60, DFSIDP70, DFSIDP80
Explanation: Between characters of a message, 28
seconds is allowed before the hardware times out and DFS116 DATABASE|AREA KEYWORD
cancels the message. PARAMETER NOT PRESENT
System action: The message is canceled. Explanation: The database or area keyword was not
followed by a parameter.
Operator response: (Local/remote terminal) Reenter
the message without excessive delay. System action: The command is ignored.
Module: DFSDN020, DFSDS010, DFSDS020, Operator response: Reenter the correct command.
DFSDS040, DFSICL30
Module: DBFCDAR0, DFSICL20, DFSICL80,
DFSICL90, DFSIC430, DFSIDPJ0, DFSIDP50
DFS112 BLDQ KEYWORD NOT PRESENT
Explanation: BLDQ keyword must be present for the DFS117 PROGRAM KEYWORD PARAMETER
/ERESTART command with checkpoint 0 or if the NOT PRESENT
FORMAT keyword is supplied with the /ERESTART
command. Explanation: The PROGRAM keyword was not
followed by a parameter specifying which program.
System action: The command is ignored.
System action: The command is ignored.
Master terminal operator response: Reenter the
command properly.
Module: DFSICL70
DFS127 TOO MANY KEYWORDS
Explanation: Too many keywords were supplied.
DFS132 ALL DATABASE|AREA PARAMETERS
System action: The command is ignored. ARE INVALID
Local/remote terminal operator response: Recheck the Explanation: This message is issued for one of the
format of the command, and delete the unnecessary following reasons:
keywords. v The database or area names entered are invalid.
v A parameter is valid, but has failed processing (for
Module: DFSCML70, DFSICA10, DFSICLE0,
example, an allocation error has occurred on the
DFSICLG0, DFSICLJ0, DFSICLQ0, DFSICLU0,
database).
DFSICL10, DFSICL20, DFSICL60, DFSICL70, DFSICL80,
v A valid parameter was specified, but the particular
DFSICL90, DFSICM00, DFSIC430, DFSIDP00, DFSIDP30
type of IMS you are running does not support that
parameter. For example, the /DISPLAY AREA or
DFS128 TOO FEW KEYWORDS /DISPLAY DB command with the OFR keyword is
not valid on an RSR active subsystem.
Explanation: Too few keywords were supplied for this v If you receive this message during a /START DB
command. partname, where partname is a HALDB partition that
System action: The command is ignored. was added, and a partition structure rebuild has not
been performed, then issue a /START DB haldbmst
Local/remote terminal operator response: Check the OPEN, where haldbmst is the master of the partition.
command format, and reenter it correctly. Then issue a /START DB partname or a call for a key
Module: DFSICLJ0, DFSICLQ0, DFSICL80 in the key range of the new or redefined partition.
This response performs a partition structure rebuild
and enables the partition for use.
DFS129 INPUT ERROR, ONLY KEYBOARD
BEING READ System action: The command is ignored.
Explanation: An input error was detected while Operator response: Reenter the correct database or
reading from a component. The keyboard is the only area names that have been defined to IMS. If the
device from which input will be accepted until the parameter is valid, correct or investigate other error
component is restarted by entering a /RDR statement messages and reenter the command. Make sure any
from the keyboard. command keywords or parameters are valid for the
flavor of IMS you are running.
System action: The data entered is ignored.
Module: DBFCDAR0, DFSDBDR0, DFSICL20,
Operator response: (local/remote terminal) Correct DFSIC430, DFSIDPJ0, DFSIDP50
the problem, and enter the /RDR statement.
Module: DFSDN020 DFS133 BLDQ MUST NOT BE PRESENT
Explanation: The BLDQ keyword is not permitted
DFS130 INVALID KEYWORD COMBINATION with a cold start.
Explanation: One or more of the keywords entered System action: The command is ignored.
were incompatible with another specified.
Operator response: (master terminal) Reenter the
System action: The command is ignored. command properly.
Operator response: Check the keyword combination, Module: DFSICL20
and reenter the command.
Module: DFSICLJ0, DFSICLN0, DFSICL20, DFSICL30, DFS134 SHUTDOWN CHECKPOINT NOT IN
DFSICL40, DFSICL60, DFSICL80, DFSIC430, DFSIC470, PROGRESS, CANNOT PROCESS
DFSIDP00, DFSICLN1, DFSICLN2, DFSICLN3, COMMAND
DFSICLN4
Explanation: One of the following problems occurred:
v A /DISPLAY SHUTDOWN status command was
DFS131 PTERM IN/OUT NOT THE SAME entered before a checkpoint command was issued.
Explanation: The master terminal logical terminal v An /IDLE command (without the NOSHUT
must have its output physical terminal also assigned as keyword) was entered before a checkpoint command
its input physical terminal. was issued.
v An /IDLE NODE command was entered before a
System action: The command is ignored. /STOP DC or a /CHE command was issued.
Operator response: Reassign the terminal properly. System action: The command is ignored.
VTAM
DFS151 LTERM KEYWORD PARAMETER IS
INVALID System action: The command is ignored.
Explanation: The logical terminal name specified was Operator response: Start IMS with the specified
not defined to the system. component and reenter the command.
If this IMS system is part of a sysplex using the IMS Module: DFSICL30
Resource Manager, the logical terminal (LTERM) name
might be actively on or owned by another IMS system.
As a result, the LTERM name would not be found on DFS155 CHECKPOINT KEYWORD
this IMS, even if it was statically defined to the system. PARAMETER IS INVALID
System action: The command is ignored. Explanation: A nonzero checkpoint ID was specified
for the CHECKPOINT parameter in the restart
Operator response: Correct the LTERM parameter and command. Since IMS determines the correct checkpoint
reenter the command. to use for restart, the only CHECKPOINT parameter
accepted as an override is zero.
Module: DFSICA10, DFSICLE0, DFSICLJ0, DFSICL70,
DFSICV10 System action: The command is ignored.
Operator response: If you are starting IMS for the first
DFS152 PTERM KEYWORD PARAMETER IS time (no previous shutdown), or if you want to restart
INVALID using the checkpoint taken during IMS cold start, take
one of the following actions:
Explanation: The physical terminal specified is not
v Reissue the restart command specifying
numeric, or the line has no terminal specified by that
CHECKPOINT 0.
relative number.
v Omit the CHECKPOINT keyword and reissue the
System action: The command is ignored. restart command.
Operator response: Check the system as defined and Module: DFSICL20
reenter the command properly.
Module: DFSICLJ0, DFSICL30, DFSICL50, DFSICL70, DFS156 TRAN KEYWORD PARAMETER IS
DFSIDP80 INVALID
Explanation: The TRAN keyword parameter was
DFS153 DATABASE KEYWORD PARAMETER invalid for one of the following reasons:
IS INVALID v The name specified for the transaction keyword was
not a valid transaction code.
Explanation: The database specified was not able to
v The command does not permit a parameter after the
be found as a defined database for this system.
transaction keyword, but a parameter was entered.
System action: The command is ignored.
System action: The command is ignored.
Operator response: (local/remote terminal) Correct
Operator response: Reenter the command properly.
the parameter and reenter the command.
Module: DFSICLE0, DFSIC430, DFSIDP30
DFS154I COMMAND xxxxxxxxxx INVALID;
REQUIRES COMPONENT component DFS157 PRIORITY KEYWORD PARAMETER IS
INVALID
Explanation: The command xxxxxxxxxx was invalid
without the component component. Up to 10 characters Explanation: The priority of a transaction must be 0
of the command verb are included in the error through 14; all other parameters are invalid. For BMP
message. component can be one of the following transactions, the normal and limit priorities cannot be
components: changed using the /ASSIGN command.
CQS
System action: The command is ignored.
FAST PATH
MSC
Related information:
DFS167 INVALID RESTART FROM CHKPT
SPECIFIED. RE-ENTER RESTART Abend 0168
COMMAND
Chapter 2, “IMS problem determination,” on page 5
Explanation: This message is generated when the
operator requests one of the following invalid
DFS169I INITIALIZATION IN PROGRESS,
combinations:
CANNOT PROCESS COMMAND
v Normal warm start from a simple checkpoint
v BLDQ type restart from a FREEZE or SIMPLE Explanation:
checkpoint
v Non-BLDQ type restart from a PURGE or DUMPQ The log routing function of the tracking subsystem is
checkpoint initializing and cannot respond to the command.
v /ERE command specifying CHKPT 0, but the System action: The command is ignored.
checkpoint returned by the logger is not a cold start
checkpoint. Operator response: Reenter the command at a later
time.
System action: IMS waits for another RESTART
command to be entered. Module: DFSIDPO0
Operator response: Correct the command and reenter System action: The command is rejected.
it.
Module: DFSIC4C0, DFSICM30, DFSICM40,
Module: DFSICM40 DFSICV30, DFSICV80, DFSOLC10
Explanation: The command was entered on a system System action: The command was ignored.
that is not RSR-capable.
Operator response: (master terminal) If the user
System action: The command is rejected. specified non-auto delete for paging and has not
dequeued the conversational reply, this message can
Operator response: If RSR capability is wanted, define occur as a result of the /EXIT command being entered.
the IMS system as an RSR-capable system and reenter If so, to allow the system to continue, enter a question
the command. mark character (?) to dequeue the last paged message.
Module: DFSIC4B0, DFSICM30, DFSIDPO0 Module: DFSICLH0
Module: DFSICLH0
DFS182I INVALID OR MISSING PARAMETER
Explanation: Either a parameter was missing for one
DFS185 CONVERSATION NOT SCHEDULED,
or more of the specified keywords or it was invalidly
CANNOT PROCESS COMMAND
specified.
Explanation: The conversation is still in the process of
System action: The command is ignored.
beginning.
If you received this message while running a command
System action: The entered command is disregarded.
for a data group, or after entering a command for a
data group, verify that you used the DBRC command Operator response: Wait for the first message to be
INIT.DBDSGRP GRPNAME(name) DBGRP(dbname) to completed before reentering the command.
create the group.
Module: DFSICLH0
Operator response: Reenter the correct format of the
command.
DFS186 CONVERSATION ID IS INVALID
Module: DFSCML70, DFSICLE0, DFSICLG0,
DFSICLH0, DFSICLJ0, DFSICLK0, DFSICLM0, Explanation: The parameter entered as an ID for the
DFSICLN0, DFSICLQ0, DFSICLW0, DFSICLU0, conversation was not four characters long, was an
DFSICLY0, DFSICL10, DFSICL20, DFSICL50, DFSICL60, invalid conversation number for this system, or was for
DFSICL70, DFSICL90, DFSICM00, DFSICM40, an inactive conversation.
DFSICVA0, DFSIC410, DFSIC420, DFSIC430, DFSIC450, System action: The entered command is disregarded.
DFSIC460, DFSIC470, DFSIC480, DFSIDPL0, DFSIDP00,
DFSIDP60, DFSIDP70, DFSIDP80, DFSIDPB0, Operator response: (local/remote terminal) Reenter
DFSIDPH0, DFSIDPI0, DFSICLN1, DFSICLN2, the command properly.
DFSICLN3, DFSICLN4 Module: DFSICLH0
Operator response: (local/remote terminal) Correct System action: The entered command is disregarded.
the ID of the terminal or user specification and reenter Module: DFSICLH0
the command.
Module: DFSICLH0 DFS188 CONVERSATION IN PROCESS,
CANNOT ACTIVATE ANOTHER
DFS184 CONVERSATION IN USE. CANNOT Explanation: Only one conversation can be active on a
PROCESS COMMAND terminal at a time.
Explanation: One of the following problems occurred: System action: The entered command is disregarded.
v The conversation message is presently in the queue
waiting to be processed by a message processing Operator response: If you want to activate a new
program. conversation, either exit the current one or hold it
v The last output message is temporarily unavailable before reentering the /RELEASE command.
because of incomplete restart resynchronization. Module: DFSICLH0
v The Use Manager LOCK request failed because the
Conversation Control Block (CCB) is currently in use
by some other process. DFS189 TERMINAL OR USER NOT STOPPED
AND IDLE, CANNOT PROCESS
System action: The entered command is disregarded. COMMAND
Operator response: Wait for the response from the Explanation: The terminal or user must be stopped or
program before reentering the /HOLD or /EXIT idle, or both, before the command can be processed.
command. If the conversation is in use because of
incomplete restart resynchronization or if the CCB is in For /DEQUEUE LINE, LTERM, MSNAME, or NODE
use by some other process, this condition should exist command, the line, MSC link, or node must be stopped
for only a short amount of time. and idle if the PURGE/PURGE1 keyword is specified.
Module: DFSDN020, DFSDS020 Explanation: More than one physical terminal was
using the logical terminal assigned to your terminal, or
it was assigned to another terminal for output.
DFS193 CANNOT OUTPUT PUNCH 2 Conversational transactions cannot be entered from this
Explanation: The specified terminal component caused type of communication network.
an I/O error. System action: The requested conversation is not
System action: The terminal component is shut down. started.
Operator response: Correct the problem, and enter the Operator response: If the transaction is required,
correct component restart command to continue output. request the master terminal operator to assign an
DFS201 INVALID LTERM CHAIN FOR DFS205 STORAGE NOT AVAILABLE FOR
FORMAT SPECIFIED BUILDING PARTITION CIBS
Explanation: The LTERM specified in a /ASSIGN Explanation: MFS received a message to build
command is the input LTERM for multiple physical partition CIBS (communication interface block storage),
terminals (LTERMs). but was unable to acquire storage to build partition
CIBS.
System action: The command is ignored.
System action: The LTERM was marked inoperable,
Operator response: (master terminal ) Reenter the
and the message causing the problem was returned to
command, using proper format to cause the desired
the message queue.
results.
Operator response: (master terminal) Contact your
Module: DFSICL70
IMS system programmer for assistance. If use of the
LTERM is to continue, a /START LTERM xxx command
DFS202 2770/2265 PROCEDURAL ERROR. must be issued. The message can be removed from the
message queue with the /DEQUEUE LTERM P1
Explanation: The /TRACE SET ON or /TRACE SET PURGE1 command.
OFF command was entered with no monitor
parameters specified. Programmer response: Send the output message when
system activity has decreased and more storage is
System action: Processing continues. available, or increase the main storage available to IMS.
Operator response: (entering terminal) Reset the Module: DFSCFEO0
terminal, and try the operation again.
Module: DFSDN070 DFS206 QBLK D/S LIMIT REACHED. MUST
REBUILD.
DFS203 LOOPTEST NOT VALID FOR THIS Explanation: A record was allocated within the
LINE shutdown area on the IMS.QBLKS system data set.
Explanation: A /LOOPTEST command has been System action: An internal /CHE DUMPQ command
entered for a switched line, or a remote processor line, was initiated and in most cases, the system shuts
that is, a System/3 or System/7. A /LOOPTEST down. In an XRF environment, a /CHE SNAPQ will be
command is not valid for these types of lines. initiated if there are VSO areas that have I/O tolerated
System action: The command is ignored. data, and the system will not shut down.
Nodes or users that were only created to retain status Explanation: This command can be issued only on the
data and have not been logged on or signed on are not IMS system designated as the command master. All
allowed in an /ASSIGN command. For example, a commands entered from a local IMS (the MTO, a local
/TRACE SET ON NODE command that creates a node user terminal, or AOI) are treated as the command
with a status of trace, in anticipation of the terminal master. For a command entered from the Operations
logging on, is not allowed as a node parameter in the Manager (OM) TSO Single Point of Control (SPOC),
/ASSIGN command. only one IMS among those chosen by OM to process
the command is treated as the command master.
System action: The command is ignored.
System action: The command is rejected.
Operator response: (master terminal) Enter a valid
form of the /ASSIGN command. Operator response: If you enter the /OPNDST
command from OM TSO SPOC and you want to log
Module: DFSICL70 the node onto a particular IMS, specify ROUTE(imsid).
If your command doesn't specify ROUTE(imsid), the
DFS211I INVALID REASSIGNMENT FOR /OPNDST command is routed to all the IMS systems
NAMED LTERM and IMS will only process the command on the IMS
that is designated as the command master. The other
Explanation: See message DFS211 IMS systems will issue this message.
Related information:
Module: DFSICLQ0
“DFS211” on page 56
If an IMS conversation does not exist, or if LU 6.2 Operator response: (master terminal)No action is
support or OTMA support is not used, notify the IMS required.
system programmer. The /FORMAT command should not be entered from a
Ensure that the OTMA client sends an ACK or NAK terminal which is not supported by the MFS.
message to IMS before the TPIPE is stopped for Module: DFSICLK0
dequeue processing. If the ACK or NACK cannot be
sent by the OTMA client, issue a /STOP OTMA
command and dequeue the message.
device-dependent module is not in READ Attention: The DFS253I form of the message is issued
setup or READ interrupt logic. only for remote 3270 lines.
09 Fewer than 5 bytes were read.
10 Device address in data stream was invalid for The following description applies to remote 3270 lines:
a device on this control unit or line.
11 Retries exhausted on temporary error. Code Meaning
y-z This field gives the range of PTERMs that are
connected to the line.
The fields out of the BTAM DECB are shown as they
aa This field contains the ECB completion code.
are passed to IMS from BTAM. See OS/VS BTAM
bbbb The DECTYPE field indicates the type of
(GC27-6980) for an explanation of these fields.
failing operation.
Operator response: (master terminal) Correct the cc The DECTPCOD field indicates the data
malfunction, and restart all terminals associated with communication operation code from the last
the remote control unit for LINE x PTERM y. Any CCW run in the channel program.
operations in progress must be restarted. dd The DECFLAGS field contains the flag byte
passed to IMS from BTAM. The field might
Problem determination: 1, 6, 23, 24
contain information as to the cause of the
Module: DFSC3270 (DFS251I), DFSDN030, DFSDN130 failure.
(DFS251) ee The DECSENS0 field contains the sense
Related reference: information from the DECB if the status in the
CSW indicates a unit check.
IEA000I ff The DECERRST is the error status field from
Related information: the DECB.
gg The DECCSWST is the CSW status field from
“DFS973I” on page 246 the DECB.
Chapter 2, “IMS problem determination,” on page 5 hh This field contains the device-dependent
module code. When the 3270
device-dependent module shuts down a
DFS252 ATTEMPT TO OUTPUT DETECTED
component of the data communication
BUSY CONDITION
network, a device-dependent module reason
Explanation: A busy condition has been detected on a code is put in the CLBTEMP1 field to indicate
device attached to a remote 3271/3275 or 3275 dial why the device-dependent module shut down
control unit. A busy condition is not considered normal the component.
at the time it was detected and is normally the result of iiii This field contains the BSCK return code. The
an operation being attempted on a terminal when the code is passed from the BSC check routine
screen is unprotected. (DFSBSCK0) to the device-dependent module.
The BSC check routine analyzes the I/O
Operator response: (local/remote terminal) Any
completion and passes a unique return code to
output messages in progress are sent after this error
the device-dependent module, depending on
message. Refrain from performing terminal operations
the contents of the DECB fields.
on an unprotected screen.
jjjj This field contains the SENSE/STATUS
Module: DFSDN130, DFSDS060 information from the 3270 device (if
applicable).
Problem determination: 1, 6, 23
DFS254 BUFFER SIZE INCREASED
Module: DFSDN130, DFSDS060
Explanation: The buffer size for a 3270 local line
group was not adequate to contain an input message. Related information:
The buffer size has been increased by 300 bytes for all Chapter 2, “IMS problem determination,” on page 5
ensuing messages.
Operator response: No action is required. DFS258 UNABLE TO LOCATE MESSAGE
DESCRIPTION-INPUT IGNORED
If this message is repeated, increase the BUFSIZE
parameter specified during IMS system definition for Explanation: Either an I/O error occurred while
the 3270 local lines, or decrease the amount of data attempting to fetch the message input descriptor block
being input at the terminal. or the device input format block, or the blocks were not
in the active format data set, or the block fetched was
Module: DFSDN140
not a message input descriptor block.
System action: The input data was ignored.
DFS255 COPY NOT ALLOWED
Operator response: Clear the screen, and enter a
Explanation: A request has been made for a video
/FORMAT command. Contact your IMS system
display to be copied to a printer. However, the buffer
programmer for assistance.
on the display was locked by program action.
Module: DFSCFEI0
Operator response: If the display is intended to be
locked, it is not possible to copy the current display. If
it is required to copy the current display, contact the DFS259 NO MATCHING STATION CTB.
person responsible for development of the 3270
terminal message formats in your installation. Explanation: IMS remote station support encountered
a problem. No station communication terminal block
Module: DFSDN130 (CTB) matching the address in the polling list was
found. Communication was terminated.
DFS256 PRINTER FOR COPY NOT Operator response: (master terminal) Notify your IMS
CURRENTLY AVAILABLE system programmer.
Explanation: A copy operation was requested on a Module: DFSCRSS0
3270 terminal, but a printer was not currently available.
Alternatively, an intervention-required was returned by
the printer component of a 3275. DFS260 PERMANENT TRANSMISSION
ERROR LINK x
Operator response: Have the master terminal operator
start the PTERMs which represent printers that can be or
candidates for a copy operation from the specified
terminal. If an intervention-required situation exists on PERMANENT TRANSMISSION ERROR LINE x
the printer component of a 3275 device, make the PTERM y
printers ready.
Explanation: A permanent transmission error occurred
Problem determination: Do a /DISPLAY LINE x while communicating with the remote station identified
PTERM ALL for the line containing the terminal. by the message, or with another IMS system on the
Problem determination: 4, 36 identified link.
Module: DFSDN130, DFSDS060 Note: The LINK x portions of this message pertain to
Related information: Multiple Systems Coupling.
Chapter 2, “IMS problem determination,” on page 5 System action: IMS stops the data traffic on the link.
Operator response: (master terminal) When you have
DFS257 ERROR OCCURRED DURING LAST corrected the problem, restart communication using the
TRANSMISSION. /START LINE x PTERM y or /RSTART LINK x
Explanation: An input or output error occurred command.
during the last input or output transmission to a 3270 Programmer response: Determine the cause of the I/O
terminal. error.
Operator response: Reenter the last input message, or Module: DFSCRST0, DFSCS7T0
press the appropriate key to have the last message
resent.
DFS261 INVALID DATA FLAGS LINE x PTERM DFS266 OUTPUT NOT IN PROGRESS LINE x
y PTERM y
Explanation: IMS remote station support encountered Explanation: For IMS remote station support, an error
an error. The flags in a data block were inconsistent, message was received specifying a terminal which had
that is, first segment was indicated while a message no output message in progress or which had a system
was in progress. Communication was terminated. message (Q3 output) in progress. Communication was
terminated.
Operator response: Notify your IMS system
programmer. Operator response: Notify your IMS system
programmer.
Module: DFSCRSV0
Module: DFSCR2Z0
DFS262 MESSAGE STARTED DURING
SHUTDOWN. LINE x PTERM y DFS267 INVALID TERMINAL IDENTIFIER IN
ERROR MESSAGE LINE x PTERM y
Explanation: IMS remote station support. IMS sent an
immediate-shutdown request or received either a Explanation: For IMS remote station support, a
shutdown request or a shutdown complete. It then terminal identifier not defined to IMS system definition
received the first segment of a message. was received in an error message. Communication was
Communication was terminated. terminated.
Operator response: Notify your IMS system Operator response: (master terminal) Notify your IMS
programmer. system programmer.
Module: DFSCRSV0 System programmer response: Correct the terminal
identifier.
DFS263 INVALID TERMINAL IDENTIFIER IN Module: DFSCR2Z0
DATA BLOCK LINE x PTERM y
Explanation: For IMS remote station support, a DFS268 INVALID BLOCK FORMAT LINE x
terminal identifier not defined in the IMS system PTERM y
definition was received in a data block. Communication
Explanation: IMS remote station support. One of the
was terminated.
following problems occurred:
Operator response: Notify your IMS system v The first 2 characters in a block were neither DA nor
programmer. SY.
v The input block conversion routine was unable to
Module: DFSCRSV
convert a received block from transmission code to
EBCDIC.
DFS264 INVALID TERMINAL ID IN STATUS v The length exceeded the end of the input block.
CHANGE SEGMENT LINE x PTERM y
Communication with the remote station is terminated.
Explanation: IMS remote station support. A terminal
identifier not defined to IMS system definition was Operator response: (master terminal) Notify your IMS
received in a status change segment. Communication system programmer.
was terminated.
Module: DFSCRSU0, DFSCRSV0, DFSCS7U0
Operator response: Notify your IMS system
programmer.
DFS269 SHOULD NOT OCCUR TYPE ERROR
Module: DFSCRSX0 ON LINK x
or
DFS265 INVALID TERMINAL ID IN I/O
SYNCH SEGMENT LINE x PTERM y
SHOULD NOT OCCUR TYPE ERROR ON LINE x
Explanation: For IMS remote station support, a
Explanation: IMS remote station support encountered
terminal identifier not defined to IMS system definition
an error. This error can be caused by one of the
was received in an I/O synchronization segment.
following problems:
Communication was terminated.
v A hardware malfunction
Operator response: (master terminal) Notify your IMS v An invalid specification to z/OS system definition
system programmer. v A programming logic error in the program that
resides in the intelligent remote station
Module: DFSCR2Y0
Note: The LINK x portions of this message pertain to a Programmer response: See the description of message
Multiple Systems Coupling feature system. DFS057I for possible causes of block fetch errors.
System action: IMS stops the line or link. Problem determination: Log record type X'67',
subrecord X'01', ID'FERR' which contains diagnostic
Operator response: (master terminal) When you have
information, is produced automatically.
corrected the problem, restart communications, using
the /START LINE x or /RSTART LINK x command. Module: DFSCFEO0
Module: DFSCMS70 Related information:
“DFS057I” on page 28
DFS270 PARTITIONED FORMAT SENT TO: [
NODE nodename|LINE x PTERM y] DFS272 FORMAT BLOCK LEVEL
ERROR-INPUT IGNORED
Explanation: MFS was instructed to format a message
with a device output format (DOF) that specified a Explanation: The DIF block that was fetched to
partition descriptor block (PDB). However, the message process the input was not at the same level as the MID
was not directed to a SLU2 terminal. block used to format the message or the DOF block
used to format the device. In MFS TEST mode, new
System action: The LTERM was marked inoperable,
format blocks have been added to the test library since
and the message causing the problem was returned to
the last output to the terminal. If not in MFS TEST
the message queue.
mode, format blocks have been changed by switching
Operator response: (master terminal) Your IMS the format data sets with the /MODIFY or INITIATE
system programmer should direct the message to a OLC commands since the last output to the terminal.
SLU2 terminal and use the right device output format
System action: The input data was ignored.
(DOF). If the use of the LTERM is to continue, a
/START LTERM xxx command must be issued. This Operator response: Format the screen and reenter the
message can be removed from the message queue with input. If the last output was logically paged by the
the /DEQUEUE LTERM P1 PURGE1 command. operator, it is still available; request the next message. If
the last output message was not completely transmitted
Programmer response: Direct the message to a SLU2
(all pages), it is still available; request the next message.
terminal.
Module: DFSCFEI0
Problem determination: Log record X'67' (subrecord
X'01', ID'FERR'), which contains diagnostic information,
is produced automatically. DFS273 QUEUE ERROR ON MESSAGE
DELETION
Module: DFSCFEO0
Explanation: An error occurred while attempting to
Severity: None.
delete the message in progress. Either an I/O error has
occurred on the message queue data set, or an internal
DFS271 UNABLE TO LOAD ERROR MESSAGE logic error has occurred.
OUTPUT DESCRIPTION
System action: The input data was ignored.
Explanation: The system was unable to load the error
Operator response: Contact your IMS system
message output description.
programmer for assistance.
System action: Block fetch has failed for the IMS
Module: DFSCFEO0
default message output description or the associated
device output format. Fetch also failed for a requested
message output description or a device output format. DFS274 LOAD MODULE DATASET NOT
The LTERM was marked inoperable with a QERROR OPEN LINE x PTERM y
status, and the message causing the problem was
Explanation: A System/7 issued a request for a load
returned to the message queue. This message is sent to
module, but the load module data set could not be
the z/OS system console if the LTERM involved is the
opened. Communication was terminated.
master terminal.
Operator response: (master terminal) Contact your
Operator response: (master terminal) Notify your IMS
IMS system programmer for assistance.
system programmer. The MTO should ensure that the
IMS default message output description and device Module: DFSCS7B0
output formats are in the format library and that I/O
errors are not occurring. If use of the LTERM is to
continue, a /START LTERM xxx command must be
issued. The message can be removed from the message
queue with the /DEQUEUE command.
System action: The command is ignored. security error. USERID userid is the user ID of the user
that invoked the program that issued the ICMD call.
Operator response: Reissue the command when the
The user ID is based on the type of region in which the
terminal is not active or is stopped.
program was executing and whether a Get Unique
Module: DFSICL50 (GU) call was done:
Explanation: Status cannot be changed while the DBT N/A Security token passed in
the PAPL
message is being processed.
IFP NO Program name
System action: The command is ignored.
IFP YES User ID (if terminal
Operator response: (local/remote terminal) Reissue signed on) or LTERM
the command when the terminal is not active or is name where a transaction
stopped. was issued
Module: DFSICL50 MPP NO Program name
MPP YES User ID (if terminal
DFS286 SECURITY VIOLATION LINE x signed on) or LTERM
PTERM y name where a transaction
was issued
or
BMP NO BMP JCL USER
SECURITY VIOLATION NODE nodename[USER BMP YES User ID (if terminal
username] signed on) or LTERM
name where a transaction
or was issued
System action: Any input message in progress is System action: Any input message in progress is
discarded. discarded.
Operator response: (master terminal) Retry the Operator response: Reenter the input message, using
operation. If the error persists, notify your systems the correct program function keys.
programmer.
Problem determination: 16
Programmer response:
Module: DFSCFE00
1. Ensure that entry is made into a field large enough
Related information:
to contain all card data.
Chapter 2, “IMS problem determination,” on page 5
2. Ensure that the card being used and the 3270
hardware function correctly.
DFS297 MULTIPLE PHYSICAL PAGE INPUT IS
Problem determination: Use /TRACE and DFSERA10
NOT IN PROGRESS
to obtain a printout of the terminal input data received
by IMS. See IBM 3270 Information Display System for Explanation: When no multiple physical page input
data formats. message was being created, the operator has entered a
request to terminate multiple physical page input
Module: DFSCFE10, DFSCFE00
(ENDMPPI).
System action: Input data is discarded.
DFS294 ID CARD READER USE ALLOWED
ONLY ONCE PER MESSAGE Operator response: Reenter the input, using the
appropriate procedure.
Explanation: When creating a multiple physical page
input message, the 3270 operator ID card reader can be Problem determination: 16
used only once.
Module: DFSCFEI0
System action: Any input message in progress is Related information:
discarded.
Chapter 2, “IMS problem determination,” on page 5
Operator response: Reenter the message using the ID
card reader only once.
DFS298 INPUT MESSAGE CANCELED BY
Problem determination: 16 SEGMENT EDIT EXIT
Module: DFSCFE00, DFSCFE10 Explanation: A user-supplied MFS segment edit exit
Related information: routine requested that the input message be canceled or
echoed by DPM-B.
Chapter 2, “IMS problem determination,” on page 5
Either the reason for the cancellation is dependent
upon an application, with invalid input, or the
DFS295 IMMEDIATE PEN DETECT LITERAL
distribution presentation management B (DPM-B)
ALLOWED ONLY ONCE PER
requests that the input message be echoed. The echoed
MESSAGE
message is not supported for DPM-B.
Explanation: 3270 immediate pen detect can be used
System action: The input message in progress is
in mixed mode, or to create an input literal only once
deleted.
per message.
Operator response: Enter the message in the manner
System action: Any input message in progress is
required by the exit routine.
discarded.
Programmer response: Verify correct operation of the
Operator response: Reenter the message, using the
user-supplied exit routine. Terminal input data can be
immediate pen detect facility only once.
examined by use of the /TRACE facility.
Problem determination: MFS
Module: DFSCFEI0
Module: DFSCFE00
DFS299 SEGMENT EDIT EXIT
DFS296 PROGRAM FUNCTION KEY LITERAL FAILURE-NOTIFY SYSTEMS
ALLOWED ONLY ONCE PER PROGRAMMER
MESSAGE
Explanation: A user-supplied MFS segment edit exit
Explanation: When creating a multiple physical page routine has either increased segment size beyond the
input message, the program function key can be used maximum allowed, or returned an invalid return code.
to create a literal value only once. Keys defined for System integrity can be harmed due to the edit routine
operator control can be used more than once. failure.
DFS301A UNABLE TO OPEN DDNAME-ddname Control statements for the DFSUCF00 utility
(Database Utilities)
Explanation: The issuing utility program was unable
to open a DCB with the ddname specified in the
message. DFS0303I xxxx <DYNAMIC BLOCK>
System action: Processing is terminated with a
or
nonzero return code.
Programmer response: Ensure that all necessary DD THE FOLLOWING BLOCKS WILL BE
statements required for execution are supplied. Correct <DYNAMICALLY FIXED | ALLOCATED IN DREF
any missing JCL statements, and resubmit the job. See STORAGE>:
abend code 0302.
Explanation: As storage for the block is obtained, the
Problem determination: 2, 3, 8, 18, 20, 35. Also, if this dynamic BLOCKS specified in the DFSFIXnn member
message was produced while running under the Utility of the data set described by DDNAME=PROCLIB is
Control Facility, rerun the job with a page fixed. The blocks specified in the DFSDRFnn
FUNCTION=OP,MSGNUM=301 control statement in member of the data set described by
the DFSYSIN data set. You must supply a SYSUDUMP DDNAME=PROCLIB are allocated in a DREF storage
DD statement in this step. subpool. xxxx is the IMS name of the block to be page
fixed or allocated in DREF storage.
Module: DFSPIRP0, DFSUCMN0, DFSUCP40,
DFSUC150, DFSUC350, DFSUDMP0, DFSURDB0, System action: IMS initialization continues.
DFSURGL0, DFSURGU0, DFSURRL0, DFSURUL0,
DFSUTR20, DFSUTR30 Operator response: No action is required.
Related information: Module: DFSXFIX0
Explanation: A utility program was unable to find a under the Utility Control Facility, rerun the job with a
DBD/PSB with the name specified in the utility control FUNCTION=OP,MSGNUM=307 control statement in
statement. the DFSYSIN data set. Supply a SYSUDUMP DD
statement to this step.
System action: Processing is terminated with a
nonzero return code. Module: DFSPRSDI, DFSUCP40
Programmer response: Correct either the utility Related information:
control statement or the DD statement specifying the
IMS abend 0302
DBD/PSB library, and resubmit the job. See abend code
0302.
DFS308A NO OUTPUT DDNAME SPECIFIED
Problem determination: 2, 3, 8, 18, 35. Also, if
FOR FUNCTION ff ON REQUEST nnnn
running under the Utility Control Facility, rerun the job
with a FUNCTION=OP,MSGNUM=305 control Explanation: A utility program found a control
statement in the DFSYSIN data set. You must supply a request that required an output data set DDNAME in
SYSUDUMP DD statement in this step. the control statement, but it was not supplied. nnnn is
the control request number.
Module: DFSUCMN0, DFSUCP40, DFSUCUM0,
DFSURUL0 System action: Processing is terminated with a
Related information: nonzero return code.
Programmer response: Correct the control request,
IMS abend 0302
and resubmit the job.
Chapter 2, “IMS problem determination,” on page 5
Problem determination: 2, 3, 8, 36. Also, if running
under the Utility Control Facility, rerun the job with a
DFS306A DBD dbdname DOES NOT CONTAIN FUNCTION=OP,MSGNUM=308 control statement in
DDNAME FOR FUNCTION ff the DFSYSIN data set. Supply a SYSUDUMP DD
Explanation: A utility program attempted to locate the statement to this step.
ddname specified in the control statement in the DBD Module: DFSUCP40
dbdname specified. The attempt was unsuccessful.
Related information:
System action: Processing is terminated with a Chapter 2, “IMS problem determination,” on page 5
nonzero return code.
Programmer response: Correct the control statement DFS309A CONTROL STATEMENT
in error, and resubmit the job. See abend code 0302. ERROR-INVALID/MISSING
Problem determination: 2, 3, 8, 35. Also, if running KEYWORD keyword
under the Utility Control Facility, rerun the job with a Explanation: A control program either detected a
FUNCTION=OP,MSGNUM=306 control statement in missing keyword that was required or was not able to
the DFSYSIN data set. Supply a SYSUDUMP DD identify a keyword.
statement to this step.
System action: Processing is terminated with a
Module: DFSUCCT0, DFSUCP40, DFSUCUM0, nonzero return code.
DFSUDMP0, DFSURDB0
Programmer response: Correct the control statement,
Related information:
and resubmit the job.
IMS abend 0302 Problem determination: 2, 3, 8, 36. Also, if running
Chapter 2, “IMS problem determination,” on page 5 under the Utility Control Facility, rerun the job with a
FUNCTION=OP,MSGNUM=309 control statement in
the DFSYSIN data set. Supply a SYSUDUMP DD
DFS307A NO DDNAME SPECIFIED FOR DATA
statement to this step.
BASE dbdname FOR FUNCTION ff
Module: DFSUCP40
Explanation: A utility program found a control
statement which required a ddname, but did not Related information:
contain one. Chapter 2, “IMS problem determination,” on page 5
System action: Processing is terminated with a
nonzero return code. DFS310A INPUT RECORD IMAGE FOR
ddddddddddddd IS IN ERROR AND
Programmer response: Correct the control statement,
FOLLOWS THIS MESSAGE
and resubmit the job. See abend code 0302.
Explanation: A utility program issues this message
Problem determination: 2, 3, 8, 35. Also, if running
after detecting an error in a control statement. The
message text identifies the statement in error. format. An error of this type can occur when the
ddddddddddddd identifies the unique data by the utility format of the image copy header record does not match
currently running to produce a customized message. that of a currently supported release of IMS.
This message can be issued for the following situations:
System action: Processing is terminated with a
v The database did not have to be scanned when
nonzero return code.
running DFSURGSO.
v When running OLIC, the DBD name specified on the Programmer response: Ensure that the input was
input control statement was not found in a DB PCB correct, or correct it, and resubmit the job. See abend
in the OLIC PSB, or the PSB specified LANG=PL/I. code 302.
OLIC requires LANG=ASSEM.
v The track recovery option was specified for an index Problem determination: 2, 3, 8, 35. Also, if running
KSDS. under the Utility Control Facility, rerun the job with a
FUNCTION=OP,MSGNUM=312 control statement in
System action: Processing is terminated with a the DFSYSIN data set. Supply a SYSUDUMP DD
nonzero return code. statement to this step.
Programmer response: Correct any errors, and Module: DFSURDB0
resubmit the job. Related information:
Problem determination: 2, 3, 8, 36. Also, if running
IMS abend 0302
under the Utility Control Facility, rerun the job with a
FUNCTION=OP,MSGNUM=310 control statement in Chapter 2, “IMS problem determination,” on page 5
the DFSYSIN data set. Supply a SYSUDUMP DD
statement for this step. DFS313A HD UNLOAD CANNOT BE USED TO
Module: DFSUCMN0, DFSUCP40, DFSUCUM0, UNLOAD INDEX DATABASE - dbdname
DFSUDMP0, DFSUICP0, DFSURDB0, DFSURGP0, Explanation: The Hierarchic Direct (HD)
DFSURGS0, DFSURG10, DFSURRL0, DFSURUL0, Reorganization utilities cannot be used to unload or
DSPLRC10 reload an index database.
Related information:
System action: Processing terminates with a nonzero
Chapter 2, “IMS problem determination,” on page 5 return code.
Programmer response: The Hierarchic Sequential (HS)
DFS311A RESTART WAS NOT SPECIFIED AND Unload/Reload utilities should be used to reorganize
NO DFSYSIN DATASET EXISTS an index database.
Explanation: The Utility Control Facility could not Module: DFSUFGU0
locate any control statements to determine its
processing. It is necessary to either have a DFSYSIN
data set or a “start” parameter. DFS314I TRAP KEYWORD HAS INVALID
PARAMETER
System action: Processing is terminated with a
nonzero return code. Explanation: The /TRACE SET ON TRAP command
was issued, but the TRAP keyword parameter was
Programmer response: Correct the error, and resubmit missing or invalid.
the job.
System action: The command is ignored.
Problem determination: 2, 3, 8, 36. Also, run the job
with a FUNCTION=OP,MSGNUM=311 control Operator response: (master terminal) Check the
statement in the DFSYSIN data set. Supply a command format and reenter the corrected command.
SYSUDUMP DD statement to this step.
Module: DFSICLN0
Module: DFSUCP10
Related information: DFS315A DEVTYPE MACRO FAILED ON
Chapter 2, “IMS problem determination,” on page 5 DDNAME ddname FOR FUNCTION ff
Explanation: A utility program issued an SVC 24
DFS312A DDNAME ddname DOES NOT (DEVTYPE) to obtain information about an input or
CONTAIN A VALID IMAGE OR output device. The return code indicated that the
REORGANIZED COPY FOR attempt to do this was unsuccessful.
FUNCTION RV
System action: Processing is terminated with a
Explanation: The Database Recovery utility was nonzero return code.
supplied an input data set defined by the DDNAME
Programmer response: Report this to system operation
ddname whose header record was not of the correct
personnel. See abend code 0302.
Module: DFSUCP40, DFSURDB0 Programmer response: One copy of the dumped data
set is created. If you want two copies, ensure that the
Related information:
output units and volumes are in good working order,
Chapter 2, “IMS problem determination,” on page 5 and resubmit the job.
Problem determination: 2, 3, 8
DFS323W FUNCTION ff WAS NOT SUPPLIED A
Module: DFSUCP40, DFSUDMP0, DFSURGU0, CHANGE ACCUMULATION INPUT
DFSURUL0
Explanation: A utility program found the accumulated
Related information: change input data set specified as DD DUMMY.
Chapter 2, “IMS problem determination,” on page 5
System action: Processing continues.
Programmer response: If no input was required, no
DFS321W FUNCTION ff EXPERIENCED AN
action is necessary. Otherwise correct the input, and
ERROR AND MUST BE RESTARTED
resubmit the job.
Explanation: A utility program encountered errors
Problem determination: 2, 3, 8, 36. Also, if running
prohibiting the successful completion of the requested
under the Utility Control Facility, rerun the job with a
operation.
FUNCTION=OP,MSGNUM=323 control statement in
System action: Processing is terminated with a the DFSYSIN data set. Supply a SYSUDUMP DD
nonzero return code. statement to this step.
Programmer response: Correct any errors noted before Module: DFSUCP40, DFSURDB0
this message and rerun the failing requests. If running Related information:
under the Utility Control Facility, correct the errors and
Chapter 2, “IMS problem determination,” on page 5
change the PARM= on the JCL to indicate RESTART is
needed or add a control statement to the DFSYSIN data
set with a FUNCTION=OP,REQUEST=RESTART. Some DFS324W FUNCTION ff WAS NOT SUPPLIED
utilities cannot be restarted within their execution. AN INPUT LOG FILE
Problem determination: 2, 3, 8, 36. Also, if running Explanation: The utility program found the log input
under the Utility Control Facility, rerun the job with a data was specified as DD DUMMY.
FUNCTION=OP,MSGNUM=321 control statement in
System action: Processing continues.
the DFSYSIN data set. Supply a SYSUDUMP DD
statement to this step. Programmer response: If no input was required, no
action is necessary. Otherwise correct the input, and
Module: DFSUDMP0
resubmit the job.
Related reference:
Problem determination: 2, 3, 8, 36. Also, if running
Utility Control Facility (DFSUCF00) (Database under the Utility Control Facility, rerun the job with a
Utilities) FUNCTION=OP,MSGNUM=324 control statement in
Related information: the DFSYSIN data set. Supply a SYSUDUMP DD
statement to this step.
Chapter 2, “IMS problem determination,” on page 5
Module: DFSUCP40, DFSURDB0
DFS322W FUNCTION ff WAS NOT SUPPLIED Related information:
AN IMAGE COPY INPUT Chapter 2, “IMS problem determination,” on page 5
Explanation: The utility ff found the image copy input
data set specified as DD DUMMY. DFS325A PURGE DATE ON DDNAME ddname IS
LATER THAN DATE ON DDNAME
System action: Processing continues.
ddname FOR FUNCTION ff
Programmer response: If no input was required, no
Explanation: A utility found that the purge date
action is necessary. Otherwise, correct the input, and
specified when the accumulated change input data set
resubmit the job.
was created was later than the date the image copy
Problem determination: 2, 3, 8, 36 input data set was created.
Also, if running under the Utility Control Facility, rerun System action: Processing terminates with a nonzero
the job with a FUNCTION=OP,MSGNUM=322 control return code.
statement in the DFSYSIN data set. Supply a
Programmer response: If any change records were
SYSUDUMP DD statement to this step.
created between the subject dates and are required for
Module: DFSUCP40, DFSURDB0 database integrity, the accumulated change input must
Related information: be recreated and the recovery job submitted again.
Chapter 2, “IMS problem determination,” on page 5 Problem determination: 2, 3, 8, 36. Also, if running
under the Utility Control Facility, rerun the job with a
FUNCTION=OP,MSGNUM=325 control statement in
the DFSYSIN data set. Supply a SYSUDUMP DD statements, and resubmit the job.
statement to this step.
Problem determination: 2, 3, 8, 36. Also, if running
Module: DFSUCP40, DFSURDB0 under the Utility Control Facility, rerun the job with a
Related information: FUNCTION=OP,MSGNUM=328 control statement in
the DFSYSIN data set. Supply a SYSUDUMP DD
Chapter 2, “IMS problem determination,” on page 5
statement to this step.
Module: DFSUCP40
DFS326A DDNAME ddname INPUT IGNORED
DUE TO PURGE DATE ON DDNAME Related information:
ddname Chapter 2, “IMS problem determination,” on page 5
Explanation: The Database Recovery utility program
found the creation date of the accumulated change DFS329A HEADER RECORD ON DDNAME
input data set to be earlier than the creation date of the ddname IS NOT CONSISTENT WITH
image dump data set. Because all records are already ddname/dbpcb FOR FUNCTION ff
on the dump, the accumulated change input data set is
Explanation: A utility program encountered an input
not being used.
data set header record whose data set description does
System action: Processing terminates with a nonzero not match the DBD description, or the header record of
return code. the other input data set indicated.
Problem determination: 2, 3, 8, 36. Also, if running System action: Processing terminates with a nonzero
under the Utility Control Facility, rerun the job with a return code.
FUNCTION=OP,MSGNUM=326 control statement in
Programmer response: Ensure that all inputs are
the DFSYSIN data set. Supply a SYSUDUMP DD
correct, and resubmit the job. See abend code 302.
statement to this step.
Problem determination: 2, 3, 8, 35. Also, if running
Module: DFSUCP40, DFSUDMP0, DFSURDB0
under the Utility Control Facility, rerun the job with a
Related information: FUNCTION=OP,MSGNUM=329 control statement in
Chapter 2, “IMS problem determination,” on page 5 the DFSYSIN data set. Supply a SYSUDUMP DD
statement to this step.
DFS327W NO RECORDS ON DDNAME ddname Module: DFSUCP40, DFSURDB0
FOR RECOVERED DATASET Related information:
Explanation: A utility program scanned the input data
IMS abend 0302
set ddname for records applicable to the data set being
recovered, but none were found. Chapter 2, “IMS problem determination,” on page 5
Programmer response: The input file is in error; Problem determination: 2, 3, 5, 6, 8, 12, 14, 17g, 35.
re-create it, and resubmit the job. See abend code 0302. Also, if running under the Utility Control Facility, rerun
the job with a FUNCTION=OP,MSGNUM=332 control
Problem determination: 2, 3, 8, 35. Also, if running
statement in the DFSYSIN data set. Supply a
under the Utility Control Facility, rerun the job with a
SYSUDUMP DD statement to this step.
FUNCTION=OP,MSGNUM=330 control statement in
the DFSYSIN data set. Supply a SYSUDUMP DD Module: DFSUCP40, DFSURDB0
statement to this step. Related information:
Module: DFSURDB0
IMS abend 0302
Related information:
Chapter 2, “IMS problem determination,” on page 5
IMS abend 0302
Chapter 2, “IMS problem determination,” on page 5 DFS333A KEY ID ON DDNAME ddname DOES
NOT EXIST IN DDNAME ddname
DATASET
DFS331A DDNAME ddname IS AN EMPTY
DATASET BUT SHOULD NOT BE Explanation: The recovery program encountered a
change accumulation or a system log record for a KSDS
Explanation: A utility program attempted to read a
data set with a key that does not exist in the recovered
data set, but got an immediate end-of-file condition.
data set. This indicates the input supplied was not
System action: Processing terminates with a nonzero correct. Normal operation requires that if a record on
return code. the change accumulation or the system log is not an
entire and complete record, then it must already exist
Programmer response: Ensure that the appropriate in the database data set or the image copy. There are
data set was supplied. Correct any error, and resubmit two basic reasons this message would be issued. These
the job. database errors are commonly caused by using the
Problem determination: 2, 3, 8, 36. Also, if running wrong image copy, or because a log data set was
under the Utility Control Facility, rerun the job with a missed during change accumulation.
FUNCTION=OP,MSGNUM=331 control statement in v The change accumulation or system log record is for
the DFSYSIN data set. Supply a SYSUDUMP DD a partial update (indicated by an offset greater than
statement to this step. zero). This record cannot be processed because the
database record does not exist.
Module: DFSUCP40
v The change accumulation record contains changes for
Related information:
two separate areas in a database record. This record
Chapter 2, “IMS problem determination,” on page 5 cannot be processed because the database record
does not exist.
DFS332A OSAM RECORD FROM DDNAME System action: Processing terminates with a nonzero
ddname HAS RBN nnnnnnnn AND IS return code.
BEYOND THE CURRENT END OF
THE DATASET Programmer response: Ensure that all input data sets
are correct, and resubmit the job. See abend code 302.
Explanation: The Database Recovery utility
encountered an OSAM record in the accumulated Problem determination: 2, 3, 8, 35. Also, if running
change or log input data set (ddname) that contained an under the Utility Control Facility, rerun the job with a
RBN value that was greater than the RBN value of the FUNCTION=OP,MSGNUM=333 control statement in
next block after the end of the data set. This condition the DFSYSIN data set. Supply a SYSUDUMP DD
should never exist under normal operation, because statement to this step.
inserts always use the next sequential RBN value after Module: DFSUCP40, DFSURDB0
the end of the data set. The most probable cause for
this is that an applicable log data set was not included Related information:
in either this run or an accumulation run. Another IMS abend 0302
possibility is that a HISAM reorganization unload was
run, the corresponding reload was not performed, and Chapter 2, “IMS problem determination,” on page 5
the unload tape was used as an input to the recovery
program. DFS334I DDNAME ddname DATASET MAY BE
System action: Processing terminates with a nonzero SCRATCHED
return code. Explanation: The Utility Control Facility has
Programmer response: Ensure that all supplied inputs determined that the named data set ddname is not
are correct, and resubmit the job. See abend code 0302. required for RESTART and can be released for other
uses.
Chapter 2, “IMS problem determination,” on page 5 For FUNCTION PU, the NO. OF UPDATES=nnnnnnnn
phrase is included, where nnnnnnnn is the count of
records on the input DFSURWF3 data set generated by
the Prefix Resolution utility. This count might differ
Related information:
DFS351W DFSYSIN DATA SCANNED FOR
OPTION REQUESTS ONLY Chapter 2, “IMS problem determination,” on page 5
attempting to perform a RESTART, an error occurred statement. Ensure that the proper journal data set has
that prevented successful reading of the old control been specified on the DFSOJRNL DD statement. Ensure
data set. that a RESTART is wanted, and resubmit the job.
System action: Processing terminates with a nonzero Problem determination: 2, 3, 8, 36. Also, if running
return code. under the Utility Control Facility, rerun the job with a
FUNCTION=OP,MSGNUM=359 control statement in
Programmer response: Ensure that the correct data set
the DFSYSIN data set. Supply a SYSUDUMP DD
was supplied. Move data set to another device (in the
statement to this step.
case of I/O errors), and resubmit the job.
Module: DFSUCP40, DFSURUL0
Problem determination: 2, 3, 8, 36. Also, if running
under the Utility Control Facility, rerun the job with a Related information:
FUNCTION=OP,MSGNUM=357 control statement in Chapter 2, “IMS problem determination,” on page 5
the DFSYSIN data set. Supply a SYSUDUMP DD
statement to this step.
DFS360I ERROR-ID CARD ERROR
Module: DFSUCP40, DFSURUL0 ENCOUNTERED
Related information: Explanation: The Change Accumulation utility
Chapter 2, “IMS problem determination,” on page 5 encountered a control statement with a control code of
ID that was invalid.
DFS358A INVALID SEGMENT CODE ss FOUND Programmer response: Correct the control statement,
IN DATABASE dbdname DDNAME and resubmit the job.
ddname ON FUNCTION ff
Module: DFSUCCT0
Explanation: A utility program encountered a segment
with a physical segment code of zero or higher than
DFS361A DFSNCDS IS NOT READABLE,
the highest segment code in the associated DBD
RESTART NOT POSSIBLE, RE-RUN
dbdname data set ddname. The segment code replaces the
JOB FROM BEGINNING
ss.
Explanation: While the Utility Control Facility was
System action: Processing terminates with a nonzero
attempting to write or read the new control data set
return code.
from the DFSNCDS file, an error was detected. This
Programmer response: Ensure that the DBD supplied error might be either physical device oriented or logical
accurately describes the database. If the data integrity in nature.
of the database is questionable, run the Database
System action: Processing terminates with a nonzero
Recovery utility program against the database in
return code.
question, and resubmit the job.
Programmer response: If the processing being done is
Problem determination: 2, 3, 8, 36. Also, if running
a RESTART, verify that the DFSNCDS data set was
under the Utility Control Facility, rerun the job with a
properly allocated. If the processing was not RESTART,
FUNCTION=OP,MSGNUM=358 control statement in
the error was probably caused by user-supplied control
the DFSYSIN data set. Supply a SYSUDUMP DD
statement information and a prior message will reflect
statement to this step.
this error. Correct any errors, and resubmit the job.
Module: DFSUCP40, DFSURUL0
Problem determination: 2, 3, 8, 36. Also, if running
Related information: under the Utility Control Facility, rerun the job with a
Chapter 2, “IMS problem determination,” on page 5 FUNCTION=OP,MSGNUM=361 control statement in the
DFSYSIN data set. Supply a SYSUDUMP DD statement
to this step.
DFS359A RESTART FAILURE-FUNCTION ff NOT
FOUND IN DFSOCDS Module: DFSUCP40
Explanation: When the Utility Control Facility was Related information:
attempting to perform a RESTART of a function, Chapter 2, “IMS problem determination,” on page 5
function ff was not indicated as required in the control
data set. This problem does not happen under normal
DFS362I function HAS TERMINATED WITH
processing.
RETURN CODE nn
System action: Processing terminates with a nonzero
Explanation: The currently running utility has
return code.
terminated and is passing return code nn.
Programmer response: Ensure that the proper control
Programmer response: If the return code is zero, no
data set has been specified on the DFSOCDS DD
further action is required. If the return code is nonzero,
Otherwise, restart the job from the beginning. System action: Processing terminates with a nonzero
return code.
Module: DFSURGU0
Programmer response: Either correct the control
statement, or if the control statement is correct, replace
DFS380A UNABLE TO POSITION DATABASE
the DBD with a valid IMS DBD.
dbdname FOR FUNCTION ff
Problem determination: 2, 3, 8, 36. Also, if running
Explanation: While attempting to position database
under the Utility Control Facility, rerun the job with a
dbdname, a utility program could not locate the
FUNCTION=OP,MSGNUM=382 control statement in
checkpointed segment.
the DFSYSIN data set. Supply a SYSUDUMP DD
System action: Processing terminates with a nonzero statement to this step.
return code.
Module: DFSUCP40, DFSURUL0
Programmer response: Ensure that all DD statements Related information:
are correct and the database has not been changed
Chapter 2, “IMS problem determination,” on page 5
between the original unload and the RESTART attempt.
If corrections can be made, resubmit the job. Otherwise,
restart the job from the beginning. DFS383A INPUT RECORDS ARE NOT IN
SEQUENCE FROM DDNAME ddname
Problem determination: 2, 3, 8, 36. Also, if running
FOR FUNCTION ff
under the Utility Control Facility, rerun the job with a
FUNCTION=OP,MSGNUM=380 control statement in Explanation: A root segment has been encountered
the DFSYSIN data set. Supply a SYSUDUMP DD with a sequence field (key) equal to or lower than the
statement to this step. previous root segment processed.
Module: DFSUCP40, DFSURGU0 System action: Execution is terminated.
Related information: Programmer response: If the abend option was
Chapter 2, “IMS problem determination,” on page 5 specified and a SYSUDUMP or SYSABEND DD
statement was provided, abend 0359 is issued, and a
storage dump was produced. Register 11 at entry to
DFS381I CHKPNTnnnn, {*****|vol1}, {*****|vol2},
abend is the address of the current key, and register 9
segname
is the address of the previous key.
Explanation: The system writes this message to the
Problem determination: 2, 3, 8, 36. Also, if running
console every time a checkpoint is taken by the HD
under the Utility Control Facility, rerun the job with a
Reorganization Unload utility program.
FUNCTION=OP,MSGNUM=383 control statement in
In the message text: the DFSYSIN data set. Supply a SYSUDUMP DD
nnnn A decimal value 1 - 9999, incremented by 1 for statement to this step.
every checkpoint taken
Module: DFSUCP40, DFSURUL0
vol1 The current primary output volume serial
number or asterisks indicating that the Related information:
primary output volume is not in use
IMS abend 0359
vol2 The current secondary output volume serial or
asterisks indicating that the secondary output Chapter 2, “IMS problem determination,” on page 5
volume is not in use
segname DFS384A PROCESSING OF LAST UCF
The segment name of the segment being REQUEST COMPLETED-RESTART
retrieved when the checkpoint was taken NOT ALLOWED
User response: No action is required. Explanation: The Utility Control Facility has
Module: DFSURGU0 completed all requests successfully. Since normal
completion has been achieved, RESTART is not
allowed.
DFS382A DBD dbdname IS NOT A VALID DBD
FOR THIS FUNCTION ff System action: Processing continues.
Explanation: The DBD dbdname supplied on a control Problem determination: 2, 3, 8, 36. Also, if running
statement was used to load a DBD. Upon examination under the Utility Control Facility, rerun the job with a
of the DBD, it was discovered that the DBD was not a FUNCTION=OP,MSGNUM=384 control statement in
valid IMS DBD, or it was a HALDB and the utility the DFSYSIN data set. Supply a SYSUDUMP DD
does not support HALDBs statement to this step.
Module: DFSUCP40
System action: Processing terminates with a nonzero Explanation: A utility program was processing an
return code. input file ddname, and expected to find a statistics
record.
Programmer response: Too many parameters were
specified on the control request nnnn. Make multiple System action: Processing terminates with a nonzero
control requests to do the same function as the one in return code.
error. This action shortens the overall length of the Programmer response: If "NSTAT" was specified on
table requirements and still perform the required HISAM unload, specify OPTIONS=(NSTAT) in the
function. Resubmit the job; do not perform a RESTART. SYSIN data set for HISAM reload. Correct any errors,
Problem determination: 2, 3, 8, 36. Also, if running and resubmit the job.
under the Utility Control Facility, rerun the job with a Problem determination: 2, 3, 8, 36. Also, if running
FUNCTION=OP,MSGNUM=385 control statement in under the Utility Control Facility, rerun the job with a
the DFSYSIN data set. Supply a SYSUDUMP DD FUNCTION=OP,MSGNUM=388 control statement in
statement to this step. the DFSYSIN data set. Supply a SYSUDUMP DD
Module: DFSUCP40 statement to this step.
Related information: Module: DFSUCP40, DFSURGU0
Chapter 2, “IMS problem determination,” on page 5 Related information:
Chapter 2, “IMS problem determination,” on page 5
DFS386A A PREMATURE EOF WAS
ENCOUNTERED ON DDNAME ddname DFS389W PROCESSING FOR THE {FOLLOWING
Explanation: The utility program was reading an | PRECEDING} REQUEST HAS
input file when it reached the End of File. This TERMINATED {ABNORMALLY |
condition was not expected at that precise time, and is NORMALLY}
therefore an error. Explanation: This informational message is issued to
System action: Processing terminates with a nonzero tell the user how a request completed.
return code. System action: Processing terminates normally or
Programmer response: Ensure that the data set is abnormally as indicated in this message.
complete, and resubmit the job. Programmer response: If an abnormal termination has
Problem determination: 2, 3, 8, 36. Also, if running occurred, correct the errors printed prior to this
under the Utility Control Facility, rerun the job with a message, and resubmit the job. If a normal termination
FUNCTION=OP,MSGNUM=386 control statement in has occurred, no further action is necessary.
the DFSYSIN data set. Supply a SYSUDUMP DD Problem determination: 2, 3, 8, 36. Also, if running
statement to this step. under the Utility Control Facility, rerun the job with a
Module: DFSUCP40, DFSURUL0 FUNCTION=OP,MSGNUM=389 control statement in
the DFSYSIN data set. Supply a SYSUDUMP DD
Related information:
statement to this step.
Chapter 2, “IMS problem determination,” on page 5
Module: DFSUCP40, DFSURGL0
Related information:
DFS387I ERROR-NO VALID RECORDS ON
INPUT DATASET Chapter 2, “IMS problem determination,” on page 5
Programmer response: Correct the invalid input, and Explanation: The issuing program encountered one of
resubmit the job. Ensure that the HD unload was the following errors:
successful and that the unloaded data set is valid. It
v The input record is not a valid type. The valid types flagged on the output printer. Correct the error, and
are 00 (logical parent), 10 (logical child), 60 (dummy), resubmit the job.
and 80 (checkpoint).
Problem determination: 2, 3, 8, 36. Also, if running
v While processing a type 00 or type 10, an invalid
under the Utility Control Facility, rerun the job with a
logical description exists in the DBD.
FUNCTION=OP,MSGNUM=392 control statement in
v During input processing of work file data sets, a
the DFSYSIN data set. Supply a SYSUDUMP DD
work file record was found that contains a segment
statement to this step.
not found in the segment descriptor blocks (SDB).
Module: DFSUCMN0, DFSUCP40, DFSUDMP0
In the first two cases, the work file record is printed for Related information:
each occurrence of the invalid condition. In the third
case, the work file record is printed once and the job IMS abend 0013
terminates. This work file record is from the specified Chapter 2, “IMS problem determination,” on page 5
data set on the DFSURWF3 DD statement. The record
is printed in hexadecimal with EBCDIC translation.
DFS393A BLDL FAILED FOR MODULE cccccccc
System action: Processing terminates with a nonzero
return code. Explanation: The module listed, cccccccc, was not
found when the BLDL macro searched the PDS
Programmer response: Ensure that the complete log directories for STEPLIB, JOBLIB, SYS1.LINKLIB.
data set file is supplied as input, and resubmit the job.
System action: Processing stops for the utility.
Problem determination: 2, 3, 8, 36. Also, if running
under the Utility Control Facility, rerun the job with a Programmer response: Verify that the JCL specifies
FUNCTION=OP,MSGNUM=390 control statement in the correct libraries and that the module is in one of
the DFSYSIN data set. Supply a SYSUDUMP DD the program libraries. Rerun the job.
statement to this step. Problem determination: 1, 2, 3, 4, 8, 12, 36. Also, if
Module: DFSUCMN0, DFSUCP40 running under the Utility Control Facility, rerun the job
with a FUNCTION=OP,MSGNUM=393 control
Related information:
statement in the DFSYSIN data set. Supply a
Chapter 2, “IMS problem determination,” on page 5 SYSUDUMP DD statement to this step.
Module: DFSUCF00, DFSURDB0
DFS391I This message is variable
Related reference:
Explanation: Anytime a utility must print a general
message, it uses this message. No warning or error BLDL Completion Codes
message uses this number. Related information:
Problem determination: 2, 3, 8, 36. Also, if running Chapter 2, “IMS problem determination,” on page 5
under the Utility Control Facility, rerun the job with a
FUNCTION=OP,MSGNUM=391 control statement in DFS394A AN RBA SEQUENCE ERROR
the DFSYSIN data set. Supply a SYSUDUMP DD OCCURRED FOR FUNCTION ff
statement to this step.
Explanation: A utility program was reading an ESDS,
Module: DFSUARC0, DFSUARP0, DFSUCCT0, and the returned relative byte address (RBA) of the
DFSUCP40, DFSUDMP0, DFSUICP0, DFSURDB0, record was not higher than the prior one.
DFSURRL0, DFSULG20, DFSUPNT0
System action: Processing terminates with a nonzero
Related information:
return code.
Chapter 2, “IMS problem determination,” on page 5
Programmer response: The database is in error.
Recovery of the data set is required. Use the Database
DFS392A DUPLICATE NAMES name SPECIFIED Recovery utility to accomplish this recovery.
ON CONTROL REQUEST FOR
FUNCTION ff Problem determination: 2, 3, 8, 36. Also, if running
under the Utility Control Facility, rerun the job with a
Explanation: The control statement contains duplicate FUNCTION=OP,MSGNUM=394 control statement in
data definition names (ddnames). This condition would the DFSYSIN data set. Supply a SYSUDUMP DD
have caused a system abend 0013. statement to this step.
System action: Processing terminates with a nonzero Module: DFSUDMP0, DFSURDB0
return code.
Related information:
Programmer response: The control request in error is Chapter 2, “IMS problem determination,” on page 5
DFS395I BACKOUT COMPLETE FOR PSB DFS398I I/O ERROR DURING BACKOUT IN
psbname [TO CHKPT chkptid] [FOR DATA BASE dbname PROGRAM name
REGION regid]
Explanation: The Database Backout utility
Explanation: The Database Backout utility successfully encountered an I/O error while attempting backout on
completed the requested database backout. If the the specified database.
CHKPT option was specified in the SYSIN data file, TO
Programmer response: Run the Database Recovery
CHKPT chkptid identifies the checkpoint to which the
utility against the database in error. Use all log data
backout was completed, and FOR REGION regid
sets, including the output of this backout attempt. Then
identifies the region in which the PSB was running.
rerun the backout job.
(default=01)
Problem determination: 1, 2, 3, 5, 8, 11, 17a, 17d, 17g,
Operator response: Record the checkpoint number
20, 36
and the volume serial number in case a restart action
must be requested. Module: DFSBACK0, DFSRDBC0
Problem determination: 1, 2, 3, 5, 8, 11, 17a, 17d, 17g, Related information:
20, 36 Chapter 2, “IMS problem determination,” on page 5
Module: DFSBACK0, DFSRDBC0
Related information: DFS399I BUFFER POOL TOO SMALL FOR
BACKOUT OF DATA BASE dbname
Chapter 2, “IMS problem determination,” on page 5
PROGRAM psbname
Explanation: The database buffer pool was too small
DFS396I SYSTEM ERROR DURING BACKOUT
to accommodate the database specified while
OF DATA BASE dbname PROGRAM
attempting to run the Database Backout utility.
psbname
Programmer response: Increase the database buffer
Explanation: The Database Backout utility was unable
pool size in the EXEC statement, and rerun the job.
to locate a data management block directory entry for
the database specified. Problem determination: 1, 2, 3, 5, 8, 11, 17a, 17d, 17g,
20, 36
Programmer response: This problem indicates that the
PSB used for backout has changed since the original Module: DFSBACK0, DFSRDBC0
run. Check the PSB requested in the EXEC statement to Related information:
ensure that the name and the PSB are correct. Correct
any errors, and rerun the job. Chapter 2, “IMS problem determination,” on page 5
DFS401I DBRC CALL FAILURE - RETURN DFS0402 DATABASE dbname NOT STARTED
CODE = xx - CALL = yyyyyy DUE TO RECOVERY NEEDED.
Explanation: The Batch Backout utility received an Explanation: While processing a /START DB
unexpected return code from DBRC. yyyyyy is the call command, the system found that a deferred backout
made to DBRC, and xx is the return code from DBRC. was required for the database, dbname. A verification of
this backout using DBRC (to ensure that the backout
System action: If the call identified in the message is
was not done by batch backout utility) found that the
SAVUOR, LOGSET, or VERUOR, the batch backout job
database first requires forward recovery. This condition
terminated. If the call is UPDUOR, INIT, or EOJ, the
occurs during the first active start after a remote
required changes have been successfully backed out of
takeover. The shadowed database was not authorized
the databases associated with the PSB for which the
to the tracking system at the time of the takeover while
Batch Backout utility was being run.
the copy of the active was updated before takeover.
Programmer response: If the call identified in the
System action: The database is not started and the
message is SAVUOR, LOGSET, VERUOR, or UPDUOR,
backout is not done.
contact IBM for problem determination assistance.
User response: Forward recover the database; then
If the call is INIT or EOJ, see one of the following
reissue the start command.
return codes:
Module: DFSDBDR0
Code (hex)
Explanation
DFS0403W IMS xxxxxxxxx CALL TO MVS ARM
08 The IMS subsystem for which backout was being
FAILED - RETURN CODE=
performed was not authorized to use one or more
nn,REASON CODE=nnnn.
of the databases that had changes backed out.
Explanation: A call to the z/OS Automatic Restart
A previous error might have caused the loss of the
Manager (ARM) failed. The message text contains the
database authorization. Determine the cause of any
type of call, represented by xxxxxxxx, and the return
previous errors. Otherwise, the DBRC EOJ call has
and reason codes. Values for xxxxxxxxx are:
failed and the RECON data set might need
REGISTER
updating.
Register with the z/OS ARM.
2C An internal DBRC error occurred. DBRC was not READY
able to access the RECON data set. Ensure that the Notify the z/OS ARM that IMS is ready to
appropriate DD statement for the RECON data set accept work.
is available. ASSOCIATE
Notify the z/OS ARM that this is an XRF
30 The parameters passed to DBRC were invalid. The alternate or a Fast DB Recovery region.
RECON data set must be updated manually. UNKNOWN
Contact IBM for problem determination assistance. An unknown request value was passed to
Problem determination: 1, 2, 20, 25 DFSARM00.
Module: DFSBACK0 System action: IMS ignores the return code and
continues running.
Related information:
Chapter 2, “IMS problem determination,” on page 5 Programmer response: To determine the reason for
the failure, check the IXCARM return and reason codes.
Then, correct the problem.
DFS0401I DBRC CALL FAILURE - RETURN
CODE = xx - CALL = yyyyyy Module: DFSARM00
Related reference:
Explanation: See DFS401I
Related information: IXCARM Return and Reason Codes
“DFS401I”
System action: If yyy is 1 or 2, the DL/I subordinate Explanation: Module DFSILTA0 was unable to get
address space abends with 0023, causing the control enough storage to build queue entries.
address space to abend with 0150. If yyy is 3, System action: DFSILTA0 terminates abnormally with
initialization continues. abend 0407.
| If yyy is 004, IMS terminates abnormally with abend Programmer response: Rerun the job in a larger
| code 0023. region or code the ST= parameter on the EXEC
Programmer response: If yyy is 1 or 2, correct the statement to process a shorter time.
specification for the indicated DDNAME. The data sets Module: DFSILTA0
specified and their concatenation order must be
Related information:
identical in both the IMS and DL/I address space
procedures. If yyy is 3, and you intend to use the IMS abend 0407
Online Change function, cancel the control region and
supply the missing specification for the inactive
ACBLIB. DFS0408I INVALID 'ST' PARAMETER.
| If yyy is 004, correct the specification for the indicated Explanation: The EXEC statement had an invalid ST
| DDNAME. parameter.
40 The OLDS block size was less than the largest 05 DSCB for data set not found.
OLDS block size (DFSOLPnn,DFSOLSnn)
06 First volume DSCB specified a DSORG type not
successfully allocated.
permitted by OSAM.
44 The WADS device type was inconsistent
(distinct). 07 DCB block size not equal to DSCB block size after
48 The OLDS block size was greater than the JFCB/DCB merge.
track capacity.
08 DCB LRECL size not equal to DSCB LRECL size
System action: The DD error statement is discarded after JFCB/DCB merge.
and system initialization continues. If DUAL is
requested and an error exists in an OLDS pair, the 09 Neither the LRECL nor block size was specified in
OLDS pair is discarded. System initialization continues. the DSCB, DCB, or JCL.
Programmer response: Check the DD statement and 0A The specified block size is less than LRECL.
correct any errors so that the data set will be available 0B The specified block size exceeds track size for the
the next time the system is initialized. specified device.
Problem determination: 1, 3, 8, 11, 36 0C A previous OPEN or EOV failed.
Module: DFSFDLS0, DFSXLGI0 0D VIO not supported by OSAM. The data set is
Related information: allocated to a VIO unit.
“DFS2503W” on page 511 0E Tape devices are not supported. The data set is
Chapter 2, “IMS problem determination,” on page 5 allocated to a tape device.
0F Some internal error occurred in the OSAM DEB
DFS0414I CONTINUING WITH ALTERNATE subroutine. DCBWRK1 indicates the error code.
LOG
10 Block size greater than track size.
or
If hardware errors occur, see the z/OS IOS000I message
issued before this message.
PERMANENT I/O ERROR ON ddname - DURING
LOG zzzz xx System action: IMS continues execution with a spare
WADS (DFSWADSn, n=0,1,...9), if one is available. If no
Explanation: Either form of this message can be such WADS exists, IMS continues logging in a
issued. The first message indicates that a permanent degraded mode by truncating log buffers to ensure the
I/O error occurred in the log data set specified by the preservation of Log-Write Ahead Protocols (LWA).
ddname. The log data set is either an online log data
set (OLDS), a write-ahead data set (WADS), or a batch One of the following occurs for the other WRITE error
system log data set (SLDS). The value of zzzz is WRITE cases:
or READ. OLDS IMS continues execution if 2 or more OLDS
remain. If only one OLDS remains, an internal
The second message indicates that the system continues CHECKPOINT FREEZE is performed. If no
with an alternate log data set. OLDS remains, IMS abends with abend 0616.
For WRITE errors, xx is an invalid DECB post code, SLDS IMS continues execution if dual logging is in
which is contained in the first byte of the ECB effect and an alternate SLDS exists. If an
(ECBCC). No xx value with a WRITE error indicates alternate SLDS is unavailable, IMS abends
that a log data set CLOSE error occurred during EOV with abend 0616.
processing. Operator response: If the error occurs on an OLDS
For READ errors, xx is an OSAM error return code. and dual logging was not being used, or if errors occur
on both copies of a dual OLDS log, then run the Log
The values and meanings of xx are as follows: Recovery utility to close the OLDS in error.
Code (hex) For an invalid DECB post code with no associated
Explanation hardware error, set a SLIP to capture a memory dump
01 DD statement missing. at the next message occurrence and contact IBM
Software Support.
02 Concatenated data set.
If an error IOS002A occurred indicating no paths were
03 Fewer units than volumes specified for a DASD available to the allocating device and CLOSE
data set. processing also involving an I/O request is started, the
04 JCL specified a DSORG type not permitted by CLOSE might still appear hung. Issue V OFFLINE to
OSAM. the UCB.
Module: DFSFDLS0
Problem determination: 1, 4, 5, 6, 8, 11, 36 Programmer response: Correct the error, and resubmit
the job.
Module: DFSFCST0
Module: DFSUPRT0
Related information:
Chapter 2, “IMS problem determination,” on page 5
DFS422I I/O ERROR WRITING SYSPRINT
DATASET, JOB TERMINATED.
DFS418A PSB IS NOT AUTHORIZED FOR
ON-LINE IMAGE COPY Explanation: A permanent I/O error occurred while
the SYSOUT print utility was writing to the SYSPRINT
Explanation: This message occurs if the PSB specified data set. This message is printed using the z/OS
by the user was generated without the OLIC=YES Write-To-Programmer facility (return code = 0C).
option on the PSBGEN macro.
Programmer response: Correct the error, and resubmit
System action: The utility ends with a return code of the job.
16.
Module: DFSUPRT0
Programmer response: Either correct the PSB or use a
PSB with the option properly specified.
detected while testing for buffer codes from VSAM GENCB and MODCB, see z/OS
validity using coupling facility DFSMS Macro Instructions for Data Sets.
services.
Problem determination: 1, 2, 3, 4, 35
08 An unexpected return code was
returned from VSAM while testing Module: DFSDVBI0
for buffer validity using coupling Related reference:
facility services.
VSAM Macro Return and Reason Codes
System Action: The buffer handler causes the Related information:
application program to be terminated with
abend 0427. IMS abend 0430
Chapter 2, “IMS problem determination,” on page 5
If you have a program specification block (PSB) where
one PCB has PROCOPT=L and another PCB has
PROCOPT=I (or GIRD or A), the results are DFS0430I UNABLE TO INITIALIZE DL/I
unpredictable. This message can be issued. BUFFERING SERVICES, REASON
CODE xx
Also, see the 0427 abend code information. Explanation: The DL/I buffering services function
Problem determination: 1, 4, 35 cannot be initialized. The variable xx is the reason for
the failure and can have the following values:
Module: DFSDVSM0
Reason code: 01
Related information: In a DL/I or DBB region, the PSB contained
IMS abend 0427 one or more PCBs for VSAM databases.
However, the DL/I buffer pool parameter data
Chapter 2, “IMS problem determination,” on page 5 set (DFSVSAMP) was not provided.
Programmer response: Provide a DL/I buffer
DFS0428I PSB SPECIFIED IN EXECUTE PARMS pool parameter data set to describe the VSAM
DOES NOT MATCH PSB ON LOG buffer subpools for the job step.
DATASET.
Reason code: 02
Explanation: The PSB specified in the EXEC DL/I was unable to OPEN the buffer pool
parameters of the Batch Backout job did not match the control statement data set. For batch regions,
PSB on the update (type X'50') records in the log data this data set is defined by DDNAME
set supplied to Batch Backout. DFSVSAMP. For online regions, this data set is
This error occurs during backout of a batch job in defined by DDNAME PROCLIB.
which IRLM is being used for data sharing. If the Programmer response: Ensure that the DD
wrong PSB was specified on the EXEC parameters, this statement is correct for the region type. In
check prevents a data integrity exposure if batch addition, for online regions, ensure that the
backout releases all IRLM locks for a failed batch job, value specified by the parameter VSPEC is a
but does not complete any backout. valid suffix to complete the member name of
System action: Batch Backout terminates. DFSVSMxx and the member name which
exists in PROCLIB. Member name, DFSVSM00,
Programmer response: Make sure the PSB specified is used if VSPEC is not specified.
on the EXEC parameters matches the PSB specified in
the batch job being backed out. Reason code: 03
In a DLI or DBB region, the PSB contained one
Module: DFSBCKI0 or more PCBs for VSAM databases, but no
valid subpool definition statements were
DFS0429I VSAM {GENCB|MODCB} ERROR, found. Message DFS0434I or DFS0435I, or
RETURN CODE X'yy'. both, was issued.
Explanation: DL/I VSAM pool initialization issued a Programmer response: See message DFS0434I
VSAM GENCB or MODCB macro, and encountered an or DFS0435I.
error condition returned from VSAM X'yy' is the Reason code: 04
hexadecimal return code in register 15 returned by In a DLI or DBB region, the PSB contained one
VSAM. or more PCBs for VSAM databases, but no
System action: Abend 0430 is issued, and the step is subpool definition statements were found.
terminated. Programmer response: Check the control
Programmer response: For an explanation of return statements and correct if necessary.
IMODULE return codes (Messages and Codes) DFS0434I BUFFER SIZE OR KEYWORD INVALID
Related information: ON CARD nnn
IMS abend 0430 Explanation: The nth statement in the buffer pool
parameter data set specified an invalid buffer size or an
Chapter 2, “IMS problem determination,” on page 5 invalid keyword. A buffer size must be 512, 1024, 2048,
4096, or a multiple of 4096 up to and including 32768.
System action: The statement is bypassed. PSB being used. This error can also occur if invalid
parameters are on the following statements:
Programmer response: Correct the control statement,
CFNAMES
and resubmit the job.
IOBF
Problem determination: 1, 2, 3, 36 DBD
OPTIONS
Module: DFSDVBI0 VSRBF or VSAM buffer pool definition
Related information: RESVPOOL
Chapter 2, “IMS problem determination,” on page 5 LOCKTIME
FFROLR
DFS0435I NUMBER OF BUFFERS INVALID ON System action: The parameter is ignored, and
CARD n processing continues.
Explanation: The nth statement in the buffer pool In the buffer pool parameter data set, if the database
parameter data set specified an invalid number of parameter is specified with a data set number of A to J,
buffers, or the value specified was not numeric. L or X for HALDB but the database is a NON HALDB,
the system issues this message; the allocation does not
System action: If VSAM is used (and the value is not occur. If the database is later converted to HALDB,
numeric), the statement is bypassed. For OSAM, then the allocations for this entry become live as soon
defaults are taken for all remaining parameters. If the as the database is started (without recycling IMS). The
parameter is numeric, see message DFS0433I. same occurs if you have a data set number 1 and are
Programmer response: Correct the control statement; converting from HALDB to NON HALDB.
then resubmit the job, if necessary. Programmer response: The parameter has been
Problem determination: 1, 2, 3, 36 ignored. Correct the control statement, and resubmit
the job. See the IMS system definition information for
Module: DFSDVBI0 parameter formats.
Related information:
Problem determination: 2, 3, 18, 19
“DFS0433I” on page 104
Module: DFSDVBI0, DFSTRA00, DFSRDB30
Chapter 2, “IMS problem determination,” on page 5
Related information:
Chapter 2, “IMS problem determination,” on page 5
DFS0436I I/O ERROR ON CONTROL CARD
DATASET
DFS0438I UNABLE TO LOAD MODULE m, return
Explanation: Module DFSCVBIO attempted to read
code X'nn'
the buffer pool parameter data set (DFSVSAMP) and
encountered an I/O error. Explanation: An error was encountered while
attempting to load the module with module name m.
System action: In region type DBB or DLI, if a
X'nn' is the hexadecimal return code from the
database using VSAM was specified in the PSB, abend
IMODULE LOAD macro. For a description of these
0430 was issued. In all other cases, processing
codes, see the IMODULE return codes information.
continues without a DL/I VSAM buffer pool.
System action: IMS is terminated abnormally with
Programmer response: Ensure that the DD statement
abend 0430.
for DFSVSAMP is correct, and resubmit the job.
Programmer response: Provide the module in a
Problem determination: 2, 3, 4, 18, 19
library where it can be accessed without error.
Module: DFSDVBI0
Problem determination: 1, 2, 3, 35
Related information:
Module: DFSDVBI0
IMS abend 0430 Related reference:
Chapter 2, “IMS problem determination,” on page 5
IMODULE return codes (Messages and Codes)
Related information:
DFS0437I CARD nnn, ERROR IN PARAMETER
mmm IMS abend 0430
Explanation: The nth statement in the buffer pool Chapter 2, “IMS problem determination,” on page 5
parameter data set has an error in the mth parameter.
For an online system, this error occurs if system
definition does not include the DBD. For a batch job,
this error occurs if the DBD is not generated within the
DFS0439I WARNING, VSAM SUBPOOLS WITH DFS0441I STORAGE NOT AVAILABLE FOR
EQUAL LENGTH BUFFERS HAVE OPEN TABLE, RETURN CODE X'yy'
BEEN DEFINED, POOL ID xxxx
Explanation: An error was encountered while
Explanation: Two or more VSAM subpool definition attempting to GETMAIN storage for an open table. 'yy'
statements specify the same buffer size. If multiple is the return code from the IMODULE GETMAIN. For
shared resource pools were requested, POOL ID xxxx a description of these codes, see the IMODULE return
indicates the particular shared resource pool in error. codes information.
System action: A subpool is built with the sum of the System action: IMS terminates abnormally with abend
number of buffers specified. 0430.
Programmer response: If the intent was to build Programmer response: If insufficient storage is
separate subpools, then correct the subpool definition available, increase the main storage available to IMS.
statements to specify different buffer sizes.
Problem determination: 1, 2, 3, 4, 18, 22
Problem determination: 2, 3, 18, 19
Module: DFSDVBI0
Module: DFSDVBI0 Related reference:
Related information:
IMODULE return codes (Messages and Codes)
Chapter 2, “IMS problem determination,” on page 5
Related information:
databases are registered as recoverable. It is suggested characters of the invalid pool ID appear in the
that all related databases be either recoverable or warning message. See Defining VSAM buffer
nonrecoverable. pools (System Definition) for an explanation of
the POOLID statement.
System action: IMS continues processing.
Reason code: 04
Programmer response: No action is required.
While processing POOLID subpool definition
This is an informational message. statements, a POOLID statement was coded
with a duplicate pool ID. IMS ignores the
Module: DFSDBLN0 POOLID statement with the duplicate pool ID.
IMS also ignores all VSRBF statements that
DFS0444 MESSAGE LENGTH EXCEEDS FAST define subpools in that shared resource pool.
PATH BUFFER LENGTH - INPUT Programmer response: Correct the control
IGNORED statements before the next job execution.
Explanation: The terminal operator entered a Fast Reason code: 05
Path message segment that was too long for the While processing POOLID subpool definition
expedited message handling buffer (EMHB). The statements, an invalid parameter was found.
EMHB is defined in the FPBUFLEN keyword on the IMS ignores the remainder of the particular
TERMINAL macro. POOLID statement and uses the default values
System action: The transaction message is discarded. of the remaining parameters. See Defining
VSAM buffer pools (System Definition) for an
Operator response: Correct the format of the explanation of the POOLID statement.
transaction message; then reenter the command.
Reason code: 06
Module: DBFSUIX0 An error was detected while processing
POOLID subpool definition statements. The
DFS0445I WARNING - INVALID VSAM SHARED VSAM shared resource pool ID on the
RESOURCE POOL DEFINITION, POOLID subpool definition statement (for a
POOLID xxxx, REASON CODE yy shared resource pool other than the default
pool) was not referenced by any valid buffer
Explanation: The definition for the VSAM shared pool DBD statement. The VSAM shared
resource pool is invalid. xxxx identifies the pool ID, and resource pool is built but not used. See
yy identifies one of the following reason codes: Defining VSAM buffer pools (System
Reason code: 01 Definition) for an explanation of the POOLID
An error was detected in an attempt to define statement.
an index subpool without any data subpool Reason code: 07
within the same VSAM shared resource pool. An error was detected in the attempt to define
IMS cannot build the particular shared a VSAM shared resource pool which did not
resource pool. contain a subpool. A POOLID subpool
Programmer response: Correct the control definition statement is followed by another
statements before the next job execution. POOLID statement rather than by VSRBF
subpool definition statements. A VSAM shared
Reason code: 02 resource pool without any defined subpool is
The maximum number of VSAM shared ignored. See Defining VSAM buffer pools
resource pools has been exceeded. Any (System Definition) for an explanation of the
POOLID statements (with the corresponding POOLID statement.
VSRBF statements) found after the limit is
reached are ignored. The warning message is Reason code: 08
issued only for the first valid POOLID The maximum number of VSAM shared
statement that exceeds the limit. resource pools has been exceeded when the
number of shared pools reserved with the
Programmer response: Combine or eliminate RESVPOOL statement is considered. Normally,
the VSAM POOLID subpool definition the maximum number of shared pools allowed
statements that exceed the limit. is:
15 in a batch or utility environment
Reason code: 03
16 in a DC or DBCTL environment
While processing POOLID subpool definition
statements, an invalid pool ID was found. IMS
ignores the POOLID statement and all VSRBF Any POOLID statements (with the
statements defining subpools within that corresponding VSRBF statements) found after
shared resource pool. Only the first four the limit is reached are ignored. The warning
message is only issued for the first valid and the Hiperspace buffers were specified as required.
POOLID statement exceeding the limit.
If multiple shared resource pools were requested,
POOL ID xxxx indicates the shared resource pool in
IMS buffer pool initialization continues.
error.
Programmer response: Combine or eliminate System action: For INVALID or FAILED, IMS
the VSAM POOLID subpool definition initialization abnormally terminates with abend 0430.
statements that exceed the limit.
For UNAVAIL, initialization of IMS continues without
Reason code: 20 Hiperspace buffering for the identified VSAM subpool.
A terminal in Fast Path response mode
Programmer response: Remove any Hiperspace
attempted to logon to an IMS system that is
buffering specifications on buffer sizes less than 4 K.
not Fast Path capable.
If sufficient expanded storage exists and this message
Module: DBFSUIX0, DFSRDB30
indicates that storage is unavailable, try increasing the
z/OS SRM values in the IPS statement for
DFS0446I WARNING - VSAM SHARED PWSS=(min,max). See z/OS MVS Initialization and Tuning
RESOURCE POOLID xxxx ON DBD Guide (SA22-7591).
STATEMENT IN ERROR
Module: DFSDVBI0
Explanation: An error was detected while processing
DBD statements. The VSAM shared resource pool ID
DFS449A VOLUME...... IS INCORRECT FOR
on the DBD statement did not match the ID on any
RESTART-MOUNT VOLUME......
valid POOLID subpool definition statement.
Explanation: During restart processing, the utility
System action: IMS reassigns the data set to the
detected an incorrect volume mounted for the
default shared resource pool.
continuation of the image data set.
Programmer response: Correct the control statement
System action: The utility closes the data set, forcing
before the next job execution.
the incorrect volume to be demounted, and then opens
Module: DFSRDB30 the data set. The utility continues to do this until the
correct volume is mounted.
DFS0447I NUMBER OF BUFFERS FOR VSAM Operator response: If the volume serial numbers are
SUBPOOL SIZE nnnnn CHANGED TO not specifically mentioned in the JCL or catalog, mount
mmm, POOL ID xxxx the volume specified in the second half of the message.
If the volume is described, continue mounting volumes
Explanation: The number of buffers specified for the that z/OS will accept until the volume the utility
VSAM subpool size nnnnn was either less than the requires is eventually mounted.
required minimum or was greater than 32767. If
multiple shared resource pools were requested, POOL Module: DFSUICP0
ID xxxx indicates the shared resource pool in error.
System action: mmm buffers were built in the subpool. DFS0450I DFSDDLE0 dbdname
STOPPED-LOGICAL ERROR
Programmer response: For an explanation of buffer DDNAME=ddname VSAM ERROR
pool specifications, see the IMS system definition CODE=nn
information.
Explanation: The module detected a read or write
Module: DFSDVBI0 error on the database definition name on the DDNAME
data set. This message indicates VSAM returned (in
DFS0448I VSAM HIPERSPACE BUFFERING register 15) a return code of 8 to a VSAM PUT from
INVALID|UNAVAIL|FAILED FOR module DFSDDLE0. A logical error code from the RPL
SUBPOOL SIZE nnnnn, POOL ID xxxx is also printed to further define the logical error.
(master terminal) : Contact the appropriate support System action: If the error occurs on a dual WADS or
personnel responsible for the recovery of the database. dual Next, OLDS processing continues using the
alternate data set. Otherwise, the Log Recovery utility
System programmer response: For both messages, if it terminates processing.
is a permanent READ error or WRITE error, recover the
database. However, if only WRITE errors occur, the Programmer response: If the Log Recovery utility
database might continue to be used by the online fails, ensure that a DD statement is present and
system, and recovery can be delayed until a convenient specified correctly. If a hardware failure is indicated,
time. If application performance is affected or READ rerun the job specifying an alternate unit.
errors occur, the database must be recovered.
Module: DFSULG10, DFSULG20
Problem determination: 1, 2, 3, 5, 8, 11, 17a, 17d, 17g,
20, 35
DFS0454I UNSUCCESSFUL ALTERNATE LOG
Module: DFSDBH40, DFSDDLE0, DFSDVSM0 DATASET POSITION---REASON x
Related reference: Explanation: Dual input logs were specified for the
Log Recovery utility. An error was detected while
RPLERRCD Reason Codes
reading one of the input logs.
Related information:
The value of the reason code x is 2 or 3.
“DFS0762I” on page 197
Chapter 2, “IMS problem determination,” on page 5 Code (hex)
Meaning
02 Dual SLDS input was provided. The two
DFS0452I DUP-CLOSE NO LONGER SLDSs did not start with the same block of
SUPPORTED -- USE DUP AND REP data. DFSULG20 processing has terminated for
THEN RERUN CLS MODE both input logs, but the block of data common
to both logs was not successfully read.
or 03 Dual input logs were provided. DFSULG10
tried to read the first block from each log to
CONTROL CARD INPUT NOT PRESENT determine if the input was valid. For OLDS,
the first pair of blocks must be readable and
or identical. For SLDS, the first pair of blocks
must be readable. If the SLDS blocks are not
ERROR IN CONTROL CARD FORMAT identical, the higher log sequence number (for
the first log record) is saved. Processing of that
Explanation: Either control statement input was
input log (and its corresponding output log) is
missing or a control statement was in error. The
suspended until the higher log sequence
erroneous control statement is printed on the
number is found on the other remaining input
SYSPRINT data set.
log.
Programmer response: Resubmit the job with a
System action: The Log Recovery utility terminates
control statement or a corrected control statement.
processing with a memory dump.
Module: DFSULG10
Programmer response: For reason code 02, examine
the error block listing and the input logs. Try to
determine why the matching block was not read. (The
matching block is either an error block or is missing on
the input log.) If the block is in error, correct the block
using z/OS system utilities. If the block is missing,
DFS0455I I/O ERROR ON xxx DURING mmm System action: The Log Recovery utility terminates
OPERATION processing.
Explanation: The Log Recovery utility, DFSULTR0, Programmer response: Take the following actions:
encountered an I/O error on data set xxx while v Check the printed output from the previous DUP run
processing in mode mmm. The value of mmm is CLS, to ensure that the B records were produced.
DUP, or REP. xxx consists of a descriptive name of the v Ensure that the appropriate interim log data set was
data set plus the ddname. used.
System action: The Log Recovery utility terminates Explanation: The offset plus the length of the data
processing. specified by the REP statement falls outside of the
indicated block.
Programmer response: Do the following:
1. Verify that the control statements agree with the System action: The Log Recovery utility terminates
printed output produced in the DUP mode run. processing.
2. Correct and resubmit the job. Programmer response: Examine the printed output
3. Ensure that the appropriate interim log data set was from the previous DUP run to determine the proper
used. offset and length. Correct the control statement, and
Module: DFSULG10 rerun the job.
Module: DFSULG10
during the repositioning process. Each form of the System action: IMS ignores the abend and switches to
message indicates a specific repositioning error. IMS the next available spool data set.
issues the first form of the message when an
Programmer response: Ensure that there is a spool
IMODULE GETMAIN call to obtain a temporary
data set available. If there is no spool data set available,
Read/Write buffer fails. The return codes from the call
schedule the spool print utility to unload the spool data
indicate the following conditions:
sets. Additionally, in an XRF environment, consider
Codes issuing a takeover and allocating new spool data sets.
Explanation As long as there is no spool data set available, IMS
queues all messages destined to the spool LTERM to
4 Storage not allocated
the message queue. This problem can lead to an abend
8 Parameter error 0758.
Operator response: Enter a SET CLOCK command System action: Processing is halted.
with the correct clock setting or local time value.
User response: Correct the data set referenced by the
The system continues to process transactions, but the SYSIN DD card.
stored time stamps are not convertible to the current
Module: DFSURGU0
local time. Correcting the clock to a valid local time
eliminates the cause of this message and removes the
highlighted messages from the screen. DFS0484A THE FOLLOWING DATASETS FOR
DATA BASE dbdname ARE NOT
If entering the correct local time value does not correct
REGISTERED TO DBRC: ddname1 . . . .
the problem, the TOD clock must contain an invalid
ddnamen
UTC value. An IPL might be required to set a correct
UTC value in the TOD clock. Explanation: DL/I open processing for database
dbdname failed because the open data sets listed are not
Module: DFSTIME0
registered in the RECON data set, although the
database is registered.
DFS0479A ISSUE UNQUALIFIED GN FAILED =
System action: Message DFS0730I with reason code
xx
I,35 is issued. See System Action for message DFS0730I.
Explanation: xx indicates the DL/I status code for the
Programmer response: Use the DBRC INIT.DBDS
error.
command to register the data sets in the RECON data
System action: Processing stops. set so that the necessary recovery-related information is
recorded during execution.
Programmer response: Correct the JCL error indicated
by the DL/I status code. See the DL/I status codes Problem determination: 1, 6
information.
Module: DFSDDUI0
Module: DFSMAID0 Related information:
Related reference: “DFS0730I” on page 181
DL/I status codes (Messages and Codes) Chapter 2, “IMS problem determination,” on page 5
DFS0481A CANNOT ALLOCATE STORAGE DFS0485W RECOVERY DATA FOR [DATA BASE
-GETMAIN dbdname|AREA areaname] MISSING
FROM THE RECON DATASET
Explanation: An error occurred while trying to obtain
storage. Explanation: Recovery information for database
dbdname or area areaname might be missing from the
System action: Processing stops. Storage is not RECON data set. The database or area is being opened
allocated. for update with DBRC so that log data sets generated
System programmer response: Increase the region size during the execution are recorded in the RECON data
in the startup JCL. set. In a previous run when update ACCESS to the
database or area was allowed, DBRC was not used.
Module: DFSMAID0 Therefore, unless explicit action was taken, the RECON
data set contains no record of log data sets from
DFS0482A PARTITION SIZE SELECTION TOO previous executions necessary to generate valid
SMALL recovery JCL.
Explanation: The selection size for a HALDB partition If the log data sets from the previous executions were
was too small. explicitly added to RECON, then this message confirms
that the RECON is again being used to record recovery
System action: Processing stops. information. If an image copy was recorded in RECON
since the last update of the database or area that did
System programmer response: Increase the size for
not use DBRC, and if the log data sets from the
the HALDB partition selection.
previous executions were not recorded in RECON, then
Module: DFSMAID0 this message indicates that recovery from image copies
before the updates without DBRC are invalid.
DFS0483A HD UNLOAD ENCOUNTERED AN System action: Execution continues. The DBRC usage
ERROR OPENING THE SYSIN indicator (DUI) in the database is updated with the
DATASET identification of the RECON data sets that currently
record recovery information.
Explanation: The data set described by the SYSIN DD
card was not able to be opened.
DBR | DBD | STA | STO COMMAND Module DFSMDA00 can also issue return code
COMPLETED. KEYWORD ALL 4 if dynamic allocation or deallocation failed.
This code indicates an interface problem
Explanation: The /DBRECOVERY, /DBDUMP,
between another IMS module and the IMS
/START, or /STOP command processing is completed.
dynamic allocation module, DFSMDA00. This
A zero return code indicates that the named database
code can also indicate a missing or bad
has been successfully processed. The ADS specification
DFSMDA00 member.
is effective only for the /STOP command. The area is
only for the /DBRECOVERY, /START, and /STOP For a /VUNLOAD command, the area
commands. A nonzero return code indicates that an specified was not found in any data space or
unexpected error was encountered while processing. coupling facility structure. Verify that the area
name is correct. Issue a /DISPLAY
If the data group contains both full function and Fast
FPVIRTUAL command to find which areas are
Path databases, you might see a command complete
in data spaces or coupling facility structures.
message before seeing any messages indicating Fast
Path areas did not start successfully. For the second form of the message, this
return code indicates that the /UNLOCK
The /VUNLOAD command completed processing for
SYSTEM command was only partially
area xxxxxxxx. DFS0488I is only issued for areas for
successful. At least one tolerated block or CI
which the /VUNLOAD command failed, along with
could not be purged. Enter the /UNLOCK
the reason code. The reason code indicates the result of
SYSTEM command again later.
the command. A final DFS0488I message is issued to
indicate that the command is completed. Return code 04 can also mean that the
database is authorized only if the requested
For the second form of the message, the return code nn
state is "READ" or "READ-GO" because of a
can have the value 00, 04, or 20.
global /DBD command.
The third and fourth forms of the message are issued to 05 The database is marked as needing an image
avoid excessive individual messages for successful copy.
operations. 06 The database is marked as needing recovery.
07 The database is marked as needing backout.
When the keyword ALL is specified, one DFS0488I is 08 Dynamic allocation failed (from DFSMDA00).
issued for every database name, area name, or ADS This code indicates that the IMS dynamic
name in error, followed by a final DFS0488I allocation module (DFSMDA00) received a
DBR|DBD|STA|STO|VUN COMMAND COMPLETED message. nonzero return code from MVS dynamic
DFS0488I is not issued for each database name, area allocation.
name, or ADS name with return code of 00 (RC=00
indicates that the command was successful). For a /VUNLOAD, /STOP AREA GLOBAL,
/DBRECOVERY AREA GLOBAL, or /STOP
This message is only received for the LOCK command ADS command, an attempt to get the
that is issued from an OM API. VUNLOAD lock for an area in a coupling
Return code (Dec) facility structure failed. The /VUNLOAD,
Meaning /STOP AREA GLOBAL, /DBRECOVERY
01 The requested state and the current AREA GLOBAL, or /STOP ADS command is
authorization state (see the RECON data set) terminated. The VUNLOAD, STOP, or DBR
are incompatible. The database is authorized processing is not done.
by another active or abnormally terminated 09 During authorization change processing, IRLM
IMS subsystem, and its authorization state is could not identify one or more subsystems.
incompatible with the current authorization You might have IRLM=N or another IRLM
request. name specified on the subsystem.
02 The global command was not able to 11 An invalid parameter was found during the
synchronize with all data sharing partners. evaluation process for database-usage
The command was completed on the compatibility. The database record in the
subsystem that received this message, but the RECON data set might be invalid.
partners must be interrogated to determine if 12 Dynamic allocation or deallocation failed
the command completed successfully. because no storage was available from
03 The database is marked as prohibiting further DFSMDA00.
authorization for one of the following reasons; Return code 12 can also mean that the current
a global /DBRRECOVERY, a global /STO, or a authorization state in DBRC is invalid because
DBRC CHANGE.DB(NOAUTH) command. of an unauthorization error.
04 An error occurred at the close of the database. 14 The named database cannot be started because
For detailed information about the reason of one of the following possible conditions:
codes, refer to message DFS730I.
v DBRC has already authorized other READ control block (DMAC) on DASD and the
access users in the other IMS subsystem to DMAC in storage. The area is marked as
access the database. The granted STOPPED.
authorization level for the other subsystem Issue a /START AREA command to correct
is incompatible with the original the inconsistency.
authorization level for the current v During /VUNLOAD, or a /START AREA
subsystem because of the last /DBDUMP command processing, an IMS sharing
command issued. As a consequence, the partner noted an inconsistency in VSO
original authorization level cannot be options between the DMAC on DASD and
restored for the current subsystem. the DMAC in storage. The AREA is stopped.
v The changed database authorization level Issue a /START AREA command to correct
has been requested through the /STA DB the inconsistency.
ACCESS command. The request for the v During /START AREA command
change in the ACCESS parameter failed processing, an IXLFORCE command is
because the database was incompatible with issued to delete any failed persistent
the authorization level currently held in the connections from a prior failed system. The
other IMS subsystem. IXLFORCE command was not able to delete
the failed persistent connection. In this case,
Return code 14 can also mean that an error the following messages are generated:
occurred in DBRC while trying to process a – DFS2783A UNABLE TO DELETE
change authorization request. FAILED-PERSISTENT CONNECTION TO
15 The duplicate AREA entry on the STR: SSSSSSSSSSSSSSSS
/DBRECOVERY AREA command is ignored. REASON=RRRR
The area was already unauthorized by DBRC. – DFS0488I STA COMMAND
16 Dynamic allocation or deallocation failed COMPLETED. AREA= XXXXXXXX
because of a system error. For detailed RC=21
information about the reason codes, refer to 24 A command with the ALL keyword is not
message DFS2498I. processed for a Fast Path MSDB. If /START
20 For the /UNLOCK SYSTEM command, one of DB ALL access is entered, module DFSDBDR0
the following conditions occurred: does not include MSDBs.
v There were no EEQEs to purge. 28 The named database cannot be started because
v The /UNLOCK command was entered on of the following conditions:
an IMS system that is not XRF-capable. v The request to change the database
v The /UNLOCK command was entered on authorization level to a data entry database
an active system that was not a previous (DEDB) has been requested through the
alternate system. This command must be /START DB ACCESS command. The change
entered only on the alternate system. of an authorization level to a DEDB cannot
v The /UNLOCK command was entered on be done because the referenced DEDB is in
the alternate system before the alternate use by a region.
system completed the XRF takeover. This v Changing the DEDB access intent requires
command must be entered on the alternate stopping the scheduling of all PSBs that
system only after one or more of the have access to the target DEDB. This code
following events have occurred: might require stopping regions in which
– The failing active system has terminated PSBs associated with WFI transactions are
– The processor containing the failing currently scheduled, and stopping the
active system has been reset transactions or PSBs for non-WFI
– I/O prevention on the active system is transactions.
complete 31 A /START AREA command failed because the
21 One of the following occurred: area is marked as recovery-needed in the
v A VLOCK request cannot be granted when DBRC RECON data set, or the DBRC RECON
processing a /START AREA, or a indicates that there are no available area data
/VUNLOAD AREA command. The area is sets for the area.
marked as STOPPED. One sharing IMS 34 Because a /START DB ACCESS command was
system is holding the retained VLOCK issued, a change database authorization
exclusive. request was made from IMS to DBRC. The
v While processing either a /VUNLOAD encoded database state returned from DBRC
AREA, or a /START AREA command, an was set to a value of zero.
IMS sharing partner noted an inconsistency 35 A backout error occurred for the database. A
in the VSO options between the DEDB area /START command for the database is invalid
until a /DBRECOVERY command is issued
and batch backout is performed.
37 One of the following events occurred: the RSR tracker for a Fast Path DEDB. The
v A write error occurred for the database. The DEDB name is ignored and the remainder of
command issued is invalid until a the command is processed.
/DBRECOVERY command is issued. 52 A /DBRECOVERY or /START command was
v A request for a new dataspace was issued entered for a database that was in the process
during the open processing for a shared of being recalled from HSM. The command
VSO area. Refer to message DFS2444I, that process is not performed at this time. The
precedes message DFS0488I. /DBRECOVERY command must be entered
38 A /START DB command was not run because again after the database is recalled. The
the database was being extended during an /START command will be automatically
IMS XRF takeover, and I/O Prevention was performed after the recall is complete.
not yet complete. You cannot start the 53 A command that specifies a full-function DL/I
database until IMS knows that I/O Prevention database was entered on an RSR tracker that is
is complete. running with LSO=Y. Full-function databases
39 A /START DB command specifying are not available to LSO=Y tracker systems, so
ACCESS=RO or RD is invalid while the command could not be processed for the
incomplete, restartable back outs exist for the named database.
database. IMS must have update or exclusive 54 There is a discrepancy between the number of
access to the database to redo the incomplete ADS allocated by IMS and the number of ADS
back outs. The command is not processed for known to DBRC. Correct the discrepancy, then
the specified database. reissue the /DBRECOVERY or /STOP
41 The area is not loaded into the Coupling command to deallocate the data sets.
Facility. This code does not prevent access to 55 The command failed because the FF DB or FP
the area unless this code is preceded by area is currently being recovered.
message DFS2819A. 56 An error occurred while attempting to open
42 The named HALDB partition cannot be the named database or HALDB partition.
processed in response to a /START DB Check the System Console for message
command because of an error in the Partition DFS0730I to determine the reason for the
Structure Manager. Check the system console failure.
for related DFS0415W messages. 57 The named database is a HALDB master and
| 43 The named database cannot be processed in is invalid with the OPEN keyword. However,
| response to a /DBRECOVERY command a partition structure rebuild is attempted if
| because one or more in-doubt EEQEs exist for needed and if only one HALDB master was
| the database and the NODBR keyword was specified in the command. No rebuild is
| specified in the DFSVSMxx member of the attempted if more than one database name is
| IMS PROCLIB data set. listed in the command.
44 When the /STOP ADS command is entered, 58 The named HALDB partition cannot be
the ADS of the named ddname is already processed in response to a /DBDUMP,
stopped. This /STOP ADS command is /DBRECOVERY, /START, or /STOP
ignored. command. It is still in use by an active
| 45 A /DBR, /DBD, /STA, or /STO command was HALDB OLR. The command is not processed
| issued against the named database or HALDB for the HALDB partition named in the
| partition that is QUIESCED or has QUIESCE message. However, processing continues for
| in progress. Try the command again after the any other databases or HALDB partitions
| QUIESCE has been released. If the quiesce is specified in the command.
| in a held state, release it with an UPDATE DB 60 The command failed because the area has been
| STOP(QUIESCE) command. deleted by Online Change.
50 A /DBRECOVERY, /START, or /STOP 62 The named database failed directory
command was issued with AREAGROUP or initialization or the DBB or PSB pool space
DBGROUP, where the AREAGROUP contained was not large enough to accommodate the
a specified database or the DBGROUP blocks. Check the system console for messages
contained a specified area. The command is that reference this database.
not processed for databases in an 70 The named database or HALDB partition
AREAGROUP or areas in a DBGROUP. failed authorization. Check the system console
for messages that are related to the
On a system that is defined to support Fast
authorization failure.
Path, the keyword 'MSDB' was entered on a
71 OPEN keyword processing could not continue
/START, /STOP, or /DBRECOVERY
for the named HALDB partition because a
command. (MSDB is allowed on /DBDUMP.)
/DBRECOVERY command has been issued for
The keyword is ignored and the remainder of
the HALDB master. Start the HALDB master
the command is processed.
and then reissue the command to start the
51 A /DBRECOVERY command was entered on
HALDB partition. This situation can also occur | the quiesce by issuing a UPDATE AREA
if the partition has been deleted and a | STOP(QUIESCE) command and issue the
partition structure rebuild has occurred. You | command again.
can perform a partition structure rebuild by 83 For the /UNLOCK command, an internal start
issuing a /START DB haldbmst OPEN database (/STA ) command failed because of
command or UPD DB NAME(haldbmst) Common Service Area (CSA) shortage. Issue a
START(ACCESS) OPTION(OPEN) command, manual /STA DB command for each database
where haldbmst is the master of the partition, that has received message DFS0451I with the
or by issuing a qualified GU call for a key in text IEQE FOUND.
the key range of the partition. You can use the
System action: IMS continues processing.
LIST.RECON command to determine if the
partition exists or has been deleted. Problem determination: 6, 11
72 Partition DBM build failed for the named
HALDB partition. Check the System Console Module: DBFARD10, DBFARD40, DBFARDA0,
for DFS0415W messages to determine the DFSDBDR0, DFSRDSH0, DBFCVUN0
reason for the failure. Related information:
73 DMB build processing failed for the named Chapter 2, “IMS problem determination,” on page 5
database or HALDB partition. Check the
system console for DFS0561 or DFS0592I
messages to determine the reason for the DFS0489I DATA BASE database name IS
failure. CHANGED TO INQUIRY ONLY
74 DMB build processing failed for the named STATUS
database or HALDB partition because the data Explanation: The database identified in the message
management block pool (DMB pool) is too was changed to INQUIRY ONLY status because the
small to hold all the required data image copy needed flag is set in the DBRC RECON
management blocks. Change the appropriate data set. When an Online Image Copy utility is
parameter to make the pool larger and restart scheduled to copy the database, the database
the system. Message DFS0992I might also be authorization level must be changed to a read level in
issued. order to permit the online image copy to run. The
75 DMB build processing failed for the named Online Image Copy utility is requesting the read level
database or HALDB partition. IMS detected a authorization on behalf of the IMS subsystem.
DMB pool shortage while attempting to load
the DMB block for the named database or System action: IMS processing continues with the
HALDB partition. The size of the DMB pool online image copy. However, the database is marked
must be large enough to accommodate all for use as inquiry only.
DMBs that are actively being used. Change the Operator response: If an update or exclusive
appropriate parameter to make the pool larger authorization level is required for the online IMS
and restart the system. subsystem, enter a /START DB or UPDATE DB
76 DMB build processing failed for the named START(ACCESS) command after the completion of the
database or HALDB partition. Check the Online Image Copy utility.
System Console for DFS0564I messages to
determine the reason for the failure. Problem determination: 4, 6
77 DMB build processing failed for the named
Module: DFSDBAU0
database or HALDB partition. An unexpected
return code was received. Check the system Related information:
console for any related messages and contact Chapter 2, “IMS problem determination,” on page 5
IBM Software Support.
79 The command was issued for a database that
DFS0490I HD UNLOAD OF PARTITIONED
is still being processed by Restart Parallel
DATA BASES IS NOT SUPPORTED
Database Open. Wait for that process to
FOR UCF
complete and try the command again.
80 The named DEDB database cannot be started Explanation: HD unload of HALDB is not supported
in a non-FP system. for the Utility Control Facility (UCF).
81 This message is generated because the user
issued a /VUN command for an area in a System action: Execution halts, and the return code is
database that was read authorized. The /VUN set to 16.
command must be entered on an IMS Module: DFSURGU0
subsystem that has update authorization for
the database.
| 82 A /DBR, /STO or /VUN area command was
| issued against an area that is quiesced. Stop
Module: DBFPCAA0
DFS0491A ERROR IN DFSCTL DATASET
Related information:
Explanation: A statement in the DFSCTL data set
“DFS0492I”
contained an error. Messages that follow this one
display the incorrect line and describe the error. This
message displays the affected region, when possible. DFS0496A PARTITION SELECTION FOR DATA
BASE DATASET FAILED
System action: The region is terminated.
Explanation: HDUNLOAD encountered an error from
Programmer response: Correct the line in error based
IMS Partition Selection while preparing to unload the
on the messages that follow.
database segments for a partition or range of partitions
Module: DBFPCAA0, DBFPHI00, DBFPHI10, belonging to the database specified on the job
DBFPHI20, DBFPHI30 parameter card.
System action: Processing halts with return code 16.
DFS0492I line in error
User response: Verify that the database input on the
Explanation: This message displays the incorrect line job parameter card is correct. If you specified a range
in the DFSCTL data set. At least one more message of partitions in the SYSIN using NUMBER= (for
follows this one to provide additional information. This example, PARTITION=PART2,NUMBER=5) then you
message displays the affected region, when possible. might need to correct the range value or correct
RECON by defining additional partitions. Consult your
System action: The region is terminated.
partition selection exit routine to identify partition
Programmer response: Correct the error based on the names within the scope of the range.
information in this message and the next messages.
If partitions are missing, define them using the
Module: DBFPCAA0, DBFPHI00, DBFPHI10, Partition Definition utility TSO panels and resubmit the
DBFPHI20, DBFPHI30 job.
Module: DFSURGU0
DFS0493I INVALID CHARACTERS IN
DATABASE NAME
DFS0497I INVALID CHARACTERS IN PCB
Explanation: The database name in the statement LABEL
shown in message DFS0492I contained invalid
Explanation: The PCB label in the statement shown in
characters.
message DFS0492I contained invalid characters.
System action: The region is terminated.
System action: The region is terminated.
Programmer response: Correct the line in error.
Programmer response: Correct the line in error.
Module: DBFPCAA0
Module: DBFPCAA0
Related information:
Related information:
“DFS0492I”
“DFS0492I”
Programmer response: Correct the line in error. System action: The region is terminated.
DFS0501I IC OPTION SPECIFIED FOR NON DFS0505I MULTIPLE PCB LABELS GIVEN
PROCOPT H PCB x. RGN n
Explanation: The statement shown in message
Explanation: PCB x specified the image copy (IC) DFS0492I contained two PCB= keywords.
option, but not processing option H (PROCOPT=H). The IC
System action: The region is terminated.
option is only valid for PROCOPT H PCBs.
Programmer response: Correct the line in error.
System action: The region is terminated.
Module: DBFPCAA0
Programmer response: Either remove the IC option
for this PCB, or specify PROCOPT H and rerun Related information:
PSBGEN. “DFS0492I” on page 121
Module: DBFCPY00
DFS0506I SUBSET POINTER IS NOT VALID FOR
SENSEG segmentname IN PCB dbdname
DFS0502I MULTIPLE DATABASE NAMES
IN PSB psbname
GIVEN
Explanation: The SSPTR subset pointer is specified in
Explanation: The statement shown in message
the SENSEG statement but not defined in the
DFS0492I contained two DATABASE= (or DB=)
corresponding SEGM statement. In the message text:
keywords.
segmentname
System action: The region is terminated. The SENSEG that contains the invalid subset
pointer.
Programmer response: Correct the line in error.
dbdname
Module: DBFPCAA0 The SEGM segmentname of the DBD that does
Related information: not have the SSPTR subset pointer defined.
psbname
“DFS0492I” on page 121 The PSB that contains the invalid statement.
System action: Processing continues.
DFS0503I DATABASE x NOT FOUND IN
SYSTEM. RGN n Programmer response: Take one of the following
actions:
Explanation: In the statement shown in message v If the application program does not use a subset
DFS0492I, the DATABASE= (or DB=) keyword specified pointer, ignore this message.
a database that does not exist. v Remove the SSPTR subset pointer from the SENSEG
System action: The region is terminated. statement in the PSB. Then rerun the PSBGEN, then
rerun the ACB utility with a BUILD statement for the
Programmer response: Correct the line in error. PSB.
Module: DBFPHI00 v Add the SSPTR subset pointer in the SEGM
statement in the DBD. Then rerun the DBDGEN,
Related information:
then rerun the ACB utility with a BUILD statement
“DFS0492I” on page 121 for the PSB.
Module: DBFUDLB0
DFS0504A NO PCB FOUND WITH LABEL x FOR
DATA BASE y. RGN n
DFS0507I PRIMARY MASTER LOGICAL
Explanation: No PCB was found with label x for TERMINAL IS NOT DEFINED
database y.
Explanation: IMS initialization detected that the
System action: The region is terminated. primary master logical terminal (PMTO) was not
Programmer response: Correct the line in error. defined in the system.
System action: The utility ends with a return code of Programmer response: Correct the line in error.
08.
Module: DBFPHI10, DBFPHI20
System programmer response: Examine a list history Related information:
for the partition DBDS being copied to determine the
“DFS0492I” on page 121
cause.
Module: DFSUICP0
DFS0515I INVALID AREA NAME LENGTH. RGN
n
DFS0511I DUPLICATE OPTIONS FOR DB=x
Explanation: The length of an area name in the
AREA=y. RGN n
statement shown in message DFS0492I was invalid.
Explanation: The area was specified twice, either Area names must be from 1 to 8 characters in length.
implicitly or explicitly, in the SETO statement shown in
System action: The region is terminated.
message DFS0492I.
Programmer response: Correct the line in error.
System action: The region is terminated.
Module: DBFPHI30
Programmer response: Correct the line in error.
Related information:
Module: DBFPHI10
“DFS0492I” on page 121
Related information:
“DFS0492I” on page 121
DFS0516I INVALID CHARACTERS IN AREA
NAME. RGN n
DFS0512I UNRECOGNIZED KEYWORD. RGN n
Explanation: An area name in the statement shown in
Explanation: The SETO statement shown in message message DFS0492I contained invalid characters.
DFS0492I contained an invalid keyword.
System action: The region is terminated.
System action: The region is terminated.
Programmer response: Correct the line in error.
Programmer response: Correct the line in error.
Module: DBFPHI30
Module: DBFPHI10, DBFPHI20 Related information:
Related information: “DFS0492I” on page 121
“DFS0492I” on page 121
DFS0517I AREA x NOT FOUND IN DATA BASE DFS0521I UNMATCHING PARENTHESIS. RGN n
y. RGN n
Explanation: The statement shown in message
Explanation: Area x was not defined in database y. DFS0492I contained more open parentheses than
closing parentheses.
System action: The region is terminated.
System action: The region is terminated.
Programmer response: Correct the line in error.
Programmer response: Correct the line in error.
Module: DBFPHI30
Module: DBFPHI10, DBFPHI20
DFS0518I INVALID DASH SEPARATOR. RGN n Related information:
“DFS0492I” on page 121
Explanation: In the statement shown in message
DFS0492I, a dash separated 3 or more area names (for
example, IC=(A1-A2-A3)). DFS0522I AREA x SPECIFIED TWICE IN AREA
LISTS. RGN n
System action: The region is terminated.
Explanation: The area list in the SETR statement
Programmer response: Correct the line in error.
shown in message DFS0492I contained the area name
Module: DBFPHI10, DBFPHI20 twice.
Related information: System action: The region is terminated.
“DFS0492I” on page 121
Programmer response: Correct the line in error.
Module: DBFPHI20
DFS0519I AREAS x AND y ARE IN THE WRONG
ORDER. RGN n Related information:
“DFS0492I” on page 121
Explanation: In the statement shown in message
DFS0492I, areas x and y, which are the starting and
ending points for an area range, were in the wrong DFS0523I UNRECOGNIZED TEXT AT END OF
order. Areas must be specified in DBDGEN order. AREA LIST. RGN n
System action: The region is terminated. Explanation: The text at the end of the area list for an
IC= keyword was invalid. Only 1ABEND, 2ABEND, or
Programmer response: Correct the line in error.
CONTINUE (and their synonyms) are valid for the end
Module: DBFPHI10, DBFPHI20 of the area list.
Related information: System action: The region is terminated.
“DFS0492I” on page 121
Programmer response: Correct the line in error.
Module: DBFPHI10
DFS0520I TERMINATION ITASK WAITS DUE
TO LONG BUSY FAST PATH ADS
AREA=areaname DDN=ddname DFS524I DFSZDI00-GSAM INIT.
AUTHORIZATION DENIED
Explanation: During shutdown processing, IMS
determined that one or more Fast Path ADSs is under a Explanation: The IMSAUTH macro returned a
Long Busy condition. The Long Busy Recovery must nonzero code indicating that module DFSZDI40 is not
finish before shutdown processing continues. in the authorized library.
In the message text: System action: The region is terminated with abend
areaname 0657 and a memory dump.
The name of the area to which the long busy
Operator response: Rerun the job. If the situation
ADS belongs.
persists, contact your IMS system programmer.
ddname The data description name of the long busy
ADS that is registered in the RECON data set. Programmer response: Verify the status of the IMS
libraries.
System action: The termination ITASK is posted after
the Fast Path Long Busy ADSs complete recovery. IMS Module: DFSZDI40
shutdown processing continues. Related information:
Programmer response: No action is required.
IMS abend 0657
Module: DBFTERM0
DFS0525A A PROCOPT H PCB WAS SPECIFIED DFS0528I PSTOP/STOP CMD FOR RGN nnnn
TO AN xxx REGION. PCB x IN PSB y. WAITING IN QSN EXIT. CODE = x
RGN n
Explanation: The dependent region was placed in a
Explanation: PCB x in PSB y specified processing wait state by DFSQSPC0, the IBM IMS Queue Control
option H, but the region is an IFP, MPP, Facility for z/OS version of the Queue Space
message-driven BMP, WFI BMP, or CCTL thread. In Notification Exit. The wait state occurred based on IMS
addition, the JCL for this region contains some SETO queue usage, which exceeded the user or default limits.
statements in the //DFSCTL data set. Programs using While the dependent region was in a wait state, a
HSSP (PROCOPT=H) can only run in a BMP region. /STOP or /PSTOP command was entered against the
region. To terminate an application program or region
System action: For an IFP, MPP, message-driven BMP,
in this state, use one of the following methods:
or WFI BMP, the region is terminated with abend 1060.
v Use the QCF TSO/ISPF interface.
For a DBCTL thread, the 1060 abend code is returned
v Enter a /STOP REGION x ABDUMP tranname
to the CCTL to indicate a schedule failure.
command to terminate the application program, and
Programmer response: An IFP, MPP, message-driven then enter a /STOP REGION x command to
BMP, WFI BMP, or DBCTL thread cannot schedule a terminate the region.
PSB containing a PCB using processing option H.
Correct the processing option. In the message text:
nnnn The dependent region that was placed in a
Module: DBFCPY00
wait state.
Related information: x The reason code, which can be one of the
following:
IMS abend 1060
1 Indicates that the dependent region
terminates with abend 0408. This
DFS0526A AN INCONSISTENCY EXISTS abend is normal if a /STOP REGION
BETWEEN THE PSB AND THE DEDB'S x ABDUMP tranname command was
DBD. PCB x IN PSB y. RGN n issued.
2 Indicates that the region is no longer
Explanation: The DBD was changed in the DBDLIB waiting in the queue space
and was used for an ACBGEN to build a PSB. A notification exit, or it was not
warning message was issued during ACBGEN that the recognized in that state when the
DBD was not replaced in the ACBLIB. command was issued.
System action: Abend code 1013 is returned to the 3 Indicates a failure to acquire space to
CCTL to indicate a schedule request failure. process a /STOP or /PSTOP
command (DFSSTOP). This error
Programmer response: Rerun the ACBGEN utility to should not occur.
correct the inconsistency between the PSB and the
DBD. System action: None.
or
DFS0530I DFSZDC00 I/O ERROR
DBDNAME=dbdname DDNAME=ddname REASON CODE=08 AREA=areaname REGID=regid
GBCRTNCD=xxxx AREA DOES NOT HAVE REUSE ATTRIBUTE
Explanation: The GSAM controller has detected an
error writing out buffers during a purge or checkpoint or
operation.
REASON CODE=09 AREA=areaname REGID=regid
xxxx is the 2-byte field GBCRTNCD in hexadecimal. See HSSP IC ALREADY IN PROCESS
GB DSECT for definition of the GBCRTNCD field bits.
System action: GSAM terminates with abend 0271. or
Programmer response: Use a data recovery procedure
REASON CODE=10 AREA=areaname REGID=regid
to reconstruct the data set in error.
DUPLICATE DDNAME FOUND DD=ddname
Module: DFSZDC00 DSN=dsname
Related information:
or
IMS abend 0271
REASON CODE=11 AREA=areaname REGID=regid
SPACE FOR IDSC(S) UNAVAILABLE DD=ddname
DFS0531I IMAGE COPY DATASET OPEN
DSN=dsname
FAILED
or
or
or
or
or
or
or
or
HSSP Image Copy processing can terminate when an 14 Rerun the job when the common service area
IDS open failure occurs for one of these reason codes: (CSA/ECSA) usage is low.
01, 10, 11, 13, 17, 20, 31. Whether the image copy 15 Sequential access method OPEN displays a return
process terminates depends on which image copy code in sequential access method messages.
options you specified.
16 Rerun the job when the common service area
For reason code 19, the HSSP/IC job fails with a user (CSA/ECSA) usage is low.
abend 1062.
Codes
For all IDS open failure reason codes, HSSP processing Explanation
can continue with or without image copy, or might
terminate, depending on which HSSP Image Copy 17 If a DD statement is specified, make sure that the
options you specified. Valid options are CONTINUE, ddname is correct. If the DD statement is missing,
1ABEND, 2ABEND and IC=0,1,2. specify a DD statement. If dynamic allocation
failed, take the action suggested in message
Programmer response: Take the appropriate action DFS2502W or DFS2503W. Then rerun the job.
based on the reason code you received.
Codes
Codes Explanation
Action
18 The user determines the action. (A possible action
01 Check the appropriate VSAM catalog or JCL DD is to rerun the job after the EEQEs owned by the
statements to determine if a disk device is sharing system have been purged for this area.)
specified for the named IDS. If dynamic allocation
occurred, check the dynamic allocation parameter Codes
list to find the device type specified for the named Explanation
IDS. If a device other than a disk was specified, 19 HSSP Image Copy (HSSP/IC) has been requested
change the device type to the disk device; then for a nonrecoverable DEDB. Fuzzy image copies
rerun the job. are not permitted for nonrecoverable DEDBs.
02 Rerun the program as soon as the conflict is Take one of the following actions:
resolved. Create a valid image copy. v Remove the nonrecoverable DEDB area from the
03 Add the missing resource description to DBRC and HSSP/IC specification.
rerun the program. v Run the Image Copy utility or Image Copy 2
utility to produce a non-fuzzy image copy.
or
DFS0533I AREA=areaname, DD=ddname,
IMAGE COPY PROCESS (STARTED|TERMINATED) DSN=dsname REGID=regid IDS
FOR AREA=areaname REGID=regid, RC=((0|4)|8.) CONNECT ERROR
DSN1=dsname1 Explanation: Module DBFMMIT0 was unable to open
(connect) the image copy data set (IDS) associated with
or the identified ddname. This message follows VSAM
message IEC161I.
IMAGE COPY PROCESS (STARTED|TERMINATED)
FOR AREA=areaname REGID=regid, RC=((0|4)|8.) HSSP Image Copy setup then tries to open another IDS.
DSN1=dsname1 | DSN2=dsname2 If the next IDS is not defined or available, HSSP Image
Copy processing terminates for the area and region
identified in message DFS0531I. Depending on the user
or
IC specifications, (CONTINUE, 1ABEND, 2ABEND and
IC=0,1,2), HSSP Image Copy processing and HSSP
IMAGE COPY STARTED FOR AREA=areaname
processing continues or terminates. Message DFS0532I
Explanation: The HSSP Image Copy set up finished, tells which action was taken. Both messages DFS0531I
and Image Copy either started, terminated, or failed. and DFS0532I follow this message.
The return codes, explained below, indicate which System action: HSSP Image Copy processing and
action was taken. HSSP processing can continue or terminate.
DFS0535A xxxx DISC PROCESS ATTEMPTED Explanation: A process was attempted but could not
AREA a complete for the reason listed in the message.
v RGN=r, xxxx CONN PROCESS ATTEMPTED AREA a, PCB
or LABEL z
Process xxxx was not started. Process xxxx can be:
RGN=r, xxxx CONN PROCESS ATTEMPTED AREA HSRE High Speed Reorganization utility
a, PCB LABEL z HSSP High Speed Sequential Processing
Explanation: See the information for DFS0535I. for a PREL VSO preload process
detailed explanation and actions.
Region r identifies the affected region.
Related information:
v xxxx DISC PROCESS ATTEMPTED AREA a
DFS0535I
Process xxxx could not disconnect. Process xxxx can
be:
DFS0535I RC=01, yyyy ALREADY RUNNING HSRE High Speed Reorganization utility
HSSP High Speed Sequential Processing
or PREL VSO preload process
v RC=01, yyyy ALREADY RUNNING
RC=03, AREA LOCK FAILED
Process yyyy is active on the area or has not
disconnected from the area. Process yyyy can be:
or
HSRE High Speed Reorganization utility
HSSP High Speed Sequential Processing
RC=04, AREA IS STOPPED MDLO DEDB Sequential Dependent Delete utility
MMHO
or DEDB area data set Compare utility
MRIO DEDB area data set Create utility
RC=05, AREA FAILED TO OPEN MSCO DEDB Sequential Dependent Scan utility
PREL VSO preload process
or v RC=03, AREA LOCK FAILED
Process xxxx failed to acquire the area lock for the
RC=06, 2ND CI UPDATE AND/OR NOTIFY FAILED
area.
or v RC=04, AREA IS STOPPED
Process xxxx cannot run on a stopped area.
RC=07, UOW LOCK MODE INITIATION FAILED v RC=05, AREA FAILED TO OPEN
The attempt to open area a failed.
or
v RC=06, 2ND CI UPDATE AND/OR NOTIFY FAILED
RC=08, INSUFFICIENT STORAGE FOR AREA Process xxxx failed because the IRLM notify failed or
PRIVATE BUFFER POOL. STORAGE there was an error in the second CI update.
REQUESTED=nnnnnnnK. STR MGR RC=xxx v RC=07, UOW LOCK MODE INITIATION FAILED
The transition to UOW locking mode was
or unsuccessful. A probable cause is a failure in the
notify process to a sharing subsystem.
RC=09, PRIVATE BUFFER POOL ALREADY EXISTS
sysid
v RC=08, INSUFFICIENT STORAGE FOR AREA PRIVATE v RC=06, 2ND CI UPDATE AND/OR NOTIFY FAILED
BUFFER POOL. STORAGE REQUESTED=nnnnnnnK. STR MGR See accompanying messages for more information.
RC=xxx. v RC=07, UOW LOCK MODE INITIATION FAILED
Unable to create private buffer pool; sufficient Correct the failing component and rerun.
storage was not available. In the message, nnnnnnn is v RC=08, INSUFFICIENT STORAGE FOR AREA PRIVATE
the number of 1014 bytes of storage requested, and BUFFER POOL
xxx is the return code set by the IMS storage
Run process xxxx again when storage is available.
manager.
v RC=09, PRIVATE BUFFER POOL ALREADY EXIST sysid
v RC=09, PRIVATE BUFFER POOL ALREADY EXISTS sysid
This indicates a logic error in the software. Run
Process xxxx requested the creation of the area process xxxx again. If the error still occurs, contact
private buffer pool but the buffer pool exists already. IBM Software Support.
v RC 10, COULD NOT GET AN AWE sysid v RC=10, COULD NOT GET AN AWE sysid
The request for an AWE control block failed to Run process xxxx again when storage is available.
process xxxx. v RC=11, INVALID REQUEST SENT TO DBFPAPB0 sysid
v RC 11, INVALID REQUEST SENT TO DBFPAPB0 sysid This indicates a logic error in the software. Run
An invoking module passed an invalid request code process xxxx again. If the error still occurs, contact
to DBFPAPB0. IBM Software Support.
| v RC=12, AREA IS IN A QUIESCE STATE sysid
| v RC=12, AREA IS IN A QUIESCE STATE sysid
| Stop the quiesce by issuing a UPDATE AREA
| The process cannot run on a quiesced area.
| STOP(QUIESCE) command, and rerun the named
System action: The action the system takes are listed | utility.
for the different forms of the message:
Programmer response: Ensure that no HSSP process
v RGN=r, xxxx CONN PROCESS ATTEMPTED AREA a, PCB
or utility is active in an area before restarting the HSSP
LABEL z
job.
Process xxxx terminates.
v xxxx DISC PROCESS ATTEMPTED AREA a Module: DBFPMSG0, DBFPSET0, DBFUHDR0
Process xxxx terminates without disconnecting.
| v RC=12, AREA IS IN A QUIESCE STATE sysid DFS536A LAST CONVERSATION MESSAGE
| The utility terminates. UNAVAILABLE - reason
System programmer response: The actions to take are Explanation: The /RELEASE command failed to
listed for the different forms of the message: retrieve the last output message for the IMS
v RGN=r, xxxx CONN PROCESS ATTEMPTED AREA a, PCB conversation for one of the following reasons indicated
LABEL z by reason in the message text:
STORAGE UNAVAILABLE
See the accompanying DFS0535I message.
RESTART RESYNC INCOMPLETE
v xxxx DISC PROCESS ATTEMPTED AREA a
QUEUE ERROR
See the accompanying DFS0535I message.
v RC=01, yyyy ALREADY RUNNING System action: The command is ignored.
Run the utility or process again when process yyyy Operator response: All of these errors are likely to be
has completed. This message can also be issued if a temporary. Reenter the command after a short wait for
previous process did not complete successfully; if so, the condition causing the failure to be resolved.
issue a /STOP and /START command pair for the
Module: DFSICLH0
area to allow the requested process to run. If this
message is received in a data sharing environment,
issue the /STOP and /START command pair on all DFS0537I AREA=areaname DD=ddname,
sharing subsystems. DSN=dsname CLOSED, IC FAILED
v RC=03, AREA LOCK FAILED
Determine the cause of the lock failure and correct or
the problem. If a disconnect did not complete
because of an area lock failure, a /STOP and /START AREA=areaname DD=ddname, DSN=dsname
command pair might be required to allow other OPEN|CLOSED
processes to run.
v RC=04, AREA IS STOPPED or
Issue a /START command to start the area.
v RC=05, AREA FAILED TO OPEN AREA=areaname DD=ddname, DSN=dsname CLS
See message DFS3702I to determine why the open RETRY FP TCB
failed. Explanation: HSSP Image Copy opened or closed the
image copy data set normally. a JBP application) was processed. The X'18'
records are located in the log.
If the data set is being closed after an error, you see the
*XRST CKPT NOT IN OLDS*
IC FAILED form of the message. CLS RETRY FP TCB
A BMP and JBP application requested an
indicates that the image copy is closed and failed.
XRST. The OLDS no longer contains the X'18'
System action: IMS continues processing. records of the last symbolic checkpoint.
*XRST LAST CKPT ID IS*
Programmer response: No action is required. A BMP requested XRST, specifying a
Module: DBFMPCL0, DBFICSQ0, DBFPICT0, checkpoint ID value. The specified value is not
DBFPIOS0 the same as the value recorded by IMS as the
last checkpoint of the BMP. The last checkpoint
ID recorded by IMS is displayed in the
DFS0538I I/O ERROR qsam_info message.
Explanation: The SYNADAF ACSMETH=QSAM
macro gathered information from QSAM. qsam_info The time and day displayed are the universal
contains a system message number that explains the coordinated time (UTC) at which the checkpoint was
content of the message. taken.
System action: IMS stops processing for the data set. System action: In the first two cases, processing
continues normally. In the last two cases, the action
Programmer response: Correct the error and reissue depends on whether the BMP job contains an
the command, as appropriate. IMSLOGR DD data set. If the data set is present, it is
Module: DBFICSQ0 used as the log input for the XRST. Otherwise, the BMP
is terminated with abend 0102.
The termination of the CCTL thread is caused by one of REASON=reason is displayed only if the abend reason
the following causes: code is available. The message can be issued during
v A CCTL application abend or pseudoabend Create Thread processing or by the dependent region
v A CCTL abend environment controller module (for example,
v A CCTL request for termination of its connection to DFSECP10). reason has the following forms:
DBCTL while its thread is still active For abend 0711
REASON=xxxxyyyy, where xxxx is the return
| SMB indicates that the transaction was stopped, and code from z/OS Recovery Resource
| the absence of SMB indicates that the transaction was Management Services (RRMS) or from z/OS
| not stopped. PSB indicates that the program was UNIX System Services, and yyyy is the abend
| stopped, and the absence of PSB indicates that the 0711 reason code.
| program was not stopped. LTERM or LUNAME is the For abend 0129
| name of the terminal. LUNAME is displayed in place REASON=xxxxyyyy, where xxxx is the SAF
| of LTERM when the originating terminal is LU6.2 or return code and yyyy is the RACF or
| OTMA, unless the LUNAME information is in equivalent return code.
| transition. If the LUNAME information is in transition, For abend 0128
| UNKNOWN is displayed. REASON=xxxxxxxx, where xxxxxxxx is the
return code from the APPC Associate service
For DBCTL/CCTL threads, this message displays the (ATBASOC).
recovery token. The first 8 bytes of this token are in For abend 0109
EBCDIC and are displayed as characters; the second 8 REASON=xxxxxxxx, where xxxxxxxx is the
bytes of the token are displayed in hexadecimal form. return code from the APPC/OTMA
However, if DBCTL detects a failure during scheduling synchronous shared queue.
of the PSB (for example, abends 0428, 0437, 0456, 0457, System action: This message might follow message
and 0458), the recovery token is displayed as zeros. DFS555I. If the transaction input message that caused
This signifies that recovery of an unscheduled PSB is the application program to terminate abnormally is
not needed. available, the first 79 bytes of the input message are
printed by message DFS555I. A transaction is
Except for DBCTL, if the user completion code is U428, considered “available” if the input message in process
the PSB name is blank because the PSB was not found. by the application is on the message queue. Exceptions
are:
If the user completion code is 0448, 0452, 0456, or 0458, v The application has not issued a GU call. Therefore,
the transaction code and the stopped SMB name are the message did not cause the abnormal termination.
blank. v An abnormal termination that could be rescheduled
occurred (for example, PI lockout) unless the
If the user completion code is 0464, SYS does not Non-Discardable Messages user exit (DFSNDMX0)
represent a system completion code, but rather the told IMS to discard the input message.
error return code from the reply SVC. These return v This message is preceded by the SUCCEEDED
codes are: version of message DFS550I.
Codes
Explanation The preceding exceptions allow the message to run
again.
001
Simulated region termination or reply recursion. If the application program terminated abnormally after
002 the last message was removed from the applicable
Address of the dependent region TCB is invalid. queue, the transaction is not available and only
message DFS554A is printed.
003
Dependent task is terminating (TCBFLGS1 is set). If during the initialization of a new message region the
004 IMS control region can determine that a previous
Dependent task is terminating (TCBFLGS5 is set). region was canceled, the job name and step name fields
of this message contain the words REGION CANCELED.
005 The region is the identity of the new dependent region.
Dependent task does not have an RCPARMS.
Operator response: (master terminal) Inform
006 appropriate personnel of the application program
PSTID does not match RCID. abend. See abends 0448, 0452, 0456, 0458. See message
DFS550I which might precede this message at the IMS
009
master terminal.
The dependent region was probably canceled by
z/OS.
Explanation: A /STOP REGION ABDUMP or a System action: The dependent region is terminated
/PSTOP REGION x TRAN y command was entered, abnormally.
but the transaction xxxxxxxx is not scheduled in the If you receive this message during an online change
region specified.
procedure, the online change is terminated. number of the database. The copy of the resident
PSB loaded at IMS initialization time can no longer
Programmer response: To regain use of the affected
be used.
block, perform ACBLIB online change (/MODIFY
PREPARE ACBLIB and /MODIFY COMMIT) or shut Programmer response: Correct either the PSB or the
down the system, correct the error condition, and system definition. For a DEDB Online utility, do either
restart the system. of the following actions:
1. Correct the database name in the second positional
You must complete the online change procedure by
operand of the PARM field on the EXEC control
issuing either a TERM OLC or a /MODIFY ABORT
statement, and resubmit the job.
command.
2. Redefine the named database as a DEDB, rerun
Module: DFSDBLR0, DFSXRBL0, DBFOLC01 ACBGEN the next time the IMS control region is
started, and resubmit the job.
DFS562I INVALID CORE SIZE REQUIRED FOR System action: A BMP region terminates with abend
{PSB psbname|DMB dmbname} 0458. A batch DBB region terminates with abend 0821.
If the message was issued during IMS initialization,
Explanation: The named block required more space execution continues, but the first data management
than was available in the PSB or data management block is marked as unusable.
pool. This situation indicates that the affected pool is
not large enough to accommodate the largest block. Programmer response: Correct the data management
block or the system definition.
System action: The dependent region is terminated
abnormally. Module: DFSDBLD0, DFSXRBL0
Programmer response: Check to see that the Explanation: Member yyyyyyyy from DDNAME
specification of lines and columns in the SIZE keyword xxxxxxxx data set was successfully read.
of the TYPE or TERMINAL macro used for IMS system System action: IMS continues processing.
definition for this device is correct. If it is correctly
specified, use the /TRACE command to obtain a Module: DFSXRPS0, DFSIILD0, DFSDFN10,
printout of the terminal input data received by IMS. DFSDFN20
Obtain a printout of the DIF and compare the buffer
addresses to determine if a hardware error occurred.
Problem determination: 3, 5, 16, 17, 23, 36
| System action: The ACBGEN utility is terminated. Explanation: For information, see message DFS0588I.
Related information:
| Programmer response: Correct the errors, and rerun
| the program. “DFS0588I”
| Module: DFSUACB0
DFS0588I CONTROL CARD SYNTAX ERROR-
{INVALID LABEL|OP CODE|BLK
DFS0586I {PSB psbname|DBD dbdname} TYPE|OPERAND|OPTION|FORMAT|
REQUESTED IN A {BUILD|DELETE CONTINUATION} <'symbol'>
OPERATION} {NOT FOUND IN
ACBLIB|IS A PSB}-REQUEST Explanation: A control statement syntax error was
IGNORED. detected. The remaining statements are scanned, but no
processing are attempted. The symbol enclosed in
Explanation: A build error is associated with the quotation marks is the symbol or delimiter which
indicated PSB or DBD that was requested in a build or caused the error. If FORMAT is indicated, the logical
delete operation. end of statement was reached before the statement was
v If the message is NOT FOUND IN ACBLIB, the PSB or complete. If CONTINUATION is indicated, an invalid
DBD does not exist in the ACBLIB data sets. continuation was detected.
v If the message is IS A PSB, the directory entry for Programmer response: Correct the control statement,
this member is a PSB. and rerun the program.
There is no first in, first out (FIFO) process for the ACB Module: DFSUACB0
Maintenance utility SYSIN input control statements. If
both the BUILD PSB= and BUILD DBD= parameters DFS0589I PROCESSING COMPLETED FOR PSB
are specified in the same application control block psbname. PCB=xxxxxx, PSB=xxxxxx,
(ACB) generation job SYSIN control statement, DBD= WORKAREA=xxxxxx, TOTAL
operands are passed to the block builder utility SIZE=xxxxxx
program first. Message DFS0586I is issued if the DBD is
not already in the ACBLIB data sets, regardless of Explanation: The blocks for the indicated PSB were
where DBD= operands are specified in the SYSIN successfully built and written to ACBLIB. The required
control statements. buffer sizes for inter-region copy are indicated. See the
description of the DIRCA parameter of the IMSBATCH
System action: This request is ignored. Processing procedure, in Parameter descriptions for IMS
continues, but the return code is 8. procedures (System Definition). PCB is the work area
Programmer response: Correct the errors, and rerun size required in the MSG or BMP region. PSB is the size
the program. of the fixed PSB blocks required in the PSB pool.
WORKAREA is the size of various work areas required
Module: DFSUACB0 for the PSB and is obtained from the PSB work pool
(PSBW pool). See message DFS0593I for sizes of each of
the various work areas. WORKAREA gives the size at
DFS0587I ERROR BUILDING PSB=psbname-IT
ACBGEN time. This is the minimum size for the work
WILL BE DELETED FROM ACBLIB
areas. At scheduling time, this size can be increased. A
Explanation: The block builder returned a nonzero significant increase can occur if the size is changed to
completion code after processing the indicated PSB. The the size of the long message queue buffer. TOTAL SIZE
PSB is deleted from ACBLIB, processing continues, and is the combined PSB pool size and PSB work pool size
the return code is set to 8. If this message is preceded requirement at ACBGEN time. The FP work areas used
by message DFS0921I, no member is deleted from for EPCBs are not included in the WORKAREA above.
ACBLIB because the indicated PSB is a DBD.
Module: DFSUACB0
Programmer response: Correct any errors indicated by Related information:
the error messages, and rerun the program with a
“DFS0593I” on page 146
BUILD statement for this PSB.
Module: DFSUACB0
DFS0597W OPEN FAILED FOR DDNAME xxxxxxxx System action: Processing terminates. Redefinition is
ignored for the distribution identifier implied.
Explanation: The OPEN failed for the DDNAME
xxxxxxxx data set. If this message occurs during IMS Programmer response: Correct the distribution
initialization, IMS might not be able to acquire the redefinition statement, and rerun the job.
information needed for initialization. If the MFS Device Module: DFSUTR20, DFSUTR30
Characteristics Table utility issues this message, the
descriptor members are unavailable.
System action: IMS initialization abnormally
terminates with abend 0016. The MFS Device
Characteristics Table utility ends with a return code of
12.
Operator response: (master terminal) If IMS does not
abend, determine if DDNAME xxxxxxxx is necessary
for the installation. For the MFS Device Characteristics
Table utility, DDNAME xxxxxxxx is required.
Programmer response: Validate the DDNAME
xxxxxxxx data set and make sure that the DDNAME
xxxxxxxx DD statement is included in the JCL.
Problem determination: 1, 3, 6, 8
Module: DFSXRPS0, DFSPMBR0
Related information:
Programmer response: Correct the distribution task ST JS Subtask Job step task
redefinition statement, and rerun the job. id jobname For End of Task failure For End
ID=imsid of Memory failure
Module: DFSUTR20, DFSUTR30
The return code, xx, indicates the results of DLS
DFS603I IMS DLS CLEANUP (type) status FOR resource cleanup processing. A return code of X'00'
task jobname.stepname.procstepname RC=xx indicates DLS resource cleanup finished successfully.
Return code values X'30' through X'58' represent
Explanation: For information and actions, see failures during End of Task termination. Values X'C0'
DFS603W. through X'D8' represent failures during End of Memory
Related information: termination. The return codes have the following
values and meanings.
DFS603W
Code (hex)
Meaning
DFS603W IMS DLS FAILURE (xx) FOR task id
00 Cleanup finished successfully.
Explanation: The IMS DL/I subordinate address space 01 GETMAIN failed for work area. Minimal
(DLS) resource cleanup processing (SSI routine) cleanup processing is performed.
produces two forms of message DFS603; one is a 02 Failure while attempting to obtain either the
warning and the other is informational. SSCD image or SCD address, or both. The
only cleanup performed is to null the DLS
The warning message, DFS603W, appears every time a
REAL SSCT.
recoverable failure occurs during cleanup processing.
03 Failure or operator cancel occurred during
The message provides a failure code, xx, specifying the
cleanup processing causing ESTAE to be
function executing at the time the failure is detected.
driven for an unrecoverable failure.
DLS resource cleanup processing resumes with the next
Abbreviated cleanup is attempted. ESTAE is
function in the termination process.
unable to obtain storage for the failure
The information message, DFS603I, is produced once message. Processing terminates.
for the job step TCB at the end of cleanup, and once for 04 ESTAE could not be established. Minimal
each ESTAE failure under a subtask. An ESTAE failure cleanup processing is performed.
occurs when the SDWA is not present or no retry is 08 Failure while attempting to obtain the SSCD
possible. If all TCBs complete without errors, the image or SCD address. Processing resumes
informational message shows a status of COMPLETE with the next function.
with a zero return code; otherwise, for all but 0C Failure while locating DLS DUMP SSCT or
Operator response:
System action: Processing continues.
Make sure that no IMS system is currently active with
the same subsystem name. Check for DBRC and Programmer response: Install the correct level of
DLISAS regions that might still be active after a prior DFSVC200 or DFSRTM00.
failure of the CTL region. If DBRC or DLISAS regions
Module: DFSMRC20, DFSRTM00, DFSVC200
are still active without a corresponding CTL region,
cancel them before proceeding.
DFS0622I job.step.proc-KEY 0-7 NOT ALLOWED
If there is no IMS system currently active with the
FOR DLI, DEP OR UTILITY RGN
same subsystem name, then issue the /ERE OVERRIDE
command. In an XRF environment, issue the /ERE Explanation: You specified a protect key of 0-7 for a
BACKUP command. DL/I, DEP, or utility region. In z/OS, only the online
control region is allowed to run under a protect key in
Module: DFSRST00
the range 0-7.
System action: IMS issues abend 0622 for the region connection is still active. During a reconnect
that issued this message. attempt, be aware of the following:
v Every dependent region with an intent to
Programmer response: See abend code 0622.
use a database must go through terminate
Module: DFSRRA00 thread processing.
Related information: v Any such dependent region that does not
terminate prevents IMS from completing the
Abend 0622 steps necessary to clean up from the IRLM
failure.
v IMS cannot be reconnected to the IRLM or
DFS0623I job.step.proc-KEY 0-7 REQUIRED FOR be terminated until all region disconnect
ONLINE CONTROL REGION processing has completed.
Explanation: IMS attempted to initialize an online v You must abend those regions that are in
control region in z/OS with a protect key in the range various stages of disconnect processing
8-15; a key of 0-7 is required. (such as waiting in an application for a
timer pop, or waiting for a reply to a
System action: IMS issues abend 0623 for the region WTOR).
that issued this message. 08 IMS was unable to sign on to the IRLM again
Programmer response: See the information for abend and the operator replied CANCEL to message
code 0623. DFS039A.
12 IMS found applications still scheduled against
Module: DFSRRA00 the data bases which were active at the time of
Related information: the IRLM failure and therefore could not
proceed with the IRLM reconnect command.
Abend 0623
System action: Processing continues without the use
of the IRLM.
DFS624I COMMAND VERB/OPTION NOT
SUPPORTED (y) Module: DFSFCTT0, DFSRDSH0
Module: DFSFCTT0
DFS627I IMS RTM CLEANUP (type) status FOR
task jobname.stepname.procstepname RC=xxx
DFS625I IRLM RECONNECT COMMAND
FAILED, CODE - nn Explanation: For information and actions, see message
DFS627W.
Explanation: The OS operator has entered an OS
Related information:
MODIFY command to IMS specifying RECONNECT,
and IMS was unable to complete the IRLM DFS627W
RECONNECT command.
The value of nn is indicated by one of the following DFS627W IMS RTM FAILURE (xxx) FOR task id
codes: Explanation: The IMS resource termination manager
Code (Dec) (RTM) produces two forms of message DFS627; one is a
Meaning warning and the other is informational.
04 The IRLM did not give the IMS status exit The warning message, DFS627W, appears every time a
control for an IRLM failure. This means either recoverable failure occurs during RTM processing, or
IRLM has not been used at all during this when a nonzero return code is received from a routine
execution of IMS or the IMS-to-IRLM called by RTM. The message provides a failure code,
xxx, specifying the function executing at the time the Manager disconnect processing (XRF or Fast
failure is detected. RTM resumes processing with the Database Recovery environments only).
next function in the termination process. Processing resumes with the next function.
18 A failure occurred while performing IMS
The informational message, DFS627I, is produced once
Intersubsystem Interface termination
for the job step TCB at the end of cleanup, and once for
processing. Processing resumes with the next
each ESTAE failure under a subtask. An ESTAE failure
function.
occurs when the SDWA is not present or no retry is
1C A failure occurred while disconnecting
possible. If all TCBs complete without errors, the
memory-to-memory window headers.
informational message shows a status of COMPLETE
Processing resumes with the next function.
with an X'00' return code; otherwise, the status is
20 A failure occurred while scanning TCB DEB
FAILED with a return code of X'FF'. (See the
chain. Processing continues with the next DEB
hexadecimal return codes described later in the
on chain.
message for the meaning of return code X'FF'.)
24 A failure occurred while performing HALT
I/O or quiesce function for channel to channel
Remember: When ESTAE is entered and retry is device. Processing continues with the next
possible, the SDWA is written to SYS1.LOGREC. DEB on chain.
Included in the entry are the job name, the release and 28 A failure occurred while closing an OSAM
level of the terminating IMS, and the failure code. data set. Processing continues with the next
The following table shows the message text: DEB on chain.
Table 6. DFS627W message text 2C A failure occurred while closing an OS data
set. Processing continues with the next DEB on
Keyword Values Meaning
chain.
type EOM EOT End of Memory End of Task 30 A failure occurred during processing, or
ESTAE ESTAE failure; no retry possible nonzero return code received from IMS
status COMPLETE IMS finished successfully. IMS Resource Lock Manager quit function.
FAILED encountered at least one failure Processing resumes with the next function.
during cleanup. 34 A failure occurred while page freeing OSAM
task ST JS Subtask Job step task short term I/O pages. Processing resumes with
the next function.
id jobname For End of Task failure For End
ID=imsid of Memory failure 38 A failure occurred while disconnecting
cross-memory tables. Processing resumes with
the next function.
The return code, xxx, indicates the results of resource 3C A failure occurred while releasing CSA storage
cleanup processing. Return code values X'00' through for RGPARMS. Processing resumes with the
X'FF' are produced by DFSRTM00. Values X'04' through next function.
X'74' represent failures during End of Task termination. 40 A failure occurred during processing or
Values X'C8' through X'EC' represent failures during nonzero return code received from SVC
End of Memory termination. Other values produced by termination and CSA cleanup routine.
DFSRTM00 apply to either type of termination. Return Processing resumes with SVC directory
code X'100' or greater are produced by DFSMRC20. The cleanup.
return codes have the following values and meanings. 44 A failure occurred during processing or
nonzero return code received from SVC
Code (hex) directory cleanup routine. Processing resumes
Meaning with the next function.
00 Cleanup finished successfully. 48 A failure occurred while performing an
01 GETMAIN failed for work area. Minimal ENFREQ DELETE call to delete an IMS ENF
cleanup processing is performed. listen exit. Processing resumes with the next
04 ESTAE could not be established. Minimal function.
cleanup processing is performed. 4C A failure occurred while performing an
08 Not used. IXLDISC call to disconnect from a coupling
0C A failure occurred while scanning the TCB facility structure. Processing resumes with the
Table during TCB validation. Processing next function.
resumes with the next function. 50 A failure occurred while performing an
10 A failure occurred while performing ENFREQ DELETE call for the IMS ARM ENF
Availability Manager disconnect processing listen exit. Processing resumes with the next
(XRF environments only). Processing resumes function.
with the next function. 54 A failure occurred while performing Media
14 RTM received a nonzero return code from Manager control block clean up for opened
GETMAIN when storage was requested for Fast Path DEDB areas. Processing resumes
save areas while performing Availability with the next function.
| 58 A failure occurred while performing Fast Path 108 DFSRTM00 address is zero in the SSCT.
| 64-bit buffer cleanup. Processing resumes with Abbreviated cleanup is attempted.
| the next function. 10C A failure occurred attempting to route control
59-5B Not used. to DFSRTM00. The ESTAE in DFSMRC20
5C A failure occurred while performing logger intercepts the abend and attempts an
cleanup. Processing resumes with the next abbreviated cleanup.
function. 110 Previous job step or end-of-memory cleanup
5D-6C Not used. was attempted and failed. DFSMRC20 resets
70 A failure occurred attempting to set IMS the IMS DUMP SSCT to null and returns to
DUMP SSCT to null. Processing resumes with z/OS. Some IMS resources might not have
the next function. been cleaned up.
74 A failure occurred during delete subpool all 114 DFSMRC20 was called for a non-IMS job step
function for IMS subtask. Processing resumes TCB in an address space with an active IMS
with the next function. SSCT. This is usually the result of a prior IMS
C8 RTM received a nonzero return code from the resource cleanup failure, or of DFSMRC20 not
SVC directory cleanup routine. Processing receiving control for an IMS job step TCB
resumes with the next function. termination. DFSMRC20 resets the IMS DUMP
CC RTM received a nonzero return code from the SSCT to null and returns to z/OS. Some IMS
IRLM quit function. Processing resumes with resources might not have been cleaned up.
the next function. 118 DFSMRC20 was called for task termination
D0 A failure occurred attempting to route control after the IMS job step TCB entered final
to DFSRTM00. The ESTAE in DFSMRC20 termination in module DFSRTM00. The job
intercepts the abend and attempts an step task is still active. This situation is not an
abbreviated cleanup. error; however, this code is used internally for
EC A failure occurred attempting to set IMS tracing this event for diagnostics.
DUMP SSCT to null. Processing resumes with
System action: If the return code is X'00' for End of
the next function.
Task termination, the resource cleanup processing for
F0 The DL/I subordinate address space can
the IMS region completed satisfactorily. If the return
terminate without successfully performing
code is X'00' for End of Memory termination, cleanup
resource cleanup for the region. If this
completed satisfactorily, but is limited to
happens, the DLS SSCTs might be left after the
non-task-related functions only. If the return code is
DLS region has terminated, which can produce
X'FF', one or more failures occurred, and cleanup
abends in the Master Scheduler Broadcast
processing related to those failures might not have been
function. In attempting to prevent certain
completed.
abends if running with a DLS region, the
control region job step TCB searches for the Problem determination: 1, 11, 36
DLS SSCTs during cleanup processing. If
either SSCT is found, SSCT cleanup is Module: DFSRTM00, DFSMRC20
attempted. If cleanup of the DLS SSCTs Related information:
succeeds, message DFS627W IMS RTM FAILURE “DFS627I” on page 155
(F0) FOR DLS is issued. If cleanup fails, the
Chapter 2, “IMS problem determination,” on page 5
standard form of the warning message is
issued. Processing resumes with the next
function. DFS628I ABNORMAL TERMINATION
FC Resource cleanup processing canceled by SCHEDULED
operator. Abend X'x22' is intercepted by
Explanation: The z/OS system console operator
ESTAE, and no retry processing is permitted.
entered a MODIFY IMS.DUMP command to
An abbreviated form of cleanup processing is
abnormally terminate the IMS region.
performed by the ESTAE routine.
FF Resource cleanup processing was completed, System action: The IMS region is abnormally
but one or more failures occurred during terminated with a memory dump.
cleanup. Message DFS627W explains the
reason for the failure. Module: DFSFCTT0
100 While processing on behalf of an IMS TCB,
DFSMRC20 determined that the DUMP SSCT DFS629I IMS ttt TCB <action> IMS|SYS
was invalid. No cleanup is attempted for the sss|uuuuvvvvIMS ttt TCB <action>
terminating TCB. IMS|SYS sss|uuuuvvvv
104 ESTAE could not be established. Control is not
passed to DFSRTM00. The only processing or
attempted is setting the DUMP SSCT to null.
IMS BATCH REGION ABEND - IMS|SYS uuuu
aaaaaaaa
Hexadecimal address of module entry point DFS632I job.step.proc-EXCESSIVE NUMBER OF
PARAMETERS IN PARM FIELD
System action: For some IMS TCB failures, the IMS
system terminates. For other IMS TCB failures, (such as Explanation: The EXEC statement PARM field
dynamic allocation, Fast Path-dependent region, storage contained too many positional parameters.
compression, and some DBRC failures) IMS continues Programmer response: Correct the error, and resubmit
processing. For IMS external subsystem failures, the the job.
external subsystem task terminates.
Module: DFSRRA20
Operator response: If an external subsystem task
terminates, restart the task with the /START SUBSYS
command.
Module: DFSRRA20
DFS0633I DBRC PARAMETER SPECIFIED VALID
ONLY FOR BATCH BACKOUT
DFS0637W xxxx REQUEST NOT SATISFIED DUE
Explanation: DBRC=C was specified, but the program
TO POOL EXPANSION LIMIT
name was not DFSBBO00. Batch Backout is the only
valid program that can be specified with the DBRC=C Explanation: One or more requests for storage from
parameter. the IMS storage pool xxxx were not satisfied. The
request causes the pool size to exceed the upper
System action: The IMS job terminates abnormally
expansion limit. The upper limit is specified on the
with abend 0633.
execution parameters.
Programmer response: Correct the conflict between
System action: If the caller specified that the IMS
the DBRC and MBR parameters.
storage pool manager waits for storage, the caller waits
Module: DFSRRA00 until enough storage is returned to the storage pool to
Related information: satisfy the request or until the caller has waited the
maximum number of compression cycles. If the request
IMS abend 0633 is not satisfied, a nonzero return code is returned to the
caller.
DFS634I job.step.proc-BLANK ENCOUNTERED Programmer response: If this message is issued
AS FIRST CHAR OF PARAM VALUE repeatedly for the same storage pools, increase the
upper expansion limit for those pools.
Explanation: A positional parameter in the PARM
field of the EXEC statement contained one or more Module: DFSSTAT0
leading blanks.
System action: System terminates abnormally. DFS638I job.step.proc-COMMA FOUND WITHIN
EXTENT OF FIXED LENGTH PARAM
Programmer response: Correct the error, and resubmit
the job. Explanation: A comma was found within the extent of
a fixed-length field.
Module: DFSRRA00
System action: System terminates abnormally.
DFS635 COMMAND BUFFER TOO LARGE: Programmer response: Correct the error, and resubmit
CANNOT PROCESS COMMAND. the job.
Explanation: The entered command required a buffer Module: DFSRRA00
length greater than X'FFFF' (65,535) bytes. X'FFFF' is the
limit for the /DISPLAY command, while X'7FFF'
DFS639W INVALID STG POOL DEF FOR (xxxx)
(32,767) bytes is the limit for all other commands. The
(*) parm
command in error probably contained the NODE
keyword with the ALL parameter. Explanation: The IMS.PROCLIB member DFSSPMnn
contains a storage pool definition statement with an
System action: The command is ignored.
invalid parameter. The allowable parameters are pool
Programmer response: Reduce the storage name and buffer definition.
requirements by reentering the command as multiple
If parm indicates FPL=zzzz, then the pool name is
commands with a specified range. The number of
invalid. The IMS storage pool zzzz has not been
parameters that can be specified for a /DISPLAY
defined.
command is approximately 5500, and 2500 for all other
commands. Contact the system programmer for If parm indicates (a, b, c, d), then the buffer definition is
assistance. invalid for pool xxxx. The following list defines the
buffer definition subparameters:
Module: DFSICL30
a Defines the buffer size, which is a unique 1 to
5-digit numeric value. The allowable range is 8
DFS636I job.step.proc-LAST FIXED LENGTH through 65536. The buffer size value is
PARM VALUE TOO SHORT rounded up to the nearest multiple of eight.
b Defines the number of buffers in the primary
Explanation: The last fixed-length parameter value in
storage allocation. The value must be a 1 to
the PARM field of the EXEC statement was too short.
5-digit numeric value in the range of 2
System action: System terminates abnormally. through 65535.
c Defines the number of buffers in secondary
Programmer response: Verify that no preceding value
is incorrect. Correct any error, and resubmit the job.
Explanation: A required parameter for the execution Explanation: System error was encountered.
specified by the first three characters of the EXEC System action: System terminates abnormally.
statement PARM field was omitted.
Operator response: (z/OS System operator) Refer this
System action: System terminates abnormally. error to IMS systems operation personnel.
Programmer response: Correct the error, and resubmit Problem determination: 1, 2, 3, 4, 36. Also, get an
the job. assembly listing of DFSRRA00 as used on-site.
Module: DFSRRA20 Module: DFSRRA20
Related information:
DFS641I jobname.jobstep-INCORRECT REGION Chapter 2, “IMS problem determination,” on page 5
PARAMETER IN EXEC STATEMENT
Explanation: The Database Recovery utility DFS645W PRIMARY xxxx STORAGE EXCEEDED
DFSURDB0 was run in an invalid region type. The POOL EXPANSION LIMIT
batch region type specified in the first subparameter of
the //EXEC PARM field must be UDR. Explanation: During xxxx storage pool initialization,
the accumulated size of the primary buffer allocations
System action: IMS issues abend 0641 for the region specified exceeded the upper expansion limit specified.
that issued this message. This message is issued before any attempt to obtain
Programmer response: See abend code 0641. storage for buffers. If the upper expansion limit value
Related concepts: member and job name failed for one of the following
reasons:
IMS abend codes (Messages and Codes) 04 The JOB statement is missing from the
PROCLIB member.
DFS658I job.step.proc-PROGRAM NAME 08 An incomplete statement was encountered.
PARAMETER OMITTED FROM PARM 0C Unable to add the IMSID parameter to the
FIELD EXEC statement.
10 The parameter field is continued incorrectly.
Explanation: The program name parameter was 14 The EXEC statement has no parameters.
omitted from the PARM field. 18 The PROCLIB cannot be opened.
Programmer response: Correct the error, and resubmit 1C The data set record format is incorrect.
the job. 20 The data set block size is incorrect.
24 The PROCLIB member cannot be found. The
Module: DFSRRA00 instream procedure is not supported by the
generic /START REGION command.
28 The first statement of the PROCLIB member is
DFS0659I CTL RGN U780 RC=xxxx BECAUSE
not the JOB statement.
CCTL yyyyyyyy WAS TERMINATED
2C The procedure statement is not valid. The
WHILE DBCTL THREAD HELD
instream procedure is not supported by the
LATCH
generic /START REGION command.
Explanation: The CCTL was terminated while a 30 The EXEC statement is missing.
DBCTL thread was holding an IMS unrecoverable latch.
Programmer response: Verify that the member and job
This problem caused a critical failure that required an
names are correct. Also check the JCL statements in the
abnormal termination of the IMS control region.
specified member. Make the necessary corrections and
xxxx Represents the return code from the failed
reissue the command.
attempt at latch recovery. For an explanation
of return codes, see the IMS abend 0780 Module: DFSPMBR0
information.
yyyyyyyy
Job name of the terminated CCTL region. DFS662I job.step.proc-FIRST POSITIONAL
PARAM IN PARM FIELD IS INVALID
Module: DFSSDA30
Explanation: The first positional parameter in the
Related information: PARM field was invalid.
IMS abend 0780 System action: Abend 0662 is issued.
Programmer response: Correct the error, and resubmit
DFS660I job.step.proc-PARM FIELD OMITTED the job.
FROM EXEC STATEMENT
Module: DFSRRA00
Explanation: All IMS execute statements must contain
Related information:
a PARM field.
Programmer response: See the information about IMS abend 0662
PARM fields.
Module: DFSRRA00 DFS0663I (Message text varies for DFS0663I,
DFS0664W, and DFS0665E)
Related concepts:
Explanation: See the explanation for DFS0665E.
Specifying IMS execution parameters (System
Related information:
Definition)
DFS0665E
Related reference:
Parameter descriptions for IMS procedures (System DFS0664W (Message text varies for DFS0663I,
Definition) DFS0664W, and DFS0665E)
Explanation: See the explanation for DFS0665E.
DFS0661I CANNOT PROCESS /START REGION
Related information:
COMMAND: MEMBER=member_name
JOB NAME=job_name RC=X'xxxxxxxx' DFS0665E
Explanation:
The /START REGION command with the specified
DFS0669I PROCLIB RECFM NOT 'F' OR 'FB' System action: The following initial default is set for
this execution of IMS: DBRC=YES.
Explanation: The IMS initialization process found the
IMS PROCLIB data set record format to be neither Programmer response: Verify that DFSIDEF0 has been
"fixed" nor "fixed-blocked". built correctly.
Module: DFSRRA70, DFSRRA80
System action: If any of the modules are required by Note: In most cases, the checkpoint ID consists of
IMS, abend 0718 follows. If all of the modules are printable universal character data. When the checkpoint
optional, initialization continues. ID consists of printable universal character data, the
Operator response: Contact the IMS system EBCDIC representation of the HEX value of the
programmer at your installation. checkpoint ID does not appear. If the EBCDIC
representation of the HEX value does appear, it must
Programmer response: Check the JOB/STEPLIB PDS be translated to binary for restart purposes.
member attributes. To avoid possible physical damage
to the DASD pack, you might want to again bind those System action: Normal processing continues.
modules that were not loaded. Module: DFSRDBL0, DFSRBLB0
If sufficient storage is not available, increase the SQA,
CSA, or region size, as needed. DFS682I BATCH-MSG PROGRAM pgmname JOB
Problem determination: 1, 4, 36 jobname MAY BE RESTARTED FROM
CHKPT ID id-value
Module: DFSPLDR0 [X'nnnnnnnnnnnnnnnn']
Related reference:
Explanation: One of the following occurred:
IMS system services return codes (Messages and v IMS was processing the checkpoint FREEZE
Codes) command and the batch message processing program
listed made a CHKP call with the indicated
Related information:
checkpoint ID value.
IMS abend 0718 v During emergency restart processing, the batch
message processing program listed was processing at
Chapter 2, “IMS problem determination,” on page 5
the time of system failure. The indicated CHKPT-ID
was the last CHKP call issued. All databases and the
DFS680I USING CHKPT yyddd/hhmmss message queue have been restored to reflect the
status that existed at the time the CHKP call was
Explanation: The system selected this checkpoint for
issued.
emergency or normal restart.
System action: Normal processing continues. Note: The jobname and psbname are the same if this
message was issued during emergency restart.
Module: DFSRBCP0
v The indicated CHKPT-ID was the last CHKP call
issued before abnormal termination of the listed
batch message processing program. All databases
and the message queues have been restored to reflect v An attempt was made to start a second copy of IMS
the status that existed at the time the CHKP call was control region with the same IMSID as one already
issued. running. This can also occur if IMS SVC termination
failed in a previous run of IMS with the same IMSID.
Note: In most cases, the checkpoint ID consists of v The IMS SDFSRESL is not authorized or the IMS
printable universal character data. When the checkpoint SVC module is being loaded from an unauthorized
ID consists of printable universal character data, the library.
EBCDIC representation of the HEX value of the v The region size is too small.
checkpoint ID does not appear. If the EBCDIC v Not enough CSA is available.
hexadecimal value nnnnnnnnnnnnnnnn does appear, it
must be translated to a binary value for restart Abend 0684 and message DFS686W accompany this
purposes. message.
System action: Normal processing continues. System action: The region that issued abend 0684
terminates abnormally.
Operator response: (master terminal) Take one of the
following actions: Programmer response: Do one of the following:
v If the batch message processing program reads v Correct the duplicated IMSID situation and rerun the
messages from the message queue and does not job.
require restart routines, start the program in the v Make sure IMS SDFSRESL is authorized or include
normal manner. the DFSRESLB DD statement that points to an
v If the batch message processing program does not authorized library containing the IMS SVC modules.
read messages from the queue or requires restart v Increase the region size.
routines, restart the program from the checkpoint ID v Allocate additional CSA and IPL the system.
listed.
See abend 0684 and message DFS686W for additional
Problem determination: 4, the log data set being used
information.
for restart, or the current IMS system log if restart is
not in progress. Module: DFSRRA00
| Module: DFSRBLB0, DFSRBOI0, DFSRDBL0 Related information:
Related information: Abend 0684
Chapter 2, “IMS problem determination,” on page 5 DFS686W
Related reference:
Abend 0689
IMS system services return codes (Messages and
Codes) DFS690A CTL xxxx NOT ACTIVE, REPLY 'WAIT'
Related information: OR 'CANCEL' - yyyyyyyy
Chapter 2, “IMS problem determination,” on page 5
or
DFS687I DBRC INDICATES DBD=x WITHIN job.step.proc-CTL PGM NOT ACTIVE, REPLY 'WAIT'
PSB=y WITH TOKEN=z WAS BACKED OR 'CANCEL' OR 'alt-id'
OUT, RIS HAS BEEN PURGED.
Explanation: There are two forms of this message. In a
Explanation: While IMS attempts to build a Database Control (DBCTL) subsystem environment, a
recoverable in-doubt structure (RIS), DBRC informs Coordinator Control (CCTL) subsystem tried to identify
IMS that database x within PSB=y was altered under a to an IMS control program that was not active. The
unit of recovery identified by token z and was backed inactive IMS control program is xxxx; the identifying
out through Batch Backout. The online region CCTL is yyyyyyyy.
considered the changed data to be in an indoubt state.
For the second form of this message: a dependent
System action: The online system stops the database region started running when the IMS control or
identified, but it does not build a recoverable in-doubt Database Control (DBCTL) region was not active.
structure for the data.
System action: If you entered WAIT, the dependent
Programmer response: If the backing-out of the data region waits; if you entered CANCEL, the dependent
was intended, then a /START DB or UPDATE DB region terminates. If you specified neither, the
START(ACCESS) command makes the database dependent region uses the reply as a name of an
available. However, if backing-out of the data was not alternate control region to which it attempts to identify.
intended, or if multiple resource managers are
involved, an investigation into the resolution of the If you entered WAIT, the CCTL waits before attempting
in-doubt data must be made. to identify again. If you entered CANCEL, the current
initialization transaction is terminated.
Module: DFSDRIS0
Operator response: (master terminal) Reply WAIT or
CANCEL, if either is appropriate. If the control region will
DFS688I job.step.proc-CANCELED BY soon be available, reply WAIT. Reply with an alternate
OPERATOR. CTL PGM NOT ACTIVE control region ID, if one is active.
hh.mm.ss
The JCL for the dependent job region must specify the
Explanation: The control region was not active. This same IMSID and SDFSRESL as the IMS control region.
situation was determined by the dependent region If the dependent region JCL IMSID is incorrect, reply
parameter analysis. The job was canceled because: with the correct control region ID. If SDFSRESL is
v The cancel option (OPT=C) was specified on the incorrect, reply CANCEL, correct the dependent region
dependent region EXEC statement. JCL, and resubmit the job.
v The operator entered CANCEL or C in response to error
message DFS690A. Module: DFSRRA00, DFSPRA10
Module: DFSRRA00
Related information: DFS691I WAITING FOR CTL xxxx - yyyyyyyy
dddddddd
DFS692I jobname.stepname.procstepname BUFFER
The data definition name (ddname) of the data
CONTROL-BUF=value
set encountering the error
Explanation: The buffer control value might be used
System action: A nonzero return code is passed to the
when the log terminator program is needed to close the
caller of OSAM. Depending upon the function
log data set.
requested (OPEN, CLOSE, or EOV), the caller displays
Module: DFSDLN00 an additional error message, or can ignore the error
and continue processing.
DFS0693I RIS ESTABLISHED FOR PSB xxxxxxxx, Programmer response: The purpose of this message is
PRTKN=yyyyyyyy, TOKEN=zzzzzzzz, to record the fact that an ignorable abend condition
RRS- occurred. The abend might be expected or permitted,
URID=wwwwwwwwwwwwwwwwwwww for example, while closing a data set that has been
renamed or deleted. If the abend is the result of I/O
Explanation:
errors while processing the VTOC or writing a file
A Recoverable In-doubt Structure (RIS) was established mark to the data set, the type of data set (database,
for a thread in either a CCTL-IMS environment or in an IMS system data set, or log data set) determines the
RRS protected conversation environment. The recovery process to follow.
RRS-URID is supplied for only protected conversation
Problem determination: 1, 2, 27
work and is the RRS unit of recovery interest token.
The referenced PSB is xxxxxxxx, the pseudo token is Module: DFSAOSF0
yyyyyyyy, and the actual IMS recovery token is zzzzzzzz. Related reference:
The RIS is maintained until a resynchronization process
is performed with IMS. System Completion Codes
Module: DFSDRIS0
DFS0696I COMMAND REJECTED, UNABLE TO
GET STORAGE
DFS694I 'CTL' WAS SPECIFIED FOR JOB STEP
EXECUTION Explanation: A command module tried to get storage
with invalid parameters. The storage manager rejected
Explanation: The IMS control region was started using
the storage request. The command cannot be processed.
job JCL, but CTL was specified in the execution JCL
This problem is an internal error that requires action by
parameter. IMS initialization continued.
the system programmer.
System action: The IMS control program operates as a
System action: The command is rejected.
job step task.
Operator response: Notify the system programmer.
This message can be avoided if the CTX" parameter is
used, or if the IMS control region is started as a system System programmer response: If the storage manager
task. trace was active at the time of the command failure,
find the trace log record associated with the storage
Programmer response: Consult the IMS system
request failure.
programmer for your installation before doing this
action. If the storage manager trace was not active at the time
of the command failure, turn it on using the /TRACE
Module: DFSRRA00
SET ON TABLE STRG command. Reenter the
command. If the command fails again, find the needed
DFS0695I OSAM (OPEN|CLOSE|EOV) information in the associated storage manager trace log
INTERCEPT,ABEND=sss-rc, record.
DDN=dddddddd
Module: DFSICA20, DFSICLI0, DFSICLM0, DFSICL60,
Explanation: OSAM issued an OPEN, CLOSE, or EOV DFSICL90, DFSICV40, DFSIC410, DFSIC460
macro call, and the DCB abend exit routine was entered
because of an abnormal condition. The abend can be
DFS697I IMODULE FAILED REG15=xx IN
ignored, thus preventing the IMS region from
DFSDINB0 FOR EPLOC=yyyyyyyy
terminating abnormally. The requested function was
not performed, and the data set are closed, if possible. Explanation: An IMODULE LOAD or an IMODULE
GETMAIN failed during Database Control (DBCTL)
In the message text:
subsystem initialization (DFSDINB0). Register 15
sss-rc The system completion code (abend), and the
contains the return code from the IMODULE routine
subcode that might accompany the abend (see
(DFSMODU0). For the meaning of the return code, see
z/OS MVS System Codes (SA22-7626) for a
the IMS system services return code information. Field
description of the abend.)
Module: DFSERA10
DFS707I END OF FILE ON INPUT.
Explanation: The input file reached an EOF. The
DFS703I NORMAL END OF JOB.
current test sequence is ended.
Explanation: Program has terminated without
Module: DFSERA10
uncontrollable errors. Error messages might have been
printed but no abend conditions occurred.
DFS708I OPTION COMPLETE.
Programmer response: Verify that all options
completed normally. Explanation: The current test sequence is ended.
Module: DFSERA10 System action: Processing continues on the next
sequence.
DFS704I NO OPTION CARDS SUPPLIED. Module: DFSERA10
Explanation: This message was issued for one of the
following reasons: DFS709I UNABLE TO OPEN OUTPUT FILE.
v The OPTION statements were omitted.
Explanation: The OPEN for the data set associated
v Errors caused all options to be ignored.
with the last control statement failed.
System action: A test sequence was ignored.
System action: The error message is printed and
Programmer response: If the OPTION statements processing continues with the next statement.
were omitted, include the OPTION cards as needed.
Programmer response: Verify that the JCL is correct
Otherwise, correct errors as previously noted in and the DCB parameters are supplied if the data set
SYSOUT printing. does not use a standard label, and rerun the job.
Module: DFSERA10 Module: DFSERA10
DFS705I UNABLE TO OPEN INPUT FILE. DFS710A UCF TERMINATING DUE TO STOP
REQUEST
Explanation: The OPEN for the data set associated
with the last control statement failed. Explanation: While processing under the Utility
Control Facility, the system operator requested a
System action: The error message is printed and
"stop-processing" or a control function contained an
processing continues with the next input statement.
EXEC=STOP on its control statement.
Programmer response: Verify that the JCL is correct
System action: Processing stops, and return code 4 is
and the DCB parameters are supplied if the data set
passed to the next step.
does not use a standard label, and rerun the job.
Programmer response: If further processing is
Module: DFSERA10
required, change the JCL to allow for Restart under the
Utility Control Facility, and resubmit the job.
DFS706I ELEMENT LIST ERROR.
Problem determination: 1, 2, 8, 11, 36. Also, rerun the
Explanation: If RC=04, DFSERA10 detected a job with a FUNCTION=OP,MSGNUM=710 control
duplicate symbol or the symbol specified in the statement in the DFSYSIN data set. Supply a
VALUE= option was not found. You must specify a SYSUDUMP DD statement to this step.
SYM= statement before the VALUE= statement that
Module: DFSUCF00
contains that symbol.
Related information:
System action: Processing terminates and the next test
Chapter 2, “IMS problem determination,” on page 5
sequence is constructed.
Programmer response: If previous errors were
DFS711W VERIFY FAILED FOR module/database
printed, correct them and rerun the job.
csect/data set ON REQUEST nnnn FOR
Problem determination: If the error persists, see 2, 4, FUNCTION ff
36
Explanation: While processing a zap function (ff), a
Module: DFSERA10 verification of data failed. The module and csect or
Related information: database and data set is identified.
Problem determination: 1, 2, 8, 11, 36. Also, rerun the Programmer response: Correct the control statement
job with a FUNCTION=OP,MSGNUM=711 control omitting the DATE operand or the STOP parameter, or
statement in the DFSYSIN data set. Supply a specify them such that the stop time is after PI tracing
SYSUDUMP DD statement to this step. was started.
Module: DFSUCF00 Module: DFSPIRP0
Related information:
Chapter 2, “IMS problem determination,” on page 5 DFS0716A PRINT MUST BE SPECIFIED BEFORE
ANY KEYWORDS
DFS0712A xxxxx KEYWORD REPEATED-MAY BE Explanation: A keyword other than PRINT was
SPECIFIED ONLY ONCE specified first on the control statement to module
DFSPIRP0.
Explanation: A keyword on the control statement to
module DFSPIRP0 was specified more than once. System action: The control statement is scanned for
further errors and processing is terminated.
System action: The control statement is scanned for
further errors, and processing is terminated. Programmer response: Correct the control statement
specifying PRINT as the first keyword.
Programmer response: Correct the control statement
specifying a keyword only once. Module: DFSPIRP0
Module: DFSPIRP0
DFS0717A STOP TIME SPECIFIED PRECEDES
START TIME SPECIFIED
DFS0713A DATE INVALID
Explanation: The STOP parameter was earlier than the
Explanation: An invalid DATE parameter was
START parameter. This message is issued after the
specified. Possible causes are:
control statement scan has been completed.
v The date was not in the form MM/DD, where MM is
one or two numeric characters from 1 through 12 System action: The program is terminated.
and DD is one or two numeric characters from 1
Programmer response: Correct the control statement
through 31.
specifying a stop time later than the start time.
v The date (DD) specified is too large for the
corresponding month (MM). Module: DFSPIRP0
System action: The program is terminated.
DFS0718W BLANK OR NO CONTROL CARD
Programmer response: Correct the DATE parameter in
SPECIFIED-IGNORED
the DFSPIRP0 control statement.
Explanation: A SYSIN DD statement was included but
Module: DFSPIRP0
the input data set contained a blank line or the data set
was empty (no records).
DFS0714A xxxxx PARAMETER DOES NOT END
System action: The report includes records from the
WITH COMMA OR SPACE
beginning to the end of the log data set. The control
Explanation: A parameter on the control statement to statement processing is bypassed.
module DFSPIRP0 did not end with a comma or space.
Programmer response: If a time period was wanted,
System action: The program is terminated. provide a valid control statement. If no control
statement is required, the SYSIN DD statement should
Programmer response: Correct the control statement.
be omitted.
Module: DFSPIRP0
Module: DFSPIRP0
Programmer response: Specify the correct SLDSs, Programmer response: Increase the region size, and
including all volumes in correct sequence, on the resubmit the job.
LOGTAPE DD statement.
Module: DFSPIRP0
Problem determination: 3, 5, 8, 36
Module: DFSPIRP0 DFS0724A NO TRACE RECORDS ON LOG
Related information: DATASET FOR THE TIME PERIOD
Chapter 2, “IMS problem determination,” on page 5 Explanation: No program isolation (PI) trace log
records were found on the log data set during the
specified time period. This problem occurred because:
DFS0720A xxxxx TIME INVALID
v PI tracing was not in effect during the time period.
Explanation: The start or stop time was not specified v The IMS system was dormant during the period and
in two numeric characters from 00 through 99 for no activity occurred which required tracing.
hours, and in two numeric characters from 00 through v The time period specified on the control statement
59 for minutes. for the IMS program isolation trace report utility did
not overlap the time period corresponding to the log
System action: The control statement is scanned for data set provided by the log DD statement.
further errors, and processing is terminated.
System action: No report is generated and the
Programmer response: Correct the start or stop time program completes normally.
on the control statement.
Programmer response: Ensure that the time period
Module: DFSPIRP0 specified on the control statement corresponds to the
log data set provided. Check the console records to
DFS0721A INVALID KEYWORD IN DFSPIRP0 determine if PI tracing was active during the time
CONTROL CARD period. If PI tracing was active check to see if the
system was dormant.
Explanation: The control statement to module
DFSPIRP0 contained an operand other than PRINT=, Problem determination: 3, 5, 8, 36
START=, STOP=, or DATE=. Module: DFSPIRP0
System action: The program is terminated. Related information:
Programmer response: Correct the control statement, Chapter 2, “IMS problem determination,” on page 5
and resubmit the job.
Module: DFSPIRP0 DFS0725I INITIATE|UPDATE|TERMINATE
OLREORG COMMAND FOR DB
dbnamexx COMPLETE. CC= nn
DFS0722I NO TRANSACTION HAD TO WAIT
FOR AN ENQUEUE DURING THE Explanation: The /INITIATE, /UPDATE, or
TIME PERIOD /TERMINATE OLREORG command processing is
complete.
Explanation: No transaction had to wait for an
enqueue during the time period and no report was In the message text:
generated. dbnamexx
is the HALDB partition name entered in the
System action: The program reaches normal command
completion. nn is the completion code
Programmer response: This might be a normal
condition. If a control statement was included, ensure A zero completion code indicates that the command
that the time period was correct. has been successfully processed. Message DFS2970I is
issued after OLR initialization completes to indicate
Module: DFSPIRP0 that the HALDB OLR has started. A nonzero
completion code indicates that an unexpected error was
DFS0723A REGION SIZE TOO SMALL FOR encountered during command processing.
PROGRAM DFSPIRP0 Completion code
Explanation: The region size specified for program Meaning
DFSPIRP0 was not large enough to contain the 0 REQUEST SUCCESSFUL
common work area, input log buffer, and data 10 RESOURCE NAME INVALID
management block list. 14 RESOURCE NOT A PARTITION NAME
1C RESOURCE IS A PARTITION SECONDARY
System action: The program is terminated. INDEX
20 INIT OLREORG ISSUED, OLR IS ALREADY v The combination of the START and DATE operands
IN PROGRESS resulted in a start time greater than 12 days from the
24 NO OLREORG IS IN PROGRESS date PI tracing started.
28 NO DMB LOADED - need to schedule a PSB
System action: The program is terminated.
that references the DB
AE DYNAMIC ALLOCATION ERROR Programmer response: Correct the control statement
C1 OLREORG DDIR MISSING specifying a valid date or starting time.
C3 OLREORG PARTITION STOPPED, or
LOCKED, or DBDUMPED Module: DFSPIRP0
C4 OLREORG PARTITION BEING RECOVERED
C5 OLREORG PARTITION ACCESS NOT DFS0728W DATE SPECIFIED PRECEDES DATE
UPDATE/EXCLUSIVE TRACING STARTED
C6 OLREORG SCHEDULING FAILED - A failure
to build required blocks/PSB or partition Explanation: The date specified was before the date PI
selection failure occurred. tracing started. If IMS was active for more than one
C7 OLREORG PARTITION NOT AUTHORIZED - day, PI tracing might have begun after the first day that
Check HALDB Master status IMS was started.
C8 OLREORG MASTER STOPPED, or LOCKED, System action: Processing continues.
or DBDUMPED
C9 OLREORG MASTER ACCESS NOT UPDATE Programmer response: Determine if the date specified
or EXCLUSIVE was as intended.
CA OLREORG SET OWNERSHIP FAILED Module: DFSPIRP0
CB PARTITION NOT IN SPECIFIED STATUS
CC OLR already active for the partition
CD HALDB OLR attempted for an RSR-covered DFS0729I UNABLE TO OBTAIN WORK AREA
HALDB FOR DL/I OPEN/CLOSE PROCESSING
CE HALDB OLR cannot access all the data in the
Explanation: When attempting to open or close a
partition because an EEQE exists.
DL/I database, it was found that main storage space
DA DATABASE BEING RECALLED FROM HSM
for the work area required for OPEN/CLOSE
System action: IMS continues processing. processing was unavailable.
Problem determination: 6, 11 System action: Processing of the DL/I call is
terminated and a status code of AI is returned in the
Module: DFSORC10, DFSORP50 PCB. In addition, the error code from the IMODULE
Related information: routine is stored in PSTRTCDE.
“DFS2970I” on page 593 Programmer response: Provide a larger address space
Chapter 2, “IMS problem determination,” on page 5 for the step so that the work area can be obtained.
Problem determination: 1, 2, 3, 17b, 36
DFS0726A CONTROL CARD ERROR-
PROCESSING TERMINATED Module: DFSDLOC0
Related information:
Explanation: The control statement to module
DFSPIRP0 contained one or more errors as indicated by Chapter 2, “IMS problem determination,” on page 5
previous messages, or data was entered past position
71 on the control statement. DFS0730I UNABLE TO OPEN OR CLOSE
System action: The program is terminated. DATASET WITH DDNAME ddname
FOR REASON x, yy, z DATABASE
Programmer response: Correct the control statement, dbdname programid
and resubmit the job.
Explanation: An error occurred when IMS tried to
Module: DFSPIRP0 open or close a database. ddname is the DD statement
name of the data set on which the error occurred. x, yy
represents the major and minor reason codes. The data
DFS0727A DATE/TIME SPECIFIED NOT WITHIN
set ddname is a part of the DBD dbdname. If an error
12 DAYS OF DATE PI TRACE
occurred when IMS tried to open a database programid
STARTED
is included in the message. When a scheduler message
Explanation: One of the following problems occurred: block (SMB) is present, programid represents the
v The DATE operand specified a date that was more transaction code (TRN). When an SMB is not present,
than 12 days before or after the date PI tracing was programid represents the PSB name.
started.
The following information provides the explanation,
programmer response, and problem determination 07 DCB block size not equal to DSCB block
codes for the various major and minor reason codes: size after Job File Control Block/DCB
merge.
Codes
08 DCB LRECL size not equal to DSCB
Explanation
LRECL size after Job File Control Block or
A,yy Data Control Block (DCB) merge.
An attempt was made to open an OSAM data set. 09 Neither the LRECL nor block size was
The OSAM OPEN routine returned an error specified in the DSCB, DCB, or JCL.
indication. yy is the hexadecimal error code that is 0A The specified block size is less than
returned in register 15. LRECL.
0B The specified block size exceeds the track
Code (hex) size for the specified device.
Meaning 0C A previous OPEN or EOV failed.
00 The normal condition. 0D VIO not supported by OSAM. The data
04 The DCB is already being opened or set is allocated to a VIO unit.
closed. 0E Tape devices are not supported. The data
08 The DCB is already open. set is allocated to a tape device.
0C The DECBTYPE is invalid. 0F An internal error occurred in the OSAM
10 A failure in the IMS SVC occurred. DEB subroutine. DCBWRK1 indicates the
DCBWRK1 indicates the reason. error code:
14 An I/O error occurred while the OSAM 01 The block size is greater than the
OPEN routine was scanning for a file track size.
mark, formatting, or writing a file mark. 02 The DEB length is greater than
See DECBSTAT for additional information. the maximum allowed. There are
18 An invalid RBN was calculated. The RBN too many extents. This situation
is either 0 or is greater than the maximum might be the result of a DFS0842I
RBN for the data set. message REASON=5 issued
1C An error occurred during TCLOSE earlier by the same or a different
processing for the data set. DCBWRK1 job.
indicates the reason. 10 IEFDDSRV failed to perform the function.
20 An error occurred while acquiring storage 11 Inconsistent number of allocated devices.
using IMODULE.
24 An error occurred during EOV processing 99 The DCB abend exit was entered. Message
for the data set. DFS0695I is also displayed. See that
28 OSAMOP IOSCB=NO was specified in a message for an explanation of the error.
control statement data set. This value
caused BATCH initialization to bypass the Programmer response: Correct the JCL error by
allocation of OSAM I/O blocks and using the major and minor reason codes given.
prevented the use of the OSAM access
B,40
method.
A coupling facility (CF) environmental error
occurred.
z is the hexadecimal error subcode returned at the
last byte (byte number 4) in the field name Programmer response: Determine the exact error
DCBWRK1 by module DFSAOSF0. This subfield of by using the IMS DFSERA10 utility and selecting
the message is used only for a message that the X'67FD' record from the IMS log. This record
contains reason code A,10. includes the REQUEST=IXLCACHE macro with a
reason code, RSNC=xxxxxxxx. The last 4 digits of
z Value (hex)
the number string xxxxxxxx represent the true error
Meaning
code. For example, if the reason code is
01 The DD statement is missing, or for
RSNC=0C170C19, look up reason code 0C19. See
dynamically allocated data sets, the data
the z/OS MVS Programming: Sysplex Services
set is not yet allocated.
Reference for reason code descriptions.
02 The data set is a concatenated data set.
03 Fewer units than volumes were specified B,yy
for a DASD data set. DL/I OPEN/CLOSE called the DL/I buffer
04 JCL specified a DSORG type not handler for buffering services. The buffer handler
permitted by OSAM. returned with an error indicator. yy is the
05 The DSCB for the data set was not found. hexadecimal value that was returned in PSTRTCDE
06 First volume DSCB specified a DSORG by the buffer handler.
type not permitted by OSAM.
Programmer response: Provide a larger address If the error was caused by an incompatible
space for this step. allocation program or product:
I,14 1. Enter a /DBR command to deallocate the
The system was unable to satisfy a GETMAIN database.
request for an additional ddname open table. This 2. Correct the program or product.
error occurred during the opening of an ACB. 3. Enter an UPDATE DB START(ACCESS) or
/START for the database.
Programmer response: Provide a larger address
space for this step. I,20
The system is not able to satisfy a GETMAIN
I,15 request for the record size of the KSDS being
An error was detected during OPEN processing of opened for sequential mode.
an HSAM or OSAM data set. The data set was not
allocated at the time IMS tried to obtain DBRC Programmer response: Provide a larger address
authorization for the database. See return code I,16 space for this step.
for a complete description of the error. I,21
Programmer response: If there is an incorrect The system is not able to satisfy the GETMAIN
dynamic allocation of the data set, or an request for the block size of an HSAM database.
incompatible allocation program or product, use
Problem determination: 1, 3, 8, 17b, 17d, 18, 20, 36 already one or more ACBs open for the indicated data
set. The SHR option of the VSAM DEFINE utility
Module: DFSDLOC0
provides the user the ability to control the extent that a
Related concepts: data set can be shared. The DEFINE has allowed the
current data set to be shared.
IMS buffer pools (System Definition)
Related reference: System action: The IMS system ignores the error and
continues processing.
IMS return and function codes (Messages and
Programmer response: The IMS databases should
Codes)
never be shared by multiple batch regions or batch and
DL/I status codes (Messages and Codes) online regions. Correct the error, and resubmit the job.
Operator response: If this error occurred during Fast 21 Error return code from DBRC. Left
Database Recovery region initialization, take a simple half of register 15 contains the DBRC
checkpoint in the active IMS system, and make sure return code.
that the restartable checkpoint is found in the OLDS 22 A logic error was detected.
before restarting the Fast Database Recovery region. 23 Restart read transition table failure.
24 A sequence error occurred on both
Problem determination: 1, 5, 8, 11, 35
OLDS (dual logging).
Save a copy of the OLDSs and WADSs data sets. Also, 25 A read error occurred on both OLDS
list the DBRC RECON data set. (dual logging).
26 In an XRF complex, the alternate
Module: DFSFDLR0, DFSFDLM0, DFSFDLN0, system either allocated an SLDS or
DFSFDLP0, DFSFDLT0 determined that the next log to be
Related information: allocated is an SLDS. In a Fast
“DFS0739X” Database Recovery environment, the
Fast Database Recovery region either
IMS abend 0175 allocated an SLDS or determined that
the next log to be allocated is an
IMS abend 0176 SLDS.
Chapter 2, “IMS problem determination,” on page 5
System action: IMS terminates with abend 0175. In an
XRF complex, the IMS alternate system terminates with
DFS0739X ERROR READING IMS LOG RC=xx abend 0176.
dddddddd nnnnnnn
In a Fast Database Recovery environment, the Fast
Explanation: Restart cannot proceed because of errors Database Recovery region terminates with abend 0176.
encountered.
Operator response: If this error occurred during Fast
In the message text: Database Recovery region initialization, take a simple
dddddddd checkpoint in the active system and make sure that the
The ddname of the data set being processed restartable checkpoint is found in the OLDS before
when the error was encountered. dddddddd can restarting the Fast Database Recovery region.
be blank.
nnnnnnn Problem determination: 1, 5, 8, 11, 35
The log sequence number last processed. Save a copy of the OLDSs and WADSs data sets. Also,
nnnnnnn can be blank. list the DBRC RECON data set.
xx A hexadecimal error code. Register 14 contains
the address of the routine that detected the Module: DFSFDLM0, DFSFDLN0, DFSFDLP0,
error. Register 15 contains an error code. DFSFDLR0
Related information:
Code (hex)
Meaning IMS abend 0175
15 Could not open the data set.
16 Could not close the data set properly. IMS abend 0176
17 Read error. Chapter 2, “IMS problem determination,” on page 5
18 Reread of last good block failed.
19 OLDS block sequence error.
1A Next sequential log record was not DFS0740I DBRC SAYS NO BACKOUTS NEEDED
found. FOR DB xxxxxxxx
1B TRKCALC macro failed. Explanation: When you issue a /START DB command
1C Latest OLDS could not be terminated. without the NOBACKOUT keyword, DBRC might tell
1D Allocation of the log data set failed. IMS that backouts are not required. However the IMS
Dynamic allocation failed, a DD online system might still think that backouts are
statement is missing, or OPEN failed. required. This situation occurs when batch backouts
The left half of Register 15 contains have already run successfully.
the DFSMDA return code.
1E Next log data set record was not System action: IMS continues processing. Control
found in the RECON data set, or the blocks maintained by the online IMS system to track of
next OLDS is marked invalid. the backout data are released as if the operator
1F Latest log data set record was not specified NOBACKOUT.
found in the RECON data set, or the Operator response: No action is required.
next OLDS is marked invalid.
20 Reusable OLDS is unavailable. Module: DFSDBDR0
all data for that detail or spill record does not fit into In the message text:
one detail or spill record. The message is issued for one rrr The region where the storage was fixed and
of these reasons: indicates CTL for the control region or DLS for
v One of the split detail records is missing. the DL/I subordinate address space region.
v One of the split spill records is missing. x The page fix error return code and is defined
v A detail record is marked as having spill records, but as follows:
the Change Accumulation utility did not receive any v 04 One or more entries could not be fixed.
spill records for that detail record. v 08 Insufficient number of pages available to
satisfy request.
In the message text: v 0C List format invalid.
xxxxxxxx v 10 Parameter list pointer invalid.
The name of the database with the record
System action: IMS continues processing.
System action: The utility reading the CA data set
Problem determination: 36
terminates processing.
Module: DFSIFIX0
System programmer response: Supply all CA volumes
to the utility reading the CA data set; then rerun the Related information:
utility. Chapter 2, “IMS problem determination,” on page 5
Problem determination: 2, 3
Module: DFSUC350
Related information:
Chapter 2, “IMS problem determination,” on page 5
System action: IMS continues running. whose DDNAME=PROCLIB, more than 62 areas must
be fixed.
Operator response: (master terminal) Either continue
running IMS without the parts fixed or allocated in System action: IMS continues running.
DREF storage, or do a shutdown checkpoint and rerun
Operator response: (master terminal) Either continue
after DFSFIXnn or DFSDRFnn has been corrected.
running IMS without the fixed parts, or do a shutdown
Programmer response: Correct the invalid word in the checkpoint and rerun after DFSFIXnn has been
DFSFIXnn or DFSDRFnn member. corrected.
Problem determination: For a description of the Programmer response: Reduce or combine areas to be
DFSFIXnn member, see DFSFIXnn member of the IMS fixed, and correct the member DFSFIXnn.
PROCLIB data set (System Definition). For a
Problem determination: For a description of the
description of the DFSDRFnn member, see DFSDRFnn
DFSFIXnn member, see DFSFIXnn member of the IMS
member of the IMS PROCLIB data set (System
PROCLIB data set (System Definition).
Definition).
Module: DFSIFIX0
Module: DFSIFIX0
Operator response: (master terminal) If page fixing Note: For Fast Path blocks that are page fixed, In rrr
was processed as expected, no action is needed. If is not displayed. Fast Path blocks are page fixed in the
problems were encountered, either continue running control region (CTL). If the total size of all DEDB
IMS without the page-fixed parts or do a shutdown blocks in the system exceeds 1 MB, IMS displays
checkpoint and restart IMS after DFSFIXnn has been multiple DFS0759I messages during start-up.
corrected.
System action: IMS continues processing.
Programmer response: If page fixing was not
processed as expected, correct the parameters in Module: DFSIFIX0
DFSFIXnn and restart IMS.
Problem determination: See a description of the DFS0760I THE FOLLOWING FIX|DREF
DFSFIXnn member. OPERANDS WERE NOT FIXED
IN|ALLOCATED IN DREF IN rrr:
Module: DFSIFIX0 xxxxxxxx
Related reference:
Explanation: The operand specified has not been fixed
DFSFIXnn member of the IMS PROCLIB data set or allocated in DREF storage in the region indicated
(System Definition) byrrr. The variable rrr is either CTL for the control
region or DLS for the DL/I subordinate address space.
Related information:
Either a pool or block name has been incorrectly
“DFS0755I” on page 195 specified, or the module specified has not been loaded
“DFS0759I” in region rrr.
System action: IMS continues processing.
DFS0758I FIX FAILURE: MORE THAN 62 AREAS
Programmer response: If a pool or block name was
TO BE FIXED
intended, update member DFSFIXnn or DFSDRFnn in
Explanation: To FIX storage as described by the the IMS procedure library (DDNAME=PROCLIB) to
parameters in the member DFSFIXnn of the data set correct the specification. For a request to page fix a
module, this message might be normal if the DL/I
address space has been selected, because the module Note: The second line is not displayed if the I/O
will be located in one region and not in the other operation was not started.
region. The third line shows the name of the data set on which
the error was located.
Problem determination: For a description of the
DFSFIXnn member, see DFSFIXnn member of the IMS
The variable fields are defined as follows:
PROCLIB data set (System Definition). For a
FUNC=aa
description of the DFSDRFnn member, see DFSDRFnn
The OSAM operation type - defined as
member of the IMS PROCLIB data set (System
follows:
Definition).
01 Read-specific OSAM block
Module: DFSIFIX0 02 Reserved
03 read multiple OSAM buffers
* 04 Scan for file mark
DFS0761I SPACE NOT AVAILABLE FOR
05 Reserved
<PGFIX|DREF> PARAMETER LIST
06 Reserved
Explanation: Storage to build a PAGE FIX or DREF * 07 STAE
parameter list in response to the parameters specified 08 Write specific OSAM block
in the member DFSFIXnn or DFSDRFnn of the data set 09 Reserved
described by the DDNAME=PROCLIB does not exist in * 0A Write queued buffers
the IMS control region. * 0B Write sequential block
* 0C Format logical cylinder
System action: IMS continues running. * 0D Write file mark
Operator response: (master terminal) Either continue 0E Reserved
running IMS without the parts fixed or allocated in * 0F Format extent
DREF storage, or do a shutdown checkpoint and rerun * 10 REDRIVE after EOV
after the region size has been changed. * 11 REDRIVE after DDR SWAP
* 12 Post tape RRQ in error
Programmer response: Increase the size of the IMS 13 Virtual format logical cylinder
control region by a size equal to one page.
(* Indicates internal functions.)
Module: DFSIFIX0 STATUS=bb
The IOSB/IOB completion code used to post
DFS0762I OSAM (TAPE|DASD) (READ|WRITE) the operation complete.
ERROR - FUNC=aa cc The DECB status code (DECBSTAT) is defined
STATUS=bb,cc,dddd,eeee,ffff as follows:
01 Undefined operation code
or 02 DCB not open
03 IDAL translation error
04 Channel program protection error
OSAM UNIT=gggg FAILING CCW=hh,,ii,jjjj
05 Incorrect length error (bad DCBBUFL)
IOSEEK=kkk...kk LOG=llll
06 Permanent I/O ERROR
07 DCB specified as DD Dummy
or
08 RBN conversion error
09 RBN beyond current end of data set
OSAM DSN=............... 0A End-of-file reached
Explanation: An OSAM I/O error was encountered. A 0B Caller not authorized for call type
two or three line message, each numbered DFS0762I, is 0C Unable to obtain channel program work
generated. area
0D No space to add block to data set
The first line indicates (1) whether the I/O operation 0E Reserved
was directed to a tape or to a direct-access device, (2) 0F Reserved
whether the I/O operation was READ or WRITE, (3) 10 Unable to allocate an IOSB from the OSAM
the OSAM operation type, and (4) the ending status of I/O storage pool
the operation. 11 New block request for existing block
The second line indicates (1) the 4-character UNIT 12 I/O prevented
name, (2) the failing channel command word, (3) if the 13 Write queue errors (buffer prefix contains
device is direct access, the full disk address associated status)
with the I/O operation, and (4) the IMS log record 14 Buffer ignored due
types under which OSAM I/O control blocks were 15 IOSB/IOB address invalid - write
logged. sequential
16 Request ignored due
System action: System continues, but with possible Resources shortages are generally caused by an
performance degradation. abnormally high volume of activity under the following
TCBs:
Operator response: Either continue running IMS
without the fixed parts, or shutdown checkpoint and TCB Possible causes of selective dispatching
rerun when more real storage is available. CTL
v High volume of communications activity.
Programmer response: Make certain more real storage
v Insufficient number of SAPs defined for the
is available to the IMS control program during the next
size of the terminal network.
execution.
v A disruptive event that caused
communications processing to be
DFS0767I OTMA MESSAGE FLOOD interrupted and a flood of queued
CONDITION HAS BEEN RELIEVED communications work.
FOR MEMBER YYYYYYYY v IMS internal problems.
ALM
Explanation: The IMS system has processed the v High volume of LU 6.2 communications
OTMA input messages to reduce the number of active activity.
input messages in the input queue. The input messages v A disruptive event that caused LU 6.2
from the member have reached 50% or below of the communications to be interrupted and a
maximum active input message count. flood of queued LU 6.2 work.
System action: IMS continues to process OTMA v An application program coded to maintain
messages from the member. allocated LU 6.2 conversations for an
extended period.
Programmer response: This message informs the v IMS internal problems.
programmer that the OTMA message flood condition
has been improved. When an IMS TCB is in selective dispatching, only
Module: DFSYFD00 priority units of work (for example, the MTO terminal)
and those already holding resources can be processed
until the resources become available again. This could
DFS0768I AN INVALID BSAM FORMATTED degrade response time for some terminal users.
RECORD WAS DETECTED IN
DDNAME=xxxxxxxx. IT HAS BEEN The SAP resource can cause selective dispatching when
CLOSED it is. in short supply. SAPs are IMS internal control
Explanation: A record in data set DDNAME=xxxxxxxx blocks that are required to process IMS units of work,
violated BSAM formatting rules for variable-length communication requests (terminals) and LU 6.2
records. requests. If the supply of available SAPs becomes low,
IMS attempts to allocate additional SAPs up to a
System action: An AF status code is returned to the maximum amount. If no SAPs are available to process
database PCB. GSAM control blocks and the buffer a unit of work, IMS invokes selective dispatching for
containing the invalid record are written to the IMSERR SAPs. When this occurs, IMS units of work can be
or SYSPRINT data set. If another call is made to this processed only when another unit of work terminates
data set without reinitializing GSAM, abend 0272 is and releases its SAP. This can cause degraded
issued. performance of the IMS system.
Programmer response: Terminate the program, and System action: Continues processing.
correct the data set.
Operator response: This message indicates a possible
Problem determination: 1, 2, 3, 8, 18, 19, 35 resource shortage. If this message occurs frequently, or
Module: DFSZD210 is accompanied by performance degradation, the
system programmer should be informed.
Related information:
System programmer response: This message does not
IMS abend 0272 necessarily indicate that there is a problem with IMS.
Chapter 2, “IMS problem determination,” on page 5 Selective dispatching can occur for legitimate reasons
(for example, during an IMS checkpoint, or due to
quick peaks in communications activity. If this message
DFS0769I ttt SELECTIVE DISPATCHING - rrrr
occurs frequently or is accompanied by IMS
Explanation: Selective dispatching was in effect since performance problems such as poor terminal response
the last checkpoint because of a resource shortage. ttt time, then additional analysis is advisable.
identifies the TCB under which selective dispatching
If the TCB in selective dispatching is CTL, the number
was in effect. rrrr identifies the resources which had the
of available dynamic SAPs can be increased by
shortage.
changing the SAV= parameter on the IMS startup JCL
or in the DFSPBxxx members. identifies the program for which no backouts were
done.
If the TCB in selective dispatching is ALM, the problem
could be an application program that does not The IMS alternate system taking over the workload of a
deallocate its LU 6.2 conversation for a long period. failing active system does not know how or where the
This can occur when an application program does not failing or degraded active system is changing the
receive an immediate LU 6.2 response to CONFIRM. end-of-data. For this reason, IMS cannot use this
database safely until the failing active system has
A dispatcher statistics log record (type X'45' subcode
terminated.
X'0F') is written at each checkpoint. These log records
should be printed and analyzed for selective System action: The backouts for this database have
dispatching problems. Additional statistics records been deferred, and the database is stopped. Either
(type X'45') might be useful in indicating high storage message DFS2012I or DFS0773I are issued when the
pool utilization. Any problem reports related to database is stopped.
selective dispatching should include a copy of the IMS
Programmer response: When the failing active system
log that contains the checkpoint intervals during which
has terminated, you can safely start the database again.
the problem occurred or a printed copy of the X'45'
If the log containing the database changes to be backed
records for those checkpoints.
out has already been archived, you must run Batch
Problem determination: 5, 6, 23 34 Backout for the PSB identified in this message. Then
start the database with the NOBKO parameter of the
Module: DFSSTAT0
/START DB command or issue UPDATE DB
Related information: START(ACCESS) OPTION(NOBACKOUT).
Chapter 2, “IMS problem determination,” on page 5
Module: DFSRBOI0
Related information:
DFS0770W NO FP CONTROL BLOCKS ARE
“DFS0773I”
ABOVE 16 MB
“DFS2012I” on page 418
Explanation: Fast Path control block module
(DBFCONT0) was not allocated in ECSA because of
insufficient storage. DFS0773I DATA BASE - dddddddd STOPPED.
System action: IMS gets storage from CSA and Explanation: A non-block level shared database was
continues processing. being extended by the failing active IMS system during
takeover. The variable dddddddd identifies the database.
Programmer response: Notify the z/OS system
programmer. The IMS alternate system taking over the workload of a
failing IMS active system does not know how or where
Module: DBFIFIX0 the failing or degraded active is changing the
end-of-data. For this reason, IMS cannot use this
DFS0771I IMS LOGGING IS NOT IN EFFECT. database safely until the failing active terminates.
Explanation: IMS LOGGING is not in effect because System action: This database has been stopped until
an extended, or symbolic, checkpoint call has been the failing active terminates. You cannot enter a
issued and the IEFRDER DD statement is missing or /START DB or UPDATE DB START(ACCESS)
has been defined as DD DUMMY. command until the new active IMS system knows that
I/O Prevention is complete.
System action: If the IEFRDER DD is defined as DD
DUMMY, only the message is issued and processing Programmer response: When the failing active IMS
continues. If the IEFRDER DD statement is missing, the terminates completely, you can safely start the
call continues to be processed but STATUSNL is database.
returned in the IOPCB. Module: DFSHDCL0
Programmer response: If logging is needed for this
job, add an IEFRDER DD statement to the JCL. DFS0774I (CCCCFFSS) AREA=AREANAME
Module: DFSPR000, DFSZSC00 DD=DDNAME, AREA CLOSED, MUST
COMPLETE TOSSED,
CI-RBA=NNNNNNNNN, SEVERE
DFS0772I KSDS EXTENDING AT TAKEOVER - ERROR
DBD dddddddd, PROGRAM pppppppp
NOT BACKED OUT Explanation: An attempt was made to write to a
closed area. This situation indicates a system error.
Explanation: A VSAM KSDS was being extended by
the failing active IMS system during takeover. The System action: The WRITE MUST COMPLETE DMHR
variable dddddddd identifies the database; pppppppp is disregarded, and the dependent region is terminated.
System programmer response: Contact IBM service. xxxxxxxx ERROR eeeeeeee SENDING/RECEIVING
SIDTABLE TO/FROM MSC SUBSYSTEM yyyyyyyy,
ACTION = zzzzzzzz
DFS0775I COMMAND REJECTED; TCO IS NOT
ACTIVE Explanation: This message is produced when the
multiple systems communications (MSC) feature is
Explanation: You entered a /TRACE SET ON|OFF
supported in a shared queues group (SQG)
TCO command, but the Time-Controlled Operations are
environment and one of the following events occurs:
not active.
v An IMS subsystem joins or leaves the shared queues
System action: The command is rejected. group.
v An error is detected while sending or receiving the
Operator response: Start the Time-Controlled MSC system identification table (SIDTABLE) to or
Operations before entering the command. from another IMS while processing an IMS
Module: DFSICLN0 subsystem join or leave.
v An error is detected while merging a SIDTABLE
received from another IMS that has joined the shared
DFS0776A AMP PARAMETER INVALID FOR queues group.
OSAM DATASET- DDNAME xxxxxxxx v A residual SIDTABLE storage area is being freed that
Explanation: A DD statement for an OSAM data set was created from a previous merge of the
contained the parameter AMP, which is not valid for SIDTABLES when an IMS subsystem joined the
OSAM. shared queues group.
or Routine Description
FREEAWSI
xxxxxxxx MSC SUBSYSTEM yyyyyyyy HAS Error freeing received SID table
JOINED/LEFT THE SHARED QUEUES GROUP, storage.
ACTION = zzzzzzzz FREEEND
Error freeing storage at end
or processing.
FREEOSID
Error freeing old SID table storage
after merge.
This message is issued for all abends, whether a System action: Even if a transaction retry is
transaction retry is attempted. It is issued: attempted, the system continues to terminate
1. At the time of the initial failure, before a potential abnormally, providing the usual memory dumps,
transaction retry. entries to the log tape, and collecting diagnostic
2. At the time the failure recurs after a transaction information.
retry attempt, if the retry results in a failure. Operator response: No action is required.
Note: The failure occurring on the transaction retry System programmer response: Save the diagnostic
might not be the same as the original failure, although information. Contact IBM Software Support for
this should be an exceptional case. assistance.
Explanation: This message is issued after an System programmer response: No action is required.
unsuccessful transaction retry, and follows message
Module: DBFTCMT9
DFS0781I, ABEND cccc IN mmmm.
Related reference:
Note: If transaction retry fails with an abend identical Interpreting Error Reason Codes from DYNALLOC
to the original failure, this information is provided
twice: once when the failure occurs, and a second time
when transaction retry reproduces the failure.
DFS0789I GETMAIN FAILED TO
System action: The system again terminated DYNAMICALLY ALLOCATE TRACE
abnormally while in the process of executing DATASET
transaction retry.
Explanation: This is an informational message only.
Operator response: No action is required.
System action: The system continues transaction retry
System programmer response: Save the diagnostic without tracing, attempting to acquire the needed
information. Contact IBM Software Support for resource at the time of the next application program
assistance. calls.
Module: DBFTCMT9 Operator response: No action is required.
System programmer response: No action is required.
DFS0787I TRANSACTION RETRY WAS
ATTEMPTED AND COMPLETED Module: DBFTCMT9
SUCCESSFULLY
Explanation: This message is issued at entry to the DFS0790I OPEN FAILED FOR DYNAMICALLY
sync process of the retried transaction after a successful ALLOCATED TRACE DATASET
transaction retry.
Explanation: This is an informational message only.
System action: Sync processing continues for the
System action: The system continues transaction retry
retried transaction.
without tracing, attempting to acquire the needed
In this case, the system does not stop the transaction resource at the time of the next application program
and overrides the action indicated in message calls.
DFS554A.
System programmer response: No action is required.
Operator response: No action is required.
Master terminal operator response
System programmer response: Save the diagnostic
No action is required.
information. If the error recurs, contact IBM Software
Support for assistance. Module: DBFTCMT9
Module: DBFTCMT9
Related information: DFS0791A PROCESSING OF HSSP HIC/PIC BY
DB RECOVERY TERMINATED
“DFS554A” on page 137
ABNORMALLY FOR AREA=xxxxxxxx
DD=yyyyyyyy REASON CODE=zz
Explanation: This message is issued during execution
of the Database Recovery utility when an error
involving an HSSP Image Copy (HIC) or HSSP Partial
Image Copy (PIC) occurs. The Database Recovery System action: Processing terminates with a nonzero
utility failed. The following reason codes indicate the return code.
cause of the problem:
Programmer response: Delete and redefine the VSAM
Reason code data set that is being opened for output as the target
Explanation data set.
10 DD statement for Area xxxxxxxx DD yyyyyyyy
was missing in the JCL.
DFS0793I THE TOTAL OTMA
20 Utility was unable to open a DCB with
SEND-THEN-COMMIT(CM1)
DDNAME yyyyyyyy.
CONTROL BLOCKS (TIB) HAS
30 VSAM SHOWCB failed.
DECREASED BELOW nnn
40 VSAM MODCB failed.
50 Either the date/time stamp in the second CI Explanation: This message is issued during an OTMA
does not match the HIC/PIC time stamp, or message flood condition to provide status on the flood
the second CI indicates that the data set is not condition. The total number of uncompleted OTMA
an image copy data set. commit mode 1 (CM1) messages from all the OTMA
60 The PIC time stamps are not in chronological clients is decreasing.
order.
70 The date/time-stamp does not match the System action: Processing continues. An OTMA
stamp in the log record for any of the input protocol message with the OK status is sent to all the
HIC/PIC data sets. OTMA clients.
Programmer response: For reason code 10, ensure that System programmer response: The global OTMA
all required DD statements are supplied. message flood condition has been resolved. However,
an individual OTMA member might still experience a
For reason code 20, use the memory dump to flood condition.
determine the cause of the open error (see z/OS DFSMS
Macro Instructions for Data Sets for possible causes of Module: DFSYFD00
failure).
For reason codes 30 and 40, contact your IBM DFS794I APPLICATION NOT PERMITTED TO
representative. REASSIGN LTERM IT IS USING
For reason code 50, ensure that all HIC/PIC data sets Explanation: The /ASSIGN command was rejected
used are valid. because AOI programs are not permitted to reassign an
LTERM that the application is using.
For reason code 60, ensure that the PIC time stamps
contained in SYSIN are in date/time sequence. System action: The command is rejected. If the
command was /ASSIGN LTERM PRIMARY, the
For reason code 70, ensure that SYSIN contains all primary master terminal assignment might have
needed HIC/PIC time stamps. succeeded.
Problem determination: 2, 3, 4, 8, 20, 36, and listings Programmer response: Redesign the AOI application
of the RECON data sets. program so that it does not issue an /ASSIGN
command that reassigns an LTERM it is already using.
Module: DBFUHIC0
The LTERM in the redesigned AOI program cannot be
Related reference: any of the following:
v The LTERM that originated the AOI transaction
OPEN--Connect Program and Data (BDAM, BISAM
v The destination LTERM to which the application is
interface to VSAM, BPAM, BSAM, QISAM interface to
inserting messages
VSAM, and QSAM)
v The alternate destination LTERM to which the
Related information: application is inserting messages
Chapter 2, “IMS problem determination,” on page 5
Module: DFSICL70
primary master terminal assignment might have System action: Processing halts and return
succeeded. code is set to 8.
Operator response: (master terminal) Notify the User response: Check and correct the error
system programmer. condition indicated by the message and reason
code.
System programmer response: See the topic titled
“IMS problem determination”. REASON = 03 DATABASE NOT FOUND IN DBDLIB
- &DBNAME
Problem determination: 1, 6, 36, 41
The specified DBD, &DBNAME, is defined in
Module: DFSICL70 RECON as a HALDB, but it was not found in
Related information: DBDLIB.
Chapter 2, “IMS problem determination,” on page 5 System action: Processing halts and return
code is set to 8.
DFS0796A IS NOT A VALID HALDB MASTER User response: Check and correct the error
OR PARTITION DATABASE, condition indicated by the message and reason
REASON=nn code.
Explanation: One of the following errors was REASON = 04 INITALL NOT ALLOWED FOR
encountered: PARTITION - &DBNAME
A conflict resulting from a SYSIN statement
Code (hex) specifying a partition name that is a partition
Meaning of a HALDB master name &DBNAME which
01 The DBD specified was not found in DBDLIB. also appears in a different SYSIN statement.
02 The DBD specified was found in DBDLIB but
is not a HALDB DBD. System action: Processing halts.
03 The specified HALDB DBD does not exist in
User response: Remove the conflicting
RECON.
statements specifying partition names, if you
04 The specified HALDB partition does not exist
want to initialize (INITALL) all of the HALDB
in RECON.
partitions; or remove the INITALL statement
System action: Processing continues if other HALDB from the DFSOVRDS data set to
master databases or partitions are to be processed and unconditionally initialize specific partitions.
return code is set to 8. Remove the HALDB master name if no
additional partitions existing in RECON and
User response: Check and correct the error condition recorded as PINIT=YES (partition initialization
indicated by the reason code. required) are to be initialized.
Module: DFSUPNT0, DFSUPNT1 Module: DFSUPNT0
DFS0796I Reason Code = rc message DFS0797E The database PCB control blocks were
Explanation: An error occurred, indicated by rc, with incorrectly built for HALDB master
an accompanying message issued by module database
DFSUPNT0. Each reason code has its own explanation Explanation: Validation of the PCB control blocks for
and response. See the following reason codes and the specified HALDB master database failed. This is an
messages to further identify the type of error and IMS internal error.
appropriate action:
System action: Processing is halted.
REASON = 01 DATABASE OR PARTITION NOT
FOUND IN RECON - &DBNAME Operator response: Call IBM Software Support to
The specified DBD, &DBNAME, does not exist report this problem.
in RECON.
Module: DFSUPNT0, DFSUPNT1
System Action: Processing halts and return
code is set to 8. Check and correct the error
DFS0798I eee PROCESSING COMPLETE FOR
condition indicated by the message and reason
jjjjjjjj RC=0000
code.
RSN=00000000 ASCB=aaaaaaaa
REASON = 02 DATABASE IS NOT A HALDB DBD ASID=dddd
OR PARTITION - &DBNAME TRC=tttttttttttttttt:zzzzzzzz
The specified DBD, &DBNAME, is not defined
Explanation: An end of memory (EOM) event for an
in RECON as a HALDB.
IMS dependent region has been detected and
processed.
Explanation: The operator gave an invalid reply to Other system data set failures (Operations and
one of the following messages: DFS816A, DFS817A, or Automation)
DFS818A. Related information:
DFS823I UNABLE TO OPEN DDN 'IMSACBx' DFS825I BLDL FAILED FOR ALL DEFINED
IN (CTL|DLS) ADDRESS SPACE. DATA BASE DIRECTORIES
Explanation: A permanent I/O error might have Explanation: No valid directory entries for databases
occurred during OPEN. x=A or B depending upon named at IMS system definition time could be found
whether IMSACBA or IMSACBB is active. DLS is on the data set allocated to ddname IMSACB.
included in this message if the error occurred in the
System action: IMS terminates with abend 0071.
DL/I subordinate address space.
Operator response: (master terminal) Contact your
System action: IMS terminates with abend 0071 or
IMS system programmer.
0821.
Programmer response: Ensure that at least one
Programmer response: Ensure that ddname IMSACBx
DBDGEN for the defined system has been run and that
is allocated properly and that the data set specified at
it is placed in the ACBLIB data set defined by ddname
IMS system definition time exists. x=A or B.
IMSACB. If DBDs exist in the IMSACB library, validate
Problem determination: Check the JCL to ensure that the IMSACB library is built at the same IMS level
proper allocation per the IMS system definition as the IMS execution library.
information.
Problem determination: Message DFS826I contains a
Module: DFSBIND0, DFSIIND0 list of reasons for which the directory entries might
Related concepts: have been invalid.
Module: DFSRDB30
Other system data set failures (Operations and
Automation) Related concepts:
Related information: Other system data set failures (Operations and
Automation)
IMS abend 0071
Related reference:
IMS abend 00821
BLDL Completion Codes
Related information:
DFS824I DFS824I PDS DIRECTORY READ
ERROR DDN 'IMSACB ' RC=xx “DFS826I”
RSN=yy
IMS abend 0071
Explanation: An I/O error has occurred while trying
to read the PDS directory for ddname IMSACBx. The
DFS826I BLDL FAILED FOR FOLLOWING
return code from the call to the BLDL macro is shown
DBDs:
as xx, and the reason code is yy.
System action: IMS terminates with abend 0071 or or
0821.
Programmer response: Check the JCL to ensure xxx DBD ERRORS SENT TO JOB LOG
proper allocation per the IMS system definition
information. or
DFS827I DYNAMIC PSB psbname BLDL DFS830I BLDL FAILED FOR FOLLOWING PSBs;
FAILED-aaaaa
Explanation: The BLDL for the PSB indicated by or
psbname in the message failed for the reason specified
by one of the following codes, aaaaa in the message xxx PSB ERRORS SENT TO JOB LOG
text:
or
Name Meaning
IOERR I/O error reading the directory xxx PSB ERRORS SUPPRESSED
NOFND
Member not found Explanation: The first form of this message is repeated
CONCT as PSB names are listed that were not found or did not
Member is in first concatenation. meet requirements on ACBLIB. A reason follows each
ALIAS Member is an alias. name. See message DFS826I.
NOTPS
For the second form of this message, more than ten
Member is not really a PSB.
PSB errors were found; xxx is the number of PSB errors
NOBUF
found.
No buffer size was available.
NOTCP System action: IMS continues running if running in
Not compatible either a CTX or CTL type IMS region. IMS terminates
with abend 0821 if running in a DBB type IMS region.
System action: IMS continues running.
Programmer response: For the first form of this
message, note that no programs or transactions that use wwww The pseudo-abend code.
the named PSB are scheduled for execution by IMS. xxxx One of the following:
v The reason code for HALDB abends, or N/A
For the second form of this message, see the job log for
for non-HALDB abends.
all DFS830I messages.
v One of these detected IMS abends:
IMS issues the third form of this message if you 0880
specified MSG0830=SUPPBLDL in the DFSDFxxx PROCLIB 3303
member. DFS830I messages are not sent to the job log. 3498
Module: DFSBIND0, DFSIIND0 For these abends, the reason code is yyyy
Related reference: and it is related to a problem that was
detected while processing a HALDB.
BLDL Completion Codes yyyy If xxxx (the abend) is not one of the above, the
Related information: value of yyyy is N/A otherwise it is one of the
following reason codes:
“DFS826I” on page 213 4001 No more partitions are defined
4020 DB authorization error (data
DFS831I BLDL FAILED FOR ALL DEFINED unavailable)
PROGRAM DIRECTORIES 4025 DB unload action error
4026 DB initialization action error
Explanation: No valid directory entries for programs 4032 Partition unavailable due to a
defined during IMS system definition were found in migrated data set.
the ACBLIB data set allocated to ddname IMSACB. 4059 The access level is not compatible
During initialization, the PSBs defined during IMS with the intent level
system definition, or defined in the CICS program 8001 Target partition requires initialization
directory (PDIR), are loaded and validated. At least one 8010 Target partition not found
valid PSB must be found in ACBLIB. If no PSBs, or no 8011 An invalid key for a partition was
valid PSBs are found, message DFS831I is issued. found.
8031 Open DMB failure
System action: IMS terminates with abend 0071. 8051 User partition selection failed
Operator response: (master terminal) Make sure that C001 Non-partitioned DB access
no message regions were going to be run. If yes, C002 Partitions not active
contact your IMS system programmer for assistance. C003 Partition stopped
C004 Partition structure terminating
Programmer response: Check the JCL for proper C005 Partition structure not initialized
allocation. In addition, ensure that at least one PSBGEN C006 Partition structure rebuild failed
for a non-DOPT PSB was run, and that the PSB is C009 ILDS DSG not provided
placed in the ACBLIB data set defined by ddname C010 Unusual structure status
IMSACB. C030 Invalid authorization reason code
C031 Partition open error
Module: DFSRDB30
C040 Invalid partition DDIR
Related concepts: C041 Invalid partition set operation
C042 Unable to allocate PSETE storage
Other system data set failures (Operations and
C043 Invalid partition set selection action
Automation)
C050 User selection exit not invoked
Related information: C060 Invalid function code
C070 Buffer handler byte locate failed
IMS abend 0071
C071 Buffer handler locate by key failed
C072 Error occurred during processing
DFS0832I ABEND Uwwww REASON CODE xxxx against the indirect list data set
yyyy PARTITION | DATABASE zzzzzzzz (ILDS).
C073 Buffer handler mark altered failed
Explanation: Use this message to assist in debugging
C074 Buffer handler byte locate & mark
problems that cause an IMS abend. This message is
altered failed
issued when an abend condition is detected by module
C075 IRLM root lock request (GRID) failed
DFSDLA00. This condition can be caused by either:
C076 Request to obtain BCB storage
v A non-zero return code on a partition selection or
(BCBGET) failed
validation.
C077 Refresh OLR cursor request failed
v A pseudo-abend set by module DFSDLR00,
PARTITION | DATABASE
DFSDDLE0, DFSDXMT0, DFSDLD00, or DFSRCHB0.
If HALDB, PARTITION. If non-HALDB,
DATABASE.
In the message text:
System action: No data management blocks are made Module: DFSBIND0, DFSIIND0
resident. Related concepts:
Programmer response: Either provide more space in Other system data set failures (Operations and
the area where the space is obtained or make fewer Automation)
installation of RACF, analyze the return and reason new extent does not match the volume serial
codes for racf-function in z/OS Security Server number broadcast by the extending subsystem.
RACROUTE Macro Reference (SA22-7692).
3 DSXT0360 An error occurred while processing
To bypass all RACF checking for online IMS systems, an OSAM TCLOSE function for the data set. A
modify the z/OS program properties table for TCLOSE is the closing and reopening of the
DFSMVRC0 as described in z/OS MVS Initialization and data set to acquire new extent information.
Tuning Reference (SA22-7592).
4 LCREAT10 An error condition was returned
Problem determination: 1,3,4,6 from the LCTSRCH routine. This problem
might have been caused by an I/O error on
Module: DFSXRAC0
the data set.
Related reference:
| 5 LCREAT30 An attempt to get another extent
RACROUTE Return codes and reason codes | for the data set using the OSAM
| end-of-volume routine resulted in one of the
System tailoring | following two conditions:
Related information: | v The end-of-volume routine failed. The data
| set could not be enlarged and another
IMS abend 0029
| extension could not be allocated.
Chapter 2, “IMS problem determination,” on page 5
| v The end-of-volume routine was successful,
| but the total number of extents used is 55 or
DFS0842I OSAM DATASET CANNOT BE | more, nearing the allowable maximum of
EXTENDED, REASON=X, dbdname | 60.
ddname, dsname
6 LCREAT40 An attempt to obtain a buffer for
the requested block failed. This problem might
| or have been caused by I/O errors on one of the
OSAM data sets sharing the same set of
| OSAM DATA SET NEAR MAX EXTENTS (NN OF buffers.
| 60), REASON=X, dbdname
| ddname, dsname 7 LCREAT70 An I/O error was received during
the format logical cylinder operation.
| Explanation: OSAM was unable to extend the named
| data set, or the total number of extents allocated for the System action: For condition 1, 2, or 3, the application
| data set is 55 or more, nearing the maximum allowance program pseudoabends with abend 0842. For the other
| of 60. A two line message, each numbered DFS0842I, is conditions, processing continues and message DFS0845I
| issued. The first line indicates why the data set is not might follow.
| extendable or the total extents allocated so far. It also
Operator response: (master terminal) Notify the IMS
| contains the dbdname. The second line contains the
system programmer or database administrator of the
| ddname and the dsname.
condition.
In the message text:
Programmer response: Take the following actions:
X The reason code that identifies the error
v If data set extend error 1, 2, or 3 occur in a data
condition
sharing environment, ensure that all the volumes of
dbdname
the database are shared among the subsystems and
The database name
that a path exists to all volumes.
ddname The data definition name
v If data set extend error 5 occurs, add additional
dsname The data set name
space or reduce the number of DASD extents, by
reorganizing the database or recovering the database
One of the following reason codes (X) identifies the with larger space parameters. After an extend error
error condition. The first word in the description is the 5, if an OSAM data set cannot be opened because it
label name where the error was detected. Conditions 1, extends beyond the OSAM-supported maximum
2, and 3 occur only in a data sharing environment number of extents, you might need an intermediate
when the data set was extended on another subsystem. utility step when opening the data set to allow the
The subsystem with the error was unable to perform a system to release the unused extents. For example,
similar extension. use an ADRDSSU job with RELEASE, or a copy
X reason code utility such as IEBGENER with a dummy input data
Error condition set and the OSAM data set as output, specifying
DISP=MOD and
1 DSEXTEND, the DCB for this data set, was SPACE=(xxx,(primary,secondary),RLSE). For
marked nonextendable. information about extends, see Using OSAM as the
2 DSXT0350 The volume serial number for the access method (Database Administration).
under the Utility Control Facility, rerun the job with a Chapter 2, “IMS problem determination,” on page 5
FUNCTION=OP,MSGNUM=856 control statement in
the DFSYSIN data set. Supply a SYSUDUMP DD
DFS859A DL/I RETURNED AN ERROR CODE
statement to this step.
OF return code FOR FUNCTION ff
Module: DFSURGP0, DFSURGS0, DFSURPR0
Explanation: The issuing program received an
Related information: unexpected return code after a DL/I call.
Chapter 2, “IMS problem determination,” on page 5
System action: Processing terminates with a nonzero
return code.
DFS857I MISSING OR INVALID CONTROL
Programmer response: Correct any errors indicated by
DATASET
the return code, and resubmit the job.
Explanation: The issuing program attempted to read
Problem determination: 2, 3, 8, 36. Also, if running
the input control data set generated by the Database
under the Utility Control Facility, rerun the job with a
Prereorganization utility (DFSURPR0). One of the
FUNCTION=OP,MSGNUM=859 control statement in
following conditions occurred:
the DFSYSIN data set. Supply a SYSUDUMP DD
v You did not provide a control data set.
statement to this step.
v The control data set identified was not present in the
first block of the control data set. Module: DFSURGP0, DFSURGS0
v The control data set did not contain the number of Related information:
blocks indicated in the first block of the control data
set. Chapter 2, “IMS problem determination,” on page 5
Problem determination: 2, 3, 8, 36. Also, if running Explanation: The issuing program is displaying an
under the Utility Control Facility, rerun the job with a input control statement provided for it. Numbers are
FUNCTION=OP,MSGNUM=858 control statement in assigned sequentially for reference by subsequent error
the DFSYSIN data set. Supply a SYSUDUMP DD messages that might be generated.
statement to this step. Programmer response: Verify that the information
Module: DFSURGP0, DFSURGS0 displayed is consistent with the entered information.
Related reference: Problem determination: 1, 2, 3, 5, 8, 11, 17a, 17d, 17g,
20, 36
Return and function codes associated with the
external subsystem support (Messages and Codes) Module: DFSURGP0, DFSURGS0, DFSURPR0
Related information: Related information:
Chapter 2, “IMS problem determination,” on page 5 restart. If the output is correct, no further action is
required.
DFS862I DBS=databasename, segmentname Module: DFSURGS0, DFSURPR0
Explanation: This message might be issued more than
one time to provide a list of segments to be scanned by DFS865I UNABLE TO CONSTRUCT A
the Database Scan Utility (DFSURGS0). If an CONTROL LIST ENTRY FOR
OPTIONS=(PUNCH) control statement was provided to FUNCTION database-name1
the program issuing the message, the portion of this segment-name1 database-name2
message beginning with the characters DBS are written segment-name2
to SYSPUNCH.
Explanation: The issuing program was attempting to
Programmer response: The Database Scan Utility construct a control list entry for the logical relationship
(DFSURGS0) must be run for each of the databases that was defined to exist between the above-named
indicated by the scan list provided by this message. database- and segment-names. The definition was not
verified in the control blocks available to DL/I.
Problem determination: 1, 2, 3, 5, 8, 11, 17a, 17d, 17g,
20, 36 Programmer response: Ensure that valid DBDs are
available to define the indicated logical relationship.
Module: DFSURPR0
Related information: Problem determination: 1, 2, 3, 5, 8, 11, 17a, 17d, 17g,
20, 36
Chapter 2, “IMS problem determination,” on page 5
Module: DFSURPR0
DFS863I DUPLICATE NAME ON INPUT Related information:
CONTROL CARD, number Chapter 2, “IMS problem determination,” on page 5
Explanation: The issuing program found a database
name that appeared on the preceding input control DFS866I NORMAL PROGRAM TERMINATION
statement (indicated by number). number
Programmer response: Correct the input control Explanation: The issuing program terminated
statement preceding the message, and resubmit the job. normally. number, if present, is the number of input
work data set records processed by the issuing
Problem determination: 1, 2, 3, 5, 8, 11, 17a, 17d, 17g,
program.
20, 36
Problem determination: 1, 2, 3, 5, 8, 11, 17a, 17d, 17g,
Module: DFSURPR0
20, 36
Related information:
Module: DFSURGP0, DFSURGS0, DFSURG10,
Chapter 2, “IMS problem determination,” on page 5
DFSURPR0
Related information:
DFS864W DBR AND/OR DBIL CONTROL
Chapter 2, “IMS problem determination,” on page 5
REQUESTS MISSING FOR FUNCTION
ff
DFS867I UTILITY CHECKPOINT, pgm-name
Explanation: The issuing program read and
chkpt-# volume-serial
interpreted all the control statement requests from the
SYSIN (DFSYSIN for Utility Control Facility) data set. Explanation: The issuing program completed a
After analysis of the control data set, it was found that checkpoint at one of the intervals specified by the user.
no reorganizations or initial loads were requested. The name of the program issuing the message and the
Although this is possible under the Utility Control checkpoint number are known. The volume serial
Facility, it is an error when executing the Database number that the checkpoint record was written to is
Prereorganization utility (DFSURPR0). also shown.
System action: If running under UCF, processing Operator response: Record the checkpoint number
continues; otherwise, processing terminates with a and volume serial number in case a restart action must
nonzero return code. be requested.
Programmer response: If running under the Utility Problem determination: 1, 2, 3, 5, 8, 11, 17a, 17d, 17g,
Control Facility, ensure that this is correct operation. If 20, 36
not, correct, or if running the Database
Module: DFSURGP0, DFSURGS0
Prereorganization utility, supply the required control
statements, and resubmit the job. Do not attempt a Related information:
Chapter 2, “IMS problem determination,” on page 5
VSAM
DFS868I (INPUT|OUTPUT) VOLUMES: volser1,
ddname The ILDS that encountered the error.
volser2, etc..
nnnnnnnn
Explanation: This message is issued one or more The return code found in register 15 when the
times to display the volume serial identifiers of the error was encountered. If error_type is ABEND,
volumes used to contain the INPUT/OUTPUT work this field is the abend code.
data set of the issuing program. yyyyyyyy
The reason code; if the error type is ABEND,
Problem determination: 2, 3, 8, 36. Also, if running
RC is blank.
under the Utility Control Facility, rerun the job with a
FUNCTION=OP,MSGNUM=868 control statement in System action: Processing terminates with return code
the DFSYSIN data set. Supply a SYSUDUMP DD 8. The affected ILDS is marked “Recovery Needed” in
statement to this step. RECON.
Module: DFSURGS0 Programmer response: Run the ILDS/INDEX Rebuild
Related information: Utility (DFSPREC0) to rebuild the ILDS identified by
ddname.
Chapter 2, “IMS problem determination,” on page 5
Problem determination: 2, 3, 8, 36. Not a valid
message for UCF
DFS869A SEGMENT segment-name WAS NOT
FOUND IN THE CONTROL BLOCKS Module: DFSURGL0
FOR FUNCTION ff Related information:
Explanation: The issuing program was unable to Chapter 2, “IMS problem determination,” on page 5
locate the control blocks for the named segment. The
segment was either listed on an input control
DFS872I DATA BASE NOT SCANNED,
statement, or on the input control data set.
database-name
System action: Processing terminates with a nonzero
Explanation: The named database was not scanned.
return code.
DFS873I is issued before this message.
Programmer response: Ensure that valid DBDs are
Problem determination: 1, 2, 3, 5, 8, 11, 17a, 17d, 17g,
available for the supplied input control statements or
20, 36
control data set, or both, and resubmit the job.
Module: DFSURGS0
Problem determination: 2, 3, 8, 36. Also, if running
under the Utility Control Facility, rerun the job with a Related information:
FUNCTION=OP,MSGNUM=869 control statement in “DFS873I”
the DFSYSIN data set. Supply a SYSUDUMP DD Chapter 2, “IMS problem determination,” on page 5
statement to this step.
Module: DFSURGS0 DFS873I SEGMENT NOT SCANNED,
Related information: database-name segment-name
Chapter 2, “IMS problem determination,” on page 5 Explanation: The issuing program found one or more
of the following errors when checking the control
DFS871E error_type ERROR ENCOUNTERED blocks for the named segment:
LOADING ILDS WITH 1. The named segment was not found in the control
DDNAME=ddname RC= nnnnnnnn blocks for the named database,
REASON= yyyyyyyy 2. The named segment does not participate in any
logical relationships with any of the segments in the
Explanation: Module DFSURIT0 encountered an error databases listed in the control data set as being
during ILDS data set processing for the ILDS identified initially loaded or reorganized.
by ddname while migrating to a HALDB.
Programmer response: Ensure that valid DBDs are
In the message text: available for the supplied control statements or control
error_type data set, or both.
Describes the error encountered. The possible
error types are: Problem determination: 1, 2, 3, 5, 8, 11, 17a, 17d, 17g,
ABEND 20, 36
DSPSERV Module: DFSURGS0
FREEMAIN
GETMAIN Related information:
LOAD Chapter 2, “IMS problem determination,” on page 5
SORT
Explanation: The named utility was requested for Ensure that only work data sets from databases
execution by a control request with a keyword of currently being initially loaded, reorganized, or scanned
FUNCTION=ff, and the control statement request are supplied as input to the issuing program.
sequence was nnnn. Problem determination: 1, 2, 3, 5, 8, 11, 17a, 17d, 17g,
Problem determination: 2, 3, 8, 35. Also, if running 20, 36
under the Utility Control Facility, rerun the job with a Module: DFSURG10
FUNCTION=OP,MSGNUM=875 control statement in
the DFSYSIN data set. Supply a SYSUDUMP DD Related information:
statement to this step. Chapter 2, “IMS problem determination,” on page 5
Explanation: This message is issued one or more Explanation: The issuing program expected to find
times to list the requested or defaulted keyword, and one or more type 10 records for the type 00 input work
values for each requested function of the Utility data set record displayed. A type 00 record is generated
Control Facility. for a logical parent. A type 10 record is generated for
each of its logical children. This condition could be
Important: The defaults for the message are from a caused by not supplying as input to the issuing
FUNCTION=OP statement or UCF only. program all work data sets that were generated by the
databases currently being initially loaded, reorganized,
Problem determination: 2, 3, 8, 36. Also, if running or scanned. Because it is not necessary for logical
under the Utility Control Facility, rerun the job with a children to actually occur for each logical parent, this
FUNCTION=OP,MSGNUM=876 control statement in message is issued as a caution.
the DFSYSIN data set. Supply a SYSUDUMP DD
statement to this step. Prefix resolution might be invalid if this message is
issued. It is also invalid if the user intended to load or
Module: DFSURG10 reload the logical children belonging to the logical
Related information: parent.
Chapter 2, “IMS problem determination,” on page 5 System action: Processing continues.
Programmer response: Ensure that all work data sets
are supplied as input. See DFS877A for information
checkpoint record (type 41) is found for the correct Programmer response: Specify the BLKSIZE value in
PSB. If a checkpoint is present in the message, it is the DD statement and resubmit the job.
always the last checkpoint-id found. If you specified a
Problem determination: 1, 2, 3, 5, 8, 11, 17a, 17d, 17g,
CHKPT statement in the SYSIN data set, and if the
20, 36
checkpoint in the message is different from your
checkpoint, then one of the following occurred: Module: DFSBACK0
v IRLM was used during the update. Related information:
v Another type 41 record exists after the one you
specified, and no type 5X records exist between your Chapter 2, “IMS problem determination,” on page 5
checkpoint-id and the end of the data set.
Programmer response: Check the input log data sets DFS891A DDNAME NOT FOUND OR DEVTYPE
to be sure that the correct log data sets are being ERROR
supplied to the utility. A frequent cause for this Explanation: An OPEN macro or DEVTYPE macro
message to be displayed is the use of logs from the was issued for the active format data set with a
wrong job or the wrong time period. ddname of FORMATA or FORMATB or a DEVTYPE
Problem determination: 1, 2, 3, 5, 8, 11, 17a, 17d, 17g, macro was issued with an invalid AREA address.
20, 36 System action: IMS terminates abnormally with either
Module: DFSBACK0 abend 0889 or abend 0890.
Related information: Programmer response: Rerun the job with the correct
Chapter 2, “IMS problem determination,” on page 5 DD statement.
Module: DFSIINF0, DFSIING0
DFS889I MULTIPLE LOGICAL CHILD Related information:
RECORDS/LP NO LT PTRS SPECIFIED
(followed by one or more lines containing IMS abend 0889
input records in hexadecimal and EBCDIC IMS abend 0890
format)
Explanation: The issuing program found a second DFS892A NOT ENOUGH STORAGE AVAILABLE
logical child record for a logical parent record, but no IN MFBP
logical twin pointers were specified for the logical child
segment type. A return code of 8 is passed to Explanation: Not enough storage was available in the
DFSURG10 from sort exit 35. Abnormal termination message format buffer pool (MFBP) to complete the
message DFS339I is also issued. initialization of the pool.
Programmer response: The user should determine if System action: IMS terminates abnormally with abend
this condition is according to specification, make 0892.
corrections, and rerun the Prefix Resolution utility. A
Programmer response: Rerun the job, giving more
possible correction might be removal of input data
storage to the MFBP. The FBP symbolic parameter of
which caused more than one LC to point to the same
the EXEC statement controls the amount of storage
LP or a new DBDGEN to include LT pointers in the LC
available for the pool.
segment.
Module: DFSIINF0, DFSIING0
Problem determination: 1, 2, 3, 5, 8, 11, 17a, 17d, 17g,
20, 36 Related information:
Operator response: Notify your IMS system the log data set with the identified ddname is out of
programmer. order.
Module: DFSIINF0, DFSIING0 The following subcodes nn identify the error:
Related information: Subcode
Meaning
IMS abend 0893
03 During forward read of a batch log, a TYPE5X
IMS abend 0894 record was found with a date-time value
lower than a previous record processed.
04 During forward read of a batch log, a TYPE06
DFS894I INVALID RECORD ERROR nn ON record was found with a time stamp less than
INPUT LOG DD ddname the current saved.
Explanation: One of the following errors, with System action: The Database Backout Utility,
subcode=nn, occurred on the batch input log: DFSBBO00, terminates unsuccessfully with a return
Subcode code of RC40 (X'28'). If the ABENDMSG control
Meaning statement was specified, abend 0507 is issued.
01 A variable-length record was read with a field Programmer response: Rerun the backout, providing
length of zero. all of the needed log data sets, in the order they were
02 A spanned record was encountered. created. If all the logs were provided in the correct
03 End of block not equal to end of buffer. order, save the log input and the abend 0507. Then,
04 Next record beyond the end of buffer. contact the IMS system programmer.
System action: The Database Backout utility, Module: DFSBACK0
DFSBBO00, terminates unsuccessfully with a return
Related information:
code of RC36 (X'24'). If the ABENDMSG control
statement was specified, abend 0507 is issued. IMS abend 0507
Programmer response:
This error is issued only for a batch input log. This DFS898A INVALID OPTION STATEMENT IN
condition can be caused by using an improperly closed SYSIN - RECORD NUMBER nn
log data set as input. Run DFSULTR0 to close the log, Explanation: Batch Backout detected a SYSIN data set
and then rerun the job. If the error persists, the log data record that was not a recognized control statement. nn
set is currently unusable for batch backout or forward indicates the record number of the invalid control
recovery utilities. Contact the system programmer for statement in the SYSIN data set.
database recovery options.
System action: The job terminates with a condition
Module: DFSBACK0 code of 72 before any backout is attempted.
Related information:
Programmer response: Correct or remove the
IMS abend 0507 indicated control statement and rerun Batch Backout.
Module: DFSBACK0
DFS895I LTERM name STOPPED DUE TO CODE Related reference:
XXX
Batch Backout utility (DFSBBO00) (Database
Explanation: IMS remote station support encountered Utilities)
an error. The logical terminal named in the message
was stopped by the receipt of an error message
following the transmission of a message to the remote DFS899A RELOAD COMPLETED, BUT DBRC
station from the named logical terminal. FUNC=nnnnnnnn HAS TERMINATED
WITH RC=xx
Operator response: Notify your IMS system
programmer. Explanation: The database RELOAD occurred before
any reorganization call to DBRC (DFSBRLSC ID=REN).
Module: DFSCR2Z0 The RELOAD completed and message DFS339I showed
a return code of 00 or 04. The DBRC call function
DFS896A UNEXPECTED RECORD (DFSBRLSC FUNC=nnnnnnnn) failed with the return
ENCOUNTERED - SEQUENCE ERROR code shown in this message.
nn on DDNAME ddname System action: Processing continues and the step
Explanation: During the forward reading of an input terminates with condition code 04.
log, Batch Backout performs context checks on log Programmer response: If the return code for message
records. One of the context checks failed, implying that
| DFS0905E INSUFFICIENT STORAGE FOR PSB Programmer response: Create the PSB using the IMS
| psbname PSBGEN, and rerun the program.
Explanation: The named SENSEG statement in the Programmer response: Create the DBD using the IMS
named PSB has an invalid PROCOPT specified. DBDGEN, and rerun the program. If the DBD defines a
main storage database (MSDB) or a data entry database
System action: Abend 0906 is issued if batch DL/I (DEDB), the IMS system must contain Fast Path
was running. ACBGEN processing continues if the support.
ACBGEN utility was being run.
| Go through each database program communication
Programmer response: Correct the PSB, and rerun the | block (DB PCB) of the involved PSB to pick up the data
program. | name. Then, search its DBD source for the LCHILD
Module: DFSDLBL0 | statement with PTR=INDX and with reference to the
| database name specified in this error message. Correct
Related information:
| the error.
IMS abend 0906 Module: DFSDLBL0
Related information:
DFS0913I DBD dbdname CONTAINS INVALID
IMS abend 0909 ACCESS METHOD
Explanation: The named DBD contained an invalid or
DFS0910I INTERNAL PROG LOGIC ERROR unknown access method.
PROCESSING PSB-psbname System action: Abend 0913 is issued if batch DL/I
Explanation: An internal programming error has was running. ACBGEN processing continues if the
occurred processing the indicated PSB. ACBGEN utility was being run.
System action: Abend 0910 is issued if batch DL/I Programmer response: Correct the DBD, and rerun
was running. ACBGEN processing continues if the the program.
ACBGEN utility was being run. Module: DFSDLBL0
Programmer response: Remove the PSB from the Related information:
processing list and rerun the program. Before
contacting IBM Software Support, have the associated IMS abend 0913
PSB and DBDs available.
Module: DFSDLBL0 DFS0914I THE PCB FOR DATABASE - dbdname
HAS PARTITIONED AND NON
Related information:
PARTITIONED DATABASES
IMS abend 0910 SPECIFIED
Explanation: This message can occur during the
DFS0911I ENQ LIST LENGTH ERROR FOR PSB ACBGEN process if the database referenced by a PCB
psbname is related to one or more databases by a logical
relationship, or a secondary index, and not all related
Explanation: The processing option intent list length databases are of the same type. The databases must all
was calculated incorrectly for the named PSB. be partitioned, or they must all be nonpartitioned.
System action: Abend 0911 is issued if batch DL/I In the message text, dbdname can see a logical database.
was running. ACBGEN processing continues if the Use the name of the logical database to determine the
ACBGEN utility was being run. referenced physical databases where the type mismatch
Programmer response: This problem is an internal occurs.
program logic error. Remove the PSB, and rerun the System action: The ACBGEN fails with a condition
program. code 08.
Problem determination: 19, 35 Programmer response: Correct the database in error
Module: DFSDLBL0 so that all of the databases in the logical relationship
are either all partitioned or all nonpartitioned. Rerun
Related information: the program.
IMS abend 0911 Module: DFSDLB70
Chapter 2, “IMS problem determination,” on page 5
DFS0915I INDEX DBD-dbdname-HAS
DFS0912I PSB psbname REFERENCES SEGM INCORRECT SEQ FIELD LENGTH.
segmname IN DBD dbdname. SEGM NOT LENGTH SHOULD BE-xxx BYTES.
FOUND.
Explanation: The named INDEX DBD has a sequence
Explanation: The named PSB referenced the named field length specified which is not equal to the indexed
SEGM in the named DBD. The named SEGM does not field length. The correct length is indicated.
exist in the named DBD.
System action: Abend 0915 is issued if batch DL/I
System action: Abend 0912 is issued if batch DL/I was running. ACBGEN processing continues if the
was running. ACBGEN processing continues if the ACBGEN utility was being run.
ACBGEN utility was being run.
Programmer response: Correct the DBD in error, and
Programmer response: Correct the PSB or DBD, and rerun the program.
rerun the program.
Module: DFSDLBL0
Module: DFSDLBL0 Related information:
Related information:
IMS abend 0915
IMS abend 0912
DFS0922I DBD dbdname IS NOT A DBD DFS0925I SEGM segmname IN DBD dbdname HAS
A SEQ FIELD IN VIRTUAL LPCK
Explanation: The named DBD was loaded. Upon
AREA
examination, it was discovered the DBD was not a
valid DBD. Explanation: A named logical child segment had a
sequence field defined which fell within the logical
System action: Abend 0922 is issued if batch DL/I
parent's concatenated key area in the logical child and
was running. ACBGEN processing continues if the
the key was specified as VIRTUAL. The key must be
ACBGEN utility was being run.
specified as PHYSICAL if it is to be used as part of the
Programmer response: Check the JCL or control physical twin sequence field.
statements, or both. Correct the error, and rerun the
System action: Abend 0925 is issued if batch DL/I
program.
was running. ACBGEN processing continues if the
Module: DFSDLBL0 ACBGEN utility was being run.
Related information: Programmer response: Correct the DBD in error, and
rerun the program.
IMS abend 0922
Module: DFSDLBL0
DFS0923I LC SEGM-segmname-IN Related information:
DBD-dbdname-DATA LENGTH TOO
IMS abend 0925
SMALL. LENGTH SHOULD BE-xxxxx
BYTES.
DFS0926I INVALID ALT PROC SEQ SPECIFIED
Explanation: The indicated logical child segment in
FOR SENSEG-segname IN PCB-pcbname
the indicated DBD had a BYTES specification shorter
IN PSB-psbname
than its logical parent's fully concatenated key. The
minimum acceptable length is indicated. Explanation: The indicated PCB in the indicated PSB
had an alternative processing sequence specified. The
System action: Abend 0923 is issued if batch DL/I
specified secondary index is not valid for the specified
was running. ACBGEN processing continues if the
SENSEG.
ACBGEN utility was being run.
System action: Abend 0926 is issued if batch DL/I
Programmer response: Correct the DBD, and rerun
was running. ACBGEN processing continues if the
the program.
ACBGEN utility was being run.
Module: DFSDLBL0
Programmer response: Correct the PSB or the DBDs,
Related information: or both, and rerun the job.
IMS abend 0923 Module: DFSDLBL0
Related information:
DFS0924I INDEX SEGMENT IN
IMS abend 0926
DBD-dbdname-TOO SHORT. LENGTH
SHOULD BE-xxxxx BYTES.
DFS0927I INDEX DBD dbdname INDEXES
Explanation: The root segment in the named INDEX
NON-EXISTENT FIELD IN DBD
DBD had a data length that was too small to hold the
dbdname
required index data. The minimum acceptable length is
indicated. Explanation: The named INDEX DBD specified an
indexed field in the INDEXED DBD that does not exist.
System action: Abend 0924 is issued if batch DL/I
was running. ACBGEN processing continues if the System action: Abend 0927 is issued if batch DL/I
ACBGEN utility was being run. was running. ACBGEN processing continues if the
ACBGEN utility was being run.
Programmer response: Correct the DBD in error, and
rerun the program. Programmer response: Correct the DBD in error, and
rerun the program.
Module: DFSDLBL0
Related information: Module: DFSDLBL0
Related information:
IMS abend 0924
IMS abend 0927
Abend 0928
DFS0932I INDEX DBD dbdname HAS NO SEQ
FIELD
DFS0929I BLDL FAILED FOR MEMBER -- member
Explanation: The named INDEX DBD does not have a
name
sequence field defined for the index segment.
Explanation: A BLDL was issued for the named
System action: Abend 0932 is issued if batch DL/I
member. The member was not found in the DBD or
was running. ACBGEN processing continues if the
PSB library.
ACBGEN utility was being run.
System action: Abend 0929 is issued if batch DL/I
Programmer response: Correct the INDEX DBD, and
was running. ACBGEN processing continues if the
rerun the program.
ACBGEN utility was being run.
Module: DFSDLBL0
Programmer response: Correct the error in the
appropriate library, and rerun the program. Related information:
was running. ACBGEN processing continues if the Programmer response: Correct the DBD, and resubmit
ACBGEN utility was being run. the job.
Programmer response: Correct the appropriate DBD, Module: DFSDLBL0
and rerun the program. Related information:
Module: DFSDLBL0
IMS abend 0937
Related information:
space is obtained from each PSB pool when the PSB is the EPCB pool includes each IOPCB and ALTPCB in
first used. the PSB.
The sum of CSA size and SAS size in this message is System programmer response: Use the maximum
not necessarily the same as the PSB size given in required EPCB size, because the HSSP work area is not
message DFS0940I. The PSB size in message DFS0940I large enough to accommodate the required space for
includes the size of the intent list. The size of the CSA the PSB.
PSB and the SAS PSB do not include the size of the
Module: DBFUAMA0
intent list.
Module: DFSUAMB0
DFS0944W BUILD FOR dbdname FAILED. A
Related information: REQUIRED DBD WAS NOT IN
“DFS0940I” on page 237 DBDLIB
Explanation: An explicit ACB Generation request was
DFS0942I IF USING DL/I SUBORDINATE made to build a DMB using a BUILD DBD=dbdname
ADDRESS SPACE, MAX CSA = control statement, but a required DBD was not in
wwwwww MAX SAS = xxxxxx DBDLIB. The missing DBD could be either the named
AVERAGE CSA = yyyyyy AVERAGE DBD or a logically related DBD. This message is
SAS = zzzzzz preceded by a DFS0929I message for the missing DBD.
Explanation: If using DL/I subordinate address space, System action: The DBD is not replaced or added, and
wwwwww is the largest CSA space requirement, and a return code 8 is set.
xxxxxx is the largest DL/I private space requirement
Programmer response: Add the missing DBD to
for any single PSB processed by this ACBGEN. For all
DBDLIB and rerun ACB Generation.
PSBs processed by the ACBGEN, yyyyyy is the average
CSA space requirement, and zzzzzz is the average DL/I Module: DFSUACB0
private space requirement. The ratio of the average Related information:
CSA and average SAS might provide some basis for
determining the relative size of the two PSB pools. The “DFS0929I” on page 236
ideal ratio might, however, be different because of
other PSBs not processed by this ACBGEN or the DFS0945I PSB-psbname-PCB-pcbname HAS NO
frequency distribution of PSBs in the pool. SENSITIVE SEGMENTS.
Module: DFSUACB0 Explanation: The named database PCB within the
named PSB had no SENSEG statements defined at
DFS0943I PSB PsbName REQUIRES A MINIMUM PSBGEN time. The PSBGEN was invalid.
OF xxxxxxxx AND A MAXIMUM OF System action: Abend 0938 is issued if batch DL/I
xxxxxxxx BYTES OF STORAGE IN THE was running. ACBGEN processing continues if the
EPCB POOL ACBGEN utility was being run.
Related information:
DFS0950I LOGICAL CHILD OR LOGICAL
IMS abend 0939 PARENT IN DBD dbdname
REFERENCES SEGM segment name.
REFERENCED SEGM HAS NO
DFS0947I DBD dbdname BUILD DID NOT FORCE CORRESPONDING REFERENCE.
PSB REBUILDS.
Explanation: An invalid logical relationship exists:
| Explanation: The database dbdname was specified in a v A logical child references the named segment in the
| BUILD DBD= statement but was unchanged in the indicated database and the named logical parent
| areas that required rebuild of referencing PSBs. These does not have an LCHILD statement.
| PSBs are not automatically rebuilt. (All PSBs explicitly v A logical parent references a logical child segment in
| listed on BUILD DBD= statements will be rebuilt.) PSB the named database and the logical child does not
| Selective Rebuild does not apply to Fast Path MSDBs. have a reference for the logical parent.
System action: DBD is replaced in ACBLIB, but v A logical DBD does not contain a reference to the
referencing PSBs are not changed. named segment in the SOURCE= operand that
references its corresponding logical child or logical
Programmer response: No action is required. parent.
Module: DFSUAMB0 System action: Abend 0943 is issued if batch DL/I
was running. ACBGEN processing continues if the
ACBGEN utility was being run.
DFS0948I SEGM-segmname-IN DBD-dbdname-IS
VARIABLE LENGTH. PHYSICAL PAIR Programmer response: Correct the DBD, and rerun
OF SEGMENT IS FIXED LENGTH. the job.
Explanation: The indicated segment in the indicated Module: DFSDLBL0
DBD was a physically paired logical child of variable Related information:
length. The opposite pair was fixed length. Physically
paired segments must have the same length attributes. IMS abend 0943
System action: Abend 0941 is issued if batch DL/I
was running. ACBGEN processing continues if the
ACBGEN utility was being run.
Programmer response: Correct the DBD in error, and
rerun the job.
Module: DFSDLBL0
Related information:
Related information:
DFS0951I SEGM segment name IS PHYSICALLY
PAIRED. ITS PAIR DOES NOT HAVE Chapter 2, “IMS problem determination,” on page 5
EQUAL INTERSECTION DATA
LENGTH. DFS0953I LOGICAL CHILD IN DATA BASE
Explanation: The referenced segment is physically xxxxxxxx HAS A L/P PTR SPECIFIED.
paired. Either the two intersection data lengths are not LOGICAL PARENT IS IN HISAM
equal (for fixed-length segments); or the maximum ORG.
intersection data lengths for the two paired segments Explanation: An error exists in the logical child SEGM
are not equal. statement in database xxxxxxxx. It is not permissible to
System action: Abend 0957 is issued if batch DL/I specify a direct pointer to a database with HISAM
was running. ACBGEN processing continues if the organization. PTR=LP is the incorrect specification; only
ACBGEN utility was being run. PTR= should be specified.
Programmer response: Correct the DBD, and rerun System action: If running under DL/I, IMS terminates
the job. abnormally with abend 0959.
Problem determination: 1, 2, 3, 5, 8, 11, 17a, 17d, 17g, Programmer response: Correct the logical child SEGM
20, 35 statement to remove the LP specification. Specify
instead only PTR= and reassemble the DBD. Rerun the
Module: DFSDLBL0 job.
Related information:
Module: DFSDLBL0
IMS abend 0957 Related information:
Chapter 2, “IMS problem determination,” on page 5
IMS abend 0959
Explanation: The old change-accumulation-data set Problem determination: 2, 3, 8, 35. If running under
header record contains a creation date and time. The the Utility Control facility, rerun the job with a
specified purge date is before the creation data and FUNCTION=OP, MSGNUM=965 control statement in
time. If the input log data set contains records created the DFSYSIN data set. Supply a SYSUDUMP DD
before the old change accumulation database, extra statement to this step.
records will have been accumulated that cannot be Module: DFSURDB0
used in recovery.
Related information:
System action: IMS continues processing but
generates a return code of 4. IMS abend 0302
Chapter 2, “IMS problem determination,” on page 5
Programmer response: Ensure that the input log data
set does not include any records for the named
database that were created before the old change DFS966W RECOVERY OF ROOT ONLY VSAM
accumulation database. ESDS HISAM DATA BASE ddname NOT
REQUIRED
Problem determination: 2, 3, 8, 36
Explanation: One of the following conditions existed:
Module: DFSUC350
v You attempted to access the ESDS of a root-only
Related information: VSAM HISAM database. This data set is not used by
Chapter 2, “IMS problem determination,” on page 5 IMS and is not required for processing. It cannot be
image-copied or recovered.
v The specified ddname does not belong to this
DFS964I INVALID PROCOPT SPECIFIED FOR
database.
PCB=pcbname, IN PSB=psbname
System action: The utility completes normally without
Explanation: The named PCB contained a PROCOPT
image copying the ESDS or recovering the ESDS data
of H but the DBD is not a DEDB. The PROCOPT H is
set.
only valid for a DEDB.
Operator response: If running under the Utility
System action: Abend 0996 is issued if batch DL/I
Control facility, rerun the job with a FUNCTION=OP,
was running. ACBGEN processing continues if the
MSGNUM=966 control statement in the DFSYSIN data
ACBGEN utility was running.
set. Supply a SYSUDUMP DD statement to this step.
Programmer response: Correct the PSB and run the
Programmer response: If condition 1, above, does not
program again.
pertain, verify that the ddname belongs to this DBD
Module: DFSDLBL0 and that it is spelled correctly. Correct any error and
Related information: rerun the job.
Problem determination: 2, 3, 8, 36
IMS abend 0996
Module: DFSRCP00
Related information:
CLSDST|TRMSESS
DFS971I (I/O ERR|INT REQ) NODE node name,
Failure occurred during CLSDST or TRMSESS
ssbytes, error description
command.
Explanation: An I/O operation to an IBM 3270 device
SEND Failure occurred during SEND command.
completed abnormally. The ssbytes are 3270
RECEIV sense/status bytes out of the RPL as passed to IMS by
Failure occurred during RECEIVE command. VTAM. The error-description-field VTAM indicators
are:
RESETSR PATH A recoverable-path error occurred.
Failure occurred during RESETSR command. CPM An unrecoverable error occurred.
INQUIR STATE An error occurred in the use of bracket
Failure occurred in attempting to inquire for indicators by the node.
BIND parameters. FI A function-interpreter error occurred.
RR A request-reject error occurred.
SESSNC
Failure occurred during SESSIONC command. The error-description-field sense/status indicators are:
RQR Invalid VTAM RQR command was received by DB Device Busy
IMS for this node. US Unit Specify
DE Device End
****** Normal if there was no operation in progress, TC Transmission Check
or LOSTERM has a hexadecimal value. CR Command Reject
IR Intervention Required
Error Data: EC Equipment Check
v RC=value in the RPLRTNCD field. DC Data Check
v FDB2=value in the RPLFDB2 field. CC Control Check
v LOSTERM=|NSEXIT=value passed to the IMS OC Operation Check
LOSTERM or NSEXIT exit by VTAM.
– X'0C' - LOSTERM Tip: See z/OS Communications Server SNA Programming
– X'29' - NSPE Cleanup RU (SC31-8829) for VTAM indicators and information
– X'20' - NSPE Notify RU about 3270 sense or status indicators.
– X'B0' - Unbind received
– X'00' - Neither LOSTERM nor SPE System action: CLSDST the node except for
v UNBIND=unbind code passed to IMS SCIP exit by intervention-required conditions. On
VTAM. intervention-required processing, the operation
v SENSE=sense code passed from VTAM, DEVICE, or continues normally after the node (terminal) is made
NSEXIT. ready.
v REASON=reason code generated by NSEXIT or Operator response: Attempt to OPNDST the node and
UNBIND continue operation if possible; if not possible, see
Problem determination. For intervention-required
See z/OS Communications Server SNA Programming processing, make the node ready and processing should
(SC31-8829) for a more detailed description of VTAM continue normally. Obtain IMS Transaction Manager
indicators and sense values. trace of the failure.
System action: ACF/VTAM terminated the session, Problem determination: 14, 23, 36
but IMS continues processing.
Module: DFSCVEO0
Operator response: (master terminal) Try to start the
Related reference:
session after diagnosing the problem.
Programmer response: No action is required. Exception conditions and sense information
nnn MESSAGE(S) PURGED, x PURGED MSG(S) DFS978I PLEASE RESEND LAST LINE
REROUTED Explanation: An I/O error has occurred reading the
last segment.
or
Explanation: Reenter the last segment, or, if wanted,
use a /CANCEL command to cancel all previous
nnn MESSAGES(S) PURGED, DEQ CMD
segments.
SUPPRESSED BY MESSAGE CONTROL ERROR
EXIT Problem determination: 1, 6, 23
Explanation: The /DEQUEUE command for NODE, Module: DFSCLMO0, DFSDS050
LTERM, and MSNAME causes the invocation of Related information:
Message Control/Error Exit before the processing of
each message. A /DEQUEUE command with the Chapter 2, “IMS problem determination,” on page 5
PURGE keyword caused the number of messages (nnn)
to be purged from the message queue. A purged Fast DFS979I BATCH MESSAGE PROGRAM psbname
Path message, if any, is included in the displayed count WAS ACTIVE AT TIME OF FAILURE
of purged messages.
Explanation: Emergency restart has determined that
The user exit requests to purge the messages from the the batch message program indicated by psbname was
queue and then reroute them to a different destination. active at the time of the failure that necessitated the
The variable x is the number of purged messages that emergency restart.
were rerouted.
This message can also occur from a failure during a
System action: The command completed successfully. backout process during other processing.
Operator response: (master terminal) This message System action: By restart - the program and its
results when the Message Control/Error Exit is associated databases are stopped. Message DFS981I
customized in the receiving system to specify an accompanies this message to identify the stopped
incorrect exit flag, or the exit flag is correct but an error databases.
was found while IMS was performing the requested
action and the associated default was performed. Operator response: (master terminal) Run the Batch
Inform the system programmer Backout utility, DFSBBO00, as described in, using the
same tapes as entered for the emergency restart. Then
System programmer response: Find the default action start the program and databases, and rerun the batch
from Message Control/Error Exit DFSCMUX0. Look for message program.
the error description in the MSNBMSG area of Message
Control/Error Exit interface block MSNB, which is a Problem determination: 4, 5
forced log entry in the X'6701' CMEI record for send Module: DFSRBLB0, DFSRBOI0
error, receive error, and the DEQ command. Correct the
Related information:
exit flag or the destination for reroute, if appropriate.
Chapter 2, “IMS problem determination,” on page 5
Problem determination: 14
Module: DFSICLJ0
Explanation: This message identifies a database that System action: The database is stopped and normal
was stopped for the specified reason. processing continues.
Programmer response: In all cases, you must do a Operator response: (master terminal) When the
backout for the database. For the BACKOUT FAILURE recovery and backout are complete, the user should
and ERE NOBMP START reasons, you can do the start the database and program with the appropriate
backout by entering a /START DB or UPDATE DB master terminal commands.
START(ACCESS) command. For the COLDBASE Programmer response: The user should run the Data
START reason, you must do a batch backout. For the Base Recovery utility against the database. When the
REMOTE TAKEOVER, a forward recovery followed by recovery is complete, the Data Base Backout utility
a batch backout are required. should be run, specifying the program indicated in the
Module: DFSRBOI0, DFSRBLB0 error message and the same tapes used for input to the
emergency restart. Running the Batch Backout utility
after this error message might result in message
DFS982I I/O ERROR READING BACKOUT DFS888I being returned from batch backout indicating
QUEUE COVERING SYSTEM no backouts exist for PSB xxxxxxxx. If the correct input
CHKPT=yyddd/hhmmss tapes were used, DFS888I indicates that the prior
emergency restart or dynamic backout did successfully
or backout the incomplete transactions for the database /
program name, before the I/O error was incurred.
I/O ERROR READING BACKOUT QUEUE
Problem determination: 1, 5, 8, 11
Explanation:
Module: DFSRBOI0
The first message is issued only in batch. The second Related reference:
message is the online (TM and DBCTL) form of the
message, where yyddd/hhmmss is the last system Recovery utilities (Database Utilities)
checkpoint ID that occurred before the start of the Related information:
unit-of-recovery being backed out. An error occurred
“DFS888I” on page 227
while reading the log. If an I/O error occurred,
message DFS0414I should be issued. Chapter 2, “IMS problem determination,” on page 5
System action: The database and the program are v If RC=00000010 is received, the most likely reason is
stopped and normal processing continues. because register 3 contained a negative value when
the CSRCESRV macro was issued.
Operator response: (master terminal) After database
v If RC=Uxxxx (xxxx is the pseudoabend code that
recovery or backout, or both, are complete, the user
occurred during /ERE or Dynamic Backout), or
should start the database and the program with the
RC=00000004 and the first case is not the problem,
appropriate master terminal commands.
then the type X'67FF' pseudoabend record on the log
Programmer response: Check the DD statement for data set is needed to determine the cause of the
the database involved and make certain it is online. If problem. Run the Database Backout utility specifying
the JCL is correct, the failure that prompted the program pppppppp and either the logs used for input
emergency restart might have damaged the database. If to the emergency restart or the logs in use at the
so, follow the programmer response for message time of the dynamic backout.
DFS983I. If this is not the case, run the Database
Problem determination: 1, 5, 8, 17b
Backout utility specifying the program indicated in the
error message and the same tapes used for input to the Module: DFSRBOI0
emergency restart. Related information:
Problem determination: 1, 5, 8 Chapter 2, “IMS problem determination,” on page 5
Module: DFSRBOI0
Related reference: DFS986A CANNOT OPEN SYSTEM
DATASET-DD NAME-nnnnnnnn, RC=xx
Database Recovery utility (DFSURDB0) (Database
Explanation: A DD statement was missing or a data
Utilities)
set requires formatting. During a restart with
Related information: formatting, an I/O error might have occurred in the
Chapter 2, “IMS problem determination,” on page 5 data set indicated by nnnnnnnn. Return code xx is
defined as follows:
DFS985I SYSTEM ERROR DURING BACKOUT Code (hex)
FOR DB=dddddddd, PGM=pppppppp, Meaning
LOG SEQ=yyyyyyyy, RC=zzzzzzzz 00 This condition is normal.
04 The DCB is already being opened or closed.
Explanation: An error occurred while emergency
08 The DCB is already open.
restart or dynamic backout was attempting to back out
0C The DECBTYPE is invalid.
incomplete transactions for data base dddddddd and
10 A failure occurred in the IMS SVC. DCBWRK1
program pppppppp. The field yyyyyyyy is the
indicates the reason. See message DFS0730I for
hexadecimal sequence number of the data base change
error subcodes.
log record being processed. The field zzzzzzzz is either a
14 An I/O error occurred while the OSAM OPEN
pseudoabend code that occurred during backout, the
routine was scanning for a file mark,
value 4, or the value 10. A value of 4 or 10 indicates an
formatting, or writing a file mark. See
error other than a pseudoabend occurred.
DECBSTAT for additional information.
System action: The database and the program are 18 An invalid RBN was calculated. The RBN is
stopped, and processing continues. A type X'67FF' either 0 or greater than the maximum RBN for
pseudoabend is written to the log data set. the data set. When multiple data sets are
defined for the short or long message queue,
Operator response: (master terminal) For the first the error might be caused by the incorrect
case, reinitialize IMS; then retry the emergency restart. space specification of the multiple data sets.
For the second case, start the database and the program See the topic on IMS.QBLKS, IMS.SHMSG/1-9,
with the appropriate master terminal operator after the and IMS.LGMSG/1-9 in the installation
database recovery or backout, or both, are complete. information and the topic on message queue
Programmer response: The following two cases data set allocation in IMS Version 11 System
should help determine and resolve the problem: Administration.
v If RC=00000004 is received during /ERE processing, 24 An error occurred during EOV processing for
a data management block (DMB) directory entry the data set.
might not have been found for the database being 28 While opening the Queue Manager system
backed out. Be sure the IMS nucleus used to restart data set, an invalid ddname was found.
the system is the same one in use at the time of the System action: IMS waits for another restart command
original system failure. If this is the problem, restart to be entered.
the IMS job specifying the correct nucleus; then rerun
the emergency restart. Operator response: (master terminal) Reenter the
restart command with BLDQ and FORMAT keywords,
as appropriate.
Programmer response: Make sure that a DD statement Table 7. Resource status (continued)
exists for the referenced data set, and if DISP=OLD, the
rsrcstat Meaning
data set is available to the system.
STOACC The resource is stopped for access
Problem determination: 1, 8, 11
globally and is offline.
Module: DFSQDOC0 STOPPED The resource is stopped globally.
Related information:
STOSCHD The resource is stopped globally.
DFS0730I
STOUPDS The resource is stopped for updates
Chapter 2, “IMS problem determination,” on page 5
globally.
or
DFS993I (CSA PSB|DLS PSB|PSBW) POOL
TOO SMALL, UNABLE TO SCHEDULE
PSB PSBNAME. STATISTICS CHECKPOINT COMMAND
COMPLETED
Explanation: One of the following problems occurred:
v The named PSB cannot be scheduled because it is too or
large to fit in the indicated (CSA|DLS) PSB pool. If
the DL/I subordinate address space option is not XRF TAKEOVER COMPLETED
selected, the entire PSB is in the CSA PSB pool. If
DL/I subordinate address space is selected, part of Explanation: A checkpoint was written to the IMS
the PSB is in the CSA PSB pool and part in the DLS system log, as the result of one of the following:
PSB pool. v A restart command
v The work area needed by this PSB is too large to fit v A /CHECKPOINT command
in the PSBW pool. v A /DBRECOVERY command
v A /DBDUMP command
System action: The PSB is stopped. v Automatic initiation by the IMS system logger
Programmer response: Take one of the following v A completed XRF takeover by the alternate IMS
actions: system
v For the first problem, use this information: The size v A restart command for a new active at a remote site
of the PSB pool for non-DL/I subordinate address
space environments is specified using the PSB= Upon completion of restart, the restart type is provided.
parameter on the control region JCL. In a DL/I During termination of IMS, the shutdown completion
subordinate address space environment, CSAPSB= message is issued. The values of yyddd/hhmmss, ctype,
and DLIPSB= are the sizes of the CSA PSB pool and and rtype are:
the second PSB pool in DL/I subordinate address v yyddd/hhmmss is the time stamp that identifies the
space local storage. The output of the ACBGEN checkpoint.
utility for the PSB psbname indicate how much space v ctype is the checkpoint type. Possible values are:
is required in these pools. *SIMPLE*, *FREEZE*, *DUMPQ**, *SNAPQ**, and
v For the second problem, use this information: The *PURGE**.
size of the PSBW pool is specified on the PSBW= v rtype is the restart type. Possible values are:
parameter in the control region JCL. The output of COLD
the ACB Maintenance utility for the PSB psbname WARM
(WORKAREA= ) indicates how much space is EMERGENCY
required in the PSBW pool. BUILDQ WARM
*BUILDQ* EMERGENCY
Module: DFSDPDM0 *COLDBASE* EMERGENCY
*COLDBASE* *BUILDQ* EMERGENCY
DFS994I RSR TAKEOVER VIA rtype START *COLDCOMM* EMERGENCY
COMPLETED *COLDSYS* EMERGENCY
System action: Normal processing continues or IMS
or terminates, depending upon the checkpoint type.
*CHKPT yyddd/hhmmss*ctype For the IMS SHUTDOWN (DBCTL) COMPLETED form of the
message, the DBCTL terminates. For the IMS SHUTDOWN
(DCCTL) COMPLETED form of the message, the DCCTL
or
terminates.
rtype START COMPLETED For the STATISTICS CHECKPOINT COMMAND COMPLETED
form of the message, IMS performance statistics records
or are written to the system log. This checkpoint is not a
restart checkpoint.
IMS SHUTDOWN COMPLETED For the XRF TAKEOVER COMPLETED form of the message,
some of the recovery functions might still be active. In
or this case, new transactions that are not in conflict with
recovery processing are allowed to run in parallel with
IMS SHUTDOWN (DBCTL) COMPLETED the recovery processing.
0C The ddname information returned from the X'02000014' X'5000' IMS encountered a
DEVTYPE macro indicates a SYSIN/SYSOUT storage failure
allocation. during the
LERUNOPTS. LE
System action: The indicated ddname NNNNNNNN runtime parameters
of the system data set will not be used during the are not initialized.
current execution of IMS. LE parameter
Operator response: Contact the system programmer. override processing
is disabled and
Programmer response: If the referenced system data processing continues
set is required, correct the JCL, the system data set normally
allocation, or both.
Module: DFSIINO0, DFSQDOC0 System action: Depends on the return and reason
codes.
DFS1002A IXLFORCE REQUEST TIMEOUT FOR Programmer response: If there is a storage failure,
STRUCTURE=xxx, CONNAME=yyy allocate more ECSA storage.
Explanation: The new, active IMS cannot delete the Module: DFSLEP10
failed persistent connection in the old IMS because it is
still active.
DFS1004I LE PARAMETER OVERRIDE
System action: IMS processing continues. PROCESSING state
System programmer response: If the new, alternate Explanation: Indicates a change in LE parameter
IMS is restarted using the same IMS ID as the failed override processing for the system. State can be either
IMS, the failed persistent connection is changed to ENABLED, indicating overrides are allowed, or
active. If the alternate XRF cannot be restarted, or the DISABLED, indicating overrides are not allowed.
new IMS ID is not the same as the old IMS ID, use the
following XCF command to delete the connection after Note: If you want to enable or disable the
the old IMS terminates: LERUNOPTS, use the keyword LEOPT=Y or N on the
SETXCF FORCE,CONNECTION,STRNAME=xxx,CONNAME=YYY DFSCGxxx member of the PROCLIB.
The following table shows the return and reason codes
for DFS1004I:
DFS1003I LERUNOPT OVERRIDES INITIALIZED
FROM imsid RC=rrrrrrrr, RSN=ssssssss
Table 9. Return and reason codes for DFS1004I 0 The new destination is missing or invalid. The
exit routine might have exited with RC=4 or
Return code Reason code Meaning
RC=8.
0 0 LERUNOPTS have
1 For exit with RC=4, timeout is specified
been successfully
without an ERP name.
initialized and
processing continues 2 For exit with RC=4, timeout is specified
normally. without a message number.
X'02000014' X'5000' IMS encountered a 3 For exit with RC=8, the LTERM name of the
storage failure original input terminal is missing or invalid.
during the
LERUNOPTS. LE 4 For exit with RC=8, the destination for a late
runtime parameters reply is missing or invalid. A timeout for the
are not initialized. original input terminal for this message has
LE parameter already occurred.
override processing 5 For exit with RC=4, the transaction code
is disabled and specified for an ERP was invalid. Timeout
processing continues processing cannot take place. A message text is
normally not displayed with this reason code.
6 For exit with RC=4, the user message number
System action: Processing continues normally. specified for timeout processing was invalid.
Programmer response: No action is required. Timeout processing cannot take place. A
message text is not displayed with this reason
Module: DFSLEP00, DFSLEP10 code.
System action: The system action depends on the
DFS1005E DFSFEBJ0 ERROR. INCORRECT reason code.
ROUTING TABLE. LTERM=nnnnnnnn
MESSAGE TEXT=xxxxxxxxxxxxxxxxxxxx Code Meaning
Explanation: Exit routine DFSFEBJ0 processed a reply 0 The message is discarded. If the message was
to a front end switching message. The system input from an ISC session and the exit routine
identification in the message text does not match an specified a valid error transaction in the
entry in the user routing table. LTERM nnnnnnnn was FEIBERP field, this error transaction is
the source of the FES reply message. This error scheduled. If the timer facility was specified,
message displays the first 20 bytes of the input the original input terminal is released;
message. otherwise it hangs.
System action: The reply message is discarded. 1,2 The input message is discarded.
System programmer response: Check the routing 3 The reply message is discarded. If the exit
table and correct invalid or missing entries. If the table routine specified a valid error transaction in
is correct, check the displayed message text and the FEIBERP field, this error transaction is
identify the source of the incorrect routing information. scheduled. If the timeout facility was specified
on input, the terminal is released from
Module: DFSCIOB0 response mode; otherwise it hangs.
4 The reply message is discarded. If the exit
DFS1006E DFSFEBJ0 ERROR. INVALID FEIB routine specified a valid error transaction in
FIELD. LTERM=nnnnnnnn RC=x the FEIBERP field, this error transaction is
DATA=yyyyyyyy MESSAGE scheduled.
TEXT=zzzzzzzzzzzzzzzzzzzz
5,6 The original input terminal is released from
Explanation: Exit routine DFSFEBJ0 processed a front response mode by this message.
end switching message. A field to be specified by the
exit routine in the front end interface block is invalid or System programmer response: Check the displayed
missing. LTERM nnnnnnnn was the source of the information and determine the source of the incorrect
message. Field yyyyyyyy contains the invalid data.
information or, if data is missing, '--NONE--'. Field Module: DFSCIOB0
zz...zz displays the first 20 bytes of the message, if
applicable. Reason code x has one of the following
meanings:
Code Meaning
to uniquely define the statement for possible error used to uniquely define the statement for possible error
message reference. message reference.
Module: DFSUTLW0 Module: DFSUTLW0
Severity: 0 Severity: 0
System action: Processing continues normally. System action: Phase 2 of the MFS Language Utility
abnormally terminates with an IMS abend code of 3006.
Severity: 4
Programmer response: Notify your IMS system
programmer.
Severity: 20
DFS1034I label PDB (SYSMSG=pd) DFS1038I FIELD NAME SYMBOL TABLE LIST
FOR name FMT SET.
Explanation: This message identifies the beginning of
a Partition Descriptor Block (PDB). The label is the Explanation: This is an informational header line
externally defined name of the PDB. If the SYSMSG generated to identify subsequent output as the symbol
keyword is present, pd is the externally defined name table listing for all field names defined in the FMT set
of the Partition Descriptor (PD) that was defined to with the label name. See also message DFS1039I.
receive system messages.
Severity: 0
Severity: 0 Related information:
DFS1039I
DFS1035I UTILITY TERMINATED FOR REFERAL
LIBRARY ERROR. RETURN
DFS1039I fieldname use assign [ATTR]
CODE=return-code.
[PASSWORD] [CURSOR] [EXTEND]
Explanation: The MFS phase 1 processor has detected [DPN] [RDPN] [PRN] [RPRN] [FMT]
a permanent I/O error in the IMS REFERAL library. [MSG] [****]
The return-code return-code in the message indicates the
Explanation: This message is used to display the
type of failure that occurred:
attributes associated with a symbol table entry. A
Code Meaning symbol table entry can be for a named DPAGE or
1 OPEN unsuccessful LPAGE SOR=name. The entry can also be for a named
2 Permanent I/O error on directory search DFLD or MFLD dfldname. The particular symbol table
3 Unrecoverable I/O error, SYNAD exit taken being processed is identified by a previous message in
4 Unexpected end of input reached, EODAD exit the output. The following list shows the definitions for
taken the message:
System action: Phase 1 of the MFS Language utility Name Meaning
terminates with the highest return code of 20 passed to
fieldname
z/OS.
Symbolic name as defined by user
Programmer response: Correct the error detected by
use Number of occurrences of the specific name
the Step 1 preprocessor, and resubmit the job.
(decimal)
Severity: 20
assign Decimal value assigned to the symbol for
interblock identification
DFS1036I label PD PID=nn
[ATTR] Field has dynamic attribute information
Explanation: This message identifies a Partition supplied by at least one output message in the
Descriptor (PD) defined within a Partition Descriptor format set.
Block (PDB). The label is the externally defined name of
[PASSWORD]
the PD. The nn is the identifier (ID) of the partition
Internal entry for PASSWORD definition for
used by this PD.
the FMT
Severity: 0
[CURSOR]
This field is used to set dynamic cursor
DFS1037I LPAGE/DPAGE SYMBOL TABLE LIST position or to receive cursor position
FOR name SET. information on input.
Explanation: This is an informational header line [EXTEND]
generated to identify subsequent output as the Field has dynamic extended attribute
LPAGE/DPAGE symbol table listing for the FMT information supplied by at least one output
description with label 'name'. See also message message in the format set.
DFS1039I.
[DPN]* This field name has been referenced by a
Severity: 0 destination process name parameter on the
Related information: DIV statement.
DFS1039I [RDPN]*
This field name has been referenced by a
return destination process name parameter on
the DIV statement.
[PRN]* This field name has been referenced by a (PDB) used by this device or the name of the
primary resource name parameter on the DIV Partition Descriptor (PD) used by this DPAGE.
statement. nn The ID of the partition used by this DPAGE.
[RPRN]* User response: No action is required.
This field name has been referenced by a
Severity: 0
return primary resource name parameter on
the DIV statement.
DFS1041 ABNORMAL TERMINATION -
*Note: The same field name can be referenced by STATUS CODE DHxx
more than one of the last four parameters above, but
Explanation: The command-level interface found a
those parameters must appear in different DIV sections
condition caused by a programming error, or DL/I
of the FORMAT definition, or error message DFS1160I
returned a status code to a command-level interface
will be issued.
indicating an error other than a programming error.
[FMT] This field has been defined within a FMT The DH indicates use of HLPI in DL/I batch. The xx
descriptor. value is the DL/I or command-level interface status
code.
[MSG] This field has been referenced within a MSG
descriptor. System action: IMS terminates abnormally with abend
1041.
[****] Indicates a potential error. Either the field has
not been defined within an FMT description Programmer response: For an explanation of the
and referenced within an MSG descriptor, or status codes, see IMS Version 11 Application Programming
the field was defined within the FMT and the DL/I status code information.
description and was not referenced within an
Problem determination: 4, 11, 19 and obtain a listing
MSG description.
of macro DFSHLPDS
Programmer response: If the field is found to be in Related reference:
error, as indicated by [****], correct the definition and
rerun the job. DL/I status codes (Messages and Codes)
Severity: 0, if no asterisks are in the message; 4, if Related information:
four asterisks (****) are in the message.
IMS abend 1041
Chapter 2, “IMS problem determination,” on page 5
DFS1040I DEVICE MAPPING FOR FMT=name
DEVICE=identification DPAGE=dp
PHYSICAL PAGE=pp PDB=pdbname PD= DFS1042I label DPAGE PD NAME CANNOT BE
pdname PID=nn FOUND
Explanation: This header identifies a device image Explanation: The Partition Descriptor (PD) specified in
map as defined by the user for the format, device, the PD keyword on the DPAGE statement was not
device page, and physical page. The image that follows found in the REFERAL library. The label is the name of
this message conforms to the following rules: the DPAGE statement referencing the PD statement.
v Unprotected named fields have their location in the System action: A return code of 12 is set, and
image marked with underscore characters. processing continues with the next DEV, MSG, or FMT
v Protected named fields have their location in the definition.
image marked with colon characters.
v Literals in the image are moved and displayed at Programmer response: Make sure the PD named in
their defined location. the PD keyword on the DPAGE statement has been
defined in the REFERAL library.
In the message text: Problem determination: 2, 8, 16
name The label on the FMT statement.
identification Severity: 12
Consists of DEVICE=type (in which type is the Related information:
parameter coded in the DEV TYPE= operand) Chapter 2, “IMS problem determination,” on page 5
and TYPE=name (in which name is either
OUTPUT, INPUT, or INOUT coded in the DIV
TYPE= operand). DFS1043I THE DEV STATEMENT SPECIFIES
dp The DPAGE number within DIV. PDB= , BUT THIS DPAGE
pp The physical page number within DPAGE. STATEMENT DOES NOT SPECIFY
pdbname PD=. THIS COMBINATION IS
The name of the Partition Descriptor Block INCOMPATIBLE.
DFS1051I name DATE=mm|dd|yy TIME=hh.mm.ss DFS1054I label DEVICE LINES TOO SMALL FOR
IGNORED. PDB REQUIREMENTS
Explanation: The name contains: FMT or MSG label, Explanation: The number of vertical lines (rows)
type of block: FMT or MSG. The named block had defined for the device is insufficient for the screen
build-time errors during MFSBTCH1 batch utility depth requirements of the Partition Descriptor Block
execution, and was not created for online processing. (PDB). The label is the name of the DEV statement
This message indicates that the block is not be added to requiring the PDB.
the online library, and, if a duplicate block existed in
System action: A return code of 12 is set, and
the online library, it will be deleted. The DATE
processing continues with the next DEV, MSG, or FMT
contains: month (mm), day (dd) and year (yy). The
definition.
TIME contains: hour (hh), minute (mm) and second (ss).
Programmer response: The 3270 symbolic name
System action: Processing continues normally.
(3270-An) used in the TYPE keyword on the DEV
Programmer response: Correct the MSG or FMT statement might specify an incorrect screen size.
definition if not corrected through a later MFSBTCH1 Alternately, the PDB used in the PDB keyword on the
utility run, and resubmit the job. DEV statement might be in error. Correct the error, and
rerun the job.
Severity: 8
Problem determination: 2, 8, 16
DFS1052I label TABLE NOT FOUND. Severity: 12
Explanation: The operator control table name Related information:
referenced in the DFLD OPCTL= operand was not Chapter 2, “IMS problem determination,” on page 5
found in the REFERAL library. label is an externally
defined label on the TABLE macro.
DFS1055I label DEVICE COLUMNS TOO SMALL
System action: Processing continues normally with the FOR PDB REQUIREMENTS
next DEV, FMT, or MSG definition.
Explanation: The number of horizontal lines
Programmer response: Define the TABLE in error, and (columns) for the device is insufficient for the screen
resubmit the job. width requirements of the Partition Descriptor Block
(PDB). The label is the name of the DEV statement
Problem determination: 2, 8, 16
requiring the PDB.
Severity: 12
System action: A return code of 12 is set, and
Related information: processing continues with the next DEV, MSG, or FMT
Chapter 2, “IMS problem determination,” on page 5 definition.
Programmer response: The 3270 symbolic name
DFS1053I label TABLE HAS NO ENTRIES. (3270-An) used in the TYPE keyword of the DEV
statement might specify an incorrect screen size.
Explanation: The operator control table name Alternatively, the PDB used in the PDB keyword of the
referenced by the DFLD macro has no IF entries. label is DEV statement might be in error. Correct the error, and
an externally defined name on the TABLE statement. rerun the job.
System action: Processing continues with the next Problem determination: 2, 8, 16
DEV, FMT, or MSG definition.
Severity: 12
Programmer response: Redefine the TABLE in error,
and resubmit the job. Related information:
Chapter 2, “IMS problem determination,” on page 5
Problem determination: 2, 8, 16
Severity: 12
Related information:
Chapter 2, “IMS problem determination,” on page 5
User response: Correct the error based on information IMS attempted this page fixing while trying to initiate
in message DFS1066I. sequential buffering for the PCB/data set pair
Related information: bbbbbbbb/cccccccc of PSB aaaaaaaaa.
DFS1066I System action: IMS does not use SB for the PCB/data
set pair bbbbbbbb/cccccccc of PSB aaaaaaaa.
DFS1070I SB-COMPARE-OPTION DETECTED A User response: Determine if too much buffer space is
MISMATCH FOR PSB=xxxxxxxx allocated to Sequential Buffering.
Explanation: See message DFS1070W for an
explanation and actions. DFS1073I LCE ALLOCATION FAILED FOR
Related information: PSB=aaaaaaaa; PCB=bbbbbbbb;
DDN=cccccccc
DFS1070W
Explanation: IMS was unable to allocate any
additional local cache entries (LCEs) to this subsystem.
DFS1070W SB-COMPARE-OPTION DETECTED A
The limit of 1200 sequential buffering buffer sets (12000
MISMATCH FOR PSB=xxxxxxxx
buffers) was exceeded. IMS attempted to allocate the
Explanation: The Sequential Buffering (SB) COMPARE LCEs while trying to initiate sequential buffering for
option detected that the buffer content that the SB the PCB/data set pair bbbbbbbb/ cccccccc of PSB aaaaaaaa.
buffer handler wanted to return to the OSAM buffer
System action: IMS does not use sequential buffering
handler did not match the contents of the block as it is
for the PCB/data set pair bbbbbbbb/cccccccc of PSB
stored on DASD.
aaaaaaaa
Message DFS1070I is issued in a non-data-sharing
User response: Determine if too many buffers are
environment indicating that the mismatch is an IMS
allocated to sequential buffering.
error.
Module: DFSSBEV0
Message DFS1070W is issued in a data-sharing
environment, indicating that the mismatch might be
legitimate. DFS1075A NO STORAGE AVAILABLE FOR
DFSSBSCD
System action: IMS creates SNAP dumps for problem
determination. Explanation: IMS was unable to acquire virtual
storage for the Sequential Buffering (SB) extension to
In a non-data sharing environment, IMS issues
the System Contents Directory (SCD).
pseudoabend 0152.
System action: IMS terminates abnormally.
User response: Save all SNAP output for problem
determination. User response: For IMS batch allocate more private
storage; for IMS DB/DC or DBCTL, allocate more CSA
storage.
DFS1071I INVALID DATA SET ATTRIBUTES
FOR //DFSCTL
DFS1076A xxxxxxxx CAN NOT BE LOADED,
Explanation: The //DFSCTL data set has invalid data
RC=nn
set attributes.
Explanation: The IMODULE macro was unable to
System action: IMS abnormally terminates the starting
load module xxxxxxxx. For an explanation of
batch, or online dependent region.
IMODULE return code nn, see the IMODULE return
User response: Correct the error by making sure that codes information.
v The data set is either a sequential file or an existing
System action: IMS issues abend 0153.
member of a partitioned data set (PDS).
v The record format is F, FB, or FBS. User response: Correct the error based on the code
v The record size is 80. returned from the IMODULE macro.
Related reference:
DFS1072I PAGE-FIXING FAILED FOR
IMODULE return codes (Messages and Codes)
PSB=aaaaaaaa; PCB=bbbbbbbb;
DDN=cccccccc Related information:
Explanation: IMS was unable to page fix the storage IMS abend 0153
for the Sequential Buffering (SB) buffers or the control
blocks. The cause is probably that real storage was
unavailable.
DFS1101I label FORMAT BLOCK HAS NO DFS1104I label INPUT MESSAGE HAS NO
DEVICES. SEGMENTS.
Explanation: A format block was defined for which no Explanation: The block is deleted because the input
DEV statements were defined. label is an externally message has no segments. label is an externally defined
defined name on the statement. If label is omitted, it is name on the statement. If label is omitted, it is an
an internal name generated by the preprocessor for the internal name generated by the preprocessor for the
statement. See message DFS1027I. statement. See also message DFS1026I.
System action: Processing continues with the next System action: Processing continues with the next
FMT or MSG definition. MSG or FMT definition.
Programmer response: Correct the format definition, Programmer response: Correct the message definition,
and rerun the MFS Language utility. and rerun the job.
Severity: 12 Severity: 12
Related information: Related information:
“DFS1027I” on page 260 “DFS1026I” on page 260
“DFS1022I” on page 259 System action: Processing continues with the next
MSG or FMT definition.
DFS1107I label LPAGE REQUIRED LITERAL Programmer response: Correct the message definition,
MISSING IN COND=. and rerun the job.
Explanation: label is an externally defined name on the Severity: 4
statement. If label is omitted, it is an internal name
generated by the preprocessor for the statement. This
DFS1111I label MSG/LPAGE HAS NO SEGMENTS
message is issued if the COND= parameter is not
WITH FIELDS.
specified or a literal is missing, or both, when it is
required on an LPAGE statement. See also message Explanation: label is an externally defined name on the
DFS1022I. statement. If label is omitted, it is an internal name
generated by the preprocessor for the statement. MSG
System action: Processing continues with the next
or LPAGE segments have no fields defined. See also
MSG or FMT definition.
message DFS1022I.
Programmer response: Correct the message definition,
System action: Processing continues with the next
and rerun the job.
MSG or FMT definition.
Severity: 12
Programmer response: Correct the message definition,
Related information: and rerun the job.
“DFS1022I” on page 259
Severity: 12
Explanation: An output message segment has no Programmer response: Correct the message definition,
fields defined for it. label is an externally defined name and rerun the job.
on the statement. If label is omitted, it is an internal
Severity: 12
name generated by the preprocessor for the statement.
See also message DFS1023I. Related information:
Explanation: This message is issued if any of the Programmer response: Correct the format definition,
following occurs: and rerun the job.
v DEV TYPE=3270, 3270P, 3600, 36DS, 36FP, 36JP or Severity: 12
36PB is specified and more than one DIV statement
Related information:
follows the above DEV statement.
“DFS1017I” on page 258
v DEV TYPE=274X and more than two DIV statements
follow the above DEV statement.
v DEV TYPE=274X, and either two DIV TYPE=INPUT DFS1118I label DPAGE ALREADY DEFINED THIS
or two DIV TYPE=OUTPUT follow the above DEV DEVICE.
statement. Explanation: A duplicate DPAGE label has been found
for this DEV statement. label is an externally defined
label is the identifier of the DEV statement in error. See name on the statement. If label is omitted, it is an
also message DFS1017I. internal name generated by the preprocessor for the
System action: Processing continues with the next statement. See also message DFS1019I.
MSG or FMT definition. System action: Processing continues with the next
Severity: 12 DEV, FMT, or MSG definition.
System action: Processing continues with the next System action: Processing continues normally.
DEV, FMT, or MSG definition.
Programmer response: If copy lock is not desired,
Programmer response: Correct the format definition, redefine the field definition so the field does not start
and rerun the job. in the first position of the buffer (POS=(1,2)) or does
not have the attributes of ALPHA and PROT
Severity: 12 (protected).
Related information:
Severity: 4
“DFS1120I”
DFS1128I label LPAGE PROMPT=DFLDNAME IS System action: Processing continues with the next
DUPLICATE. MSG or FMT definition.
Explanation: The DFLD label referenced by the Programmer response: Correct the PASSWORD
LPAGE statement must be unique within LPAGE. label segment, and resubmit the job.
is an externally defined name on the LPAGE statement. Problem determination: 2, 8, 16
Programmer response: Correct the DFLD statement, TYPE=OUTPUT) is associated through the SOR=
and resubmit the job. parameter to the MSG description TYPE=INPUT. This
message is followed by one or more DFS1145I error
Problem determination: 1, 2, 3, 4, 8, 12, 16
messages and possibly by one or more DFS1144I error
Severity: 12 messages. A return code of at least 12 is passed to
Related information: z/OS from execution of Step 1 of the MFS Language
utility.
Chapter 2, “IMS problem determination,” on page 5
System action: Processing continues normally with the
next FMT or MSG definition.
DFS1139I label keyword= PARAMETER INVALID
FOR THIS DIV TYPE AND WILL BE Programmer response: Correct the MSG or FMT
IGNORED. definition, or both, and resubmit the job.
Related information:
DFS1144I name OUTPUT MESSAGE NOT
PROCESSED. Chapter 2, “IMS problem determination,” on page 5
System action: Processing continues normally with the Explanation: The VT= or VTAB= parameter and the
next FMT set. PAGE FLOAT options were specified in the same DEV
statement. The VT= or VTAB= specification is ignored.
Programmer response: Correct the MSG or FMT The field label is the external or internally generated
definition, or both, and resubmit the job. label on the DEV statement.
Problem determination: 2, 8, 16, 36 System action: Processing continues normally.
Severity: 12 Programmer response: If the VT= or VTAB= option is
Related information: desired, correct the PAGE option and rerun the job.
Chapter 2, “IMS problem determination,” on page 5 Problem determination: 2, 8, 16
Severity: 8
DFS1145I name INPUT MESSAGE NOT
Related information:
PROCESSED.
Chapter 2, “IMS problem determination,” on page 5
Explanation: name is the external label defined on the
MSG statement. This error message is printed as a
result of a DFS1141I error message. It can also be DFS1148I label WARNING: DPAGE FILL=NONE
printed as a result of a DFS1140I error message when OR NULL IS INVALID WITH HTAB
the FMT set is not processed. 'ONLINE' OR 'OFFLINE'. HTAB
OPTION RESET TO SET.
System action: Processing continues normally with the
next FMT set. Explanation: DPAGE with FILL=NULL or
FILL=NONE was specified in the DEV statement with
Programmer response: Correct the MSG or FMT the HTAB OFFLINE or ONLINE option. The OFFLINE
definition, or both, and resubmit the job. or ONLINE option will be reset to SET. The field label
Problem determination: 2, 8, 16, 36 is the external or internally generated label on the
DPAGE statement.
Severity: 12
System action: Processing continues normally.
Related information:
Chapter 2, “IMS problem determination,” on page 5 Programmer response: If the HTAB OFFLINE or
ONLINE option is desired, correct the DPAGE fill
character specification, and resubmit the job.
DFS1146I BAD COMPLETION CODE RECEIVED
FROM IEBCOPY SUBTASK ON Problem determination: 2, 8, 16
COMPRESS OF DDNAME=FORMAT. Severity: 8
EXECUTION TERMINATED.
Related information:
Explanation: The z/OS Image Copy utility program Chapter 2, “IMS problem determination,” on page 5
(IEBCOPY) issues a return code that indicates either a
condition from which recovery might be possible or
indicates an unrecoverable error. DFS1149I label DPAGE HAS EXCEEDED
ALLOWABLE LENGTH.
System action: Processing terminates.
Explanation: The DPAGE definition currently being
Programmer response: Determine the problem by processed has exceeded the MFS buffer design limit of
using the IEBCOPY messages previously received, and 32767 bytes. The work buffer contains literals, data
the associated IEBCOPY program message fields, and control characters for the entire DPAGE. The
documentation. field label is the name specified on the DPAGE
Problem determination: 2, 8, 16, 36 statement. If DPAGE was not externally defined, label is
the name of the DIV statement.
Severity: 20
System action: Processing continues with the next
Related reference:
DEV, FMT, or MSG definition.
IEBCOPY (Library Copy) Program Programmer response: The DPAGE definition cannot
Explanation: The number of PPAGE statements duplicate parameters, and processing continues with
defined in this DPAGE, with OPTIONS=PPAGE the next DEV, FMT, or MSG definition.
specified in the DIV statement, has exceeded the design
Programmer response: Redefine the dfldname for the
limit of 256 pages. The field label is the user-supplied or
conflicting parameters, and resubmit the job.
internally-generated label on the PPAGE statement.
Problem determination: 2, 8, 16
System action: Processing continues with the next
DIV, DEV, FMT or MSG definition. Severity: 8
Programmer response: Reduce the number of PPAGE Related information:
statements in this DPAGE to less than the maximum or Chapter 2, “IMS problem determination,” on page 5
define the current DPAGE in two or more DPAGE
statements, and resubmit the job.
DFS1161I label DPAGE LABEL IS REQUIRED
Severity: 16
Explanation: A label must be defined for each input
DPAGE statement if OPTIONS=DNM is specified on
DFS1158I labell IMSSYSTEM MESSAGE the DIV statement. label is the internal label generated
DEFINED INCORRECTLY by the MFS preprocessor.
Explanation: The MFLD literal containing the IMS System action: Processing continues with the next
system message DFS057I has been defined incorrectly. DIV, DEV, FMT, or MSG statement.
The length of the literal is greater than 62, thereby
preventing MFS from properly inserting system Programmer response: Correct the DPAGE definition,
information into the system message, or the MFLD and rerun the job.
containing the system message is not in the default Severity: 12
MOD DFSM03. The field label is the external or
internally-generated label of the MFLD statement.
DFS1162I label WARNING: ATTR=nn SPECIFIED
System action: Processing continues with the next FOR DFLDNAME WHICH HAD NO
FMT or MSG definition. EATTR= SPECIFICATION
Programmer response: Change the MFLD length to be Explanation: A request has been made to dynamically
less than or equal to 62, or remove the system message modify the extended attribute bytes for a dfldname
literal from the user-supplied MOD. (label) for which no extended attributes (using EATTR=)
have been specified. The request will be honored in
DFS1159I label A MESSAGE CONTAINING AN expectation of other formats or future formats
IMS SYSTEM MESSAGE MAY NOT containing this dfldname that do have extended
DEFINE OTHER LITERALS. attributes. IMS still assumes that (2x nn) additional
bytes have been included in the LTH= specification for
Explanation: This message is issued for the DFSM03 this MFLD to be used for the attribute modification
message, the IMS MFS error default block. This bytes that are specifiable by the IMS application
message must define only one literal: the IMS system program.
message. No other literal definitions are permitted. The
field label is the external or internally-generated label of System action: Processing continues with the current
the MFLD statement. statement.
System action: Processing continues with the next Programmer response: Verify that the ATTR=nn
FMT or MSG definition. specification is really desired, or that the EATTR=
parameter was not inadvertently omitted from the
Programmer response: Remove all MFLD literals DFLD statement.
except the IMS system message from the MSG block.
Rerun the job. Problem determination: 2, 8 16
Severity: 4
DFS1160I name DFLDNAME SPECIFIED FOR Related information:
MORE THAN ONE OF THE DPN, PRN, Chapter 2, “IMS problem determination,” on page 5
RDPN, AND RPRN PARAMETERS
Explanation: A dfldname (name) was specified in more DFS1163I label WARNING: ATTR=YES AND/OR
than one of the following parameters on the DIV nn SPECIFIED ON MFLD STATEMENT,
statement: DPN=, PRN=, RDPN, and RPRN=. The BUT NOT ON CORRESPONDING
dfldname for each of these parameters, if specified, DFLD STATEMENT
must be unique.
Explanation: For DPM-An or DPM-Bn, a request has
System action: The specification is ignored for all been made to pass attribute data from an IMS
BPE0042E (Messages and Codes) Programmer response: Ensure that the MEMLIMIT
parameter on either the EXEC or the JOB statement is
set to 12 GB or higher.
DFS1177E THE RDDS EXTRACTION UTILITY
FAILED TO OPEN THE ddname DATA Module: DFSURDD0
SET, OPEN RC=rc
Explanation: The RDDS Extraction Utility DFS1180E THE RDDS EXTRACTION UTILITY
(DFSURDD0) failed to open one of the required data FAILED TO OBTAIN STORAGE,
sets. SIZE=strgsize, GETMAIN RC=rc
command is issued with the NOSAVE keyword. keyword specifies that the auto logon information
persist until another /CHANGE command with the
System action: The command is rejected.
NOSAVE keyword is used for this user. Without the
Operator response: Reenter the /ASSIGN command SAVE keyword, and any other significant status, the
with the SAVE keyword. user might be immediately deleted making the
/CHANGE command ineffective.
Module: DFSICL70
System action: The command is rejected.
DFS1234I REQUESTED BLOCK DOES NOT DFS1239I ERROR OCCURRED ON WRITE FOR
EXIST IN $$IMSDIR. $$IMSDIR
Explanation: A delete request for a FMT/MSG Explanation: During termination processing of the
descriptor has been unsuccessful. The requested MFS Language utility, an error occurred when
descriptors are not in $$IMSDIR. attempting to WRITE and STOW the final version of
the INDEX directory into the active format library.
System action: If delete, processing continues with
next statement. If scratch, continue with scratch System action: Processing continues with the next
processing. statement.
Programmer response: If delete, specify the correct Programmer response: After determining the cause of
descriptor name. Resubmit the job. the I/O error, correct it, and resubmit the job.
System action: Processing continues with the next System action: Processing continues with the next
action. statement.
Programmer response: Delete $$IMSDIR entries, as Programmer response: Correct the error, and resubmit
applicable; then resubmit the job. the job.
DFS1243I INTERNAL FETCH ERROR, SNAP DFS1247I MEMBER= name RECEIVED RETURN
ID=126 TAKEN. CODE= nnnn FROM STOW WITH
DELETE OPERATION.
Explanation: An internal logic error has occurred in
the block service module DFSUTSQ0. A SNAP memory Explanation: A requested scratch action for the
dump has been taken on the SYSSNAP data set. member with name received a return code of nnnn from
the host system STOW function. nnnn is the
System action: Processing continues with the next
hexadecimal return code received.
statement.
System action: Processing continues with the next
Programmer response: After problem determination,
statement.
visually scan the statement causing the failure, correct
the error, and resubmit the job. Programmer response: See the host system STOW
function return codes for the interpretation of the nnnn
Problem determination: 1, 2, 3, 4, 8, 13, 24, 36
value returned.
Related information:
Related reference:
Chapter 2, “IMS problem determination,” on page 5
STOW Completion Codes
DFS1244I NO OTHER KEYWORDS MAY BE
SPECIFIED WITH FMT= WHEN DFS1248I REQUESTED FMT DOES NOT EXIST
ACTION IS AGAINST THE REFERAL IN FORMAT LIBRARY.
LIBRARY.
Explanation: The requested action for format (FMT)
Explanation: When you are running an action against control block descriptors has been unsuccessful. The
the REFERAL library, no other keywords can be requested descriptors are not in the FORMAT library.
specified with FMT=.
System action: Processing continues with the next
System action: Processing continues with the next statement.
statement.
Programmer response: Specify the correct format
Programmer response: Remove the extra DEV, DIV, name, and resubmit the job.
MDL, or FEAT keywords, and resubmit the job.
DFS1249I REQUESTED MSG DOES NOT EXIST
DFS1245I REQUIRED KEYWORD NOT IN REFERAL LIBRARY.
PRESENT.
Explanation: A SCRATCH request for a REFERAL
Explanation: SCRATCH FORMAT cannot be requested library member was not performed for one of the
without specifying the FMT keyword. following reasons:
v The member is unknown to the MFS Utility program
System action: Processing continues with the next DFSUTSO0.
statement. v The member to be scratched is actually an FMT or
Programmer response: Specify the format name or TBL description.
ALL. Correct, and resubmit the job. System action: Processing continues with the next
statement.
DFS1246I INTERNAL INDEX/DELETE LOGIC Programmer response: Specify the correct message
ERROR. SNAP ID=125 TAKEN. name, and resubmit the job.
Explanation: An internal logic error has occurred in
the DIRMAINT subroutine of the INDEX/DELETE DFS1250I REQUESTED FMT DOES NOT EXIST
action module, DFSUTSG0. A SNAP memory dump has IN REFERAL LIBRARY.
been taken on the SYSSNAP DD statement data set.
Explanation: A SCRATCH request for a REFERAL
System action: Processing continues with the next library member was not successful for one of the
statement. following reasons:
Programmer response: After problem determination, v The member is unknown to the MFS Utility program
visually scan the statement causing the failure, correct DFSUTSO0.
the error, and resubmit the job. v The member to be scratched is actually a MSG or
Problem determination: 1, 2, 3, 4, 8, 13, 24, 36 TBL description.
Related information: System action: Processing continues with the next
Chapter 2, “IMS problem determination,” on page 5 statement.
Programmer response: Check the REFERAL listing to System action: Execution continues. The Device
correct the error, specify the TBL again, and then Characteristics Table member name defaults to
resubmit the job. DFSUDT00, unless otherwise specified in a subsequent
MFS Service Utility control statement. The MFS Device
Characteristics Table utility ends with a return code of
DFS1252I I/O ERROR ON REFERAL, SNAP 4. The descriptor member name defaults to DFSDSCT0
ID=124 TAKEN. or DFSDSCM0.
Explanation: An I/O error has occurred on the Programmer response: If the output produced is not
REFERAL library. A SNAP dump has been taken to the satisfactory, specify a valid suffix in the EXEC
SYSSNAP DD data set. statement parameter field, and resubmit the job.
System action: Processing continues with the next
source statement. DFS1256I THE PARAMETER DEVCHAR=x
Programmer response: Determine the cause of the I/O SPECIFIED IN THE CONTROL
error, correct the error, and resubmit the job. STATEMENT IS {WRONG
LENGTH|INVALID}
DFS1253I LIBRARY CONTENTS ARE INVALID, Explanation: The suffix "x" given in the control
SNAP ID=124 TAKEN. statement as an appendage to complete the Device
Characteristics Table member name (DFSUDT0x)
Explanation: The contents of the REFERAL library contained characters that would not allow a valid
PDS are incorrect. member name to be generated.
System action: Processing continues with the next System action: The control statement will be ignored,
source statement. and execution will continue with the control statement
Problem determination: Source, listing from failing following.
run, list PDS of REFERAL. Programmer response: Enter the correct suffix in the
control statement, and resubmit the job.
DFS1254I REQUESTED PDB DOES NOT EXIST
IN REFERAL LIBRARY DFS1257I BLDL ERROR, RETURN CODE=xx
Explanation: A SCRATCH request for a Partition Explanation: A nonzero return code was returned
Descriptor Block (PDB) member in the REFERAL from the BLDL for the Device Characteristics Table
library was not performed because the member was not member. The member name is DFSUDT0x, where x is
found. specified with the DCTSUF= keyword for the MFS
System action: Processing continues with the next Device Characteristics Table utility and with the
statement. DEVCHAR= keyword for the MFS Service utility. The
default name is DFSUDT00.
Programmer response: Correct the PDB name, and
rerun the job. System action: For the MFS Service utility, the control
statement is ignored, and execution continues with the
control statement following. The MFS Device Programmer response: Make sure that the DD
Characteristics Table utility ends with a return code of statement for REFIN has been included and is specified
12. correctly. Resubmit the job.
Programmer response: Enter the correct suffix in the
control statement or EXEC statement keyword, and DFS1262I MESSAGE FORMAT SERVICE DCT
resubmit the job. UTILITY DATE=mm/dd/
Related reference: yyTIME=hh.mm.ss PAGE nnnn
Explanation: This message is the title or header line
BLDL Completion Codes
for the SYSPRINT output data set from the MFS Device
Characteristics Table (DCT) utility program. This
DFS1258I SYMBOLIC NAME 3270-Ann IS message is written only when an error is found in the
INVALID first step of the utility. An error message follows the
message.
Explanation: The symbolic name 3270-Ann specified
in the DEV= parameter is invalid. The number nn
appended to 3270-A was not within the range "1 to 15", DFS1263X FIND FAILED FOR DESCRIPTOR
or the length of nn was less than 1 or more than 2. MEMBER xxxxxxxx RETURNCODE=
X'yyyyyyyy'
System action: The control statement will be ignored,
and execution will continue with the control statement Explanation: The FIND failed for descriptor member
following. xxxxxxxx from the PROCLIB data set. The member
name is either DFSDSCMa, where a is specified in the
Programmer response: Correct the specification in the
DSCMSUF= parameter, or it is DFSDSCTb, where b is
control statement, and resubmit the job.
specified in the DSCTSUF= parameter.
System action: The MFS Device Characteristics Table
DFS1259I nnnn IS AN INVALID KEY NUMBER
utility ends with a return code of 12.
Explanation: Message generator module DFSUTSC0
Programmer response: Determine why the MFS
has received a request to generate a message with a
Device Characteristics Table utility could not locate the
key of nnnn The message requested does not exist in a
specified descriptor member in the data set with the
known message table.
ddname PROCLIB.
System action: Processing continues with the next
statement.
DFS1264W DEVCHAR SUFFIX xx TRUNCATED
Programmer response: After problem determination, TO FIRST CHARACTER
visually scan the statement causing the failure, correct
Explanation: More than one character was specified in
the error, and resubmit the job.
the DEVCHAR= parameter of the EXEC statement. The
Problem determination: 1, 2, 3, 4, 8, 12, 13, 36 message displays only the first two characters that were
Related information: specified.
Chapter 2, “IMS problem determination,” on page 5 System action: Only the first character is used as the
one-character suffix for the device characteristics table
name. The MFS Device Characteristics Table utility
DFS1260I UNABLE TO OPEN FORMAT LIBRARY ends with a return code of 4.
Explanation: One of the DCBs for the FORMAT DD Programmer response: Specify a valid single
statement could not be opened. alphanumeric suffix for the DEVCHAR= parameter on
System action: Processing continues with the next the EXEC statement. Then, rerun the job.
utility control statement.
Programmer response: Make sure that the DD DFS1265I IMS CONNECT CALL TO THE MVS
statement for FORMAT has been included and is WORKLOAD MANAGER FAILED,
specified correctly. Resubmit the job. RETURN CODE= nn, REASON
CODE=nnnn.
DFS1261I UNABLE TO OPEN REFERAL Explanation: The z/OS Workload Management service
LIBRARY returned a nonzero return code when IMS attempted to
connect to it.
Explanation: One of the DCBs for the REFIN DD
statement could not be opened. System action: IMS continues with initialization, but
will not participate with z/OS Workload Management
System action: Processing continues with the next services.
utility control statement.
Programmer response: See the z/OS documentation Module: DFSYC490, DFSYDPD0, DFSICLN3
for an explanation of the return code and reason code.
Related reference: DFS1269E SEVERE IMS INTERNAL FAILURE,
REASON CODE=xxyy
Introducing the Workload Management Services
Explanation: IMS experienced an internal error. See
IWMCONN Return and Reason Codes the following table for a list of reason codes xxyy.
In the message text:
DFS1266 INCORRECT SPECIFICATION OF LU xx A decimal number that identifies the module
NAME that experienced the error.
Explanation: The network-qualified LU name in the yy An internal reason code.
command is specified incorrectly. A network-qualified If yy is 98 or 99, the error can occur in any
LU name has a maximum length of 17 bytes that is module. For example: REASON CODE=4698
composed of 8 bytes maximum network ID, and 8 occurs in module DFSYRST0, and REASON
bytes maximum LU name separated by a period CODE=2898 occurs in module DFSYGRX0.
enclosed in single quotation marks, for example,
'networkid.luname' Network-qualified LU names must Table 11. DFS1269E reason codes
be surrounded by singe quotation marks when entered xx yy Module Description
on a command, and there can be no blanks.
xx 98 DFSPOOL Failure to acquire storage for a
The command was rejected for one of the following variable with the DFSYMAGT
reasons: macro.
v A period is missing between the network ID and the xx 99 DFSPOOL Failure to release storage for a
LU name. variable with the DFSYMARL
v The length of the network ID or the LU name field is macro.
greater than 8 bytes. 16 01 DFSYSCP0 Release_Prefix_and_Syn_Blocks -
v The closing singe quotation mark is missing. Error releasing the prefix buffer.
v There is a blank somewhere between the singe 16 02 DFSYSCP0 Release_Prefix_and_Syn_Blocks -
quotation marks . Error releasing LUMP storage.
v Parameter ALL was specified either in the network
16 03 DFSYSCP0 Rel_Sync_AWE_Stg - Error
ID or the LU name field.
releasing Sync AWE storage.
v An invalid character was encountered in the
network-qualified LU name. 16 04 DFSYSCP0 Delete_Sync_AWE_from_YQAB -
No Sync AWE in chain.
v
16 05 DFSYSCP0 Delete_Sync_AWE_from_YQAB -
System action: The command is ignored. Error deleting AWE from the
callout chain.
Operator response: Reenter the command with the
correct format of a network-qualified LU name. 16 06 DFSYSCP0 Process_Request_Data - Error
releasing LUMP storage.
19 DFSYLUS0 OTMA FAST SERVICES
DFS1267 PARAMETER CONTAINS INVALID
CHARACTERS 20 DFSYSTO0 OTMA STORAGE MGR
21 DFSYRR00 OTMA DEST RE-ROUTE SETUP
Explanation: The parameters that are specified in the
ROUTINE
command contain invalid characters. Valid characters
for parameters are the alphanumeric characters: 'A' 22 DFSYIO00 OTMA INPUT/OUTPUT SETUP
through 'Z', 'a' through 'z', '0' through '9', the three ROUTINE
national characters '#','$','@', and the two generic 23 DFSYCM20 OTMA COMMAND
characters '%', and '*'. PROCESSOR
24 DFSYDP40 OTMA /DIS TRAN or QUERY
System action: The command is ignored.
TRAN
Operator response: Reenter the command by using 25 DFSYCLH0 OTMA /TRA SERVICES
valid characters.
26 DFSYRAC0 OTMA SECURITY
27 DFSYMGX0 OTMA XCF MESSAGE EXIT
DFS1268 NO TPIPES ASSOCIATED WITH
28 DFSYGRX0 OTMA XCF GROUP EXIT
TMEMBER
29 DFSYXMO0 OTMA ATTACH MEMBER OIM
Explanation: A command specified the TMEMBER, TPIPE, TCB
and ALL keywords, but no OTMA Tpipes are associated
30 DFSYC480 OTMA STA/STO(JOIN/LEAVE)
with the specified transaction member. XFACE
System action: The command is ignored.
Table 11. DFS1269E reason codes (continued) Table 11. DFS1269E reason codes (continued)
xx yy Module Description xx yy Module Description
31 01 DFSYFND0 FIND_LEGACY - Unknown 32 21 DFSYFD00 Find_Tpipe - Release of ITASK
return code from DFSFNDST failed.
31 02 DFSYFND0 GET_PRPRIX - DFSPOOL unable 32 22 DFSYFD00 Move_Ytib_Chain - Release of
obtained a buffer from a YTIB storage failed.
specified IMS/VS storage pool.
32 23 DFSYFD00 Move_Ytib_Chain - Deletion of
31 03 DFSYFND0 PROCESS_YPRX - DFSYPRX0, YTIB ITASK failed.
An user exit routine has not yet
32 25 DFSYFD00 BUILD_YQAB - The YQAB
been defined, or unable to get an
create failed.
interface block from BCB.
| 32 26 DFSYFD00 Failed to obtain DYNP storage
31 04 DFSYFND0 PROCESS_YDRU - DFSYDRUX,
| for DFSYPSI0.
An user exit routine has not yet
been defined, or unable to get an | 32 27 DFSYFD00 Failed to release DYNP storage
interface block from BCB. | for DFSYPSI0.
31 05 DFSYFND0 BUILD_OUPUT - User prefix 33 DFSYFD10 OTMA CONTROL BLOCK
length in error. PROCESSOR
32 01 DFSYFD00 Bad input PARM - YDSTTY. 34 23 DFSYMOM0 NOTIFY_ONE_MEMBER -
DFSBCB get failed.
32 02 DFSYFD00 Bad input PARM for TPIPE -
YDSTFUNC. 34 24 DFSYMOM0 PROCESS_AWES - Invalid
AWOFUNC function requested.
32 03 DFSYFD00 Bad input PARM for YQAB -
YDSTFUNC. 34 25 DFSYMOM0 CHECK_SECURITY - Invalid
security.
32 04 DFSYFD00 BAD INPUT PARM for TTIB -
YDSTFUNC. 34 26 DFSYMOM0 CHECK_SECURITY - RACHECK
system failed.
32 05 DFSYFD00 BUILD_TPIPE - DFSBCB GET
failed. 34 27 DFSYMOM0 CHECK_SECURITY - RACINIT
failed.
32 06 DFSYFD00 BUILD_TPIPE - TPIPE DFSCIR
ITASK failed. 34 30 DFSYMOM0 Do_oic_notify - Error on Get
Unique notify.
32 07 DFSYFD00 DELETE_TPIPE - TPIPE DFSCIR
DTASK failed. 34 31 DFSYMOM0 Do_oic_notify - Error on
FINDDEST notify.
32 08 DFSYFD00 DELETE_TPIPE - DFSBCB
RELEASE failed. 34 32 DFSYMOM0 The load failed for the DRU exit.
32 09 DFSYFD00 RELEASE_YTIB - YTIB was not 35 03 DFSYMEM0 Check_Security - Resume Tpipe
found. RACINIT failed.
32 10 DFSYFD00 Bad input parameter for RTIB - 35 04 DFSYMEM0 Check_Security - Resume Tpipe
YDSTFUNC. is not authorized.
32 11 DFSYFD00 FIND_YTIB - YRTIB create failed. 35 24 DFSYMEM0 DO_MEM_PHASE3 - OTMA is
not ready shutdown in phase 3.
32 12 DFSYFD00 FIND_YTIB - YTIB get storage
pool failed. 35 25 DFSYMEM0 ARE_QAB_READY - All QABs
are not ready for shutdown.
32 13 DFSYFD00 DELETE_TPIPE - DFSBCB REL
TPIPE's query anchor block 35 26 DFSYMEM0 ARE_TIBS READY - All TIBs are
(QAB) failed. not ready for shutdown.
32 14 DFSYFD00 Release_Msceb - Release of user 35 27 DFSYMEM0 PERFORM_ON_TIB - Unable to
prefix failed. post the TIB.
32 15 DFSYFD00 Release_Msceb - Release of user 35 28 DFSYMEM0 PERFORM_ON_QAB - Unable to
prefix failed. post the query anchor block
(QAB).
32 16 DFSYFD00 Release_Msceb - Release of
MSCEB failed. 35 29 DFSYMEM0 PROCESS_AWES - Invalid
AWOFUNC function requested.
32 17 DFSYFD00 Delete_Tpipe - Release of QAB
hold queue ITASK failed. 35 30 DFSYMEM0 FREE_AWE - Unsupported AWE
type.
32 18 DFSYFD00 Delete_Tpipe - Release of hold
queue QAB storage failed. 35 31 DFSYMEM0 Activate_Resume_Tpipe - System
was unable to post the query
32 19 DFSYFD00 Delete_Tpipe - Release of QAB
anchor block (QAB).
ITASK failed.
35 32 DFSYMEM0 DO_MEM_RSM_TPIPE - System
32 20 DFSYFD00 Find_Tpipe - Release of hold
was unable to post the QAB for
queue failed.
the super member.
Table 11. DFS1269E reason codes (continued) Table 11. DFS1269E reason codes (continued)
xx yy Module Description xx yy Module Description
35 33 DFSYMEM0 OTMA failed to create or find a 40 04 DFSYTIB0 Check_Security - RACHECK
tpipe for the RESUME TPIPE verified TranCode/Command
call. This problem can be caused Verb failed.
by:
40 05 DFSYTIB0 Reserved.
v The input tpipe name is
incorrect so that OTMA cannot 40 06 DFSYTIB0 Enqueue - Message Router
use it to create a tpipe. DFSICLR0 enqueued the
v OTMA ran out of the storage message to the destination, but
to create the tpipe for the failed.
RESUME TPIPE call. 40 07 DFSYTIB0 Process_Input - Get buffer pool
35 34 DFSYMEM0 RelStgBuf - OTMA failed to failed.
release the storage of the 40 08 DFSYTIB0 Normal_Cleanup - Unable to free
response message for the DL/I the receive buffer or command
ICAL call. buffer it had been allocated.
| 35 35 DFSYMEM0 DO_MEM_RSM_TPIPE - Invalid 40 09 DFSYTIB0 Process_Input - DFSQMGR
| communication line block (CLB) updated the Message Prefix to
| pointer. show that message is
| 35 36 DFSYMEM0 DO_MEM_RSM_MHQUE - unrecoverable and
| Invalid communication line block non-restartable, but failed.
| (CLB) pointer. 40 10 DFSYTIB0 Reserved.
35 41 DFSYMEM0 Are_TIBs_Ready - Unable to post 40 11 DFSYTIB0 Inser_One_Seqgment - QMGR
the transaction instance block inserted the segment, but failed.
(TIB).
40 12 DFSYTIB0 Process_cmd: DFSYCMD0
35 42 DFSYMEM0 DO_MEM_RSM_TPIPE - Unable command in error.
to post the query anchor block
(QAB). 40 13 DFSYTIB0 Reserved.
Table 11. DFS1269E reason codes (continued) Table 11. DFS1269E reason codes (continued)
xx yy Module Description xx yy Module Description
40 29 DFSYTIB0 Find_Dest - The SMB is not 40 63 DFSYTIB0 Process_Input - Get buffer pool
found. See DFS064. failed.
40 30 DFSYTIB0 Check_Security - Invalid security. 40 64 DFSYTIB0 Process_Output - Error releasing
See DFS1292E. asynchronous work element
(AWE) for shared queues.
40 31 DFSYTIB0 Conv_TRAN - System Error
Requested. 40 65 DFSYTIB0 Msg_Back_Queue - Release of
asynchronous work element
40 32 DFSYTIB0 Process_FastPath - System Error
(AWE) failed.
Message.
40 66 DFSYTIB0 Msg_Back_Queue -
40 33 DFSYTIB0 Process_FastPath - User Error
Conversational transaction in
Message.
error.
40 34 DFSYTIB0 Insert_One_Segment - Single
40 67 DFSYTIB0 Msg_Back_Queue -
Segment Message. See DFS1290E.
Conversational transaction in
40 35 DFSYTIB0 Enqueue - All messages error.
discarded. See DFS249.
40 68 DFSYTIB0 Msg_Back_Queue - Release of
40 36 DFSYTIB0 Insert_One_Segment - Sent null asynchronous work element
segment. See DFS249. (AWE) failed.
40 37 DFSYTIB0 Insert_One_Segment - Queue 40 69 DFSYTIB0 Conv_Tran - Conversational
overflow as unsuccessful insert. transaction in error.
40 38 DFSYTIB0 Find_Dest - Disallow CM0 for 40 71 DFSYTIB0 Conv_Tran - Conversational
IMS conversational or Fast Path transaction in error.
Transaction. See DFS1291E.
40 72 DFSYTIB0 Go_DFSYIO00 - IMS failed to
40 39 DFSYTIB0 Process_commit - Ending the obtain LUMP storage for calling
conversation without an error DFSYIOE0.
message.
40 74 DFSYTIB0 Go_DFSYIO00 - IMS failed to
| 40 40 DFSYTIB0 Find_Dest - DFSMSCE0 Terminal release LUMP storage.
| Routing entry point requested to
40 75 DFSYTIB0 Normal_Cleanup - IMS failed to
| reroute message to a remote
release LUMP storage.
| system, but failed. See DFS064.
| 40 41 DFSYTIB0 Find_Dest - DFSMSCE0 Terminal
| 40 76 DFSYTIB0 Setup_Security - IMS failed to
| Routing entry point requested to
| obtain LUMP storage for RACF
| reroute message to a remote
| TOKENMAP.
| system, but failed. See DFS070. | 40 77 DFSYTIB0 Setup_Security - IMS failed to
40 42 DFSYTIB0 Check_Seq_Num - Validate the
| release LUMP storage.
recoverable sequence number for 41 08 DFSYQAB0 Get_First_Segment - DFSQMGR
Resynch, but failed with gets segment failure.
Segment number.
41 28 DFSYQAB0 Check_System_Status - Member
40 43 DFSYTIB0 Check_Seq_Num - Validate the is not clear to send.
recoverable sequence number for
41 29 DFSYQAB0 Edit_N_Send - Segment has been
Resynch, but failed with Nack.
canceled.
40 48 DFSYTIB0 An invalid message was received
41 30 DFSYQAB0 Move_Segment_Into_Buf - The
from DFSYPSI0.
LLZZ of segment length has
40 51 DFSYTIB0 When processing an input exceeded the maximum size.
message without an AWE control
41 50 DFSYQAB0 Check_System_Status - System
block, an invalid AWE function
shutdown is in progress.
code was specified.
41 51 DFSYQAB0 Check_System_Status - XCF
40 54 DFSYTIB0 The attempt to insert a prefix
group has not been enabled.
failed for the queue manager.
41 52 DFSYQAB0 Check_System_Status - Qab/Pipe
40 58 DFSYTIB0 An invalid APPC/OTMA shared
Control Block has not been
queues prefix data that was sent
stopped.
from the back-end IMS was
detected in the front-end IMS. 41 53 DFSYQAB0 Check_Init_Before_Send - Unable
t0 clear YQAB for work.
40 60 DFSYTIB0 Go_DFSYIO00 - IMS failed to get
LUMP storage for calling 41 54 DFSYQAB0 Get_First_Segment - DFSQMGR
DFSYIOE0. cannot get the first segment.
40 61 DFSYTIB0 Enqueue - IMS failed to release 41 55 DFSYQAB0 Reserved.
LUMP storage.
Table 11. DFS1269E reason codes (continued) Table 11. DFS1269E reason codes (continued)
xx yy Module Description xx yy Module Description
41 56 DFSYQAB0 Get_First_Segment - APPC 42 38 DFSYLUS0 Get_OTMA_Prefix - DFSPOOL
Transaction has no prefix. cannot get storage for OTM
prefix.
41 57 DFSYQAB0 Get_Storage - DFSPOOL
allocated storage failure. 42 39 DFSYLUS0 TibInfo_Service - When OTMA
returns information in the YTIB,
41 58 DFSYQAB0 Dispose_Msg - Wash the msg
the LUMBLK_Ptr is pointing to
back after sending.
the YTIB, but the address of
41 59 DFSYQAB0 Free_Storage - DFSPOOL freed LTERM (DLALTRMA) is zero.
storage using DFSPOOL failure.
42 40 DFSYLUS0 Inqy_Service - OTMA is not
41 60 DFSYQAB0 Check_System_Status - RESYNC returned information from
flag is on. OTMA Prefix or YQAB/YTIB.
41 61 DFSYQAB0 Proc_Sync_Callout_Msg - Sync 42 43 DFSYLUS0 Sync_Output - Failure to get
AWE processing error. Sync AWE storage.
41 62 DFSYQAB0 Proc_Sync_Callout_Msg - Sync 42 45 DFSYLUS0 Sync_Output - Failure to release
AWE unknown state. Sync AWE storage.
41 80 DFSYQAB0 Reroute_Msg - Unable to find 42 48 DFSYLUS0 Send_Deal_to_FE - Failure to get
YQAB for message hold queue. Sync AWE storage.
41 81 DFSYQAB0 Reroute_Msg - Unable to reroute 42 49 DFSYLUS0 Send_DFS_Msg_To_FE - Failure
message. to get Sync AWE storage.
41 82 DFSYQAB0 Reroute_Msg - Bad return code 42 50 DFSYLUS0 Send_DFS_Msg_To_FE - Failure
from message router CLR1. to get Sync AWE storage.
42 04 DFSYLUS0 Send_Service - Send out Sync 42 51 DFSYLUS0 Send_DFS_Msg_To_FE - Failure
output, but YQAB indicator is to release Sync AWE storage.
on.
43 06 DFSYCMD0 INIT_PRE - Fail to call QMGR
42 08 DFSYLUS0 Send_Service - DFSYSLM0 issues insert move message prefix.
XCF send, but failed.
43 23 DFSYCMD0 INIT_PRE - DFSPOOL gets the
42 29 DFSYLUS0 Send_Deallocate - DFSYFMTE LUMP pool, but failed.
cannot find corresponding input
43 24 DFSYCMD0 INIT_PRE - DFSPOOL releases
member.
the LUMP pool, but failed.
42 30 DFSYLUS0 Do_Invalid_Service - Bad
44 DFSYCKP0 OTMA CHECK POINT
addressability or parameter area.
45 29 DFSYSLM0 Reserved.
42 31 DFSYLUS0 Chng_Service - DFSYFND0
should return to DFSDLA30, but 45 30 DFSYSLM0 Move_Segment_Into_Buf - The
it is not. LLZZ of segment length is
exceeded the maximum size of
42 32 DFSYLUS0 Find_QAB - Cannot find a QAB
32k.
in the OTMA message prefix.
45 57 DFSYSLM0 Get_Storage - DFSPOOL get
42 33 DFSYLUS0 Find_RTIB - Cannot find an RTIB
LUMP, but failed.
in the OTMA message prefix.
45 59 DFSYSLM0 Free_Storage - DFSPOOL releases
42 34 DFSYLUS0 Find_TIB - Cannot find a TIB in
LUMP, but failed.
the OTMA message prefix.
46 DFSYRST0 OTMA RESTART
42 35 DFSYLUS0 GetQabTib_Service - When
OTMA returns to CLB, which 46 01 DFSYRST0 Restart_4032 - A tpipe create
should have YTIB/YQAB failed for the 4032 log record.
address, but DLAMSGIN is not Restart continues without these
pointing to the OTMA message blocks, but messages might be
prefix. lost.
42 36 DFSYLUS0 Copypf_Service - When OTMA 46 02 DFSYRST0 Restart_4032 - HOLDQ create
copies a OTMA message prefix, failed for the 4032 log record.
DLAMSGIN is pointing to Restart continues without these
OTMA message prefix, but blocks, but messages might be
cannot find the TIB in the lost.
LUMBLK.
46 03 DFSYRST0 Restart_4032 - A YQAB token
42 37 DFSYLUS0 Copypf_Service - When OTMA mismatch was found for a 4032
copies a OTMA message prefix, log record. Restart continues
DLAMSGIN is pointing to without these blocks, but
OTMA message prefix, but the messages might be lost.
LUMBLK_Ptr is zero.
| Programmer response: Specify a larger LUMP or System action: The OTMA response message is
| LUMC pool limit at next IMS restart. ignored.
Programmer response: Ensure the OTMA transaction
| DFS1278E LUMx POOL LIMIT REACHED, ALL pipe associated with the client is awaiting an OTMA
| APPC INPUT WILL BE REJECTED. response message.
| DFS1279I APPC INPUT PROCESSING After a tpipe is created for an input or output OTMA
| RESUMED. message, the Synchronized Tpipe setting for the Tpipe
cannot be changed for the subsequent input or output
| Explanation: The LUMP or LUMC storage shortage OTMA message.
| has been released, and new input from advanced
| program-to-program communication (APPC) is
In the message text:
| allowed.
tpipe Identifies the 8-byte transaction pipe name
| System action: IMS tells APPC/MVS to accept all
| APPC input; processing continues. member Identifies the 16-byte client name
| Programmer response: No action is required. System action: IMS responds to the original OTMA
message with a NACK message.
| If the LUMP or LUMC storage shortage occurs again,
| follow the response steps in the DFS1278E information. Programmer response: Ensure the IMS system has
| Related information: enough available storage. Also, check the Synchronized
Tpipe flag in the processing flag of the OTMA
| “DFS1278E”
message-control-information prefix.
Module: DFSYMEM0
Module: DFSYPSI0
DFS1287E DESTINATION NAME=destination IS
RCNT AND NOT ALLOWED FROM
DFS1284E (N)ACK ON NON-WAITING BLOCK AN OTMA MEMBER
IN TPIPE=tpipe MEMBER=member
TOKEN=token Explanation: The specified destination is an RCNT
and cannot be accepted for processing from an OTMA
Explanation: An OTMA client sent an client.
acknowledgment message, ACK or NAK, to IMS for a
transaction pipe (tpipe) that is not waiting for the System action: IMS sends the OTMA client a NACK
message. message. The original message is discarded.
In the message text: Programmer response: Ensure the OTMA client does
tpipe The 8-byte transaction pipe name not issue messages for RCNT names.
member The 16-byte client name Module: DFSYTIB0
token The 32 byte server token
| The client might have specified an incorrect tpipe name DFS1288E DESTINATION NAME=destination IS
| or IMS OTMA already timed out the wait. The tpipe CNT AND NOT ALLOWED FROM AN
| might be in a hold state. OTMA MEMBER
System action: The message from the OTMA client is Explanation: The specified destination is a CNT and
ignored. An X'6701' error record with ID=YNAK is cannot be accepted for processing from an OTMA
logged on the IMS OLDS. client.
Programmer response: Ensure the OTMA transaction System action: IMS sends the OTMA client a NACK
pipe associated with the client is awaiting an OTMA message. The original message is discarded.
response message and that the IMS token in the OTMA Programmer response: Ensure the OTMA client does
message is valid. not issue messages for CNT names.
Module: DFSYPSI0 Module: DFSYTIB0
System action: The OTMA message is canceled. System action: The OTMA client receives a NACK
message.
Programmer response: Check the size of the message
and adjust if necessary. Programmer response: Ensure that the destination
IMS subsystem is at Version 5 or higher.
Module: DFSYTIB0
Module: DFSYLUS0
DFS1290E DESTINATION NAME=destination IS
SINGLE SEGMENT, TPIPE=tpipe DFS1294E OTMA OUTPUT SEGMENT SIZE
EXCEEDED, MESSAGE DISCARDED,
Explanation: The specified destination can only accept
MEMBER=member, TPIPE=tpipe
single segment messages. Because multiple segments
were detected, the message is discarded. tpipe is the Explanation: The message segment length exceeded
8-byte transaction pipe name. the limit of 32,764 bytes. tpipe is the 8-byte transaction
pipe name. member is the 16-byte client name.
System action: The OTMA client receives a NACK
message. System action: The OTMA message is canceled.
Programmer response: Ensure the OTMA message has Programmer response: Check the segment size of the
only a single segment. OTMA message.
Module: DFSYTIB0 Module: DFSYSLM0
Programmer response: Examine the security data Explanation: The OTMA client or the LU 6.2 device
section of the OTMA message prefix to ensure a user attempted to establish a protected conversation with a
token, userid or group name was specified and valid. destination that is not an IMS transaction.
For example, if a user token contains an invalid value
System action: For OTMA, the OTMA client receives a
such as zero, this message will be issued.
NACK message. For LU 6.2, IMS deallocates the
Module: DFSYTIB0 conversation with
ATBCMTP_TP_NOT_AVAIL_NO_RETRY and sends
this message back to the LU 6.2 device.
DFS1293E DESTINATION NAME=destination IS IN
DOWN LEVEL IMS Programmer response: Establish the protected
conversation with a local IMS transaction.
Explanation: The destination name specified is an IMS
remote transaction name that is not valid. The likely Module: DFSYTIB0, DFSRLM10
cause is that the destination IMS subsystem is not
capable of accepting the OTMA transaction.
Explanation: The order of occurrence required Explanation: The previous source statement indicated
OPERATOR, and the current item had a non-alphabetic continuations on a subsequent statement; however, no
first character. continuation statement followed.
System action: Processing continues with the next System action: Processing continues as if no
source character. continuation was specified.
Programmer response: Preprocessor OPERATORS are Programmer response: Supply the continuation
all alphabetic character strings; specify the operator statements or remove the continuation indicator, and
again, and rerun the job. rerun the job.
DFS1322I SC=08 EXCESSIVE LABEL LENGTH Programmer response: Specify the OPERATOR you
want, and rerun the job.
Explanation: LABEL can never exceed 8 characters in
length.
DFS1328I SC=08 EXPECTED STRING
System action: Truncation occurs and processing CONTINUATION NOT RECEIVED
continues with the next source character.
Explanation: Continuation of a literal string was
Programmer response: Shorten the LABEL specified to indicated, but not found.
eight or fewer characters, and rerun the job.
System action: Processing continues as if this
statement were comments.
DFS1323I SC=08 NO OPERATOR FOUND
Programmer response: Specify the input again
Explanation: The order of occurrence of the operands according to continuation requirements, and rerun the
requires that OPERATOR occur next, but it was not job.
found.
System action: Processing continues with the next DFS1329I SC=04 END OF FILE DETECTED
source statement. WHERE CONTINUATION CARD WAS
EXPECTED
Programmer response: Specify the input again;
include a valid OPERATOR and rerun the job. Explanation: An end-of-file condition has been sensed,
when a continuation statement was expected.
DFS1324I SC=08 CONTINUED OPERATOR System action: Processing continues with the
INVALID SYNTAX appropriate EOD routines.
Explanation: OPERATORs must be contiguous and on Programmer response: Correct the erroneous source
a single statement. or re-create the offending SYSLIB source, and rerun the
job.
System action: Processing continues as if this
statement were comments.
Programmer response: Specify the input again
according to continuation requirements, and rerun the
job.
DFS1330I SC=20 I/O ERROR. INPUT DFS1335I SC=08 REC'D ITEM DELETED
PROCESSING TERMINATED
Explanation: The item indicated by message DFS1333I
Explanation: An I/O error on SYSIN or SYSLIB has been deleted and no assumption will be made.
occurred. This message is preceded by a z/OS message
System action: Processing continues with the next
indicating the specific type of error.
operand.
System action: The preprocessor terminates with a
Programmer response: Specify the proper OPERAND
forced end of job (EOJ).
again and rerun the job.
Programmer response: Determine the cause of the I/O
error, correct it, and rerun the job.
DFS1336I SC=08 ITEM PREVIOUS TO REC'D
ITEM DELETED
DFS1331I SC=08 TEXT SUBSTITUTION BUFFER
Explanation: An error condition exists that requires
FULL, TEXT LOST
the preprocessor to delete the previous item to resolve
Explanation: The text substitution buffer size (4096 the conflict.
bytes) has been exceeded; no further entries can be
System action: Processing continues with next
made.
operand.
System action: The current text is not stacked;
Programmer response: Specify the proper OPERAND
processing continues with the next source statement.
again and rerun the job.
Programmer response: Remove the unnecessary or
lengthy equates (EQU), and rerun the job.
DFS1337I SC=04 FOLLOWING ASSUMED: any
operand
DFS1332I SC=04 POSITION MARKER
Explanation: The preprocessor has assumed the
Explanation: The position marker indicates the current operand specified in any operand, which is valid.
source pointer at the time of error.
System action: Processing continues with the next
System action: Processing continues with further error source item.
analysis.
Programmer response: See message DFS1334I if the
Programmer response: See message DFS1334I. assumption made is not desired.
Related information: Related information:
“DFS1334I” DFS1334I
DFS1333I SC=04 REC'D: 'any operand' DFS1338I SC=08 NULL OPERAND RECEIVED
FOR ALPHA STATEMENT
Explanation: "any operand" is the offending
OPERAND. Explanation: No OPERAND has been provided on an
ALPHA statement.
System action: Processing continues with further error
analysis. System action: Processing continues with the next
source statement.
Programmer response: See message DFS1334I.
Related information: Programmer response: Add the desired operand, and
rerun the job.
“DFS1334I”
DFS1351I SC=08 MAXIMUM RESCAN DFS1355I SC=04 NUMBER FOR SPACE EXCEEDS
SUBSTITUTION COUNT EXCEEDED. 15 SIGNIFICANT DIGITS. THE PAGE
SUBSTITUTION NOT PERFORMED WILL BE EJECTED
Explanation: A statement exceeded the maximum Explanation: The SPACE count exceeded 15 significant
RESCAN substitution count. The RESCAN default is 5 digits. A page eject occurred.
to avoid looping.
System action: Processing continues with the next
System action: The substitution is terminated. source statement.
Processing resumes with the next statement.
Programmer response: Specify the SPACE count
Programmer response: Specify a larger number on the again; do not exceed 15 significant digits. Rerun the
RESCAN statement for the result you want. job.
System action: Processing continues with the next Programmer response: Specify the PS value as either a
source statement. single character or 2 hexadecimal characters in the
range from X'40' to X'FE', or as PX'00'. Rerun the job.
Programmer response: Provide the appropriate DFLD
statement, and rerun the job.
DFS1367I SC=08 TABLENAME AS LABEL
REQUIRED. 'TEMPTABL USED'
DFS1363I SC=08 POS=(lll,ccc,ppp) REQUIRED FOR
RECORD MODE Explanation: Each TABLE statement requires a label.
None was found; it was assigned a label.
Explanation: The stream mode form of the DFLD
POS= keyword was given when MODE=RECORD; the System action: Processing continues with the next
form POS=(lll,ccc,ppp) is required. The default record operand.
mode POS= keyword is used (line=1, column=left
Programmer response: Provide the required label, and
margin +1, page=1).
rerun the job.
System action: Processing continues with the next
operand.
DFS1368I SC=04 TABLENAME TRUNCATED TO
Programmer response: Specify the MODE= keyword 8 CHARACTERS
of the DEV statement or the POS= keyword of the
Explanation: The TABLE statement label exceeded 8
DFLD statement again and rerun the job.
characters; the first 8 characters were used.
System action: Processing continues with the next
operand.
Programmer response: Specify the appropriate label
again and rerun the job.
DFS1372I SC=04 MSG NAME TOO LONG. DFS1377I SC=04 FILL=C'.', TRUNCATED TO 1
TRUNCATED TO 8 BYTES CHARACTER
Explanation: An MSG statement label exceeded 8 Explanation: The FILL= literal exceeded one character
bytes; the first 8 bytes were used. in length; the first character was used.
System action: Processing continues with the next System action: Processing continues with the next
operand. operand.
Programmer response: Specify the label again and Programmer response: Specify the literal again and
rerun the job. rerun the job.
Explanation: The EXIT= value parameter Exceeded 3 Programmer response: Specify EXIT= with the
digits; the last 3 digits were used. appropriate vector, and rerun the job.
System action: Processing continues with the next
operand. DFS1415I SC=04 DUPLICATE EXIT= KEYWORDS
INVALID
Programmer response: Specify a valid value, and
rerun the job. Explanation: You can specify only one EXIT=
specification on a single SEG statement; the second one
was ignored.
DFS1410I SC=08 EXIT= EXITNUM VALUE
EXCEEDS 127. 127 USED System action: Processing continues with the next
operand.
Explanation: The EXIT= value parameter exceeds 127.
The value was set to 127. Programmer response: Resolve the conflict, and rerun
the job.
System action: Processing continues with the next
operand.
DFS1416I SC=04 DUPLICATE GRAPHIC=
Programmer response: Specify EXIT= with a valid
KEYWORDS INVALID
value, and rerun the job.
Explanation: Only one GRAPHIC= specification is
allowable on a single SEG statement. The second one is
DFS1411I SC=08 EXIT= EXITVECT EXCEEDS 3
ignored.
SIGNIFICANT DIGITS. LAST 3
DIGITS USED System action: Processing continues with the next
operand.
Explanation: The EXIT= vector specification exceeds 3
digits; the last 3 digits are used. Programmer response: Resolve the conflict, and rerun
the job.
System action: Processing continues with the next
operand.
DFS1417I SC=04 MFLD LABEL LENGTH
Programmer response: Specify EXIT= vector with a
EXCEEDS 8 CHARACTERS.
valid value, and rerun the job.
TRUNCATED TO 8 CHARACTERS
Explanation: The message field (MFLD) statement
DFS1412I SC=08 EXIT= EXITVECT VALUE
label exceeds 8 characters. The first 8 characters are
EXCEEDS 255. 255 USED
used.
Explanation: The EXIT= vector specification exceeds
System action: Processing continues with the next
255, The value was set to 255.
operand.
System action: Processing continues with the next
Programmer response: Specify a valid label again and
operand.
rerun the job.
Programmer response: Specify the EXIT= parameter
with a valid value, and rerun the job.
DFS1418I SC=08 DO COUNT EXCEEDS 2
SIGNIFICANT DIGITS. LAST 2
DFS1413I SC=08 EXIT= EXITNUM HAS NO DIGITS USED
DIGITS. VALUE OF ZERO USED
Explanation: The DO count exceeds 2 digits; the last 2
Explanation: The EXIT= value specification is null. The digits are used.
value was set to zero.
System action: Processing continues with the next
System action: Processing continues with the next operand.
operand.
Programmer response: Specify DO again using an
Programmer response: Specify EXIT= with the appropriate count, and rerun the job.
appropriate value, and rerun the job.
DFS1419I SC=08 DO COUNT HAS NO DIGITS.
DFS1414I SC=08 EXIT= EXITVECT HAS NO VALUE OF 1 ASSUMED
DIGITS. VALUE OF ZERO USED
Explanation: You did not provide a count on a DO
Explanation: The EXIT= vector specification is null. It statement. One is assumed.
was set to zero.
System action: Processing continues with the next
System action: Processing continues with the next operand.
operand.
Programmer response: Specify DO again using an Programmer response: Select one specification, and
appropriate count, and rerun the job. rerun the job.
System action: Processing continues with the next Programmer response: Specify the length again and
operand. rerun the job.
Programmer response: Specify a valid value, and
rerun the job. DFS1435I SC=08 LTH=(pp,nn), nn'S VALUE
EXCEEDS 8000. 8000 USED
DFS1430I SC=08 LTH=nn, nn HAS NO DIGITS. Explanation: The LTH= length value exceeded 8000; it
VALUE OF 1 USED was set to 8000.
Explanation: The LTH= length specification was null; System action: Processing continues with the next
it was set to 1. operand.
System action: Processing continues with the next Programmer response: Specify the value again and
operand. rerun the job.
Programmer response: Specify the length, and rerun
the job. DFS1436I SC=08 LTH=(pp,nn), nn HAS NO
DIGITS. VALUE OF 1 USED
DFS1431I SC=08 LTH=(pp,nn), pp EXCEEDS 4 Explanation: The LTH= length parameter was null; it
SIGNIFICANT DIGITS. LAST 4 was set to 1.
DIGITS USED
System action: Processing continues with the next
Explanation: The LTH= position specification operand.
exceeded 4 digits; the last 4 digits were used.
Programmer response: Specify the appropriate value,
System action: Processing continues with the next and rerun the job.
operand.
Programmer response: Specify the appropriate DFS1437I SC=08 FILL=C'', LITERAL LENGTH IS
position parameter again and rerun the job. ZERO. BLANK USED
Explanation: The FILL= literal specification was null;
DFS1432I SC=08 LTH=(pp,nn), pp'S VALUE a blank was used.
EXCEEDS 8000. 8000 USED
System action: Processing continues with the next
Explanation: The LTH= position value exceeded 8000; operand.
it was set to 8000.
Programmer response: Specify the appropriate literal,
System action: Processing continues with the next and rerun the job.
operand.
Programmer response: Specify a valid value again DFS1438I SC=04 FILL=C'', LITERAL LENGTH
and rerun the job. EXCEEDS 1 CHARACTER. FIRST
CHARACTER USED
DFS1433I SC=08 LTH=(pp,nn), pp HAS NO Explanation: The FILL= literal specification exceeded
DIGITS. VALUE OF 2 USED one character; the first character was used.
Explanation: The LTH= position parameter was null; System action: Processing continues with the next
it was set to 2. operand.
System action: Processing continues with the next Programmer response: Specify the literal again and
operand. rerun the job.
Programmer response: Specify the appropriate
position value, and rerun the job. DFS1439I SC=04 FILL=X'hh', hh EXCEEDS 2
CHARACTERS. FIRST 2
CHARACTERS USED
DFS1434I SC=08 LTH=(pp,nn), nn EXCEEDS 4
SIGNIFICANT DIGITS. LAST 4 Explanation: The FILL= hexadecimal string exceeded
DIGITS USED two hexadecimal characters in length; the first two
characters were used.
Explanation: The LTH= length specification exceeded
4 digits; the last 4 digits were used. System action: Processing continues with the next
operand.
System action: Processing continues with the next
operand. Programmer response: Specify the hexadecimal string
again and rerun the job.
SPECIFICATION IGNORED
DFS1451I SC=08 POSITIONAL PARAMETER 1
REQUIRES DFLDNAME FOR LITERAL Explanation: The SCA specification precluded ATTR=
WHEN MSG.TYPE=OUTPUT or JUST= specification on an MFLD statement. They
SPECIFIED were ignored.
Explanation: The first MFLD parameter must be the System action: Processing continues with the next
device field name (dfldname) of a literal when the operand.
MSG.TYPE=OUTPUT. The parameter is ignored.
Programmer response: Specify the MFLD statement
System action: Processing continues with the next again, omitting the specifications not needed, and rerun
operand. the job.
Programmer response: Supply the dfldname of the
appropriate literal, and rerun the job. DFS1456I SC=08 keyword= SPECIFICATION
INVALID FOR SYSTEM LITERAL
FIELD. SPECIFICATION IGNORED
DFS1452I SC=08 LTH=(pp,nn) INVALID FOR
MSG.TYPE=OUTPUT. pp VALUE Explanation: The system literal specification precluded
IGNORED ATTR= or JUST= specification on an MFLD statement.
The keyword= specification was ignored.
Explanation: The MFLD LTH=pp specification conflicts
with the MSG.TYPE=OUTPUT; it is ignored. System action: Processing continues with the next
operand.
System action: Processing continues with the next
operand. Programmer response: Specify the MFLD statement
again, omitting the specifications not needed, and rerun
Programmer response: Resolve the MSG/MFLD
the job.
conflict, and rerun the job.
DFS1459I SC=08 SCA FIELD INVALID FOR DFS1464I SC=04 MULTIPLE PFK= KEYWORDS
MSG.TYPE=INPUT. NULL FIELD INVALID
CREATED
Explanation: More than one PFK= specification has
Explanation: The SCA specification conflicted with been made on a single DEV statement; the second one
MSG.TYPE=INPUT; it was ignored. is ignored.
System action: Processing continues with the next System action: Processing continues with the next
operand. operand.
Programmer response: Resolve the MFLD/MSG Programmer response: Correct the PFK= specification,
conflict, and rerun the job. and resubmit the job.
DFS1469I SC=04 MULTIPLE LDEL= KEYWORDS DFS1474I SC=08 TYPE=INOUT INVALID FOR
INVALID SPECIFIED DEVICE TYPE
Explanation: More than one LDEL= specification has Explanation: Only 3270s are INOUT device types.
been made on a single DEV statement; the second one
System action: Processing continues with the next
is ignored.
operand.
System action: Processing continues with the next
Programmer response: Correct DIV or DEV, and rerun
operand.
the job.
Programmer response: Correct the LDEL=
specification, and resubmit the job.
DFS1475I SC=08 TYPE=INPUT INVALID FOR
SPECIFIED DEVICE TYPE
DFS1470I SC=04 MULTIPLE PAGE= KEYWORDS
Explanation: 36XX are output only device types.
INVALID
System action: Processing continues with the next
Explanation: More than one PAGE= specification was
operand.
made on a single DEV statement; the second one was
ignored. Programmer response: Correct DIV or DEV, and rerun
the job.
System action: Processing continues with the next
operand.
DFS1476I SC=04 MBRNAME EXCEEDS 8
Programmer response: Correct the PAGE=
CHARACTERS. TRUNCATED TO 8
specification, and resubmit the job.
CHARACTERS
Explanation: The COPY member name exceeded 8
DFS1471I SC=04 MULTIPLE FORMS=
characters, which is not allowable; it was truncated.
KEYWORDS INVALID
System action: Processing continues with the next
Explanation: More than one FORMS= specification has
source statement.
been made on a single DEV statement; the second one
is ignored. Programmer response: Correct the member name, if
necessary, and rerun the job.
System action: Processing continues with the next
operand.
DFS1477I SC=08 MBRNAME CONTAINS NO
Programmer response: Correct the FORMS=
CHARACTERS. STATEMENT
specification, and resubmit the job.
IGNORED
Explanation: No member name was specified in a
DFS1472I SC=04 MULTIPLE SYSMSG=
COPY statement.
KEYWORDS INVALID
System action: Processing continues with the next
Explanation: More than one SYSMSG= specification
source statement.
was made on a single DEV statement; the second one
was ignored. Programmer response: Correct the COPY statement,
and rerun the job.
System action: Processing continues with the next
operand.
DFS1478I SC=08 RECURSIVE NESTED COPY
Programmer response: Correct the SYSMSG=
OPERATIONS INVALID
specification, and resubmit the job.
Explanation: A COPY for a member, currently part of
a nested copy, was invalid.
DFS1473I SC=08 TYPE=OUTPUT INVALID FOR
DEV TYPE=3600 System action: Processing continues; the COPY
statement is ignored.
Explanation: 3600 device types are for input only.
Programmer response: Ensure that the members to be
System action: Processing continues with the next
copied do not refer to members in a previously copied
source item.
library. Correct the error, and rerun the job.
Programmer response: Correct DIV or DEV to reflect
the appropriate results, and rerun the job.
Severity: 12
DFS1501I SC=08 PDB STATEMENT NAME
EXCEEDS 8 CHARACTERS
DFS1505I SC=04 PD NAME SPECIFIED ON
Explanation: The label on the Partition Descriptor
SYSMSG= TOO LONG, IS
Block (PDB) statement exceeded 8 characters.
TRUNCATED TO 8 CHARACTERS
System action: A return code of 8 is set, and
Explanation: The Partition Descriptor (PD) name
processing of the PDB statement continues.
specified for the SYSMSG keyword on a Partition
Programmer response: Provide a valid label for the Descriptor Block (PDB) statement exceeded 8
PDB statement. characters; the first 8 characters were used.
Severity: 8 System action: A return code of 4 is set, and
processing of the PDB statement continues.
DFS1502I SC=12 NO PD STATEMENTS Programmer response: Provide a valid PD name for
SPECIFIED the SYSMSG keyword on the PDB statement.
Explanation: Each Partition Descriptor Block (PDB) Problem determination: 2, 8, 16
statement must be followed by at least one Partition
Severity: 4
Descriptor (PD) statement.
Related information:
System action: A return code of 12 is set, and PDB
Chapter 2, “IMS problem determination,” on page 5
definition continues.
Programmer response: Define at least one PD
DFS1506I SC=08 SYSMSG= KEYWORD DOES
statement before the PDBEND statement.
NOT SPECIFY A NAME
Severity: 12
Explanation: The SYSMSG keyword was present on
the Partition Descriptor Block (PDB) statement, but was
DFS1503I SC=08 PDBEND STATEMENT HAS not followed by a required Partition Descriptor (PD)
BEEN ASSUMED name.
Explanation: A PDBEND statement, which must System action: A return code of 8 is set, and
terminate a Partition Descriptor Block (PDB) statement, processing of the PDB statement continues.
was not found; one has been assumed.
Programmer response: Provide a valid PD name for
System action: Processing continues with the next the SYSMSG keyword.
source item.
Severity: 8
Programmer response: Provide a PDBEND statement
to terminate the PDB.
DFS1507I SC=04 PDB NAME SPECIFIED ON
Severity: 8 PDB= IS TOO LONG, 1ST 8
CHARACTERS USED
DFS1504 SC=12 KEYWORD 'LUSIZE=' IS Explanation: The Partition Descriptor Block (PDB)
REQUIRED ON THE PDB STATEMENT name in the PDB keyword on the DEV statement
BUT WAS NOT SPECIFIED exceeded 8 characters; the first 8 characters were used.
Explanation: The required LUSIZE keyword was not System action: A return code of 4 is set, and
present on the Partition Descriptor Block (PDB) processing continues on this definition.
statement. The LUSIZE keyword indicates the screen
Programmer response: Correct the name specified in
size to be used for validation of the view ports.
the PDB operand.
System action: A return code of 12 is set, and
Problem determination: 2, 8, 16
processing of the PDB statement continues.
Severity: 4
Programmer response: Specify a LUSIZE keyword on
the PDB statement. Related information:
Chapter 2, “IMS problem determination,” on page 5 Programmer response: Provide a label for the PD
statement.
DFS1508I SC=08 PDB= NAME HAS NO Problem determination: 2, 8, 16
CHARACTERS
Severity: 12
Explanation: The name of a Partition Descriptor Block Related information:
(PDB) is required for the PDB keyword on the DEV
Chapter 2, “IMS problem determination,” on page 5
statement, but a name was not specified.
System action: A return code of 8 is set, and
DFS1514I SC=04 PD STATEMENT NAME IS TOO
processing continues with the next definition.
LONG, AND HAS BEEN TRUNCATED
Programmer response: Provide a name in the PDB TO 8 DIGITS
keyword on the DEV statement.
Explanation: The label on the Partition Descriptor
Problem determination: 2, 8, 16 (PD) statement exceeded 8 characters; the first 8
characters were used.
Severity: 8
Related information: System action: A return code of 4 is set, and
processing of the PD statement continues.
Chapter 2, “IMS problem determination,” on page 5
Programmer response: Provide a valid label for the
PD statement.
DFS1510I SC=08 VALUE IN LUSIZE= TOO
LONG, IS TRUNCATED TO 4 DIGITS Severity: 4
Explanation: The LUSIZE value on the Partition
Descriptor Block (PDB) statement exceeded 4 digits; the DFS1515I SC=12 KEYWORD 'PID=' IS
value was truncated to 4 digits. REQUIRED ON THE PD STATEMENT
BUT WAS NOT SPECIFIED.
System action: A return code of 4 is set, and
processing of the PDB statement continues. Explanation: The required PID keyword, which
identifies the partition, was not specified on the
Programmer response: Provide a valid LUSIZE value
Partition Descriptor (PD) statement.
on the PDB statement.
System action: A return code of 12 is set, and
Severity: 4
processing of the PD statement continues.
Programmer response: Provide a PID keyword on the
DFS1511I SC=08 NO VALUE WAS SPECIFIED IN
PD statement.
LUSIZE= ON PDB STATEMENT FOR
WIDTH AND/OR DEPTH OF DISPLAY Severity: 12
Explanation: The set of values specified for the
LUSIZE keyword on the Partition Descriptor Block DFS1516I SC=12 KEYWORD 'VIEWPORT=' IS
(PDB) statement to describe the size of the display REQUIRED ON THE PD STATEMENT
screen was not valid or was missing. BUT WAS NOT SPECIFIED
System action: A return code of 8 is set, and Explanation: The VIEWPORT keyword is required on
processing of the (PDB) statement continues. each Partition Descriptor (PD) statement, but was not
specified. The VIEWPORT keyword indicates viewport
Programmer response: Provide a valid set of values
size.
for the LUSIZE keyword.
System action: A return code of 12 is set, and
Severity: 8
processing of the PD statement continues.
Programmer response: Provide a VIEWPORT
DFS1513I SC=12 PD STATEMENT NAME
keyword on the PD statement.
REQUIRES A LABEL
Severity: 12
Explanation: Each Partition Descriptor (PD) statement
requires a label, but no label was found. The PD
keyword on the DPAGE statement references the PD DFS1517I SC=12 KEYWORD 'VIEWLOC=' IS
statement by this label. REQUIRED ON THE PD STATEMENT
BUT WAS NOT SPECIFIED.
System action: A label is generated for this PD
statement, and processing of the PD statement Explanation: The VIEWLOC keyword is required on
continues. If more errors are found, the generated label each Partition Descriptor (PD) statement, but was not
is used to reference the PD statement. specified. The VIEWLOC keyword indicates the
viewport location on the screen. Programmer response: Provide a valid name for the
ACTVPID keyword on the DPAGE statement.
System action: A return code of 12 is set, and
processing of the PD statement continues. Severity: 8
Programmer response: Provide a VIEWLOC keyword
on the PD statement. DFS1522I SC=08 DUPLICATE PID NUMBERS
SPECIFIED ON TWO OR MORE PD
Severity: 12
STATEMENTS WITHIN A PDB
DEFINITION
DFS1518I SC=04 PDNAME SPECIFIED ON PD=
Explanation: A Partition Descriptor (PD) statement
IS TOO LONG, 1ST 8 CHARACTERS
has a PID number that was specified on a previous PD
USED
statement within this Partition Descriptor Block (PDB)
Explanation: The Partition Descriptor (PD) name definition.
specified for the PD keyword on the DPAGE statement
System action: A return code of 8 is set, and
exceeded 8 characters; the first 8 characters were used.
processing of the PD statement continues.
System action: A return code of 4 is set and
Programmer response: Provide unique PID numbers
processing of the DPAGE statement continues.
for each PD statement within a PDB definition.
Programmer response: Provide a valid PD name for
Severity: 8
the PD keyword on the DPAGE statement.
Severity: 4
DFS1523I SC=08 PRESENTATION SPACE VALUE
EXCEEDED, TRUNCATED TO 5
DFS1519I SC=08 PD= NAME HAS NO DIGITS
CHARACTERS
Explanation: The values specified on the PRESPACE
Explanation: A PD keyword was found on the keyword of the Partition Descriptor (PD) statement
DPAGE statement, but no Partition Descriptor (PD) exceeded 5 digits; the first 5 digits were used.
name was specified.
System action: A return code of 8 is set, and
System action: A return code of 8 is set, and processing of the PD statement continues.
processing of the DPAGE statement continues.
Programmer response: Provide valid PRESPACE
Programmer response: Provide a valid PD name for values on the PD statement.
the PD keyword on the DPAGE statement.
Severity: 8
Severity: 8
DFS1524I SC=08 NULL PRESENTATION SPACE
DFS1520I SC=04 PDNAME SPECIFIED ON VALUE IGNORED
ACTVPID= TOO LONG, 1ST 8
Explanation: The PRESPACE keyword was found on a
CHARACTERS USED
Partition Descriptor (PD) statement, but no presentation
Explanation: The Partition Descriptor (PD) name values were specified.
specified for the ACTVPID keyword on the DPAGE
System action: A return code of 8 is set, and
statement exceeded 8 characters; the first 8 characters
processing of the PD statement continues.
were used.
Programmer response: Provide valid values for the
System action: A return code of 4 is set, and
PRESPACE keyword, or omit the PRESPACE keyword,
processing of the DPAGE statement continues.
using the default for the VIEWPORT values.
Programmer response: Provide a valid PD name for
Severity: 8
the PD keyword on the DPAGE statement.
Severity: 4
DFS1525I SC=08 VIEWPORT ROWS VALUE
EXCEEDED, TRUNCATED TO 5
DFS1521I SC=08 ACTVPID= NAME HAS NO DIGITS
CHARACTERS
Explanation: The VIEWPORT rows value on a
Explanation: An ACTVPID keyword was found on Partition Descriptor (PD) statement exceeds 5 digits; the
the DPAGE statement, but no name was specified. first 5 digits are used.
System action: A return code of 8 is set, and System action: A return code of 8 is set, and
processing of the DPAGE statement continues. processing of the PD statement continues.
AREA exceeded 1000, or the X'1002' Request (WRITE) long busy entry if return
MADSIOT structure entry reached the code is equal to X'C' (DBFMLBI0 CF_UPDT).
limit of 1000. X'1003' Request (WRITE) long busy entry if return
02 The allowable number of AREA code is greater than X'C' (DBFMLBI0
exceeded 63. CF_UPDT).
03 The MADS I/O timing did not X'1004' Request (WRITE) new owner ID if reason code
terminate within 60 seconds. is not equal to 0 or
04 A MADS I/O timing condition was IXLRSNCODESTATUSUNKNOWN
detected during recovery.
05 A read error occurred during (DBFMLBI0 LONG_BUSY_TKO).
recovery. X'1005' Multiple entry case; request (WRITE) new
06 A write error occurred during owner ID if reason code is not equal to 0 or
recovery.
07 A lock failure occurred during IXLRSNCODESTATUSUNKNOWN
recovery.
08 A logical error occurred during (DBFMLBI0 LONG_BUSY_TKO).
recovery. X'3001' Locking first list header; non-zero return code
09 Shutdown was initiated during (DBFMLBR0 RECOVERY_PHASE1).
MADS I/O timing. X'3002' Resetting lock on first list header; non-zero
0A A read error was detected on the return code (DBFMLBRO
MADS I/O timing ADS. RECOVERY_PHASE1).
0B The MADS I/O timing owner was X'3003' A DELETE_LIST request received a non-zero
not found in the structure. return code. DELETE or DELETE_ENTRYLIST
0C The DMHR buffer was not obtained is retried when
for recovery. RSN=IXLRSNTIMEOUT
0D ADS was stopped by data sharer at
the beginning of recovery. (DBFMLBR0 RECOVERY_PHASE3).
0E DBRC returned a nonzero return X'3004' A request to delete owner entry received a
code. DBRC might not have marked non-zero return code (DBFMLBR0
ADS as stopped. RECOVERY_PHASE3).
0F IRLM returned a nonzero return code. X'3005' A READ_LIST request received a non-zero
The ADS stop request was not sent to return code. The request is retried when
data sharers. RSN=IXLRSNTIMEOUT
11 A deferred second CI refresh failed
due to a second CI error.
(DBFMLBR0 RECOVERY_PHASE3).
13 The dummy read received a long
busy error. ADS closes.
For X'1nnn' reason codes, this message is issued by
14 Long busy recovery received a long
DBFMLBI0; for X'3nnn' reason codes, it is issued by
busy error or the second CI I/O
DBFMLBR0.
received a long busy error. ADS
closes. System action: IMS stops this ADS internally during
IMS MADS I/O timing.
System action: IMS stops this ADS internally.
Programmer response: If the ADS stopped, run the
Programmer response: Correct the problem and run
Create utility to make a new ADS.
the Create utility to make a new ADS.
Module: DBFMLBI0, DBFMLBR0
DFS1556E MADS I/O TIMING ISLLIST REQUEST Related reference:
FAILED FOR AREA areaname RC=rrrr
IXLLIST Return and Reason Codes
RSN=ssss
Explanation: An error occurred when IMS attempted
DFS1558I MADS I/O TIMING ENDED FOR
handling the long busy structure.
AREA areaname DDN=ddname
areaname is the name of the area that the long busy
Explanation: MADS I/O timing ended successfully. In
ADS belongs to. For descriptions of the event codes
the message text:
and rrrr, see the IXLLIST return and reason codes
areaname
information. The first two bytes of the reason code, rrrr,
The name of the area that the long busy ADS
are can be one of the following codes:
belongs to.
X'1001' Request (WRITE) long busy owner if return
ddname The data description name of the long busy
code is greater than 8.
ADS that is registered in the RECON data set.
System action: Processing continues. System action: A return code of 8 is set, and
validation of the Partition Descriptor (PD) statement
Programmer response: No action is required.
continues.
Programmer response: Make sure the dimensions of
DFS1559I MADS I/O TIMING STRUCTURE
the viewport and its offsets (location on the screen) do
REBUILD INITIATED, RSN=rr
not exceed the LUSIZE values.
Explanation: The rebuild of the long busy structure
Severity: 8
was initiated. rr indicates the cause for initiating the
rebuild and can be one of the following codes:
DFS1562I SC=08 THE VIEWPORT POSITION
Reason code
AND DEPTH FOR PD STATEMENT
Explanation
(pdname) DOES NOT FIT ON THE
01 An error occurred in the coupling facility. SCREEN SPECIFIED BY THE PDB
02 A link error was detected. Explanation: The total depth of the screen required for
this viewport exceeded the depth specified on the
03 Operator entered the rebuild command. LUSIZE keyword on the Partition Descriptor Block
System action: The MADS I/O timing function is (PDB) statement. This error occurs when the number of
suspended while a rebuild is in progress. After the PELS or COLS, calculated by adding the viewport's
rebuild completes successfully, the MADS I/O timing offset from the top of the screen and the number of
function continues normally. If the rebuild failed, rows (depth) of the viewport, is greater than the
MADS I/O timing function is disabled. number of PELS or COLS specified on the LUSIZE
keyword.
Operator response: Ensure that the rebuild completes
successfully. Notify the system programmer if a System action: A return code of 8 is set, and
problem occurs during the rebuild. If the rebuild fails, validation of the Partition Descriptor (PD) statement
contact the system programmer to determine why. continues.
Programmer response: Make sure the dimensions of
DFS1560I SC=08 THE PDNAME SPECIFIED ON the viewport and its offsets (location on the screen) do
THE SYSMSG= KEYWORD ON THE not exceed the LUSIZE value.
PDB STATEMENT DOES NOT EXIST Severity: 8
IN THE PD STATEMENTS WITHIN
THIS PDB.
DFS1563I SC=08 THE AREA ON THE DISPLAY
Explanation: The Partition Descriptor (PD) statement SPECIFIED FOR THE VIEWPORTS ON
name, specified on the SYSMSG keyword, was not PD STATEMENTS (pdname and pdname)
found as a label (name) on any Partition Descriptor OVERLAP.
(PD) statement within this Partition Descriptor Block
(PDB) definition. Explanation: The size and location specifications of
the viewport on the named Partition Descriptor (PD)
System action: A return code of 8 is set, and statements caused the VIEWPORTS to overlap.
processing of the PD statement continues.
System action: A return code of 8 is set, and
Programmer response: Make sure that the PD validation of the PD statement continues.
statement name on the SYSMSG keyword corresponds
to a name on a PD statement. Programmer response: Correct the size and location
specifications of the viewport on the named PD
Severity: 8 statements to eliminate overlap.
Severity: 8
DFS1561I SC=08 THE VIEWPORT POSITION
AND WIDTH FOR PD STATEMENT
(pdname) DOES NOT FIT ON THE DFS1564I SC=08 DUPLICATE PD NAME (pdname)
SCREEN SPECIFIED BY THE PDB DETECTED ON THE PD STATEMENTS
WITHIN THIS PDB
Explanation: The width of the screen required for this
viewport exceeded the LUSIZE width specification on Explanation: Duplicate Partition Descriptor (PD)
the Partition Descriptor Block (PDB) statement. This statement names must not be used within a Partition
error occurs when the number of PELS or COLS, Descriptor Block (PDB) definition.
calculated by adding the viewport's offset from the left
System action: A return code of 8 is set, and
of the screen and the number of columns (width) of the
processing of the PD statement continues.
viewport, is greater than the number of PELS or COLS
specified on the LUSIZE keyword. Programmer response: Make sure that each PD
statement within a PDB definition has a unique name. 01 This IMS connected to the structure, but another
IMS failed to connect to the structure.
Severity: 8
02 This IMS cannot connect to the structure.
DFS1565I SC=04 WARNING - PD STATEMENT System action: MADS I/O timing function is disabled.
(pdname) CANNOT BE CHECKED FOR
Programmer response: Correct the problem and issue
OVERLAP WITH OTHER VIEWPORTS
a /START MADSIOT command from an IMS (not the
DUE TO CELLSIZE = ZERO
one that issued the message) to restart MADS I/O
Explanation: The identified viewport might overlap timing. If the problem cannot be corrected, stop the
with other VIEWPORTS. VIEWPORTS are checked for IMS that generated the error and issue the /START
possible overlapping with other VIEWPORTS on the MADSIOT command.
screen. However, when CELLSIZE is specified as zero,
the viewport size is unknown and cannot be compared
DFS1569I SC=08 PDB= WAS SPECIFIED ON THE
with the size of other VIEWPORTS.
DEV STATEMENT, BUT PD= IS NOT
System action: A return code of 4 is set, and SPECIFIED ON THE DPAGE
processing of the Partition Descriptor (PD) statement STATEMENT.
continues.
Explanation: When partitioning is used, the DEV
Programmer response: No action is required. statement must specify the PDB keyword and the
DPAGE statement must specify the PD keyword.
Severity: 4
System action: Processing continues with the next
DEV, MSG, or FMT definition.
DFS1566I SC=12 PDB DOES NOT SPECIFY
LUDEFN=PELS, BUT VARIABLE CELL Programmer response: If partitioning is used, specify
SIZES EXIST IN PD STATEMENTS. the PDB keyword on the DEV statement and the PD
THIS IS INVALID. keyword on the DPAGE statement. Otherwise, remove
both keywords from these statements, and rerun the
Explanation: Unless LUDEFN=PELS is specified, the
job.
cell size of every Partition Descriptor (PD) statement
within the Partition Descriptor Block (PDB) must be the Problem determination: 2, 8, 16
same. At least two different cell sizes were detected.
Severity: 8
System action: A return code of 12 is set, and Related information:
processing of the PD statement continues.
Chapter 2, “IMS problem determination,” on page 5
Programmer response: Either specify the viewport
offsets in pels, or ensure that cell sizes are the same on
DFS1570I SC=08 PD= WAS SPECIFIED ON THE
all PD statements.
DPAGE STATEMENT, BUT PDB= IS
Severity: 12 NOT SPECIFIED ON THE DEV
STATEMENT
DFS1567I MADS I/O TIMING STRUCTURE Explanation: When partitioning is used, the DEV
REBUILD COMPLETED statement must specify the PDB keyword, and the
DPAGE statement must specify the PD keyword.
Explanation: The rebuild of the structure for multiple
area data sets (MADS) I/O timing completed System action: Processing continues with the next
successfully. DEV, MSG, or FMT definition.
System action: Processing continues. Programmer response: If partitioning is used, specify
the PDB keyword on the DEV statement and the PD
Operator response: No action is required.
keyword on the DPAGE statement. Otherwise, remove
both keywords from these statements, and rerun the
DFS1568E MADS I/O TIMING STRUCTURE job.
REBUILD FAILED, RSN=rr
Problem determination: 2, 8, 16
Explanation: One of the IMS systems failed to
Severity: 8
participate in the rebuild of the structure for multiple
area data sets (MADS) I/O timing. The reason code Related information:
indicates the cause of the failure. Chapter 2, “IMS problem determination,” on page 5
Codes
Explanation
DFS1590I SC=04 OUTL VALUE SHOULD BE X'00' DFS1595I SC=04 MAXIMUM VALUE FOR
to X'0F', X'00' ASSUMED. MIX/MIXS'nn' is 31, DEFAULT SET AS
xx
Explanation: The field outlining value specified on the
OUTL'hh' keyword was not a number between X'00' Explanation: The value specified on the MIX/MIXS'nn
and X'0F'. ' keyword exceeded the maximum of 31; xx is used as
the default.
System action: MFS uses the default value X'00'.
System action: Processing continues.
Programmer response: If you do not want to use the
default value, correct the field outlining specification; Programmer response: If the default MIX/MIXS'nn'
then rerun the job, if necessary. value is not sufficient, correct the value; then rerun the
job, if necessary.
DFS1591I SC=08 SO CONTROL CHARACTER IS
OPEN DFS1596I SC=04 DEFAULT CALCULATED IS xx
FOR MIX/MIXS
Explanation: A DBCS/EBCDIC mixed field literal
contained an unpaired SO control character. Explanation: MFS calculated the default for
MIX/MIXS as xx.
System action: MFS does not create the MOD/MID or
DOF/DIF blocks. System action: Processing continues.
Programmer response: Correct the DBCS/EBCDIC Programmer response: If the default MIX/MIXS'nn'
mixed field literal and rerun the job. value is not sufficient, correct the value; then rerun the
job, if necessary.
DFS1592I SC=08 THERE IS A REDUNDANT
TRAILING SI CHARACTER DFS1597I SC=04 MIXD INVALID FOR MIXED
MODE LITERAL FOR SCS1
Explanation: A DBCS/EBCDIC mixed field literal
contained a duplicate closing SI control character Explanation: The MIXD keyword specified on a DFLD
statement for a DBCS/EBCDIC mixed literal field was
System action: MFS does not create the MOD/MID or
invalid for an SCS1 printer.
DOF/DIF blocks.
System action: MFS ignores the keyword MIXD and
Programmer response: Correct the DBCS/EBCDIC
continues processing.
mixed field literal and rerun the job.
Programmer response: Correct the device type or the
keyword; then rerun the job, if necessary.
DFS1593I SC=08 FIELD OUTLINING INVALID
FOR 3270P DEVICE TYPE
DFS1598I SC=04 MIXS and MIX/MIXS WITH 'nn'
Explanation: Field outlining was specified for a 3270P
VALID ONLY FOR TYPE=SCS1
on a DFLD statement, but was not valid for device type
3270P. Explanation: MIXS or MIX/MIXS'nn' was specified for
a device other than an SCS1 printer, but is valid only
System action: MFS ignores the field outlining
for the SCS1 printer.
specification.
System action: MFS ignores the invalid keyword and
Programmer response: Correct the device type or
continues processing.
remove the field outlining specification from the DFLD
statement; then rerun the job. Programmer response: Remove the MIXS or
MIX/MIXS'nn' specification from the DFLD statement;
then rerun the job, if necessary.
DFS1594I SC=08 MIX, MIXD, MIXS, MIX'nn',
MIXS'nn' ARE EXCLUSIVE
DFS1599I SC=08 MIXED MODE LITERAL
Explanation: MIX, MIXD, MIXS, MIX'nn', and
CONTAINS DBCS STRING WITH
MIXS'nn' are mutually exclusive keywords, but more
ODD LENGTH
than one was specified on a DFLD statement.
Explanation: Odd length DBCS data was specified in
System action: MFS does not create the DOF/DIF
a DBCS/EBCDIC mixed field literal, but DBCS data
blocks.
must be even length.
Programmer response: Specify only one of these
Programmer response: MFS does not create
keywords on the DFLD statement; then rerun the job.
MOD/MID and DOF/DIF blocks.
Programmer response: Correct the DBCS/EBCDIC
Explanation: FEAT= specification can only be System action: Processing continues with the next
IGNORE for this device type; IGNORE was assumed. operand.
System action: Processing continues with the next Programmer response: Resolve the conflict, and rerun
operand. the job.
Programmer response: Examine the conflicting
statements, correct the error, and rerun the job. DFS1616I SC=08 FEAT=PARAMETERS ARE
MUTUALLY EXCLUSIVE
DFS1611I SC=08 FEAT=VALUE(S) SPECIFIED Explanation: The features specified cannot coexist;
INVALID FOR SPECIFIED DEVICE they were accepted in the order of occurrence.
TYPE
System action: Processing continues with the next
Explanation: The FEAT= specification conflicted with operand.
the device type; the FEAT= specification was ignored.
Programmer response: Select the wanted features, and
System action: Processing continues with the next rerun the job.
operand.
Programmer response: Correct DEV or respecify DFS1617I SC=04 PEN=FIELDNAME, FIELDNAME
FEAT=, and rerun the job. TRUNCATED TO 8 CHARACTERS
Explanation: PEN= field name exceeded 8 characters;
DFS1612I SC=08 PAGE=EJECT PARAMETER(S) the first 8 characters were used.
INVALID FOR SPECIFIED DEVICE
System action: Processing continues with the next
TYPE
operand.
Explanation: The PAGE= specification conflicted with
Programmer response: Correct the field name, and
the device type; the PAGE= specification was ignored.
rerun the job.
System action: Processing continues with the next
operand.
DFS1618I SC=08 PEN=FIELDNAME, FIELDNAME
Programmer response: Correct DEV or remove HAS NO CHARACTERS
PAGE=, and rerun the job.
Explanation: No field name was supplied for PEN=
specification; it was ignored.
DFS1613I SC=08 FEAT=PFK FORCED FOR PFK=
System action: Processing continues with the next
SPECIFICATION
operand.
Explanation: FEAT=PFK was not specified, although
Programmer response: Supply a field name, and rerun
PFK= was; FEAT=PFK was assumed.
the job.
System action: Processing continues with the next
operand.
DFS1619I SC=04 PFK=(FIELDNAME,
Programmer response: Resolve the conflict, and rerun FIELDNAME TRUNCATED TO 8
the job. CHARACTERS
Explanation: PFK= field name exceeded 8 characters;
DFS1614I SC=08 FEAT=PEN FORCED FOR PEN= the first 8 characters were used.
SPECIFICATION
System action: Processing continues with the next
Explanation: FEAT=PEN was not specified, although operand.
PEN= was; FEAT=PEN was assumed.
Programmer response: Correct the field name, and
System action: Processing continues with the next rerun the job.
operand.
Programmer response: Resolve the conflict, and rerun DFS1620I SC=08 PFK=(FIELDNAME,
the job. FIELDNAME HAS NO CHARACTERS
Explanation: No field name was provided for PFK=
DFS1615I SC=08 FEAT=CARD FORCED FOR specification; it was ignored.
CARD= SPECIFICATION
System action: Processing continues with the next
Explanation: FEAT=CARD was not specified although operand.
CARD= was; FEAT=CARD was assumed.
Programmer response: Supply a field name, and rerun
the job.
System action: Processing continues with the next System action: Processing continues with the next
source item. operand.
Programmer response: Specify field name, if desired, Programmer response: Resolve the conflict, and rerun
and rerun job. the job.
DFS1673I SC=08 POS=nnn REQUIRED FOR DFS1678I SC=08 keyword=operand INVALID FOR
STREAM MODE SPECIFIED DEVICE TYPE
Explanation: The record mode form of the DFLD Explanation: The operand on the specified keyword is
POS= keyword was given when MODE=STREAM; the not allowed for the device type specified by the TYPE=
form POS=nnn is required. The next available stream operand of the DEV statement.
position or the left margin value was used.
System action: The keyword operand is ignored, and
System action: Processing continues with the next processing continues with the next operand.
operand.
Programmer response: Remove the operand, or
Programmer response: Specify the MODE= keyword correct the DEV TYPE= specification, and rerun the job.
of the DEV statement or the POS= keyword of the
DFLD statement, and rerun the job.
DFS1679I SC=08 ATTR=(parms) INVALID FOR
THIS DEVICE
DFS1674I SC=08 LTH=nnn OMITTED.
Explanation: The ATTR=(parms) is valid only for 3270
DEFAULTED TO LTH=1
display device types; it was ignored.
Explanation: No LTH= parameter was specified for
System action: Processing continues with the next
this DFLD; it was set to 1.
operand.
System action: Processing continues with the next
Programmer response: Correct the DEV/DFLD
operand.
specification, and rerun the job.
Programmer response: Correct the LTH= specification,
and rerun the job.
System action: Processing continues with the next System action: The first HT= specification is used,
source statement. multiple specifications are ignored, and processing
continues with the next operand.
Programmer response: Determine the cause of the
IMS REFERAL library error, check the source for syntax Programmer response: Resolve the multiple
errors, and rerun the job. specification conflict, and rerun the job.
DFS1713I SC=16 BAD COMPLETION CODE DFS1717I SC=04 DSCA= KEYWORD HAS NO
FROM IEBCOPY SUBTASK MEANING AND IS IGNORED
COMPRESSION OF Explanation: At present, there are no DSCA-specified
DDNAME=REFOUT. CONTINUING device functions defined for the device type specified.
WITH SYNTAX CHECK ONLY
currently existed in real storage. System action: A STACK OFF statement is assumed,
and termination processing continues.
System action: The stack that currently exists in real
storage is deleted, and stacking is initiated for the Programmer response: Determine if the last stack is
STACK ON statement encountered. needed and, if wanted, rerun the job.
Programmer response: Specify unique identifiers for
all stacks that currently exist in real storage. DFS1739I SC=04 STACK 'ccccccc' WAS NOT
DELETED
DFS1735I SC=08 'UNSTACK' STATEMENT Explanation: All stacks that were still in real storage
CANNOT BE STACKED. 'UNSTACK' when the preprocessor terminates were deleted.
STATEMENT IGNORED
System action: Termination processing continues.
Explanation: An UNSTACK statement was
Programmer response: To ensure that all stacks are
encountered while stacking was in progress. Nested
deleted before termination processing, do not specify
stacking is not allowed.
the KEEP option on the last UNSTACK statement for
System action: The UNSTACK statement is ignored, each stack.
and stacking continues for the current STACK ON
statement.
DFS1740I SC=08 DEV SPECIFICATION EXCEEDS
Programmer response: Rearrange the source DESIGN LIMITS
statements in the program so that nested stacking is not
Explanation: The processing of this parameter can
required, and rerun the job.
cause the DEV control block (DEVITB) to exceed the
maximum design size. This situation normally only
DFS1736I SC=08 STACK NOT FOUND FOR happens when you specify many long literals for PF
IDENTIFIER SPECIFIED IN keys. However, the check is made for FORMS literals,
'UNSTACK' STATEMENT. 'UNSTACK' FTABS, horizontal tabs (HT), vertical tabs (VT), and all
STATEMENT IGNORED PF key specifications. The combined specification of
these parameters in one DEV statement cannot exceed
Explanation: An UNSTACK statement identified a
4064 minus the basic size of the DEVITB (of
stack that was not currently in real storage.
approximately 100 bytes).
System action: The UNSTACK statement is ignored
System action: Processing stops for the keyword that
and processing continues with the next source
caused the message to be issued and continues with the
statement.
next keyword.
Programmer response: Validate the spelling of the
Programmer response: Reduce the number and length
stack identifier or specify the KEEP option on a
of literals, or only specify the maximum allowed
previous UNSTACK statement with the same stack
number of horizontal and vertical tabs, or both. Rerun
identifier.
the job.
Programmer response: Resolve the multiple Programmer response: Specify the appropriate left
specification conflict, and rerun the job. margin, and rerun the job.
DFS1743I SC=04 MULTIPLE VT= KEYWORDS DFS1748I SC=04 HORIZONTAL TAB STOP
INVALID VALUE TRUNCATED TO LAST 3
DIGITS
Explanation: More than one VT= keyword is invalid
on a single DEV statement. Explanation: A tab value in the HT= specification of
the HTAB= keyword exceeded 3 digits.
System action: The first VT= specification is used,
multiple specifications are ignored, and processing System action: The last 3 digits of the tab stop are
continues with the next operand. used, and processing continues with the next operand.
Programmer response: Resolve the multiple Programmer response: Specify the tab stop value with
specification conflict, and rerun the job. 3 or fewer digits, and rerun the job.
DFS1744I SC=04 WIDTH=nnn; nnn TRUNCATED DFS1749I SC=08 NULL HORIZONTAL TAB STOP
TO LAST 3 DIGITS VALUE IGNORED
Explanation: The width specified in the WIDTH= Explanation: A null horizontal tab stop value was
keyword exceeded 3 digits. encountered in the HT= specification of the HTAB=
keyword. Error-recovery procedures assumed a tab stop
System action: The last 3 digits of the width are used
value with no digits ($I$).
and processing continues with the next operand.
System action: The null horizontal tab stop is ignored,
Programmer response: Specify a width of 3 or fewer
and processing continues with the next operand.
digits, and rerun the job.
Programmer response: Ensure that the syntax of the
HTAB= keyword is valid, and rerun the job.
DFS1745I SC=04 WIDTH=nnn; nnn HAS NO
DIGITS. DEFAULT VALUE USED
DFS1750I SC=04 VERTICAL TAB STOP VALUE
Explanation: The width specified in the WIDTH=
TRUNCATED TO LAST 3 DIGITS
keyword was null.
Explanation: A tab stop value in the VT= keyword
System action: The default width for the specified
exceeded 3 digits.
device type is used, and processing continues with the
next operand. System action: The last 3 digits of the tab stop are
used, and processing continues with the next operand.
Programmer response: Specify the appropriate width,
and rerun the job. Programmer response: Specify the tab stop value with
3 or fewer digits, and rerun the job.
DFS1746I SC=04 LEFT MARGIN VALUE OF
HTAB= KEYWORD TRUNCATED TO
LAST 3 DIGITS
Explanation: The left margin value specified in the
HTAB= keyword exceeded 3 digits.
System action: The last 3 digits of the left margin
value are used, and processing continues with the next
operand.
Programmer response: Specify a left margin value of 3
or fewer digits, and rerun the job.
System action: LTH=8 is assumed, and processing Programmer response: Remove ATTR=YES or
continues with this operand. ATTR=nn from the DFLD statement, and rerun the job.
Programmer response: Specify LTH=8 or omit the
LTH= operand on the DFLD statement, and rerun the
job.
Explanation: A number was not specified after the an FTAB character is reached. An FTAB character of
symbolic device type on the TYPE= operand. X'00' was not treated as an FTAB, but is deleted as an
EBCDIC null.
System action: A device type identifier is assumed,
and processing continues with this operand. Device System action: Processing continues with this
types that can be assumed are: DPM-A1, DPM-B1, or operand.
3270-A1.
Programmer response: If DIV NULL=DELETE is
Programmer response: Specify a valid number on the specified, change the DIV NULL=DELETE specification
TYPE= operand, and rerun the job. or do not define X'00' as a hexadecimal digit in an
FTAB character. Rerun the job.
DFS1809I SC=08 INVALID INTEGER SPECIFIED
IN type DEVICE TYPE. type-identifier DFS1813I SC=04 MULTIPLE FLDEXIT/
ASSUMED NOFLDEXIT SPECIFICATIONS IN
OPTIONS= KEYWORD INVALID
Explanation: A device-type identifier must be
specified as a 1- or 2-digit number from 1 to 15 as part Explanation: Multiple FLDEXIT or NOFLDEXIT
of the TYPE= operand in the DEV statement. options were supplied on the DIV statement
OPTIONS= specification.
System action: A device type identifier is assumed,
and processing continues with this operand. Device System action: The first FLDEXIT or NOFLDEXIT
types that can be assumed are: DPM-A1, DPM-B1, or option specified is used, and processing continues with
3270-A1. this operand.
Programmer response: Specify a valid integer for DEV Programmer response: Remove the multiple FLDEXIT
TYPE= operand, and rerun the job. or NOFLDEXIT options from the OPTIONS=
specification, and rerun the job.
DFS1810I SC=08 FTAB=X'HEXSTRING' TOO
LONG. HEX STRING TRUNCATED TO DFS1814I SC=08 USER FTAB CHARACTERS
FIRST 16 DIGITS REQUIRED FOR MIX OR ALL. NONE
DEFINED. FORCE ASSUMED
Explanation: More than 16 hexadecimal digits were
found in the FTAB=X'HEXSTRING' specification. Explanation: Input data editing for the MIX or ALL
options require user-defined FTAB characters. No FTAB
System action: The hexadecimal string is truncated to
characters were defined.
the first 16 hexadecimal digits. Processing continues
with this operand. System action: FORCE is assumed. Processing
continues with this operand.
Programmer response: Correct the hexadecimal string
FTAB specification, and rerun the job. Programmer response: Supply FTAB characters or
change the MIX or ALL option to FORCE. Rerun the
job.
DFS1811I SC=08 'HEXSTRING' CONTAINS ODD
NO. OF DIGITS. LAST BYTE PADDED
ON RIGHT WITH 0 DFS1815I SC=08 LDEL='LITERAL' LENGTH NOT
EQUAL 2. DEVICE TYPE DEFAULT
Explanation: An odd number of hexadecimal digits
USED
was found in the specification. The last hexadecimal
digit is padded by a hexadecimal zero to complete the Explanation: More than 2 line-delete characters were
character. specified on the LDEL= operand.
System action: Processing continues with this System action: The LDEL= operand is ignored and
operand. the device type default is used. Processing continues
with this operand.
Programmer response: Specify an even number of
hexadecimal digits in the hex string specification, and Programmer response: Specify 2 line-delete characters,
rerun the job. and rerun the job.
Programmer response: Remove the multiple record Programmer response: Remove the multiple FIXED or
size numbers, and rerun the job. VARIABLE options from the HDRCTL= specification,
and rerun the job.
DFS1827I SC=04 MULTIPLE HDRCTL NUMBER DFS1832I SC=08 RCDCTL= INVALID FOR
SPECIFICATIONS INVALID SPECIFIED DEVICE TYPE
Explanation: Only one numeric-length specification is Explanation: RCDCTL= is only valid for TYPE=
valid for the HDRCTL= keyword. DPM-A1 through DPM-A10 on the DEV statement.
System action: The first numeric-length specification System action: The RCDCTL= specification is ignored,
is used, and processing continues with this operand. and processing continues with the next operand.
Programmer response: Specify only one numeric Programmer response: Correct the DEV.TYPE=
length on the HDRCTL= specification, and rerun the statement or remove the RCDCTL= specification, and
job. rerun the job.
DFS1829I SC=08 NULL HDRCTL NUMBER. DFS1834I SC=08 keyword= INVALID FOR
DEFAULT ASSUMED SPECIFIED DEVICE TYPE
Explanation: You specified null for HDRCTL=. Explanation: The keyword is not allowed for the
device type specified by the TYPE= operand in the
System action: The default of 7 is used, and
DEV statement.
processing continues with this operand.
System action: The keyword specification is ignored,
Programmer response: Omit the length specification
and processing continues with the remaining keyword.
or specify an appropriate HDRCTL= numeric length,
and rerun the job. Programmer response: Correct the DEV TYPE=
specification or remove this keyword, and rerun the
job.
DFS1830I SC=04 MULTIPLE SIM/NOSIM2
SPECIFICATIONS IN OPTIONS=
KEYWORD INVALID DFS1835I SC=08 NULL= INVALID FOR
SPECIFIED DEVICE TYPE
Explanation: SIM or NOSIM2 was specified more than
once in a single OPTIONS= keyword. Explanation: The DIV statement NULL= specification
is only valid for DEV TYPE=DPM-A1 through
System action: The first SIM or NOSIM2 specification
DPM-A10.
is used, and processing continues with this operand.
System action: The NULL= specification is ignored,
Programmer response: Resolve the multiple SIM or
and processing continues with the next operand.
NOSIM2 specification conflict, and rerun the job.
Programmer response: Correct the DEV.TYPE=
specification or remove the NULL= specification, and
DFS1831A SC=04 MULTIPLE operand/operand
rerun the job.
SPECIFICATIONS IN OPTIONS=
KEYWORD INVALID
DFS1836I SC=08 MSG/DPAGE/PPAGE
Explanation: Conflicting operands were specified in
PARAMETERS INVALID ON
the OPTIONS= keyword.
OPTIONS= KEYWORD FOR DIV
System action: The first operand specified by the user TYPE=INPUT
is used, and processing continues.
Explanation: For DIV TYPE=INPUT, the options
Programmer response: Resolve the conflicting MSG/DPAGE/PPAGE are invalid on the OPTIONS=
operands by selecting DNM or NODNM, or MSG, or keyword.
both, DPAGE or PPAGE.
System action: These options are ignored, and
processing continues with this operand.
Programmer response: Remove the when used for DIV TYPE=OUTPUT. Processing
MSG/DPAGE/PPAGE parameters from the OPTIONS= continues with the next operand.
keyword or change the DIV TYPE to OUTPUT. Rerun
Programmer response: Resolve the NULL= or DIV
the job.
TYPE=OUTPUT conflict, and rerun the job.
DFS1855I SC=08 VERSID LENGTH INVALID, 'cc' DFS1859I SC=08 DEVCHAR TABLE DFSUDT00
USED NOT FOUND. NO TABLE LOADED
Explanation: The specification for version ID was Explanation: The device characteristics table
either less than or greater than 2 characters. DFSUDT00 was not found in IMS.SDFSRESL.
System action: The 2 characters (cc) presented in the System action: The system issues message DFS1861I,
message are used for the version ID. If less than 2 assumes an IBM 3270 model 2 device type, and
characters are specified, blanks are added. If more than continues processing.
2 characters are specified, the first 2 characters are
used. Programmer response: Specify a device characteristics
table suffix that identifies the desired member in
Programmer response: Correct the version ID IMS.SDFSRESL before using the symbolic device type
specification by using exactly 2 characters and rerun 3270-An on the DEV statement.
the job.
Related information:
“DFS1861I” on page 382
DFS1856I SC=04 PF KEY NUMBER 'nnnnnnnn' IS
NOT A VALID INTEGER.
SUBPARAMETER IGNORED
System action: A 3270 model 2 device type is Explanation: For DIV TYPE=INPUT, the option
assumed, and processing continues. PPAGE is invalid on the OPTIONS= keyword.
Programmer response: Correct the cause of message System action: The PPAGE option is ignored, and
DFS1859I or DFS1860I, and rerun the job. processing continues with this operand.
Related information: Programmer response: Remove PPAGE from the
“DFS1859I” on page 381 OPTIONS= keyword or change the DIV TYPE to
OUTPUT. Rerun the job.
“DFS1860I”
pointed to by the DFSRESLB DD card. The xxx” message is correct. If you do not wish to
utility terminates with RC=0004. Resolve the continue, reply “NO” to the WTOR message. If
problem with the data set and resubmit the you decide to continue, reply “YES” to the
utility job. WTOR. See your system administrator to
determine the correct course of action.
DATA SET APF AUTHORIZATION FAILED - SEE
DFSRESLB DD CARD IMS RELEASE LEVELS INCONSISTENT - RESLIB
The RESLIB specified on the DFSRESLB DD SVC IS AT A LOWER LEVEL THAN CURRENT
card is not APF authorized. The utility SVC The MVS SVC table entry points to a newer
terminates with RC=0008. The RESLIB must be version of the SVC than is found in the IMS
APF authorized in order for the utility to run RESLIB data sets. The utility issues a WTOR
successfully. Ensure that the DFSRESLB DD message to allow you to decide what to do.
card is pointing to the correct data sets and Ensure that the correct IMS RESLIB data sets
that those data sets are APF authorized. are specified. If you do not wish to continue,
reply “NO” to the WTOR message. If you
MODULE DFSVC000 NOT FOUND - SEE DFSRESLB
decide to continue, reply “YES” to the WTOR.
DD CARD
See your system administrator to determine
The secondary SCD (DFSVC000) cannot be
the correct course of action.
located. The utility terminates with RC=0012.
The IMS RESLIB contains the SSCD. Ensure THERE IS CURRENTLY AN ACTIVE IMS USING
that the DFSRESLB DD card is pointing to the THE SAME SVC NUMBER
correct data sets and resubmit the job. One or more IMS control regions are currently
running and referencing the IMS Type 2 SVC.
MODULE xxxxxxxx NOT FOUND - SEE DFSRESLB
The utility terminates with RC=0032. You must
DD CARD
wait until the currently active IMS control
xxxxxxxx is the name of the SVC module being
regions can be scheduled to be brought down.
updated. If the IMS Type 2 SVC is being
At that time, resubmit the job.
updated, the module name is IGCxxx, where
xxx is the IMS Type 2 SVC number. If the MVS SVC TABLE UPDATE SERVICES FAILED -
DBRC Type 4 SVC is being updated, the RC=xx A non-zero return code was returned from the
module name is IGC00xxx, where xxx is the MVS SVC Update service (SVCUPDTE). xx is
signed decimal SVC number for the DBRC the return code. See the SVCUPDTE macro for
Type 4 SVC. The utility terminates with return code explanations.
RC=0016 or RC=0044. The IMS RESLIB data
MODULE DSPSVC00 NOT FOUND - SEE
sets should contain the SVC modules. Ensure
DFSRESLB DD CARD
that the DFSRESLB DD card is pointing to the
Module DSPSVC00, which contains the DBRC
correct data sets and resubmit the job.
Type 4 SVC number, cannot be located. The
MVS SVC TABLE ENTRY WAS EMPTY - WTOR utility terminates with RC=0040. The IMS
REPLY WAS NO RESLIB contains module DSPSVC00. Ensure
The MVS SVC table entry for the SVC was that the DFSRESLB DD card is pointing to the
empty. There is a DFS1886A message correct data sets and resubmit the job.
preceding this message to which the operator
MVS SVC TABLE CONTAINS AN ACTIVE SVC
replied “NO.” If the operator did not expect
THAT IS NOT A DBRC SVC
the entry to be empty, this reply is probably
The MVS SVC table entry contains an active
correct. The utility terminates with RC=0020.
SVC that is not a DBRC SVC. The utility issues
Ensure that the correct IMS RESLIB data sets
a WTOR message to allow you to decide what
are specified and resubmit the job. This is an
to do. Ensure that the correct IMS RESLIB data
unusual condition, unless you are expecting
sets are specified and that the SVC number
this SVC entry to be empty. You might want to
returned in the previous “DFS1886I DBRC
consult your system administrator if this
TYPE 4 SVC NUMBER = xxx” message is
situation occurs.
correct. If you do not wish to continue, reply
MVS SVC TABLE CONTAINS AN ACTIVE SVC “NO” to the WTOR message. If you decide to
THAT IS NOT AN IMS SVC continue, reply “YES” to the WTOR. See your
system administrator to determine the correct
The MVS SVC table entry contains an active
course of action.
SVC that is not an IMS SVC. The utility issues
a WTOR message to allow you to decide what INVALID VALUE SPECIFIED FOR SVCTYPE=
to do. Ensure that the correct IMS RESLIB data INPUT PARAMETER
sets are specified and that the SVC number An invalid value was specified for the
returned in the previous “DFS1886I IMS TYPE SVCTYPE= input parameter. The utility
2 SVC NUMBER = xxx” message or the
“DFS1886I DBRC TYPE 4 SVC NUMBER =
terminates with RC=0056. Resolve the problem To respond to the WTOR message, enter REPLY
with the input parameter and resubmit the xx,yyy from the z/OS operator console, where:
utility job. xx WTOR number.
Related information: yyy The character string YES or NO:
NO The utility terminates
“DFS1886I” on page 385
abnormally with RC=0028.
“DFS1886A” YES The utility continues and
uses an older version of the
DFS1886A SVC message SVC.
Explanation: One or more of the following SVC MVS SVC TABLE ENTRY = ACTIVE SVC THAT IS
messages can be issued. The operator should take the NOT A DBRC SVC - DO YOU WISH TO
actions included below: CONTINUE? (YES OR NO)
The MVS SVC table entry contains an active
MVS SVC TABLE ENTRY = EMPTY - DO YOU SVC that is not a DBRC SVC. Ensure that the
WISH TO CONTINUE? (YES or NO) correct IMS RESLIB data sets are specified. To
This is an unusual condition. Ensure that the respond to the WTOR message, enter REPLY
correct IMS RESLIB data sets were specified. xx,yyy from the z/OS operator console, where:
You might want to consult your system xx WTOR number.
administrator if this situation occurs. To yyy The character string YES or NO:
respond to the WTOR message, enter REPLY NO The utility terminates
xx,yyy from the z/OS operator console, where: abnormally with RC=0048.
xx WTOR number. YES The utility continues and
yyy The character string YES or NO: reuses the MVS SVC table
NO The utility terminates entry.
abnormally with RC=0020.
YES The utility continues and This is an unusual condition. Unless you are
uses the empty entry. expecting to reuse an SVC entry that is no
MVS SVC TABLE ENTRY = ACTIVE SVC THAT IS longer needed, you should respond with a
NOT AN IMS SVC - DO YOU WISH TO reply of NO. See your system administrator
CONTINUE? (YES OR NO) for the correct course of action.
The MVS SVC table entry contains an active MVS SVC TABLE ENTRY = DBRC SVC AT HIGHER
SVC that is not an IMS SVC. Ensure that the RELEASE THAN RESLIB SVC - DO YOU WISH TO
correct IMS RESLIB data sets are specified. To CONTINUE? (YES OR NO)
respond to the WTOR message, enter REPLY The MVS SVC table entry points to a newer
xx,yyy from the z/OS operator console, where: version of the DBRC SVC than is found in the
xx WTOR number. IMS RESLIB data sets. Ensure that the correct
yyy The character string YES or NO: IMS RESLIB data sets are specified. If you do
NO The utility terminates not wish to continue, reply NO to the WTOR
abnormally with RC=0024. message. If you decide to continue, reply YES
YES The utility continues and to the WTOR. See your system administrator
reuses the MVS SVC table to determine the correct course of action.
entry.
To respond to the WTOR message, enter REPLY
This is an unusual condition. Unless you are xx,yyy from the z/OS operator console, where:
expecting to reuse an SVC entry that is no xx WTOR number.
longer needed, you should respond with a yyy The character string YES or NO:
reply of NO. See your system administrator NO The utility terminates
for the correct course of action. abnormally with RC=0052.
YES The utility continues and
MVS SVC TABLE ENTRY = IMS SVC AT HIGHER uses an older version of the
RELEASE THAN RESLIB SVC - DO YOU WISH TO SVC.
CONTINUE? (YES OR NO)
The MVS SVC table entry points to a newer
version of the SVC than is found in the IMS DFS1887I SC=04 DPAGE FILL= IN CONFLICT
RESLIB data sets. Ensure that the correct IMS WITH EGCS ATTRIBUTE
RESLIB data sets are specified. If you do not Explanation: The FILL= specification on the DPAGE
wish to continue, reply NO to the WTOR statement caused an error indication from the terminal
message. If you decide to continue, reply YES for EGCS fields that contain no data.
to the WTOR. See your system administrator
to determine the correct course of action. System action: Processing continues.
System action: The bottom margin value is set to the maximum lines per page value from the PAGE=
last 3 digits, and processing continues. specification, and processing continues.
Programmer response: Specify the bottom margin Programmer response: Change the bottom margin
value not to exceed 3 digits, and rerun the job. value, and rerun the job.
Severity: 8 Severity: 8
DFS1909I SC=04 NULL BOTTOM MARGIN DFS1914I INQUIRE ERROR NODE x RTNFDBK y
VALUE WILL BE SET TO MAXIMUM SENSE z
PAGE VALUE
Explanation: An INQUIRE for session parameters
Explanation: VTAB= was specified without a bottom during the logon for NODE x failed. The attempted
margin value. session initiation was terminated. VTAM provided the
return code and feedback (y) with sense information (z)
System action: The bottom margin value is set to the
as the reason for the failure.
maximum lines per page value from the PAGE=
specification. System action: The system continues.
Programmer response: Respecify the VTAB= top Operator response: See the system programmer.
margin value, and rerun the job.
Programmer response: Examine the BIND parameters
Problem determination: None. in the mode table for NODE x for correctness, and the
VTAM return code and sense information for the
Severity: 4
recovery action to be taken. Try to initiate the session
for NODE x again.
DFS1910I SC=08 WIDTH= SPECIFICATION
Problem determination: 1, 5, 6, 12, 14, 2
INVALID WITH FEAT= IGNORE OR IF
FEAT= IS UNSPECIFIED Related information:
Chapter 2, “IMS problem determination,” on page 5
Explanation: The WIDTH= was specified while
FEAT= IGNORE was specified or FEAT= was
unspecified. DFS1915I UNSUPPORTED SCIP EXIT/VTAM
ERROR
System action: WIDTH= value is ignored. A default
width of 120 is used, and processing continues. Explanation: VTAM drove the IMS SCIP exit with an
invalid command or an invalid parameter list.
Programmer response: Specify the DEV statement
with a valid combination of WIDTH= and FEAT= System action: IMS rejected VTAM entry to the SCIP
values, and rerun the job. exit and returned to VTAM with an error code. IMS
continues.
Severity: 8
Operator response: No action is required.
DFS1911I SC=08 VERTICAL TAB STOP EXCEEDS Programmer response: Examine and correct possible
PAGE LENGTH. TAB STOP SET TO inconsistencies in the VTAM definitions.
ZERO
Problem determination: 1, 5, 6, 12, 14, 25
Explanation: The DEV statement VT= specification Related information:
exceeded the page length. The specification must be
Chapter 2, “IMS problem determination,” on page 5
equal to or less than PAGE= specification.
System action: The specified value is reset to zero,
DFS1916I hh:mm:ss ATTEMPT TO START
and processing continues.
SECONDARY SESSION BUT WAS
Programmer response: Specify the vertical tab stop in PRIMARY NODE xxx ims-id
error, and rerun the job.
Explanation: An attempt to start a session with NODE
Severity: 8 xxx as the secondary half-session resulted in an error
and a termination of the attempt. The previous session
with NODE xxx initiated as a primary half-session,
DFS1912I SC=08 VTAB= BOTTOM MARGIN
terminated abnormally.
VALUE EXCEEDS 255, THE MAXIMUM
PAGE= VALUE System action: IMS rejected the attempt to start the
session as a secondary. IMS continues.
Explanation: The DEV statement VTAB= specification
has a bottom margin value greater than 255. Operator response: See the Programmer response.
System action: The bottom margin is reset to the Programmer response: Examine the session initiation
process, and determine the cause of the previous execution parameters. Message DFS1920I results when
session failure. Correct the procedure and attempt the values of the final parameters do not meet the system
session initiation again. definition requirements.
Problem determination: 1, 5, 6, 12, 14, 25
With some parameters, this error results in abend 0083
Related information: after all the final parameters have been evaluated. The
Chapter 2, “IMS problem determination,” on page 5 value zzzzz=ABEND identifies the parameters with the
unrecoverable error.
DFS1917I INVALID CID System action: User abend 0083 results when ABEND
appears in at least one DFS1920I message. If the abend
Explanation: VTAM used an invalid control interval
does not occur, all parameters identified by DFS1920I
definition (CID), or the CID in the IMS control block
receive their default values.
was overlaid. The NODE name cannot be found for the
session initiation. Programmer response: Determine if the system should
continue operating with the default value. If not, shut
System action: IMS rejected the VTAM entry to one of
down IMS and rerun the system with a corrected
the IMS exits and returned to VTAM with an error
parameter.
code. IMS continues.
Module: DFSIIDC0
Operator response: See the Programmer response.
Related information:
Programmer response: Determine whether VTAM has
operational problems. If possible, create a snap memory IMS abend 0083
dump of the IMS CLB control blocks to determine if
any of them are overlaid.
DFS1921I PARAMETER KEYWORD INVALID,
Problem determination: 1, 5, 6, 12, 14, 25 xxxxxxxx=yyyyyyyy
Related information: Explanation: An invalid keyword was found. In the
Chapter 2, “IMS problem determination,” on page 5 message text, the variables and their meanings are:
xxxxxxxx
Parameter keyword (First 8 characters)
DFS1918A DFSURDB0 CANNOT PROCESS yyyyyyyy
CONCATENATED INPUT DATA SETS Parameter value (First 8 characters)
FOR DD DFSUCUM
Explanation: The architecture of the recovery utility IMS execution parameters can be specified with JCL or
DFSURDB0 does not permit the use of concatenated with the DFSPBxxx and DFSDCxxx members. Message
files as input using the DFSUCUM DD statement. DFS1921I results when invalid keywords are in the
parameters specified with DFSPBxxx, DFSDCxxx, or
System action: Processing terminates with return code JCL. For example, invalid keywords might be
8 after issuing this message. misspelled or might be invalid for the type of IMS
Programmer response: Submit individual jobs for the control region being started.
utility, each with only one data set as the DFSUCUM
DD input. The DFSPBxxx member might use all 80 columns of the
record. If you have parameters names starting in
column 1, be sure that you do not have sequence
DFS1920I PARAMETER VALUE INVALID, numbers in columns 73 through 80.
xxxxxxxx=yyyyyyyyzzzzz
System action: The system continues.
Explanation: An invalid parameter was found.
Programmer response: Determine if the system should
In the message text: continue operating after using a parameter that was not
xxxxxxxx correctly specified and was ignored. If necessary, shut
Parameter keyword (First 8 characters) down IMS and correct the parameter in error.
yyyyyyyy
Parameter value (First 8 characters)
zzzzz ABEND, if an invalid value for this parameter DFS1922I GSAM OPEN OF DD xxxxxx FAILED,
causes abend 0083 during initialization. REASON CODE=reason
Explanation: An attempt to open GSAM data set
IMS execution parameters can be specified with JCL or xxxxxx failed for one of the following reasons:
with the DFSPBxxx or DFSDCxxx members. The JCL X'20' MVS OPEN call failed.
specified parameters override any parameters specified X'24' An OPEN call to a specific concatenated data
with DFSPBxxx or DFSDCxxx, resulting in the final set failed. Most likely, there is a missing data
set in the concatenation.
X'28' An OBTAIN of the data set DSCB failed. System action: The message is ignored.
Ensure that the data set has been properly
Programmer response: This problem is temporary. If
allocated.
the problem persists, print X'67D0', subtype X'D00D'
X'2C' An OBTAIN of a concatenated data set DSCB
log records to identify the return and reason codes for
failed. Ensure that the data set has been
the registration failure.
properly allocated.
X'30' A fixed data set block size is zero. Ensure that Module: DBFHIEL0
the data set has been properly allocated.
X'34' A fixed data set logical record length is zero.
Ensure that the data set has been properly DFS1928 DBRC RETURNED A ZERO LENGTH
allocated. MESSAGE, CANNOT PROCESS
X'38' A fixed data set block size is not a multiple of COMMAND
the logical record length. Change the block Explanation: A DBRC request submitted by the
size or logical record length so the block size /RMxxxxxx command processor returned a zero-length
is a multiple of the logical record length. message.
X'3C' A previous call to a dummy data set
encountered an error. The data set cannot be System action: The /RMxxxxxx command is rejected.
opened. IMS issues this message and continues execution.
X'40' An attempt to open a striped data set was Programmer response: Determine the reason for the
made; however, the DFSMS release level is not DBRC failure. See the z/OS master console (SYSLOG)
at DFSMS 1.2.0 or later. for DSP messages that might explain the cause of the
X'44' The volume number does not exist in condition.
JFCBNVOL.
X'48' Current volume serial number in UCB does Problem determination: 1, 6, 36, 40, 41
not match in JFCBVOLS. Module: DFSICLW0
Problem determination: 1, 3, 17a, 18 Related information:
Related information: Chapter 2, “IMS problem determination,” on page 5
Chapter 2, “IMS problem determination,” on page 5
DFS1929I IMS SYSTEM PARAMETERS init_activ
DFS1924 KEYWORD RESOURCE NOT FOR THIS V nn.n crt EXECUTION:
DEFINED * parameter *
Explanation: A command was entered requesting a Explanation: IMS issues these messages when IMS
specific resource when the keyword resource is not control region initialization completes and when IMS
defined for the IMS system. control region restart completes. The initial IMS system
parameters that are active from DFSPBxxx and EXEC
Operator response: Correct the command. parameters are displayed in this message when IMS
Programmer response: Check the keyword resource initialization completes. The IMS system parameters
against the IMS generated system to determine if the that are displayed after initialization might not reflect
resource is installed. the actual values that are used during online execution.
However, when DFS1929I is issued after an IMS restart
completes, it displays the actual values that are used
DFS1925 CONVERSATION RESOURCE NOT during online execution.
DEFINED
The message header that is issued when IMS control
Explanation: A command was entered requesting region initialization completes contains a keyword
information from a conversation resource that is not INITIAL. The message header that is issued when IMS
defined in the IMS system. restart completes contains the keyword ACTIVE.
Operator response: Correct the command. Fast Path parameters are suppressed if Fast Path is not
Programmer response: Check the TRANSACT and active (FP=N).
SPAREA macro definitions for conversation resource. In the message text:
init_activ
DFS1927 UNABLE TO PROCESS SHARED EMH One of the following:
DUE TO LTERM REGISTRATION INITIAL when the message is issued
FAILURE during initialization
ACTIVE when the message is issued
Explanation: While using the shared expedited during a restart
message handler (EMH) to process an input message, nn.n IMS version number, such as 10.1
Fast Path tried to register LTERM interest to CQS.
However, the LTERM registration failed.
crt Control region type, such as DBDC, DBCTL, Chapter 2, “IMS problem determination,” on page 5
DCCTL, or FDBR
DFS1932 CONVERSATION IN PROGRESS
In the message text, parameters are the IMS system
-CANNOT PROCESS COMMAND.
parameters. An example of message DFS1929I follows:
DFS1929I * IMS SYSTEMPARAMETERS ACTIVE FOR THIS V10.1 DBDC EXECUTION: Explanation: A /DISPLAY, /RDISPLAY, or /FORMAT
DFS1929I * ALOT = 1440
DFS1929I
DFS1929I
*
*
AOIP
AOIS
= 2147483647
= N
command was entered while a conversation transaction
DFS1929I
DFS1929I
*
*
AOI1
APPC
=
= N
was in progress. These commands generate queued
DFS1929I
DFS1929I
*
*
APPCSE
APPLID1
= F
=
output that cannot be sent while the terminal or node
DFS1929I
DFS1929I
*
*
APPLID2
APPLID3
=
= APPL7 is in conversation mode.
.
.
DFS1929I * TCORACF = N System action: The entered command is ignored.
DFS1929I * SVSODR = NONE
DFS1929I * TRACK = NO
DFS1929I
DFS1929I
*
*
TRN
TSR
=
= L
Operator response: The conversation must be
DFS1929I
DFS1929I
*
*
UHTS = 256
USERVAR = IMS1 terminated by the application or the terminal operator
DFS1929I * VAUT = 1
DFS1929I * VSPEC = 91 (/EXIT) before the command is accepted.
DFS1929I * WADS = S
DFS1929I * WKAP = 40960
DFS1929I * YEAR4 = N
or or
UNABLE TO TERMINATE FUNCTIONS FOR CQS UNABLE TO IDENTIFY THE IMS CONTROL
COMMUNICATION - FUNCTION=CQSDISC REGION TO CQS AS A CLIENT -
STRUCTURE=cccc, COMPCODE=zzzzzzzz FUNCTION=CQSCONN, STRUCTURE=cccc,
COMPCODE=zzzzzzzz
or
or
UNABLE TO TERMINATE FUNCTIONS FOR CQS
COMMUNICATION - FUNCTION=CQSDISC UNABLE TO IDENTIFY THE IMS CONTROL
STRUCTURE=cccc, COMPCODE=zzzzzzzz REGION TO CQS AS A CLIENT -
STRUCTURE=cccc, COMPCODE=zzzzzzzz FUNCTION=CQSCONN, STRUCTURE=cccc,
Explanation: IMS encountered an error while COMPCODE=zzzzzzzz STRUCTURE=cccc,
attempting to terminate functions required for CQS COMPCODE=zzzzzzzz
communication. Explanation: An error occurred while attempting to
The first form of the message is issued if a completion identify the IMS control region to CQS as a client that
code is not returned. will use shared queues on the coupling facility.
The second form of the message is issued if the The first form of the message is issued if a completion
function is CQSDISC, only one structure (MSGQ or code is not returned.
EMHQ) is in error, and a nonzero completion code is The second form of the message is issued if the
returned. function is CQSCONN, only one structure (MSGQ or
The third form of the message is issued if the function EMHQ) is in error, and a nonzero completion code is
is CQSDISC, both the MSGQ and EMHQ structures are returned.
in error, and a nonzero completion code is issued. The third form of the message is issued if the function
failing_function is CQSCONN, both the MSGQ and EMHQ structures
The function request that failed: are in error, and a nonzero completion code is issued.
CQSDISC failing_function
Request to terminate IMS connections The function request that failed:
to one or more coupling facility IMODULE GETMAIN
structures failed. Request to obtain a work area failed.
CQSDEREG IMODULE LOAD
Request to unregister IMS from CQS Request to load a module failed.
failed. CQSREG
xxxxxxxx Request to register IMS to CQS failed.
The return code from the failing function. CQSCONN
yyyyyyyy Request to connect IMS to one or
The reason code from the failing function. more coupling facility structures
cccc MSGQ or EMHQ failed.
zzzzzzzz CQS MSGQ STR ATR
The completion code from the CQSCONN The WAITRBLD value for the MSGQ
request. structure is not correct.
System action: IMS processing continues. CQS EMHQ STR ATR
The WAITRBLD value for the EMHQ
System programmer response: The return code and structure is not correct.
reason code are provided for IBM support JOIN XCF GROUP
representatives only. Report the problem to IBM The MAXGROUP value specified for
Software Support. the XCF couple data set is too small.
xxxxxxxx zzzzzzzz
The return code from the failing function. The completion code from the CQSCONN
v For a description of IMODULE GETMAIN request.
or IMODULE LOAD return codes, see the
System action: IMS initialization terminates with
IMS system services return code
abend code 0071.
information.
v For a description of CQSREG and System programmer response: If the WAITRBLD
CQSCONN return codes, see CQSREG value for the MSGQ or EMHQ structure is incorrect,
request (System Programming APIs) and determine which address spaces are connected to the
CQSCONN request (System Programming structure through CQS. Disconnect all non-IMS control
APIs). region clients. Restart IMS so an IMS control region
v For a description of CQS MSGQ STR ATR makes the initial connection to a structure in the
or CQS EMHQ STR ATR return codes, see sysplex. Then reconnect the non-IMS clients.
reason code yyyyyyyy. Reason and return
codes for these functions are the same. Return and reason codes from all other functions are
yyyyyyyy provided for IBM support representatives only. Contact
The reason code from the failing function: IBM Software Support for assistance.
v When the failing function is IMODULE Module: DFSSQ020
GETMAIN, the reason code is one of the
Related reference:
following:
X'00001002' CQSREG request (System Programming APIs)
DFSSQM allocation failed.
X'00001004' CQSCONN request (System Programming APIs)
SQ1 AWE allocation failed.
X'00001005' IMS system services return codes (Messages and
SQ2 AWE allocation failed. Codes)
v When the failing function is IMODULE Related information:
LOAD, the reason code is:
X'00001006' IMS abend 0071
DFSSQ010 load failed.
v When the failing function is CQSREG, the DFS1938 INVALID MODE TABLE NAME LINK x
reason code is from the CQSREG macro.
v When the failing function is CQSCONN, the Explanation: A VTAM session initiation attempt failed
reason code is from the CQSCONN macro. because VTAM did not recognize the mode table name
v When the failing function is CQS MSGQ used for LINK x.
STR ATR, the reason code is: System action: The attempt to establish an MSC
X'00000106' VTAM session failed for LINK x.
The WAITRBLD value for the
MSGQ structure is incorrect. When Operator response: Specify the correct mode table
this error occurs, you might need name supplied by the system programmer, and try to
to force the structure and rebuild initiate the session for LINK x.
before IMS can be brought up. Programmer response: Specify the correct mode table
v When the failing function is CQS EMHQ name for LINK x.
STR ATR, the reason code is:
X'00000107' Problem determination: 1, 5, 6, 12, 14, 25
The WAITRBLD value for the Related information:
EMHQ structure is incorrect. When
Chapter 2, “IMS problem determination,” on page 5
this error occurs, you might need
to force the structure and rebuild
before IMS can be brought up. DFS1939W hh:mm:ssxxxxxxxxxxx INTEREST ERROR,
v When the failing function is JOIN XCF yyyyyyyyzzzzzzzzwwwwwww
GROUP, the reason code is:
Explanation: IMS attempted to register or unregister
X'00000000'
interest in one or more shared queues for one or more
The MAXGROUP value specified
resources. Either IMS experienced an internal error, or
for the XCF couple data set is too
CQS rejected the request.
small. When this error occurs, you
might need to increase the value The message variables have the following meanings:
specified on the MAXGROUP hh:mm:ss
keyword. Time stamp
cccc MSGQ or EMHQ xxxxxxxx
REGISTER or DEREGISTER
QERROR. Use the /START command to start the destination. The maximum output message segment to
destination. an LU6.2 device is 32767.
If error occurred while processing a /MSVERIFY System action: The output message is discarded.
command, reissue the MSVERIFY command.
Programmer response: Change the named transaction
If this message is a result of a /DEQUEUE command, to insert message segments with a length no greater
reenter the /DEQUEUE command when CQS or the than 32767. Change the TRANSACT macro SEGSIZE
structure is again available. parameter to 32767.
If the stopped terminal is the system console, issuing a
subsequent IMS command will reset the stopped status. DFS1945 DATA COMMUNICATIONS
QMGR/CQS WRITE ERROR LINK xx
Programmer response: You can isolate the error by
using the DFSERA10 program to print the 6701 records. Explanation: An error occurred during the data
When the problem is corrected, reestablish the session communication QMGR or CQS WRITE (PUT/ISRT)
or signon by Node x, an IMS /OPNDST command, or process.
responding to the DFS3649A signon message, as
System action: For messages being received on an
appropriate.
MSC link, the message is canceled, a 6701 ID = MSSx
Problem determination: 1, 5, 6, 12, 14, 15, 36 (x = 1, 2, 3) record is written to the log, and the partner
IMS system is notified. The partner system issues
Module: DFSICIO0, DFSICLJ0
message DFS2140 DESTINATION name STOPPED,
Related information: REASON CODE 1945, where name is the MSNAME of
“DFS3649A” on page 728 the MSC send path. The message is returned to the
Chapter 2, “IMS problem determination,” on page 5 message queue of the sending IMS system.
If a /MSVERIFY command was being processed, the
DFS1943 CQS OUTPUT QUEUE information being inserted to the queue is discarded,
REGISTRATION ERROR and a 6701-AER1 record is written to the log data set.
Explanation: An error occurred during a logon or If a message was being routed by the message control
signon CQS INFORM call to register interest on one or error exit DFSCMUX0, the rerouted message is
more output message queues (LTERMs) associated with canceled, and a 6701 ID = AER1 record is written to
the terminal logon or user signon. the log data set.
System action: For system-defined terminals, Operator response: When you have corrected the
communication (for example, a VTAM session) is problem, use the /START command to start the
terminated. For ETO terminals, the user is signed off. destination (for example, MSNAME or REMOTE
An X'67D0' log record containing pertinent information TRANSACTION). If the error occurred while processing a
about the error is produced. /MSVERIFY command, reissue the command.
Operator response: Reestablish the session or signon Programmer response: You can isolate the error by
as explained in the Programmer response. using the DFSERA10 program to print the 6701 records.
Programmer response: When the problem is corrected, Problem determination: Contact the system
reestablish the session or signon by Node x, an IMS programmer if the error persists.
/OPNDST command, or responding to the DFS3649A If the error was encountered by an MSC link, the
signon message, as appropriate. following CLBTEMP fields are set in the LLB block in
Problem determination: 1, 5, 6,12, 14, 15, 36 the 6701 MSS1 record:
v CLBTEMP2 = R15 return code +8 from the QMGR
Module: DFSCMS00 Put-move call
Related information: v CLBTEMP3 = Message key = x'00000799' = decimal
1945
“DFS3649A” on page 728
v CLBTEMP4 = Module ID, that is C'CMS0' =
Chapter 2, “IMS problem determination,” on page 5 DFSCMS00
Module: DFSCMS00, DFSCMLA0, DFSCMLB0,
DFS1944E APPC OUTPUT SEGMENT SIZE DFSCM4L0, DFSCMSY0, DFSCMEI0
EXCEEDED, MESSAGE DISCARDED
Related information:
FOR LU=nnnnnnnn, TPN=name,
SIDE=name, TRANCODE=xxxxxxxx Chapter 2, “IMS problem determination,” on page 5
IMS must retain these messages with this IMS until it DFS1950 DESTINATION HAS NO OUTPUT
restarts. These messages is only accessible from this QUEUED
IMS system.
Explanation: The /ALLOCATE command was
entered, but the LU 6.2 destination has no output to be
If IMS is cold started, IMS will move the locked
sent.
messages to the cold queue.
System action: The entered command is ignored.
System action: IMS processing continues.
Programmer response: No action is required.
The following list contains the various formats for LU INVALID CONVERSATION TYPE
6.2 descriptors: INVALID SYNC LEVEL
v DFS1956E SYNTAX ERR ON PREVOUS CARD IN MISSING OR INVALID VALUE AFTER KEYWORD
CHAIN, SKIP THIS LTERM AND OTHER KEYWORDS ARE
v DFS1956E SYNTAX ERROR ON CARD card number MUTUALLY EXCLUSIVE
v DFS1956E SYNTAX ERROR FOR DESCRIPTOR = THE PARAMETER LENGTH IS TOO LONG
lterm name DUPLICATE OUTBND KEYWORD NO MESSAGE TEXT AFTER ')'
NO USERID OR USER IS NOT SIGNED ON
The following are added to the prefix: DESTINATION NOT FOUND
v CAN NOT CONTINUE IF COL(71) IS BLANK
System action: The system continues processing.
v FIRST COLUMN MUST BE EITHER "U" OR "*"
v SECOND COLUMN MUST BE BLANK Programmer response: Correct the errors and retry
v LTERM NAME NOT GIVEN DFSAPPC.
v LTERM NAME LONGER THAN 8 CHAR
v INVALID LTERM NAME
DFS1958I IMS CONNECTION TO APPC/MVS
v DIFFERENT LTERM NAME ON CONTINUED
COMPLETE, LUNAME= nnnnnnnn.
CARD
v THE CONTINUED DATA MUST BEGIN IN Explanation: The connection between APPC/MVS and
COLUMN 12 IMS was established. APPC/MVS opened the local
v ILLEGAL KEYWORD ACB of IMS. APPC/MVS LU 6.2 services are available
v SIDE MUST BE 1 TO 8 CHARACTER LONG to IMS. If the LU name is network-qualified, it can be
v INVALID CHARACTER IN SIDENAME up to 17 bytes long.
v DUPLICATE SIDE KEYWORD
v LUNAME MUST BE 1 TO 17 CHARACTERS LONG System action: IMS receives messages from LU 6.2
v LUNAME MUST BEGIN WITH A-Z OR @,$,# devices and sends messages to LU 6.2 devices using
v DUPLICATE LUNAME KEYWORD APPC/MVS services.
v INVALID CHARACTER IN LUNAME
v TPNAME MUST BE 1 TO 64 CHARACTER LONG DFS1959E SEVERE IMS INTERNAL FAILURE,
v DUPLICATE TPNAME KEYWORD REASON CODE= xxyy
v INVALID CHARACTER IN TPNAME
v MODE MUST BE 1 TO 8 CHARACTER LONG Explanation: This message identifies an IMS internal
v MODE MUST BEGIN WITH A-Z OR @,$,# error.
v INVALID CHARACTER IN MODE System action: The system continues processing.
v DUPLICATE MODE KEYWORD
v SYNCLEVEL MUST BE 1 CHARACTER LONG Programmer response: Contact IBM Software Support
v INVALID SYNCLEVEL VALUE and report the reason code xxyy provided by the
v DUPLICATE SYNCLEVEL KEYWORD message and the LUMI trace output. Also see the IMS
v CONVTYPE MUST BE 1 CHARACTER LONG diagnostic information for more information about this
v INVALID CONVTYPE VALUE message and other APPC/IMS diagnostic aids.
v DUPLICATE CONVTYPE KEYWORD Related reference:
v DESCRIPTOR ENTRY ALREADY EXISTS
DFS1959E message information (Diagnosis)
System action: This error message is sent to the
system console.
DFS1960I IMS HAS REQUESTED A
Programmer response: Correct the errors identified in CONNECTION WITH APPC/MVS
this message.
Explanation: IMS issued the APPC/MVS verb
ATBIDEN to connect to APPC/MVS.
DFS1957E DFSAPPC ERROR: description
System action: IMS continues processing without
Explanation: An input parameter error is found while APPC/MVS LU 6.2 service. The service is unavailable
processing the DFSAPPC message request. The until APPC/MVS drives the IMS XCF exit indicating
description field is replaced by the appropriate error that the IMS LOCAL LU 6.2 ACB was opened.
types. The following are possible error types:
MISSING '('
MISSING '=' AFTER KEYWORD DFS1961W IMS CONNECTION WITH APPC/MVS
INVALID OR DUPLICATE KEYWORD HAS FAILED
INVALID LTERM NAME Explanation: A failure occurred while trying to start
INVALID LU NAME or maintain an APPC/MVS connection.
INVALID MODE NAME
INVALID TP NAME System action: IMS continues processing without
INVALID SIDE NAME APPC enabled.
Programmer response: Determine the reason for messages from an LU 6.2 application program that
failure by analyzing all DFS1965E messages and VTAM is not on an IMS system that has MSC support for
or APPC/MVS messages on the system console that APPC.
might have preceded this message. Restart APPC using
02 The destination name specified by the requestor
the /START APPC command.
from LUNAME= is for a local LTERM. This type of
Related concepts: message switch function is not supported from an
LU 6.2 application program.
APPC/IMS diagnostic aids (Diagnosis)
Related information: 03 The destination name specified by the requestor
from LUNAME= is for an IMS Fast Path
“DFS1965E” on page 404
transaction or an IMS response mode transaction.
This type of transaction is not valid for queuing
DFS1962 COMMAND INVALID FROM AN LU messages from an LU 6.2 device with an
6.2 DEVICE asynchronous request (ALLOCATE, SEND_DATA,
DEALLOCATE).
Explanation: This command cannot be entered from
an LU 6.2 device. It is valid only from other IMS 04 The destination name specified by the requestor
terminal types. from LUNAME= can accept only single segments.
Because multiple segments were detected from the
System action: The IMS command is ignored.
requestor, the input is discarded (ALLOCATE,
Operator response: The IMS command entered has no SEND_DATA, SEND_DATA).
meaning for an LU 6.2 device. Determine the reason for
05 The destination name specified by the requestor
using this command. Another IMS command might
from LUNAME= is an IMS remote transaction
apply, or an APPC/MVS or VTAM command might
name that is not acceptable. The cause could be
exist for the wanted action.
that the destination IMS is not capable of accepting
an APPC transaction.
DFS1963W XRF PARAMETERS MISSING OR
06 If the first form of the message is issued, the
INVALID IN MVS APPCPM MEMBER
reroute destination name for Message
Explanation: This message is issued because the Control/Error exit specified from LUNAME= and
USERVAR or ALTLU parameters are missing or invalid DESTINATION NAME=, or from DESTINATION
in the APPCPM member. The APPCPM member is NAME=, is not accessible because the message
used by z/OS during startup of the APPC subsystem to originated in this system and there is no base LU
specify options. z/OS also passes USERVAR and the name in this system to receive an output message.
ALTLU name to IMS when requested.
If the second form of the message is issued, the
Programmer response: Check the APPCPM member reroute destination name for the Message
for validity of the USERVAR and ALTLU parameters. Control/Error exit specified on TMEMBER
NAME= and TPIPE NAME= is not accessible.
02 Use the DFSAPPC facility for message switch Problem determination: Check for any accompanying
support APPC/MVS and VTAM error messages. Check the
03 Use the synchronous process (ALLOCATE, SYS1.LOGREC data set for software failure records that
SEND_DATA, RECEIVE_AND_WAIT) might accompany this condition.
04 Because multiple segments were detected from Related concepts:
the requestor, the input is discarded
(ALLOCATE, SEND_DATA) APPC/IMS diagnostic aids (Diagnosis)
05 Verify that the destination IMS is at system Related reference:
product level of Version 5.1
07 Determine which IMS systems in the shared DFS1965E APPC/MVS call failures (Diagnosis)
queues group have the transaction defined
locally, and enter the transaction on one of APPC/MVS-Explanation of Return and Reason
these systems. Codes
System programmer response: For reason codes 1 and 4 Unable to issue message DFS1973I to report a
2, reissue the command when the event completes. parameter error.
5 Unable to issue message DFS1972I to report
For all other reason codes, call IBM Software Support
that the /CQSCHKPT command was
for assistance.
successful for some structures.
Module: DFSSQCP0 6 Unable to issue message DFS1974I to report
that the /CQSCHKPT command failed for a
structure.
DFS1975 COMMAND REJECTED AS CQS IS 7 Unable to issue message DFS1973I to report an
NOT AVAILABLE environmental error.
Explanation: The command was not processed System action: IMS processing continues.
because the CQS address space is unavailable.
System programmer response: Reissue the command.
System action: IMS processing continues.
Module: DFSSQCP0
System programmer response: Reissue the command
when CQS is available. Related information:
“DFS1972I” on page 405
Module: DFSICM30, DFSICQ20, DFSIDP40
“DFS1973I” on page 405
“DFS1974I” on page 405
DFS1976 KEYWORD INVALID - SHARED
QUEUES NOT ENABLED
DFS1979I CHECKPOINT REQUEST REJECTED,
Explanation: The command was not processed CQS IS NOT AVAILABLE
because the keyword is invalid in an IMS system
without Shared Queues. Explanation: The request was not processed because
the CQS address space is unavailable.
System action: IMS processing continues.
System action: IMS processing continues.
System programmer response: Reissue the command
in an IMS system in which Shared Queues is enabled. System programmer response: Reissue the command
when CQS is available.
Module: DFSIDPR0, DFSIDP00
Module: DFSRCP00
DFS1977 COMMAND REJECTED DUE TO CQS
ERROR DFS1980 TRANSACTION NOT STOPPED,
CANNOT PROCESS COMMAND
Explanation: The command was not processed
because IMS received an error return code from CQS. Explanation: The /DEQ command was rejected
because the transaction was not stopped.
System action: IMS processing continues.
System action: The command is not processed.
System programmer response: Reissue the command.
If you receive the same message again, contact IBM System programmer response: Issue the /STOP
Software Support. TRAN or UPDATE TRAN STOP(Q,SCHD) command;
then reenter the command.
Module: DFSICQ20, DFSIDP40
Module: DFSICLJ0
DFS1978I REQUEST FOR STORAGE FAILED
DURING CQCHKPT COMMAND DFS1981 COMMAND REJECTED DUE TO CQS
PROCESSING, REASON ERROR OR CQS UNAVAILABLE
CODE=reasoncode
Explanation: The command was not processed
Explanation: The /CQCHKPT SHAREDQ or because the Common Queue Server (CQS) address
/CQCHKPT SYSTEM command processing terminated space was unavailable, or because IMS received an
because IMS was unable to acquire HIOP storage to error return code from CQS.
process the command or to issue a message about the
System action: IMS processing continues.
outcome of the command. The reasons are:
1 Unable to issue message DFS1971I to report an System programmer response: Reissue the command
invalid structure. when CQS is available. If CQS is available and you
2 Unable to obtain the storage required to receive the same message again, contact IBM Software
process the /CQSCHKPT command. Support.
3 Unable to issue message DFS1972I to report
Module: DFSICLZ0
that the /CQSCHKPT command was
successful for all structures.
Reason Code = 90 Unable to perform INDEX/ILE Reason Code = D4 OPEN/CLOSE failure refer to
rebuild processing – DBRC not available preceding DFS0730I message
Explanation: DBRC is unavailable. Explanation: OPEN or CLOSE failure
INDEX/ILE rebuild requires that DBRC is occurred; refer to preceding DFS0730I message
active during rebuild processing. for the name of the data set.
System action: The job terminated with a System action: The job terminated with a
return code of 8. return code of 8.
Programmer response: Ensure that DBRC=Y is Programmer response: Correct the problem
specified in the EXEC card, then rerun the job. identified in DFS0730I and run the job again.
Reason Code = A0 Index/ILD rebuild request not Reason Code = E0 PSTBYTNM POINTS TO FREE
honored - database specified NOT a HIDAM SPACE - TWIN BACKWARD POINTER IS BROKEN
database
Explanation: During an index rebuild request,
Explanation: During an INDEX rebuild a twin backward pointer was encountered that
request, DDIR determined that the partition pointed into free space.
was not for a PHIDAM database.
System action: The job terminates.
System action: The job terminated with a
Programmer response: Take one of the
return code of 8.
following actions:
Programmer response: Change the DBD on v Run Batch Backout to correct the incomplete
the job parameter to a HALDB that is segments.
PHIDAM, then rerun the job. v Run Pointer Checker, correct the broken
pointers, and then run Index Build again.
Reason Code = B0 Index rebuild was requested for a
DBD that is not a HALDB DBD. REASON CODE = E1 PSTBYTNM POINTS TO FREE
SPACE - TWIN FORWARD POINTER IS BROKEN
Explanation: During an INDEX rebuild
request, DDIR determined that the partition Explanation: During an index rebuild request,
was not for a HALDB database. a twin forward pointer was encountered that
pointed into free space.
System action: The job terminated with a
return code of 8. System action: The job terminates.
Programmer response: Change the DBD on Programmer response: Take one of the
the job parameter to a HALDB DBD, then following actions:
rerun the job. v Run Batch Backout to correct the incomplete
segments.
Reason Code = C0 Index rebuild was requested using
v Run Pointer Checker, correct the broken
a PSB with a DBPCB that does not map to the Master
pointers, and then run Index Build again.
DBD specified on the JOB PARM card.
REASON CODE = E2 TWIN BACKWARD POINTER
Explanation: During an INDEX rebuild
DOES NOT POINT TO THE PREVIOUS ROOT
request, DDIR determined that the partition
SEGMENT
was not for a HALDB database.
Explanation: During an index rebuild request,
System action: The job terminated with a
a twin forward pointer was encountered while
return code of 8.
scanning the twin backward chain that did not
Programmer response: Change the DBD on point to the previously scanned root segment.
the job parameter to a HALDB DBD that is the
System action: The job terminates.
master database containing the partition input
on the SYSIN card, then rerun the job. Programmer response: Take one of the
following actions:
Reason Code = D0 OPEN/CLOSE failure - refer to
v Run Batch Backout to correct the incomplete
preceding DFS0730I message
segments.
Explanation: OPEN or CLOSE failure v Run Pointer Checker, correct the broken
occurred; refer to preceding DFS0730I message pointers, and then run Index Build again.
for the name of the data set.
REASON CODE = E3 TWIN FORWARD POINTER
System action: The job terminated with a DOES NOT POINT TO THE PREVIOUS ROOT
return code of 8. SEGMENT
Programmer response: Correct the problem Explanation: During an index rebuild request,
identified in DFS0730I and run the job again. a twin forward pointer that did not point to
the previously scanned root segment was REASON CODE = F1 FREEMAIN ERROR
encountered while scanning the twin forward ENCOUNTERED LOADING ILDS WITH
chain. DDNAME=ddname. FREEMAIN RC= nnnnnnnn
REASON= yyyyyyyy
System action: The job terminates.
Explanation: Module DFSURIT0 encountered
Programmer response: Take one of the
an error freeing previously allocated storage
following actions:
while rebuilding the ILDS identified in the
v Run Batch Backout to correct the incomplete
message text. The error occurred while the
segments.
HALDB Index/ILDS Rebuild utility
v Run Pointer Checker, correct the broken
(DFSPREC0) was loading the ILDS by using
pointers, and then run Index Build again.
the free space option.
Reason Code = E4 DL/I GN processing returned an
In the message text:
unexpected status code &statcode
ddname
Explanation: DL/I returned a status code The ILDS that encountered the error.
indicating an error. Usually other system nnnnnnnn
messages appear in the job output. You can The return code in register 15 when the
check the status code in the DL/I status code error occurred. If an abend occurred, this
information. is the abend code.
yyyyyyyy
System action: The job step is terminated. The reason code. If an abend occurred, the
Programmer response: Correct the conditions reason code is blank.
indicated by the status code and any other
related messages. System action: Processing terminates with
return code 8. DBRC flags the ILDS as
REASON CODE = F0 GETMAIN ERROR Recovery Needed in the RECON data set.
ENCOUNTERED 1LOADING ILDS WITH
DDNAME=ddname. GETMAIN RC=nnnnnnnn
Programmer response: Correct the problem
REASON= yyyyyyyy
indicated or change the SYSIN statement to
Explanation: Module DFSURIT0 encountered omit the free space option by removing the
an error allocating storage while rebuilding the suffix letter F from either the BOTHF parameter
ILDS identified in the message text. The error or the ILEF parameter, and run the DFSPREC0
occurred while the HALDB Index/ILDS utility again.
Rebuild utility 1 (DFSPREC0) was loading the
ILDS by using the free space option. Module: DFSPREC0
In the message text: REASON CODE = F2 VSAM ERROR
ddname ENCOUNTERED LOADING ILDS WITH
The ILDS that encountered the error. DDNAME=ddname. VSAM RC= nnnnnnnn REASON=
nnnnnnnn yyyyyyyy
The return code in register 15 when the
Explanation: Module DFSURIT0 encountered a
error occurred. If an abend occurred, this
VSAM error while rebuilding the ILDS
is the abend code.
identified in the message text. The error
yyyyyyyy
occurred while the HALDB Index/ILDS
The reason code. If an abend occurred, the
Rebuild utility (DFSPREC0) was loading the
reason code is blank.
ILDS by using the free space option.
System action: Processing terminates with In the message text:
return code 8. DBRC flags the ILDS as ddname
Recovery Needed in the RECON data set. The ILDS being loaded when the error
occurred.
Programmer response: Correct the problem nnnnnnnn
indicated or change the SYSIN statement to The return code in register 15 when the
omit the free space option by removing the error occurred. If an abend occurred, this
suffix letter F from either the BOTHF parameter is the abend code.
or the ILEF parameter, and run the DFSPREC0 yyyyyyyy
utility again. The reason code. If an abend occurred, the
reason code is blank.
Module: DFSPREC0
DFS1986 KEYRANGE TOO LONG, User response: Check the system messages in
TRUNCATING the job log to determine the cause of the error
and correct it.
Explanation: This message is displayed when you
input one or more KEYRANGE values that are longer Module: DFSUPNT0, DFS3UACB.
than the key values in the database.
REASON = 04 A GETMAIN ERROR OCCURRED
System action: The DFSMAID0 utility truncates the Explanation: The utility encountered an error
KEYRANGE to the appropriate size. Processing while obtaining storage.
continues.
System action: Processing halts and return
User response: No action is required. code is set to 16.
Module: DFSMAID0 User response: Increase the region size for the
job or decrease the number of SYSIN
statements.
DFS1987I REASON CODE = rc message_text
Module: DFSUPNT0, DFS3UACB.
Explanation: An error occurred running one of the
following utilities: REASON = 05 ERROR LOADING MODULE
v HALDB Partition Data Set Initialization utility &modulename
(DFSUPNT0) Explanation: The utility encountered an error
while loading the module &modulename.
For an explanation of the error and possible solutions System action: Processing halts and return
to the error, find the return code of the error message code is set to 12.
in the following list.
User response: Place the specified module in
REASON = 01 SYSPRINT DD STATEMENT the LOADLIB concatenation for this job step.
REQUIRED FOR STAND ALONE EXECUTION
Explanation: The IMS program controller Module: DFSUPNT0, DFS3UACB.
module DFSRRC00 did not start the utility REASON = 06 DBRC INITIALIZATION FAILED FOR
because the utility JCL does not include a PHASE 1
SYSPRINT DD statement. A SYSPRINT data Explanation: The utility encountered an error
set is required. during phase 1 initialization of DBRC.
System action: Processing halts and return System action: Processing halts and return
code is set to 8. code is set to 8.
User response: Examine the job log for System action: Processing halts and return
additional messages to determine and correct code is set to 8.
the cause of the error.
User response: Examine the job log for
Module: DFSUPNT0, DFS3UACB. additional information about the error and
correct it. If the problem cannot be
REASON = 07 DBRC INITIALIZATION FAILED FOR
determined, contact IBM Software Support.
PHASE 2
Explanation: DFSUPNT0 encountered an error Module: DFSUPNT0, DFSUPNT1, DFSUPNT2.
during phase 2 initialization of DBRC.
REASON = 12 ESTAE HAS DETECTED AN ABEND
System action: Processing halts and return RESULTING FROM ATTACH OF DFSRRC00
code is set to the internal DBRC error code. Explanation: The ESTAE routine was driven
for the utility due to an abend of the attached
User response: Contact IBM Software Support.
IMS system.
Module: DFSUPNT0.
System action: Processing halts and return
REASON = 08 AN ERROR OCCURRED OPENING code is set to 32.
THE DFSOVRDS DATASET
User response: Examine the job log for
Explanation: DFSUPNT0 encountered an error
additional information about the error and
opening the data set specified by the
correct it. If the problem cannot be
DFSOVRDS DD statement.
determined, contact IBM Software Support.
System action: Processing halts and return
Module: DFSUPNT0, DFS3UACB.
code is set to 8.
REASON = 13 A SYSIN DD CARD IS REQUIRED
User response: Examine the job log for
TO EXECUTE DFSUPNT0 STAND ALONE
additional information about the error and
Explanation: DFSUPNT0 was not started by
correct it.
the IMS program controller module
Module: DFSUPNT0. DFSRRC00. A SYSIN data set is required, but
no SYSIN DD statement was found in the JCL.
REASON = 09 AN ERROR OCCURRED OPENING
THE DFSRESLB DATASET System action: Processing halts and return
Explanation: DFSUPNT0 encountered an error code is set to 8.
opening the data set specified by the
User response: Check and correct the error
DFSRESLB DD statement.
condition indicated by the message and reason
System action: Processing halts and return code.
code is set to 8.
Module: DFSUPNT0.
User response: Examine the job log for
REASON = 14 SYSIN DD DUMMY NOT ALLOWED
additional information about the error and
FOR STAND ALONE EXECUTION
correct it.
Explanation: DFSUPNT0 was not started by
Module: DFSUPNT0. the IMS program controller module
DFSRRC00. A SYSIN data set is required, but a
REASON = 10 IMS INTERNAL ERROR - DYNAMIC SYSIN DD DUMMY statement was found in
PSB IS CORRUPTED the JCL.
Explanation: DFSUPNT1 or DFSUPNT2
encountered and invalid PCB control block in System action: Processing halts and return
the parameter list passed by IMS. The error is code is set to 8.
returned to DFSUPNT0.
User response: Check and correct the error
System action: Processing halts and return condition indicated by the message and reason
code is set to 16. code.
| User response: Examine the job log for Explanation: An OTMA message flood condition
| additional information about the error and exists for member yyyyyyyy. The input messages have
| correct it. reached a default or client specified Transaction
Instance Block (TIB) limit, indicated by zzzz.
| Module: DFSUPNT0.
System action: IMS OTMA rejects any new input
REASON = nn UNEXPECTED ERROR - messages from the member until free TIBs are
INITIALIZATION INTERNAL LOGIC ERROR available.
Explanation: The utility encountered an
unexpected logic error. Programmer response: Determine the following:
v Whether the input transactions are processed by
System action: Processing halts and return dependent regions
code is set to 99. The reason code has meaning v Whether the remote transactions insert back to the
only to IMS support personnel. I/O PCB
User response: Contact IBM Software Support. v Whether the OTMA clients are flooding the IMS
Module: DFSUPNT0, DFS3UACB. You might need to control or stop the OTMA clients to
prevent the flood conditions. Ensure that the IMS
Module: DFS3UACB, DFSUPNT0, DFSUPNT1, regions are started to run the OTMA transactions. You
DFSUPNT2 might need to contact the IMS system programmer for
assistance. Also, you can use the /DISPLAY TMEMBER
TPIPE command to display the input message counts.
Module: DFSYFD00
System action: IMS issues a VTAM CLOSE ACB, Problem determination: 6, 10, 35
making VTAM communication impossible. Related reference:
Operator response: If the wrong component of
IMODULE return codes (Messages and Codes)
ACF/VTAM is active, first terminate ACF/VTAM and
then initialize the correct component. After the correct Related information:
component of ACF/VTAM is active, issue the /START
IMS abend 0016
DC command.
Chapter 2, “IMS problem determination,” on page 5
Programmer response: Either redefine IMS to execute
with the ACF/VTAM component you are using, or
install an ACF/VTAM component that matches the IMS DFS2000I OPNDST ACQUIRE FAILED NODE x.
level. SUBPOOL zzzzzzzz SENSE=yyyy
Explanation: IMS attempted to issue a VTAM CLSDST System action: IMS idles the terminal.
for NODE x, but was unsuccessful. The node is Operator response: (master terminal) Another
deactivated, and is no longer usable. /OPNDST, VTAM VARY NET, or LOGON command can be
System action: Node x is deactivated, and is no longer attempted.
usable. Problem determination: Turn on IMS trace, and
Problem determination: Determine why the CLSDST reproduce the problem.
failed. If necessary, perform VTAM problem
determination. DFS2008 INPUT IGNORED-ERROR MESSAGE
CANCELED
DFS2004 PERMANENT ERROR-CLSDST Explanation: This is caused by an operator error.
REQUIRED NODE x. Terminal input was attempted while IMS was trying to
send an error message for the immediately-previous included during IMS system definition, perform a /DIS
input operation. NODE ALL, save the output.
For a bisync 3270 VTAM device, the operator might Related information:
have entered input whose length was greater than the Chapter 2, “IMS problem determination,” on page 5
length defined for that terminal.
System action: The input is ignored. The terminal is DFS2011I IRLM FAILURE - IMS QUIESCING
available for further use.
Explanation: The lock manager status exit is given
Operator response: Do not enter data without waiting control and detects that the IRLM is terminating. This
for a response to the previous entry. event causes the discontinuation of the use of all
databases.
Problem determination: Turn on IMS trace for the
node, and reproduce the problem. System action: IMS pseudoabends all currently
scheduled transactions with abend 3303. Full-function
If the entered data was too long, verify that the
databases participating in data sharing (share level 1, 2,
RECEIVE ANY buffer size specified on the COMM
or 3) and Fast Path databases participating in block
macro is large enough to handle the length of data
level data sharing (share level 1, 2, or 3) are closed.
being entered.
Their authorization is discontinued. All further
transaction scheduling, except Fast Path, is prohibited.
DFS2009 INPUT IGNORED All terminals inputting Fast Path transactions wait until
IRLM is restarted and IMS reconnects to it.
Explanation: This is caused by an operator error or
input that is not supported by IMS from a 3270 display. Every dependent region with an intent to use a
database must go through terminate thread processing.
For the case of invalid input, IMS has received trigger That is, any such dependent region that does not
field, input from the terminal when the MFS bypass is terminate prevents IMS from completing the actions
not being used. Trigger fields are not supported by necessary to clean up from the IRLM failure. IMS
MFS and trigger field input will be accepted by IMS cannot be reconnected to the IRLM or terminated until
only if the MFS bypass facility is being used on input all such region disconnect procedures have occurred.
received from the terminal. Wait for input (WFI) transactions are given a QC status
For a bisync 3270 VTAM device, the operator might code or pseudoabended with a U3303 on their next
have entered input whose length was greater than the database call. There are timing-related conditions at the
length defined for that terminal. time of the IRLM failure when the application
programs currently running can receive the BA, BB, or
System action: For an invalid trigger field, the input is FH status code.
discarded and communication with the terminal
continues normally. An error record is written on the Programmer response: Restart the IRLM and have the
IMS log data set at the time of the failure. system console operator modify IMS specifying
RECONNECT. The only other allowable response is to
Operator response: The screen should be reformatted issue /CHECKPOINT FREEZE to terminate IMS.
with a format that does not have trigger fields defined
or the transaction entered must be one that uses the When the IRLM has been restarted and IMS
MFS bypass facility of IMS. reconnected to it, start all databases stopped because of
this failure. Also, BMP regions might need to be
Problem determination: If reformatting the screen or restarted.
entering another transaction is not possible, contact
your system programmer for assistance. Problem determination: 1, 17
Related information:
If the entered data is too long, verify that the RECEIVE
ANY buffer size specified on the COMM macro is large Chapter 2, “IMS problem determination,” on page 5
enough to handle the length of data being entered.
DFS2012I GLOBALLY SHARED DATA
DFS2010 VTAM NOT SUPPORTED BASE|AREA - dbdname|areaname
STOPPED.
Explanation: The NODE keyword was entered in a
command, but VTAM is not included in the current or
system.
System action: The command is not processed. SHARING DATA BASE(S) STOPPED BECAUSE
DATA SHARING DISCONTINUED
Operator response: (terminal) Reenter the command
correctly. Explanation: One of the above two messages is
generated. The first message lists the sharing databases
Problem determination: 36; also, if VTAM nodes are that stopped because data sharing was discontinued.
Programmer response: You might want to reduce the System action: IMS continues execution.
queue usage and avoid a possible shutdown. To
Programmer response: The action to reduce the queue
determine the effect of this action, examine the
usage may cease.
percentage of use displayed by the /DIS POOL
command. When the number of records assigned to the
QBLKS data set drops below the lower threshold DFS2017 NUMBER OF RECORDS IN SMSGQ
established by IMS, message DFS2016 will be issued. DATA SET IS NOW BELOW LOWER
THRESHOLD
DFS2014 NUMBER OF RECORDS IN SMSGQ Explanation: IMS has established a lower threshold
DATA SET HAS EXCEEDED UPPER which the number of records assigned to SMSGQ data
THRESHOLD set must pass after the upper threshold has been
exceeded. Passing this lower threshold will result in
Explanation: IMS has established an upper threshold
this message being issued. This threshold is some
for the number of records that can be assigned to the
percentage of the maximum number of records
SMSGQ data set before issuing this warning message.
assignable before an automatic shutdown is initiated.
This threshold is some percentage of the maximum
number of records assignable before an automatic System action: IMS continues execution.
shutdown is initiated.
Programmer response: The action to reduce the queue
System action: IMS continues execution. usage may cease.
Programmer response: You might want to reduce the
queue usage and avoid a possible shutdown. To DFS2018 NUMBER OF RECORDS IN LMSGQ
determine the effect of this action, examine the DATA SET IS NOW BELOW LOWER
percentage of use displayed by the /DIS POOL THRESHOLD
command. When the number of records assigned to the
Explanation: IMS has established a lower threshold
SMSGQ data set drops below the lower threshold
which the number of records assigned to LMSGQ data
established by IMS, message DFS2017 is issued.
set must pass after the upper threshold has been
Related information: exceeded. Passing this lower threshold will result in
“DFS2017” this message being issued. This threshold is some
Either an IMSMON DD statement is missing, or LOAD Explanation: A parameter was entered for PARLIM
modules DFSIMNT0 or DFSMNTR0 are unavailable in keyword that was not 0 - 65535.
the proper library.
System action: The command is ignored.
System action: The command is ignored.
Remote terminal operator response: Correct the
Operator response: Reenter the command after the command, and reenter it.
monitor has been successfully initialized.
Programmer response: Ensure that the monitor is DFS2035 UNABLE TO ASSIGN SPECIFIED
successfully initialized. LTERM TO A PTERM DEFINED
MSGDEL=SYSINFO
Module: DFSICLN4
Explanation: LTERM has messages queued on the
system queue.
DFS2030 MONITOR ALREADY ACTIVE.
System action: The command is ignored.
Explanation: The /TRACE SET ON monitor command
was entered when the monitor was already activated. Terminal operator response: See that LTERM is
assignable to specified PTERM.
System action: The command is ignored.
Operator response: Use the /TRACE SET OFF DFS2036 UNABLE TO ASSIGN SPECIFIED
MONITOR command before repeating the /TRACE LTERM TO A PTERM DEFINED
SET ON MONITOR command. MSGDEL=NONIOPCB
Module: DFSICLN4 Explanation: LTERM has messages queued on the
system or application output queue.
DFS2031 INVALID MONITOR KEYWORD System action: The command is ignored.
PARAMETER.
Operator response: See that LTERM is assignable to
Explanation: The /TRACE SET ON MONITOR specified PTERM.
command was entered with an invalid parameter for
the monitor keyword.
System action: The command is ignored.
Operator response: Reenter the command using valid
parameters.
DFS2037 START DC HAS NOT BEEN DFS2040 DEVICE DEPENDENT LOGIC ERROR
COMPLETED NODE x (USER y)
Explanation: A /START DC command must be Explanation: A logic error was encountered during
completed before /OPNDST or /CLSDST can be done. device-dependent processing of a VTAM I/O request.
The probable causes of this problem are:
System action: The command is ignored.
v A VTAM error occurred.
Operator response: Enter the /START DC command; v A hardware malfunction occurred.
then retry. v A program logic error in the program at NODE x
occurred (programmable devices only).
v An invalid specification to the IMS System
DFS2038 BUFFER POOL TOO SMALL FOR Definition.
COMMAND v Unexpected VTAM system sense from the device.
v Time expired on CLEAR request during RQR
or processing.
INSUFFICIENT STORAGE AVAILABLE TO System action: The session established with NODE x
PROCESS COMMAND or USER y is terminated. An IMS Log Record (X'67')
containing pertinent information was produced with an
Explanation: The first form of the message is issued ID of CVCT.
when a command was not processed because of
insufficient storage. Programmer response: When the problem is corrected
the session can be reestablished by NODE x, USER y,
The first form of this message can also be produced if or an IMS /OPNDST command.
there is insufficient CSA/ECSA available to hold the
internal tables associated with the/TRACE SET ON Problem determination: 1, 5, 6, 12, 14
MONITOR command. Related information:
System action: The command is ignored. Chapter 2, “IMS problem determination,” on page 5
Related information:
DFS2051 RESYNCH FAILED DUE TO VTAM RC
NODE x (USER y). Chapter 2, “IMS problem determination,” on page 5
/OPNDST command for NODE x or USER y. The required. Session initiation can be attempted using an
session can also be requested or initiated by NODE x IMS /OPNDST command for NODE x or USER y. The
or USER y. session can also be requested or initiated by NODE x
or USER y.
Problem determination: 1, 5, 6, 12, 14, 25
Related information: Problem determination: 1, 5, 6, 12, 14, 25
Chapter 2, “IMS problem determination,” on page 5 Related information:
Chapter 2, “IMS problem determination,” on page 5
DFS2066I BAD BIND PARM (DISP A, VALUE B)
NODE x (USER y). DFS2068 INPUT DATA FM HDR PARAMETER
INVALID, UNSUPPORTED, OR NOT
Explanation: IMS detected one or more invalid,
AVAILABLE
unsupported, or conflicting parameters when receiving
a VTAM/SNA BIND command or when validating Explanation: An input data function management
Bind parameters from LOGMODE table or USERDATA (FM) header contained an invalid, unsupported, or
(after an INQUIRE). The parameters also might be in unavailable parameter. The output ERP FM header sent
conflict with the IMS system definition options with this message might contain additional sense
specified for NODE x or ETO descriptor options information to isolate the specific parameter.
specified for USER y.
System action: The session with NODE x has
DISP A is the displacement from the beginning of the encountered an input error, but the session was not
BIND RU. VALUE B is the erroneous data. Both DISP A terminated. This message is sent to reject the input
and VALUE B are in hexadecimal. message. An IMS trace log record (X'67'), containing
pertinent information, was produced with an ID of
System action: The attempt to establish a session with
CVCT.
NODE x or USER y using a VTAM/SNA BIND
command has been rejected. An IMS trace log record Operator response: See Programmer response.
(X'67'), containing pertinent information, was produced
Programmer response: Continue with input/output
with an ID of CVCT.
operations as appropriate. When the problem with the
Operator response: See Programmer response. FM header is corrected, the input message can be
resent.
Programmer response: When the problem is corrected,
session initiation can be attempted again using an IMS Problem determination: 1, 5, 6, 12, 14, 25
/OPNDST command for NODE x or USER y. The Related information:
session can also be requested or initiated by NODE x
Chapter 2, “IMS problem determination,” on page 5
or USER y.
Problem determination: 1, 5, 6, 12, 14, 25
DFS2069 END-BRACKET NOT SUPPORTED ON
Related information: IMS INPUT SYNCHRONOUS
Chapter 2, “IMS problem determination,” on page 5 MESSAGES.
Explanation: An end-bracket was received on an input
DFS2067I BEGIN-END BRACKET ERROR NODE IMS response mode or conversational transaction, an
x (USER y). IMS command, or an input message while in IMS "test
mode".
Explanation: IMS detected an error while processing
an output message. The message to be sent indicates System action: A session with NODE x has
begin bracket, but the node is in a "NOBB" (cannot encountered an input error, but the session was not
begin an output bracket) shutdown state. The requested terminated. This message is sent to reject the input
message could not be sent. message. An IMS trace log record (X'67'), which
contains pertinent information, was produced.
The "NOBB" shutdown state is the result of OHS
requesting a symmetric shutdown or a /QUIESCE Operator response: See Programmer response.
NODE x (USER y) command.
Programmer response: Continue with input/output
System action: Session termination was forced for operations as appropriate. The message can also be
NODE x or USER y. An IMS trace log record (X'67'), presented to IMS without end-bracket, test mode can
containing pertinent information, was produced with be terminated by an IMS /EXIT command, or the input
an ID of CVCT. transaction code can be redefined by a change to the
IMS system definition.
Operator response: See Programmer response.
Problem determination: 1, 5, 6, 12, 14, 25
Programmer response: The session can be restarted to
reset the shutdown state if additional input or output is Related information:
Chapter 2, “IMS problem determination,” on page 5 LU6 session identified by the user name. The text
following the FM header describes the asynchronous
condition detected by the "OTHER" system.
DFS2070 MESSAGE TERMINATION FORCED
FOLLOWING INPUT SNA CANCEL OF System action: Normal input and output continues
MFS PAGE. during the LU6 session.
Explanation: A VTAM/SNA CANCEL command was Operator response: Same as the Programmer
received without receiving a SUBSEQUENT response.
VTAM/SNA LUSTATUS (message termination)
Programmer response: Take appropriate action as
following a sender detected error during an MFS
required by the message text.
multiple page input message. IMS requires the input
message to be terminated if any single page is canceled. Problem determination: 1, 5, 6, 12, 14 25
System action: A session with NODE x has Related information:
encountered an input error, but the session has not Chapter 2, “IMS problem determination,” on page 5
been terminated. This message is sent to force
termination of the MFS multiple page input message.
An IMS trace log record (X'67'), containing pertinent DFS2073I LUname username (LTERM) SOURCE
information, was produced with an ID of CVCT. (LTERM) FMH7 --- text ---.
Operator response: See Programmer response. Explanation: An error message from the "OTHER"
system (LUname) was received by IMS in response to
Programmer response: Continue with input/output output sent on an LU6 session identified by the user
operations as appropriate. The message can be resent to name. The output queue containing the message in
IMS after the problem that caused the VTAM/SNA error is identified by the user name LTERM name. The
CANCEL command is corrected. originating input message source is identified by the
source LTERM name. The text following the TYPE 7
Problem determination: 1, 5, 6, 12, 14, 25
FM header describes the error condition.
Related information:
System action: This message is used to report error
Chapter 2, “IMS problem determination,” on page 5
conditions for the IMS master terminal operator or
message source terminal operator (message switch to
DFS2071I EXPECTED ERP MESSAGE NOT LU6 session only).
RECEIVED NODE x (USER y).
The LU6 session is terminated after reporting the error
Explanation: A VTAM/SNA exception response was to the IMS master terminal operator. The output
received without a subsequent ERP message explaining message in error is returned to the queue for later
the reason for the exception response. retransmission.
System action: A session with NODE x or USER y has The output message in error is dequeued, and the
encountered an input error, and the session is session is not terminated when reporting the error
terminated. An IMS trace log record (X'67'), containing condition to a source terminal operator (LU6 message
pertinent information, was produced with an ID of switch).
CVCT.
Operator response: Same as Programmer response.
Operator response: See Programmer response.
Programmer response: Take appropriate action as
Programmer response: After correcting the system required by the message text. The session can be
logic in any other session, initiation can be attempted restarted after correcting the error condition by the
using an IMS /OPNDST command for NODE x or "OTHER" system or by an IMS /OPNDST command.
USER y. The session can also be requested or initiated
Problem determination: 1, 5, 6, 12, 14, 25
by NODE x or USER y.
Related information:
Problem determination: 1, 5, 6, 12, 14, 25
Chapter 2, “IMS problem determination,” on page 5
Related information:
Chapter 2, “IMS problem determination,” on page 5
DFS2074I SESSION ENDED; PURGE DURING
QUIESCE NODE x (USER y).
DFS2072I LUname username (LTERM) FMH6|7 ---
Explanation: A deadlock condition has occurred as a
text ---.
result of a /CHE PURGE QUIESCE command. Quiesce
Explanation: A system informational or error message, logic cannot complete because of purging for the
defined by the SNA FMH6 or FMH7 format, detected named node or user.
an asynchronous condition by the 'OTHER' system
System action: The node or user is closed (session
(LUname), which was received by IMS through the
terminated) as in an error situation.
Operator response: Display shut down status to be Operator response: See the Programmer response.
sure that session has terminated.
Programmer response: Redefine the buffer size and
regenerate the IMS system—or make sure the data
DFS2075 INVALID QNAME IN QMODEL FMH. generated for output is not longer than the defined
buffer.
Explanation: The QNAME field in the QMODEL FMH
(TYPE 6) received by IMS contains a name that did not Problem determination: 1, 5, 6, 12, 14, 25
match the DQN of the ATTACH FMH for the process, Related information:
or did not match any valid QNAME for available
Chapter 2, “IMS problem determination,” on page 5
output.
System action: A session has encountered an input
DFS2078I OUTPUT REJECTED SENSE xxxxxxxx
QMODEL FMH error, but the session was not
LTERM yyyyyyyy. OUTPUT REJECTED
terminated. This message is sent to notify the sending
SENSE xxxxxxxx LTERM yyyyyyyy Node
half-session.
zzzzzzzz
Operator response: Same as Programmer response.
Explanation: A response was received indicating an
Programmer response: Try to continue with I/O invalid character in the message being sent to the
operations as appropriate. The FMH can be resent PTERM, or the terminal is not configured to properly
when the problem with QNAME has been corrected or accept the message; for example, an address outside the
the FMH can be resent with QNAME not specified. range of the device buffer was contained in the data
stream. The sense information received from the device
Problem determination: 1, 5, 6, 12, 14, 25
is contained in the sense field of the message. For
Related information: devices that contain programmed symbols, output is
Chapter 2, “IMS problem determination,” on page 5 rejected if the programmed symbols buffer is not
properly loaded.
DFS2076 INVALID QORG PARAMETER IN System action: A record is written on the IMS log
QMODEL FMH. data set that contains the message. The message is put
back on the IMS message queues. Communications
Explanation: The QORG field in the QMODEL FMH with the PTERM continue, unless the message was
(TYPE 6) received by IMS contained a QORG value that being sent in response mode. Then the terminal is
was greater than X'02', or did not match the QORG in disconnected and this message is sent to the MTO.
the QXFR FMH sent by IMS, or was invalid for the
type of QMODEL FMH received. Operator response: (master terminal) This message is
followed by a DFS998I message. Take the terminal out
System action: A session has encountered an input of response mode (/STOP), then /START) and then
QMODEL FMH error, but the session was not restarted (/OPN).
terminated. This message is sent to notify the sending
half-session. (terminal) The message must be dequeued from the
IMS message queues or the LTERM reassigned to a
Operator response: See the Programmer response. terminal capable of accepting the output. For devices
Programmer response: Try to continue with I/O that contain program symbols, a possible corrective
operations as appropriate. The FMH can be resent action would be to properly load the program symbol
when the problem with QORG has been corrected or buffer at the device, then resend the message.
the QORG can be set to X'00'. Related information:
Problem determination: 1, 5, 6, 12, 14, 25 “DFS998I” on page 252
Related information:
Chapter 2, “IMS problem determination,” on page 5 DFS2079I INVALID APPLICATION OUTPUT
LTERM xxxxxxxx LINE yyy PTERM zzz.
INVALID APPLICATION OUTPUT
DFS2077I DATA IS LONGER THAN BUFFER LTERM xxxxxxxx NODE yyyyyyyy
NODE x (USER y).
Explanation: A non-supported command code was
Explanation: An error was encountered while detected in application output using the MFS bypass.
attempting to move data into a buffer. Either the
segment received was larger than the SEGSIZE System action: A log record type X'67', subrecord X'01'
specified in the IMS system definition, or a VLVB block has been written using the IMS trace facility, which
count was larger than the remaining buffer size. provides a snap of the IMS control blocks and save
areas. The terminal involved will be made inoperable.
System action: The session for the node or user is A DFS998I message is sent to the MTO.
terminated. The data that was to be blocked was lost.
Operator response: (master terminal) The LTERM
should be reassigned, or the message dequeued. Notify System action: The attempt to initiate or
the system programmer. resynchronize the session fails.
System programmer response: Correct the application Operator response: See Programmer response.
program to use valid command codes.
Programmer response: Allow the response mode
Related information: transaction to complete and produce an output reply
“DFS998I” on page 252 message; then reestablish the session from NODE x
(USER y) or with an IMS /OPNDST command. The
/DISPLAY command can be used to determine when
DFS2080I CONVER TRANSACTION INPUT NOT
the response mode reply is available for output.
RECEIVED NODE x (USER y).
Problem determination: 1, 5, 6, 12 14
Explanation: An incorrect session protocol was
received while in a conversational mode. This problem Related information:
resulted in dequeuing a conversational output reply Chapter 2, “IMS problem determination,” on page 5
message; the message provided no valid reason to
continue the IMS conversation. The invalid session
DFS2082 RESPONSE MODE TRANSACTION
protocol caused by the error indicated one of the
TERMINATED WITHOUT REPLY.
following conditions:
1. LUSTATUS or CHASE with a changed direction in Explanation: A response mode application terminated
reply to a conversational output message. normally without having an output reply message
2. Exceptional response sense code X'0864' to a returned to the terminal.
conversational output message.
3. FMH 7 sense code X'0864' to a conversational An OTMA send-then-commit (CM1) or APPC
output message. synchronous input message receives a DFS2082
message when the IMS application did not reply to the
System action: The NODE x (USER y) session was IOPCB or do a message switch to another transaction.
terminated. An IMS log record (X'67'), containing
pertinent information, was produced with an ID of System action: This IMS message is sent in lieu of the
CVCT. application output reply to prevent the terminal from
being hung in response mode.
Operator response: See Programmer response.
Programmer response: Continue communication with
Programmer response: When the problem is corrected, IMS or correct the transaction logic to insert an
the session can be reestablished by NODE x, by USER appropriate reply.
y, or an IMS /OPNDST command.
Terminal operator response: See Programmer response.
Problem determination: 1, 5, 6, 12, 14
Problem determination: 1, 5, 6, 12 14
Related information:
Related information:
Chapter 2, “IMS problem determination,” on page 5
Chapter 2, “IMS problem determination,” on page 5
System action: Signon is ignored. The session is 020 A member joined the group and cannot
terminated, and message DFS2085I is sent to the support APPC/OTMA shared message
current MTO. queue enablement.
Operator response: Attempt the signon after 024 Another member dropped support for
diagnosing the problem. APPC/OTMA shared message queue
enablement.
Problem determination: 1, 5, 6, 12, 14
028 IMS disconnected from RRS.
Related information:
032 AOS=N was specified in the DFSDCxxx
“DFS3649A” on page 728
member.
Chapter 2, “IMS problem determination,” on page 5
036 RRS=N has been specified as startup
parameter.
DFS2086 /TRACE SET OFF FOR MONITOR IN
PROGRESS, CANNOT PROCESS
COMMAND System action: IMS forces every APPC/OTMA
message to the front-end system.
Explanation: The /TRACE SET ON MONITOR
command was entered before a previous /TRACE SET Operator response: Make sure that all the
OFF MONITOR command completed. requirements for APPC/OTMA shared message queue
enablement are met.
System action: The command is ignored.
Operator response: Reenter the command. | DFS2089I APPC/OTMA SMQ ENABLEMENT
Programmer response: If commands are entered
| ACTIVE.
through an automation program, change the program Explanation: The shared message queue support for
to increase the time between the /TRACE SET OFF synchronous APPC/OTMA is active.
MONITOR and /TRACE SET ON MONITOR
commands. System action: IMS allows every member within the
IMSplex to process APPC/OTMA messages.
Module: DFSICLN4
Operator response: No action is required.
Explanation: The IMS VTAM I/O timeout processor Explanation: This node has an output response
(DFSASLT0) was unable to obtain storage for the ASLTI outstanding for a period greater than the time specified
ITASK or the timer table required by the IMS VTAM on the /TRA SET TIMEOUT command used to activate
I/O timeout detection facility. the VTAM I/O timeout detection facility. The second
form of the message is issued for ISC nodes. The
The return codes and their meanings are: message includes VTAM sense information, if available.
Code (hex) System action: The action taken depends on what was
Meaning specified on the /TRA SET TIMEOUT command:
01 Unable to get time AWE for front and v If MSG was specified, the node is placed on a chain
switching initialization. of timed-out nodes and continues to wait for a
02 Unable to get second AWE for front and response.
switching initialization. v If AUTO was specified, IMS issues a VTAM VARY
03 Unable to get quick save area for timer table NET,INACT command followed by a VTAM VARY
initialization. NET,ACT command for the node. An OPNDST is issued
04 Unable to get storage for AS1T ITASK. for the node if it was defined as non-shared and is
05 Unable to create AS1T ITASK. still operable. Messages DFS2095I and DFS2096I
follow this message.
v If AUTO was specified and this is an ISC node, the Programmer response:
node is placed on a chain of timed-out nodes and v If MSG was specified, issue the IMS /IDLE and
continues to wait for a response. No automatic /ACT commands for the node to do a VTAM V
restart is performed. NET,INACT and V NET,ACT. Then the node can be
restarted.
Operator response: (master terminal) Notify the
v If AUTO was specified and this message was issued
system programmer.
for an ISC node, see the previous response for MSG.
Programmer response: v If AUTO was specified and this message was issued
v If MSG was specified, issue the IMS /IDLE and for a non-ISC node, do an IMS /DISPLAY of the
/ACT commands for the node to do a VTAM V node to make sure that it was restarted.
NET,INACT and V NET,ACT. Then the node can be
restarted. Remember: The VTAM TIMEOUT I/O facility is
v If AUTO was specified and this message was issued automatically started during IMS shutdown. It is set for
for an ISC node, see the previous response for MSG. 1 minute and 'AUTO'. Effectively, the trace command
v If AUTO was specified and this message was issued would be: /TRACE TIMEOUT 1 AUTO. The VTAM
for a non-ISC node, do an IMS /DISPLAY of the TIME I/O facility is also automatically started during
node to make sure that it was restarted. IMS initialization.
Related information:
Remember: The VTAM TIMEOUT I/O facility is
“DFS2095I”
automatically started during IMS shutdown. It is set for
1 minute and 'AUTO'. Effectively, the trace command “DFS2096I”
would be: /TRACE TIMEOUT 1 AUTO. The VTAM
TIME I/O facility is also automatically started during DFS2095I V NET,INACT PERFORMED FOR
IMS initialization. NODE nodename.
Related information:
Explanation: IMS has issued a VTAM 'VARY
“DFS2095I” NET,INACT' command for one of the following
“DFS2096I” reasons:
v The IMS VTAM I/O timeout detection facility
detected a VTAM node that has timed out, and is
DFS2094I NODE nodename USER username TIMED
automatically deactivating it. This message is
OUT AT hh:mm SENSE=xxxx.
preceded by message DFS2094I and followed by
message DFS2096I.
or v IMS TM shutdown processing has detected an
outstanding SIMLOGON for a dynamic terminal that
NODE nodename TIMED OUT AT hh:mm SENSE=xxxx. has not completed, and is automatically deactivating
Explanation: This node has an output response the node. This message is followed by message
outstanding for a period greater than the time specified DFS2096I.
on the /TRA SET TIMEOUT command used to activate Related information:
the VTAM I/O timeout detection facility. The second “DFS2094I” on page 435
form of the message is issued for ISC nodes. The
“DFS2096I”
message includes VTAM sense information, if available.
System action: The action taken depends on what was
DFS2096I V NET,ACT PERFORMED FOR NODE
specified on the /TRA SET TIMEOUT command:
nodename.
v If MSG was specified, the node is placed on a chain
of timed-out nodes and continues to wait for a Explanation: IMS has issued a VTAM 'VARY
response. NET,ACT' command for one of the following reasons:
v If AUTO was specified, IMS issues a VTAM VARY v The IMS VTAM I/O timeout detection facility
NET,INACT command followed by a VTAM VARY detected a VTAM node that has timed-out, and is
NET,ACT command for the node. An OPNDST is issued automatically reactivating it. When IMS issues this
for the node if it was defined as non-shared and is message, it is preceded by messages DFS2094I and
still operable. Messages DFS2095I and DFS2096I DFS2095I.
follow this message. v IMS TM shutdown processing has detected an
v If AUTO was specified and this is an ISC node, the outstanding SIMLOGON for a dynamic terminal that
node is placed on a chain of timed-out nodes and has not completed, and is automatically reactivating
continues to wait for a response. No automatic the node. This message is preceded by message
restart is performed. DFS2095I.
Operator response: (master terminal) Notify the Related information:
system programmer. “DFS2094I” on page 435
System action: The message is canceled. System action: The command is ignored, and
processing continues.
Programmer response: Correct the 3600 or 3790
program, or, if required, correct the definition of the Operator response: Correct the command and issue it
transaction in IMS system definition. again.
Explanation: You entered the NODE keyword without Explanation: On a line where ID verification is
specifying which nodes or all. required, a 3275 dial terminal, which was not
authorized in the ID list, attempted to connect to IMS.
System action: The IMS system continues, and the
command is ignored. System action: The connection is broken. The line is
restarted and is waiting for a connection attempt.
Operator response: Reenter the command specifying
the nodes to be operated on. Programmer response: When the situation warrants it,
use the Log Print Utility (DFSERA10), with record
Module: DFSICLN0 type=X'69', to list the offending terminal IDs and the
lines they accessed.
DFS2104 INVALID NODE NAME -NODE
nodename DFS2107 NODE NOT PHYSICALLY
DISCONNECTED, CANNOT PROCESS
or COMMAND.
Explanation: An /EXIT command was issued for a
INVALID NODE NAME.
remote terminal node, which is not physically
Explanation: A specified node name was not found in disconnected currently.
System action: The command is not processed. Programmer response: Use the provided information
(return code and error flags) to find out why the
Operator response: Try the command again when
CLOSE failed. See VTAM V4R3 for MVS/ESA
remote node is disconnected.
Programming (SC31-6496) for a description of the
CLOSE macro and an explanation of the return codes
DFS2108 INVALID COMMAND FROM and error flags. VTAM Messages and Codes (SC31-6493)
NON-VTAM TERMINAL. provides additional information.
Explanation: An attempt has been made to CLOSE the Operator response: (master terminal) Unless the error
VTAM ACB, and a return code of X'xx' was received. message indicates otherwise, repeat the session.
Otherwise, dial the next required terminal.
System action: IMS continues processing.
Problem determination: 23, 36
Master terminal operator response: One of the
Related information:
following actions can be taken:
Chapter 2, “IMS problem determination,” on page 5
v Enter /CLSDST command to disconnect any active
nodes if there is no need to continue processing.
v Enter /CHECKPOINT command to close down IMS. DFS2115 PTERM DISC LINE xxx PTERM xxx
{[SEQ NO xxxxx [SEGM ID xxxxxxxx]] ,
v Ignore the message if processing must continue.
DO NOT REDIAL PTERM}.
v /STOP DC to close ACB
Explanation: The terminal issued a disconnect
System action: IMS continues processing. sequence during input or output.
System action: The current session terminates. The
DFS2111I VTAM ACB CLOSED. next session is initiated ready for operator connection.
Explanation: The VTAM ACB has been closed. IMS is Operator response: (master terminal) The current
disconnected from VTAM. session cannot be reestablished without correcting the
System action: IMS continues processing. problem at the remote terminal.
Problem determination: During input, the message
DFS2112I UNABLE TO CLOSE VTAM ACB, REG segment at the point of error is identified by a
15=rc, ACBERFLG=xx. sequence number, and, optionally, by an 8-character
identifier. For both input and output, the termination
Explanation: An attempt has been made to CLOSE the status is on the screen at the remote terminal.
VTAM ACB using a /STOP DC command or by VTAM
driving the IMS TPEND exit routine. The attempt failed
with the return code, rc, in register 15 and the ACB DFS2116 OUTPUT COMPLETE LINE xxx PTERM
error flags set as indicated by xx. xxx.
System action: IMS internally marks the VTAM ACB Explanation: All ready output messages have been
as closed and continues processing without its VTAM successfully written to the terminal. This message is not
interface.
issued if no output messages are written during the persists, do not initiate further sessions until the exit
session. routine has been corrected.
System action: The current session is completed. The Programmer response: Correct the user sign-on exit to
next session is initiated ready for operator connection. create valid IMS names.
Problem determination: Repeat the session using
DFS2117 INPUT COMPLETE LINE xxx PTERM /TRACE (Level 3), and print the log data set to show
xxx. the set command in error.
Explanation: The input message has been successfully
read from the terminal. This message is not issued if DFS2121 USER EXIT REQUESTED DISC LINE
there is no input message to be read. xxx PTERM xxx.
System action: The current session continues with the Explanation: The user sign-on exit passed a return
output phase. If there are no output messages, the code requesting that the terminal be disconnected.
session is complete and the next session is initiated for
System action: The current session terminates. The
operator connection.
next session is initiated ready for operator connection.
Programmer response: Check to determine that the
DFS2118 DIAL REMOTE TERMINAL LINE xxx
user sign-on exit request is valid; if not valid, take
PTERM xxx.
corrective action.
Explanation: A session has been initiated after a start
Master terminal operator response: Dial the required
line command, or following a previous session.
terminal.
System action: The session waits until a terminal is
Problem determination: 6, 24
physically connected and the enabled control unit is
posted. Related information:
Chapter 2, “IMS problem determination,” on page 5
Master terminal operator response: Dial the required
terminal, and press DATA on the Modem when a tone
is heard. If all sessions are completed, issue a STOP DFS2122 INPUT ERROR LINE xxx PTERM xxx
command and then press DATA on the Modem that [SEQ NO xxxxx [SEGM ID xxxxxxxx]].
terminates the session and idles the line.
Explanation: A permanent input error occurred while
reading the input message from the terminal.
DFS2119 IAM COMMAND ERROR LINE xxx
PTERM xxx. System action: The current session terminates. The
next session is initiated, ready for operator connection.
Explanation: The internally created /IAM command
was rejected by IMS as invalid. Master terminal operator response: Repeat the session.
If the error persists, manual intervention may be
System action: The current session terminates. The required at the remote terminal.
next session is initiated, ready for operator connection.
Problem determination: The input message segment
Operator response: (master terminal) If the problem at the point of error is identified by a sequence number
persists, do not initiate further sessions until the exit and, optionally, by an 8-character identifier. The
routine has been corrected. termination status is on the screen at the remote
terminal.
Programmer response: Correct the user sign-on exit to
create valid IMS names.
DFS2123 STATUS MSG x LINE xxx PTERM xxx
Problem determination: Repeat the session using
{[SEQ NO xxx [SEGM ID] xxxxxxxx],
/TRACE (Level 3), and print the log data set to show
DO NOT REDIAL PTERM}.
the /IAM command in error.
Explanation: An error was detected at the remote
terminal. A 1-character status message was read from
DFS2120 SET COMMAND ERROR LINE xxx
the terminal and inserted into the error message.
PTERM xxx.
System action: The current session terminates. The
Explanation: The internally created /SET command
next session is initiated, ready for operator connection.
was rejected by IMS as invalid.
Operator response: (master terminal) Unless the error
System action: The current session terminates. The
message indicates otherwise or the status message
next session is initiated ready for operator connection.
indicates the problem is unrecoverable without manual
Operator response: (master terminal) If the problem intervention, repeat the session. Otherwise, dial the
required terminal.
Problem determination: During input, the message Operator response: The error message sent to the
segment at the point of error is identified by a input and the master terminals indicates the type of
sequence number and, optionally, by an 8-character message that was in error. Compare the two system
identifier. For both input and output, the termination definition specifications for this message and correct
status is on the screen at the remote terminal. Check the one in error.
the 3741 status message character in the error message.
Problem determination: 14
Related information:
DFS2124 OUTPUT NOT COMPLETE.
Chapter 2, “IMS problem determination,” on page 5
Explanation: The user issued a stop line and
disconnected the terminal before all of the messages in
DFS2127 SPA IN MSG FOR NON-CONV TRANS
the queue were sent.
I: sss1/name1, D: sss2/name2
System action: System continues processing.
Explanation:
Operator response: Proceed with the normal terminal
In the message text:
operation.
sss1/name1
The source SYSID and source LTERM name
DFS2125 LOGICAL TERMINAL BECAME for the input system. name1 is defined as
TRANS I: sss1/name1, D: sss2/name2 nonconversational.
sss2/name2
Explanation:
The destination SYSID and destination LTERM
In the message text: or TRAN code of the processing system. name2
sss1/name1 is defined as conversational.
The source SYSID and source LTERM name
System action: IMS logs the message in error, using
for the input system.
log record type "64", and removes the message from the
sss2/name2
system.
The destination SYSID and destination LTERM
or TRAN code of the processing system. Operator response: The error message sent to the
input and the master terminals indicates the type of
System action: IMS logs the message in error, using
message that was in error. Compare the two system
log record type "64", and removes the message from the
definition specifications for this message and correct
system.
the one in error.
Operator response: The error message sent to the
Programmer response: Correct the erroneous system
input and the master terminals indicates the type of
definition.
message that was in error. Compare the two system
definition specifications for this message and correct Problem determination: 14
the one in error. Related information:
Programmer response: Correct the erroneous system Chapter 2, “IMS problem determination,” on page 5
definition.
Problem determination: 14 DFS2128 NO SPA IN MSG FOR CONV TRANS
Related information: I: sss1/name1, D: sss2/name2
Chapter 2, “IMS problem determination,” on page 5 Explanation:
In the message text:
DFS2126 TRANS BECAME LOGICAL
sss1/name1
TERMINAL I: sss1/name1, D: sss2/name3
The source SYSID and source LTERM name
Explanation: for the input system. name1 is defined as
nonconversational.
In the message text:
sss1/name1 sss2/name2
The source SYSID and source LTERM name The destination SYSID and destination LTERM
for the input system. or TRAN code of the processing system. name2
sss2/name2 is defined as conversational.
The destination SYSID and destination LTERM
System action: IMS logs the message in error, using
or TRAN code of the processing system.
log record type "64", and removes the message from the
System action: IMS logs the message in error, using system.
log record type "64", and removes the message from the
Operator response: The error message sent to the
system.
input and master terminals indicates the type of
message that was in error. Compare the two system input and the master terminals indicates the type of
definition specifications for this message and correct message that was in error. Compare the two system
the one in error. definition specifications for this message and correct
the one in error.
Programmer response: Correct the erroneous system
definition. Programmer response: Correct the erroneous system
definition.
Problem determination: 14
Related information: Problem determination: 14
Chapter 2, “IMS problem determination,” on page 5 Related information:
Chapter 2, “IMS problem determination,” on page 5
DFS2129 MSG IS RECOV BUT DEST IS NOT I:
sss1/name1, D: sss2/name2 DFS2131 DEST OF A RESPONSE IS A TRANS I:
sss1/name1, D: sss2/name2
Explanation:
Explanation: In the message text:
In the message text:
sss1/name1
sss1/name1 The source SYSID and source LTERM name
The source SYSID and source LTERM name for the input system.
for the input system. name1 is defined as sss2/name2
recoverable. The destination SYSID and destination LTERM
or TRAN code of the processing system.
sss2/name2
The destination SYSID and destination LTERM System action: IMS logs the message in error, using
or TRAN code of the processing system. name2 record type "64", and removes the message from the
is defined as unrecoverable. system.
System action: IMS logs the message in error, using Operator response: The error message sent to the
log record type "64", and removes the message from the input and the master terminals indicates the type of
system. message that was in error. Compare the two system
definition specifications for this message and correct
Operator response: The error message sent to the the one in error.
input and the master terminals indicates the type of
message that was in error. Compare the two system Programmer response: Correct the erroneous system
definition specifications for this message and correct definition.
the one in error.
Problem determination: 14
Programmer response: Correct the erroneous system Related information:
definition.
Chapter 2, “IMS problem determination,” on page 5
Problem determination: 14
Related information: DFS2132 INPUT LOGICAL TERMINAL NOT
Chapter 2, “IMS problem determination,” on page 5 FOUND I: sss1/name1, D: sss2/name2
Explanation: This system received a message that is a
DFS2130 MSG IS NOT RECOV BUT DEST IS I: response to the input. The input originated from an
sss1/name1, D: sss2/name2 LTERM in this system, but now that LTERM cannot be
found, the system error, or the definition of sss1 is
Explanation: changed. name1 is not defined in sss1.
In the message text: In the message text:
sss1/name1
The source SYSID and source LTERM name sss1/name1
for the input system. name1 is defined as The source SYSID and source LTERM name
recoverable. for the input system.
sss2/name2
sss2/name2
The destination SYSID and destination LTERM
The destination SYSID and destination LTERM
or TRAN code of the processing system. name2
or TRAN code of the processing system.
is defined as unrecoverable.
System action: IMS logs the message in error, using
System action: IMS logs the message in error, using
log record type "64", and removes the message from the
log record type "64", and removes the message from the
system.
system.
Operator response: Inform the system programmer.
Operator response: The error message sent to the
System action: IMS logs the error information using a v CLBTEMP4 = Module ID. i.e. C'CONM' =
type X'6701' log record. The link is stopped by PSTOP. DFSCONM0, C'CON2' = DFSCON20, C'CMSV' =
The restart block is updated so that a subsequent DFSCMSV0, or C'CMSZ' = DFSCMSZ0.
restart link will work; however, the messages will v If applicable, R5 or R14 BALR offset into the module
remain lost. that detected the error
Operator response: Verify that both IMS systems were
correctly restarted (a cold start or restart from the DFS2147I ACB CLOSE PENDING ON MASTER
wrong checkpoint could cause this). Restart the link TERMINALS.
again. The link should restart, but the messages will
Explanation: A /STOP DC command was entered, but
remain lost.
cannot complete until the VTAM ACB is closed. The
Programmer response: The log data sets from both ACB cannot be closed until all VTAM node sessions
systems will have to be analyzed to determine why the have terminated. This message is issued to inform the
messages were lost. If the error occurred following an operator that the only remaining active nodes are the
IMS warm start, then the restart log data set will also master or secondary master terminals, or both.
have to be analyzed. (You will need to print type 40,
Operator response: Issue a /CLSDST NODE or /IDLE
66, and X'6701' records.)
NODE command to close the nodes. This allows the
Problem determination: 36. Include as documentation VTAM ACB to close and /STOP DC processing to
the master terminal output and IMS log data sets from complete. Message DFS2111I will indicate a successful
both systems. If IMS was warm started, then include VTAM ACB close.
the restart logs also.
DFS2148I HH:MM:SS QERR=aabb REMOTE MSG
DFS2146 INVALID DATA BLOCK RECEIVED xxxx FROM SYSID=yy.
LINK xx.
Explanation: A queue error occurred while requesting
Explanation: A data block was received on link xx function aa. The queue manager issued return code bb;
that, when checked, was found to contain invalid or SYSID yy issued command xxxx.
lost data, or the conversational routines detected an
System action: The message is dequeued and control
error while attempting to process a conversational type
is returned to the dispatcher. A X'6701' record, which
message.
provides a SNAP of the relevant control blocks, is
System action: The data block is rejected. If the data written to the log.
block was a resync, restart, or shutdown message, the
Operator response: Reenter a valid command.
link has stopped. If the data block was a user or system
message, the message was discarded (dequeued) on the System programmer response: See Problem
sending IMS. Also, the associated sending MSNAME Determination for the correct response.
path was stopped on the sending IMS and message
DFS2140 with a 2146 reason code was issued on the Problem determination: 1, 5, 6, 7, 17b
sending IMS. Both sides write type 6701 ID = MSSx (x Related information:
= 1, 2, or 3) log records. Chapter 2, “IMS problem determination,” on page 5
Operator response: (master terminal): Display the
logical link in the partner system (/DIS MSNAME) to DFS2149 PARTNER IMS IN SAME SHARED
see if the link was stopped. If the partner was not QUEUES GROUP - RESTART
stopped, the error was recovered. If it was stopped, ABORTED LINK xxx
restart the link (/START MSNAME).
Explanation: The master terminal operator attempted
System programmer response: Print the type 6701 log to start a multiple systems coupling (MSC) link and
records and analyze the error. partner IMS is in the same shared queues group (SQG).
Problem determination: Contact the system MSC link traffic between IMS systems in the same SQG
programmer if the error persists. is not supported.
The following CLBTEMP fields will be set in the LLB System action: IMS stops the link.
block in the 6701 MSS1 record: Operator response: The link is not restarted. Inform
v CLBTEMP1 = Pseudo abend code if this is a the system programmer, if the link is not intended for
conversational error. CLBTEMP4 is CONM or CON2 backup purposes, such as when IMS or the partner IMS
for conversational type errors. is brought up in non shared queues mode or in a
v CLBTEMP2 = Return code if applicable different shared queues group.
v CLBTEMP3 = Message key = x'00000862' = decimal
2146 Programmer response: Remove the shared queues
specification from one of the IMS systems (for example,
the SHAREDQ= startup parameter) or place one of the
IMS systems in a different SQG. The following channel-to-channel return codes and
meanings are possible:
DFS2150A hh:mm:ss CTC IO ERR PC=xx
Return
REASON=xx OP=xx LINK nnnn
STOPPED. Code (hex)
Meaning
Explanation: For an explanation and actions, see
04 Logic error: IOSB is not busy on ACK or
DFS2150I.
WRACK.
Related information: 08 Logic error: ACK or WRACK is issued, and no
DFS2150I message is received to acknowledge.
10 Logic error: on STARTUP, there is an invalid
value in DECWAREA, DECWLNG, DECAREA
DFS2150I MTM I/O ERR PC=xxcccccc LINK=xxxx.
or DECLNGTH.
14 Probable I/O error: on attention interrupt.
or 18 Paging error: at STARTUP.
1C Logic error: in module DFSCMC50 at
CTC ERR RC=xx LINK=xxxx. STARTUP.
20 Logic error: STARTUP issued, but link is
or already connected.
24 Logic error: SHUTDOWN issued, but link is
hh:mm:ss CTC IO ERR PC=xx REASON=xx OP=xx already shut down.
LINK nnnn RSTARTED. 28 An I/O error or an abnormal condition was
detected during SHUTDOWN, and
or SHUTDOWN was successfully executed.
MTM ERR RC=xx LINK=xxxx. The following table shows the possible post codes,
associated reason codes, and their meanings:
Explanation: An I/O error has occurred.
Table 13. Possible post codes, associated reason
In the message text:
RC The return code codes, and meanings for DFS2150I
PC The post code Post Code Meaning
REASON reason (hex)
The associated channel-to-channel reason code code
LINK The link number
7F any I/O complete without error
OP The attempted CTC operation
hh:mm:ss 7F 04 Startup: Link available for
The time write
7F 08 Startup: message received
If message DFS2150I...LINK nnnn RSTARTED is issued,
the link was stopped and then restarted by IMS. If 7F OC Message received
message DFS2150A...LINK nnnn STOPPED is issued, 7F 10 Shutdown received
IMS attempted to restart the link, but was unable to do
so. 7F 1C Acknowledgement received
7F 20 Acknowledgement with data
The following channel-to-channel operations apply: received
41 any I/O error detected
Operation
41 01 Error in attempting to
Code (hex) determine command in
Meaning adapter
04 WRITE: write a buffer.
08 ACK: acknowledge input. 41 02 Invalid command in adapter
0C WRACK: write a buffer and acknowledge 41 03 Error in reading message
input.
10 STARTUP: establish connection.
14 SHACK: acknowledge input and shut down The following real storage-to-real storage connection
the connection. return codes and meanings apply:
18 SHUTDOWN: shut down the connection.
1C READ: read input.
Return
Code (hex)
Meaning
12 Window is not open or not found.
16 Window is allocated to two other systems.
20 Invalid input.
24 IEAMSCHD failed: partner has terminated.
28 Buffer lock failure.
32 Buffer lengths are not equal.
36 Caller is not authorized.
40 Main storage-to-main storage access routine is
defined for a different OS.
44 Window queue header block is bad or is not
initialized.
48 GET or GETMAIN failure.
52 PGFIX or PGFREE error.
IEA000I
Related information:
DFS2150A
Explanation: The link number specified was not valid System programmer response: See Problem
for the defined multiple systems IMS system. Determination for the correct response.
Explanation: Link nnn was started at the request of System action: IMS logs the message in error, using
the remote partner system. log record type '64', and removes the message from the
system.
System action: Processing continues.
Operator response: (master terminal) The error
Operator response: No action is required.
message sent to the input and master terminals
Programmer response: No action is required. indicates the type of message that was in error.
Compare the two system definition specifications for
Problem determination: Not applicable. this message and correct the one in error. Inform the
system programmer.
DFS2161I LINK xxx STOPPED BY PARTNER. Programmer response: Correct the erroneous system
Explanation: Link xxx was stopped at the request of definition.
the other system attached to it. The other system might
be shutting down, or the master terminal operator DFS2164 MSG IS SNGL SEG, DEST IS MULTI
might have entered a /PSTOP LINK command. D: sss1/name1, I: sss2/name2
System action: Output messages are queued on this Explanation:
link, but none are sent.
In the message text:
Operator response: (master terminal) Issue a sss1/name1
/RSTART LINK command to put the link back into The source SYSID and source LTERM name
operation. The master terminal operator in the other for the input system. name1 is defined as a
system must do the same before message transfers will single segment.
begin. sss2/name2
The destination SYSID and destination LTERM
DFS2162 TERMINAL IN RESPONSE or TRAN code of the processing system. name2
MODE-ENTER PA1 or PA2 THEN is defined as a multisegment.
AWAIT REPLY. System action: IMS logs the message in error, using
Explanation: This terminal is in response mode either log record type '64', and removes the message from the
because it is defined to operate in forced-terminal system.
response mode, or because a terminal response type of Operator response: The error message sent to the
transaction was entered. input and master terminals indicates the type of
System action: IMS discards the entered data. The message that was in error. Compare the two system
application program will respond to the last accepted definition specifications for this message and correct
input, unless the terminal is page protected. the one in error. Inform the system programmer.
Operator response: Page protection can be overridden System programmer response: Correct the erroneous
by pressing PA1 or PA2. If no response is received, system definition.
contact the master terminal operator to have the Problem determination: 14
operator issue the /STOP, /START commands for node
or in the case of a dynamic terminal, the /STOP, Related information:
/START commands for the user. Chapter 2, “IMS problem determination,” on page 5
System action: IMS logs the message in error, using | 4 CAUTRMSC RACF failure occurred; it was
log record type '64', and removes the message from the
| unable to obtain the ACEE for
| MSNAME.
system. | CLBTEMP3 = RACF RC
Operator response: (terminal operator) Notify the | 8 RACFERR RACROUTE failure.
master terminal operator. | CLBTEMP3 = RACF RC.
(master terminal operator) This is probably a user | C CAUT044 TRANAUTH was specified, but
error. Use the /DISPLAY ASSIGNMENT command to | RACF was not defined.
display the current SYSID assignments involved. If the | 10 TESTE010 An error was returned from
looping message is a response destined for an inputting | DFSCRTN0.
terminal that is in response, conversation, or exclusive | CLBTEMP3 = DFSCTRN0 RC.
mode, this error can result in the terminal remaining | 14 GETRACWE The GETRACW routine was unable
locked until restarted with a /START command or until | to obtain storage.
the conversation is terminated with an /EXIT | CLBTEMP3 = BCB RC.
command. | 18 CAUTRINT The CAUTRINT routine was unable
| to obtain storage.
Problem determination: 14 | CLBTEMP3 = BCB RC.
Related information: |
Chapter 2, “IMS problem determination,” on page 5 | Problem determination: 14
Module: DFSCMS00
DFS2166 EXTENDED SECURITY VIOLATION
Related information:
FOR MSC LINK [I: sss/name, D: sss/name]
Chapter 2, “IMS problem determination,” on page 5
Explanation: While an MSC link was receiving an
input message destined to a transaction, a security
check to determine if the input message was allowed DFS2167 FAST PATH MSG REJECTED BY MSC
for the transaction destination failed. The failure I: sss1/name1, D: sss2/name2
occurred due to an authorization check made by RACF Explanation:
or by the user exit DFSCTRN0.
In the message text:
If the optional part of the message is printed: sss1/name1
v name following D: is the transaction destination of The source SYSID and source LTERM name
the message; name following I: is the input system for the input system.
LTERM name. sss2/name2
v sss following I: is the SYSID of the input system; sss The destination SYSID and destination LTERM
following D: is the SYSID of the processing system. or TRAN code of the processing system. name2
The /DISPLAY ASSIGNMENT SYSID command can be is defined for exclusive Fast Path transactions.
used to determine the MSNAME involved. Multiple Systems Coupling does not support
exclusive Fast Path transactions.
System action: IMS logs the message in error, using
record type 64, and removes the message from the System action: IMS logs the message in error, using
system. log record type '64', and removes the message from the
system.
| System programmer response:
Operator response: The error message sent to the
| Correct the erroneous security error. Check the input and master terminals indicates the type of
| MSCSEC= parameter in the DFSDCxxx PROCLIB message that was in error. Compare the 2 system
| member of the remote system. Also, check that the link definition specifications for this message and correct
| receive logic of the user exit DFSMSCE0 of the remote the one in error. Inform the system programmer.
| system determines the type of security check that was
| made. Using the information from the X'64F1' and System programmer response: Correct the erroneous
| X'64F2' log records and the DFS2166 error message system definition.
| determine why the security authorization check failed. Problem determination: 14
| An X'6701' log record with ID=CMEA is logged. Related information:
| CLBTEMP5 contains the return code (RC) from Chapter 2, “IMS problem determination,” on page 5
Master terminal operator response: Start the The transaction code updated by the Link Exit is not
transaction with the /START command. defined as a local transaction in sss2.
In the message text:
DFS2171I NO RESPONSE. CONVERSATION sss1/name1
ENDED. The source SYSID and source LTERM name
for the input system.
Explanation: The synchronization point processor sss2/name2
found that a conversational program did not insert a The destination SYSID and destination LTERM
message to the IOPCB, ALT CONVERSATION PGM or TRAN code of the processing system.
PCB, or ALTRESP PCB.
System action: IMS logs the message in error, using
System action: After terminating the conversation, the log record type '64', and removes the message from the
system issues error message DFS2171I to the input system.
terminal.
Operator response: Inform the system programmer.
Operator response: The terminal in conversation can
reenter the conversation with different input data. System programmer response: Correct the error either
in the MSC Link Exit Routine, or in the System
Programmer response: Check the input message Definition.
Problem determination: 14
DFS2176 RESPONSE LTERM NOT LOCAL
Related information: LTERM I: sss1/name1, D: sss2/name2
Chapter 2, “IMS problem determination,” on page 5
Explanation: An application program in response
mode changed the destination of the response and
DFS2175 MESSAGE CANCELED BY ROUTING inserted a message to a modifiable alternate response
EXIT RSN=xxyy ROUTINE I:sss1/name1, PCB. But name2 is not a local CNT in the inputting
D:sss2/name2. system.
Explanation: Either the Terminal Routing entry point In the message text:
or the Link Receive Routing entry point in the
sss1/name1
DFSMSCE0 exit canceled (rejected) this message.
The source SYSID and source LTERM name
If sss/name appears in the message, the message was for the input system.
canceled in a remote system by the Link Receive
sss2/name2
Routing entry point.
The destination SYSID and destination LTERM
In the message text: or TRAN code of the processing system.
xx The IMS module that detected the error:
System action: IMS logs the message in error, using
01 DC Communication Manager
log record type '64', and removes the message from the
(DFSICIO0 - Terminal Routing)
system.
02 MSC Analyzer (DFSCMS00 - Link
Receive Routing) Operator response: The error message sent to the
yy The reason for error is 01. If xx=01, the input and the master terminals indicates the logical
message was canceled by the DFSMSCE0 terminals involved. Verify the need for the input
Terminal Routing entry point. If xx=02, the terminal in response mode. Inform the system
message was canceled by the DFSMSCE0 Link programmer.
Receive Routing entry point.
System programmer response: Correct the erroneous
sss1/name1
application program. When the input terminal is in
The source SYSID and source LTERM name
response mode, the message response must go to the
for the input system.
input system.
sss2/name2
The destination SYSID and destination LTERM Problem determination: 14
or TRAN code of the processing system. Related information:
System action: If xx=02, IMS logs the canceled Chapter 2, “IMS problem determination,” on page 5
message (using log record type '64') and removes the
message from the system. If xx=01, IMS removes the
message from the system. DFS2177I LOAD ERROR FOR USER EXIT
DFSDBUX1
System programmer response: Determine which entry
point in the DFSMSCE0 exit canceled the message. See Explanation:
the user exit to determine why the exit canceled the The user specified DATXEXIT=YES at DBDGEN time,
message. If the Link Receive Routing entry point but failed to linkedit DFSDBUX1 into an APF
canceled the message, use the MSC link trace to gather authorized library. At execution time, while processing
more information (/TRACE SET ON LINK x MODULE a DBD requiring the exit, DFSDLA00 determined that
ALL LEVEL 3). If the Terminal Routing entry point the exit could not be loaded and issued the load error
canceled the message, use the exit trace to gather more message. This message can also result if the user
information (/TRACE SET ON EXIT DFSMSCE0 ALL specified DATXEXIT=YES and the user exit set
or TRBT|TRVT|TR62| TROT|LRTR|LRLT|LRDI|LRIN). You SRCHFLAG to X'FF' because the user exit determined
can also use UPDATE MSLINK NAME(linkname) the DBD did not require the exit.
START(TRACE). For more information about these
traces and diagnosing routing errors, see the IMS System action: After issuing the message, the database
diagnostic information. requiring the exit is stopped and the transaction
receives a U0885 pseudoabend.
Note: The type-2 command UPDATE MSLINK Programmer response: If the user exit (DFSDBUX1) is
NAME(linkname) START(TRACE) uses the same level required for the application, ensure that DFSDBUX1 is
and module settings that were used the last time the bound into an APF authorized library, and restart IMS
/TRACE SET (ON) LINK command was issued. If a before restarting the application.
/TRACE SET (ON) LINK command has not been
issued since the last cold start, this command defaults If the second option above applies, either remove the
to MODULE=ALL and LEVEL=4. DATXEXIT=YES from the DBDGEN or change the user
exit so that is does not set SRCHFLAG to X'FF'.
Module: DFSCMS00, DFSICIO0, DFSMSCE0
System action: IMS will terminate all active sessions Command processing continues normally but
and idle the nodes. At this point the IMS VTAM ACB is the exit routine is not called for subsequent
closed. command response segments for this
command.
DFS2180I AUTOMATED OPERATOR USER EXIT 11 The exit routine requested that IMS pass the
ERROR-CODE=x. message to DFSAOUE0, but DFSAOUE0 does
not exist.
Explanation: IMS detected an error condition
indicated by x in an automated operator (AO) exit Message processing continues normally but
routine. the exit routine is not called for subsequent
message segments for this message.
The following codes are issued for AO exit routine
DFSAOUE0: 12 The exit routine returned with an invalid reply
code for a message segment.
Code (dec)
Meaning Message processing continues normally but
1 The user exit destination name was invalid. the exit routine is not called for subsequent
There is no TRAN/LTERM defined by that message segments for this message.
name. No further exit routine processing takes
13 The exit routine returned with a return code
place with this message/command.
outside the range of valid return codes. The
2 The queue manager handling a request on
return code is changed to 0 (the exit processes
behalf of the exit routine returned a nonzero
the message or command), and processing for
return code. No further exit routine processing
the message or command proceeds.
takes place for this message/command.
3 The return code in register 15 is invalid. No 14 The exit routine returned with a reply code
further exit routine processing takes place for other than 0 for a command entered either
this message/command. internally by IMS or by the DL/I ICMD call.
4 There were multiple requests for storage. No
The processing for the command proceeds
further exit routine processing takes place for
normally. The exit routine is not called for
this message/command.
command response messages for commands
5 An exit routine request for storage could not
entered either internally by IMS or by the
be satisfied. Either the request is unreasonably
DL/I ICMD call.
large or the CIOP buffer pool needs to be
increased. 20 The AO User Exit Interface detected an error.
6 The AO detected an error. The standard AO AO trace log record X'6701' is generated, and
log record is produced, and exit routine exit routine processing for the command in
processing for the message in progress is progress proceeds.
terminated.
2 Cannot reroute a conversational message to a Programmer response: Increase the region size on the
non-conversational destination. next IMS restart.
3 Cannot reroute a non-conversational message
Module: DBFHIEL0
to a conversational destination.
4 Error while building a rerouted message.
5 Cannot reroute a message switch to a DFS2193I SHARED EMH PROCESSING FAILED:
conversational destination. RC=nn PROCESSING IMSID=xxxxxxxx
6 Error during copy of LU 6.2 prefix while
building a rerouted message. Explanation: An IFP region was unable to process an
input message retrieved from the shared expedited
System action: The message is not rerouted. The message handler queue (EMHQ). This message is sent
associated default action is performed. to the inputting terminal and the input message is
deleted from the shared EMHQ. IMSID is the IMS ID
If a /DEQ command was entered and the reroute fails
of the processing IMS subsystem. In an XRF system,
before IMS dequeues the message, the message remains
IMSID is the RSENAME of the processing IMS
on the queue.
subsystem. A possible reason is that the transaction is
If the reroute fails after IMS dequeues the message, the not defined in the processing IMS subsystem. The
default action is performed, and the message is return code is one of the following:
dequeued. 01 The transaction code is not defined.
02 The transaction code name is invalid.
If a STOPPED destination is provided by the Message
03 The input message is too large.
Control/Error exit routine to reroute a message, the
04 The transaction is stopped at the processing
destination name is either LTERM followed by the
IMS.
LTERM name, or TRAN followed by the transaction
05 The input terminal name is invalid. The
name.
processing IMS subsystem cannot locate the
System programmer response: Check the Message input LTERM.
Control/Error exit (DFSCMUX0) for the default action.
System action: The input message is discarded.
Provide a good destination in the user exit, if
appropriate. Module: DBFHGU10
Local/remote terminal operator response: If the
destination was stopped, enter the /START command DFS2194 SHARED EMHQ NOT AVAILABLE
to start the destination. The next message can then be
Explanation: The shared expedited messages handler
rerouted successfully.
(EMH) queues were temporarily unavailable to perform
shared EMH processing.
DFS2191 UNABLE TO PROCESS SHARED EMH
System action: The input message is rejected.
DUE TO GLOBAL STORAGE
SHORTAGE Module: DBFHIEL0
Explanation: While using the shared expedited
message handler (EMH) to process an input message, DFS2195I INPUT MESSAGE DISCARDED DUE
Fast Path was unable to obtain global storage from TO REBUILD
ECSA for the following internal control blocks:
UOW table Explanation: An input message was put on the
expedited message handler queue (EMHQ) to process.
System action: The message is ignored. Before an IMS can process the message, a recovery
rebuild was done to rebuild the EMHQ. The input
Programmer response: Increase ECSA storage on the
message was lost as a result of the recovery rebuild
next IMS restart.
process.
Module: DBFHIEL0
System action: The input message is discarded.
Module: DBFSEQS0
DFS2192 UNABLE TO PROCESS SHARED EMH
DUE TO PRIVATE STORAGE
SHORTAGE DFS2195W INPUT MESSAGE DISCARDED DUE
TO REBUILD WHILE IMS IS DOWN.
Explanation: While using the shared expedited
TERMINAL xxxxxxxx MIGHT REMAIN
message handler (EMH) to process an input message,
LOCKED
Fast Path was unable to obtain extended private
storage for the following internal control blocks: Explanation: An input message on a client queue was
FPWP discarded because a coupling facility was rebuild and
an emergency restart of the IMS was run. The inputting
System action: The message is ignored.
If the data set ran out of space, DFSUTR20 can be used INVALID DEVICE
to report the current contents, and the monitor can be For an online IMS, an OLDS or WADS is
restarted. IMS does not need to be restarted, regardless allocated to a non-DASD device or all WADS
of the allocation method of the data set. are not allocated to the same DASD device
type. For a batch environment, the log is
allocated to a tape device and a standard label
DFS2203I LOG INITIALIZATION is not specified.
FAILED-TRANSLATE ERROR.
NOT ENOUGH WADS OR OLDS
Explanation: Using a virtual control region, an error No WADS or less than three OLDS are
occurred translating virtual addresses to real addresses specified for an online IMS.
for the log work area.
LOG DATA SET REQUIRED
System action: IMS terminates abnormally. This is a batch job which declared that the
Problem determination: 36 database should be updated. Either no log DD
statement is present or the log DD statement
Related information:
specified a DD DUMMY data set and DBRC is
Chapter 2, “IMS problem determination,” on page 5 active.
LOG BLKSIZE INVALID (MIN yyyyy)
DFS2204I LOG INITIALIZATION FAILED-PAGE For an online IMS, either the log data set block
FIX ERROR. size is not in multiples of 2048 or the block
Explanation: Using a virtual control region, an error size is not large enough to handle the
occurred while page fixing the log work area. maximum log record created by IMS. yyyyy is
the minimum log block size required.
OLDSDEF STATEMENT MISSING failure. For all the other zzzz values, ensure the
An OLDSDEF statement was not found in following:
member DFSVSMxx of IMS.PROCLIB. The v All required log DD statements are present.
OLDS attributes are unavailable. v Log DD statements specify device and data set
attributes that meet IMS requirements.
OLDSDEF REQUIRED KEYWORD MISSING
v Sufficient virtual storage and all required load
The OLDS required keyword was missing on
modules are available.
the OLDSDEF statement. The initial OLDS IDs
are unavailable. Problem determination: 1, 3, 8, 11 35
WADSDEF STATEMENT MISSING Related information:
No WADSDEF statement was found in “DFS2206I”
member DFSVSMxx of IMS.PROCLIB. The
WADS attributes are unavailable. IMS abend 0070
For reason code 02, increase the size of the IMS control Explanation: DC monitoring is activated.
region. System action: The system continues processing as
before.
DFS2210I MONITOR TERMINATION
ERROR-REASON x {RC=yyyy} DFS2213I DC MONITOR STOPPED - (TIME
Explanation: A monitor encountered an error. The INTERVAL ELAPSED)
following reason codes and meanings apply: Explanation: DC monitoring is terminated. If the
Code Meaning command used to start the monitor included the
02 Logical logger FEOV failure. RC=yyyy is INTERVAL parameter, then Time Interval Elapsed is
displayed for reason code 02 only and contains included in the message to indicate that the system
the IMS logical logger return code. internally terminated monitoring when the time
elapsed.
System action: For all reason codes, IMS continues
processing, and the monitor is stopped. System action: The system continues processing.
DFS2211I LOG INITIALIZATION ERROR - zzzz. Explanation: Incompatible input data set or no records
on the data set.
Explanation: An error occurred during initialization of
the monitor log. One of the following phrases in System action: The system continues processing.
boldface type replaces the variable zzzz. An explanation Programmer response: Resubmit the job with the
follows each phrase. appropriate data set.
OLDSDEF SYNTAX ERROR, KEYWORD=xxxxxxxx
An invalid keyword, xxxxxxxx, was detected
on the OLDSDEF statement. DFS2215A MONITOR INACTIVE, MODIFY TO
OLDSDEF SYNTAX ERROR, INVALID START MONITOR.
PARAMETER=xxxxxxxx Explanation: The DB Monitor is inactive and is
An invalid keyword parameter, xxxxxxxx, was prompting for a command to start the monitor.
detected on the OLDSDEF statement.
WADSDEF SYNTAX ERROR, KEYWORD=xxxxxxxx System action: IMS continues, with the Monitor
An invalid keyword, xxxxxxxx, was detected inactive.
on the WADSDEF statement. Operator response: When the monitor is to be started,
WADSDEF SYNTAX ERROR, INVALID enter MODIFY jobname, START.
PARAMETER=xxxxxxxx
An invalid WADS subparameter, xxxxxxxx,
was detected on the WADSDEF statement.
System action: For OLDSDEF SYNTAX ERROR,
KEYWORD=xxxxxxxx, the invalid keyword is ignored
DFS2229E MAXIMUM NUMBER OF System action: The system will continue to process
STATEMENTS FOR URL ADDRESS the command. When the last resource is verified, the
EXCEEDED command will terminate.
DFS2240 TOO MANY MSNAME PARAMETERS. DFS2244 TOO MANY SYSID PARAMETERS.
Explanation: Too many MSNAME parameters were Explanation: You specified too many SYSID
entered for this command; only one can be entered. parameters for this command; only one can be
specified.
System action: The command is ignored.
System action: The command is ignored.
Operator response: Reenter the command with only
one MSNAME parameter. Operator response: Reenter the command with one
SYSID parameter.
System action: The command is not executed. System action: The command is not executed.
Operator response: Reenter the command, specifying Operator response: Reenter the command with only
a different MSNAME or remote SYSID. one link parameter.
System action: IMS continues normal execution. Operator response: The terminal can be restarted, as
appropriate, using the normal session initiation
Operator response: No action is required. procedure.
System programmer response: No action is required. System programmer response: This message is a
Module: DFSVTPO0 warning to the operator to look for some process that is
delaying checkpoint. If one is found, the operator
should take some action to ensure that checkpoint gets
completed quickly.
Module: DFSRCP00
DFS2290 INPUT MESSAGE CANNOT BE DFS2299A OPEN MNPS ACB WAS NOT
CREATED SINCE NO OUTPUT SUCCESSFUL REG15=xx
MESSAGE IN PROGRESS. ACBERFLG=yyy, REPLY RETRY OR
CANCEL
Explanation: An output message was not in progress
when input was entered from the first physical page of Explanation: After three attempts and still failing to
a DPAGE with multiple physical page input specified. open the MNPS ACB during an MNPS XRF takeover,
The output message was dequeued by a previous the alternate IMS system will issue the WTOR and
operator action: NXTMSG, or NXTMSGP. await a reply from the operator. xx is the OPEN return
code in register 15, and yyy is the ACB error field
System action: The input data is ignored.
returned by VTAM. These values are displayed as a
Operator response: Issue a /FOR command for the decimal number. With a reply of RETRY, the alternate
current format to create a multiple physical page input IMS will attempt another three times, if necessary, to
message, a /FOR command for a different format to open the ACB. With a reply of CANCEL, the alternate
create a single physical page input message, or clear system will stop attempting to open the ACB and
the screen and enter the data. resume the takeover process. Any reply other than
RETRY or CANCEL is invalid, and the WTOR will be
Problem determination: 16 re-issued.
Related information:
System action: IMS waits for a reply from the
Chapter 2, “IMS problem determination,” on page 5 operator.
Operator response: Correct the problem and reply to
DFS2296A INCORRECT INPUT LOG DD the WTOR.
SPECIFICATION
System programmer response: For a detailed
Explanation: One of the following occurred: explanation of the error codes, see z/OS Communications
v A DD DUMMY was specified for an input log. Server: SNA Messages, z/OS Communications Server: SNA
v Multiple DD statements were specified, but a correct Programming, and z/OS Communications Server IP and
ddname or order, or both was not specified. SNA Codes.
Explanation: xxx contained a character other than a System action: Processing terminates.
digit. Valid suffixes are 1 to 255.
Programmer response: Check that two or more valid
System action: Validation of input data is completed. suffixes were specified, that there are no embedded
No further processing occurs because the input data is blanks in the input data, and that column 1 is not
invalid. blank. Rerun the program.
Explanation: Input data aaaa contained more than System action: Processing terminates.
three digits.
Programmer response: See the information on the
System action: Validation of input data is completed. BLDL macro completion codes.
No further processing occurs because input data is Related reference:
invalid.
BLDL Completion Codes
Programmer response: Input data must be numeric,
from 1 to 255, and expressed as a 1 to 3-digit number.
DFS2310X MODULE-DFSMSaaa-NOT FOUND
DFS2306X aaa-IS NOT IN THE RANGE FROM 1 Explanation: The BLDL searched the directory and did
TO 255 not find module DFSMSaaa. aaa represents the variable
portion of the module name.
Explanation: Input data aaa was less than 1 or greater
System action: Verification processing continues. Within the total multiple systems configuration being
verified, sysid which is the 4-digit SYSID, has no local
Programmer response: See DFS2319I for SYSID aaa. SYSID defined, and is referenced by another system.
Related information: System action: Verification processing continues.
“DFS2319I”
Programmer response: Determine where the local
SYSID should be defined and define an MSNAME
accordingly, or do not see this SYSID in any system.
Rerun the program.
Problem determination: 1, 6, 10
DFS2335I DFSMSaaa SYSID sysid ccccc dddddddd
Related information: RETURN PATH TO DFSMSeee NOT
Chapter 2, “IMS problem determination,” on page 5 VERIFIED
Explanation:
DFS2332X SYSID sysid TRANS bbbbbbbb HAS
aaa is the processing system module suffix. sysid is the
INCOMPATIBLE ATTRIBUTES
4-digit return SYSID. ccccc is either TRANS or LTERM.
BETWEEN SYSTEMS
dddddddd is the TRANS/LTERM name. eee is the
Explanation: originating system module suffix. A previously
determined error condition caused this TRANS/LTERM
Variable sysid is the 4-digit remote SYSID referenced by return path not to be verified. A DFS2324X message is
transaction bbbbbbbb. This message will be followed by displayed for SYSID sysid.
two DFS2333I messages that display the attributes of
transactions in the two systems. System action: Verification processing continues.
System action: The transaction description message Programmer response: Correct the original problem
will be displayed for both systems; then verification referred to in DFS2324X. Rerun the program.
processing continues. Related information:
Programmer response: See the description for “DFS2324X” on page 478
DFS2333I.
Related information: DFS2336A INSUFFICIENT STORAGE TO
“DFS2333I” ACQUIRE SBPSS CONTROL BLOCK
Explanation: IMS was unable to acquire enough
DFS2333I DFSMSaaa bbbbbb,MSGTYPE=ccccccc, storage from the CSA (Common Storage Area) to build
INQUIRY=ddd,eeeeeee, fffffffff,ggggg the SBPSS, a control block used by Sequential Buffering
(SB) in an IMS online environment.
Explanation: In the message text:
aaa System module suffix. System action: The IMS online system can no longer
bbbbbb Either REMOTE or LOCAL. use Sequential Buffering.
ccccccc SNGLSEG or MULTSEG.
User response: Provide more virtual storage for IMS.
ddd YES or NO.
eeeeeee RECOVER or NORECOV.
fffffffff FPATH=YES or SPA=nnn, where nnn is the DFS2337A INSUFFICIENT STORAGE TO
SPA size. ACQUIRE PST EXTENSION FOR
ggggg The type of SPA—FIXED or BLANK. SEQUENTIAL BUFFERING
System action: Verification processing continues. Explanation: IMS was unable to acquire a PST
extension used for Sequential Buffering.
Programmer response: Determine which system has
the incorrect attributes and correct them. Rerun the System action: The IMS online system can no longer
program. use Sequential Buffering.
User response: For IMS DB/DC with LSO=N, allocate
DFS2334X DFSMSaaa SYSID sysid ccccc dddddddd more CSA storage; for IMS DB/DC with LSO¬=N, IMS
HAS NO RETURN PATH TO DFSMSeee batch, or DBCTL, allocate more private storage.
Explanation: eee is the system module suffix in which
ccccc (TRANS or LTERM), named dddddddd, has defined DFS2338I xxxxxxxx CAN NOT BE LOADED,
the 4-digit SYSID, sysid, as the return path. SYSID sysid RC=nn
is undefined, or is defined as a local.
Explanation: The IMODULE macro was unable to
System action: Verification processing continues. load module xxxxxxxx. For an explanation of
IMODULE return code nn, see the IMODULE return
Programmer response: Determine whether SYSID
code information.
sysid should be defined as remote in system DFSMSaaa
or if DFSMSeee (TRANS or LTERM dddddddd) defined System action: IMS cannot use Sequential Buffering.
the wrong SYSID for the return path. Correct the
User response: Correct the error based on the code
system, and rerun the program.
returned from the IMODULE macro.
Related reference:
System action: Processing continues using the original Explanation: The OTMA client task control block
XCF group. (TCB) is initialized and the OTMA client is ready for
processing.
Programmer response: Check the /START OTMA
command and reissue if necessary. There is one OIM TCB for each TMEMBER. As the
OTMA workload requires, new TCBs can be initialized
Module: DFSYJL00 during an IMS session. Each time this process happens,
this message is issued.
DFS2363I XCF GROUP CANNOT BE JOINED. System action: Processing continues.
NOT APF AUTHORIZED.
Module: DFSYIM00
Explanation: IMS was not APF-authorized and
therefore was notable to join the OTMA XCF group.
DFS2370I INVALID RETURN CODE rc FROM
System action: Processing continues with OTMA USER EXIT exitname
disabled.
Explanation: A user exit routine returned an invalid
System programmer response: Ensure IMS is return code.
APF-authorized.
In the message text:
Module: DFSYJL00 rc The 2-byte return code.
exitname
DFS2375W IMS HAS CHANGED ITS OTMA
The 8-byte user exit routine name. The routine
MEMBER NAME FROM oldname TO
is usually DFSYPRX0 or DFSYDRU0.
newname.
Programmer response: Correct the exit routine.
Explanation: During a warm or emergency restart,
Module: DFSYFND0 IMS was connecting to an OTMA client newname which
is different than the client name oldname contained in
restart log records.
DFS2371I OTMA DRU OVERRIDE LIMIT
REACHED Programmer response: Ensure that the client name
newname is known to all OTMA clients that connect to
Explanation: The override limit was reached for a IMS.
DFSYDRU0 exit routine, and the routine attempted to
specify a new client to which to route messages. Only Module: DFSYRST0
one DFSYDRU0 exit can specify a new client.
Programmer response: Correct the DFSYDRU0 exit DFS2376W IMS OTMA MEMBER NAME name IS
routine, especially the client override logic. THE SAME AS A PREVIOUSLY
ACTIVE CLIENT.
Module: DFSYFND0
Explanation: During a warm or emergency restart, the
IMS OTMA client name name was the same as that of
DFS2372I INVALID MEMBER NAME SET BY an existing OTMA client. That client is no longer able
DFSYPRX0 to connect to IMS.
Explanation: A DFSYPRX0 user exit routine specified Programmer response: Ensure that the IMS OTMA
an OTMA transaction, but did not specify an OTMA client name name is correct.
client name. This message is issued only when the
transaction is entered from a non-OTMA source. Module: DFSYRST0
Explanation: During a warm or emergency restart, System action: The utility processing terminates.
IMS was joining the XCF group newname for OTMA
System programmer response: Correct the error in
processing. However, this group is different from the
SYSIN control statement and rerun the utility.
group name oldname contained in restart log records.
Module: DFSMAID1
Programmer response: Ensure that the group name
newname specified in the startup procedure is correct.
DFS2379A A single ' found in a character string.
Module: DFSYRST0
Explanation: The SYSIN control statement of the
HALDB Migration Aid utility (DFSMAID0) had a
single quotation mark within the character string of
KR= field; for example, KR=C'ZZZ'ZZ' instead of
KR=C'ZZZZZZ'.
System action: The utility processing terminates.
System programmer response: Remove the single System action: The utility terminates with RC = 103.
quote in the character string and rerun the utility.
System programmer response: Add SAMPLE=xxx in
Module: DFSMAID1 the SYSIN control statement and rerun the utility.
Module: DFSMAID0
DFS2380A Unsorted keys in SYSIN.
Explanation: The SYSIN control statement of the DFS2384E THE NUMBER OF DESCRIPTORS
HALDB Migration Aid utility (DFSMAID0) contained DEFINED IN MEMBER member
key ranges that are not in ascending order. EXCEEDS THE MAXIMUM.
For example, the user coded KR=C'J00400' followed by Explanation: An OTMA server cannot have more than
KR=C'J00200'. 255 descriptors.
System action: The utility processing terminates. Programmer response: Decrease the number of
descriptors specified.
System programmer response: List the key range
fields in ascending order and rerun the utility. Module: DFSYIDC0
Module: DFSMAID1
DFS2384W THE NUMBER OF OTMA TYPE t
DESCRIPTORS IN MEMBER member
DFS2381A CTDLI ('GSCD') returned status xx.
HAS REACHED THE MAXIMUM OF
Explanation: The C Language program to DLI macro nnn
with GSCD system service call returned a status code
of xx. | or
System action: The utility processing terminates.
| THE NUMBER OF OTMA TYPE t DESCRIPTORS
System programmer response: See an explanation of | HAS REACHED THE MAXIMUM OF nnn
the xx status code received. If the problem persists, call
Explanation: The number of OTMA type-t descriptors
IBM Software Support.
that are defined in the OTMA DFSYDTx PROCLIB
Module: DFSMAID1 member has reached the maximum allowable number
Related reference: for type-t descriptors.
t The descriptor type, either D or M.
EXEC DLI commands (Application Programming
Type D descriptors are OTMA destination
APIs)
descriptors. Type M descriptors are OTMA
client descriptors.
| DFS2382I THE NUMBER OF OTMA TYPE D member The name of the OTMA DFSYDTx member in
| DESCRIPTORS IS NOW BELOW THE the IMS.PROCLIB data set that contains the
| MAXIMUM OF nnn descriptors.
| nnn The maximum allowable number of
| Explanation: The number of OTMA destination (type
| descriptors for the descriptor type identified
| D) descriptors was at the maximum value, but it is
| by t. You can specify a maximum of 255 for
| now less than the maximum.
| either type.
| In the message text,
| The second form of the message is displayed when the
| nnn The maximum number of allowable OTMA
| maximum value is reached as a result of adding
| destination descriptors is 255.
| descriptors by using the CREATE OTMADESC
| Programmer response: OTMA destination (type D) | command.
| descriptors can once again be added by the CREATE
| Programmer response: No more descriptors of the
| OTMADESC command.
| listed type can be added to the member or added with
| Module: DFSYCMR0 | a CREATE OTMADESC command unless one or more
| existing descriptors are deleted. Alternatively, existing
| descriptor definitions can be changed to refer to new
DFS2383E ENCOUNTERED DATABASE | clients or destinations.
RECORDS LARGER THAN 16M.
PLEASE USE SAMPLING AND RERUN | Module: DFSYIDC0, DFSYCMR0
THE UTILITY.
Explanation: The HALDB Migration Aid Utility
(DFSMAID0) encountered database records larger than
16 MB. Sampling should be used.
DFS2385E SYNTAX ERROR FOR DESCRIPTOR = DFS2388X UNABLE TO OPEN SYSIN DATA SET
descriptor errortext
Explanation: An OPEN error occurred while
Explanation: An OTMA descriptor parsing error has attempting to open the SYSIN data set.
occurred. For more information, see the DFS1956E
System action: The Multiple Systems Verification
message for LU 6.2 descriptor parsing errors. descriptor
utility is terminated.
is the 16 byte descriptor name. errortext is one of the
following values: Programmer response: Check the SYSIN DD
v DRU COULD NOT BE LOADED statement. Correct the OPEN failure, and rerun the job.
v DRU MUST BE 1 TO 8 CHARACTERS LONG
v DUPLICATE DESCRIPTOR NAME FOUND
v DUPLICATE DRU KEYWORD DFS2389I XCF SEND RC=xxxxxxxx
v DUPLICATE SYNTIMER KEYWORD REASON=yyyyyyyy,
v ILLEGAL KEYWORD Explanation: OTMA called MVS/XCF IXCMSGO to
v INVALID MEMBER NAME issue a send, but the send failed.
v MEMBER NAME LONGER THAN 16 CHAR
v MEMBER NAME NOT GIVEN OR BEGINS AFTER Programmer response: Check the meaning of the
COLUMN 3 return and reason codes.
v NO PARAMETER GIVEN FOR THIS KEYWORD Problem determination: 5
v NON-NUMERIC CHARACTERS WERE FOUND IN
THE SYNTIMER PARAMETER Module: DFSYSND0
v SECOND COLUMN MUST BE BLANK Related reference:
v SYNTIMER MUST BE 1 TO 6 CHARACTERS LONG
v UNRECOGNIZED CHARACTERS FOUND DURING IXCMSGO Return and Reason Codes
KEYWORD SEARCH Related information:
Programmer response: Correct the problem. Chapter 2, “IMS problem determination,” on page 5
Module: DFSYIDC0
DFS2390I FP TRAN tttttttt SEND FAIL.
Related information:
TPIPE=pppppppp
“DFS1965E” on page 404 Member=mmmmmmmmmmmmmmmm
MSG:xxxxxxxx
DFS2386I OTMA IS CONNECTING TO THE Explanation: An application program send failed or
MEMBER xxxxxxxxxxxxxx received a NACK message from the OTMA client
Explanation: IMS OTMA has received a connection during the processing of transaction tttttttt. MSG
request from a member with the XCF member name xxxxxxxx contains up to 40 characters of the output
xxxxxxxxxxxxxx. message being processed.
This message appears only on the IMS master terminal. System action: The output transaction identified by
this message is deleted from the IMS system.
System action: OTMA makes the connection by
initializing the OTMA member blocks with the Programmer response: Correct the cause of failed
connection requests and sends a confirmation message send or the NACK message from the client.
(ACK) to the OTMA member. Problem determination: 5
Programmer response: IMS automated operator Module: DFSYSLM0
interface (AOI) exits can detect this message to identify
Related information:
whether a particular member has connected to IMS
OTMA. Chapter 2, “IMS problem determination,” on page 5
Module: DFSYMOM0
DFS2391I MESSAGE DEQUEUE FAILED
DURING RESYNCH FOR TMEMBER =
DFS2387X UNABLE TO OPEN SYSOUT DATA xxxxxxxxxxxxxxxx TPIPE = xxxxxxxx
SETS
Explanation: An IMS queue manager dequeue call
Explanation: An OPEN error occurred while that was issued during resynchronization failed.
attempting to open the SYSOUT data set.
System action: The NACK X'0026' message is
System action: The Multiple Systems Verification generated and resynchronization for the Tpipe is
utility is terminated. stopped.
Programmer response: Correct the OPEN failure, and Programmer response: Contact the IBM Software
rerun the job. Support for assistance in determining the problem.
Explanation: The IMS queue manager calls that were Programmer response: No action is required.
'SA - EP ADDRESS'
DFS2400I ERROR WHILE ATTEMPTING TO
'SAP'
FORMAT THE ccc...ccc
'ECB PREFIX'
Explanation: During memory dump formatting, an 'SAVE AREA'
error was encountered while attempting to format a 'REGISTER AREA'
control block or data area. Field ccc...ccc, which can be 'SA - INV FWD PTR'
up to 16 bytes in length, identifies the control block or 'QUEUE BUFFERS'
data area being formatted. 'UEHB'
'LATCH LIST'
In an online environment, memory dump storage is in
'ECB STORAGE'
the IMS memory dump Formatter.
'XMCI BLOCK'
Users of the memory dump formatter should be aware 'USE LIST (CULE)'
that the original cause of the abnormal termination of
User response: Despite the failure of the IMS memory
IMS might cause the memory dump formatter to
dump Formatter, the output might still provide enough
program check.
information to help you diagnose your original
Some of the common failures of the memory dump problem. If the memory dump formatter output does
formatter are: not provide enough information, contact the IMS
v Invalid use of save areas and their linkages. The system programmer.
memory dump formatter assumes that register 13
Programmer response: Use the diagnostic memory
always points to a save area. The forward and
dump to determine the cause of the problem. If the
backward pointers in the save area are valid. BALR
diagnostic memory dump is suppressed, contact the
14,15 is used as standard calling convention.
IMS system programmer.
v Invalid IMS control block addresses. The memory
dump formatter assumes that all addresses pointing
to control blocks are valid. The memory dump
formatter does not validate addresses.
v Invalid IMS control block contents. The memory
dump formatter assumes that all IMS control block
contents are valid.
System action: For most errors, a diagnostic memory
dump immediately follows this message. This
diagnostic memory dump consists of the following:
v The contents of SDWA, which includes the PSW,
completion code, module ID, registers, and a
memory dump of the SDWA area.
v Instruction area, which includes 128 bytes of data
before and after the failing instruction (total of 256
bytes).
v Communications area, which is the control block
used by the IMS memory dump Formatter for
intercommunication between the formatting modules.
v Save area, which is a memory dump of the save area
set used by the memory dump formatter.
v The memory dump formatter module vector table.
v Dump formatter storage buffer header and prefixes
(offline formatting only).
v Dump option request block storage (offline
formatting only).
Related information:
DFS2401I UNABLE TO OPEN IMSUDUMP DATA
SET Chapter 2, “IMS problem determination,” on page 5
System action: The STAE exit routine continues with Explanation: IMS OTMA detected that both the CM0
its processing; however, no formatted memory dump is output option, TMAMPCM0, and the CM0 output
provided. reroute option, TMAMHRRQ, are specified in the
OTMA message prefix.
Programmer response: Make sure that the
IMSUDUMP DD statement was specified correctly. System action: Neither the CM0 output purge nor the
CM0 output reroute for the OTMA output message is
performed. IMS OTMA take the default action to store
DFS2402I jobname, stepname, unit addr, device type, the output onto the asynchronous message hold queue
ddname, op code, error description of the inputting TPIPE.
Explanation: The Formatted Dump facility attempted Programmer response: Have the client of IMS OTMA
to write to the IMSUDUMP data set and an I/O error examine the OTMA message prefix sent to IMS. Only
occurred. one of the TMAMPCM0 or TMAMHRRQ options can
System action: Formatted memory dump processing be set in the OTMA state data prefix.
is discontinued. Module: DFSYPSI0, DFSYQAB0
Problem determination: Determine the error condition
from the message text. DFS2408I UNABLE TO LOAD/LCT/FIX OSAM
DRIVER/APPENDAGE OSAM INIT
DFS2403I DYNAMIC UNALLOCATE RC=rc FAILED FUNC REQ=xx R/C=yyyy
ERROR Explanation: The OSAM I/O driver module
(DFSAOS70) was not able to be loaded or located, or
or the entry point was incorrect. For an explanation of the
FUNC REQ=xx and R/C=yyyy values, see message
DYNAMIC ALLOCATE INFORMATION CODE=xxxx DFS2411I.
Explanation: IMS issued an ALLOCATE or System action: Initialization terminates with abend
UNALLOCATE command for a SYSABEND or 0071 and register 15 contains return code 8.
SYSUDUMP data set. Either a nonzero return code or a
nonzero information code was returned by SVC 99. Programmer response: Make sure the DFSAOS70
module is in SDFSRESL with an entry point of
If RC=04, Error Code=0254 is returned by SVC 99, you DFSAOS70; then restart IMS.
requested conditional ENQUEUE on a resource that is
currently unavailable. One reason for getting this return Problem determination: 1, 2, 8, 10
and error code would be issuing an IMS MODIFY Related information:
command while a mount for a log is pending. “DFS2411I” on page 492
System action: IMS continues execution (it might be IMS Abend 0071
in abnormal termination processing).
Chapter 2, “IMS problem determination,” on page 5
Programmer response: Contact the z/OS system
programmer.
DFS2409I CANNOT OBTAIN FIX LISTS - OSAM
Problem determination: 1, 4, 36 INIT FAILED FUNC REQ=xx R/C=yyyy
Related reference: Explanation: An attempt to allocate storage for OSAM
Interpreting Error Reason Codes from DYNALLOC I/O initialization failed. For an explanation of FUNC
REQ=xx and R/C=yyyy values, see message DFS2411I.
System action: Initialization is terminated with abend 09 An attempt was made to format an invalid
0071. Register 15 contains return code 12. I/O pool. R/C=yyyy does not apply; abend
0723 is issued.
Programmer response: Increase the IMS control region
10 Unable to page fix I/O pool. R/C=yyyy is the
REGION size, and restart IMS.
IMSAUTH return code.
Related information:
System action: Initialization processing terminates
DFS2411I
with abend 0071, and IMODULE services places a
IMS abend 0071 return code in register 15.
Operator response: Increase CSA size, if applicable.
DFS2410I DATA TRANSLATION EXCEPTION Programmer response: Increase the region size; then
OCCURRED-OSAM INIT FAILED restart IMS.
FUNC REQ=xx R/C=yyyy
Related reference:
Explanation: An attempt to translate fixed virtual
storage addresses resulted in an error. For an IMODULE return codes (Messages and Codes)
explanation of FUNC REQ=xx R/C=yyyy values, see Related information:
message DFS2411I.
IMS abend 0071
System action: Initialization terminates with abend
0071. Register 15 contains return code 16.
DFS2412I INSUFFICIENT STORAGE TO OBTAIN
Problem determination: 1, 4, 8, 35 OSAM BUFFER INITIALIZATION
Related information: WORK AREA-OSAM INITIALIZATION
DFS2411I FAILED
Explanation: IMODULE GETMAIN failed for the
IMS abend 0071
work area space. Initialization of OSAM buffer pools
Chapter 2, “IMS problem determination,” on page 5 cannot continue.
System action: IMS terminates abnormally.
DFS2411I CANNOT OBTAIN IOB/IOSB-IOMA
POOL-OSAM INIT FAILED FUNC Operator response: Contact the system programmer.
REQ=xx R/C=yyyy Programmer response: Ensure that sufficient virtual
Explanation: An attempt to allocate storage for the storage exists so that GETMAIN succeeds.
OSAM I/O pool was not successful. In an online Problem determination: 1, 2, 4, 8
environment, the storage is requested from CSA. In a
Related information:
batch environment, the storage is requested from either
CSA or private storage. FUNC REQ=xx and R/C=yyyy Chapter 2, “IMS problem determination,” on page 5
codes are described below. When R/C=yyyy is either an
IMODULE or an IMSAUTH return code, see the DFS2413I WARNING - OSAM SUBPOOL
IMODULE return code information for an explanation DEFINITION LIMIT HAS BEEN
of these codes. EXCEEDED
xx Description Explanation:
01 I/O pool blocks not on doubleword boundary.
R/C=yyyy does not apply; abend 0723 is The maximum number of OSAM subpools was
issued. exceeded; 250 uniquely defined subpools are allowed.
02 Unable to locate OSAM I/O module Any IOBF statements, found after the limit has been
(DFSAOS70). R/C=yyyy is the IMODULE reached, are ignored.
return code.
System action: The initialization of IMS continues.
03 Entry point of OSAM I/O module is invalid.
R/C=4 Programmer response: Combine or eliminate the
04 Unable to obtain storage. R/C=yyyy is the OSAM subpool definition statements that exceed the
IMODULE return code. limit.
05 Unable to page fix OSAM I/O module
Problem determination: 1, 2, 27
(DFSAOS70). R/C=yyyy is the IMSAUTH
return code. Related information:
06 Unable to obtain storage for I/O pool. Chapter 2, “IMS problem determination,” on page 5
R/C=yyyy is the IMODULE return code.
07 Unable to release storage. R/C=yyyy is the
IMODULE return code.
08 Real address translation failure. R/C=4
4. The source segment for the named segment does Problem determination: 18, 19
not define a logical parent. Related information:
System action: The system issues abend 0991 if batch
IMS abend 0994
DL/I was being run. ACBGEN processing continues.
Chapter 2, “IMS problem determination,” on page 5
Programmer response: Correct the SOURCE=
specification or the physical DBDs involved.
DFS2434I SEGM-segname-IN DBD-dbdname-IN
Related information:
PSB-psbname-NOT SENSITIVE TO KEY
IMS abend 0991 FIELD
Explanation: Load or insert sensitivity was specified
DFS2431I DBD1 dbdname1 REFERENCES DBD2 for the segment in the PSB, but sensitivity to the
dbdname2 AS AN INDEX INVALIDLY sequence field was not specified.
Explanation: A DBD was referenced in an LCHILD System action: Abend 0995 is issued if batch DL/I
statement in another DBD as an index DBD. The was being run. ACBGEN processing continues.
referenced DBD was not coded as ACCESS=INDEX, Programmer response: Correct the PSB, and rerun the
and the reference is therefore invalid. job.
System action: The system issues abend 0992 if batch Problem determination: 18, 19
DL/I was being run. ACBGEN processing continues.
Related information:
Programmer response: Correct the DBDs, and rerun
the job. IMS abend 0995
Related information: Chapter 2, “IMS problem determination,” on page 5
Module: DBFUCDB0
DFS2446I DATA SPACE NOT ACQUIRED.
VIRTUAL STORAGE OPTION NOT
DFS2443I UNABLE TO OBTAIN VSO CONTROL ACTIVATED. rr
BLOCK
Explanation: An error occurred while trying to obtain
Explanation: During area open or system a data space during control region initialization. rr is
initialization, a request for a VSO control block failed. the reason code.
System action: The data space is not obtained. IMS Reason code
system initialization continues without VSO. Area open Description
fails.
35 VSO control block failure; see message
System programmer response: Re-submit job when DFS2443I
ECSA use is lower. See message DFS3702I.
37 DSPSERV request for the data space failed; see
Module: DBFVIDS0 message DFS2444I
Related information:
Explanation: This message is issued during local Operator response: If the area is marked recovery
emergency restart, by an XRF alternate system during needed, use the Database Recovery utility.
tracking or takeover, or by a Fast Database Recovery Module: DBFNRST0
region if the system is unable to obtain storage that is
Related reference:
needed to process log records for area aaaaaaaa, which
is defined as VSO. Emergency restart, the XRF alternate DSPSERV - Create, Delete, and Control Data Spaces
system, or the Fast Database Recovery region might not
be able to recover the area after a failure without the
storage. If this occurs, the area is stopped and marked DSPSERV Return and Reason Codes
“recovery needed”.
System action: Restart continues normally, except for DFS2450I UNABLE TO ACQUIRE STORAGE
area aaaaaaaa. If, at the end of restart log processing, the FOR ENQ/DEQ BLOCKS, REASON=n
area has CIs that require REDO processing (that is,
Explanation: Module DFSFXC10 was unable to
updated CIs that might not have been written to DASD
acquire a block of storage for queuing control blocks.
prior to the failure), the area is stopped and marked
The reason codes n provide further details:
“recovery needed”.
Code (dec)
Operator response: If the area becomes “recovery
Meaning
needed”, use the Database Recovery utility.
0 A block was requested that is not the first
Module: DBFVSOP0 block. The amount of storage that was
specified by the PIMAX parameter has not
been exhausted, but a GETMAIN for another
block of storage was unsuccessful. If the
failure was on an attempt to acquire the last
block, this message is accompanied by
message DFS2451W.
defined as VSO and PRELOAD, Fast Path was unable to SHTD an IMS shut down
begin loading the area into a data space because HSSP
System action: The preload process terminates
or a utility is currently active on the area.
without completing.
For the fourth form of this message, IMAGE COPY ITASK
Operator response: A possible real storage shortage
STARTED|COMPLETED|ABORTED FOR: aaaaaaaa, either
problem has occurred. After the real storage problem is
HSSP or another process dynamically created the image
resolved, issue the /START AREA or UPDATE AREA
copy ITASK for area aaaaaaaa. The image copy ITASK
START(ACCESS) command to have the preload process
issues this message when it starts, completes, or aborts.
initiate.
For the IMAGE COPY ITASK ABORTED form of the message,
Module: DBFVSPL0
one of the following strings is appended:
v IMS SHUTDOWN means IMS is being shut down.
v IMAGE COPY ERR means that an error occurred during DFS2455A CANNOT RUN COMPARE UTILITY
image copy that caused the termination of the image FOR AREA IN VIRTUAL STORAGE,
copy and the ITASK. AREA=aaaaaaaa
v ABORT AT INIT means that an error occurred during
the initialization of the image copy data set, and Explanation: The DEDB ADS Compare utility was
image copy is not possible. See message DFS0531I or requested for an area that is currently in virtual
the relevant DBRC messages. storage.
System action: The utility request fails with return
The sixth form of the message reports the status of code 12 and message DFS2662A is issued.
preload processing for area aaaaaaa. Status xxxxxxxx can
be STARTED, ABORTED, or COMPLETED. STR1 and STR2 are Operator response: Issue the /VUNLOAD command
the z/OS cross-systems extended services (XES) to remove the area from virtual storage and resubmit
structure names. the utility job. The area can be returned to virtual
storage after the utility has completed by issuing the
System action: Processing continues. /START AREA or UPDATE AREA START(ACCESS)
command.
For the third form of this message, the preload process
is aborted. Module: DBFUMRT0
For the fourth and sixth forms of this message, the
action indicated was taken. DFS2456I AREA aaaaaaaa UNEXPECTED
POINTER VALUE DURING VSO
Operator response: For the third form of this message,
CLOSE
reissue the /START AREA or UPDATE AREA
START(ACCESS) command when HSSP or the utility Explanation: A non-catastrophic internal logic error
has completed. has occurred. During close of VSO area aaaaaaaa, a
control block was found to contain a bad pointer value
For the fourth form of this message, no action is
and it was necessary to bypass the code that would
required.
have deallocated the portion of a data space that was
For the sixth form of the message, if the preload allocated for the area. Bypassing the deallocation is not
process for an area aborted, correct the reason for the a problem for data integrity. It is possible, however,
failure. Then issue a /START AREA or UPDATE AREA that part of a data space might be unusable until the
START(ACCESS) command to start the preload process next restart. If the data space deallocation is skipped,
again. the /DIS FPV command might show the area as being
in a data space even after it is closed.
Module: DBFVSPL0, DBFPTIC0, DBFVXPL0
Related information: System action: Area close processing is allowed to
continue.
“DFS0531I” on page 127
Operator response: Call IBM Software Support.
DFS2454I PRELOAD SEVERE ERROR FOR: Module: DBFVSCL0
aaaaaaaa RC=rc
Explanation: Fast Path has begun the process of DFS2457I DUE TO A STORAGE SHORTAGE,
loading an area, which is defined with the VSO and NOT ALL AREAS WILL BE
PRELOAD options, into a data space. The return code rc PREOPENED OR PRELOADED, RETRY
indicates the reason for the error message. LATER
PIN an error while attempting to page fix storage
Explanation: During preopen or preload setup, there
in the data space
was a storage shortage and the preopen or preload
LOCK an error has occurred in trying to obtain a
processing was not attempted.
UOW lock
The second form of this message is produced when DFS2469W TRANSACTION REJECTED reason
IMS is attempting to build in-storage profiles for RACF Explanation: This message is sent to the terminal
defined resources, and a failure occurs in the entering a transaction when RACF determines that the
RACROUTE, RACLIST, or ROUTER EXIT processing. transaction failed security checking. The reasons for the
The class of the failing resource is specified, and the transaction rejection are:
return code from the RACROUTE routine is also given.
The return code and reason code (if applicable) from TRANS NOT AUTH; RC=08
RACF or the ROUTER EXIT is also given. User is not authorized to this transaction code
by RACF.
System action: With the first form of the message,
IMS restart continues. SIGNON REQUIRED
Transaction is RACF-protected and the user is
With the second form of the message, IMS restart not signed on.
continues, and the RACF authorization function for
transactions, commands, PSBs, or LTERMS is disabled. RACF NOT ACTIVE; RC=12
Programmer response: No action is required. Programmer response: Save the log record
information for debug.
Problem determination: None.
Problem determination: 36
Module: DFSCIOB0, DFSICIO0, DFSICLE0
Related information:
Chapter 2, “IMS problem determination,” on page 5
DFS2470 /SIGN COMMAND REQUIRED
Explanation: This message is sent to the terminal
| DFS2473I ERROR; RPLREQ=xx, R0=xx,
entering a transaction or /RELEASE command when
| R15=xx,NODE nodename,CLSDST
no previous valid sign-on has been done.
| SCHED
System action: The transaction or /RELEASE
| Explanation: One of the following conditions exists:
command is ignored.
| 1. IMS issued the VTAM EXECRPL macro and
Operator response: (local/remote terminal operator) | received an unrecognized return code from VTAM
Enter a valid sign-on, and then enter the transaction or | 2. A VTAM request (using EXECRPL) failed 25 times
/RELEASE command. | because VTAM is short on storage. IMS attempts to
| CLSDST the node. R0 is X'08' and R15 is X'04'.
Problem determination: None. | 3. VTAM rejects the SEND request (RPLREQ= 22)
| because the session has already terminated. R0 is
DFS2471 DUPLICATE CONTROL CARD OR | X'14' and R15 is X'04'. This message is issued
KEYWORD FOR DLITRACE | instead of DFS970I when VTAM drives NSEXIT or
| LOSTERM after IMS has started output message
Explanation: While processing the DLITRACE control | processing.
statement, one of the following conditions occurred:
v More than one DLITRACE control statement in the | RPLREQ code and the other codes are in hexadecimal.
input stream.
v A keyword was used more than once in the control | System action: The node is either closed or
statement. | deactivated. If the node is deactivated, DFS2101I is
| displayed at the master terminal. An IMS log record
System action: | (X'67') with an ID of AER2 containing pertinent
v The DL/I CALL TRACE options used were the ones | information was produced.
set by the first DLITRACE control statement in the
input stream. | Programmer response: The contents of the message
v The value specified by the first keyword encountered | aid in determining which of the problem conditions has
is the one set for DL/I CALL TRACE. Subsequent | occurred.
use of the keyword is overlooked.
| Problem determination: 36
Programmer response: Ensure that the DL/I CALL | Related information:
TRACE options used were the correct options, and
| “DFS970I” on page 244
ensure that duplicate parameters are removed.
| “DFS2101I” on page 439
| Chapter 2, “IMS problem determination,” on page 5
DFS2472 INVALID AWE DETECTED AND
LOGGED
DFS2474I RECEIVE ANYS EXHAUSTED, REG
Explanation: An invalid asynchronous work element
0=xx, CLOSING VTAM ACB
(AWE) was detected by the processing IMS module. An
invalid element might mean conflicting parameters, Explanation: IMS cannot receive data from the
missing addresses, or a number of other things. It is network due to VTAM being short on storage. Every
entirely dependent upon the requirements for the issuance of the VTAM RECEIVE macro has resulted in
processor. This message is accompanied by an X'67' FB the short on storage return code.
log record on the IMS log data set. The log record
System action: Since IMS can no longer communicate
indicates which of the processors detected the invalid
with its VTAM network, it causes an orderly shutdown
AWE. This message indicates a possible IMS or exit
of the VTAM network.
routine logic error.
Operator response: (master terminal) Restart the
System action: This message is issued and the X'67'
VTAM network with the /START DC command.
FB log record containing the invalid AWE and optional
processor work areas are logged. The log record is Programmer response: Increase the size of the
intended for debug purposes. appropriate VTAM buffer pool.
Operator response: Notify the system programmer Problem determination: Determine the VTAM buffer
about the receipt of this message. pool that is running short on storage, and enlarge it.
DFS2478I MIGRATED RESOURCE xxxxxxxx HAS DFS2482I DBRC LOG xxxx EXIT FAILED (yy)
BEEN RECALLED
Explanation: A DBRC request submitted by the IMS
Explanation: A recall for either database name or area logger was unsuccessful. The specific type of DBRC
name, as designated by xxxxxxxx, has finished. exit invoked is indicated by xxxx. The value of xxxx can
System action: The system issues an internal /START be one of the following:
DB or /START AREA command to allocate the OPEN
resource. CLOSE
SWITCH
STATUS
DFS2479W ISAM ACCESS METHOD IS NO ARCHIVE
LONGER SUPPORTED. DBD-dbdname EOV
MUST BE CORRECTED FOR IT TO BE SYNAD
USABLE LOGREC
Explanation: The database listed in this message
When xxxx indicates EOV or SYNAD, either a return number n of times the error condition described in
code of X'00' or X'04' indicates it was successful, or a DFS2458A occurred.
return code of X'12' indicates that it was unsuccessful.
System action: None.
The DBRC return code is displayed as yy (hexadecimal) Operator response: No action is required.
in the message. See the DBRC request return code
Module: DBFERST0
information.
Related information:
System action: When the ARCHIVE exit fails, IMS
“DFS2458A” on page 503
issues this message and continues execution. An error
return code from any of the other DBRC exits results in
IMS issuing abend 0071. DFS2486I FP ERE TOTAL VSO LOG ERRORS = n
Programmer response: An analysis is required to Explanation: This message is preceded by one to three
determine the reason for the DBRC exit failure. See the instances of message DFS2489I and shows the total
z/OS master console (SYSLOG) for DSP messages that number n of times the error condition described in
might explain the cause of the condition. DFS2458A occurred.
If this problem is an archive exit failure, determine if System action: None.
an emergency restart (/ERE) was issued after a normal
IMS shutdown. If it was, the automatic archive job Operator response: No action is required.
submitted by the emergency restart processing will fail, Module: DBFERST0
and you can ignore this message.
Related information:
Problem determination: 1, 3, 8, 11, 35 “DFS2458A” on page 503
Related reference: “DFS2489I” on page 508
DBRC request return codes (Messages and Codes)
Related information: DFS2487I UNABLE TO COMPLETE REDO
DURING XRF TKO - AREA aaaaaaaa-
IMS abend 0071 RSN cccc
Chapter 2, “IMS problem determination,” on page 5 Explanation: During XRF takeover, DEDB REDO
processing includes the following:
DFS2483A DBRC INITIALIZATION ERROR v Refreshing the second CI for all block-level shared
areas to pick up the changes from the sharing
Explanation: An INIT call was made to the database subsystem that might not have been sent to the
recovery control (DBRC) module DSPFLT00. The return restarting subsystem.
code was 12, indicating a serious error condition in the v Notifying the sharing subsystem if utility or HSSP
exit. cleanup was done during takeover.
System action: The IMS control region terminates
abnormally. This message indicates that REDO processing was
unable to perform these tasks for area aaaaaaaa. cccc
identifies the reason and can be one of the following
DFS2484I JOBNAME=nnnnnnnn GENERATED BY values:
LOG AUTOMATIC ARCHIVING ER2L REDO was unable to obtain the lock needed.
Explanation: Automatic log archiving is active. DBRC ER2R REDO was unable to refresh successfully the
has generated a JCL for an execution of the Log second CI.
Archive utility. nnnnnnnn is the name of the job ER2U REDO was unable to notify successfully the
generated by DBRC. sharing subsystem that utility or HSSP cleanup
was done during takeover. This condition can
System action: IMS continues processing. be caused by either an I/O error or by a
problem with the notify process.
Operator response: If the log archive job is to run
concurrently with the online IMS system, ensure that a
z/OS initiator is available to process the log archive At the time this message is issued, area aaaaaaaa has
job. successfully completed all other REDO processing. The
problem indicated in the message might be resolved by
closing the area and allowing it to go through normal
DFS2485I FP ERE TOTAL ALTERATION COUNT area open processing when it is next accessed.
ERRORS = n Therefore, it is not necessary to mark the area as
“recovery needed” and, except in the case of a notify
Explanation: This message is preceded by one to three
error, it is not necessary to prohibit the sharing
instances of message DFS2458A and shows the total
subsystem from accessing the area.
System action: If an error occurred while notifying a terminate IMS, the information has the same format as
sharing subsystem, the sharing subsystem is notified to output from abend 1026.
stop the area. The area is closed on the restarting
This message and the accompanying diagnostic
subsystem and message DFS3705I is issued. If the error
information are issued a maximum of three times.
recurs when the area is next opened, the area is
Message DFS2686I is issued at the end of emergency
stopped and marked “recovery needed”.
restart and shows the total number of times the error
System programmer response: If REDO processing condition was detected.
was unable to complete utility or HSSP cleanup, the
System action: Restart continues.
area must be reopened on the restarting subsystem (or
stopped, started and reopened on the sharing System programmer response: During local
subsystem) before a utility or HSSP can be started for emergency restart of XRF takeover, no action is
the area. required. If the problem occurs during XRF tracking,
restart the XRF alternate to relieve resource shortage
Module: DBFERS20
and performance degradation.
Related information:
Problem determination: 1, 5, 11, and a memory dump
“DFS3705I” on page 748
of the restarted system after restart finishes.
Module: DBFERSY0
DFS2488A VSO AREA aaaaaaaa- ERE SEVERE
ERROR Related information:
Explanation: Restart log processing was unable to 1026 (Messages and Codes)
obtain storage necessary to track updates made to area Chapter 2, “IMS problem determination,” on page 5
aaaaaaaa, which is defined as a Virtual Storage Option
(VSO) area.
DFS2490A UNLOCK SYSTEM COMMAND
System action: Area aaaaaaaa is stopped and marked REQUIRED BEFORE SHUTDOWN.
“recovery needed”.
Explanation: Following an XRF takeover, either the
System programmer response: Use the Database IMS /UNLOCK SYSTEM command or the z/OS
Recovery utility to recover the area. Availability Manager (AVM) UNLOCK command must
Module: DBFERSY1 be entered to purge I/O tolerated data before IMS can
be shut down.
DFS2489I ERE VSO LOG RECORD ERROR System action: Shutdown command is rejected.
Explanation: Restart log processing encountered a System programmer response: Enter either the IMS
VSO DEDB area log record that did not match any area /UNLOCK SYSTEM or the AVM UNLOCK command.
known to the restarting system. This problem happens Module: DFSICM30
during emergency restart, XRF tracking, XRF takeover,
or Fast Database Recovery processing,
DFS2491I A DIVIDE EXCEPTION HAS
The log record should contain the VSO DEDB area OCCURRED-NEXT LINE OF DATA
name and a time stamp. The presence of the log record MAY BE IN ERROR
signifies that area updates, which were committed
before the logged time, were written to DASD before Explanation: A divide exception (ABEND0C9 or
failure. Based on this log record, restart log processing ABEND0CB) occurred while dividing two fields. The
can ignore updates that were written to DASD, but usual reasons for this message are:
without a valid area name it cannot determine which 1. One of the fields being used for the divide is
updates to ignore and which to process. incomplete because either the input tape was not
completely processed or the input tape was
In most cases restart can tolerate this error, although incomplete;
performance might be degraded. A subsequent log 2. The DC monitor was active too long causing the
record might correct the problem (that is, might show dividend field to be so large that the quotient and
which updates were written to DASD for the area), remainder did not fit into the assigned work area.
otherwise restart does additional REDO processing.
System action: Processing continues normally.
If this problem recurs, IMS restart can run out of
resources to track VSO area updates. If this happens,
any affected areas are stopped and marked “recovery DFS2492I AREA aaaaaaaa HAS IOT EEQE -
needed”. CANNOT ACTIVATE VSO
In addition to this message, some diagnostic Explanation: A /START AREA was entered for area
information is output. Although this error does not aaaaaaaa. At the time of the command, the Virtual
Storage Option (VSO) was not active for the area, but
Explanation: The data entry database (DEDB) area Explanation: IMS RAS security is suppressing
was defined as a Virtual Storage Option (VSO) area. additional ICH408I messages because there is a RACF
While opening the area, IMS determined that the definition error for the identified transaction for the
amount of central and expanded storage available was identified dependent region.
not enough to satisfy the size of the area. Normal VSO
In the message text:
processing is allowed for the area.
YYYYYYYY
System action: The area is opened with the Virtual The dependent region name
Storage Option. ZZZZZZZZ
The transaction name
Operator response: This warning message indicates
that a potential VSO storage shortage exists. For the System action: IMS RAS security suppresses
area indicated in the message, not enough VSO storage additional ICH408I messages for the transaction and
exists to hold the entire area. Accessed CIs are loaded dependent region. The transaction is still in the
into VSO, but it is possible that storage constraint message queue and could be processed by another
problems, such as paging, might exist. If constrained eligible dependent region or another IMS system in the
storage represents a problem in your environment, you IMSplex. Processing continues.
can remove the area from VSO by issuing the /VUN
Programmer response: Determine whether it is
command. You can reactivate VSO processing for the
appropriate to grant the region access to process the
area at any time by reissuing the /START AREA or by
transaction. If so, grant the region access to process the
issuing an UPDATE AREA START(ACCESS) command.
transaction, and update the appropriate RACF
Module: DBFVSOP0 definitions. Otherwise, remove the transaction from the
region.
01 An invalid AWE was passed to the dynamic Programmer response: Correct the condition to allow
allocation routine. future requests to be processed successfully.
02 An attempt was made to deallocate a database
without stopping its index. DFS2500I DATABASE|DATASET xxxxxxxx
{DSN=yyyyyyyy} SUCCESSFULLY
03 The DDIR for the database was found to be in
ALLOCATED|DEALLOCATED|
NOTINIT status.
CREATED| DELETED
04 An attempt was made to deallocate a database
Explanation: Processing for the identified function
while the schedule bit was on.
completed for the database or data set name, where
05 An attempt was made to deallocate a database xxxxxxxx is the database or data set name, where
while one of its DCBs was still open. xxxxxxxx is the name. For allocation of a monitor data
set or an archived log (SLDS), the data set name is also
06 The data management block (DMB) for the provided (yyyyyyyy). Creation and deletion messages
database could not be loaded. are possible only on the Remote Site Recovery (RSR)
07 An attempt was made to deallocate a database, but tracking system.
a DDNAME for one of its data sets was not found Module: DFSMDA00
in the TIOT.
08 A data set of a database resides on a device not
supported by IMS.
System action: The Fast Path utility being used Explanation: More than 2048 AREA= utility control
terminates. statements were given in the CONTROL DD statement
for the DEDB initialization utility (DBFUMIN0).
Programmer response: Ensure that the DD statement
for the area is correct. System action: The utility terminates with a return
code of 4.
Problem determination: 3, 8, 20
Programmer response: Correct the parameters, and
Related information:
resubmit the job.
Chapter 2, “IMS problem determination,” on page 5
Maintenance utility again, and run the Online Change Related information:
utility. Chapter 2, “IMS problem determination,” on page 5
Problem determination: 1, 4, 18
Module: DBFINI20, DBFOLC02 DFS2532 MESSAGE ROUTED TO UNDEFINED
ROUTING CODE
Related information:
Chapter 2, “IMS problem determination,” on page 5 Explanation: The Fast Path user input exit directed
Fast Path to search the routing code table with a
routing code the exit supplied. Program DBFHIEL0
DFS2529I NO FAST PATH REGION IS ACTIVE. searched the table and did not find an equal
Explanation: A Fast Path input message was queued comparison.
in the load and balancing group. However, the last System action: The message is ignored.
region that was scheduled to process the message had
terminated. The terminal user is informed that no Fast Programmer response: If the correct routing code is
Path region is available to process an input message at being generated, add the routing code to the routing
this time. code table. Otherwise, modify the user input exit to
generate the correct routing code.
System action: IMS continues processing.
Problem determination: 7, 14
Operator response: (master terminal) Restart the
Related information:
designated Fast Path region.
Chapter 2, “IMS problem determination,” on page 5
(terminal) Make sure the Fast Path region has been
restarted and then reenter the input message.
DFS2533 ROUTING CODE NOT ACTIVE
Problem determination: 1, 6, 7, 11
Explanation: No message processing programs were
Related information:
scheduled for this routing code. The master terminal
Chapter 2, “IMS problem determination,” on page 5 operator must schedule the message processing
program before Fast Path can accept any messages for
DFS2530 FAST PATH EXCLUSIVE that destination.
TRANSACTION FROM NON-FP System action: The message is ignored.
TERMINAL
Operator response: Notify the master terminal
Explanation: A message destined for a Fast Path operator that the routing code is not active.
exclusive transaction was received from a terminal that
did not have a Fast Path message buffer defined during Problem determination: 7, 14
system definition or from the master terminal. Related information:
System action: The message is ignored. Chapter 2, “IMS problem determination,” on page 5
connect or open the data set associated with the Media Manager error return code used for problem
ddname. VSAM error message IEC161I was issued determination.
before this message.
System action: If the named area did not read the
System action: If a request is made to open an ADS other data sets, the system tries to read from other data
for the DEDB Create utility, the utility attempts to open sets. Otherwise, a status code AO is returned to the
the next ADS. If the next ADS is unavailable, the DEDB application program. If a permanent I/O error
Create utility terminates and the named area continues (indicated by a Media Manager error return code of
processing. If a request is made to open an ADS for X'0020FF10'), has not occurred, an MVS SDUMP can be
other than the DEDB Create utility, messages DFS3702I taken to the SYS1.DUMP data set by the Media
and DFS2574I are issued after this message. The named Manager FRR routine or the Fast Path I/O error
area is terminated and marked as stopped. routine.
Programmer response: Check VSAM error message Operator response: If the read errors persist, run the
IEC161I, correct the error, and follow the appropriate DEDB Create utility or the Database Recovery utility
restart procedure. To select the appropriate restart for this area.
procedure, check the Programmer response in messages
Problem determination: 1, 6, 11, 20. Problem
DFS3702I and DFS2574I, which follow this message.
determination is effective when the Media Manager
Related reference: return code is not X'0020FF10'.
For information about IEC161I Related information:
Related information: Chapter 2, “IMS problem determination,” on page 5
“DFS2574I” on page 522
“DFS3702I” on page 745 DFS2572I (ccccffss) AREA=areaname DD=ddname,
WRITE ERROR, CI-RBA=nnnnnnnn,
REMAINING EQE=nn, EEQE=nnnn
DFS2570I AREA=areaname DD=ddname
DISCONNECT ERROR Explanation: A write error occurred in the data set at
control interval (CI) RBA=nnnnnnnn. The error queue
Explanation: The module DBFMMIT0 was unable to element (EQE=nn) represents the number of write
disconnect (close) the data set associated with the errors in the data set. The maximum number of EQEs
identified ddname. VSAM error message IEC251I was for write errors is EQE=10. For a single area data set
issued before this message. (SADS), EEQE=nnnn is also displayed in the message.
System action: Close processing is discontinued for The extended error queue element (EEQE=nnnn)
the data set. represents the number of existing write errors for the
area. The variable ccccffss represents the Media
Operator response: No action is required. Manager error return code used for problem
Programmer response: Check VSAM error message determination.
IEC251I to determine the cause of the error, then run a The error return code of X'40CF4040' indicates a write
VSAM access method service program to determine if error on the coupling facility structure. Message
the named ADS is usable. If the named ADS is not DFS2830I is issued before this return code.
usable, run the DEDB Create utility or the Database
Recovery utility. System action: The system produces an error queue
element (EQE) for multiple area data sets (MADS) and
Related reference:
the CI on the error data set is deactivated. The system
IEC251I produces an extended error queue element (EEQE) for
a single area data set (SADS) and the CI in error is
available in the IO Toleration (IOT) buffer for the
DFS2571I (ccccffss) AREA=areaname DD=ddname, system that encountered the write error. If a permanent
READ ERROR, CI-RBA=nnnnnnnn, I/O error (indicated by a Media Manager error return
REMAINING EQE=nn, EEQE=nnnn code of X'0020FF10'), has not occurred, a z/OS SDUMP
Explanation: A read error occurred in the data set at can be taken to the SYS1.DUMP data set by the Media
control interval (CI) RBA nnnnnnnn. The error queue Manager FRR routine or Fast Path I/O error routine.
element (EQE=nn) represents the number of Operator response: If this control interval is critical
consecutive read errors in the data set. The maximum CI, run the DEDB Create utility or the Database
number of EQEs for read errors is EQE=03. For a single Recovery utility for this area to restart the area with a
area data set (SADS), EEQE=nnnn is also displayed in /START command.
the message if there are existing EEQEs for write errors
for the area. The extended error queue element Problem determination: 1, 6, 11, 20. Problem
(EEQE=nnnn) represents the number of existing write determination is effective when the Media Manager
errors for the area. The variable ccccffss represents the error return code is not X'0020FF10'.
Operator response: If the read errors persist, run the System action: Processing is terminated for the named
DEDB Create utility or the Database Recovery utility area. The Prohibit Authorization flag is set for the
for this area. database or area, unless the message is in response to a
/DBR command that includes the NOPFA option.
System action: The message is ignored. System action: See the message that was issued before
this message.
Operator response: Reenter the message in the correct
format. Programmer response: See the message that was
issued before this message.
System action: IMS continues running. System action: No MSDB image copy is loaded, and
the MSDBs cannot be used.
Programmer response: Check and correct the
DFSFIXnn member in the IMS PROCLIB. Programmer response: Check and correct the database
name, segment length, or length of the data area. Make
sure that no other changes were made to the DBD
DFS2589I ddname OPEN ERROR specified in the message. Also make sure that the
Explanation: Program DBFDBDL0 could not open the ACBLIB has not been changed. If it has, restart the
DCB for this data set. Possible causes are: system with a cold start.
v There is a missing DD statement.
v The JCL is incorrect. DFS2594I NO CONTROL RECORD FOUND IN
v A hardware error exists. ddname RC=XX
System action: The MSDB image copy is not loaded. Explanation: Program DBFDBDL0 attempted to load
Programmer response: Make sure that there is a DD the MSDB image copy from a data set. However it
statement and that its specifications are correct. If failed. The return code XX identifies the problem:
hardware failure is indicated, rerun the job, using a Code Meaning
different unit. 01 A data set does not contain an MSDB
checkpoint or the checkpoint was incomplete.
DFS2590I INVALID CHECKPOINT ID FOUND 02 If the active system is taking the checkpoint,
IN ddname the alternate system cannot use the same
MSDB checkpoint data set. This condition is
Explanation: The checkpoint identification in the temporary.
MSDB image copy control record was not the same as
the identification from which the system was restarted. System action: The system takes action based on the
A possible cause is that a wrong checkpoint was return code:
entered or the DD statement points to the wrong data 01 No MSDB copy is loaded, and the MSDBs
set. cannot be used.
02 The system rereads the MSDB data set every 3
System action: No MSDB image copy is loaded. seconds until it successfully reads.
Programmer response: Restart IMS with the correct Programmer response: Take action based on the
checkpoint identification or correct the JCL. return code:
01 Make sure that the JCL is correct. Otherwise,
restart IMS from another checkpoint data set,
DFS2591I NO MSDB HEADERS FOUND, IMAGE
if possible, or run the MSDB recovery utility to
COPY LOAD IGNORED
create a new initial load data set, and restart
Explanation: IMS was restarted with no main storage the system with MSDBLOAD.
databases (MSDB) from a checkpoint of a system with 02 The system rereads the checkpoint data set. If
MSDBs. message RC=02 is issued only once, no
response is required. If message RC=02 is
System action: No MSDB image copy is loaded.
issued more than once, check the status of
Programmer response: If MSDBs are to be used, active IMS. If active IMS is down, or an I/O
error occurred on the MSDB checkpoint data System action: An error from an I/O read request is
set in active IMS, enter the /STOP BACKUP treated the same as an error from a physical read I/O.
command to stop the alternate IMS. IMS blocks further access to the failing CI and records
the CI-RBA in the second CI of the area. The data set
remains open, but the error log (type X'24') is not
DFS2595I MSDB IMAGE COPY LOADED FROM
produced. If the error resulted from an I/O request for
CHKPT DATA SET ddname
update, IMS closes the data set and stops the area if the
Explanation: This message verifies that the MSDB data set is the only one available in this area. An MVS
image copy was loaded from the checkpoint data set SDUMP is taken to the SYS1.DUMP data set for
ddnamebb. problem determination.
Operator response: If the data set is closed but the
DFS2596I I/O ERROR IN ddname,cc,co,stat,sens,cchhr area is not stopped, run the DEDB Area Data Set Create
utility to recover the data set. If the area is stopped,
Explanation: Program DBFDBDL0 attempted to read run the Database Recovery utility to recover the area.
the MSDB checkpoint data set, and an I/O error
occurred. The following information is given in the System programmer response: If the error persists
message text: and if the data set is needed, contact IBM Software
cc The ECB completion code Support for additional analysis.
co The command code of the CCW that caused
Programmer response: The application program
the error
receives status code AO if access to the failing CI is
stat Status information
attempted. The CI can be accessed after the Database
sens Sense bytes
Recovery or DEDB Area Data Set Create utility is run.
cchhr The disk address where the error occurred
Problem determination: 1, 6, 11, 20
System action: IMS stops the load process, and the
MSDBs cannot be used. Related reference:
Explanation: Module DFSQFIX0 detected invalid data System action: The DEDB utility program stops
or inconsistencies, or both, between messages and scanning the current input line. Further processing is as
control blocks in the message queues and made the specified by the user in the ERRORACTION command.
queues valid. The process might have caused some
Programmer response: Correct the DEDB utility input,
messages or conversations, or both to be lost.
and rerun the DEDB utility.
System action: The invalid data, corrected control
blocks, and any purged messages were written to the
DFS2615I UNABLE TO CONVERT SEQUENTIAL
IMS log. Processing continues with the corrected
DEPENDENT ADDRESS
queues.
Explanation: The program expected a sequential
Problem determination: 1, 5, 25, 26, 36 (if
dependent address in hexadecimal, in the form X"hex
conversations are involved)
digits". The X or the starting quotation mark was
Related information: missing.
Chapter 2, “IMS problem determination,” on page 5
System action: The DEDB utility program stops
scanning the current input line. Further processing is as
DFS2611I COMMAND NAME NOT FOUND specified by the user in the ERRORACTION command.
Explanation: The program looked for a DEDB utility Programmer response: Correct the DEDB utility input,
command name. However, there was no command and rerun the DEDB utility.
name on the input line, or the program could not find
the name in its table of valid command names.
DFS2616I UNABLE TO RECOGNIZE KEYWORD
System action: The DEDB utility program stops
Explanation: The program looked for a keyword,
scanning the current input line. Further processing is as
followed by an equal sign. One of the following
specified by the user in the ERRORACTION command.
problems was encountered:
Programmer response: Correct the DEDB utility input, v The keyword was missing.
and rerun the DEDB utility. v The keyword was not in the table of keywords for
this command.
v The equal sign was missing.
DFS2612I OPERAND DATA LEFT OVER
System action: The DEDB utility program stops
Explanation: The program has processed all the scanning the current input line. Further processing is as
operands it expected for this command. However, there specified by the user in the ERRORACTION command.
was still more operand data on the input line.
Programmer response: Correct the DEDB utility input,
System action: The DEDB utility program stops and rerun the DEDB utility.
scanning the current input line. Further processing is as
specified by the user in the ERRORACTION command.
System action: IMS continues processing. System action: The Delete utility continues processing
normally.
Programmer response: No action is required.
Programmer response: No action is required.
Module: DBFCSTS0, DBFDMAC, DBFNCBS0
System action: The Area Data Set Create utility v A partner IMS failure retains a CI for its emergency
continues processing normally. restart.
v A partner IMS is not inserting SDEP segments into
Programmer response: No action is required.
the area at a rate that fills the preallocated CI
encountered by the Delete utility.
DFS2640A I/O ERROR IN ddname OUTPUT DATA v A program or transaction is stopped after an abend.
SET
System action: Utility processing stops.
Explanation: Program DBFUMCL0 attempted to close
System programmer response: Determine why the
the DCB for this scan utility data set and an error
partner is holding the CI. Issue a /DISPLAY AREA or
occurred.
QUERY AREA command to show the SDEP CI
System action: The utility terminates. utilization for one partner. The IMS partner might be
waiting for some resource (for example, a log data set,
Operator response: Correct the error and rerun the a resource with which to schedule a program, a DBRC
job. request, or a lock). The hardware and operating system
Programmer response: To determine the cause of the on which the IMS partner is executing might be
error, check the z/OS access methods error message constrained or not have sufficient capacity to keep up
issued before this message. with the rest of the sharing group.
Module: DBFUMCL0, DBFUMMS0 To make the CIs following the held CI available to the
Delete utility, you can take one of these actions:
v Use the QUITCI option of the Database Scan or
DFS2641A UTILITY ERROR
Delete utility to cause the IMS partner that owns the
Explanation: The DEDB utility attempted to free CI to release the CI.
space. The request was rejected. Make sure that any SDEP segments contained in this
System action: The utility is terminated for this area. CI are retrieved by the SCAN utility and put in an
output file before rerunning the DELETE utility after
Operator response: If this problem is not a user error, the QUITCI option was used.
call IBM Software Support.
Attention: After a CI is deleted, any data that it
Programmer response: Check whether an exit routine contained is not accessible.
in the Delete utility activated the utility. v Wait until the partner releases the CI and run the
Delete utility again.
DFS2642I NUMBER OF CI'S FOR SEQUENTIAL
DEPENDENT SEGMENTS xxxxxxx DFS2644I NUMBER OF CI'S NOT USED BY
Explanation: This message shows the space allocated SEQUENTIAL DEPENDENT
for sequential dependent segments for the area in use. SEGMENTS xxxxxxxx
Explanation: This message prints the number of
DFS2643I NUMBER OF CI'S USED BY control intervals (CIs) that are not used by the
SEQUENTIAL DEPENDENT sequential dependent segments listed in the message
SEGMENTS xxxxxxx text.
DFS2652A REORGANIZATION HAS TO BE System action: The Fast Path Base Module utility is
RESTARTED IN AREA xxxxxxxx stopped for the named area.
Explanation: Program DBFNRST0 was unable to open System action: The area stopped. then IMS
the DCB for this data set. Possible causes are: disconnected from the structure.
v There is a missing DD statement. Operator response: Increase the INITSIZE for the
v The JCL is incorrect. structure in the CFRM policy, or remove the PRELOAD
v A hardware error exists. specification for the area.
System action: The system tries to open the second Module: DBFVXAS0
MSDB data set. Fast Path is made unavailable if the
second opening fails too. Related reference:
Programmer response: Make sure that there is a DD IXLALTER Return and Reason Codes
statement and its specifications are correct. If hardware
failure is indicated, rerun the job, using a different unit. DFS2685I SDEP DISCREPANCY DURING
RESTART AREA xxxxxxxx - AREA
DFS2682W MSDBS NOT LOADED DUE TO STOPPED
PREVIOUS ERROR(S) Explanation: During an emergency restart, restart log
Explanation: Either program DBFNRST0 found no processing found a problem with the log records
valid MSDB checkpoint control record, or other errors relating to the sequential dependents of area xxxxxxxx.
as specified in messages DFS2780A and DFS2781A Specifically, due to a missing log record, restart log
previously occurred. processing was unable to determine the correct buffer
for one or more committed SDEP updates.
System action: Fast Path is made unavailable.
System action: Area xxxxxxxx is stopped. If the area is
Programmer response: Find out if IMS was cold registered with DBRC, it is marked as recovery needed.
started without MSDBs specified. If so, issue the /NRE
MSDBLOAD command on the next warm start to load Programmer response: Use the Database Recovery
the MSDBs from the MSDBINIT data set. utility to recover the area.
Related information:
“DFS2780A” on page 554
DFS2690I OPEN FAILED DDNAME=xxxxxxxx Programmer response: Correct the control input, and
resubmit the job.
Explanation: The DBFDBDZ0 utility was unable to
open the indicated data set.
DFS2694I O/P LRECL INSUFFICIENT TO HOLD
System action: The utility terminates and no output is RECORD
generated.
Explanation: The logical record length that you
Programmer response: Make the necessary changes, specified in the JCL was too small for the utility output
and resubmit the job. data set. The ddname is MSDBINIT.
System action: The utility terminates, and no output
DFS2691A LOG DATA SET IS INVALID, is generated.
TERMINATE. CURRENT CHKPT
ID=xxxxxxx, PROCESSING CHKPT Programmer response: Correct the JCL, and resubmit
ID=xxxxxxx the job.
Explanation: One of the following problems occurred:
Explanation: The IMS control region did not contain Programmer response: Update the BSIZ parameter in
sufficient storage to build the temporary the IMS procedure or override the parameter at IMS
DMCB/DMAC or BHDR blocks, or both. startup time. If neither an MSDB nor a DEDB is in use,
no suffix for an MSDB can be defined, and no DBD
System action: IMS terminates abnormally with abend should be on the IMS ACBLIB for any DEDB.
1011.
Related information:
Programmer response: Increase the IMS control region
size. IMS abend 1011
Related information:
DFS2705A DBBF NOT SPECIFIED
IMS abend 1011
Explanation: There are DEDBs or MSDBs in use, but
no number is specified for the data buffers.
DFS2703A GETMAIN FAILED. INSUFFICIENT
STORAGE FOR FP CONTROL System action: IMS terminates abnormally with abend
BLOCKS. 1011.
Explanation: There was not enough storage to load Programmer response: Update the DBBF parameter in
and build all of the Fast Path control blocks in the CSA the IMS procedure or override it at IMS startup time.
or ECSA. For Fast Database Recovery (FDBR) region, Related information:
the storage shortage is in ECSA only if FPBUFF=ECSA
is specified in DFSFDRxx member. Otherwise the IMS abend 1011
storage shortage is in the FDBR region private storage;
FPBUFF=LOCAL or FPBUFF was not specified in DFS2705W DBBF NOT SPECIFIED
DFSFDRxx member.
System action: IMS terminates with abend 1011. or
Operator response: (master terminal) After increasing DBBF SPECIFICATION INVALID, DBBF=10 IS
CSA or ECSA, restart IMS. For an FDBR region, ASSUMED
increase the region size if you used extended private to
Explanation: You specified a DBBF value less than 10. Maximum number of
That value is not suitable for using Fast Path. IMS has BSIZ (buffer size) buffers
changed the DBBF value to 10.
4,096 440,000
System action: Normal processing continues.
8,192 230,000
Programmer response: No action is required.
12,288 160,000
Module: DBFINI20
16,384 130,000
20,480 100,000
DFS2706A MSDB xxxxxxxx {NOT SPECIFIED AT
SYSGEN|HAS NO DBD GENERATED 24,576 80,000
IN ACBLIB|NOT DEFINED AS A 28,672 70,000
MSDB AT DBDGEN}.
Explanation: One of the following occurred: System action: IMS continues running.
v The MSDB name is specified in the DBFMSDBn
member, but was not defined in the DATABASE Programmer response: Correct the DBBF value in the
parameter at system definition. IMS procedure.
System action: IMS continues running but the named Explanation: Because of previous errors no DEDBs (or
MSDB is marked as not accessible in the first two cases MSDBs) were initialized.
listed above. System action: IMS continues running.
If the named entry is not defined as an MSDB at Programmer response: If DEDBs (or MSDBs) are
DBDGEN, the entry is ignored. required, shut down IMS, correct any errors indicated
Programmer response: Check and correct the IMS by previous error messages, and restart IMS.
system definition or MSDB load determination member
DBFMSDBn. DFS2710W DBFX GREATER THAN DBBF, OR
DBFX LESS THAN 10. DBFX=10 IS
DFS2707W INVALID OTHR VALUE SPECIFIED. ASSUMED.
SYSDEF VALUE USED. Explanation: The number of data buffers, page fixed
Explanation: The OTHR parameter was specified, but at region startup, exceeded the number of data buffers
not as a decimal value from 1 to the value of the available. Alternatively, the page fixed data buffer was
MAXPST parameter in the control region procedure. specified as less than 10 and the number of data buffer
was greater than 0. The DBFX value is set to 10. In
System action: IMS continues running. addition, if the number of data buffers available was
less than 10, DBBF=10 was assumed.
Programmer response: Correct the OTHR value in the
IMS procedure. System action: IMS continues running.
Programmer response: Correct the DBFX parameter in
DFS2708W NUMBER OF DATA BUFFERS the IMS procedure.
EXCEEDED THE MAXIMUM
ALLOWED FOR THE SPECIFIED BSIZ.
DBBF HAS BEEN ADJUSTED. DFS2711A BSIZ VALUE WRONG
Explanation: The DBBF parameter in the IMS startup Explanation: The BSIZ value specified in the IMS
procedure exceeded the maximum value based upon startup procedure is invalid. The data buffer size (BSIZ)
BSIZ. DBBF is adjusted to the maximum allowed value must be a multiple of 4 KB unless the BSIZ value is
for the specified BSIZ as specified in the following 512, 1024, or 2048. The maximum BSIZ value is 28 672.
table: System action: IMS terminates with abend 1011.
1. Force termination of IMS by issuing a If the new active IMS system receives this message in
MODIFY IMS,STOP command. an XRF environment, the operator might not have
2. Scratch the failing MSDB checkpoint data entered the 'MD' option for the FORMAT keyword in
set, and reallocate a new data set. the /ERE command for the IMS alternate system.
3. Copy the valid MSDB checkpoint data set
to the newly allocated data set.
DFS2723I UNABLE TO OPEN DD=LOGTAPE.
4. Emergency restart the system from the last
ANALYSIS TERMINATED.
valid system checkpoint.
B. Recovery through a warm start action: Explanation: A permanent I/O error might have
1. Shut down IMS. Message DFS2762A occurred while opening the input log data set, which
should be expected. resides on tape or DASD.
2. Follow the actions documented in message
DFS2762A. System action: The IMS Fast Path Log Analysis utility,
DBFULTA0, terminates.
Related information:
“DFS2762A” on page 552 Programmer response: Ensure that the LOGTAPE
ddname is allocated properly.
Fast Path Log Analysis utility (DBFULTA0) (System IMS abend 1011
Utilities)
DFS2732E SVSO CASTOUT PROCESS FAILED
DFS2727I LOG BUFFER CONTROL RECORD DUE TO TIMEOUT. AREA=xxxxxxxx
NOT FOUND ON INPUT LOG.
Explanation: This message is generated when the
ANALYSIS TERMINATED.
CASTOUT for an SVSO area has timed out. The
Explanation: The IMS Fast Path Log Analysis utility, maximum number of retries has been exhausted.
DBFULTA0, was unable to find the IMS log buffer
System action: Area xxxxxxxx is stopped and marked
control record on the data set specified by LOGTAPE
as recovery needed.
ddname.
System programmer response: Use the Database
System action: Execution terminates.
Recovery utility to recover the area.
Programmer response: Ensure that the LOGTAPE
Module: DBFVXOC0
ddname is correctly allocated.
DFS2729I PERMANENT I/O ERROR READING Explanation: There was a faulty DD statement, or a
LOG DATA SET. ANALYSIS DD statement was missing.
TERMINATED. System action: Processing continues. However,
Explanation: Module DBFULTA0 attempted to read a abnormal termination is likely if an attempt is made to
log record, and the access method returned control to read or write the data set.
the SYNAD address specified in the log data set DCB, Programmer response: Check the DD statement, and
indicating an uncorrectable I/O error on the log data resubmit the job.
set.
System action: Analysis is terminated prematurely DFS2735A MORE THAN ONE RUN CARD
with presentation of the results accumulated up to the
point of the error. Explanation: More than one run card was supplied,
and only one card is valid.
Problem determination: Check the accompanying IEA
or IEC messages for details. System action: Program DBFDBMA0 continues
processing until message DFS2740A appears.
DFS2730A UNABLE TO LOAD FP INPUT Programmer response: Remove the extra run cards,
ROUTING EXIT: DBFHAGU0 and resubmit the job.
Related information:
Explanation: During IMS system initialization, Fast
Path initialization was unable to load DBFHAGU0, the “DFS2740A” on page 548
required Fast Path input routing exit.
System action: After issuing this message, IMS Fast DFS2736A INVALID ACTION CARD
Path initialization terminates with the user abend 1011. Explanation: There was a syntax error in the listed
System programmer response: statement.
1. Make sure that the default or customer written System action: Program DBFDBMA0 continues
version of DBFHAGU0 is in the IMS.SDFSRESL processing until message DFS2740A appears.
STEPLIB concatenation.
2. Restart IMS. Programmer response: Correct the statement, and
resubmit the job.
Related information:
Related information:
“DFS2740A”
DFS2742A CHANGE RECORD DATA INVALID
OR TOO LONG
DFS2737A NO RUN CARD
Explanation: The specified change record contained
Explanation: No run card was supplied. invalid data.
System action: Program DBFDBMA0 continues System action: Program DBFDBMA0 terminates.
processing until message DFS2740A appears.
Programmer response: Correct the input, and
Programmer response: Insert a run card, and resubmit resubmit the job.
the job.
Related information: DFS2743I READING THE OLCSTAT MDA
“DFS2740A” MEMBER
Explanation: An OLCSTAT DD statement was coded
DFS2738A NO ACTION CARDS in the batch JCL; however, the system cannot access the
data set. An attempt was being made to read the MDA
Explanation: Program DBFDBMA0 requires at least member if one exists.
one action card, and none was supplied.
System action: Processing continues.
System action: The program continues processing
until message DFS2740A appears. Programmer response: No action is required.
| or
DFS2753I nnnn MSDBS COPIED
Explanation: This summary message shows the count | QFIX - PROCESSING cccc. QFIX ddd.d%
of MSDBs has been copied intact from the load-image | COMPLETED.
data sets MSDBINIT(0) to MSDBINIT(+1).
| Explanation:
Explanation: The MSDB DUMP/RECOVERY utility Explanation: The master terminal operator requested a
processed a control statement which contained a value shutdown of IMS after message DFS2718I or DFS2761W
other than DBN=. was issued.
System action: Program DBFDBDR0 terminates. System action: A shutdown checkpoint is taken
without taking an MSDB checkpoint.
Programmer response: Correct the input, and
resubmit the job. Operator response: (master terminal)
1. Run the Log Archive utility (DFSUARC0).
2. Run the MSDB DUMP RECOVERY utility
DFS2760I INVALID SYNTAX. BLANK (DBFDBDR0) to recover the MSDBs from the valid
FOLLOWING DBN=( MSDB checkpoint data set and the SLDSs
Explanation: The first character in the list of MSDB containing MSDB changes since the last valid
names supplied in the control file was a blank. It must system checkpoint.
be an alphabetic character. 3. Discard the failing MSDB checkpoint data set, and
reallocate a new data set.
System action: The utility terminates and no output is 4. Warm start IMS with the MSDBLOAD keyword.
generated. Related information:
Programmer response: Correct the control statement, “DFS2718I” on page 545
and resubmit the job. “DFS2761W”
DFS2765W OUT OF SPACE IN DATA SET DFS2767I AREA=xxxxxxxx DEDB AREA FULL
DATABASE=xxxxxxxx AREA=yyyyyyyy
Explanation: The space management module could
ss RM: tttt
not find adequate space in the root portion of the area
Explanation: for an ISRT request.
The DEDB area described in the message has run out
Note: This message is sent to the Master Terminal
of space in the sequential dependent portion of the
operator.
area. No more additions of sequential dependents to
the area are possible. System action: For an IFP or MPP, the transaction
requesting the ISRT is canceled, the dependent region
In the message text:
from which the request originated is brought down,
xxxxxxxx
and if the threshold value has not been reached, the
The DEDB containing the area which ran out
dependent region is brought back up. If the region is a
of space.
BMP, it completes normally but receives a STATUSFS
yyyyyyyy
for the ISRT call.
The area that ran out of space.
ss The DL/I call status code. For these codes, see
the DL/I status code information. DFS2768W FAST PATH RESTART ERROR-FP
tttt The type of DL/I status call that was issued. UNAVAILABLE
The valid types for this message are:
ISRT The message was issued by module Explanation: Module DBFNRST0 detected an error
DBFMSRT0 when attempting to during Fast Path restart.
pre-allocate SDEP CIs for SDEP insert System action: IMS continues without Fast Path.
activity.
SDEP The message was issued by module Programmer response: Cold start the system after all
DBFSYN10 when processing SDEPs of the IMS queues are processed and all of the
during sync point. messages are sent to their destination.
For more information about sequential dependent space DFS2769I INVALID SYNTAX. DELIMITER
management, see the IMS Version 11 Database EXPECTED BEFORE 72
Administration.
Explanation: The utility was scanning the control file
System action: The input message is reprocessed so for a blank or comma, indicating the end of an MSDB
that the condition will be detected at call time. name. Column 72 was reached before the delimiter was
Operator response: Contact the IMS system found.
programmer. System action: The utility terminates and no output is
Programmer response: Determine which data is no generated.
longer required in the database and run the Delete Programmer response: Correct the control statement,
utility to reclaim usable space for the online system. and resubmit the job.
Module: DBFMSRT0, DBFSYN10
Related reference: DFS2770I FAST PATH DBD dbdname IGNORED
DL/I status codes (Messages and Codes) Explanation: Initialization for database backout found
a Fast Path DBD. All Fast Path DBDs are ignored.
DFS2766I PROCESS FAILED System action: Processing continues and bypasses the
Fast Path DBDs.
Explanation: The application program has abnormally
terminated. This general message is accompanied by
one of a number of messages to the master terminal DFS2771 APDB KEYWORD HAS INVALID
detailing the reason for the failure. PARAMETER
System action: The input message is discarded. Explanation: You entered an invalid parameter for this
keyword.
Operator response: Contact the IMS database
administrator or the system programmer, or both. System action: The command is ignored.
Operator response: (master terminal) Reenter the
command and keyword using valid parameters.
Module: DFSICL30, DFSICLN4
Check for missing log data sets. This is the most Code (hex)
common cause for this message. Supply any missing Meaning
log data sets to a change accumulation or log input to 44 The CCHHR in ERLG is not in the data space
recovery. extents.
48 The RBA in ERLG is not in the target data set
If the second situation occurs, supply a previous
extents.
unload or image copy and log data sets produced since
4C An error return code was received from
that time.
ATLAS.
If the third situation occurs, notify system 50 An error return code was received from VSAM
programming for a resolution. There is no after a GET/GETIY request (f indicates VSAM
recommended solution to this problem. feedback).
54 An error return code was received from VSAM
When all input is checked, resubmit the job. after a PUT/PUTIY request (f indicates VSAM
Problem determination: 2, 3, 4, 8, 17g, 36 feedback).
58 The CI RBA=00 was not updated since HISAM
Related information:
unload was used as input to recover an ISDS.
Chapter 2, “IMS problem determination,” on page 5
System action: Processing continues.
DFS2806A SYSIN CONTROL CARD NOT Programmer response: If possible, correct the problem
SUPPLIED and rerun track recovery. If the problem cannot be
corrected, the entire data set must be recovered.
Explanation: A control statement is required, but none
was available from the SYSIN data set. If this message
was issued from the Database Image Copy 2 utility, it DFS2811A TRACK RECOVERY TERMINATED
might indicate that a group statement was not followed ABNORMALLY, REASON r(f)
by at least one DBDS Select statement. Explanation: In the message, r indicates the reason
Programmer response: Include at least one control code and (f), if present, is the VSAM feedback code.
statement and resubmit the job. The values of the reason codes and their meanings are
as follows:
Module: DFSUDMP0, DFSUDMT0
Code (hex)
Meaning
DFS2807I PURGE DATE-TIME 04 Unable to open ACB for target data set. See
SPECIFIED=timestamp message IEC161I to determine cause of error.
Explanation: The date and time specified on the 08 Error detected while reading VSAM index. (f)
SYSIN control statement is repeated here. is the VSAM feedback code.
0C Control interval RBA in type X'24' error log
record not found in VSAM index.
DFS2808I RECOVER TRACK CCHH=cccchhhh, 14 Invalid request. Parameter list passed during
VOLSER=volser track recovery call had unidentified request
Explanation: The track recovery option of the value.
Database Data Set Recovery utility (DFSURDB0) was 18 Record passed by caller did not fit in control
started for the designated tracks. interval.
1C No volumes mounted for target data set.
20 Unable to open DCB for Data Space.
DFS2809I ATLAS CALL RC=rc FOR TRACK
CCHH=cccchhhh, VOLSER=volser System action: The program is terminated abnormally.
Explanation: See Data Administration: Macro Instruction Programmer response: If error is correctable, correct it
Reference for MVS/DFP (SC26-4506) for the meaning of and rerun the job. If error cannot be corrected, recover
ATLAS return codes. the database. If reason codes X'14' or X'18' occur, rerun
the job with an ABEND control statement.
DFS2815A VSAM KSDS NOT SUPPORTED A list containing multiple occurrences of the second
part of the message might be issued. This list can
Explanation: A concurrent image copy of a VSAM contain several UOR tokens that are not involved in the
KSDS cannot be created. Database Recovery process, but are generated because
System action: The Image Copy utility terminates this the input log is incomplete, as far as these tokens are
image copy and reads the next control statement. concerned.
System action: The Database Recovery utility
DFS2821I PRELOAD COMPLETED FOR ALL System action: The open process for the area fails.
SHARED VSO AREAS
System programmer response: Contact IBM Software
Explanation: The preload process for all shared VSO Support.
areas has completed.
System action: None. DFS2827A AREA areaname CONNECT TO STR:
strname FAILED. INTERNAL XES
Programmer response: No action is required. ERROR. CONDIAG0=xxxxxxxx,
Module: DBFVXPL0 CONDIAG1=yyyyyyyy,
CONDIAG2=zzzzzzzz.
DFS2822I AREA areaname CONNECT TO STR: Explanation: An internal z/OS cross-system extended
strname SUCCESSFUL services (XES) error occurred. The message provides
XES diagnostic information.
Explanation: Area areaname was successfully
connected to cache structure strname. System action: The open process for the area fails.
DFS2830I CF READERROR, RBA rrrrrrrr, AREA DFS2833I CANNOT ADD DEDB dedbname- FAST
areaname,STR strname RC=xxxxxxxx PATH NOT INSTALLED
RSN=yyyyyyyy
Explanation: An attempt was made to add a data
entry database (DEDB) to an IMS system that does not
or
have Fast Path installed.
CF WRITEERROR, RBA rrrrrrrr, AREA areaname,STR System action: The /MODIFY PREPARE or INITIATE
strname RC=xxxxxxxx RSN=yyyyyyyy OLC PHASE(PREPARE) command fails.
Explanation: The read or write of the control interval Programmer response: Remove the DEDB from the
(CI) to the coupling facility failed. An internal z/OS system definition or install Fast Path.
cross-system extended services (XES) error occurred.
Module: DFSRMDM0
The return and reason codes provide XES diagnostic
information. These return and reason codes are
documented in the IXLCACHE macro. DFS2834I PSB psbname HAS BEEN
RESCHEDULED BECAUSE OF
System action: Fast Path continues processing the area
ONLINE CHANGE
from DASD, if a single cache structure is defined, or
from the other structure, if multiple structures are Explanation: An IMS Fast Path program (IFP) or
defined. message processing program (MPP) attempted to
update a data entry database (DEDB) that was changed
System programmer response: Contact IBM Software
using online change.
Support.
System action: The application program is terminated
Module: DBFVSOW0, DBFMSRB0
with a pseudoabend, and the PSB is rescheduled.
Related reference:
Module: DBFIRCI0
Return and reason codes for the IXLCACHE macro
(for read)
DFS2835I ERROR IN VSPEC DEDB STMT:
Return and reason codes for the IXLCACHE macro statement_text REASON= reason_text
(for write)
or
DFS2831I POOLNAME XXXXXXXX; BUFFER
ERROR IN VSPEC DEDB STMT: POOLNAME text;
SHORTAGE. POOL EXPANDED
text; SPECIFICATION ERROR
BEYOND MAX
Explanation: A buffer pool, indicated by XXXXXXXX, or
is experiencing a buffer shortage. The buffer pool will
be expanded beyond the specified limit by the ERROR IN VSPEC SDEPQCI STMT: statement_text
secondary amount. REASON= reason_text
Operator response: Use the /DIS POOL FPDB Explanation: The DEDB or SDEPQCI VSPEC
command to display the private pool usage. statement text is incorrect. The message displays the
text for a maximum of two pools in error, however,
there might be more pools in error than those included
in this message.
For the variant with statement_text, the statement_text
shows partial error statement. The reason_text offers the changing data entry databases (DEDBs).
explanation for the error.
System action: The /MODIFY PREPARE or INITIATE
System action: IMS continues processing without the OLC PHASE(PREPARE) command fails.
buffer pool in error or accounting for the DEDB or
Programmer response: Stop IMS and increase the size
SDEPQCI statement in error.
of CSA or ECSA.
System programmer response: Stop IMS and restart
Module: DBFOLC01
with a corrected VSPEC member.
Module: DBFVSOP0, DBFPVTS0, DBFDVBI0
DFS2840W ERROR IN LOADING RANDOMIZER
name FOR DEDB dedbname, RC=zz
DFS2837I CANNOT ADD DEDB dedbname-
Explanation: Randomizer name cannot be loaded.
OTHREADS NOT INITIALIZED
System action: The command (/MODIFY PREPARE,
Explanation: An attempt was made to add a data
INITIATE OLC PHASE(PREPARE), /START DB, or
entry database (DEDB) to an IMS system that was not
UPDATE DB START(ACCESS)) continues without
initialized with DEDBs. No output threads
loading the randomizer. Subsequent DL/I calls to this
(OTHREADS) were initialized and no I/O is possible to
data entry database (DEDB) receive an FH status code.
the added DEDB.
Hexadecimal return code zz from the IMODULE
System action: The /MODIFY PREPARE or INITIATE function of IMS is explained in the IMODULE return
OLC PHASE(PREPARE) processing stops. code information.
Programmer response: Define DEDBs to the system Programmer response:
and restart IMS.
If the return code is 0, the randomizer module was not
Module: DFSRMDM0 reentrant. Rerun the bound JCL to make it reentrant.
Also verify that:
DFS2838I RANDOMIZER name FOR dedbname IS v The randomizer was correctly linked into the IMS
DELETED AND status system.
v The DEDB was correctly defined with the
Explanation: The following commands can delete the
randomizer name.
randomizer:
v /DBR DB dbname
Correct any errors and issue the UPDATE DB
v /DBR DB FFdatabase
START(ACCESS) or /START DB command to reload
v /STO DB FFdatabase
the randomizer.
v /STA DB FFdatabase
v UPDATE DB NAME(dedbname) STOP(ACCESS) Module: DBFDBAC0, DBFINI24, DBFERDB0
v UPDATE DB NAME(FFdatabase) STOP(ACCESS) Related reference:
v UPDATE DB NAME(FFdatabase) STOP(UPDATES)
v UPDATE DB NAME(FFdatabase) START(ACCESS) IMODULE return codes (Messages and Codes)
DFS2839I ERROR TRYING TO GETMAIN Programmer response: Consult your z/OS system
STORAGE FOR DMCBS programmer. Determine what resources are using the
CSA and attempt to free some CSA for use. You must
Explanation: The /MODIFY PREPARE or INITIATE issue an IPL to increase CSA.
OLC PHASE(PREPARE) command failed to get enough
Common Service Area (CSA) and the Extended Module: DBFOLC01
Common Service Area (ECSA) storage for adding or
If a utility encounters this error, this message is sent to In the message text:
the utility job log. rsrcdesc A resource description, that is DATASET.
rsrctype A resource type, that is OLCSTAT.
System action: The system action depends on the IMS
function that encountered the error: This message is sent to the system console.
v IMS initialization abends with 2800, subcode X'0007'.
v IMS restart abends with 2901, subcode X'0007'. System action: IMS initialization fails with abend
v Online change commands fail. 2800, subcode X'0009'.
System programmer response: Run the global online Programmer response: See abend 2800 for response
change utility (DFSUOLC0) to initialize the OLCSTAT details.
data set. Then try IMS initialization, IMS restart, or the
Module: DFSCSL40
IMS abend 2800
Related information:
IMS abend 2801
IMS abend 2800
If an OM command encounters this error, this message This message is sent to the system console in response
is sent to the OM output exit as an unsolicited to a restart command such as /NRE or /ERE.
message. If IMS initialization or IMS restart encounters System action:
this error, this message is sent to the system console. If
a utility encounters this error, this message is sent to IMS terminates abnormally with abend 2801, subcode
the job log of the utility. 12.
System action: The system action depends on the IMS Operator response:
function that encountered the error: Start IMS again and enter either a cold start command
v IMS initialization fails with abend 2800, subcode (/NRE CHECKPOINT 0), or enter a restart command
X'0001' or X'0003'. that does not conflict with the last online change type.
v IMS restart fails with abend 2801, subcode X'0001'.
v IMS online change command fails. The following table shows the types of IMS restarts
that are permitted for an IMS that was down during
System programmer response: Correct the dynamic online change, with the online change type that was
allocation problem and try IMS initialization, IMS performed while the IMS was down:
restart, or the online change command again.
Module: DFSIIOC0, DFSIQ040, DFSROLC0
Related information:
Module: DFSOLCS0
Related information:
condition is encountered whose root cause is external. System action: The specified /DIAGNOSE command
does not complete.
In the message text:
reason text System programmer response: Contact IBM Software
| Identifies the specific error encountered. The Support.
| reason text can be one of the following:
Module: DFSDGST0, DFSDGSN0, DFSDGS10,
| BLOCK STORAGE NOT AVAILABLE
DFSDGS94, DFSDGS92, DFSDGSB0, DFSDGS20,
| A /DIAGNOSE SNAP BLOCK()
DFSDGS00
| command was issued and the
| requested primary block was not
| available. DFS2859I DIAGNOSE COMMAND
| COPY BUFFER FREESTOR FAILED UNSUCCESSFUL - reason text
| A /DIAGNOSE SNAP command was
| issued, diagnostic information was Explanation: A non-fatal error was encountered that
| captured in a copy buffer, and the prevented the /DIAGNOSE command from completing
| FREESTOR call for the copy buffer successfully. The message is issued at any point in the
| failed. code that a non-fatal, non-serious error condition is
| COPY FAILED: DESTRUCTIVE OVERLAP encountered.
| A /DIAGNOSE SNAP command was In the message text:
| issued, diagnostic information was reason text
| found, a call was made to the storage | Identifies the specific error encountered:
| copy routine without tolerate copy | AOS=N WAS SPECIFIED
| failures in effect, and the copy failed | A /DIAGNOSE SET AOSLOG()
| because of a destructive overlap | command was issued where AOS
| between the storage and the copy | logging was prohibited by an IMS
| buffer. | startup parameter.
| COPY FAILED: INVALID STORAGE KEY | CSCD UNAVAILABLE
| A /DIAGNOSE SNAP command was | A /DIAGNOSE SNAP BLOCK(CSCD)
| issued, diagnostic information was | command was issued when the CSCD
| found, a call was made to the storage | control block was not available or not
| copy routine without tolerate copy | defined.
| failures in effect, and the copy failed | INVALID ADDRESS VALUE SPECIFIED
| because of an invalid storage key. | A /DIAGNOSE SNAP command was
| COPY FAILED: STORAGE UNAVAILABLE | issued with ADDRESS(address) where
| A /DIAGNOSE SNAP command was | the address specified was beyond the
| issued, diagnostic information was | maximum address allowed:
| found, a call was made to the storage | X'7FFFFFFF'.
| copy routine without tolerate copy | INVALID LENGTH VALUE SPECIFIED
| failures in effect, and the copy failed | A /DIAGNOSE SNAP command was
| because of an invalid address. | issued with ADDRESS(address)
| DGSS BUFFER FREESTOR FAILED | LENGTH(length) where the length
| A /DIAGNOSE SNAP command was | specified was beyond the maximum
| issued, a DGSS storage table was | length allowed: address + length <=
| allocated, and the FREESTOR call for | X'7FFFFFFF'.
| the DGSS storage table failed. | INVALID resource SHOW OPTION
| NUCLEUS ADDR TABLE NOT AVAILABLE | A /DIAGNOSE SNAP command was
| A /DIAGNOSE SNAP MODULE() | issued where the SHOW option
| command was issued and the | keyword or block name was invalid
| DIAGNOSE Command Nucleus | for the specified resource type.
| Module Address Table was not | LIMIT INVALID WITH OPTION(OLDS)
| available. | A /DIAGNOSE SNAP command was
| STORAGE COPY FAILED | issued with OPTION(OLDS) and a
| A /DIAGNOSE SNAP command was | LIMIT(linecount) was specified. The
| issued, diagnostic information was | LIMIT parameter is not valid with
| found, a call was made to the storage | OPTION(OLDS).
| copy routine without tolerate copy | LIMIT INVALID WITH OPTION(TRACE)
| failures in effect, and the copy failed. | A /DIAGNOSE SNAP command was
| TRACE FACILITY START FAILED | issued with OPTION(TRACE) and a
| A /DIAGNOSE SNAP command was | LIMIT(linecount) was specified. The
| issued with OPTION(TRACE) and the | LIMIT parameter is not valid with
| internal call to start tracing facilities | OPTION(TRACE).
| for a DIAG trace table failed.
| LSCD UNAVAILABLE System action: IMS external trace is started, but is not
| A /DIAGNOSE SNAP BLOCK(LSCD) permanently disabled if error cleanup is successful.
| command was issued when the APPC
Operator response: Notify the IMS system
| SCD Extension control block was not
programmer.
| available or not defined.
| MWA UNAVAILABLE
| A /DIAGNOSE SNAP BLOCK(MWA) DFS2861W TAPE/DISK DYNAMIC ALLOCATION
| command was issued when the FAILED FOR EXTERNAL TRACE
| Modify Work Area control block was DATA SET xxxxxxxx.
| not available or not defined.
| resource(parameter) NOT FOUND Explanation: Dynamic allocation failed for the
| A /DIAGNOSE SNAP command was ddname listed as xxxxxxxx. Verify that the DFSMDA
| issued where the parameter for the member accurately describes the data set and where it
| specified resource type was not resides.
| found. System action: If disk data sets are used, IMS tries to
| SNAP RESOURCE NOT FOUND log the trace tables to the remaining data set. If no
| A /DIAGNOSE SNAP command was disks or tape are left for external trace use, IMS asks
| issued where the parameter for the the operator for permission to log trace tables to the
| specified resource type was not OLDS. See DFS2867A for more information.
| found.
Related information:
| SNAP RESOURCE NOT SPECIFIED
| A /DIAGNOSE SNAP command was “DFS2867A” on page 571
| issued without a SNAP resource type
| specified. DFS2862W OPEN/CLOSE ERROR ON EXTERNAL
| SQM UNAVAILABLE TRACE DATA SET xxxxxxxx.
| A /DIAGNOSE SNAP BLOCK(SQM)
| command was issued when the SQM Explanation: An open or close failed for the listed
| control block was not available or not data set. This message should have been preceded by a
| defined. system error message.
| TSCD UNAVAILABLE System action: If disk data sets are used, IMS tries to
| A /DIAGNOSE SNAP BLOCK(TSCD) continue using the remaining disk. If no more disks are
| command was issued when the TSCD available or if tape is used, IMS asks the operator for
| control block was not available or not permission to log IMS trace tables to the OLDS. If the
| defined. failing data set cannot be closed and deallocated, the
| UNABLE TO GET DIAG TRACE TABLE failing data set is unusable until IMS is restarted. See
| A /DIAGNOSE SNAP command was DFS2867A for more information about logging IMS
| issued with OPTION(TRACE) when a trace tables to the OLDS.
| DIAG trace table was not available
| for use. Related information:
“DFS2867A” on page 571
System action: The specified /DIAGNOSE command
does not complete.
DFS2863I LOGGING IMS TRACE TABLES TO
System programmer response: No action is required. EXTERNAL TRACE DISK/TAPE DATA
Module: DFSDGST0, DFSDGSN0, DFSDGS10, SET.
DFSDGS94, DFSDGS92, DFSDGSB0, DFSDGS20, Explanation: This is a notification that IMS is logging
DFSDGS00 the IMS trace tables to an external trace data set and
not to the online log (OLDS).
DFS2860W EXTERNAL TRACE DATA SET
LOGGING NOT AVAILABLE - DFS2864I EXTERNAL TRACE DATA SET
REASON - N. xxxxxxxx FULL - SWITCHING TO
Explanation: IMS cannot use the external trace data yyyyyyyy.
sets. N specifies one of the following reasons: Explanation: Disk data set xxxxxxxx is full, and IMS is
v No storage is available for the output buffers in switching to the data set yyyyyyyy.
control region 24-bit private storage.
v The block size of the output data sets is less than Programmer response: If the data on the full data set
4008 bytes. is wanted, it must be copied to another data set or
v No external trace data sets are left. This message is printed. As soon as data set yyyyyyyy is full, IMS
usually preceded by another message reporting an switches back to data set xxxxxxxx.
error condition.
| Both external trace data sets must have the same block Programmer response: Resubmit the job with an
| size of at least 4020. alternate log data set.
Operator response: Determine the cause of the write Explanation: The tracking subsystem read attempt to
error by analyzing the BSAM post code, and consult a tracking log data set failed. synad string is bytes 68
MVS/XA Data Facility Product Version 2: Diagnosis through 136 of the message buffer returned from the
Reference and MVS/XA Data Facility Product Version 2: SYNADAF macro. It contains information about the
Diagnosis Guide. data set which has the error.
Related information:
DFS2917I UNABLE TO FILL GAPS FOR PRILOG
“DFS2909I” on page 574 TOKENS SMALLER THAN token
Explanation: The tracking subsystem was unable to
DFS2916W ERROR DETECTED DURING fill missing log gaps that have PRILOG tokens smaller
TRACKING LOG WRITE FUNCTION than token. Logs with these PRILOG tokens were
INVOCATION, RC = nnnnnnnn deleted at the active site.
Explanation: The tracking subsystem was unable to System action: The tracking subsystem continues
create the function which writes log buffers received processing with no further attempts to obtain the
from an active subsystem to a tracking log data set. unavailable logs.
01 Parameter error, function terminates. Internal
IMS logic error, refer problem to IBM. Operator response: If the unavailable log data is
02 No initialization done for tracking log write required for shadow databases or areas, you must
function; function terminates. Internal IMS obtain new image copies of the databases or areas from
logic error, refer problem to IBM. the active site.
03 Unable to determine data set type for tracking Module: DFSLRICM
log; function terminates. Internal IMS logic
error, refer problem to IBM.
04 Unable to obtain DBRC communication area DFS2918A READ ERROR, TRACKING LOG
for tracking log write function. The function MARKED IN ERROR IN RECON:
terminates. Resolve Extended CSA storage dsname
constraint. Explanation: A tracking subsystem read from tracking
05 Unable to create IMS tasks for tracking log log data set dsname failed because all copies of the
write function, function terminates. Internal tracking log data set have an error status in the
IMS logic error, refer problem to IBM. RECON data set.
07 No tracking log data set was created for the
tracking log write function, function System action: One of the following:
terminates. v If the read is for an online forward recovery of a
08 Attempt to notify DBRC of data in tracking database or area, the recovery is terminated.
log data set failed for open of tracking log v If the read is for a log truncation, the tracking
data set. Internal IMS logic error; refer subsystem abnormally terminates with abend 0381,
problem to IBM. reason code 1F.
0A Write error detected. See message DFS2909I for v If the read is for routing during normal processing,
information about the write error. routing stops.
0B Invalid data in buffer detected while writing v If the read is for routing during restart, the tracking
to tracking log data set. No action required. subsystem might abnormally terminate with abend
0C Unable to switch to new tracking log data set 0380, reason code 1C.
after filling current tracking log data set.
Operator response: Resolve the condition that caused
Tracking log write attempt is terminated.
the tracking log to be marked in error in the RECON
0D Unable to obtain storage to initiate filling of a
data set.
gap between tracking log data received from
active site. Resolve storage constraint. If /DIS TRACKING STATUS commands indicate that
0E Unable to obtain storage by IMODULE. routing stopped, the user must either issue the /STOP
Resolve storage constraint. SERVGRP and /START SERVGRP commands to restart
0F Attempt to notify DBRC of data in tracking routing or shut down the tracking subsystem and
log data set failed for close of tracking log restart.
data set. Internal IMS logic error; refer
If an OFR process terminated early and this message
problem to IBM.
was issued, reissue the/START DB, UPDATE DB
System action: Tracking log write attempt fails except START(ACCESS), /START AREA, or UPDATE AREA
for return codes 09, 0A, and 0B. START(ACCESS) command.
Operator response: See the individual reason codes If the tracking subsystem terminated abnormally
above for user response. during unplanned takeover and this message was
issued, make sure the required tracking log is not
Module: DFSLRSAR, DFSLRSIN
marked in error in the RECON data set before
Related information: restarting the tracking subsystem.
“DFS2909I” on page 574
Module: DFSLRRDS
Related information:
Abend 0379
DFS2923I PROCLIB MEMBER DFSRSRXX IS
REQUIRED FOR A TRACKING
SUBSYSTEM DFS2925I SLDSDEF STATEMENT MUST BE
SPECIFIED IN PROCLIB MEMBER
Explanation: A tracking IMS subsystem was unable to DFSRSRXX
open the DFSRSRxx PROCLIB member. This member is
required for an RSR tracking subsystem. Explanation: An IMS tracking subsystem was started,
but the SLDSDEF statement was omitted from the
System action: IMS terminates with an abend 0071. DFSRSRxx PROCLIB member. This statement is
required.
Operator response: Ensure the correct DFSRSRxx
member suffix is specified on the RSRMBR= exec System action: IMS terminates with a 0071 abend.
parameter in the IMS procedure; the default is 00.
Ensure that the specified DFSRSRxx member exists and Operator response: Correct DFSRSRxx PROCLIB
is in a data set that is properly concatenated with the member and resubmit the job.
IMS.PROCLIB data set specification. Correct any Module: DFSRSRI0
problems with this data set and resubmit the IMS job.
Related information:
Module: DFSRPP00
Abend 0071
Related information:
yyyyyyyy
DFS2930I INITIALIZATION FAILURE -
The failure return code from the requested
mmmmmmmm,xxxx,yyyyyyyy,zzzzzzzz-
service.
ccccc
zzzzzzzz
Explanation: IMS initialization failed for module The failure subcode from the requested service
mmmmmmmm. (if applicable).
ccccc Optional text that provides further explanation
In the message text:
of the error.
xxxx The failure reason code (also found in register
15 at the time of abend). See Table 16 for a
description of the reason code and the
requested service.
0011 DFSDREF0 Unable to process the DFSDRFxx member of the IMS PROCLIB
data set.
0012 DFSXRLM0 Unable to initialize the IRLM.
0013 DFSSTKI0 Unable to initialize the IMS Stack Storage Manager. Possible reason
codes are:
00000001
IMODULE GETMAIN failed for the main stack storage
control block (SCDSTK). zzzzzzzz contains the return code
from IMODULE GETMAIN.
00000002
IMODULE LOAD failed for the message service modules
(DFSMSGC0 and DFSMSGF0). zzzzzzzz contains the return
code from IMODULE LOAD.
0014 DFSMSGI0 Unable to initialize IMS message services. Possible reason codes are:
00000001
IMODULE GETMAIN failed for the message service
control block (MSCB). zzzzzzzz contains the return code
from IMODULE GETMAIN.
00000002
IMODULE LOAD failed for the message service modules
(DFSMSGC0 and DFSMSGF0). zzzzzzzz contains the return
code from IMODULE LOAD.
00000003
IMODULE LOAD failed for the message service text
module (DFSMSGTX). zzzzzzzz contains the return code
from IMODULE LOAD.
Module: DFSLRCAS
DFS2931I IMS HAS BEEN NOTIFIED THAT
TRANSPORT MANAGER HAS
TERMINATED DFS2934I LOG TRUNCATION STARTED FOR
IMS: instance name
Explanation: The tracking subsystem has been
notified, by the Transport Manager Subsystem (TMS) Explanation: The tracking subsystem has started the
status exit, that the transport manager subsystem has log truncation process on behalf of the active
terminated. subsystem (instance name) listed in the message.
System action: The tracking subsystem continues If the active subsystem is XRF capable, the instance
processing with the existing conversations. New name is appended with the character -, followed by the
conversations are not established. single character HSBID.
Operator response: After starting the transport System action: Processing continues.
manager subsystem, issue the /STOP SERVGRP
followed by /START SERVGRP commands on the Module: DFSLRLTS
tracking subsystem to establish conversations with the
active site. To avoid creating gaps in the log data being DFS2935I TRACKING LOG DATA SETS HAVE
received, you can delay issuing these commands as BEEN TRUNCATED AT lsn:
long as new conversations with active systems or with
isolated log sender are not needed. Explanation: The tracking subsystem has completed
the log truncation process for the data sets listed in the
Module: DFSLRMST DFS2936I message. If any of the tracking log data sets
listed in the message have been archived and the
DFS2932I DATABASE UPDATES PRIOR TO corresponding recovery log data sets (RLDSs) created,
SYSTEM imsidaction HAVE BEEN the entire RLDS are removed from the RECON data set
ROUTED by DBRC. The PRILOG and PRISLDS entries in the
RECON are the output data set created by the
Explanation: All active log buffers containing database truncation process. No RLDSs are created during
updates for the active subsystem imsid have been truncation.
written to active logs, transported to the tracking
subsystem, and routed to the database tracker lsn is the last log sequence number that is allowed to
components. be applied to the databases or areas at the tracking site
for the corresponding active IMS subsystem.
In the message text, action can be one of the following
values: System action: Processing continues.
SHUTDOWN Module: DFSLRLTR
if a shutdown /CHECKPOINT (FREEZE or
Related information:
DUMPQ) command was issued on the active
subsystem. “DFS2936I”
TAKEOVER
if a /RTAKEOVER command was issued for DFS2936I dsname
the active subsystem
Explanation: The tracking subsystem has completed
System action: Processing continues. the log truncation process for the data set (dsname) This
Module: DFSST500 message accompanies message DFS2935I. If recovery
log data sets (RLDSs) are being truncated, they will be
listed after the system log data sets (SLDSs) in the
DFS2933I UNPLANNED TAKEOVER LOG message.
TRUNCATION POINT: hhhhhhhh
hhhhhhhh System action: Processing continues.
System action: The tracking subsystem continues with Explanation: This message indicates whether a
unplanned takeover shutdown processing. tracking MODSTAT data set has been updated (ACTIVE)
or not updated (INACTIVE). In an XRF environment,
Operator response: No action is required.
tracking information is written to the first data set system terminates after issuing this message, then it
(MODSTAT) and a null record is written to the second must be restarted. A normal shutdown is automatically
data set (MODSTAT2). performed after the restart completes.
The named libraries reflect the most current Module: DFSICM30, DFSIRST0
information received by the tracking system. sysid is the
8-byte RSENAME (XRF) or SCDIMSID (non-XRF) of the
DFS2940 DBRC PLANNED TAKEOVER
tracked IMS system.
REQUEST FAILED, RC=nn
The accuracy of this message can be affected by
Explanation: A request for planned takeover was not
missing log data.
granted by DBRC. The reason code indicates the type
System action: Processing continues. of failure that occurred:
Programmer response: Verify that the named libraries Reason code
are correct before starting an active IMS after remote Description
takeover. 08 There is at least one subsystem record in the
RECON data set marked “abnormally
Module: DFSST500
terminated”
12 There are no GSG records in the RECON data
DFS2938W MODSTAT error ERROR FOR set This should not occur. DBRC will not allow
DDNAME=dddddd, SYSID=sssss. an RSR system to be started without GSG
records in the RECON, and once an RSR
Explanation: A MODSTAT data set error occurred. system is running, these GSG records cannot
error indicates the type of error (ALLOCATE, OPEN, be deleted.
READ, WRITE) and dddddd indicates the dynamic 44 DBRC internal error
allocation member name used when the error occurred. 48 Invalid invocation
This message is only issued when the error first occurs.
The MODSTAT data set is associated with active System action: The command is rejected.
system, sssss, being tracked.
Operator response:
System action: Processing continues. An attempt is
Reason code
made to retry the data set update each time the active
Action
system makes an online change or takes a system
08 Restart the subsystem which abnormally
checkpoint.
terminated, then terminate it gracefully. Then
Programmer response: Verify the dynamic allocation retry the planned takeover.
member name. This name must match the name 12 Internal IMS error. Report problem to IBM.
specified in the DFSRSRxx member at the active site. 44 Internal IMS error. Report problem to IBM.
Verify that the data set pointed to by the dynamic 48 Internal IMS error. Report problem to IBM.
allocation member is available for update. See the
Module: DFSICM30
DFS2937I message for data set status.
Module: DFSST500
DFS2941W TERMINATING TRACKING LOG
Related information: WRITE ATTEMPT EARLY, RC =
“DFS2937I” on page 585 nnnnnnnn
Explanation: An error was detected while writing to a
DFS2939I REMOTE SITE PLANNED TAKEOVER tracking log data set. nnnnnnnn is the return code:
IN PROGRESS 01 Required tracking log write-related control
block not supplied with request.
Explanation: An /RTA FREEZE or /RTA DUMPQ 02 No initialization done for tracking log write
command has been issued on the active system and the function.
active has begun shutdown processing. This message is 03 Unable to determine data set type for tracking
initially issued by the command processor. However, if log (tracking SLDS, archive SLDS, or RLDS).
the active system should terminate before shutting 04 Unable to obtain ECSA storage for
down, then this message is also issued during a communication with DBRC.
subsequent restart; the system begins to shut down 05 Unable to create IMS tasks for tracking log
because a planned takeover must have a normal write function.
shutdown in order to complete. 06 The RSR tracking IMS is unable to obtain a
System action: Processing continues. buffer while processing an active site log
record, which represents a /DBR command
System programmer response: If the system shuts with a forced end of volume, FEOV. The write
down properly after issuing this message, then you can attempt is terminated and is retried
take steps to start a new active at the remote site. If the automatically. No further action is necessary.
transported using the log to the remote site, a cold start Operator response: No action is required.
of the Transaction Manager component will be
Problem determination: 1, 5, 6, 12, 14
necessary.
Module: DFSCVFJ0, DFSCVHC0, DFSCMSW0
System action: The restart is terminated and the
system waits for another restart command. Related information:
Chapter 2, “IMS problem determination,” on page 5
Programmer response: Issue another restart command
as appropriate.
DFS2950A A CHECKPOINT REQUIRED TO
Module: DFSRST00
SATISFY RESTART IS NOT
AVAILABLE ON SYSTEM LOG
DFS2948I RESYNCHRONIZATION REJECTED,
Explanation: An attempt was made to start a
NODE nodename. INPUT/LASTI:
subsystem, active or tracker, but the checkpoint
aaaa/bbbb, OUTPUT/LASTO: cccc/dddd
required to satisfy the request, usually the cold start
checkpoint, is not on the system log. This situation can
or
happen because PRILOG records were deleted from the
RECON or from remote takeover scenarios.
RESYNCHRONIZATION REJECTED, LINK link.
INPUT/LASTI: aaaa/bbbb, OUTPUT/LASTO: cccc/dddd, System action: The restart is terminated and the
BLOCKID eeee system waits for another restart command.
Explanation: For the NODE nodename form of the Programmer response: Issue another restart command
message, the node rejected the IMS “set and test as appropriate.
sequence number” request while attempting to
Module: DFSRBCP0
reestablish the session. The sequence numbers at the
time of error are shown in the message.
For the LINK link form of the message, the message
sequence numbers from the partner side of an MSC
BISYNC, CTC, or MTM link do not match the sequence
numbers on this side. The sequence numbers at the
time of error are shown in the message.
LASTI is the sequence number of the last data block
received
INPUT is the sequence number of the last recoverable
message received and enqueued to the
message queue
LASTO
is the sequence number of the last data block
sent
OUTPUT
is the sequence number of the last recoverable
message sent, acknowledged, and dequeued
from the message queue
BLOCKID
is the sequence number of the last recoverable
message received and enqueued by the partner
IMS (that is, the INPUT number from the
partner side of the link)
If you route the INITIATE OLC PHASE(COMMIT) 02 The IMODULE GETMAIN macro returned a
to the new active subsystem, it will fail because the nonzero return code. There is no work storage
new active subsystem is not in an online change available.
state. 03 An error occurred during AREA open. For
additional information, see the previously
If you issue a TERMINATE OLC command to issued messages.
terminate the OLC, it will fail as the online change 04 Online forward recovery (OFR) does not occur
is committed and the OLCSTAT is updated. for an RCVTRACK area.
| 4. If the QUERY OLC LIBRARY(OLCSTAT) 05 DBRC encountered an error during USID
| SHOW(MBRLIST) command displays the IMSID of validation. For additional information, see
| the old XRF active in the member list, but not the message DFS2965A.
| IMSID of the new XRF active, then the old XRF 06 An error occurred during AREA open. For
| active IMSID must be deleted from the OLCSTAT additional information, see message DFS3709.
| data set and the new XRF active IMS ID must be 07 DBRC encountered an error while being
| added to the OLCSTAT data set. You must make notified that an active system was taking the
| this change before you run the next INIT OLC AREA offline. For additional information, see
| PHASE(PREPARE) command. Run the Global message DFS2967A.
| Online Change utility (DFSUOLC0) to add the 08 Update log records of the AREA exist in the
| IMSID of the new XRF active. If you are using data space but no action was taken for them;
| ACBMBR online change, run DFSUOLC0 to delete this problem might be a logic error.
| the old IMSID. If you are using global online 09 An error occurred during AREA authorization
| change, you can either run DFSUOLC0 to delete the for the online forward recovery (OFR) process.
| old IMS ID, or specify OPTION(FRCABND) on the INIT 10 An error occurred during AREA open. For
| OLC PHASE(PREPARE) command. additional information, see message
DFS3709A.
Module: DFSOLCS0 11 DBRC encountered an error while being
notified that online forward recovery had
completed for the AREA. For more
DFS2959I TERMINATING OFR DUE TO
information, see message DFS2968A.
STARTPOINT PROCESSING ERROR
12 The Log Router detected an error or unfilled
Explanation: The Remote Site Recovery Online GAP while processing OFR for the AREA.
Forward Recovery (OFR) process has detected an OFR terminates for the AREA.
inconsistency with a stream's startpoint list such that 13 A severe I/O error occurred for the shadow
the information in the current list does not agree with database. OFR terminates for the AREA.
the position that the process has reached so far. If the 14 The OFR request was rejected for the AREA.
process was allowed to continue the database or For more information, see message DFS2982E.
databases would be corrupted.
System action: The shadow database (area) is stopped.
System action: The OFR Startpoint list is logged,
Operator response: Correct the error indicated by nn
either a 3757, 3758, or 3759 trace record is created, and
and recover the AREA by online forward recovery
the OFR process is terminated.
(OFR).
Operator response: Collect the tracking subsystem
For RC of 12, confirm that GAP is filled and rerun the
RECON listing and log data and call IBM Software
OFR.
Support to report the problem. In most cases starting
the databases again to restart the OFR will result in Module: DBFDT180
successful OFR completion. Related information:
Module: DFSLRORM, DFSLROPR “DFS2965A” on page 592
“DFS2967A” on page 592
DFS2960A AREA areaname STOPPING. RC=nn “DFS2968A” on page 593
Explanation: An error has been detected by Fast Path “DFS2982E” on page 596
database tracking. The area, indicated by areaname, is “DFS3709A” on page 748
stopped. The reason code,nn, indicates the type of
failure that occurred:
DFS2961I AREA areaname IS STOPPED
Reason code
Description Explanation: Internal Area stop request or
01 The DFSDSM OBTAIN macro returned a /DBRECOVERY AREA command is completed. The
nonzero return code. There is no space left in area is now stopped. This message might be preceded
the data space. by message DFS2960A. See message DFS2960A for
reasons.
System action: Stop of the area is completed. the current stream of log records cannot be applied.
Module: DBFDT180 In the message text:
Related information: areaname
The area name of the shadow database.
“DFS2960A” on page 591
nn The DBRC return code. For these codes, see
the DBRC return code information.
DFS2962I AREA areaname IS ALREADY STOPPED uuuuuuuu
The update set identifier (USID) for the
Explanation: This message appears when specified database.
/DBRECOVERY AREA is entered for an area that is yydddfhhmmsst
already stopped. The PRILOG start time.
System action: /DBRECOVERY command is ignored. llllllll The low four bytes of the log sequence
number for the area specified by areaname.
Module: DBFDT180
System action: Stop of the shadow database (area) is
initiated.
DFS2963A AREA areaname IS NOT DEFINED
Operator response: Contact IBM Software Support.
Explanation: Log data for the specified AREA was
passed to tracking logic, but the AREA was not defined Module: DBFDT300
in the tracking IMS subsystem. Related reference:
System action: The log data is ignored, no database DBRC request return codes (Messages and Codes)
tracking is performed using the referenced log data.
This message is produced each time that tracking
processes a record indicating the beginning of update DFS2966A END OF LOG STREAM
activity for a covered AREA when the AREA is not NOTIFICATION FAILED. RC=nn
defined to the tracking subsystem. PRILOG=yydddfhhmmsst.
Explanation: A /DBR command has been entered on System action: The system issues abend 3093 with a
an IMS tracker system for a shadow database before subcode 05.
the database stop processing completed for a previous Operator response: Call IBM Software Support for
/DBR command that was issued for the same shadow assistance.
database.
Module: DBFDT300
System action: The /DBR command is rejected for the
listed database and /DBR processing continues. Related reference:
Message DFS4055I is issued when the stop database DBRC request return codes (Messages and Codes)
processing is complete.
Related information:
Operator response: Wait for the previous /DBR
command to complete. IMS abend 3093
Module: DFSDT180
DFS2967A END OF UPDATE NOTIFICATION
Related information:
FAILED. AREA areaname RC=nn
“DFS4055I” on page 823 LSN=llllllll PRILOG=yydddfhhmmsst
Explanation: The attempt to notify DBRC that the
DFS2965A USID VALIDATION FAILED. AREA specified AREA has been taken offline by the active
areaname RC=nn USID=uuuuuuuu subsystem (for example, /DBR) failed.
PRILOG=yydddfhhmmsst LSN=llllllll
In the message text:
Explanation: DBRC was requested to validate the areaname
current stream of log records to be applied to the The area for which notification to DBRC failed.
specified shadow database. The validation failed and
nn The DBRC return code. For these codes, see Module: DBFDT180
the DBRC return code information. Related reference:
llllllll The low four bytes of log sequence number.
yydddfhhmmsst DBRC request return codes (Messages and Codes)
The PRILOG start time. Related information:
System action: Stop of the shadow database (area) is
IMS abend 3094
initiated.
Operator response: Call IBM Software Support for
DFS2970I OLR STARTED | RESUMED FOR
assistance.
NAME=partname MASTER=mastername
Module: DBFDT300 PST=pstnumber
Related reference: Explanation: HALDB Online Reorganization has
started or resumed for the named partition. The
DBRC request return codes (Messages and Codes)
message text includes the name of the master
(mastername) and the program specification block
DFS2968A END OF OFR NOTIFICATION FAILED. number (pstnumber).
AREA areaname RC=nn OFRID=rrrr
Important: This message is issued after the type-1 or
Explanation: The attempt to notify DBRC, when
type-2 INIT OLREORG command is processed to the
notified by log router, of the end of an online forward
extent that OLREORG ownership is established in
recovery (OFR) for an AREA failed.
RECON. If the online reorganization cursor is active
In the message text: then RESUMED is indicated; otherwise, STARTED is
areaname indicated.
The area for which notification to DBRC failed.
System action: IMS continues processing.
nn The error return code from DBRC indicating
that an internal error has been detected when Module: DFSORP00
log router started DBRC. For these codes, see
the DBRC return code information.
DFS2971W OLR INITIALIZATION|RESUMPTION
rrrr The OFR identifier.
FAILED FOR NAME=partname
System action: Stop of the shadow database (area) is MASTER=mastername PST=pstnumber
initiated. RC=xx RS=yy
Operator response: Call IBM Software Support for
or
assistance.
Module: DBFDT300 OLR TERMINATED FOR NAME=partname
Related reference: MASTER=mastername PST=pstnumber RC=xx RS=yy
DFS2969A END OF TRACKING NOTIFICATION DFS2971W OLR WILL NOT BE RESUMED FOR
FAILED. AREA areaname RC=nn NAME=partname MASTER=mastername PST=pstnumber
RC=xx RS=yy
Explanation: The attempt to notify log router when
the specified shadow database became unavailable (for Explanation: First form of the message: For the reason
example /DBRECOVERY on tracking subsystem or I/O indicated by the return and reason codes, the HALDB
error) failed. online reorganization did not complete the OLR
initialization process to either start or resume the OLR.
In the message text:
areaname Second format of the message: For the reason indicated
The area for which the attempt to notify the by the return and reason codes, the OLR terminated
log router failed. before all records were copied from the input to the
nn The DBRC error return code, which indicates output set of data sets.
that an internal error has been detected, when The message text includes the name of the master
log router started DBRC. For these codes, see (mastername), the program specification block number
the DBRC return code information. (pstnumber), and the return and reason codes. For the
System action: Abend 3094 with subcode 03 is issued. exact cause of the termination, see the return and
reason codes in the following table:
Operator response: Call IBM Software Support for
assistance.
10 nnnn Pseudoabend during partition selection (decimal value). The value of nnnn
(module: is the abend code returned by the issuing module. For more information
DFSORP10) about the cause of the abend, see IMS abend codes (Messages and Codes).
| 1C nnnn Backout failure. The value of nnnn is the abend code returned by the
(module: issuing module. For more information about the cause of the abend, see
DFSORP10, for IMS abend codes (Messages and Codes).
errors detected in
DFSORP30) 02 OLR terminated by a /TERMINATE OLREORG command with the FORCE
option
03 Key with all X'FF' found, or error doing chain maintenance
04 OLR termination with the ABORT was initiated.
The value of nnnn is the abend code returned by the issuing module. For
more information about the cause of the abend, see IMS abend codes
(Messages and Codes).
28 04 The OLR for the named partition is not automatically resumed during the
(module: restart of the failed subsystem due to Fast Database Recovery processing.
DFSORP10,
DFSDOCA0)
Important: A PST=00000 indicates the DFS2971W Second form of the message: The cursor-active status
message was issued when not running under a for the partition was already recorded in the RECON,
dependent region PST, such as during Fast Database and the database records in the partition are still
Recovery processing or during OLR initialization before contained in two sets of data sets, both of which are
ITASK creation. required for continued use of the partition.
System action: First format of the message: For an System programmer response: After the problem is
INITIATE OLREORG command that tried to start a corrected, start or resume the HALDB online
new online reorganization, the cursor-active status is reorganization with the INITIATE OLREORG command
not recorded in the RECON. In this case, the database or else run an offline reorganization.
records in the partition are still contained in the
Problem determination: 1, 6, 27
original set of data sets that were in use before the
command was entered. Module: DFSORP00, DFSORP10 (For errors detected
in DFSORP20, DFSORP30)
For an automatic or command-initiated resumption of
an online organization for which the cursor-active Related concepts:
status was already recorded in the RECON:
IMS abend codes (Messages and Codes)
v The cursor-active status is still in effect.
v The database records in the partition are still Related information:
contained in two sets of data sets, both of which are Chapter 2, “IMS problem determination,” on page 5
required for continued use of the partition.
v No additional database records were copied from the
input to the output set of data sets. DFS2972E OLR PSB BUILD FAILED. reason
Explanation: IMS was building an internal PSB for an
online reorganization. This process encountered the these data sets are no longer in use, delete them.
error indicated by reason, which is one of the following:
Module: DFSORP40
v DATA BASE IS NOT A PARTITION
v MASTER IS NOT PARTITIONED
v GETMAIN FAILED FOR PSB DFS2974I OLR COMPLETED FOR
v DMB LOAD FAILED NAME=partname MASTER=mastername
| v HALDB STRUCTURE NOT ACTIVE PST=pstnumber
System action: The online reorganization is Explanation: HALDB Online Reorganization has
abandoned, and the must-complete status is not recorded completed for the named HALDB partition. The
in the RECON. message text includes the name of the master
(mastername) and the program specification block
| Programmer response:
number (pstnumber).
| For DMB LOAD FAILED, ensure that the ACBLIB
System action: IMS continues processing.
| contains the DMB with the name of the HALDB master.
Module: DFSORP10
| For GETMAIN FAILED FOR PSB, storage might be
| constrained so run the online reorganization later.
DFS2980E AREA areaname IS NOT STOPPED.
| For HALDB STRUCTURE NOT ACTIVE, if the Online
INVALID FOR OFR
| Reorganization (OLR) is being resumed during IMS
| /ERE, ensure that the ACBLIB used at restart is the Explanation: A /START AREA or UPDATE AREA
| same ACBLIB used by IMS before termination. START(ACCESS) command was entered to request
online forward recovery (OFR) for the area, but the
| The other errors are probably IMS errors, so contact
status of the area was not STOPPED.
| IBM Software Support.
System action: /START command for the area is
Module: DFSOPSB0
ignored.
Operator response: If OFR is required for the area,
DFS2973W NO RESPONSE FROM SHARING IMS
/DBR the area and then enter the command again.
AFTER ONLINE REORG.
PART=partname Module: DBFARDA0
Explanation: HALDB online reorganization has
completed the copying phase for the named HALDB DFS2981E AREA areaname IS NOT REGISTERED
partition and the inactive data sets are to be deleted. WITH DBRC. INVALID FOR OFR
Data set deletion was attempted because OPTION(DEL)
was specified or defaulted on the INITIATE OLREORG Explanation: A /START AREA or UPDATE AREA
command or was subsequently specified on the START(ACCESS) command was entered to request
UPDATE OLREORG command. However, before data online forward recovery (OFR) for the area, but the
set deletion was attempted, all sharing IMS systems area is not registered with DBRC.
were notified. All sharing IMS systems must indicate System action: /START command for the area is
that they are no longer using these data sets. One or ignored.
more of these systems did not respond even after three
requests. Operator response: Register the area with DBRC and
then enter the command again.
System action: IMS already reset the cursor-active
status for the partition in the RECON and the database Module: DBFARDA0
records in the partition are now contained in the single
set of data sets to which these records were copied. To DFS2982E OFR REQUEST FOR AREA areaname
complete the processing, IMS attempts to delete the REJECTED BY DBRC. RC=nn
inactive data sets even though not all sharing IMS
systems responded. An error might result during data Explanation: The request for Online Forward
set deletion if some job, such as an IMS batch job, has Recovery (OFR) for the area is rejected by DBRC. nn is
the data sets allocated but is unable to respond within the reason code from DBRC. The reasons codes (nn)
the time allowed for a response. If this situation are:
happens, one or more of the inactive data sets are not Reason code
deleted, but the online reorganization completes Explanation
anyway.
01 The area is not registered to DBRC at the tracking
System programmer response: Check the MVS system site.
console log to determine whether error messages
indicate that any of the inactive data sets from the 02 The area is not a member of the same Global
HALDB online reorganization were not deleted. After Service Group as the tracking subsystem.
Table 18. Publications that contain macro information v Was not of a type that could be used for the
applicable data set
Macro Publication
v Had certain characteristics that did not
DEVTYPE DEVTYPE Macro Specification in z/OS match those of the corresponding input data
DFSMSdfp Advanced Services (SC26-7400) set at the active site
v Did not exist
GETDSAB GETDSAB - Accessing the DSAB Chain in
z/OS MVS Programming: Authorized
Assembler Services Reference Vol 2 In all of the preceding cases, reasoncode is a reason code
(SA22-7610) for the specific problem.
LOCATE Return Codes from LOCATE in z/OS The following table shows the definitions of the
DFSMSdfp Advanced Services (SC26-7400) possible reason codes.
OBTAIN Reading DSCBs from the VTOC Using
OBTAIN in z/OS DFSMSdfp Advanced In the table, the Environment column indicates whether
Services (SC26-7400) the error is detected at the beginning of one or more of
the following activities:
SWAREQ The SWAREQ Macro in z/OS MVS
Programming Authorized Assembler Services v HALDB online reorganization
Guide (SA22-7608) v The tracking of an online reorganization at the RSR
tracking site
TRKCALC TRKCALC Macro Specification in z/OS
DFSMSdfp Advanced Services (SC26-7400) Table 19. Reason codes, environments, and errors
detected for message DFS2991I
If the error was detected in processing the INITIATE Reason
code Environment Errors detected for preexisting data set
OLREORG command, reissue the command for
partition partname. 1 Any The data set is not a DASD data set.
2 Any The data set is a VSAM data set, but the
If the error was detected at the RSR tracking site, issue database is defined to use OSAM.
a /START DB command for the partition in order for 3 Any The data set is a PDS, PDSE, or a member
Online Forward Recovery (OFR) to continue updating of a PDS or PDSE.
the partition. 4 Tracking, The data set is not a VSAM ESDS, but the
Reorganization database is defined to use VSAM.
Module: DFSORA00, DFSORA10
5 Any The VSAM data set does not have the
REUSE attribute.
DFS2991E UNACCEPTABLE DATA SET, REASON 6 Reorganization The VSAM data set has a different record
CODE reasoncode. PART=partname length than that of the corresponding
input data set.
DSN=dsname
7 Reorganization The VSAM data set has a different control
Explanation: In determining whether to create the interval size than that of the
data set dsname for the HALDB partition partname, IMS corresponding input data set.
found either: 8 Reorganization The VSAM ESDS has a different control
v A data set of that same name. However, because of interval size than that of the
corresponding input data set.
certain characteristics of this preexisting data set, the
9 Reorganization The data set is not a VSAM KSDS. The
data set could not be used for the intended purpose.
primary index data set of a PHIDAM
v No data set of that name when there should have database must be a VSAM KSDS.
been a preexisting data set. 10 Reorganization The primary index data set of a PHIDAM
database (the KSDS), is defined with a
Case 1: In starting a HALDB online reorganization for different key offset or key length than that
the HALDB partition partname, IMS of the corresponding input data set.
determined that the data set that was to be 11 Tracking The VSAM data set has a different record
used as the output of the reorganization: length than that of the tracked output
v Was not of a type that could be used for the data set at the active site.
applicable data set 12 Tracking The VSAM data set has a different control
v Had certain characteristics that did not interval size than that of the tracked
output data set at the active site.
match those of the corresponding input data
set 13 Tracking The primary index data set of a PHIDAM
database (the KSDS), is defined with a
v Did not exist different key offset or key length than that
of the tracked output data set at the active
Case 2: On the RSR tracking site, IMS found that in site.
tracking database changes for a HALDB online
reorganization for the HALDB partition
partname, the data set that was to be used as
the shadow of an output data set:
Table 19. Reason codes, environments, and errors set for the database segments (one of the
detected for message DFS2991I (continued) A-through-J or the M-through-V data sets)
Reason
is:
code Environment Errors detected for preexisting data set – A DASD data set
18 Any Either: – Not a VSAM data set
v The data set is cataloged but it is not on – Neither a PDS, PDSE, or a member of a
the volume to which the catalog entry PDS or PDSE
refers.
Ensure that for a VSAM-defined database
or
v The data set was allocated with a DD
the output data set for the database
statement that had a VOLUME segments (one of the A-through-J or the
parameter, but the data set was not on M-through-V data sets) has the following
the referenced volume. characteristics:
19 Any The data set was allocated with a DD – VSAM entry-sequenced data set (ESDS)
statement, but the data set name in the – The REUSE attribute
DSNAME parameter does not follow the
data set naming convention defined for – A fixed-length record length identical to
the data sets of this partition. that of the input data set
20 Tracking, The output data set does not exist, but the – A control interval size that is identical to
Reorganization corresponding input data set resides on that of the input data set
multiple volumes and is not an
SMS-managed data set. Ensure that for a PHIDAM database the
22 Any An unexpected condition involving the output data set for the primary index (the X
HSM-migrated data set occurred after it or Y data set) has the following
was recalled. This condition is likely characteristics:
caused by an internal error.
– A VSAM key-sequenced data set (KSDS)
23 Reorganization The VSAM data set has a different control
– The same key offset, key length, and
with the interval size than what is specified for the
ALTER option data set in the ALTER BLOCK SIZE field record length as the corresponding input
of the partition record in the RECON data data set
set. – The REUSE attribute
24 Reorganization The data set has a block or control
with the interval size that is not large enough to
ALTER option hold the largest database segment that can
Then reissue the INITIATE OLREORG
be stored in this data set. command to start the HALDB online
reorganization for partition partname.
System action: If this error occurred in starting the Case 2: Before restarting the partition at the RSR
reorganization, then the reorganization is not started, tracking site, do one of the following:
but the partition remains accessible with the original v Delete the preexisting output data set at the
active set of data sets -- either the A-through-J and X tracking site, which allows IMS to create it
or the M-through-V and Y data sets. automatically. When IMS creates the data
set, the size and placement of the data set is
If this error occurred at the RSR tracking site, then the
determined automatically by IMS, MVS,
shadow partition is taken offline.
DFSMS/MVS and also by parameters
In any of these cases, one or more of the output data defined by the storage administrator.
sets could have already been created automatically. Therefore, do not let IMS create the data set
if you need precise control over the size and
Programmer response: placement of the data set.
Case 1: Before restarting the HALDB online v Create a data set that is acceptable for
reorganization, do one of the following: tracking the output of the reorganization.
v Delete the preexisting output data set, thus Ensure that for an OSAM-defined database
allowing IMS to create it automatically. the output data set for the database
When IMS creates the data set, the size, and segments (one of the A-through-J or the
placement of the data set is determined M-through-V data sets) at the RSR tracking
automatically by IMS, MVS, and site is:
DFSMS/MVS, and also by parameters – A DASD data set
defined by your storage administrator. – Not a VSAM data set
Therefore, do not let IMS create the data set – Neither a PDS, PDSE, or a member of a
if you need precise control over the size and PDS or PDSE
placement of the data set. Ensure that for a VSAM-defined database
v Create a data set that is acceptable as the the output data set for the database
output of the reorganization. Ensure that for segments (one of the A-through-J or the
an OSAM-defined database the output data M-through-V data sets) at the RSR tracking
site has the following characteristics:
– VSAM entry-sequenced data set (ESDS) information is in z/OS MVS System Messages Vol 6
– The REUSE attribute (SA22-7636) under message IDC3009I.
– The same fixed-length record length as
the tracked output data set at the active For the second form of the message (when the CSI
site (as shown in the X'2930' log record) return code, csireturncode is other than 4), a CSI error
– The same control interval size as the was detected. For CSI return code 8, csireasoncode is the
tracked output data set at the active site CSI reason code. Information about this CSI error
(as shown in the X'2930' log record) information is in z/OS DFSMS Managing Catalogs.
Ensure that for a PHIDAM database the
output data set for the primary index (the X These values were not expected by IMS.
or Y data set) at the RSR tracking site has System action: If this error occurred in starting the
the following characteristics: reorganization, then the reorganization is not started,
– VSAM key-sequenced data set (KSDS) but the partition remains accessible with the original
– The REUSE attribute active set of data sets: either the A-through-J and X or
– The same fixed-length record length as the M-through-V and Y data sets.
the tracked output data set at the active
site (as shown in the X'2930' log record) If this error occurred at the RSR tracking site, then the
– The same key offset, key length, and shadow partition is taken offline.
record length as the tracked output data In any of these cases, one or more of the data sets that
set at the active site (as shown in the were to have been created automatically could have
X'2930' log record) been created already.
Then issue a /START DB command for Programmer response: Based on value of the CSI
partition partname so that online forward return code, refer to z/OS DFSMS Managing Catalogs to
recovery can continue updating the partition. determine the cause of the error, and follow any
recommended actions.
Module: DFSORA00
Then if the error was detected in processing the
INITIATE OLREORG command, reissue the command
DFS2992E CSI RETURN CODE=4, [ { CATALOG for partition partname.
ERROR, | DATA SET ERROR, } ]
CATALOG MANAGEMENT RETURN If the error was detected at the RSR tracking site, issue
CODE=cmreturncode REASON a /START DB command for the partition in order for
CODE=cmreasoncode Online Forward Recovery to continue updating the
MODULE=cmmoduleid PART=partname partition.
DSN=dsname Module: DFSORA80
Related reference:
or
CSI Return Codes for General Purpose Register 15
CSI RETURN CODE=csireturncode [ REASON
CODE=csireasoncode ] PART=partname DSN=dsname CSI Return Codes 4 and 8
After the corrections are complete, restart the HALDB Explanation: IMS tried to delete the VSAM input data
online reorganization or rerun the DFS3PU00 utility, set dsname for the HALDB partition partname as part of
whichever was running at the time of the error. either:
v Completing a HALDB online reorganization for the
Module: DFSORA00 partition.
v Completing the tracking of these changes at the RSR
DFS2994E IDCAMS RETURN CODE returncode tracking site.
CREATING AN ONLINE REORG
OUTPUT DATA SET. PART=partname Access Method Services (IDCAMS) gave a return code
DSN=dsname of returncode.
Explanation: IMS tried to create the VSAM data set System action: The message, if any, produced by
dsname for the HALDB partition partname as part of IDCAMS was displayed before this message.
either:
The reorganization or the tracking of the reorganization
v Starting a HALDB online reorganization for the
at the RSR tracking site is still considered to have
partition.
completed successfully, and there is now a single new
v Tracking these changes at the RSR tracking site.
active set of data sets for partition partname--either the
A-through-J and X or the M-through-V and Y data sets.
Access Method Services (IDCAMS) gave a return code
of returncode. Programmer response: See z/OS MVS System Messages,
V6 (GOS-IEA) to determine the cause of the error, and
System action: The message, if any, produced by follow any recommended actions, then delete the data
IDCAMS was displayed before this message. set if it has not already been deleted.
For return code 4, the data set is assumed to have been Module: DFSORA20
created. In this case, none of the following actions
apply, and processing continues.
DFS2996E NOT ENOUGH DASD SPACE. ERROR
If this error occurred in starting the reorganization, REASON=X's99errorcode' [ SMS
then the reorganization is not started, but the partition REASON=s99ersn ] BLOCKS=blocks
remains accessible with the original active set of data BLKSIZE=blksize VOLUMES=volcount {
sets -- either the A-through-J and X or the M-through-V UNIT=SYSALLDA | STORAGE
and Y data sets. CLASS=storageclassname }
If this error occurred at the RSR tracking site, then the PART=partname DSN=dsname
shadow partition is taken offline. Explanation: IMS tried to create the OSAM data set
In any of these cases, if the data sets were to be created dsname for the HALDB partition partname as part of
automatically, one or more of the data sets might have either:
been created. v Starting a HALDB OLR for the partition.
v Tracking these changes at the RSR tracking site.
Programmer response: See the z/OS MVS System
Messages Vol 6 (GOS - IEA) (SA22-7636) to determine The internally executed DYNALLOC macro instruction
the cause of the error, and follow any recommended (SVC 99) that was used for this purpose reported that
actions. the data set could not be created because of DASD
Then if the error was detected in processing the space or DASD volume constraints. The requested
INITIATE OLREORG command, reissue the command space was blocks blocks, each with a block size of
for partition partname. blksize. There were volcount volumes requested.
If the error was detected at the RSR tracking site, issue If the text showing the group name (SYSALLDA)
a /START DB command for the partition in order for appears in the message text, the attempt was to create a
Online Forward Recovery to continue updating the non-SMS-managed data set because the corresponding
partition. input data set was not SMS-managed. If the text
Module: DFSORA20 showing the storage class appears, then the attempt
was to create an SMS-managed data set using storage
class storageclassname because the corresponding input
data set was SMS-managed and was created using that
storage class.
If the reorganization was being started, these space Then if the error was detected in processing the
allocation values were derived from the corresponding INITIATE OLREORG command, reissue the command
input data set. On the RSR tracking site, these space for partition partname.
allocation values were derived from the tracked output
data set at the active site where the reorganization If the error was detected at the RSR tracking site, issue
occurred. a /START DB command for the partition in order for
online forward recovery (OFR) to continue updating
For further information of this error, see the z/OS MVS the partition.
Programming: Authorized Assembler Services Guide
Module: DFSORA20
(SA22-7608). The value s99errorcode is the hexadecimal
value of the error reason code (field S99ERROR in the Related reference:
SVC 99 request block) that is provided when the
Interpreting Error Reason Codes from DYNALLOC
DYNALLOC macro instruction (SVC 99) fails with
return code 4. In the SMS case, s99ersn is the SMS
reason code (field S99ERSN in the SVC 99 request block IGD messages
extension). The SMS reason code corresponds to the
message number of an IGD message describing the
error. For further information about the IGD message, DFS2997E DATA SET ALLOCATED TO
see the z/OS MVS System Messages Vol 8 (IEF - IGD) ANOTHER JOB AND CANNOT BE
(SA22-7638). CREATED. PART=partname DSN=dsname
System action: If this error occurred in starting the Explanation: IMS tried to create the OSAM data set
reorganization, then the reorganization is not started, dsname for the HALDB partition partname as part of
but the partition remains accessible with the original either:
active set of data sets -- either the A-through-J and X v Starting a HALDB OLR for the partition.
or the M-through-V and Y data sets. v Tracking these changes at the RSR tracking site.
If this error occurred at the RSR tracking site, then the Creating the data set required that the data set be
shadow partition is taken offline. allocated as though DISP=NEW had been specified on a
In any of these cases, if the data sets were to have been DD statement through JCL. However, a data set of the
created automatically, one or more data sets might have same name was already in use by another job, causing
been created before the error occurred. the allocation to fail.
Programmer response: Determine whether the System action: If this error occurred in starting the
requested space (blocks blocks of size blksize) is required reorganization, then the reorganization is not started,
for the output data set. In some cases, this space but the partition remains accessible with the original
allocation request could include space acquired in a active set of data sets -- either the A-through-J and X
secondary allocation for the input data set and might or the M-through-V and Y data sets.
not be required for the reorganized database. Then If this error occurred at the RSR tracking site, then the
either: shadow partition is taken offline.
v Ensure that there is sufficient DASD space on the
volumes referenced by the group name SYSALLDA In any of these cases, other data sets might have been
(for the non-SMS-managed case) or referenced by the created before the error occurred.
storage class storageclassname (for the SMS-managed
Programmer response: Ensure that no other job is
case), possibly by scratching unneeded data sets. The
using a data set of the name dsname even if that data
primary allocation amount (blocks blocks of size
set is not cataloged and even if that data set is not
blksize) must be available in a total of no more than
intended to be the same data set as the output of the
five extents on a single volume. In the SMS-managed
reorganization.
case, if the storage class definition includes the
GUARANTEED SPACE attribute, then the primary Then if the error was detected in processing the
allocation amount must be available and is allocated INITIATE OLREORG command, reissue the command
on each of the volumes (rather than on just the first for partition partname.
volume).
If the error was detected at the RSR tracking site, issue
v Create and catalog this output data set yourself. In
a /START DB command for the partition in order for
this case, you can reserve whatever amount of space
OFR to continue updating the partition.
you choose, and you can control the number of
volumes. See Allocating OSAM data sets (Database Module: DFSORA20
Administration), for information about allocating
OSAM data sets along with a technique for
pre-allocating multi-volume data sets.
Reorganization cannot be used for this reorganization. System action: Processing continues.
System action: The step is abnormally terminated Programmer response: Increase Common Service Area
with abend 0310. (CSA) storage allocation.
Problem determination: 2, 3, 8, 17a, 18, 19, 35
Related information: DFS3023A MORE THAN 500 SCAN AND
RELOAD ACTIONS REQUIRED FOR
Chapter 2, “IMS problem determination,” on page 5
POINTER RESOLUTION
Explanation: The limit of 500 scan and reload actions
DFS3019 INSUFFICIENT STORAGE AVAILABLE
for logically related segment pointer resolution has
IN HIOP
been exceeded. Partial Database Reorganization cannot
Explanation: A command was not processed because be used for this reorganization.
there is insufficient storage in the communication
System action: The step is abnormally terminated
input/output pool, which resides above the 16
with abend 0310.
megabyte line (HIOP).
Problem determination: 2, 3, 8, 17a, 18, 19, 35
System action: The command is ignored.
Related information:
Programmer response: This condition can be a
Chapter 2, “IMS problem determination,” on page 5
temporary condition that can be resolved by reentering
the command later. If this fails, notify the system
programmer. DFS3024W RAS SECURITY HAS SUPPRESSED
NNNNNNNN ICH408I MESSAGES FOR
Module: DFSICLN2
REGION YYYYYYYY
Related information:
Explanation: RAS security has suppressed multiple
IMS abend 0310 ICH408I messages because there is a RACF definition
error for the identified dependent region. This message
is issued to let you know that RAS security is still
DFS3020 UNABLE TO OBTAIN AN AWE FROM
performing ICH408I message suppression for the
DFSBCB
dependent region and the number of ICH408I messages
Explanation: A command was not processed because suppressed.
an Asynchronous Work Element (AWE) could not be
In the message text:
obtained from IMS BCB services.
NNNNNNNN
System action: The command is ignored. The number of ICH408I suppressed
YYYYYYYY
Programmer response: This problem can be a The dependent region name
temporary condition that can be resolved by reentering
the command later. If this attempt fails, notify the System action: The unauthorized transaction remains
system programmer. in the message queue and could be processed by
another eligible dependent region or another IMS
system in an IMSplex. Processing continues.
DFS3021W DIRECT ADDRESS POINTERS IN
RELATED HISAM DATABASE dbdname Programmer response: Locate the preceding
NOT ALLOWED DFS2497W, message, which specified the unauthorized
transaction for the specified region. Follow the response
Explanation: A related HISAM database has direct in the information for DFS2497W to resolve the
address pointers to the primary database. Partial problem.
Database Reorganization cannot be used to do this
reorganization. Problem determination: 1, 5, 6, 27, 35, 36
Programmer response: If a PSB is required, rerun step Explanation: Module DFSPRWFM has encountered an
1 with PSB=psbname specified. error that prevents further processing.
System action: The step is abnormally terminated
DFS3028A UNSUCCESSFUL OPEN OF ddname with abend 0310.
DATA SET Programmer response: Perform IMS backout facility
Explanation: The system could not open the data set to undo changes.
identified in the message text by ddname. Problem determination: 2, 3, 8, 17a, 18, 19, 35
System action: The step is abnormally terminated Related information:
with abend 0310.
IMS abend 0310
Programmer response: Perform IMS backout facility Chapter 2, “IMS problem determination,” on page 5
to undo changes made in step 2 of Partial Database
Reorganization (PDBR). Ensure that DD statements for
this data set are included, and specifications are correct. DFS3033A DBDS DO NOT MATCH, STEP 1
Related information: DBD=dbdname, STEP 2 DBD=dbdname
Explanation: The DBD specified in the step 2 input is
IMS abend 0310
not the same as the DBD specified in step 1.
System action: PSBGEN is terminated because of
DFS3029A UNSUCCESSFUL WRITE TO ddname
specification error.
DATA SET
Programmer response: Correct the error in the control
Explanation: The named data set had a write error.
statement, and rerun the job.
System action: The step is abnormally terminated
with abend 0310.
Problem determination: 2, 3, 8, 17a, 18, 19, 35
Explanation: Open error on the index maintenance file toleration EEQEs. Then enter the command again.
has occurred.
Module: DBFARDC0
System action: The step is abnormally terminated
with abend 0310.
DFS3062I PRELOAD ACTIVE IN AREA=areaname,
Programmer response: Perform IMS Backout utility to COMMAND REJECTED
undo changes made during step 2 of Partial Database
Explanation: PRELOAD is active for area, areaname,
Reorganization (PDBR).
and the command was rejected to avoid an abend.
Problem determination: 2, 3, 8, 17a, 18, 19, 35
System action: The command is rejected.
Related information:
Programmer response: Reissue the command.
IMS abend 0310
Chapter 2, “IMS problem determination,” on page 5 DFS3063A DYNAMIC UNALLOCATION FAILED
FOR DD ddname
DFS3059A INVALID RECORD TYPE xx IN XWR Explanation: During database recovery, the Database
Explanation: An index work record was encountered Recovery utility was unable to deallocate the target
which contained a record type code that is not defined data set identified by ddname.
to the system. System action: The Database Recovery utility
System action: The step is abnormally terminated terminates abnormally with user code 0302. Register 15
with abend 0310. contains the DYNALLOC error reason code for
unallocation failure.
Programmer response: Perform IMS Backout utility to
undo changes made during step 2 of PDBR. Programmer response: Ensure that the image copy
data set was correct. If not, correct the JCL and
Problem determination: 2, 3, 8, 17a, 18, 19, 35 resubmit the job.
Related information:
Module: DFSURT00
IMS abend 0310 Related reference:
Chapter 2, “IMS problem determination,” on page 5
Interpreting Error Reason Codes from DYNALLOC
System action: Processing continues until all control statements have been analyzed. Then processing
statements have been analyzed. Then processing terminates.
terminates.
Programmer response: Correct the error in the control
Programmer response: Correct the error in the control statement, and rerun the job.
statement, and rerun the job.
DFS3091W DBDLIB DOES NOT CONTAIN
DFS3086W KEYWORD PREVIOUSLY SPECIFIED dbdname
KEYWORD: keyword
Explanation: The DBD for the database identified by
Explanation: The keyword indicated has been dbdname was not found in DBDLIB.
specified previously in another input statement and
System action: Processing terminates.
only one keyword of this type is allowed.
Programmer response: Correct the error in control
System action: Processing continues until all control
statement or DBDLIB, and rerun the job.
statements have been analyzed. Then processing
terminates.
DFS3092W DBD dbdname DOES NOT HAVE HD
Programmer response: Correct the error in the control
ACCESS METHOD
statement, and rerun the job.
Explanation: The DBD identified by dbdname is not an
HDAM or HIDAM database.
DFS3087W INVALID OPERAND
System action: Processing terminates.
Explanation: An invalid operand has been found for
the keyword indicated in the previous statement. Programmer response: Correct the error in the control
statement, and rerun the job.
System action: Processing continues until all control
statements have been analyzed. Then processing
terminates. DFS3093W DATA SET GROUPS(S) SPECIFIED ON
INPUT STATEMENTS DO NOT
Programmer response: Correct the error in the control
MATCH DBD dbdname
statement, and rerun the job.
Explanation: The data set groups used in the
TOAREA input statements are not the same as found in
DFS3088W MISSING KEYWORD: keyword
the DBD.
Explanation: The indicated keyword is missing.
System action: Processing continues until all control
System action: Processing continues until all control statements have been analyzed. Then processing
statements have been analyzed. Then processing terminates.
terminates.
Programmer response: Correct the error in the control
Programmer response: Correct the error in the control statement, and rerun the job.
statement, and rerun the job.
DFS3094W FROMAREA low block number TO high
DFS3089W FROMAREA, KEYRANGE, AND block number NOT IN ROOT
TOAREA ARE MUTUALLY ADDRESSABLE AREA
EXCLUSIVE
Explanation: The FROMAREA range specified is not
Explanation: Two of the keyword types, listed in the within the root addressable area of this database.
message, have been specified.
System action: Processing terminates.
System action: Processing continues until all control
Programmer response: Correct the error in the control
statements have been analyzed. Then processing
statement, and rerun the job.
terminates.
Programmer response: Correct the error in the control
DFS3095W NO RECORDS IN RANGE
statement, and rerun the job.
Explanation: No records were found in the range
specified by user control statement.
DFS3090W MORE THAN THE MAXIMUM OF 10
TOAREAS SPECIFIED System action: Processing terminates.
Explanation: You can specify no more than 10 Programmer response: Correct the error in the control
TOAREAs. statement, and rerun the job.
System action: Processing continues until all control
DFS3098A SURVEYOR IS UNABLE TO LOCATE Operator response: Use the /DISPLAY USER or
RECORD AT BEGINNING OF RANGE /DISPLAY NODE commands to determine the status of
AND/OR PARTITION BOUNDARY the user or node.
System action: The command is ignored. owned by another IMS system. As a result, the name
would not be found on this IMS, even if it was
Operator response: Check the valid syntax and
statically defined to the system.
restrictions of the command, noting restrictions of the
use of the USER keyword. System action: The command is ignored.
Module: DFSICLN0 Operator response: Check the syntax and restrictions
of the command. Use the /DISPLAY ASMT command
to note current assignments of users.
DFS3107I USER NOT AVAILABLE, IN USE BY
/ASSIGN OR /DEQUEUE Module: DFSICLN0
Explanation: A session initiation request was refused.
DFS3109 INVALID NODE TYPE
For a detailed explanation and actions, see DFS3107.
Related information: Explanation: The form of the command entered is not
applicable for the node type specified by the command.
DFS3107
System action: The command is ignored.
DFS3107 USER NOT AVAILABLE, IN USE BY Operator response: Check the allowable formats and
/ASSIGN OR /DEQUEUE restrictions of the command and rerun the command.
or
DFS3110I INVALID KEYWORD SEQUENCE
USER NOT AVAILABLE - NODE nodename USER Explanation: The command editor (DFSICL30)
username detected a command in which the NODE keyword was
entered following the USER keyword and its
Explanation: A session initiation request was refused. parameters. When both these keywords are used, the
The first form of the message is issued by the user name must be specified after the node.
/OPNDST command processor that referenced a user System action: The command is ignored.
name that was involved in an assignment with a
/ASSIGN command or a dequeue with a /DEQUEUE Operator response: Resubmit the command with the
LTERM P1 PURGE. keywords in the correct sequence.
The second form of the message is issued by the Module: DFSICLN2, DFSICLN3, DFSICLN4
LOGON or SCIP exit if an ISC session initiation request
references an unavailable user.
DFS3111I UNABLE TO START SESSION - NODE
A user is unavailable if it was STOPPED; is currently nodename STOPPED
referenced by an /ASSIGN, /DEQUEUE, or a /SIGN
command; or is currently in use. or
System action: The command is ignored or the
UNABLE TO START SESSION -USER OR NODE
LOGON/REQSESS request is denied.
STOPPED
Operator response: Enter a /DIS USER command to
Explanation: A session initiation request was refused.
determine the status of the user. If the user is
STOPPED, issue a /START USER command, if The first form of the message is issued by the
appropriate. If the user is the object of an /ASSIGN, /OPNDST command processor if a referenced user or
/DEQUEUE, or /SIGN command, wait for the node is STOPPED. The user or node cannot be
command to complete before reentering the /OPN referenced to start a session.
command.
The second form of the message is issued by the
LOGON or SCIP exit if a session initiation request
DFS3108I USER KEYWORD PARAMETER IS references a STOPPED node.
INVALID OR MISSING
System action: The command is ignored or the
Explanation: The USER keyword parameter was LOGON/REQSESS request is denied.
missing, was not a valid name, or was used in an
invalid context. The name might be valid, but it might Operator response: Use the /DISPLAY USER and
be a duplicate of another entered user name, or a name /DISPLAY NODE commands to determine the status of
used with a node name to which the user is not the user and node.
allocated.
If this IMS system is part of a sysplex using the IMS
Resource Manager, the user might be actively on or
Explanation: The /ASSIGN failed because: Explanation: The message cannot be processed
1. When attempting to /ASSIGN the USER back to synchronously. It must follow one of the following
VTAMPOOL, the half-session node, to which the modes.
specified user name is allocated, is in session in v Test mode
conversational mode, preset mode, or response v Command
mode; or the half-session node is not stopped and v Conversational transaction
idle. v Response mode
2. When attempting to /ASSIGN the LTERM or user
System action: The session is terminated. An IMS Log
name to another (target) USER, the half-session
Record with an ID of CVCT containing pertinent
node, to which the specified target USER is
information was produced.
allocated, is in session or is not idle.
System programmer response: Either change the
System action: The command is ignored.
destination type to one of the above, or change the
ATTACH to asynchronous form. the image copies are physically complete, they are
recorded in the RECON data set.
Problem determination: 1, 5, 6, 14
Related information: Programmer response: If you stopped update
processing for the data group, database, or area with a
Chapter 2, “IMS problem determination,” on page 5
/DBD or /DBR command to run the utility with the
exclusive (X) option, you can now resume update
DFS3119I NO USERS ARE ALLOCATED TO processing by issuing a /START DATAGROUP,
NODE UPDATE DATAGRP START(ACCESS), /START DB,
UPDATE DB START(ACCESS), /START AREA or
Explanation: The command specified the NODE UPDATE AREA START(ACCESS) command.
keyword and the USER keyword with parameter ALL,
but no user names are currently allocated to the Module: DFSUDUI1
specified node, or the node is not in the system. Related information:
System action: The command is ignored. “DFS3121A”
DFS3120I MSC IN SYSTEM BUT DFSCMR00 DFS3122A LOGICAL COPY FAILED FOR
NOT AVAILABLE DB/AREA dbname DDN ddname DSN
dsname
Explanation: During IMS restart, module DFSCRM00
is needed to reinstate the MSC control blocks but it is Explanation: DFSMSdss notified the Database Image
not available. Copy 2 utility (DFSUDMT0) that the attempt to
initialize a concurrent copy session for the named data
System action: This message will be followed by an set was unsuccessful. For more information about the
IMS 3120 abend. failure, see the ADR734I message and other ADRnnn
Programmer response: Make sure that DFSCMR00 is messages that were issued by DFSMSdss.
linked into DFSRST00 load module. System action: Image copy processing fails for the
Related information: database data set named in the message. The utility
terminates unless there are other database data sets for
IMS abend 3120 which image copy processing has not completed.
Operator response: See the ADRnnn messages that
DFS3121A LOGICAL COPY COMPLETE FOR were issued by DFSMSdss to determine how to correct
GROUP|DB/AREA groupname | dbname - the problem. See z/OS MVS System Messages Vol 1
n OF m DATA SETS FAILED (SA22-7631) for a description of ADR messages.
Explanation: See explanation under DFS3121I. If the data set is not on hardware that supports the
Related information: concurrent copy function, or if you do not want to use
DFS3121I concurrent copy, use the Database Image Copy utility
(DFSUDMP0) to create the image copy.
DFS3140A SDEP SCAN UTILITY FAILED DUE TO DFS3141I COPIED DB/AREA dbname DDN ddname
INDOUBT SEGMENT IN THE SCAN DSN dsname
RANGE Explanation: The DFS3141A message is issued by the
Database Image Copy 2 utility (DFSUDMT0) when
or image copy processing for the database data sets
contained in the identified group, database, or area is
SDEP UTILITY FAILED DUE TO IN-DOUBT physically complete. If a group name was specified as
SEGMENT IN UTILITY RANGE input to the utility, then groupname identifies the group.
Otherwise one DFS3141A message is issued for each
or database or area for which data sets were copied.
DFS3141I messages identify the individual database
SDEP DELETE UTILITY FAILED DUE TO
data sets that were successfully copied.
IN-DOUBT SEGMENT IN DELETE RANGE
In the message text:
Explanation: The DEDB Sequential Dependent Scan
utility found an in-doubt segment in the range of groupname
segments requested to be scanned. The name specified on the group name control
statement. Image copies for all database data
For the SDEP UTILITY FAILED DUE TO IN-DOUBT SEGMENT
sets being copied are physically complete.
IN UTILITY RANGE version of this message, the DEDB
Sequential Dependent utility found an in-doubt dbname The name of a database or area for which
segment in the range of segments requested to be image copies are physically complete.
scanned or deleted and the command INDOUBT was
n The number of data sets for which image copy
not specified as a utility control statement. Only
processing failed.
aborted and committed SDEP segments can be scanned
or deleted. They will be skipped if INDOUBT is m The total number of data sets to be copied by
specified. this execution of the utility.
For the SDEP DELETE UTILITY FAILED DUE TO IN-DOUBT
ddname The ddname or area name for the data set that the output ddnames. Specify no more than 255
was copied. database data sets to be copied to the same output data
set(s).
dsname The data set that was copied.
Problem determination: 2, 3
System action: All image copies for the group,
database, or area were recorded in the RECON. The Module: DFSUDMT0
utility continues processing if there are other data sets Related information:
still being processed.
Chapter 2, “IMS problem determination,” on page 5
Programmer response: If you stopped update
processing for the data group, database, or area with a
DFS3144A IMAGE COPY PROCESSING FAILED
/DBD or /DBR command to run the utility with the
FOR DB/AREA dbname DDN ddname,
exclusive (X) option, you can resume update processing
REASON = nn
by issuing a /START DATAGROUP, UPDATE
DATAGRP START(ACCESS), /START DATABASE, Explanation: The Database Image Copy 2 utility was
UPDATE DB START(ACCESS), /START AREA, or unable to create an image copy for the specified
UPDATE AREA START(ACCESS) command. database data set or area.
Module: DFSUDUI1 (nn) is one of the following reason codes:
Related information: Reason code
“DFS3141A” on page 625 Meaning
01 DBRC AUTH request failed.
DFS3142I DFSMSDSS MESSAGE ADR974I WAS The request to DBRC for database
ISSUED FOR DB dbname DDN ddname authorization failed.
DSN dsname 02 DBRC INIT request failed.
Explanation: The Database Image Copy 2 utility The INIT request to DBRC for image copy
(DFSUDMT0) issues this message to the system console processing failed. See the DSP message that
when it is notified that DFSMSdss is writing an was also issued.
ADR974I message. 03 Input DD statement is missing.
System action: The utility continues processing. A DD statement for the database data set was
not supplied.
System programmer response: See z/OS MVS System
04 Output DD statement is missing.
Messages Vol 1 (SA22-7631) for a description of the
ADR974I message. You should verify that the identified A DD statement for an image copy output
data set is good. data set was not supplied.
05 The area data set has Error Queue Elements
Module: DFSUDUI1
(EQEs).
Related reference:
EQEs exist for all area data sets for the
ADR974I identified area. See the DFS3726A message that
was also issued.
06 The DFSMSdss DUMP initialization failed.
DFS3143A SAME DATASET ("S") SPECIFICATION
ERROR. DFSMSdss did not schedule a memory dump
task for the dump command for this database
Explanation: The utility control statements supplied
data set. See the DFSMSdss ADR messages
for the Database Image Copy 2 utility contains one of
issues for the dump command.
the following syntax errors:
07 No VOLSER for the image copy data set.
v More than 255 database data sets were specified to
be copied to the same output data set. The maximum DFSMSdss has notified the utility of successful
is 255. completion for the database data set, however,
v The Same Data Set (S) option was specified, but during dump processing, volume serial
there is no previous control statement specifying the numbers for the output data sets were not
output data set(s). received from DFSMSdss.
08 Invalid VOLSER for image copy data set.
System action: The utility terminates with a return
code of 16. An output volume serial number received
from DFSMSdss is invalid. An abend U0225
System programmer response: Correct the utility
with subcode 4 was issued. See the abend
control statements before rerunning the utility. The first
description.
control statement specifying the Same Data Set option
09 Fast Path error was detected.
must be preceded by a control statement that specifies
The Fast Path image copy module set an data set. Because the data set was not
unexpected return code during image copy successfully closed, it might be unusable.
processing. See the error message issued for Image copy processing fails for the DBDS
the Fast Path area. because there is no valid image copy to record
0A Attempt to copy KSDS concurrent with update in the RECON.
access failed. 14 The system created a list of the volumes that
are candidates for copying. However, no
A concurrent copy session for a fuzzy KSDS
volume could be found in the list that fulfilled
image copy was not successfully initialized.
the requirements for DFSMSdss fast
See the DFS3145A message that was also
replication.
issued.
0B Database/area is not registered with DBRC. System action: The utility continues processing if
there are other database data sets that are being copied
The identified database or area is not
that have not completed. The return code for this run
registered with DBRC.
of the utility is 8 or higher.
0C BWO(TYPEIMS) was not specified for KSDS.
For reason code 14, utility processing terminates with
A fuzzy image copy of a KSDS data set was
return code 16.
requested, however, BWO(TYPEIMS) was not
defined for KSDS. See the DFS3135A message System programmer response: Correct the problem
that was also issued. indicated and submit another Database Image Copy 2
0D DBRC EOD request failed. job to copy the database data set. For reason codes 07,
08, and 12 (with abend), contact IBM Software Support
The EOD request to DBRC for image copy
for assistance if you are unable to resolve the problem.
processing failed. See the DSP message that
was also issued. Module: DFSUDMT0, DFSUDUI1, DFSUDMT1
0E I/O error on image copy data set. Related information:
The last or only image copy output data set “DFS0300I” on page 74
has experienced an I/O error. “DFS3145A”
0F DFSMSdss DUMP processing failed.
“DFS3726A” on page 756
The data set complete notification from
DFSMSdss indicated that the data set was not IMS abend 0225
successfully dumped. See the DFSMSdss ADR
messages to determine the cause of the failure. DFS3145A ATTEMPT TO COPY KSDS
10 Dynamic allocation error. CONCURRENT WITH UPDATE
Dynamic allocation for the database data set ACCESS FAILED
failed. Explanation: A control statement supplied to the
11 Unauthorization failed. Database Image Copy 2 utility (DFSUDMT0) specified
The request to DBRC to unauthorize a that a KSDS data set was to be copied concurrent with
database or area failed. update access (S was specified or defaulted to in
12 UIM abend or unexpected DFSMSdss column 58). However, because of current update
processing. activity to the data set, a concurrent copy session
required to copy the data set was not successfully
Either an abend occurred in the user initialized. If the KSDS was the only data set being
interaction module (UIM), DFSUDUI1, during copied, this utility attempted the DFSMSdss dump
DFSMSdss dump command processing, or operation several times before issuing this message.
dump command processing ended without the
UIM being driven for data set complete System action: Message DFS3144A with reason code
notification. If there was no abend, check the 0A is also issued to identify the database data set for
DFSMSdss ADR messages for this dump which image copy processing has failed. The utility
command. terminates unless there are other database data sets for
which image copy processing has not completed.
You might encounter this code when a DFSMS
server is going into QUIESCE mode. You can Operator response: The condition encountered might
suppress this code in these situations by be momentary. Retry image copy processing for the
configuring a DFSMS server which does not KSDS after an appropriate amount of time.
shut down. Module: DFSUDUI1
13 Output data set was not successfully closed.
Related information:
Close was unsuccessful or was not attempted “DFS3144A” on page 626
for the primary or secondary image copy data
set. A DFS0300I message was issued for the
DFS3162E Parm=xx Invalid on eeeeeeee Command DFS3165E Invalid Parameter to Function REXXIMS
"yyyyyyyy"
Explanation: Syntax error occurred while running
Explanation: A syntax error while running EXEC with EXEC with IMS Adapter for REXX. Invalid function
IMS Adapter for REXX was encountered. You provided parameters were passed on the REXXIMS function call.
an invalid parameter on eeeeeeee environment
System action: An invalid function call is signaled to
command. The xx value represents the parameter in
the REXX interpreter where it processes the condition
error, where 1 is the first parameter after the command.
appropriately.
For example, if the PCB parameter is invalid, the xx
value would be 1 for DL/I calls. Programmer response: Verify usage of REXXIMS
function call. If problem persists, verify that you are in
The eeeeeeee value is either REXXTDLI or REXXIMS. In the
an IMS Adapter for REXX environment by issuing the
message text, yyyyyyyy identifies the IMS command
following command and getting a return code 0.
you issued.
Address MVS ’SUBCOM REXXIMS’
System action: Environment command is not
executed; however, EXEC execution continues with a -5
return code from the command. DFS3166I Var-f:vvvv= (lllll):xxxx
Programmer response: Verify parameters and correct Explanation: An informational message issued by IMS
application. Adapter for REXX, when the IMSRXTRC level is
greater than 1 for set/drop or IMSRXTRC greater than
2 for fetch. Show REXX variable manipulation by
DFS3163E Excess Parameters on eeeeeeee Command REXXTDLI or REXXIMS. Function F will be f, s or d for
"xxxxxxxx" Fetch, Store, or Drop. The first 12 characters of variable
Explanation: Syntax Error while running EXEC with name is shown in the vvvv field. The LLLL value is the
IMS Adapter for REXX. Invalid number of parameters length of the contents. Up to the first 40 characters are
on eeeeeeee environment command. The eeeeeeee value shown in the xxxx field. For the F=d (drop) case, the llll
will be either REXXTDLI or REXXIMS. and xxxx fields are not shown. If the variable was not
initialized and it was specified in a MAPPUT then it is
System action: No processing is done. EXEC execution "Skipped" and that form of the message is given.
continues with a -8 return code from the
call/command. System action: None.
Programmer response: Correct the application EXEC System action: Variable manipulation is aborted.
issuing the unrecognized command. EXEC execution continues with a -6 return code from
the call/command.
System programmer response: If you cannot resolve
the problem, look up the return code on IRXSUBCM in Application Programming APIs for more details).
TSO/E REXX/MVS Reference.
Programmer response: Correct application and verify
Programmer response: Verify that variable mapping definition (MAPDEF).
vvvvvvvvvvvv is a proper REXX variable. Verify that the
value to be assigned does not exceed 32K.
DFS3173E Invalid MAPPUT Var: xxxxxxxx Map:
yyyyyyyy
DFS3169E Invalid Token Name: xxxxxxxx
Explanation: Data Mapping error while running EXEC
Explanation: Syntax error occurred while running with IMS Adapter for REXX. Error in EXEC on
EXEC with IMS Adapter for REXX. Error in EXEC on MAPPUT statement or DL/I "PUT" call
STORAGE type statement or DL/I call specifying a packing/concatenating variable yyyy in map xxxxxxxx.
token name. Invalid token names are those of less than Common cause is Map data, when packaged, is larger
1 or more than 16 characters in length. than output segment/buffer.
System action: Variable manipulation is aborted. System action: Variable manipulation is aborted,
EXEC execution continues with a -9 return code from EXEC execution continues with a -10 return code from
the call/command. the call/command.
Programmer response: Correct the token name. Programmer response: Correct application, verify
correct variable spelling.
DFS3170E Invalid Map Definition: xxxxxxxx at
offset yyyy DFS3174A INVALID DATABASE RECOVERY
UTILITY CONTROL STATEMENT
Explanation: Data Mapping error while running EXEC
SYNTAX, REASON=nn
with IMS Adapter for REXX. Error in EXEC on
MAPDEF statement for map xxxxxxxx in actual Explanation: A control statement for the Database
definition variable at the yyyy offset in the message. Recovery utility (DFSURDB0) is invalid for the
following reason:
System action: Variable manipulation is aborted.
01 The Database Recovery utility must retrieve the
EXEC execution continues with a -10 return code from
database data set name from DBRC, but DBRC is
the call/command.
not active.
Programmer response: Examine the mapping input
System action: Control statement processing
and correct the application error. The yyyy value is a
terminated with a utility return code of 8.
character offset in the original map definition string.
System programmer response: Correct the problem
and resubmit the job.
DFS3171E Invalid Map Name: xxxxxxxx
Module:
Explanation: Data Mapping error while running EXEC
with IMS Adapter for REXX. Error in EXEC on MAP
type statement or DL/I call specifying a map name. DFS3179I TTTTTPP=(AAAAAAAA:SSSS-LLLL)=
Invalid map names are those of less than 1 or more XXXXXXXX=CCCCCCCC
than 16 characters in length.
Explanation: An informational message issued by IMS
System action: Variable manipulation is aborted. Adapter for REXX, when the IMSRXTRC level is
EXEC execution continues with a -10 return code from greater than 7. Show parameter list passed to and
the call/command. received from the standard IMS language interface on
AIBTDLI or ASMTDLI call.
Programmer response: Correct the map name.
v TTTTT is the type of trace, "Entry" when traced
before the DL/I call, "Exit" when traced after the
DFS3172I Invalid MAPGET Var: xxxx Map: DL/I call.
yyyyyyyy
v PP is the parameter number, where number 1 is the
Explanation: Data Mapping error while running EXEC actual DL/I call.
with IMS Adapter for REXX. Error in EXEC on v AAAAAAAA is the address of the parameter.
MAPGET statement or DL/I "GET" call while
v SSSS is the size of the parameters buffer.
decoding/extracting variable xxxx in map yyyyyyyy.
Common causes include when the Map defined is v LLLL is the assumed length of the parameter.
larger than the input segment to the map and data v XXXXXXXX is the first 8 bytes of the parameter in
conversion error of packed or zoned decimal. hexadecimal.
System action: Program continues. The failing v CCCCCCCC is the first 64 bytes of the parameter in
variable's value is dropped. (See IMS Version 11 EBCDIC.
application and DFSREXX0 was the stub took the place Programmer response: Verify IMS module DFSREXX1
of the application. is in a library accessible to your dependent region that
is running REXX. Verify your STEPLIB.
System action: No EXEC execution occurs.
System programmer response: Verify your REXX
DFS3199E INTERNAL ERROR xxxxx
installation. If the problem recurs, contact IBM Software
Support. Explanation: An internal error has occurred in the
IBM Adapter for REXX. Results cannot be determined.
DFS3192E IRXINOUT ERROR DD=xxxxxxxx, System action: No EXEC execution occurs.
RC=yyyyy
System programmer response: Contact IBM Software
Explanation: A problem prevented a WRITE to the Support and supply the message text.
DD xxxxxxxx from the IMS Adapter for REXX.
System action: No EXEC execution occurs. DFS3200 MSPLINK NOT STOPPED
Programmer response: Verify the DD definition in the Explanation: In order to process the /MSASSIGN
IMS Region. LINK command, the MSPLINK specified must be
stopped.
DFS3193E ERROR LOADING MODULE xxxxxxxx System action: The command is not run. Processing
RC=yyyyyyyy continues normally.
Explanation: The module xxxxxxxx was not able to be Operator response: Use the /PSTOP MSPLINK or
loaded for the IBM Adapter for REXX. UPDATE MSPLINK NAME(msplinkname) STOP
command to temporarily stop the physical link. Then
System action: No EXEC execution occurs.
reenter the /MSASSIGN command.
System programmer response: Verify your REXX
System programmer response: No action is required.
installation. If the problem continues, contact IBM
Software Support. Problem determination: None.
System programmer response: An IMS system Explanation: The /CHANGE command specified a
definition or temporary JCL change might be link that was not a VTAM type.
appropriate if more sessions are warranted. System action: The /CHANGE command is not run.
Problem determination: None. Processing continues normally.
Related information: Operator response: Enter the correct link.
DFS3213I
DFS3206 REMOTE LOGICAL LINK NOT
DFS3202 BIND REJECTED DUE TO ASSIGNED LINK nnn
INCOMPATIBLE BUFFER/RU SIZE Explanation: The partner ID specified in the bind
LINK nnn identifies a logical link belonging to a different physical
Explanation: The partner system has rejected the bind link at the remote IMS.
because its output buffer size exceeds the current See also message DFS3213I, reason code 04 and 08.
system input buffer size, or its input buffer size is less
than the current system's output buffer size. System action: IMS prevents the link from starting.
See also message DFS3213I, reason code=20. Operator response: Use the /DISPLAY ASMT
command at the remote IMS to display the
System action: IMS prevents the link from starting. logical-to-physical link assignments, and correct them
Operator response: Notify the system programmer. using the /MSASSIGN MSLINK or UPDATE MSLINK
command if in error. Notify the system programmer of
System programmer response: An IMS system the problem.
definition is appropriate.
System programmer response: An IMS system
Problem determination: 10 definition is appropriate if the sysdef is incorrect.
Related information:
Problem determination: 10
DFS3213I
Related information:
Chapter 2, “IMS problem determination,” on page 5
DFS3213I
Chapter 2, “IMS problem determination,” on page 5
DFS3203 BIND REJECTED DUE TO INVALID
SESSION PARAMETERS LINK nnn
DFS3207 REMOTE LINK HAS REACHED THE
Explanation: The partner system has rejected the bind MAX NO. OF ALLOWABLE SESSIONS
because it is a negotiable bind and MSC/VTAM LINK nnn
requires nonnegotiable type bind.
Explanation: The maximum number of active sessions
See also message DFS3213I, reason code=24. allowed at the remote IMS was reached for this
System action: IMS prevents the link from starting. physical link.
Operator response: This problem is possibly a See also message DFS3213I, reason code 12.
transient error. Try again by restarting the link from the
System action: IMS prevents the link from starting. System action: This is an informational message only.
Processing continues normally.
Operator response: (master terminal) Use the
/RSTART MSPLINK or UPDATE MSPLINK START Operator response: Notify the system programmer.
command at the remote site if the PSTOPPED status is
System programmer response: See Problem
unwarranted.
Determination.
Related information:
Problem determination: 1, 5, 6, 15
DFS3213I
Related information:
Chapter 2, “IMS problem determination,” on page 5
DFS3209 MULTI-RU ERP OR SYSMSG
RECEIVED LINK nnnn
DFS3212I MISMATCH RESYNCH CONDITION
Explanation: An error recovery procedure (ERP)
ACCEPTABLE|UNACCEPTABLE TO
message or SYSMSG that was not an only-in-chain
PRIMARY|SECONDARY LINK nnn
message was received on the specified link.
Explanation: The FORCSESS/SYNCSESS MSLINK
System action: The MSC and link session for the
macro parameter or RSR remote takeover and recovery
indicated link ID is terminated.
logic has determined that the session initiation might
Operator response: Notify the IMS system not proceed following the mismatch indicated by the
programmer. DFS3211I message.
System programmer response: See Problem System action: IMS might not permit the session to be
Determination. initiated, as indicated by the message.
Operator response: Use a QUERY MSLINK or Explanation: One or some of the transactions did not
/DISPLAY LINK command to determine the status of satisfy all of the following:
the link or links. Depending on the reason code, 1. Transaction stopped
continue as follows: 2. No message queued for this transaction code
3. Local APPLCTN defined in the SYSDEF
Code Response
04 Notify the system programmer. System action: The command is completed for all but
08 Use /DISPLAY ASMT to display those transactions.
logical-to-physical link assignments, and Operator response: Determine which transactions
correct them with /MSASSIGN LINK or were not reassigned and which of those were not
UPDATE MSLINK if in error. Notify the stopped or had messages queued by using a QUERY
system programmer. TRAN SHOW(ALL) or /DIS TRAN ALL command.
12 Notify the system programmer.
16 Restart the link from this system if a session is System programmer response: No action is required.
warranted. Problem determination: None.
20 Notify the system programmer.
24 Notify the system programmer. Try again from
either system. | DFS3215W QMGR DISCARDED
28 Restart the partner with a warm restart | NON-RECOVERABLE MESSAGE(S)
(/ERE), cold restart both sides, or restart the | DUE TO CQSPUT COMMIT FAILURE
link from this side, or restart following the | Explanation: One or more nonrecoverable messages
correct checkpoint. | were unsuccessfully committed. The messages were
32 Terminate the prior session using /PSTOP to | discarded. The IMS DFS3215W message is issued only
stop the link or VARY NET INACT APPLID. | once per checkpoint interval, regardless of the number
Establishing a new session. | of the discarded messages. One set of type 67D00A
36 Verify that both sides were restarted from the | diagnostic records is logged for each discarded
proper checkpoint. This problem can happen | message.
| System action: The message is deleted from the local xx Identifies the module.
| IMS. Any parts of the message that was put to the 01 DFSCM7D0, a VTAM restart routine
| staging queue on the shared queue are deleted. If the 02 DFSCMSW0, the CTC or MTM restart
| deletion from the staging queue fails, it will be tried routine
| again at the next checkpoint. 03 DFSCM7A0, a VTAM restart routine
04 DFSCM7B0, a VTAM restart routine
| Programmer response: The DFS3215W message is
yy Reason code.
| expected in certain situations, such as when the IMS
01 The partner IMS release is zero or
| message queue primary or overflow structure becomes
invalid. MSC generally supports two
| full, and messages can no longer be put onto the queue
lower or higher versions; for example,
| or structure. For such cases, fix the structure full
Version 10 supports Versions 8 and 9
| problem either by making the structure larger or by
and two higher versions. Ensure that
| stopping the source of the large number of messages
the partner is a supported release. If
| that filled the structure (for runaway message cases).
the releases are supported, this
| If the cause of the DFS3215W message is not problem is an IMS internal error.
| explainable, save the IMS logs from at least two 02 The partner IMS does not support
| checkpoints before the DFS3215W message, up to the extended prefixes. Extended prefix
| checkpoint after DFS3215W, and contact IBM Software support was introduced in IMS
| Support to report the problem. Version 5 and is required if you are
connecting to an IMS Version 8 or
| Problem determination: Check type 67D00A above. Ensure that the partner is a
| diagnostic records to determine the status of the supported release. If the release is
| CQSPUT request. The header of the 67D00A record supported, this problem is an IMS
| should contain the function and description of the internal error.
| error. 03 The partner IMS ID is invalid. Both
| Module: DFSQXF00 sides of the link must have the same
two-character partner ID.
04 An invalid restart message was
DFS3217 POLARITY MISMATCH ON SESSION detected; likely the restart message ID
RESTART is invalid. This problem is an IMS
Explanation: This message appears on the master internal error.
terminal of a cold-started IMS system, because of a 05 Bandwidth is incompatible. The
warm partner that was previously the primary partner. partner IMS systems must both be
Session restart requires that this system be properly either BANDWIDTH (OFF) or BANDWIDTH
restarted (/ERE), or that you enter the /RSTART (ON).
command on the warm partner. It is also possible that 06 Invalid FMH5. For MSC VTAM, the
both sides were warm started, in which case at least restart message must be proceeded by
one of the sides restarted after the wrong checkpoint. an FMH5 block. This problem is an
IMS internal error.
See also message DFS3213I, REASON CODE=28 and 07 FMH5 contained an invalid DPN
36. field. For MSC VTAM, the FMH5
System action: IMS prevents the link from starting. block must have DFSCMS00. This
problem is an IMS internal error
Operator response: See explanation above. 08 The buffer sizes were not equal. Both
sides of the link must have the same
System programmer response: No action is required.
MSLINK buffer size.
Problem determination: None 09 An error occurred getting storage
Related information: during bandwidth restart for a QMBA
or QLST block used by QMGR. This
“DFS3213I” on page 637
problem most likely is an insufficient
storage error. If not, then it is an IMS
DFS3218 INVALID RESTART MESSAGE OR internal error.
RESTART RESPONSE MESSAGE 10 V10 VTAM link encountered an error
RECEIVED RSN=xxyy, LINK link# rebuilding the buffers and VTAM
control blocks were compatible with
Explanation: The MSC link was restarted. During the the Version 8 or Version 9 partner.
exchange of the restart messages, an invalid or This problem might be an IMS
unexpected message was detected, or the values in the internal error.
restart message indicated incompatible MSC link link# Identifies the link.
definitions between the partner IMS systems.
System action: IMS prevents the link from starting.
In the messages:
Operator response: Refer to the reason code for zz Value (in decimal) placed in Register 15 by
possible causes and actions. The DFS3218 reason codes VTAM upon returning control to IMS
are also documented in the DFSKEYRC macro.
nnn MSC/VTAM link ID for which the request
Use the QUERY MSLINK, /DISPLAY LINK, or failed
/DISPLAY LINK OPTION BUFSIZE command on each
System action: The MSC/VTAM link session for the
side of the link to determine whether the links are
indicated link is terminated. An IMS log record (X'67')
compatible. If error is due to incompatible link
with an ID of MSSx (where x=1, 2 or 3) containing
parameters, use the UPDATE MSLINK or /UPDATE
pertinent information was written.
MSLINK command to set the parameters compatible.
Notify the system programmer if the error persists. Operator response: Notify the IMS System
Programmer.
System programmer response: If the error is not due
to incompatible link options between this side of the Programmer response: See VTAM V4R3 for MVS/ESA
link and its partner, or the incompatibility cannot be Programming and VTAM Messages and Codes for an
determined or corrected with the UPDATE MSLINK explanation of what caused this return code.
command, analyze the 6701 MSSx log records produced
when the error occurred. Problem determination: 1, 5, 6, 7, 17b.
Related information:
To print the type 6701-MSSx (x = 1, 2, 3, and 4) log
records, use the DFSERA10 log print utility with the Chapter 2, “IMS problem determination,” on page 5
following control cards:
CONTROL CNTL DFS3221 SHOULD NOT OCCUR TYPE LOGIC
OPTION PRINT O=5,V=6701,L=2,C=M,E=DFSERA30 ERROR LINK nnn
OPTION PRINT O=9,V=MSS,L=3,T=C,C=E,E=DFSERA30
Explanation: An illogical condition has been detected
by the MSC/VTAM device dependent module for the
The type-1 /PSTOP MSPLINK command sets the
specified link nnn.
appropriate stop status, either PSTOPPED or
PSTOPGEN, depending on the specification of the System action: The MSC/VTAM link session for the
GENIMSID parameter in the DFSDCxxx PROCLIB indicated link is terminated. An IMS log record (X'67')
member. If status is ACTIVE, PSTOPGEN is set, if with an ID of MSSx (where x = 1, 2 or 3) containing
DISABLED, PSTOPPED is set. This status can be pertinent information was written.
displayed by either the /DISPLAY ASMT MSPLINK or
QUERY MSPLINK NAME(msplink_name) Operator response: Notify the IMS System
SHOW(STATUS) commands. Programmer.
Problem determination: 1, 5, 6, 7, 17b. System action: The session is terminated for the
Related information: indicated MSC/VTAM link.
Chapter 2, “IMS problem determination,” on page 5 Operator response: No action is required.
System programmer response: No action is required.
DFS3236 DR2 RESPONSE RECEIVED FOR
Problem determination: None.
WRONG RU NUMBER LINK nnn
Explanation: A DR2 received for SNA data did not
DFS3240 DATA RECEIVED EXCEEDS
carry the VTAM sequence number of the OIC/LIC.
ALLOCATED INPUT BUFFER LINK
System action: The session is terminated for the nnn
indicated link.
Explanation: Data received on the specified
Operator response: Notify the system programmer. MSC/VTAM link nnn exceeded the input buffer
allocation.
System programmer response: See Problem
Determination. System action: The session is terminated for the
indicated MSC/VTAM link.
Problem determination: 1, 5, 6, 7, 17b
Related information: Operator response: Notify the system programmer.
Chapter 2, “IMS problem determination,” on page 5 System programmer response: See Problem
Determination.
DFS3237 UNEXPECTED FME RESPONSE Problem determination: 1, 5, 6, 7, 17b
RECEIVED LINK nnn Related information:
Explanation: An unexpected SNA FME response Chapter 2, “IMS problem determination,” on page 5
occurred on the indicated MSC/VTAM link nnn.
System action: The session is terminated for the DFS3241 DATA FRAME COUNT DOES NOT
indicated MSC/VTAM link. AGREE WITH RPL BYTES-RECEIVED
COUNT LINK nnn
Operator response: Notify the system programmer.
Explanation: The MSC data frame count (first 2 bytes
System programmer response: See Problem
of the MSC RU) does not agree with the value
Determination.
indicated by VTAM in the RECEIVE RPL for the
Problem determination: 1, 5, 6, 7, 17b. specified MSC/VTAM link nnn.
Related information: System action: The session is terminated for the
Chapter 2, “IMS problem determination,” on page 5 indicated MSC/VTAM link.
Operator response: Notify the system programmer.
DFS3238 INVALID/UNEXPECTED
System programmer response: See Problem
INFORMATION RECEIVED LINK nnn
Determination.
Explanation: A SNA command or LU was received
Problem determination: 1, 5, 6, 7, 17b
that is not supported by MSC/VTAM.
Related information:
System action: The session is terminated for the
Chapter 2, “IMS problem determination,” on page 5
indicated link.
Operator response: Notify the system programmer.
DFS3242I PARTNER SHUTTING DOWN LINK
System programmer response: See Problem nnn
Determination.
Explanation: The last message sent to the link partner
Problem determination: 1, 5, 6, 6, 7, 17b has been rejected because the partner commenced
Related information: shutdown just as the message arrived.
Chapter 2, “IMS problem determination,” on page 5 System action: The message is returned to queue by
the current system.
Problem determination: To determine which blocks System programmer response: Check the MAXSESS
are on one OLDS and not on the other, you can use a field in system definition for this link, and check the
tool such as IMS Problem Investigator for z/OS or NLXB parameter in the IMS control region JCL.
DFSERA10 to check type 4800 log records. There is one
type 4800 log record per block and it contains fields DFS3256I OPEN FAILED ON ddname - DURING
such as the block sequence number. ONLINE LOG READ (xx)
This message is first issued when the BSN exceeds Explanation: The log data set specified on the ddname
X'F0000000'. It is then issued again when it exceeds could not be opened or allocated for logging, because
X'F1000000', again at X'F2000000', and so on. the DD statement was not correctly specified or
because the preallocated data set had inconsistent DCB
If the BSN reaches the upper limit of X'FFFFFFFF', IMS attributes.
ends abnormally with abend code 0616, the /ERE
The first form of this message applies to log write
operations for either an online log data set (OLDS), or a The second form of the message is issued each time the
write-ahead data set (WADS). OLDS (ddname1) becomes full, EOV was forced, or
OLDS (ddname1) incurred an I/O error and was closed.
The second form of this message is issued under these
The next OLDS (ddname2) is opened for further logging.
conditions:
During an XRF takeover, the second form of the
v When an OLDS is opened that has a different block
message appears. ddname1 is the OLDS that is
size (BLKSIZE) from the value displayed in message
terminated from the WADS when takeover is requested.
DFS2207I.
v When a write-ahead data set (WADS) is opened The third form of this message appears when normal
which does not have sufficient space allocated. shutdown is scheduled and OLDS is closed.
v When the RECFM is not VB.
The fourth form of this message is issued o the master
v When an extended format OLDS was found and this
terminal when some OLDS are forced to stop, by a
release of IMS cannot use an extended format OLDS.
/STOP command or because of I/O error. The log data
set is no longer needed for online database backout,
The third form of the message appears when the
and the log data set is removed from the candidate list
GETMAIN storage is not available for the OSAM DCB
for future use. This OLDS is dynamically deallocated
required for a log read operation. It is also issued when
from the control address space.
the OSAM OPEN function fails. When the GETMAIN
storage is not available, xx contains a value of x'FF'. System action: IMS continues processing.
When the OSAM OPEN function fails, xx is the return
Operator response: If automatic archiving is not
code value returned by the OSAM OPEN function.
specified, display the OLDS status to determine
System action: If the error occurred while opening a whether to submit an archive job.
WADS and one or more WADS was still available, IMS
When the fourth form of the message appears, the
continues processing. If no WADS was available,
specified OLDS is ready for repair. After the OLDS has
message DFS3262I is issued and IMS continues
been archived, the data set can be scratched and
processing.
reallocated on another volume. Then the /START
If the error occurred while opening an OLDS and 3 or OLDS command can be entered to reconnect the OLDS
more OLDS are still available, IMS continues to the online IMS.
processing. If 2 or less OLDS are available, message
Programmer response: No action is required.
DFS3260I is issued. See the system action for message
DFS3260I.
DFS3258A SYSTEM WAITING FOR AN ONLINE
Operator response: No action is required.
LOG DATA SET - NEED ARCHIVE
Programmer response: No action is required.
Related information: or
“DFS2207I” on page 462
LAST ONLINE LOG DATA SET IS BEING USED -
“DFS3260I” on page 647 NEED ARCHIVE
“DFS3262I” on page 647
Explanation: The first form of this message is sent
when IMS detects that the last unarchived online log
DFS3257I ONLINE LOG NOW OPENED ON data set (OLDS) was being used. All the other OLDS
ddname are not reusable for output operation, because they
have not yet been archived or have been stopped.
or
The second form of this message is sent when all
non-stopped OLDS require archiving. The second
ONLINE LOG NOW SWITCHED - FROM ddname1
message is repeated at 5 minute intervals until the
TO ddname2
situation is resolved by archive completion.
DFS3260I ONLINE LOG DATA SET SHORTAGE - ARCHIVE UTILITY ENDED SUCCESSFULLY
NEED ANOTHER DATA SET (rrrrrrrr)
Explanation: Because of I/O errors or /STOP OLDS Explanation: The Log Archive Utility terminated
commands, two or less online log data sets (OLDS), are either successfully or unsuccessfully. A reason for
available which can be used by IMS. termination is given in cases where a programmer
System action: If two OLDS remain, IMS continues response is required. The values for rrrrrrrr are:
processing. If there is only one, IMS initiates a /CHE v SUCCESSFULLY - (BUT NOT ALL OLDS WERE
FREEZE. ARCHIVED)
v UNSUCCESSFULLY - (OPEN ERROR) (DBRC
Operator response: The /DISPLAY OLDS command VERIFICATION FAILED: INPUT LOG(S), SSID OR
can be used to display the status of all OLDS. When RECON(S) ARE INVALID)
two data sets remain, any one of the following v (EXEC PARAMETER ERROR)
responses is acceptable: v (CONTROL STATEMENT ERROR)
v No response, IMS continues processing. v (DATA SET SPECIFICATION ERROR)
v In a z/OS environment, additional OLDS can be v (ERROR IN SINGLE INPUT LOG)
activated using the /START OLDS command. v (DUPLICATE ERROR IN DUAL INPUT LOG)
v The checkpoint command can be used to initiate an v (OUTPUT DATA SET I/O ERROR)
IMS shutdown. v (OUT-OF-SPACE IN OUTPUT DATA SET)
Programmer response: No action is required. v (UNSUCCESSFUL EXCHANGE BETWEEN DUAL
INPUT DATA SETS)
v (USER EXIT ROUTINE ERROR)
DFS3261I WRITE AHEAD DATA SET NOW ON v (DEVICE TYPE ERROR)
ddname v (OUTPUT DATA SET BLOCK/TRACK SIZE IS TOO
SMALL)
Explanation: The log write-ahead function is now
v (DBRC MODULE NOT FOUND)
using the data set identified by ddname. During IMS
v (INPUT SLDS ALLOCATED TO AN EXTENDED
execution, this message might follow a WADS I/O
FORMAT VOLUME)
error message.
v (NON-ZERO RETURN CODE FROM ISITMGD)
System action: IMS continues processing.
System action: If the Log Archive Utility ended
Operator response: No action is required. SUCCESSFULLY with a return code of 0 and no
accompanying reason, then all online log data sets
Programmer response: No action is required.
(OLDS) were archived as identified in the SYSPRINT
output messages. The utility terminated normally.
DFS3262I NO DATA SET AVAILABLE FOR LOG
If the Log Archive Utility ended SUCCESSFULLY with
WRITE AHEAD
a return code of 4 and the accompanying reason "(BUT
Explanation: Either the WAD's are too small, or errors NOT ALL OLDS WERE NOT ARCHIVED)", then one
have occurred OPENing or writing to the WADS, and or both of the following reasons apply to this archive
no more WADS are available. job:
v The system encountered a recovery point in an
System action: IMS continues processing. However, OLDS, archived that OLDS, and terminated without
the system performance can be degraded because the archiving any more OLDS. A recovery point results
log write-ahead support will cause the online log at every /DBR or /DBD command that forces an
buffers to be truncated. OLDS switch.
v An OLDS specified as input to the Archive utility CLOSE An error occurred while closing the WADS.
was already archived when this job ran. The TRKCALC
SYSPRINT output messages will identify the OLDS An error occurred in the MVS TRKCALC
that were already archived. function.
LOGIC An internal logic error was detected by the
If the Log Archive Utility ended UNSUCCESSFULLY, WADS read module (DFSFDLW0).
then the accompanying reason, additional DFS VERIFY
messages, and messages in the SYSPRINT output An error was found in the WADS DD
identify the reason for abnormal termination. statement (DFSWADS0).
MISSING RCD
Programmer response: If all OLDS were not archived A sequence of WADS records had fewer
because they encountered a recovery point, then run records than it should.
the Log Archive Utility for the unarchived OLDS.
System action: The Log Recovery utility, DFSULTR0,
If the utility ended UNSUCCESSFULLY, correct the terminates with abend 3265.
error and rerun the Log Archive Utility.
The second form of this message, where the zzzzzz when a X'47', an active PSTs log record written at
value is LOG DATA EXISTS BEYOND EXPECTED checkpoint time, was not found in the input (online log
CLOSE POINT, indicates that the Log Recovery utility data sets (OLDS) and WADS).
has encountered the following condition:
The X'47' record contains a list of all active PSBs, and is
v Input data set is a SLDS. required to ensure that the PSB report is complete.
ERRC number of errors were encountered on the
The third form of this message is issued when an
input SLDS, but the SLDS contains additional blocks
OLDS error is encountered. This means that the log
with later time stamp values. This indicates that
records are missing, and therefore, the analysis of the
SLDS is not correctly positioned for close.
active PSBs cannot be correctly performed.
v CLS mode.
The fourth form of this message is issued when an
The first error was encountered in CLS mode, but
internal error occurs during Log Recovery utility
end-of-file checking found additional blocks with
processing.
later time stamp values.
System action: If this is not a "rerun" of the Log
The third form of this message, where the zzzzzz value Recovery utility in PSB mode, the OLDS close process
is LOG DATA DOES NOT SATISFY LSN KEYWORD, is completed. Otherwise, the Log Recovery utility
indicates that the last log sequence number read by simply terminates.
CLS or DUP mode is less than the value specified for
Programmer response: If you received the first two
the LSN keyword.
forms of this message and you need the active PSB
System action: The Log Recovery utility, DFSULTR0, information, do the following:
terminates unsuccessfully. For the REQUIRED LOG v Rerun the job in CLS mode, specifying the previous
DATA NOT FOUND and end-of-data detected cases, and current OLDS as concatenated data sets in your
abend U3271 is issued. input.
v Specify PSBLIST=YES and DBRC=NO as exec
Programmer response: If CLS mode was specified,
parameters so that DBRC processing will be
change it to DUP mode with an error count other than
bypassed.
zero. If DUP mode was specified, increase the error
count value, and rerun the job. If NOWADS was
For the third form of this message, ensure that the
specified assure that no DFSWADSn DD card is
previous and current OLDS were concatenated in the
present, if present remove and rerun the job.
correct sequence. If OLDSs are specified correctly, use
the Log Recovery utility in DUP mode to create a valid
DFS3272I OLDS ERROR. ACTIVE PSB OLDS.
MESSAGES NOT GENERATED.
If you received the fourth form of this message, check
or your log record concatenation in your IEFRDER DD
statement. A possible log record sequence error
X'47' LOG RECORD NOT FOUND. RECOVERY occurred.
REQUIREMENTS NOT GENERATED.
DFS3273I UNABLE TO PROCESS xxx
or COMMAND FOR ddname, REASON
CODE nn
X'47' LOG RECORD NOT FOUND. ACTIVE PSB
MESSAGES NOT GENERATED. Explanation: A /START OLDS, /START WADS,
/STOP OLDS, /STOP WADS, or /SWITCH WADS
Explanation: This message is related to DFS3272E. See command could not be processed. The value of xxx is
the information on that message for a detailed /START, /STOP, or /SWI indicating which command
explanation and actions. could not be processed. The reason code nn is a
Related information: hexadecimal number.
DFS3272E For a /START command failure, one of the following
reason codes occurs:
DFS3272E INTERNAL ERROR DURING LOG Code (hex)
RECOVERY Meaning
Explanation: The write-ahead data set, WADS, was 04 The OLDS or WADS could not be dynamically
specified as input to the Log Recovery utility. The Log allocated. Either no DFSMDA member exists
Recovery utility could not determine the active PSBs for the specified OLDS or WADS, or the
from the log data processed. dynamic allocation request failed.
The first and second forms of this message are issued 08 One of these errors occurred: The specified
02 IMS is not currently using WADS. Some Explanation: Either an EXEC parameter is incorrectly
WADS must be started before a switch specified, or the specified combination of EXEC
command is meaningful. parameters, DD statements, and control statements is
invalid.
03 A failure occurred opening the spare WADS.
System action: The Log Recovery utility failed.
System action: The command is rejected.
Programmer response: Correct the parameter and
Operator response: If less than 2 OLDS are currently rerun the job. See IMS Version 11 System Utilities and
available, it might be possible to use the /START OLDS IMS Version 11 Operations and Automation for an
command to start additional OLDS and then retry the explanation of the Log Recovery utility EXEC
/STOP OLDS command. If the current OLDS should be parameter.
stopped, it must first be closed with a command, such
as /DBR, that causes a switch to the next OLDS.
DFS3276I PRIMARY OR SECONDARY OLDS
In the case of a /START OLDS failure, notify the HAS BAD CONTENTS
system programmer.
Explanation: The contents of the primary input OLDS
Problem determination: 1, 3, 8, 11, 36 is different from the secondary OLDS. The primary or
Related information: the secondary OLDS encountered a write error and was
Chapter 2, “IMS problem determination,” on page 5 not reused, whereas the other data set was reused, but
was not closed successfully.
System action: The Log Recovery utility failed.
Programmer response: Remove the DD statement for
the OLDS which has the bad contents and specify the DEDB might remain in the log record chain in the
other OLDS as the primary input log; then rerun the previous log data set (OLDS or SLDS).
job.
System action: The Log Recovery utility terminates
with return code X'04'
DFS3277I END OF PRIMARY EXTENT DURING
Programmer response: If the previous log is OLDS,
OLDS WRITE OPERATION
rerun the job in CLS mode and include the previous
Explanation: A DUP mode or CLS mode for OLDS OLDS as a concatenated data set with the current
with WADS was specified. There was not enough room OLDS. Also, specify PSBLIST=YES and DBRC=NO as
to write the log blocks from WADS, an accounting log EXEC parameters.
record (X'06') in the primary extent of the output log
If the previous OLDS was already archived into an
(DUP mode) or the input log (CLS mode).
SLDS, run a Log Recovery utility job in DUP mode and
System action: The Log Recovery utility failed. specify the SLDS as an input data set. Also, specify
PSBLIST=YES and DBRC=YES as EXEC parameters.
Programmer response: If CLS mode was specified,
change it to DUP mode and specify an output log with
Note: If the closed OLDS is the only OLDS used since
enough space. If DUP mode was specified, specify
cold start, ignore this message.
more space for the output log and rerun the job.
HALDB partition. The partition data set cannot be the reorganization number has been set incorrectly for
updated with the correct reorganization number this partition. An incorrect reorganization number can
because the dataset is open only for input. IMS issues cause failures during resolution of the indirect pointers
this message when the partition data set is opened. for segments involved in a logical relationship or the
target of a secondary index or both. This failure can
System action: IMS updates the reorganization
cause IMS to follow a bad pointer and cause a data
number in the internal control blocks, but the data set
integrity failure.
still contains a lower reorganization number until the
data set is opened for update. System action: The reorganization number was set in
the data set using the reorganization number of the
System programmer response: Change the partition
first record loaded into the partition.
access to allow the reorganization number to be
updated on the dataset. The ILDS must be rebuilt if the System programmer response: If the database does
ILE's were created with the same reorganization not have any logical relationships or secondary index
number as the data set. databases, then no action is required.
Module: DFSDDUI0 If the database has logical relationships or a secondary
index target, then determine if the reorganization
number was regressed. Follow these steps to determine
DFS3283A BACKOUT INCOMPLETE FOR PSB
if the number was regressed:
psbname DATABASES dbname1 dbname2...
1. Determine the key of the first record in the partition
Explanation: When Batch Backout is run in multiple after reload.
steps using the DATABASE control statement, this 2. Determine the reorganization number for the
message is the normal response for all but the last step. partition of the first record before reload.
The dbnames shown in the message are all the databases 3. Determine the reorganization number for the
specified on the DATABASE control statements. If a partition of the first record after reload.
COLDSTART statement was used with the DATABASE
statements, the word ALL appears in place of the If the reorganization number after reload is less than or
dbnames. equal to the reorganization number before reload, a
data integrity failure might occur. To prevent a data
System action: Batch Backout backed out any updates
integrity failure take the following steps:
to the identified databases for the named PSB that were
1. Reverse the changes in the partition boundaries,
found in the series of input log data sets. A condition
restoring the partitions to their original partitions.
code of 88 is returned.
2. Enable the reorganization number verification
Programmer response: Continue the backout by function. You can do this using the DBRC
running Batch Backout against the previous set of log CHANGE.RECON REORGV command.
data sets. Use the same DATABASE control statements. 3. Set the reorganization number in the RECON, by
making updates to the partition or by executing the
HD Unload utility.
DFS3284A INCOMPATIBLE CONTROL 4. Redo the changes to the partition boundaries.
STATEMENTS: s1 - s2
Explanation: The SYSIN data set contains two control Attention: If you cannot enable reorganization
statements, s1 and s2, which cannot be used together. number verification, then IMS can prevent the
regression of the reorganization number during reload
System action: The job is terminated before backout as long as the primary database data set is not
begins. scratched and reallocated, or the partition is not
Programmer response: Remove the inappropriate reinitialized to empty.
control statement and resubmit the job. For descriptions Module: DFSPSEL0
of all control statements see IMS Version 11 Database
Utilities.
DFS3288I INPUT LOG RECORD LENGTH
ERROR - SEQ NUMBER = nnnnnnnn
DFS3286W REORG# NOT FOUND FOR INPUT LOG SEQUENCE NUMBER
PARTITION yyyyyyy ERROR - SEQ NUMBER = nnnnnnnn
Explanation: The reorganization number for a HALDB INPUT LOG CONTAINS RECORD
partition cannot be determined during reload when GAPS - SEQ NUMBER = nnnnnnnn
new records have been moved into the partition. The Explanation: During the Log Recovery Utility
reorganization number from the primary data set and (DFSULTR0) running PSB mode, an error was detected
the RECON cannot be determined or are null. on the input log (IEFRDER).
When IMS is unable to determine the correct System action: The first version of the message is
reorganization number during reload, it is possible that issued when a log record is read that has a record
The variables in the message and their meanings are: 12 Invalid VOLSERs were either specified or
repeated.
nn A subcode which identifies a specific test in
the Batch Backout module. 13 VOLSERExamined was found where
VOLSERExpected was expected.
rrrrrrrrrr
A general description of the problem. 14 The log data set that should precede the log
data set specified by dd statement
The possible values are: DSNExamined is missing from the input.
v DATA SET NOT FOUND IN RECON
v CONTINUITY 20 The input log is from batch. VOLSERs are
v LATER DATA SET OR VOLUME NEEDED missing at the end.
v DATA SET NOT CLOSED. 21 The backout is related to a restart. VOLSERs
v LOG INCLUDES RESTART are missing at the end.
DSNExamined 22 The input log is from a batch job, and the
The DSN, from 1 to 44 characters, of the DD DBRC information shows a more recent log for
statement examined when the problem was that job name. This code can also mean that
detected. The problem exists in this DD logs were specified from more than one
statement or the preceding one. execution of a batch job.
VOLSERExamined 23 A control statement indicates that the backout
The VOLSER examined when the problem was is related to a restart. The last log data set
detected. The problem exists in this VOLSER before the restart is not included in the input.
or the preceding one.
30 The log data set specified in DD statement
DSNExpected DSNExamined has not been closed.
The DSN, from 1 to 44 characters, of the DD
statement that was expected when the 40 One of the input log data sets other than the
problem was detected. first data set includes a successful restart.
authorized to access the started database, issue the a single statement produce multiple messages.
/START DATABASE or UPDATE DB START(ACCESS)
In the message text:
command.
name Indicates the name of the PROCLIB member
To drain the suspend queue for the started transaction that was being processed.
and reset the USTOPPED status, issue the /START nnn The statement number within the member.
TRAN or UPDATE TRAN START(SUSPEND) xxxxxxxxxxxxxxxxxxx
command. The text in error.
yyyyyyyyyy
To drain the suspend queue for all transactions, issue
The reason codes, which can be one of the
the /DEQ SUSPEND command.
following values:
For more information about how the suspend queue OMITTED
works, see IMS Version 11 System Administration. A required parameter was omitted
Related reference: from the definition. The definition
was invalid.
INIT call (Application Programming APIs) IGNORED
Related information: A parameter that is not applicable
was specified in the definition. The
IMS abend 3303 parameter is ignored and processing
continues.
INVALID
DFS3304I IRLM LOCK REQUEST REJECTED. The error text represents invalid data
PSB=psb_name DBD=dbd_name in the statement. If the character
JOBNAME=job_name RGN=nnn string KEYWORD proceeds the error
SUBSYSTEM=subsystem text, then the value for the parameter
Explanation: This informational message precedes is invalid. Otherwise, the error text
pseudoabend 3303 when an application program represents data that could not be
attempts to obtain a retained lock through IRLM. The interpreted as part of the definition.
variables in the message text are: The definition was invalid.
psb_name DUPLICATE
The name of the PSB issuing the failed call A specific value for a parameter was
dbd_name specified for more than one
The name of the database with the retained definition. The definition was
lock considered invalid and is ignored.
job_name System action: IMS initialization terminates with a
The name of the z/OS job receiving the 3303 0071 abend.
abend
nnn The number (decimal) of the PST receiving the Programmer response: Correct the PROCLIB member
3303 abend definition, and try IMS initialization again.
subsystem
Module: DFSCSL10
The name of the IMS subsystem that holds the
lock Related information:
System action: See the description of abend 3303 for IMS abend 0071
system action.
Module: DFSLRH00 DFS3306A CTL REGION WAITING FOR csltype
Related information: Explanation:
IMS abend 3303 This write to operator (WTO) message indicates that
one of the following problems was encountered:
v IMS when SCI, OM, or RM is unavailable at first
DFS3305E DEFINITION ERROR IN PROCLIB
registration.
MEMBER name
v IMS online processing when there are no RM, OM,
STMNT (nnn), 'xxxxxxxxxxxxxxxxxxx'
or SCI systems ready in the IMSplex (for example, all
(yyyyyyyyyy)
RMs, OMs, or SCIs have terminated or quiesced).
Explanation: If one or more errors were found while
processing external subsystem definitions, this message In the message text:
is issued. For each definition error, a message is issued csltype The CSL type; either SCI, OM, or RM.
that indicates which statement was in error and the text
System action: IMS waits until the user starts the
in the error. One STMNT error message is issued for
indicated CSL type before continuing with system
each error in the PROCLIB member. Multiple errors in
initialization or online processing.
Programmer response: Start the csltype for which IMS Important: When the CSLTYPE shows other
is waiting. If you did not want to start the CSL during than an SCI, but the return code (xx) is X'01',
IMS initialization, you must cancel IMS. check the CSLSRR macro to find out what is
the reason means. Many OM and RM request
Module: DFSCSL20, DFSCSL30, DFSCSL40,
can result in a SCI return code and reason
DFSSNTF0
code.
System action: If this error occurs during IMS
DFS3307E OM CMD REG ERROR, VERB
initialization, the system might abend with 3308.
=vvvvvvvvvvvvvvv
Otherwise, the current process is rejected and online
KEYWORD=kkkkkkkkkkkkkkk CC=cccccccc
processing continues. An abend can also occur if a new
Explanation: This write-to-operator (WTO) message is OM address space joins the IMSplex, IMS registers to it,
issued by the IMS control region when an Operations and one of the command registration calls fails.
Manager (OM) command registration failed. One
Operator response: If the condition is temporary, try
DFS3307E message is issued for each command and
the failed process again.
keyword combination that failed.
Module: DFSCSL20, DFSCSL30, DFSCSL40,
In the message text:
DFSOLC30, DFSRMCL0, DFSRMD00, DFSRMFD0,
vvvvvvvvvvvvvvv
DFSRMIU0, DFSRMSR0, DFSSLGF0, DFSSLON0
The command that was registered with OM
kkkkkkkkkkkkkkk
The keyword that was registered with OM DFS3311I DFS3311I USER EXIT, XXXXXXXX,
cccccccc The completion code for the command and WAS NOT FOUND
keyword registration. The cccccccc values are
Explanation: The Data Capture exit routine
defined in the CSLORR macro.
XXXXXXXX was specified in DBDGEN, but a load
System action: IMS attempts to register the rest of the module with this name was not found.
commands in the list. A DFS3307E message is printed
System action: The job is terminated with abend 3314.
for each one that fails. After all attempts are completed,
a DFS3308E message is printed and then IMS Programmer response: Determine why the load
terminates abnormally. module was not found, correct the error, and rerun the
job.
Programmer response: If the condition is temporary,
try the failed process again. Problem determination: 1, 2, 3, 8
Module: DFSCSL30 Related information:
Related information: IMS abend 3314
DFS3308E Chapter 2, “IMS problem determination,” on page 5
Problem determination: 2, 3, 8 and a listing of the exit Explanation: The database access cannot be changed
routine for the Fast Path main storage databases (MSDB).
Related information: System action: The named databases are removed
Chapter 2, “IMS problem determination,” on page 5 from the command, and the remaining databases, if
any, are processed.
DFS3314W RETURN CODE xxx, REASON CODE Operator response: No action is required.
yyy FROM EXIT zzzzzzzz IN REGION n
Explanation: Exit zzzzzzzz in region n returned an xxx DFS3318I FAST PATH MSDB dbname NOT
return code and a yyy reason code to IMS, so exception SUPPORTED BY GBL COMMANDS
processing is done based upon the return code. Explanation: The Fast Path main storage database
Programmer response: Correct the situation that (MSDB) is not supported by global commands.
caused the exit to return the return code. System action: The named database is removed from
Problem determination: 2, 3, 8 and a listing of the exit the command, and the remaining databases, if any, are
routine processed.
Related information: Operator response: No action is required.
Chapter 2, “IMS problem determination,” on page 5
DFS3319 IRLM NOT ACTIVE.
DFS3315 ACCESS INVALID FOR GLOBAL Explanation: IRLM must be active in the system when
COMMAND global commands or /DEQ SUSPEND are entered.
Explanation: The keyword ACCESS was invalid for System action: The command is ignored.
global commands.
Operator response: Ensure that IRLM is active before
System action: The command is ignored. entering global commands or /DEQ SUSPEND.
Operator response: Correct the command, and reenter
it. DFS3320I DBRC INDICATES DATA BASE|AREA
xxxxxxxx NEEDS BACKOUT/
DFS3315W xxxxxxxx USER EXIT HAS RECOVERY
TERMINATED Explanation: The named database or area must be
Explanation: Exit xxxxxxxx terminated during the recovered before the command can be processed
processing of changed data due to the application against the database or area.
program updating a segment with an exit defined on System action: The named database or area is
the DBD statement. removed from the command, and the remaining
System action: The application program terminated. database or areas, if any, are processed.
Programmer response: Correct the situation that Operator response: No action is required.
caused the exit to terminate.
Problem determination: 2, 3, 8 and a listing of the exit
routine
Related information:
Chapter 2, “IMS problem determination,” on page 5 Operator response: (master terminal) Wait for the
dump command to be completed, and reenter the
command.
DFS3327 MORE THAN 29 DB or 27 AREA
NAMES NOT SUPPORTED BY
GLOBAL COMMANDS DFS3332I DBRECOVERY ALREADY IN
PROGRESS, CANNOT PROCESS
Explanation: A maximum of 29 database names or 27 GLOBAL COMMAND seqno
area names can be supplied on a global command.
Explanation: A database recovery command
System action: The command is ignored. previously entered has not yet completed. Seqno is the
Operator response: Correct the entered command, and sequential number of the global command that initiated
reenter it. the action.
System action: The command is ignored.
DFS3328I GLOBAL cmd COMMAND seqno IN Master terminal operator response: Wait for the
PROGRESS database recovery command to be completed and
Explanation: The seqno is a sequential number used to reenter the command.
tie this message with the global command that initiated
the action. DFS3333I MSDB CHKPT IN PROGRESS,
System action: The system continues processing. CANNOT PROCESS GLOBAL
COMMAND seqno
Explanation: This is the global command equivalent to
DFS2717I. An MSDB checkpoint from a previously
entered command or an automatic system checkpoint is
currently in progress. Seqno is the sequence number of
the global command that initiated the action. 1. Partial Log Record Data. Contains the last 4 bytes of
the previous log record followed by 246 bytes of the
System action: The command is ignored.
error log record.
Operator response: (master terminal) Wait for the 2. Log Record Sequence Number Data. Contains the
checkpoint to complete, and reenter the command. last 8 bytes of data for the error log record.
3. UCSTAT Table Entry. Contains the entire UCSTAT
table entry data used by module DFSUC150 to
DFS3334I hh:mm:ss GLOBAL cmd COMMAND perform the log sequence checking.
seqno INITIATED BY SUSBYSTEM=ssid 4. DFSULOG JFCB Information. Contains the JFCB
FOR THE FOLLOWING DATA data for the DFSULOG data set being processed.
BASES|AREA|ADS(s) Use this information to determine the data set name
Explanation: The indicated global command, initiated and volume serial number.
from another subsystem, is being processed in this Related information:
subsystem. The following defines cmd, seqno and ssid: Chapter 2, “IMS problem determination,” on page 5
Keyword
Meaning DFS3336I SUSPEND QUEUE DRAINED
cmd The command being processed.
seqno A sequential number assigned to this Explanation: The transactions that were suspended
command that will be used in the response to have been removed from the suspend queue and
the command issued by this subsystem. reenqueued on their original transaction queue.
ssid The subsystem ID of the indicating subsystem
System action: Those transactions that were
which issued the global command.
suspended are now eligible to be processed.
System action: IMS continues processing.
Problem determination: None.
Operator response: No action is required.
DFS3337W DBRC IS NOT ACTIVE, BUT WAS
DFS3335A LOG INPUT IS NOT IN SEQUENCE ACTIVE WHEN THE INPUT LOG WAS
FOR FUNCTION CA; REASON CREATED.
CODE=r
Explanation: The issuing utility program discovered
Explanation: The log input is not in sequence for the an indication from the X'42' log record that DBRC was
CA function. The return code r has one of the following active at the time the input log data set was created.
values: However, DBRC is not active during this utility
01 The error occurred during the creation of a log program execution.
data set using the Change Accumulation
System action: Processing continues normally, but
utility. There was a log input from both the DB
DBRC is not notified about the utility execution.
sharing release IMS system and from an IMS
system previous to DB sharing. Programmer response: Verify whether DBRC should
02 The error occurred during the creation of a have been active during the execution of the utility. If
change accumulation data set. There was a log DBRC notification is required, then use DBRC
input from both a DB sharing release IMS commands to manually update RECON data set
system and from an IMS system previous to records to reflect the current log information.
data sharing.
System action: Processing terminates. DFS3338A OLIC AUTHORIZATION FAILURE -
nnnncccc ALREADY AUTHORIZED
Programmer response: Determine the correct sequence
of the log input, and correct the JCL so that the log Explanation: This error occurs when restart is
input is in the correct sequence. requested for a data set copy and the indicated
subsystem name is not signed-on to DBRC. It can also
Problem determination: 2, 3, 8, 36. If running under
occur when restart was not requested and the indicated
the utility control facility, rerun the job with a
subsystem name was already signed-on to DBRC. The
FUNCTION=OP, MSGNNN=3335 control statement in
name nnnncccc represents the global data management
the DFSYSIN data set. Supply a DFSUDUMP DD
block number, DCB number, and the IMSID for the
statement to this step.
online IMS subsystem to which the online image copy
If a DFSUSNAP DD statement is specified, then is connected.
diagnostic information is written to that data set in
System action: The execution is terminated with an
dump format to help locate the log record in error. The
error.
information is dumped in four parts:
Programmer response: If restart was not requested,
online image copy should be rerun, specifying restart.
If restart was specified, online image copy should be System action: The IMS subsystem continues while
rerun without specifying restart. If the online, but the scheduled application terminates. For
checkpoint-restart facilities are not being used, the batch or utility, the subsystem terminates and receives
DBRC command CHANGE.SUBSYS must be issued to message DFS047A with a reason code of 09.
do an abnormal sign off for the name nnnncccc, and
Operator response: (master terminal) Notify your IMS
online image copy rerun to copy the complete data set
system programmer of the message.
again.
Related information:
“DFS047A” on page 22
DFS3339A DATABASE AUTHORIZATION
FAILURE. CODE - n
DFS3341I DATA BASE dbname IS USING DATA
Explanation: Code n identifies the reason for the
SETS NOT REGISTERED WITH DBRC
authorization failure.
Explanation: The DDNAME or DSNAME identified
Code (hex)
by dbname in the message was passed to DBRC, but did
Meaning
not match the names registered to DBRC. When IMS
4 IMS online subsystem could not obtain a authorizes the use of a database with DBRC, the
database authorization for the database to be DDNAME and DSNAME of the first database data set
copied. If you issued the /DBR command for are passed to DBRC. DBRC compares these names with
the database, make sure that it is available to those registered for the database.
the online system by issuing a /START
System action: IMS treats the database as though it
command.
were not registered to DBRC at all (that is, no DBRC
8 An authorization for the Online Image Copy authorization protection is provided for this database).
failed. Another IMS subsystem (batch or This means that no database or block level data sharing
online), other than the online IMS subsystem can take place for this database.
which Online Image Copy is connected to, has
Programmer response: If you want to use data sets
update authorization for the database to be
that do not match those registered in the DBRC
copied.
RECON, then no action is required. If the intent is to
C Online Image Copy authorization failed use the correct database data sets, correct the startup
because the database is not recoverable. JCL or dynamic allocation member, or the DBRC
registration.
System action: The execution is terminated with an
error.
DFS3342I AREA areaname IS NOT REGISTERED
Programmer response: The online IMS subsystem to
WITH DBRC. INVALID FOR GLOBAL
which the Online Image Copy is connected, must be
CMND
the only subsystem authorized for updating capability.
This error also indicates that another Online Image Explanation: A global command was issued to register
Copy, connected to another online IMS subsystem, an area that was not registered with DBRC. A global
currently has the authorization to make a copy of this command is accepted only if an area is registered to
data set in the database. If the database is a HALDB DBRC; otherwise, the command is considered invalid.
partition and the master database has been deallocated,
System action: IMS ignores the command and
then the database must be started before authorization
continues processing.
is granted at the partition level.
Operator response: Ask the database administrator if
Module: DFSUICP0
the named area should be registered to DBRC. If the
area is not registered, enter the correct command.
DFS3340I DFS3340I - IRLM VERIFY REQUEST
FAILED. RC=xxx,yyy
DFS3343E CANNOT PROCESS DFSTCF LOAD
Explanation: During a database authorization COMMAND, REASON=xx
processing, IRLM was called to verify the subsystems
Explanation: IMS was unable to process the DFSTCF
which were previously authorized to use the database
LOAD command. The reason code explains why IMS
with an update or read intent. The IRLM verification
was unable to process this command:
request failed because of a nonzero return code from
IRLM. The return code xxx represents the IRLM return Reason code
code and the return code yyy represents the IRLM Meaning
feedback subcode. If XXX=012 and YYY='zz', the value 01 The queue module could not enqueue the
indicates that the number of subsystem entries for the TCO logical terminal DFSTCFI on the new line
verification request exceeds the maximum capacity or node.
currently supported. 02 TCO logical terminal DFSTCFI was having a
message dequeued and sent. It cannot be The value of x (FIELD x) can be one of the following:
reassigned until it is finished. 01 The first positional keyword is not DFSTCF.
03 Either the physical terminal that is associated 02 The second positional keyword is not LOAD.
with the LTERM specified in the DFSTCF 03 The third positional parameter was not
LOAD OUTPUT command or the physical specified. The third positional parameter
terminal that TCO LTERM DFSTCFI is xxxxxxxx is a 1-8 character script name.
assigned to was in conversational mode, preset 04 The fourth (optional) positional keyword is not
mode, response mode, or is in a signed-on OUTPUT.
subpool. 05 The fifth positional parameter was not
04 The physical terminal that is associated with specified or is greater than eight characters.
the LTERM specified in the DFSTCF LOAD yyyyyyyy is a 1-8 character LTERM name.
OUTPUT command or the physical terminal 06 The sixth (optional) positional keyword is not
that TCO LTERM DFSTCFI is assigned to was CONT.
switched line. 07 The seventh positional parameter was not
05 The TCO LTERM DFSTCFI cannot be assigned specified or is a number greater than two
to a PTERM defined MSGDEL=SYSINFO. For digits. zz is a number from 1 to 99.
example, TCO LTERM DFSTCFI has messages
System action: The DFSTCF LOAD command is
queued on the system queue.
ignored. Processing continues.
06 The TCO LTERM DFSTCFI cannot be assigned
to a PTERM defined MSGDEL= NONIOPCB. Operator response: Correct the DFSTCF LOAD
For example, TCO LTERM DFSTCFI has command and resubmit.
messages queued on the system or application
output queue.
07 A request for another script member was DFS3345E DFSTCF DOES NOT CONTAIN
already in progress. MEMBER name
System action: The DFSTCF LOAD command is not Explanation: The data set specified on the DFSTCF
processed. IMS continues. DD statement did not contain the timetable member
identified in the message.
Programmer response: Take the action associated with
the reason code received: System action: If the Time-Controlled Operations
Verification utility was running, the utility terminates.
Reason code If IMS online was running, the DFSTCF LOAD
Action command fails, but IMS processing continues.
01 This code denotes a system error. Shut down
the system and create a memory dump at the Programmer response: Verify that the timetable
earliest possible time for analysis of the member is specified correctly and that the timetable
problem. Notify the IMS system programmer. member resides in the data set specified on the
02 Reenter the DFSTCF LOAD command after DFSTCF DD statement. Rerun the utility or reissue the
the current message is completed, or reenter DFSTCF LOAD command.
the DFSTCF LOAD command without the
OUTPUT option. DFS3346E TCO EXIT RECEIVED STATUS CODE
03 Wait for the terminal to be freed, or reenter the status code
DFSTCF LOAD command with a different
LTERM name. Explanation: The Time-Controlled Operations (TCO)
04 Reenter the DFSTCF LOAD command with an language interface routine returned a status code to the
LTERM that is associated with a valid line. TCO exit routine.
05 Reenter the DFSTCF LOAD command with a System action: The TCO message was not processed.
different LTERM name. TCO processes the next time request.
06 Reenter the DFSTCF LOAD command with a
different LTERM name.
07 Reenter the DFSTCF LOAD command. DFS3348E UNABLE TO ESTABLISH ESTAE
Created by ActiveSystems 12/24/96
Entity not defined. TCO UNAVAILABLE
DFS3344E DFSTCF LOAD CONTAINS INVALID
CHARACTER IN FIELD x Explanation: The Time-Controlled Operations (TCO)
ESTAE routine was not established.
Explanation: The DFSTCF LOAD command is
incorrect. FIELD x identifies the invalid keyword or System action: TCO terminates, but IMS continues
parameter. processing.
The format for the DFSTCF LOAD command is: Programmer response: Make sure that the ESTAE
routine was bound correctly and that enough storage is
DFSTCF LOAD XXXXXXXX (OUTPUT YYYYYYYY) (CONT ZZ)
available.
System action: TCO rejects the time schedule request than 8 characters must be left-aligned and padded with
and processing continues. blanks. Rerun the TCO Verification utility for this
timetable member.
Programmer response: Correct the time schedule
request. Make sure that:
v The resident indicator is valid. DFS3361E INSUFFICIENT VIRTUAL STORAGE
v The resident indicator is specified in column 31. FOR TABLES
Explanation: The Time-Controlled Operations (TCO)
Rerun the TCO Verification utility for this timetable
was unable to acquire enough storage to build the
member.
message or request tables.
System action: The Time-Controlled Operations (TCO)
DFS3358E DISPATCH INDICATOR INCORRECT,
terminates the timetable member load and frees all
SEQUENCE NUMBER=nnnnnnnn
storage.
Explanation: Only a blank (schedule at same time
Programmer response: Specify more storage and then
each day), an O (schedule first day and delete), or an S
restart the job. See the Summary Report produced by
(schedule at startup) are valid codes in column 32 of
the TCO Verification utility to determine the amount of
the time schedule request. The sequence number
storage needed for a specific timetable member.
identifies the statement containing the error.
System action: The Time-Controlled Operations (TCO)
DFS3362E TIME tttt SPECIFIED IS INVALID,
or the TCO Verification utility rejects the time schedule
SEQUENCE NUMBER=nnnnnnnn
request and processing continues.
Explanation: One of the time fields of a time schedule
Programmer response: Correct the time schedule
request (columns 7-10, 21-24, or 26-29) did not contain
request error. Make sure that:
either blanks or a value between 0001 and 2359. tttt
v The dispatch indicator is in column 32.
identifies the invalid time. The sequence number
v The dispatch indicator is valid.
nnnnnnnn identifies the statement containing the error.
Rerun the TCO Verification utility for this library System action: The Time-Controlled Operations (TCO)
member. or the TCO Verification utility rejects the time schedule
request and processing continues.
DFS3359E MESSAGE SET INDICATED, NO Programmer response: Make sure that the time is
MESSAGE FOUND SEQUENCE valid and is specified in the correct columns. Valid HH
NUMBER=nnnnnnnn values are 00-23; valid MM values are 00-59. Rerun the
TCO Verification utility for this timetable member.
Explanation: The time schedule request specified the
use of a previous message set (**** in columns 56-59),
but the message set was not provided. The sequence DFS3363E UNABLE TO OPEN SYSIN
number identifies the statement containing the error.
Explanation: The TCO Verification utility was unable
System action: The Time-Controlled Operations (TCO) to open the SYSIN input data set.
or the TCO Verification utility rejects the time schedule
System action: The TCO Verification utility
request and processing continues.
terminates.
Programmer response: Add the missing message set,
Programmer response: Make sure that the SYSIN DD
or delete the time schedule request. Rerun the TCO
statement is present, and if present, the SYSIN data set
Verification utility for this library member.
exists. Rerun the TCO Verification utility for this
timetable member.
DFS3360E USER EXIT xxxxxxxx REQUESTED NOT
FOUND, SEQUENCE
DFS3364E UNABLE TO OPEN SYSPRINT
NUMBER=nnnnnnnn
Explanation: The TCO Verification utility was unable
Explanation: IMS.SDFSRESL did not contain exit
to open the SYSPRINT output data set.
routine xxxxxxxx specified in columns 12-19 of a time
schedule request. The sequence number identifies the System action: The TCO Verification utility
statement containing the error. terminates.
System action: The Time-Controlled Operations (TCO) Programmer response: Make sure that the SYSPRINT
rejects the time schedule request and processing DD statement is present and the SYSOUT class is valid.
continues. Rerun the TCO Verification utility for this timetable
member.
Programmer response: Check the spelling or the
justification, or both, of the name. Names with fewer
DFS3368E
DFS3370E NO SYSTEM RESOURCE DEFINITION
DATA SETS AVAILABLE FOR
AUTOMATIC EXPORT DFS3373I AUTOMATIC EXPORT IS ENABLED
TO RDDS
Explanation: There were no valid system resource
definition data sets that can be used for automatic Explanation: Automatic export processing is enabled.
export processing. This message is highlighted and Resource and descriptor definitions will be
remains highlighted until a resource definition data set automatically exported to a system resource definition
becomes available. data set (RDDS) at checkpoint time.
System action: IMS continues processing. The System action: IMS continues processing.
automatic export process is disabled until one or more
of the system resource definition data sets are fixed. User response: No action is required.
System action: IMS continues processing. Programmer response: If you do not want to use
automatic export processing, no action is necessary.
User response: No action is required.
If you want automatic export processing, use the return
Module: DFSXP000 code to identify and correct the specification error in
the DFSDFxxx IMS.PROCLIB member.
DFS3372E AUTOMATIC EXPORT FAILED, RC=rc Module: DFSDFN10, DFSRDD10
Explanation: An automatic export failed. rc indicates
the reason for the failure. The return code rc values are DFS3375 UNABLE TO ACQUIRE STORAGE IN
as follows: SUBPOOL 0 FOR MODIFY
Codes COMMAND
Explanation Explanation: The /MODIFY or INITIATE OLC
4 An I/O error occurred while trying to access a command processor failed to get storage in the private
resource definition data set (RDDS). region.
8 No RDDS data sets are available. System action: The command is ignored.
12 An error occurred trying to obtain a 64-bit buffer. Operator response: Reenter the command when there
is less activity in the private region and more storage is
System action: IMS continues processing. available. If the problem occurs often, increase the size
Programmer response: To determine the cause of the of available storage in the private region.
failure, see any DFS3368E messages that were issued
before this message.
Module: DFSXP000
Related information:
ee can have the following values: Explanation: The attempt to disconnect from the
VSAM or OSAM structure, or both, in the coupling
Code (hex) facility failed. The DATA part of the message defines
Meaning the reason for the failure.
80 A dummy PST was obtained during aa The place code, which identifies where the
coupling facility services initialization error was found. aa can have the following
or execution. values:
40 Connection to the OSAM structure
was successful. Code (hex)
20 Disconnection from the OSAM Meaning
structure was successful. 60 Disconnection from the OSAM
10 Connection to the VSAM structure structure failed.
was successful. 70 Disconnection from the VSAM
08 Disconnection from the VSAM structure failed.
structure was successful. bbbbbbbb
The return code from the last service started.
ff can have the following values: See z/OS MVS Programming: Sysplex Services
Reference (SA22-7618) for the values of this
Code (hex) code.
Meaning cccccccc The associated reason code. See z/OS MVS
80 A request was received to stop data Programming: Sysplex Services Reference
sharing because coupling facility (SA22-7618) for the values of this code.
services initialization failed. ddeeffgg the associated flag bytes.
gg can have the following values: dd can have the following values:
Code (hex)
Meaning DFS3386I OSAM CF CACHING RATIO = ddd:eeer
80 A request was received to stop data
Explanation: A coupling facility structure was defined
sharing because coupling facility
for OSAM. The values specified for ddd and eee
services initialization failed.
represent the coupling facility directory-to-element
ratio. The directory-to-element ratio is active for the
gg can have the following values: issuing IMS. These values might be used to configure
Code (hex) the OSAM structure. The ratio values active for the first
Meaning IMS that connects to the coupling facility establishes
80 A read-and-register operation for the the directory-to-element ratio. Other IMS regions
OSAM buffer failed. connecting to the same structure will use the structure
20 Buffer invalidation for the OSAM previously configured.
buffer failed. The value represented by r indicates whether a default
System action: Although the IMS attempt to ratio or an externally-specified ratio is active. r has the
disconnect from the coupling facility failed, data following values:
sharing was successfully stopped. 1 The CFOSAM= keyword on the CFNAMES
statement did not specify the
Programmer response: See z/OS MVS Programming: directory-to-element ratio. IMS supplies a
Sysplex Services Reference (SA22-7618) for error return default ration of 999:1.
and reason codes that identify the cause of the failure. 2 The directory-to-element ratio was specified
Problem determination: 1, 2, 3, 36 with the CFOSAM= keyword and is active.
3 The directory-to-element ratio was specified
Related information:
with the CFOSAM= keyword, but defines an
Chapter 2, “IMS problem determination,” on page 5 incorrect ratio and cannot be used. The result
of dividing the element value by the directory
DFS3384I DATA SHARING STOPPED value must not exceed the maximum number
of 16 elements. The ratio IMS provided is used
Explanation: Data sharing was successfully stopped. instead of the externally specified ratio.
Data sharing stops under these circumstances: 4 The element portion of the
v Connection to the coupling facility is lost. directory-to-element ratio as specified by the
v Rebuild of the coupling facility fails. CFOSAM= keyword is zero. The resultant
v Coupling facility initialization fails. ratio becomes 1:0. This ratio causes the OSAM
structure to be configured for directory-only
System action: Regardless of whether the connection
processing. No data elements will be available
was lost for an OSAM or VSAM structure, if both
for data caching.
structures were specified on the CFNAMES control
statement, data sharing is stopped for both and System action: IMS initialization processing continues.
connection to both structures is lost. If only one of the The ratio specified is active for the issuing IMS.
structures was specified, the other can continue data
sharing using the notify protocol. Programmer response: No response is required unless
the directory-to-element ratio used to configure the
Programmer response: No action is required. OSAM structure is not the ratio you want. In this case,
specify or change the directory and element values on
the CFNAMES statement and restart the IMS sysplex.
DFS3385I DUPLICATE CF STRUCTURE NAME
SPECIFIED
DFS3387I DUPLICATE xxxxxx KEYWORD
Explanation: Duplicate coupling facility structure
SPECIFIED FOR CFNAMES
names were specified in the CFNAMES control
statement. Structure names for the IRLM, OSAM, and Explanation: A keyword on the CFNAMES control
VSAM structures must all be different when specified. statement (CFIRLM, CFOSAM, or CFVSAM) was
specified more than once. Each keyword can only be
System action: IMS terminates with abend 0430.
specified once.
Programmer response: Correct the CFNAMES control
System action: The duplicate keyword is ignored, and
statement, and resubmit the job.
the rest of the statement is bypassed.
Problem determination: 1, 2, 3, 36
Programmer response: See member DFSVSMxx in
IMS system definition information. Verify the CFNAMES control statement or blanks if the
CFNAMES control statement, and make appropriate mismatch involved the DBRC RECON time
changes if necessary. stamp.
wwwwwwwwwwwwwwww
Problem determination: 1, 2, 3, 36
The structure name the IRLM has in use or
Related reference: blanks if the mismatch involved the DBRC
RECON time stamp.
DFSVSMxx member of the IMS PROCLIB data set
(System Definition) System action: IMS terminates with abend 0039.
Related information: Programmer response: Verify that all IMS subsystems
Chapter 2, “IMS problem determination,” on page 5 sharing a coupling facility specify the same names to
the IRLM for any OSAM, VSAM, or IRLM structure
that was used. All sharing subsystems must also use
DFS3388I ALL CF KEYWORDS ARE REQUIRED
the same RECON data set.
ON CFNAMES CARD
Problem determination: 1, 4, 10, 35
Explanation: All keywords (CFIRLM, CFOSAM, and
CFVSAM) must be specified on the CFNAMES control Related information:
statement. All keywords must be specified even if their
IMS abend 0039
respective structures are not to be used.
System action: IMS terminates with 0430.
DFS3390I NO CF CONNECTION EXISTS. /ERE
Programmer response: Fix the CFNAMES control BACKUP NOT ALLOWED.
statement, and resubmit the job.
Explanation: The /ERE command entered on the XRF
Problem determination: 1, 2, 3, 36 alternate subsystem was rejected. This is because
Related information: connection to the coupling facility did not exist when
the command was processed.
IMS abend 0430
System action: The /ERE BACKUP command is
Chapter 2, “IMS problem determination,” on page 5 rejected until connection to the coupling facility is
established.
DFS3389I MISMATCH - xxxx yyyyyyyyyy Programmer response: Retry the /ERE BACKUP
zzzzzzzzzzzzzzzz ++ command when the coupling facility connection is
wwwwwwwwwwwwwwww established.
Explanation: The IDENTIFY request to the IRLM Problem determination: 1, 36
failed. The IRLM detected a mismatch between one of
Related information:
the following:
v The coupling facility structure name it was using and Chapter 2, “IMS problem determination,” on page 5
the one specified in the IDENTIFY request
v The DBRC RECON time stamp it was using and the DFS3391I CFNAMES SPECIFIED BUT IRLM IS
one specified in the IDENTIFY request NOT USED
completed for all of the specified resource and Programmer response: Provide the missing DD
descriptor definitions. xxxx can be ALL, SOME or statement or create the data set, or both, referenced by
NONE. the MODSTAT DD statement using the INITMOD
dsname Indicates the name of the resource definition procedure and run IMS. See IMS system definition
data set (RDDS) from which the resource and information for the INITMOD procedure.
descriptor definitions were imported. Related information:
System action: IMS continues processing.
IMS abend 3411
Programmer response: If the IMPORT command did
not complete successfully for all of the resource and
DFS3412 ERROR READING MODSTAT DATA
descriptor definitions that you specified, determine the
SET
cause of the error and reissue the IMPORT command.
Explanation: An I/O error was detected while
Module: DFSIP100
attempting to read the MODSTAT data set.
System action: IMS terminates abnormally with abend
DFS3410I DATA SETS USED ARE DDNAME
3412.
acblib-name format-name 'MODBLKS-name'
(time/date stamps if they exist) Programmer response: Reconstruct the MODSTAT
data set, using the INITMOD procedure with the
Explanation: The indicated ddnames are the ones
ddnames indicated on the last successful DFS3410I, or
which are used for IMS online processing. If time/date
DFS3499I message, and run IMS. For a description of
stamps exist, they indicate when the last successful
the INITMOD procedure, see the IMS system definition
INITIATE OLC PHASE(PREPARE) or /MODIFY
information. For the appropriate recovery actions in an
PREPARE and INITIATE OLC PHASE(COMMIT) or
XRF environment, see the information about Extended
/MODIFY COMMIT commands were issued.
Recovery Facility. If this message is issued by the Fast
In the message text: Database Recovery region, terminate the active IMS
acblib-name and reconstruct the MODSTAT data set. Then restart
The active IMSACB DD in the IMS JCL, which IMS, and start the Fast Database Recovery region again.
identifies the active ACBLIB library. The Related concepts:
acblib-name is either IMSACBA or IMSACBB.
format-name Extended Recovery Facility Overview (System
The active FORMAT DD in the IMS JCL, Administration)
which identifies the active MFS format library. Related information:
The format-name is either FORMATA or
FORMATB. If this system is DBCTL, IMS abend 3412
format-name is blank.
modblks-name
DFS3413X INVALID CONTENTS IN THE
The active MODBLKS DD in the IMS JCL,
MODSTAT DATA SET
which identifies the active MODBLKS library.
The modblks-name is either MODBLKSA or Explanation: The MODSTAT data set contains invalid
MODBLKSB. data.
modblks-name can be blank. If modblks-name is System action: IMS terminates abnormally with abend
blank, then MODBLKS DD is not defined in 3413.
the IMS JCL. The MODBLKS DD statements
Programmer response: Reconstruct the MODSTAT
are optional when dynamic resource definition
data set, using the INITMOD procedure with the
is enabled.
ddnames indicated on the last successful DFS3410I, or
System action: IMS processing continues. DFS3499I message, and run IMS.
Operator response: No action is required. Related information:
Related information: missing, and run IMS. Ensure that the active
MODBLKSA(B) data set is APF-authorized.
IMS abend 3414
Related reference:
DFS3415X LIBRARY xxxxxxxx IN USE BY IMS system services return codes (Messages and
ANOTHER OS/VS TASK Codes)
Related information:
Explanation: The library associated with ddname
xxxxxxxx could not be used because it was already in IMS abend 3419
use by another OS/VS task.
System action: IMS terminates abnormally with abend DFS3420X RESIDUAL MESSAGES EXIST FOR
3415. DELETED TRANSACTIONS
Programmer response: Wait until the other task has Explanation: IMS detected existing messages for a
released the library, and run IMS. transaction that does not exists. The transaction
Related information: definition does not match the message activity
indicated on the IMS system log.
IMS abend 3415
System action: IMS terminates abnormally with abend
3420.
DFS3416X OPEN FAILED FOR LIBRARY xxxxxxxx
Programmer response: The log data set is inconsistent
Explanation: The library associated with ddname with the definition in the MODBLKS data set. The SMB
xxxxxxxx could not be opened at IMS initialization blocks, which were loaded from MODBLKS during
time. initialization, are not the same as those which were last
System action: IMS terminates abnormally with abend active during the prior IMS execution. This situation
3416. can occur if the MODSTAT data set was reconstructed
specifying an incorrect ddname of the active
Programmer response: Determine why open failed, MODBLKS data set. It can also occur by changing the
and then run IMS. contents of the MODBLKS data set while IMS was not
Related information: active. Use the same copy of MODBLKS that was in
use during the last IMS execution, and restart IMS with
IMS abend 3416 a /ERE from the last checkpoint that was taken with a
memory dumpQ.
DFS3418X UNABLE TO DELETE MODULE Related information:
xxxxxxxx
IMS abend 3420
Explanation: The modulexxxxxxxx could not be
deleted from the active MODBLKSA(B) data set.
DFS3421X UNABLE TO FIND xxxx CONTROL
System action: IMS terminates abnormally. BLOCK NAMED yyyyyyyy.
Programmer response: This is probably an IMS Explanation: This message is issued during an IMS
internal error. cold start if a PDIR or RCTE cannot be found because
either no PDIRs exist or no RCTEs exist. xxxx is the
Problem determination: 35
control block type, PDIR or RCTE. yyyyyyyy is set to
Related information: DFSHSHT to indicate the internal resource control
Chapter 2, “IMS problem determination,” on page 5 block hash table is empty.
These blocks can be loaded from MODBLKS, or using
DFS3419X UNABLE TO LOAD MODULE xxxxxxxx an automatic import from the resource definition data
RC=xx set (RDDS).
Explanation: The module xxxxxxxx could not be found System action: IMS issues an abend 3421 following
in the active MODBLKSA(B) data set, or the data set message DFS3421X. IMS terminates abnormally.
was not APF-authorized. Alternatively, this message
Programmer response: If dynamic resource definition
indicates that there was not enough virtual storage
(DRD) is not enabled, check that IMS.MODBLKSx
available in the IMS control region. For a description of
contains the correct control block modules, DFSSMB0x,
the IMODULE LOAD return codes, see IMS system
DFSPDIRx, DFSDDIRx, and DFSRCTEx. If these checks
services return code information.
do not indicate a problem, contact IBM Software
System action: IMS terminates abnormally with abend Support for assistance.
3419.
If DRD is enabled, and resource definitions are being
Programmer response: Determine why the module is imported from the IMS.MODBLKSx data set during a
cold start, check that IMS.MODBLKSx contains the In the message test:
correct control block modules, DFSSMB0x, DFSPDIRx, resourcetype
DFSDDIRx, and DFSRCTEx. If resource definitions are The resource type can be one of the following:
being imported from an RDDS during a cold start, v DBBD – database descriptor
check that the correct RDDS is being used and that the v DDIR – database
RDDS has a complete set of resource definitions. If v PDIR – program
these checks do not indicate a problem, contact IBM v PGMD – program descriptor
Software Support for assistance. v RSCX – resource extension block
v RTCD – routing code descriptor
Problem determination: 36
v RTCE – routing code
Related information: v SMB – transaction
Chapter 2, “IMS problem determination,” on page 5 v TRND – transaction descriptor
servicename
Name of the service that encountered an error.
DFS3422X INSUFFICIENT STORAGE FOR Other than DFSBCB, the services are internal
resource_type CONTROL BLOCKS. to IMS.
Explanation: IMS was unable to acquire enough function Name of the service function that encountered
storage in subpool 231 (Common CSA/ECSA) to create an error.
the specified control blocks. These blocks might be a returncode
group of control blocks loaded into an IPAGE from Service return code. If the servicename is
MODBLKS, or an individual resource that is DFSBCB, see the DFSBCB return codes.
dynamically created. resourcename
Name of the resource that encountered the
In the message text: error
resource_type modulename
The resource type can be one of the following: Name of the module that encountered the
DBBD database descriptor error
DDIR database
HSMB hash SMB. The SMB hash table is full. System action: In some cases, IMS terminates
There are not enough hash table slots, abnormally with abend 3423. In other cases, IMS
including free pool slots, to add an continues processing without the use of the resource.
SMB to the hash table. System programmer response: Check whether your
PDIR program MODBLKS data set is generated at the appropriate IMS
PGMD program descriptor release level. If you are starting an IMS that references
RSCX resource extension block a MODBLKS data set generated at an older IMS release
RTCD routing code descriptor level, the mismatch usually results in the DFS3423E
RTCE routing code message.
SMB transaction resource
TRND transaction descriptor If the MODBLKS data set is generated at the same IMS
release level, copy the SYSLOG and IMS memory
System action: IMS terminates abnormally with abend dump and contact IBM Software Support for help. Also
3422. save the servicename, function, returncode, and other
System programmer response: Increase the amount of information from the message.
storage for subpool 231. Module: DBFNRST0, DBFRRT00, DFSRDB00,
Problem determination: 36 DFSRPG00, DFSRTR00
Related reference:
Module: DBFRRT00, DFSCPDM0, DFSRDB00,
DFSRPG00, DFSRTR00 DFSBCB return codes (Messages and Codes)
Related information: Related information:
IMS abend 3422 IMS abend 3423
Chapter 2, “IMS problem determination,” on page 5
DFS3424I DFSINSX0 CREATE resourcetype ERROR
DFS3423E RESOURCE ERROR TYPE=resourcetype RC=returncode RSN=reasoncode
SERVICE=servicename FUNC=function CC=completioncode NAME=resourcename
RC=returncode NAME=resourcename
Explanation: The DFSINSX0 user exit attempt to
MODULE=modulename
dynamically create a program or a transaction failed.
Explanation: IMS encountered an error initializing a The failure was caused by an invalid attribute or
resource control block. attribute combination. Examples of attribute errors:
v The transaction has an invalid program name.
CREATE TRAN command (Commands) Explanation: The system could not read the
PLEXPARM parameters from RM due to an error from
the Resource Manager (RM). The RM error return and
DFS3425I PLEXPARM INIT VALUE reason codes are listed in the DFS3308 issued before
rrrrrrrr=vvvvvvvv OVERRIDDEN WITH this message. You cannot use the same IMS
GLOBAL PLEXPARM VALUE PLEXPARM values as the values in RM.
rrrrrrrr=vvvvvvvv
System action: IMS continues processing.
Explanation: The PLEXPARM value for resource
rrrrrrrr did not match the value in the Global Plex System programmer response: If you want to ensure
Parm entry. The value from the Global Plex Parm entry IMS and RM are in sync, take the following action:
was used. 1. After IMS restart is complete, issue a QRY IMS
TYPE(PLEXPARM) SHOW(ALL) command.
In the message text: 2. If the IMS and RM values in the QRY IMS output
rrrrrrrr The Global Plex Parm whose PLEXPARM are identical, no further action is required.
value is overridden with the value in the 3. If there is a mismatch in the PLEXPARM values
Global Plex Parm entry. between IMS and RM from the QRY IMS command
vvvvvvvv output, the user can choose to:
The value of the Global Plex Parm. Option 1
System action: The value from the Global Plex Parm Cancel or shut down IMS, fix the RM error
entry is used for the specified resource. reported in the DFS3308 message, and
restart IMS.
System programmer response: No action is required. Option 2
If the value for the specified resource does not match Take the following actions:
what is wanted for the IMSplex, use the UPD IMS SET v If the RM value for PLEXPARM
command to change the Global Plex Parm value. GSTSTRAN is an N and the IMS value is
a Y, issue a UPD IMS
System action: The command is ignored. v One or more ACB library member online change
processes occurred while this IMS was not active in
Operator response: Perform one of the following
the IMSplex.
actions:
v The ACB member online changes that occurred while
v If another online change command is in progress,
this IMS was not active in the IMSplex are not in the
wait for the online change command (/MODIFY or
active ACB library of this IMS.
/DISPLAY MODIFY) to complete before entering this
online change command.
Manually update the ACB members in the ACB library
v If IMS is already in an online change prepare state,
so that the 1MOLCID field in the X'4001' log record
terminate or commit the online change before
matches the MOLCID field in the OLCSTAT data set.
attempting the /MODIFY PREPARE or INITIATE
OLC PHASE(PREPARE) commands again.
Attention: If you run this IMS before the MOLCID
Module: DFSICVD0, DFSICLV0, DFSICV10, values match, IMS might have data integrity problems
DFSIDPG0 or might terminate abnormally.
DFS3432 RACF PARAMETER INVALID IF RACF To make the MOLCID values match, perform one of
DATA SPACE USED the following tasks:
1. Perform one or more ACB member online change
Explanation: When RACF (or equivalent product) processes to synchronize the MOLCID field in the
with the GLOBAL=YES support is used, the X'4001' log record with the MOLCID field in the
RACF-defined IMS transactions and command profiles OLCSTAT data set.
are loaded into a RACF data space. The IMS online 2. Shut down IMS and run the ACB Maintenance
change command /MODIFY PREPARE RACF cannot utility.
be used to refresh these profiles when they are in a a. Shut IMS down normally.
RACF data space. b. Run the ACB Maintenance utility for those
member online changes and apply the changed
System action: The command is ignored.
ACBs directly to the active ACB library. Ensure
Operator response: The RACF-defined IMS profiles in that the ACB library includes all the ACB library
the RACF data space can be refreshed by using the members online up to the time of the MOLCID
RACF command SETROPTS RACLIST (classname) in DFS3433W.
REFRESH. An example of a classname is TIMS. TIMS is c. Restart IMS.
the RACF classname for IMS transaction profiles.
Module: DFSRLP00
Module: DFSICVF0
DFS3434W UNABLE TO OPEN DDNAME 'ddname'
DFS3433W ACBLIB MEMBER OLC ID
Explanation: IMS encountered an error trying to open
MISMATCH MOLCID=yyyyddd hhmmss
the data set with ddname. Either the DD statement does
Explanation: One or more ACB library member online not exist or the operating system has encountered an
changes occurred while IMS was not active in the I/O error during open processing.
IMSplex. IMS restart processing detected that the value
System action: The command is ignored.
in the MOLCID field in the restart checkpoint log
record (X'4001') is not the same value as in the Programmer response: The data set for ddname was
MOLCID field in the OLCSTAT data set. probably not created. You must create the data set, if it
MOLCID=yyyyddd hhmmss is the local time stamp of is an I/O error.
the last member online change process that was
committed while IMS was not active in the IMSplex.
DFS3435A UNABLE TO LOCATE OR LOAD
System action: IMS restart continues normally. MODULE DFSnnnns. RETURN
CODE=abcd
System programmer response: If ACBSHR=Y, then the
ACB library member online change has been included Explanation: IMS is unable to locate or load the
and the restarting IMS does not need to take any indicated module DFSnnnns from the inactive
action. MODBLKS data set.
If ACBSHR=N, then its ACB library does not include any In the message text:
ACB member online changes while the restarting IMS nnnn Represents the MODBLKS member name,
is down. either DDIR, PDIR, RCTE, or SMB0.
s Represents the member name suffix.
When this message is issued because ACBSHR=N is
abcd Represents the 4-digit return code, where ab is
specified for this IMSplex, it means that:
the IMODULE LOAD return code, and cd is
v IMS systems in the OLCSTAT data set do not share
the IMODULE LOCATE return code.
ACB libraries.
See the IMODULE LOAD and IMODULE LOCATE Programmer response: If the I/O error occurred on a
return codes documented in the IMS system services data set currently in use by the online IMS system, that
return code information. system might shortly encounter a similar condition. If
the error occurred for an inactive data set, you should
System action: If the module is necessary for
recreate that data set.
continued operations, the /MODIFY or INITIATE OLC
preparation is terminated. Otherwise, the message is a
warning and the command attempts to complete. DFS3440E CHECKPOINT IS REJECTED - ONLINE
CHANGE COMMIT IS IN PROGRESS
Programmer response: Be sure that the library is APF
authorized. Run the offline MODBLKS system Explanation: A /CHECKPOINT command was
definition steps to build the required modules or run rejected because online change commit was in progress.
the Online Change utility to copy the MODBLKS data
System action: The /CHECKPOINT command is
set.
rejected.
Related reference:
Operator response: Try the /CHECKPOINT command
IMS system services return codes (Messages and again after online change commit is completed.
Codes)
Module: DFSICM30, DFSRCP00
v TERMINATE OLC
DFS3444W TRAN tranname CONFLICTS WITH
v /MODIFY COMMIT
DYNAMIC LTERM, /MODIFY
v INITIATE OLC PHASE(COMMIT)
ABORTED
Explanation: A /MODIFY PREPARE or INITIATE If you enter the /MODIFY ABORT command followed
OLC PHASE(PREPARE) command was entered that by the /MODIFY PREPARE , or the TERMINATE OLC
attempted to add a transaction name that conflicts with command followed by the INITIATE OLC
a dynamic LTERM name. The tranname variable names PHASE(PREPARE) command, the resident index
the transaction that already exists as a dynamically ($$IMSDIR) might be made smaller.
created LTERM.
System action: The /MODIFY PREPARE or INITIATE If you enter the /MODIFY COMMIT or INITIATE OLC
OLC PHASE(PREPARE) command is aborted. PHASE(COMMIT) command, the resident index will be
truncated by the number of entries indicated in this
Programmer response: Determine whether tranname message, but the switch to the inactive format library
should be a LTERM or a transaction. If it should be an would continue. The reserved area for expansion of the
LTERM, remove tranname from the inactive MODBLKS indexes in the MFS buffer pool should be increased at
you are trying to change to and retry the online the next IMS restart, or the requirements of the two
change. If tranname should be a transaction, delete the indexes should be reduced. The reserved area is
dynamic LTERM by removing status and queue counts specified in the FORMAT keyword of the system
and initiating a simple checkpoint. To do this, issue the definition BUFPOOLS macro, or as an EXEC parameter
following commands: (FBPR=) in the IMS procedure.
/STOP USER tranname
/DEQ USER tranname PURGE The additional space requirement can be calculated as:
(or /DEQ LTERM tranname PURGE) 12 x (1 + number of added MFS format blocks/12)
/START USER tranname plus
/CHE 14 x (number of new $$IMSDIR entries)
DFS3445 INACTIVE FORMAT LIBRARY IS Explanation: Storage in the IMS extended private area
EMPTY is unavailable for the hash table, for the prime area
($$IMSDIR), or index area of the MFS Dynamic
Explanation: The inactive format library has no Directory, or for the PDS directory index during
members. /MODIFY COMMIT or INITIATE OLC
System action: The /MODIFY PREPARE or INITIATE PHASE(COMMIT).
OLC PHASE(PREPARE) command is aborted. System action: The /MODIFY COMMIT or INITIATE
Programmer response: Copy the updated staging OLC PHASE(COMMIT) command is ignored.
format library to the inactive format library and reissue Programmer response: Reenter the command at a
the command. time when system activity has decreased and more
storage is available.
DFS3446I INDEX AREA IN MFS BUFFER POOL
TOO SMALL. nnnn ENTRIES DFS3448W UNEXPECTED EOF ON DDNAME
TRUNCATED ddname -nn
Explanation: The area in the message format buffer Explanation: The library referenced by the DD
pool (MFBP) reserved during IMS initialization for the statement with the name ddname does not contain the
two indexes used by the MFBP manager is not large expected data. This can be because the DD statement
enough to accommodate the increased indexes that specified "DD DUMMY". If the EOF occurred on a
would result from the /MODIFY PREPARE or FORMAT library which has concatenated data sets, nn
INITIATE OLC PHASE(PREPARE) command being indicates on which of the concatenated data sets of the
entered. EOF was received.
System action: Processing continues. System action: The command is ignored.
System programmer response: If the /MODIFY Programmer response: Correct the DD statement, or
PREPARE or INITIATE OLC PHASE(PREPARE) recreate the data set, and reenter the command.
command completes successfully, enter one of the
following commands:
v /MODIFY ABORT
Operator response: Reenter the transaction at a later Explanation: The library type parameter was not one
time when the transaction or its resources are not being of the following values for the Online Change utility:
modified, and are available for use. ACB
FORMAT
MODBLKS
DFS3471 ROUTING CODE CURRENTLY NOT
AVAILABLE FOR USE System action: The copy is not done and the utility is
terminated.
Explanation: The routing code selected for this
transaction is currently being modified. Programmer response: Correct the parameter, and
rerun the utility.
System action: The entered transaction is rejected by
IMS. Module: DFSUOCU0
DFS3481I INVALID INPUT DDNAME DFS3485I jobname WAITING FOR DATASET data
PARAMETER set name
Explanation: The input ddname parameter for the Explanation: The data set indicated by the message
Online Change utility is not one of the following was already in use by another task. It has caused the
values: indicated job to wait for the release of the data set.
S
System action: The indicated job waits until the data
I
set becomes available.
System action: The copy is not done and the utility is
Operator response: No action is required.
terminated.
When the data set becomes available, the indicated job
Programmer response: Correct the parameter, and
will run.
rerun the utility.
Explanation: An error occurred while attempting to Operator response: If the /MODIFY PREPARE or
read the MODSTAT data set before copying. INITIATE OLC PHASE(PREPARE) command was
terminated and no message DFS3499I was issued,
System action: The copy is not done and the utility is resubmit the command when the data set is available.
terminated.
Programmer response: Determine whether the content DFS3489 OUTPUT MESSAGE CANCELED BY
of MODSTAT is correct. If the data set has been USER OUTPUT EDIT ROUTINE
destroyed, recreate it based on the last DFS3499I
message, and resubmit the job. Explanation: IMS canceled the output message at the
Related information: request of your physical terminal output edit routine. If
the terminal is in response mode, IMS sends this
“DFS3499I” on page 699 message in place of the output message that would
have satisfied response mode. If a system restart
occurred, then IMS resets response mode and does not
send message DFS3489 after a request to discard the Otherwise, this is an informational message.
response message.
System action: IMS sends this message instead of the DFS3492W APPC/IMS TIMEOUT LIMIT
canceled message. REACHED FOR LU luname, TP-ID tp-id,
ASYNC. CONVERSATION. INACTIVE
Operator response: This is an informational message.
SINCE xxxx SECONDS.
Consult your procedures to determine if you must take
any action.
or
Problem determination: 5, 14
Related information: APPC/IMS TIMEOUT LIMIT REACHED FOR LU
luname, TP-ID tp-id, REGION region-id. INACTIVE
Chapter 2, “IMS problem determination,” on page 5
SINCE xxxx SECONDS.
Explanation: APPC/IMS timeout detected a
DFS3490I APPC/IMS TIMEOUT ACTIVE,
dependent region or an asynchronous conversation that
TIMEOUT = xx MINUTES
might have hung. The values of the message text are:
luname The VTAM LU name of the session.
or
tp-id The TP-ID of the APPC conversation.
region-id
APPC/IMS TIMEOUT ACTIVE, TIMEOUT = xx The IMS-dependent region ID or ASYNC. For
MINUTES, ss Seconds an asynchronous conversation, the region ID is
CONV.
or xxxx The number of seconds the conversation is
waiting for a response to an APPC call.
APPC/IMS ASYNC. TIMEOUT ACTIVE, TIMEOUT =
xx MINUTES Programmer response: Issue a V NET,INACT
command for the luname to clean up the dependent
Explanation: APPC/IMS timeout is active. xx is the region or an asynchronous conversation that is
number of minutes and ss is the number of seconds potentially hung. V NET,INACT stops all conversations
defined by the APPCIOT parameter in the DFSPBxxx for the luname, which could be more than just the
PROCLIB member. hung conversation.
System action: IMS checks every xx minutes or ss If the hung conversation is a batch-job, the luname will
seconds to see if an APPC call issued under the be APPC/MVS; in this case, issuing a V NET,INACT
dependent region TCB is inactive after more than xx stops all APPC/MVS sessions. Use the tp-id to
minutes. See the message text for DFS3492W for determine the job-name by issuing the D APPC,TP,ALL
additional information. command, and cancel the batch job.
Programmer response: This message is for
information only. DFS3493I MODBLKS KEYWORD INVALID
Related information: WHEN DYNAMIC RESOURCE
DFS3492W DEFINITION ENABLED
Explanation: The command was not processed
DFS3491I APPC/IMS TIMEOUT DEACTIVATED. because the keyword is invalid in an IMS system with
(SYSTEM SHUTDOWN) (TIMER dynamic resource definition (DRD) enabled.
CANCELED) (DFSTIMER ERROR, System action: The command is ignored.
RC=xx) (APPC NOT ACTIVE (APPCIOT
= 0) (NO MVS SUPPORT) Programmer response: Use DRD commands to modify
resources online.
Explanation: APPC/IMS timeout is inactive. The
message includes the reason why APPC/IMS timeout is
inactive. | DFS3494E OTMA HAS TIMED OUT FOR
| TMEMBER/TPIPE xxxx/yyyy
If the reason is NO MVS SUPPORT, APPC/MVS does
not support the timeout service. The current z/OS level | or
does not support the APPC/MVS timeout service.
When APPCIOT = 0 is listed, the APPCIOT parameter | OTMA HAS TIMED OUT FOR TMEMBER/TPIPE
in DFSDCxxx member has been defined as zero, or has | xxxx/yyyy AND MOVED THE OUTPUT TO zzzz
been changed to zero by the /CHANGE command. | Explanation: OTMA timed out waiting for an ACK or
Programmer response: If the reason is (DFSTIMER | NAK from the OTMA target member (tmember or
ERROR), report the problem to IBM Software Support. | client) xxxx with the transaction pipe (tpipe) yyyy has
| initiated a CM0 timeout action for a missing ACK or | might be an application program, or a failure in the
| NAK. | network component. You can restart the tpipe manually
| with a /STOP TMEMBER tpipe and then a /START
| If the zzzz field is present, the CM0 output message has
| TMEMBER tpipe command.
| been rerouted to the output tpipe zzzz. If the member
| supports the hold queue, the message is moved to the | Programmer response: Make sure that your program
| hold queue of the tpipe zzzz. | issues an ACK or NAK to IMS for the received CM0
| output message. Also, it is possible that there is a
| For an IMS callout message through ICAL, the IMS
| network failure so that the ACK or NAK cannot arrive
| application that issues the synchronous callout request
| at IMS OTMA.
| receives a return code of X'100' and a reason code of
| X'104'. The message is discarded. | Problem determination: Examine the network trace to
| identify which component in the network did not
| In the message text:
| forward the ACK or NAK to IMS.
| xxxx The name of the OTMA client.
| Module: DFSYPSO0
| yyyy The name of the TPIPE on which the time out
| occurred.
DFS3496W DMB XXXXXXXX IN INACTIVE
| zzzz The TPIPE name to which the output was ACBLIB NOT COMPATIBLE WITH
| rerouted. IMS
| System action: Processing continues. Explanation: The level of the inactive library is not
compatible with the current IMS release.
| Operator response: Identify the cause of the missing
| ACK or NAK for this timeout condition. It could be an System action: The /MODIFY PREPARE ACBLIB or
| application program or a failure in the network INITIATE OLC PHASE(COMMIT command terminates.
| component.
Programmer response: Verify that the JCL specifies
| Programmer response: Make sure that your program the correct library and that ACBGEN is performed at
| issues an ACK or NAK to IMS for the received CM0 the appropriate level for the current release of IMS
| output message. Also, it is possible that there is a
| network failure so that the ACK or NAK cannot arrive
DFS3497A AN INVALID MOLC LOG RECORD
| at IMS OTMA.
DETECTED AND IGNORED
| Problem determination: Examine the network trace to RSN=aaaaaaaa RC=bbbbbbbb
| identify which component in the network did not TOKEN=cccccccccccccccc
| forward the ACK or NAK to IMS. Make sure that your
| program issues an ACK or NAK to IMS for the or
| received CM0 output message or synchronous callout
| message. A PRIOR MOLC UOW FOUND, THE UOW IS
BEING IGNORED RSN=aaaaaaaa RC=bbbbbbbb
| A possible cause of this problem is that there is a
TOKEN=cccccccccccccccc
| network failure so that the ACK or NAK cannot arrive
| at IMS OTMA.
or
| Module: DFSYPSO0
INTERNAL MOLC ERROR RSN=aaaaaaaa
| DFS3495W OTMA HAS BEEN WAITING FOR AN RC=bbbbbbbb TOKEN=cccccccccccccccc
| ACK FROM TMEMBER/TPIPE
| xxxx/yyyy FOR OVER zzzz SECONDS. or
| Explanation: OTMA detected that member xxxx with INTERNAL MEMBER ONLINE CHANGE ERROR
| transaction pipe (tpipe) yyyy has been waiting for an RSN=aaaaaaaa RC=bbbbbbbb
| acknowledgment for more thanzzzz seconds. Because TOKEN=cccccccccccccccc
| the OTMA CM0 ACK timeout function has been turned
| off, OTMA does not take the timeout action to reroute or
| the output message.
| System action: Processing continues. The tpipe MOLC ERROR PROCESSING AN INCOMPLETE
| remains in a hang status. All of the queued output UOW RSN=aaaaaaaa RC=bbbbbbbb
| messages on the tpipe are not delivered until the ACK TOKEN=cccccccccccccccc
| or NAK is received.
or
| Operator response: Identify the cause of the missing
| ACK or NAK for this timeout condition. The problem
MOLC ERROR, PDIR BLOCK COULD NOT BE FDBR and ACBSHR=N is specified, the member
FOUND PDIR=dddddddd RSN=aaaaaaaa RC=bbbbbbbb online unit of work is committed. If this problem is
TOKEN=cccccccccccccccc an XRF tracking IMS with FDBR and ACBSHR=Y is
specified, no action is required by this IMS; the
or commit on the active IMS completed successfully.
0B A 7010 log record was found as the only log record
MOLC ERROR, DDIR BLOCK COULD NOT BE in this unit of work. See the subsequent DFS3497I
FOUND PDIR=eeeeeeee RSN=aaaaaaaa RC=bbbbbbbb to determine how IMS handled this member online
TOKEN=cccccccccccccccc change unit of work.
Explanation: During IMS restart, Extended Recovery 0C A 7010 log record was found by the tracking IMS
Facility (XRF) or Fast Database Recovery (FDR) at the end of a unit of work log stream, indicating
tracking, an unrecoverable error was encountered while you aborted the member online change unit of
processing member online change log records. The work. ACBSHR=N was specified so IMS aborted the
member online change unit of work was most likely member online unit of work.
not completed, and the member online change must be
redone. See the explanation of the reason codes for 0D A 7010 log record was found at the end of a unit of
detailed information. work log stream, indicating you aborted the
member online change unit of work. ACBSHR=Y was
In the message text: specified, so no IMS action is required. This is an
dddddddd informational message only.
The name of the missing PDIR
eeeeeeee The name of the missing DDIR 0E A 7002 was the only log record found in the log
aaaaaaaa stream for this member online change unit of
The reason code work. The existence of the 7002 indicated the unit
bbbbbbbb of work was initiated, but the subsequent 7004,
The return code 7005, and 7010 were not found. IMS read the
cccccccccccccccc OLCSTAT data set and found the member online
The member online change unit of work token change unit of work had been aborted, so IMS
aborted the member online change unit of work.
The reason code can be one of the following: 0F A 7003 was the last log record found in the log
Codes stream for this member online change unit of
Explanation work. The existence of the 7003 indicated the unit
of work was initiated, but the subsequent 7004,
01 Internal error. An invalid log record type 70xx was 7005, and 7010 were not found. IMS read the
passed to the member online change processing OLCSTAT data set and found the member online
module and was ignored. change unit of work had been aborted, so IMS
02, 03, 05, 06, 07, or 0A aborted the member online change unit of work
A type 70xx (7002, 7003, 7004 or 7005) log record 10 A 7003 was the last log record found in the log
was read for a new member online change unit of stream for this member online change unit of
work, while the previous member online change work. The existence of the 7003 indicated the unit
unit of work did not contain the unit of work of work was initiated, but the subsequent 7004,
termination log record (a type 7006 or 7010). The 7005, and 7010 were not found. IMS read the
previous member online change unit of work is OLCSTAT data set and found the member online
terminated and cleanup is performed, and the new change unit of work had been completed, so IMS
unit of work is initialized. Missing log records or committed the member online change unit of
log tapes can cause this problem. work.
04 A 7002 log record contained no members to 11 A 7004 was the last log record found in the log
process. This member online change unit of work stream for this member online change unit of
generated no work. This situation is most likely work. The existence of the 7004 indicated the unit
due to a member online change which did not of work had completed; however, because the
update any ACBLIB members. subsequent 7010 was missing, the state of the
08 A 7005 log record was processed for a member resources being changed is unknown. The member
online change indicating the user terminated the online change unit of work is committed.
member online change unit of work. The member 12 This is due to an internal error, where part of the
online unit of work is terminated. internal control block structure is missing. The
09 A 7005 log record was processed, indicating the member online change process is aborted.
user committed the member online change unit of 1B or 21
work. If this problem is an XRF tracking IMS with This problem is due to a get main failure. The
most likely cause is a lack of available storage. The contact IBM Software Support. This problem is
return code for the get main is included in the an internal error, as the 7002 must contain
message. member names to process. If any member
online changes were performed in this time
1C The member online change process could not read
frame, verify all member online changes for
the OLCSTAT data set; the member online change
completeness. If any member online changes
process is aborted.
were found to have failed, the member online
1D A DDIR was missing from the library during change must be redone.
member online change processing. The online 12 Run DFSERA10 to extract all 7002, 7003, 7004,
change process skips this member and the member 7005, 7006, 7010, and 70FF log records for the
online change process continues. token described in the message, and contact
IBM Software Support. This problem is an
1E A PDIR was missing from the library during internal error. The member online change unit
member online change processing. The online of work is not completed and must be redone.
change process skips this member and the member If you feel you received these messages in
online change process continues. error, contact IBM Software Support.
1F or 20 1D Run DFSERA10 to extract all 7002, 7003, 7004,
An internal error occurred during initialization 7005, 7006, 7010, and 70FF log records for the
processing for a member online change. The token described in the message, and contact
member online change process is aborted. IBM Software Support. The PDIR or DDIR to
member online change was missing from the
13, 15, 17, or 19 staging or active ACBLIB. The member online
During tracking with ACBSHR=NO, the member change for these missing members must be
online change process was attempting to delete a redone. If you feel you received these
member from the tracking ACBLIB, but the messages in error, contact IBM Software
member does not exist. This code indicates the Support.
ACBLIBs are now out of sync between the active 1E Run DFSERA10 to extract all 7002, 7003, 7004,
and the tracker. IMS terminates abnormally. 7005, 7006, 7010, and 70FF log records for the
22 A 7002 was the only log record found in the log token described in the message, and contact
stream for this member online change unit of IBM Software Support. The PDIR or DDIR to
work. The existence of the 7002 indicated the unit member online change was missing from the
of work was initiated, but the subsequent 7004, staging or active ACBLIB. The member online
7005, and 7010 were not found. IMS read the change for these missing members must be
OLCSTAT data set and found the member online redone. If you feel you received these
change unit of work had been committed, so IMS messages in error, contact IBM Software
recommitted the member online change unit of Support.
work. 1F or 20
To help IBM correct this internal error, run
System action: The member online change incomplete DFSERA10 to extract all 7002, 7003, 7004, 7005,
unit of work is committed or aborted. See the 7006, 7010, and 70FF log records and contact
description of the reason code under Programmer IBM Software Support.
response for additional information. 08, 09, 0B, 0C, 0D, 0E, 0F, 10, or 11
Programmer response: The responses depend on the No response required, as these are
reason codes as follows: informational messages only. If you feel you
01 An invalid log record was passed to the received these messages in error, or that there
modules that process the member online is an issue, contact IBM Software Support.
change log records. To assist in correcting this 1C Verify that the OLCSTAT data set exists, and is
internal error, run DFSERA10 to extract all available for member online change in read
7002, 7003, 7004, 7005, 7006, 7010, and 70FF only mode. The member online change unit of
log records and contact IBM Software Support. work must be redone. Run DFSERA10 to
02, 03, 05, 06, 07, or 0A extract the 7002 for the token described in the
Run DFSERA10 to extract all 7002, 7003, 7004, message to obtain a list of the members to
7005, 7006, 7010, and 70FF log records for the redo.
token described in the message. The 7002 for 1B Free ECSA storage for the member online
the incomplete member online change unit of change process. The member online change
work contains the member names which were unit of work must be redone. Run DFSERA10
not processed. To process these, the member to extract the 7002 for the token described in
online change must be redone for the missing the message to obtain a list of the members to
members; also contact IBM Software Support. redo.
04 Run DFSERA10 to extract all 7002, 7003, 7004, 21 Free private storage for the member online
7005, 7006, 7010, and 70FF log records and change process. The member online change
unit of work must be redone. Run DFSERA10 Explanation: During IMS restart, Extended Recovery
to extract the 7002 for the token described in Facility (XRF) or Fast Database Recovery (FDR)
the message to obtain a list of the members to tracking, an incomplete member online change
redo. unit-of-work was encountered. The most likely cause
13, 15, 17, or 19 was IMS abnormally terminating while member online
The missing member name was contained in change was active, or XRF/FDBR tracking. The
the message. The member online change for member online change log records contained enough
this member must be redone for the tracking information to allow IMS to determine if the user had
IMS ACBLIB. Run DFSERA10 to extract the committed or terminated the member online change
7002 for the token described in the message to unit of work (UOW). Based upon this information the
obtain a list of the members that were part of unit-of-work was recommitted or terminated. See the
this member online change. Then verify that explanation of the reason codes for detailed
the member online change has completed for information.
the other members in the type 7002 log record.
In the message text:
Module: DFSMOL10, DFSMOL20 aaaaaaaa
The reason code
bbbbbbbb
DFS3497I MOLC 7005 LOG RECORD FOUND,
The return code
UOW ABORTED RSN=aaaaaaaa
cccccccccccccccc
RC=bbbbbbbb TOKEN=cccccccccccccccc
The member online change unit of work token
MOLC 7005 LOG RECORD FOUND, UOW
COMMITTED RSN=aaaaaaaa RC=bbbbbbbb The reason code can be one of the following:
TOKEN=cccccccccccccccc
Codes
Explanation
or
01 Internal error. An invalid log record type 70xx was
MOLC 7010 LOG RECORD FOUND, NO passed to the member online change processing
PROCESSING REQUIRED RSN=aaaaaaaa module and was ignored.
RC=bbbbbbbb TOKEN=cccccccccccccccc
02, 03, 05, 06, 07, or 0A
A type 70xx (7002, 7003, 7004 or 7005) log record
or was read for a new member online change
unit-of-work, while the previous member online
MOLC 7010 LOG RECORD FOUND, UOW change unit of work did not contain the
ABORTED RSN=aaaaaaaa RC=bbbbbbbb unit-of-work termination log record (a type 7006 or
TOKEN=cccccccccccccccc 7010). The previous member online change
unit-of-work is terminated and cleanup is
or performed, and the new unit-of-work is initialized.
Missing log records or log tapes can cause this
MOLC 7003 LOG RECORD FOUND, UOW problem.
ABORTED RSN=aaaaaaaa RC=bbbbbbbb
TOKEN=cccccccccccccccc 04 A 7002 log record contained no members to
process. This member online change unit of work
generated no work. The cause is likely a member
or
online change that did not update any ACBLIB
members.
MOLC 7002 LOG RECORD FOUND, UOW
COMMITTED RSN=aaaaaaaa RC=bbbbbbbb 08 A 7005 log record was processed for a member
TOKEN=cccccccccccccccc online change indicating that you terminated the
member online change unit-of-work. The member
or online unit-of-work is terminated.
09 A 7005 log record was processed, indicating the
MOLC 7003 LOG RECORD FOUND, UOW user committed the member online change
COMMITTED RSN=aaaaaaaa RC=bbbbbbbb unit-of-work. If this problem is an XRF tracking
TOKEN=cccccccccccccccc IMS with FDBR and ACBSHR=N is specified, the
member online unit-of-work is committed. If this
or problem is an XRF tracking IMS with FDBR and
ACBSHR=Y is specified, no action is required by this
MOLC 7004 LOG RECORD FOUND, UOW IMS as the commit on the active has completed
COMMITTED RSN=aaaaaaaa RC=bbbbbbbb successfully.
TOKEN=cccccccccccccccc
0B A 7010 log record was found as the only log record
in this unit-of-work. See the subsequent DFS3497I 1C The member online change process could not read
for information about how IMS handled this the OLCSTAT data set, the member online change
member online change unit of work. process is terminated.
0C A 7010 log record was found by the tracking IMS 1D A DDIR was missing from the library during
at the end of a unit-of-work log stream, indicating member online change processing. The online
you terminated the member online change change process skips this member and the member
unit-of-work. ACBSHR=N was specified so IMS online change process continues.
terminated the member online unit-of-work.
1E A PDIR was missing from the library during
0D A 7010 log record was found at the end of a member online change processing. The online
unit-of-work log stream, indicating you terminated change process skips this member and the member
the member online change unit-of-work. ACBSHR=Y online change process continues.
was specified, so no IMS action is required.
1F or 20
0E A 7002 was the only log record found in the log An internal error occurred during initialization
stream for this member online change processing for a member online change. The
unit-of-work. The existence of the 7002 indicated member online change process is terminated.
the unit-of-work was initiated, but the subsequent
13, 15, 17, or 19
7004, 7005, and 7010 were not found. IMS read the
During tracking with ACBSHR=NO, the member
OLCSTAT data set and found the member online
online change process was attempting to delete a
change unit of work had been terminated, so IMS
member from the tracking ACBLIB, but the
terminated the member online change unit of
member does not exist. This indicates the ACBLIBs
work.
are now out of sync between the active and the
0F A 7003 was the last log record found in the log tracker. IMS is abnormally terminated.
stream for this member online change
22 A 7002 was the only log record found in the log
unit-of-work. The existence of the 7003 indicated
stream for this member online change
the unit-of-work was initiated, but the subsequent
unit-of-work. The existence of the 7002 indicated
7004, 7005, and 7010 were not found. IMS read the
the unit-of-work was initiated, but the subsequent
OLCSTAT data set and found the member online
7004, 7005, and 7010 were not found. IMS read the
change unit of work had been terminated, so IMS
OLCSTAT data set and found the member online
terminated the member online change unit of work
change unit of work had been committed, so IMS
10 A 7003 was the last log record found in the log committed the member online change unit of
stream for this member online change work.
unit-of-work. The existence of the 7003 indicated
System action: The member online change incomplete
the unit-of-work was initiated, but the subsequent
unit of work is committed or terminated. See the
7004, 7005, and 7010 were not found. IMS read the
description of the reason code under Programmer
OLCSTAT data set and found the member online
response for additional information.
change unit of work had been completed, so IMS
recommitted the member online change unit of Programmer response: The responses depend on the
work. reason codes as follows:
01 An invalid log record was passed to the
11 A 7004 was the last log record found in the log
modules that process the member online
stream for this member online change
change log records. To help in correcting this
unit-of-work. The existence of the 7004 indicated
internal error, run DFSERA10 to extract all
the unit-of-work had completed. However, because
7002, 7003, 7004, 7005, 7006, 7010, and 70FF
the subsequent 7010 is missing, the state of the
log records and contact IBM Software Support.
resources being online changed are unknown. The
02, 03, 05, 06, 07, or 0A
member online change unit of work is committed.
Run DFSERA10 to extract all 7002, 7003, 7004,
12 This problem is due to an internal error, where 7005, 7006, 7010, and 70FF log records for the
part of the internal control block structure is token described in the message. The 7002 for
missing. The member online change process is the incomplete member online change
terminated. unit-of-work contains the member names that
were not processed. To process these members,
1B or 21
the member online change must be redone for
This problem is due to a get main failure. The
the missing members along with contacting
most likely cause is a lack of available storage. The
IBM Software Support.
return code for the get main is included in the
04 Run DFSERA10 to extract all 7002, 7003, 7004,
message.
7005, 7006, 7010, and 70FF log records and
contact IBM Software Support. This problem is
an internal error, as the 7002 must contain
member names to process. If any member to extract the 7002 for the token described in
online changes were performed in this time the message to obtain a list of the members to
frame, verify all member online changes for redo.
completeness. If any member online changes 13, 15, 17, or 19
were found to have failed, the member online The missing member name was contained in
change must be redone. the message. The member online change for
12 Run DFSERA10 to extract all 7002, 7003, 7004, this member must be redone for the tracking
7005, 7006, 7010, and 70FF log records for the IMS ACBLIB. Run DFSERA10 to extract the
token described in the message, and contact 7002 for the token described in the message to
IBM Software Support. This problem is an obtain a list of the members that were part of
internal error. The member online change this member online change and verify that the
unit-of-work is not completed and must be member online change has completed for the
redone. If you feel you received these other members in the type 7002 log record.
messages in error, contact IBM Software
Module: DFSMOL10, DFSMOL20
Support.
1D Run DFSERA10 to extract all 7002, 7003, 7004,
7005, 7006, 7010, and 70FF log records for the DFS3498W bbbb nnnnnnnn eeeeeeeeee....
token described in the message, and contact
IBM Software Support. The PDIR or DDIR to Explanation: /MODIFY PREPARE, INITIATE OLC
member online change was missing from the PHASE(PREPARE), or /MODIFY COMMIT processing
staging or active ACBLIB. The member online detected an invalid condition in the MODBLKS or
change for these missing members must be ACBGEN output. This problem or situation occurred
redone. If you feel you received these during prepare processing, unless otherwise noted as
messages in error, contact IBM Software commit processing.
Support. In the message text:
1E Run DFSERA10 to extract all 7002, 7003, 7004, bbbb Block type, if applicable DMB represents a
7005, 7006, 7010, and 70FF log records for the DMB in ACBLIB. DDIR represents a database
token described in the message, and contact in MODBLKS. PSB represents a PSB in
IBM Software Support. The PDIR or DDIR to ACBLIB. SMB represents a transaction in
member online change was missing from the MODBLKS.
staging or active ACBLIB. The member online nnnnnnnn
change for these missing members must be The name of the block, if applicable.
redone. If you feel you received these eeeeeeeeee....
messages in error, contact IBM Software The problem or situation encountered, which
Support. might be one of the following:
1F or 20 ALREADY DEFINED AS PARTITION
To help in correcting this internal error, run CHANGE
DFSERA10 to extract all 7002, 7003, 7004, 7005, Issued when a database defined in
7006, 7010, and 70FF log records and contact the MODBLKS data set is already
IBM Software Support. defined as a HALDB partition. Once a
08, 09, 0B, 0C, 0D, 0E, 0F, 10, or 11 database is defined as a HALDB
No response required, as these are partition to DBRC and IMS, it
informational messages only. If you feel you remains defined to IMS as a HALDB
received these messages in error, or that there partition until you cold start IMS and
is an issue, contact IBM Software Support. cannot be changed into a MODBLKS
1C Verify that the OLCSTAT data set exists, and is database, even if the HALDB
available for member online change in read partition is deleted from DBRC.
only mode. The member online change ALREADY DEFINED AS DATABASE
unit-of-work must be redone. Run DFSERA10 CHANGE
to extract the 7002 for the token described in Issued when the online change
the message to obtain a list of the members to prepare detects that a DDIR in the
redo. MODBLKS data set that is being
1B Free up ECSA storage for the member online added exists. If this situation does
change process. The member online change occur, it is probably an internal error.
unit-of-work must be redone. Run DFSERA10 Online change prepare is rejected.
to extract the 7002 for the token described in ALREADY DEFINED AS DATABASE
the message to obtain a list of the members to COMMIT
redo. Issued when the online change
21 Free private storage for the member online commit detects that a DDIR in the
change process. The member online change MODBLKS data set that is being
unit-of-work must be redone. Run DFSERA10 added exists. If this situation does
for the specified database. The database remains a value indicates how many online changes have
HALDB partition. been successful since cold start. The modify ID
is used to recover security status during an
Programmer response: Correct the problem, run the
emergency restart.
MODBLKS GEN or ACBGEN again, run the Online
Change utility, and retry online change.
This message is also issued after:
For a /MODIFY COMMIT command that failed with v Simple checkpoint invoked by /DBD
DFS3498W DDIR dbname ALREADY EXISTS AS v Simple checkpoint invoked by /DBR
PARTITION COMMIT, perform an online change to v Simple checkpoint invoked by /CHE
remove this database definition from your MODBLKS
gen. Otherwise, each subsequent attempt to do an
DFS3500W GLOBAL STATUS FOR rsrctype
online change will fail on the /MODIFY PREPARE
RESOURCES IS DISABLED
command with DFS3498W DDIR dbname ALREADY
EXISTS AS PARTITION CHANGE. Also, the database Explanation: The global status for database, DEDB
reverts to a non-HALDB database at the next IMS cold area, or transaction resources is disabled at this IMS.
start. rsrctype can be DB (database), AREA, or TRAN (transaction).
Any DB, AREA, or TRAN commands that are issued with
Module: DFSCPDD0, DFSRMDD0, DFSRMDM0,
SCOPE(ALL) are treated as SCOPE(ACTIVE), and global
DFSRMPS0, DFSRMSM0
status is not updated. If a DB or AREA command is
issued as GLOBAL, global status is not updated.
DFS3499I ACTIVE DDNAMES: modblks-name
System action: IMS continues restart processing.
acblib-name format-name MODSTAT ID:
nnnn System programmer response: No action is required.
Explanation: This message indicates online change If you want to maintain global status for commands
status including the active online change libraries and processed from this IMS, take the following actions:
the current modify ID. IMS issues this message in the 1. Cancel IMS or shut down IMS after the restart
following cases: completes After the error condition reported in the
v IMS restart DFS3308 message is fixed, restart IMS. IMS is then
v Simple checkpoint synchronized with the RM status and no additional
v /MODIFY PREPARE or INITIATE OLC action is required.
PHASE(PREPARE), to indicate the current active 2. Allow IMS restart to complete. Then do the
online change libraries before the new definitions are following:
committed a. Correct the error condition reported in the
v /MODIFY COMMIT or INITIATE OLC DFS3308 message.
PHASE(COMMIT), to indicate the new active online b. Issue the appropriate UPDATE IMS
change libraries, after online change is committed SET(PLEXPARM) command to enable global
status at this IMS.
In the message text: c. Issue QRY TRAN (or DB or AREA)
modblks-name SHOW(GLOBAL) commands to see the
Active MODBLKS DD in the IMS JCL, that resources with global status.
identifies the active MODBLKS library. d. Issue the appropriate SCOPE(ACTIVE)
modblks-name is either MODBLKSA or commands to ensure this IMS is synchronized
MODBLKSB. If the MODBLKS DD cards are with RM status.
omitted from the IMS JCL and online change
Module: DFSGST20
for MODBLKS is disabled, this variable is
blank. Related information:
acblib-name DFS3308E
Active IMSACB DD in the IMS JCL, that
identifies the active ACBLIB library. acblib-name
is either IMSACBA or IMSACBB.
format-name
Active FORMAT DD in the IMS JCL, that
identifies the active MFS format library.
format-name is either FORMATA or FORMATB.
If this system is DBCTL, format-name is blank.
nnnn Modify ID number. When you initialize the
MODSTAT data set, you decide what number
to assign as the modify ID. Every time online
change is successful, this number increments
by 1. If you initialized this number to 0, the
DFS3528I DUPLICATE SUBPOOL NAMES ARE DFS3534I THE CODE OPERAND IS OMITTED
SPECIFIED ON THE FOLLOWING OR INVALID ON THE FOLLOWING
SUBPOOL STATEMENTS: NAME - RTCODE STATEMENT(S):
name1 STATEMENT NOS - nnn,... STATEMENT NOS - nnn,...
NAME - name2 STATEMENT NOS -
Explanation: One of the following occurred on each
nnn,...
statement indicated by nnn:
Explanation: The SUBPOOL name indicated by namex v The CODE keyword parameter was not specified.
was specified on multiple SUBPOOL macros on v The operand or suboperands contained more than
statements nnn. eight alphanumeric characters.
System action: Processing continues. Severity: 8
Programmer response: Correct SUBPOOL name
specification on indicated SUBPOOL statements to DFS3536I DUPLICATE ROUTING CODES ARE
remove duplicates. SPECIFIED ON THE FOLLOWING
RTCODE STATEMENTS: NAME -
Severity: 8
name1 STATEMENT NOS - nnn,...
NAME - name2 STATEMENT NOS -
DFS3530I THE PARTNER OPERAND IS nnn,...
OMITTED OR INVALID ON THE
Explanation: The routing code indicated by namex was
FOLLOWING MSLINK
specified on multiple RTCODE macros on statements
STATEMENT(S): STATEMENT NOS -
nnn.
nnn,...
System action: Processing continues.
Explanation: One of the following occurred on each
statement indicated by nnn: Programmer response: Correct routing code
v The PARTNER keyword parameter was not specified. specifications on indicated RTCODE statements to
v More than 1 NAME suboperand was specified. remove duplicates.
v The operand did not begin with an alphabetic
Severity: 8
character or contained more or less than eight
alphanumeric characters.
DFS3538I THE PHYSICAL LINK NAME IS
System action: The PARTNER parameter is ignored
OMITTED OR INVALID ON THE
on the indicated statement, and processing continues.
FOLLOWING MSPLINK
Programmer response: Specify the PARTNER STATEMENT(S): STATEMENT NOS -
parameter or, if specified, ensure that the operand nnn,...
begins with an alphabetic character and contains
Explanation: One of the following occurred on each
exactly two alphanumeric characters.
statement indicated by nnn:
Severity: 8 v The physical link name was not specified.
v The link name did not begin with an alphabetic
character or contained more than eight alphanumeric
DFS3532I DUPLICATE PARTNER IDS ARE
characters.
SPECIFIED ON THE FOLLOWING
MSLINK STATEMENTS: NAME - name1 System action: The physical link name is ignored on
STATEMENT NOS - nnn,... NAME - the indicated statement, and processing continues.
name2 STATEMENT NOS - nnn,...
Programmer response: Specify the physical link name
Explanation: The PARTNER ID indicated by namex or, if specified, ensure that it begins with an alphabetic
was specified on multiple MSLINK macros on character and contains no more than eight
statements nnn. alphanumeric characters.
System action: Processing continues. Severity: 8
Programmer response: Correct the PARTNER ID
specification on indicated MSLINK statements to DFS3540I DUPLICATE PHYSICAL LINK NAMES
remove duplicates. ARE SPECIFIED ON THE
FOLLOWING MSPLINK
Severity: 8
STATEMENTS: NAME - name1
STATEMENT NOS - nnn,... NAME -
name2 STATEMENT NOS - nnn,...
Explanation: The physical link name indicated by
namex was specified on multiple MSPLINK macros on v The transaction code namex was also specified as an
statements nnn. LTERM.
v The MSNAME link name namex was also specified as
System action: Processing continues.
an LTERM.
Programmer response: Correct physical link name v The MSNAME link name namex was also specified as
specification on indicated MSPLINK statements to a transaction code.
remove duplicates. v The transaction code namex was also specified as an
RTCODE for a Fast Path exclusive transaction.
Severity: 8
System action: Processing continues.
DFS3542I THE NAME OPERAND IS OMITTED Programmer response: Correct the resource names on
OR INVALID ON THE FOLLOWING the indicated statements to remove duplicates.
MSPLINK STATEMENT(S):
Severity: 8
STATEMENT NOS - nnn,...
Explanation: One of the following occurred on each
DFS3548I PARM FIELD ERROR DETECTED,
statement indicated by nnn:
PARAMETER IGNORED; REASON
v The NAME keyword parameter was specified but
CODE = xx
TYPE=VTAM was not indicated.
v The NAME keyword parameter was not specified by Explanation: An error was detected in one of the
TYPE=VTAM was indicated. parameter fields. The value of xx can be one of the
v More than one NAME operand was specified. following reason codes:
v The operand did not begin with an alphabetic
Code (hex)
character or contained more than 8 alphanumeric
Meaning
characters.
01 DFSPRE60 indicator (first parameter) was not
System action: The NAME parameter is ignored on specified as Y or N.
the indicated statement, and processing continues. 02 DFSPRE70 indicator (second parameter) was
not specified as Y or N.
Programmer response: Specify the NAME parameter
03 The assembler override options were not
with TYPE=VTAM or, if specified, ensure that it begins
enclosed in apostrophes or a blank space was
with an alphabetic character and contains no more than
used as a delimiter.
8 alphanumeric characters.
System action: The remaining parameter fields are
Severity: 8
scanned for accuracy. Preprocessor execution continues,
using defaults for invalid parameters.
DFS3544I DUPLICATE VTAM NODE NAMES
Programmer response: Correct any errors and
ARE SPECIFIED ON THE
resubmit the job.
FOLLOWING MSPLINK
STATEMENTS: NAME - name1 Severity: 2
STATEMENT NOS - nnn,... NAME -
name2 STATEMENT NOS - nnn,...
DFS3550I REGION SIZE INSUFFICIENT TO
Explanation: The remote system VTAM node name CONTAIN ALL SPECIFIED (TABLES)
indicated by namex was specified on multiple (ERRORS) (COPIES)
MSPLINK macros on statements nnn.
Explanation: The region specified was insufficient to
System action: Processing continues. construct the resource name tables, error tables, or copy
statement push down stack with the specified or
Programmer response: Correct VTAM node name
required sizes.
specifications on indicated MSPLINK statements to
remove duplicates. System action: No further action is taken. For resource
name tables, the job is terminated. Otherwise,
Severity: 8
processing continues but the error or copy statement
processing is terminated.
DFS3546I CROSS-CHECK FAILED FOR THE
Programmer response: Increase the region size on JOB
FOLLOWING RESOURCE NAMES:
or EXEC statement, or both.
NAME - name1 STATEMENT NOS -
nnn,... NAME - name2 STATEMENT Severity: 12
NOS - nnn,...
Explanation: One of the following occurred on the
statement indicated by nnn:
Table name
DFS3552I ROUTINE name NOT FOUND ON
Position of parameter
STEPLIB
Logical terminal
Explanation: The routine indicated by name cannot be 3 (ccc)
found on the library pointed to by the STEPLIB DD Transaction code
statement. 4 (ddd)
PSB name
System action: The preprocessor always looks for all
5 (eee)
exit routines specified by the user. If exits are specified,
DBD name
and if one or more of the exit routines specified cannot
6 (fff)
be found on the library pointed to by the STEPLIB DD
VTAM node name
statement, the preprocessor ignores all exit routines.
7 (ggg)
Processing continues. If a preprocessor module cannot
Routing code
be found, execution terminates.
8 (hhh)
Programmer response: Ensure that the module exists Remote SYS VTAM
on the library indicated by the STEPLIB statement, or 9 (jjj)
concatenate the correct library with the one specified. MS linkname blk
10 (kkk)
Severity: 8 Partner ID
11 (mmm)
DFS3554I COPY MEMBER name NOT FOUND Physical link name
ON SYSLIB STATEMENT NO - nnn 12 (nnn)
Subpool name
Explanation: The copy member indicated by name on 13 (ppp)
statement nnn cannot be located on the SYSLIB data
sets. Severity: 8
DFS3556I NUMBER OF name ENTRIES EXCEED Programmer response: Determine the cause of the
UPPER LIMIT DROPPING failure, correct the problem, and resubmit the job.
REMAINING ENTRIES STATEMENT Severity: 8
NO - nnn
Explanation: The number of entries required for the DFS3559A THE MASTER OR SECONDARY
name table was greater than the upper limit established MASTER IS DUPLICATED ON THE
either by default or in the corresponding parameter FOLLOWING STATEMENT(S):
field on the EXEC statement. statementstatement
System action: The preprocessor continues to process Explanation: The MASTER or SECONDARY MASTER
other types of entries. All entries in the indicated table LTERM has been defined more than once.
which were accepted before the limit was reached are
processed. System action: All stage 1 input is processed but the
large system definitions (LGEN) assemblies are not
Programmer response: Increase upper limit for the performed.
table. The correspondence between the table name and
EXEC statement parameter field is as follows: Programmer response: Remove the multiple
definitions of the MASTER or SECONDARY MASTER
LTERM and re-execute the preprocessor.
Severity: 8
DFS3562I THE FOLLOWING SYSIDS WERE
CODED AS BOTH REMOTE AND
DFS3560I LARGE SYSGEN ASSEMBLIES NOT LOCAL SYSIDS: NAME - SYSID1
DONE - REASON CODE = xx STATEMENT NOS - nnn,... NAME -
SYSID2 STATEMENT NOS - nnn,...
Explanation: Module DFSPRE80 was not called to
perform Stage 1 processing in an LGEN environment Explanation: The SYSID number indicated by SYSIDx
for reason xx. The value xx is one of the following: was specified as both a remote SYSID and a local
SYSID on statements nnn.
Code (hex)
Meaning System action: Name checking continues but large
X'01' Open failed for the DCB of the DDNAME system definitions (LGEN) assemblies are not
indicated in the preceding DFS3558I message. performed.
X'02' The fourth subparameter of the SYSTEM=
Programmer response: Correct the SYSIDs in error
keyword on the IMSCTRL source statement
and re-execute the preprocessor.
was not correctly specified as 'LGEN'.
X'03' The MSVID= keyword was not specified for a Severity: 8
LGEN/MSVERIFY system definition.
X'04' The LGEN environment was requested for a
DFS3563I bbb NAME nnnnnnnn NOT FOUND.
system definition other than a MODBLKS or
MSVERIFY. Explanation: DFSIIRS0 was not able to find the name
X'05' Routine DFSPRE80 was not found on nnnnnnnn of control block bbb. The possible control
STEPLIB. blocks are CNT, CLB, or LNB.
X'06' An MSVERIFY system definition type was
requested in the SYSTEM= keyword of the System action: The IMS initialization is terminated
IMSCTRL source statement but no MS with an abend code of 0220.
resources were defined. Programmer response: Ensure that the correct set of
X'07' A GETMAIN for the LGEN environment control blocks from a large system definition (LGEN) is
failed. being used.
X'08' The preprocessor is not running on an MVS
system. Severity: 8
X'09' A previous error prevented module DFSPRE80 Related information:
from being started.
X'10' An error occurred during an assembly that IMS abend 0220
prevented the consolidated object data set
from being successfully created. DFS3564I THE FOLLOWING REMOTE SYSID(S)
X'11' No DB resources have been defined. At least DID NOT APPEAR AS A REMOTE
one APPLCTN/TRANSACT set must be SYSID ON ANY MSNAME
defined. STATEMENT: NAME - SYSID1
System action: Stage 1 processing of the source STATEMENT NOS - nnn,... NAME -
statements is not done. SYSID2 STATEMENT NOS - nnn,...
Programmer response: Correct the error indicated by Explanation: The remote SYSID indicated by SYSIDx
the reason code and re-execute the preprocessor. that was specified on the indicated APPLCTN or
TRANSACT source statements nnn did not appear as a
Severity: 8 remote SYSID on any MSNAME source statement.
Related information:
System action: Name checking continues but large
“DFS3558I” on page 707 system definition (LGEN) assemblies are not
performed.
DFS3561E INSUFFICIENT STORAGE ABOVE 16 Programmer response: Ensure that a MSNAME source
MEG FOR PSB xxxxxxxx. statement has the required remote SYSID and
Explanation: The block builder was unable to obtain re-execute the preprocessor.
sufficient storage above 16 MB to build the required Severity: 8
PSB control block. In the message text, xxxxxxxx
identifies the PSB block.
DFS3565E INSUFFICIENT STORAGE ABOVE 16
System action: IMS terminates abnormally. MEG FOR DBD xxxxxxxx.
Programmer response: Increase the region or partition Explanation: The block builder was unable to obtain
size, and run the program again. sufficient storage above 16 MB to build the required
Programmer response: Increase the region or partition Explanation: Duplicate BTAM addresses were coded
size, and run the program again. in the Stage 1 input.
System action: Stage 1 processing of the source
DFS3566I NO VALID REMOTE SYSID WAS statements is not done.
CODED ON ANY MSNAME
Programmer response: Correct the indicated error and
STATEMENT.
re-execute the preprocessor.
Explanation: You did not code a valid remote SYSID
Severity: 8
for any MSNAME source statement.
System action: Name checking continues but large
DFS3570I DUPLICATE REMOTE SYSIDS ARE
system definition (LGEN) assemblies are not
CODED ON THE FOLLOWING
performed.
MSNAME STATEMENTS: NAME -
Programmer response: Ensure that MSNAME source SYSID1 STATEMENT NOS - nnn,...
statements have valid SYSID specifications. NAME - SYSID2 STATEMENT NOS -
nnn,...
Severity: 8
Explanation: The specification for the remote SYSID
was duplicated on the indicated statements.
DFS3567I THE BTAM ADDRESS
SPECIFICATION IS INVALID ON THE System action: Name checking continues but large
FOLLOWING STATEMENT(S): system definition (LGEN) assemblies are not
STATEMENT NO. nnn,... performed.
Explanation: An invalid address specification Programmer response: Correct the incorrect remote
parameter was detected in a LINE, CTLUNIT, SYSID specification and re-execute the preprocessor.
STATION, or TERMINSL macro call.
Severity: 8
System action: Stage 1 processing of the source
statements is not done.
DFS3571A THE OPCODE ON THE FOLLOWING
Programmer response: Correct the indicated error and STATEMENT IS INVALID.
re-execute the preprocessor.
Explanation: An OPCODE that exceeded eight
Severity: 8 characters was found.
System action: Names checking continues, but the
DFS3568I THE SYSID SPECIFICATION IS Stage 2 input is not generated.
INVALID ON THE FOLLOWING
Programmer response: Correct the OPCODE in error
STATEMENT(S): STATEMENT NO -
and re-execute the preprocessor.
nnn,...
Severity: 8
Explanation: One or more of the following occurred
on each of the indicated statements:
v The SYSID was not numeric. DFS3572I ASSEMBLER ERROR DETECTED IN
v The SYSID was not in the range of 1 to 2036. DFSPRE80 - RETURN CODE = xxxx
v Either one or both of the SYSID specifications was
Explanation: DFSPRE80 received nonzero return code
omitted.
xxxx during a large system definition (LGEN) assembly.
System action: Name checking continues but large
System action: Processing continues.
system definition (LGEN) assemblies are not
performed. Programmer response: Examine the assembly errors in
the preprocessor consolidated listing file to determine if
Programmer response: Correct the errors and
any corrections must be made on the Stage 1 source
re-execute the preprocessor.
statements.
Severity: 8
Severity: 2
DFS3573A MISSING PARM FIELD ERROR DFS3578A OPEN ERROR FOR DDNAME = ddname
DETECTED. RETURN CODE = 12
Explanation: One of the input parameters was missing Explanation: An attempt to open a BPAM data set
from the DFSLGD00 utility JCL. failed. Return code 12 is a Sort/Split utility return code,
not a return code from OPEN.
System action: Processing terminates with return code
8. System action: The utility function was terminated.
Programmer response: Correct the proper parameter Programmer response: See Data Administration: Macro
and rerun the job. Instruction Reference for MVS/DFP (SC26-4506).
Severity: 8
DFS3579I USER EXIT2 REQUEST = 90 FROM
DFSSS060. INPUT IS NOT IN
DFS3574I PREPROCESSOR ASSEMBLY CYCLE
STANDARD FORMAT, END
COUNT IS - xxxx
STATEMENT MISSING. RESOURCE
Explanation: This message contains the current TYPE = resource type.
assembly cycle for DFSPRE80.
Explanation: Return code 90 signals the SORT/SPLIT
System action: None. utility to process the current user resource type as a
standard resource. In this case, the exit routine is not
Programmer response: No action is required. called for the remainder of the current user resource
Severity: 0 type. This message warns you that the END statement
is missing, which might cause compiler errors after the
Sort/Split utility completes. A report is generated.
DFS3576A OPEN ERROR FOR DDNAME xxxxxxxx
System action: The SORT/SPLIT utility generates
Explanation: An open error occurred in module return code 02. Processing continues.
DFSLGD00.
Programmer response: If a compiler error occurs, you
System action: Processing terminates with return code must add an END statement either through the initial
12. input to Stage 1 or through exit routine 2. If you add
Programmer response: Correct the DDNAME in error the END statement through the exit routine, you must
and rerun the job. also put it at the end of each member.
Severity: 12
DFS3580A READ ERROR IN RESOURCE
INFORMATION FILE. MEMBER NAME
DFS3577A NO VALID HIERARCHY EXISTS FOR = member name RETURN CODE = 12
THE FOLLOWING STATEMENT(S).
Explanation: A read error in the resource information
Explanation: The physical position of the macro file (RIFL) is caused by the one of the following:
statements that follow this message in the listing did v The record was not found.
not occur in any valid hierarchy. v An I/O error occurred.
System action: Name checking continues but large v The first record is not the RIFL record.
system definition (LGEN) assemblies are not A report is not generated. Return code 12 is a
performed. Sort/Split utility return code, not an I/O return code.
Programmer response: Do the following steps: System action: The utility function was terminated.
1. Check the physical order of the statements that
follow the message in the listing. The IMSCTRL Programmer response: Review the RIFL to ensure that
macro call must be the first non-comment statement the first record is the RIFL record and that it contains
defined. This message is issued if any IMS macro the number of resource types found in the RIFL. For
call follows the IMSGEN macro call. more information, see Data Administration: Macro
2. Reorder the statements correctly in the Stage 1 Instruction Reference for MVS/DFP.
input to form valid hierarchies.
3. Rerun the job. DFS3581A READ ERROR. MEMBER NAME =
Severity: 12 member name RETURN CODE = 12
Explanation: An I/O error occurred during the read
of a block from an input member. Return code 12 is a
Sort/Split utility return code, not an I/O return code.
System action: Processing is terminated.
Programmer response: See Data Administration: Macro Programmer response: Ensure that the resource types
Instruction Reference for MVS/DFP. passed to Sort/Split utility conform with guidelines.
the error text, then the error text represents a For STMNT errors, use the /START SUBSYS command
keyword parameter. The character string yyyyyyyy is to start one or more external subsystem connections.
one of the following error reason codes:
Problem determination: 1, 3, 34 and save the SSM
OMITTED
PROCLIB member
A required parameter was omitted from the
external subsystem definition. The Related information:
subsystem definition is found to be invalid, Chapter 2, “IMS problem determination,” on page 5
therefore, a subsystem connection is not
established.
IGNORED
A parameter is specified in the external
subsystem definition which is not applicable
to the type of subsystem being defined. This
parameter is ignored and processing
continues. If the rest of the subsystem
definition is valid, a subsystem connection
is established at the appropriate time.
INVALID
The error text represents invalid data in the
subsystem definition statement. If the
character string, KEYWORD, precedes the
error text, then the value for the parameter
was invalid. Otherwise, the error text
represents data that could not be interpreted
as part of a subsystem definition. The
subsystem definition was found to be
invalid, therefore, a subsystem connection is
not established.
DUPLICATE
A specific value for a parameter was
specified for more than one subsystem
definition. The subsystem definition is
considered invalid and is ignored. All SSN
parameter values must be unique within a
member.
v DB2AF DEF INVALID FOR DEP REG
An SSM parameter was provided to the dependent
region job; the parameter identified the PROCLIB
member that included a definition for a DB2
subsystem to be accessed with the DB2 Attach
Facility. This definition is unavailable in an MPP or
BMP region and is ignored. Processing continues.
Definitions for the DB2 Attach Facility can only be
provided to the control region in the SSM parameter.
System action: If the UNABLE TO INITIALIZE
message is displayed, IMS external subsystem
initialization processing failed. None of the external
subsystems defined in the member are connected to
IMS.
If a statement is processed and an error occurs that
causes the subsystem definition to become invalid, then
that external subsystem are not connected to IMS.
Programmer response: Correct the errors in the SSM
PROCLIB member.
For UNABLE TO INITIALIZE errors, use the /START
SUBSYS SSM command to start the external subsystem
initialization process, which starts all valid subsystems
defined in the member.
05 Open failure for DFSESL DD statement - the zz 0054 Too many parameters were specified following
value equals the OPEN return code. the SSM keyword.
0401 An invalid return code was received from the
06 The resource named in the message was not found
PROCLIB processor.
- the zz value is the IMODULE LOAD return code.
0403 An IMODULE GETSTOR request failed to
07 The resource named in the message was not found obtain a subsystem definition element. No
(DFSESI40) - the zz value equals the OS LOAD subsystems can be connected to IMS.
macro return code. 0404 No valid SSM entries were specified.
0501 No ESET prefix
08 The resource named in the message was not found 0502 Attach list count is zero
- the zz value equals the BLDL return code. 0503 No ESET exists for subsystem
09 The resource named in the message was not 0504 Unable to obtain SIDX block
loaded - the zz value equals the return code 0505 Unable to obtain quick save area
associated with the MVS system code aaaa. 0506 Global ESET already attached
05FF IMS in SHUTDOWN/ESS task in process of
0A The data set type cannot be determined - the zz abending—request rejected
value is the return code from the ISITMGD macro 04FF IMS in SHUTDOWN/ESS task in process of
call. The aaaa value is the ISITMGD reason code. abending—request rejected
0101 No list passed to build routine
See the IMODULE return code information. 0103 Unable to obtain quick save area
System action: Subsystem connections between IMS 0104 Unable to obtain the Global External
and the specified subsystem are not established, and Subsystem Entry
initialization processing continues. 01FF IMS in SHUTDOWN/ESS task in process of
abending—request rejected
Operator response: Notify the system programmer
about the receipt of this message. System action: The command is rejected.
System programmer response: Ensure that the Operator response: Notify the system programmer
subsystem load library is accessible to IMS. IMS about the receipt of this message.
provides a DD statement (DFSESL) to alleviate this System programmer response: Take one of the
problem. The external subsystem modules can be in following actions based on the code:
any z/OS authorized library accessible by IMS (that is,
JOBLIB, STEPLIB or DFSESL). Code Meaning
0050 External subsystem connection processing has
Increase the region size to accommodate the external already been done. To start a specific
subsystem modules, and document the storage subsystem, use the /START SUBSYS xxxx
requirements in the external subsystem documentation. command.
Related reference: 0051 Reenter the /START SUBSYS SSM xxxx
command with a parameter xxxx of 1 to 4
IMODULE return codes (Messages and Codes) characters.
0052 Reenter the /START SUBSYS SSM xxxx
ISITMGD Completion Codes
command with a parameter xxxx of 1 to 4
characters.
DFS3604I /STA COMMAND FAILED WITH 0053 Reenter the /START SUBSYS SSM xxxx
RETURN CODE xxxx command without any additional parameters.
0054 Reenter the /START SUBSYS SSM xxxx
Explanation: An attempt to create the external command without any additional parameters.
subsystem mother task by the /START command 0401 The subsystem PROCLIB member name is
processor failed with one of the following return codes: invalid or an error occurred while trying to
Code Meaning read the member. Verify that the PROCLIB
0050 The subsystem member name was already member name is correct and resides on
specified by a previous /START SUBSYS SSM IMS.PROCLIB, then reenter the command.
xxxx command, or the SSM= EXEC parameter 0403 IMS was unable to get private storage for a
was specified on the IMS JCL. work area. The /START SUBSYS command
0051 The SSM keyword parameter length was not 1 can be reentered. If the resource shortage is
- 4 characters. temporary, storage might be available at a later
0052 No parameter was specified following the SSM time. If a storage shortage still exists, more
keyword. working storage might be allocated to IMS by
0053 A parameter was specified for the SUBSYS increasing the region (RGN) parameter on the
keyword. If the SSM keyword is specified, the IMS startup procedure.
SUBSYS keyword cannot have any parameters. 0404 The IMS.PROCLIB member specified by the
SSM parameter does not contain any valid 1C The IMSID/RSENAME in the internal
entries. Message DFS3600I was issued for each MODIFY command does not match the name
specific error. in the SCD/FRB.
0501 IMS logic error: follow the procedures for 20 The external subsystem name was not
software problems. specified in the MODIFY command. The name
0502 IMS logic error: follow the procedures for must be from 1 to 8 characters.
software problems.
System action: IMS cannot perform the requested
0503 IMS logic error: follow the procedures for
action. The command is rejected.
software problems.
0504 IMS was unable to get working storage. This Operator response: Notify the system programmer
condition can temporary; reenter the that this message has been received.
command. If the condition persists, more
working storage might be allocated to IMS by Programmer response: Take one of the following
increasing the region (RGN) parameter on the actions:
IMS procedure. Code (hex)
0505 Take the same action indicated in return code Meaning
0504. 04 Check the spelling and format of the MODIFY
0506 IMS logic error; follow the procedures for command.
software problems. 08 Either SSM was not specified in the EXEC
05FF No action required. parameters or there was a failure in the
04FF No action required. initialization of the external subsystem.
0101 IMS logic error: follow the procedures for 0C If the command was entered by the operator,
software problems. check the spelling and format of the MODIFY
0103 Take the same action indicated in return code command. Otherwise, the MODIFY command
0504. was an internal command sent from the
0104 Take the same action indicated in return code external subsystem to notify IMS that the
0504. external subsystem was ready to continue the
01FF No action required. identify process. Make sure that the SSM
Problem determination: 5, 6, 34 PROCLIB member has not been changed.
10 IMS logic error; follow the procedures for
Related information: software problems.
Chapter 2, “IMS problem determination,” on page 5 14 IMS logic error; follow the procedures for
software problems.
18 This return code can result if IMS has been up
DFS3605I ESS/ESI MODIFY COMMAND
and down without a connection to the external
REJECTED, code xx (y)
subsystem.
Explanation: During an attempt to modify the 1C IMS logic error; follow the procedures for
external subsystem with the MVS MODIFY command, software problems.
an error was detected. The reason code xx describes the 20 IMS logic error; follow the procedures for
error. The value y represents up to 12 bytes of the software problems.
MODIFY command input data. The following reason
Problem determination: 5, 6, 35
codes and their meanings can appear:
Related information:
Code (hex)
Chapter 2, “IMS problem determination,” on page 5
Meaning
04 The subsystem name specified in the MODIFY
command does not have an active subtask. No DFS3606I wwww EXTERNAL SUBSYSTEM
task control block (TCB) exists for the external INITIALIZATION FAILED, FC = xxxx,
subsystem daughter task. RC = yy, JOBNAME = zzzzzzzz
08 No external subsystems have been attached to
IMS. Explanation: Initialization exit processing was
0C The external subsystem name in the MODIFY unsuccessful for the external subsystem (wwww). The
command is not defined to IMS. external subsystem returned a nonzero return code. The
10 The IMS ID is invalid. function code, xxxx, indicates the module that detected
14 The external subsystem name in the MODIFY the error. This module can be an IMS or external
command is too long. The name must be from subsystem exit module. For the function code value
1 to 8 characters. and the module name that detected the error, see the
18 The external subsystem in the MODIFY IMS return codes and function codes information. The
command is not waiting for a notify message. return code yy, set by the detecting module, indicates
the function that failed in the detecting module.
To distinguish one region from another, JOBNAME =
X'0C' IDENTIFY unsuccessful. See the external exits are provided. The Explanation identifies the
subsystem documentation for action. required exits.
X'20' See the external subsystem documentation for
Problem determination: 34
action.
X'??' Unsupported return code; save all Related information:
documentation (that is, console logs, log data
IMS abend 3049
set, memory dumps).
Chapter 2, “IMS problem determination,” on page 5
Problem determination: 35
Related reference:
DFS3609 EXTERNAL SUBSYSTEM TASK
Return and function codes associated with the ABENDING/ABENDED. COMMAND
external subsystem support (Messages and Codes) REJECTED.
Related information: Explanation: The IMS external subsystem task
Chapter 2, “IMS problem determination,” on page 5 terminated abnormally or was in the process of
terminating when the /START SUBSYS command was
entered.
DFS3608I xxxx SUBSYSTEM REQUIRED EXIT
MISSING yyyy, JOBNAME = zzzzzzzz. System action: The command is rejected. IMS
continues processing.
Explanation: IMS was not able to finish processing
successfully for external subsystem (xxxx). A required Operator response: Notify the system programmer.
exit (yyyy) was unavailable. zzzzzzzz is the name of the System programmer response: Enter the /START
job that encountered the problem. JOBNAME is SUBSYS command as soon as the termination has
required because more than one region can have completed to restart the connection.
connections to the external subsystem. yyyy can be one
of the following values:
ID ID IDENTIFY EXIT DFS3610 SUBSYSTEM STOPPED, COMMAND
RID RESOLVE-IN-DOUBT EXIT REJECTED.
SNON SIGNON EXIT
Explanation: The external subsystem is already in a
CRT CREATE THREAD EXIT
stopped state. The stopped state can be the direct result
CMP COMMIT PREPARE EXIT
of:
CMC COMMIT CONTINUE EXIT
v A previous /STOP SUBSYS command.
ABC ABORT AND CONTINUE EXIT
v An external subsystem termination.
TRTD TERMINATE THREAD EXIT
v Either the mother or daughter task abended.
SNOF SIGNOFF EXIT
v The existence of outstanding recovery elements from
TERM TERMINATE IDENTIFY EXIT
a previous IMS execution.
SNO SUBSYSTEM NOT OPERATIONAL EXIT
v An IMS abnormal termination.
STE SUBSYSTEM TERMINATION EXIT
NORC NORMAL CALL EXIT System action: The command is rejected. IMS
ECHO ECHO EXIT continues to process.
CMD COMMAND EXIT
Operator response: Notify the system programmer of
System action: A subsystem connection is not this message.
established. If a connection exists, it is terminated in
System programmer response: If you want to restart
the normal termination sequence, and the task structure
the external subsystem connection, enter the /START
(TCB) is collapsed for the control region. If an
SUBSYS command. If the external subsystem
application is involved, it terminates with abend 3049.
connection is already in a stopped state, reentering the
Operator response: Notify the installation personnel /STOP SUBSYS command has no affect.
about the receipt of this message, then follow the
installation action.
DFS3611I EXTERNAL SUBSYSTEM xxxx
Programmer response: Ensure that the subsystem load CONNECTION TERMINATED RC=y
library is accessible to IMS. IMS provides a DD
Explanation: See message DFS3611W for the
statement (DFSESL) to alleviate this problem. The
explanation.
external subsystem modules must be in a z/OS
authorized library accessible by IMS (that is, JOBLIB, Related information:
STEPLIB or DFSESL). Use the IMS /START SUBSYS DFS3611W
command to restart the failing external subsystem
connection when the problem has been resolved. If this
action does not solve the problem, then check the
External subsystem documentation to determine which
Operator response: Notify the system programmer of This message is issued only one time per IMS
the receipt of this message. checkpoint interval, regardless of how many double
AWE frees occurred.
Programmer response: For problem analysis for the
description of subcode 13, see 3058 information. System action: IMS processing continues, however, a
Related information: double free of an AWE is a symptom of an internal
processing error within IMS, and unpredictable results
IMS abend 3058 might occur.
System programmer response: Take a memory dump
DFS3626I RESTART HAS BEEN ABORTED of the IMS control and DLI regions and contact IBM
Software Support.
Explanation: IMS terminated the restart process. Error
messages issued before this one indicate the problem. Module: DFSBCB30
System action: The restart is terminated and awaits
another command. DFS3628I DB2 RRSAF SETUP FAILED -
xxxxxxxxxx
Operator response: After correcting the problem,
restart the IMS system. Explanation: The DB2® Attach Facility could not be
established in the Java™ region for the reason given by
Problem determination: 35
xxxxxxxxxx. The possible reasons for the failure are:
Related information: v GETMAIN FOR AFB FAILED
Chapter 2, “IMS problem determination,” on page 5 v ACCESS TO db2id STOPPED
v UNABLE TO OPEN DFSDB2AF
DFS3627I DYC|DYS TCB RETRY IN PROGRESS System action: The dependent region terminates
DUE TO SYS|IMS xxxx abnormally with a 3056 except for the reason, ACCESS
TO db2id STOPPED, where db2id is the subsystem name
Explanation: The dynamic control services TCB which was provided in a /STOP SUBSYS command.
ESTAE has received control and is attempting a retry of
the process that encountered an error. DYC is the System programmer response: For UNABLE TO
dynamic allocation service in the IMS control region. OPEN DFSDB2AF, ensure that access to the defined
DYS is the dynamic allocation service in the DL/I data set is available to the dependent region. Also
subordinate address space. The reason for the retry is ensure that the DB2 library is APF-authorized. For
abend code xxxx, which is either a system (SYS) or IMS ACCESS TO db2id STOPPED, if the dependent region
code. needs access, stop the region, issue a /STA SUBSYS
command and restart the region. If access is not
System action: A retry of the request issued to the needed, nothing need be done.
dynamic control services TCB is attempted. In addition,
a software log record containing a copy of the System Module: DFSD2AF0
Diagnostic Work Area (SDWA) is written to the Related information:
SYS1.LOGREC data set. The log record contains an
eye-catcher field that identifies the failure as "IMS DYN IMS abend 3056
ALLOCATE".
Operator response: No action is required. DFS3629I DB2 RRSAF FUNC=xxxx FAILED -
RC=yyyy, RS=zzzz
Programmer response: In most cases, receiving this
message is no cause for alarm, although a database or Explanation: The DB2 Attach Facility function xxxx
data set might not have been allocated or deallocated. failed with return code yyyy and reason code zzzz. The
External user action might be required to process the possible functions are:
request. However, if the problem persists, an IDENTFY
investigation of the SYS1.LOGREC data set might be SIGNON
necessary to obtain diagnostic information about the CREATE THD
failure. TERM THD
System action: The dependent region terminates
DFS3628E DOUBLE AWE RELEASE DETECTED abnormally with a 3056.
IN MODULE DFSBCB30
Programmer response: Contact the system
Explanation: The IMS control block storage manager, programmer.
DFSBCB30, detected a double release of an IMS internal
Module: DFSD2AF0
control block called an AWE. IMS collects internal
diagnostic information for this problem and issues this Related concepts:
message to document that this condition occurred. DB2 codes
v The /ASSIGN INPUT LTERM and /ASSIGN keyword are incorrect, restart IMS.
OUTPUT LTERM forms of the /ASSIGN command
Problem determination: 1, 6, 10
are not allowed for dynamic or LUTYPE6 logical
terminals. Related information:
v An LUTYPE6 or dynamic LTERM cannot be assigned Chapter 2, “IMS problem determination,” on page 5
to a node because these types of logical terminals are
associated with users.
v An LUTYPE6 LTERM or user cannot be assigned to a DFS3643I USER xxxxxxxx HAS EXCEEDED DLQT
non-LUTYPE6 user. VALUE. LAST ACCESSED ON yyyyddd.
v A non-LUTYPE6 LTERM or user cannot be assigned Explanation: User xxxxxxxx has queued messages or
to an LUTYPE6 user. outstanding status and has not been accessed since
v An LTERM cannot be assigned to a dynamic or yyddd, which exceeds the time period specified on the
LUTYPE6 terminal. DLQT JCL parameter. User xxxxxxxx was last accessed
System action: The command is ignored. when it was created, signed on, or signed off. Other
possibilities are when messages were dequeued, or
Operator response: Make an appropriate reassignment queues were assigned away. User xxxxxxxx has been
for LUTYPE6 or dynamic nodes, LTERMs, or users. marked as having a status of DEADQ.
System programmer response: Verify that the time
DFS3639 USER KEYWORD INVALID IF NODE period specified on the DLQT JCL parameter is not
PARAMETER IS GENERIC unreasonably short.
Explanation: A command with the keyword For ISC users, determine why the ISC user was not
combination NODE and USER was supplied with a allocated to a node for the DLQT time period.
generic NODE parameter.
For dynamic users, if the user name is defined to
System action: The command is ignored. enhanced security such as RACF, verify that user
xxxxxxxx can access the queue by signing on. If the
User response: Enter a nongeneric NODE parameter
dynamic user name is not defined to enhanced security
with the USER keyword.
such as RACF, and thus cannot be signed on, determine
Module: DFSICLN0 why messages were queued or status applied to that
user.
DFS3640W xxxxxxxx HAS AN INVALID DYNAMIC To aid the investigation of why messages were queued
TERMINAL DESCRIPTOR TYPE OF y and to remove the status of DEADQ, use the /ASSIGN
command to reassign queues and retrieve the data for
Explanation: While processing ETO descriptors, IMS
evaluation.
found a descriptor that cannot be identified as a
LOGON, MSC, USER, or DEVICE descriptor type. To purge the data and to remove the DEADQ status,
use the /DEQUEUE command. If status no longer
System action: The descriptor is ignored.
applies to the user, remove the status using a command
System programmer response: Locate the descriptor or by signing the user on and taking the necessary
with the resource name of xxxxxxxx. Correct the actions to reset the undesired status.
descriptor type of y to L, M, U, or D. If this descriptor
Delete dynamic users who were created inadvertently.
must be present, restart IMS.
To cause the user structure to be deleted, all the
Problem determination: 1, 6 messages must be dequeued or the queues assigned
Related information: away, and the status must be removed. Then, the user
structure will be deleted at the next simple checkpoint.
Chapter 2, “IMS problem determination,” on page 5
Problem determination: 1, 6
Problem determination: 1, 6, 10
DFS3649A /SIGN COMMAND REQUIRED.
Related concepts:
(3270/SLU2 type devices) IMS Sign on panel
LU2 and non-SNA 3270 screen size and model
information (Communications and Connections) or
MFS device descriptors (System Definition)
(Non-3270/SLU2 devices) /SIGN COMMAND
Related tasks: REQUIRED FOR IMS imsid. NODE node name. (NO)
OUTPUT SECURITY AVAILABLE (,REJECTED
Administering the Extended Terminal Option
reason.)
(Communications and Connections)
Related reference: Explanation: The user of a terminal requiring sign on,
which includes all ETO terminals except ISC, SLU P,
MFS Device Characteristics Table utility and FINANCE terminals, must enter valid sign-on data
(DFSUTB00) (System Utilities) before IMS will accept other input data, such as
Related information: transactions, commands, and message switches. The
only commands permitted at this time are /SIGN and
Chapter 2, “IMS problem determination,” on page 5
/RCLSDST.
For 3270 terminals, the first form of the message
DFS3647W MISPLACED OR DUPLICATE
appears and the sign-on data can be entered into the
DESCRIPTOR xxxxxxxx. CONTENTS
panel displayed. For non-3270 terminals, the second
ARE IGNORED.
form of the message appears; use the /SIGN command
Explanation: IMS initialization has already processed when permitted.
descriptor records for descriptor name xxxxxxxx.
If this message is sent again due to the rejection of a
However, a descriptor with the same resource name
sign-on attempt, the reason for the rejection will be
was found and ignored.
shown after the word REJECTED.
System action: The descriptor records in error are
The last form of this message, the key message, is
ignored and processing continues.
displayed when the pre-edit message was unable to be
System programmer response: Correct the error by built. For all the conditions that cause DFS3649 to be
discarding or repositioning descriptors in sent, see “Conditions for signon for DFS3649” on page
IMS.PROCLIB as required. 730.
Problem determination: 1, 6, 10 See the following list for the reason codes reason and
Related information: their meanings:
of a static ISC parallel session, or a static user user attempted to log on as a dynamic
was used for the sign-on to an ETO terminal terminal, but the node is already defined as
session. static.
264 Session initiation occurred for an ETO terminal 368 A mismatch occurred between the local IMS
that is an output-only device, but no sign-on and RM: session manager session.
data (user ID and optionally user password 372 A mismatch occurred between the local IMS
and user descriptor) was included. The session and RM: user or subpool support.
is terminated. 376 A mismatch occurred between the local IMS
268 MSGDEL specifications for the USER and and RM: device type.
static ISC parallel session terminal did not 380 A mismatch occurred between the local IMS
match. They must be the same. and RM: output-only.
272 The user structure name has been overridden 384 A mismatch occurred between the local IMS
by DFSSGNXO exit, either because a name and RM: output-only.
was provided in USEQUSTN or as a result of 388 A mismatch occurred between the local IMS
suffixing. This name exists as a user descriptor and RM: output edit.
and, therefore, cannot be used as a user 392 The node update did not produce RM output.
structure name by the user signing on. 396 The node update failed.
276 The user exists and is currently being used by 400 There is no storage.
as part of an /ASSIGN, /STOP, or /OPNDST 404 Node cleanup has no RM output.
command. 408 Node cleanup failed.
280 An LTERM name with a suffix added 412 Node delete has no RM output.
contained more than eight characters. 416 Node delete failed.
284 Temporary user structure is currently in use by 420 There is no LTERM for this signon.
another ITASK. Wait a moment and try again. 428 The user currently allocates to a different
292 A static terminal attempted to sign on and node.
register the user ID to RM. However, the 432 An error in the RACF database occurred. For
sign-on is rejected due to an error in RM more information, see system abend 483-4C in
registration. z/OS MVS System Codes (SA22-7626).
296 The user exists, but the user has Fast Path 436 CQS is unavailable, which causes the
input in progress and the user was defined registration of interest to fail.
with no Fast Path recovery (RCVYFP=NO). v For ETO terminal, the user is signed off.
The Fast Path program must complete before v For static non-stsn terminal that requires
the user is allowed to sign on. signon, the session persists. The user is
300 Password verification is required. signed off if already signed on.
304 Password verification failed. 440 The user is currently allocated to a different
308 A failure occurred in obtaining CTBWORK. node on the local IMS system.
312 The user is stopped from signing on. 444 Sign-on was unable to update the node
316 A user in Fast Path response mode attempted resource in RM. This condition is temporary;
to sign on to an IMS system that is not Fast try the sign-on again.
Path capable or is not using an EMHQ 448 An application is currently using an LTERM
structure. associated with this user. This condition is a
320 A mismatch occurred between the local IMS temporary. Please try the sign-on again.
and RM: user type.
324 A mismatch occurred between the local IMS Attention: For reason codes 4-52, see z/OS Security
and RM: number of assigned CNTs. Server RACF System Programmer's Guide (SA22-7681) for
328 The user resource in RM does not have a fixed further details.
segment.
332 The user is currently active. Conditions for signon for DFS3649:
336 The limit has been reached for user update Message DFS3649 is sent for various reasons. The
attempts. following table contains the conditions under which
340 The user is owned by another IMS. these messages are sent to different devices.
344 The user update failed.
348 The user ID is owned by an active IMS. In the table, a “Y” in the cell indicates that the
352 The assigned CNT was not found. condition is valid for the device listed at the top of that
356 The node query produced no RM output. column. An “N” indicates that this condition will not
360 The node query failed. cause message DFS3649 to be sent to the device listed
364 User signon failed. The user attempted to log at the top of that column. Blank cells in the tables
on as a static terminal, but the node is already indicate that the condition is not applicable to the
defined to RM as a dynamic terminal; or the device listed at the top of that column.
Because 3270 printers are output-only devices, they
never receive message DFS3649.
Numbers 058, 064, 165, 2467, 2469, 3650, 3662, and 3664 A sign-on failure for an output-only device causes
in the table indicate that messages DFS058, DFS064, message DFS2085 to be sent to the MTO with the
DFS165, DFS2467, DFS2469, DFS3650, DFS3662, and reason code from the DFS3649 message.
DFS3664 are received instead of DFS3649.
System action: IMS processes signon input data when descriptor name of eight characters or less that
entered. If the sign-on is successful, message DFS3650I is used by IMS to build a user control block
is sent to the terminal. Message DFS3650I provides the structure.
status of the terminal session and user. Password
An optional keyword indicating a password of
Operator response: Enter valid signon data as
eight characters or less that is associated with
requested. For RACF, the sign-on data consists of the
the user identification. This field will have a
following strings:
non-display attribute. The password is
User ID
required when RACF is used to verify the
A user identification of eight characters or less.
sign-on.
User Descriptor
Group An optional keyword indicating a group name
An optional keyword indicating a user
of eight characters or less that is associated
with the user ID.
System action: The IMS system continues processing. Operator response: Verify the status of the session
Operator response: See system programmer response. | nnn The maximum allowable number of
| descriptors for the descriptor type identified
System programmer response: You can suppress this
| by t. You can specify a maximum of 255 for
message by changing the IMS execution parameter to
| either type.
ETO=N. If ETO is required, it must be installed or
licensed. | System action: This message is issued, OTMA ignores
| the descriptor, and IMS continues to run normally. The
Problem determination: 1, 6, 10, 13
| client or destination definitions in the descriptor that is
Related information: | identified in the message text are not available for use.
IMS abend 3476 | Programmer response:
Chapter 2, “IMS problem determination,” on page 5 | Delete or reuse any descriptors that are no longer
| required. If you need to add an ALTPCB destination
DFS3677W aaaaaaaa HAS AN INVALID | descriptor and you cannot delete or modify any
PARAMETER FOR KEYWORD bbbbbbbb. | existing destination descriptors to accommodate the
KEYWORD IS IGNORED, DEFAULT | new descriptor, you can code the definitions in the
NOT USED. | OTMA Destination Resolution exit routine (DFSYPRX0)
| and the OTMA User Data Formatting exit routine
Explanation: IMS was processing dynamic terminal | (DFSYDRU0).
descriptors when it encountered an invalid parameter
for keyword bbbbbbbb. | If you modified any client descriptors, restart IMS to
| add the changes to the online IMS system.
System action: The keyword is ignored, but the
default is not used. | If you modified any destination descriptors in the
| DFSYDTx member, you must cold start IMS to add the
System programmer response: Locate the descriptor | changes to the online system.
with the resource name aaaaaaaa. Correct the invalid
parameter. If IMS cannot run without this keyword, | If you modified or replaced any destination descriptors
IMS must be restarted. | by using the UPDATE OTMADESC, DELETE
| OTMADESC, and CREATE OTMADESC commands,
Problem determination: 1, 6, 10 | you do not need to restart IMS.
Related information:
| Module: DFSYIDC0
Chapter 2, “IMS problem determination,” on page 5
| Related reference:
| DFS3678E TYPE t DESCRIPTOR desc_id IN | DFSYDTx member of the IMS PROCLIB data set
| MEMBER member EXCEEDS THE | (System Definition)
| MAXIMUM OF nnn. IT WAS
| IGNORED. DFS3680W UNABLE TO ADD EDIT ROUTINE
| Explanation: The number of type-t descriptors in the xxxxxxxx IN DESCRIPTOR yyyyyyyy TO
| DFSYDTx PROCLIB members exceeds the maximum TABLE. DESCRIPTOR IGNORED.
| number, nnn, that can be defined for the descriptor Explanation: IMS issues this message during
| type. The descriptor identified in the message text is initialization when it cannot expand the size of the
| ignored. dynamic user edit routine name and address table.
| OTMA initializes descriptors in the order in which they System action: The descriptor ignored.
| are coded in the DFSYDTx PROCLIB member. The
| descriptor identified in the message text by desc_id System programmer response: Increase the amount of
| might not be the descriptor that was added to cause virtual storage available to IMS.
| the maximum number to be exceeded. Problem determination: 1, 6, 10
| In the message text: Related information:
| t The descriptor type, either D or M. Chapter 2, “IMS problem determination,” on page 5
| Type D descriptors are OTMA destination
| descriptors. Type M descriptors are OTMA DFS3681W DESCRIPTOR NAME XXXXXXXX
| client descriptors. SAME AS TRANSACTION NAME.
| desc_id The ID of the descriptor. For type D
| descriptors, this is the destination name. For Explanation: This message is issued when the LU 6.2
| type M descriptors, this is the OTMA client descriptor initialization routine attempts to create a
| name. descriptor which has the same name as a transaction
| member The name of the OTMA DFSYDTx member in name initialized by the ETO initialization routine.
| the IMS.PROCLIB data set that contains the System action: This LU 6.2 descriptor is ignored.
| descriptors.
41 AREA=areaname COUPLING FACILITY subsystem, which means the ADS has been
CONNECT FAILED opened. If the ADS to be opened is already
42 AREA=areaname VSO AREA HAS IOT EEQES open, delete the DD statement for the named
44 AREA=areaname DD=ddname MADS I/O ddname. If the named ddname was incorrect,
timing is detected and thus coincidentally matched another
45 AREA=areaname REQUEST FOR VLOCK ddname in the IMS subsystem, correct the
FAILED. input ddname and then rerun the job.
| 46 AREA=areaname IS IN A QUIESCE STATE. 11 Rerun the job later when the common service
area (CSA) usage is low.
System action: When an open ADS failure occurs
12 Check the information given for the DBRC
during the processing of the DEDB area data set Create
RECON data set for the named area. If the
utility, the named area continues processing. An invalid
information is incorrect, correct the error and
return code is returned to the utility. Otherwise, the
rerun the job.
area is stopped.
13 Follow the programmer response in message
Programmer response: DFS2569I, which precedes this message.
14 Either the dsname specified in the ADS list of
Code (dec) the DBRC RECON data set, the JCL DD
Meaning statement, or the dynamic allocation parameter
01 Check the appropriate VSAM catalog or JCL list is incorrectly specified. Correct the
DD statements if a disk device is specified for specified dsname and rerun the job.
the named ADS. If dynamic allocation occurs, 16
check the dynamic allocation parameter list to | Case 1 The area had the virtual storage
find a device type specified for the named | option active when an XRF takeover
ADS. If a different device type was specified, | occurred, and an EEQE was created
correct the device type to the disk device and | to show that the area had I/O
rerun the job. | tolerated data in its data space. Before
02 This condition should not occur. Check why | the I/O toleration purge, one of the
the named ADS was changed to an available | following events occurred:
status. After changing the named ADS status | v The area was shut down internally
to an unavailable status, rerun the job. | due to a severe error and has not
03 The application program terminates when the | yet been recovered.
dependent region abends. After preparing the | v IMS failed and was restarted with a
tracing facilities for lock, rerun the job. | cold start; the area has not yet been
This reason code can be issued if a Fast Path | recovered
area open failed because the PI limit of 63 | Case 2 The VSO area lost connection to its
active waiters was reached. | structure, and an EEQE for RBA 0
04 Check the database definition (DBD) and the | was created to indicate area has I/O
VSAM definition for the named area. Also, | tolerated data in the old structure. If
check the BSIZ in the startup procedure. | an area is able to reconnect to the old
Correct the control interval (CI) size or buffer | structure, IMS resolves the I/O
size (BSIZ), and rerun the job. | toleration data and deletes the EEQE.
05 The number of allocated buffers is not | It the area was connected to a new
sufficient to fill the buffer allocation request. | structure, the I/O tolerated data in
The number of allocated buffers is defined by | the old structure is lost.
the DBBF parameter in the IMS EXEC
parameters. In either case, the I/O tolerated data has been
lost and the area must be recovered. Ensure
For a description of the dbbf value, see the the ADS marks unavailable. Run the database
IMS system definition information. recovery utility to recover the lost data and
06 Follow the Programmer response of message delete the EEQE.
DFS3709A or DFS3711A either of which might 17 If a DD statement is specified, specify the
precede this message. correct ddname. If the DD statement is
07 See the description for reason code 03 in this missing, specify a DD statement. (The DD
message. statement is located in the control region JCL.)
08 See the description for reason code 03 in this If a dynamic allocation failed, follow the
message. programmer response for DFS2502W or
09 Check an ADS list of the DBRC RECON data DFS2503W. Then, rerun the job.
set and change at least one ADS to an 18 Run your database print program or a VSAM
available status by using the CHANGE.ADS access method service program to print all the
command. area data sets. Find at least one correct ADS,
10 The named ddname exists in the IMS issue a CHANGE.ADS command for those
ADSs which are incorrect, change the available Determine why the identifier is incorrect.
status to an unavailable status, and rerun the Rerun the job with the correct data set.
job. Or follow your recovery procedure.
The area must be reinitialized. Unload the
19, 20 Check the DBRC RECON data set if the
area, run the Initialization utility, and then
named ADS is set to an unavailable status. If
reload the area.
the named ADS was set to an available status,
30 The RBA calculated as the next position to
change the status by the CHANGE.ADS
insert sequential dependents (DMACNXTS) is
command and rerun the job.
not within the range of valid RBAs for
21 Reorganization recovery is requested, but
sequential dependents for the area. Print the
ACCESS INTENT is neither UP nor EX. Set
second CI for the area. If the error is not
ACCESS INTENT to UP or EX with /START
apparent from the second CI (DMAC), contact
DB ACCESS or UPDATE DB START(ACCESS)
IBM Software Support for assistance.
SET(ACCTYPE()) command and rerun the job.
31 The high used RBA of the AREA/ADS was
22 The system tried to check whether the
not equal to the high allocated RBA. The Fast
reorganization utility was running or had been
Path AREA might have been defined to
running among subsystems, but failed. Either
VSAM, but the Fast Path format/initialization
IMS or IRLM might not be working correctly,
program might not have been run, or the
thus causing a notify error. Rerun the job, and
Database Image Copy utility or the DEDB
if the same error persists, restart IMS, IRLM,
Area Data Set Create utility might not have
or both.
completed successfully.
23 In a block level sharing environment,
reorganization recovery ended successfully, Use the list catalog (LISTCAT) command to
and the system then tried to update the find the high used and high allocated values.
second CI or the area, but failed. Run the Delete and redefine the AREA/ADS. Then
database recovery utility to recover the area, recover the AREA/ADS by either using the
and then rerun the job. DEDB Initialization utility and an application
24 In a block level sharing environment, to restore the data, or the Database Image
reorganization recovery ended successfully. Copy utility and a forward recovery method.
The system then tried to update the second CI 34 During Open processing of the specified Area,
of the area for the other subsystems, but it was determined that an EEQE exists for the
failed. Either IMS or IRLM might not be second CI of the Area and that the EEQE is
working correctly, thus causing a notify error. owned by a sharing IMS subsystem. On the
Rerun the job, and if the same error persists, sharing subsystem, use the /UNLOCK
restart IMS or IRLM, or both, then rerun the SYSTEM command to eliminate the EEQE.
job. 35 During Area open, a request for a VSO control
25 Check which area data sets are not available in block failed. Rerun job when CSA use is lower.
the DBRC RECON data set. If you want to 36 During Area open, a request for a new VSO
recover the area data set, run the DEDB Area control block failed. Rerun job when CSA use
Data Set Create utility, or rerun the job. is lower.
27 Start the area when the common service area 37 A request for a new data space was issued
(CSA) usage is low. during open processing of the Area, but the
28 DBD information in the DMAC is inconsistent request failed. See DFS2444I, which precedes
with the Area definition as found in the this message.
second CI of the Area/Area Data Set. One of 38 A new data space was obtained during open
the following events occurred: processing of the Area, but the request for
1. An area definition was changed by a authorization of the data space failed. See
DBDGEN (for example, CISIZE, number of DFS2445I, which is precedes this message.
UOW elements, number of RAPS). If the 39 During Area open, a request for a new VSO
DBDGEN is to be changed, redefine it and control block failed. Rerun job when CSA use
rerun the job. is lower.
2. An area was redefined with different 40 Determine if insufficient CSA/ECSA storage
characteristics, such as CISIZE or has been allocated to IMS, or if excessive
CYLINDERS. If an area definition is to be storage is being used.
changed, the area must be reorganized by 41 The area is not loaded into the Coupling
an UNLOAD/LOAD operation. Check the Facility. This situation does not prevent access
last DBDGEN and VSAM DEFINE for to the area unless preceded by message
consistency with the current characteristics DFS2819A.
or the area data set. 42 A /START AREA or UPDATE AREA
29 During area open, the second CI of the area START(ACCESS) command was issued but the
was found to have a structure for an IMS area was not started because it has IOT
Release level earlier than Version 1 Release 3. EEQEs. Message DFS2492I is generated before
message DFS3702I RSN=42. See message DMCB of the named DEDB, is referenced by the named
DFS2492I for additional information. PSB.
45 ADS is still in long busy mode at open time.
System action: The named PSB is stopped. For an
During open processing for an SVSO area, a
MPP, the input message is not processed. For a BMP or
request to get the VLOCK failed. This lock
an IFP, the dependent region terminates abnormally
serializes the SVSO processing across a data
with abend 0046.
sharing environment.
| 46 Stop the quiesce by issuing a UPDATE AREA Programmer response: This problem can occur if the
| STOP(QUIESCE) command. DEDB is not defined in the database statement for the
Related information: IMS online subsystem. If required, the IMSGEN listing
must be checked and the IMS online subsystem must
DFS2492I
be regenerated.
DFS3709A
Problem determination: 6, 8, 9, 10, 18, 19
DFS3711A
Related information:
System action: The named area is stopped for the For nn=08
online subsystem, and the status code 'FH' is The requesting online subsystem is not authorized
returned to the application programs. to share the named area with other subsystems.
System action: The named area is stopped for the
Programmer response: One of the following
online subsystem, and the status code 'FH' is
responses should be made:
returned to the application programs.
1. Close the area in the other subsystems holding
the incompatible database authorization by Programmer response: One of the following
entering a /STOP or /DBR command, and responses should be taken:
restart the area by entering a /START 1. If an environment with inter-system data
command in this subsystem. sharing and two IRLMs is required, change the
2. Wait until the other subsystems close the area, SHARELVL from 2 to 3 by using the DBRC
and restart the area by entering a /START CHANGE.DB command for the named
command in this subsystem. database and restart the area by using the
/START command.
For nn=02
2. If an environment with intrasystem data
The database is not registered in the RECON data
sharing and a single IRLM is required, run the
set.
online subsystem under the host processor
For nn=03 authorized for the named area.
The DEDB or area status prohibits further
For nn=09
authorization in the DBRC RECON data set
The DBRC RECON data set indicates that the
because of a global /DBR, /STOP command or
named area has been previously authorized in one
because of an internal database or area stop
or more online subsystems. Because the exit
command.
verification indicates that the subsystems are
System action: The named area is stopped for the inactive, the named area cannot be authorized.
online subsystem, and the status code 'FH' is
System action: The named area is stopped for the
returned to the application programs.
online subsystem, and the status code 'FH' is
Programmer response: The following responses returned to the application programs.
should be made:
Programmer response: Wait until another online
1. Analyze the reason for the status that prohibits
subsystem ends restart processing and closes the
further authorization, and take the required
area, and then restart the area by using the
action if necessary.
/START command in the subsystem.
2. Reset the authorization status for the database
or area by using the DBRC command, If the area was involved in data sharing with more
CHANGE.DB, or DBDS, and restart the area by than one IRLM, the IRLMs must be reconnected.
entering a /START command in this subsystem.
For nn=10
For nn=05 The area was previously authorized to the
The area is marked as needing an image copy in subsystem.
the DBRC RECON data set.
System action: The named area is stopped for the
System action: The named area is stopped for the online subsystem, and the status code 'FH' is
online subsystem, and the status code 'FH' is returned to the application programs.
returned to the application programs.
Programmer response: Close the area holding the
Programmer response: Run the Database Image incompatible database authorization by entering a
Copy utility, DFSUDMP0, for the named area, and /STOP or /DBR command; then restart the area by
restart the area by using the /START command entering a /START command.
after the utility has run successfully.
For nn=11
For nn=06 An invalid parameter was found in the database
The area is marked as needing recovery in the usage compatibility evaluation process. Probably,
DBRC RECON data set, or there are no area data the database/area record in the DBRC RECON
sets in AVAIL status for the area. data set is corrupted.
System action: The named area is stopped for the System action: The named area is stopped for the
online subsystem, and the status code 'FH' is online subsystem, and the status code 'FH' is
returned to the application programs. returned to the application programs.
Programmer response: Run the Database Recovery Programmer response: This condition is unlikely.
utility, DFSURDB0, for the named area, and restart Correct the problem associated with DBRC, and
the area by using the /START command after the contact IBM Software Support for further
utility has run successfully. assistance.
covered but the requesting subsystem is not signed v Close the area in other subsystems holding
on to the covering global service group (GSG). the database authorization by entering a
Only RSR subsystems can update RSR-covered /STOP or /DBR command.
databases and areas. v Wait until other IMS subsystems close the
area, and rerun the job.
System action: Authorization for the requested
activity is denied. For nn=06
Either there is no available ADS, or the area is
Programmer response: Either stop the database or
marked as needing recovery in the DBRC
area from being covered or define the requesting
RECON data sets. The Database Image Copy
subsystem to the GSG.
utility, DFSUDMP0, is unable to obtain
| For nn=41 authorization for a recovery-needed area.
| The area is quiesced or in the process of being
System action: The utility is not invoked for
| quiesced.
this area.
| System action: Authorization for the requested
Programmer response: Run the Database
| activity is denied.
Recovery utility, DFSURDB0, before running
| Programmer response: Wait for the quiesce to end the Database Image Copy utility to get a
| and rerun the job which failed authorization. The correct memory dump.
| status of the area can be determined by issuing the
For nn=07
| /DISPLAY AREA QSC, the QUERY AREA
The ACCESS parameter of the online
| command, or LIST.DBDS DBD(dbname)
subsystem is unacceptable for running the
| AREA(areaname) and examining the output.
DEDB Online utility.
| For nn=42 System action: Processing is terminated for
| The area is not quiesce held and image copy is
area.
| attempting authorization.
Programmer response: Verify the ACCESS
| System action: Authorization for the requested
parameter of the online subsystem. Ask the
| activity is denied.
master terminal operator to change the
| Programmer response: Wait for the quiesce to end database ACCESS parameter by using the
| and rerun the job which failed authorization. The /START command. Change it to a level which
| status of the area can be determined by issuing the is compatible with the current DEDB Online
| /DISPLAY AREA QSC command, the QUERY utility.
| AREA command, or LIST.DBDS DBD(dbname)
For nn=08
| AREA(areaname) and examining the output.
The requesting online subsystem is not
| If the image copy failed, wait for the quiesce to authorized to share the named area with other
| end or until the QUIESCE HELD flag is set on. You subsystems.
| can set the QUIESCE HELD flag on using the UPD
System action: The named area is stopped for
| START(QUIESCE) OPTION(HOLD) command
the online subsystem, and the status code FH is
| processing when quiesce has occurred.
returned to the application programs.
Programmer response: One of the following
DFS3710A UNABLE TO OBTAIN
actions should be taken:
AUTHORIZATION IN UTILITY FOR
v If an environment with intersystem data
DATA BASE=dbname AREA=areaname.
sharing and two IRLMs is required, change
REASON CODE=nn
the SHARELVL from 2 to 3 by using the
Explanation: The nn value in the message indicates DBRC CHANGE.DB command for the
the reason for the authorization failure in the DEDB named database; then restart the area by
utility. The following list indicates the explanation and using the /START command.
action for each nn code: v If an environment with intrasystem data
sharing and a single IRLM is required, run
For nn=01 the online subsystem under the host
The requested state and the current processor authorized for the named area.
authorization state are incompatible.
For nn=10
System action: The Fast Path utility being The area has been previously authorized to the
used is not invoked for this area. subsystem.
Programmer response: One of the following System action: The offline utility is not
actions should be taken: invoked for this area.
Programmer response: Duplicate job names the RSR tracking subsystem and the attempted
might have been used for the same area. Wait activity is not allowed for the area.
until another IMS subsystem closes the area,
For nn=23
and resubmit the job.
An attempt was made to update a
For nn=15 recovery-level tracking database or area on an
The Database Recovery utility is run against a RSR tracking subsystem.
DEDB area when all other subsystems are not
System action: Authorization for the requested
marked abnormally terminated for the
activity is denied.
Database Recovery utility.
System programmer response: Recovery-level
System action: The Database Recovery utility
tracking databases and areas cannot be
is not invoked for this area. The Database
updated. Change the tracking status for the
Recovery utility terminates.
database or area to database-level tracking,
Programmer response: Make sure that there is receive an image copy of the database or area,
no subsystem that has already authorized this and recover the database or area. Then try the
area and that has not abnormally terminated. failed activity again.
If a subsystem has authorized the area, wait
For nn=24
until that subsystem unauthorizes the area,
On an RSR tracking subsystem, there is
and then rerun the Database Recovery utility.
missing log data received from the RSR active
For nn=16 site that can contain update records for the
The area is not marked as recovery-needed in database or area.
the DBRC RECON data sets. The DEDB
System action: Authorization for the requested
Initialization utility is unavailable to obtain
activity is denied.
authorization for a recovery-not-needed area.
System programmer response: Wait for the
System action: The DEDB Initialization utility
missing log data to be recovered from the RSR
terminates.
active site. Perform the activity again after
Programmer response: Make sure that the area ensuring that all active site log data is
is valid for initialization. If the area should be available at the tracking site.
initialized, then force the area to a
The existence of gaps can be determined by
recovery-needed status using a
issuing the /DISPLAY TRACKING STATUS
CHANGE.DBDS command, redefine the area
command and examining the GAPS section of
using a VSAM access method service
the output.
command, specify the utility area control
statements again except for the ones already For nn=25
initialized, and rerun the utility. On an RSR tracking subsystem, all log records
have been applied to the tracking database for
For nn=20
the authorizing RSR active subsystem and
The named database or area is not registered
authorization is not for online forward
with DBRC and FORCER option is specified in
recovery.
the DBRC RECON record.
System action: Authorization for the requested
System action: The Fast Path utility being
activity is denied.
used is not invoked for this area.
System programmer response: This problem is
Programmer response: Register the named
an internal logic error; contact IBM.
area and area data sets with DBRC using
INIT.DBDS and INIT.ADS commands, and For nn=26
resubmit the job. On an RSR tracking subsystem, records from
an earlier update set ID have been received
For nn=22
from the RSR active site, but have not been
The area is currently authorized to another
applied to the database or area.
subsystem.
System action: Authorization for the requested
System action: Authorization for the requested
activity is denied.
activity is denied.
System programmer response: If there is
System programmer response: If this reason
missing log data from the earlier update set
code is received at an RSR active site or in a
ID, it will be automatically be recovered from
non-RSR environment, you must issue a /DBR
the RSR active site. When the missing log data
command for the area for all IMS subsystems
is recovered, try the failed activity again.
at that site. If the reason code is received at an
RSR tracking site, the area is being tracked by
The existence of gaps can be determined by | System action: Authorization for the requested
issuing the /DISPLAY TRACKING STATUS | activity is denied.
command and examining the GAPS section of
| Programmer response: Wait for the quiesce to
the output.
| end and rerun the job which failed
For nn=27 | authorization. The status of the area can be
In an RSR environment, authorization was | determined by issuing the /DISPLAY AREA
requested for a DEDB area that was not | QUIESCE command, the QUERY AREA
registered in the global service group (GSG) of | command, or LIST.DBDS DBD(dbname)
the requester. | AREA(areaname) and examining the output.
System action: Authorization for the requested | For nn=42
activity is denied. | The area is not quiesce held and image copy
| attempting authorization.
System programmer response: Register the
area with the GSG of the requester, if | System action: Authorization for the requested
appropriate, using the INIT.DBDS command. | activity is denied.
For nn=28 | Programmer response: Wait for the quiesce to
The update set ID (USID) is earlier than the | end and rerun the job which failed
USID of the most recently received image copy | authorization. The status of the area can be
for the database or area at the RSR tracking | determined by issuing the /DISPLAY AREA
subsystem. | QSC command, the QUERY AREA command,
| or LIST.DBDS DBD(dbname) AREA(areaname)
System action: Authorization for the requested
| and examining the output.
activity is denied.
| If the image copy failed, wait for the quiesce
System programmer response: Receive an
| to end or until the QUIESCE HELD flag is set
image copy with a USID earlier than the one
| on. You can set the QUIESCE HELD flag on
for the current image copy, or retry the activity
| using the UPD START(QUIESCE)
after a USID has been processed by the RSR
| OPTION(HOLD) command processing when
tracking subsystem that is equal to or later
| quiesce has occurred.
than the received image copy.
Problem determination: 6, 10, 17
| For nn=29
On an RSR tracking subsystem, one or more Module: DBFDBAU0
required tracking database or area data sets Related information:
have not been received.
Chapter 2, “IMS problem determination,” on page 5
System action: Authorization for the requested
activity is denied.
DFS3711A NONRECOVERABLE DEDB
System programmer response: Receive an AUTHORIZATION ERROR
image copy for the database or area and retry DEDB=dddddddd AREA=aaaaaaaa
the activity.
Explanation: DEDB authorization determined that a
| For nn=30 unrecoverable DEDB contains a sequential dependent
In an RSR environment, the database or area is (SDEP) segment type.
covered but the requesting subsystem is not
In the message text:
signed on to the covering global service group
dddddddd
(GSG). Only RSR subsystems can update
The database that experienced the error.
RSR-covered databases and areas.
aaaaaaaa
System action: Authorization for the requested The area that experienced the error.
activity is denied.
System action: Authorization fails.
System programmer response: Either stop the
Programmer response: Change the DEDB database
database or area from being covered or define
definition (DBD) to remove the Sequential Dependent
the requesting subsystem to the GSG by
(SDEP) segment type.
specifying PARM=’GSGNAME=IMSGSG1’ on the
EXEC statement of the DBFUMIN0 job. Module: DBFDBAU0
| For nn=41
| The area is quiesced or in the process of being
| quiesced.
issued) that preceded this message and follow the failed. This check compares the CUSN of the
programmer response in that message. second control interval for each data set
Related reference: entered.
20 No input ADS is available and the Database
Return codes from Sign-on Normal call (Messages Image Copy utility cannot take a backup copy
and Codes) from any of the data sets in the area. Before
this message, messages DFS3727I, DFS3728I,
Return codes from Sign-off Normal call (Messages DFS3729I, DFS3730I, or DFS3762I might be
and Codes) issued.
24 The IC utility either cannot find a clean ADS
Return codes from Authorization calls (Messages
(no EQE) for the area, or the only ADS
and Codes)
specified as input has EQE.
Return codes from Unauthorization call (Messages 28 The area status changed to a recovery-needed
and Codes) status in the DBRC RECON data set during
the image copy operation. This problem can
occur during an XRF takeover, when
DFS3725I AREA=areaname JCL DD STATEMENT recovery-needed status is temporary. The
DOES NOT EXIST status is reset to indicate recovery not needed,
Explanation: The DEDB Area Initialization utility, once takeover is complete.
DBFUMIN0, was unable to find a JCL DD statement This situation can also occur if IMS loses
corresponding to the ddnames in the ADS list of the connectivity with the coupling facility, causing
DBRC RECON data set. CASTOUT to fail. The write error, EEQE with
System action: The Fast Path utility being used a null EQERBA, is registered to DBRC and the
terminates. area is marked as temporary recovery-needed.
After CASTOUT is successful, the status is
Programmer response: Ensure that all DD statements reset to indicate that recovery is not needed.
for the DEDB areas (or multiple area data sets) are 32 An invalid data set name is specified in the
correct. If you are initializing the multiple area data DATAIN DD statement. The data set name
sets of an area, the area must be registered in the DBRC specified in the DATAIN DD statement of the
RECON data set and these area data sets must be in an Database Image Copy utility must match the
unavailable status in the RECON data set. The use of names registered in the ADS list of the target
DBRC must either default to YES, or be specified as area.
DBRC=Y in the EXEC parameter for DBFUMIN0. 36 No available ADS was found in the ADS list of
Problem determination: 3, 8, 35 the DBRC RECON data set. When ADSs are
unavailable, the area cannot be specified as
Related information: input to the Database Image Copy utility.
Chapter 2, “IMS problem determination,” on page 5 40 Only one ADS is specified as input when the
MADS I/O timing environment (MADSIOT) is
enabled.
DFS3726A FPE AREA IMAGE COPY
TERMINATED ABNORMALLY FOR System action: The program terminates.
AREA=areaname REASON CODE=nn
Programmer response: Take the appropriate action
Explanation: Database Image Copy utility processing based on the code you received.
failed for the named area. The following nn values
indicate the reason for the failure. Code (Dec)
Action
Code (dec) 00 Check if DBFDBAU0 exists in the SDFSRESL.
Meaning 04 See the DBRC message related to this message.
00 Loading of the area authorization module, 08 Check the message for the area authorization
DBFDBAU0, from the IMS SDFSRESL to the related to this message.
main storage failed. 12 Specify the correct ddname in the DATAIN
04 The DBRC interface failed. DD statement, and resubmit the job.
08 The area authorization failed. 16 Check to see if all the input data sets are at the
12 No DATAIN DD statement was specified in same level, specify the correct data sets in the
the JCL. The ddname specified in the DATAIN DATAIN DD statement, and resubmit the job.
DD statement of the Database Image Copy 20 Check messages DFS3727I, DFS3728I,
utility must match the names registered in the DFS3729I, DFS3730I, or DFS3762I and correct
ADS list of the target area. the error. Then resubmit the job.
16 The consistency check for the input data sets 24 Recover the area and create a data set which
does not have any EQE, and resubmit the job.
28 List the RECON to determine if the area is in
24 Unable to read the second control interval for 40 Rerun the job.
the target data set. 44 Specify the correct dsname in the data set1 DD
28 DBRC was not initialized for this region and statement and resubmit the job.
was unable to authorize the area. If the system 48 Follow the operator response described in the
does not have DBRC, this message is issued. IEC131I message.
36 Unable to get the control interval size for the 52 Print the DBRC RECON data set and check
target data set. For DEDB track recovery, the ADS list of the named area. If there is not
SHOWCB is issued to get the length of the CI any ddname in the ADS list, register at least
for a later reading of the second CI, but it one ddname in the DBRC RECON data set
failed. using an INIT.ADS command. After the
40 Unable to change the VSAM control block registration, recover the named area by a
(RPL). For DEDB track recovery, MODCB Is Database Recovery utility and rerun the job.
issued to set the relative byte address of the Related reference:
second control interval for reading, but it
failed. IEC131I
44 An invalid data set name was issued. For a
DEDB, the dsname specified in the data set1
DFS3736A VALIDATION CALL FAILED FOR
DD statement of the Database Recovery utility
AREA=areaname DD=ddname Code=xx
must match the names registered in the ADS
list of the target area. Explanation: IMS Fast Path attempted to validate the
48 The RDJFCB macro failed. Check the IEC131I status of the ddname specified in the DDNAME control
message. statements and discovered an error condition. In the
52 No ADS record is found in the DBRC RECON message text, the code xx can have one of the following
data set. values:
System action: The program terminates. For reason Code Meaning
code 32, the system sets the data set unavailable status IA The status of ADS in the DDNAME statement
in the ADS list of the DBRC area record. The area conflicts with the one in the ADS list in the
status is set to the recovery-needed status if the data set DBRC RECON data set. If the DEDB Create
is the last one in the area. utility is requested, the status of the ADS is
available in the RECON data set. If the DEDB
Programmer response: Respond based on the return
Compare utility is requested, the status of the
code nn as follows:
ADS is unavailable in the RECON data set.
Code (dec) IB The ddname is not found in the RECON data
Meaning set.
00 Check if DBFDBAU0 exists in SDFSRESL.
System action: The utility is not activated for the
04 See the DBRC message related to this message
requested area.
and check it.
08 Check the message related to the area Programmer response: Specify the correct ddname in
authorization. the DDNAME statement, and resubmit the job.
12 First check to see if DBRC is used or not. (This
can be done by checking the DBRC positional
parameter in the EXEC parameter or the DFS3737A DMAC SYNCHRONIZATION FAILED
IMSCTRL DBRC parameter in the IMS system FOR AREA=areaname
definition macro.) Explanation: In the environment of sharing an area
If DBRC is used and the Area is registered, among subsystems at the block level, DMAC, which
specify one of the ddnames of the ADS list in contains the area information, must be identical among
the data set1 DD statement. If DBRC is used, the subsystems. Because of some error in the lock
but the Area is not registered, or if DBRC is failure, second control interval write failure, notify
not used, specify the areaname in the data set1 failure, and so on, DMAC synchronization cannot be
DD statement then resubmit the job. maintained on the area.
16 Specify the correct recovery mode according to System action: The Fast Path utility being used
the area status in DBRC RECON data set and terminates and the area is marked as stopped.
resubmit the job.
20 Check the other message related to this Programmer response: After the area is restarted,
message. resubmit the job.
24 Check other messages related to this message.
28 Check if the system has DBRC.
32 Recover the data set and the area if the area is
in recovery-needed status.
36 Rerun the job.
Explanation: In the format phase in Create utility, Programmer response: Ensure that all new ADSs to be
DBFUMRI0, the formatting of a new area data set created are stopped among all the subsystems sharing
(ADS) failed. One of the following reason codes nn the area in block level. If not, enter the /STOP ADS
indicates the cause for the failure: command to stop all new ADSs globally. When this
action is done, take the following action.
Code (dec)
Meaning
01 Rerun the job.
02 Rerun the job.
03 Rerun the job.
04 Check the reason for the failure of the ADS to
open and correct the error. When this action is
done, rerun the job.
Explanation: An I/O error occurred on the last | If the area is quiesced, stop the quiesce by issuing a
new-active area data set (ADS), and no new ADS are to | UPDATE AREA STOP(QUIESCE) command, and rerun
be created. | the named utility.
System action: The Fast Path utility being used
terminates. DFS3756A COMPARE UTILITY TERMINATED
BECAUSE COMPARABLE ADS
Explanation: The IMS DEDB Initialization utility Explanation: An error occurred when the Database
(DBFUMIN0) found that the data set name in the Image Copy utility attempted to read from or point to
DBRC RECON ADS list does not match the one in the a DEDB area. The VSAM GET or POINT macro
JCL DD statement. encountered a problem.
System action: The utility terminates. System action: The Database Image Copy utility tries
to read from or point to a DEDB area in the next
Programmer response: Ensure that the data set names available data set.
in the DBRC RECON record and in the JCL DD
statement are correct, and then rerun the job. Programmer response: Correct the error, and rerun
the job.
System action: Processing continues. Explanation: IMS encountered a problem with IRLM
when modifying the status of the area data set for the
named area data set and attempting to notify the other
subsystems to synchronize the status during emergency
restart. The status change had been requested in the
failing system.
System action: The indicated DEDB area is stopped, Operator response: The user must stop the ADS in all
and the emergency restart continues. subsystems sharing this ADS by /STOP ADS
command.
Programmer response: Restart the area using the
/START AREA GLOBAL command after emergency
restart. DFS3766W PSB pppppppp REQUIRES STOPPED
DEDB DATA BASE dddddddd, PSB
Problem determination: 6, 27
STOPPED.
Related information:
Explanation: Because a required Fast Path DEDB,
Chapter 2, “IMS problem determination,” on page 5
dddddddd, was unavailable, scheduling ended and PSB,
pppppppp, stopped.
DFS3764I DEDB AREA DATA SET STOP
System action: Processing stops.
SYNCHRONIZATION NOT
AVAILABLE - AREA STOPPED.
DBD=dbname AREA=areaname DFS3767A NOTIFY REQUEST TO SET AN ADS
DD=ddname TO AVAILABLE STATUS FAILED FOR
AREA=xxxxxxxx DD=yyyyyyyy
Explanation: IMS attempted to stop the area data set
during emergency restart. This situation can occur if an Explanation: During ERE processing the system tried
I/O error existed for the named area data set during to set the specified area data set (ADS) to available
emergency restart or if an external or internal stop area status in all subsystems sharing the ADS, but failed.
data set (ADS) was processing when the system failed. The status of the ADS in each subsystem remains in
If an external or internal stop ADS was processing, the copy phase status. The status of the ADS in RECON
stop ADS was not available during the emergency D/S is in available status.
restart. Therefore, IMS forced the area to stop.
System action: System continues its operation.
System action: The indicated DEDB area is stopped,
Operator response: As there is a difference in the ADS
and the emergency restart continues.
status between each subsystem and the RECON D/S,
Programmer response: Restart the area using the the operator should stop the area which accesses this
/START AREA GLOBAL command after emergency ADS by /STOP AREA or UPDATE AREA STOP(SCHD)
restart. You must run either the DEDB Area Data Set command, then restart the area.
Create utility, DBFUMRI0, or the Database Recovery
utility, DFSURDB0, for the indicated data set.
DFS3768A DBRC REQUEST TO SET AN ADS TO
UNAVAILABLE STATUS FAILED FOR
DFS3765I DEDB AREA CONTROL BLOCK AREA=xxxxxxxx DD=yyyyyyyy
NOTIFY FAILURE - AREA STOPPED.
Explanation: During ERE processing, the system tried
DBD=dbname AREA=areaname
to set the specified area data set (ADS) to unavailable
Explanation: During emergency restart IMS status in the RECON data set, but failed. The status of
encountered a problem with IRLM when modifying the the ADS in the RECON data set remains in copy phase
area status for the named area and attempting to notify status.
other subsystems to synchronize the status. The status
System action: System continues its operation.
change had been requested in the failing system.
Operator response: The operator must set the status
System action: The indicated DEDB area is stopped,
of the ADS to unavailable status by a DBRC command.
and the emergency restart continues.
Make sure the status of the ADS is in unavailable
Programmer response: Restart the area using the status, both in the RECON data set and in each
/START AREA GLOBAL command after the emergency subsystem.
restart.
DFS3769I INVALID SYNTAX IN START OR
DFS3766A NOTIFY REQUEST TO STOP AN ADS STOP TIME PARM
FAILED FOR AREA=xxxxxxxx
Explanation: The program encountered an error in a
DD=yyyyyyyy
start time or stop time parameter.
Explanation: During ERE processing the system tried
System action: The DEDB utility program terminates
to stop the specified area data set (ADS) in each of the
with a return code of 08.
subsystems sharing the ADS, but failed. The status of
the ADS in all subsystems remains in copy phase status Operator response: Correct the invalid input
or in format phase status. parameter and rerun the utility.
System action: System continues its operation.
the processor STOP key was not pressed, and the other message, and continues processing.
subsystem has a severe problem. Contact IBM Software
Operator response: Restart the area just closed to
Support after appropriate data has been collected.
allow processing of the area to resume using its
Capture memory dumps of all IMS subsystems in the
remaining ADS data sets.
sysplex.
Module: DBFMPCL0
Problem determination: 1, 3, 4, 5, 6, 8, 10, 11, 14
Related information:
DFS3774A INSUFFICIENT STORAGE FOR
Chapter 2, “IMS problem determination,” on page 5
CONTROL BLOCKS
Explanation: The GETMAIN macro failed due to a
DFS3771I AREA areaname CANNOT BE
shortage in memory for SP=0. Because of this
PROCESSED DUE TO 2ND CI EEQE
condition, the input statements in the DFSHALDB data
(BUFFER)
set are not read and therefore, not validated.
Explanation: The AREA areaname could not be
System action: The job terminates with pseudoabend
processed for one of these reasons:
0201 and the following reason code:
v The /STO AREA (LOCAL) or UPDATE AREA
REASON=00000028
STOP(SCHD) command was not processed because
GETMAIN failure for control block storage.
the AREA has a second CI EEQE buffer.
v The /STOP AREA GLOBAL, UPDATE AREA Programmer response: Increase the size value of the
STOP(SCHD), /STOP ADS, /DBR DB, UPDATE DB REGION parameter.
STOP(ACCESS), or /DBR AREA command was not
processed because the AREA has a second CI EEQE. Module: DBFSHSPI0
Related information:
System action: Command processing for the AREA
terminates. IMS abend 0201
Operator response: Enter the /UNLOCK command or
the OS GO reply command to purge all EEQEs after DFS3775A OPEN FAILURE OF DDNAME
I/O prevention is resolved. Then reenter the failed DFSHALDB
command.
or
DFS3772I AREA areaname STOPPED. RECOVERY
NEEDED DUE TO 2ND CI EEQE DATASET ATTRIBUTES FOR DDNAME DFSHALDB
BUFFER ARE NOT VALID
Explanation: During /CHECKPT FREEZE processing Explanation: A DFSHALDB data set failed to open,
the named AREA was stopped and its status marked as the RECFM is not fixed block format, or the LRECL is
recovery-needed, if the AREA was registered in DBRC. not equal to 80.
This condition occurred because the AREA has a System action: The job terminates abnormally with
second CI EEQE buffer, which could not be written to pseudoabend 0201 and one of the following reason
the physical data set. codes:
System action: After stopping the AREA, the system REASON=00000016
continues processing. Indicates RECFM
REASON=00000020
Programmer response: Recover the AREA using the Indicates LRECL
Database Recovery utility. REASON=00000024
Indicates DFSHALDB failed to open.
DFS3773I AREA=areaname DD=ddnameSTOP Programmer response:
AREA GENERATED BY ADS CLOSE v For a reason code of 16, make sure the RECFM is FB.
ERROR. v For a reason code of 20, make sure the LRECL is 80.
Explanation: During the close of an ADS data set of a v For a reason code of 24, use the accompanying
multiple area data set (ADS) area that is being shared DFS0730I message to determine the cause of the
by two or more IMS subsystems, an I/O error occurred open failure.
while updating the second CI of that ADS data set. Module: DFSHSPI0
This situation causes internal /STOP AREA commands
Related information:
to be generated and sent to the IMS subsystems
currently sharing the area. After stopping the area, the “DFS0730I” on page 181
system continues processing.
IMS abend 0201
System action: The system closes the area, issues this
DFS3782I DB:O'name' AREA:name ADS:name 2ND DFS3795I IOT EEQE PURGE FAILED.
CI DAMAGE DETECTED AREA=areaname RBA=xxxxxxxx RC=yy
Explanation: Damage to the second control interval Explanation: During I/O toleration EEQE purge
(CI) was detected during DMAC refresh at the first processing, at least one EEQE could not be purged. For
open following an XRF takeover. each EEQE that is not purged, IMS issues this message
User response: Take one of the following actions: followed by message DFS0488I. areaname identifies the
v If multiple area data sets (MADS) are defined, name of the associated area; xxxxxxxx identifies the
change the ADS copy damaged by the second CI to RBA of the associated CI. Reason code yy has the
unavailable status for a subsequent recovery Start the following meanings.
area with the remaining valid ADS copies. Code (dec)
v If multiple area data sets (MADS) are not defined, Meaning
recover the area. 04 The request to get the CI lock failed.
08 The request to get the area lock failed.
or
DFS3801 CHKPT SNAPQ REQUIRED ON
ACTIVE SYSTEM
[LATEST] [RESTART] CHKPT: yyddd/hhmmss,
Explanation: An alternate system in the XRF complex HSBID=xx – [LATEST] BUILDQ CHKPT:
sends this message to the master terminal operator yyddd/hhmmss, HSBID=xx
(MTO) if the alternate system fails to locate the SNAPQ
checkpoint of the active system after thirty seconds. or
System action: The alternate system continues.
LOG READ CHKPT: yyddd/hhmmss – RESTART
Operator response: (master terminal) Determine CHKPT: yyddd/hhmmss, HSBID=xx – BUILDQ CHKPT:
whether the active system has taken a SNAPQ yyddd/hhmmss, HSBID=xx
checkpoint. If not, force a manual SNAPQ checkpoint
by entering a /CHE SNAPQ command on the active Explanation: At the completion of each IMS
system. If this message persists after the active system checkpoint, IMS issues this message to inform you of
has taken a SNAPQ checkpoint, a problem might exist the last checkpoint ID that is valid for loading DC
with the alternate system. Cancel the alternate system blocks. When running in an XRF environment, it
with a memory dump. indicates which IMS system (HSBID) wrote the CHKPT.
The latest RESTART or RESTART CHKPT indicates
Programmer response: No action is required. which IMS system must be restarted when an XRF
system abends. The exception to this is a BLDQ restart,
DFS3802W XRF NOT POSSIBLE - ONLY ONE RDS which can be done by either IMS system.
ALLOCATED. The first form of this message is issued in a non-XRF
Explanation: An XRF-defined IMS system was started, environment.
but only one restart data set (RDS) DD statement was The second form of this message is typically issued
included in the JCL. when running in XRF. For XRF systems following a
System action: The IMS alternate system being started shutdown checkpoint or a restart, the word LATEST
terminates abnormally. Any other IMS system starts does not appear in the message, and the word
continue, but the system will not be XRF-capable. RESTART is abbreviated to RST.
Programmer response: If you want an XRF-capable The third form of this message is issued only after a
system, shut down the IMS system. Include the takeover occurs, and when the system checkpoint
IMSRDS and the IMSRDS2 DD statements for the needed for IMS recovery was written before the LAST
restart data sets; then restart the IMS system. DC CHKPT and before the takeover. The new
checkpoint ID, LOG READ CHKPT, indicates only the
checkpoint at which IMS starts reading the input log.
DFS3803I ENTER /SWITCH TO CAUSE THE The checkpoint ID does not have an HSBID and must
BACKUP TO TAKEOVER not be used when determining which IMS system to
restart.
Explanation: The alternate (backup) system detected a
potential failure of the active system, but the operator In some circumstances, IMS might not be have been
must approve all takeovers. able to issue this message with a latest checkpoint
during a shutdown or cancel. In such circumstances, a
System action: The alternate system continues
later restart might show a different CHKPT.
tracking the active system.
System action: IMS continues processing.
Operator response: (master terminal) To initiate a
takeover, enter /SWITCH SYSTEM FORCE on the Operator response: (master terminal) This
alternate system. information is useful for determining which IMS
system to restart after an XRF takeover.
Programmer response: No action is required.
command was entered on a system that is not Programmer response: Define an ISC link to the
XRF-capable. XRF-capable IMS system if you want this type of
surveillance.
System action: The command is rejected.
Operator response: (master terminal) Contact the
DFS3810 KEYWORD ACTIVE OR BACKUP
system programmer.
DOES NOT MATCH SYSTEM OR IS
Programmer response: If you want XRF capability, MISSING
define the IMS system as an XRF-capable system.
Explanation: One of the following occurred:
v The keyword indicating whether the /SWITCH
DFS3806 BACKUP KEYWORD INVALID - NO SYSTEM command is being entered on the active or
XRF CAPABILITY the alternate (backup) system (ACTIVE/BACKUP)
does not correspond to the actual system.
Explanation: You entered an /ERE BACKUP v The keyword ACTIVE is missing. The keyword
command or a /STOP BACKUP command on a system ACTIVE must be specified when the /SWITCH
that is not XRF-capable. SYSTEM command is entered on the active system.
System action: The command is rejected. System action: The command is rejected.
Programmer response: If you want XRF capability, Programmer response: Be sure of the status (active or
define the IMS system as an XRF-capable system. alternate) of the system on which you are entering the
command.
DFS3807 MORE THAN 1 PARAMETER IN /STA
OR /STO SURVEILLANCE COMMAND DFS3811I LNK|RDS|LOG SURVEILLANCE
Explanation: A /START or /STOP SURVEILLANCE ACTIVE|INACTIVE;
command was entered with more than one INTERVAL|TIMEOUT VALUE
SURVEILLANCE parameter. The SURVEILLANCE CHANGED FROM xx TO yy
parameter must be one of these: Explanation: This informational message responds to
LNK the /CHANGE SURVEILLANCE command, and is
RDS issued with the DFS058I CHANGE COMMAND COMPLETED
LOG message. The following information is given in the
ALL message:
System action: The command is rejected. v which type of surveillance was changed
(LNK|RDS|LOG)
Programmer response: Reenter the command with a v whether that type of surveillance was active or
single SURVEILLANCE parameter. inactive
v the original (xx) and new (yy) interval or timeout
DFS3808I RDS|LNK|LOG SURVEILLANCE values.
ALREADY STARTED|STOPPED System action: The system continues processing.
Explanation: One of the following occurred: Programmer response: Check that the command
v A /START SURVEILLANCE command was entered, produced the intended results.
but the specified type of surveillance had already
Related information:
been started
v A /STOP SURVEILLANCE command was entered, “DFS058I” on page 30
but the specified type of surveillance had already
been stopped. DFS3812I BACKUP LNK|RDS|LOG INTERVAL
System action: The command is rejected. VALUE OF xx HAS BEEN FORCED TO
ACTIVE VALUE OF yy
Programmer response: No action is required.
Explanation: This informational message, issued in
response to the /CHANGE SURVEILLANCE
DFS3809 NO LINK SURVEILLANCE - LINK command, indicates that IMS modified system data in
NOT DEFINED order to continue processing the command. When the
Explanation: A /START or /STOP SURVEILLANCE timeout or the interval value is being changed by
LNK command was entered, but an Intersystem entering /CHANGE SURVEILLANCE on the alternate
Communication (ISC) link between the active and the (backup) system, and the alternate interval value is less
alternate IMS systems is not defined to IMS. than the active interval value, the alternate interval
value defaults to the active interval value. This message
System action: The command is rejected. is issued with the DFS058I CHANGE COMMAND COMPLETED
Operator response: Contact the system programmer. message.
System action: IMS continues processing the Operator response: (master terminal) Wait until the
command with the modified data. active system issues the INSYNCH message, DFS3858I.
Then reenter the SURVEILLANCE command.
Operator response: Contact the system programmer.
Programmer response: No action is required.
Programmer response: Check the command produced
the intended results. If you want different results, Related information:
reenter the /CHANGE SURVEILLANCE command. “DFS3858I” on page 780
Related information:
“DFS058I” on page 30 DFS3817 SURVEILLANCE KEYWORD
PARAMETER IS MISSING OR
INVALID
DFS3813 SYSTEM NOT XRF CAPABLE -
COMMAND REJECTED Explanation: A /CHANGE SURVEILLANCE, /START
SURVEILLANCE, or /STOP SURVEILLANCE
Explanation: The /DIS HSB or /UNLOCK SYSTEM
command was rejected for one of the following reasons:
command was entered on a system that is not
v The SURVEILLANCE parameter was missing or
XRF-capable.
invalid.
System action: The command is rejected. v More than one SURVEILLANCE parameter was
entered.
Programmer response: If you want XRF capability,
define the IMS system as an XRF-capable system.
Valid SURVEILLANCE parameters are LNK, restart
Module: DFSICLN0 data set (RDS), LOG, and ALL.
System action: The command is rejected.
DFS3814 FORCE KEYWORD IS REQUIRED
Programmer response: Correct the SURVEILLANCE
Explanation: The FORCE keyword is required when parameter; then enter the command again.
entering /SWITCH from an alternate system.
System action: The command is rejected. DFS3818 INTERVAL KEYWORD PARAMETER
IS MISSING OR INVALID
Operator response: (master terminal) If you want to
switch processing from the current active system to the Explanation: A /CHANGE SURVEILLANCE
alternate system, add the FORCE keyword, and reenter command was rejected for one of the following reasons:
the command. v The INTERVAL value was missing or invalid.
v More than one INTERVAL value was entered.
Programmer response: No action is required.
The INTERVAL value must be greater than 0 and less
DFS3815 RDS SURVEILLANCE NOT STARTED than 100.
DUE TO WRITE ERROR ON THE
System action: The command is rejected.
ACTIVE
Programmer response: Correct the INTERVAL value;
Explanation: The command to start restart data set
then reenter the command.
(RDS) surveillance was rejected because a previous
write error was encountered on the active system.
DFS3819 TIMEOUT KEYWORD PARAMETER IS
System action: The command to start RDS
MISSING OR INVALID
surveillance is rejected.
Explanation: A /CHANGE SURVEILLANCE
Operator response: (master terminal) Contact the
command was rejected for one of the following reasons:
system programmer.
v The TIMEOUT value was missing or invalid.
Programmer response: Determine the cause of the v More than one TIMEOUT value was entered.
write error. The restart data set (RDS) might have to be
reformatted. The TIMEOUT value must be greater than 0 and less
than 100.
DFS3816 COMMAND REJECTED - SNAPQ System action: The command is rejected.
CHECKPOINT NOT YET FOUND
Programmer response: Correct the TIMEOUT value;
Explanation: You cannot start or stop surveillance then reenter the command.
before the alternate system is synchronized with the
active system by processing a SNAPQ checkpoint from
the active system.
System action: The command is rejected.
DFS3823 I/O ERROR DURING SURVEILLANCE System action: The command is rejected.
READ/WRITE ON xxxxxxxx Operator response: Check the transaction code; then
Explanation: A read or write error occurred on the reenter the command.
restart data set (RDS) while RDS surveillance was Programmer response: No action is required.
active. The variable xxxxxx has one of the following
values:
IMSRDS DFS3827 MAXRGN KEYWORD PARAMETER IS
The error occurred on the data set defined by MISSING OR INVALID
the IMSRDS DD statement.
Explanation: A /CHANGE TRANSACTION
IMSRDS2
MAXRGN command was rejected because the
The error occurred on the data set defined by
MAXRGN parameter was invalid or missing. The
the IMSRDS2 DD statement.
MAXRGN parameter was invalid for one of the
System action: Processing continues, but RDS following reasons:
surveillance stops and no longer participates in the v The MAXRGN parameter must be in the range of 0
takeover decision. and 255 inclusive.
v Multiple MAXRGN parameters were entered.
Operator response: (master terminal) Determine the
cause of the I/O error and reformat the RDS, if System action: The command is rejected.
necessary. You can do RDS formatting only when
Programmer response: Correct the MAXRGN
restarting the active system.
parameter; then reenter the command.
Defining IMS.PROCLIB members for XRF (System DFS3833I BACKUP LNK|RDS|LOG INTERVAL
Administration) VALUE OF xx HAS BEEN FORCED TO
LNK|RDS|LOG INTERVAL VALUE OF
DFS3831 MODETABLE KEYWORD INVALID yy
WITH DISPLAY BY ATTRIBUTE Explanation: This message can be issued in response
OPTION to a /CHANGE SURVEILLANCE command to indicate
Explanation: The MODETABLE keyword cannot be that IMS changed system data in order to continue
used on a /DISPLAY NODE command if the nodes are processing the command. It is issued in the following
to be displayed by attribute. cases:
v When the interval value is being changed by
System action: The command is rejected entering /CHANGE SURVEILLANCE LNK or
Operator response: Reenter the command with the /CHANGE SURVEILLANCE RDS on the alternate
ALL keyword rather than specific node names. (backup) system and the new alternate interval value
is less than the alternate LOG interval value.
Programmer response: No action is required. v When the interval value is being changed by
entering /CHANGE SURVEILLANCE LOG on the
alternate system and the new alternate interval value
is greater than the alternate RDS and LNK interval
values.
v When the interval value specified on the LOG
parameter is greater than the interval value specified
on the RDS or LNK parameter. The interval value for v Increase the number of Message Queue buffers
the LOG parameter must be less than or equal to the assigned to the Active and XRF Alternate systems.
restart data set (RDS) and LNK interval values. This v If you are experiencing high I/O rates on any of the
restriction applies to original specifications made in devices that contain the Message Queue data sets,
member DFSHSBxx, or to specifications changed consider splitting up those data sets with the highest
with a /CHANGE SURVEILLANCE command. I/O activity across different devices.
DFS3851I YOU CANNOT CHANGE XRF DFS3852I THE OTHER SYSTEM IS NOT THE
SPECIFICATIONS IN THIS RESTART ACTIVE SYSTEM
Explanation: This message is issued only in an XRF Explanation: While bringing up an alternate system,
environment for one of the following reasons: the X'4001' log record from the active system contained
v The HSBID parameter is incorrect. an HSBID value of zero. A zero value is invalid for an
IMS active system in an XRF complex.
The HSBID parameter in the JCL of the system being
restarted (NRE/ERE) must be the same as the HSBID System action: The system terminates with abend
parameter in the JCL of the failing system in the XRF 3141.
complex. To determine the correct JCL
Operator response: (master terminal) Be sure that the
(active/alternate) to use:
correct log file was selected for the restart.
1. On the secondary console (hardcopy device), find
the last “DFS3804I LAST CHKPT ID VALID FOR Programmer response: No action is required.
RESTART: yyddd/hhmmss” message.
2. Determine the date and time from the Problem determination: 5, 8 (for both the active
DFS3804Imessage. system and the alternate system)
3. On the secondary console (hardcopy device), find Related information:
the “DFS994I *CHKPT yyddd/hhmmss*ctype rtype
START COMPLETED” message whose date and IMS abend 3141
time match the DFS3804I message. Chapter 2, “IMS problem determination,” on page 5
4. Determine the IMS ID from the DFS994I message.
5. Use this IMS ID JCL for the emergency restart.
DFS3853I DEDB AREA IS NOT AUTHORIZED
v The RSENAME parameter is incorrect. WITH DBRC. AREA STOP HAS BEEN
The RSENAME parameter in the JCL of the alternate REQUESTED FOR AREA = , DB = .
system being restarted (/ERE BACKUP) must be the
Explanation: During a takeover, the alternate system
same as the RSENAME parameter in the JCL of the
verifies that all Fast Path areas opened by processing
active system in the XRF complex. The RSENAME
the failing system log are authorized with DBRC. The
parameter is located in IMS PROCLIB member
area named in this message is not authorized with
DFSHSBxx. The xx represents the two characters of
DBRC.
the HSMBR=xx parameter in the IMS control region
JCL. System action: The Fast Path area is internally
v The USERVAR parameter is incorrect. stopped and closed.
The USERVAR parameter in the JCL of the alternate Operator response: (master terminal) Look for other
system being restarted (/ERE BACKUP) must be the error messages describing problems with this area. If
same as the USERVAR parameter in the JCL of the none are found, the area can be restarted.
active system in the XRF complex. The USERVAR
Programmer response: No action is required.
parameter is found in the IMS PROCLIB member
DFSHSBxx. The xx represents the two characters of
the HSMBR=xx parameter in the IMS control region DFS3854A WHEN THE PREVIOUS ACTIVE IMS
JCL. SUBSYSTEM TERMINATES, REPLY
'UNLOCK' [IMSID=imsid ASID=asid
System action: The system terminates with abend
RSE=rsename]
3141.
Explanation: An IMS system in an XRF complex is
Operator response: (master terminal) Correct the
terminating in I/O toleration mode. Unless the
error based on the information in the Explanation of
previous active system has terminated, the termination
this message.
of the current IMS system threatens the integrity of the
Related information: databases.
IMS abend 3141 The information in brackets will not be displayed if
insufficient storage is available to display the complete
message.
System action: The termination of the IMS system is checkpoint records from the alternate system.
waiting for the operator to guarantee that the previous
System action: Processing continues.
active system has terminated.
Programmer response: No action is required.
Programmer response: No action is required.
Master terminal operator response: Reply UNLOCK
DFS3859I PRIORITY n TERMINAL SESSIONS
only after the previous active system has terminated.
SWITCHED
Note: UNLOCK does not purge IOT EEQEs. Explanation: The former alternate system (now the
active system) has taken over all terminal sessions with
priority level n that were active at the time the
DFS3855I DEDB AREA HAS NO OPEN ADSCS
previous active system failed.
AT TIME OF TAKEOVER. AREA STOP
REQUESTED FOR AREA = , DB = . System action: Processing continues.
Explanation: During the tracking phase in an XRF Programmer response: No action is required.
complex, the alternate system could not open all area
data sets (ADS) that were opened by the active system.
DFS3860I ALL TERMINAL SESSIONS
Since there were no valid ADSs open at takeover time,
SWITCHED
the area was stopped.
Explanation: The former alternate system (now the
System action: The area is closed and stopped. An
active system) has taken over all terminal sessions that
error message describing the ADS open failure should
were active at the time the previous active system
have been issued before this message.
failed.
Operator response: Contact the system programmer.
System action: Processing continues.
Programmer response: Look for another error
Programmer response: No action is required.
message that describes the ADS open failure. Correct
the error as indicated in the message; then restart the
area. DFS3861 SYSTEM TAKEOVER OCCURRED
Problem determination: 1, 2, 3, 6 Explanation: This message is issued when the former
Related information: alternate system (now the active system) informs the
terminal user at session takeover that system takeover
Chapter 2, “IMS problem determination,” on page 5
completed in the host system.
System action: Processing continues.
DFS3856I REQSYNC WAS PROCESSED TO
TAKE SNAPQ CHKPT Programmer response: No action is required.
Explanation: The REQSYNC (SNAPQ checkpoint
request) sent from the alternate system was processed, DFS3862 INVALID LOGON REQUEST IN THE
and SNAPQ checkpoint process was scheduled in the ALTERNATE SYSTEM
active system.
Explanation: For information and actions, see message
System action: Processing continues. DFS3862I.
Programmer response: No action is required. Related information:
DFS3862I
DFS3857I OKTOSYNC ARRIVED FROM THE
ACTIVE SYSTEM DFS3862I INVALID LOGON REQUEST IN THE
ALTERNATE SYSTEM - NODE
Explanation: The alternate system received a signal
nodename
that indicates the active system began taking the
SNAPQ checkpoint process from the active system. Explanation: The alternate system in an XRF complex
can accept a LOGON request from one of the following
System action: Processing continues.
during the tracking phase:
Programmer response: No action is required. v MTO terminal
v ISC link between the active and alternate IMS
systems
DFS3858I INSYNCH ARRIVED FROM THE
v Class 1 terminal that is eligible for a backup session,
BACKUP SYSTEM
has an active session on the active system, and has
Explanation: The active system received a signal no backup session currently active. For an ETO
indicating the alternate (backup) system synchronized
with the active system by processing the SNAPQ
System action: The command is rejected. Explanation: Since the previous IMS startup was an
XRF-capable system, the following ERE startup, even
Operator response: If you are trying to bring up an though not XRF-capable, must specify an IMSID that
alternate (backup) system, reenter the command matches the checkpointed recoverable service element
specifying BACKUP without FORMAT WADS. Only (RSE) name.
SM, LM, QC, and SP are allowed.
System action: The system terminates with abend
Programmer response: No action is required. 3141.
Operator response: Change the IMSID PROCLIB
DFS3865 FORMAT ALL CONFLICTS WITH parameter in the JCL of the system being restarted to
BACKUP KEYWORD match that of the checkpointed RSE name.
Explanation: FORMAT ALL is invalid in a /ERE Problem determination: 5, 8 (for both the failing
command that contains the keyword BACKUP. system and the system being restarted)
System action: The command is rejected. Related information:
Operator response: (master terminal) If you are trying IMS abend 3141
to bring up an alternate (backup) system, reenter the
Chapter 2, “IMS problem determination,” on page 5
command specifying BACKUP without FORMAT ALL.
Only SM, LM, QC, and SP are allowed.
DFS3869I THE ACTIVE SYSTEM MAY HAVE
Programmer response: No action is required.
FAILED REASON CODE=xx.
Explanation: The alternate system detected a potential
failure of the active system, but the operator must
approve all takeovers. This message is issued only
when nonautomatic takeover has been requested by Programmer response: No action is required.
specifying AUTO=NO in member DFSHSBxx. The
Problem determination: 1, 3
operator must enter /SWITCH SYSTEM FORCE to
enable takeover to proceed. This message is issued Related information:
every 30 seconds, as long as the takeover remains Chapter 2, “IMS problem determination,” on page 5
pending.
Reason code xx is defined below. The codes can be DFS3873I JOINRSE MODE=ACTIVE|BACKUP
issued by themselves, or in combination. For example, WAS SUCCESSFUL
X'82' combines X'80' and X'02'.
Explanation: An IMS system was successfully
Code (hex) registered with the Availability Manager as either the
Meaning active system or the alternate (backup) system of an
02 ESTAE exit entered XRF complex. To the Availability Manager, the
04 IRLM failure XRF-capable IMS system is a recoverable service
08 /SWITCH entered element (RSE) consisting of both an active system and
10 LOG surveillance an alternate system. The name of the RSE that this IMS
20 System LNK surveillance system is "joining" can be found on the RSENAME
40 Restart data set (RDS) surveillance parameter in the DFSHSBxx member of PROCLIB.
80 VTAM termination
In a Fast Database Recovery environment, the
System action: The alternate system continues subsystem name of the active IMS is used as the RSE.
tracking the active system. When an IMS system that is enabled for Fast Database
Recovery issues this message, it is ready for I/O
Operator response: Enter the /SWITCH SYSTEM
prevention invocation. The Fast Database Recovery
FORCE command if you want takeover to continue.
region does not issue this message.
System action: Processing continues.
DFS3870I RDS|LNK|LOG INTERVAL VALUE
HAS BEEN FORCED TO nnn Programmer response: No action is required.
Explanation: The interval values for restart data set
(RDS), LNK, or LOG surveillance specified on the DFS3874I LEAVERSE MODE=IOP|TAKEOVER
alternate system were less than the interval values WAS ISSUED
specified on the active system. The alternate interval
values must be greater than or equal to the active Explanation: The Availability Manager was notified
interval values. The interval values are checked during that the IMS system issuing this message is no longer
the synchronization phase, and when an interval value considered part of the XRF recoverable service element
is changed on the active system and a type X'6D' (RSE). The name of the RSE can be found on the
record is written to the system log. RSENAME parameter in the DFSHSBxx member of
PROCLIB. In an FDBR environment, the subsystem
User response: Check the interval values. name of the active IMS is used as the RSE.
When this message is issued by the active IMS, I/O
DFS3871I JOINAVM WAS SUCCESSFUL prevention or Takeover was requested.
Explanation: In an XRF complex or a Fast Database System action: Processing continues.
Recovery environment, the connection with the z/OS
component, the Availability Manager, was established Programmer response: No action is required.
successfully with the JOINAVM call.
System action: Processing continues. DFS3875I LEAVEAVM
MODE=NORMAL|ABEND WAS
Programmer response: No action is required. ISSUED
Explanation: A LEAVEAVM call with normal mode or
DFS3872I AVM CONNECTION FAILED abnormal mode was issued to reset the connection with
the availability manager.
Explanation: In an XRF complex or a Fast Database
Recovery environment, the connection with the z/OS System action: Processing continues.
component, the Availability Manager, failed. AVM
functions such as I/O prevention is not performed Programmer response: No action is required.
during a takeover.
System action: Processing continues.
Operator response: Contact the system programmer.
Programmer response: No action is required. used were different. They must be the same
unless a cold start or a BLDQ option is
specified.
DFS3885I NO FAST PATH FORWARD
08 During an emergency restart, the number of
RECOVERY NEEDED
data sets for the short and long message data
Explanation: If critical event messages were requested sets must be consistent. If a change is required,
in the KEYEVENT parameter in the DFSHSBxx member either a cold start or the BLDQ option is
of PROCLIB, this message is sent if Fast Path forward required.
recovery is not needed. 0C During an emergency restart in an XRF
environment, the Queue Manager System Data
System action: Takeover processing continues. Sets (qblks-shmsg-lgmsg) for the backup
Programmer response: No action is required. system were different. They must be different
than the System Data Sets used by the active
system.
DFS3886I FAST PATH FORWARD RECOVERY 10 During an emergency restart in an XRF
COMPLETE environment, the system data sets for the
Explanation: If critical event messages were requested backup system online change and restart data
in the KEYEVENT parameter in the DFSHSBxx member set were different. They must be the same as
of PROCLIB, this message is sent when Fast Path the active system.
forward recovery processing has completed. System action: The system terminates with abend
System action: Takeover processing continues. 0598.
Programmer response: No action is required. Operator response: (master terminal) Contact the
system programmer.
DFS3887I IRLM TAKEOVER ISSUED Programmer response: Correct the JCL so that the
ddname given in the message is no longer in conflict.
Explanation: If critical event messages were requested
Related information:
in the KEYEVENT parameter in the DFSHSBxx member
of PROCLIB, this message is sent when IRLM IMS abend 0598
TAKEOVER is issued.
System action: Takeover processing continues. DFS3890I TAKEOVER REQUESTED REASON
Programmer response: No action is required. CODE=rc
Explanation: The alternate system sends this message
DFS3888I NORMAL IRLM OPERATION when it determines that a takeover should occur. The
RESUMED reason codes (rc) are:
DFS3889A SYSTEM DATA SETS INCONSISTENT These reason codes can be issued by themselves or in
DDNAME- NNNNNNNN, RC=xx combination. For example, X'82' combines X'80' and
X'02', VTAM termination and ESTAE exit entered.
Explanation: While processing an X'4001' log record
from the previous (or active) IMS system during a System action: Takeover processing begins.
normal or an emergency restart, a conflict was detected
between a data set name and volume in the previous Programmer response: No action is required.
(or active) system and a data set name and volume in
the restart system. DFS3891I TAKEOVER IN PROGRESS
Code (hex) Explanation: The alternate system sends this message
Meaning after the IMS system log from the active system has
04 During a normal or an emergency restart of been processed by the alternate system.
the active system, the DSNAMES or VOLIDs
System action: Takeover processing continues.
Operator response: You do not need to act System action: The operating system did not take an
immediately, but tell the IMS system programmer that SDUMP. IMS does not retry the memory dump.
you received this message. Operator response: Notify your IMS system
programmer.
DFS3902W IMS DUMP REQUEST ERROR
-INVALID CALLER TYPE, xx DFS3905W IMS DUMP REQUEST ERROR - t
Explanation: The caller type passed to the IMS SDUMP PROCESSING ERROR,
memory dump assist module (DFSFDMP0) in the RC=r-ccc
DFSDPARM control block for an IMS memory dump Explanation: The IMS dump assist module
request was invalid. The hexadecimal field xx identifies (DFSFDMP0) received a nonzero return code from
the caller type. One of the following conditions caused SDUMP while processing an IMS SDUMP request. The
this error: meanings of the variables are:
v The level of DFSOFMD0 was not the same as the t P or S, indicating whether the request was a
level of the DFSDUMP macro and the DFSDPARM primary or secondary SDUMP request
control block. r SDUMP return code
v The DFSDPARM control block was overlaid. 04=partial memory dump created
v The IMS memory dump requester did not use the 08=no dump created
DFSDUMP macro to insert the caller ID field in the ccc The reason code taken from SDUMP (the
DFSDPARM control block. value is UNK, if no reason code was
System action: DFSFDMP0 creates a memory dump of available). For a partial memory dump (return
the caller's address space and the control region code=04), the value of ccc is N/A. In this case,
address space only. obtain the reason code from z/OS message
IEA911E or IEA611E.
Operator response: You do not need to act
immediately, but tell the IMS system programmer that System action: If this is the primary SDUMP request
you received this message. (t=P), IMS retries with a secondary SDUMP for the
following conditions:
v A partial memory dump was created (return code 4)
DFS3903W IMS DUMP REQUEST ERROR - which was not due to a QUIESCE=YES request that
INVALID DUMP TITLE LENGTH, yy could not be honored.
v No memory dump was created (return code 8), but
Explanation: The IMS dump assist module
the reason code is one of the following: 001, 255, 005
(DFSFDMP0) detected an invalid memory dump title
through 009. A retry is not attempted if the internal
length while processing an IMS memory dump request.
parameter list passed by the caller of the dump assist
The length precedes the actual title and cannot exceed
routine specifies no secondary memory dump.
required for the OTMA Callable processes any valid options received.
Services SVC module. rc is the return
User response: Correct the invalid options by
code from the MVS STORAGE macro
ensuring that:
call.
v The option is correctly spelled.
LOAD FOR DFSYSVC0 FAILED, RC=rc
v The option has only one qualifier (although the
An MVS LOAD call for module
option can be repeated.)
DFSYSVC0 failed. rc is the return
code from the MVS LOAD macro call.
BPESVC REGISTRATION FAILED, RC=rc Then rerun the memory dump formatting job for these
Registration of the OTMA Callable options. This message is followed by message
Services SVC routine with BPESVC DFS3913I, which indicates whether IMS offline
(BPE SVC services) failed. rc is the formatting will continue.
return code from the BPESVC Related information:
REGISTER macro call. “DFS3913I”
ABEND OCCURRED DURING
INITIALIZATION
An abnormal termination occurred DFS3913I IMS DUMP FORMATTING
during DFSYSVI0 processing. This DISCONTINUED
message can be preceded by a
DFS3908E message indicating the or
abend code and PSW, and by an
SDUMP of the address space of the IMS DUMP FORMATTING CONTINUING
DFSYSVI0 job.
Explanation: This message indicates whether IMS
System action: Module DFSYSVI0 terminates. The offline memory dump formatting is continuing after a
OTMA Callable Services SVC is not initialized (or, if it previous error.
was previously initialized, is not replaced).
System action: IMS offline dump formatting either
System programmer response: For environmental continues or stops.
errors (such as DFSYSVC0 not being in the same library
User response: If offline memory dump formatting
as the one from which you are running DFSYSVI0),
stopped, correct the errors based on previous messages,
correct the error and rerun DFSYSVI0. For NOT
and rerun the formatting job for any options that did
EXECUTING IN PSW KEY 7 error, ensure that the
not format.
library where DFSYSVC0 resides is APF authorized. For
other problems contact IBM Software Support.
DFS3914I IMS DUMP FORMATTER BUFFER
Module: DFSYSVI0
CONTROL BLOCK INTERNAL ERROR
Related reference: DETECTED
BPESVC codes (Messages and Codes) Explanation: One of the following internal IMS Dump
Formatter processing errors (related to IMS dump
ESTAE Return and Reason Codes storage buffers) occurred:
v The memory dump storage buffer prefixes were
BLDL Completion Codes
overlaid.
STORAGE OBTAIN Return and Reason Codes v IMS memory dump formatting was interrupted
while prefix rechaining was in progress.
LOAD Return and Reason Codes v An error occurred in the IMS memory dump format
Related information: storage access routine.
“DFS3908E” on page 788 System action: IMS snaps the memory dump
formatter control blocks and then returns control to
AMDPRDMP/IPCS with RC=8.
DFS3912W IMS DUMP FORMAT CONTROL
PARAMETER ERROR, cccccccc User response: Use the diagnostic output to determine
the cause of the problem.
Explanation: IMS Offline Dump Formatter
initialization (DFSOFMD0) did not recognize or process
option cccccccc in the memory dump format control DFS3915I GETMAIN FAILED FOR AN IMS
data set. FORMATTING DUMP BUFFER.
System action: DFSOFMD0 continues scanning the
format options, ignoring the invalid options. If more or
than 3 invalid options are detected, DFSOFMD0 closes
the memory dump format control data set and FREEMAIN FAILED FOR AN IMS FORMATTING
DUMP BUFFER.
Explanation: The IMS Dump Formatter was unable to System action: DFSOFMD0 tries to load the needed
get or free storage for IMS memory dump storage modules from current libraries to continue processing.
buffers.
User response: If you want to format the memory
System action: After a GETMAIN or FREEMAIN dump using the Offline Dump Formatter modules in
failure, the Print Service Routine prints a SNAP of the the memory dump, increase the storage provided for
memory dump formatting control blocks, IMS memory AMDPRDMP, and rerun the job. If the problem
dump formatting terminates, and AMDPRDMP receives continues, check the DFSAVECT vector table control
control with RC=4. block to make sure that it was not overlaid. The
address of this control block is at the beginning of load
User response: If the error occurred during a
module DFSABND0, which is pointed to by field
FREEMAIN, use the diagnostic output to determine the
SCDCABN0 or SCDDABN0 in the SCD.
cause of the problem. If the error occurred during a
GETMAIN, rerun the job with a larger region size. If you do not want to use the IMS Offline Dump
Formatter modules in the memory dump for
formatting, make sure that the Offline Dump Formatter
DFS3916W RC=01,DFSOFMD0 UNABLE TO
modules are available in load module DFSABND0.
GETMAIN STORAGE FOR -
REGISTER SAVEAREA For more help, contact the IMS system programmer.
or
DFS3918W RC=05, DFSOFMD0 UNABLE TO
GETMAIN STORAGE FOR -
RC=02, DFSOFMD0 UNABLE TO GETMAIN RELOCATED FP ESCD.
STORAGE FOR - COMMUNICATION AREA
or
or
RC=08, DFSOFMD0 UNABLE TO GETMAIN
RC=03, DFSOFMD0 UNABLE TO GETMAIN STORAGE FOR - RELOCATED CBT HEADER
STORAGE FOR - DUMP BUFFER PREFIXES
or
or
RC=10, DFSOFMD0 UNABLE TO GETMAIN
RC=04, DFSOFMD0 UNABLE TO GETMAIN STORAGE FOR - RELOCATED CBT TABLE
STORAGE FOR - DUMP BUFFERS
or
or
RC=310, DFSOFMD0 UNABLE TO GETMAIN
RC=06, DFSOFMD0 UNABLE TO GETMAIN STORAGE FOR - FAST PATH EPST WORK BUFFER
STORAGE FOR - RELOCATED SCD
Explanation: IMS Offline Dump Formatter
Explanation: IMS Offline Dump Formatter initialization (DFSOFMD0) was unable to get storage
initialization (DFSOFMD0) received a nonzero return needed to relocate the Fast Path ESCD, the Fast Path
code from GETMAIN while trying to get storage for a work buffer, Control Block Table Header, or the Control
required IMS offline memory dump formatting control Block Table (CBT). The IMS Offline Dump Formatter is
block. unable to format the CBT or CBTE subset options or
System action: The memory dump formatter is unable any other option that uses CBT FIND services to locate
to continue and returns control to AMDPRDMP with control blocks.
RC=4. System action: IMS memory dump formatting
User response: Increase the storage provided for continues, but Fast Path control blocks are not
AMDPRDMP; then rerun the failing job. If the problem formatted.
continues, notify your IMS system programmer. DFSOFMD0 disables all CBT use and continues with
IMS Offline Dump Formatter initialization.
DFS3917W RC=07, DFSOFMD0 UNABLE TO User response: Increase the storage provided for
GETMAIN STORAGE FOR - IMS AMDPRDMP and rerun the job. If the problem
DUMP FORMATTER MODULES. continues, notify your IMS system programmer.
Explanation: IMS Offline Dump Formatter
initialization (DFSOFMD0) was unable to get storage
needed to relocate the IMS Offline Dump Formatter
modules.
or
DFS3926W RC=24, DFSOFMD0 EXIT PARAMETER
LIST ERROR - JOBNAME IS NOT AN
RC=21, DFSOFMD0 ERROR WITH DFSFRMAT IMS SUBSYSTEM
DATA SET - READ/CHECK FAILED
or
or
RC=28, DFSOFMD0 EXIT PARAMETER LIST ERROR
RC=36, DFSOFMD0 ERROR WITH DFSFRMAT - JOBNAME ASCB NOT FOUND
DATA SET - "FMTIMS" KEYWORD NOT FOUND
Explanation: Either the address space control block
or (ASCB) for the IMSDUMP jobname in the AMDPRDMP
exit parameter list was missing in the current dump, or
RC=41, DFSOFMD0 ERROR WITH DFSFRMAT an ASCB for the jobname was present but did not have
DATA SET - RECFM FORMAT INVALID a matching SSCT entry for subsystem type "DB" or
"DC". The error can happen when any of these
or conditions occur:
v The necessary storage was not dumped.
v The jobname was incorrect.
RC=42, DFSOFMD0 ERROR WITH DFSFRMAT
v The IMS job terminated before the memory dump
DATA SET- LRECL/BLKSIZE INCOMPATIBLE
was created.
Explanation: Either DFSOFMD0 was unable to find, v A jobname was provided for a non-IMS job.
open, or read the IMS dump format control data set, or
System action: IMS dump formatting stops, and
the DFSFRMAT DD statement or data set contained
control is returned to AMDPRDMP with RC=8.
invalid data. The specific form of the message issued
indicates the problem. User response: Be sure that:
v You provide the correct dump.
System action: IMS dump formatting continues using
v The IMS jobname is valid.
the SUMMARY option.
v All necessary storage is dumped.
User response: Make sure that v IMS was in the dump.
v A valid DFSFRMAT DD statement is included for v IMS was not in early initialization or late
IMS offline dump formatting. termination.
For additional help, see your z/OS system v Any IMS memory dump in which the CTL, DL/I, or
programmer. DBRC address space was not requested.
Related reference: v SYSMDUMPs, secondary-request IMS memory
dumps, operator-initiated SVC memory dumps that
Offline Dump Formatter utility (DFSOFMD0) did not request the CTL or DL/I, or both, address
(System Utilities) spaces.
v z/OS-initiated SVC memory dumps.
DFS3927W DFSDPARM PARAMETER LIST NOT
For more help, see your IMS system programmer.
ALLOCATED, PARTIAL OFFLINE
DUMP MAY RESULT.
DFS3930I DFSOFMD0 WAS NOT ASSEMBLED
Explanation: You did not pass a DFSDPARM control
AT THE SAME MVS SP LEVEL AS
block containing certain DFSDUMP options to the IMS
THE IMS DUMPED OR THE DUMP IS
dump assist module (DFSFDMP0). DFSFDMP0 used
NOT MACHINE READABLE
the default options instead.
Explanation: z/OS control blocks cannot be analyzed
System action: DFSFDMP0 returns to the issuer of
correctly because either the IMS Offline Dump
DFSDUMP with RC=8. SDUMP processing continues.
Formatter initialization module was not assembled at
Operator response: No immediate action is necessary, the same z/OS SP level as the dumped IMS system, or
but tell your IMS system programmer that you received the memory dump was not machine readable, or the
this message. data set is not a memory dump.
System action: IMS memory dump formatting is
DFS3928W UNRECOVERABLE ERROR DURING terminated.
IMS DUMP REQUEST MAY RESULT
User response: Be sure that DFSOFMD0 is assembled
IN NO OFFLINE DUMP.
at the correct z/OS level for this memory dump and
Explanation: IMS SDUMP processing stopped because that the memory dump is machine readable. For more
problems were encountered during request processing help, see your IMS system programmer.
in IMS SDUMP. If a memory dump was not already
produced, no memory dump is created.
DFS3930W DFSOFMD0 ENCOUNTERED ERROR
System action: DFSFDMP0 returns to the issuer of WITH DUMP- RC45, DFSOFMD0 IMS
DFSDUMP with RC=8. Alternate online diagnostics, LEVEL DOES NOT MATCH DUMP
such as spin-off memory dumps, software LOGREG
Explanation: The version or release level of
entries, and dependent region memory dumps, are
DFSOFMD0 is incompatible with the level of IMS
allowed.
found in the memory dump. IMS dump formatting
Operator response: No immediate action is necessary, initialization code must be compatible with the IMS
but tell the IMS system programmer that you received control blocks in the memory dump. IMS Offline Dump
this message. Formatting is not performed.
System programmer response: Examine the diagnostic System action: Make sure that a compatible library is
output, including the LOGREC entries created for the used and rerun the memory dump formatting job.
memory dump processing errors, to determine the
cause of the problem.
DFS3931W DFSFDMP0 UNABLE TO GET SRB
BLOCK STORAGE, NO IMS OFFLINE
DFS3929W name ADDRESS SPACE STORAGE IS DUMP ATTEMPTED.
NOT IN THIS DUMP
or
Explanation: The private address space storage for the
name address space was not dumped. In the message
text, name can be one of the following: DFSFDMP0 UNABLE TO GET WORK AREA
CTL STORAGE, NO IMS OFFLINE DUMP ATTEMPTED.
DLI Explanation: The IMS dump assist module was unable
DBRC to obtain either private storage needed for the internal
System action: IMS offline memory dump formatting work area or CSA storage needed for the SDUMP SRB
continues, but some options can be bypassed, and some interface. Message DFS629I was not sent, and no IMS
blocks might not be formatted. SDUMP memory dump was created.
User response: Be sure that you provided the correct System action: DFSFDMP0 returns to the issuer of
memory dump. This situation can be valid for: DFSDUMP with RC=36. Online memory dump
formatting is not suppressed.
Operator response: No action is required. continues, but unpredictable formatting errors can
occur.
If the message indicates that work area storage is
unavailable, tell the IMS system programmer to User response: Use the formatted output with caution,
provide additional virtual storage for the failing remembering that control blocks that were not fully
address space. If the message indicates that SRB block initialized can contain formatting errors.
storage is unavailable, the system might need to be Related information:
inspected to determine what is causing the shortage of
“DFS3934W”
global storage.
Related information:
DFS3934W RC=38 CTL ADDRESS SPACE WAS
“DFS629I” on page 157
NOT FULLY INITIALIZED.
User response: See the previous symbol create service 'ECB STORAGE'
messages. 'XMCI BLOCK'
'USE LIST (CULE)'
DFS3937I UNABLE TO ACCESS STORAGE User response: Despite the failure of the IMS Dump
WHILE FORMATTING THE ccc...ccc Formatter, the output might still provide enough
information to help you diagnose your original
Explanation: During memory dump formatting, an
problem. If the memory dump formatter output does
error was encountered while attempting to access
not provide enough information, contact the IMS
dumped storage. The field ccc...ccc, which can be up to
system programmer.
16 bytes in length, identifies the control block or data
area being formatted. Programmer response: Use the diagnostic memory
dump to determine the cause of the problem. If the
In an online environment, memory dump storage is in
diagnostic memory dump is suppressed, contact the
the IMS Dump Formatter.
IMS system programmer.
The most common memory dump storage access errors
are:
DFS3938W TRACE TABLE WITH NAME cc
v STORAGE NOT AVAILABLE. The requested storage
REQUESTED -- NOT FOUND
was not in the memory dump.
v PARTIAL STORAGE AVAILABLE. A portion of the Explanation: The requested trace table could not be
requested storage was in the memory dump. found for an IMS Offline Dump Formatter TRACE
request. This usually indicates an invalid name was
System action: For most errors, a diagnostic memory
requested. This does not indicate a valid trace exists
dump immediately follows this message. This
and was not started.
diagnostic memory dump consists of the following:
v The contents of SDWA, which includes the PSW, System action: The TRACE option formatter
completion code, module ID, registers, and a terminates the current request and continues with the
memory dump of the SDWA area. next trace request.
v Instruction area, which includes 128 bytes of data
User response: Ensure that a appropriate IMS trace
before and after the failing instruction (total of 256
table name has been requested. For assistance, see the
bytes).
IMS system programmer.
v Communications area, which is the control block
used by the IMS Dump Formatter for Related reference:
intercommunication between the formatting modules.
Common trace table interface (Diagnosis)
v Save area, which is a memory dump of the save area
set used by the memory dump formatter.
v The memory dump formatter module vector table. DFS3939I cccccccc FORMATTING TERMINATED
v Dump formatter storage buffer header and prefixes -- WORKAREA STORAGE
(offline formatting only). UNAVAILABLE
v Dump option request block storage (offline
formatting only). Explanation: The IMS Offline Dump Formatter
internal work areas needed to process the request could
not be obtained, where cccccccc was the formatter
Following the diagnostic memory dump of the error,
option requested. An inadequate amount of storage to
the dump formatter continues formatting the next IMS
GETMAIN work area space causes the failure. The
control block requested.
message also occurs if more than 63 dump formatter
low-level option requests are made during the same
A diagnostic memory dump is suppressed when any of
formatter invocation.
the following forms of ccc...ccc is received:
'PSB' (and there is no DL/I storage in the memory System action: The IMS Offline Dump Formatter skips
dump) the current request and attempts to process the next
'AUTO OPTION PROC' (and debug was not formatting request.
requested)
User response: Ensure that the IMS Offline Dump
'ABND DIAG. AREA'
Formatter has sufficient storage and reissue the request.
'SA - EP ADDRESS'
For TSO use, make sure that the region size is
'SAP'
adequate. For batch jobs, increase the region size and
'ECB PREFIX'
rerun the job. See the IMS system programmer for
'SAVE AREA'
assistance.
'REGISTER AREA'
'SA - INV FWD PTR' When requesting memory dump formatter options
'QUEUE BUFFERS' from a user TSO CLIST facility, use no more than 63
'UEHB' options at one invocation.
'LATCH LIST'
request usually causes this condition. But requests for continues with the next request.
dynamically created terminal blocks when the terminal
User response: Ensure that the CLB option requests
is not currently connected to IMS can also cause this
are valid. Ensure that the CID qualifier refers to a valid,
condition.
connected IMS node. For assistance, see the IMS system
The request header line which contains the requested programmer.
formatter request type and argument that caused this
message to be generated precedes the error message.
DFS3967I INVALID SAP ADDRESS IN CLB/LLB
System action: The IMS Dump Formatter terminates -- SAP NOT FORMATTED
the current CLB formatting request and continues with
Explanation: The IMS Offline Dump Formatter
the next request.
detected an invalid save area prefix address while
User response: Ensure that the CLB option requests attempting to format a save area prefix associated with
are valid. Ensure that the CLB NODE argument refers a requested CLB/LLB. Storage errors in the dumped
to a valid IMS node name. For assistance, see the IMS IMS system cause this condition. The invalid address is
system programmer. found in the CLB/LLB ECB prefix that is formatted
after this message.
DFS3965I cccccccc FORMATTING TERMINATED System action: The IMS Offline Dump Formatter skips
-- BLOCK FAILED VALIDITY CHECK the save area prefix formatting for the current
CLB/LLB.
Explanation: The control block that was requested for
option cccccccc failed to pass a control block validity User response: For assistance, see the IMS system
check. An invalid request (an address argument) programmer.
usually causes this condition. Errors in the dumped
Problem determination: 2, 4, 8
IMS can also cause this condition.
Related information:
The request header line which contains the requested
Chapter 2, “IMS problem determination,” on page 5
formatter request type and argument that caused this
message to be generated precedes the error message.
DFS3968I cccccccc FORMATTING TERMINATED
The validity check ensures a given pointer in the
-- INVALID NUMBER CHARACTERS
control block points to the expected target location. For
IN ARGUMENT
example, it verifies that the requested CLB points to a
valid CTB in the requested CLB. Explanation: The named option NUMBER argument
contained non-decimal characters, where cccccccc is the
System action: The IMS Dump Formatter terminates
formatter option requested.
the current request and continues with the next request.
The request header line which contains the requested
User response: Ensure that the option requests and
formatter request type and argument that caused this
their arguments are valid. For assistance, see the IMS
message to be generated precedes the error message.
system programmer.
System action: The IMS Dump Formatter skips the
current request for the named option.
DFS3966I CLB FORMATTING TERMINATED --
REQUESTED CID NOT FOUND User response: Ensure that option request arguments
are valid. Valid decimal values are 0-9. The number
Explanation: While processing an IMS Offline Dump
argument must be one to four decimal numbers in
Formatter CLB option, no CLB was found with a
length. For assistance, see the IMS system programmer.
VTAM Communication ID (CID) to match the CID
request argument requested. One of the following
situations caused this condition: DFS3970 FAST PATH EXECUTION NOT
v The CID argument is invalid. POSSIBLE.
v Dynamically created terminal blocks were requested
when the terminal was not connected to IMS. Explanation: This message is issued when a terminal
v Storage errors were in the dumped IMS system. that cannot process a Fast Path transaction attempts to
v VTAM terminals were requested that are not enter a Fast Path transaction. To process a Fast Path
currently connected to IMS. transaction, a terminal must support response mode.
System action: The system rejects the attempt and
The request header line which contains the requested does not schedule the transaction.
formatter request type and argument that caused this
message to be generated precedes the error message. Programmer response: When this message is issued,
check the relationship between the terminal and
System action: The IMS memory dump formatter transaction to make sure that all system definitions are
terminates the current CLB formatting request and correct.
DFS3971 UNABLE TO PROCESS FAST PATH DFS3976E utility nameUTILITY FAILED TO OPEN
DUE TO EMH SHORTAGE THE ddname DATA SET
Explanation: IMS was unable to obtain an Expedited Explanation: A utility failed to open one of the
Message Handling (EMH) buffer for the size requested required data sets.
to process the Fast Path transaction.
In the message text:
System action: IMS rejects the Fast Path transaction utility name
and sends this message to the terminal user. The utility that encountered the problem.
ddname The data set that failed to open. Possible
System programmer response: Determine the current
values for ddname are:
EMH buffer usage. Stop or close terminals and sessions
SYSUT1
that currently have EMH buffers but do not need them.
REPORT
This action frees EMH buffers for use by terminals and
SYSPRINT
sessions that require them.
CONTROL
The next time you restart IMS, increase the EMH buffer RDDSDSN
pool definitions for the buffer sizes needed.
System action: The indicated utility fails with a return
code 8.
| DFS3974W UNABLE TO WRITE OUTPUT
Programmer response: Make sure that the DD
| RECORDS FROM THE IMS DUMP
statement for the data set is defined correctly.
| FORMATTER TO DATA SET:
| data_set_name Module: DFSKJOB0, DFSURCM0, DFSURCL0,
DFSURST0
| Explanation: The IMS Dump Formatter was unable to
| open or allocate the data set identified in the message
| text by data_set_name. It was trying to use the data set DFS3977E routine name ROUTINE FAILED TO
| for writing log records from dump log buffers. OPEN THE ddname DATA SET
| System action: If you provided an existing data set, Explanation: A routine failed to open one of the
| check that it was created in the proper format. If you required data sets. The routine is started by utility
| did not create the data set, then the system was unable DFSURCM0.
| to allocate the data set.
In the message text:
| System programmer response: Provide a valid data routine name
| set to be used to write the records, or allow the The routine that encountered the problem.
| formatter to create one. ddname The data set that failed to open. Possible
values for ddname are:
| Module: DFSAAED1
MODBLKS
JOBLIB
| DFS3975W UNABLE TO WRITE REPORT DATA STEPLIB
| FROM THE IMS DUMP FORMATTER SDFSRESL
| TO THE OUTPUT DATA SET:
System action: The indicated routine fails with a
| data_set_name
return code 8.
| Explanation: The IMS Dump Formatter was unable to Programmer response: Make sure that the DD
| open or allocate the data set identified in the message statement for the data set is defined correctly.
| text by data_set_name for use in writing report data.
Module: DFSKMOD0, DFSKNUC0
| System action: If you provided an existing data set,
| check that it was created in the correct format. If you
| did not create the data set, then the system was unable DFS3978E utility name UTILITY FAILED TO
| to allocate the data set. CLOSE THE ddname DATA SET
| System programmer response: Provide a valid data Explanation: A utility failed to close one of the
| set to be used to write the records, or allow the required data sets successfully.
| formatter to create one.
In the message text:
| Module: DFSAAED1 utility name
The utility that encountered the problem.
ddname The data set that failed to close. Possible
values for ddname are:
SYSUT1
REPOR
SYSPRINT
CONTROL
DFS3981E utility name UTILITY FAILED TO
MODBLKS
OBTAIN STORAGE,
RDDSDSN
SIZE=strgsize,COMPONENT=component
System action: The indicated utility fails with a return
Explanation: A utility encountered an error when
code 8.
trying to obtain storage for the component.
Programmer response: Make sure that the DD
In the message text:
statement for the data set is defined correctly.
utility name
Module: DFSURCM0, DFSURCL0 The utility that encountered the problem
strgsize The amount of storage requested
component
DFS3979E routine name ROUTINE FAILED TO The component for which the storage request
CLOSE THE ddname DATA SET failed
Explanation: A routine failed to close one of the data System action: The indicated utility fails with a return
sets successfully. The routine is started by utility code 8.
DFSURCM0.
Programmer response: Increase the region size
In the message text: available to the utility.
routine name
The routine that encountered the problem. Module: DFSURCM0, DFSURCL0, DFSURST0
ddname The data set that failed to close. Possible
values for ddname are:
DFS3982W utility name UTILITY FAILED TO FREE
MODBLKS
STORAGE, SIZE=strgsize,
JOBLIB
FREEMAINRC=rc,
STEPLIB
COMPONENT=component
SDFSRESL
Explanation: An error occurred when a utility tried to
System action: The indicated routine fails with a
free storage for a component.
return code 8.
In the message text:
Programmer response: Make sure that the DD
utility name
statement for the data set is defined correctly.
The utility that encountered the problem
Module: DFSKMOD0, DFSKNUC0 strgsize The amount of storage to be freed
rc The return code from the MVS FREEMAIN
request
DFS3980E utility name UTILITY FAILED TO LOAD component
MODULE module name, RC=rc The component for which the storage request
Explanation: A utility was unable to load a module. failed
In the message text: System action: The utility terminates successfully with
utility name a return code 4.
The utility that encountered the problem. Programmer response: This is probably an internal
module name error. Search the problem-reporting databases to find a
The module for which load failed. Possible correction for the problem. If none exists, contact IBM
values for module name are: Software Support. Provide the JCL, SYSLOG, and
DFSCNVT0 memory dump if available.
DFSKMOD0
rc The return code from the load request. Module: DFSURCM0, DFSURCL0, DFSURST0
a suffix matching the value specified on the User response: For assistance, see the IMS system
SUFFIX= control statement. programmer.
2. If the resource definition data set (RDDS) is being
created from the system definition input, the
DFS3986 IMS SYSTEM IS NOT FDR CAPABLE -
CONTROL DD statement does not reference the
COMMAND REJECTED
data set created by the DFSURST0 utility
OUTPARMS DD statement. Explanation: The /DIS FDR or /CHA FDR command
3. The data set referenced by the CONTROL DD was entered on an IMS system that is not enabled for
statement does not contain EDITRTN control Fast DB Recovery.
statements for the indicated transaction code.
System action: The command is rejected.
System action: The Create RDDS from MODBLKS
utility fails with a return code 8. Operator response: If you want to run the IMS system
with Fast DB Recovery, rerun the job with the correct
Programmer response: Based on the possible cause of EXEC parameters and DFSFDRxx IMS.PROCLIB
the problem, perform one of these actions: member.
For 1, ensure that an IMS.SDFSRESL data set is Module: DFSCMT50
supplied which contains the nucleus member
DFSVNUCx with a suffix matching the value
specified on the SUFFIX= control statement. DFS3987 FDR CAPABLE ENVIRONMENT NOT
For 2, ensure that data set created by the DFSURST0 COMPLETED - COMMAND REJECTED
utility OUTPARMS DD statement is included in the Explanation: An IMS system was enabled for Fast DB
data set concatenation for the CONTROL DD Recovery. However, the Fast DB Recovery environment
statement code. is not completed because restart is in progress and the
For 3, ensure that EDITRTN control statements are XCF JOIN request has not been performed yet.
supplied for transaction code.
System action: The command is rejected.
Module: DFSURCM0
Operator response: After the restart operation or cold
start completes, enter the command again.
DFS3984I DUMP FOR ABEND xxxxx
Module: DFSCMT50
SUPPRESSED BY DUMP OVERRIDE
TABLE.
DFS3988E THE DFSKMOD0 ROUTINE IS
or MISSING THE MODBLKS DD
STATEMENT OR DD DUMMY IS
DUMP FOR ABEND xxxxx FORCED BY DUMP SPECIFIED
OVERRIDE TABLE. Explanation: The JCL specified for the Create RDDS
Explanation: There is an entry for abend xxxxx in the from MODBLKS utility (DFSURCM0) was missing the
memory dump override table (DFSFDOT0) to DD MODBLKS statement, or a DD DUMMY was
force/suppress the memory dump generated for this specified for MODBLKS.
abend. System action: The Create RDDS from MODBLKS
System action: When FORCE is specified a memory utility fails with a return code 8.
dump is taken if that abend occurs. When SUPPRESS is Programmer response: Make sure that the MODBLKS
specified a memory dump is not generated. After this DD statement is specified in the JCL and that a valid
procedure is processed the regular post-abend data set is specified.
procedure will occur.
Module: DFSKMOD0
Programmer response: When the information is
incorrect, modify the memory dump override table
entry in DFSFDOT0. When the message is correct then DFS3989W THE DATA SET SPECIFIED FOR THE
no further action is necessary. dd_name DD STATEMENT DOES NOT
CONTAIN MEMBER member name
DFS3985W NO CBTE ENTRY FOUND FOR SAPS - Explanation: The data set specified in a DD statement
SUMMARY ENDS in the JCL for the Create RDDS from MODBLKS utility
did not contain the indicated member.
Explanation: Save area prefixes (SAP) storage was not
obtained, or the pointer to the storage is damaged. In the message text:
dd_name
System action: The save area summary option The data set that is missing the member.
terminates, and the IMS Offline Dump Formatter Values include:
continues with the next option.
MODBLKS
DFS3991E RECORDS FOR THE SELECTED
JOBLIB
CHECKPOINT ARE INCOMPLETE.
STEPLIB
THE RDDS WAS NOT CREATED.
SDFSRESL
member name Explanation: The checkpoint records in the control
The missing member. statements or the default specification processed by the
Create RDDS from Log Records utility (DFSURCL0) did
System action: Processing continues. This message is
not contain an X'4098' record. That record identifies the
accompanied by message DFS3990E, if this problem is a
end of the checkpoint records. This situation might
terminating error.
result from one of the following circumstances:
Programmer response: If the indicated DD statement v You specified an incorrect checkpoint ID for
is MODBLKS, ensure that you specified the correct processing.
MODBLKS data set associated with the MODBLKS DD v Log data sets might be missing from the SYSUT1 DD
statement. Ensure that the value specified for the statement concatenation.
SUFFIX= control statement specifies the correct suffix
System action: The Create RDDS from Log Records
for the members you want in the MODBLKS data set.
utility fails with a return code 8.
If the indicated DD statement is JOBLIB, STEPLIB or
Programmer response: If a checkpoint ID is specified
SDFSRESL, ensure that the data set contains the
with the CHKPTID= statement, ensure that this
DFSVNUCx member with a suffix value matching the
checkpoint contains both the X'4001' record (beginning
value specified with the SUFFIX= control statement. If
of checkpoint) and the X'4098' record.
the data set containing the DFSVNUCx member with a
suffix value matching the value specified with the If no checkpoint ID was specified, ensure that the log
SUFFIX= control statement does not contain the data set that includes the X'4098' record is included in
executable modules for the Create RDDS from the SYSUT1 DD statement concatenation of the log data
MODBLKS utility, do not specify this data set with the sets at the end of the log data sets.
JOBLIB or STEPLIB DD statement, but specify this data
Module: DFSURCL0
set with the SDFSRESL DD statement.
Module: DFSKMOD0, DFSKNUC0
DFS3992E utility name UTILITY ENCOUNTERED
Related information: AN ERROR PARSING THE CONTROL
“DFS3990E” DATA
Explanation: The utility identified by utility name in
DFS3990E NO MEMBERS WITH SUFFIX: suffix the message text encountered an error while trying to
WERE FOUND IN THE MODBLKS parse the control statements in the CONTROL data set.
DATA SET. This message is accompanied by a more specific error
message describing the problem.
Explanation: The data set specified in the MODBLKS
DD statement for the Create RDDS from MODBLKS System action: The Create RDDS from MODBLKS
utility (DFSURCM0) did not contain any MODBLKS utility (DFSURCM0) fails with a return code 8.
members whose names contained a value for suffix that
Programmer response: Check the accompanying
matched the suffix supplied in a control statement or
messages to determine the parsing errors that you must
the default value. These members are required for
correct in the CONTROL data set.
processing. This message is accompanied by one or
more occurrences of message DFS3989W, identifying Module: DFSURCM0, DFSURCL0
the missing members.
System action: The Create RDDS from MODBLKS DFS3993E AN INVALID VALUE WAS
utility fails with return code 8. ENCOUNTERED BY THE DFSURCM0
UTILITY FOR THE SYSTYPE
Programmer response: Ensure that the correct
CONTROL STATEMENT
MODBLKS data set has been specified with the
MODBLKS DD statement. Also, ensure that the value Explanation: An invalid value was supplied for the
specified for the SUFFIX= control statement indicates SYSTYPE= keyword on a statement in the CONTROL
the correct suffix for the members in the MODBLKS data set. The allowable values are:
data set. DB
DC
Module: DFSURCM0
DBDC
Related information:
System action: The indicated utility fails with a return
“DFS3989W” on page 804
code 8.
Programmer response: Correct the invalid value for in the CHKPTID= control statement, did not match any
the keyword. checkpoint in the log.
Module: DFSURCM0 System action: The Create RDDS from Log Records
utility (DFSURCL0) fails with a return code 8.
DFS3994I IMS SYNC WITH RM GLOBAL Programmer response: Specify a valid checkpoint ID
STATUS COMPLETE- yyyy.ddd if processing a specific ID is required, or omit this
hh:mm:ss.ms control statement. In this case the last checkpoint ID on
the log will be processed.
Explanation: Global status is read from Resource
Manager (RM) during IMS initialization. This message Module: DFSURCL0
indicates that IMS is in sync with RM global status.
In the message: DFS3998E NO COMPLETE CHECKPOINTS WERE
yyyy - the year FOUND IN THE LOG IN THE
ddd - the day INDICATED TIME RANGE
hh:mm:ss.ms - local time
Explanation: The log did not include both the begin
System action: IMS continues processing. Any global and end checkpoint log records. The checkpoint records
status updated in RM after this message and before an were incomplete. Possible reasons include:
IMS restart is complete is not applied at this IMS that is v The records for a checkpoint span multiple log data
restarting. All commands sent to this IMS are not sets.
processed as restart is not complete. v A value for STARTTIME was specified which was
after the time stamp on any beginning checkpoint
System programmer response: After restart is
record on the log.
complete, issue commands with SCOPE(ACTIVE) to
v A value for STOPTIME was specified which occurred
ensure this IMS is in sync with RM status.
before the time stamp on the end checkpoint record
Module: DFSGST10 for the checkpoint being processed.
System action: The Create RDDS from Log Records
DFS3995E REQUIRED KEYWORD utility (DFSURCL0) fails with a return code 8.
MODBLKSHLQ= WAS NOT SUPPLIED
Programmer response: Ensure that sufficient log data
Explanation: The JCL specified for the Stage 1 sets are concatenated to contain all the records for a
pre-parser (DFSURST0) was missing the DD MODBLKS checkpoint. If you specify a STARTTIME, ensure that
statement, or a DD DUMMY was specified for the value does not represent a time later than the time
MODBLKS. after the last beginning checkpoint on the log. If you
supply a STOPTIME, ensure that the value specified
System action: The Stage 1 pre-parser fails with a does not occur before the end of the checkpoint being
return code 8. processed.
Programmer response: Ensure that the Module: DFSURCL0
MODBLKSHLQ= control statement is specified with the
CONTROL DD statement.
DFS3999W A STOP TIME WAS SUPPLIED WHICH
Module: DFSURST0 EXCEEDS THE TIME RANGE IN THE
LOG.
DFS3996E ONLY ONE SPECIFICATION OF STOP TIME: stop time TIME ON LAST
CHKPTID IS ALLOWED RECORD: record time
Explanation: The system found multiple values for the Explanation: A value for the STOPTIME keyword was
CHKPTID= keyword in the CONTROL data set. supplied in the CONTROL data set. The stop time
value exceeded the latest time stamp on the last
System action: The utility fails with a return code 8. processed log record. This situation might be valid;
Programmer response: Supply a single specification of however, it might indicate that the concatenation of log
the CHKPTID= keyword and resubmit the job. data sets in DD SYSUT1 is incomplete.
Module: DFSURCL0 System action: The Create RDDS from Log Records
utility (DFSURCL0) continues processing. It terminates
successfully with a return code 4.
DFS3997E CHECKPOINT ID checkpoint id NOT
FOUND IN THE LOG. THE RDDS Programmer response: Ensure that all of the log data
DATA SET WAS NOT WRITTEN sets you want are included in the SYSUT1 DD
concatenation.
Explanation: The checkpoint ID checkpoint id, specified
Module: DFSURCL0
Programmer response: This message indicates an Programmer response: If multiple log data sets are
internal error in module DFSURCL0. Contact IBM being processed, ensure that the log data sets are
Software Support. concatenated in the proper order. If this message was
issued because of processing an open OLDS, even if the
Module: DFSURCL0 processing was successful, close the OLDS by issuing a
/SWI OLDS command. Then run the utility again to the CONTROL data set. The STOPTIME must be later
avoid the message. than the STARTTIME.
Module: DFSURCL0 System action: The Create RDDS from Log Records
utility (DFSURCL0) fails with a return code 8.
DFS4005E THE DFSKNUC0 ROUTINE IS Programmer response: Correct the specification for
MISSING THE dd_name DD the STARTTIME or STOPTIME= keyword and resubmit
STATEMENT the job.
Explanation: The JCL specified for the DFSKNUC0 Module: DFSURCL0
routine, invoked by utility DFSURCM0, was missing
the indicated DD KS statement. Possible values for
DFS4010W UNABLE TO CREATE function ITASK,
dd_name are:
DFSCWU RETURN CODE=nnnnnnnn
JOBLIB
STEPLIB Explanation: The tracking subsystem was unable to
SDFSRESL create an IMS task for the function listed in the
message.
System action: The Create RDDS from MODBLKS
utility (DFSURCM0) fails with a return code 8. System action: The tracking subsystem continues
processing without the function listed.
Programmer response: Ensure that you have a
JOBLIB, STEPLIB or SDFSRESL DD statement specified Operator response: This is likely an internal IMS
in the JCL, and that a valid data set is specified. problem. Contact IBM Software Support.
Module: DFSKMOD0 Module: DFSLRARI, DFSLRASC, DFSLRCAS,
DFSLRCS0, DFSLRIDS, DFSLROIC, DFSLRRDC,
DFSLRRDR, DFSLRRDS
DFS4006E AN INVALID CHKPTID (chkptid) WAS
SUPPLIED
IT MUST BE OF THE FORMAT: DFS4011I UNABLE TO action POSITION DATA
yyddd/hhmmss SET: dsname
Explanation: The value supplied for the CHKPTID= Explanation: IMS Remote Site Recovery (RSR) is
keyword in the CONTROL data set was invalid. The unable to perform the operation indicated by action
value was not of the format yyddd/hhmmss. against the position data set dsname. The action is one of
the following values:
System action: The Create RDDS from Log Records
DEALLOCATE
utility (DFSURCL0) fails with a return code 8.
A tracking IMS experienced an error
Programmer response: Correct the specification for attempting to deallocate the position data set.
the CHKPTID= keyword and resubmit the job. CLOSE A tracking IMS experienced an error
attempting to close the position data set.
Module: DFSURCL0
DELETE
A tracking IMS experienced an error
DFS4007E AN INVALID STARTTIME OR attempting to delete the position data set.
STOPTIME WAS SUPPLIED
System action: If action is DEALLOCATE, make sure
Explanation: The value you supplied for the that the error does not cause an allocate or open error
STARTTIME= or STOPTTIME= keyword in the when the new tracking IMS is started. If action is
CONTROL data set was invalid. CLOSE or DELETE, make sure that the position data
set is removed from storage and the catalog.
System action: The Create RDDS from Log Records
utility (DFSURCL0) fails with a return code 8. Module: DFSLRINS
Operator response: If online forward recovery of a The data set entry is removed from
shadow database or area ended early after this message the RECON and the data set is
is issued, restart the database or area after the gap is deleted. The data is obtained from the
filled. active site automatically by gap
processing.
Related information:
“DFS4013W” nnnnnnnn: Is zero.
System action: The tracking subsystem continues
processing.
Operator response:
If function indicates a BSAM CLOSE error, resolve the
error indicated by the return code. All other functions
are automatically handled by the tracking subsystem. 4 The issuer is not in key 7, supervisor
state.
Module: DFSLRDDE, DFSLRRDD, DFSLRRDH,
8 TMS code cannot be loaded or is at
DFSLRRDR, DFSLRRDX
the wrong level.
C A VTAM SETLOGON request failed.
DFS4015I ERROR ON TRANSPORT MANAGER 10 An MVS LINK macro failed.
FORGET, RETURN CODE=nnnn 10 Unusual VTAM OPEN error. Some of these
failures are caused by VTAM definitional
Explanation: An error was returned from a Transport errors or operational errors.
Manager Subsystem (TMS) FORGET request during 14 At least one parameter value is invalid.
tracking subsystem termination or as a result of a
/STOP SERVGRP command. The return code nnnn can Reason code (hex)
have these values: Description
4 ASCTOK is invalid.
Return code 8 TMSNAME is invalid. Only one name
Description per ASCTOK is allowed.
04 At least one conversation is not completely
deallocated. You have been disconnected from
For more information about the IDENTIFY function
the TMS address space and your VTAM ACB
return codes, see the Transport Manager interface
has been closed, but local storage has not been
functions and return code information.
freed.
08 FORGET already in progress or invalid System action: The tracking subsystem processing
IDTOKEN or double failure during FORGET. continues.
0C An MVS LINK macro failed.
Operator response: Start the transport manager
System action: The tracking subsystem continues subsystem if indicated by the return or reason codes
processing. and issue the /START SERVGRP command.
Module: DFSLRMST If the return or reason codes indicate a VTAM or
tracking subsystem definitional error, correct the error.
DFS4016A SYNCHRONOUS TMS IDENTIFY Module: DFSLRIN1
ERROR, RETURN CODE=nnnn Related reference:
REASON CODE=rrrr
Transport Manager Subsystem interface function
Explanation: An error was returned from the initial
and return codes (Messages and Codes)
IDENTIFY request to the Transport Manager Subsystem
(TMS) during tracking system initialization or as a
result of a /START SERVGRP command. The following DFS4017A ASYNCHRONOUS TMS IDENTIFY
describes the return codes and reason codes: ERROR, REASON CODE=rrrr
Return code (hex) Explanation: An error was returned from the
Description Transport Manager Subsystem (TMS) upon completion
4 The entity name is currently in use or a of the tracking subsystem IDENTIFY request.
reserved name was used.
The reason code rrrr is the TMS status exit return code
8 Resource failure.
displayed in hexadecimal format. For more
Reason code (hex) information, see the Transport Manager interface
Description functions and return code information.
4 Storage shortage.
System action: The tracking subsystem continues
8 VTAM storage shortage.
processing without identifying to TMS and without
C VTAM applid not available.
conversations with the active subsystems.
10 VTAM not available.
14 The TMS instance specified by Operator response: Take action appropriate to the
TMSNAME (or defaulted) not reason code given in the message.
available.
18 Failure during activation. Module: DFSLRIN1
1C Abnormal termination during Related reference:
IDENTIFY processing.
20 Nonzero return code from the MVS Transport Manager Subsystem interface function
RESMGR macro. and return codes (Messages and Codes)
C Environment error.
Reason code (hex)
Description
Reason code
DFS4018I TMS ALLOCATE CONVERSATION
Description
ERROR RETURN CODE=nnnn
00 identify token parameter is invalid
REASON CODE=rrrr
04 buffer parameter is invalid
Explanation: An error was returned from a Transport 08 conversation token parameter is
Manager Subsystem (TMS) ALLOCATE conversation invalid
request during tracking subsystem initialization or as a 12 conversation state invalid for
result of a /START SERVGRP command. The following ACCEPT function
describes the return codes and reason codes: 63 Asynchronous error
Reason code The reason code is the TMS status exit return
Description code displayed in hexadecimal format. For
08 Resource failure. more information, see the Transport Manager
interface functions and return code
Reason code
information.
Description
04 Storage shortage System action: If the return code is X'14', the message
0C Conversation token shortage is followed by abnormal termination (abend 0380-03) of
10 The transport manager subsystem is no longer the tracking subsystem. Processing continues normally
available. for all other return codes.
14 At least one parameter value is invalid.
Operator response: For return code X'10', start the
Reason code transport manager subsystem, then issue the /STOP
Description SERVGRP followed by the /START SERVGRP
00 Identify token parameter is invalid command.
04 Buffer parameter is invalid
Module: DFSLRCS0, DFSLRICN
63 Asynchronous error.
Related reference:
The reason code is the TMS status exit return
code displayed in hexadecimal format. For Transport Manager Subsystem interface function
more information, see the Transport Manager and return codes (Messages and Codes)
interface functions and return code
information.
DFS4020I LOG DATA TRANSMISSION TO
System action: For return code X'14', the message is SERVICE GROUP gggggggg
followed by abnormal termination (abend 0380-02) of TEMPORARILY SUSPENDED.
the tracking subsystem. Processing continues normally
Explanation: The attempt to send log data to service
for all other return codes.
group gggggggg failed because of a VTAM buffer
Operator response: For return code X'10', start the shortage for Transport Manager Subsystem (TMS).
transport manager subsystem, then issue the /STOP
System action: Sending of log data to service group
SERVGRP followed by the /START SERVGRP
gggggggg is suspended until the next online log data set
command.
(OLDS) switch.
Module: DFSLRCS0, DFSLRICN
Operator response: Check your VTAM tuning. See the
Related reference: information about VPACING and IOBUF. Issue a
/SWITCH OLDS command to switch the OLDS and
Transport Manager Subsystem interface function
begin again the sending of log data.
and return codes (Messages and Codes)
You can also increase the maximum number of TMS
buffers in the LBUFMAX() parameter of the
DFS4019I TMS ACCEPT CONVERSATION
IMS.PROCLIB member DFSRSRxx.
ERROR RETURN CODE=nnnn
REASON CODE=rrrr Module: DFSFLLRD0
Explanation: An error was returned from a Transport Related concepts:
Manager Subsystem (TMS) ACCEPT conversation
Defining the Transport Manager Subsystem to
request. This list describes the return codes and reason
VTAM (System Definition)
codes:
Return code (hex)
DFS4021I RSR ssssssssss SERVICE FAILED,
Description
SERVICE GROUP gggggggg,
10 TMS was no longer available.
RC=nnnnnnnn, RSN=rrrrrrrr
14 At least one parameter value is invalid:
Explanation: The attempt to use RSR service ssssssssss
referencing service group gggggggg failed with return
code nnnnnnnn and reason code rrrrrrrr. The service is tried to identify to the Transport Manager Subsystem
one of the following values: (TMS), and has received a response to all attempts to
ACCEPT allocate conversations.
issued by module DFSLLRX1 v If the message indicates that /STOP SERVGRP
ALLOCATE processing is complete, it means that a response was
issued by module DFSLLRS0 received for all attempts to deallocate conversations
DEALLOCATE and FORGET has been issued.
issued by module DFSLLRP0 or DFSLLRX1 v If the message indicates COMMAND COMPLETE, it
FORGET means that the processing was initiated by an
issued by module DFSLLRP0 /START or /STOP command. If the message
IDENTIFY indicates INTERNAL COMPLETE, it means that the
issued by module DFSLLRS0 processing was internally generated. /START
SEND issued by module DFSLLRD0 SERVGRP processing is internally generated during
OLDS switch in response to suspended or lost
For more information, see the Transport Manager conversations.
interface functions and return code information.
For a tracking subsystem:
System action: Processing continues.
v If the message indicates that /START SERVGRP
Operator response: If the message indicates that an processing is complete then the tracking subsystem
ALLOCATE or ACCEPT failed with return code of 14 has attempted to identify to TMS. If successful, it
(hexadecimal) and reason code 4. Check that the OLDS attempted to establish a conversation with an
or batch log data set block size. This block size should isolated log sender (ILS) at the active site and is
not be larger than 32708 bytes in an RSR environment. attempting (or has attempted) to establish
Module: DFSFDLS0 conversations with the active subsystems.
DFS4022I ATTEMPT TO OBTAIN SERVICE v If the message indicates that /START ISOLOG
GROUP NAME LIST FAILED, processing is complete then the tracking subsystem
RC=nnnnnnnn. has attempted to establish a conversation with an
isolated log sender at the active site if a conversation
Explanation: Logger module DFSLLRS0 called DBRC was not already established. If a conversation is
to get a list of the service group names in the global established, the tracking subsystem has initiated gap
service group. DBRC returned nonzero return code fill processing for any gaps that were in “waiting”
nnnnnnnn. For these codes, see the DBRC request status.
return code information. v The message at the tracking subsystem always
System action: The attempt to start or refresh RSR indicates COMMAND COMPLETE.
communication by the logger terminates. System action: Processing continues.
Operator response: If you can find and rectify the Module: DFSFDLS0, DFSLRMST
DBRC problem, logger processing can be tried using
the /START SERVGRP command. If not, call IBM
Software Support for assistance. DFS4025I WRITE ERROR DETECTED DURING
TRUNCATION, ATTEMPTING RETRY
Module: DFSFDLS0 FOR: subsystem
Related reference:
Explanation: A write error was detected while writing
DBRC request return codes (Messages and Codes) to all copies of a tracking log data set during log
truncation for an unplanned takeover. The current
truncation process terminates and a new one is initiated
DFS4024I START|STOP SERVGRP|ISOLOG for subsystem subsystem. The log truncation attempt is
PROCESSING attempted only once. If a write error is detected during
(COMMAND|INTERNAL) COMPLETE the log truncation attempt, user abend 0381 occurs with
Explanation: For an active subsystem: subcode X'20'.
v If the message indicates that /START SERVGRP System action: The log truncation process is tried for
processing is complete, it means that the logger the active subsystem tracking logs.
asked for a service group list from DBRC. It then
Module: DFSLRLTS
DFS4026I TRUNCATION POINT FOR subsystem DFS4029I UNEXPECTED RSR STATUS EXIT -
PRIOR TO RESTART IS: lsn TYPE tttttttt, RC=nnnnnnnn,
RSN=rrrrrrrr, SERVICE GROUP
Explanation: If there is an allocation failure during log
gggggggg
truncation, IMS terminates abnormally with code 0381
subcode X'20'. You receive this message after message Explanation: This message was requested by the
DFS2934I during emergency restart after the abend. status exit module, DFSLLRX1. The exit routine is
either not the expected type (ALLOCATE COMPLETE
subsystem is the subsystem name of the active IMS
when ALLOCATE is not in progress for that service
subsystem whose tracking log data sets are undergoing
group, for example) or an expected exit routine gets an
truncation, and lsn is the log sequence number for the
unexpected return code. The values are taken from the
prior truncation point.
status exit area.
System action: An unplanned takeover completes
For more information, see the Transport Manager
with the truncation point listed in message DFS2935I.
interface functions and return code information.
System programmer response: If the truncation point
System action: Processing continues.
given in this message is different from the truncation
point given in message DFS2935I. If the message is not Module: DFSFDLS0
issued for the indicated subsystem, take image copies Related reference:
of all affected databases and areas as soon as possible.
Then start a new active subsystem. Transport Manager Subsystem interface function
and return codes (Messages and Codes)
Module: DFSLRLTS
Related information:
DFS4030A TRUNCATION FAILURE, ARCHIVE
“DFS2935I” on page 585
DATA SET DEFINITION MISSING
IMS abend 0381 Explanation: This message is issued at the start of log
truncation during unplanned takeover processing if the
DFS4027I DATABASE LEVEL TRACKING NOT data set being truncated is an archive SLDS, and no
SUPPORTED BY DC CONTROL ARCHDEF or ARCHDEF keyword is provided in the
TRACKING SYSTEM. CHANGED TO DFSRSRxx member. It is followed by an abnormal
RECOVERY LEVEL TRACKING. termination of the tracking IMS with abend 0381. The
accompanying reason code in register 15 is X'25'.
Explanation: A DCCTL subsystem at the tracking site
was initialized in database level tracking mode. DCCTL System action: The tracking IMS subsystem
does not support database level tracking. abnormally terminates.
System action: The DCCTL subsystem is initialized in Operator response: Perform an emergency restart of
recovery level tracking mode. the tracking IMS with the ARCHDEF and ARCHDEF
keywords defined in the DFSRSRxx member.
System programmer response: No action is required.
Module: DFSLRLTS
Module: DFSRSRI0
| 11.1 The RSR position data set was created by an Related information:
| RSR tracking IMS running at Version 11 “DFS4031A” on page 815
| Release 1 level.
Explanation: A remote site recovery (RSR) tracking System action: If the open error occurs, during
IMS successfully allocated and read from an RSR initialization, on the secondary copy after an error on
position data set during cold-start processing and the primary copy, the tracking IMS subsystem stops
issued message DFS4031A. If this is the correct position cold start processing. If the open error occurs during
data set for the RSR tracking IMS to use, reply Y to the shutdown processing, IMS abends with a 0381 abend
WTOR generated by this message. If this is not the code, and register 14 contains reason code 0003.
correct position data set, reply N and cold start Operator response: Contact the system programmer.
processing will proceed. Be aware that the RSR tracking
IMS will not process any data from RSR active site IMS Programmer response:
subsystems that is created before tracking an IMS cold Resolve the cause of the OPEN error. Before shutting
start. Only log data from new active IMS subsystems is down the tracking IMS, manually delete the position
processed. If you reply with something other than Y or data set that is identified in the message text. If you do
N, messages DFS4031A and DFS4032A are reissued. not delete the position data set, IMS terminates
Cold start processing is suspended until you reply Y or abnormally during shutdown with user abend 0381,
N. reason code 1B, in DFSLRTRM.
System programmer response: Determine if the Module: DFSLRDOP
version and time stamp supplied with message
DFS4031A are valid. If they are, reply Y to the message
WTOR. If they are not, reply N.
Module: DFSLRINS
database buffer, module DFSDT410 checks three v OFR DB AUTH OR OPEN FAILURE
conditions: v USN OUT-OF-SEQUENCE
1. Is the REDO data length (DLOGDLEN) zero or v DMB CONFIGURATION ERROR
negative? v OLR COMPLETION FAILURE
2. Is the REDO offset into the buffer (DLOGDOFF) v MUST-COMPLETE STATUS FAILURE
negative? v MUST-COMPLETE RESET FAILURE
3. Does the combined offset and length exceed the v INACTIVE DATA SET DELETION FAILURE
block size? v SUBSEQUENT OLR TOO EARLY
System action: Stop of the shadow database is
If any of these conditions are true, module DFSDT410
initiated. When all internal activity related to the
issues message DFS40044A with FUNC=X'D3' and
database is suspended, the database is closed or
RC=X'10', takes a SNAP memory dump, and stops the
deallocated as appropriate and a message DFS4055I is
database. REDO data must never have a zero or
issued.
negative length, and it must always point inside the
intended buffer. Operator response:
v If reason is DATA SPACE STORAGE SHORTAGE, change the
In the message text: values specified in the DFSRSRxx PROCLIB member
ff The buffer handler function code for DLIDSIZE. Increase the REDO value, or decrease
nn The buffer handler error reason code the DSSIZE value. The respecified values do not take
ssssssss ssssssss effect until a restart of the tracking subsystem. You
The log sequence number can issue a /START DB or UPDATE DB
yyyydddfhhmmssth START(ACCESS) command when you want the
The PRILOG start time system to recover the database to the current state.
v If reason is OFR NEEDED, database information for the
If the error occurred as a result of z/OS compress or database was skipped when a log was processed due
expand service failure, ff is set to FF to indicate such to the sequence in which log data was processed
failure, while nn is the error code from z/OS from different IMS subsystems. This problem
compress/expand services. occurred because processing of earlier database
System action: Stop of the shadow database is changes for the database had not yet completed. The
initiated. earlier data has now been processed and it is
appropriate to initiate online forward recovery (using
Operator response: Print log records from the tracker /START DB or UPDATE DB START(ACCESS)
subsystem OLDS: type X'67', subrecord type X'FD'. Use command) for each specified database. Restore from
the File Select and Formatting Print program to print an image copy should not be necessary before
these records. The OPTION PRINT control statement must initiating online forward recovery.
specify EXITR=DFSERA30. Contact IBM Software Support
v If reason is ONLINE CHANGE, no user action is required.
if further assistance is required.
v If reason is INVALID ACTIVE LOG DATA, save and verify
After the problem is resolved, issue /START DB or the active subsystem log data to identify and correct
UPDATE DB START(ACCESS) command to initiate the problem. Contact IBM Software Support if
online forward recovery for the specified database. further assistance is required.
Module: DFSDT410 v If reason is USN OUT-OF-SEQUENCE, see the preceding
DFS4152A message for an explanation of the
condition that caused the shadow database to be
DFS4045A DATABASE dbdname STOPPING: reason
stopped.
Explanation: An error has been detected by database v If reason is SUBSEQUENT OLR TOO EARLY, the tracking of
tracking; the specified database is stopped. This database changes for a HALDB online reorganization
message can be preceded by another message that (OLR) started before all of the changes for a previous
identifies the specific error. The reason is one of the OLR were hardened in a restart milestone. This is
following: followed by message DFS4055I. By the time the
v DATA SPACE STORAGE SHORTAGE DFS4055I message is issued to indicate that the
v EARLY END OF OFR process of stopping the partition has been completed,
v OFR NEEDED the updates from all the log records from the
v ONLINE CHANGE previous OLR were hardened. At that time the
v INVALID ACTIVE LOG DATA partition can be started immediately with a /STA DB
v BH ERROR command.
v DBRC DSPNDTRK FAILURE
v DBRC DSPNUSID FAILURE For additional information and appropriate actions for
v DBRC DSPNDOFR FAILURE all other reasons, see the preceding message that
v DB AUTHORIZATION FAILURE identified the error.
v DB OPEN FAILURE
Module: DFSDT180
DFS4049I ACTIVE IMS SERVICE GROUP NAME
NOT DEFINED TO DBRC
DFS4046A UNABLE TO OBTAIN STORAGE IN
Explanation: During start service group processing, no
DL/I DB TRACKING DMB POOL,
active service group was indicated in the list of service
DMB=dbdname
groups returned by DBRC.
Explanation: A data management block (DMB) pool
System action: Start service group processing is
shortage was detected. The system was attempting to
discontinued.
load the DMB block for the requested shadow database
that must be opened for database tracking. The size of Operator response: Ensure that an active service
the DMB pool must be large enough to accommodate group is defined to DBRC for this global service group.
all DMBs that are actively being tracked.
Module: DFSLLRS0
System action: Stop of the shadow database is
initiated.
DFS4050A INVALID DL/I TRACKING DB
Operator response: Obtain the DMB size from the ORGANIZATION, DMB=dbdname
output display from ACBGEN. After the DMB pool size
Explanation: The data management block (DMB)
is increased, restart the tracker subsystem and issue
loaded from ACBLIB is not one that is supported by
/START DB or UPDATE DB START(ACCESS)
remote site recovery tracking. The most likely cause of
command to initiate online forward recovery for the
this error is a mismatch between the DMB on the active
specified database.
and the one on the tracker subsystem.
Module: DFSDT310
Remote site recovery support is provided for DL/I
HDAM, HIDAM, HISAM, PHDAM, PHIDAM, and
DFS4047A UNABLE TO OBTAIN DL/I DB SHISAM databases.
TRACKING DSG STORAGE FOR
System action: Stop of the shadow database is
DMB=dbdname
initiated.
Explanation: The attempt to get space to build a
Operator response: Verify the database organization
“dummy” DSG block for the specified DMB for
for the specified database.
database tracking failed.
Module: DFSDT310
System action: Stop of the shadow database is
initiated.
Operator response: Provide more virtual storage space
in DL/I private above the line. Then issue a /START
DB or UPDATE DB START(ACCESS) command to
initiate online forward recovery for the specified
database.
Module: DFSDT310
System programmer response: The database is database at the RSR tracking subsystem is
being tracked by the RSR tracking subsystem. older than the USID of the most recently
The attempted activity is not allowed. received image copy.
For nn=23 System action: Authorization for the requested
Explanation: An attempt was made to update activity is denied.
a recovery-level tracking database on an RSR
System programmer response: Receive an
tracking subsystem.
image copy with a USID that is older than the
System action: Authorization for the requested one for the current image copy, or retry the
activity is denied. activity after a USID has been processed by
the RSR tracking subsystem that is equal to or
System programmer response: Recovery-level
later than the received image copy.
tracking for the databases cannot be updated.
Change the tracking status for the database to For nn=29
database-level tracking, receive an image copy Explanation: On an RSR tracking subsystem,
of the database, and recover the database by one or more required tracking database data
issuing the /START command. sets have not been received.
For nn=24 System action: Authorization for the requested
Explanation: On an RSR tracking subsystem, activity is denied.
log data is missing from the RSR active site
System programmer response: Receive an
that contains update records for the database.
image copy for the database and retry the
System action: Authorization for the requested activity.
activity is denied.
Module: DFSDT310
Programmer response: Wait for the missing
log data to be received from the RSR active
DFS4053A DBRC END TRACK FAILURE ON
site. Perform the activity again after ensuring
DATABASE dbdname RC=nn LSN=llllllll
that all active site log data is available at the
llllllll PRI=yyyydddfhhmmssth
tracking site.
Explanation: The attempt to notify DBRC that the
You can determine if gaps exist by issuing the
specified database has been taken offline by the active
/DISPLAY TRACKING STATUS command
subsystem (for example /DBR) failed.
and examining the GAPS section of the
output. In the message text:
dbdname
For nn=26
The database for which notification to DBRC
Explanation: On an RSR tracking subsystem,
failed.
records from an earlier update set ID were
nn The DBRC reason code, which indicates that
received from the RSR active site but were not
an internal error was detected when log router
applied to the database.
invoked DBRC. For additional information, see
System action: Authorization for the requested the DBRC return code information.
activity is denied. llllllll llllllll
The log sequence number.
System programmer response: If data is
yyyydddfhhmmssth
missing from the earlier update set ID, it is
The PRILOG start time.
automatically recovered from the RSR active
site. After the log data is recovered, retry the System action: Stop of the shadow database is
failed activity. initiated.
For nn=27 Operator response: Call IBM Software Support for
Explanation: In an RSR environment, assistance.
authorization was requested for a database
Module: DFSDT300
that was not registered in the requester's
global service group (GSG). Related reference:
System action: Authorization for the requested DBRC request return codes (Messages and Codes)
activity is denied.
System programmer response: Register the DFS4054A END-TRACKING FAILURE ON
database with the requester's GSG. DATABASE dbdname RC=nn
For nn=28 Explanation: The attempt to notify DBRC when the
Explanation: The update set ID (USID) for the specified shadow database becomes unavailable (for
instance of ILS supporting the particular global service v VTAM STORAGE SHORTAGE
group, issue the TMS START ILS(gsgname) command. v VTAM APPLID NOT AVAILABLE
v VTAM NOT AVAILABLE
Module: DFSIL110
v TMS INSTANCE NOT AVAILABLE
v FAILURE DURING ACTIVATION
DFS4067A ILS FOR GSG gsg ABENDED. v ABEND DURING IDENTIFY
CODE=sss uuu REASON=reason v USER NOT KEY 7/SUP STATE
v T.M. CODE NOT ACCESSIBLE / WRONG LEVEL
Explanation: An instance of the IMS isolated log v SETLOGON REQUEST FAILURE
sender (ILS) has abended. gsg is the global service v LINK TO ELXUIID0 FAILED
group (GSG) name, identifying the instance of ILS. sss v ASCTOK IS INVALID
is the system abend code, hexadecimal format. uuu is v TMSNAME IS INVALID
the user abend code, hexadecimal format. reason is the v REFER TO VTAM ACBERFLG VALUES
reason code, decimal format.
System action: The instance of ILS is stopped.
System action: See message DFS4066I.
Operator response: Correct the problem and issue the
Operator response: If this problem is a system abend, TMS START ILS(gsgname) command.
code X'AC6' (decimal 2758), see message DFS4068A.
Otherwise resolve the problem causing the abend and Module: DFSIL300
issue a Transport Manager Subsystem (TMS) START
ILS(gsgname) command.
DFS4070A ILS: TMS IDENTIFY ASYNCH
Module: DFSIL110 FAILURE error
Related information: Explanation: An IMS isolated log sender (ILS)
“DFS4066I” on page 824 identification request to the transport manager
“DFS4068A” subsystem (TMS) failed to complete without error. The
transport manager subsystem reason code is shown in
decimal format by error. This problem usually indicates
DFS4068A DBRC (SUPPORTING ILS) ABENDED. that a VTAM SETLOGON failed. Transport manager
CODE=sss uuu REASON=reason subsystem messages can provide more information.
Explanation: The copy of DBRC required for the IMS System action: The instance of ILS is stopped.
isolated log sender (ILS) has terminated abnormally. sss
is the system abend code, hexadecimal format. uuu is Operator response: Correct the problem and issue the
the user abend code, hexadecimal format. reason is the transport manager subsystem START ILS(gsgname)
reason code, decimal format. command.
v DBRC ERROR. A DBRC internal error was detected. Other possibilities are resource shortages and logic
v LOGIC ERROR. ILS parameters were invalid. errors.
v ONLY 1 SG. Only a single service group (SG) name
System action: The conversation is not allocated.
is defined to DBRC for this global service group. ILS
requires a local and a remote SG to be defined. Operator response: If VTAM or Transport Manager
v NO LOCAL SG. A service group name with the Subsystem (TMS) is not terminating and if this is the
“local” attribute (the name to be used for this initial conversation with the tracking system, then
instance of ILS) is not defined to DBRC for this contact with the tracking system must be initiated from
global service group. the tracking system or the instance of ILS must be
v NO REMOTE SG. A service group name without the stopped and started.
“local” attribute (the name to be used by the tracking
system to be served by this instance of ILS) is not If VTAM or TMS is not terminating and if this is a
defined to DBRC for this global service group. subsequent conversation allocation (not the first),
operator action is not required because retry will be
System action: If reason is LOGIC ERROR, the instance of attempted the next time an additional data set is
ILS terminates abnormally. Otherwise it just terminates. available for transport.
Operator response: Add the correct information to Module: DFSIL330
DBRC (RECON) or use the correct GSG name, then
issue Transport Manager Subsystem (TMS) START
ILS(gsgname) command. DFS4075A ILS FOR GSG.SG gsg.sg"SNO" ERROR
FROM SEND. R15=xx R0=yy
Module: DFSIL300
Explanation: The IMS isolated log sender (ILS)
encountered an unexpected error when attempting to
DFS4073A ILS FOR GSG gsg RECEIVED send to a tracking system using ELXSEND. The global
ALLOCATE FROM type"sg sys inst comp" service group (GSG) and service group of the tracking
system is identified by gsg.sg. The return and reason
Explanation: The IMS isolated log send (ILS)
codes returned by ELXSEND are identified by xx and
component received what it considers to be an invalid
yy.
request for a conversation. The global service group
(GSG) being supported is identified by gsg. type System action: An internal ILS restart is triggered that
specifies: deallocates all conversations. IT then cleans up state
v INVALID COMPONENT. Indicates that the information and attempts to begin anew by allocating a
component name is not acceptable. conversation with the tracking system.
v UNKNOWN SG. Indicating that the specified service
group was not known to the DBRC (RECON) being Operator response: Pursue the problem through the
used by ILS when ILS was started. service process.
Module: DFSIL350, DFSIL330
"sg sys inst comp" is the four part transport manager
subsystem name of the requestor.
DFS4076A ILS FOR GSG.SG gsg.sg INVALID MSG
System action: The conversation request is rejected by RECEIVED: xx
deallocating the conversation.
Explanation: The IMS isolated log sender (ILS)
Operator response: Investigate a possible user received a message it does not understand. The global
definition error. service group (GSG) and service group of the tracking
system is identified by gsg.sg. The first portion of the
Module: DFSIL400
message, in hexadecimal format, is identified by xx.
System action: An internal ILS restart is triggered that
DFS4074W ILS FOR GSG.SG gsg.sg ALLOCATION
deallocates all conversations. It then cleans up the state
FAILED. R15=xx R0=yy
information, and attempts to begin anew by allocating
Explanation: The IMS isolated log sender (ILS) a conversation with the tracking system.
encountered an error when attempting to allocate a
Operator response: Pursue the problem through the
conversation with a tracking system using ELXALOC.
service process.
The global service group (GSG) and service group of
the tracking system is identified by gsg.sg. The return Module: DFSIL330
and reason codes returned by ELXALOC are identified
by xx and yy.
The most likely reasons are that VTAM or the Transport
Manager Subsystem (TMS) is in the process of
termination, which causes ILS to terminate as well.
format. Allocation information comes from the DBRC data is unavailable at the tracking site.
RECON data sets.
System action: Transport of this particular log data is
System action: If dual copies of the log data set are terminated.
available (known to DBRC) and a failure has not
action of DELAYED RETRY indicates that the tracking
occurred on the other copy, allocation of the other copy
system requests this data again when it next performs
is attempted.
its periodic checks for unknown IMS systems. The try
Operator response: If this message is not followed by is attempted because the error has potential to be a
a DFS4087A message, isolated log send operation is transient error (such as, data set in use by another job).
continuing, but examine the cause of the allocation
action of REPAIR REQUIRED indicates that the tracking
error for potential operational problems or lost or
system does not attempt to obtain this log data until it
damaged log data sets.
processes a /START ISOLOG command. The error
Module: DFSIL510 appears to be such that operations, system
Related reference: programming, or database administrator action is
required to make the log data accessible to ILS.
Interpreting Error Reason Codes from DYNALLOC
Operator response: Follow procedures to get
operations, system programming, or database
administration involved in diagnosing and correcting
DFS4086W ILS type ERROR FOR DSN=dsn the problem. Use information from DFS4086W,
DFS4087A and messages from other z/OS components
Explanation: The IMS isolated log send (ILS)
to diagnose the specific problem.
component was unable to allocate or open a data set.
type is either OPEN or ALLOCATION; dsn is the data Prompt action is of particular importance if the action
set name for which the error occurred. For an of REPAIR REQUIRED is in the message. Correct the
ALLOCATION error, this message provides the data set problem and issue the /START ISOLOG command on
name associated with a DYNALLOC error described by the tracking IMS system.
message DFS4085W. For an OPEN error, there might be
If action of DELAYED RETRY is in the message, action
console messages from other system components that
might be required to make the automatic try successful.
provide further information.
In any case, the identify reason for the data sets
System action: If dual copies of the log data set are unavailability, and take action to prevent future
available (known to DBRC) and a failure has not occurrences.
occurred on the other copy, allocation of the other copy
Module: DFSIL500
is attempted.
Related information:
Operator response: If this message is not followed by
“DFS4086W”
a DFS4087A message, isolated log send operation is
continuing, but examine the cause of the error for
potential operational problems or lost or damaged log DFS4088A INVALID BDW IN LOG AT
data sets. bbbbbbbbDSN=dsn
Module: DFSIL50 Explanation: The IMS isolated log send (ILS)
Related information: component detected an invalid block descriptor word
(BDW) while reading a log data set. The length
“DFS4085W” on page 827
indicated for the block is either too large or too small.
“DFS4087A”
In the message text,
LOG WAS DELETED batch or utility IMS log data set. If the previous
The PRILOG record for the log data set that contents of the data set had been copied before reuse,
contained the requested data was previously this operation was not recorded in DBRC at the time
deleted from RECON. ILS requested log information from DBRC. There is a
LOG WAS COMPRESSED small time window between when ILS obtains data set
The data set entry for the data set that information from DBRC and when it reads the data set.
contained the requested log data was
System action: Use of this data set as a source for
previously deleted from RECON by PRILOG
transport of this particular log data is terminated.
compression.
Operator response: Issue a /START ISOLOG
Additional information is provided by message command on the IMS tracking subsystem to initiate a
DFS4097I. retry operation. If this error recurs, then the problem is
not due to a timing window and a serious condition
System action: The tracking system is informed that
exists which requires user analysis and recovery actions
the requested log data is unavailable.
since log data required by the tracking site is
Operator response: Initiate problem determination: unavailable.
the tracking system apparently needs log data for
Use the DBRC LIST command to determine the
which the active system has no (or no longer) a record.
IMS-execution-to-log data set relationships recorded in
Gather information from DBRC messages, tracking
the RECON. Use z/OS system logs and job logs to
system messages and displays, and active and tracking
determine what happened to the log data set and
DBRC RECON lists. It might be that recent database
where the original contents, as required by the tracking
image copies are needed at the tracking site to
subsystem, can be found. If the original log contents
eliminate the need for old log data.
can be found, and the data set in error was a batch log
Module: DFSIL310 or the first data set of the IMS execution, correct
Related information: RECON such that the proper data set is referenced.
Then issue a /START ISOLOG command on the IMS
“DFS4097I” tracking subsystem to initiate a retry operation.
If the log data has been lost, or the data set in error
DFS4097I INFO REQUESTED: was not a batch log and not the first data set of the
h-timestamph-tokenh-flsnh-llsn IMS execution, new database image copies must be
Explanation: This message is additional information received from the active site to eliminate the need for
associated with message DFS4096A that describes the old log data at the tracking site.
log data requested by the tracking subsystem. Once recovery has completed, evaluate the operational
h-timestamp is (in hexadecimal format) the PRILOG time procedures and change to prevent recurrence of this
stamp. h-token is (in hexadecimal format) the PRILOG problem.
token. h-flsn is (in hexadecimal format) the log
sequence number of the first record requested. h-llsn is Module: DFSIL350
(in hexadecimal format) the log sequence number of
the last record requested.
DFS4099A DBRC QUERY TRACKING LOG DATA
System action: See message DFS4096A. SETS ERROR, RC=nnnn
Operator response: See message DFS4096A. Explanation:
Module: DFSIL310 The tracking subsystem received an unsuccessful return
Related information: code from DBRC on the query tracking log gap
descriptions. nnnn is the DBRC reason code. For
“DFS4096A” on page 830 additional information about return codes from query
tracking log gap descriptors, see the DBRC return code
DFS4098A UNEXPECTED DATA IN LOG DSN dsn. information.
EXPECTED dbrc-ts. FOUND log-ts System action: If the error occurred during tracking
Explanation: The IMS isolated log sender (ILS) found subsystem restart, the tracking subsystem terminates
that a log data set contained data for an IMS execution abnormally with abend 0380-22. Otherwise, the tracking
different than the IMS execution recorded in the DBRC subsystem isolated log transport function is shut down.
RECON data sets for this log. dbrc-ts is (in hexadecimal Operator response: See the DBRC message that was
format) the log data set time stamp recorded with issued to resolve the DBRC error. Then issue the /STA
DBRC. log-ts is (in hexadecimal format) the time stamp ISOLOG command to resume isolated log transport
the log data set currently has. dsn specifies the data set processing.
name in which the error was detected.
Module: DFSLRIGP, DFSLRINI
The most likely cause of this error is the reuse of a
TAKEOVER, RC=nnnn
DFS4101A NO ACTIVE SERVICE GROUP
DEFINED Explanation: The tracking subsystem received an error
return code from DBRC on a takeover request. nnnn is
Explanation: The tracking subsystem is unable to find
the DBRC reason code. If the error return code is 8 and
a definition of any active service group.
no abend results, an active IMS terminated abnormally
System action: Tracking subsystem initialization and the tracking IMS did not receive the log data sets
continues. from the restart (if online) or backout (if batch) before
processing the planned takeover request. For
Operator response: Shut down the tracking subsystem
information about the return codes from RSR Takeover
and define the active service group to DBRC. Restart
Request (both planned and unplanned), see the DBRC
the tracking subsystem.
return code information.
Module: DFSLRIN1
System action: The tracking subsystem might
terminate abnormally with abend code 0380-17 or
DFS4102A NO TRACKING SERVICE GROUP 0381-23. If the tracking subsystem does not terminate
DEFINED abnormally and the abnormally terminated IMS was
restarted or backout was run, its log data sets is
Explanation: The tracking subsystem is unable to find received by the tracking subsystem if the isolated log
a definition of the tracking service group. sender is running at the active site.
System action: Tracking subsystem initialization Operator response: If an abend occurred, see the
continues. explanation for the abend that was issued.
Operator response: Shut down the tracking subsystem System programmer response: If an abend did not
and define the tracking service group to DBRC. Restart occur, and if the active IMS is an online IMS that was
the tracking subsystem. not restarted, restart the IMS. Then shutdown normally
Module: DFSLRIN1 before the planned takeover can continue. If an abend
did not occur and if the active IMS is a batch job and
backout was not run, run a backout before the planned
DFS4103I INVALID ISOLATED LOG SENDER takeover can continue. If backout is not possible, the
MESSAGE RECEIVED subsystem record must be removed from the tracking
Explanation: A Remote Site Recovery (RSR) IMS at the site RECON before the planned takeover can continue.
remote site received a message from the isolated log Planned takeover can be initiated by issuing a
sender (ILS) at the active site. The message indicated /CHECKPOINT FREEZE command to the tracking IMS
that the ILS and the remote IMS have different release after the subsystem record is removed from the
levels. tracking site RECON. If the subsystem record is not
System action: The conversation is terminated. removed, an abend 0380-17 or 0381-23 might occur, or
the tracking IMS might shut down without processing
System programmer response: Make sure that the ILS the planned takeover.
and the Transport Manager Subsystem (TMS) at the
active site are at the same release level as the remote Module: DFSLRAST, DFSLRCAS, DFSLRMST,
IMS. More than one TMS might be running at the DFSLRTK0, DFSLRTRM
active site. Related reference:
If at least one ILS is at the same release as the remote DBRC request return codes (Messages and Codes)
IMS, use the STOP ILS(gsgname) command to stop the
ILS components on the TMS that are not at the same
release level. Make sure that you start ILS on the DFS4105A DB START FAILED: reason
appropriate TMS with the START ILS(gsgname) Explanation: A /START DB, UPDATE DB
command. START(ACCESS), /START DATAGROUP, or UPDATE
Module: DFSLRIRX, DFSLRREX, DFSLRSTX DATAGRP START(ACCESS) command on a remote site
recovery tracking subsystem failed; no databases or
areas are started as a result of the command. reason is
DFS4104A DBRC ERROR DURING REMOTE one of the following:
06 The database must be changed to database Operator response: Contact IBM service to resolve the
level tracking before it can be started. problem.
07 Run the Change Accumulation Utility to
Module: DFSLRARI
accumulate the log recorded at this site while
it was an active site. Recover the database
using the Database Recovery Utility with the DFS4112A CANNOT QUERY DBRC FOR SLDS
Change Accumulation utility as input. Start LIST TO ARCHIVE, RC = retcode
the database.
51 None. Explanation: The tracking subsystem received an
52 None. unsuccessful return code from DBRC on the query
53 Perform one of the following actions: tracking logs for automatic archive request.
v Resume the tracking of changes to the Reason code
HALDB partition and to the other stopped Explanation
partitions of the HALDB master by issuing
the UPDATE DB START(ACCESS) or 2C DBRC internal error.
/START DATABASE command for the 30 IMS internal error.
HALDB master.
v Resume the tracking of changes to this System action: This automatic archive request is not
partition, but not to the other partitions in processed. The automatic archive processor will be
the HALDB master: available for the next archive request.
1. Issue the UPDATE DB STOP(ACCESS) Operator response: Contact IBM service to resolve the
or /DBR DATABASE command for all of problem.
the HALDB master shadow partitions
that are not stopped. Module: DFSLRARC, DFSLRARR
2. Issue the UPDATE DB START(ACCESS)
or /START DATABASE command for
DFS4113I CANNOT READ THE SHADOW SLDS
the HALDB master.
FOR AUTOMATIC ARCHIVE
Module: DFSDT190
Explanation: The tracking subsystem read attempt
detected an I/O error, or the tracking SLDS does not
DFS4109I AUTOMATIC ARCHIVE NOT have a stop time in DBRC.
AVAILABLE - INITIALIZATION
System action: This automatic archive request is not
FAILED
processed. The tracking SLDS is closed and any archive
Explanation: The RSR tracking subsystem experienced data sets are deleted. Automatic archive processing
an internal error while trying to initialize automatic continues.
archive for tracking logs.
Operator response: No action is required.
System action: IMS does not automatically archive the
Module: DFSLRARP
tracking logs.
Operator response: You must manage archiving of the
DFS4114A TRANSPORT MANAGER IS NOT
tracking logs. Contact IBM service to resolve the
ACTIVE
problem.
Explanation: The tracking subsystem is unable to
Module: DFSLRARC
identify to the transport manager subsystem because
the Transport Manager Subsystem (TMS) instance
DFS4111I AUTOMATIC ARCHIVE FAILED - specified to the tracking subsystem is not available.
REASON CODE = reason
System action: The TMS continues processing, but
Explanation: The RSR tracking subsystem experienced conversations with the active site are not be
an internal error while trying to automatically archive a established.
tracking log.
Operator response: Start the TMS for the tracking site.
Reason code If a TMS has been started, check that the INSTANCE
Explanation name specified by the TMS SET APPLID command
05 Unable to obtain storage. matches the TMINAME specified to the tracking
06 Unable to create control structure. subsystem in the system definition or DFSRSRxx
07 Unable to obtain buffer storage. PROCLIB member.
08 Unable to initiate output processing.
Module: DFSLRIN1
System action: Automatic archiving continues until
multiple archive attempts fail.
Module: DFSLRINI
archiving tracking log data sets which should have fit System action: The utility fails with a return code 8.
in the archive log data sets, then the DFSRSRxx auto
Programmer response: Correct the specification for
archive parameters need to be changed to ensure a
the IMSID= keyword and resubmit the job.
successful fit. The tracking subsystem must then be
shutdown and restarted. The /START TRKAUTOARCH Module: DFSURCL0, DFSURCM0, DFSURCP0
command will not be needed.
Module: DFSLRARC DFS4140E NULL VALUES ARE NOT ALLOWED
IN UTILITY utility name FOR
KEYWORD keyword.
DFS4135I START TRKAUTOARCH COMMAND
INVALID Explanation: The indicated keyword was supplied in
the CONTROL or SYSIN data set without an associated
Explanation: Automatic archiving of tracking log data
value. A value for this keyword must be supplied.
sets cannot be started because automatic archive
operation was not stopped. The /START In the message text:
TRKAUTOARCH command is not processed. utility name
The name of the utility that encountered the
System action: Processing continues.
problem
Operator response: The /START TRKAUTOARCH keyword The keyword that is missing a value
command is only valid after a DFS4134I message has
System action: The indicated utility fails with return
been issued. If automatic archiving is not occurring,
code 8.
determine whether the correct parameters were
specified in the DFSRSRxx PROCLIB member. Programmer response: Supply a value for the
indicated keyword and resubmit the job.
Module: DFSLRARC
Module: DFSURCL0, DFSURCM0, DFSURCP0
DFS4136I START TRKAUTOARCH COMMAND
COMPLETED DFS4141E A NUMERIC VALUE EXCEEDING 7
CHARACTERS WAS SUPPLIED TO
Explanation: Automatic archiving of tracking log data
UTILITY utility name FOR KEYWORD
sets has been resumed.
keyword.
Module: DFSLRARC
Explanation: The numeric value that you supplied in
the CONTROL or SYSIN data set for the indicated
DFS4138E utility name UTILITY RDDSIN keyword exceeded 7 characters. The maximum number
SPECIFIES AN INVALID RDDS. of numeric characters allowable is 7.
Explanation: The data set specified by the RDDSIN In the message text:
DD statement is invalid. It might be invalid for one of utility name
the following reasons: The name of the utility that encountered the
v The data set may not be an RDDS. problem
v The data set may be an RDDS, but a status of GOOD keyword The keyword that exceeded 7 characters
was not contained in the header record.
System action: The indicated utility fails with return
System action: The indicated utility fails with return code 8.
code 8.
Programmer response: Supply a valid value for the
Programmer response: Specify a valid RDDS for the indicated keyword and resubmit the job.
RDDSIN DD statement.
Module: DFSURCL0, DFSURCM0, DFSURCP0
Module: DFSURCP0
DFS4142E YOU SUPPLIED NON-NUMERIC
DFS4139E IMSID IS MISSING OR INVALID. DATA TO UTILITY utility name FOR
imsid WAS SPECIFIED. KEYWORD keyword.
Explanation: The value supplied for the IMSID= Explanation: The value that you supplied in the
keyword in the CONTROL data set was missing or was CONTROL or SYSIN data set for the indicated
invalid. The value for IMSID must be a string keyword was non-numeric; however, the keyword
containing 1 to 4 characters. requires a numeric value to be supplied.
Utilities DFSURCL0 and DFSURCP0 do not require this In the message text:
keyword. This error situation is triggered only in these utility name
two utilities if the value is incorrectly specified. This The name of the utility that encountered the
keyword is required by utility DFSURCM0. problem
Module: DFSURCL0, DFSURCM0, DFSURCP0 System action: Update sequence number (USN)
checking is suspended, but database tracking continues.
DFS4143E AN EMPTY INPUT FILE TO UTILITY Operator response: Ensure that additional virtual
DFSKJOB0 WAS FOUND; CHECK storage is provided to the IMS tracking system when
THAT IMS SYSTEM STAGE 1 FAILED the system is restarted.
Explanation: The file referenced by the INFILE DD Module: DFSDT210, DFSDT240, DFSDT250
statement should contain the JCL stream created by a
prior successful run of a IMS System Stage 1; however,
this file is empty. It might be invalid for one of the
following reasons:
v The IMS System Stage 1 step did not complete
successfully.
v The INFILE DD statement for DFSKJOB0 does not
reference the data set containing the output from
IMS System Stage 1.
System action: The utility fails with return code 8.
Programmer response: Ensure that IMS System Stage
1 runs successfully and that the INFILE DD references
the data set containing the output from IMS System
Stage 1.
Module: DFSKJOB0
lsn The log sequence number of the database Module: DFSDT210, DFSDT240
(X'50') log record being applied to the shadow
database.
DFS4153W INCONSISTENT FSE. DB=dbdname
usn The update sequence number (USN) in the DDN=ddname RBA=rba SSID=imsid
database update log record being applied to PRI=pri LSN=lsn
the shadow database.
Explanation: The database tracker discovered that a
System action: Database tracking continues. block about to be written in the shadow database had
one of the following errors involving free space in the
Operator response: If it is unclear whether or not an block:
error exists, contact IBM Software Support for v The free space element anchor point (FSEAP) in a
programming assistance. block pointed to a free space element (FSE) that
Module: DFSDT210, DFSDT240 either was at an odd displacement into the block or
was beyond the end of the block.
v An FSE pointed to an FSE that either was at an odd
DFS4152A SEQUENCE ERROR. DB=dbdname displacement into the block or was beyond the end
SSID=imsid PRI=pri LSN=lsn PREV=prev of the block.
CURR=curr v The length of the free space in an FSE either had an
Explanation: The database tracker determined that a odd value or had a value referring to free space
database update log record was about to be applied out extending beyond the end of the block.
of the expected sequence. The database was not
stopped and restarted. Log records might have been In the message text:
lost or processed out of sequence. dbdname
In the message text: The name of the shadow database.
dbdname ddname The name of the data set that was updated.
The name of the shadow database. rba The RBA (for VSAM) or the RBN (for OSAM)
imsid The IMS system from which the log was of the block that was updated.
routed. imsid The IMS system from which the log was
pri The PRILOG time of the log. routed.
lsn The log sequence number of the database pri The PRILOG time of the log
(X'50') log record being applied to the shadow
database.
lsn The log sequence number of the database System action: Processing continues.
(X'50') log record being applied to the shadow
Module: DFSFDR80
database.
Related information:
System action: IMS writes the block onto the
“DFS4165W”
database, writes a TYPE4930 log record, and continues
database tracking.
DFS4165W FDR FOR (imsid) XCF DETECTED
During a single restart of the tracking system, message
TIMEOUT ON ACTIVE IMS SYSTEM,
DFS4153W appears only once for each shadow
REASON = reason
database. However, there is a TYPE4930 log record for
each block for which the error is detected. Explanation: XCF notified the Fast DB Recovery
region that a timeout occurred on the IMS system
Operator response: Contact IBM Software Support for
identified by imsid. The variable reason is one of the
programming assistance.
following:
Module: DFSDT410
IMS SURV., DIAGINFO = nnnnnnnn
XCF reported the timeout. At least one IMS
DFS4161I FDR FOR (imsid) TRACKING STARTED TASK or ITASK might be in a loop or wait
state in the IMS system. The nnnnnnnn
Explanation: The Fast DB Recovery region is
indicates which TASK or ITASK might have
established and is tracking the IMS system identified
caused the timeout. nnnnnnnn is made of two
by imsid.
parts. The first 2 bytes indicate the TASK or
System action: Processing continues. ITASK getting the timeout, and the second 2
bytes indicate whether another TASK or
Module: DFSFDR10 ITASK might be involved, as shown in the
following table:
DFS4164W FDR FOR (imsid) TIMEOUT DETECTED
Table 22. TASK or ITASK involvement
DURING LOG AND XCF
SURVEILLANCE TASK or ITASK in TASK or ITASK possibly
timeout involved
Explanation: The Fast DB Recovery region detected a
timeout status during log and XCF surveillance. One of Bit 0 x'8000' CTL TCB IMS Control Task
following conditions might have occurred: Bit 1 x'4000' XFP TCB Fast Path Control Task
v The identified IMS system is in a wait.
v The identified IMS system is in a loop. Bit 2 x'2000' CST ITASK Common Services ITASK
v A failure occurred on the z/OS on which the Bit 3 x'1000' CHK ITASK Checkpoint ITASK
identified IMS system is running.
v A failure occurred in the central processing complex Bit 4 x'0800' SAS ITASK DLISAS ITASK
(CPC) on which the identified IMS system is Bit 5 x'0400' FP CST00 Fast Path Common
running. Services ITASK
System action: This message is retained in the Bit 6 x'0200' FP CSTS0 Fast Path Common
operator console. The Fast DB Recovery region Services dependent ITASK
continues tracking. If the Fast DB Recovery region is
Bit 7 x'0100' reserved
able to read a new log record, or if XCF surveillance
detects the IMS system resumed normal processing,
this message is deleted from the console. IMS SURV., DIAGINFO = N/A
XCF detected the timeout. The IMS address
Operator response: If the IMS system is in a wait or
space might be non-dispatchable or the status
loop, cancel IMS, if necessary. If z/OS or the CPC
exit routine might have failed.
failed, reset the system and enter the MVS MODIFY
command (F fdrproc,RECOVER) to initiate database SYSTEM, DIAGINFO = nnnnnnnn
recovery in the Fast DB Recovery region. XCF detected the timeout. The failure or event
was at the z/OS-system level. The nnnnnnnn
Module: DFSFDR90
represents the GEPLFLGS word of the list of
input parameters from the XCF group exit
DFS4165I FDR FOR (imsid) XCF DETECTED routine. The values are documented in z/OS
ACTIVE SYSTEM RESUMED MVS Data Areas, Vol 3 (IVT-RCWK)
(GA22-7583), under macro IXCYGEPL. In
Explanation: XCF notified the Fast DB Recovery addition, you might find this information in
region that the identified IMS system exited timeout the IXCYGEPL macro in SYS1.MACLIB.
status indicated in message DFS4165W and has
resumed normal processing. System action: Processing continues.
If log surveillance also detects a timeout status, v Look for message AVM006E with an rsename that
DFS4164W follows this message. matches the imsid in this message.
Operator response: Check the status of the IMS and v If message AVM006E does not appear, manually stop
z/OS systems. If IMS is in a loop or a wait state, I/O for the IMS system. To do this, manually switch
terminate IMS with the MVS MODIFY command (F DASD or reset the system.
activeims,DUMP) to initiate database recovery in the
Fast DB Recovery region. Then reply UNLOCK in response to this message.
DFS4166I FDR FOR (imsid) DB RECOVERY DFS4169I FDR FOR (imsid) PROCESS
PROCESS STARTED, REASON = TERMINATED
reasonid
Explanation: The Fast DB Recovery region terminated
Explanation: The Fast DB Recovery region stopped because the identified IMS system terminated normally
tracking the identified IMS system and started database or because the MVS MODIFY TERM command (F
recovery for the reason indicated in reasonid, which is fdrproc,TERM) was issued.
one of the following:
System action: The Fast DB Recovery region
IMS FAILURE terminates normally.
An IMS system failure was detected by a X'06'
Module: DFSFDR00
log record. The Fast DB Recovery region
automatically initiated recovery.
DFS4170I FDR FOR (imsid) NORMAL
RECOVER COMMAND
TERMINATION DETECTED FOR
Recovery was initiated by the MVS MODIFY
ACTIVE SYSTEM
command (F fdrproc,RECOVER).
Explanation: The Fast DB Recovery region detected
XCF NOTIFICATION
that the identified IMS system terminated normally.
Recovery was initiated by MVS XCF
notification. System action: The Fast DB Recovery region stops
tracking and terminates normally.
System action: The Fast DB Recovery region started
database recovery. Module: DFSFDR10
Module: DFSFDR00
DFS4171I FDR FOR (imsid) ACTIVE IMS
TERMINATION NOTIFIED BY XCF.
DFS4167A FDR FOR (imsid) WAITING FOR
OPERATION RESUMED.
ACTIVE SYSTEM TO COMPLETE I/O
PREVENTION. REPLY "UNLOCK" Explanation: MVS XCF notified the Fast DB Recovery
WHEN I/O PREVENTION region that the active IMS system terminated. Message
COMPLETES. DFS4167A was issued.
Explanation: The Fast DB Recovery region cannot System action: Message DFS4167A is cleared from the
continue until the identified IMS system completes I/O console and the Fast DB Recovery region resumes
prevention. database recovery.
System action: The Fast DB Recovery region waits for Module: DFSFDR00
the operator's reply. Related information:
Operator response: Make sure that the failing IMS “DFS4167A”
system completed I/O prevention, as follows:
Correct the error and restart the job. Operator response: Specify the correct GROUPNAME
parameter in the DFSFDRxx member of IMS.PROCLIB,
Module: DFSFDR00
or specify the correct suffix of member DFSFDRxx in
the FDRMBR parameter in the Fast DB Recovery
DFS4177E FDR FOR (imsid) XCF JOIN FAILED. procedure. Then restart the Fast DB Recovery region.
Related information:
DFS4183E FDR FOR (imsid) MODIFY cmdname
DFS4181A COMMAND REJECTED. FDR IS IN
INITIALIZATION OR RECOVERY
DFS4181A FDR FOR (imsid) FOR DB RECOVERY, PHASE.
ENTER "RECOV". TO CONTINUE Explanation: The identified MODIFY command was
TRACKING, ENTER "TRACK". rejected because the Fast DB Recovery region was being
Explanation: Database recovery was initiated by the initialized or was already in a recovery process.
MVS MODIFY command (F fdrproc RECOVER). The System action: The Fast DB Recovery region continues
Fast DB Recovery region issued an IDENTIFY its current processing.
RECOVERY request to IRLM to start database recovery,
but the identified IMS system was still running. Module: DFSFDR60
If the correct command was entered for the correct Fast System action: The Fast DB Recovery region is
DB Recovery region, reply RECOVER to the DFS4181A terminated.
message. Operator response: Resolve the problem; then restart
If the command was not correct or was entered for the the Fast DB Recovery region.
wrong region, reply TRACK to the DFS4181A message. Module: DFSFDR10
Module: DFSFDR00 Related reference:
System action: The database data sets that make up Module: DFSRWCA0
the entryname are not added to the recovery list. The Related information:
databases, areas, or both are not recovered by the “DFS4265I”
database recovery service.
System programmer response: Examine the DFS4264I RECOVERY STARTED FOR (options):
/RECOVER ADD command and compare it with the
corresponding ACBGEN or RECON entries. Reissue the Explanation: The /RECOVER START command was
command with the correct entry names. issued and no errors were detected. Database recovery
service processing started for the database data set and
If reason is UNKNOWN REASON FROM DBRC, call areas listed in the subsequent DFS4265I messages.
IBM Software Support for assistance. options specifies parameters on the /RECOVER START
Module: DFSRWCA0 command. If no parameters were specified, the
following default values for the options are listed:
Related information: ERRORCONT
“DFS4289” on page 860 STAGLOBAL
STALOCAL
NOSTA
DFS4262I INVALID RESPONSE FROM DBRC
FOR COMMAND RECOVER ADD,
REASON=reason The message destination is the z/OS system console
and the IMS master terminal (if this is a DB/DC IMS).
Explanation: DBRC returned an invalid response due This message is also sent to the issuer of the command.
to a database recovery service related command. The
message destination is the z/OS system console and System action: /RECOVER START command
the IMS master terminal (if this is a DB/DC IMS). This processing continues.
message is also sent to the issuer of the command. System programmer response: No action is required.
In the message text: Module: DFSRWCS0
reason The reason code returned by DBRC, which is
internal diagnostic information.
DFS4265I name AUTHORIZED BY ssid
System programmer response: This message indicates
an internal IMS error. The command is ignored. Explanation: This message lists the database data set
or area that the database recovery service started a
Problem determination: Set a SLIP TRAP on the error recovery for. Either DFS4263I or DFS4264I follows this
message, and call IBM Software Support for assistance. message. The message destination is the z/OS system
Module: DFSRWCR0, DFSRWCD0, DFSRWCP0, console and the IMS master terminal (if this is a
DFSRWCA0 DB/DC IMS). This message is also sent to the issuer of
the command.
In the message text:
name Indicates the database data set name (dbname
ddname) or area name for recovery.
ssid If the database data set or area is authorized area failed because a point-in-time
by an IMS, ssid identifies the authorizing ssid. (PITR) recovery was performed
This message is issued for each IMS that earlier and no image copy was taken
authorized a database data set or area in the afterward. Because backout
recovery list. information may have been deleted
from the RECON due to the prior
System action: /RECOVER command processing
PITR recovery, a new recovery may
continues.
result in a corrupted database.
System programmer response: No action is required. NO PRILOG FOUND
DBRC was unable to locate a PRILOG
Module: DFSRWCA0, DFSRWCS0, DFSRWCR0, record. This condition should not
DFSRWCP0 occur. Call IBM Software Support for
assistance.
DFS4266I UNABLE TO RECOVER: dbname, reason NO RECOV RECORD FOUND
The USEDBDS option was specified
Explanation: A database recovery service /RECOVER on the /RECOVER ADD command,
START command was issued, but the database data set but the latest recovery recorded in
or area cannot be recovered. The message destination is RECON was not for a time stamp
the z/OS system console and the IMS master terminal recovery, or the DBDS or AREA is
(if this is a DB/DC IMS). This message is also sent to marked in RECON as needing
the issuer of the command. recovery.
In the message text: NOT FOUND
dbname Identifies the database data set or area that One or more of the database data sets
could not be recovered. or areas in the recovery list is not
reason Indicates the cause of the error and is one of listed in the RECON data set.
the following:
AUTHORIZATION FAILED, RC = XX If the database data set or area has
Authorization processing failed to been removed from the system in
properly authorize one or more of the Online Change and no longer needs
database data sets or areas in the to be recovered, use the /RECOVER
recovery list. XX identifies the DBRC REMOVE command to remove the
return code. data set or area from the recovery list.
HALDB MASTER IS STOPPED If the database data set or area has
The master database for a HALDB been removed from the system in
partition has been stopped. Although Online Change and now must be
the database recovery service requires recovered, use Online Change to add
that the partitions being recovered be it back to the system; then re-issue
stopped, the master database must be the /RECOVER START command.
started. Start the master database, and NOT OFFLINE
then reissue the /RECOVER START One or more of the database data sets
command. or areas in the recovery list was not
IMAGE COPY NOT AVAILABLE taken offline with an IMS /DBR
DBRC was unable to locate a usable command. When the database is in
image copy for the database data set. this state, proper operation of the
INVALID RCVTIME database recovery service cannot be
DBRC determined that the RCVTIME guaranteed.
specified falls in the middle of an RECOV RECORD UNUSABLE
ALLOC for this entry, and the PITR The USEDBDS option was specified
option was not specified. on the /RECOVER ADD command,
LOGS MARKED IN ERROR but the DBDS or AREA has been
DBRC determined that none of the updated or reorganized since the
log data sets are usable. They may be latest recovery recorded in the
marked in error. RECON.
NEEDS HIGHER RELEASE LOG REORG LATER THAN IMAGE COPY
DBRC detected logs created by a The REORG utility ran against the
higher release IMS. The database database data set but there is no
cannot be selected if it was updated subsequent image copy data set
by an IMS operating at a higher registered in the RECON.
release. System action: If ERRORCONT was specified for the
NO IC TAKEN AFTER A PITR database data set or area, processing continues for the
Recovery for the database data set or
was specified, it is automatically started in the IMS DATABASE command. Report this failure to IBM
issuing the message. Software Support.
System programmer response: No action is required. Module: DFSRWME0
Module: DFSRWME0
DFS4282A ERROR PROCESSING PROCLIB
MEMBER DFSORSXX: error
DFS4278I UNABLE TO COMPLETE RECOVERY
FOR: dbdname ddname Explanation: An error was detected while processing
the IMS PROCLIB member DFSORSxx. One or more
Explanation: The database recovery service is unable
DFS4282A messages might be issued, depending on the
to complete recovery for the DBDS or AREA specified
number of errors detected. The /RECOVER command
dbdname and ddname. This can be a result of a DBDS or
that was processing fails.
AREA failure that occurred during recovery, or failure
to restore the Image Copy for the DBDS or AREA. In the message text, error is one of the following
problems:
The message destination is the z/OS system console
FAILURE PARSING, IKJPARS RC = rc
and the IMS master terminal (if this is a DB/DC IMS).
The TSO IKJPARS service detected an error in
This message is also sent to the issuer of the command.
the parameters specified in the DFSORSxx
System action: None. member. IKJPARS returned the code shown as
rc.
System programmer response: Determine the cause of PARAMETER IN ERROR: yyyy
the failure and rerun recovery when corrected. An invalid value was detected on a parameter
Module: DFSRWME0 in DFSORSxx. The incorrect parameter is
indicated by yyyy.
TSO ENVIRONMENT IS NOT AVAILABLE
DFS4279I THE FOLLOWING ENTRIES ARE The TSO environment was not available. As a
AUTHORIZED TO AN IMS: result, the DFSORSxx member could not be
Explanation: The database recovery service detected processed.
full function database data sets, Fast Path areas, or both UNABLE TO DELETE STORAGE, IMODULE RC =
during recovery to any time-stamp recovery that might rc The DFSORSxx member parsing module,
need to be recovered. The database data sets and areas DFSRWPP0, was unable to free working
being recovered are updated by units of recovery that storage it had obtained to process the member.
also update the ones identified in subsequent DFS4265I IMODULE GETMAIN returned the code
messages. shown as rc. For information about IMODULE
return codes, see the IMS system services
The message destination is the z/OS system console return code information.
and the IMS master terminal (if this is a DB/DC IMS). UNABLE TO OBTAIN STORAGE, IMODULE RC =
This message is also sent to the issuer of the command. rc The DFSORSxx member parsing module,
System action: None. DFSRWPP0, was unable to obtain the storage
necessary to process the member. IMODULE
System programmer response: Determine if the GETMAIN returned the code shown as rc. For
database data sets, areas, or both listed in subsequent information about IMODULE return codes, see
DFS4265I messages need to be recovered to the same the IMS system services return code
point in time as the recovery that caused this message. information.
Module: DFSRWPR0 System action: The /RECOVER command that was
Related information: processing fails.
“DFS4265I” on page 852 Operator response: Take the appropriate action for the
error you received:
FAILURE PARSING, IKJPARS RC = rc
DFS4280I UNABLE TO START type FOR THE
From the messages in the SYSTSPRT data set,
RECOVERY LIST token, RC=return code
determine the parameters in error in the
Explanation: The database recovery service is unable DFSORSxx member. Correct the parameters
to start the areas or databases, indicated by type, and reissue the /RECOVER command.
associated with the recovery token The message PARAMETER IN ERROR: yyyy
destination is the z/OS system console. Correct the parameters indicated in DFSORSxx
and reissue the /RECOVER command.
System action: The areas or databases are recovered
TSO ENVIRONMENT IS NOT AVAILABLE
but not started.
Ensure that the TSO environment is available
System programmer response: Issue the /START and resubmit the job.
AREA, UPDATE AREA START(ACCESS) or /START
UNABLE TO DELETE STORAGE, IMODULE RC = /RECOVER ADD command, then issue /RECOVER
rc Make note of the message and IMODULE START, or issue /RECOVER START with the
return code and report the problem to IBM NOCHECK parameter specified.
Software Support. No immediate corrective
action is required; however, this message
DFS4285I END OF RECOVERY FOR: token
might be a sign of an internal logic error
within IMS or problem with (IMS or z/OS) Explanation: The Online Recovery Service issues this
storage management. message when all recovery processing for the current
UNABLE TO OBTAIN STORAGE, IMODULE RC = recovery completes. token represents the recovery list
rc Determine the reason for IMODULE token specified on the /RECOVER START command
GETMAIN failure based on the reason code. If which initiated this recovery.
the problem is due to fragmented storage, you
might need to issue an z/OS IPL. The message destination is the z/OS system console
and the IMS master terminal (if this is a DB/DC IMS).
Module: DFSRWPP0 This message is also sent to the issuer of the command.
Related reference: System action: Processing continues.
Checking return codes from the Parse Service Module: DFSRWME0
Routine
IMS system services return codes (Messages and DFS4286I DATABASE RECOVERY SERVICE IS
Codes) BEING TERMINATED
Explanation:
DFS4283I EARLY END OF RECOVERY FOR: token
A /RECOVER TERMINATE command was issued, and
Explanation: The database recovery service is ending the database recovery service is being removed from
early due to a failure that was encountered during the the system.
recovery. This error occurs if ERRORABORT was
System action:
specified on the /RECOVER START command and a
DBDS or AREA failure occurred during recovery, or the The database recovery service resources are released by
image copy for the DBDS or AREA failure to restore. IMS.
The message destination is the z/OS system console System programmer response: No action is required.
and the IMS master terminal (if this is a DB/DC IMS).
This message is also sent to the LTERM that issued the Module: DFSRVM00
/RECOVER START command.
System action: None. DFS4287I DATABASE RECOVERY SERVICE HAS
TERMINATED
System programmer response: Determine the cause of
the failure, correct it, then rerun the recovery. Explanation:
Module: DFSRVM00
DFS4299I xxxx
Explanation: A message was issued by the IMS Online
Recovery Service ORS. The 'message-id' and
'message-text' are documented in the IMS Online
Recovery Service for z/OS, User's Guide (SC27-0944).
System action: The system response is documented in
the IMS Online Recovery Service for z/OS, User's Guide.
Operator response: (master terminal) Take the
appropriate action identified for the 'message-id' in the
IMS Online Recovery Service for z/OS, User's Guide.
User response: Take the appropriate action identified
for the 'message-id' in the IMS Online Recovery Service
for z/OS, User's Guide.
Module: DFSRWPR0
Explanation: DBRC was called from DFSKARC0, but User response: Select one keyword or the other and
the processing did not complete successfully. submit the job.
Module: DFSKSUM0
System action: Processing terminates with condition System action: Processing continues.
code of 8. User response: No action is required.
User response: Specify a value for the keyword and Module: DFSKARC0
resubmit the job.
Module: DFSKARC0
range for which log data set names are available, and
DFS4314E STRTTIME CANNOT BE LATER THAN
resubmit the utility.
STOPTIME
Module: DFSKARC0
Explanation: Values were specified in control
statements for STRTTIME and STOPTIME, but the time
stamp specified for STOPTIME is earlier than that for DFS4321I ACTIVE OLDS DATA SET: data set name
STRTTIME. WAS NOT INCLUDED IN THE
SELECTED DATA SETS
System action: Processing terminates with condition
code of 8. Explanation: The Online Log Data Sets (OLDS) were
selected for processing by the RECON Query of Log
User response: Correct the STRTTIME and STOPTIME
Data Set Names utility. You specified the
keyword values and resubmit the job.
NOACTIVEOLDS control statement to exclude the
Module: DFSKARC0, DFSKSUM0 active OLDS from the list of data set names extracted
by the utility.
DFS4315E RECOVERY TOKEN BOUNDARIES In the message text:
WERE SELECTED, BUT NO TOKEN data set name
WAS SUPPLIED The name of the active OLDS that was
excluded from the list
Explanation: The Log Summary utility (DFSKSUM0)
was invoked with the TOKENBND keyword, which System action: The RECON Query of Log Data Set
indicates that the utility should restrict log processing Names utility continues processing.
to the period during when a token was active.
Operator response: No action is required.
However, no TOKEN= keyword was supplied to
indicate this processing period. Module: DFSKARC0
System action: Processing terminates with condition
code of 8. | DFS4342E IMODULE INIT FAILED; RC=xx
User response: Take one of the following actions:
| RSN=yyyyyyyy
v Specify a token with the TOKEN= control statement | Explanation: An error occurred during the
keyword. | initialization of the IMS IMODULE service. IMS
v Remove the TOKENBND control statement keyword. | initialization cannot continue.
Module: DFSKSUM0 | In the message text:
| xx A return code that indicates the specific
DFS4320E SOME LOG DATA SET NAMES ARE
| initialization function that failed. Possible
UNAVAILABLE BECAUSE THEY WERE
| values are:
CHANGED BY DBRC PRILOG
| 04 Unable to load the IMS storage
RECORD COMPRESSION. THE LOG
| management module DFSMODU0.
DATA SET NAMES WERE NOT
| The reason code is a combination of
EXTRACTED.
| the two values that are returned from
| the z/OS LOAD macro. The top half
Explanation: DBRC PRILOG record compression | of the reason code is the abend code
replaced the data set name for sets of log data sets with | that the z/OS LOAD service would
the character string DSN=**** COMPRESSED DATA SET | have issued if it had been called
**** in the RECON data sets for the time range | unconditionally. The lower half of the
specified for processing by utility DFSKARC0. Because | reason code is the reason code that is
the data set names are no longer present in RECON, | associated with the abend code. For
DFSKARC0 is not able to extract them. | example, 08060004 means system
| abend 806, reason code 04.
System action: Processing continues.
| 08 Unable to obtain storage for the
If a range of log data set names are found within the | IMODSTAT block (the internal IMS
time range specified for processing by DFSKARC0 that | storage manager main control block).
have not been subject to DBRC PRILOG record | The reason code is the return code
compression, an indication of this subset of time ranges | from the z/OS STORAGE macro.
is included in the summary report generated by | 0C Unable to obtain storage for the
DFSKARC0. At end of processing, a condition code of 8 | internal IMODULE trace table. The
is returned. | reason code is the return code from
| the z/OS STORAGE macro.
Programmer response: Supply STRTTIME and | 10 Unable to obtain storage for the
STOPTIME control statements to restrict the utility to a | dynamic storage for the IMODULE
| service initialization module
| DFSMODX0. The reason code is the | about the abend code and the reason code
| return code from the z/OS STORAGE | from LOAD, see z/OS MVS System Codes
| macro. | (SA22-7626).
| 14 Unable to obtain storage for the 64-bit
| storage tracking object for private
| System action: IMS terminates abnormally with abend
| storage. The reason code is the return
| 0684.
| code from the z/OS IARV64 macro. | System programmer response: If the error described
| 18 Unable to obtain storage for the 64-bit | in this message is caused by environmental conditions,
| tracking object for common storage. | such as insufficient storage or module missing from
| The reason code is the return code | IMS.SDFSRESL, correct the problem. Then, restart the
| from the z/OS IARV64 macro. | address space. Otherwise, save ay memory dump and
| 1C Unable to load the IMS storage | SYSLOG information and contact IBM Software
| cleanup module DFSMODU2. The | Support.
| reason code is a combination of the
| two values that are returned from the | Module: DFSMODX0
| z/OS LOAD macro. The top half of | Related reference:
| the reason code is the abend code
| that the z/OS LOAD service would | IARV64 Macro Return and Reason Codes
| have issued if it had been called | STORAGE OBTAIN Return and Reason Codes
| unconditionally. The lower half of the
| reason code is the return code that is | z/OS MVS System Codes
| associated with the abend code. For | Related information:
| example, 08060004 means system
| abend 806, reason 04. | IMS abend 0684
| 20 Unable to obtain storage for a work
| area for the IMS storage cleanup
| routine DFSMODU2. The reason code | DFS4343E IMS STORAGE CLEANUPABEND
| is the return code from the z/OS | abend_code PSW=psw RSN=rsn
| STORAGE macro. | modname=module_address
| 24 A DL/I separate address space | Explanation: An abnormal termination occurred in
| (DLISAS) region attempted to | IMS storage cleanup processing during IMS
| initialize IMS IMODULE services; | termination.
| however, the associated IMS control
| region was not running with DLISAS | In the message text:
| and did not allocate an IMODULE | abend_code
| IMODASCT block for DL/I. This | The abend code that was received; Sxxx for a
| error can be caused by erroneously | system abend, Uxxxx for a user abend.
| starting a DL/I address space directly, | psw The PSW (program status word) content at the
| outside of IMS system's control, when | time of the termination.
| the associated control region is a | rsn The abend reason code, if any; N/A if there is
| DCCTL IMS or is running with | none.
| LSO=Y (no DL/I). | modname
| 28 A DLISAS region attempted to | The name of the IMS cleanup module that
| initialize IMS IMODULE services; | detected the termination. This module might
| however, another DL/I region had | not be the one in which the termination
| already initialized IMODULE services | occurred.
| for the same control region. This error | module_address
| can be caused by erroneously starting | The address of the module identified with
| a second DL/I address space directly, | modname.
| outside of IMS system's control, when | System action: When an abnormal termination occurs
| there is already a DL/I address space | during IMS storage cleanup, the storage cleanup
| started for the same IMS control | recovery routine receives control from z/OS. The
| region. | recovery routine analyzes the abend, takes appropriate
| yyyyyyyy | action, and gathers diagnostic data. The recovery
| A reason code that is the return code of the | routine will take an SDUMP for the first abend that
| service that failed. For IARV64 return codes, | occurs during processing. If possible, the recovery
| see z/OS MVS Programming: Authorized | routine will recover from the termination and return
| Assembler Services Reference Vol 2 (SA22-7610). | control to the storage cleanup routine to continue
| For codes from STORAGE, see z/OS MVS | releasing storage.
| Programming: Authorized Assembler Services
| Reference Vol 4 (SA22-7612). For information | For abends after the first, the recovery routine will
Explanation: The OTMA XCF message count has System action: Processing stops. IMS ceases creating
reached 50% of the maximum limit. OTMA has tpipes and issues this message.
considered this condition as a relieve condition and System programmer response: An OTMA tpipe
issued this informational message. overflow has occurred in this IMS. OTMA stops
System action: Processing continues. An OTMA creating new tpipes. Issue a checkpoint three times to
protocol message with the OK status is sent to the clean the idle tpipes. The system can then continue to
OTMA client. create new tpipes.
DFS4382W THE TOTAL OTMA TPIPE COUNT | Explanation: OTMA detected that the number of
nnnnn HAS REACHED 80% OF mmmmm | transaction pipes (tpipes) has fallen below xx
for MEMBER name | percentage of the maximum limit indicated by
| mmmmm, which you set in the descriptor file. OTMA
Explanation: OTMA detected that the number of | issues this relief message for each OTMA client.
transaction pipes (tpipe) has reached or exceeded 80%
of the maximum number mmmmm, which you set in In the message text:
nnnnn The current number of tpipes flood condition as a global warning for all the OTMA
| xx The relief level of the maximum limit. This clients.
| relief level can be set in the OTMA client
System action: Processing continues. An OTMA
| descriptor. The default is 50.
protocol message with the warning status is sent to all
mmmmm
OTMA clients.
The limit number of tpipes you set for this
member System programmer response: An OTMA message
name The name of the member flood has occurred in this IMS. Reroute the new
transaction requests to a different IMS.
System action: The system continues to create tpipes.
Module: DFSYFD00
System programmer response: No action is required.
Module: DFSYFD00
Operator response: A problem exists with the retrieval Operator response: If you want to use the signon
or update of the resource in RM that is associated with value from the local IMS, shut down all IMS systems.
the failed parameter. This command, and other Restart the local IMS first with the correct signon
commands, might continue to fail with the parameter specification.
in error until the resource problem is corrected. Module: DFSIRAC0
Module: DFSICLC0, DFSICLE0, DFSICLJ0, DFSICLN0,
DFSICLP0, DFSICL50, DFSICL60, DFSICL70, DFSIC440, DFS4450I RESOURCE STRUCTURE
DFSIC450, DFSIDPB0, DFSIDPE0, DFSIDP10, REPOPULATION
DFSIDP40, DFSIDP70, DFSIDP80, DFSOCM30, STARTING|COMPLETE
DFSRMCL0, DFSRMSR0, DFSRMS00
Explanation: In an IMSplex environment, IMS
Related concepts:
received a structure repopulate directive from the
Issue CSL RM requests to manage global resources Resource Manager. IMS is either starting or has
(System Programming APIs) completed repopulating the resource structure with all
locally known resources.
initialization. If you reply with CANCEL, IMS terminates cleaned properly, or contact IBM Software Support.
abnormally with user abend 3308.
Module: DFSRMCL0
System action: IMS waits until a response to the
WTOR is entered.
DFS4456A RESOURCE STRUCTURE FAILED
Operator response: Determine the status of the system
Explanation: IMS received a “resource structure
that is performing the cleanup; that system should
failed” directive from the Resource Manager.
issue message DFS4452I when it completes. After
message DFS4452I is issued, enter RETRY. If the system System action: Limited online processing can
cannot complete the cleanup, terminate the system, continue, but terminal and user resource status cannot
which permits the initializing IMS to restart. be committed until the resource structure becomes
available. Until then, no new terminals or users can
Module: DFSRMCL0
access IMS, and terminals or user access might hang
Related information: (including during IMS shutdown).
IMS abend 3308 Operator response: Determine and correct the
problem with the resource structure.
DFS4455E RESOURCE CLEANUP ERROR FOR Module: DFSRMSR0
xxxx, RC=yy
Explanation: An error occurred while resources were DFS4457E RM REGISTRATION FAILED,
being cleaned up or messages unlocked for a NAME=xxxxxxxx
terminating or initializing IMS system.
Explanation: IMS attempted to register to a Resource
In the message text: Manager (RM) in the IMSplex, but the registration was
xxxx The IMS ID of the terminating or initializing rejected. Message DFS3308E is also issued with the
system error return and reason codes.
yy The reason code for the error. The following
list provides the reason codes and their In the message text, xxxxxxxx is the name of the
meanings. Resource Manager for which registration failed.
Module: DFSUOLC0
DFS4503A INVALID IMSID ON SYSIN RECORD
Explanation: An IMSID specified in a SYSIN record is
DFS4506A OLC IN PROGRESS. CANNOT
invalid. The IMSID must start in column 1, be 1-4
ACCESS OLCSTAT
characters in length, contain alphanumeric characters,
and contain blanks in the rest of the record. Explanation: The Global Online Change utility
(DFSUOLC0) failed to initialize the OLCSTAT dataset
System action: The Global Online Change Utility fails.
because a global online change is in progress. Global
Operator response: Correct the IMSID and run the online change locks the OLCSTAT data set so that
DFSUOLC0 utility again. nothing else can update it while it is being changed.
Module: DFSUOLC0 System action: The Global Online Change Utility fails.
Operator response: Wait for the global online change
DFS4504A INVALID PARAMETER xxxx=yyyy to complete or terminate the global online change,
before running the Global Online Change utility.
Explanation: Global Online Change utility
(DFSUOLC0) encountered an error in the input Module: DFSUOLC0
parameter.
In the message text: DFS4507A SYSPRINT OPEN FAILED
xxxx The keyword for which the parameter is
Explanation: The Global Online Change utility
invalid. It can be one of the following:
(DFSUOLC0) encountered an error in opening the
FUNC
OLCSTAT data set.
ACBS
MDBS System action: The DFSUOLC0 utility terminates with
FMTS a return code of 4.
MDID
PLEX User response: This problem is likely the result of a
VERS JCL error. Check that your DD statements for the data
yyyy The parameter. set are defined correctly. Correct the problem and rerun
the utility.
System action: The system does not perform any
validity checking on the SYSIN records as the input Module: DFSUOLC0
parameters are not valid. The DFSUOLC0 utility
terminates with a return code of 4. DFS4508A FUNC=UNL, NO LOCK HELD
User response: Correct the error parameter and retry Explanation: The Global Online Change utility
the utility function. (DFSUOLC0) could not unlock the OLCSTAT data set
Module: DFSUOLC0 because the data set is not locked with the lock word
OLCINP.
DFS4505A DUPLICATE IMSID ON SYSIN System action: The DFSUOLC0 utility terminates with
RECORD a return code of 4.
Explanation: You specified an IMSID more than once User response: The UNLOCK function is not required
in the SYSIN records. You can specify a particular because the OLCSTAT data set is not locked. An online
IMSID only once in a SYSIN record. Multiple IMSIDs change in progress might have completed and
are supported in the SYSIN records, but they must all unlocked the OLCSTAT data set.
be different names. You should continue processing with the next
System action: The global online change utility DFSUOLC0 action that you want to take.
DFSUOLC0 fails. Module: DFSUOLC0
Operator response: Delete the duplicate IMSID or
correct the name. Then run the DFSUOLC0 utility DFS4509A FUNC=ADD, IMSID ALREADY IN
again. OLCSTAT, SYSIN RECORD
reached this limit, IMS issues this error. | tttttttt The user exit type. If this field is USRXINIT,
| the error is from user exit initialization
In the message text:
| services and not related to an individual user
nnnnn The global TPIPE warning threshold, which is | exit routine. In this case, mmmmmmmm is
the MAXTP limit specified for DFSOTMA in | blank. If this field is USRXRFSH, the error is
the OTMA client descriptor. | during REFRESH USEREXIT command
| processing and not related to a particular user
System action: IMS rejects any subsequent TPIPE | exit type.
creation requests from OTMA clients and IMS | mmmmmmmm
applications. The /DISPLAY OTMA command will | The name of the user exit routine or the
display MAX TPIPE for the USER-STATUS of the OTMA | control block for which the error occurred.
server. | rrrrrrrrrrrrrrrrr
Programmer response: Issue the /DISPLAY OTMA | The reason the user exit setup failed. This can
command to view the TPCNT value, which is the total | be one of the following strings:
TPIPEs in use, and the MAXTP value, which is the | BCB RELEASE ERROR
TPIPE limit specified in the OTMA client descriptor. | Storage for the USXI or USXS control
You can issue the IMS /CHECKPOINT command three | blocks could not be released by BCB
times to force the tpipe cleanup so that idle tpipes in | services.
the system can be deleted. | BCB GET ERROR
| Storage for the USXI or USXS control
Module: DFSYFD00 | blocks could not be obtained from
| BCB services.
DFS4517I THE GLOBAL OTMA TPIPE COUNT | BLDL ERROR
HAS DECREASED BELOW xx% OF | BLDL failed for the indicated module
THE GLOBAL LIMIT OF nnnnn. | name. If RC=04, the specified module
| could not be found.
Explanation: OTMA detected that the total number of | IMOD FREE ERROR
transaction pipes (tpipes) for all the OTMA members | Storage for the indicated module
has fallen below xx% of the monitoring point indicated | could not be released using
by the MAXTP value of the DFSOTMA descriptor | IMODULE FREE.
entry. | IMOD GETM ERROR
In the message text: | Storage for the indicated module
| could not be obtained using
xx The relief level, which is specified through the | IMODULE GETMAIN.
MAXTP parameter for DFSOTMA in the | IMOD GETS ERROR
OTMA client descriptor. | Storage for the indicated module
| could not be obtained using
nnnnn The global TPIPE warning threshold, which is
| IMODULE GETSTOR.
the MAXTP limit specified in the DFSOTMA
| LOAD ERROR
member of the OTMA client descriptor.
| LOAD failed for the indicated module
System action: The system continues to create tpipes. | name.
| NO EXITDEF STMT
System programmer response: No action is required.
| No EXITDEF statement in the
Module: DFSYFD00 | DFSDFxxx member for the specified
| exit type.
| PARSE ERROR
DFS4570E USER EXIT LOAD FAILURE. EXIT | An error was encountered while
TYPE - tttttttt MODULE NAME - | parsing the DFSDFxxx member. If the
mmmmmmmm IMODULE LOAD RC - rr | error was a parse error (as opposed to
| an error in the parsing service),
or | BPE003E messages give more
| information on the error.
| USER EXIT SETUP FAILED. EXIT TYPE - tttttttt | PDS READ ERROR
| MODULE NAME - mmmmmmm REASON - | An error was encountered while
| rrrrrrrrrrrrrrrrr RC - rr | reading the DFSDFxxx member. The
| Explanation: | MODULE NAME field indicates the
| member that was read.
| IMS was unable to load a user exit routine. The exit | STOR OBTN ERROR
| routine name is defined in the USER_EXITS section of | Storage for the indicated module
| the DFSDFxxx member. | could not be obtained using
| In the message text:
| STORAGE.
| rr The return code issued by the services that are | System action: IMS continues processing.
| associated with the reason text of this
| message. If there is no return code from the
| System programmer response: Check the PROCLIB
| service, this field is blank.
| member to ensure that all of the exits that are listed are
| eligible for multi-exit support. Remove any that are not.
| This message is also issued while processing the output | Module: DFSUSRXI
| EXITDEF parameter in the USER_EXITS section of the
| DFSDFxxx member during IMS initialization or during
| the processing of the REFRESH USEREXIT command.
| DFS4573E UNABLE TO CALL USER EXIT TYPE –
| tttttttt FUNCTION - ffffffff REASON -
System action: IMS continues processing. | cccccccccccccccc RC - rr
| System programmer response: | Explanation: IMS was unable to call any exit routines
| of the specified user exit type.
| If the user exit setup failed because of a storage error,
| check that the region size of the address space is large | In the message text:
| enough. Increase the region size by changing the | tttttttt The user exit type.
| REGION= parameter on the IMS control region JCL | ffffffff The function code that was to be passed to the
| and restart IMS. | exit. If here is no function code, this is blank.
| cccccccccccccccc
| If the user exit setup failed because of a BLDL or a
| The reason the exit type could not be called.
| LOAD error, check the PROCLIB member to ensure the
| Possible reasons are:
| exit routine name is correct. If the name is correct in
| IMOD GETM ERROR
| the PROCLIB member, ensure that the load module is
| An IMODULE GETMAIN error was
| available to the control region.
| encountered.
Module: DFSUSRXI, DFSUSX00 | rr The return code from the service that received
Related reference: | an error. If the error does not have a return
| code, this field is blank,
IMODULE return codes (Messages and Codes)
| System action: IMS continues processing.
| System programmer response: If this is a storage
DFS4571E USER EXIT TYPE tttttttt IS NOT A
| shortage, it may be due to the region size of the
VALID USER EXIT TYPE
| address space being too small. Increase the region size
Explanation: The user exit type specified on the | by changing the REGION= parameter on the IMS
EXITDEF statement in the USER_EXITS section of the | control region JCL and restart IMS.
DFSDFxxx member is not a valid user exit type.
| If the problem persists, save any memory dumps and
In the message text: | IMS logs; then contact IBM Software Support. If no
tttttttt The user exit type specified on the EXITDEF | memory dumps were produced, create a console dump
statement | of the IMS control region.
| Problem determination: 1, 2, 3, 4, 25, 36, 41
| This message is also issued while processing the output
| EXITDEF parameter in the USER_EXITS section of the | Module: DFSFSTM0, DFSTRM00
| DFSDFxxx member during IMS initialization or during | Related reference:
| the processing of the REFRESH USEREXIT command.
| IMODULE return codes (Messages and Codes)
System action: IMS continues processing.
| Related information:
System programmer response: Specify a valid user | Chapter 2, “IMS problem determination,” on page 5
exit type on the EXITDEF statement. See the IMS
system definition information for the valid user exit
types. | DFS4574W DUPLICATE USER EXIT ROUTINE
| DEFINED. TYPE- ttttttt MODULE
Module: DFSUSRXI | NAME - mmmmmmmm
| Explanation: A duplicate user exit routine was defined
| DFS4572E USER EXIT TYPE IS NOT ELIGIBLE | in the EXITS parameter of the EXITDEF statement for
| FOR MULTI-EXIT ROUTINE SUPPORT | the indicated user exit type. The exit is only loaded one
| Explanation: The user exit type tttttttt is a valid user | time and is called only one time.
| exit type, but it is not eligible for multi-exit routine | In the message text:
| support. | tttttttt The user exit type
| In the message text: | mmmmmmmm
| tttttttt The user exit type | The user exit module name
DFSD001E Invalid data set specified for panel DFSD004E You must specify at least one function
selection field
Explanation: You attempted to invoke an ISPF panel
Explanation: You specified a data set name as a value that allows the selection of one or more functions to be
on an ISPF panel; however, this data set name was not performed; however, you neglected to indicate which
found in the system catalog. One of the following functions you wanted to perform. The panel displays
might be a reason for why the data set could not be the functions you could chose to perform.
found:
System action: ISPF panel processing awaits
v The data set name might be incorrect.
correction of the error.
v The data set name is correct, but the data set is not
cataloged. System programmer response: Indicate the functions
you want to perform.
System action: ISPF panel processing awaits
correction of the error. Module: REXX program DFSRRDD4
System programmer response: Take one of the
following actions: DFSD005E You must specify UNIT and VOLUME
v If the data set name was incorrect, supply a valid as a set
data set name.
v If the data set is not cataloged, catalog the data set or Explanation: On the Enter Log Data Set Names panel,
supply a different data set that has been cataloged. you selected the step to make a list of log data sets. For
one or more data set entries on the panel, you specified
Module: REXX programs DFSRRDD1, DFSRRDD2, either a unit or a volume, but not both. If you specify
DFSRRDD3, DFSRRDD4 either one, you must also specify the other.
System action: ISPF panel processing awaits
DFSD002E panel field is required for this function correction of the error.
Explanation: You omitted the specification of a value System programmer response: For an uncataloged
on an ISPF panel; however, this value is required by data set, specify both unit and volume.
the function which is being performed. panel field in the
message text identifies the field that requires a value. For a cataloged data set, specify neither unit nor
volume.
System action: ISPF panel processing awaits
correction of the error. Module: REXX program DFSRRD1A
Explanation: On the Create RDDS from Log Records Module: REXX program DFSRRD1
panel, you selected the step to make a list of log data
sets. For one or more data set entries on the panel, you
DFSD010E Member containing logs from RECON
specified a log data set name that was not found in the
is empty
system catalog. One of the following might be a reason:
v The data set name might be incorrect. Explanation: On the Create RDDS from Log Records
v The data set name is correct, but the data set is not panel, you selected to create the resource definition
cataloged. data set (RDDS) from log data set contents. For the
selection of the technique to use creating the list, you
System action: ISPF panel processing awaits
indicated that you have extracted the list of log data
correction of the error.
sets from RECON; however, this list was not found.
System programmer response: Take one of the The PDS member that would contain the extracted data
following actions: set names is empty.
v Supply a valid data set name, if the data set name
System action: ISPF panel processing awaits
was incorrect.
correction of the error.
v If the data set is not cataloged, catalog the data set or
supply a different data set that has been cataloged. System programmer response: On the Create RDDS
from Log Records panel, perform the step to extract the
Module: REXX program DFSRRD1A
list from RECON, and ensure that this step completes
without any panel or runtime errors.
DFSD008E The list of log data sets was not found
Module: REXX program DFSRRD1
Explanation: On the Create RDDS from Log Records
panel, you selected the step to create the resource
DFSD011E The Stage 2 data set was not found
definition data set (RDDS) from log data set contents.
DSN: data set name
For the selection of technique for making the list, you
Select the Create Stage 2 JCL step to
have indicated that you have entered a list of log data
create it
sets; however, this list cannot be found. One of the
following might be a reason: Explanation: On the Create RDDS from SYSGEN
v The PDS member which would contain the data set panel, you selected the step to Create Temporary
name list is missing. MODBLKS. However, the data set indicated in the
v The PDS member which would contain the data set message text by data set name, which should have been
name list is empty created by your prior processing of the Create Stage 2
JCL step, was not found.
System action: ISPF panel processing awaits
correction of the error. System action: ISPF panel processing awaits
correction of the error.
System programmer response: On the Create RDDS
from Log Records panel, perform the step to enter the System programmer response: On the Create RDDS
list of logs and ensure that this step completes without from SYSGEN panel, perform the Create Stage 2 JCL
any panel errors. step. Ensure that it runs successfully. Then retry the
Create Temporary MODBLKS step.
Module: REXX program DFSRRD1
Module: REXX program DFSRRDD2
DFSD009E The list of log data set names extracted
from RECON was not found DFSD012E The MODBLKS data set was not found
DSN: data set name
Explanation: On the Create RDDS from Log Records
Select the Create Temporary MODBLKS
panel, you selected the step to create resource
step to create it
definition data set (RDDS) from log data set contents.
For the selection of technique for making the list, you Explanation: On the Create RDDS from SYSGEN
have indicated that you have extracted the list of log panel, you selected the step to Process Temporary
data sets from RECON; however, this list cannot be MODBLKS. However, the data set indicated in the
found. In this case, the PDS member that would message text by data set name, which should have been
contain the extracted data set names is missing. created by your prior processing of the Create
Temporary MODBLKS step, was not found.
System action: ISPF panel processing awaits
correction of the error. System action: ISPF panel processing awaits
correction of the error.
System programmer response: On the Create RDDS
from Log Records panel, perform the step to extract the System programmer response: On the Create RDDS
list from RECON, and ensure that this step completes from SYSGEN panel, perform the Process Temporary
without any panel or runtime errors. MODBLKS step. Ensure that the step runs successfully,
and then retry the Process Temporary MODBLKS step. Module: REXX program DFSRRDD1
Module: REXX program DFSRRDD2
DFSD016E Full Julian date is required
DFSD013E Data Sets were not found for IMS HLQ: Explanation: On the Create RDDS from log records
ims hlq panel, you specified an invalid value for the Start or
Stop date. The value you specify must be the Julian
Explanation: On the Create RDDS from System
date in the format yyyyddd.
Definition panel, you specified a value for IMS HLQ.
The value specified for this field should represent the System action: ISPF panel processing awaits
high level qualifier that was used by the IMS systems correction of the error.
installer to name your IMS installation data sets used
System programmer response: Specify a valid value
during the sysgen process; for example, hlq.ADFSMAC.
for the Start or Stop date.
However, the system could not find any IMS
installation data sets with this high level qualifier. Module: REXX programs DFSRRDD1, DFSRRD1B
System action: ISPF panel processing awaits
correction of the error. DFSD017E Century is required
System programmer response: Verify with the IMS Explanation: On the Create RDDS from log records
systems installer that the correct value for IMS HLQ is panel, you specified an invalid value for the century in
being used. the Start or Stop date. The value you specify for the
century must be 19 or greater.
Module: REXX program DFSRRDD2
System action: ISPF panel processing awaits
correction of the error.
DFSD014E CHKPTID must contain all numerics
and a slash in position 6 System programmer response: Specify a valid value
for the century in the Start or Stop date.
Explanation: On the Create RDDS from log records
panel, you specified a invalid value for CHKPTID. The Module: REXX programs DFSRRDD1, DFSRRD1B
value specified for this field must exactly match the
checkpoint value used in IMS log records. It must be of
the format yyddd/hhmmss where: yyddd represents the DFSD018E Invalid specification for Day
Julian date and hhmmss represents the time. The / is Explanation: On the Create RDDS from log records
required. panel, you specified an invalid value for the day in the
All of the characters used for the date and time must Start or Stop date. The value you specify for the day
be numeric. must be between 1 and 366.
System action: ISPF panel processing awaits System action: ISPF panel processing awaits
correction of the error. correction of the error.
System programmer response: Ensure that you use System programmer response: Specify a valid value
the correct syntax for CHKPTID. for the day in the Start or Stop date.
DFSD015E CHKPTID must be 12 characters long DFSD019E Stop date/time cannot be before start
date/time
Explanation: On the Create RDDS from log records
panel, you specified a invalid value for CHKPTID. The Explanation: On the Create RDDS from log records
value specified for this field must exactly match the panel, you entered a stop date and time; however, the
checkpoint value used in IMS log records. It must be 12 stop date and time are before the start date and time.
characters long with this format yyddd/hhmmss where: System action: ISPF panel processing awaits
yyddd represents the Julian date and hhmmss represents correction of the error.
the time. The / is required.
System programmer response: Ensure that the stop
All of the characters used for the date and time must date and time is after the start date and time.
be numeric.
Module: REXX program DFSRRD1B
System action: ISPF panel processing awaits
correction of the error.
System programmer response: Ensure that you use
the correct syntax for CHKPTID.
For information about using the IVP, see IMS installation verification program
(IVP) overview (Installation).
unnumbered INPUT PARM parameter IS TOO LONG unnumbered PARAMETER DLTA6 MUST NOT BE
THE SAME AS DLTA1, DLTA2, OR
Explanation: The value of the parameter identified by
DLTA3
keyword parameter is too long. The value of the
parameter must be no longer than 26 characters. Explanation: The DLTA6 parameter cannot have the
parameter can be one of the following values: same value as DLTA1, DLTA2 or DLTA3.
v HLQDL
System action: The IVP Install dialog terminates.
v HLQIPO
v HLQIV Programmer response: Change the parameter to a
v HLQSY unique value then rerun the IVP Install dialog.
System action: The IVP Install dialog terminates. Module: DFSIXC01
Programmer response: Change the parameter value so
that it is no longer than 26 characters and rerun the unnumbered SYSISPF=NOT ACTIVE - THIS CLIST
IVP Install dialog. MUST BE INVOKED FROM WITHIN
ISPF
Module: DFSIXC01
Explanation: The IVP Install dialog was not started
from within ISPF.
unnumbered PARAMETER DLTA1, DLTA2, DLTA3,
DLTA5, DLTA6, or DLTA7 IS TOO System action: The IVP Install dialog terminates.
LONG
Programmer response: Run the IVP Install dialog
Explanation: One or more of the DLTA parameters is from within ISPF.
too long. The parameters must be no longer than 44
characters. Module: DFSIXC01
aaaaaaaa mmmmmmmmmmmmm
Explanation: This is a general sever error message.
The INSTALL/IVP Dialog can only be used by one System action: Processing continues.
user at a time. Someone is currently using IVP.
Programmer response: No action is required.
In the message text:
Module: DFSIXX08, DFSIXX09, DFSIXX10
aaaaaaaa
Identifies the module in which the error
occurred. DFSIX007 aaaaaaaa - PRV ACTION WRAPPED TO
mmmmmmmmmmmmm BOTTOM OF TABLE
Is the error message. If mmmmmmmmmmmmm
is THE INSTALL/IVP DIALOG DOES NOT Explanation: The previous (PRV) action was
SUPPORT MULTIPLE USERS, see message requested, but the top of the table was reached. Instead
DFSIX000 for an explanation. of paging backward to the previous job, task, or
variable, PRV wrapped to the bottom of the table.
System action: IVP stops processing.
In the message text, aaaaaaaa is the module that was
Programmer response: Make sure that IVP is not in running when this message was issued.
use on another ISPF screen. If not, try again later.
System action: Processing continues.
If the problem persists, contact IBM Software Support
for assistance. Programmer response: No action is required.
DFSIX000 (Messages and Codes) Explanation: The change (CHG) action completed
successfully. The changed variables were saved.
DFSIX001 aaaaaaaa ENT ACTION COMPLETE In the message text, aaaaaaaa is the module that was
running when this message was issued.
Explanation: The entry (ENT) action completed. You
are now in ENT mode where one variable displays at a System action: Processing continues.
time with help text. Programmer response: No action is required.
In the message text, aaaaaaaa is the module that was Module: DFSIXX08
running when this message was issued.
System action: Processing continues. DFSIX019 aaaaaaaa - LST ACTION REJECTED -
Programmer response: No action is required. TABLE IS EMPTY
Module: DFSIXX08, DFSIXX09, DFSIXX10 Explanation: The list (LST) action could not be
completed. The program has not switched to LST
mode. An ISPF Table is empty.
DFSIX002 aaaaaaaa LST ACTION COMPLETE
In the message text, aaaaaaaa is the module that was
Explanation: The list (LST) action completed. You are running when this message was issued.
now in LST mode where multiple variables display
without help text. System action: The display switches to entry (ENT)
mode.
In the message text, aaaaaaaa is the module that was
running when this message was issued. Programmer response: You might be able to continue
processing in ENT mode. If problems persist, contact
System action: Processing continues. IBM Software Support to report the problem and for
Programmer response: No action is required. assistance.
DFSIX032 aaaaaaaa - CHG/RFR ACTION FAILED - DFSIX036 aaaaaaaa - BRS ACTION COMPLETE
DEFAULT VALUE NOT FOUND
Explanation: The browse (BRS) action completed
Explanation: The change (CHG) or restore (RFR) successfully. A source member (DFSSLIB or DFSISRC)
action failed. The value of the variable was not has been browsed.
changed, or the value was not changed to the default.
In the message text, aaaaaaaa is the module that was
In the message text, aaaaaaaa is the module that was running when this message was issued.
running when this message was issued.
System action: Processing continues.
System action: Processing continues. The default
Programmer response: No action is required.
value is not restored.
Module: DFSIXX09
Programmer response: Set the variable to the desired
value and continue processing. If problems persist,
contact IBM Software Support for assistance. DFSIX037 aaaaaaaa - EDM ACTION COMPLETE
Module: DFSIXX08 Explanation: The edit (EDM) action completed
successfully. An INSTALIB member has been edited.
DFSIX033 aaaaaaaa - FILE TAILORING PHASE In the message text, aaaaaaaa is the module that was
ENDED FOR ivpenv running when this message was issued.
Explanation: The File Tailoring phase (which resolves System action: Processing continues.
variables before running a job) for the ivpenv
environment completed. Programmer response: No action is required.
DFSIX035 aaaaaaaa - BRM ACTION COMPLETE DFSIX039 aaaaaaaa - ISPF/PDF EDIT RECOVERY
IS NOT SUPPORTED BY INSTALL/IVP
Explanation: The browse (BRM) action completed
successfully. An INSTALIB member has been browsed. Explanation: This message is issued when you edit a
In the message text, aaaaaaaa is the module that was member in IVP. IVP does not support ISPF EDIT
running when this message was issued. recovery. The ISPF EDIT profile recovery settings are
not used by IVP. This message is displayed each time
System action: Processing continues.
you edit a member with IVP to remind you that edit
Programmer response: No action is required. recovery is not supported.
Module: DFSIXX09, DFSIXX10 In the message text, aaaaaaaa is the module that was
running when this message was issued.
System action: Processing continues.
Programmer response: Reissue the command with a System action: The variable vvvvvvvv action field is
valid job or task. set to ERR, which indicates that the variable is invalid.
terminates. You are returned to previous selection System action: The variable vvvvvvvv action field is
panel. set to ERR, which indicates that the variable is invalid.
Programmer response: Contact IBM Software Support Programmer response: Change the vvvvvvvv variable
for assistance. to alphanumeric characters only.
Module: DFSIXX07 Module: DFSIXX11
DFSIX056 aaaaaaaa - vvvvvvvv - PLEASE SPECIFY Y DFSIX059 aaaaaaaa - vvvvvvvv - INVALID LENGTH
(YES), OR N (NO) - MIN/MAX = mnnnn / mxxxx
Explanation: The variable vvvvvvvv must be specified Explanation: The vvvvvvvv variable is not the correct
as Y or N. length. The variable must be between mnnnn and
mnnnn.
In the message text:
aaaaaaaa In the message text:
The module that was running when this aaaaaaaa
message was issued. The module that was running when this
vvvvvvvv message was issued.
The name of the variable that needs to be vvvvvvvv
specified. The name of the variable with an incorrect
length.
System action: The variable vvvvvvvv action field is
mnnnn The maximum allowable length for the
set to ERR, which indicates that the variable is invalid.
vvvvvvvv variable.
Programmer response: Change the vvvvvvvv variable mxxxx The minimum allowable length for the
to either Y or N. vvvvvvvv variable.
DFSIX057 aaaaaaaa - vvvvvvvv - PLEASE SPECIFY Programmer response: Correct the vvvvvvvv so that it
6250, 3480, OR 3490 is between mnnnn and mxxxx.
DFSIX058 aaaaaaaa - vvvvvvvv - MUST BE Programmer response: Change the vvvvvvvv variable
ALPHNUMERIC (A-Z, 0-9) to either JES2 or JES3.
aaaaaaaa
DFSIX064 aaaaaaaa - vvvvvvvv - VALUE RANGE -
The module that was running when this
mnnn M THRU mxxx M
message was issued.
vvvvvvvv Explanation: The variable vvvvvvvv is out of the
The name of the variable that needs a required range. The variable must be within the range
non-blank value specified. of mnnn megabytes to mxxx megabytes.
System action: The variable vvvvvvvv action field is In the message text:
set to ERR, which indicates that the variable is invalid. aaaaaaaa
The program name.
Programmer response: Change the vvvvvvvv variable
vvvvvvvv
to a non-blank value.
The name of the variable that is out of the
Module: DFSIXX11 required range.
mnnn The minimum value to which vvvvvvvv can be
set.
DFSIX062 aaaaaaaa - vvvvvvvv - VALUE MUST BE mxxx The maximum value to which vvvvvvvv can be
OF THE FORM nnnnnnn K OR nnnn M set.
Explanation: The variable vvvvvvvv must be in the System action: The variable vvvvvvvv action field is
form of nnnnnnn kilobytes or nnnn megabytes. set to ERR, which indicates that the variable is invalid.
In the message text: Programmer response: Change the variable vvvvvvvv
aaaaaaaa to a value between mnnn M and mxxx M.
The module that was running when this
message was issued. Module: DFSIXX11
vvvvvvvv
The name of the variable that needs to be
DFSIX065 aaaaaaaa - vvvvvvvv - TOTAL LENGTH
respecified in the correct format.
WILL EXCEED mxxxx BYTES
nnnnnnn
The kilobyte format for vvvvvvvv. Explanation: The total length of the values in the JOB
nnnn The megabyte format for vvvvvvvv. statement accounting information variables exceeds the
maximum allowable size.
System action: The variable vvvvvvvv action field is
set to ERR, which indicates that the variable is invalid. In the message text:
aaaaaaaa
Programmer response: Change the vvvvvvvv variable
The module that was running when this
to the format of nnnnnnn K or nnnn M.
message was issued.
Module: DFSIXX11 vvvvvvvv
The variable that exceeded the size limitation.
mxxxx The maximum number of bytes allowed in the
DFSIX063 aaaaaaaa - vvvvvvvv - VALUE RANGE - accounting field.
mnnn K THROUGH mxxx K
System action: The variable vvvvvvvv action field is
Explanation: The vvvvvvvv variable must be between set to ERR, which indicates that the variable is invalid.
mnnn kilobytes and mxxx kilobytes.
Programmer response: Change the vvvvvvvv variable
In the message text: so that it is at or below mxxxx.
aaaaaaaa
The module that was running when this Module: DFSIXX11
message was issued.
vvvvvvvv
DFSIX066 aaaaaaaa - vvvvvvvv - VALUE CONTAINS
The name of the variable that must be
ILLEGAL CHARACTERS
specified in the proper range.
mnnn The minimum value that can be specified for Explanation: The variable vvvvvvvv contains
the vvvvvvvv variable. characters that are not allowed.
mxxx The maximum value that can be specified for
In the message text:
the vvvvvvvv variable.
aaaaaaaa
System action: The variable vvvvvvvv action field is The module that was running when this
set to ERR, which indicates that the variable is invalid. message was issued.
vvvvvvvv
Programmer response: Change the vvvvvvvv variable
The variable containing illegal characters.
to between mnnn K and mxxx K.
System action: The variable vvvvvvvv action field is
Module: DFSIXX11
set to ERR, which indicates that the variable is invalid.
System action: The IVP Variable Export utility panel is Programmer response: Correct the export data set
displayed with this message. problem, then retry.
Explanation: A required parameter was not specified. Explanation: The VOLID typed by the user is not
valid. The name can be 1 to 6 alphanumeric characters.
System action: The program ends without performing
the desired function. System action: The system prompts the user again
with message DFSIX104.
Programmer response: Reissue the command and
provide the HLQ parameter. The HLQ is the high level System programmer response: Respond to message
qualifier for IMS data sets. DFSIX104. Type a VOLID and press Enter.
Module: DFSDFSRT
Module: DFSWSMBC
DFSI920E Parameter value invalid xxxxxxxxx
Explanation: The parameter at the top of the screen is
DFSI925I Member xxxxxxxx has no new keywords
invalid. xxxxxxxxx is optional and gives more
information. Explanation: User has requested the new keyword
display. There are no new keywords in the member.
System action: None.
System action: None.
System programmer response: Correct the error. Use
F1 (Help key) to view the parameter’s description. System programmer response: No action is required.
Module: DFSWPBVP Module: DFSWMBLD
DFSI921W (C) Copyright IBM Corp. 2002. All DFSI926W Keyword kkkkkk not valid in Release
Rights reserved. rrrrr
Explanation: IMS Syntax Checker copyright statement Explanation: The user has chosen to process the
appears when Syntax Checker is started. PROCLIB member in IMS release rrrrr. The keyword
kkkkkk currently in the member is not valid in release.
System action: None.
System action: None.
System programmer response: No action is required.
System programmer response: Delete the keyword.
Module: DFSWSMBC
Module: DFSWPBKP
DFSI922I Member xxxxxxxx is new or empty. All
parameters are displayed. DFSI927W Keyword kkkkkk is not valid for Control
Region ccccc
Explanation: The member requested is empty. All
possible parameters will be displayed. Explanation: The user has chosen a process the
PROCLIB member in IMS control region ccccc. The
System action: None.
keyword kkkkkk currently in the member is not valid in
System programmer response: No action is required. the control region.
Module: DFSWMBLD System action: None.
System programmer response: Delete the keyword.
DFSI923I No errors found in a parameter value.
Module: DFSWPBKP
Explanation: No errors were found in any parameter
values.
DFSI930I Member xxxxxxxx saved in dsn
System action: Processing continues.
Explanation: The member has been successfully saved
System programmer response: No action is required. in dns.
Module: DFSWMBLD System action: None.
System programmer response: No action is required.
DFSI924I Member xxxxxxxx not currently
Module: DFSWMSAV
processed by Syntax Checker
Explanation: The member xxxxxxxx is not processed
DFSI932I Command cccccc is undefined
by Syntax Checker.
Explanation: The command cccccc on the command
System action: None.
line is not known to Syntax Checker.
System programmer response: To use Syntax Checker
System action: None.
to process a member, the member must be supported
by Syntax Checker. System programmer response: Correct the command.
Module: DFSWSMBM, DFSWUPCR, DFSWUPDM, are underlined in the keyword display panel.
DFSWUPNR, DFSWUPSA, DFSWUPSV
Module: DFSWKOPR
DFSI937I Equal sign in same line comment DFSI999I MEMBER memb PROCESSING
changed to dash CONTINUES
Explanation: The user has entered a same line Explanation: The processing of member memb
comment that contains an equal sign (=). Equal Signs continues following the completion of the processing of
are not allowed in same line comment. It is changed to another member with the P option.
a dash (-). memb Member name.
System programmer response: No action is required. System programmer response: No action is required.
DFSI938I P COMMAND IGNORED. KEYWORD DFSI991I Member name must be entered as part
DOES NOT IDENTIFY A MEMBER. of the DSN
Explanation: The keyword selected with the P Explanation: The member name must be entered as
command does not identify a member of part of the data set name.
IMS.PROCLIB. The P command cannot be processed. System action: None.
System action: The processing of the P command is System programmer response: Enter the member
terminated. name as part of the data set name in TSO format.
System programmer response: Select a keyword that Module: DFSWUPSA
identifies a member of IMS.PROCLIB. Valid keywords
DFSI992I Member must be 1-8 characters DFSI997I Comment not allowed on "blank",
Unknown or keywords without values
Explanation: Member name is invalid. It must be 1-8
characters. Explanation: A comment "C" select code was entered
on the "blank: or unknown keyword. Comments are
System action: None.
not allowed on the keywords.
System programmer response: Correct the member
System action: None.
name.
System programmer response: No action is required.
Module: DFSWUICR, DFSWUIDH, DFSWUIDM,
DFSWUOSA Module: DFSWPBMC
Explanation: The member is in use either by another System action: Informational message.
user or the current user on another ISPF screen. System programmer response: No action is required.
System action: None. Module: DFSWSMBM
System programmer response: No action is required.
Module: DFSWPBMC DFSI999I MEMBER memb PROCESSING
CONTINUES
DFSI995I Change release option cancelled - user Explanation: The processing of member memb
request continues following the completion of the processing of
another member with the P option.
Explanation: The user canceled (F3) the change of memb Member name.
release process.
System action: Informational message.
System action: The previous keyword display panel is
displayed. System programmer response: No action is required.
Module: DFSWSMBM
IMS Version 11 is the last version of IMS that supports the KBLA facility.
DFSK201E rc return code DFSK203E You must select at least one type of log
record
Explanation: An uncorrectable error was encountered
during ISPF panel-driven generation of JCL for the Explanation: The ISPF panel provides an option to
selected operation. select the type of log records you want to process;
however, you did not make a selection.
System action: The ISPF panel processing awaits
correction of the error. System action: ISPF panel processing awaits
correction of the error.
System programmer response: This error is an
internal error. Contact IBM Software Support. System programmer response: Select a log record
type and continue processing.
Module: KBLA Data Entry Panel
Module: KBLA Data Entry Panel
DFSK202I input message
DFSK204E Use KBLA Option 0 - "JOB JCL
Explanation: This message identifies the origin of the
statement" panel to make a JOB JCL
DD statements for the log data sets that are used as
Statement
input to the selected utility.
Explanation: You started the KBLA Define KBLA
In the message text, input message indicates the origin of
Environment panel with a Y on the JOB JCL statement.
the DD statement and can have one of the following
This action created a tailored JOB statement for the
values:
panel user as member DFSKJOBU in data set
Input IMS Log DSN was used
userid.KBLA.SDFSKJCL. However, this member cannot
This message indicates that a single DD
currently be found in the data set.
statement for the log data set is used, and was
taken from the value for the Input IMS Log System action: ISPF panel processing awaits
DSN field on the panel. correction of the error.
Log DSNs were extracted from RECON
System programmer response: Take one of the
This message indicates that the field Log
following actions:
DSNs were Extracted from RECON on the
v Restart Option 0 with a Y in the field JOB JCL
panel contained a Y. The list of log data sets
statement to recreate member DFSKJOBU.
was taken from member DFSKRCN0 in the
v Restart Option 0 with an N in the field JOB JCL
data set userid.KBLA.SDFSKJCL. The member
statement to ensure that further KBLA processing
was created using KBLA Option 5.1
does not attempt to use member DFSKJOBU.
Log DSNs were extracted from PDS MEMBER:
member This message indicates that a name of a Module: KBLA Data Entry Panel
member from the data set
userid.KBLA.SDFSKJCL entered in the field
PDS member Containing Logs on the panel is DFSK205E You have selected mutually exclusive
used. This member contains the list of log data log data set parameters
sets to be processed by the selected utility. The Explanation: An ISPF panel contains various
member was created using KBLA Options 5.2 selections for specifying the log data sets to use. Only
and 5.3. one selection is permitted; however, multiple selections
System action: ISPF panel processing continues. were made.
System programmer response: No action is required. System action: ISPF panel processing awaits
correction of the error.
Module: KBLA Data Entry Panel
System programmer response: Specify only a single
log selection option and continue processing.
DFSK304E Alternate System ID and NODE are DFSK307E A required parameter has been omitted
required to enable output routing
Explanation: A value is required for a field on the
Explanation: On the KBLA Define KBLA panel but was not specified.
Environment panel, you indicated that you wanted to
System action: ISPF panel processing awaits
route output to alternate system. You must specify a
correction of the error.
value for the Alternate system userid/node field to
indicate where the output is to be routed. System programmer response: Specify a value for the
field and continue processing.
System action: ISPF panel processing awaits
correction of the error. Module: KBLA Data Entry Panel
System programmer response: Take one of the
following actions: DFSK308E Mutually exclusive parameters have
v Specify where to route the output in the Alternate been selected
system userid/node field.
v Specify an N in the Route output to alternate system Explanation: An ISPF panel allows for the selection of
field to ensure that no alternative output routine is multiple options which are mutually exclusive. Specify
performed. only one of the parameters.
Module: KBLA Data Entry Panel System action: ISPF panel processing awaits
correction of the error.
DFSK305E An unsupported or invalid IMS level System programmer response: Specify only one of the
was selected options and continue processing.
Explanation: The value you specified on the panel in Module: KBLA Data Entry Panel
the IMS Log Version field does not match an IMS level
for which KBLA support has been provided. DFSK309E A specified dataset was not found
System action: ISPF panel processing awaits Explanation: You specified a data set name as a value
correction of the error. on an ISPF panel; however, this data set name was not
System programmer response: Take one of the found in the system catalog. This message is
following actions: accompanied by a preceding message that indicates the
v Use KBLA Option 0.1 to specify the IMS Log version name of the data set which could not be found.
you want , and to indicate the SDFSRESL data set to One of the following might be a reason why the data
use to process log data sets created under this IMS set could not be found:
version. v The data set name might be incorrect.
v Select an alternate IMS Log Version which has v The data set name is correct, but the data set is not
already been specified on the KBLA Option 0.1 cataloged.
panel. v The data set might be created by another KBLA
Module: KBLA Data Entry Panel function that has not yet completed.
System action: ISPF panel processing awaits
DFSK306E KBLA Option 0.2 must be completed correction of the error.
before attempting Option 0.3 or Option System programmer response: Take one of the
0.4 following actions:
Explanation: You attempted to browse or work on v Supply a valid data set name, if the data set name
data sets that do not exist yet. When you try to view a was incorrect.
work data set list using KBLA Option 0.3 or delete v If the data set is not cataloged, catalog the data set or
work data sets using KBLA option 0.4, you access a supply a different data set that has been cataloged.
data set which is created by KBLA Option 0.2. You v If the data set is created by another KBLA function,
must make sure that you created the work data set ensure that the function has created the data set and
using option 0.2 before attempting to use Option 0.3 or has completed.
0.4. Module: KBLA Data Entry Panel
System action: ISPF panel processing awaits
correction of the error. DFSK401E Dual OLDSs are used. All DD
System programmer response: Use KBLA Option 0.2 statements for dual logs must be used
to create the data set before attempting to process Explanation: On the panel for KBLA Option 1.5, you
Options 0.3 or 0.4. can indicate whether to operate in modes that require
Module: KBLA Data Entry Panel the specification of multiple online log data sets
Explanation: This panel supports multiple processing Module: KBLA Data Entry Panel
modes. You selected a particular mode; you must
supply a log data set name associated with the
DFSK406E Gaps are not allowed in sort parameters
indicated log DDname.
Explanation: On the panel for KBLA Option 5.4, you
In the message text:
can specify up to four sets of sorting parameters,
log DDname
identified by Parm1 through Parm4. Although Parm2
The DD statement associated with the log data
through Parm4 are optional, if any of them are
set name
specified, you must specify the preceding parameters.
System action: ISPF panel processing awaits
System action: ISPF Panel processing awaits
correction of the error.
correction of the error.
System programmer response: Specify a log data set
System programmer response: Ensure that there are
name for the indicated log DDname and continue
no gaps in the specification of the parameter sets and
processing.
continue processing.
Module: KBLA Data Entry Panel
Module: KBLA Data Entry Panel
System action: ISPF panel processing awaits System programmer response: Specify the correct
correction of the error. number of hex characters for the LSN parameter and
continue processing.
System programmer response: Specify a log data set
name for the indicated log DDname and continue Module: KBLA Data Entry Panel
processing.
Module: KBLA Data Entry Panel DFSK415E Start/Stop LSN must be 8 hexadecimal
characters
DFSK411E DBRC=N is not allowed Explanation: You supplied a value on the panel for
the one of the log sequence number (LSN)-related
Explanation: For the option you selected on the ISPF parameters; however, an incorrect number of hex
panel, DBRC processing is required. characters for the parameter was specified.
System action: ISPF panel processing awaits System action: ISPF panel processing awaits
correction of the error. correction of the error.
System programmer response: Specify Y for the DBRC System programmer response: Specify the correct
parameter and continue processing. number of hex characters for the LSN-related
parameters and continue processing.
Module: KBLA Data Entry Panel
Module: KBLA Data Entry Panel
DFSK412E log DDname1 or log DDname2 DD
statements are required for this option DFSK416E RBA must be 8 hexadecimal characters
Explanation: For the option selected on this panel, Explanation: You supplied a value on a panel for the
you must supply two sets of log data set names. RBA parameter; the value of this parameter must be 8
hex characters.
In the message text:
log DDname1, log DDname2 System action: ISPF panel processing awaits
DD statements associated with log data set correction of the error.
names
System programmer response: Specify the correct
System action: ISPF panel processing awaits number of hex characters for the RBA parameters and
correction of the error. continue processing.
System programmer response: Specify a log data set Module: KBLA Data Entry Panel
DFSK417E DRRN must be 8 hexadecimal characters DFSK421E Both parameter1 and parameter2 are
required
Explanation: You supplied a value on the panel for
the device relative record number (DRRN) parameter; Explanation: Values are required for the certain
the value of this parameter must be 8 hexadecimal parameters on the panel. A parameter was missing.
characters.
In the message text:
System action: ISPF panel processing awaits parameter1, parameter2
correction of the error. The parameters on the panel for which a value
is required
System programmer response: Specify the correct
number of hexadecimal characters for the DRRN System action: ISPF panel processing awaits
parameters and continue processing. correction of the error.
Module: KBLA Data Entry Panel System programmer response: Specify a value for
these parameters and continue processing.
DFSK418E Invalid hex representation for SCAN Module: KBLA Data Entry Panel
Explanation: You supplied a value on the panel for
the SCAN parameter; however, the value was not in a DFSK422E parameter is required
valid hex format. One of the following might be in
Explanation: You must specify a value on this panel
error:
for the parameter identified in the message.
v The value was not preceded by an X and single
quotation mark ( X' ). In the message text:
v The value was not followed by a single quotation parameter
mark ( ' ). The parameter on the panel for which a value
v An even number of characters was not supplied. is required
System action: ISPF panel processing awaits System action: ISPF panel processing awaits
correction of the error. correction of the error.
System programmer response: Correct the hex System programmer response: Specify a value for this
formatting problem in error and continue processing. parameter and continue processing.
Module: KBLA Data Entry Panel Module: KBLA Data Entry Panel
DFSK419E Invalid hex characters in SCAN DFSK423E parmname must be number hex digits
Explanation: You supplied a value on the panel for Explanation: You supplied a value on the panel for
the SCAN parameter; however, characters other than the indicated parameter; however, an incorrect number
0-9 and A-F were included in the field. of hex characters was specified for the parameter.
System action: ISPF panel processing awaits In the message text:
correction of the error. parmname
The parameter being updated
System programmer response: Specify valid hex
number The number of digits that is required
characters for the SCAN parameter and continue
processing. System action: ISPF panel processing awaits
correction of the error.
Module: KBLA Data Entry Panel
System programmer response: Specify the correct
number of digits for the indicated parameter and
DFSK420E Blank values are not allowed in IMS
continue processing.
Version / RESLIB pairings
Module: KBLA Data Entry Panel
Explanation: On the panel for KBLA Option 0.1, you
must specify values for the parameters IMS Version
and IMS.SDFSRESL as pairs. DFSK424I (C) Copyright IBM Corp. 2003. All
Rights Reserved.
System action: ISPF panel processing awaits
correction of the error. Explanation: This message contains the copyright
statement.
System programmer response: Specify corresponding
values for IMS Version and IMS.SDFSRESL and System programmer response: No action is required.
continue processing.
Module: KBLA Data Entry Panel
Module: KBLA Data Entry Panel
DFSK425E parmname contains an invalid value DFSK428E ALL cannot be specified for multiple
Criteria or with Dynamic Search
Explanation: You supplied a value on the panel for
the indicated parameter; however, an invalid value was Explanation: You supplied a value of ALL for a
supplied for the parameter. processing criteria parameter on the KBLA Option 4.1
panel. When such a value is supplied, no other
In the message text:
processing criteria parameters can be specified, nor can
parmname
a Dynamic Search be started.
The parameter containing the invalid value
System action: ISPF panel processing awaits
System action: ISPF panel processing awaits
correction of the error.
correction of the error.
System programmer response: Take one of the
System programmer response: Specify valid value for
following actions:
the parameter and continue processing.
v Remove the specification for ALL where it has been
Module: KBLA Data Entry Panel supplied.
v Do not specify any other processing criteria
parameter when ALL is specified for a processing
DFSK426E Option 0.1 Panel is full. Manually add criteria parameter.
Version ver IMS.SDFSRESL entry
Module: KBLA Data Entry Panel
Explanation: You supplied a value on the panel for
the indicated parameter; however, an invalid value was
supplied for the parameter. DFSK430E A complete set of OFF, T, and VALUE
parameters must be specified
In the message text:
ver The version of IMS for the entry you are Explanation: You must specify the search criteria in
trying to add. sets of 3: a data offset (OFF), a data type (T), and a
data value (VALUE). One or more of these parameters
System action: ISPF panel processing awaits was omitted from the set of three.
correction of the error.
System action: Processing awaits correction of the
System programmer response: Remove one of the error.
existing IMS versions and IMS.SDFSRESL entries from
your Option 0.1 panel, and specify the appropriate IMS System programmer response: Enter the missing
version and corresponding IMS.SDFSRESL entry. parameters from the set of three and continue
processing.
Module: KBLA Data Entry Panel
Module: KBLA Data Entry Panel
System action: ISPF panel processing awaits System action: ISPF panel processing awaits
correction of the error. correction of the error.
System programmer response: Ensure that there are System programmer response: Enter a date associated
no gaps between sets of search criteria specifications with the selected time and continue processing.
and continue processing.
Module: KBLA Data Entry Panel
Module: KBLA Data Entry Panel
DFSK502E HLQ length exceeds length1 chars;
DFSK433E If T is Y or N, VALUE must be two hex KEYWORD must be limited to length2
digits
Explanation: ISPF Panel processing requires that you
Explanation: You entered either Y or N on an ISPF enter a value for the KEYWORD parameter, which is
panel as a data type (T) parameter. When one of these concatenated with other parameters to make a
character strings has been entered, you must enter a high-level qualifier (HLQ) for data sets that are
two-digit hexadecimal character 0-9 or A-F for the allocated by KBLA. Although the KEYWORD
VALUE parameter. Something other than a two digit parameter can accept a value up to eight characters, the
hex character was entered. length of this parameter might be limited by the
number of and size of other parameters which are
System action: ISPF panel processing awaits
concatenated to make the HLQ.
correction of the error.
In the message text:
System programmer response: Supply two hex digits
length1 The length of the HLQ, based upon the length
for the VALUE parameter and continue processing.
of the value supplied for KEYWORD
Module: KBLA Data Entry Panel length2 The maximum length allowed for KEYWORD
so that the HLQ length is valid
DFSK434E Invalid numeric characters in OFFSET System action: ISPF panel processing awaits
correction of the error.
Explanation: For the data entered as the OFFSET
parameter, you must enter numeric characters 0-9. You System programmer response: Enter a KEYWORD
entered a non-numeric character in this data field. parameter with a length of length2 or shorter.
System action: Processing awaits correction of the Module: KBLA Data Entry Panel
error.
System programmer response: Enter numeric DFSK503E Even number of characters for UOW
characters for the OFFSET parameter and continue must be supplied
processing.
Explanation: You supplied a value on the panel for
Module: KBLA Data Entry Panel the unit of work (UOW) parameter. This parameter
requires an even number of hex characters
DFSK435E UTC difference must be less than 1200 System action: ISPF panel processing awaits
correction of the error.
Explanation: On the panel for Knowledge-Based Log
Analysis (KBLA) Option 1.1, you can specify an offset System programmer response: Specify an even
from Coordinated Universal Time (UTC) to local time. number of hex characters for the UOW parameter and
However, the value entered was greater than 1200. continue processing.
System action: ISPF panel processing awaits Module: KBLA Data Entry Panel
correction of the error.
System programmer response: Enter a value for local DFSK504E Even number of characters for token
time to UTC difference less than 1200. See the online must be supplied
help associated with this field for valid entries.
Explanation: You supplied a value on the panel for
Module: KBLA Data Entry Panel the token parameter. This parameter requires an even
number of hex characters.
DFSK501E If time is specified, corresponding date System action: ISPF panel processing awaits
must also be specified correction of the error.
Explanation: The panel supports the entry of values System programmer response: Specify an even
for the start date, start time, stop date, and stop time. If number of hex characters for the token parameter and
you enter a value for start or stop time, you must enter continue processing.
a value for the corresponding start or stop date.
Module: KBLA Data Entry Panel
For information about using the IMS abend search and notification function, see
the IMS system definition information.
For the IMS abend search and notification function, you can get these messages
when running from batch:
DFS2225E
DFS2226E
DFS2227E
DFS2228E
DFS2229E
You can receive the messages in this topic when using the IMS abend search and
notification ISPF panels.
System action: Processing is terminated and a System action: Processing is terminated and a
message is displayed. message is displayed.
System programmer response: Provide two different System programmer response: Specify a valid,
valid data set names for the skeleton library data set existing data set on the System Setup panel.
and the runtime data set. Module: DFSRASN1
Provide an email address in the Recipient e-mail
address field or enter a Y in the Specify additional DFSS004E No search argument has been provided
addresses? field to specify email addresses in the
CONTROL member. Explanation: For the On demand interface panel to
generate the email, you must provide at least one
Module: DFSRASN1 search argument.
System action: Processing is terminated and a
DFSS002E e-mail address must be specified message is displayed.
Explanation: When setting up IMS abend search and System programmer response: Provide at least one
notification, either specify an email address on the web search argument on the On demand interface
System Setup panel in the Recipient e-mail address panel in one of the following fields:
field or specify a Y in the Specify additional v PSP for FMID
addresses? field. v Abend Code
System action: Processing is terminated and a v Return Code (RC)
message is displayed. v Module Name
v APAR Number (PE or other)
Explanation: When entering an abend code, use either System programmer response: Press Enter to
an S for a system abend or a U for an IMS abend code continue.
(user abend) as a prefix.
Module: DFSRASN1
System action: Processing is terminated and a
message is displayed.
DFSS100E Abend code must be specified with
System programmer response: Enter a valid prefix for return code (RC)
the abend code in the Abend Code field.
Explanation: If you specify a value for the return code
Module: DFSRASN2 (RC) parameter, you must also specify a value for the
Abend code parameter. You did not specify a value for
the Abend code.
DFSS007E The edit of the Abend Search and
Notification generated JCL failed with System action: Processing stops.
RC=xx
System programmer response: Make sure that
Explanation: The REXX program failed to open certain specifications of Return code (RC) are accompanied by
members for edit. specifications of Abend code.
Module: DFSRASN1
DFSS102I PROCLIB member has been updated
due to change to xxxxxxxx
DFSS106E Skeleton skeleton not found
Explanation: The PROCLIB member contains
information that can be modified using the System Explanation: You selected IMS ASN On-Demand
Setup panel. The changes you make on this panel are Interface and the system tried to validate that the
propagated to the member by creating a copy of the control statement skeletons are available to the
PROCLIB member containing the updated information. program. The program could not access the skeleton
identified in the message. These skeletons were created
System action: Processing continues.
as part of the setup of the IMS Abend Search and
System programmer response: Press Enter to Notification. They reside in the data set specified as the
continue. Skeleton lib DS on the IMS ASN System Setup panel
(Option 1).
Module: DFSRASN1
In the message text:
skeleton The name of the skeleton that was unavailable.
DFSS103E The HLQ parameter is missing
This can be DFSSPCLI or DFSSPRCI
Explanation: You must provide the high-level qualifier
System action: Processing terminates.
used to install IMS to access the appropriate data sets.
System programmer response: Verify that the
System action: Processing terminates, and IMS abend
skeletons exist in the data set and that your IMS Abend
search and notification is not started.
Search and Notification installation is configured
System programmer response: Provide the high-level correctly to access to the skeleton library data set.
qualifier used to install IMS.
Module: DFSRASN2
Module: DFSRASN0
Chapter 101. DFSS messages (IMS abend search and notification) 919
920 Messages and Codes, Volume 1: DFS Messages
Notices
This information was developed for products and services offered in the U.S.A.
| This material may be available from IBM in other languages. However, you may be
| required to own a copy of the product or product version in that language in order
| to access it.
IBM may not offer the products, services, or features discussed in this document in
other countries. Consult your local IBM representative for information on the
products and services currently available in your area. Any reference to an IBM
product, program, or service is not intended to state or imply that only that IBM
product, program, or service may be used. Any functionally equivalent product,
program, or service that does not infringe any IBM intellectual property right may
be used instead. However, it is the user's responsibility to evaluate and verify the
operation of any non-IBM product, program, or service.
IBM may have patents or pending patent applications covering subject matter
described in this document. The furnishing of this document does not give you
any license to these patents. You can send license inquiries, in writing, to:
For license inquiries regarding double-byte (DBCS) information, contact the IBM
Intellectual Property Department in your country or send inquiries, in writing, to:
The following paragraph does not apply to the United Kingdom or any other
country where such provisions are inconsistent with local law:
INTERNATIONAL BUSINESS MACHINES CORPORATION PROVIDES THIS
PUBLICATION “AS IS” WITHOUT WARRANTY OF ANY KIND, EITHER
EXPRESS OR IMPLIED, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED
WARRANTIES OF NON-INFRINGEMENT, MERCHANTABILITY OR FITNESS
FOR A PARTICULAR PURPOSE. Some states do not allow disclaimer of express or
implied warranties in certain transactions, therefore, this statement may not apply
to you.
IBM may use or distribute any of the information you supply in any way it
believes appropriate without incurring any obligation to you.
Licensees of this program who wish to have information about it for the purpose
of enabling: (i) the exchange of information between independently created
programs and other programs (including this one) and (ii) the mutual use of the
information which has been exchanged, should contact:
IBM Corporation
J46A/G4
555 Bailey Avenue
San Jose, CA 95141-1003
U.S.A.
The licensed program described in this information and all licensed material
available for it are provided by IBM under terms of the IBM Customer Agreement,
IBM International Program License Agreement, or any equivalent agreement
between us.
All statements regarding IBM's future direction or intent are subject to change or
withdrawal without notice, and represent goals and objectives only.
This information contains examples of data and reports used in daily business
operations. To illustrate them as completely as possible, the examples include the
names of individuals, companies, brands, and products. All of these names are
fictitious and any similarity to the names and addresses used by an actual business
enterprise is entirely coincidental.
COPYRIGHT LICENSE:
Each copy or any portion of these sample programs or any derivative work, must
include a copyright notice as follows:
© (your company name) (year). Portions of this code are derived from IBM Corp.
Sample Programs. © Copyright IBM Corp. _enter the year or years_. All rights
reserved.
Trademarks
IBM, the IBM logo, and ibm.com® are trademarks or registered trademarks of
International Business Machines Corp., registered in many jurisdictions worldwide.
Other product and service names might be trademarks of IBM or other companies.
A current list of IBM trademarks is available on the web at “Copyright and
trademark information” at www.ibm.com/legal/copytrade.shtml.
Notices 923
v UNIX is a registered trademark of The Open Group in the United States and
other countries.
Other product and service names might be trademarks of IBM or other companies.
| This Software Offering does not use cookies or other technologies to collect
| personally identifiable information.
| If the configurations deployed for this Software Offering provide you as customer
| the ability to collect personally identifiable information from end users via cookies
| and other technologies, you should seek your own legal advice about any laws
| applicable to such data collection, including any requirements for notice and
| consent.
| For more information about the use of various technologies, including cookies, for
| these purposes, See IBM’s Privacy Policy at http://www.ibm.com/privacy and
| IBM’s Online Privacy Statement at http://www.ibm.com/privacy/details the
| section entitled “Cookies, Web Beacons and Other Technologies” and the “IBM
| Software Products and Software-as-a-Service Privacy Statement” at
| http://www.ibm.com/software/info/product-privacy.
Supplementary publications
Title Order number
IMS and SOA Executive Overview GC19-2516
Program Directory for Information Management System Transaction GI10-8788
and Database Servers V11.0
IMS Version 11 Fact Sheet GC19-2451
IRLM Messages and Codes GC19-2666
Printed in USA
GC19-4232-00
Spine information: