Analyzing the area during image copy

If your site has a license for Fast Path Online Analyzer/EP, pointer validation will occur automatically (by default) when you make an online image copy of an area by using the IMAGECOPY command. This automatic process applies the default value of QUICK for the POINTER_VALIDATION keyword to perform a checksum validation of pointers for each segment type within each UOW of the area that is specified on the IMAGECOPY command.

Automatic pointer validation provides an assurance of the area’s pointer integrity, while providing statistics that show how the segment data affected space usage.

Note

You can override automatic quick pointer validation and request more extensive validation by specifying POINTER_VALIDATION=FULL on the IMAGECOPY or GLOBAL command. Direct pointers are validated by using the cross-reference technique. You can also specify any other valid value for the POINTER_VALIDATION keyword (such as POINTER_VALIDATION=NONE to completely disable the analysis function).

If an SDEP segment is defined for the database, SDEP pointers are also validated by default by using the same technique as specified for direct pointers. You can manually specify another valid value for the SDEP_VALIDATION keyword to control how SDEP pointers are to be validated.

You can also specify additional functions that are associated with the analysis function:

Use the RAP_VALIDATION keyword to control how RAPs are processed.
Use the LARGEST_DATABASE_RECORDS keyword to specify the number of largest database records to be tracked by the analysis process.
Use the REPORT and THRESHOLD subcommands to control the generation of analysis reports and exception testing.

The following example requests the creation of a single output image copy data set for each area within the database. By omission of a value for POINTER_VALIDATION, quick analysis is also performed for each area. SDEP pointers (if any exist) are validated using the same technique. (See Pointer validation for more detailed information.) Only the Free Space Analysis report is produced.

Specifying the analysis function with the IMAGECOPY command

IMAGECOPY DBD=dbdnameIC DSNAME='dataset-name-mask',
     DISP=(NEW,CATLG), UNIT=TAPE
     REPORT DEFAULT=NO,FREESPACE_ANALYSIS=YES

Making an online image copy during an online analysis process is essentially the same as performing an online analysis while making an online image copy.

The following example is functionally equivalent to the first example. The main difference is that you are actively requesting the analysis (instead of it occurring automatically with the IMAGECOPY command).

Specifying the image copy function with the ANALYZE command

ANALYZE DBD=<dbdnameIC> DSNAME='<dataset-name-mask>',
     DISP=(NEW,CATLG),UNIT=TAPE
     REPORT DEFAULT=NO,FREE_SPACE_ANALYSIS=YES

For more information about analyzing areas, see Analyzing a DEDB online.

Related topic

Making an online image copy

Analyzing the area during image copy

Comments