Skip to Content

Rules Management registry export utility

 

Related topics

Utilities

(BMC.AMIOPS.SPE2510)

The Rules Management registry export utility in BBSAMP member AAOEXPRT, provides an EXEC that you can use to accomplish the following tasks:

  • Export and import the Rules Management registry definitions from one AOPLEX to another AOPLEX

    Use the AAOEXPRT EXEC to export the entire Rules registry or, select individual (or combination of) Rule Pools, Setbases, PASDefs, or Chained Rule Groups (CRG) without interrupting OpsA automation processing. The EXEC exports to a pre-allocated sequential data set that you can read and review before importing to another AOPLEX. 
     
  • Routine backup purposes

    You can also use the AAOEXPRT EXEC to easily review, and then edit and save the exported definitions. You can simply store these back up PDSs or, use them to populate a registry on another remote AOPLEX.
Information

The AAOEXPRT EXEC requires that OpsA is active on the same z/OS system where the EXEC is scheduled.

To implement the Registry export utility

  1. Copy the AAOEXPRT EXEC from the BBSAMP data set to the UBBPROC data set that is allocated to the SYSPROC concatenation of the OpsA PAS.
     
  2. Edit the user-modifiable section of the AAOEXPRT EXEC to modify the parameters to meet your needs.
     
  3. Schedule the AAOEXPRT EXEC in the OpsA PAS.  

    Review the OpsA Journal to ensure the export process was completed successfully. You can also schedule the AAOEXPRT EXEC from TSO or in TSO batch. If you are executing from TSO or TSO batch, check the TSO session or the SYSTSPRT output to ensure the export process completed successfully. After AAOEXPRT completes execution, the selected OpsA elements definitions will be exported and written to a newly generated EXEC.
     
  4. Review the generated EXEC and make additional modifications if necessary. 
     
  5. Schedule the generated EXEC from an OpsA PAS to import the exported definitions into another AOPLEX.

AAOEXPRT EXEC parameters

ParameterDescription
AOID=(OpsA_Pas_ID)

Specify the ID of the OpsA PAS to export registry definitions from

Valid values are 1 to 8 alphanumeric characters. 

You must specify either the AOID or AOPLEX parameter but do not specify both. These parameters are mutually exclusive.

AOPLEX=(AOPLEXName)

Specify the name of the AOPLEX to export from 

Valid values are 1 to 8 alphanumeric characters. 

You must specify either the AOID or AOPLEX parameter but do not specify both. These parameters are mutually exclusive.

GROUP=(groupName | * )

(optional) Specifies the group name for the exported items.

The default value is an asterisk (*), which means that all of the groups in the registry will be exported.

PASDEF=(PASDefName | * )

(optional) Specifies the PAS definition to to export definitions from.               

The default value is an asterisk (*), which means that all of the PASDefs in the registry will be exported.

      
You can specify the question park (?) as a masking wildcard character to represent a single character an asterisk (*) to represent zero or more characters.  Any PASDef name that matches the mask will be exported.

RULEPOOL=(RulePoolName |  * )

(optional) Specifies the Rule Pool and all its  included Rules will be exported

The default value is an asterisk (*), which means that all of the Rule Pools in the Registry will be exported. 

You can specify the question park (?) as a masking wildcard character to represent a single character or an asterisk (*) to represent zero or more characters.  Any Rule Pool name that matches the mask will be exported.

SETBASE=(SetbaseName)

(optional) Specifies the Setbase and all its Rule Sets will be exported 

The default value is an asterisk (*), which means that all of the Setbases in the Registry will be exported. 

You can specify the question park (?) as a masking wildcard character to represent a single character or an asterisk (*) to represent zero or more characters.  Any Setbase name that matches the mask will be exported.

CRG=(CRGName |  * )(optional) Specifies the Chained Rule Groups (CRG) to export definitions from.    

The default value is an asterisk (*), which means that all of the CRGs in the Registry will be exported. 

You can specify the question park (?) as a masking wildcard character to represent a single character or an asterisk (*)  to represent zero or more characters.  Any CRG name that matches the mask will be exported.
DSN=(dataSetName | userid.AAOEXPRT.EXEC)

(required) Specifies the fully qualified default data set name (DSN) of the pre allocated output partitioned (PDS or PDS/E) data set where the newly generated import EXEC will be added.

The DSN value defaults to userid.AAOEXPRT.EXEC.    

MBR=(memberName | IMPORT00)

(required) Specifies the member name to be given to the import EXEC generated by the AAOEXPRT EXEC .

If the member name already exists in the PDS/E, a warning message is issued.

If you also specify REUSE=Y, the member is overwritten otherwise, processing is terminated.

The member name defaults to IMPORT00. 

LOG=(ExportLog_dsn | userid.AAOEXPRT.LOG)

(required)  Specifies the fully qualified name of export log data set.

If an export log DSN is not already created, the EXEC creates the data set.  The DSN defaults to userid.AAOEXPRT.LOG.                       

REUSE=(Y | N)

(optional) Specify REUSE=Y to allow the specified MBR to be overwritten if it already exists in the PDS/E.

Specifying any other value will cause  processing to terminate if the specified MBR already exists in the PDS/E.

Valid values are Y or N.

The default value is N.    

VERBOSE=(Y | N)

(optional) Specify VERBOSE=Y so that more information about processed items will be written to the console.

Valid values are Y or N.

The default value is N.              

 

Tip: For faster searching, add an asterisk to the end of your partial query. Example: cert*

BMC AMI Ops Automation 8.4