Library View Topics Framed Contents Revised Topics Previous Topic Next Topic Search Search ResultsPrevious Topic MatchNext Topic Match Notes List Notes Print Download No PDF Handheld DisconnectedHandheld ConnectedHelp

8.1.15.4 DEBUGGING Declarative



Debugging sections are permitted only in the outermost program; they are not valid in nested programs. Debugging sections are never triggered by procedures contained in nested programs.


X Debugging sections are not permitted in:

The WITH DEBUGGING MODE clause of the SOURCE compiler statement activates all debugging sections and lines that have been compiled into the object program. See Appendix C, "Source Language Debugging" in topic APPENDIX1.3, for additional details.

When the debugging mode is suppressed by not specifying that option of the SOURCE compiler, any USE FOR DEBUGGING declarative procedures and all debugging lines are inhibited.

Automatic execution of a debugging section is not caused by a statement appearing in a debugging section.


    ___ Format 3--USE (DEBUGGING Declarative) ______________________________ 
   |                                                                        |
   |                                        <__________________             |
   | >>__USE__ _____ __DEBUGGING__ ____ __ ___procedure-name-1_|_ _______>< |
   |          |_FOR_|             |_ON_|  |_ALL PROCEDURES_______|          |
   |                                                                        |
   |________________________________________________________________________|
USE FOR DEBUGGING
All debugging statements must be written together in a section immediately after the DECLARATIVES header.

Except for the USE FOR DEBUGGING sentence itself, within the debugging procedure there must be no reference to any non-declarative procedures.

procedure-name-1
Must not be defined in a debugging session.

Table 53 shows, for each valid option, the points during program execution when the USE FOR DEBUGGING procedures are executed.

Any given procedure-name can appear in only one USE FOR DEBUGGING sentence, and only once in that sentence. All procedures must appear in the outermost program.

ALL PROCEDURES
Procedure-name-1 must not be specified in any USE FOR DEBUGGING sentences. The ALL PROCEDURES phrase can be specified only once in a program. Only the procedures contained in the outermost program will trigger execution of the debugging section.


 Table 53. Execution of Debugging Declaratives                             
 USE FOR DEBUGGING 
 Operand           
 Upon execution of the following, the USE FOR          
 DEBUGGING procedures are executed immediately         
 procedure-name-1  
                   
                   
                   
 Before each execution of the named procedure          
                                                       
 After the execution of an ALTER statement referring   
 to the named procedure                                
 ALL PROCEDURES    
                   
                   
                   
                   
                   
 Before each execution of every nondebugging procedure 
 in the outermost program                              
                                                       
 After the execution of every ALTER statement in the   
 outermost program (except ALTER statements in         
 declarative procedures)                               




Previous Topic Next Topic © Copyright IBM Corp. 1991, 1998

IBM Library Server Copyright 1989, 2005 IBM Corporation. All rights reserved.





Return to library:   z/OS | z/OS.e | TPF | z/VSE | z/VM | IBM Hardware | IBM System z Redbooks
Glossary:   IBM terminology
Publications:   How to order publications
Readers:   Download IBM Library Reader | Download IBM Softcopy Reader | Download Adobe® Acrobat® Reader®
Library management:   Download IBM Softcopy Librarian
Contacts:   Contact z/OS


Adobe, the Adobe logo, Acrobat, the Acrobat logo, and Acrobat Reader are registered trademarks of Adobe Systems incorporated.