ANALYZE command (PL/I)

The ANALYZE command displays the process of evaluating an expression and the data attributes of any intermediate results. To display the results of the expression, use the LIST command.

Read syntax diagramSkip visual syntax diagramANALYZEEXPRESSION(expression);
EXPRESSION
Requests that the accompanying expression be evaluated from the following points of view:
  • What are the attributes of each element during the evaluation of the expression?
  • What are the dimensions and bounds of the elements of the expression, if applicable?
  • What are the attributes of any intermediate results that will be created during the processing of the expression?
expression
A valid z/OS® Debugger PL/I expression.

Usage notes

  • If SET SCREEN ON is in effect, and you want to issue ANALYZE EXPRESSION for an expression in your program, you can bring the expression from the Source window up to the command line by typing over any character in the line that contains the expression. Then, edit the command line to form the desired ANALYZE EXPRESSION command.
  • If SET WARNING ON is in effect, z/OS Debugger displays messages about PL/I computational conditions that might be raised when evaluating the expression.
  • Although the PL/I compiler supports the concatenation of GRAPHIC strings, z/OS Debugger does not.
  • The ANALYZE command cannot be used to debug Enterprise PL/I programs.
  • The ANALYZE command cannot be used while you replay recorded statements by using the PLAYBACK commands.
  • The ANALYZE command cannot be used while you debug a disassembled program.

Example

This example is based on the following program segment: 
DECLARE lo_point FIXED BINARY(31,5);
DECLARE hi_point FIXED BINARY(31,3);
DECLARE offset FIXED DECIMAL(12,2);
DECLARE percent CHARACTER(12);
lo_point = 5.4; hi_point = 28.13; offset = -6.77;
percent = '18';
The following is an example of the information prepared by issuing ANALYZE EXPRESSION. Specifically, the following shows the effect that mixed precisions and scales have on intermediate and final results of an expression: 
ANALYZE EXPRESSION ( (hi_point - lo_point) + offset / percent )
>>> Expression Analysis <<<
 ( HI_POINT - LO_POINT ) + OFFSET / PERCENT
|   HI_POINT - LO_POINT
|  |   HI_POINT
|  |   FIXED BINARY(31,3) REAL
|  |   LO_POINT
|  |   FIXED BINARY(31,5) REAL
|   FIXED BINARY(31,5) REAL
|   OFFSET / PERCENT
|  |   OFFSET
|  |   FIXED DECIMAL(12,2) REAL
|  |   PERCENT
|  |   CHARACTER(12)
|   FIXED DECIMAL(15,5) REAL
 FIXED BINARY(31,17) REAL

Refer to the following topics for more information related to the material discussed in this topic.