Restrictions while debugging Enterprise PL/I programs

While debugging Enterprise PL/I programs, you cannot use the following commands:

  • ANALYZE
  • AT ALLOCATE (of a controlled variable)
  • AT OCCURRENCE CONDITION conditions (name)
  • GOTO LABEL

While debugging Enterprise PL/I programs, the following restrictions apply:

  • If you are running any version of VisualAge® PL/I or Enterprise PL/I Version 3 Release 1 through Version 3 Release 3 programs, you cannot use the AT LABEL command.
  • If you are running Enterprise PL/I for z/OS®, Version 3.4, or later, programs and you comply with the following requirements, you can use the AT LABEL command to set breakpoints (except at a label variable):
    • If you are compiling with Enterprise PL/I Version 3 Release 4, apply PTFs for APARs PK00118 and PK00339.
  • For expressions, you cannot do either of the following:
    • preface variables with the block, CU, and load module qualification
    • Reference or list at the block entry
  • You cannot use some of built-in functions. See Supported PL/I built-in functions for more information.
  • You cannot use the DECLARE command to declare arrays, structures, or multiple variables in one line
  • The SET WARNING ON command has no effect.
  • For typed structures, the following restrictions apply:

    z/OS Debugger does not support the debugging of PL/I typed structures for procedures compiled with the Enterprise PL/I V4R1 or earlier compiler releases. A typed structure is a variable or structure that is declared as TYPE X, where X is declared using DEFINE STRUCTURE.

    z/OS Debugger supports the debugging of PL/I typed structures for procedures compiled with the Enterprise PL/I V4R2 or later compilers. You can use the TEST (SEPARATE) options at compile time to get the full benefit of this support.

    With a few exceptions, references to typed structures require the qualified name of an elementary member. For nested typed structures, any parent that has a type reference in its declaration must be included in the qualification. References to the structure type or references that are qualified to an intermediate level of a typed structure cannot be resolved. (See the Enterprise PL/I Language Reference Manual for more information about typed structures.)

    Typed structure references are supported for the following:
    • ASSIGNMENT:
      • A typed structure that is assigned to a typed structure of the same type
      • A handle that is assigned to a handle declared as the same type
      • A value that is assigned to an elementary member of a typed structure
    • COMPARISONS
    • AUTOMONITOR
    • DESCRIBE ATTRIBUTES
    • LIST
    • LIST STORAGE()