Previous Topic: PRINT PAGE SyntaxNext Topic: Usage


PRINT PAGE Parameter

page-group:

Specifies the page group from which one or more pages is to be printed. Page group is concatenated with the start-page in the form page-group:start-page.

By default, if you do not specify a page group, page group zero is used.

start-page

The number of the page to print or the first in a range of pages to print.

TO

Specifies a range of pages to be printed.

end-page

The last page of a range of pages to be printed. End-page must be greater than or equal to start-page.

FOR page-count pages

Specifies that the indicated number of database pages is to be printed.

Page-count must be an integer in the range 1 through 32,768.

If you specify a number higher than the remaining number of pages in the area, printing continues with the first page of the area. Processing stops when the specified number of pages are printed or when all the pages in the area are printed, whichever comes first. No pages are printed more than once.

By default, if you do not specify TO or FOR, one page is printed.

IN AREA

Specifies pages from a specified area to be printed.

By default, if you specify IN AREA, but do not specify SUBAREA, all the pages in the specified area are printed.

segment

Specifies the name of the segment associated with the area whose pages are to be printed.

area

Specifies the name of the area whose pages are to be printed.

SUBAREA

Specifies that only the pages in a subarea are to be printed.

subarea

Specifies the name of the subarea whose pages are to be printed.

FOR page-count pages

Specifies the indicated number of database pages, starting with the first page of the (sub)area, to be printed.

Page-count must be an integer in the range 1 through 32,768.

If you specify a number higher than the number of pages in the (sub)area, processing will stop when all the pages in the (sub)area are printed.

By default, if you do not specify the FOR clause, all pages in the area or subarea are printed.

FOR CALC key

Specifies that one or more pages based on CALC keys will be printed.

Note: You cannot use the FOR CALC option for locating the target page of a large key value, because you can only specify key values that are less than or equal to 256 bytes.

calc-options

Specifies the CALC keys on which to base the selection of pages.

DISPLAY

Directs the PRINT PAGE utility to print the contents of the requested database pages in display format only.

By default, if you do not specify DISPLAY or HEX, the contents of the specified pages will be printed in both display and hexadecimal format.

HEX

Directs the PRINT PAGE utility to print the contents of the requested database pages in hexadecimal format only.

BOTH

Directs the PRINT PAGE utility to print the contents of the requested database pages in both display and hexadecimal format.

BOTH is the default.

'character-key-value'

Specifies a CALC key with a character string literal. The target page in the specified area is printed.

X'hex-key-value'

Specifies a CALC key with a hexadecimal literal. The target page in the specified area is printed.

IN AREA

Identifies the area from which the target page for the specified CALC key is to be printed.

If you specify neither SUBAREA nor CALC in calc-options, the page range of the area specified by IN AREA is used to determine the target page for the specified CALC key.

segment-name

Specifies the name of the segment associated with the area containing the target page to be printed.

area-name

Specifies the name of the area that contains the target page to be printed.

SUBAREA

Identifies the subarea of the area to be used in determining the target page for the specified CALC key.

subarea-name

Specifies the name of the subarea.

CALC

Identifies a page range of the area to be used in determining the target page for the specified CALC key.

start-page

Specifies the number of the first page in the page range.

TO

Identifies the end of the page range.

end-page

Specifies The number of the last page in the page range.

FOR page-count pages

Specifies the indicated number of database pages to be printed, starting with the target page for the specified CALC key.

Page-count must be an integer in the range 1 through 32,768.

If you specify a number higher than the remaining number of pages in the (sub)area, printing will continue with the first page of the (sub)area. Processing will stop when the specified number of pages is printed or when all the pages in the (sub)area are printed, whichever comes first. No pages are printed more than once.

By default, if you do not specify FOR or OVERFLOW, one page is printed.

OVERFLOW

Directs the PRINT PAGE utility to print (in addition to the target page) all pages in the specified (sub)area that contain records in the CALC chain of the target page for the specified CALC key due to overflow situations or that contain duplicates of the CALC key.