Previous Topic: TRC: Statement Tracing OptionNext Topic: USH: Unprotect Shared Storage


UBP: Specify Unconditional Breakpoints

To specify unconditional breakpoints, use the following commands:

UBP=locn
UBP=(locn1,locn2,...,locn9)
UBP=((locn),F=term1,T=term2) 
UBP=((locn1,...,locn9),F=term1,T=term2)
UBP=((locn),F=term1,T=term2,L=loopnumber) 
UBP=((locn1,...,locn9),F=term1,T=term2,L=loopnumber)
ubp=((ALLPAR),F=term1,T=term2,L=loopnumber) 
ubp=((ALLLAB),F=term1,T=term2,L=loopnumber)
locn

Specifies a program location as a COBOL paragraph name (in quotes), a PL/I or Assembler label (in quotes), a COBOL or PL/I statement number (preceded by a # sign), or a hexadecimal displacement from the beginning of the program. locn also specifies an address in main storage.

The following operands specify the terminal at which the program must be executing for the breakpoint to take effect.

term2

Specifies the terminal to which the breakpoint display is sent.

T=.ANY

Specifies that the breakpoint display be sent to the terminal at which the program is executing.

Note: If the F=term1 or T=term2 parameter is omitted, it defaults to the terminal that issued the UBP option.

loopnumber

Specifies how often the program should halt when a breakpoint is within a loop.

Example

L=2 halts the program every other time it passes through the loop; L=3 halts it every third time. If this parameter is omitted, the breakpoint occurs every time the program reaches the location.

ALLPAR

Specifies that breakpoints take effect at all COBOL paragraph names.

ALLLAB

Specifies that breakpoints take effect at all Assembler labels.

When you set unconditional breakpoints, CA InterTest for CICS halts the program at the specified locations.