CA ADS Dialog and Application Reporter › Control Statements › DIALOGS

DIALOGS

Purpose

Generates reports for specified dialogs.

Syntax

►►─── DIALOGs = ──────────────────────────────────────────────────────────────►

 ►─┬─ ALL ────────────────────────────────────────────────────────────┬─ , ───►
   │       ┌────────────────────── , ─────────────────────────┐       │
   └─┬───┬─▼─┬─ dialog-name ────────────────────────────────┬─┴─┬───┬─┘
     └ (─┘   ├─ dialog-mask-value ──────────────────────────┤   └ ) ┘
             └─ low-dialog-name - high-dialog-name ─────────┘

 ►───┬───────────────────────────────────────────────────────────────┬── , ───►
     └─ VERsions = ───┬─ ALL ◄ ────────────────────────────────────┬─┘
                      ├─ version-number ───────────────────────────┤
                      └─ low-version-number - high-version-number ─┘

 ►───┬───────────────────────────────────────────────────────────────────┬────►◄
     └─ REPORTs = ─┬ ALL ─────────────────────────────────────────────┬──┘
                   │      ┌────────────────────────────────────┐      │
                   └┬───┬─▼─┬ SUMmary ◄ ─────────────────────┬─┴─┬───┬┘
                    └ ( ┘   ├┬ RECords ─┬────────────────────┤   └ ) ┘
                            │└ RCD ─────┘                    │
                            ├ FDBlist ───────────────────────┤
                            └ PROcesses ─┬─────────────────┬─┘
                                         └─ sxref-options ─┘

Expansion of sxref-options

►►─── with SXREF ─┬───────────────────────┬───────────────────────────────────►◄
                  └─ ( ─┬─ LONG ────┬─ ) ─┘
                        └─ SHORT ◄ ─┘

Parameters

ALL

Generates reports for all dialogs in the load area.

dialog-name

Specifies the 1- to 8-character name of a single dialog.

If the name includes a hyphen (-) as a character, replace with a mask character. The mask character is the asterisk (*).

dialog-mask-value

Specifies any dialog with a name that matches the mask criteria. The mask character is the asterisk (*); it matches any character. For example, DIALOGS=DCB***** generates the requested reports for all dialogs beginning with DCB.

low-dialog-name - high-dialog-name

Specifies all dialogs within the dialog-name range (inclusive).

The hyphen (-) is required and cannot have surrounding blanks.

Dialog names and masks that have fewer than eight characters are padded on the right with blanks.

VERSIONS =

Introduces the version numbers of the dialogs for which reports are requested.

ALL

Specifies all versions of the named dialogs.

ALL is the default when no other version is specified.

version-number

Specifies a single version number for the named dialogs.

low-version-number - high-version-number

Specifies all versions of the named dialogs within the version-number range (inclusive). The hyphen (-) is required and cannot have surrounding blanks.

REPORTS =

Introduces the reports requested for the named dialogs.

ALL

Requests all reports (that is, the summary, processes, records, and FDBLIST reports) for the named dialogs.

SUMmary

Requests summary reports for the named dialogs.

SUMMARY is the default when no other report is specified.

RECords

Requests records reports for the named dialogs.

FDBlist

Requests FDBLIST reports for the named dialogs.

PROcesses

Requests processes reports for the named dialogs.

sxref-options

Specifies sorted cross-reference report options.

with SXREF

Requests a sorted cross-reference for process reports. The usage of all data names and subroutine calls is cross-referenced.

LONG

Specifies that all elements be included in the report.

SHORT

Specifies that only elements that are referenced be included in the report.

SHORT is the default.

Note: When specifying the cross-reference option, the Master Function Table (RHDCEVBF) must reside in either the load area or the load library.

Usage

Considerations

A maximum of 100 dialog report requests can be specified in a single ADSORPTS run. If both dialog and application reports are requested in a single ADSORPTS run, dialogs are reported first, followed by applications, regardless of their order in the control statements.

Example 1: Requesting summary reports

The following statement requests summary reports for all versions of dialogs with names in the range A-C (inclusive):

DIALOGS=(A-C),REPORTS=SUMMARY

Example 2: Requesting summary and records reports

The following statement requests all reports for all dialogs with names that contain the characters S and T in the third and fourth positions and blanks in the last two positions:

DIALOGS=**ST**,REPORTS=(SUMMARY,RECORDS)

Example 3: Requesting summary reports for all versions

The next statement requests summary reports for all versions of these dialogs:

• Dialogs whose names begin with the characters ABC
• Dialogs whose names contain the characters S and T in the third and fourth positions and blanks in the last two positions
• Dialogs whose names are in the range A through C (inclusive)

  DIALOGS=(ABC*****,**ST**,A-C)
  

Example 4: Requesting all reports for the dialog named TBXSUMD

The following statement requests all reports for the named dialog:

DIALOGS=TBXSUMD,REPORTS=ALL