Use this command to update an existing parameter table that has been
locked.
Requirements and Restrictions
- You must lock the parameter table before you can use the ZFCRU SETUP
command.
- The ADR and WID parameters are not supported with CRUISE restore
processing when the database is captured using multiple reference check (MRC)
support. Using the STATISTICS parameter with MRC support can result in
incomplete statistics because not all paths are chain chased during MRC
processing.
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:
- Because the MRC parameter with the NO value specified ignores the MRCID
parameter, they can be used together.
- 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:
- The WID parameter can be a fixed or pool file.
- 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.
- 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.
- 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.
- 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:
- Printing will stop when the number you specified is reached.
- If the number of messages you specify is less than the number of messages
printed, printing will end.
- 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:
- Logging ends when the specified number of logged messages is
reached.
- Logging will run until available pool space is used if you use the ALL
parameter with the ZFCRU LOG command.
- If the number of logged messages you specify is less than the number of
messages logged, logging will complete and no messages are deleted.
- 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
- If your database contains a large amount of data with subfiles referenced
by index files, MRC support improves the performance of CRUISE capture
processing by chain chasing each subfile once. By eliminating redundant
chain chasing, MRC support reduces the amount of tape required and increases
the performance of CRUISE capture processing. The performance of CRUISE
restore and verify processing is also improved. Additionally, MRC
support enhances the management of your system resources with improved CPU and
input/output (I/O) time.
- The ADR and WID parameters are not supported with CRUISE restore
processing when the database is captured using MRC support. Using the
STATISTICS parameter with MRC support can result in incomplete statistics
because not all paths are chain chased during MRC processing.
- You must pack a B+Tree and block index file to validate
the file references after CRUISE capture and restore processing because CRUISE
capture and restore processing nullifies the validation of block index
technical LRECs (TLRs) and releases B+Tree files.
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
- See the following commands for information about overriding parameter
table default values while the CRUISE function is in running state.
- See TPFDF Programming Concepts and Reference for
more information about commit scopes.