ZFCRU DEFAULT-set up and change parameter values
Use this command to set up and change parameter table default values.
Requirements and restrictions
None.
Format
Note: You can also specify the optional parameter names in their abbreviated form as shown in the
syntax diagram.
- ECB-ecb
- ECU-ecb specifies the percent of entry control blocks (ECBs) that are used for a
CRUISE function in the range 1 - n%, where n is a predefined maximum ECB level. This level is
defined as CRU_DEF_MAX_ECB in C$CRUUSR. Note:
- If you do not use ZFCRU DEFAULT to define a default value for the ECB parameter, the default value will be set to 10.
- The ECB percentage that is stored in a CRUISE parameter table is ignored during a CRUISE operation if it is too low for a specific ID (for example, there are not enough ECBs for all structure levels of that database). When this occurs, a system-defined number of ECBs is used. You can specify a higher ECB percentage by using the ZFCRU ECB command while a CRUISE operation is running to avoid the system-defined value.
- The specified ECB percentage is always ignored if CRUISE cannot determine the number of structure levels in a database. The predefined default number of ECBs is then used to process that database.
- 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.
Note: If you do not use ZFCRU DEFAULT to define a default value for the SETINUSE parameter, the default value will be set to NO. - STATISTIC
- specifies statistics from the parameter table, where:
- YES
- is the file statistics that are built following successful parameter table processing.
- NO
- is the that file statistics that are not built following successful parameter table processing.
Note: If you do not use ZFCRU DEFAULT to define a default value for the STATISTIC parameter, the default value will be set to NO. - 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.
Note:- Printing will stop when the number you specified is reached.
- Print will stop if the number of messages you specify is less than the number of messages printed.
- You specify the output device for printed messages with the ZFCRU OUTPUT command, or with the output parameter settings specified with the ZFCRU SETUP command.
- The number of messages you specified is in effect only when the capture/restore utility, information and statistics environment (CRUISE) is in running state.
- If you do not use ZFCRU DEFAULT to define a default value for the PRINT parameter, the default value will be set to ALL.
- 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.
Note:- Logging ends when the specified number of logged messages is reached.
- Logging will run until available pool space is used if you use the ZFCRU LOGGING command with the ALL parameter.
- 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 CRUISE is in running state.
- If you do not use ZFCRU DEFAULT to define a default value for the LOGGING parameter, the default value will be set to ALL.
- 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 all messages regardless of where a CRUISE function is entered.
- If you do not use ZFCRU DEFAULT to define default values for the OUTPUT parameter, the output addresses will be set to X'000000'.
- TAPE
- specifies the requested tape or general data set (GDS). Note: If you do not use ZFCRU DEFAULT to define a default value for the TAPE parameter, the default value will be set to BFA.
- ttt
- specifies 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 processed. For example, it
specifies whether the tape format is for the CRUISE restore function or for processing by
applications other than TPFDF applications. This parameter is used for CRUISE capture only. The TPF
system is the default.
- TPF
- specifies that the data will be restored on a TPF or ALCS system by a CRUISE restore function. Since the capture tape is created using multiple-ECB processing for increased performance, the file blocks are not in any specific order on the tape. Every data block is preceded by a control block with CRUISE-specific information. The tape can only be used for a restore function.
- MVS
- specifies that the data can be used by an offline batch job on an MVS system. The file blocks
for subfiles are written to tape in sequential order so that the tape can be processed by an offline
batch job on an MVS system.
The tape can also be used for a restore operation on a TPF or ALCS system by using the DBTRD and DBTLD macros, if the tape contains only TPFDF-type data.
Note: If you do not use ZFCRU DEFAULT to define a default value for the TARGET parameter, the default value is TPF. - 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.
- NOREB
- 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.
- REB
- 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.
- REL
- specifies that old pool file addresses are released when the data structure is rebuilt.
Note: You can this parameter only in NORM state.
- NOREL
- specifies that old pool file addresses are not released when the structure is rebuilt. Note: You can use this parameter only in NORM state.
Note: If you do not use ZFCRU DEFAULT to define a default value for the RESTORE parameter, the default value will be set to REBUILD/NORELEASE.
Additional information
- During the installation of CRUISE, the initial parameter values are set according to the values in the C$CRUUSR header.
- You can use the ZFCRU DEFAULT command while the CRUISE function is processing existing parameter tables; that is, the status of the CRUISE function is active, running (in use), paused, or stopped. However, changes that you make to the parameter table by using the ZFCRU DEFAULT command occur only when new parameter tables are created.
- You can use the ZFCRU DISPLAY command to display the default values that are currently assigned.
Examples
In the following example, the default value for ECBs allocated to CRUISE is 50% of the ECBs allocated to the system.
User: ZFCRU DEFAULT ECB-50
System: FCRU0000I 10.31.44 MODIFIED FCRU0000I 10.31.44 DEFAULT PARAMETER VALUES USABLE ECB START VALUE 50 PCT BUILD STATISTICS YES NUMBER OF PRINT MESSAGES 100 PRINTER ADDRESSES 306919 000000 000000 NUMBER OF LOG MESSAGES ALL SET POOL ADDRESSES IN USE NO TAPE NAME BFA TARGET SYSTEM NAME TPF RESTORE OPTION REBUILD/NORELEASE WID/ADR IMBED REFERENCES YES FCRU0000I 10.31.44 END OF DISPLAY