gtps4m2r | System Generation |
The DDCCAP macro is used to establish the disk device control table for
capture/restore. Parameters may be submitted for up to four DASD
devices.
DDCCAP is required if the capture/restore facility is desired. If
coded, parameters for at least one device must be entered. For more
information about capture/restore and a detailed explanation of how to
initialize these fields, see the TPF Database
Reference.
Format
Notes:
- Up to 6 values can be coded on INTxP.
- Up to 6 values can be coded on INTxN.
- Note:
- Fields in this macro are identical in definition for the various device
types. One explanation of the parameters is provided here, where x in
the keyword parameters is interpreted as follows:
Device A - - - x = A
Device B - - - x = B
Device C - - - x = C
Device D - - - x = D
- INTxP=(s-f)
- From 1-6 valid disk module ranges to be captured or restored at one
time where both nonduplicated and primary copies of duplicated records will be
selected.
- s
- A 1-4 character decimal number that defines the starting relative module
number of the range, and is less than 3998.
- "-"
- Delimiter.
- f
- A 1-4 character decimal number that defines the ending relative module
number of the range, and is less than 3998. For example: 0-4,
5-8, 9-15, 1600-2000.
- Note:
- s value must be less than or equal to f value.
0 is the first module number. The number of mods - 1 is the highest
module number (e.g., 0-9, 10-16) is invalid for a 16
module device type).
Ranges need not be submitted in any sequence. See the description of
fields 'BXILOM' and 'BXIHIM' in assembled program segment
BXAX.
- INTxN=(s-f)
- From 1-6 valid disk module ranges to be captured or restored where
only nonduplicated records will be selected. Rules for coding this
parameter are identical to those stated above. See the description of
fields 'BXILOM' and 'BXIHIM' in assembled program segment
BXAX.
- KPUPx=25|n
- Capture/restore keypoint file increment. This number is the
interval (expressed as number of cylinders) after which the capture/restore
keypoint will be filed. The allowable range, in decimal, is
1-255, however, 10 is considered too frequent. See the
description of field 'BXACINC' in assembled program segment
BXAX.
- Note:
- Module ranges submitted for the above parameters must be consistent with
ranges calculated from the SIP ONLFIL macro and must not overlap within a
device type. Module ranges submitted in the primary/nonduplicated
parameter must not overlap ranges in the nonduplicated only parameter.
Either primary (INTxP) or nonduplicated (INTxN)
ranges must be specified for a particular device type. However, if only
primary ranges are desired, the nonduplicated parameter may be omitted and
vice versa.
It is important to note that the working storage required for capture is
significant and in a small system the danger of a polling shutdown
exists.
Examples
The example system is defined to have 2 DASD device type A and 2 DASD
device type B. All modules are to be captured and restored. The
nonduplicated and primary copies of the duplicated records are to be
selected. Tape speeds are 22 milliseconds. Code the DDCCAP as
follows:
DDCCAP INTAP=(0-1), X
INTBP=(0-1)
References
None.