REORG and SIMULATE Statements

REORG and SIMULATE statements syntax

REORG statement

Use this statement to specify that REORG is to reorganize selected data sets.

SIMULATE statement

Use this statement to specify that REORG is to report on data sets that would have been processed if REORG had been specified.

REORG and SIMULATE statements operands

The following operands may be specified with the REORG and SIMULATE statements.

ALIASCHECK=

Specifies if a check for an existing catalog alias for the backup data set is done prior to allocating a backup data set.

Do not check for an existing alias. If an alias does not exist, the backup data set is cataloged in the master catalog. This fails if the job does not have authority to update the master catalog.

Check for an existing alias and fail the backup or reorganization if one does not exist.

Default: From the FDRREORG option table that is shipped set to “YES”.

ALWAYSBACKUP

Specifies that a backup is always taken of IAM or VSAM data sets that meet the general selection criteria but do not qualify for reorganization. When using this operand, data sets qualify for a backup when ALL CRITERIA EXCEPT THOSE LISTED BELOW are met:

This operand can also be specified on the SELECT statement. Specify ALWAYSBACKUP at the SELECT level if you want to limit this option to specific data sets.

BACKUP=

Defines the default disposition of the backup data sets after the target data set has been successfully reorganized. The value specified on the SELECT statement that selects the data set takes precedence.

Same as PERM except backup data sets is a +1 Generation Data Group (GDG). REORG dynamically defines any Generation Data Groups (GDGs) that do not already exist. The high-level qualifier of the dynamically generated Generation Data Groups (GDGs) must be aliased to an ICF catalog. GDGs are not supported for parallel backups.

Backup data sets on DASD are not deleted and uncataloged. Backup data sets on tape are not uncataloged.

Backup data sets on DASD are deleted and uncataloged. Backup data sets on tape are uncataloged. If the LASTAPE operand is specified, BACKUP=PERM is forced.

Default: From the FDRREORG option table that is shipped set to TEMP.

BACKUPALLOC=

Defines the allocation method to use when allocating backup data sets.

Allocate by SMS storage class.

Allocate by unit name.

Default: From the FDRREORG option table that is shipped set to UNIT.

BACKUPDATACLASS=

BACKUPMGMTCLASS=

BACKUPSTORCLASS=

smsclass

Defines the default SMS data, management, and storage classes for backup data sets, used if BACKUPALLOC=SMS. These operands cannot be specified with BACKUPUNIT=. The values specified on the SELECT statement that selects the data set takes precedence. Your installation ACS routines may override these values.

Default: The default for these operands can be set in the FDRREORG option table.

BACKUPEXPDT=

BACKUPRETPD=

Defines the default expiration date or retention period to be used for all backup data sets; specify only one of these operands. The value specified on the SELECT statement that selects the data set takes precedence. Specify BACKUPEXPDT= as a date in Julian format with a 2-digit year “yyddd” or a 4-digit year “yyyyddd”. If the 2-digit year is used, year numbers less than 70 are assumed to be in the 21^st century (for example, 03123 = 2003.123).

Default: The default for BACKUPRETPD= can be set in the FDRREORG option table.

Defines how FDRREORG treats a backup failure that occurs as part of a reorganization. Backup failures that occur as a result of data sets selected via the NOREORG or ALWAYSBACKUP operands are always treated as an error.

The failure is treated as an error and results in a return code of 8.

The failure is treated as a warning and results in a return code of 4.

Default: From the FDRREORG options table that is shipped set to ERROR.

BACKUPGROUP=

Defines the default group name to be used to generate the names of the backup data sets. The number of characters specified replace (left to right) characters in the target data set name. The value specified on the SELECT statement that selects the data set takes precedence. You can specify a special identifier of &RACFUID or &RACFGID to indicate that the IBM RACF user id or IBM RACF group id be used. See SELECT Statement for examples.

If MODE=PARALLEL, you must place a single question mark somewhere in the specified string. The question mark is replaced by a letter starting with “A” to identify the multiple backups taken in parallel mode.

Example: BACKUPGROUP=BKUP?

The generated backup data set name is the name of the selected data set with BKUPA overlaying the first five characters of the first backup name; BKUPB overlays the first five characters of the second backup name, and so on.

BACKUPINDEX=

Defines the default pattern to be used to add or delete index levels when generating the backup data set name. REORG uses each index level specified in BACKUPINDEX= in place of the original index level. If a period is specified without any characters following, the original index level is copied to the backup data set name. If + is specified, the character following the + is inserted into the backup data set name as a new index level. If ++ is specified, the characters following the ++ are added to the end of the backup data set name as a new index level. If -- is specified, the index level is dropped from the backup data set name. The value specified on the SELECT statement that selects the data set takes precedence. You can specify a special identifier of &RACFUID or &RACFGID to indicate that the IBM RACF user id or IBM RACF group id be used. See SELECT Statement for examples.

If MODE=PARALLEL, you must place a single question mark somewhere in the specified string. The question mark is replaced by a letter starting with “A” to identify the multiple backups taken in parallel mode.

Example: BACKUPINDEX=++BACKUP?

The generated backup data set name is the name of the selected data set with “.BACKUPA” appended to the name of the first backup, “.BACKUPB” is appended to the name of second backup, and so on.

Default: From the FDRREORG option table that is shipped set to ++BACKUP.

BACKUPSTRING=

Specifies an old string and a new string enclosed in parentheses to be used in generating the name of a backup data set. Only the first occurrence of the old string is replaced by the new string. See SELECT Statement for examples.

If MODE=PARALLEL, you must place a single question mark somewhere in the specified string. The question mark is replaced by a letter starting with “A” to identify the multiple backups taken in parallel mode.

Example: BACKUPSTRING=(CLUSTER,BACKUP?)

The generated backup data set name is the name of the selected data set with BACKUPA replacing CLUSTER in the name of the first backup, BACKUPB replaces CLUSTER in the name of the second backup, and so on.

unit

Defines a valid unit name containing tape or DASD devices to be used for allocating backup data sets when BACKUPALLOC= is UNIT. The unit name specified must not define a group of devices that contain a mixture of device classes (that is, 3480s and 3380s). It is allowed to use a unit name that defines a group of devices with a mixture of device models (that is, 3380s and 3390s). This operand cannot be specified with BACKUPSTORCLAS=.

Default: From the FDRREORG option table that is shipped set to SYSDA.

nn

For backup data sets on tape, this operand defines the number of units to be allocated for backup data sets for each task. For backup data sets on DASD, this operand defines the minimum number of units to be allocated for each backup data set. REORG dynamically increases the number of DASD units for a DASD backup data set to ensure that sufficient space is available to backup the target data set. Allowable values are in the range of 1-50.

Default: From the FDRREORG option table that is shipped set to 1.

Specifies whether FDRREORG performs a build index on the empty Alternate Indexes (AIXs) of base clusters selected for reorganization.

Do not build empty Alternate Indexes (AIXs).

Build empty Alternate Indexes (AIXs).

Default: NO.

CKPTALLOC=

Defines the allocation method to use when allocating the checkpoint data set.

Allocate by SMS storage class.

Allocate by unit name.

Default: From the FDRREORG option table that is shipped set to UNIT.

CKPTDATACLASS=

CKPTMGMTCLASS=

CKPTSTORCLASS=

smsclass

Defines the default SMS data, management, and storage classes for the checkpoint data sets, used if CKPTALLOC=SMS. These operands cannot be specified with CKPTUNIT=. Your installation ACS routines may override these values.

Default: The default for these operands can be set in the FDRREORG option table.

CKPTPREFIX=

hlq

Specifies the high-level qualifier to use when constructing the name of the checkpoint file. To make it possible for the RECOVER statement to find the checkpoint file for a failed REORG, the checkpoint data set is cataloged with a name of: &CKPTPREFIX.REORGCKP.job.Dccyyddd.Thhmmss

The IBM RACF user id is used for the high-level qualifier.

The IBM RACF group id is used for the high-level qualifier.

Default: From the FDRREORG option table that is shipped set to FDRREORG.

CKPTUNIT=

unit

Specifies a unit name containing DASD devices to use for the checkpoint file when CKPTALLOC= is UNIT. This operand cannot be specified with CKPTDATACLASS=, CKPTMGMTCLASS=, or CKPTSTORCLASS=.

Default: From the FDRREORG option table that is shipped set to SYSDA.

Directs FDRREORG to convert a VSAM KSDS or AIX that was defined with the IMBED and/or REPLICATE attributes to NOIMBED and NOREPLICATE.

If the cluster is redefined with a SMS data class that requests Extended Format (EF) (required for VSAM compaction or extended addressability), then this operand is required since EF VSAM clusters do not support IMBED. Without this operand, FDRREORG issues message FDRS63* and redefine the KSDS or AIX as non-Extended Format using the original define parameters.

Specifies whether to use ALLOCATED or USED space for the CYLS and TRKS options of the EXCLUDE and SELECT statements.

EXCLUDE and SELECT processing uses allocated space for CYLS or TRKS.

EXCLUDE and SELECT processing uses used space for CYLS or TRKS.

Default: USED.

DSNRETRY=

Defines the default action to take for data sets that are not available when they are selected for processing. The value specified on the SELECT statement that selects the data set takes precedence.

The data set is added to the task's retry queue and an enqueue for the data set is left pending. If the enqueue is not satisfied before the task completes its processing, the data set is bypassed.

The data set is bypassed.

The data set is added to the task’s retry queue and periodic attempts are made to allocate the data set. If the data set does not become available before the task completes its processing, the data set is bypassed.

The data set is added to the task's retry queue and an enqueue for the data set is left pending. The task waits for all data sets queued with the wait option before terminating. An operator STOP (P) command can be used to shutdown FDRREORG normally if it is no longer desirable to wait for data sets.

Default: NO. Do not override the default in a JES3 installation.

Specifies the types of data sets to be considered for reorganization.

All data sets are eligible for reorganization.

IAM data sets are eligible for reorganization.

Partitioned data sets are eligible for reorganization (compression). PDS is ignored if MODE=PARALLEL.

VSAM data sets are eligible for reorganization.

Default: ALL.

Specifies whether FDRREORG keeps the backups of previously loaded IAM or VSAM data sets that are now empty. Specifying KEEP is useful if the backups created by FDRREORG are retained as application backups and the current generation of each backup reflects the current contents of all the data sets within that application.

Empty backup data sets are deleted.

Empty backup data sets are kept.

Default: DELETE.

Specifies whether FDRREORG sets return code 8, 4, or 0 if a data set selected for reorganization is in use by another job or user.

Set return code 0 if a data set is in use.

Set return code 4 if a data set is in use.

Set return code 8 if a data set is in use.

IAMCOMPPERM=

IAMCOMPTEMP=

Specifies whether FDRREORG backs up compressed IAM data sets in compressed format when BACKUP=GDG or BACKUP=PERM (IAMCOMPPERM=) or BACKUP=TEMP (IAMCOMPTEMP=) has been specified.

Backups are in compressed format.

Backups are not in compressed format.

Default: From the FDRREORG option table that is shipped as IAMCOMPPERM=NO and IAMCOMPTEMP=YES.

IAMDEFINE=

Specifies whether FDRREORG deletes and defines IAM data sets that are reorganized.

IAM data sets are not deleted and defined before reloading.

IAM data sets are deleted and defined before reloading.

Default: From the FDRREORG option table that is shipped set to NO.

IAMDISP=

Specifies the disposition REORG is to use when allocating IAM data sets to be reorganized.

IAM data sets are allocated DISP=OLD.

IAM data sets are allocated DISP=SHR.

Default: OLD (and recommended value).

Specifies whether FDRREORG retains the original creation date when redefining VSAM.

FDRREORG uses the current date.

FDRREORG retains the original creation date.

Default: From the FDRREORG options table that is shipped set to YES.

LASTAPEPREFIX=

hlq

Specifies the high-level qualifier to be used when cataloging or locating the special LASTAPE catalog entries.

The IBM RACF user id is used for the high-level qualifier.

The IBM RACF group id is used for the high-level qualifier.

Default: From the FDRREORG option table that is shipped set to FDRREORG.

Requests that the REORG processor append new backup data sets to the tape volumes used in a prior run. At the end of a successful run, a data set is cataloged for each task of the form: &LASTAPEPREFIX.job.TASKnn.LASTAPE

The catalog entry identifies the last volume used and the next file sequence number to use. If the next file to be backed up would have gone to a new tape, no LASTAPE is cataloged. Use of this option requires the BACKUP= operand to be specified as either PERM or GDG. If BACKUP=TEMP is specified or defaulted, it is forced to PERM.

LISTNOREORG=

Defines the NOREORG list print option.

The NOREORG list is not printed.

The NOREORG list is printed for REORG or SIMULATE functions.

Default: From the FDRREORG option table that is shipped set to YES.

LOGALLOC=

Defines the allocation method to use when allocating the log data set

Allocate by SMS storage class.

Allocate by unit name.

Default: From the FDRREORG option table that is shipped set to UNIT.

LOGDATACLASS=

LOGMGMTCLASS=

LOGSTORCLASS=

smsclass

Defines the default SMS data, management, and storage classes for the log file, used if LOGALLOC=SMS. These operands cannot be specified with LOGUNIT=. Your installation ACS routines may override these values.

Default: The default for these operands can be set in the FDRREORG option table.

LOGPREFIX=

hlq

Specifies the high-level qualifier to use when constructing the name of the log file. To make it possible for the RECOVER statement to find the log file, the log data set is cataloged with a name of: &LOGPREFIX.REORGLOG.job.Dccyyddd.Thhmmss

The IBM RACF user id is used for the high-level qualifier.

The IBM RACF group id is used for the high-level qualifier.

Default: From the FDRREORG option table that is shipped set to FDRREORG.

LOGUNIT=

unit

Specifies a unit name containing DASD devices to use for the log file when LOGALLOC= is UNIT. This operand cannot be specified with LOGDATACLASS=, LOGMGMTCLASS=, or LOGSTORCLASS=.

Default: From the FDRREORG option table that is shipped set to SYSDA.

nnn

Specifies the maximum number of outstanding enqueues allowed for the DSNRETRY= enqueue and WAIT operands for each volume processor task. When this limit is reached, data sets are added to task retry queue as if the RETRY operand was specified. The enqueue is issued when the outstanding enqueue count falls below this maximum. Once the volume processor task has completed processing all volumes and is waiting for data sets queued with the WAIT option, no additional enqueues are issued.

Default: From the FDRREORG option table that is shipped set to 999.

MAXENVERR=

nn

Specifies the maximum number of environmental errors allowed. When this limit is reached, all sub-tasks terminate after processing the currently active data set. No additional REORG or SIMULATE statements are processed. Environmental errors are any backup or re-load failures not caused by a system abend. Insufficient space, or target data set not available, are examples of environmental errors.

Default: From the FDRREORG option table that is shipped set to 99.

nnn

Specifies the maximum number of backup files to place on a single tape volume.

Default: From the FDRREORG option table that is shipped set to 255.

MAXPARALLELBACKUPS=

n

Specifies the maximum number of concurrent backups for each data set when MODE=PARALLEL has been specified. For an individual data set, FDRREORG additionally limits the number of concurrent data set backups to the number of USED volumes. You may specify a value between 2 and 9.

Default: 2.

MAXSYSERR=

nn

Specifies the maximum number of system abends allowed. When this limit is reached, all sub-tasks terminate after processing the currently active data set. No additional REORG or SIMULATE statements are processed.

Default: From the FDRREORG option table that is shipped set to 99.

MAXTASKS=

nn

Specifies the maximum number of concurrent volumes to be processed. You may specify any number from 1 to 15, inclusive.

Default: From the FDRREORG option table that is shipped set to 4.

Specifies the concurrent data set backup mode.

All data sets are processed.

Only IAM and VSAM data sets with more than one USED volume are processed. FDRREORG creates multiple backup tasks to backup specific portions of the data set. Use the MAXPARALLELBACKUPS= operand to specify the number backups per data set.

Compresses PDSs and processes IAM and VSAM data sets not supported by parallel mode. This option is intended to be used to complement those jobs run with MODE=PARALLEL. All data sets that are not processed in parallel mode are processed in single mode.

Default: ALL.

Specifies if alternate index data sets are moved if the base cluster is moved.

Alternate index data sets are defined on the original volumes.

Alternate index data sets are defined using the NEWVOLSDATA= and NEWVOLSINDEX= specified for the base cluster.

Default: NO. YES is forced if a non SMS-managed cluster is redefined as an SMS-managed cluster or if an SMS-managed cluster is redefined a non SMS-managed cluster.

MSGLEVEL=

Specifies the lowest level message type to be displayed on the sub-task print file that has the ddname REORGPRT.

Only error messages are displayed.

Informational, warning, and error messages are displayed.

Warning and error messages are displayed

Default: From the FDRREORG option table that is shipped set to “I”.

MSGTIMESTAMP=

Specifies whether messages written to REORGPRT are suffixed with the current date, time, and the internal sub-task id that issued the message. If “YES” is requested or defaulted, the LRECL of the REORGPRT file is increased to 151.

Messages are not time-stamped.

Messages are time-stamped.

Default: From the FDRREORG option table that is shipped set to “YES”.

If specified, the default selection criteria from the FDRREORG option table is not used when evaluating SELECT statements.

Specifies whether FDRREORG’s internal define keeps the current management status and volumes for non SMS-managed data sets or let the SMS ACS routines decide.

Non SMS-managed data sets are redefined as non SMS-managed data sets.

The installation SMS ACS routines decide if the data set is defined as a SMS-managed data set.

Specifies that selected data sets are backed up but not reorganized.

This operand can also be specified on the SELECT statement. Specify NOREORG at the SELECT level if you want to limit this option to specific data sets.

NOUPDATES=

Specifies the action to take for IAM or VSAM data sets selected for reorganization that have had no adds, no deletes, and no updates.

The data set is not reorganized.

The data set is reorganized.

Default: From the FDRREORG option table that is shipped set to NO.

OWNERSTRING=

cccc

Specifies a string of up to four characters that are used as an eye-catcher in the owner ID of the data component of a VSAM KSDS. REORG updates the owner ID field of the data component's catalog entry to record information used to insure data set integrity and to identify data sets that were being processed by REORG when either a system failure occurred, or REORG was canceled or otherwise terminated. See RECOVER Statement for additional information.

Default: From the FDRREORG option table that is shipped set to FDR$.

PDSDISP=

Specifies the disposition REORG is to use when allocating partitioned data sets to be compressed.

Partitioned data sets are allocated DISP=OLD.

Partitioned data sets are allocated DISP=SHR.

Default: OLD.

Specifies if POOLDASD from BMC or a similar allocation control product is installed, and unit names that have not been defined to the system are being used by POOLDASD to control volume allocation.

Do not accept undefined unit names.

Accept undefined unit names.

Default: From the FDRREORG options table that is shipped set to NO.

Specifies whether FDRREORG issues a message containing the number of records read and the number of records loaded after reorganizing IAM and VSAM data sets.

Do not issue the FDRS55 message that contains the record counts.

Issue FDRREORG message FDRS55 that contains the record counts.

Default: From the FDRREORG options table that is shipped set to “NO”.

Specifies whether FDRREORG decreases the primary space allocation of enhanced format IAM data sets or VSAM KSDS data sets if the total allocated space is less than the primary space allocation used to originally define the file. This option only applies to data sets that are redefined by FDRREORG.

Specifying YES for this option enables FDRREORG to preserve the current space allocation for data sets that may have had excess free space released by COMPAKTOR, or for IAM files loaded with RELEASE=YES.

FDRREORG always uses the original primary space allocation.

FDRREORG uses the total allocated space as the primary when defining data sets that have had the total allocated space reduced to an amount less than the original primary.

Default: From the FDRREORG options table that is shipped set to YES.

RUNTIME=

Defines the number of minutes that this REORG or SIMULATE statement is allowed to run. When this limit is reached, processing for all active data sets is completed and the next REORG or SIMULATE statement, if any, is processed.

Specifies whether FDRREORG sets a return code of 8 if no data sets are selected by REORG or SIMULATE. Due to the nature of the selection process and the selection criteria specified, this may be a natural occurrence.

Set return code 0 if no data sets are selected.

Set return code 4 if no data sets are selected.

Set return code 8 if no data sets are selected.

Default: From the FDRREORG option table that is shipped set to YES.

If specified on a SIMULATE statement, requests that a simulated compression be performed on partitioned data sets.

Specifies whether FDRREORG’s internal define keeps the current management status and volumes for SMS-managed data sets or let the SMS ACS routines decide.

SMS-managed data sets are redefined as SMS-managed data sets on the original first volume of the data set. SMS chooses additional volumes if required.

The installation SMS ACS routines decide if the data set is defined as a SMS-managed data set. SMS selects the volumes used to define the data set

Directs FDRREORG to dynamically add an SMS dummy candidate volume for SMS-managed data sets before starting the reload. If more space is required during the reload than is available on the current volumes, the candidate volume is converted to a real volume and the reload is able to complete without an out of space error. If the volume is not used, FDRREORG removes it.

SORTRPT=

Specifies the sorting option for the report written to REORGRPT. Specifying YES requires that information related to each data set processed or selected be kept in storage until the function is completed.

Report is produced as data sets are processed or selected.

Report is produced at the end of a REORG, SIMULATE, or RECOVER function in data set name and volume serial number order.

Default: From the FDRREORG option table that is shipped set to NO.

STOPTIME=

Defines a time in hours and minutes (hhmm or hh.mm) that processing for this statement is to stop. When this time is reached, processing for all active data sets is completed and the next REORG or SIMULATE statement, if any, is processed.

SUBTASKABEND=

Specifies the action to take if a volume processor sub-task abends.

Continue processing without the sub-task.

Quiesce all active work and terminate.

Default: From the FDRREORG option table that is shipped set to CONT.

Specifies the action to take for partitioned data sets that do not have a current backup. If the update indicator is on in a data sets Format 1 DSCB, the data set is considered to not have a current backup.

The data set is not compressed.

The data set is compressed.

Default: From the FDRREORG option table that is shipped set to YES.

VSAMDEFINE=

Specifies when FDRREORG deletes and defines VSAM KSDS data sets that are reorganized.

VSAM KSDS data sets are always deleted and defined before reloading.

Only VSAM KSDS data sets that cannot be reused are deleted and defined before reloading.

Disables delete and define of all VSAM KSDS data sets. VSAM KSDS data sets that cannot be reused are not reorganized.

This operand can also be specified on the SELECT statement.

Default: From the FDRREORG option table that is shipped set to IFREQ.

VSAMDISP=

Specifies the disposition REORG is to use when allocating VSAM data sets to be reorganized.

VSAM data sets are allocated DISP=OLD.

VSAM data sets are allocated DISP=SHR.

Default: OLD (and the recommended value).