gtpo1mdnOperations

ZRECP PROFILE-Option Table Input Message Driver

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

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.