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.

BBPARM member AAOPLX00

Parameter name

Description

AO_NAME

     


(required) 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.

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

Example: AO_NAME=AGSPROD1


(PTF BQO2539 applied)

(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 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.

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 BBISSPxx.

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 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.

Note

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

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.

 

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