General Page
Environment Variables:
QZ_FSFC_CANCEL_CLONE_NO_FORCE
Where: Controlling LPAR
Why: The toolkit will always 'cancel' a PowerVS clone using the 'force' parameter. Use this environment to remove the 'force' parameter. Without the 'force' parameter, only clones in 'prepared' or 'available' states can be canceled.
How: ADDENVVAR ENVVAR(QZ_FSFC_CANCEL_CLONE_NO_FORCE) LEVEL(*SYS)
QZ_FSFC_CLONE_ROLLBACK_FALSE
Where: Controlling LPAR
Why: The toolkit will always specify the 'rollback' parameter when executing PowerVS volume-clones, such that a failure will cause PowerVS to roll back clone activity and removes the prepared snapshot. The existence of this environment variable will not trigger a rollback after a failure, and the toolkit will attempt to cancel and delete the clone.
How: ADDENVVAR ENVVAR(QZ_FSFC_CLONE_ROLLBACK_FALSE) LEVEL(*SYS)
QZ_PVS_ALW_CLONE_GRS
Where: Controlling LPAR
Why: When PowerVS creates a clone of a replicating volume, the clone will also be replicating. By default STRFSFLASH will then remove the clone volumes from consistency sets and stop replication. If this environment variable exists STRFSFLASH will not change the replication status of the clone volumes nor remove it from the consistency set.
How: ADDENVVAR ENVVAR(QZ_PVS_ALW_CLONE_GRS) LEVEL(*SYS)
QZ_PVS_CRTVOL_NO_REPL
Where: Controlling LPAR
Why: Disable passing the 'replication enabled' flag when using WRKCLDVOL to create volumes.
How: ADDENVVAR ENVVAR(QZ_PVS_CRTVOL_NO_REPL) LEVEL(*JOB)
QZ_DISABLE_PCYGM_CHECKPOINT
Where: Controlling LPAR
Why: Some FlashSystem firmware releases do not support chvolumegroupreplication -checkpoint so the toolkit needs to use the running recovery point instead, which is less accurate.
How: ADDENVVAR ENVVAR(QZ_DISABLE_PCYGM_CHECKPOINT) LEVEL(*SYS)
QZ_PBR_TARGET_FLASH
Where: Controlling LPAR
Why: Enable the CSE parameters for creating a flashcopy from the target of policy-based replication. The value in the environment is the number of seconds the toolkit will delay before triggering the flashcopy. The recommendation is to not perform flashcopies from the target of replication until the FlashSystem firmware supports chvolumegroupreplication -checkpoint.
How: ADDENVVAR ENVVAR(QZ_PBR_TARGET_FLASH) LEVEL(*SYS) VALUE(<seconds>)
QZ_FLASH_PAD
Where: Source LPAR
Why: When using BRMS transfer method *CHGONLY and performing a FlashCopy while backups are running on the source LPAR, it is possible that BRMS can add additional records to the database after the FlashCopy timestamp is established. At version 5.2 and newer the toolkit defaults to padding this timestamp with five minutes, but if the target LPAR IPLs and starts backups faster than that a shorter pad value may be needed. The toolkit will use the pad time specified by this environment variable.
How: ADDENVVAR ENVVAR(QZ_FLASH_PAD) LEVEL(*SYS) VALUE(<minutes>)
QZ_ALLOW_PCYGM_DETACH
Where: Controlling LPAR
Why: At version 5.2 and newer, detach is blocked for PCYGM unless the following environment variable exists. The toolkit cannot guarantee the point in time of the data on the target disk and thus cannot prevent applications from starting. During the attended IPL of the target the user must ensure the LPAR will start to restricted state, and issue these commands when the command line becomes available, before the controlling subsystem is started:
CHGSYSVAL QSTRUPPGM VALUE(*NONE)
CRTDTAARA DTAARA(QZRDHASM/QDETACHED) TYPE(*CHAR)
How: ADDENVVAR ENVVAR(QZ_ALLOW_PCYGM_DETACH) LEVEL(*SYS)
QZ_DS_CG_WAIT
Where: Controlling LPAR
Why: At version 4.6 and newer, SWCSE on DS8K GMIR will wait up to 10 minutes for the consistency to be sent to the target DS. If the network does not have sufficient bandwidth requires longer time it will place the error "Failed to reach consistency within 10 minutes" in the viewlog. Use this environment variable to increase the timeout value .
How: ADDENVVAR ENVVAR(QZ_DS_CG_WAIT) VALUE(<minutes>) LEVEL(*SYS)
QZ_COS_XFER_DELAY_WARN
Where: Source LPAR
Why: At version 4.6 and newer, CHKFSFLASH will fail if there are BRMS volumes that need to be transferred to Cloud Object Storage (WRKMEDBRM TYPE(*TRF) will show them). Use this environment variable to change CHKFSFLASH to only issue a warning instead.
How: ADDENVVAR ENVVAR(QZ_COS_XFER_DELAY_WARN) LEVEL(*SYS) and restart subsystem QZRDFSR.
QZ_FSFC_AE_DELAY
Where: Source LPAR
Why: At version 4.6 the toolkit will set the Activation Engine delay to zero prior to a Flash Copy, and leave it at zero, which is appropriate for non-PowerVS operations. If the LPAR is in PowerVS then a delay is required, and the toolkit will restore the delay to the value specified in the environment variable. CALL PGM(QSYS/QCLTDSP) will display the currently configured value.
How: ADDENVVAR ENVVAR(QZ_FSFC_AE_DELAY) VALUE(5) LEVEL(*SYS)
QZ_FSFC_QUIESCE_FRCWRT
Where: Source LPAR
Why: If the environment variable exists add parameter SSPFRCWRT to CHGASPACT. The variable should contain *YES or *NO and that will be placed on the parameter value.
How: ADDENVVAR ENVVAR(QZ_FSFC_QUIESCE_FRCWRT) VALUE(*YES) LEVEL(*SYS)
IBM_POWER_HA_TOOLS_LOGFILE
Where: Controlling LPAR
Why: Set the log file to use. The variable contains the path of the log file.
How: ADDENVVAR ENVVAR(IBM_POWER_HA_TOOLS_LOGFILE) VALUE('/tmp/newfile') LEVEL(*SYS)
QZ_FSFC_UPTIME_HOURS
Where: Controlling LPAR
Why: Override the default FSFC target LPAR uptime timeout. Use the value (in hours) in the variable.
How: ADDENVVAR ENVVAR(QZ_FSFC_UPTIME_HOURS) VALUE(34) LEVEL(*SYS)
QZ_LPAR_IMMED_DEACTIVATION
Where: Controllling LPAR
Why: If the variable exists, the toolkit is to use the --immed parameter when shutting down the target LPAR.
How: ADDENVVAR ENVVAR(QZ_LPAR_IMMED_DEACTIVATION) LEVEL(*SYS)
QIBM_FSFC_JAVA_FILE
Where: Controlling LPAR
Why: Additional Java logging to the path specified in the variable
How: ADDENVVAR ENVVAR(QIBM_FSFC_JAVA_FILE) VALUE('/tmp/newfile') LEVEL(*SYS)
QZRDHASM_RECOVERY_POINT
Where: Controlling LPAR
Why: Show Recovery Point Flash parameters in WRKCSEDTA
How: ADDENVVAR ENVVAR(QZRDHASM_RECOVERY_POINT) LEVEL(*SYS)
QZRDHASM_PING_CMD
Where: Controlling LPAR
Why: Override the default Java ping command for CSM operations
How: ADDENVVAR ENVVAR(QZRDHASM_PING_CMD) VALUE(some_other_ping_command) LEVEL(*SYS)
QIBM_FSFC_DISABLE_MEDIA_CLASS_CHECK
Where: Source LPAR for use on the target LPAR
Why: Disable checking for restricted media class on merge operations
WARNING: Will allow media overwrites
How: ADDENVVAR ENVVAR(QIBM_FSFC_DISABLE_MEDIA_CLASS_CHECK) LEVEL(*SYS)
QZ_IGNORE_BRMS_ERROR
Where: Source LPAR for use on the target LPAR
Why: If this exists on the target LPAR when BRMS calls QZBRMSEXIT (the control group backup item exit program) and BRMS indicates an error has occurred, the toolkit will ignore the error reported by BRMS and issue ENDFSFLASH *NORMAL anyway. Hint: It's best to get BRMS control groups to run clean by omitting items it can't backup.
How: ADDENVVAR ENVVAR(QZ_IGNORE_BRMS_ERROR) LEVEL(*SYS)
QZIA_SG_PVI_RETRY
Where: Source LPAR for use on the target LPAR after the Safeguarded Copy (Physical Virtual Isolation) FlashCopy.
Why: The value in the environment variable determines how many times the target LPAR will try connecting to the controller to retrieve BRMS.
How: ADDENVVAR ENVVAR(QZIA_SG_PVI_RETRY) VALUE(5) LEVEL(*SYS)
QIBM_CSM_ALT_JAVA_HOME
Where: Controlling LPAR
Why: The path in the environment variable will be used for the JAVA_HOME path for CSM Java calls. Default is /QOpenSys/QIBM/ProdData/JavaVM/jdk80/32bit
How: ADDENVVAR ENVVAR(QIBM_CSM_ALT_JAVA_HOME) VALUE('path to Java directory') LEVEL(*SYS)
QIBM_DSCLI_ALT_JAVA_HOME
Where: Controlling LPAR
Why: The path in the environment variable will be used for the JAVA_HOME path for DSCLI Java calls. Default is /QOpenSys/QIBM/ProdData/JavaVM/jdk80/32bit
How: ADDENVVAR ENVVAR(QIBM_DSCLI_ALT_JAVA_HOME) VALUE('path to Java directory') LEVEL(*SYS)
QIBM_SSH_ALT_JAVA_HOME
Where: Controlling LPAR
Why: The path in the environment variable will be used for the JAVA_HOME path for SSH Java calls. Default is /QOpenSys/QIBM/ProdData/JavaVM/jdk80/32bit
How: ADDENVVAR ENVVAR(QIBM_SSH_ALT_JAVA_HOME) VALUE('path to Java directory') LEVEL(*SYS)
QZ_FSFC_STRRSTD_FAIL
Where: Source LPAR
Why: If the LPAR is set to start to restricted state [CHGIPLA STRRSTD(*YES)] a warning will be issued. If this environment variable exists the FlashCopy process will fail instead.
How: ADDENVVAR ENVVAR(QZ_FSFC_STRRSTD_FAIL) LEVEL(*SYS)
QZ_NO_FLUSH
Where: Source LPAR
Why: When using *FRCWRT and this environment variable exists then don't call CHGASPACT before the FlashCopy. In 4.6 this is replaced with memory flush method *NONE.
How: ADDENVVAR ENVVAR(QZ_NO_FLUSH) LEVEL(*SYS)
QIBM_FSFC_RMT_FLASH_TIMEOUT
Where: Source LPAR
Why: The environment variable contains a new timeout value for remote STRFSFLASH. The default value is 180 seconds. This is how long remote STRFSFLASH will wait for a response from the controller before giving up.
How: ADDENVVAR ENVVAR(QIBM_FSFC_RMT_FLASH_TIMEOUT) VALUE(240) LEVEL(*SYS)
QZ_FSFC_NO_DS_PING
Where: Controlling LPAR
Why: If this exists to do not attempt to ping the DS8K to validate a communications path.
How: ADDENVVAR ENVVAR(QZ_FSFC_NO_DS_PING) LEVEL(*SYS)
QZ_DISABLE_LUN_CHECK
Where: Controlling LPAR
Why: For FSR operations, skip the LUN check on the source LPAR. For FSFC, skip the LUN check on the target LPAR.
How: ADDENVVAR ENVVAR(QZ_DISABLE_LUN_CHECK) LEVEL(*SYS)
QZ_NO_RESYNC_MULTINC
Where: Controlling LPAR
Why: Will not add the -multinc parameter to script # 77 (resyncflash) for the environments specified. If the flashcopy was initially created without -multinc then the resyncflash cannot be performed with -multinc. While a better solution is to remove the flashcopy (rmflash) and then re-establish a flashcopy (mkflash) with the -multinc parameter, this environment provides a workaround. The environment variable's value should include the copy services environments (CSE) which must not have the -multinc parameter.
How: ADDENVVAR ENVVAR(QZ_NO_RESYNC_MULTINC) LEVEL(*SYS) VALUE('<CSE1><CSE2><CSE4>')
QZ_FSR_IGNORE_COMM_PORT
Where: Source LPAR
Why: When searching for comm resources after FSR switch ignore the port number
How: ADDENVVAR ENVVAR(QZ_FSR_IGNORE_COMM_PORT) LEVEL(*SYS)
QZ_PWRREST_DUMP
Where: Controlling LPAR
Why: Dump PowerVS API information into files into a directory specified by the env variable value.
How: ADDENVVAR ENVVAR(QZ_PWRREST_DUMP) LEVEL(*SYS) VALUE('/QIBM/Qzrdhasm/logs')
QZ_PWRREST_TIMEOUT
Where: Controlling LPAR
Why: Wait up to n minutes for a response from PowerVS.
How: ADDENVVAR ENVVAR(QZ_PWRREST_TIMEOUT) LEVEL(*SYS) VALUE('n')
Where: Controlling LPAR
Why: For CSM configurations, use DSCLI instead of ping
How: ADDENVVAR ENVVAR(QIBM_FSFC_PING) LEVEL(*SYS)
QZRD_DISABLE_CG_FLASH_CHECK
Where: Controlling LPAR
Why: If asymmetrical CHKPPRC don't check CG FLASH
How: ADDENVVAR ENVVAR(QZRD_DISABLE_CG_FLASH_CHECK) LEVEL(*SYS)
QZ_INQ_SAFE2CONTINUE
Where: Controlling, source and target LPARs
Why: At several crucial VM IPL and shutdown points, halt and issue an inquiry message asking for permission to continue.
How: ADDENVVAR ENVVAR(QZ_INQ_SAFE2CONTINUE) LEVEL(*SYS)
QZ_SKIP_VC_CLEANUP
Where: Controlling LPAR
Why: Do not clean up (remove) PowerVS volumes-clones
How: ADDENVVAR ENVVAR(QZ_SKIP_VC_CLEANUP) LEVEL(*SYS)
QZ_FSFC_ISCSI_VRYFIX
Where: Source LPAR
Why: Perform an extra vary off - vary on cycle to the tape device.
How: ADDENVVAR ENVVAR(QZ_FSFC_ISCSI_VRYFIX) LEVEL(*SYS)
QZ_FSFC_ISCSI_OLD_TARGET
QZ_FSFC_ISCSI_OLD_INIT
QZ_FSFC_ISCSI_OLD_TARGET_IP
QZ_FSFC_ISCSI_OLD_TARGETPORT
QZ_FSFC_ISCSI_TARGET
QZ_FSFC_ISCSI_INIT
QZ_FSFC_ISCSI_TARGET_IP
QZ_FSFC_ISCSI_TARGETPORT
Where: Source LPAR
Why: Used briefly in 4.6 to identify the iSCSI resources to remove and create. 5.1+ encapsulates this information on panels and the environment variables are no longer used.
How: ADDENVVAR ENVVAR(QZ_FSFC_ISCSI_*) LEVEL(*SYS) VALUE('<various>')
QIBM_SAVE_DDDS_TO_FILES_AND_THEN_REMOVE_FROM_CLUSTER
Where: Controlling LPAR
Why: After SAVDDD saves the DDD, remove the information from the cluster.
How: ADDENVVAR ENVVAR(QIBM_SAVE_DDDS_TO_FILES_AND_THEN_REMOVE_FROM_CLUSTER) LEVEL(*JOB)
QZ_FSFC_CLONE_FLASH_TIER
Where: Controlling LPAR
Why: Experimental method to set the clone voume tier level
How: ADDENVVAR ENVVAR(QZ_FSFC_CLONE_FLASH_TIER) LEVEL(*SYS)
QZ_FSFC_CLONE_PREP_FAIL
Where: Controlling LPAR
Why: For testing purposes to cause a PowerVS volumes-clone prepare operation to fail.
How: ADDENVVAR ENVVAR(QZ_FSFC_CLONE_PREP_FAIL) LEVEL(*SYS)
QZ_FSFC_CLONE_START_FAIL
Where: Controlling LPAR
Why: For testing purposes to cause a PowerVS volumes-clone start operation to fail.
How: ADDENVVAR ENVVAR(QZ_FSFC_CLONE_START_FAIL) LEVEL(*SYS)
QZ_FSFC_CLONE_EXEC_FAIL
Where: Controlling LPAR
Why: For testing purposes to cause a PowerVS volumes-clone execution operation to fail.
How: ADDENVVAR ENVVAR(QZ_FSFC_CLONE_EXEC_FAIL) LEVEL(*SYS)
All data areas are in QZRDHASM.
NOMULTPATH
Where: Production LPAR
Why: Existence signals to the toolkit that FIXSTRPRSC will skip the multi-path reset.
CHGSRCIP
Where: Source LPAR LPAR
Why: Indicate to the target LPAR the IP used to reach the source LPAR. This is useful if there is a NAT between the source and target LPARs.
SENDSAVF
Where: Source LPAR LPAR
Why: Revert to using savefiles instead of virtual tape to receive QUSRBRM
SLOWSOCK
Where: Source LPAR
Why: Force toolkit to use a very slow QUSRBRM xfer method
KEEPHRVST
Where: Source LPAR
Why: Do not delete the BRMS xfer library after merging records. Only valid for *CHGONLY transfers.
ONLYRSTCLS
Note: Obsolete after 4.4
Where: Source LPAR
Why: For *CHGONLY transfers, skip checking if volume has changed media class before merging data.
DEBUG
Where: Anywhere
Why: Turn on additional debug statements.
WAIT4TAPE
Where: Source LPAR
Why: Add a 120 second delay on the target LPAR before configuring tape devices
GMCVFREEZE
Where: Controlling LPAR
Why: Revert to the old method of looking for freeze times in a specific window of time
FORCECONN
Where: Controlling LPAR
Why: Add the -force parameter when changing SVC host connections.
OLDGMCV
Where: Controlling LPAR
Why: Force a FSR switch using the older GMIT method.
Was this topic helpful?
Document Information
Modified date:
26 June 2024
UID
ibm11138414