The execution of the first function that requires the CXX be available ensures that DBUTLTY has not already connected to a MUF and, if so, it is an error, is reflected by the following message, and undergoes error termination.
DB10053E – MUF RUNNING, FUNCTION REQUIRES MUF DOWN
If not connected, the function removes any DELAY68 setting and attempts to connect to MUF. If it is successful, it is an error, receives a DB10053E message, and undergoes error termination.
Once it is determined that the MUF is not enabled, the DBUTLTY ensures that the MUF cannot be enabled using this CXX. By using a shared global ENQ, it protects the execution of the entire DBUTLTY function set. Execution of a MUF during one of these DBUTLTY executions generates a startup error DB00205E with 1095 CXX DSN OWNED ELSEWHERE. If the ENQ is not available, the error is recognized as the following error message and the function terminated.
DB10055E - A MUF RUNNING WITH CXX, NOT ALLOWED
All functions other than INIT AREA=CXX checks that they are executing on a system in the same Sysplex as the one on which the CXX was initialized and, if not, generates error message DB00912E and return code 47(008). This protection ensures that the GRS ENQ processing protects the data sets and actions being performed.
Specific DBUTLTY functions and their descriptions subject to the rule that MUF is required to not be enabled are as follows:
The INIT AREA=CXX function sets the CXX being built to be in the Simplify mode. If needed, the INIT AREA=CXX function must be the first of these functions that execute in the DBUTLTY step. The INIT AREA=CXX without Simplify recognizes an error if DATACOM=AD was specified and is reflected in the following message and error termination:
DB10057E - REQUIRES DBSIDPR SIMPLIFY YES
The INIT AREA=CXX function checks that the CXX has not been opened by a previous function. A violation of this rule is reflected by the following message and error termination.
DB10054E - FUNCTION REQUIRES xxx NOT TO BE OPEN
Exclusive ENQ protection of the CXX and also the DISP=OLD protection for the CXX is required. Both protections remain for the entire step.
This function expects to run with MUF not enabled. Therefore, the function SET OPTION1=MUF_NOT_ENABLED is not required. This function also effectively activates the SET option for the remainder of the DBUTLTY step.
Note: When running without Simplify mode, this function trusts that the user executes the function when and where appropriate. The function provides no protection that the data set being initialized is not currently in use by one or more MUF/DBUTLTY executions. The function provides no protection that the data set being initialized does not become in use during any point of the initialization or following functions by one or more MUF/DBUTLTY executions. If executed in error, there are a significant number of error conditions that are possible.
The LOAD AREA=CXX(no DBID=keyword) function restores the entire CXX from the backup. It does not restore the CXX name and does not alter the Simplify option from the current CXX. This function is normally used in the same DBUTLTY step as the INIT AREA=CXX immediately following. This function can execute in a step following the INIT AREA=CXX provided that the CXX has not been opened by a previous function in this step.
In all cases, the function only executes if the CXX is still empty from the INIT. If the function is not in the INIT AREA=CXX step, it checks that the CXX has not been opened by another function. A violation of this rule is reflected by the following message and error termination.
DB10054E - FUNCTION REQUIRES xxx NOT TO BE OPEN
Exclusive ENQ protection of the CXX and also the DISP=OLD protection for the CXX is required. Both protections remain for the entire step.
This function expects to run with MUF not enabled. Therefore, the function SET OPTION1=MUF_NOT_ENABLED is not required. This function also effectively activates the SET option for the remainder of the JCL stream.
The CXXCLONE function performs as a special case of LOAD AREA=CXX and has a similar set of rules.
When the DBID is not provided, this function restores the entire CXX from the backup. It does not restore the CXX name or alter the Simplify option from the current CXX. This function is normally used in the same DBUTLTY step as the INIT AREA=CXX immediately following. This function can execute in a step following the INIT AREA=CXX provided that the CXX has not been opened by a previous function in this step.
In all cases, the function only executes if the CXX is still empty from the INIT. If the function is not in the INIT AREA=CXX step, it checks that the CXX has not been opened by another function. A violation of this rule is reflected by the following message and error termination.
DB10054E - FUNCTION REQUIRES xxx NOT TO BE OPEN
Exclusive ENQ protection of the CXX and also the DISP=OLD protection for the CXX is required. Both protections remain for the entire step.
This function expects to run with MUF not enabled. Therefore, the function SET OPTION1=MUF_NOT_ENABLED is not required. This function also effectively activates the SET option for the remainder of the JCL stream.
Of special note, the CXXCLONE function accepts input as a backup of a Version 14.0 CXX and also a Version 12.0 CXX. This ability allows the migration of a single base or set of bases from Version 12.0 to Version 14.0 not using the CXXMAINT OPTION=CONVERT1214 ability that requires action for every base on the Version 12.0 backup provided.
The CXXMAINT OPTION=CONVERT1214 function loads the entire CXX from the Version 12.0 backup. However, it does not alter the CXX name or the Simplify option from the current CXX. This function must occur in the same DBUTLTY step as the INIT AREA=CXX and the CXX must still be empty from the INIT. This function can execute in a step following the INIT AREA=CXX provided that the CXX has not been opened by a previous function in this step and the CXX is still empty from the INIT function.
If the function is not in the INIT AREA=CXX step, it checks that the CXX has not been opened by another function. A violation of this rule is reflected by the following message and error termination.
DB10054E - FUNCTION REQUIRES xxx NOT TO BE OPEN
Exclusive ENQ protection of the CXX and also the DISP=OLD protection for the CXX is required. Both protections remain for the entire step.
This function expects to run with MUF not enabled. Therefore, the function SET OPTION1=MUF_NOT_ENABLED is not required. This function also effectively activates the SET option for the remainder of the JCL stream.
It executes under the rules of the DBSIDPR module. The function must be the first function to require access to the CXX because it checks that the CXX has not been opened by another function. A violation of this rule is reflected by the following message and error termination:
DB10054E - FUNCTION REQUIRES xxx NOT TO BE OPEN
Exclusive ENQ protection of the CXX and also the DISP=OLD protection for the CXX is required. Both protections remain for the entire step.
This function expects to run with MUF not enabled. Therefore, the function SET OPTION1=MUF_NOT_ENABLED is not required. This function also effectively activates the SET option for the remainder of the JCL stream.
The INIT AREA=LXX function initializes the LXX control area and checks that the LXX has not been opened by another function. A violation of this rule is reflected by the following message and error termination.
DB10054E - FUNCTION REQUIRES xxx NOT TO BE OPEN
Exclusive ENQ protection of the LXX and also the DISP=OLD protection for the LXX is required. Both protections remain for the entire step.
This function expects to run with MUF not enabled. Therefore, the function SET OPTION1=MUF_NOT_ENABLED is not required. This function also effectively activates the SET option for the remainder of the DBUTLTY step.
Note: When running without Simplify mode, this function trusts that the user executes the function when and where appropriate. The function provides no protection that the data set being initialized is not currently in use by one or more MUF/DBUTLTY executions. The function provides no protection that the data set being initialized does not become in use during any point of the initialization or following functions by one or more MUF/DBUTLTY executions. If executed in error, there are a significant number of error conditions that are possible.
The INIT AREA=FXX function initializes the FXX and checks that the FXX has not been opened by another function. A violation of this rule is reflected by the following message and error termination.
DB10054E - FUNCTION REQUIRES xxx NOT TO BE OPEN
Exclusive ENQ protection of the FXX and also the DISP=OLD protection for the FXX is required. Both protections remain for the entire step.
This function expects to run with MUF not enabled. Therefore, the function SET OPTION1=MUF_NOT_ENABLED is not required. This function also effectively activates the SET option for the remainder of the JCL stream.
Note: When running without Simplify mode, this function trusts that the user executes the function when and where appropriate. The function provides no protection that the data set being initialized is not currently in use by one or more MUF/DBUTLTY executions. The function provides no protection that the data set being initialized does not become in use during any point of the initialization or following functions by one or more MUF/DBUTLTY executions. If executed in error, there are a significant number of error conditions that are possible.
The RESET AREA=LXX function resets the LXX control area to be empty. It is rarely used and should be more rare with Simplify. If used, it must always be done with the MUF not enabled. The RESET AREA=CXX functions reset the CXX control area to have no DASD locking. The database is also reset to not be open and not load or unload. It is not needed if MUF is enabled. If used, it must always be done with the MUF not enabled.
This function checks that the LXX or CXX has not been opened by another function. A violation of this rule is reflected by the following message and error termination.
DB10054E - FUNCTION REQUIRES xxx NOT TO BE OPEN
Exclusive ENQ protection of the LXX or CXX and also the DISP=OLD protection for the LXX or CXX is required. Both protections remain for the entire step.
This function expects to run with MUF not enabled. Therefore, the function SET OPTION1=MUF_NOT_ENABLED is not required. This function also effectively activates the SET option for the remainder of the JCL stream.
Note: When running without Simplify mode, this function trusts that the user executes the function when and where appropriate. The function provides no protection that the data set being initialized is not currently in use by one or more MUF/DBUTLTY executions. The function provides no protection that the data set being initialized does not become in use during any point of the initialization or following functions by one or more MUF/DBUTLTY executions. If executed in error, there are a significant number of error conditions that are possible.
This SET option may only be executed if the DBUTLTY is not already connected to a MUF and has not already opened the Directory CXX. It has affect for the next function that requires the Directory CXX and ensures that MUF is not enabled and that the CXX is used locally. A violation of this rule is reflected by the following message and error termination.
DB10054E - FUNCTION REQUIRES xxx NOT TO BE OPEN
Exclusive ENQ protection of the CXX and also the DISP=OLD protection for the CXX is required. Both protections remain for the entire step.
For more information about messages, see the CA Datacom/DB Message Reference Guide.
|
Copyright © 2015 CA Technologies.
All rights reserved.
|
|