Terms used in this document

Because of differing terminology among the various programming languages supported by z/OS Debugger, as well as differing terminology between platforms, a group of common terms is established. The following table lists these terms and their equivalency in each language.

z/OS Debugger term C and C++ equivalent COBOL or LangX COBOL equivalent PL/I equivalent assembler
Compile unit C and C++ source file Program
  • Program
  • PL/I source file for Enterprise PL/I
  • A package statement or the name of the main procedure for Enterprise PL/I1
 CSECT
Block Function or compound statement Program, nested program, method, or PERFORM group of statements Block CSECT
Label Label Paragraph name or section name Label Label
Note:
  1. The PL/I program must be compiled with and run in one of the following environments:
    • Compiled with Enterprise PL/I for z/OS, Version 3.6 or later
    • Compiled with Enterprise PL/I for z/OS, Version 3.5, with the PTFs for APARs PK35230 and PK35489 applied

z/OS Debugger provides facilities that apply only to programs compiled with specific levels of compilers. Because of this, this document uses the following terms:

assembler
Refers to assembler programs with debug information assembled by using the High Level Assembler (HLASM).
COBOL
Refers to the all COBOL compilers supported by z/OS Debugger except the COBOL compilers described in the term LangX COBOL.
Disassembly or disassembled
Refers to high-level language programs compiled without debug information or assembler programs without debug information. The debugging support z/OS Debugger provides for these programs is through the disassembly view.
Enterprise PL/I
Refers to the Enterprise PL/I for z/OS and OS/390® and the VisualAge® PL/I for OS/390 compilers.
LangX COBOL
Refers to any of the following COBOL programs that are supported through use of the EQALANGX debug file:
  • Programs compiled using the IBM OS/VS COBOL compiler.
  • Programs compiled using the VS COBOL II compiler with the NOTEST compiler option.
  • Programs compiled using the Enterprise COBOL for z/OS V3 and V4 compiler with the NOTEST compiler option.

When you read through the information in this document, remember that OS/VS COBOL programs are non-Language Environment® programs, even though you might have used Language Environment libraries to link and run your program.

VS COBOL II programs are non-Language Environment programs when you link them with the non-Language Environment library. VS COBOL II programs are Language Environment programs when you link them with the Language Environment library.

Enterprise COBOL programs are always Language Environment programs. Note that COBOL DLL's cannot be debugged as LangX COBOL programs.

Read the information regarding non-Language Environment programs for instructions on how to start z/OS Debugger and debug non-Language Environment COBOL programs, unless information specific to LangX COBOL is provided.

PL/I
Refers to all levels of PL/I compilers. Exceptions will be noted in the text that describe which specific PL/I compiler is being referenced.