IBM Z APM Connect IMS Data Producer Operator Commands

Edit online

You can use operator commands to control IMS Data Producer.

Commands are sent to the Base Dispatcher by using z/OS® system console command:
  • For IMS regions: F proc,AGMI <imsid> command
  • For IMS Connect: F proc,AGMI <IMSCONNECT> command
where command is the command to execute; and <imsid> is the four-character IMS ID for IMS regions and <IMSCONNECT> is the jobname for IMS Connect, for example,
  • For IMS regions, /F AGMAPROC,AGMI <imsid> DBUGFLAG
  • For IMS Connect, /F AGMAPROC,AGMI <IMSCONNECT> DBUGFLAG

Command to turn on bits

DBUGFLAG is an 8-bit flag. A zero value turns off a 1-bit flag and a one turns on a 1-bit flag. IBM Support might request specific bits to be turned on for debugging purposes.

  • Command examples to turn off the bit flag:
    • /F AGMAPROC,AGMI <imsid> DBUGFLAG
    • /F AGMAPROC,AGMI <imsid> DBUGFLAG 0
  • Command examples to turn on one or several bits:
    • /F AGMAPROC,AGMI <imsid> DBUGFLAG 1
    • /F AGMAPROC,AGMI <imsid> DBUGFLAG 11110000
      This command turns on the first 4-bit flags and turns off the last 4-bit flags.
The DBUGFLAG command dynamically turns on or off the AGMSYSIN parameter AGMZDIAGLEVEL. DBUGFLAG zero or blank turns off AGMZDIAGLEVEL. DBUGFLAG with any bit on turns on AGMZDIAGLEVEL.
Note: This value of AGMZDIAGLEVEL must be changed only under direction of IBM® service personnel to avoid excessive console messages.

Commands to turn on/off all IMS and IMS Connect transaction tracking

New IMS Data Producer commands have been implemented to turn off all IMS and IMS Connect transaction tracking. This does not remove the Z APM Connect configured environment but will reduce CPU consumption and collection of data for transaction reporting.

Individual Database data collection can be deactivated or disabled for IMS DL/I databases, Db2 and/or IMS FastPath databases.

IMS Data Producer has added IMS critical path Abend protection. If an abend occurs, appropriate action will be taken to complete the transaction, keep it from being stopped and keep IMS up and operational. After 10 abends in a zAPM Connect IMS DataBase (DB) Exit, it is disabled. If IMS Data Producer recovery and SVCDUMP is on, then an SVC dump is produced on the first abend detected. Recovery is on by default and can be controlled by a new AGMI Base command RECOVERY ON/OFF.

 Commands to turn on/off recovery 

RECOVERY ON/OFF/SVCOFF commands:
  • ON - Set RECOVERY ON (Default) in IMS region
  • OFF - Set RECOVERY OFF in IMS Region
  • SVCOFF - Set SVCDUMP OFF in IMS Region
  • Command example to turn on recovery, clear the abends message counts and set all SVCDUMP flags on:
    /F AGMAPROC,AGMI <imsid> RECOVERY ON
  • Command example to turn off recovery:
    /F AGMAPROC,AGMI <imsid> RECOVERY OFF
  • Command example to turn off SVCDUMP:
    /F AGMAPROC,AGMI <imsid> RECOVERY SVCOFF

 Commands to turn on/off APM Monitoring 

ENABLE/DISABLE commands:
  • ENABLE - Enable APM Monitoring for IMS region or IMS Connect processing (default)
  • DISABLE - Disable APM Monitoring for IMS region or IMS Connect processing
  • Command example to enable APM Monitoring in IMS (imsid) region:
    /F AGMAPROC,AGMI <imsid> ENABLE
  • Command example to disable APM Monitoring in IMS (imsid) region:
    /F AGMAPROC,AGMI <imsid> DISABLE
  • Command example to enable APM Monitoring in IMS Connect (jobname):
    /F AGMAPROC,AGMI <IMSCONNECT> ENABLE
  • Command example to disable APM Monitoring in IMS Connect (jobname):
    /F AGMAPROC,AGMI <IMSCONNECT> DISABLE
Option:
  • Exclusively for IMS Region:
    DB2 - ENABLE APM Monitoring in IMS DB2 and reset DB2 recovery message count 
    - DISABLE APM Monitoring in IMS DB2 

    DBF - ENABLE APM Monitoring in IMS Fast Path DB and reset DBF recovery message count
    - DISABLE APM Monitoring in IMS Fast Path DB 

    DBI - ENABLE APM Monitoring in IMS DB and reset DBI recovery message count
    - DISABLE APM Monitoring in IMS DB
    • Command examples to enable APM Monitoring in a particular database exit routine and reset its recovery message count:
      • /F AGMAPROC,AGMI <imsid> ENABLE DB2
      • /F AGMAPROC,AGMI <imsid> ENABLE DBF
      • /F AGMAPROC,AGMI <imsid> ENABLE DBI
    • Command examples to disable APM Monitoring in a particular database exit routine:
      • /F AGMAPROC,AGMI <imsid> DISABLE DB2
      • /F AGMAPROC,AGMI <imsid> DISABLE DBF
      • /F AGMAPROC,AGMI <imsid> DISABLE DBI
  • For IMS Region:

    ALL – ENABLE/DISABLE APM Monitoring ALL (APM + DB2 + DBF + DBI)

    ENABLE ALL command turns on APM monitoring and monitoring of all 3 database exit routines: AGMDB2, AGMDBF, and AGMDLA and it also sets all recovery counters to zero.
    • Command example to enable APM Monitoring and monitoring of all 3 database exit routines and reset all recovery counters:
      /F AGMAPROC,AGMI <imsid> ENABLE ALL
    • Command example to disable APM Monitoring and monitoring of all 3 database exit routines:
      /F AGMAPROC,AGMI <imsid> DISABLE ALL
    • For IMS Connect:

      ALL – ENABLE/DISABLE APM Monitoring in IMS Connect.

      • Command example to enable APM Monitoring in all 3 database exit routines and reset all recovery counters:
        /F AGMAPROC,AGMI <IMSCONNECT> ENABLE ALL
      • Command example to disable APM Monitoring in IMS Connect:
        /F AGMAPROC,AGMI <IMSCONNECT> DISABLE ALL

 Command to display the APM Monitoring status 

STATUS command shows the status of APM Monitoring for IMS Connect or IMS region.
  • Command example for IMS Region:
    /F AGMAPROC,AGMI <imsid> STATUS
    F AGMAPROC,AGMI <imsid> STATUS
AGMZ0004I AGMZ - AGMI IMSA STATUS
AGMI0006I AGMZ STATUS FOR IMSA: IMS MONITORING, ENABLED. 
AGMI0007I AGMZ IMS MONITORING FOR DEDB/MSDB ON, SVC DUMP ON.
AGMI0007I AGMZ IMS MONITORING FOR DLI ON, SVC DUMP OFF.
AGMI0004I AGMZ IMS MONITORING FOR RECOVERY ON.
AGMI0007I AGMZ IMS MONITORING FOR DB2: READY, ON, SVC DUMP ON.
  • Command example for IMS Connect:
    /F AGMAPROC,AGMI <IMSCONNECT> STATUS
    F AGMAPROC,AGMI IMSACON STATUS
AGMZ0004I AGMZ - AGMI IMSACON STATUS
AGMI0006I AGMZ STATUS FOR IMSACON: IMS CONNECT MONITORING, ENABLED.

Command response examples

  • Status command defaults at IMS and ZAPM startup.
    /F AGMAPROC,AGMI IF1C STATUS
    AGMZ0004I AGMJ - AGMI IF1C STATUS
AGMI0006I AGMJ STATUS FOR IF1C : IMS MONITORING, ENABLED. 
AGMI0007I AGMJ IMS MONITORING FOR DEDB/MSDB ON, SVC DUMP ON.
AGMI0007I AGMJ IMS MONITORING FOR DLI  ON, SVC DUMP  ON.
AGMI0004I AGMJ IMS MONITORING FOR RECOVERY ON.
AGMI0007I AGMJ IMS MONITORING FOR DB2: READY, ON, SVC DUMP ON.
  • Z APM Exit Abend reported 10 times before being turned off.
    AGMI1202E ABEND S00C1 DETECTED IN MODULE AGMDLA00 AT OFFSET 0000097C
R4=19C52178 R13=19C52010 CNT=0001             

AGMI1202E ABEND S00C1 DETECTED IN MODULE AGMDBF00 AT OFFSET 000005E8
R4=19C52200 R13=19C52010 CNT=0001
  • SVC Dump only on first abend with DUMP title created.
    DUMP TITLE=ABEND S00C1-AGMDB200-IMSF10-HAPM610-20201104-08.43  
           OFFSET 0000048C                  

DUMP TITLE=ABEND S00C1-AGMDBF00-IMSF10-HAPM610-20201104-08.43  
           OFFSET 000005E8
  • Dump complete messages and STATUS command issued after abend. DL/I SVC Dump creation was turned off after first abend.
    IEF196I IEF285I   SYSl.TVT6057.DMP00105                                                                      CATALOGED
IEF196I IEF285I   VOL SER NOS = T60575. 
IEA611I COMPLETE DUMP ON SYSl.TVT6057.DMP00105 446 
DUMPID=105 REQUESTED BY JOB (IMSOCF16)
FOR ASID (0030)
INCIDENT TOKEN: PLEX57   TVT6057  10/09/2020 14:52:28
F CYTJZAPM, AGMI IF1C STATUS
AGMZ0004I AGMJ - AGMI IF1C STATUS
AGMI0006I AGMJ STATUS FOR IF1C: IMS MONITORING, ENABLED. 
AGMI0007I AGMJ IMS MONITORING FOR DEDB/MSDB ON, SVC DUMP ON.
AGMI0007I AGMJ IMS MONITORING FOR DLI ON, SVC DUMP OFF.
AGMI0004I AGMJ IMS MONITORING FOR RECOVERY ON.
AGMI0007I AGMJ IMS MONITORING FOR DB2: READY, ON, SVC DUMP ON.
  • Issue RECOVERY Command to turn off all SVC Dumping
    F CYTJZAPM,AGMI IFlC RECOVERY SVCOFF
AGMZ00O4I AGMJ - AGMI IFlC RECOVERY SVCOFF
AGMI0004I AGMJ RECOVERY FOR IFlC SVC DUMP OFF.
F CYTJZAPM,AGMI IFlC STATUS
AGMZ0004I AGMJ - AGMI IFlC STATUS
AGMI0006I AGMJ STATUS FOR IFlC: IMS MONITORING, ENABLED.
AGMI0007I AGMJ IMS MONITORING FOR DEDB/MSDB ON, SVC DUMP OFF.
AGMI0007I AGMJ IMS MONITORING FOR DLI ON, SVC DUMP OFF.
AGMI0004I AGMJ IMS MONITORING FOR RECOVERY ON.
AGMIO007I AGMJ IMS MONITORING FOR DB2: READY, ON, SVC DUMP OFF