Use this command to display or set your recoup run-time options.
Requirements and Restrictions
Most options cannot be changed while recoup is running.
Format
- DISPLAY
- displays the recoup option table.
- RCP
- specifies one of the following:
- ALL
- specifies that all IDs are to be written to the RCP tape.
- NONE
- specifies that no IDs are to be written to the RCP tape.
- charids
- is a continuous list of 1- to 10-character IDs that are to be written to
the RCP tape. The following example shows the RCP parameter with two
IDs in character format:
RCP-AABB
- RCPX-hexids
- specifies the specific hexadecimal IDs that are to be written to the RCP
tape, where hexids is a continuous list of 1- to 10-hexadecimal
IDs. The following example shows the RCP parameter with two IDs in
hexadecimal format:
RCPX-0A0B0C0D
- ERRLOG
- specifies one of the following:
- RCP
- specifies that errors are to be written to the RCP tape.
- BOTH
- specifies that errors are to be written to both an online file and the RCP
tape.
- Note:
- You can specify this parameter only if you have the TPFDF product
installed.
- DIRTIM-dirtim
- specifies the directory capture timeout value, where dirtim is
the number of seconds from 00000 to 99999.
- ADR
- specifies one of the following:
- NO
- specifies that items are to be logged to a file.
- Note:
- If the TPF system is in 1052 state during recoup processing, items are logged
to the ADR tape even if NO was specified.
- YES
- specifies that items are to be logged to the ADR tape.
- Note:
- You cannot change the value of this parameter at any time during recoup
processing after you enter the ZRECP START command.
- ADRNUM-adrnum
- specifies the number of bytes to be written for each ADR item, where
adrnum is a decimal value from 0000 to 9999.
- Note:
- You cannot change the value of this parameter at any time during recoup
processing after you enter the ZRECP START command.
- BCHMAX-bchmax
- specifies the number of broken chains to be logged, where bchmax
is a decimal value from 00000000 to 99999999. This includes both fixed
errors and timeout errors. Fixed errors will continue to be logged
until both BCHMAX and FIXERMAX values are exceeded. However, timeout
errors are always logged regardless of whether the BCHMAX or FIXERMAX values
have been exceeded.
- FIXERMAX-fixermax
- specifies the number of fixed errors to report to the computer room agent
set (CRAS) per record ID, where fixermax is a decimal value from 0000
to 9999. This paramer also defines how many fixed errors will be
written to the online error log after the BCHMAX limit is exceeded.
- EALOSTMAX-ealostmax
- specifies the maximum number of pool records used to log phase 3
erroneously available (EA) and lost pool files, where ealostmax is a
decimal value from 00000000 to 99999999.
- CSERRMAX-cserrmax
- specifies the number of TPF collection support (TPFCS) errors to report to
the CRAS for each datastore, where cserrmax is a decimal value from
0000 to 9999. If you specify a value of zero, recoup processing will
report all errors.
- CSTIMEOUT-cstimeout
- specifies half of the maximum amount of time that TPFCS data store
processing will wait after the last ECB is created before continuing, where
cstimeout is a decimal value in seconds from 0000 to 9999. A
timeout condition occurs if any ECBs have not completed normally after twice
the specified amount of time after which all outstanding ECBs are cleaned
up. If you specify a value of zero, recoup will not check for a timeout
condition.
- STATUSCON
- specifies one of the following:
- YES
- specifies that status messages will be displayed on the console while
recoup phase 1 is running.
- NO
- specifies that status messages will not be displayed on the console while
recoup phase 1 is running.
- Note:
- If STATUSCON-NO is specified, status messages will still be routed to the
real-time database services (RDBS) function support console (FSC) unless
FSC-NO is also specified.
- REFFMMAX-refmax
- specifies the number of file addresses to be logged, where refmax
is any decimal value from 00000000 to 99999999.
- REFFROM
- specifies one of the following:
- NONE
- performs no logging.
- DEACTIVATION
- logs deactivation reference-from file addresses up to the maximum allowed
into the SRM61A8 database.
- Note:
- You can specify this parameter only if you have the TPFDF product
installed.
- FARF3
- logs FARF3 reference-from file addresses up to the maximum allowed into
the SRM61A8 database.
- Note:
- You can specify this parameter only if you have the TPFDF product
installed.
- FARF4
- logs FARF4 reference-from file addresses up to the maximum allowed into
the SRM61A8 database.
- Note:
- You can specify this parameter only if you have the TPFDF product
installed.
- FARF5
- logs FARF5 reference-from file addresses up to the maximum allowed into
the SRM61A8 database.
- Note:
- You can specify this parameter only if you have the TPFDF product
installed.
- FSC
- specifies one of the following:
- YES
- specifies that recoup status messages will be sent to the real-time
database services (RDBS) function support console (FSC) that was defined by
the ZACRS command.
- NO
- specifies that recoup status messages will not be sent to the RDBS FSC,
but will be sent to the default receive-only (RO) FSC.
Additional Information
- Online help information is available for this command. To display
the help information, enter one of the following:
ZRECP PROFILE HELP
ZRECP PROFILE ?
- Each time you enter the ZRECP SETUP command, all default values are
reset.
Examples
The following example sets the recoup options so that all IDs are written
to the RCP tape.
+--------------------------------------------------------------------------------+
|User: ZRECP PROFILE RCP-ALL |
| |
|System: RECP0504I 13.16.59 RECOUP OPTIONS |
| CURRENT OPTIONS LAST OPTIONS |
| |
| DIRTIM - 00500 DIRTIM - 00500 |
| ERRLOG - BOTH ERRLOG - BOTH |
| ADR - NO ADR - NO |
| ADRNUM - 0032 ADRNUM - 0032 |
| FIXERMAX - 0100 FIXERMAX - 0100 |
| BCHMAX - 00000100 BCHMAX - 00000100 |
| EALOSTMAX - 00001000 EALOSTMAX - 00001000 |
| REFFMMAX - 00001000 REFFMMAX - 00001000 |
| REFFROM - FARF4 REFFROM - FARF4 |
| STATUSCON - YES STATUSCON - YES |
| FSC - YES FSC - YES |
| |
| RCP - ALL RCP - ALL |
| CURR RCPX - D1F8 D1F9 |
| LAST RCPX - D1F8 D1F9 |
| |
| END |
+--------------------------------------------------------------------------------+
The following example sets recoup options that determine the directory
capture timeout value, the maximum number of broken chains to be logged, and
which records are written to the RCP tape.
+--------------------------------------------------------------------------------+
|User: ZRECP PROFILE BCHMAX-00099999 DIRTIM-200 RCP-AA RCPX-1234 |
| |
|System: RECP0504I 13.16.59 RECOUP OPTIONS |
| CURRENT OPTIONS LAST OPTIONS |
| |
| DIRTIM - 00200 DIRTIM - 00200 |
| ERRLOG - BOTH ERRLOG - BOTH |
| ADR - NO ADR - NO |
| ADRNUM - 0032 ADRNUM - 0032 |
| FIXERMAX - 0100 FIXERMAX - 0100 |
| BCHMAX - 00099999 BCHMAX - 00099999 |
| EALOSTMAX - 00001000 EALOSTMAX - 00001000 |
| REFFMMAX - 00001000 REFFMMAX - 00001000 |
| REFFROM - FARF4 REFFROM - FARF4 |
| STATUSCON - YES STATUSCON - YES |
| FSC - YES FSC - YES |
| |
| RCP - AA RCP - ALL |
| CURR RCPX - 1234 |
| LAST RCPX - D1F8 D1F9 |
| |
| END |
+--------------------------------------------------------------------------------+
Related Information
See TPF Database Reference for more information
about recoup functions and procedures.