Customizing the AXQUSETS member of the PARMLIB
Advanced Archive for DFSMShsm has many parameters that control the
product’s functions. For the most part, values for these parameters are determined by the built-in
default values. If you need to change the default values, you can customize the AXQUSETS member of the product parameter
library.
About this task
The following figure shows the contents of the unaltered USERSETSAXQUSETS member of the Advanced Archive for DFSMShsm product parameter
library.
***********************************************************************
***********************************************************************
* USER SET PARAMETERS
*
* 5698-AAD
* © ROCKET SOFTWARE, INC. OR ITS AFFILIATES 2014-2018.
* ALL RIGHTS RESERVED.
*
***********************************************************************
***********************************************************************
*
ARCHIVE-DATABASE-CLUSTER-NAME ADV.ARCHIVE.ARCHIVE.DB
ARCHIVE-DATABASE-NUMBER-OF-RECORDS 10000
*
*ARCHIVE-DEFAULT-L0-DCOLLECT-RECORD-COUNT 200000
*
ARCHIVE-ACTIVE-LOG-GDG-BASE-DSN ADV.ARCHIVE.ACTIVE.LOG
ARCHIVE-DB-BKUP-GDG-BASE-DSN ADV.ARCHIVE.DBBKUP
ARCHIVE-LOG-BKUP-GDG-BASE-DSN ADV.ARCHIVE.LOGBKUP
*
*ARCHIVE-TARGET TAPE
*
*CLOUDDEF-DATABASE-CLUSTER-NAME ADV.ARCHIVE.CLOUDDEF.DB
*CLOUDDEF-DATABASE-NUMBER-OF-RECORDS 1000
*
*ARCHIVE-MINIMUM-SIZE 0
*ARCHIVE-SELECTION-MAXIMUM-FILES 100000
*ARCHIVE-SELECTION-MAXIMUM-GB 0
ARCHIVE-TARGET-SIZE 99999
*
ARCHIVE-TAPE-DATA-SET-NAME ADV.ARCHIVE.ARCHIVE
ARCHIVE-TAPE-ALLOCATION-UNIT-NAME 3490
*ARCHIVE-TAPE-ALLOCATION-DATACLAS NONE
*ARCHIVE-TAPE-ALLOCATION-MGMTCLAS NONE
*ARCHIVE-TAPE-ALLOCATION-STORCLAS NONE
*ARCHIVE-TAPE2-DATA-SET-NAME NONE
*ARCHIVE-TAPE2-ALLOCATION-UNIT-NAME NONE
*ARCHIVE-TAPE2-ALLOCATION-DATACLAS NONE
*ARCHIVE-TAPE2-ALLOCATION-MGMTCLAS NONE
*ARCHIVE-TAPE2-ALLOCATION-STORCLAS NONE
*ARCHIVE-TAPE3-DATA-SET-NAME NONE
*ARCHIVE-TAPE3-ALLOCATION-UNIT-NAME NONE
*ARCHIVE-TAPE3-ALLOCATION-DATACLAS NONE
*ARCHIVE-TAPE3-ALLOCATION-MGMTCLAS NONE
*ARCHIVE-TAPE3-ALLOCATION-STORCLAS NONE
*ARCHIVE-TAPE4-DATA-SET-NAME NONE
*ARCHIVE-TAPE4-ALLOCATION-UNIT-NAME NONE
*ARCHIVE-TAPE4-ALLOCATION-DATACLAS NONE
*ARCHIVE-TAPE4-ALLOCATION-MGMTCLAS NONE
*ARCHIVE-TAPE4-ALLOCATION-STORCLAS NONE
*
*DELETE-HSM-BACKUP-VERSIONS-AFTER-ARCHIVE YES
*
DATA-CENTER-NAME DATA_CENTER
*
DYNAMIC-ALLOCATION-DATASET-NAME-PREFIX ADV.ARCHIVE
*DYNAMIC-ALLOCATION-UNIT 3390
*DYNAMIC-ALLOCATION-VOLSER NONE
*DYNAMIC-ALLOCATION-DATA-CLASS NONE
*DYNAMIC-ALLOCATION-MANAGEMENT-CLASS NONE
*DYNAMIC-ALLOCATION-STORAGE-CLASS NONE
*
*DYNAMIC-ALLOCATION-SORTWORK-UNIT 3390
*
DYNAMIC-ALLOCATION-VSAM-DATASET-NAME-PREFIX ADV.ARCHIVE
*DYNAMIC-ALLOCATION-VSAM-DATA-VOLSER NONE
*DYNAMIC-ALLOCATION-VSAM-INDEX-VOLSER NONE
*DYNAMIC-ALLOCATION-VSAM-DATA-CLASS NONE
*DYNAMIC-ALLOCATION-VSAM-MANAGEMENT-CLASS NONE
*DYNAMIC-ALLOCATION-VSAM-STORAGE-CLASS NONE
*
*GREGORIAN-DATE-FORMAT MM/DD/YYYY
*
RESTORE-FROM-ARCHIVE-COPY-NUM 1
*L0-TARGET-SIZE 99999
*L0-MINIMUM-SIZE 0
ML2-MINIMUM-SIZE 0
ML2-TARGET-SIZE 99999
*
ML2-TAPE-DATA-SET-NAME HSM.HMIGTAPE.DATASET
ML2-TAPE-ALLOCATION-UNIT-NAME 3490
*ML2-TAPE-ALLOCATION-DATACLAS NONE
*ML2-TAPE-ALLOCATION-MGMTCLAS NONE
*ML2-TAPE-ALLOCATION-STORCLAS NONE
*
*RECYCLE-FROM-ARCHIVE-COPY-NUM 1
*RECYCLE-THRESHOLD-PERCENTAGE 20
*
*RESTORE-SELECTION-MAXIMUM-FILES 100
*RESTORE-SELECTION-MAXIMUM-GB 0
*RESTORE-TO-DRIVE-DYNAMIC-HRECALL YES
*
RESTORE-QUEUE-CLUSTER-NAME ADV.ARCHIVE.RESTORE.QUEUE
RESTORE-QUEUE-NUMBER-OF-RECORDS 10000
*
*-----------------------------------DFSORT PARMS
SORT-PRODUCT-NAME DFSORT
SORT-PRODUCT-PARAMETERS-DDNAME SORTCNTL
*-----------------------------------SYNCSORT PARMS
*SORT-PRODUCT-NAME SYNCSORT
*SORT-PRODUCT-PARAMETERS-DDNAME $ORTPARM
* ***********************************************************************
***********************************************************************
* USER SET PARAMETERS
*
* 5698-AAD
* © ROCKET SOFTWARE, INC. OR ITS AFFILIATES 2014-2018.
* ALL RIGHTS RESERVED.
*
***********************************************************************
***********************************************************************
*
ARCHIVE-DATABASE-CLUSTER-NAME ADV.ARCHIVE.ARCHIVE.DB
ARCHIVE-DATABASE-NUMBER-OF-RECORDS 10000
*
ARCHIVE-ACTIVE-LOG-GDG-BASE-DSN ADV.ARCHIVE.ACTIVE.LOG
ARCHIVE-DB-BKUP-GDG-BASE-DSN ADV.ARCHIVE.DBBKUP
ARCHIVE-LOG-BKUP-GDG-BASE-DSN ADV.ARCHIVE.LOGBKUP
*
*ARCHIVE-TARGET TAPE
*
*CLOUDDEF-DATABASE-CLUSTER-NAME ADV.ARCHIVE.CLOUDDEF.DB
*CLOUDDEF-DATABASE-NUMBER-OF-RECORDS 1000
*
*ARCHIVE-MINIMUM-SIZE 0
*ARCHIVE-SELECTION-MAXIMUM-FILES 100000
*ARCHIVE-SELECTION-MAXIMUM-GB 0
ARCHIVE-TARGET-SIZE 99999
*
ARCHIVE-TAPE-DATA-SET-NAME ADV.ARCHIVE.ARCHIVE
ARCHIVE-TAPE-ALLOCATION-UNIT-NAME 3490
*ARCHIVE-TAPE-ALLOCATION-DATACLAS NONE
*ARCHIVE-TAPE-ALLOCATION-MGMTCLAS NONE
*ARCHIVE-TAPE-ALLOCATION-STORCLAS NONE
*ARCHIVE-TAPE2-DATA-SET-NAME NONE
*ARCHIVE-TAPE2-ALLOCATION-UNIT-NAME NONE
*ARCHIVE-TAPE2-ALLOCATION-DATACLAS NONE
*ARCHIVE-TAPE2-ALLOCATION-MGMTCLAS NONE
*ARCHIVE-TAPE2-ALLOCATION-STORCLAS NONE
*ARCHIVE-TAPE3-DATA-SET-NAME NONE
*ARCHIVE-TAPE3-ALLOCATION-UNIT-NAME NONE
*ARCHIVE-TAPE3-ALLOCATION-DATACLAS NONE
*ARCHIVE-TAPE3-ALLOCATION-MGMTCLAS NONE
*ARCHIVE-TAPE3-ALLOCATION-STORCLAS NONE
*ARCHIVE-TAPE4-DATA-SET-NAME NONE
*ARCHIVE-TAPE4-ALLOCATION-UNIT-NAME NONE
*ARCHIVE-TAPE4-ALLOCATION-DATACLAS NONE
*ARCHIVE-TAPE4-ALLOCATION-MGMTCLAS NONE
*ARCHIVE-TAPE4-ALLOCATION-STORCLAS NONE
*
*DELETE-HSM-BACKUP-VERSIONS-AFTER-ARCHIVE YES
*
DATA-CENTER-NAME DATA_CENTER
*
DYNAMIC-ALLOCATION-DATASET-NAME-PREFIX ADV.ARCHIVE
*DYNAMIC-ALLOCATION-UNIT 3390
*DYNAMIC-ALLOCATION-VOLSER NONE
*DYNAMIC-ALLOCATION-DATA-CLASS NONE
*DYNAMIC-ALLOCATION-MANAGEMENT-CLASS NONE
*DYNAMIC-ALLOCATION-STORAGE-CLASS NONE
*
*DYNAMIC-ALLOCATION-SORTWORK-UNIT 3390
*
DYNAMIC-ALLOCATION-VSAM-DATASET-NAME-PREFIX ADV.ARCHIVE
*DYNAMIC-ALLOCATION-VSAM-DATA-VOLSER NONE
*DYNAMIC-ALLOCATION-VSAM-INDEX-VOLSER NONE
*DYNAMIC-ALLOCATION-VSAM-DATA-CLASS NONE
*DYNAMIC-ALLOCATION-VSAM-MANAGEMENT-CLASS NONE
*DYNAMIC-ALLOCATION-VSAM-STORAGE-CLASS NONE
*
*GREGORIAN-DATE-FORMAT MM/DD/YYYY
*
*ML2-MINIMUM-SIZE 0
*ML2-TARGET-SIZE 99999
*
ML2-TAPE-DATA-SET-NAME HSM.HMIGTAPE.DATASET
ML2-TAPE-ALLOCATION-UNIT-NAME 3490
*ML2-TAPE-ALLOCATION-DATACLAS NONE
*ML2-TAPE-ALLOCATION-MGMTCLAS NONE
*ML2-TAPE-ALLOCATION-STORCLAS NONE
*
*RECYCLE-FROM-ARCHIVE-COPY-NUM 1
*RECYCLE-THRESHOLD-PERCENTAGE 20
*
*RESTORE-FROM-ARCHIVE-COPY-NUM 1
*RESTORE-SELECTION-MAXIMUM-FILES 100
*RESTORE-SELECTION-MAXIMUM-GB 0
*RESTORE-TO-DRIVE-DYNAMIC-HRECALL YES
*
RESTORE-QUEUE-CLUSTER-NAME ADV.ARCHIVE.RESTORE.QUEUE
RESTORE-QUEUE-NUMBER-OF-RECORDS 10000
*
*-----------------------------------DFSORT PARMS
SORT-PRODUCT-NAME DFSORT
SORT-PRODUCT-PARAMETERS-DDNAME SORTCNTL
*-----------------------------------SYNCSORT PARMS
*SORT-PRODUCT-NAME SYNCSORT
*SORT-PRODUCT-PARAMETERS-DDNAME $ORTPARM
* AXQUSETS member of the product parameter library contains
the parameters for which you must specify values as part of the configuration process. An asterisk
(*) in column 1 of a parameter definition line in the AXQUSETS member indicates that the parameter can be
customized, but customization is not required.Procedure
Specify appropriate values for these parameters:
| Parameter | Description |
|---|---|
ARCHIVE-DATABASE-CLUSTER-NAME |
This parameter specifies the full VSAM cluster name of the Archive Database. The Archive
Database holds records for the data sets that have been archived and the location information for
those data sets. Valid values: Any valid VSAM cluster name that is 38 or fewer characters in length |
ARCHIVE-DATABASE-NUMBER-OF-RECORDS |
This parameter specifies the maximum number of records that are expected to be in the
Archive Database. There should be one record for each data set that is archived and one record
for each set of archive tapes. This parameter is used to determine the size of the database when the
database is initially created and when it is restored. Valid values: Any integer in the range 0–99999999 |
ARCHIVE-ACTIVE-LOG-GDG-BASE-DSN |
This parameter specifies the name of the GDG base for the Active Log (sometimes referred to
as the Archive Database log). The Active Log is a GDG data set. All updates to
the Archive Database are first logged to the Active Log data set, which is used for reporting and
for the recovery of the Archive Database. Valid values: A valid GDG base name that is 35 or fewer characters in length |
ARCHIVE-DB-BKUP-GDG-BASE-DSN |
This parameter specifies the name of the GDG base for the Archive Database backup file. The
backup file is a GDG data set. When the Archive Database backup program is run, the program backs up
the live key database to the next generation of this GDG data set. This data set is necessary for
recovery of the Archive Database. Valid values: A valid GDG base name that is 35 or fewer characters in length |
ARCHIVE-LOG-BKUP-GDG-BASE-DSN |
This parameter specifies the name of the GDG base for the Archive Database backup log. The
backup log is a GDG data set. When the Archive Database backup program is run, the program
consolidates all generations of the Active Log to the next generation of the backup log. This data
set might be used during special recovery of the Archive Database (if the most current backup of the
Archive Database is unusable and a previous backup must be used) and for reporting. Valid values: A valid GDG base name that is 35 or fewer characters in length |
ARCHIVE-TARGET |
This parameter establishes whether the Archive function writes the inactive data to a tape-
or cloud-based device. If the data is being archived to a cloud-based device, the value that is
assigned to the GROUP_NAME keyword determines which cloud definition is
used.Valid values:
|
CLOUDDEF-DATABASE-CLUSTER-NAME |
If you are not archiving data sets to a cloud storage environment, you do not need to
customize this value. This parameter specifies the full VSAM cluster name of the Cloud Definition Database. The Cloud Definition Database holds
records for definitions that are used to connect to cloud storage systems. Valid values: A valid VSAM cluster name that is 38 or fewer characters in length |
CLOUDDEF-DATABASE-NUMBER-OF-RECORDS |
If you are not archiving data sets to a cloud storage environment, you do not need to
customize this value. This parameter specifies the maximum number of records that are expected to be
in the Cloud Definition Database. There should be one record in the database for
each cloud location that is defined. You may provide one or more definitions for each cloud storage system. The value that you assign to this parameter is used for the database size when the database is created or whenever the database is restored. Valid values: Any integer in the range 0-99999999 |
ARCHIVE-TAPE-DATA-SET-NAME |
This parameter specifies the name of the primary copy of the tape data set that contains the
archived data sets. This data set is not cataloged in the ICF catalog. Valid values: Any valid data set name |
ARCHIVE-TAPE-ALLOCATION-UNIT-NAME |
This parameter specifies the unit name that is used to allocate the tape data set that
contains the archived data sets. Valid values: A valid esoteric or generic unit name |
DATA-CENTER-NAME |
This parameter specifies the data center name that appears on all report headings that are
generated by Advanced Archive for DFSMShsm. Valid values: Any character
string. The string is delimited by blank spaces. If you want to separate words within the string,
use the underscore character ( |
DYNAMIC-ALLOCATION-DATASET-NAME-PREFIX |
This parameter specifies which data set name prefix is used when Advanced Archive for DFSMShsm dynamically allocates a work file on DASD. Valid values: Any valid data set name prefix that is 26 or fewer characters in length |
DYNAMIC-ALLOCATION-VSAM-DATA-VOLSER |
This parameter specifies the DASD volume serial number to use when Advanced Archive for DFSMShsm needs to dynamically allocate a VSAM work file data
component. Valid values: Specify either of the following values:
Note: A value for this parameter is not required unless the allocation is to non-SMS DASD.
|
DYNAMIC-ALLOCATION-VSAM-DATASET-NAME-PREFIX |
This parameter specifies the data set name prefix to use when Advanced Archive for DFSMShsm dynamically allocates a VSAM work file on DASD. Valid values: Any data set name prefix that is 26 or fewer characters in length |
DYNAMIC-ALLOCATION-VSAM-INDEX-VOLSER |
This parameter specifies the DASD volume serial number to use when Advanced Archive for DFSMShsm dynamically allocates a VSAM work file index
component. Valid values: Specify either of the following values:
Note: A value for this parameter is not required unless the allocation is to non-SMS DASD.
|
DYNAMIC-ALLOCATION-VSAM-DATA-CLASS |
This parameter specifies the SMS data class to be used for allocation during the definition
and initialization of the Archive Database, the Cloud Definition Database, or the
Restore Queue (or any combination of these). Valid values: NONE or any valid SMS data class |
DYNAMIC-ALLOCATION-VSAM-MANAGEMENT-CLASS |
This parameter specifies the SMS management class to be used for allocation during the
definition and initialization of the Archive Database, the Cloud Definition Database, or the Restore Queue (or any combination of
these). Valid values: NONE or any valid SMS management class |
DYNAMIC-ALLOCATION-VSAM-STORAGE-CLASS |
This parameter specifies the SMS storage class to be used for allocation during the
definition and initialization of the Archive Database, the Cloud Definition Database, or the Restore Queue (or any combination of
these). Valid values: NONE or any valid SMS storage class |
ML2–TAPE-DATA-SET-NAME |
This parameter specifies the name of the DFSMShsm ML2 tape data sets. The specified
name is used when Advanced Archive for DFSMShsm is archiving data sets from DFSMShsm
ML2 tapes as well as when archived data sets are restored. Valid values: Any valid data set name |
ML2–TAPE-ALLOCATION-UNIT-NAME |
This parameter specifies the unit name that is used to allocate the ML2 data set that
contains the restored data sets. Valid values: A valid esoteric or generic unit name |
RESTORE-QUEUE-CLUSTER-NAME |
This parameter specifies the full VSAM cluster name of the Restore Queue database. The Restore Queue holds records for the data sets that have
been selected for Restore processing. Valid values: A valid VSAM cluster name that is 38 or fewer characters in length |
RESTORE-QUEUE-NUMBER-OF-RECORDS |
This parameter specifies the number of records that are expected to be in the Restore Queue database. The value of this parameter is
used when the database is created. Valid values: Any integer in the range 0–99999999 |
SORT-PRODUCT-NAME |
This parameter identifies the sort product that is installed. Advanced Archive for DFSMShsm uses this
information to set up the appropriate dynamic interface for internal sorts. Valid values: DFSORT, SYNCSORT, or CASORT |
SORT-PRODUCT-PARAMETERS-DDNAME |
This parameter specifies the DD name that Advanced Archive for DFSMShsm
assigns to the sort statement file that is used by the sort product. Valid values: Any valid DD name |