BBPARM member AAOPLX00 parameters
BBPARM member AAOPLX00 contains parameters, some of which you must modify, when you use the Rules Management application.
BBPARM member AAOPLX00
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:
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 PASes that share the same registry. This value must be 1 to 8-characters long. This name can contain only alphanumeric characters. No special characters are allowed. |
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. |
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:
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 MainView AutoOPERATOR 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 MainView AutoOPERATOR PAS opens the registry and allows you to perform administrative tasks, which the registry records. However, MainView AutoOPERATOR is not using the Rules from the registry for any automation in the PAS. Rules are read from the BBIPARM DD concatenation. FULL: the MainView AutoOPERATOR 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. The default is OFF. |
AGSLOG | (optional) specifies whether the MainView AutoOPERATOR Generalized Services (AGS) messages are sent to a logger Valid values are: YES: (recommended) messages are sent to a 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 a 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-from-classic-Rules. (PTF BQO3476 applied) | |
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, MainView AutoOPERATOR ignores the parameter during the PAS start (COLD or WARM):
Valid values are: NO (default) MainView AutoOPERATOR 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, MainView AutoOPERATOR issues an informational message to the PAS job log to remind you that the option exists. ENABLED When you specify ENABLED, MainView AutoOPERATOR 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, MainView AutoOPERATOR 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. MainView AutoOPERATOR 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 MainView AutoOPERATOR 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:
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 (.). MainView AutoOPERATOR 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 a pattern of: &SYSNAME..Rule.Pool.%p the resulting Rule pool name is SYSA.Rule.Pool.MVSAUTO 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: &SYSNAME.Setbase results in a setbase name of SYSASetbase. 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: GRP&SYSNAME results in a setbase group name of GRPSYSA. 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: &SYSNAME.PASDef results in a PASDef name of SYSAPASDef. 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: GRP&SYSNAME results in a PASDef group name of GRPSYSA. 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. |