pgm‑name

Name of the program executed.

version

Version of the program. 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 using uppercase translation that is passed to the program. For a description of a valid string delimiter, see Basic Steps to Create a Report earlier in this guide.

MCPARM 'string'

Single string using mixed case translation that is passed to the program. For a description of a valid string delimiter, see Basic Steps to Create a Report earlier in this guide.

You must define this parameter in the parameter definition fill‑in for the program being run. The length of the string is limited to the space available in the prompter. When you issue the RUN command in the command area, the command with parameter string is limited to one command line.

You must define this parameter in the parameter definition fill‑in for the program run as one alphanumeric (type X) character string with input Update Intent (not a group item).

DESTINATION

This destination information overrides the SET OUTPUT DESTINATION session option. It provides a default destination for RUNLIST and for any reports produced in this run. You can override this destination with the ASSIGN REPORT command before this RUN command or with the ASSIGN REPORT statement during this run.

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 [assign the value for emailp in your book] destination.

LIBRARY Output library.

SYSTEM name System printer name.

NETWORK name Network printer (not available in batch).

COPIES nn

Number of copies to printed on a system or network printer. This option is ignored in batch.

DISPOSITION

Disposition clause; select from the following:

KEEP
RELEASE
HOLD

For more information about these clauses, see the SET OUTPUT Command.

LOOPLIMIT nnnnnn

Maximum number of times any loop in the program may be consecutively executed. The count is reset each time the loop is entered. Unlike the value set by SET RUN LOOPLIMIT, this operand applies to PROD runs.

MAXLINES n

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

DESCRIPTION 'string'

A 1‑ to 32‑character description of the list output (RUNLIST). The description displays as part of the output status (see also the DISPLAY OUTPUT STATUS command in this guide). The default description LIST STATEMENT OUTPUT applies if you do not provide a description in the RUN command. You can override the description before the run using the ASSIGN REPORT command or during the run using the ASSIGN REPORT statement.