Skip to Content

REORG Command

The REORG command specifies the IMS database to be reorganized and establishes job-specific processing options. You can use this command to change the processing mode used for the reorganization, the load, unload and build options, and other processing options specified during installation.

  • Order-That-Database-Director-Processes-the-REORG-Command-Keywords-reorg The table shows the order that BMC Database Director for IMS processes the REORG command keywords after the database is reloaded. The table also indicates the Database Director modes where the keywords can be specified.
  • Syntax-REORG-Command The REORG command has the following syntax:
  • REORG-Command-Keywords You can only specify the REORG command once in a job. You can only specify the AREA or PARTITION keyword once for a REORG command.
  • ABSOLUTEPRIORBLOCK For HDAM and HIDAM databases, identifies a number of tracks for blocks containing space for segments that do not fit into the current block. If no space is found for the segment, the segment is placed into overflow for HDAM and into the next block for HIDAM.
  • ALLOC Use this keyword to set the data set space allocation to the percentage specified in the PRIMARY keyword.
  • AREA-REORG-Command Use this keyword to specify the Fast Path area that you want processed. You must specify a Fast Path database with the DBD keyword for this keyword to succeed.
  • BMCUNLOADEXIT-REORG-Command Use this keyword to specify that a BMC UNLOAD PLUS for IMS user exit is to be used during unload processing. The user exit is formatted as FABHFSU.
  • CAGROUP-REORG-Command Use this keyword to specify the Change Accum database group that contains the databases that will be processed.
  • CONDITIONALDISORGINDEX Use this keyword to specify a conditional reorganization using the organization index. When you specify this keyword, BMC Database Director for IMS invokes BMC iSurvey for IMS when the database is being unloaded.
  • CONDITIONALPRIORBLOCK For HDAM and HIDAM databases, identifies a number of tracks for blocks containing space for segments that do not fit into the current block.
  • DBD-REORG-Command Use this keyword to specify the database that you want processed. You must specify either a DBD name, DBD group, or Change Accum group with the REORG command.
  • DBGROUP-REORG-Command Use this keyword to specify the DBRC database group that contains the databases that will be processed. You must specify either a DBD name, DBD group, or Change Accum group with the REORG command.
  • DBRC-REORG-Command Use this keyword to specify whether the Auto-Enable utility updates DBRC. If you specify IMS, Auto-Enable will use the value of the DBRC parameter in the IMS SYSGEN to determine whether to update DBRC.
  • DCFMC Use this keyword to specify the SMS management class for the Data Collection Facility (DCF) data sets.
  • DCFSC Use this keyword to specify the SMS storage class for the Data Collection Facility (DCF) data sets.
  • DCFUNIT Use this keyword to specify the allocation unit type for the Data Collection Facility (DCF) data sets. The type is usually a generic name (for example, TAPE or DISK).
  • DELETEDB-REORG-Command Use this keyword to specify whether the current database data set will be deleted after the processing is complete.
  • EXPAND Use this keyword to specify that compressed database segments are expanded during the unload of the database. The expanded unload file will be in the IBMHDUNLOAD format with standard IBM headers.
  • HSSRUNLOADEXIT-REORG-Command Use this keyword to specify that an HSSR FABHFSU unload user exit is to be used during unload processing.
  • HSSR2UNLOADEXIT-REORG-Command Use this keyword to specify that an HSSR2 FABHURG1 unload user exit is to be used during unload processing.
  • ICCOPIES-REORG-Command Use this keyword to specify the number of image copies the Auto-Enable utility will make if the IMAGECOPY keyword option is Y.
  • ICDC-REORG-Command Use this keyword to specify the SMS data class for the image copy data sets.
  • ICEXPDT-REORG-Command Use this keyword to specify the expiration date for the image copy data set. When the date you specify occurs, the data set can be deleted or written over by another data set.
  • ICGDG-REORG-Command Use this keyword to specify whether the pattern data set name for the image copy represents a Generation Data Group (GDG). The keyword is ignored if IMAGECOPY(N) is specified.
  • ICIDX-REORG-Command If non-recoverable (NONRECOV) and no image copy required (NOICREQ) is specified in DBRC for the HIDAM database, use this keyword to specify that BMC Database Director for IMS creates an image copy of the primary index.
  • ICMASK-REORG-Command Use this keyword to specify the pattern name for the image copy data set. Enter a pattern name that represents the name as it would appear in a JCL DSN= statement. The keyword is ignored if IMAGECOPY(N) is specified.
  • ICMC-REORG-Command Use this keyword to specify the SMS management class for the image copy data sets.
  • ICREFDD-REORG-Command Use this keyword to specify the reference DD that contains the override values that you want BMC iCopy for IMS to use for the output image copy.
  • ICRETPD-REORG-Command Use this keyword to specify the retention period for an image copy data set. After the retention period, the data set can be deleted or written over by another data set.
  • ICSTACK-REORG-Command Use this keyword to specify whether the image copy process produces stacked data sets. The keyword is ignored if IMAGECOPY(N) is specified.
  • ICSC-REORG-Command Use this keyword to specify the SMS storage class for the image copy data set. You can use this keyword to override the default SMS storage class for your system. The keyword is ignored if IMAGECOPY(N) is specified.
  • ICUNIT-REORG-Command Use this keyword to specify the allocation unit type for the image copy data set. The type is usually a generic name (for example, TAPE or DISK). Check with your system administrator if you do not know the value for this keyword.
  • IMAGECOPY-REORG-Command Use this keyword to specify whether the Auto-Enable utility creates an image copy of the database. The image copy occurs after Auto-Enable loads the database.
  • INDEXONLY Use this keyword to specify the rebuild of an online index database without reorganizing the associated primary database. The keyword is valid for:
  • LOGCOPIES Use this keyword to specify the number of copies of the log that the Auto-Enable utility will make.
  • LOGDC Use this keyword to specify the SMS data class for the log data sets.
  • LOGMASK Use this keyword to specify the pattern name for the log data set. Enter a pattern that represents the name as it would appear in a JCL DSN= statement.
  • LOGMC Use this keyword to specify the SMS management class for the log data sets.
  • LOGSC Use this keyword to specify the SMS storage class to be assigned to this data set. BMC Database Director for IMS lets SMS locate appropriate volumes for the data set allocation. If this parameter is not specified, Database Director utilizes the unit type specification for this data set.
  • LOGUNIT Use this keyword to specify the esoteric unit assigned to this data set. BMC Database Director for IMS locates volumes assigned to this unit on which to allocate the data set.
  • MAXDISKS Use this keyword to specify the maximum number of concurrently allocated disk drives for the BMC Eclipse Utilities for IMS. The drives are used for parallel output and work files created by a Eclipse Utilities job step. This keyword does not apply to database data sets, libraries or SYSIN and SYSPRINT type files.
  • MAXTAPES Use this keyword to specify the maximum number of concurrently allocated tape drives for the BMC Eclipse Utilities for IMS. The drives are used for parallel output and work files created by a Eclipse Utilities job step.
  • MODE Use this keyword to specify the mode to use for the reorganization.
  • NEWSUFFIX Use this keyword to specify a suffix for the shadow data sets that are created during the process. The suffix appends the data set name as a node, separated by a period.
  • NOCONDITIONALPRIORBLOCK Use this keyword to specify that you want the BMC Database Director for IMS to use the values that you specified for the following customizable parameters when you customized the BMC Eclipse Utilities for IMS.
  • OLDSUFFIX Use this keyword to specify a suffix given to the current data set names after the process is complete. The suffix appends the data set name as a node, separated by a period.
  • PARALLELDB Use this keyword to specify whether the Auto-Enable utility performs a parallel reorganization.
  • PARTITION Use this keyword to specify a specific partition of a HALDB database to be processed. The value of the DBD keyword must specify a HALDB database if you use the PARTITION keyword.
  • PL11 Use this keyword to specify that a user exit is coded using PL1.
  • POINTERCHECK Specifies that you want a full pointer check to identify blocks, segments, and actual pointers in error. BMC Database Director for IMS automatically performs a hash pointer check to quickly validate the pointers. The POINTERCHECK keyword can be used to identify the pointers in error.
  • PRIMARY Use this keyword to specify the percentage of free space to maintain in the database data sets. If you also specify the ALLOC keyword, the PRIMARY percentage will be used to increase the size of the data sets, regardless of the existing free space. If you specify zero (0), the primary space allocation will not be increased.
  • RECONDC Use this keyword to specify the SMS data class for the temporary DBRC Recovery Control data sets (RECON1, RECON2, and RECON3).
  • RECONMASK-REORG-Command Use this keyword to specify the data set name pattern for the temporary DBRC Recovery Control data sets (RECON1, RECON2, and RECON3).
  • RECONMC Use this keyword to specify the SMS management class for the temporary DBRC Recovery Control data sets (RECON1, RECON2, and RECON3).
  • RECONSC-REORG-Command Use this keyword to specify the SMS storage class that BMC Database Director for IMS uses to allocate the temporary DBRC Recovery Control data sets (RECON1, RECON2, and RECON3).
  • RECONVOLSER Use this keyword to specify the volume serial number that BMC Database Director for IMS uses to allocate the temporary DBRC Recovery Control data sets (RECON1, RECON2, and RECON3).
  • RELATED-REORG-Command Use this keyword to specify whether the Auto-Enable utility processes logically related database data sets.
  • REORGSUFFIX If you are using the BMC Eclipse Utilities for IMS REORG command to reduce elapsed time, use this keyword to specify the suffix that BMC Database Director for IMS appends to the secondary shadow data sets that Database Director creates for online reorganizations. The suffix appends the data set name as a node, separated by a period.
  • RETRYLIMIT Use this keyword to specify the number of times that BMC Database Director for IMS retries a command when it fails. For example, a:
  • SECONDARY Use this keyword to specify a percentage by which the Auto-Enable utility will increase the secondary space allocation for database data sets when it allocates the shadow data sets. If you specify zero (0), the secondary space allocation will not be increased.
  • STARTDB Use this keyword to specify whether the Auto-Enable utility restarts the IMS online database after processing is complete.
  • STOPDB Use this keyword to specify whether the Auto-Enable utility stops the database after the load process is complete. Stopping the database allows Auto-Enable to perform the data set name swapping necessary to replace the current data sets with the processed data sets.
  • SWAPDSN Use this keyword to specify whether the Auto-Enable utility changes the data set name suffixes to replace the current data sets with the processed data sets.
  • SWITCHOLDS Specifies whether BMC Database Director for IMS issues a /SWI command after a database is stopped. /SWI switches the logs to ensure that a single log dataset does not have database updates for both the old and new database.
  • TIMEOUT-REORG-Command Use this keyword to specify the amount of time, in seconds, that BMC Database Director for IMS will wait for these types of commands to complete:
  • UICUDATA BMC Database Director for IMS generates a NOTIFY.UIC for non-recoverable secondary indexes that do not specify that an image copy is required using ICREQ. Use this keyword to specify the UDATA that Database Director adds to the NOTIFY.UIC command.
  • ULDC Use this keyword to specify the SMS data class for the unload data sets.
  • ULMASK-REORG-Command Use this keyword to specify the pattern data set name for the unload data sets. BMC Database Director for IMS allocates the data sets and then deletes the data sets once processing is complete.
  • ULMC Use this keyword to specify the SMS management class for the unload data sets.
  • ULSC Use this keyword to specify the SMS storage class to be assigned to this data set. BMC Database Director for IMS lets SMS locate appropriate volumes for the data set allocation. If this parameter is not specified, Database Director utilizes the unit type specification for this data set.
  • ULUNIT-REORG-Command Use this keyword to specify the esoteric unit assigned to this data set.
  • WF1DC Use this keyword to specify the SMS data class for the Work File 1 data sets.
  • WF1MASK Use this keyword to specify the pattern data set name for the Work File 1 data sets. BMC Database Director for IMS allocates the data sets and then deletes the data sets once processing is complete.
  • WF1MC Use this keyword to specify the SMS management class for the Work File 1 data sets.
  • WF1SC Use this keyword to specify the SMS storage class to be assigned to this data set. BMC Database Director for IMS lets SMS locate appropriate volumes for the data set allocation. If this parameter is not specified, Database Director utilizes the unit type specification for this data set.
  • WF1UNIT Use this keyword to specify the esoteric unit assigned to this data set. BMC Database Director for IMS locates volumes assigned to this unit on which to allocate the data set.

 

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

Database Director for IMS 8.2