Global Monitoring Parameters
Detailed descriptions and default values for the parameters associated with using Global Monitoring with Strobe are provided below.
GM_MONITOR=NO
Description: Specifies whether to enable Global Monitoring. Valid values are YES and NO.
Default: NO
GM_BATCH=YES
Description: Implements Global Monitoring Batch functionality. Valid values are YES or NO.
Default: YES
GM_CICS=YES
Description: Implements Global Monitoring functionality for CICS transactions. Valid values are YES or NO.
Default: YES
GM_IMS=NO
Description: Implements Global Monitoring functionality for IMS transactions. Valid values are YES or NO.
Default: NO
GM_SMFDATA=YES
Description: Specifies that SMF Data is to be collected and sent to iStrobe. Valid values are YES or NO.
Default: YES
GM_SMFREC=(30,70,100,113)
Description: Specifies the SMF record types to be collected and sent to iStrobe. Valid values are 30, 70, 100, and 113:
- SMF record type 30 represents the Common address space work.
- SMF record type 70 represents the RMF processor activity.
- SMF record type 100 represents Db2 statistics.
- SMF record type 113 represents the hardware capacity, reporting, and statistics.
If not otherwise specified, all defined record types (30,70,100,113) are collected and sent to iStrobe.
Default: (30,70,100,113)
MNASPROCNAME=STRBMNAS
Description: Specifies the Global Monitoring Address Space (MNAS) startup procedure name. If you change the value STRBMNAS here in the Strobe PARMLIB member, you must also change it to match in the Strobe allocation configuration member $07ALSTR.
Default: STRBMNAS
GM_LIMIT=QUIT
Description: Sets the LIMIT parameter on any measurements that are submitted by Global Monitoring.
Default: QUIT
GM_GOMIN=1
Description: Specifies the Global Monitoring Batch GOMIN value in minutes to be used when issuing the Add Active measurement request for a monitored job that exceeds thresholds. Valid values are 1 to 10.
Default: 1
GM_CRITERIA_DSN=
Description: Specifies the Global Monitoring Criteria dataset name. This parameter is the name you used for hlq.STRGMCRI when you initialized the Global Monitoring criteria dataset.
Default: None
GM_REPOSITORY_DSN=
Description: Specifies the high-level qualifier for the dataset names of the two repository datasets. These are the names you used for hlq.GMRPSTRY when you initialized the Global Monitoring repository datasets. GM_REPOSITORY_DSN must be specified for Global Monitoring to be enabled.
The value specified for GM_REPOSITORY_DSN will be appended with the character S plus the four-character SMF system ID of the z/OS image on which Strobe is executing, and F1 and F2.
For example, if the parameter specifies hlq.GMRPSTRY and the SMF system ID is AAAA, the names of the repository datasets will be hlq.GMRPSTRY.SAAAA.F1 and hlq.GMRPSTRY.SAAAA.F2. The value specified for GM_REPOSITORY_DSN cannot exceed 38 characters.
Default: None
GM_MAXNUM=1000
Description: Specifies the maximum number of job steps to monitor. Valid values are 10 to 999999.
Default: 1000
GM_MIN_AVG=10
Description: Specifies the minimum number of entries to be used in the calculation of the rolling average. Valid values are 1 to 30.
Default: 10
GM_ROLLING_AVG=30
Description: Specifies the number of times Global Monitor repository entries are saved. Global Monitor creates repository entries on matches with the selection criteria. The entry is written to the repository when MNAS shuts down or every 5 minutes. The entry is saved in the repository the number of times specified by GM_ROLLING_AVG. Subsequent data exceeding the GM_ROLLING_AVG is saved by overwriting the original data. The earlier entries are discarded. Valid values are 1 to 30.
Default: 30
GM_MIN_CPU=300
Description: Specifies the minimum CPU time in seconds in the format nnnn (for example, 0010). When the job exceeds either the internal average CPU or average elapse by the thresholds indicated by the GM_CPU_THRESH=50 or GM_ELAPSE_THRESH=50 parameters, Global Monitoring Batch will initiate the process of beginning a measurement. As Strobe Global Monitoring executes the process of beginning a measurement, it will perform a check against this parameter value and the GM_MIN_ELAPSE= parameter value. If neither CPU nor Elapsed time exceeds the minimums, the add measurement phase will be skipped. Valid values are 0001 to 9999.
Default: 300
GM_CPU_THRESH=50
Description: Specifies the threshold percentage by which CPU time must exceed the calculated CPU threshold in order to initiate a Strobe measurement. When the CPU time of a running monitored job exceeds the calculated threshold by this percentage, a Strobe measurement is initiated. Valid values are 1 to 100.
Default: 50
GM_MIN_ELAPSE=600
Description: Specifies the minimum Elapsed time in seconds in the format nnnn (for example, 0010). When the job exceeds either the internal average CPU or average elapse by the thresholds indicated by the GM_CPU_THRESH=50 or GM_ELAPSE_THRESH=50 parameters, Global Monitoring Batch will initiate the process of beginning a measurement. As Strobe Global Monitoring executes the process of beginning a measurement, it will perform a check against this parameter value and the GM_MIN_CPU= parameter value. If neither Elapsed nor CPU time exceeds the minimums, the add measurement phase will be skipped. Valid values are 0001 to 9999.
Default: None
GM_ELAPSE_THRESH=50
Description: Specifies the threshold percentage by which elapsed time must exceed the calculated elapsed time threshold in order to initiate a Strobe measurement. When elapsed time of a running monitored job exceeds the calculated threshold by this percentage, a Strobe measurement is initiated. Valid values are 1 to 100.
Default: 50
GM_NOTIFY=
Description: Specifies a TSO user ID to notify when a measurement initiated by Global Monitoring is complete.
Default: None
GM_JC1, GM_JC2, GM_JC3, and GM_JC4=
Description: Specifies the job cards for Global Monitoring autoprofile JCL. Each card must begin and end with double quotes (“) to allow correct parsing of special characters between those delimiters. These parameters must be specified for Global Monitoring to be enabled.
Default: None
GM_SQLAF_EXPLAIN=NO
Description: Specifies whether to enable SQL explain. Valid values are YES or NO.
Default: NO
GM_SQLAF_STATISTICS=NO
Description: Specifies whether to enable SQL statistics. GM_SQLAF_EXPLAIN=YES is required to enable statistics. Valid values are YES or NO.
Default: NO
GM_SQLAF_TRANSLATION=NO
Description: Specifies whether to enable SQL translation. GM_SQLAF_EXPLAIN=YES is required to enable translation. Valid values are YES or NO.
Default: NO
GM_SQLAF_OBSERVATIONS=NO
Description: Specifies whether to enable SQL observations. GM_SQLAF_EXPLAIN=YES is required to enable observations. Valid values are YES or NO.
Default: NO
GM_SQLAF_STMTCNT=10
Description: Specifies the number of statements, Explain, Translation, Observation, and Statistics data will be generated for. GM_SQLAF_EXPLAIN=YES is required for statement count to take effect. Valid values are 10-99.
Default: 10
GM_SQLAF_AUTHID=
Description: Specifies the Owner to use when looking for plan tables. Global Monitor will use the MNAS (STRBMNAS) by default. GM_SQLAF_EXPLAIN=YES is required to enable AUTHID.
Default: None
GM_THRESH_ACTION=BOTH
Description: Specifies which type of add request is be used by Global Monitor when a threshold is exceeded. Valid values are ACTIVE, QUEUED, or BOTH.
Default: BOTH
GM_SHRDIR_DSN=
Description: Specifies the DDIO share directory/database or DDIO source listing file is to be used to enable Source Support. The MNAS (STRBMNAS) must have access to the shared directory or DDIO file for Source Support to work.
Default: None