PRINT PAGE

The PRINT PAGE utility prints the contents of one or more database pages in display (decimal) and/or hexadecimal format. You can request printing of:
idmscu19
The PRINT PAGE utility prints the contents of one or more database pages in display (decimal) and/or hexadecimal format. You can request printing of:
  • The target page for a specified CALC key
  • A specified range of pages
  • All or some of the pages in an area or subarea
The following topics are discussed on this page:
Authorization
To
You Need This Privilege
On
Print one or more pages in an area
DBAREAD
The area
Syntax
  ►►─── PRINT PAGE ─────────────────────────────────────────────────────────────►  ►─┬──┬───────────────┬─ start-page ─┬────────────────────────┬─────────────┬─►    │  └─ page-group: ─┘              ├─ TO end-page  ─────────┤             │    │                                 └─ FOR page-count pages ─┘             │    │                                                                        │    ├── IN AREA segment.area ─┬───────────────────┬─┬────────────────────────┤    │                         └─ SUBAREA subarea ─┘ └─ FOR page-count pages ─┤    │                                                                        │    └── FOR CALC key calc-options ───────────────────────────────────────────┘  ►─┬───────────┬──────────────────────────────────────────────────────────────►◄    ├─ DISPLAY ─┤    ├─ HEX ─────┤    └─ BOTH ◄───┘  
Expansion of calc-options
►►─┬─ 'character-key-value' ─┬────────────────────────────────────────────────►    └─ X'hex-key-value' ──────┘  ►─── IN AREA segment-name.area-name ─────────────────────────────────────────►  ►─┬─────────────────────────────────┬────────────────────────────────────────►    ├─ SUBAREA subarea-name ────────┬─┘    └─ CALC start-page TO end-page ─┘  ►─┬────────────────────────┬─────────────────────────────────────────────────►◄    ├─ FOR page-count pages ─┤    └─ OVERFLOW ─────────────┘  
Parameters
  • 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.
Usage
How to submit the PRINT PAGE statement
You submit the PRINT PAGE statement by using either the batch command facility or the online command facility. When submitting the PRINT PAGE utility through the batch command facility, you must run the batch command facility in local mode.
JCL Considerations
When you submit a PRINT PAGE statement through the batch command facility in local mode, the JCL to execute the facility must include statements to define the files containing the pages to be processed. To run under central version include a SYSCTL statement.
For more information about the generic JCL used to execute the batch command facility, see z/OS JCL or z/VSE JCL.
Example
Print a specific page in an area
The following example directs PRINT PAGE to print page 75020.
print page 75020;
Sample Output
The following report lists the contents of page 75020 in response to the PRINT PAGE statement in the previous example.
IDMSBCF                                              IDMS Batch Command Facility                            mm/dd/yy   PAGE 1    SET BATCH WIDTH PAGE 80;  Status = 0    PRINT PAGE 75020;  PAGE 75,020              PAGE GROUP 0        AVAILABLE SPACE 3,952 -000000   0001250C 01250C01 01250C01 0F700000    *................*  000010   01250C00 01250C00 01254801 01252D01    *................*  000020   0125BB01 0124FA02 0125A803 0125A801    *..........Y...Y.*  000030   01256702 01256701 01250C02 01250C02    *................*  000040   01250C03 01250C03 01250C01 01250C01    *................*  000050   01250317 01250317 F0F4F5F7 C8C1D9D9    *........0457HARR*  000060   E8404040 4040C1D9 D4404040 40404040    *Y     ARM       *  000070   40404040 40F7F740 E2E4D5E2 C5E340E2    *     77 SUNSET S*  000080   E3D9C9D7 40404040 40D5C1E3 C9C3D240    *TRIP     NATICK *  000090   40404040 40404040 D4C1F0F2 F1F7F840    *        MA02178 *  0000A0   404040F6 F1F7F4F3 F2F0F9F2 F3F0F5F0    *   6174320923050*  0000B0   F2F8F7F7 F0F1F4F7 F7F7F1F2 F0F1F0F0    *2877014777120100*  0000C0   F0F0F0F0 F3F4F0F4 F0F50000 01250C01    *0000340405......*  0000D0   01250C01 01250C01 0125130F 0125BD05    *................*  0000E0   0125BD05 F7F7F1F2 F0F1F7F8 F0F6F0F1    *....771201780601*  0000F0   F5F30046 00000C00 7C000C00 0C000000    *53......@.......*  000100   01250C01 01250C01 01250C01 0125AF05    *................*  000110   0125AF03 F0F4F5F8 F0F8F0F8 00000000    *....04580808....*  000120   00000000 00000000 00000000 00000000    *................*  000130   --SAME--  001080   00000000 00000000 00000000 01A90100    *.............Z..*  001090   001C0014 01A400CC 00340018 019F0010    *.....U..........*  0010A0   00BC0048 00010004 000C0008 00280000    *................*  0010B0   0001250C                               *....* - -     1      4     0  0004     75,020-001     75,020-001 -   415    116     1  0010     75,020-000     75,020-000     75,080-001                                75,053-001     75,195-001     75,002-002                                75,176-003     75,176-001     75,111-002                                75,111-001     75,020-002     75,020-002                                75,020-003     75,020-003     75,020-001                                75,020-001     75,011-023     75,011-023                             *0457HARRY     ARM            77 SUNSET STRIP     N*                             *ATICK         MA02178    6174320923050287701477712*                             *01000000340405..* -   420     28     2  00CC     75,020-001     75,020-001     75,020-001                                75,027-015     75,197-005     75,197-005                             *77120178060153......@.......* -   425      8     3  0100     75,020-001     75,020-001     75,020-001                                75,183-005     75,183-003                             *04580808*  Status = 0    SET BATCH WIDTH PAGE 132;  Status = 0
More Information
  • For more information about defining CALC keys, see
    CA IDMS Database Administration Section
    .
  • For more information about database pages, see
    CA IDMS Database Administration Section
    .