gtpd1m1dDatabase Reference

Capture and Restore Keypoint Record

The capture and restore keypoint (BXAXF) record is used for control and communication by the capture and restore utility. Fields in the capture and restore keypoint that must be changed to suit the user's system can be established with the system initialization package (SIP). The SIP macro and macro parameters that will initialize the field are noted after each BXAXF description as follows:

SIP input = (macro keyword name) macro name

The SIP macros that are related to the capture and restore utility are RESCAP, DDCCAP, and LOGCAP. See TPF System Generation for more information about coding these macros.

Keypoint Fields

Table 5 shows a description of each of the fields in the keypoint record. Unless otherwise stated, SIP initializes these fields to X'00'.

Table 5. Keypoint Fields

Name Description
BXXLAB This tag is used to refer to the program record number and demand counter that are used in lieu of an alphabetic record ID because the capture and restore keypoint is maintained as a program.

Initialization: Dynamic via assembly and link edit.

BXXNAM This tag is used to refer to the program stamp field. When initially loaded, this field contains the name of the keypoint program (BXAX or BXX1). After running online, the working keypoint will change to BXAM, the program name of the keypoint update program.

Initialization: Dynamic via assembly.

BX1IND This field contains 8 1-bit indicators used by the capture function to maintain major package status.
BX2IND This field contains 8 1-bit indicators used by the restore function to maintain major package status.
BX3IND This field contains 8 1-bit indicators used by both capture and restore to maintain major package status.
BX4IND This field contains 8 1-bit indicators used by the restore function to maintain status of the XCP/LOG tapes being restored.
BX5IND This field contains 1-bit indicators used by both capture and restore to maintain status of the participating processors.
BXXCPTP This field contains the number of active XCP/LOG tapes for restore.
BXXSID This field contains the symbolic processor ID.
BXXIID This field contains the internal processor ID.
BXXMAX This field controls the maximum number of entries that can be created by capture or restore, therefore controlling the maximum number of modules that can be captured or restored simultaneously.

Initialization: See Timing.

BXXEBR This field contains the LNIATA of the input message that started the current function.
BXXOID This field contains the CPUID of the input message that started the current function.
BXXCIP This field is used to maintain a count of the capture or restore entries currently in progress.
BXXCES This field is used by the restore selection routines as a count of entries that are in the process of being started but have not yet been started.
BXDDCTC This field is used to unhook the DDCT during capture and restore operations, therefore providing a core chain to the DDCT.
BXDDCB This subfield of BXDDCTC contains the address of the core block that contains the DDCT. A load from this location sets the base register for DDCT DSECT usage.
BXXSSI This field contains the ID of the subsystem in which the capture and restore function is running.
BXXDTE This field is initialized by the restore function with the current date in the form of ddmmm (day/month). This value is taken from TPF global field @U1DMT.
BXXTME This field is used by the restore function as the starting time of the restore. It is initialized by restore from control program field CMMLST, referred to with a CINFC macro.
BXXLDT This field is initialized by the Logging program. It contains the last date a label record has been written to the logging tapes in the form ddmmm (day/month). This value is taken from global field @U1DMT.
BXXLTM This field is initialized by the Logging program. It contains the last time, in hours and minutes, that a label record has been written to the logging tapes, in the form hhmm. This value is taken from the CMMLST field, referred to with a CINFC macro.
BXSTRD This field is initialized by the restore function with the start date input in the XCP/LOG restore input message after it has been converted to binary form by segment CDTA.
BXSTRT This field is initialized by the restore function with the start time input in the XCP/LOG restore input message after it has been converted to binary form by segment CDTA.
BXSTPD This field is initialized by the restore function with the stop date input in the LOG restore input message after it has been converted to binary form by segment CDTA.
BXSTPT This field is initialized by the restore function with the stop time input in the LOG restore input message after it has been converted to binary form by segment CDTA.
BXXTOT This field is used to maintain a count of the total modules to be captured or restored.
BXXDON This field is used to maintain a count of the total modules that have completed capture or restore. When this field is equal to BXXTOT, the entire capture or restore operation is completed.
BXACPS This field contains the system pause time-out factor, which is the maximum amount of time allowed for an entry to be completed when a pause is requested. If an entry does not complete processing in this amount of time, it is timed out and will end.

Initialization: The minimum number of seconds used to initialize this field should be the maximum time required to capture or restore a module of any in-use device type. This time should take into consideration the additional time required by a module not having exclusive use of a channel.

SIP input = (CAPTO) RESCAP.

BXRWD This field contains the maximum rewind and unload time for all tape devices that can be used by capture and restore. An amount of time equivalent to that specified by this field is allowed to elapse after this tape is rewound before making it available for use.

Initialization: The minimum value should be equivalent to the maximum rewind and unload time for all tape devices on the system.

SIP input = (TPREW) RESCAP.

BXIOTIME This field contains the minimum amount of elapsed time between capture I/Os. At the completion of each I/O, the clock value just before the I/O is compared to the current clock value. If the difference is less than the value in BXIOTIME, the I/O entry defers because capture I/O requests are completing too quickly. The entry continues to DEFER until the required amount of time has elapsed.
BXDASDCH This field contains the maximum number of DASDs capable of running per channel path.

Initialization: This field is initialized to 1.

BXDASDCU This field contains the maximum number of DASDs capable of running per control unit.

Initialization: This field is initialized to 1.

BXTAPECH This field contains the maximum number of tape drives capable of running per channel path.

Initialization: This field is initialized to 1.

BXTAPECU This field contains the maximum number of tape drives capable of running per control unit.

Initialization: This field is initialized to 1.

BXANDV This field contains the number of devices in the system.

Initialization: This field is initialized to the number of devices in the CDT (L'BXADTS/L'BXACDT).

BXAMID This field contains the maximum size of the module interval table.

Initialization: This field is initialized to the length of field BXDINT.

BXASDT This field contains the size of an entry in the device control table (see field BXACDT).

Initialization: This field is initialized to the length of field BXACDT.

BXXPGM This field is used by the restore function as a save field for the type of restore: CAP, XCP, LOG, or KPT.
BXXERR This tag refers to the fields containing the cumulative error counts for tape errors (BXXTAP), disk track errors (BXXTRK), disk record errors (BXXRCD), and a spare field of 2 bytes.
BXXTAP This field contains a cumulative count of all uncorrectable tape read errors found during restore. Capture does not use this field.
BXXTRK This field contains a cumulative count of the uncorrectable disk track read errors found since the last capture or restore start request.
BXXRCD This field contains a cumulative count of the number of individual record errors found since the last capture or restore start request. The counts in this field and BXXTRK are mutually exclusive.
BXXTTA This field is used by the restore function to accumulate the number of tapes currently available for selection.
BXXNSL This field is used as a count of TDCT slots that are in use during restore. Therefore, it serves as an index to the next TDCT slot that is available to the selection routines.

Keypoint Tables

The following tables are defined in the capture/restore keypoint record (BXAXF).

Tape Device Control Table (TDCT)

The tape device control table is used to keep an inventory and status of the tapes assigned to capture and restore.

Table 6. Tape Device Control Table

Name Description
BXTDCT This tag defines the tape device control table (TDCT). This table is used to maintain an inventory and status of all tape drives made available to capture or restore by the operator through a start or tape add request.

Initialization: This tag is initialized with a length attribute of the TDCT table size.

BXTDCTF This tag defines an entry in the tape device control table. There should be as many entries in the TDCT as are required by multiplying BX1MAX (the maximum number of entries allowed active) by 2. This allows for uninterrupted processing during rewind.

Initialization: The length attribute of this tag is the size of an entry in the TDCT.

BXCUD1 This subfield of BXTDCTF is used to maintain the tape device hardware address input by the operator.
BXCUDA This subfield of BXTDCTF is used to maintain an alternate tape device hardware address input by the operator. This field is used only by restore in multireel restores.
BXCUD1S This subfield of BXTDCTF contains the symbolic tape name associated with the tape hardware addresses in BXCUD1 and BXCUDA. When capture and restore provide internal tape mounting and switching, this is the tape name that will be used.

Initialization: This field is set to BXx, where x is set to A and incremented through the alphabet for as many entries as exist in the TDCT.

BXSTAT1 This subfield of BXTDCTF is used as bit indicators to maintain the status of the tape during the capture or restore operation.

LOG/XCP Tape Definition Table (LXTD)

The LOG/XCP tape definition table (LXTD) defines the logging and exception tapes available to capture and restore.

Table 7. Tape Definition Table (LXTD)

Name Description
BXTAPS This label refers to the LOG/XCP tape definition (LXTD) table. This table defines the tapes available to the capture and restore utility for logging and exception recording.

Initialization: The length attribute of this label is equal to the table length.

BXTTIS This label refers to an item in the LXTD table. Each item contains a tape name (last character), an ECB count field, and a module range associated with this entry.

Initialization: The length attribute of this label is equal to the item length.

BXTNAM This subfield of BXTAPS contains the last character of the tape name for this entry (for capture, the first 2 characters are RT; for restore, the first 2 characters are XA).

Initialization: The allowable characters for tapes in this table are Y, X, W, V, U, and T respectively. Any item not used is initialized to X'00'.

SIP input = (RTT thru RTY) LOGCAP.

BXTNEN This subfield of BXTAPS indicates whether the tape for this entry is in use for capture or restore.
BXTLOM This subfield of BXTAPS contains the low symbolic module number assigned to this tape for XCP/LOG capture and restore.

Initialization: The initialization of this field and BXTHIM depends on what use will be made of the data captured to these tapes. Normally, each item should be initialized so that the load will be evenly spread across all tapes defined in the table. However, other considerations may dictate other initialization schemes. If an item is unused, this field will be initialized to X'00'.

SIP input = (RTT-RTY) LOGCAP.

BXTHIM This subfield of BXTAPS contains the high symbolic module number assigned to this tape for XCP/LOG capture and restore.

Initialization: See BXTLOM.

In-Progress Table (IPT)

The in-progress table (IPT) maintains the status of reads and writes that are currently in progress.

Table 8. In-Progress Table (IPT)

Name Description
BXINPT This tag refers to the in-progress table. This table is used to maintain the status of currently in-progress read/write entries.

Initialization: This tag has a length attribute equal to the size of the in-progress table.

BXINPF This tag refers to an entry in the in-progress table.

Initialization: This tag has a length attribute equal to the size of an entry in the in-progress table.

BXMODA This subfield of BXINPF contains the module number of the module being captured or restored.
BXCUD2 This subfield of BXINPF contains the hardware address of the tape currently being captured to or restored from.
BXCUD2S This subfield of BXINPF contains the symbolic name being used to address the tape on the address contained in BXCUD2.
BXTMES This subfield of BXINPF contains the decimal time that the capture or restore entry began.
BXTMESB This subfield of BXINPF contains the binary time that the capture or restore entry began processing the current reel of tape.
BXDEVT This subfield of BXINPF contains the device type indicator of the disk device being captured or restored. This indicator is identical to the device type indicator in this device's CDT entry (BXADTI).
BXSTAT2 This subfield of BXINPF is an end-of-reel switch used by the restore function to indicate when a new reel is being processed.
BXCDTI This subfield of BXINPF is used by the restore function as an index to the correct device control table (CDT) for the entry in progress.
BXRRNO This subfield of BXINPF is used to maintain the reel number of the current reel during a capture and restore operation. If a restart occurs, this will be the reel where capture and restore will restart.
BXTAP This subfield of BXINPF contains the count of the uncorrectable tape errors that restore has found during the processing of this entry. When this entry is completed, this counter will be added to the cumulative tape error counter, BXXTAP.
BXTRK This subfield of BXINPF contains a count of uncorrectable track errors found by capture or restore during the processing of this entry. When this entry is completed, this counter will be added to the cumulative track error counter, BXXTRK.
BXRCD This subfield of BXINPF contains a count of the individual disk record errors found by capture or restore during the processing of this entry. When this entry is completed, this counter will be added to the cumulative disk record error counter, BXXRCD. The counts in BXTRK and BXRCD are mutually exclusive.
BXXSP2 This tag is used to refer to the current and restart locations (cylinder and head) for this entry during a capture operation.
BXXCCL This tag refers to the current module location (cylinder and head) during a capture operation.

Initialization: This tag has a length attribute of 4.

BXXCC This subfield of BXINPF contains the current cylinder number of the module that is in progress during capture processing.
BXXCH This subfield of BXINPF contains the current head number of the module that is in progress during a capture operation.
BXXCCL1 This tag refers to the restart module location (cylinder and head) during a capture operation. Restart during capture occurs from the beginning of a tape reel so that the cylinder and head value saved here reflect the beginning of the reel that is being processed.

Initialization: This tag has a length attribute of 4.

BXXCC1 This subfield of BXINPF contains the restart cylinder number of the module that is in progress during a capture operation.
BXXCH1 This subfield of BXINPF contains the restart head number of the module that is in progress during a capture operation.
BXXBSN This subfield of BXINPF contains the tape block sequence number of the first tape block (record) written to the current reel for capture. It contains the tape block sequence number of the last tape block (record) written to the previous reel for restore. If a restart occurs, this number is used to begin sequencing records on the restart reel.
BXXPID This subfield of BXINPF contains the ID of the processor in which the capture or restore is running.
BXXEXT This refers to the module extent table of extents that will not be restored.

Device Type Control Table (CDT)

The device type control table (CDT) contains descriptions of each DASD device that supports capture and restore.

Table 9. Device Type Control Table (CDT)

Name Description
BXADTS This tag refers to the device type table (CDT). This table contains parameters describing the characteristics of each supported device type.

Initialization: This tag has a length attribute equal to the size of the CDT.

BXACDT This tag refers to an entry in the Device Control Table (CDT). There is an entry for each supported device type. The entries do not need to be in any specific order and spare CDT items can exist (they must be initialized to all hex zeros).

Initialization: This tag has a length attribute equal to the length of a CDT entry item.

BXADTI This subfield of BXACDT defines the device type indicator for this device. This device type indicator is used primarily as a branch vector indicator in capture or restore segments that are device dependent.

Initialization: The device type indicator is set to the equate for the specific device type (DEVA for device A, DEVB for device B, and so on).

SIP input = DDCCAP macro.

BXASRD This subfield of BXACDT defines the number of small records per track for this device type.

Initialization: This field is initialized by SIP by setting it equivalent to the correct equate for the number of small records per track for this device type (CSONSRA for device A, CSONSRB for device B, and so on).

BXALRD This subfield of BXACDT defines the number of large records per track for this device type.

Initialization: This field is initialized by SIP by setting it equivalent to the correct equate for the number of large records per track for this device type (CSONLRA for device A, CSONLRB for device B, and so on).

BXA4RD This subfield of BXACDT defines the number of 4KB records per track for this device type.

Initialization: This field is initialized by SIP by setting it equivalent to the correct equate for the number of 4KB records per track for this device type (CSON4RA for device A, CSON4RB for device B, and so on).

BXASRL This subfield of BXACDT defines the small record length for this device type.

Initialization: This field is set to the equate for small record size for this device type (#SBSZE for all devices).

BXALRL This subfield of BXACDT defines the large record length for this device type.

Initialization: This field is set to the equate for large record size for this device type (#LBSZE for all devices).

BXA4RL This subfield of BXACDT defines the 4KB record length for this device type.

Initialization: This field is set to the equate for 4KB record size for this device type (CPL4C2 for all devices).

BXAHDC This subfield of BXACDT contains the maximum addressable head number for this device type.

Initialization: This field is set to one less than the equate that defines the number of heads for this device type (CSONHCA-1 for device A, CSONHCB-1 for device B, and so on).

BXACYL This subfield of BXACDT contains the maximum addressable cylinder number for this device type.

Initialization: This field is set to one less than the equate that defines the number of cylinders for this device type (CSONCMA-1 for device A, CSONCMB-1 for device B, and so on).

BXACINC This subfield of BXACDT contains the cylinder increment factor. This number defines the interval at which the keypoint will be written to file. If, for example, the number is 25, the keypoint is written to file every 25 cylinders. On a system IPL, the exception recording pointers will be updated by this amount to ensure that the exception recording record sequence is valid.

Initialization: This field should be set to provide frequent checkpointing without excessive filing of the capture and restore keypoint. A value greater than 255 should not be used because some segments access this field as 1 byte at BXACINC+1.

SIP input = (KPUPA-KPUPD) DDCCAP.

BXADCD This subfield of BXACDT contains the cylinder displacement to the duplicate records for this device type. This field is used by capture to calculate the location of duplicated records if the primary copies are not accessible and by restore to calculate the duplicate location if the duplicated records will be restored.

Initialization: The system value for this device type will be inserted at system IPL time.

BXADHD This subfield of BXACDT contains the head displacement to the duplicate records for this device type. This field is used by capture to calculate the location of duplicated records if the primary copies are not accessible and by restore to calculate the duplicate location if the duplicated records will be restored.

Initialization: The system value for this device type will be inserted at system IPL time.

BXINTS This tag refers to the module interval definition table contained in each CDT entry. The table defines to capture and restore the valid system modules that can participate in a capture or restore. It also defines whether duplicated records will be captured on the defined modules.

Initialization: This tag has a length attribute equal to the total number of bytes required for the module interval definition table. The BXINTS field must be the same length in all CDT entries.

BXDINT This tag defines an entry in the module interval definition table. Each entry defines a range of valid modules for this device type and an indication of whether duplicated records will be captured. The entries do not need to be in any sequence and spares can exist but must be set to all hex zeros.

Initialization: This tag has a length attribute equal to the size of 1 entry in the module interval definition table.

BXILOM This subfield of BXDINT defines the low module in a range of valid modules to be captured or restored.

Initialization: The hexadecimal module number for the low module in a module number range should be set here.

SIP input = (INTxP or INTxN) DDCCAP.

BXIHIM This subfield of BXDINT defines the high module number in a range of valid modules to be captured or restored.

Initialization: This field is initialized to the high hexadecimal module number for a module number range. BXIHIM must be greater than BXILOM for a given range specification.

SIP input = (INTxP or INTxN) DDCCAP.

BXICAT This field contains an indication of whether the duplicated records on the modules in the range between BXILOM and BXIHIM will be captured.

Initialization: Set to 'P' if both nonduplicated and primary copies of duplicated records will be captured. Set to 'N' if only nonduplicated records will be captured.

SIP input = (INTxP or INTxN) DDCCAP, where x = A, B, C, or D.

BXALRT This field is used by the restore function to save the lower limit on a THRU restore. Cylinder, head, and record are saved as CCHHR. The last byte of this field (record number) has the tag name BXALRR.
BXAHRL This field is used by the restore function to save the upper limit for a THRU restore. Cylinder, head, and record number are saved as CCHHR. The last byte of this field (record number) has a tag name of BXAHRR.

Keypoint Equates

Keypoint equates define varieties of capture and restore keypoint information used during processing. Time intervals, delimiters, and indicators are maintained for hardware and capture and restore program control.

Table 10. Keypoint Equates

Name Description
BXXINT This equate defines the time interval, in minutes, in which the log time-stamp program will be started. This program (BXTT) will write a TME label record to all logging tapes each time it is activated.

Initialization: SIP input = (STAMP) LOGCAP.

BXAIT3 This equate defines the time interval, in seconds, in which the capture and restore security program (BXAI) is to be started. This program determines if capture or restore read/write entries are processing longer than expected. If so, the operator is notified and if the condition continues, the capture or restore is paused.

Initialization: It seems reasonable to set this value to 1/2 the amount of time required to perform the fastest module capture for the given system.

SIP input = (SECUR) RESCAP.

BXADT1 This field is equated to BXAIT3.
BXABT1 This field is equated to BXAIT3.
BXAET1 This equate defines the maximum amount of time that will be allowed for individual entries to end after an ABORT ALL message is entered. If the entries do not end in the specified time, the operator will be informed.

Initialization: SIP input = (ABRTO) RESCAP.

BXAMT1 This equate defines the number of times an internal tape mount will be attempted before ending the module.

Initialization: SIP input = (TPERR, subparameter a) RESCAP.

BXAMT2 This equate defines, in seconds, the time interval between the successive tape mounts that will be processed. This equate is used with BXAMT1 to control the retry of an internal tape mount operation.

Initialization: The value specified should allow the operator to respond to the problem that interfered with the previous tape mount attempt.

SIP input = (TPERR, subparameter b) RESCAP.

BXANNRA This equate defines the number of times capture will retry an individual disk error (independent of the error retry procedures).

Initialization: SIP input = (DKERR, subparameter a) RESCAP.

BXDELIM This equate defines the delimiter (/) that separates multiple modules or multiple tapes in a capture or restore input message.
BXDEL1 This equate defines the delimiter (blank) that separates modules from tapes specified in a selective start message for capture or restore.
BXDEL2 This equate defines the delimiter (-) that separates tape hardware addresses in a dual tape entry.
BX1MAX This equate defines the maximum number of read/write entries that are allowed active simultaneously for capture or restore.

Initialization: This field is set to 32.

LABEL This equate defines the length (256) of a label record written to a KPT or XCP/LOG capture tape.
SMALLB This equate defines the indicator that is used to denote small core blocks (X'21').
LARGEB This equate defines the indicator that is used to denote large core blocks (X'31').
FORKB This equate defines the indicator that is used to denote 4KB core blocks (X'51').
REELNO This equate defines the number to be used to define the first reel of tape of a module capture.
TPCTL This equate is used by the restore function as a control for the number of attempts to initially read the header of a tape to be restored.

Initialization: This equate should be initialized to a logical value for error retries: the suggested value for retry is 3.

SIP input = (TPERR, subparameter c) RESCAP.

BXAUMAX This equate defines the number of times restore will retry an individual disk error (independent of the error retry procedure).

Initialization: SIP input = (DKERR, subparameter b) RESCAP.

DEVA This equate defines the device type indicator for device A (X'01').
DEVB This equate defines the device type indicator for device B (X'02').
DEVC This equate defines the device type indicator for device C (X'03').
DEVD This equate defines the device type indicator for device D (X'04').
REALSC This equate is used by restore analysis as a tag name for the 2 bytes of the ECB work area that are used to save the starting cylinder of the interval that is being analyzed.
REALSH This equate is used by restore analysis as a tag name for the 2 bytes of the ECB work area that are used to save the starting head of the interval that is being analyzed.
REALSR This equate is used by restore analysis as a tag name for that byte of the ECB work area that is used to save the starting record number of the interval that is being analyzed.
REALEC This equate is used by restore analysis as a tag name for the 2 bytes of the ECB work area that are used to save the ending cylinder of the interval that is being analyzed.
REALEH This equate is used by restore analysis as a tag name for the 2 bytes of the ECB work area that are used to save the ending head of the interval that is being analyzed.
REALER This equate is used by restore analysis as a tag name for the byte of the ECB work area that is used to save the ending record number of the interval that is being analyzed.
ALTRSC This equate is used by restore analysis as a tag name for the 2 bytes of the ECB work area that are used to save the starting cylinder of the duplicated area for the interval that is being analyzed.
ALTRSH This equate is used by restore analysis as a tag name for the 2 bytes of the ECB work area that are used to save the starting head of the duplicated area for the interval that is being analyzed.
ALTRSR This equate is used by restore analysis as a tag name for the byte of the work area that is used as a save area for the starting record number of the duplicated area for the interval that is being analyzed.
ALTREC This equate is used by restore analysis as a tag name for the 2 bytes of the ECB work area that are used to save the ending cylinder of the duplicated area for the interval that is being analyzed.
ALTREH This equate is used by restore analysis as a tag name for the 2 bytes of the ECB work area that are used to save the ending head of the duplicated area for the interval that is being analyzed.
ALTRER This equate is used by restore analysis as a tag name for the byte of the ECB work area that is used to save the ending record number of the duplicated area for the interval that is being analyzed.
BXSECT This tag defines the BXSECT DSECT used by capture and restore.
Note:
Fields BXCAP5 through BXAUVER are used by the capture and restore error recovery segments BXAN, BXBN, and BXAU.
BXCAP5 This tag refers to the work area defined by the BXSECT DSECT.
BXSAVE (RESERVED)
BXBXAH (RESERVED)
BXBXAN This tag refers to a work area that is used by the capture error recovery program, BXAN, and by restore error recovery program BXAU.
BXANRL This field contains the record length of a record that was unsuccessfully trying to be read through a find-type macro.
BXANNOR This field contains the number of records per track used by capture error recovery programs BXAN and BXBN.
BXANLCW This field contains the last CCW error compare address used by capture error recovery programs BXAN and BXBN.
BXANFCW This field contains the first CCW error compare address used by capture error recovery programs BXAN and BXBN.
BXANSW1 This field indicates whether the primary or duplicate track had an irrecoverable error.
BXANSW2 (RESERVED)
BXANRL This field contains a count of the number of bytes remaining in the record being processed by capture error recovery segment BXBN.
BXANIOB This field contains the base address of the record being processed by capture error recovery segment BXBN.
BXANLER This field contains the last CCW error compare address that was processed by capture error recovery.
BXANNR This field contains a count of the number of retries that have been done so far. It is used by capture error recovery.
BXANDM This field contains the duplicate module number of the module number that caused a find error.
BXANS1 This field refers to the duplicate argument parameters (cylinder and head) used by the error recovery segments.
BXANDC This field contains the duplicate cylinder that corresponds to the prime cylinder associated with a find error.
BXANDH This field contains the duplicate head that corresponds to the prime head associated with a find error.
BXANRD This field contains the record number of the last record read when a find error occurred.
BXANMR This field contains the maximum record number possible on the track being processed by capture error recovery segment BXBN.
BXANCWS This field is the read CCW save area used by error recovery segment BXBN.
BXAUFCW This field contains the first CCW error compare address used by restore error recovery program BXAU.
BXAULCW This field contains the last CCW error compare address used by restore error recovery program BXAU.
BXAUPCW This field contains the address of the previous prime CCW group that caused an error. Used by BXAU.
BXAUDCW This field contains the address of the previous duplicate CCW group that caused an error. Used by BXAU.
BXAUFIL This field is a save area for the FDCTC macro used in restore error recovery segment BXAU.
BXAUREG This field is the register save area for segment BXAU.
BXCLTIN This field contains the base of the tape status table used by segment BXEL.
BXAUERR This field contains a count of the number of retries attempted on prime tracks used in restore error recovery.
BXAUERD This field contains a count of the number of retries attempted on duplicate tracks used in restore error recovery.
BXAUVER This field is used as a switch to indicate whether the primary or duplicate track is currently being processed by segment BXAU.
BXSEEK This field refers to the seek address of the primary track.
BXSEKB This field is used to process the start of the seek address for the primary track.
BXSEKCA This field contains the cylinder number of the prime module (used for CCW seek).
BXSEKH This field contains the head number of the prime module (used for CCW seek).
BXSEKR This field contains the record number of the prime module (used for CCW seek).
BXSK1 This field refers to the seek address of the duplicate track.
BXSK1B This field is used to process the start of the seek address for the duplicate track.
BXSK1CA This field contains the cylinder number of the duplicate module (used for CCW seek).
BXSK1H This field contains the head number of the duplicate module (used for CCW seek).
BXSK1R This field contains the record number of the duplicate module (used for CCW seek).
BXAUEND This equate marks the end of the BXAU work area.
BXTPALL This field contains a tape header for use by capture and restore tape processing.
BXTPLBL This field contains the tape label (BXA).
BXTPCCW This field contains the current buffer size index used in building CCWs.
BXTPDEV This field contains the device type indicator for the current module that is being processed.
BXTPDTE This field contains the capture date.
BXTPTME This field contains the capture time.
BXTPSEQ This field contains the tape block sequence number that is currently being processed.
BXXMODA This field contains the module number of the current module that is being captured or restored.
BXXRNO This field contains the reel number of the current reel that is being processed.
BXTPSS (RESERVED)
BXTPSPA (RESERVED)
BXTPCNT This field refers to the capture and restore count fields.
BXTPCTF This field contains the cylinder/head address of each record that is being processed.
BXTPSP1 (RESERVED)
BXTPCF2 (RESERVED)
BXTPAL2 This field contains the duplicate tape header area.
BXTPCT2 This field contains the capture and restore duplicate count fields.
BXCBADR This field defines the area containing the address of a core block used for I/O buffers.
BXCBADF This field contains the address of a core block that will be used for I/O buffers.
CAPCCW This field defines a work area used by capture and restore containing disk and tape CCW areas.
CAPREG This field is used as a save area for various capture and restore fields.
CAPDSK This field contains the capture and restore disk CCW build area.
CAPTAP This field contains the capture and restore tape CCW build area.
CAPRTR This field contains the retry seek address.
RESDK2 (RESERVED)
RESCW2 (RESERVED)
SAFETY This field redefines the first 24 EBW bytes of the ECB and contains information common to capture and restore.
SAFIPD This field defines an area containing various capture and restore indicators.
SAFOPI This field indicates whether a capture or restore is active.
SAFSRT This field indicates whether a module is completed or not.
SAFIPFD This field contains the address of the appropriate in-progress field (IPF).
SAFMOD This field contains the current module number being processed.
SAFDE2 This field contains the current tape hardware address.
SAFDES This field contains the symbolic tape name.
SAFTMM This field contains the decimal time that the capture or restore entry began.
SAFTMB This field contains the binary time that the capture or restore entry began processing the current reel of tape.
SAFPSS This field contains the capture common area address (CMMPSS).

Keypoint DSECTs

The following DSECT definitions are provided in the capture and restore keypoint record (BXAXF).

Disk Device Control Table (DDCT)

This record is completely initialized by the online capture and restore programs as needed.

Table 11. Disk Device Control Table (DDCT)

Name Description
DDCT DSECT describing the disk device control table.
DDCLAB This field contains the program record number and demand counter that are used in lieu of an alphabetic record ID because the disk device control table is maintained as a program.
DDCNAM This field contains the program stamp. This field will always contain BXAM because this is the only segment that files the DDCT.
DDCSYN This field contains a synchronization field used to ensure that the capture and restore keypoint and the DDCT reflect the same point in time when a system IPL occurs. Refer to keypoint tag BXSYNF for more information.
DDCTOT This field contains the number of modules to process.
DDCDON This field contains the number of modules that are currently done.
DDCCIP This field contains the number of entries in progress.
DDCCES This field contains the total number of restore entries started.
DDCPIND This field contains the processor participation indicator.
DDCTMID This field contains the number of modules that are deferred.
DDCTMOF This field contains the number of modules that are offline.
DDCHDR This tag refers to the first 30 bytes of the DDCT, which are considered the record header.
DDCNMOD This tag is equated to the number of DDCMOD entries in the DDCT. It is calculated as follows: 4096 - L'DDCHDR - 1.
DDCMOD This byte field is used as 8 1-bit indicators to maintain the status of modules that are being captured or restored. 4065 of these fields exist in the DDCT, allowing for a module number range of 0-4064.