DFS2859I DIAGNOSE COMMAND UNSUCCESSFUL - reason text
Explanation
A non-fatal error was encountered that prevented the /DIAGNOSE command from completing successfully. The message is issued at any point in the code that a non-fatal, non-serious error condition is encountered.
In the message
text:
- reason text
- Identifies the specific error encountered:
- AOS=N WAS SPECIFIED
- A /DIAGNOSE SET AOSLOG() command was issued where AOS logging was prohibited by an IMS startup parameter.
- block UNAVAILABLE
- A /DIAGNOSE SNAP BLOCK(block) command was issued when the block control block was not available or not defined.
- CLASS INVALID WITH OUTPUT OPTION
- A /DIAGNOSE SNAP command was issued with the CLASS() parameter, but the output OPTION() parameter was not SYSOUT. The CLASS() option is valid only with OPTION(SYSOUT). Change the command to use OPTION(SYSOUT) or delete CLASS(), and then reissue the command.
- CLASS(class) INVALID
- A /DIAGNOSE SNAP command was issued with the CLASS() parameter, and an invalid class was specified. Valid values for the class are: A-Z and 0-9. Change the class to one of the valid values and reissue the command.
- FORMAT INVALID WITH OPT(OLDS)
- A /DIAGNOSE SNAP command was issued with OPTION(OLDS) and the FORMAT keyword. The FORMAT keyword is not valid with OPTION(OLDS).
- FORMAT INVALID WITH OPT(TRACE)
- A /DIAGNOSE SNAP command was issued with OPTION(TRACE) and the FORMAT keyword. The FORMAT keyword is not valid with OPTION(TRACE).
- INVALID ADDRESS VALUE SPECIFIED
- A /DIAGNOSE SNAP command was issued with ADDRESS(address) where the address specified was beyond the maximum address allowed: X'7FFFFFFF'.
- INVALID LENGTH VALUE SPECIFIED
- A /DIAGNOSE SNAP command was issued with ADDRESS(address) LENGTH(length) where the length specified was beyond the maximum length allowed: address + length <= X'7FFFFFFF'.
- INVALID LIMIT(limit) MAX=maximum
- A /DIAGNOSE SNAP command was issued with the LIMIT() parameter, and the limit value was out of range for the OPTION() specified. Change the output option from OPTION(DISPLAY) to OPTION(SYSOUT), or change the limit to be less than or equal to the maximum value in the message text; and then reissue the command. See the LIMIT() parameter description for more information about the valid ranges for LIMIT() with OPTION(DISPLAY) and OPTION(SYSOUT).
- INVALID OLR resource SHOW OPTION
- A /DIAGNOSE SNAP command was issued for an OLR region where an invalid block name was specified. The VTD, ASCB, ASSB, DPDIR, IWALE, LESEP, DRAT, and IDT blocks are not available, and therefore not valid, for an OLR region.
- INVALID resource SHOW OPTION
- A /DIAGNOSE SNAP command was issued where the SHOW option keyword or block name was invalid for the specified resource type.
- LIMIT INVALID WITH OPT(OLDS)
- LIMIT INVALID WITH OPTION(OLDS)
- A /DIAGNOSE SNAP command was issued with OPTION(OLDS) and a LIMIT(linecount) was specified. The LIMIT parameter is not valid with OPTION(OLDS).
- LIMIT INVALID WITH OPT(TRACE)
- LIMIT INVALID WITH OPTION(TRACE)
- A /DIAGNOSE SNAP command was issued with OPTION(TRACE) and a LIMIT(linecount) was specified. The LIMIT parameter is not valid with OPTION(TRACE).
- NO VALID BLOCKS FOR resource
- No valid blocks were found for the specified resource and SHOW() options. Ensure that the correct resource was specified and that valid SHOW() options for that resource were specified.
- resource(parameter) NOT FOUND
- A /DIAGNOSE SNAP command was issued where the parameter for the specified resource type was not found.
- RM(ONLY) INVALID, RM UNAVAILABLE
- A /DIAGNOSE SNAP command was issued with the RM(ONLY) parameter, and a Resource Manager is not available. Change or remove the RM() parameter and reissue the command.
- SNAP RESOURCE NOT FOUND
- A /DIAGNOSE SNAP command was issued where the parameter for the specified resource type was not found.
- SNAP RESOURCE NOT SPECIFIED
- A /DIAGNOSE SNAP command was issued without a SNAP resource type specified.
- UNABLE TO GET DIAG TRACE TABLE
- A /DIAGNOSE SNAP command was issued with OPTION(TRACE) when a DIAG trace table was not available for use.
System action
The specified /DIAGNOSE command does not complete.
Operator response
Check the command text, correct any errors, and issue the command again.
System programmer response
No action is required.