Modifying #PMOPT Parameters

 
idms19
 
The installation program generates #PMOPT, a configurable macro that specifies runtime options for Performance Monitor. This macro cannot be modified during installation. 
 
 
2
 
2
 
 
Syntax
►►── #PMOPT AMACT= ──┬─ YES ─┬─ ,AMDCLOG= ─┬─ YES ─┬─────────────────────────► └─ NO ──┘ └─ NO ──┘ ►──┬──────────────────────┬─────────────────────────────────────────────────► └─ ,AMSMF= ─┬─ YES ──┬─┘ └─ NO ◄──┘ ►──┬──────────────────────────────────┬─────────────────────────────────────► └─ ,AMSMFSZ= ─┬─ 8180 ◄──────────┬─┘ └─
smf-block-size
─┘ ►──┬───────────────────────────────────┬────────────────────────────────────► └─ ,DBKMAX= ─┬─ 5 ◄ ──────────────┬─┘ └─
db-keys-per-task
─┘ ►──┬────────────────────────┬───────────────────────────────────────────────► └─ ,DCSTATS= ─┬─ YES ──┬─┘ └─ NO ◄──┘ ►──┬────────────────────────────┬───────────────────────────────────────────► └─ ,DLGNAME= ─┬─ SCREEN ◄──┬─┘ └─ FIRST ────┘ ►──┬──────────────────────────────────┬─────────────────────────────────────► └─ ,ENTMAX= ─┬─ 50 ◄─────────────┬─┘ └─
maximum-entries
─┘ ►── ,IMACT= ─┬─ YES ─┬──────────────────────────────────────────────────────► └─ NO ──┘ ►── ,IMDCLOG= ─┬─ YES ─┬────────────────────────────────────────────────────► └─ NO ──┘ ►──┬──────────────────────┬─────────────────────────────────────────────────► └─ ,IMSMF= ─┬─ YES ──┬─┘ └─ NO ◄──┘ ►──┬──────────────────────────────────┬─────────────────────────────────────► └─ ,IMSMFSZ= ─┬─ 8180 ◄──────────┬─┘ └─
smf-block-size
─┘ ►──┬─────────────────────────────────────┬──────────────────────────────────► └─ ,INTVMAX= ─┬─ 20 ◄───────────────┬─┘ └─
maximum-intervals
─┘ ►──┬─────────────────────────────────┬──────────────────────────────────────► └─ ,INTVSIZ= ─┬─ 10 ◄───────────┬─┘ └─
interval-size
─┘ ►──┬────────────────────────────────────┬───────────────────────────────────► └─ ,LIBMAX= ─┬─ 10 ◄───────────────┬─┘ └─
libraries-tracked
─┘ ►──┬───────────────────────────────────┬────────────────────────────────────► └─ ,OCCRMAX= ─┬─ 50 ◄─────────────┬─┘ └─
maximum-records
─┘ ►──┬─────────────────────────────────┬──────────────────────────────────────► └─ ,SMFRCID= ─┬─ 230 ◄──────────┬─┘ └─
smf-record-id
─┘ ►──┬────────────────────────┬───────────────────────────────────────────────► └─ ,SMFHEDR= ─┬─ YES ◄──┬─┘ └─ NO ──┘ ►──┬────────────────────────┬───────────────────────────────────────────────► └─ ,SMFTYP4= ─┬─ YES ──┬─┘ └─ NO ◄──┘ ►──┬────────────────────────┬───────────────────────────────────────────────► └─ ,SMFTY30= ─┬─ YES ──┬─┘ └─ NO ◄──┘ ►──┬───────────────────────────┬────────────────────────────────────────────► └─ ,TERMINL= ─┬─ LTERM ◄──┬─┘ └─ ACCMETH ─┘ ►──┬────────────────────────┬───────────────────────────────────────────────► └─ ,TSKWAIT= ─┬─ YES ──┬─┘ └─ NO ◄──┘ ►──┬─────────────────────────────┬──────────────────────────────────────────►◄ └─ ,IMREFT= ─┬─ 2400 ◄────────┤ └─
refresh-time
─┘
Parameters
Following is the list of parameters for the #PMOPT macro:
  •  
    AMACT=YES/NO
    Required.  Specifies whether the Application Monitor is activated automatically when the DC/UCF system is started. If you specify YES, Performance Monitor continuously captures task statistics regardless of the status of the Application Monitor's online component.
    Default:
     None
  •  
    AMDCLOG=YES/NO
    Required: Specifies whether information collected by the Application Monitor should be written to the system log area. If you specify NO, Application Monitor statistics can be viewed online only.
    Default:
     None
    : If you specify AMDCLOG=NO and you want the information to be available for batch reporting, you must specify AMSMF=YES
  • .
    AMSMF=YES/NO
    (z/OS only). Specifies whether information collected by the Application Monitor should be written to the SMF job accounting file. If you specify YES, you must include the SMFRCID parameter. If you specify NO and want data available for batch reports, you must also specify AMDCLOG=YES.
    Default:
     NO
  •  
    AMSMFSZ=8180/
    smf-block-size
     
    (z/OS only).  Specifies the maximum number of bytes in Application Monitor SMF statistics blocks (1024-32764). The default is 8180. This parameter is applicable only if AMSMF=YES.
  •  
    DBKMAX=5/
    db-keys-per-task
     
    Specifies the number of db-keys the Interval Monitor should track (0-20). This parameter is applicable only if IMACT=YES.
    Default:
     5
  •  
    DCSTATS=YES/NO
    Specifies whether the standard DC task statistics block should be written to the DC/UCF system log area.
    If you specify YES, the standard DC statistics block, as well as Performance Monitor statistics records, is written to the log at task termination.
    Default:
     NO
  •  
    DLGNAME=
    Specifies which CA ADS dialog is recorded by the Application Monitor as the program name.
    •  
      SCREEN
      Specifies to use the name of the dialog that issues the mapout request. The name of the dialog last loaded is used for the task code, and the option is displayed as LAST in the Application Monitor options screen.
      Default:
       SCREEN
    •  
      FIRST
      Specifies to use the name of the first (high level) dialog.
  •  
    ENTMAX=50/
    maximum-entries
     
    The maximum number of entities that are monitored online by the Application Monitor at any given time (0-1,000).
    Default:
     50
  •  
    IMACT=YES/NO
    Required. Specifies whether the Interval Monitor is activated automatically when the DC/UCF system is started.
    Default:
     None
  •  
    IMDCLOG=YES/NO
    Required. Specifies whether information collected by the Interval Monitor is to be written to the DC/UCF system log area. If you specify NO, Interval Monitor statistics can be viewed online only.
    Default:
     None
     If you specify IMDCLOG=NO, and you want the information to be available for batch reporting, you must specify IMSMF=Yes.
  •  
    IMSMF=YES/NO
    (z/OS only).  Specifies whether information collected by the Interval Monitor should be written to the SMF job accounting file. If you specify NO, and want the information available for batch reporting, you must specify IMDCLOG=YES.
    Default:
     NO
  •  
    IMSMFSZ=8180/
    smf-block-size
     
    (z/OS only) The number of bytes in Interval Monitor SMF statistics blocks (1,024-32,764). This parameter is applicable only if IMSMF=YES.
    Default:
     8,180
  •  
    INTVMAX=20/
    maximum-intervals
     
    The maximum number of intervals maintained by the online component of the Interval Monitor. Once the maximum number is reached during processing, the system wraps to begin overwriting with the earliest interval.
    If you specify 0, the online component of the Interval Monitor is unavailable.
    Default:
     20
    Limits:
      0 to 1,000
  •  
    INTVSIZ=10/
    interval-size
     
    The number of minutes in each interval maintained by the Interval Monitor (5-1,440). The default is 10.
    Default:
     10
    Limits:
     5 to 1,440
  •  
    LIBMAX=10/
    libraries-tracked
     
    The number of libraries (CDMSLIB, CDMSL
    nnn
    , and so forth) the Interval Monitor should maintain.
    Default:
     10
    Limits:
     0 to 1,000
     
    z/VSE users
    : z/VSE sites should specify either 1 or 0. 0 indicates that no library statistics are to be maintained.
  •  
    OCCRMAX=50/
    maximum-records
     
    The default number of statistics records accumulated by the Application Monitor for each monitored entity (0-9999).
    If you specify 0, the online component of the Application Monitor is unavailable.
    Default:
     50
  •  
    SMFRCID=230/
    smf-record-id
     
    (z/OS only) The SMF user record ID for Interval Monitor and Application Monitor statistics records written to the SMF file (128-255). The default is 230. This parameter is applicable only if IMSMF=YES or AMSMF=YES.
    Default:
     230
    Limits:
     128 to 255
  •  
    SMFHEDR=YES/NO
     
    (z/OS only) Specifies whether a CA IDMS Performance Monitor header is appended to SMF Type 4 and Type 30 records that are created and written to the SMF file. When the field is set to “YES,” SMF Type 4 and 30 record IDs match the value set in the SMFRCID parameter. This parameter is applicable only if AMSMF=YES and SMFTYP4 and/or SMFTYP30=YES.
    Default:
     YES
  •  
    SMFTYP4=YES/NO
    (z/OS only) Specifies whether Type 4 SMF records (step termination records) are created and written to the SMF file. This parameter is applicable only if AMACT=YES.
    Default:
     NO
  •  
    SMFTYP30=YES/NO
    (z/OS only) Specifies whether Type 30 SMF records (step termination records) are created and written to the SMF file. This parameter is applicable only if AMACT=YES.
    Default:
     NO
  •  
    TERMINL=LTERM/ACCMETH
    Specifies whether the Application Monitor tracks the logical terminal or the access method for use in LTERM ID fields.
    Default:
     LTERM.
  •  
    TSKWAIT=YES/NO
    Specifies whether task-wait statistics should be collected. The statistics are written to the log area if you specify AMDCLOG=YES.
    Default:
     NO
    : Statistics are written to the SMF job accounting file if you specify AMSMF=YES.
  •  
    IMREFT=
    refresh-time
     
    The time, in the format 
    hhmm
     (24-hour clock), to initialize the Interval Monitor data collection buckets. Initialization is performed at the end of the interval in which the specified time falls.