gtps4m2rSystem Generation

DDCCAP

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:

  1. Up to 6 values can be coded on INTxP.

  2. 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.