CONVERT PAGE

The CONVERT PAGE utility changes the page range for an area or changes the maximum number of records that can be stored on a page of an area.

Authorization

To	You Need This Privilege	On
Change the page range for an area or the maximum number of records that can be stored on a page of an area	DBAWRITE	All areas being converted

CONVERT PAGE Syntax

►►─ CONVERT PAGE IN ─┬─ SEGMENT source-segment ─┬─────────────────────┬─┬────►
                     │                          └─ TO target-segment ─┘ │
                     └─ area-specification ─────────────────────────────┘

 ►─┬────────────────────┬────────────────────────────────────────────────────►
   └─ DMCL target-dmcl ─┘

 ►─┬──────────────────────────────────────────────────────────────────┬──────►
   │        ┌────────────────────────── , ──────────────────────────┐ │
   └─ FILE ─▼─┬──────────────────┬─ filename ─┬───────────────────┬─┴─┘
              └─ source-segment. ┘            └─ INTO new-ddname ─┘

 ►─┬────────────────────────────────────┬────────────────────────────────────►◄
   └─ NOTIFY INTERVAL ─┬─ not-interval ─┤
                       └─ 10000 ◄───────┘

Expansion of area-specification

          ┌─────────────────────── , ─────────────────────┬──────────────────►◄
►►─ AREA ─▼─ source-seg.area ─┬───────────────────────────┤
                              └─ TO target-seg ─┬─────────┤
                                                └─ .area ─┘

CONVERT PAGE Parameter

source-segment: Names a segment to be processed. All areas in this segment are compared to matching areas in the target segment for page range and maximum records per page changes. Unless restricted by the FILE parameter, all files in this segment are scanned for page range changes and copied to new files.
source-seg.area: Names an area to be processed. All specified areas are compared to the corresponding target areas and checked for page range and maximum records per page changes. Unless restricted by the FILE parameter, all files for this area are scanned for page range changes and copied to new files.
target-segment: Names the segment with the new page range and maximum records per page definitions. If you omit target-segment, it defaults to the source segment name. You should use this when the target segment is in the same DMCL as the source.
target-seg.area: Names the area that contains the new page range and maximum records per page definitions. If you omit this, it defaults to source-seg.area name. If you omit the area, it defaults to the source area name. You should use this when the target area is in the same DMCL as the source.
target-dmcl: Names the DMCL that contains the target segment or area definitions. Use this parameter when the target segment or area is defined in a different DMCL than the current one.
filename: Restricts the conversion to the selected source files. If you do not specify the FILE parameter, then all files for selected segments and areas are converted. However, all target file definitions must have ddnames that are different from the source file definitions.
new-ddname: Names the JCL ddname used for the output file. This name must be unique in the job step. If you don't specify new-ddname, the ddname in the target file definition is used. In this case the name of the target file must match the source file.
not-interval: Specifies the notify interval. After every not-interval record read, a message is issued to the console stating how far the job has progressed. If omitted, the default interval is 10,000 records. If specified as zero (0), no notify message is issued.