Interpreting error reason codes from DYNALLOC

When the DYNALLOC macro routines return a nonzero return code in register 15, the request block field labelled S99ERROR contains a code that explains the reason for the error.

Corresponding messages listed for any error reason code are issued or returned based on the message processing options specified by the dynamic allocation caller. See Processing messages and reason codes from dynamic allocation for more information about the handling of dynamic allocation messages.

Error reason codes are divided into the following classes:
Class
Description
1
Used for internal diagnostic purposes only. Record this code and supply it to the appropriate IBM® support personnel.
2
Unavailable system resource
3
Invalid parameter list
4
Environmental error
5
Used for internal diagnostic purposes only. Record this code and supply it to the appropriate IBM support personnel.
6
Used for internal diagnostic purposes only. Record this code and supply it to the appropriate IBM support personnel.
7
System routine error

The error reason codes are shown in Table 1 through Table 4. The class designations listed here appear as the second digit of the reason code.

Note: The explanations of the codes in these figures are followed, in parentheses, by an indication of the kind of request associated with the code.
Table 1. Class 2 error reason codes (unavailable system resource - ENVIRONMENTAL ERROR)
Hex code (Decimal) Meaning and action
0204 (516) Meaning: Virtual storage unavailable.

Application programmer action: Resubmit the request.

Corresponding message: IKJ56863I
020C (524) Meaning: Unable to honor a request to upgrade an existing shared data set allocation for this address space to an exclusive allocation (such as OLD OR MOD), because the data set is also allocated to another address space, possibly on a different system in the sysplex.1

Application programmer action: Change the allocation request and resubmit the request.

Corresponding message: IKJ56241I
0210 (528) Meaning: Requested data set unavailable. The data set is allocated to another job and its usage attribute conflicts with this request. (dsname allocation)1

Application programmer action: Change the allocation request and resubmit the request. Start of changeIf the DALRTDSN text unit was specified, the name of the data set may be returned in that text unit. See the description of the DALRTDSN text unit in Dsname return specification - Key = '0056' for more information.End of change

Corresponding message: IKJ56225I
0214 (532) Meaning: Device(s) not available; or, if allocating an internal reader, all defined internal readers are already allocated. (dsname allocation)1

Application programmer action: Ensure that the device collections of the specified device can supply the required number of devices. If necessary, change the device specification. Resubmit the request.

System programmer action: If the device(s) should have been available based on the configuration defined to the system, search the problem reporting data bases for a fix for the problem. If no fix exists, contact the IBM Support Center. The S99INFO field may contain an internal informational code which can be reported to the IBM Support Center.

Corresponding message: IKJ56241I

0218 (536) Meaning: Specified volume or an acceptable volume is not mounted, and user does not have volume mounting authorization through the DYNALLOC request. (dsname allocation)1

Application programmer action: Change volume specification, or have the required volume mounted, or change the allocation request to allow volume mounting. Resubmit the request.

Some possible reasons for this error are:
  • The dynamic allocation tried to use a VIO-eligible unit, but the data set name was not a temporary dsname (DSN=&&dsname).
  • The dynamic allocation tried to put a data set with a non-temporary dsname (DSN=dsname) onto a real DASD volume but
    • No volume serial number was supplied, and
    • No volumes on the system were mounted with a USE attribute of STORAGE.

Corresponding message: IKJ56221I

021C (540) Meaning: Device name specified is undefined. (dsname allocation)

Application programmer action: Correct the device name subparameter and resubmit the allocation request. If the device name subparameter correctly identifies a device in the current configuration and a dynamic configuration change has just occurred, resubmit the request.

System programmer action: If the problem recurs, search the problem reporting data bases for a fix. If none exits, contact the IBM Support Center.

Corresponding message: IKJ56241I

0220 (544) Meaning: Requested volume not available. (dsname allocation)

Application programmer action: Resubmit the request.

Corresponding message: IKJ56221I
0224 (548) Meaning: Eligible device types do not contain enough devices. (dsname allocation)1

Application programmer action: Change the device specification and resubmit the request. Ensure that the specified device type can supply the required number of devices.

System programmer action: If the problem recurs, and the I/O configuration was built by the MVS™ configuration program (MVSCP), search the problem reporting data bases for a fix for the problem. If no fix exists, contact the IBM Support Center.

Corresponding message: IKJ56880I

0228 (552) Meaning: Specified volume or device in use by system. (dsname allocation)

Application programmer action: Resubmit the request when the system function has completed.

Corresponding message: IKJ56880I
022C (556) Meaning: Volume mounted on ineligible permanently resident or reserved device. (dsname allocation)

Application programmer action: Ensure that the device and volume specifications are correct. If necessary, correct them. Resubmit the request.

One possible reason for this error is that the dynamic allocation specified a valid volume serial number along with an invalid UNIT name.

Corresponding message: IKJ56221I
0230 (560) Meaning: Permanently resident or reserved volume on required device. (dsname allocation)

Application programmer action: Specify another device number or request the volume that is mounted on the device.

Corresponding message: IKJ56880I

0234 (564) Meaning: More than one device required for a request specifying a specific device. (dsname allocation)

Application programmer action: Change the request to specify an esoteric or generic name representing more than one device; or, if the volume is reserved and you do not wish it to be, ask the operator to unload it. Resubmit the request.

Corresponding message: IKJ56880I
0238 (568) Meaning: Space unavailable in task input output table (TIOT). (dsname allocation, concatenation)

Application programmer action: Reduce the total number of allocated DDs and devices. Deallocate data sets that are not needed simultaneously.

Corresponding message: IKJ56220I
Note: The size of the TIOT increases by four (4) bytes for every SMS candidate volume per DD statement or dynamic allocation.
023C (572) Meaning: Required catalog not mounted, and user does not have volume mounting authorization. (dsname allocation)

Application programmer action: Ask the operator to mount the required volume and resubmit the allocation request.

Corresponding message: IKJ56880I
0240 (576) Meaning: Requested device is a console. (dsname allocation)

Application programmer action: Change the incorrect device address and resubmit the request.

Corresponding message: IKJ56881I
0244 (580) Meaning: Telecommunication device not accessible. (dsname allocation)

Application programmer action: Ask the operator to enter VARY commands to ensure that the necessary device is accessible. Resubmit the request.

024C (588) Meaning: Operating-system-managed resource was unavailable to the subsystem. (dsname allocation)2

Application programmer action: Consult the subsystem message. Correct the error and resubmit the allocation request.

0250 (592) Meaning: Subsystem resource not available. (dsname allocation)2

Application programmer action: Correct the incorrect subsystem name. Resubmit the request.

System programmer action: If the subsystem name was correct, consult the subsystem documentation to determine if the subsystem supports dynamic allocation of subsystem data sets.
0254 (596) Meaning: The TIOT resource is currently unavailable and the user requested conditional ENQ on the resource. (all dynamic allocation functions)

Application programmer action: Resubmit the request. If acceptable, turn off the conditional ENQ request by setting bit S99CNENQ in the request block to 0.

0258 (600) Meaning: There was not a sufficient number of non-restricted devices to satisfy the request, or JES3 selected a JES3-managed restricted device to satisfy the request.

Application programmer action: Ensure that the device type is correctly specified. If this error code occurred because JES3 selected a device that is restricted and either JES3-managed or jointly managed, remove the device from JES3 management.

System programmer action: If the problem recurs and the I/O configuration was built by the MVS configuration program (MVSCP), search the problem reporting data base for a fix for the problem. If no fix exists, contact the IBM Support Center.

025C (604) Meaning: Requested device is boxed and cannot be accessed, as a result of an I/O error condition or the operator issuing a VARY X, OFFLINE, FORCE command. (dsname allocation)

Application programmer action: Resubmit the request when the device has been brought back online.

0260 (608) Meaning: The device does not meet the specified status requirements. (MVS issues this reason code after a device allocation or deallocation request has failed.)

System programmer or operator action: Depending on the message accompanying this error reason code, different actions are required. Follow the actions specified in the accompanying message.

0264 (612) Meaning: Due to its current status, the request made to the device is invalid. (MVS issues this reason code after a device allocation or deallocation request has failed.)

System programmer or operator action: Depending on the message accompanying this error reason code, different actions are required. Follow the actions specified in the accompanying message.

0268 (616) Meaning: The tape device is not responding to request; a hardware malfunction might have occurred. (dsname allocation)

Application programmer action: Change the tape device address and resubmit the request.

026C (620) Meaning: Request requires more SMS-managed volumes than are eligible.

Application programmer action: Change the UNIT, VOLUME, or STORCLAS requirements on the allocation request to specify an eligible SMS-managed volume.

Corresponding message: IKJ56241I

0270 (624) Meaning: Request requires more non-SMS-managed volumes than are eligible.

Application programmer action: Change the UNIT, VOLUME requirements on the allocation request to specify an eligible non-SMS-managed volume.

Corresponding message: IKJ56241I

0274 (628) Meaning: Telecommunication device deleted from I/O configuration. The accompanying message IEF358I contains the device name information.

Application programmer action: Ensure that the teleprocessing device is correctly specified and is currently defined in the system configuration.

System programmer action: If the error recurs, search the problem reporting data base for a fix for the problem. If no fix exists, contact the IBM Support Center.

Corresponding message: IEF358I

0278 (632) Meaning: The requested data set is migrated, but the S99NOMIG bit is on. (S99NOMIG is described in Flags (S99FLAG1))

Application programmer action: Recall the data set and resubmit the request.

Corresponding message: IKJ56240I

0284 (644) Meaning: No tape library contains enough devices to satisfy the request. The accompanying message IEF115I contains the number of devices needed.

Application programmer action: Reduce the number of tape devices required and resubmit the allocation request, or, if this is not possible, notify the system programmer.

System programmer action: Determine whether it is possible to satisfy the device requirements with another library. If so, assign a storage group in that library to this request. Otherwise, notify the owner of the job either to reduce the device requirements or change the request to a non-library request.

Corresponding message: IEF115I

028C (652) Meaning: Unable to allocate tape devices to the same generic device name. The accompanying message IEF112I contains the device name information.

Application programmer action: Reduce the tape device requirements and resubmit the request.

Corresponding message: IEF112I

0290 (656) Meaning: The allocation failed because the system could not assign all the required tape devices within one eligible system-managed tape library. The accompanying message IEF333I contains the libraries that are eligible to this allocation request.
Application programmer action: Do one of the following:
  • Reduce the number of devices required by the DD statement.
  • Reduce the number of devices required by the step.
  • Balance the total number of required devices among the DD statements in the step.
Then resubmit the job.

Corresponding message: IEF333I

0294 (660) Meaning: A non-tape-library request specified a tape library device. The accompanying message IEF120I contains the device name information.

Application programmer action: If you can avoid requesting a specific device (a demand request), change the device specification to either a generic device name or an esoteric device name and resubmit the allocation request. However, if you require a demand request, ensure that the required tape device is not in a tape library and resubmit the request.

Corresponding message: IEF120I

0298 (664) Meaning: No tape device pools available for allocation.

Application programmer action: Ensure that tape device pools are defined to this system and resubmit the request.

Corresponding message: IEF147I

029C (668) Meaning: There was a library automation communication services (LACS) mount failure for a device in a IBM 3495 Tape Library Dataserver.

System programmer or operator action: Depending on the messages accompanying this error reason code, different actions are needed. For required actions, see the accompanying message.

02A0 (672) Meaning: Attempt to mount a volume on the device specified, but the mount failed.

System programmer action: Depending on the messages accompanying this error reason code, different actions are needed. For required actions, see the accompanying message.

Corresponding Messages: IEF116I, IEF118I, IEF788I, IEF789I, IEF790I, IEF791I

02A4 (676) Meaning: Attempt to allocate a request to a single library failed. The accompanying message IEF333I contains the device and library name information.

Application programmer action: Reduce the tape device requirements and resubmit the request.

Corresponding message: IEF333I

02A8 (680) Meaning: Attempt to obtain library ID for the requested device failed. The accompanying message IEF155I contains the device name information.

System programmer action: Review the logrec record related to this error for information that might help resolve why the system could not obtain the tape library ID.

Corresponding message: IEF155I

02AC (684) Meaning: A volume required for a non-tape-library request was mounted on library device. The accompanying message IEF151I contains the library and volume name information.

System programmer action: Contact the storage administrator to check the tape volume inventory and update it as necessary.

Corresponding message: IEF151I

02B0 (688) Meaning: A volume required for a tape-library request was mounted on a non-library device. The accompanying message IEF152I contains the library and volume names.

System programmer action: Contact the storage administrator to check the tape volume inventory and update it as necessary.

Corresponding message: IEF152I

02B4 (692) Meaning: The volume required for a tape-library request is mounted on a device in a library that was not eligible. The accompanying message IEF153I contains the library and volume name information.

System programmer action: Contact the storage administrator to check the tape volume inventory and update it as necessary.

Corresponding message: IEF153I

02B8 (696) Meaning: Unable to obtain library status for the specified tape library. The accompanying message IEF156I contains the library name information.

System programmer action: Review the logrec record related to this error for information that might help to resolve why the system could not obtain the tape library name.

Corresponding message: IEF156I

02BC (700) Meaning: A non-tape-library request specified a library device. The accompanying message IEF113I contains the device name information.

System programmer action: Choose a device that resides in the same library as the volume(s) to be allocated.

Corresponding message: IEF113I

02C0 (704) Meaning: Unable to allocate a tape device because the device is not in the same library as the requested volume. The accompanying message IEF111I contains the device name and library name information.

System programmer action: Choose a device that resides in the same library as the volume(s) to be allocated.

Corresponding message: IEF111I

02C4 (708) Meaning: The allocation failed because the volume record for the specified volume could not be retrieved from the tape configuration database. The accompanying message IEF150I contains the volume serial number.

System programmer action: Review the logrec record related to this error for information that might help to resolve why the system could not obtain the volume record for the specified volume serial number.

Corresponding message: IEF150I

02C8 (712) Meaning: Request failed for a library record from the tape configuration database.

Application programmer action: None.

Corresponding message: IEF357I

02CC (716) Meaning: The JES Client Token (CTOKEN) was not available from the currently-running JES subsystem. The usual cause of this problem is that the JES2 or JES3 version installed does not support a CTOKEN request.

System programmer action: Verify that the current level of JES supports CTOKENs (which were introduced in conjunction with Client Print support). If the proper JES version is active and the problem recurs, search the problem reporting data base for a fix for the problem. If no fix exists, contact the IBM support center. The S99INFO field may contain an internal informational code which can be reported to the IBM Support Center.

02D0 (720) Meaning: Allocation failed in an attempt to unload a volume needed by this job from the device where it is currently mounted. The reason for the failure is either the device ENQ failed or the device ASSIGN failed.

Corresponding message: IEF017I

System programmer action: Resubmit the job or allocation request.

02D3 (723) Meaning: Allocation failed because the eligible volume was not on an online device, and the request did not allow allocation to consider offline devices.

System programmer action: Vary the eligible device online and resubmit the request.

02D4 (724) Meaning: Allocation attempted to ALESERV the ALLOCAS address space, and the ALESERV service returned a non-zero return code.

System programmer action: This error may indicate that the DU-AL is full. If the issuing program has issued many ALESERV ADDs and the DU-AL is full, delete some of the entries on the DU-AL and retry the request. If the error continues, search problem reporting databases for a fix for the problem. If no fix exists, contact the IBM Support Center.

02D5 (725) Meaning: Allocation was already active when IEFDB440 was running as an IRB under a task.

Application programmer action: IEFDB440 should not be invoked in this environment. Make sure that you adhere to this restriction. Contact the owner of the subsystem that scheduled the IRB.

System programmer action: None.

02D6 (726) Meaning: Allocation failed because there were no available offline devices within the specified esoteric, so there are no eligible devices to be brought online by Recovery Allocation processing to satisfy the request.

System programmer action: Verify that the volume serial specified is valid, and that it is online in the specified esoteric. Correct the volume serial or unit information if necessary.

02D7 (727) Meaning: The current environment cannot support dynamic allocation requests.

System programmer action: Retry allocation request at a later time.

02D8 (728) Meaning: When attempting to allocate devices to this request, Allocation was prevented from using EAV devices because of the “USEEAV(NO)” setting in the IGDSMSxx parmlib member. For a request with specific volumes in the volume list, the setting prevented the allocation. For a non-specific request, such as one with UNIT=SYSDA and no volume list, the exclusion of the EAV volumes did not leave enough volumes to allocate the request.

Application programmer action: Select another esoteric unit name for the UNIT parameter, a different volume serial for the request, or contact the System Programmer.

System programmer action: See System Programmer response for IEF021I. If EAV volumes are needed, use the SETSMS command to change the USEEAV setting in IGDSMSxx.

02D9 (729) Meaning: Allocation failed because there were not enough available tape library devices to satisfy the request.

System programmer action: If possible, make more tape devices available in the requested library by varying them available or by varying them online. Resubmit the request.

02DA (730)

Meaning: The dynamic allocation request specified DALSMSHR for a tape library request, but the unit name on the DALUNIT is not valid.

Application programmer response: Correct the dynamic allocation request to use a valid unit name, and resubmit the request.

02DB (731)

Meaning: The dynamic allocation request specified DALSMSHR and DALUNIT for a single device, but it is a restricted device.

Application programmer response: Correct the dynamic allocation request to use a device that is not restricted, and resubmit the request.

02DC (732)

Meaning: The request specified DALSMSHR and DALUNIT for a single device, but the device is in use by the system.

Application programmer response: Correct the error either by using another device or by waiting until the device is no longer in use by the system, and resubmit the request.

02DD (733)

Meaning: The request specified DALSMSHR and DALUNIT for a single device, but the device is boxed.

Application programmer response: Correct the error either by using another device or by issuing a VARY ONLINE command for the boxed device, and resubmit the request.

02DE (734)

Meaning: The request specified DALSMSHR and DALUNIT for a specific device, but the device is marked unavailable for allocation.

Application programmer response: Correct the dynamic allocation request to use another device, or make the device available by issuing VARY ONLINE or VARY AVAILABLE commands, and resubmit the request.
Note: The application programmers probably cannot issue the VARY commands themselves, but they must ask the system programmer to ensure that the device is online and available.
02DF (735)

Meaning: The MOUNT command for a tape library device with a tape library volume specified a device which was not found in the device pools returned by the system. This could be because the media types of the device and volume requested are different.

Application programmer response: Specify another device or request another volume.

Corresponding message: IKJ56231I

Notes:
1
The conditions that cause these return codes are detected by MVS or JES3.
2
The information reason code contains a subsystem-defined value to further describe the error. This value is documented in publications associated with the particular subsystem.
Table 2. Class 3 error reason codes (invalid parameter list - PROGRAM ERROR)
Hex code (Decimal) Meaning and action
02E0 (736) Meaning: The system could not allocate the data set for one of the following reasons:
  • DALROAC=DISALLOW (X’02’) text unit was specified and the data set resides on a read-only device.
  • DISP=NEW is not accepted when the volume has the read-only access attribute.

Application programmer action: If the program can tolerate a read-only volume, specify DALROAC=ALLOW (X’01’) text unit or omit the DALROAC text unit. Refer to z/OS MVS JCL Reference for information about the ROACCESS keyword. Resubmit the job.

Corresponding message: IEFA180I

02E1 (737) Meaning: The system requires the DALROA2 text unit to allocate an existing data set that resides on a PPRC secondary device.

Application programmer action: If the program can tolerate a read-only volume, specify DALROA2=TRKLOCK (X’02’) text unit. Refer to z/OS MVS JCL Reference for information about the ROACCESS keyword. Resubmit the job.

Corresponding message: IEFA181I

0304- 0338 (772- 824) Assigned by DAIR4.
0358 (856) Meaning: Overriding disposition of DELETE invalid for data set allocated as SHR. (unallocation)1

Application programmer action: Do not specify a data set disposition in your input parameter list, or code a valid disposition (such as KEEP, CATALOG, or UNCATLG). If a disposition of DELETE is required, allocate the data set as OLD.

Corresponding message: IKJ56860I

035C (860) Meaning: Invalid PARM specified in text unit. The accompanying message IKJ56231I identifies the text unit in error. (all dynamic allocation functions)2

Application programmer action: See the description of the text unit and correct the error.

Corresponding message: IKJ56231I

0360 (864) Meaning: Invalid key specified in text unit. The accompanying message IKJ56231I identifies the text unit in error. (all dynamic allocation functions)2

Application programmer action: See the description of the text unit key for the desired function and correct the error.

Corresponding message: IKJ56231I

0364 (868) Meaning: JOBLIB/STEPLIB specified as a ddname, or associated with specified dsname or pathname. These ddnames are allowed only for special data sets. The accompanying message IKJ56236I identifies which of the above ddname types is in error. (dsname allocation, ddname allocation, unallocation, concatenation, deconcatenation)1

Application programmer action: Use a different ddname, or consult your system programmer for the proper ddname to use.

Corresponding message: IKJ56236I

0368 (872) Meaning: Authorized function requested by unauthorized user. (all dynamic allocation functions)

Application programmer action: Obtain authorization from your system administrator, or request only those services (functions) that are available to unauthorized programs.

Corresponding message: IKJ56864I

036C (876) Meaning: Invalid parameter list format. (all dynamic allocation functions)

Application programmer action: Consult the description of the DYNALLOC parameter list and make corrections.

Corresponding message: IKJ56231I

0374 (884) Meaning: Invalid # specified in text unit. The accompanying message IKJ56231I indicates the number of the text unit in error. (all dynamic allocation functions)2

Application programmer action: Consult the description of the text unit in error and correct the number parameter.

Corresponding message: IKJ56231I

0378 (888) Meaning: Duplicate key specified in text unit. The accompanying message IKJ56231I indicates the number of the text unit in error. (all dynamic allocation functions)2

Application programmer action: Remove the duplicate key from the text unit list, or substitute the intended key.

Corresponding message: IKJ56231I

037C (892) Meaning: Invalid LEN specified in text unit. The accompanying message IKJ56231I indicates the number of the text unit in error. (all dynamic allocation functions)2

Application programmer action: Correct the LEN field and resubmit the request.

Corresponding message: IKJ56231I

0380 (896) Meaning: Mutually exclusive key specified. Two keys that cannot be used together were used in the request. (dsname allocation, unallocation, information retrieval, remove-in-use processing)2

Application programmer action: Consult the descriptions of the keys specified and determine which should be used.

Corresponding message: IKJ56876I

0384 (900) Meaning: Mutually inclusive key not specified. One key was used; two should have been used. (dsname allocation, unallocation)2

Application programmer action: Consult the description of the key in error, and the key(s) for the desired function to determine which additional key should be used.

Corresponding message: IKJ56877I

0388 (904) Meaning: Required key not specified. (ddname allocation, information retrieval, concatenation, deconcatenation, remove-in-use processing, unallocation)

Application programmer action: Consult the description of the key for the desired function to determine which key needs to be added.

Corresponding message: IKJ56878I

038C (908) Meaning: Duplicate ddnames specified. (concatenation)

Application programmer action: Determine which ddname is a duplicate, and remove it from the list of ddnames to be concatenated (text unit 0001). For data set concatenation to a ddname, first allocate the data set under another ddname, then concatenate the two ddnames.

Corresponding message: IKJ56869I

0390 (912) Meaning: GDG group name specified with relative generation number exceeds the maximum of 35 characters. (dsname allocation).

Application programmer action: Change the GDG name so it does not exceed 35 characters.

Corresponding message: IKJ56870I

0394 (916) Meaning: Status and relative generation number are incompatible. (dsname allocation)

Application programmer action: Correct either the disposition specified or the relative generation level requested.

Corresponding message: IKJ56871I

0398 (920) Meaning: Volume sequence number exceeds the number of volumes. (dsname allocation)

Application programmer action: Ensure that the volume sequence number is equal to or less than the number of volume serials specified. Correct the DD specifications.

Corresponding Message: IKJ56880I

039C (924) Meaning: Device type and volume are incompatible. (dsname allocation)

Application programmer action: Correct the DD statement and resubmit the job. If the DD statement was correct, notify the system programmer.

System programmer action: Verify that the I/O configuration was built correctly. If so, search problem reporting data bases for a fix for the problem. If no fix exists, contact the IBM Support Center. Check your SMS ACS routines to ensure that your non-tape and non-dasd devices have been omitted.

Corresponding message: IKJ56880I

03A0 (928) Meaning: Subsystem detected an invalid parameter. (dsname allocation)3

Application programmer action: See note 3 below. If the subsystem name was not specified (thus defaulting to the primary subsystem), check with your system programmer to obtain the name of the primary subsystem. Then consult the documentation for that subsystem and correct the parameter list error.

03A4 (932) Meaning: Unable to protect data set/volume because of conflicting keyword specification. The following requirements may not have been met:
  • If PROTECT was specified for a DASD data set, the data set must be a non-temporary data set with a disposition of 'NEW' or 'MOD' treated as 'NEW'. If specified, normal and abnormal dispositions must be other than DELETE, and the data set has a non-temporary data set name.
  • If PROTECT was specified for a tape volume, the tape label specification must be SL, AL, SUL, AUL, or NSL. Both the file sequence count and volume sequence count must be set to one (except for NSL), or must default to one, and the tape volume must have a volume use attribute of PRIVATE.

Application programmer action: See the description of the PROTECT specification key (0061) and remove any conflicting keys, or change the data set/volume specification to comply with the above rules. See the description of the DD statement PROTECT parameter in z/OS MVS JCL Reference for more information.

Corresponding message: IKJ56890I

03A8 (936) Meaning: DYNALLOC request block extension has invalid format.

Application programmer action: See the description of the DYNALLOC request block extension and correct the error.

Corresponding message: IKJ56231I

03AC (940) Meaning: The CPPL (command processor parameter list) address is not specified in the request block extension. This field is required if PUTLINE is used to issue messages.

Application programmer action: Specify a CPPL address in the request block extension.

Corresponding message: IKJ56231I

03B0 (944) Meaning: The overriding disposition key specified is not compatible with the file type of the specified DD.

Application programmer action: If the DD represents a z/OS® UNIX file, use the overriding path disposition (DUNOVPDS) key, otherwise use the normal overriding disposition (DUNOVDSP) key.

Corresponding message: IKJ56233I

03B4 (948) Meaning: Override affinity (DALOVAFF) was specified, but a SYSOUT program name (DALSPGNM) of 'INTRDR' was not specified.

Application programmer action: Specify a program name for the internal reader.

Corresponding message: None.

03B8 (952) Meaning: The system does not allocate the data set and fails the dynamic allocation that specified a two-digit year expiration Date (yyddd) Text Unit (DALEXPDT) and the 2DGT_EXPDT Policy of Fail is in effect. A two-digit Expiration Date year implies a year date of the form 19xx where xx is the two-digit year specified by DALEXPDT (yyddd). Therefore, the use of DALEXPDT does not allow the specification of an Expiration Date after December 31, 1999.

Application programmer action: Modify the application's dynamic allocation parameter input to replace the DALEXPDT text unit with the DALEXDPL text unit which uses the 4-digit year format.

Corresponding message: IEF406I.

03BC (956) Meaning: The system does not allocate the data set and fails the dynamic allocation request. The request was for a new VSAM generation data set, which is not valid because generation data sets cannot be VSAM.

Application programmer action: Correct the application's dynamic allocation input to either create a generation data set that is not a VSAM data set, or a VSAM data set that is not a member of a generation data group, depending on the intent of the original allocation request. The data set name and relative generation number are indicated by the DALDSNAM and DALMEMBR text units. A data set can be explicitly defined as a VSAM data set by the DALRECO text unit, or implicitly defined by a reference to another data set or DD name using the DALDCBDS or DALDCBDD text units.

Corresponding message: None.

03BD (957)

Meaning: The request specified DALSMSHR and DALUNIT for a non-library request.

Application programmer response: Correct the dynamic allocation request to specify a different unitname for the DALUNIT text unit, or remove the DALSMSHR text unit.

03BE (958)

Meaning: The request specified DALUNIT with a specific device number, DALUNCNT with a device count greater than 1, and DALSMSHR. This is not valid.

Application programmer response: Correct the dynamic allocation request to remove the DALUNCNT text unit or to specify a device count of 1 on the DALUNCNT text unit.

03BF (959)

Meaning: The request specified DALSMSHR and DALUNIT for a specific device, but it is not a tape device.

Application programmer response: Correct the dynamic allocation request to use another device, and resubmit the request.

03C0 (960)

Meaning: The request specified DALSMSHR and DALUNIT for a specific device, but it is not a system-managed tape library device.

Application programmer response: Correct the dynamic allocation request to use another device, and resubmit the request.

03C1 (961)

Meaning: The request specified DALSMSHR and DALUNIT for a specific device, but the device is not in the list of tape library devices selected by SMS.

Application programmer response: Correct the dynamic allocation request to use another device, and resubmit the request. If the correct device was specified, consult with the system programmer to determine why SMS did not select the correct tape library for this request.

System programmer action: Verify that the SMS settings (ACS routines, ISMF settings, and so on.) are returning tape library devices that are consistent with the dynamic allocation parameters, especially the DALUNIT parameter. Correct the SMS settings or help the application programmer select a more appropriate device.

03C2 (962)

Meaning: The request specified DALSMSHR and DALUNIT, but the unit is not an esoteric name.

Application programmer response: Correct the dynamic allocation request to use an esoteric name, and resubmit the request.

03C4 (964)
Meaning: Insulated DD error. An attempt was made to unallocate, concatenate, or deconcatenate a resource with the insulated DD attribute without specifying the insulated DD text unit, or the insulated DD text unit was specified but the resource was not allocated with the insulated DD attribute.
Application programmer response: Verify that the proper ddname was used on the request; correct it, if necessary. If the ddname is correct, add or remove the insulated DD text unit and resubmit the request.s
Notes:
1
The information reason code field contains 0004 if the requested function was performed, although an error occurred, as the error reason code indicates.
2
The information reason code contains the value of the key that caused the error.
3
The information reason code field contains a subsystem-defined value to further describe the error. This value is documented in publications associated with the particular subsystem.
4
See the description of DAIR return codes in z/OS TSO/E Programming Services.
Table 3. Class 4 Error Reason Codes (Environmental Error)
Hex code (Decimal) Meaning and action
0410 (1040) Meaning: Specified ddname unavailable. (dsname allocation, ddname allocation)

Application programmer action: Change ddname.

Corresponding message: IKJ56246I

0420 (1056) Meaning: Specified ddname or dsname associated with an open data set. (ddname allocation, concatenation, deconcatenation, unallocation, dsname allocation)1

Application programmer action: Change ddname or dsname, or close the open data set needed.

Corresponding message: IKJ56861I

0424 (1060) Meaning: Deconcatenation would result in duplicate ddnames (deconcatenation).1

Application programmer action: Ensure the ddname is available before resubmitting the deconcatenation request.

Corresponding message: IKJ56853I

0434 (1076) Meaning: Ddname specified in ddname allocation request is associated with a convertible or non-permanently allocated resource. (ddname allocation)

Application programmer action: Change ddname.

Corresponding message: IKJ56865I

0438 (1080) Meaning: Specified ddname not found. (information retrieval, ddname allocation, concatenation, deconcatenation, unallocation)

Application programmer action: Change ddname.

Corresponding message: IKJ56868I

043C (1084) Meaning: The system could not deallocate enough of the resources being held in anticipation of reuse to meet the control limit. (dsname allocation) 2

Application programmer action: Deallocate some resources or increase the control limit.

Corresponding message: IKJ56220I

0440 (1088) Meaning: Specified data set name or pathname not found. (information retrieval, unallocation)

Application programmer action: Ensure that the data set or z/OS UNIX file, for which the information was requested, exists or correct the data set name or pathname.

Corresponding message: IKJ56247I

0444 (1092) Meaning: Relative entry number specified in information retrieval request not found. (information retrieval)

Application programmer action: Change relative entry number.

Corresponding message: IKJ56867I

0448 (1096) Meaning: Request for a new data set failed; the data set already exists. (dsname allocation)

Application programmer action: Change dsname or allocate the data set as an existing data set.

Corresponding message: IKJ56248I

044C (1100) Meaning: Request was made for a data set that has a disposition of delete; this request cannot be honored because the data set might be deleted at any time. (dsname allocation)

Application programmer action: Change the data set disposition to NEW or change the requested dsname.

Corresponding message: IKJ56249I

0450 (1104) Meaning: Request caused the limit of concurrent allocations to be exceeded. (dsname allocation)
  • If no extended TIOT is requested, the limit is determined by the TIOT size. TIOT size is specified in the ALLOCxx member of PARMLIB, or by system default.
  • If extended TIOT is requested, there is no limit.

Application programmer action: Deallocate data sets that are no longer needed.

Corresponding message: IKJ56866I

0454 (1108) Meaning: Ddname in DCB reference not found. (dsname allocation)

Application programmer action: Change ddname.

Corresponding message: IKJ56234I

0458 (1112) Meaning: Dsname in DCB reference or volume reference is a GDG group name. (dsname allocation)

Application programmer action: Change dsname in DCB reference to a non GDG group name.

Corresponding message: IKJ56879I

045C (1116) Meaning: Specified dsname to be deallocated is a member of a permanently-concatenated group. (unallocation)1

Application programmer action: Do not attempt to deallocate by dsname a data set that is permanently concatenated. Remove the request or change it to deallocate the entire concatenation.

Corresponding message: IKJ56230I

0460 (1120) Meaning: Specified data set name, member name, or pathname to be deallocated is not associated with specified ddname. (unallocation)

Application programmer action: Change ddname, data set name, member name, or pathname.

Corresponding message: IKJ56872I

0464 (1124) Meaning: Specified dsname to be deallocated is a private catalog. (unallocation)1

Application programmer action: Do not attempt to deallocate a private catalog.

Corresponding message: IKJ56873I

0468 (1128) Meaning: Error while allocating or opening a private catalog. (dsname allocation)

System programmer action: List the master catalog to obtain further information about the private catalog.

Corresponding message: IKJ56874I

046C (1132) Meaning: Remote work station not defined to job entry subsystem. (dsname allocation, unallocation)

Application programmer action: Change remote user ID.

System programmer action: If the application programmer action does not resolve the issue, search the problem reporting data bases for a fix for the problem. If no fix exists, contact the IBM Support Center. The S99INFO field may contain an internal informational code which can be reported to the IBM Support Center.

Corresponding message: IKJ56875I

0470 (1136) Meaning: User unauthorized for subsystem request. (dsname allocation)

System programmer action: Contact the RACF® administrator for assistance. If the problem recurs, search the problem reporting data bases for a fix for the problem. If no fix exists, contact the IBM Support Center. The S99INFO field may contain an internal informational code which can be reported to the IBM Support Center.

Corresponding message: IKJ56864I

0474 (1140) Meaning: Error while attempting to select optimum device. (dsname allocation).

System programmer action: If the problem recurs, search problem reporting data bases for a fix for the problem. If no fix exists, contact the IBM Support Center.

Corresponding message: No corresponding dynamic allocation message

0478 (1144) Meaning: Unable to process job entry subsystem request. (dsname allocation, unallocation)

System programmer action: If the problem recurs, search problem reporting data bases for a fix for the problem. If no fix exists, contact the IBM Support Center. The S99INFO field may contain an internal informational code which can be reported to the IBM Support Center.

Corresponding message: IKJ56884I

047C (1148) Meaning: Unable to establish ESTAE environment. (all dynamic allocation functions)

Application programmer action: Resubmit the request.

Corresponding message: IKJ56231I

0480 (1152) Meaning: The number of units needed to satisfy the request exceeds the limit. (dsname allocation)

Application programmer action: Reduce the number of volumes needing to be mounted at the same time. An allocation for the base name of a VSAM data set includes all components. Ensure that there are less than 59 volumes requested for all components of the VSAM data set.

Corresponding message: IKJ56882I

0484 (1156) Meaning: Request denied by one of the following: (dsname allocation)
  • The operator
  • The default policy specified in SYS1.PARMLIB member ALLOCxx
  • The installation exit specified in SYS1.PARMLIB member EXITxx.

Application programmer action: Contact the system programmer for assistance.

System programmer action: Verify allocation defaults and exits that were active at the time when the request was denied. If the problem recurs, search the problem reporting data bases for a fix for the problem. If no fix exists, contact the IBM Support Center. The S99INFO field may contain an internal informational code which can be reported to the IBM Support Center.

Corresponding message: IKJ56883I, IEF336I, IEF876I

0488 (1160) Meaning: GDG pattern DSCB not mounted. (dsname allocation)

Application programmer action: Ensure that the volume containing the pattern DSCB is mounted and resubmit the request.

Corresponding message: IKJ56880I

048C (1164) Meaning: GDG pattern DSCB not found. (dsname allocation)

Application programmer action: Check the catalog volume VTOC for a DSCB for the GDG group. Correct the error and resubmit the request.

Corresponding message: IKJ56880I

0490 (1168) Meaning: Error changing allocation assignments. (dsname allocation)

System programmer action: If the problem recurs, search problem reporting data bases for a fix for the problem. If no fix exists, contact the IBM Support Center.

Corresponding message: No corresponding dynamic allocation message

0494 (1172) Meaning:The required catalog does not exist or it cannot be opened. (dsname allocation)

System programmer action:Ensure that the required catalog exists. If the problem recurs, search problem reporting data bases for a fix for the problem. If no fix exists, contact the IBM Support Center.

Corresponding message: IGD56231I

04A4 (1188) Meaning: Subsystem request in error. (dsname allocation)3

Application programmer action: Ensure that the subsystem is installed on the processor on which the allocation request will run.

Corresponding message: No corresponding dynamic allocation message

04A8 (1192) Meaning: Subsystem does not support allocation through key DALSSNM. (dsname allocation)

Application programmer action: Do not attempt to dynamically allocate a data set for this subsystem.

Corresponding message: No corresponding dynamic allocation message

04AC (1196) Meaning: Subsystem is not operational.

Application programmer action: Ensure that the operator makes the subsystem operational on the processor on which the allocation request will run. Resubmit the request.

Corresponding message: No corresponding dynamic allocation message

04B0 (1200) Meaning: Subsystem does not exist.

Application programmer action: Ensure that the subsystem is installed on the processor on which the allocation request will run.

Corresponding message: No corresponding dynamic allocation message

04B4 (1204) Meaning: Protect request not processed; RACF not in system or not active.

Application programmer action: If DASD data set or tape volume protection is required, contact the RACF administrator for assistance.

Corresponding Messages: IJK56891I, IKJ56892I

04C0 (1216) Meaning: Protect request failed; user not defined to RACF. (dsname allocation)

Application programmer action: If DASD data set or tape volume protection is required, contact the RACF administrator for assistance in getting defined to RACF.

Corresponding message: No corresponding dynamic allocation message

04C4 (1220) Meaning: The last request was for a VOL=REF to a dsname or DCB=dsname that exceeded the maximum allowable dsname backward references. (A maximum of 1489 backward references are allowed if the data set names are 44 characters in length.)

Application programmer action: Reduce the number of dsname backward references.

Corresponding message: No corresponding dynamic allocation message

04C8 (1224) Meaning: Unexpected return code encountered in internal MVS processing. This problem might have resulted from installation modification of the eligible device table (EDT). (system or installation error)

System programmer action: If the installation has modified the EDT, use the ACTIVATE command or re-IPL the system to restore the EDT that existed prior to modification. If the installation has not modified the EDT, contact the IBM support center.

Corresponding message: IKJ56231I

04CC (1228) Meaning: Invalid output descriptor or invalid ddname reference.

System programmer action: Check and correct the list of output descriptors and ddname references. Resubmit the request.

Corresponding message: IJK56895I

04D0 (1232) Meaning: SMS (Storage Management Subsystem) is not available or is at the wrong level. For allocation requests specifying pathname, the correct release of DFSMS/MVS must be installed.

Application programmer action: Determine whether the data set currently resides on or is to reside on an SMS-managed volume. Contact your system programmer to find out the status of SMS on your system.

Corresponding message: No corresponding dynamic allocation message

04D4 (1236) Meaning: User does not have RACF authority to allocate the specified device.

Application programmer action: Request a device that you are authorized to access or notify your security administrator.

Security Administrator Action: Determine if the user should have access to the given device. If so, define a RACF profile authorizing the user access to that device.

Corresponding message: IJK56899I.

04D8 (1240) Meaning: Unable to concatenate data sets allocated with incompatible services. Application programmer action: Do not attempt to concatenate a data set with a TIOT entry and a data set with an extended TIOT entry.

Corresponding message: No corresponding dynamic allocation message

04DC (1244) Meaning: The Scheduler JCL Facility (SJF) is not available. It either does not exist in the current system or the system is unable to locate it.

Application programmer action: Notify the system programmer.

System programmer action: Search problem reporting data bases for a fix for the problem. If no fix exists, first determine if ABEND05C RSN 0701 was issued. IF not, take a Console Dump of Master, and if an IPL is needed to resolve the problem, a Stand Alone Dump. Then contact the IBM Support Center, providing the above dump or dumps.

Corresponding message: No corresponding message for this error condition. Similar conditions may result in message IEF345I. The actions are the same in either case.

04E0 (1248) Meaning: The actual or captured UCB attributes for the DD statements to be concatenated to not match.

Application programmer action: Ensure that the actual or captured UCB attributes for the DDs being concatenated are compatible.

Corresponding message: No corresponding dynamic allocation message.

04E4 (1252) Meaning: Unable to unload volume on an Autoswitch device due to a Coupling Facility error.

Application programmer action: Rerun the job. If the error persists, notify the system programmer.

System programmer action: If the system goes into automatic rebuild state, wait until the rebuild completes (indicated by message IEF268I). If the rebuild was not successful, or did not occur, take actions to correct the hardware errors indicated by the coupling facility. Once corrected, if the system does not initiate an automatic rebuild, then issue the SETXCF START,REBUILD command with the appropriate options to perform a manual rebuild of the IEFAUTOS structure. Once the rebuild is successful (indicated by message IEF268I), rerun the job. If you cannot resolve the problem, search the problem reporting data bases for a fix. If not fix exists, contact your IBM support center, providing the SYS1.LOGREC error record.

Corresponding message: IEF241I

04E5 (1253) Meaning: The system cannot allocate tape devices, because a tape allocation subsystem eliminated all eligible devices from consideration.

Application programmer action: Notify the system programmer.

System programmer action: Determine which subsystem is causing the problem. Contact the appropriate tape subsystem vendor or service personnel.

Corresponding message: IEF391I

04EC (1260) Meaning: Unable to allocate an automatically switchable tape device, because the only eligible device(s) is(are) assigned to a foreign host (for example, a system not connected to the same IEFAUTOS structure, or is connected to the same structure but is using the device as a dedicated device).

Application programmer action: Notify the system operator.

System Operator Action: Determine which system has the device assigned. Issue the DISPLAY U,,, command from each system that can vary the device online. In response, message IEE457I identifies the devices assigned to that system with the letter R, (meaning reserved). If message IEE457I does not also identify the device with the letter A (meaning allocated), or one of the other status codes for message IEE457I meaning allocated to system (SYS), hardware error (BOX), busy (BSY) or other code indicating the device is unavailable, and you want to make the device available to the system on which the job or application was running, do the following:
  • Vary the device offline from the system it is currently assigned to.
  • Vary the device online to the system the job or application was running on at the time of error.
  • Rerun the job or restart the application that encountered the error.

Otherwise, CANCEL the job or application and try again later when the device becomes available.

Corresponding message: IEF284I

04F0 (1264) Meaning: On a request to dynamically concatenate DD statements, the system detected that the DSABs for the requested concatenation do not all reside in the same (above-the-line or below-the-line) storage location.
Note: All DSABs for batch allocated DD statements (JCL) reside in below-the-line storage. Dynamically allocated DD statements can request that their DSABs not reside in below-the-line storage by setting the S99DSABA or S99DXACU indicator in the SVC 99 Request Block (S99RB).

Application programmer action: Ensure that the DSABs for all DDs being concatenated reside below the line or that they all reside above the line.

Corresponding message: IEF893I

04F4 (1268) Meaning: On a request to generate a DDNAME for a dynamic allocation, the system detected that the task was at its maximum allowable limit of 99,999 for system-generated DDNAMEs.

Application programmer action: Either reduce the number of concurrent DDNAME allocations or avoid using system-generated DDNAMEs.

Corresponding message: IKJ56227I

04F8 (1272) Meaning: During a spool data set browse allocation request, JES2 determined that the data set was uninitialized (PDBMTTR was zero).

Application programmer action: Resubmit the spool browse request.

System programmer action: If the application programmer action does not resolve the issue, search the problem reporting data bases for a fix for the problem. If no fix exists, contact the IBM Support Center. The S99INFO field may contain an internal informational code which can be reported to the IBM Support Center.

Corresponding message: IEF016I

04FC (1276) Meaning: The request being processed would cause the TCT I/O table to exceed the maximum allowable size.

Application programmer action: If the job that received the message has JCL DD statements that specify a high volume count, or the job that received the message uses dynamic allocation to allocate data sets and specifies a high volume count, reduce the volume count and rerun the job. If the volume count is derived from the data class, use a data class which has a lower volume count or contact the Storage Administrator.

Storage Administrator Action: Reduce the volume count or dynamic volume count specified in the DATACLAS.

Corresponding message: IEF020I

04FD (1277) Meaning: Dynamic allocation request was for an esoteric that contains both TAPE and NONTAPE devices.

Application programmer action: Change the request to use a different esoteric that does not contain both TAPE and NONTAPE devices and resubmit. Otherwise, notify the system programmer.

System programmer action: Change the esoteric definition in the IODF so it will not mix TAPE and NONTAPE devices. ACTIVATE the new IODF and resubmit the request.

Corresponding message: IEF898I

04FE (1278) Meaning: Dynamic allocation request was for a tape device that was marked unavailable for allocation.

Application programmer action: Change the device status using the VARY dev,AVAILABLE or VARY dev,ONLINE command and resubmit the request. Otherwise, notify the system programmer.

System programmer action: Vary the device available and resubmit the request.

Corresponding message: IEF022I

Notes:
1
The information reason code field contains 0004 if the requested function was performed, although an error occurred as the error reason code indicates.
2
See Control limit and Considerations when requesting dsname or pathname allocation for a description of these resources.
3
The information reason code contains a subsystem-defined value to further describe the error. This value is documented in publications associated with the particular subsystem.
Table 4. Class 7 Error Reason Codes (System Routine Error)
Hex code Meaning and action
17zz CATALOG LOCATE error. LOCATE, DADSM, CATALOG, and OBTAIN errors are explained in z/OS DFSMSdfp Advanced Services. '08', '18', '2C', 'BA' are the only expected LOCATE return codes. 'FF' is returned as the value of zz if an unexpected return code is returned by LOCATE. (dsname allocation)

The expected return codes are:

1704 Meaning: Unknown HSM error.

Application programmer action: See message IDC3009I return code 38, reason code 4 for further explanation.

Corresponding message: IKJ56238I

1708 Meaning: One of the following occurred:
  • The data set name specified is in error. (program error)
  • A system error occurred when processing the data set name.
In the request block, the S99INFO field contains the text unit key instead of an information reason code. See the corresponding message for the specific error.

Application programmer action: Ensure that the correct data set name was specified. If a generation data group (GDG) level of index was coded for a non-GDG data set, remove the level of index and resubmit the job. Otherwise, this is probably a system error. Resubmit the request. If the problem persists, report the associated messages and DYNALLOC error codes to your system programmer.

System programmer action: If the problem recurs and no installation action corrects the problem, search problem reporting data bases for a fix for the problem. If no fix exists, contact the appropriate IBM support personnel.

Corresponding Messages: IKJ56228I or IKJ56229I

1718 Meaning: Permanent I/O error processing cataloged data set. (system error)

Application programmer action: Report the messages and DYNALLOC error codes to your system programmer or operator.

System programmer action: Contact hardware support.

Corresponding message: IKJ56231I

172C Meaning: Insufficient real or virtual storage for processing cataloged data set. (environmental error)

Application programmer action: Resubmit the request. If the problem persists, consult the operator to determine if another user in the installation is causing the problem, or if the entire installation is experiencing storage constraint problems.

Corresponding message: IKJ56863I

1732 Meaning: During a dynamic allocation, a request was made to recall a migrated data set. This recall normally runs synchronously, but the installation's storage administrator has implemented a standard patch to HSM to cause the recall to be done in the background (asynchronously).

Application programmer action: Retry the dynamic allocation later.

Corresponding message: IKJ56242I

1734 Meaning: During a dynamic allocation, a request was made to recall a migrated data set. This recall normally runs synchronously, but the user converted it to a background (asynchronous) request by pressing the ATTN or PA1 keys.

TSO user action: Retry the dynamic allocation later.

Corresponding message: IKJ56243I

17BA Meaning: An unsuccessful attempt was made to access a catalog that was locked for recovery. The job does not have the proper authorization to perform this function. (program error)

Application programmer action: Either obtain the proper authorization, or wait until the catalog is unlocked and resubmit the request.

Corresponding message: IKJ56896I

17FF Meaning: An unexpected return code was returned by catalog LOCATE. (system error)

Application programmer action: If a GDG level of index was coded for a non-GDG data set, remove the level of index and resubmit the job. Otherwise, this is probably a system error. Report this message to the system programmer.

System programmer action: If the problem recurs, search problem reporting data bases for a fix for the problem. If no fix exists, contact the IBM Support Center.

Corresponding message: IKJ56231I

47zz DADSM allocate error. LOCATE, DADSM, CATALOG, and OBTAIN errors are explained in z/OS DFSMSdfp Advanced Services. (dsname allocation)

Information reason codes which accompany error reason codes of 47zz are actually DADSM subfunction reason codes, which are explained in z/OS DFSMSdfp Diagnosis.

The expected reason codes are as follows:

4704 Meaning: Duplicate data set name on the volume identified by message IKJ56229I. (program error)

Application programmer action: If the specified data set is a new data set, select a unique name for it. If you intended to specify a data set that is already on the direct access device, specify OLD, SHR, or MOD in the DISP keyword. Resubmit the request.

Corresponding message: IKJ56229I

4708 Meaning: The volume table of contents (VTOC) for the specified or defaulted volume for a new data set request
  • Had insufficient space in the VTOC index for a new entry, or
  • Did not have the minimum number of data set control blocks (DSCBs) required to allocate the data set. (environmental error).

Application programmer action: Request space on a different volume and resubmit the request.

Corresponding message: IKJ56229I

470C Meaning: Space on the direct access storage device (DASD) containing the requested volume could not be obtained because of one of the following environmental or installation errors:
  • A permanent I/O error.
  • A incorrect format-1 data set control block (DSCB).
  • A structure error in the volume table of contents (VTOC) index.

Application programmer action: Request space on a different volume and resubmit the request. Record the error codes and associated messages and report the problem to your operator or system programmer.

System programmer action: Record the error codes, associated messages, and failing device, and report the problem to the appropriate hardware support personnel.

Corresponding message: IKJ56231I

4710 Meaning: Requested absolute track not available (environmental error).

Application programmer action: Request different absolute tracks, or request non-specific space, or request space on a different volume. Resubmit the request.

Corresponding message: IKJ56231I

4714 Meaning: More space was requested than is available on the DASD volume, or the DASD volume's VTOC is full, or the DASD volume's VTOC Index (VTOCIX) is full. (environmental error)

Application programmer action: Check the validity of the track quantity specified on the space quantity specification text unit keys. If it was incorrect, change it. If it was correct, change the request to a different volume. Resubmit the request. System programmer action: Enlarge the VTOC or VTOCIX as necessary.

Corresponding message: IKJ56245I

4718 Meaning: The average block length specified on text unit key DALAVGR (key 0009) was greater than the track capacity of the requested DASD volume. (environmental error)

Application programmer action: Reduce the lengths of the records to make the average length no greater than the track capacity of the device, or specify a device with a greater track capacity. Resubmit the request.

Corresponding message: IKJ56229I

4730 Meaning: Invalid DADSM REALLOC parameter list.

Application programmer action: Consult the z/OS DFSMSdfp Advanced Services, correct the parameter list, and resubmit the request.

4738 Meaning: The system did not allocate the directory for a new partitioned data set (PDS) because the space requested for the directory on text unit key DALDIR (key 000C) exceeded the space available on the specified volume. (environmental error)

Application programmer action: Reduce the directory quantity specified or request a different volume. Resubmit the request.

Corresponding message: IKJ56244I

474C Meaning: No space parameter given for a new data set or zero space requested at absolute track zero.

Application programmer action: Correct the specification of space information and resubmit.

Corresponding message: IKJ56231I

47A8 Meaning: A profile for the specified data set on this volume already exists in the Resource Access Control Facility (RACF) data set. (environmental error)

Application programmer action: Action may not be necessary. You may change the data set name or volume serial, or have the installation RACF administrator delete from the RACF data set the profile for the specified data set on this volume, and resubmit the request.

Corresponding message: IKJ56889I

47AC Meaning: User not authorized to define this data set. The user has the automatic data set protection characteristic without the RACF authorization to define data sets. (program error)

Application programmer action: Contact your RACF administrator to remove the automatic data set protection characteristic from the user profile, or to authorize the user to define data sets. Resubmit the request.

Corresponding message: IKJ56888I

47B0 Meaning: Installation exit rejected this request with return code 8. The information reason code (S99INFO) contains a reason code returned by the installation exit. (installation or environmental error

Application programmer action: Refer to your installation procedures to determine the cause of the failure as indicated by the reason code. If appropriate, notify your system programmer of the problem.

Corresponding message: IKJ56222I

47B4 Meaning: Space request rejected by installation exit. (environmental error)

Application programmer action: Refer to your installation procedures to determine the cause of the failure as indicated by the reason code that was assigned by the installation. Check the space specification text unit keys to ensure that they follow installation requirements for space requests. If they do not, correct the text unit keys and resubmit the request. If the text unit keys specify the space request correctly, notify your system programmer of the problem.

Corresponding message: IKJ56223I

47C0 Meaning: Non-SMS managed data set cannot be created on an SMS-managed volume. Message IKJ56897I indicates the specific operation that was rejected. (program error)

Application programmer action: Change the text unit requirements and resubmit the request.

Corresponding message: IKJ56897I

47FF Meaning: An unexpected or internal error code was received by Allocation. (system, installation, or environmental error)

Application programmer action: Note the information reason code (S99INFO). If it appears in the list of DADSM CREATE Return Codes in z/OS DFSMSdfp Diagnosis, then take appropriate action for that return code. If not, record the error codes and associated messages and report the problem to your system programmer.

Corresponding message: IKJ56231I

57zz CATALOG error. LOCATE, DADSM, CATALOG, and OBTAIN errors are explained in z/OS DFSMSdfp Advanced Services. (dsname allocation)

The specific meanings for expected CATALOG return codes are as follows:

5704 Meaning: Required CATALOG volume is currently not mounted. (environmental error)

Application programmer action: If possible, use another catalog. Otherwise, check with your system administrator or operator to see if the volume containing this catalog can be mounted.

Corresponding message: IKJ56880I

5708 Meaning: Either the existing catalog structure is inconsistent with the operation, or the program was not authorized to perform the operation.

Application programmer action: Consult the z/OS DFSMSdfp Advanced Services, correct the error, and resubmit the request.

5710 Meaning: The index structure necessary to catalog the data set does not exist.

Application programmer action: Consult the z/OS DFSMSdfp Advanced Services, correct the error, and resubmit the request.

5714 Meaning: CATALOG space is exhausted on the control volume. (environmental error)

Application programmer action: If possible, use another catalog. Otherwise, record the error codes and associated messages and report the error to your system programmer.

Corresponding message: IKJ56231I

5718 Meaning: A CATALOG I/O error has occurred (system error).

Application programmer action: Resubmit the request. If the problem persists, record the error codes and associated message(s) and report the error to your system programmer.

System programmer action: Record the error codes, associated messages, and failing device, and report the problem to the appropriate hardware support personnel.

Corresponding message: IKJ56231I

571C Meaning: One of the following occurred:
  • An error was found in a parameter list
  • There was a non-zero return code from ESTAE or GETMAIN
  • A permanent I/O or unrecoverable error was encountered.

Application programmer action: Consult the z/OS DFSMSdfp Advanced Services, to correct an error in the CATALOG parameter list, and resubmit the request. For actions to take for a non-zero return code from ESTAE or GETMAIN, consult z/OS MVS Programming: Assembler Services Reference ABE-HSP (for unauthorized programs), or z/OS MVS Programming: Authorized Assembler Services Reference EDT-IXG for authorized programs. For a permanent I/O or unrecoverable error, contact your system programmer and supply the reason code.

67zz OBTAIN error. LOCATE, DADSM, CATALOG, and OBTAIN errors are explained in z/OS DFSMSdfp Advanced Services. (dsname allocation, information retrieval)

The expected OBTAIN return codes are:

6708 Meaning: Data set not on volume as indicated in the catalog or volume text unit (installation or system error). See message IKJ56232I for more information.

Application programmer action: Delete the catalog entry (use DELETE command with NOSCRATCH keyword) and recreate the data set if necessary.

Corresponding message: IKJ56232I

670C Meaning: OBTAIN I/O error During data set allocation, an uncorrectable I/O error occurred when the system attempted to obtain a data set control block (DSCB). (system error)

Application programmer action: Resubmit the request. If the problem persists, record the error codes and associated messages and report the error to your system programmer.

System programmer action: Record the error codes, associated message(s) and failing device and report the problem to the appropriate hardware support personnel.

Corresponding message: IKJ56231I

6710 Meaning: An invalid work area pointer was supplied.

Application programmer action: Consult the z/OS DFSMSdfp Advanced Services, correct the work area pointer, and resubmit the request.

6714 Meaning: The absolute address passed was not within the boundaries of the VTOC.

Application programmer action: Consult the z/OS DFSMSdfp Advanced Services, correct the absolute address, and resubmit the request.

7700 Meaning: Subsystem error. (dsname allocation)

Application programmer action: Consult the publications associated with the particular subsystem for the meaning of the subsystem-defined value, and take the appropriate action.

7704 Meaning: A subsystem interface system error occurred while processing a request for allocation of a subsystem data set (text key DALSSNM - key 005F).

Application programmer action: Resubmit the request. If the problem persists, consult the subsystem documentation and installation documentation to ensure both the subsystem name and data set are supported in your installation. If the request is correct, record the name of the requested subsystem and subsystem data set, error code and any associated messages and report the problem to your system programmer.

System programmer action: Ensure that the requested subsystem and subsystem data set are correct and available. If so, supply the subsystem name, data set name, error code, and associated messages to the appropriate IBM support personnel.

Corresponding message: IKJ56231I

8700 Meaning: Scheduler JCL Facility (SJF) error. This may be due to a system failure due to insufficient storage when allocating a VIO data set. (environmental or system error)

Application programmer action: Resubmit the request. If the problem persists, report the DYNALLOC error code and any associated messages to your system programmer, who can supply it to the appropriate IBM support personnel.

Corresponding message: No corresponding dynamic allocation message

8704 Meaning: Scheduler JCL Facility access function error. (system error)

Application programmer action: Resubmit the request. If the problem persists, report the DYNALLOC error code, information reason code, and any associated message(s) to your system programmer, who can supply it to the appropriate IBM support personnel.

Corresponding message: No corresponding dynamic allocation message

8708 Meaning: Mutual exclusivity checker error.(system error)

Application programmer action: Resubmit the request. If the problem persists, report the DYNALLOC error code, information reason code, and any associated messages to your system programmer, who can supply it to the appropriate IBM support personnel.

Corresponding message: No corresponding dynamic allocation message

870C Meaning: Scheduler JCL facility (SJF) information retrieval service error, for which there is no corresponding specific dynamic allocation reason code.

Application programmer action: Resubmit the request. If the problem persists, report the DYNALLOC error code and information code and any associated messages to your system programmer, who can supply it to the IBM Support Center.

Corresponding message: No corresponding dynamic allocation message

9700

Meaning: Severe storage management subsystem (SMS) IDAX, ACS and Construct Access Services error.

Application programmer action: Check field S99ERSN for a non-zero value. A non-zero value in S99ERSN is a reason code. See SMS reason code (S99ERSN) for the possible reason codes. If the system displayed message IKJ56893I, SMS messages for the error follow IKJ56893I. If the system displayed message IKJ56894I, no messages were returned. Request the message processing option of dynamic allocation to obtain related messages and resubmit the request. If you still cannot obtain messages, contact your system programmer for assistance.

Corresponding Messages: IKJ56893I (messages were displayed) or IKJ56894I (messages not displayed).

9704 Meaning: Severe SMS CATALOG service error.

Application programmer action: Check field S99ERSN for a non-zero value. A non-zero value in S99ERSN is a reason code. See SMS reason code (S99ERSN) for the possible reason codes. If the system displayed message IKJ56893I, SMS messages for the error follow IKJ56893I. If the system displayed message IKJ56894I, no messages were returned. Request the message processing option of dynamic allocation to obtain related messages and resubmit the request. If you still cannot obtain messages, contact your system programmer for assistance.

Corresponding Messages: IKJ56893I (messages were displayed) or IKJ56894I (messages not displayed).

9708 Meaning: Severe SMS VOLREF service error.

Application programmer action: Check field S99ERSN for a non-zero value. A non-zero value in S99ERSN is a reason code. See SMS reason code (S99ERSN) for the possible reason codes. If the system displayed message IKJ56893I, SMS messages for the error follow IKJ56893I. If the system displayed message IKJ56894I, no messages were returned. Request the message processing option of dynamic allocation to obtain related messages and resubmit the request. If you still cannot obtain messages, contact your system programmer for assistance.

Corresponding Messages: IKJ56893I (messages were displayed) or IKJ56894I (messages not displayed).

970C Meaning: Severe SMS VTOC service error.

Application programmer action: Check field S99ERSN for a non-zero value. A non-zero value in S99ERSN is a reason code. See SMS reason code (S99ERSN) for the possible reason codes. If the system displayed message IKJ56893I, SMS messages for the error follow IKJ56893I. If the system displayed message IKJ56894I, no messages were returned. Request the message processing option of dynamic allocation to obtain related messages and resubmit the request. Because SMS creates entries in the logrec data set, if you still cannot obtain messages, locate the logrec data set entry for the error that corresponds to the reason code. If you need further assistance contact your system programmer.

Corresponding Messages: IKJ56893I (messages were displayed) or IKJ56894I (messages not displayed).

9710 Meaning: Severe SMS DISP service error.

Application programmer action: Check field S99ERSN for a non-zero value. A non-zero value in S99ERSN is a reason code. See SMS reason code (S99ERSN) for the possible reason codes. If the system displayed message IKJ56893I, SMS messages for the error follow IKJ56893I. If the system displayed message IKJ56894I, no messages were returned. Request the message processing option of dynamic allocation to obtain related messages and resubmit the request. If you still cannot obtain messages, contact your system programmer for assistance.

Corresponding Messages: IKJ56893I (messages were displayed) or IKJ56894I (messages not displayed).

9714 Meaning: Severe SMS COPY SWB service error.

Application programmer action: Check field S99ERSN for a non-zero value. A non-zero value in S99ERSN is a reason code. See SMS reason code (S99ERSN) for the possible reason codes. If the system displayed message IKJ56893I, SMS messages for the error follow IKJ56893I. If the system displayed message IKJ56894I, no messages were returned. Request the message processing option of dynamic allocation to obtain related messages and resubmit the request. If you still cannot obtain messages, contact your system programmer for assistance.

Corresponding Messages: IKJ56893I (messages were displayed) or IKJ56894I (messages not displayed).

9718 Meaning: Error during SMS UNITAFF processing.

Application programmer action: Check field S99ERSN for a non-zero value. A non-zero in S99ERSN is a reason code. See SMS reason code (S99ERSN) for the possible reason codes. If the system displayed message IKJ56893I, SMS messages for the error follow IKJ56893I. If the system message IKJ56894I, no messages were returned. Request the message processing option of dynamic allocation to obtain related messages and resubmit the request. If you still cannot obtain messages, contact your system programmer for assistance.

Corresponding messages: IKJ56893I (messages were displayed) or IKJ56894I

971C Meaning: Severe SMS dataset stacking error.

Application programmer action: Check field S99ERSN for a non-zero value. See SMS reason code (S99ERSN) for the possible reason codes. If the system displayed message IKJ56893I, SMS messages for the error follow IKJ56893I. If the system displayed message IKJ56894I, no SMS messages were returned. Request the message processing option of dynamic allocation to obtain related messages and resubmit the request since SMS creates entries in the logrec data set. If you still cannot obtain messages, locate the logrec data set entry for the error that corresponds to the reason code. If you need assistance, contact your system programmer.

Corresponding message: IKJ56893I (messages were displayed) or IKJ56894I.

9720 Meaning: Severe SMS device pool service error.

Application programmer action: Check field S99ERSN for a non-zero value. See SMS reason code (S99ERSN) for the possible reason codes. If the system displayed message IKJ56893I, SMS messages for the error follow IKJ56893I. If the system displayed message IKJ56894I, no SMS messages were returned. Request the message processing option of dynamic allocation to obtain related messages and resubmit the request since SMS creates entries in the logrec dataset. If you still cannot obtain messages, locate the logrec dataset entry for the error that corresponds to the reason code. If you need further assistance, contact your system programmer for assistance.

Corresponding messages: IKJ56893I (messages were displayed) or IKJ56894I (messages not displayed).

9724 Meaning: The allocation request failed because SMS provided MVS Allocation with a Library Device Pool name that could not be found in the active EDT for this allocation.

This condition is primarily caused during the time after a job has entered, but has not yet completed. Device Allocation and a new SMS Library Device Pool is introduced into the configuration via a Dynamic Activate.

System programmer action: Ensure that there are no outstanding configuration Activates. If there are none, search problem reporting databases for a fix for the problem. If no fix is found, contact the IBM Support Center.

Corresponding message: IEF124I

9728 Meaning: System error while allocating a device (allocation ABEND occurred - system error).

Application programmer action: Resubmit the request. If the problem persists, report the error code and any associated messages to your system programmer, who can supply it to the appropriate IBM support personnel.

Corresponding message: No corresponding dynamic allocation message

A700 Meaning: The automatic restart manager (ARM) encountered an error retrieving a copy of the symbol table from the system on which this job originated. Some of the possible errors (return code/reason code) are:
08 / AE8
A problem occured verifying the input ASCB's storage.
08 / AF0
Data was found in one or more of the reserved fields in the input parameter list.
08 / AFC
No ARB was found through the ASCB in the CopyTable.
08 / BA4
The ASST header is not valid or the ARB does not show a table.
08 / BB0
The Area for CopyTable is not valid.

System programmer action: Search problem reporting data bases for a fix for the problem. If no fix exists, contact the IBM Support Center. Provide the SYSLOG or OPERLOG from the failing system and any dumps taken by the system.

Corresponding message: No corresponding dynamic allocation message