The following parameters are available to the XCOPY command:
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, 3490, DYN1 through DY20, or any combination. If this parameter is omitted, processing defaults to all device types.
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 is an optional parameter. 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.
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 and EXCLUDE.)
A detailed description of the TAPEPULL process can be found in the section TAPEPULL Processing in the chapter "MERGE."
This optional parameter can specify 1 to 20 archive volume data set names or patterns for which processing is to be limited.
A list of one of more archive volumes or volume patterns (or keys to disk archive data sets) to be included in the XCOPY input without regard to their eligibility for other reasons. Their presence in this list overrides the EXCLUDE parameter.
Note: To limit processing to ONLY those ARCHVOLS specified in this parameter, all other ARCHVOLS must be excluded by specifying the parameter EXCLUDE=/.
A list of one or more archive volumes or volume patterns (or keys to disk archive data sets) to be excluded from XCOPY processing (unless in an INCLUDE list). A maximum of 50 entries is supported.
This optional parameter can be specified to limit the scan of ARCHVOL 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 XCOPY command or the command will be rejected.
This optional parameter can be specified to limit the scan of ARCHVOL 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 XCOPY command or the command will be rejected.
This optional parameter can be specified to limit the scan of ARCHVOL 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 XCOPY command or the command will be rejected.
This optional parameter can be specified to limit the scan of ARCHVOL 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 XCOPY 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 and data set names not processed, specify this parameter on the XCOPY command.
The primary output data sets created by XCOPY 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 XCOPY.
If duplexing is performed in the primary XCOPY, 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 XCOPY 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.
FLAG is provided to indicate that the original ARCHVOLS record in the input FILES is to be flagged as processed upon completion of processing. When used in conjunction with the CHKFLAG parameter, XCOPY will automatically bypass volumes already processed in prior XCOPY executions. This will automate COPY selection of volumes so the process can be run at any time to XCOPY volumes that have been newly created since the last XCOPY operation.
Will cause the program to bypass processing for any ARCHVOL previously flagged as having been processed by the FLAG parameter.
EXPDT and RETPD have been added to provide the ability to set the expiration date for all data sets extracted by the XCOPY function. These parameters are mutually exclusive. Whether or not these parameters are specified, ARCHVOL expiration dates will be set according to the existing rules for CA Disk MERGE processing (that is, DYNEXPDT sysparm will be used). For details, see DYNEXPDTE99365 in the Systems Guide.
If these output ARCHVOLS are being sent offsite and you normally use the External Data Manager for your output tape support, you can consider updating the XCOPY executing program name so that your output tapes are not managed by EDM. You can do this by updating your JCL or PROC MI= statement to specify a program name of MI=000 instead of MI=002. This runs the XCOPY PROC under the alias name of ADSMI000 and allows the output to have a valid expiration date instead of permanent retention if you set DYNEXPDT accordingly. This would be recommended if IXMAINT processing on the output FILES is being done at the offsite location (or not at all), or if the output tapes are not in your local tape library management system.
For more information, see the section Year 2000 Considerations in the chapter "General Information."
By default, XCOPY 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 can specify a maximum of input volumes to be processed for this execution of XCOPY, which is 999,999 volumes. Default value for this parameter is 32,767.
Multi volume archvols are a single data set, so they only count as one input volume.
Selects only the latest copy of the data sets selected. All other versions are ignored.
|
Copyright © 2015 CA Technologies.
All rights reserved.
|
|