*

Debugs the current program.

pgm‑name

Name of the program being debugged.

version

Version of the program being debugged. For information on valid versions to specify, see Using Version Clauses in CA Ideal Commands in the “Preliminary Concepts” chapter.

UPDATE

Either updates or bypasses updating the database.

Y Allows updating of the database.

N Does not allow updating of the database.

PARAMETER 'string'

A single string passed to the program. This parameter must be defined in the parameter definition fill‑in for the program being debugged as one alphanumeric (type X) character string with input Update Intent. It cannot be a group item.

The length of the string is limited to the space available in the prompter. When the DEBUG command is issued in the command area, the command with parameter string is limited to one command line.

DESTINATION

Applies to all reports generated by this program unless this destination information was overridden for one or more reports with the ASSIGN REPORT command. This clause differs from the more typical DESTINATION‑clause in that “NAME name” is excluded. The one‑ to eight‑character report name becomes the output name. Select from the following:

MAIL 'email‑id' A delimited 1‑ to 60‑character name of a [assign the value for emailp in your book] destination.

LIBRARY Output library.

SYSTEM name System printer name.

NETWORK name Network printer name (not available in batch).

COPIES num

Number of copies to print by a system or network printer in an online environment. Cannot exceed site maximum. This clause is ignored in batch.

DISPOSITION

The disposition clause; select from the following:

KEEP
RELEASE
HOLD

For more information on output dispositions, see the SET OUTPUT Command.

MAXLINES n

Maximum number of lines for any one report that a program can produce. The upper limit for MAXLINES is established at CA Ideal installation or by a SET OUTPUT SITE OPTIONS fill‑in, and only applies to reports going to the output library. Any report reaching this maximum stops the run. This entry does not affect reports produced in batch and printed in batch.

DESCRIPTION 'string

The 1‑ to 32‑character description of the output. The description displays as part of the output status. The default description DEBUGGER OUT applies if you do not provide a description in the DEBUG command.

For more information about the output status description, see the Working in the Environment Guide.

COMMANDS

Specifies the name of the data member used for debugging commands.

* Current member from the status line.

member Name of the data member used for the debugging commands. The default is DEBUG.

uuu User‑ID of the data member. The default is the current user.