Qualification parameter values

A different part of the Breakpoints panel allows you to further constrain the conditions under which a breakpoint is to occur by entering qualification parameter values. On this part of the panel, you can list parameter data with which the named service must have been called.

The Breakpoints panel with the Qualification parameter values field is displayed (Figure 1) if you enter the QUAL primary command on the first part of the Breakpoints panel or if you select the Qualifications choice from the Qualify pull-down. The Function and Active columns are overlaid with a column of data titled Qualification parameter values; this column was logically off the screen to the right of the first Breakpoints panel. To resume the format of the Breakpoints panel, use the RESUME primary command or select the Breakpoints choice from the Qualify pull-down.

Figure 1. Breakpoints panel with qualification parameter values (ISPYBP2)

 ┌──────────────────────────────── Dialog Test ────────────────────────────────┐
 │   Menu  Qualify  Utilities  Help                                            │
 │ ─────────────────────────────────────────────────────────────────────────── │
 │                                 Breakpoints                Row 1 to 5 of 13 │
 │                                                                             │
 │ Add, delete, and change breakpoints. Underscores need not be blanked.       │
 │ Enter END command to finalize changes.                                      │
 │                                                                             │
 │       Service          When                 Qualification parameter values  │
 │      (Required)  (BEFORE,AFTER,Rnn)                  (No entry=none)        │
 │                    (No entry=all)        ("AND" is assumed between values)  │
 │                                                                             │
 │                                                                             │
 │                                                                             │
 │                                                                             │
 │                                                                             │
 │                                                                             │
 │                                                                             │
 │ Command ===>                                              Scroll ===> PAGE  │
 │  F1=Help        F2=Split       F3=Exit        F4=Expand      F5=Rfind       │
 │  F6=Resize      F7=Backward    F8=Forward     F9=Swap       F10=Actions     │
 └─────────────────────────────────────────────────────────────────────────────┘
  F1=Help      F2=Split     F3=Exit      F7=Backward  F8=Forward   F9=Swap
 F10=Actions  F12=Cancel

The lines on the Breakpoints panel with qualification parameter values correspond to the lines on the first Breakpoints panel; Specifying breakpoints describes the Service and When fields. In the Qualification parameter values field, for all services except SELECT, you can enter any combination of:

One or more parameter values, separated by blanks, that the dialog passes to the service. No order is implied by the specification of the parameter values.
For example, if you want a breakpoint to occur when message ABC0001 is included on a DISPLAY service request, specify ABC0001. If the breakpoint should occur only when message ABC0001 and panel XYZ are both included, specify ABC0001 XYZ.
One or more command call keywords, separated by blanks, that have values that are not blank when a dialog calls the service. For ISPLINK or ISPLNK calls, the keywords matching the calling sequence parameter positions are used.
For example, if you want a breakpoint to occur whenever the DISPLAY service is called with a message, then specify MSG.

For ISPF's SELECT and ISREDIT services, you can enter one or more parameter strings that would be entered on these two service calls. A parameter string is a series of characters delimited by a blank, a comma, a single quotation mark, or a left or right parenthesis.

For example, if a SELECT call is:

SELECT PGM(ABC) PARM(1 2 3 5 '6'),

then all or any of these strings can be used: SELECT, PGM, ABC, 1, 2, 3, 5, 6.

For a breakpoint to be taken, all qualification data listed must be matched.

All line commands and change capabilities are still available on the Breakpoints panel with qualification parameter values.

During dialog processing, to determine whether the criteria for a breakpoint have been met, Dialog Test processes a logical AND of the Service, When, Function, Active, and Qualification fields specified for that breakpoint. Therefore, if you want more than one breakpoint for an ISPF service, you should create multiple rows.

When you use the Breakpoints option (7.8), be aware of these items:

Qualification: If you plan to qualify several breakpoints, it can be more efficient to specify all breakpoint data on the Breakpoints panel with qualification parameter values.
END command: You can use the END primary command from either the first Breakpoints panel or the Breakpoints panel with qualification parameter values.
Input errors: You must correct input errors before leaving any display using the END, QUAL, or RESUME command. You can use the CANCEL command to end the Breakpoints option, even if input errors remain on the display.
Syntax checking: A dialog service call must pass a basic syntax check before a breakpoint is honored.
Control display: If any CONTROL service settings for DISPLAY LINE or DISPLAY SM (Session Manager) were in effect before the breakpoint, such settings are lost.