Use this command to:
- Display recoup descriptors (BKDs) by name or slot number
- Move recoup descriptors
- Create dummy recoup descriptors
- Restore recoup descriptors
- Initialize the BKD load control record (BK0LC)
- Display recoup descriptor update history.
- Note:
- Enter the ZOLDR LOAD command to load recoup descriptors to the TPF
system.
Requirements and Restrictions
- You cannot enter this command while recoup processing is active.
- You can enter the following only from the prime CRAS:
- ZRBKD DISP ALL
- ZRBKD MOVE nameversion
- ZRBKD REST Nslotnum
- ZRBKD INIT CTL
- ZRBKD DUMM Nslotnum
- You can enter the following only in test mode or from the prime
CRAS:
- ZRBKD MOVE ALL
- ZRBKD DUMM ALL
- ZRBKD REST ALL
Format
- DISP
- displays recoup descriptors where:
- ALL
- displays all active recoup descriptors.
- name
- is the 4-character name of a specific recoup descriptor that you want to
display.
- Note:
- Recoup descriptor names must start with the letters BK.
- Aslotnum
- displays all active recoup descriptors starting from a specific slot
number, where slotnum is the 2-digit slot number from 00 to
99.
- Nslotnum
- displays all active recoup descriptors, including dummy descriptors,
starting from a specific slot number, where slotnum is the 2-digit
slot number from 00 to 99.
- MOVE
- moves active recoup descriptors, where:
- ALL
- moves all active recoup descriptors into current slot numbers.
Descriptors that were in current slot numbers are moved to previous slot
numbers.
- name
- is a specific 4-character recoup descriptor name.
Notes:
- Recoup descriptor names must start with the letters BK.
- If you do not specify Nslotnum, the recoup descriptor is moved
into its current slot number.
- version
- is a specific version of the named recoup descriptor.
- Nslotnum
- moves the specified recoup descriptor into a specific slot number, where
slotnum is the 2-digit slot number from 00 to 99.
- DUMM
- creates dummy recoup descriptors, where:
- ALL
- creates dummy recoup descriptors and puts them into all the slot numbers
from 0 to 99.
- Nslotnum
- creates a dummy recoup descriptor and puts it into a specific slot number,
where slotnum is the 2-digit slot number from 00 to 99.
- Note:
- The recoup dummy chain chase descriptor segment (BKDW) must be loaded to use
the DUMM parameter.
- REST ALL
- restores recoup descriptors, where:
- ALL
- restores all recoup descriptors to the original sequence numbers.
- Nslotnum
- restores the specified recoup descriptor into its original sequence
number, where slotnum is a 2-digit slot number from 00 to 99.
- INIT CTL
- initializes the BKD load control record (BK0LC).
- HIST
- displays the history of the last 10 commands that changed recoup
descriptors.
Additional Information
Online help information is available for this command. To display
the help information, enter one of the following:
ZRBKD HELP
ZRBKD ?
Examples
Recoup information for all active descriptors is displayed in the following
example, where:
- NO
- indicates the sequence number that the BKD occupies.
- STAT
- indicates one of the following descriptor statuses:
- D
- indicates the BKD is a dummy.
- M
- indicates the BKD was moved.
- R
- indicates the BKD was restored.
- S
- indicates the BKD was saved.
- CURR
- indicates the current descriptor occupying the sequence number.
- PREV
- indicates the descriptor that is used to occupy the sequence
number.
- GR
- indicates the number of primary groups in the descriptor.
- ID
- indicates the record IDs to chase for the descriptor.
- VER
- indicates a specific version of the named recoup descriptor.
+--------------------------------------------------------------------------------+
| |
|User: ZRBKD DISP ALL |
| |
|System: BRUB0012I 10.01.31 RECOUP DESCRIPTOR TABLE |
| NO STAT CURR PREV GR ID -VER |
| 03 .MS. BKZHP1 BKZHP1 01 JO -000 |
| 04 .MS. BKZIP1 BKZIP1 02 JS -001 JS -002 |
| 05 .MS. BKZJP1 BKZJP1 01 JH -000 |
| 06 .MS. BKZ6P1 BKZ6P1 01 JA -000 |
| 07 .MS. BKZMP1 BKZMP1 01 JG -000 |
| 10 .MS. BKZKP1 BKZKP1 01 JT -000 |
| 11 .MS. BKZLP1 BKZLP1 02 JW -000 JW -006 |
| 12 .MS. BKZCP1 BKZCP1 02 JW -050 JA -051 |
| 17 .MS. BKD740 BKDW40 01 FC2A-000 |
| 18 .MS. BKZTP1 BKZTP1 01 FC13-000 |
| 20 .MS. BKDY40 BKDW40 04 FC33-000 FC32-000 FC35-000 |
| CD -000 |
| END OF DISPLAY |
+--------------------------------------------------------------------------------+
The following example moves descriptor BKZ4P1 into slot number 4.
+--------------------------------------------------------------------------------+
|User: ZRBKD MOVE BKZ4P1 N04 |
| |
|System: BRUC0006I 15.34.34 REQUEST PROCESSED |
| |
+--------------------------------------------------------------------------------+
The following example displays the history of the last 10 commands that
changed recoup descriptors (BKDs).
+--------------------------------------------------------------------------------+
|User: ZRBKD HIST |
| |
|System: BRUB0013I 10.00.59 RECOUP DESCRIPTOR TABLE UPDATE HISTORY |
| DATE TIME ENTRY |
| 12DEC2000 10.46.34 ZRBKD DUMM N13 |
| 06DEC2000 10.33.25 ZRBKD MOVE BKDY40 N20 |
| 06DEC2000 10.33.19 ZRBKD MOVE BKZTP1 N18 |
| 06DEC2000 10.33.13 ZRBKD MOVE BKD740 N13 |
| 06DEC2000 10.33.09 ZRBKD MOVE BKZ6P1 N06 |
| 06DEC2000 10.33.04 ZRBKD MOVE BKZNP1 N13 |
| 06DEC2000 10.33.00 ZRBKD MOVE BKZMP1 N07 |
| 06DEC2000 10.32.54 ZRBKD MOVE BKZLP1 N11 |
| 06DEC2000 10.32.49 ZRBKD MOVE BKZKP1 N10 |
| 06DEC2000 10.32.45 ZRBKD MOVE BKZJP1 N05 |
| END OF DISPLAY |
+--------------------------------------------------------------------------------+
Related Information
See TPF Database Reference for more information
about recoup functions and procedures.