JCL L

Formats printed output.

SYNTAX

L element{, element}...

SYNTAX ELEMENTS

element can be any of the following:

"text"	Prints literal text. Enclose the text in quotes.
r{;input;}	Prints the result of a direct or indirect reference to a buffer or select register ( r). If required, a jQL input conversion can be applied before output.
r{:output:}	Prints the result of a direct or indirect reference to a buffer or select register ( r). If required, a jQL output conversion can be applied before output.
n	Skips n lines before printing. You cannot use n in a HDR print format specification.
(c)	Sets the print position to column number c. Can be a direct or indirect reference to a buffer or select register.
+	Suppresses NEWLINE being output at the end of the L command. You cannot use + in a HDR print format specification.
C	Closes the print file and forces printing. You cannot use C in a HDR print format specification.
E	Ejects to top-of-form (form feed). You cannot use E in a HDR print format specification.
N	Redirects subsequent printer output to the terminal. Normally only used for debugging. Must be the only element in an L command.
HDR	Allows you to define a page heading. HDR, must be the first element in the L command.
L	Outputs a line feed in the heading. Only used in a HDR specification.
P	Outputs the current page number in a heading. Only used in a HDR specification.
T	Outputs current time and date in a heading. Only used in a HDR specification.
Z	fResets the current page number in a heading to zero. Only used in a HDR specification.

NOTES

Output from the L command creates (or adds to) a print file.

The print file will remain open until a shell command is issued by using the P command. If the shell command also generates print output, this will be added to the same print file. You can close the print file and avoid any unnecessary output by choosing any shell command which does not generate print output, or by using the L C command. Alternatively, you can hold the print file open indefinitely by using the O option of the SP-ASSIGN command.

Continuation lines (which do not start with an L) can be created by terminating each preceding line with a comma (,).

A + specified as the last element the command will cause the output from the next L command to be appended.

If you specify a heading statement (HDR) which contains direct or indirect references, these will be evaluated (and included in the heading) as the command is processed. Subsequent changes to the source values will have no effect on the heading.

EXAMPLE

MV %1 "Quarter 4" L HDR,"PAGE ",P,(10),T L 5,"Sales Report for ",%1

Output:

PAGE 1 10:25:17 10 OCT 1999

Sales Report for Quarter 4

JCL