Newer version of documentation BMC provides a newer version of the documentation for this version of the product. As a result, BMC no longer accepts comments in this space.BMC recommends upgrading to the latest version of the product. To see documentation for that version, see bao8301.

BBPARM member AAOPLX00 parameters


BBPARM member AAOPLX00 contains parameters, some of which you must modify, when you use the Rules Management application.

Note

This member supports system variables substitution. For more information, see System-variables-substitution-in-parameter-library-members.

Parameter name

Description

AO_NAME

(optional) Provides the name to identify this PAS within the AOPlex

This name is used when identifying the PAS in the Valid PAS List (VPL) and in AGS messages and reports.

The default value is the target name from the TYPE=MVS entry in the BBIJNT00 member for this PAS, also known as the MVAO service point. In addition, the name must also be:

  • Unique within the AOPLEX.
  • 1 to 8-alphanumeric characters and national characters:    
    • Dollar sign ($)
    • Pound sign (#)
    • At sign (@)
Example

AO_NAME=AGSPROD1

Using the default value (the PAS target name) might simplify the configuration of multiple PASes that share the same registry in an AOPlex configuration.         

AOPLEX_NAME

(required) Provides the name of the AOPlex to which this PAS belongs

This name must be the same for all BMC AMI Ops Automation PASes that share a rules registry. In addition, this value must be unique to the AOPlex and cannot be the same value as any TOMPLEX_NAME value.

This name can contain only alpha or numeric characters. No special characters are allowed.


Example

AOPLEX_NAME=AOPLEX01

AOPLEX_XCF_GROUP

(required) Provides the name of the XCF group that the AOPlex will use to communicate

This name must be the same for all PASes that share the same registry dataset.

This value must be 1 to 8-characters long. This name can contain only alphanumeric characters. No special characters are allowed.

This value cannot be the same as AOPLEX_NAME and cannot be the same XCF group name specified in the XCFGROUP= parameter in BBPARM member BBISSPx.

Example

AOPLEX_XCF_GROUP=AOPLXCF1

REGISTRY_DSN

(required) Is the data set name of the linear VSAM data set allocated for use by this AOPlex.

This value can be 1 to 44 characters long.

REGISTRY_WARNHWM

(optional) Is the Registry high-water-mark percentage warning message threshold

If specified with a non-zero value, the AGSRY0014W warning message is issued when the percentage of the Registry space that is formatted for use exceeds the value and either of the following situations is true:

  • The PAS is being initialized
  • The registry high-water-mark has increased at least one percent since the last time the AGSRY0014W message was issued and one minute has passed since the last AGSRY0014W was issued.

Specifying a value of 0 means that no monitoring will be done and no messages are issued.

This value can be 0 to 99. If you do not specify a value, the default value is 0.

USAGE_MODE_RULES

(required) Informs the PAS how to use the registry

Valid values are:

OFF: The BMC AMI OpsA PAS will not use a registry for Rules in any way. Rules Management is not functioning for the PAS. Rules are read from the BBIPARM DD concatenation.

ADMIN: The BMC AMI OpsA PAS opens the registry and allows you to perform administrative tasks, which the registry records. However, BMC AMI OpsA is not using the Rules from the registry for any automation in the PAS. Rules are read from the BBIPARM DD concatenation.

FULL: The BMC AMI OpsA PAS uses the Rules from the registry, allows you to perform adinistrative tasks on the registry, and also reads from the registry to supply all the Rules and Rule Sets for automation in the PAS. No Rules are used from the BBIPARM DD concatenation and the full-screen Rules editor is disabled.

Note

When switching to FULL mode, you must perform a COLD start of the PAS to access all of the Rules from the registry.

(PTF BQO3985 applied) You can use the AOPLEXP view to change the USAGE_MODE_RULES parameter setting from ADMIN to FULL, without requiring that you perform a restart of the BBI-SS PAS.

The default is OFF.

AGSLOG

(optional) Specifies whether the BMC AMI OpsA Generalized Services (AGS) messages are sent to the BMC AMI Ops Infrastructure Logger

Valid values are:

YES: (recommended) Messages are sent to the Logger. If the Logger becomes unavailable for any reason, and AGSJRNL=NO and FORCEWTO=NO are also specified, the value on the AGSLOG_FAILOVER parameter determines what happens to the message.

NO: Messages are not be sent to the Logger

AGSLOG_FAILOVER

(optional) Specifies what happens to AGS messages when AGSLOG=YES, FORCEWTO=NO, and AGSJRNL=NO are specified and the Logger is not available

Valid values are:

JRNL: Send the message to the BBI-SS journal. JRNL is the default.

WTO: Send the message as a WTO to the PAS JES joblog.

NONE: Do not write any messages to any destination

FORCEWTO

(optional) Specifies whether AGS product messages are sent to the PAS JES job log

Valid values are:

YES: Messages are sent to the PAS JES job log.

NO: Messages are not sent to the PAS JES job log. NO is the default.

AGSJRNL

(optional) Specifies whether AGS product messages are sent to the BBI-SS journal

Valid values are:

YES: Messages are sent to the BBI-SS journal.

NO: Messages are not sent to the BBI-SS journal. NO is the default.

FORCE_CLASSIC_RSNAMES

(optional) Specifies whether Rule Sets created in the registry by the user address space (UAS) follow the classic Rule Set naming that requires the name to start with RUL or AAORUL

Valid values are:

YES: The names of Rule Sets created in the registry by the UAS are restricted to a Rule Set naming standard and the Rule Set name must begin with RUL or AAORUL. This ensures these Rule Sets can be exported and used in a BBPARM data set without a registry. YES is the default.

NO: The names of Rule Sets created in the registry by the UAS are not restricted to start to begin with RUL or AAORUL. Therefore, these Rule Sets cannot be used as BBPARM Rule Sets even if you export them and place them in a valid BBPARM data set unless you manually rename them to use RUL and AAORUL.

AUDIT_STARTUP_RULESETS

(optional) Causes message AGSIA4050I to be generated to the PAS syslog during a PAS COLD start to list the rulesets that the PAS will use and is similar to the PROCESS LIST= parameter in BBPARM member AOPRMxx

Valid values are:

YES: Produce the AGSIA4050I message(s) during PAS COLD start.

NO: Do not produce the AGSIA4050I message(s) during PAS COLD start.

Edit the following parameters when you use the AutoLoad process to migrate classic Rules to Rules Management Rules. For more information, see Migrating-Rules-to-Rules-Management-application.

AUTOLOAD_REGISTRY

(optional) Specifies whether an empty registry in the PAS and running in ADMIN mode is automatically loaded (initialized) with Rules and Rules Sets from the local BBPARM data set

There are two prerequisites to use the AUTOLOAD_REGISTRY parameter. If both conditions are not met, BMC AMI OpsA ignores the parameter during the PAS start (COLD or WARM):

  • The PAS must be running in ADMIN mode where the parameter USAGE_MODE_RULES=ADMIN is specified.
  • The PAS registry must be a newly defined VLDS that is empty and has never been used in any other PAS startup since it was last defined by VSAM.

Valid values are:

  • NO (default) BMC AMI OpsA will not attempt to initialize an empty Rules registry, even if all the conditions are met.
    If you specify NO, and the other conditions criteria are met, BMC AMI OpsA issues an informational message to the PAS job log to remind you that the option exists.
  • ENABLED When you specify ENABLED, BMC AMI OpsA loads the Rule Sets that are currently in ENABLED status in the local PAS into the registry and designates these Rule Sets (and only these Rule Sets) ENABLED for subsequent COLD starts of the PAS when USAGE_MODE_RULES=FULL is specified.

    This group of Rule Sets might or might not match the Rule Sets specified on the RULESET= parameter in the AAOPRMxx member used when the PAS was last started COLD. It is also possible that Rule Sets might have been manually ENABLED or DISABLED since the last COLD start. In addition, BMC AMI OpsA does not load the Rule Sets that are in TEST or LOADED status when you specify ENABLED.

  • COLDSTART Specify this option when you want to load the Rule Sets that were used when the PAS was last started COLD. BMC AMI OpsA loads only the Rule Sets that are specified with the RULESET= parameter in the AAOPRMxx member. This group of Rule Sets might or might not match the Rule Sets specified on the RULESET= parameter in the AAOPRMxx member when this PAS was last started COLD. If you made any changes to the RULESET= parameter after the last COLD start, there will be a difference in the Rule Sets BMC AMI OpsA loads between COLD starts. Be sure to verify that the Rule Sets listed in the current AAOPRMxx member are the Rule Sets that you want to load.

  • ALL Specifies the following actions:
    • Imports all of the Rule Sets that are specified in the local PAS's BBIPARM DDname concatenation
    • Sets any Rule Sets specified in RULESET= found in AAOPRMxx as ENABLED

Only Rule Sets that are a member of the PASDef used for the PAS are eligible for use in the local PAS.     

AUTOLOAD_RULEPOOL

(optional) Overrides the default naming pattern that is used for the Rule pool names used during AutoLoad processing

By default, the Rule pools are named using a pattern of:                                             

%p.RULE.POOL 

where <%p> is substituted with the name of the Rule Set (and so on).

When you specify % within the name (and not at the end of the name), you must separate it with a period (.). BMC AMI OpsA resolves the value as a node in the name and includes the period.                                        

For example, if you have a Rule Set named MVSAUTO and you use the default pattern, the resulting Rule pool name is MVSAUTO.RULE.POOL.

You can use this parameter to override the default pattern by specifying a new pattern. The derived name, after all substitutions, must not exceed 32 characters. The pattern can include constants, MVS symbolic symbols (starting with an ampersand (&)), and the private symbol <%p>.    

For example, if you have a Rule Set named MVSAUTO. &SYSNAME is set to SYSA, and specify the following pattern, the resulting Rule pool name is SYSA.Rule.Pool.MVSAUTO:                                                 

&SYSNAME..Rule.Pool.%p

This optional parameter is used if the AUTOLOAD_REGISTRY= parameter does not specify NO. In other cases, the value is parsed and accepted but is not used.                           

AUTOLOAD_SETBASE_NAME

(optional) Overrides the default value of the name portion for the Setbase ID used during AutoLoad processing

By default, the name portion of the setbase ID is:

DEFAULT.Setbase                                                 

Use this parameter to override the default value by specifying a new value.  The value, after all substitutions, must not exceed 32 characters. The pattern can include constants and MVS symbolic symbols (starting with an ampersand (&)).                                                 

For example, if the system symbol &SYSNAME is set to SYSA, specifying the following results in a setbase name of SYSASetbase.   :                   

&SYSNAME.Setbase              

This optional keyword is used if the AUTOLOAD_REGISTRY= parameter does not specify NO. In all other cases, the value is parsed and accepted but is not used. 

AUTOLOAD_SETBASE_GRP_NAME

(optional) Overrides the default value of the group name portion of the Setbase ID used during AutoLoad processing                                        

By default, the group name portion of the setbase ID is:                                     

DEFAULT

Use this parameter to override the default value by specifying a new value.  The value, after all substitutions, must not exceed 8 characters. The pattern can include constants and MVS symbolic symbols (starting with an ampersand (&)).              

For example, if the system symbol &SYSNAME is set to SYSA, specifying the following results in a setbase group name of GRPSYSA.:                    

GRP&SYSNAME

This optional keyword is used if the AUTOLOAD_REGISTRY= parameter does not specify NO. In all other cases, the value is parsed and accepted but is not used. 

AUTOLOAD_PASDEF_NAME

(optional) Overrides the default value of the name portion of the PASDef ID used during AutoLoad processing.                                       

By default, the name portion of the PASDef ID is:

DEFAULT.PASDef 

Use this parameter to override the default value by by specifying a new value.  The value, after all substitutions, must not exceed 32 characters. The template can include constants and MVS symbolic symbols (starting with an ampersand (&)).

For example, if the system symbol is set to SYSA, specifying the following results in a PASDef name of SYSAPASDef.:

&SYSNAME.PASDef

This optional keyword is used if the AUTOLOAD_REGISTRY= parameter does not specify NO. In all other cases, the value is parsed and accepted but is not used. 

AUTOLOAD_PASDEF_GRP_NAME

(optional) Overrides the default value of the group name portion of the PASDef ID used during AutoLoad processing                                       

By default, the group name portion of the PASDef ID is:                                     

DEFAULT Use this parameter to override the default value by by specifying a new value. The value, after all substitutions, must not exceed 8 characters. The value can include constants and MVS symbolic symbols (starting with an ampersand (&).         

For example, if the system symbol is set to SYSA, specifying the following results in a PASDef group name of GRPSYSA.:                  

GRP&SYSNAME

This optional keyword is used if the AUTOLOAD_REGISTRY= parameter does not specify NO. In all other cases, the value is parsed and accepted but is not used. 

 

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