Skip to Content

BMCUTIL report

The BMCUTIL report contains information about BMC products that are currently running or started. These products use the table in this report to control the use of utility IDs. Each product must have a unique utility ID for restart purposes. If you have more than one product installed, they should all share the same BMCUTIL table. For information about producing this report, see NGTDISP-command.

If you enter UNMATCHEDUIDS, the following reports display all unmatched utility IDs in the system. Unmatched utility IDs are utility IDs that exist in either the BMCUTIL report or the checkpoint data set, but not in both.

  • BMCUTIL UNMATCHEDUIDS report—Displays a list of utility IDs that appear in the BMCUTIL report but not in the checkpoint data set
  • CHECKPOINT UNMATCHED report—Displays a list of utility IDs that appear in the checkpoint data set but not in the BMCUTIL report

Related topics

NGTDISP report columns

SYSIN-syntax-option-description

Sample BMCUTIL report

 UTILITY           UTILITY                              USER      START                                     TERMED        
 ID                TYPE      STATUS  PHASE     RESTART  ID        TIMESTAMP             JOB NAME  JOB ID    STATUS
 ----------------  --------  ------  --------  -------  --------  --------------------  --------  --------  -------
 RGAWM18           NGTDISP   X       UTILEXEC  N        MVSAWM    2024-01-12-04.54.55.  RGAWM18   J0808317          
 RGDSP13           NGTDISP   X       UTILEXEC  N        MVSAWM    2023-11-20-05.01.44.  RGDSP13   J0239169          
 RGDSP14           NGTDISP   X       UTILEXEC  N        MVSAWM    2023-11-20-05.01.44.  RGDSP13   J0239169          
 RGRRG13           NGTREORG  S       UTILSTOP  N        MVSREG1   2024-01-11-22.43.57.  RGRRG13   J0784479          
 RGRRG14           NGTREORG  S       UTILSTOP  N        MVSAWM    2024-01-10-03.22.35.  RGRRG14   J0784511                                                                                              

(BMC.DB2.SPE2404)

Sample BMCUTIL UNMATCHED report

 UTILITY           UTILITY                              USER      START                                     TERMED        
 ID                TYPE      STATUS  PHASE     RESTART  ID        TIMESTAMP             JOB NAME  JOB ID    STATUS
 ----------------  --------  ------  --------  -------  --------  --------------------  --------  --------  -------
 RGDSP13           NGTDISP   X       UTILEXEC  N        MVSAWM    2023-11-20-05.01.44.  RGDSP13   J0239169  NO      
 RGDSP14           NGTDISP   X       UTILEXEC  N        MVSAWM    2023-11-20-05.01.44.  RGDSP13   J0239169  NO                                                                                            

The TERMED STATUS column is populated only when you specify UNMATCHEDUIDS on the NGTDISP command for BMCUTIL.

Entering the NGTDISP BMCUTIL UNMATCHEDUIDS TERMBMCUTIL command has the following results:

  • TERMED STATUS is set to YES.
  • Unmatched entries are successfully deleted from the BMCUTIL and BMCUTIL2 tables.

BMCUTIL report column values

Column name

Data type

Description

UTILID

CHAR(16)

Utility identifier

TYPE

CHAR(8)

Type of the executing product:

  • CHECK
  • COPY
  • STATS
  • LOAD
  • NGT
  • RECOVER
  • REORG
  • UNLOAD

STATUS

CHAR(1)

Execution status of the product:

  • A (active, not executing command)
  • I (initializing)
  • P (pausing or pause-stopped)
  • S (stopped)
  • T (terminating)
  • X (executing command)

PHASE

CHAR(8)

Current phase of the product

RESTART

CHAR(1)

Restart option:

  • N (not restart)
  • P (RESTART(PHASE))
  • Y (RESTART)

ID

CHAR(8)

User ID running the product

START TIMESTAMP

TIMESTAMP

Starting time stamp of the product

CHAR(8)

Name of the active job, whether initial job or restart

CHAR(8)

ID of the active job, whether initial job or restart

(BMC.DB2.SPE2407)TERMED STATUS

CHAR(3)

Termed options:

  • NO  - Unmatched entry is not termed (entries not removed from BMCUTIL/BMCSYNC)
  • YES - Unmatched entry is termed
  • ERR - An error occurred attempting to TERM the unmatched entry

 

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

BMC AMI Check for Db2 13.1