CPCSYSIN commands for the SP utility


The following table lists commands that you can specify in the CPCSYSIN data set to control the SP utility.

Commands can apply to all repositories or to repositories for specified data groups; for more information, see CPCSYSIN-keywords-for-the-SP-utility.

Table 1. CPCSYSIN commands for the SP utility

Command

Description

FDELETE

Use the FDELETE command to delete repositories.

FDIAG

Use the FDIAG command to obtain diagnostic information about repository data sets in the specified data groups. This command produces the same VSAM statistical information that the FREPT command produces and, in addition, verifies pointers and produces a report on free space blocks. The utility issues error messages to indicate incorrect free space information, pointer verification problems, and thresholds that are exceeded for extents.

FMIGR

Use the FMIGR GROUP(ALL) command to migrate repositories to new revision levels. (Do not specify the DATAGROUP keyword for this command except at the request of BMC Customer Support.) In most cases, you should allow the CPC to perform the repository migration process automatically. To process the FMIGR command, the utility requires the CPC subsystem to be inactive.

The migration is performed as follows:

  • The utility unloads all repository data to the file that is identified by the UNLOAD DD statement in the JCL.
  • The utility determines whether the revision level in the software DDEFs matches the DDEF level in the catalog for each repository. (The STEPLIB concatenation must contain the new software level). If the software revision level does not match the repository revision level, the utility rebuilds or migrates the repository to the new software level.
  • The utility updates the catalog with the new repository data set information.

If you must restore a repository after using the FMIGR command, you can use the FRELOAD GROUP(ALL) command, change the STEPLIB to the previous level of the software, and specify the original unload file.

FRELOAD

Use the FRELOAD command to reload repositories. The utility performs the reload as follows:

  • The utility ensures that the revision level in the software DDEFs matches the DDEF level in the catalog.
  • The utility reloads repository data from the file that is identified by the UNLOAD DD statement by using sequential processes.
  • For ESDS space control blocks, the utility builds the blocks before determining their contents. Then the utility updates ending space control blocks with information about the last free record.
  • The utility builds indexes by constructing and writing keys to unsorted key files. Then the utility sorts the keys and writes them sequentially to the indexes.

You can use the utility to perform high-level and prefix renames by changing the prefix on the REP command in the CPCINI DD. The utility reloads the repositories with the new VSAM names and rename the data set names within the repository catalog.

FREPT

Use the FREPT command to obtain VSAM statistical information about repository data sets in the specified data groups. You can request this function while the CPC is active and functions own the specified data groups.

FUNLOAD

Use the FUNLOAD command to unload repository data when the CPC subsystem is not active. The utility stores the unloaded repository data in the file that is identified by the UNLOAD DD statement in the JCL.

You can specify the PTRERROR(ACCEPT) keyword to ignore pointer errors during the unload process.

 

Tip: For faster searching, add an asterisk to the end of your partial query. Example: cert*

IMS Database Guides 3.0