The MERGE command syntax is:
MERGE SIMULATE,TYPES=,LIMITS=,PERCENT=,DATE=,EXPDAYS=,TAPEPULL=,MULTVOL,MAXVOLS=, TDSNAMES=,NOMERGEIN,INCLUDE=,RINCLUDE=,EXCLUDE=,FCREDT=,FDAYSOLD=,CREDT=, DAYSOLD=,LISTALL,COPY,UNCATALOG,DEVTYPE=,PRIMARY2,FAST=,MSGBYPAS,MINVOLS=,USEARCHVOL,VBACKUPVOLS
This parameter causes MERGE to execute without mounting any tape volumes or moving any archived data sets. It will process the DSNINDEX and ARCHVOLS files and produce reports indicating what would have occurred in a live run.
This optional parameter can be specified to limit processing to those archive data sets residing on specified device types. You can specify TAPE, DISK, 3480, DYN1 – DY20, or any combination. If this parameter is omitted, processing defaults to all device types.
This optional parameter governs the distribution of data sets on the new output volumes. It specifies a list of one to five limit values of either Julian dates or retention periods in ascending sequence. The retention periods are 1- to 5-digit numbers and the Julian dates are 7-digit dates (that is, yyyyddd). Each value represents a boundary for the data sets that are to be merged to that output group. When a data set's expiration date is greater than a boundary limit, it is merged to the next output group, with the exception of the last boundary limit. If a data set's expiration date exceeds even the last boundary value, it will still be merged to the last output group. (A maximum of 5 entries is supported.)
Fast Archived datasets, with varying expiration dates that are input to Merge, when using LIMITS= require special handling to prevent them from going to differing output volumes. For this condition with LIMITS=, Merge saves the output volume assigned to the first of the Fast group and insures that same output volume is assigned to all other members of the group.
Note: SMS-managed data sets will always be written to the ARCHVOL associated with the highest limit. However, since their expiration date is dynamic (that is, it can be changed by alterations to the Management Class, or by adding more backup copies into the files data set, and so on.), there is really no validity in using the LIMITS parameter on these data sets.
This optional parameter indicates the minimum percent of used space that is to be maintained on each archive volume. When the unexpired data sets on a volume account for less than this percentage of the total volume, the volume is selected for merge processing.
PERCENT=0 — Select no archive volumes based on the PERCENT parameter. Use the INCLUDE parameter for input volume specification.
PERCENT=nn — Select the volume when its percent used drops below nn.
PERCENT=100 — (default) Process all archive volumes regardless of the space used on them.
Note: If you specify the USEARCHVOL parameter, the value that is used for the PERCENT test may differ from the value that would be calculated when USEARCHVOL is not specified. This difference is the result of USEARCHVOL using the percent utilization field (ARCPCTUS) from the ARCHVOL record. For more information, see USEARCHVOL.
This optional parameter can specify that a date in an accepted CA Disk format be used instead of the current date in determining which archived data sets have expired.
This parameter is provided to exclude archive volumes from the merge processing if either the archive volume will expire within nnnn days or all of the data sets on the archive volume will expire within nnnn days (where nnnn is a number of days from the current date or the date specified on the DATE parameter).
The current date plus this number of days is compared to the archive volume expiration date and the highest expiration date of all the data sets on the volume. If the date is greater than either of these expiration dates, the volume is excluded from MERGE processing.
This is an optional parameter. See Operation Concerns and TAPEPULL Processing, for a complete description of the TAPEPULL support, including the need for the //TAPEPULL DD statement.
Specify TAPEPULL=GEN to generate a hardcopy list of the archive tape volumes selected for merging; that is, the input tapes that must be pulled from the tape library. This list is also saved in a disk data set and used with the TAPEPULL=USE option as described below. Normally the SIMULATE parameter is supplied along with this parameter.
Specify TAPEPULL=USE to limit processing to those input volumes listed when the TAPEPULL=GEN parameter was specified on a previous execution. The only additional optional parameters that are valid when processing in this mode are COPY, LIMIT, and EXCLUDE.
This optional parameter allows multi-volume tape archive volumes to be eligible for Merge. Other parameters can over-ride MULTVOL. By default, Merge bypasses multi-volume tape archive volumes.
This optional parameter can specify a maximum number of input volumes to be processed for this execution of MERGE, which is 999,999 volumes. Default value for this parameter is 150.
Multi-volume archvols are a single data set, so they only count as one input volume.
This optional parameter can specify 1 to 20 archive volume data set names or patterns for which processing is to be limited.
This optional parameter causes archive volumes created during previous merge runs to be excluded (unless also in an INCLUDE list).
A list of one of more archive volumes or patterns (or keys to disk archive data sets) to be included in the MERGE input without regard to their eligibility for other reasons. Their presence in this list overrides even the EXCLUDE and NOMERGEIN parameters.
The volumes specified in this parameter will be processed as well as those selected as a result of the PERCENT parameter. Specify PERCENT=0 to cause only these volumes to be processed. (A maximum of 100 entries is supported.)
A list of one or more real volumes or patterns to be included in the MERGE input without regard to their eligibility for other reasons. All archive data sets residing on the real volumes specified will be included. The RINCLUDE parameter operates similar to the INCLUDE parameter in that it overrides all other selections except TYPES*. It can be used independently or in conjunction with the INCLUDE parameter. Multi-volume archive data sets will not be processed unless the first volume is specified in the RINCLUDE.
The volumes specified in this parameter are processed as well as those selected as a result of the PERCENT parameter. Specify PERCENT=0 to only process these volumes. (A maximum of 100 entries is supported).
A list of one or more archive volumes or volume patterns (or keys to disk archive data sets) to be excluded from MERGE processing, unless in an INCLUDE or RINCLUDE list. A maximum of 50 entries is supported.
This optional parameter can be specified to limit the scan of ARCHVOLS records to those whose creation date is greater than or equal to (from or since this creation date) the date specified via this value. The date value must be in an accepted CA Disk format. This parameter and the FDAYSOLD= parameter are mutually exclusive. Do not specify both on the same MERGE command or the command will be rejected.
This optional parameter can be specified to limit the scan of ARCHVOLS records to those whose creation date is greater than or equal to the current date (or an alternate date specified in the DATE= parameter) minus the number of days specified on this parameter. The maximum value for this parameter is 9999. This parameter and the FCREDT= parameter are mutually exclusive. Do not specify both on the same MERGE command or the command will be rejected.
This optional parameter can be specified to limit the scan of ARCHVOLS records to those whose creation date is less than or equal to the date specified via this value. The date value must be in an accepted CA Disk format. This parameter and the DAYSOLD= parameter are mutually exclusive. Do not specify both on the same MERGE command or the command will be rejected.
This optional parameter can be specified to limit the scan of ARCHVOLS records to those whose creation date is less than or equal to the current date (or an alternate date specified in the DATE= parm) minus the number of days specified on this parameter. The maximum value for this parameter is 9999. This parameter and the CREDT= parameter are mutually exclusive. Do not specify both on the same MERGE command or the command will be rejected.
Normally report records and messages generated by this function are produced only for the volumes actually processed. If you want to print statistics and messages for volumes not processed, specify this parameter on the MERGE command.
The primary output data sets created by merge can have duplicate and/or tertiary copies created concurrently, often referred to as triplexing. (This is controlled by the dynamic allocation sysparms or by providing the proper JCL directly.) This COPY parameter indicates whether or not an additional copy is to be produced in an extra job step following the primary merge.
If duplexing is performed in the primary merge, this parameter causes the keys of the duplicate copies to be written to a disk data set and passed to the subsequent step where they can be copied again, creating tertiary copies. If duplexing is not done, the key of the primary (instead of the duplicate) is passed to the copy step.
This parameter merely causes the keys of the appropriate new archive volumes to be written (saved) in a disk data set. You must request procedure MERGCOPY directly after the MERGE procedure if you want to actually execute the extra copy step. An ARCHVOLS record will be made for each new copy volume and properly chained from the primary (or duplicate) ARCHVOLS record.
By default, MERGE does not change the catalog status of any data set that it merges. Specify this UNCATALOG parameter to have CA Disk uncatalog data sets that are cataloged for auto-restore purposes after each data set is successfully merged.
You can specify this parameter on your disk-to-tape Merge runs if you wished to prevent auto-restore from tape, but allow it from disk.
Before specifying this parameter, see the section DSNDELETE Command "FILES Maintenance" and the section BACKUP Command in the chapter "Backup/Archive" regarding the combination of sysparm UNCATDEL and an expiration date of 1999.000.
By default, MERGE processes all device types. This optional parameter can be used to limit processing to only those DSNINDEX records residing on a particular device type. Possible values are: 3380, 3390, 3480, 3490, REDW (StorageTek's Redwood device) or 3590 (IBM's Magstar device).
This optional parameter causes only PRIMARY2 archive volumes to be selected for Merge. No other parameters can override PRIMARY2. By default, Merge bypasses PRIMARY2 archive volumes.
Specify YES or NO to indicate whether the data set selected for processing should use the Fast Merge path.
Specify this parameter on the MERGE command to show the ARCHVOLS and the reason why they were bypassed for processing.
This optional parameter can specify a minimum number of input volumes to be processed for this execution of MERGE. Default value for this parameter is 0.
This optional parameter causes MERGE processing to bypass reading the DSNINDEX records in order to determine the actual percent utilization of the archive data set. The percent utilization field (ARCPCTUS) in the ARCHVOL record is used instead in the selection process. Because ARCPCTUS is updated during IXMAINT, the USEARCHVOL parameter can provide a significant performance improvement by not reading the DSNINDEX record. The longer is the period after IXMAINT was run, the larger the percent difference between MERGE with and without USEARCHVOL could be. This option is only available when a Files Data Base is being processed.
This optional parameter causes only VBACKUP volumes to be selected for MERGE. By default, MERGE bypasses VBACKUP volumes.
Note: If the PACK parameter is not used for VBACKUP, sysparm ARCHPACK must be set to N to maintain the one VBACKUP volume data set to one Archvol relationship. Using ARCHPACK set to Y will put multiple VBACKUP data sets on one ARCHVOL.
|
Copyright © 2015 CA Technologies.
All rights reserved.
|
|