Strobe Global Monitoring Address Space (MNAS) Commands

Stopping the Global Monitoring Address Space

When Strobeinitializes and the installation parameter GM_MONITOR is YES, Strobeautomatically starts the MNAS. To stop the MNAS, issue:

    STOP STRxMNAS

31704_Important_50x50_icon_25.png

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

Managing the Global Monitoring Environment

  • GM_DBUG: Enables/disables debugging messages used by Compuware Customer Solutions. This parameter is to be used at the direction of Compuware Customer Solutions 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 dataset 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*