Archive Log Installation Parameters (DSNTIPA)
This topic shows detailed information about System Parameters - Archive Log Installation Parameters (DSNTIPA)
.
This block shows the characteristics of archive log data sets.
System Parameters - Archive Log Installation Parameters (DSNTIPA)
The field labels shown in the following sample layout of System Parameters - Archive Log Installation Parameters (DSNTIPA)
are described in the following section.
ARCHIVE LOG INSTALLATION PARAMETERS (DSNTIPA) --------------------------------------------- CATALOG ARCHIVE DATASETS (CATALOG)..........................YES COPY1 ARCHIVE LOG DEVICE TYPE (UNIT).......................DASD COPY2 ARCHIVE LOG DEVICE TYPE (UNIT2)...................'BLANK' PRIMARY SPACE ALLOCATION (PRIQTY)...........................100 SECONDARY SPACE ALLOCATION (SECQTY)..........................10 ARCHIVE LOG BLOCK SIZE IN BYTES (BLKSIZE)................24,576 MAXIMUM READ TAPE UNITS (MAXRTU)..............................2 TAPE UNIT DEALLOCATION PERIOD (DEALLCT).................0000:00 MAX NUMBER OF DATASETS RECORDED IN BSDS (MAXARCH).........1,000 DAYS TO RETAIN ARCHIVE LOG DATA SETS (ARCRETN)...............30 ISSUE WTOR BEFORE MOUNT FOR ARCHIVE VOLUME (ARCWTOR)........YES COMPACT DATA (COMPACT).......................................NO QUIESCE PERIOD (QUIESCE)......................................5 SINGLE VOLUME (SVOLARC)......................................NO
- CATALOG ARCHIVE DATASETS (CATALOG)
-
The alias of the VSAM integrated catalog facility user catalog or the name of the master catalog where the Db2 VSAM data sets created during installation are cataloged. The MVS catalog alias is also used as the high-level qualifier for Db2 VSAM data sets.
Install parameter CATALOG ALIAS on panel DSNTIPA, or ZPARM CATALOG in DSN6ARVP.
Field Name: QWP3CTLG
- COPY1 ARCHIVE LOG DEVICE TYPE (UNIT)
-
The device type or unit name for storing archive log data sets.
The value can be any alphanumeric string. If you choose to archive to DASD, you can specify a generic device type with a limited volume range. Db2 requires that all archive log data sets allocated on DASD are cataloged.
If the device type is DASD, CATALOG DATA must be set to YES. If the unit name specifies DASD, the archive log data sets can extend to a maximum of 15 volumes. PRIQTY and SECQTY must be large enough to contain all active log data set data without extending beyond 15 volumes. If the unit name specifies a tape device, Db2 can extend to a maximum of 20 volumes. Default is TAPE.
Install parameter DEVICE TYPE 1 on panel DSNTIPA, or ZPARM UNIT in DSN6ARVP.
Field Name: QWP3UNT1
- COPY2 ARCHIVE LOG DEVICE TYPE (UNIT2)
-
Indicates the device type or unit name for storing the second copy of archive log data sets.
The value can be any alphanumeric string. If you choose to archive to DASD, you can specify a generic device type with a limited volume range. Db2 requires that all archive log data sets allocated on DASD are cataloged.
If the device type is DASD, then CATALOG DATA must be set to YES. If the unit name specifies DASD, the archive log data sets can extend to a maximum of 15 volumes. PRIQTY and SECQTY must be large enough to contain all active log data set data without extending beyond 15 volumes. If the unit name specifies a tape device, Db2 can extend to a maximum of 20 volumes. Default is TAPE.
Install parameter DEVICE TYPE 2 on panel DSNTIPA, or ZPARM UNIT2 in DSN6ARVP.
Field Name: QWP3UNT2
- PRIMARY SPACE ALLOCATION (PRIQTY)
-
The primary space allocation for archive data sets.
Install parameter PRIMARY QUANTITY on installation panel DSNTIPA, or ZPARM PRIQTY in DSN6ARVP.
Field Name: QWP3RISP
- SECONDARY SPACE ALLOCATION (SECQTY)
-
The amount of DASD secondary space allocation for an archive log data set.
The units used are specified by the ALLOCATION UNITS field. When blank (default), the CLIST calculates this space using block size and size of the log.
Install parameter SECONDARY QTY on panel DSNTIPA, or ZPARM SECQTY in DSN6ARVP.
Field Name: QWP3SECS
- ARCHIVE LOG BLOCK SIZE IN BYTES (BLKSIZE)
-
The block size of the archive log data set.
The block size must be compatible with the device type used for archive logs. The value is rounded up to the next multiple of 4096 bytes.
If the archive log is written to tape, use the largest possible block size to improve the reading speed.
Recommended block size values are 28672 for tape, 20480 for 3380, and 24576 for 3390 or RAMAC ®.
Install parameter BLOCK SIZE on panel DSNTIPA, or ZPARM BLKSIZE in DSN6ARVP.
Field Name: QWP3BKSZ
- MAXIMUM READ TAPE UNITS (MAXRTU)
-
The maximum number of tape units that can be allocated for archive read purposes.
Install parameter READ TAPE UNITS on panel DSNTIPA, or ZPARM MAXRTU in DSN6LOGP.
Field Name: QWP2MRTU
- TAPE UNIT DEALLOCATION PERIOD (DEALLCT)
-
The number of minutes an archive read tape unit can remain unused before it is deallocated.
When archive log data is read from tape, this value should be high enough to allow Db2 to optimize tape handling for multiple read applications.
Install parameter DEALLOC PERIOD on panel DSNTIPA, or ZPARM DEALLCT in DSN6LOGP.
Field Name: QWP2DMIN
- MAX NUMBER OF DATASETS RECORDED IN BSDS (MAXARCH)
-
The maximum number of archive log volumes that can be recorded in the BSDS.
When this number is exceeded, recording resumes at the beginning of the BSDS.
For dual archive, this value applies to each log data set. As an example, a value of 500 allows 500 COPY-1 and 500 COPY-2 data sets in the BSDS.
You must create image copies of all Db2 objects, probably several times, before the archive log data sets are discarded. If you fail to retain an adequate number of archive log data sets for all the image copies, you might need to cold start or reinstall Db2. In either case, data is lost.
Install parameter RECORDING MAX on panel DSNTIPA, or ZPARM MAXARCH in DSN6LOGP.
Field Name: QWP2ARCL
- DAYS TO RETAIN ARCHIVE LOG DATA SETS (ARCRETN)
-
The number of days Db2 keeps archive log data sets.
This value is added to the current date to calculate the expiration date.
The retention period is often used in tape management systems to control the reuse and scratching of data sets and tapes. Db2 uses this as the value for the dynamic allocation parameter DALRETPD when archive log data sets are created.
Install parameter RETENTION PERIOD on panel DSNTIPA, or ZPARM ARCRETN in DSN6ARVP.
Field Name: QWP3RETN
- ISSUE WTOR BEFORE MOUNT FOR ARCHIVE VOLUME (ARCWTOR)
-
Indicates whether Db2 must send a message to the operator and wait for an answer before attempting to mount an archive log data set.
Other Db2 users can be forced to wait while the mount is pending. They are not affected while Db2 is waiting for a response to the message.
When YES, a device such as tape is used that requires long delays for mounts. DEVICE TYPE 1 shows the device type or unit name.
Install parameter WRITE TO OPER on panel DSNTIPA, or ZPARM ARCWTOR in DSN6ARVP.
Field Name: QWP3WTOR
- COMPACT DATA (COMPACT)
-
Indicates whether data written to archive logs is compacted.
This option only applies to data written to a 3480 device that has the improved data recording capability (IDRC) feature.
Install parameter COMPACT DATA on panel DSNTIPA, or ZPARM COMPACT in DSN6ARVP.
Field Name: QWP3COMP
- QUIESCE PERIOD (QUIESCE)
-
The maximum amount of time (in seconds) permitted for Db2 to attempt a full system quiesce.
Install parameter QUIESCE PERIOD on panel DSNTIPA, or ZPARM QUIESCE in DSN6ARVP.
Field Name: QWP3MQP
- SINGLE VOLUME (SVOLARC)
-
Indicates whether single-volume DASD archives are used.
Install parameter SINGLE VOLUME on panel DSNTIPA, or ZPARM SVOLARC in DSN6ARVP.
DBField Name: QWP3SVOL