Strobe Global Monitoring Address Space (MNAS) Commands

The Strobe SQL Agent (SSA) captures SQL when Strobe for Db2 is installed and active.

Stopping the Global Monitoring Address Space

When Strobe initializes and the installation parameter GM_MONITOR is YES, Strobe automatically starts the MNAS. To stop the MNAS, issue:

    STOP STRxMNAS

Warning

Unlike the SSA and the MSAS, when Strobe terminates, the MNAS is not shutdown.

Managing the Global Monitoring Environment

  • BATCHSTATS: Displays the number of ADD commands submitted and failed for both QUEUED and ACTIVE since the last start of the Global Monitor address space. If there wasn't an available subtask to process the ADD command, the number of such occurrences is also reported. Results are displayed in the MNAS STRDLOG as with the other STATS commands.Use this command to display how many ADD commands have been submitted as determined by the GM THRESHOLD parameters. High numbers can indicate thresholds for CPU and elapsed time may be too low. The maximum number of subtasks to process ADD commands is determined by the GM_THRESH_ACTION parameter and the Strobe MAXACT value up to a maximum of 30.

  • GM_DBUG: Enables/disables debugging messages used by BMC Support. This parameter is to be used at the direction of BMC Support only.

    • GM_DBUG=YES: Turn on debugging messages
    • GM_DBUG=NO: Turn off debugging messages
      MODIFY STRxMNAS,GM_DBUG=YES
  • PUMPSTATS < CURRENT >: Displays information about the buffers used by the Global Monitor data pump task as it moves from the source to the TCP buffers used to send data up to iStrobe.
    The data buffer sizes, number of each size, and counts used or unavailable are shown. Also shown are the size, number, and counts of TCP buffers used or unavailable. The types of SMF records received and processed are also shown, and a count of SMF records that exceeded 16K or the largest data buffer.
    If the CURRENT operand is not entered, the results are displayed in hexadecimal and represent amounts as of the previous end of day. If CURRENT is supplied, the results are displayed in decimal and represent amounts since 00:00:00.00 of the current day.
    All of the STATS processing is scheduled to run in the 59th minute of every hour and display results in decimal. The last interval at 23:59 updates the end-of-day counts and resets the current or daily counts.
    MODIFY STRxMNAS,PUMPSTATS
  • REFRESH: Refreshes the monitoring criteria from the Criteria data set after changes have been made using the GMLOAD utility.
    MODIFY STRxMNAS,REFRESH
  • RESTART: Restarts a component in the event of a failure.
    • RESTART BATCH: Restarts the Global Monitoring Batch component.
    • RESTART CICS: Restarts the Global Monitoring CICS component.
    • RESTART DATAPUMP: Restarts the Global Monitoring communications component.
    • RESTART IMS: Restarts the Global Monitoring IMS component.
      MODIFY STRxMNAS,RESTART BATCH

Managing the Global Monitoring Environment - CICS

  • CICSDISABLE: Turns off monitoring causing the GM CICS intercept to just return control to CICS. A specific job name must be provided.
  • CICSDISPLAY: Displays all CICS address spaces known to the MNAS, unless a specific JOB name is specified. For example, CICSDISPLAY CICSPROD.
  • CICSENABLE: Turns on monitoring in a CICS address space that was previously disabled using CICSDISABLE. The dormant intercept once again captures CICS task timings. A specific job name must be provided.
  • CICSPURGE: Removes the Global Monitor CICS intercept without disconnecting from the MNAS. All CICS address spaces will be purged if no specific job name is provided.
  • CICSSTART: Implants the Global Monitor CICS intercept in the CICS address space, and connects the address space to the MNAS.
  • CICSSTATS <CURRENT>: Displays the number of buckets of CICS transaction timings filled and passed to the pump task to be sent to the iStrobe SMF Manager for reporting, and the number of times a bucket could not be passed to the pump task for lack of a data buffer.
    Each bucket represents a unique transaction ID, the count of that transaction captured in the bucket, and the total CPU and response times for that number of transactions.
    Since each bucket represents a number of CICS transactions, the total count of transactions represented by the reported buckets is also displayed.
    If the CURRENT operand is not entered, the results are displayed in hexadecimal and represent amounts as of the previous end of day. If CURRENT is supplied, the results are displayed in decimal and represent amounts since 00:00:00.00 of the current day.
  • CICSSTOP: Removes the Global Monitor CICS intercept from the CICS address space, and the CICS address space is disconnected from the MNAS. A specific job name must be provided.
  • Example:
    MODIFY STRxMNAS,CICSDISABLE

Managing the Global Monitoring Environment - IMS

  • IMSDISPLAY: Displays information regarding the Global Monitoring IMS intercept. Unless a specific job name is specified, all IMS regions in which Global Monitoring is currently implanted are displayed.
  • IMSSTART: Implants the Global Monitoring IMS Intercept for the IMS region. Unless a specific job name is specified, the intercept is implanted in all IMS regions matching Global Monitoring selection criteria.
  • IMSSTATS <CURRENT>: Displays the number of buckets of IMS transaction timings filled and passed to the pump task to be sent to the iStrobe SMF Manager for reporting, and the number of times a bucket could not be passed to the pump task for lack of a data buffer.
    Each bucket represents a unique transaction ID, the count of that transaction captured in the bucket, and the total CPU and response times for that number of transactions.
    Since each bucket represents a number of IMS transactions, the total count of transactions represented by the reported buckets is also displayed.
    If the CURRENT operand is not entered, the results are displayed in hexadecimal and represent amounts as of the previous end of day. If CURRENT is supplied, the results are displayed in decimal and represent amounts since 00:00:00.00 of the current day.
  • IMSSTOP: Removes the Global Monitoring IMS intercept from the IMS region. Unless a specific job name is specified, the intercept is removed from all IMS regions in which it was implanted.
    Example:
    MODIFY STRxMNAS,IMSDISPLAY

Managing the Global Monitoring Environment - SMF

  • SMFX_ACT: Activates the Global Monitor EXITS routines for IEFU83 and IEFU84 when GM_SMFDATA=NO is set in the Global Monitor initialization parameters. It may also be necessary to execute this command if they were inactivated by the SMFX_INA command in order to run the SMF utility STRBGPUT, which requires GM_SMFDATA=NO. This and the SMFX_INA command allow altering GM_SMFDATA=YES||NO without having to restart the Global Monitor address space.
  • SMFX_DEF: Lists the status of SMF EXITS required by Global Monitor to capture STEP initialization (IEFUSI), termination (IEFACTRT), or SMF record capture (IEFU83 and IEFU84). Even if the Global Monitor EXITS routines were activated, they still may not get called depending on the EXITS subparameter coded in SMFPRMxx in SYS1.PARMLIB. This command looks for discrepencies between SYS(EXITS(...) and any SUBSYS(xxxx,EXITS(...)) in effect from the last IPL or execution of a SET SMF=xx command. This command is executed internally at Global Monitor initialization with results displayed in both the JESMSGLG and STRDLOG. If found, any discrepencies are reported on the STRGM0049E message.
  • SMFX_INA: Inactivates the Global Monitor EXITS routines for IEFU83 and IEFU84 when GM_SMFDATA=YES is set in the Global Monitor initialization parameters. It may also be necessary to execute this command if they were activated by the SMFX_ACT command in order to enable capturing live SMF data which requires GM_SMFDATA=YES. This and the SMFX_ACT command allow altering GM_SMFDATA=YES|NO without having to restart the Global Monitor address space.
  • SMFX_LIS: Lists the detailed state of all EXITS and associated routines utilized by Global Monitor to capture STEP initialization (IEFUSI), termination (IEFACTRT), or SMF record capture (IEFU83 and IEFU84). Even if the Global Monitor EXITS routines were activated, they still may not get called depending on the EXITS subparameter coded in SMFPRMxx in SYS1.PARMLIB. This command is executed internally at Global Monitor initialization with results displayed in the STRDLOG.
    Example:
    MODIFY STRxMNAS,SMFX_ACT

 

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