Procedure Definition Language Statements › ASSIGN REPORT Statement

ASSIGN REPORT Statement

This statement overrides the RUN command defaults or any current settings and permits report outputs to be handled individually.

This statement has the following format:

ASSIGN REPORT name [TO altname]

[                  {MAIL email id                 } ]
[                  {LIBRARY                       } ]
[DESTINATION       { {SYSTEM 'name'  }            } ]
[                  { {NETWORK 'name' } [COPIES n] } ]

[DISPOSITION 'disp']
	
[MAXLINES m]

[DESCRIPTION 'string']

[DATE date_field]

[PAGE NUMBER page start]

[PAGE SIZE page-size]

name

The name of the report or the word RUNLIST for LIST statement output.

altname

An alphanumeric literal or the identifier of an alphanumeric field that specifies an alternate name for the report, as a ddname (in z/OS) or as SYSnnn (in VSE).

email‑id

A 1‑ to 60‑character alphanumeric literal or the identifier of an alphanumeric field that specifies the name of a [assign the value for emailp in your book] destination.

'name'

An alphanumeric literal (enclosed in single or double quotes) or the identifier of an alphanumeric field that specifies the name of a network or system printer destination.

Note: You cannot use a network printer destination in a batch run.

n

A numeric literal or the identifier of a numeric field that specifies the number of copies for a destination of system or network in an online environment only.

Note: The COPIES option is ignored in batch.

disp

An alphanumeric literal (enclosed in single or double quotes) or an alphanumeric field with the value of KEEP, HOLD, or RELEASE.

m

A numeric literal or the identifier of a numeric field that specifies the maximum number of lines of the report to produce. This value applies only to reports that are directed to the output library online.

'string'

An alphanumeric literal that describes the report.

date‑field

A type D field that contains the date to use on the report where the report parameter date or the $RPT‑DATE function is specified.

page‑start

A numeric field or literal that contains starting page number of the report. This is the page number that is printed for report parameter page number or the $RPT‑PAGE report function.

page‑size

A numeric literal or the identifier of a numeric field representing the actual page size for the report. This value overrides the parameter specified in the report definition.
Limits: Maximum page‑size is 250 lines per page, including heading and detail lines.

For more information about this statement available in command form, see the Command Reference Guide.

You can only issue ASSIGN REPORT when the report is not active, that is, before the first PRODUCE or after a RELEASE and before a subsequent PRODUCE.