Debugger Commands › QUALIFY

QUALIFY

Purpose

Establishes a new current process or inquires about the current program, or dialog and process.

Syntax

RESET Format

►►─── QUAlify ─┬──────────────────────┬─ PROCess process-name ────────────────►
               └─ DIAlog dialog-name ─┘

 ►─┬──────────────────────────┬───────────────────────────────────────────────►◄
   └─ VERsion version-number ─┘

INQUIRE Format

►►─── QUAlify INQuire ────────────────────────────────────────────────────────►◄

Parameters

DIAlog dialog-name

Specifies the dialog currently defined to the debugger. Only current dialog can be qualified.

PROCess process-name

Specifies the new dialog process to become current. Enclose the process name in single quotation marks if the name contains embedded delimiters.

VERsion version-number

Specifies the version number of the current dialog.

Usage

Resetting currency

When a dialog is defined to the debugger, the premap process becomes the current process by default. You can use the QUALIFY command to assign currency to a different process within the current dialog.

Two formats

The QUALIFY command has two formats. The RESET format resets currency; the INQUIRE format requests a display of the current program, or the current dialog and process.

The QUALIFY command can be used in both the setup and the runtime phases of a debugger session.

Example 1

You can inquire about the current dialog process:

DEBUG >
qualify inquire

The debugger responds in this format:

QUALIFY INQUIRE
DIALOG MISINDC VERSION 1 PROCESS MIS-MAIN1 CURRENT
DEBUG >

Example 2

These commands reassign currency to MIS-MAIN2 and set a breakpoint at line 200 within MIS-MAIN2:

qualify proc 'mis-main2' at #200

The debugger responds like this:

QUALIFY PROCESS 'MIS-MAIN2'
QUALIFY > CURRENCY SET
AT #200
AT > #200 ADDED
DEBUG >