LIST CALLS command

Displays the dynamic chain of active blocks. For languages without block structure, this is the CALL chain. Under z/OS® batch and TSO, LIST CALLS lists the call chain of the current active enclave in the process.

Usage notes

• For Enterprise COBOL for z/OS Version 5, when a program contains nested programs and your current execution point is inside one of these nested programs, the output of LIST CALLS command shows the main program and the nested programs.

  Example:

  • At ENTRY in COBOL program

    NEST3TS ::> MYMAIN :> EST1A :> NT2A :> ESA

  • From LINE 62.1 in COBOL program

    NEST3TS ::> MYMAIN :> MAI :> NEST1A :> NEST2A

  • From LINE 42.1 in COBOL program

    NEST3TS::> MYMAIN :> MYMN :> NT1A

  • From LINE 19.1 in COBOL program

    NEST3TS::> MYMAIN :> MYMAIN

  NEST1A, NEST2A, and NEST3A are all nested programs.

• For Enterprise COBOL for z/OS Version 5, if the actual execution of your program is in one of the declarative sections, the output of the LIST CALLS command shows an extra entry for the declarative.
• For programs containing interlanguage communication (ILC), routines from previous enclaves are only listed if they are written in a language that is active in the current enclave.
• If the enclave was created with the system() function, compile units in parent enclaves are not listed.
• If you are debugging a program that does not follow the standard linkage conventions for R13, R14, and R15, the output of the LIST CALLS command can be incorrect or incomplete.
• If you are debugging a disassembled program and you encounter one of the following situations:
  • The registers' save area has not been created.
  • The registers are not chained to the other save areas.
  Some of the programs or CSECTs in the call chain are not displayed.
• The LIST CALLS command cannot be used while you replay recorded statements by using the PLAYBACK commands.

Example

LIST CALLS;