Creating MainView Logger BBPARM member MVINGIxx
Use BBPARM member MVINGINI as a model to create initialization parameters for the MainView Logger agent running in the DBC address space.
Note
- This task is required for all MainView products except MainView FOCAL POINT, to which it does not apply.
- MVINGIxx supports the use of system variables.
Use the following procedure to define the initialization parameters in BBPARM member MVINGIxx for the MainView Logger agent.
To create a BBPARM MVINGIxx member
- Copy BBPARM member MVINGINI to your UBBPARM data set.
- Specify the following parameters.
Parameter
Description
SYSP=(xx|xx, yy, zz...)
Specifies the 2-character suffixes of the LOGGERxx members that MainView Logger reads and initializes with Next Generation Logger (NGL). You can specify up to 10 LOGGERxx member suffixes, separated by commas. You must enclose the suffixes (even a single suffix) in parentheses ( ).
PARMDSN=[partitionedDataSetName]
(Optional) Specifies a partitioned data set (PDS) name that contains all of the LOGGERxx members that NGL processing reads and uses for logging. If you do not specify a value, MVI processing attempts to read values from all of the LOGGERxx members specified in the data set where BBPARM member MVINGIxx is located.
DBCID=DBCid
Identifies the DBC subsystem identifier (SSID) for the MainView Logger.
NGLID=PIID
Defines the NGL product instance identifier (PIID) that DBC processing uses to identify different NGL agents. You can specify only one PIID value with this parameter.
RETENTION=[120|xx]
Defines how long (in days) MainView Logger will keep the data since it was captured. The RETENTION parameter specifies the amount of time that the LOGSET should collect data. RETENTION controls both the number of log files that the NGL agent uses to record data and the number of log files that the NGL agent allocates during a LOGSET start.
NGL uses the RETENTION specification to insure that enough log files are allocated at LOGSET startup to cover the RETENTION period. The number of log files allocated is determined by the value specified on the DSMIN parameter and up to the greater of value specified by the DSMAX parameter (or the actual number of log files that are in the NGL registry).
If more log files are available from the NGL registry after the RETENTION period elapses, and the value specified by the DSMAX parameter is not yet reached, then NGL marks additional log files as candidates and allocates more log files to cover the RETENTION period.
The default value is 120 days.
DSMAX=10
Specifies the maximum number of data sets that comprise the LOGSET. The DSMAX parameter is used in conjunction with the RETENTION parameter to control the number of data sets allocated. If you do not specify a value for the RETENTION parameter, the DSMAX value defaults to the value specified in the DSMIN parameter.
Note:
- Do not change this value unless requested by BMC Support.
- The NGL agent uses the DSMAX and DSMIN parameters to allocate the LOGSET that is created from the LOGGERxx member LOGSPACE value (if specified).
The default value is 10. The DSMAX value must be greater than the value specified for the DSMIN parameter.
DSMIN=2|xx
Specifies the minimum number of data sets that comprise the LOGSET.
Note:
- Do not change this value unless requested by BMC support.
- The NGL agent uses the DSMAX and DSMIN parameters to allocate the LOGSET that is created from the LOGGERxx member LOGSPACE value (if specified).
The minimum value is 2. The default value is also 2. The DSMIN value must be less than the value specified for the DSMAX parameter.
SPACE=500|xxx
Specifies, in megabytes, how much space MVI allocates for the LOGSET and LOGSPACE.
The default value is 500 MB. BMC recommends that you allocate at least 500 MB.
ARCHIVE=YES/NO Enables (YES) or disables (NO) the archiving of NGL logs for all LOGGERxx members defined for the parameter, SYSP.
If no value is defined, the default is YES.
Comments
Log in or register to comment.