gtpd1m1d | Database Reference |
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.
Table 5 shows a description of each of the fields in the keypoint
record. Unless otherwise stated, SIP initializes these fields to
X'00'.
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. |
The following tables are defined in the capture/restore keypoint record (BXAXF).
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. |
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. |
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. |
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 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.
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. |
| |
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). |
The following DSECT definitions are provided in the capture and restore keypoint record (BXAXF).
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. |