bdfu1m0nUtilities

ZFCRU SETUP-Parameter Table Maintenance and Setup

Use this command to update an existing parameter table that has been locked.

Requirements and Restrictions

Format







FUNCTION
specifies the function to be performed.

CAPTURE
specifies the data to be captured to tape.

RESTORE
specifies the data to be restored from tape.

VERIFY
verifies data structures, and reports broken chains and references that are not valid.

PACK
specifies data structures to pack according to the database definition (DBDEF) macro.
Note:
Because packing large database structures requires a significant amount of system resources, commit scope processing is not available with the pack function, regardless of what the DBDEF macro has set as the default.
Note:
You must specify a chain chasing parameter when you use the capture, verify, or pack functions.

REF
specifies as many as 30 hexadecimal fixed file identifiers (IDs) to chain chase.
Note:
The subparameters associated with the REF parameter (PARTITION, INTERLEAVE, FVN, and ORDINAL) are related to a single REF ID or wanted file ID (WID). You cannot specify them using an ID range.

id
is a record ID in 2-character alphanumeric or 4-character hexadecimal format.

id-id
is a range of IDs in 2-character or 4-character hexadecimal format.

id-id/id/id
is a list of IDs. You can specify single IDs and ID ranges in mixed format.

PARTITION-pp
specifies a fixed file partition to be processed, where pp is the partition for TPFDF files.
Note:
This parameter works for TPFDF files only.

INTERLEAVE-ii
specifies a fixed file interleave to be processed, where ii is the interleave number for TPFDF files.
Note:
This parameter works for TPFDF files only.

FVN-vv
specifies the file version (if applicable), where vv is the file version number.

ORDINAL
specifies an ordinal number or range of ordinal numbers to be processed.

FIRST
specifies the first relative ordinal number.

LAST
specifies the last relative ordinal number.

o
is a relative ordinal number. You can specify a relative ordinal number with a maximum size of 8 digits.

FIRST-o
specifies a range of relative ordinal numbers starting with the first ordinal number.

o-LAST
specifies a range of relative ordinal numbers ending with the last ordinal number.

o-o
is a range of relative ordinal numbers.

FIRST/LAST
specifies a list of relative ordinal numbers beginning with the first and ending with the last ordinal number.
Note:
You can specify a maximum of 10 relative ordinal number ranges.

FAD
specifies as many as fifty 8-character hexadecimal file addresses to be chain chased.
Note:
The file addresses specified with this parameter are started when you use the RESTORE parameter with the REBUILD option.

fileaddr
is an 8-character hexadecimal file address.

fileaddr/fileaddr
is a list of 8-character hexadecimal file addresses.

MRC
specifies multiple reference check (MRC) support during CRUISE capture processing, where:

NO
specifies that MRC support is not used during CRUISE capture processing.

YES
specifies that MRC support is used during CRUISE capture processing.

MRC support is a method that modifies CRUISE capture processing so that detailed files referenced from more than one index file are chain chased only once.

MRCID
specifies the file IDs to be included with MRC processing, where:

ALL
specifies that all file IDs are to be included with MRC processing.

id
is the file ID to be included with MRC processing. You can specify as many as 10 file IDs.

Notes:

  1. Because the MRC parameter with the NO value specified ignores the MRCID parameter, they can be used together.

  2. If you use the MRCID parameter, the MRC parameter with the YES value is automatically specified by the TPFDF product.

WID
sets up as many as 30 wanted file IDs (WIDs) to be chain chased.

Notes:

  1. The WID parameter can be a fixed or pool file.

  2. The WID parameter limits the functions to the specified file IDs while chain chasing the structure referenced by the REF or FAD parameter. For example, if the file ID specified with the WID parameter is equal to the fixed file ID specified with the REF parameter, CRUISE will only process the fixed file and disregard any existing references to another file.

  3. When you use the RESTORE parameter, the WID parameter specifies the first file ID to be restored. Additionally, all forward chain blocks (if any) will be restored. If you use the IMB parameter, all referenced subfiles will also be processed.

  4. The subparameters associated with the WID parameter (PARTITION, INTERLEAVE, FVN, and ORDINAL) are related to a single REF ID or wanted file ID. You cannot specify them using an ID range.

  5. The WID parameter is not supported with CRUISE restore processing when the database is captured using MRC support.

ADR
specifies a search of as many as fifty 8-character hexadecimal file addresses. CRUISE will report all references of the specified file addresses during chain chasing as specified by the REF or FAD parameter.

The restore parameter will process this file address and all of its forward chains. When you use the IMB parameter, it will also process all referenced subfiles.

Note:
The ADR parameter is not supported with CRUISE restore processing when the database is captured using MRC support.

ECB-ecb
specifies the percent of total entry control blocks (ECBs) to be distributed, where ecb is a value in the range 1-100%. One hundred percent is the total number of ECBs allocated on the TPF system.

APL-a
specifies the application ID of the files that the CRUISE function will process, where a is the application code.
Note:
This parameter applies to the fixed files specified with the REF parameter.

UEX-text
specifies a text string, where text is user-specific text up to 103 bytes that will be available to the user exit segment. The text is contained in the CRUISE workblock (IRCHDF) at assembler label IRCHUTX. The CRUISE workblock is contained in global CINFC, CMMCRU label. You can use the vertical bar (|) to switch between hexadecimal and character input.

TAPE-ttt
specifies the requested tape or general data set (GDS), where ttt is any user-defined tape. This must be defined in the tape label mask record (TLMR).

TARGET
specifies the target system where the data will be restored. This parameter is used for a CRUISE capture only. TPF system is the default.

TPF
specifies the data that will be restored on a TPF system or an ALCS environment.

MVS
specifies the data that will be restored on an MVS system.

SETINUSE
specifies pool file use, where:

YES
calls case 3 of user exit macro DFUEX during the processing of the RESTORE and VERIFY parameters when pool files are used. The RESTORE parameter must have the REF and FAD parameters specified when you use this option.
Note:
You can use this parameter only in NORM state.

NO
does not call case 3 of user exit macro DFUEX during the processing of the RESTORE and VERIFY parameters when pool files are used.

STATISTICS
specifies statistics from the parameter table, where:

YES
specifies that file statistics that are built following successful parameter table processing.

NO
specifies that file statistics are not built following successful parameter table processing.
Note:
Using this parameter with MRC support can result in incomplete statistics because not all paths are chain chased during MRC processing.

IMB
specifies embedded references, where:

YES
specifies that references embedded in files indicated with the WID parameter are included in CRUISE capture, restore, or pack processing.

NO
specifies that references embedded in files indicated with the WID parameter are not included in CRUISE capture, restore, or pack processing. When you use this parameter, only files indicated with the WID parameter are included in capture, restore, or pack processing.

OUTPUT-address
specifies the output device, where address is a 6-digit hexadecimal printer or terminal address. You can specify as many as three output addresses.
Note:
If you start a CRUISE function from a terminal that is not specified as an output terminal, only start and end messages are displayed. However, a prime CRAS receives messages regardless of where a CRUISE function was started.

PRINT
specifies the number of messages to be printed to the output device selected with the ZFCRU OUTPUT command, where

prt
is a number in the range 0-100.

ALL
specifies all the messages are to be printed.

Notes:

  1. Printing will stop when the number you specified is reached.

  2. If the number of messages you specify is less than the number of messages printed, printing will end.

  3. The specified number of messages is in effect only when the CRUISE function is in running state.

LOGGING
specifies messages to be logged to the parameter table, where:

log
is a number in the range 0-100.

ALL
specifies that all the messages are to be logged to the parameter table logging file.

Notes:

  1. Logging ends when the specified number of logged messages is reached.

  2. Logging will run until available pool space is used if you use the ALL parameter with the ZFCRU LOG command.

  3. If the number of logged messages you specify is less than the number of messages logged, logging will complete and no messages are deleted.

  4. The number of messages you specified to be logged is in effect only when the CRUISE function is in running state.

RESTORE
specifies the method in which CRUISE restores data, where:

OLD
specifies that the database is restored to the same fixed and pool file addresses that were captured.

NEW
specifies that the captured fixed and pool files are restored to new pool file addresses where the data structure is rebuilt.
Note:
You can use this parameter only in NORM state.

NOREBUILD
specifies that the captured fixed and pool files are restored to new pool file addresses and the data structure is not rebuilt.
Note:
You can use this parameter only in NORM state.

REBUILD
specifies that the captured fixed files are restored to the same ordinals that were captured. The captured pool files are restored to new pool file addresses and the database structure is rebuilt.
Note:
You can use this parameter only in NORM state.

NORELEASE
specifies that old pool file addresses are not released when the structure is rebuilt.
Note:
You can use this parameter only in NORM state.

RELEASE
specifies that old pool file addresses are released when the data structure is rebuilt.
Note:
You can use this parameter only in NORM state.
Note:
To improve system performance, pack a subfile using the pack operation after restore processing on B+Tree and block index files.
Note:
You can also specify the optional parameter names in their abbreviated form as shown in the syntax diagram.

Additional Information

Examples

In the following example, a parameter table (TABLE1) is updated to verify reference ID range 0000-FFFF.

+--------------------------------------------------------------------------------+
|User:    ZFCRU SETUP FUN-VERIFY REF-0000-FFFF                                   |
|                                                                                |
|System:  FCRU0000I 10.51.11 MODIFIED                                            |
|         FCRU0000I 10.51.11 PARAMETER TABLE DISPLAY FOR TABLE1                  |
|         FUNCTION                   VER                                         |
|         USABLE ECB START VALUE     33 PCT                                      |
|         SET POOL ADDRESSES IN USE  NO                                          |
|         BUILD STATISTICS           YES                                         |
|         NUMBER OF PRINT MESSAGES   100                                         |
|         OUTPUT ADDRESSES           306919  000000  000000                      |
|         NUMBER OF LOG MESSAGES     ALL                                         |
|         REFERENCE ID               0000 - FFFF                                 |
|         FCRU0000I 10.51.11 END OF DISPLAY                                      |
+--------------------------------------------------------------------------------+

In the following example, a parameter table (TABLE1) is updated to verify six ranges of relative ordinal numbers for reference ID B075.

+--------------------------------------------------------------------------------+
|User:    ZFCRU SETUP FUN-VER REF-B075 ORD-1-2/4-5/669-771/1115330-0206380/123456|
|         -12345670/12345678-12345679                                            |
|                                                                                |
|System:  CSMP0097I 14.55.28 CPU-B SS-BSS  SSU-HPN  IS-01                        |
|         FCRU0042I 14.55.28 MODIFIED                                            |
|         FCRU0000I 14.55.28 PARAMETER TABLE DISPLAY FOR TABLE1                  |
|         FUNCTION                   VER                                         |
|         USABLE ECB START VALUE     50 PCT                                      |
|         SET POOL ADDRESSES IN USE  NO                                          |
|         BUILD STATISTICS           NO                                          |
|         NUMBER OF PRINT MESSAGES   ALL                                         |
|         NUMBER OF LOG MESSAGES     ALL                                         |
|         REFERENCE ID               B075                                        |
|         ORDINALS                   0000001-0000002 0000004-0000005             |
|                                    0000669-0000771 0206380-1115330             |
|                                    01234567-12345670                           |
|                                    12345678-12345679                           |
|         FCRU0000I 14.55.28 END OF DISPLAY                                      |
+--------------------------------------------------------------------------------+

References