@broadcom/mat-analyze-for-zowe-cli 3.0.1 → 4.0.0

package/README.md

@@ -11,7 +11,7 @@ You can use the MAT Analyze plug-in for Zowe CLI to perform the following tasks:
 - Analyze the measurement data.  
   Access the measurement data from Mainframe Application Tuner that is available to you in the CLI in the form of MAT analysis views.
 - Address performance issues.  
-  With the source program listing registered with MAT, users of Visual Studio Code (VS Code) IDE can obtain the Histogram details and display specific source program locations that are associated with the most resource-consuming program modules and CSECTs. When you request the Histogram measurement details from your VS Code command line terminal, the MAT Analyze plug-in for Zowe CLI transfers the source code listing to your local machine and navigates you directly to the specific line and column number of the source code, which enables you to immediately inspect the program statement and identify possible tuning opportunities.
+  With the source program listing registered with MAT, users of Visual Studio Code (VS Code) IDE can obtain the Histogram measurement details and display specific source program locations that are associated with the most resource-consuming program modules and CSECTs. When you request the Histogram measurement details from your VS Code command line terminal, the MAT Analyze plug-in for Zowe CLI transfers the source code listing to your local machine and navigates you directly to the specific line and column number of the source code, which enables you to immediately inspect the program statement and identify possible tuning opportunities.
 
 # Table of Contents
 
@@ -32,33 +32,39 @@ You can use the MAT Analyze plug-in for Zowe CLI to perform the following tasks:
     - [delayview](#delayview)
     - [delay | de](#delay--de)
     - [address | ad](#address--ad)
-    - [codeview](#codeview)
-    - [module | mod](#module--mod)
-    - [csect | cs](#csect--cs)
-  - [histogram | hsg](#histogram--hsg)
-  - [callerid | cil](#callerid--cil)
-  - [db2](#db2)
-  - [db2view | db2](#db2view--db2)
-  - [sqlstmt | sql](#sqlstmt--sql)
-  - [idms](#idms)
-    - [dml | dml](#dml--dml)
-    - [module | mod](#idms)
-    - [task | ts](#task--ts)
-  - [ims](#ims)
-    - [dbdname | dbd](#dbdname--dbd)
-    - [imsview | imsv](#imsview--imsv)
-    - [psbname | psb](#psbname--psb)
-    - [region | reg](#region--reg)
-    - [ssa | ssa](#ssa--ssa)
-    - [statement | stat](#statement--stat)
-  - [tranview](#tranview)
-    - [all | all](#all--all)
-    - [module | mod](#tranview)
-    - [callerid | cid](#callerid--cid)
-    - [callstack | csk](#callstack--csk)
-    - [csect | csd](#csect--csd)
-    - [delay | dl](#delay--dl)
-    - [stat | cis](#stat--cis)
+    - [adabas | ada](#adabas--ada)
+    - [CODEVIEW](#codeview--cv)
+      - [module | mod](#module--mod)
+      - [csect | cs](#csect--cs)
+      - [natural | nat](#natural--nat)
+      - [ideal | idl](#ideal--idl)
+      - [callerid | cil](#callerid--cil)
+      - [histogram](#histogram)
+        - [csect | cs](#histogram_csect--cs)
+        - [ideal | idl](#histogram_ideal--idl)
+        - [natural | nat](#histogram_natural--nat)
+    - [db2](#db2)
+    - [db2view | db2](#db2view--db2)
+    - [sqlstmt | sql](#sqlstmt--sql)
+    - [idms](#idms)
+      - [dml | dml](#dml--dml)
+      - [module | mod](#idms)
+      - [task | ts](#task--ts)
+    - [ims](#ims)
+      - [dbdname | dbd](#dbdname--dbd)
+      - [imsview | imsv](#imsview--imsv)
+      - [psbname | psb](#psbname--psb)
+      - [region | reg](#region--reg)
+      - [ssa | ssa](#ssa--ssa)
+      - [statement | stat](#statement--stat)
+    - [tranview](#tranview)
+      - [all | all](#all--all)
+      - [module | mod](#tranview)
+      - [callerid | cid](#callerid--cid)
+      - [callstack | csk](#callstack--csk)
+      - [csect | csd](#csect--csd)
+      - [delay | dl](#delay--dl)
+      - [stat | cis](#stat--cis)
 - [Uninstall the MAT Analyze Plug-in for Zowe CLI](#uninstall-the-mat-analyze-plug-in-for-zowe-cli)
 
 # Installation
@@ -69,8 +75,9 @@ You can install the MAT Analyze Plug-in for Zowe CLI from the Zowe Package.
 
 Before starting the installation of the MAT Analyze Plug-in for Zowe CLI, verify that you have:
 
-- Zowe CLI installed.
+- Zowe version 3 (Zowe CLI version 8.x) is installed. 
 - MAT database and the REST API installed, configured, and running.
+> **Note:** To use the updated CLI commands, you must first upgrade the MAT REST API to the latest version by applying MAT PTF with the latest REST API updates. This applies to all updated and new commands in this release.
 - (Optional) To use the automated listing registration and retrieval option through Endevor® footprints, install and configure the Endevor® Web Services and specify the Endevor® web server details in the MAT database configuration.
 
 ## Install the MAT Analyze Plug-in for Zowe CLI From Packages
@@ -330,10 +337,6 @@ Values: a comma separated list of up to 3 values is allowed, max. 64 characters
 `--schedule` _(string)_  
 Specifies the name of the schedule that you want to apply to the monitor profile (maximum 8 characters).
 
-**Profile Options**  
-`--mat-profile` | `--mat-p` _(string)_  
-Specifies the name of a (mat) profile to load for this command execution.
-
 **Examples**
 
 - Create the PROFILE1 monitor profile to measure job JOB1 that runs on the AA31 system:
@@ -393,10 +396,6 @@ Values: maximum 12 characters, numbers only (0-9). If you use this parameter for
 `--listing` _(boolean)_  
 Activates automated registration of Cobol, C/C++, and Assembler program listings through Endevor® footprints. After completion of the measurement that you invoke with the '--listing' parameter, the MAT Analyze plug-in for Zowe CLI automatically retrieves the program listing that is associated with the monitored job and registers the listing with MAT. A registered program listing enhances the analysis possibilities of the 'codeview histogram' command and enables you to inspect the source code statements that are associated with specific modules and CSECTs.
 
-**Profile Options**  
-`--mat-profile` | `--mat-p` (string)  
-The name of a (mat) profile to load for this command execution.
-
 **Examples**
 
 - Invoke the PROFILE1 monitor profile to measure job JOB1 that runs on the AA31 system:
@@ -433,10 +432,6 @@ Get the list of available monitor profiles.
 $ zowe mat profile list [options]
 ```
 
-**Profile Options**  
-`--mat-profile` | `--mat-p` _(string)_  
-The name of a (mat) profile to load for this command execution.
-
 ## MONITOR
 
 The commands from the MONITOR group enable you to get monitor history and measurement analysis data from MAT.
@@ -463,10 +458,6 @@ $ zowe mat monitor history [options]
 `--profile` _(string)_  
 Specifies the name of the profile.
 
-**Profile Options**  
-`--mat-profile` | `--mat-p` _(string)_  
-The name of a (mat) profile to load for this command execution.
-
 **Examples**
 
 - Get the list of all available measurements that are stored in the history of the monitor profile TESTPROF:
@@ -498,10 +489,6 @@ Specifies the name of the profile that you want to analyze. When you specify the
 `--mon_num` _(number)_  
 Specifies the unique monitor number of the measurement.
 
-**Profile Options**  
-`--mat-profile` | `--mat-p` _(string)_  
-The name of a (mat) profile to load for this command execution.
-
 **Examples**
 
 - Get the measurement overview details for monitor number 5:
@@ -553,10 +540,6 @@ Specifies the name of the profile that you want to analyze. When you specify the
 `--mon_num` _(number)_  
 Specifies the unique monitor number of the measurement.
 
-**Profile Options**  
-`--mat-profile` | `--mat-p` _(string)_  
-The name of a (mat) profile to load for this command execution.
-
 **Examples**
 
 - Get the DelayView measurement details for monitor number 5:
@@ -595,36 +578,69 @@ Specifies the name of the profile that you want to analyze. When you specify the
 Specifies the unique monitor number of the measurement.
 
 `--majorcategory` _(string)_  
-Specifies the major delay category name identified for the analysis item (e.g. `–-majorcategory "PC routine delay"`). You get the majorcategory value from the 'delayview delay' command response.
+Specifies the major delay category name identified for the analysis item (e.g. `--majorcategory "PC routine delay"`). You get the majorcategory value from the 'delayview delay' command response.
 
 `--minorcategory` _(string)_  
-Specifies the minor delay category name identified for the analysis item (e.g. `–-minorcategory "PC CALL"`). You get the minorcategory value from the 'delayview delay' command response.
-
-**Profile Options**  
-`--mat-profile` | `--mat-p` _(string)_  
-The name of a (mat) profile to load for this command execution.
+Specifies the minor delay category name identified for the analysis item (e.g. `---minorcategory "PC CALL"`). You get the minorcategory value from the 'delayview delay' command response.
 
 **Examples**
 
 - Get the delay address details for majorcategory "PC routine delay" and minorcategory "PC CALL" for monitor number 5:
 
 ```
-$ zowe mat monitor delayview address --mon_num 5 –-majorcategory "PC routine delay" –-minorcategory "PC CALL"
+$ zowe mat monitor delayview address --mon_num 5 --majorcategory "PC routine delay" --minorcategory "PC CALL"
 ```
 
 - Get the delay address details for majorcategory "PC routine delay" and minorcategory "PC CALL" for the latest monitor in the TESTPROF profile:
 
 ```
-$ zowe mat monitor delayview address --profile TESTPROF –-majorcategory "PC routine delay" –-minorcategory "PC CALL"
+$ zowe mat monitor delayview address --profile TESTPROF --majorcategory "PC routine delay" --minorcategory "PC CALL"
 ```
 
 - Get the delay address details for majorcategory "PC routine delay" and minorcategory "PC CALL" for monitor number 5, with the specific MAT profile details defined:
 
 ```
-$ zowe mat monitor delayview address --mon_num 5 –-majorcategory "PC routine delay" –-minorcategory "PC CALL" --host "example.com" --port 12345 --user johndoe --password qwerty
+$ zowe mat monitor delayview address --mon_num 5 --majorcategory "PC routine delay" --minorcategory "PC CALL" --host "example.com" --port 12345 --user johndoe --password qwerty
+```
+
+### adabas | ada
+
+Get the Adabas measurement details.
+
+**Usage**
+
+```
+$ zowe mat monitor adabas [options]
 ```
 
-### codeview
+**Options**  
+`--profile` _(string)_  
+Specifies the name of the profile that you want to analyze. When you specify the profile name, you get the data for the latest measurement within the specified profile.
+
+`--mon_num` _(number)_  
+Specifies the unique monitor number of the measurement.
+
+**Examples**
+
+- Get the Adabas measurement details for monitor number 5:
+
+```
+$ zowe mat monitor adabas --mon_num 5
+```
+
+- Get the Adabas measurement details for the latest monitor in the TESTPROF profile:
+
+```
+$ zowe mat monitor adabas --profile TESTPROF
+```
+
+- Get the Adabas measurement details for monitor number 5, with the specific MAT profile details defined:
+
+```
+$ zowe mat monitor adabas --mon_num 5 --host "example.com" --port 12345 --user johndoe --password qwerty
+```
+
+### codeview | cv
 
 The commands from the CODEVIEW group enable you to get the CodeView measurement details.
 
@@ -653,10 +669,6 @@ Specifies the name of the profile that you want to analyze. When you specify the
 `--mon_num` _(number)_  
 Specifies the unique monitor number of the measurement.
 
-**Profile Options**  
-`--mat-profile` | `--mat-p` _(string)_  
-The name of a (mat) profile to load for this command execution.
-
 **Examples**
 
 - Get the CodeView measurement details in Module mode for monitor number 5:
@@ -679,7 +691,7 @@ $ zowe mat monitor codeview module --mon_num 5 --host "example.com" --port 12345
 
 #### csect | cs
 
-Get the CodeView measurement details in Csect mode.
+Get the CodeView measurement details in CSECT mode.
 
 **Usage**
 
@@ -694,38 +706,34 @@ Specifies the name of the profile that you want to analyze. When you specify the
 `--mon_num` _(number)_  
 Specifies the unique monitor number of the measurement.
 
-**Profile Options**  
-`--mat-profile` | `--mat-p` _(string)_  
-The name of a (mat) profile to load for this command execution.
-
 **Examples**
 
-- Get the CodeView measurement details in Csect mode for monitor number 5:
+- Get the CodeView measurement details in CSECT mode for monitor number 5:
 
 ```
 $ zowe mat monitor codeview csect --mon_num 5
 ```
 
-- Get the CodeView measurement details in Csect mode for the latest monitor in the TESTPROF profile:
+- Get the CodeView measurement details in CSECT mode for the latest monitor in the TESTPROF profile:
 
 ```
 $ zowe mat monitor codeview csect --profile TESTPROF
 ```
 
-- Get the CodeView measurement details in Csect mode for monitor number 5, with the specific MAT profile details defined:
+- Get the CodeView measurement details in CSECT mode for monitor number 5, with the specific MAT profile details defined:
 
 ```
 $ zowe mat monitor codeview csect --mon_num 5 --host "example.com" --port 12345 --user johndoe --password qwerty
 ```
 
-#### histogram | hsg
+#### natural | nat
 
-Get the Histogram details for the measurement.
+Get the CodeView measurement details in Natural mode.
 
 **Usage**
 
 ```
-$ zowe mat monitor codeview histogram [options]
+$ zowe mat monitor codeview natural [options]
 ```
 
 **Options**  
@@ -735,49 +743,64 @@ Specifies the name of the profile that you want to analyze. When you specify the
 `--mon_num` _(number)_  
 Specifies the unique monitor number of the measurement.
 
-`--module` _(string)_  
-Specifies the module name that you request the Histogram data for. You get the module value from the 'codeview csect' or from the 'codeview module' command response. The module name can be empty (e.g., --module "IGZCPAC" or --module '""').
+**Examples**
 
-`--csect` _(string)_  
-Specifies the CSECT name that you request the Histogram data for. You get the csect value from the 'codeview csect' command response. The CSECT name can be empty (e.g., --csect "TUNCOB01" or --module '""').
+- Get the CodeView measurement details in Natural mode for monitor number 5:
 
-`--top` _(number)_  
-Specifies the maximum number of the top consuming CSECT activity locations that you want to obtain in the response (e.g., --top 5). If you specify --top 0, you get the list of all CSECT activity locations that MAT has detected during the measurement. The --top parameter is optional. Values: numbers between 0 and 300.
+```
+$ zowe mat monitor codeview natural --mon_num 5
+```
 
-`--group` _(number)_  
-Specifies the histogram group size parameter that defines the resolution of the histogram. If you do not specify the group parameter, the group size defaults to 4 bytes (e.g., --group 32). If program listing is registered with MAT, the group parameter is ignored. The --group parameter is optional.
+- Get the CodeView measurement details in Natural mode for the latest monitor in the TESTPROF 
+  profile:
 
-`--listing` _(boolean)_  
-Enables you to retrieve program listing details that pertain to the specific CSECT and statement. To use the listing retrieval option, you must install and configure the Endevor® Web Services and have the program listing for the specific measurement registered with MAT. The source code listing is retrieved through Endevor® footprints for Cobol, C/C++, and Assembler programs. The program listing file is downloaded to your local directory that you specified with the 'listingDir' parameter for your MAT configuration profile. When you request the histogram details with the '--listing' option, the 'histogram' command returns the additional 'listing' column that contains a reference to the program listing with the specific CSECT name, program type, line and column number that pertain to the requested CSECT and statement, for example, c:\listings\SA420LE.asm:382:51. If you use Visual Studio Code (VS Code) IDE, you can click on the reference in the command response in your VS Code terminal to navigate directly to the indicated source program location. The --listing parameter is optional.
+```
+$ zowe mat monitor codeview natural --profile TESTPROF
+```
 
-**Profile Options**  
-`--mat-profile` | `--mat-p` _(string)_  
-The name of a (mat) profile to load for this command execution.
+- Get the CodeView measurement details in Natural mode for monitor number 5, with the specific MAT 
+  profile details defined:
 
-**Examples**
+```
+$ zowe mat monitor codeview natural --mon_num 5 --host "example.com" --port 12345 --user johndoe 
+--password qwerty
+```
 
-- Get the Histogram details with the group size defaulting to 4 bytes for monitor number 5, CSECT name TUNCOB01, module name RUNCOB:
+#### ideal | idl
+
+Get the CodeView measurement details in Ideal mode.
+
+**Usage**
 
 ```
-$ zowe mat monitor codeview histogram --mon_num 5 --csect "TUNCOB01" --module "RUNCOB"
+$ zowe mat monitor codeview ideal [options]
 ```
 
-- Get the Histogram details for the latest monitor in the TESTPROF profile for CSECT name TUNCOB01, empty module name, with the group size value set to 32 bytes, and limit the number of returned rows to 5 top consumers:
+**Options**  
+`--profile` _(string)_  
+Specifies the name of the profile that you want to analyze. When you specify the profile name, you get the data for the latest measurement within the specified profile.
+
+`--mon_num` _(number)_  
+Specifies the unique monitor number of the measurement.
+
+**Examples**
+
+- Get the CodeView measurement details in Ideal mode for monitor number 5:
 
 ```
-$ zowe mat monitor codeview histogram --profile TESTPROF --csect "TUNCOB01" --module '""' --top 5 --group 32
+$ zowe mat monitor codeview ideal --mon_num 5
 ```
 
-- Get the Histogram details for monitor number 5, CSECT name TUNCOB01, and module name RUNCOB, limit the number of returned records to 5 top consumers, and request the listing details:
+- Get the CodeView measurement details in Ideal mode for the latest monitor in the TESTPROF profile:
 
 ```
-$ zowe mat monitor codeview histogram --mon_num 5 --csect "TUNCOB01" --module "RUNCOB" --top 5 --listing
+$ zowe mat monitor codeview ideal --profile TESTPROF
 ```
 
-- Get the Histogram details with the group size defaulting to 4 bytes for monitor number 5, CSECT name TUNCOB01, module name RUNCOB, with the specific MAT profile details defined:
+- Get the CodeView measurement details in Ideal mode for monitor number 5, with the specific MAT profile details defined:
 
 ```
-$ zowe mat monitor codeview histogram --mon_num 5 --csect "TUNCOB01" --module "RUNCOB" --host "example.com" --port 12345 --user johndoe --password qwerty
+$ zowe mat monitor codeview ideal --mon_num 5 --host "example.com" --port 12345 --user johndoe --password qwerty
 ```
 
 #### callerid | cil
@@ -803,10 +826,6 @@ Specifies the module name that you request the CallerID details for. You get the
 `--csect` _(string)_  
 Specifies the CSECT name that you request the CallerID details data for. You get the csect value from the 'codeview csect' command response. The CSECT name can be empty (e.g., --csect "TUNCOB01" or --csect '""').
 
-**Profile Options**  
-`--mat-profile` | `--mat-p` _(string)_  
-The name of a (mat) profile to load for this command execution.
-
 **Examples**
 
 - Get the CallerID details for monitor number 5, CSECT name TUNCOB01, and module name RUNCOB:
@@ -827,6 +846,177 @@ $ zowe mat monitor codeview callerid --profile TESTPROF  --csect "TUNCOB01" --mo
 $ zowe mat monitor codeview callerid --mon_num 5 --csect "TUNCOB01" --module "RUNCOB" --host "example.com" --port 12345 --user johndoe --password qwerty
 ```
 
+#### histogram
+
+The commands from the HISTOGRAM group enable you to get the Histogram measurement details.
+
+**Usage**
+
+```
+$ zowe mat monitor codeview histogram <command>
+```
+
+The following **commands** are available for the HISTOGRAM group:
+
+##### histogram_csect | cs
+Get the Histogram measurement details in CSECT mode.
+
+**Usage**
+
+```
+$ zowe mat monitor codeview histogram csect [options]
+```
+
+**Options**  
+`--profile` _(string)_  
+Specifies the name of the profile that you want to analyze. When you specify the profile name, you get the data for the latest measurement within the specified profile.
+
+`--mon_num` _(number)_  
+Specifies the unique monitor number of the measurement.
+
+`--module` _(string)_  
+Specifies the module name that you request the Histogram data for. You get the module value from the 'codeview csect' or from the 'codeview module' command response. The module name can be empty (e.g., --module "IGZCPAC" or --module '""').
+
+`--csect` _(string)_  
+Specifies the CSECT name that you request the Histogram data for. You get the csect value from the 'codeview csect' command response. The CSECT name can be empty (e.g., --csect "TUNCOB01" or --module '""').
+
+`--top` _(number)_  
+Specifies the maximum number of the top consuming CSECT activity locations that you want to obtain in the response (e.g., --top 5). If you specify --top 0, you get the list of all CSECT activity locations that MAT has detected during the measurement. The --top parameter is optional. Values: numbers between 0 and 300.
+
+`--group` _(number)_  
+Specifies the histogram group size parameter that defines the resolution of the histogram. If you do not specify the group parameter, the group size defaults to 4 bytes (e.g., --group 32). If program listing is registered with MAT, the group parameter is ignored. The --group parameter is optional.
+
+`--listing` _(boolean)_  
+Enables you to retrieve program listing details that pertain to the specific CSECT and statement. To use the listing retrieval option, you must install and configure the Endevor® Web Services and have the program listing for the specific measurement registered with MAT. The source code listing is retrieved through Endevor® footprints for Cobol, C/C++, and Assembler programs. The program listing file is downloaded to your local directory that you specified with the 'listingDir' parameter for your MAT configuration profile. When you request the histogram details with the '--listing' option, the 'histogram' command returns the additional 'listing' column that contains a reference to the program listing with the specific CSECT name, program type, line and column number that pertain to the requested CSECT and statement, for example, c:\listings\SA420LE.asm:382:51. If you use Visual Studio Code (VS Code) IDE, you can click on the reference in the command response in your VS Code terminal to navigate directly to the indicated source program location. The --listing parameter is optional.
+
+**Examples**
+
+- Get the Histogram measurement details in CSECT mode with the group size defaulting to 4 bytes for monitor 
+  number 5, CSECT name TUNCOB01, module name RUNCOB:
+
+```
+$ zowe mat monitor codeview histogram csect --mon_num 5 --csect "TUNCOB01" --module "RUNCOB"
+```
+
+- Get the Histogram measurement details in CSECT mode for the latest monitor in the TESTPROF profile for CSECT 
+  name TUNCOB01, empty module name, with the group size value set to 32 bytes, and limit the number of returned rows to 5 top consumers:
+
+```
+$ zowe mat monitor codeview histogram csect --profile TESTPROF --csect "TUNCOB01" --module '""' --top 5 --group 32
+```
+
+- Get the Histogram measurement details in CSECT mode for monitor number 5, CSECT name TUNCOB01, and module name RUNCOB, limit the number of returned records to 5 top consumers, and request the listing details:
+
+```
+$ zowe mat monitor codeview histogram csect --mon_num 5 --csect "TUNCOB01" --module "RUNCOB" --top 5 --listing
+```
+
+- Get the Histogram measurement details in CSECT mode with the group size defaulting to 4 bytes for monitor number 5, CSECT name TUNCOB01, module name RUNCOB, with the specific MAT profile details defined:
+
+```
+$ zowe mat monitor codeview histogram csect --mon_num 5 --csect "TUNCOB01" --module "RUNCOB" --host "example.com" --port 12345 --user johndoe --password qwerty
+```
+
+##### histogram_ideal | idl
+
+Get the Histogram measurement details in Ideal mode.
+
+**Usage**
+
+```
+$ zowe mat monitor codeview histogram ideal [options]
+```
+
+**Options**  
+`--profile` _(string)_  
+Specifies the name of the profile that you want to analyze. When you specify the profile name, you get the data for the latest measurement within the specified profile.
+
+`--mon_num` _(number)_  
+Specifies the unique monitor number of the measurement.
+
+`--system` _(string)_  
+Specifies the system ID that you request the Histogram data for. You get the system ID from the 
+'codeview ideal' command response. This is mandatory option.
+
+`--program` _(string)_  
+Specifies the program name that you request the Histogram data for. You get the program name from the
+'codeview ideal' command response. This is mandatory option.
+
+`--objVersion` _(string)_  
+Specifies the object version that you request the Histogram data for. You get the object version from the
+'codeview ideal' command response. This is mandatory option.
+
+`--srcVersion` _(string)_  
+Specifies the source version that you request the Histogram data for. You get the source version from the
+'codeview ideal' command response. This is mandatory option.
+
+**Examples**
+
+- Get the Histogram data in Ideal mode for monitor number 5, system ID '$ID', program name 'BAGTEST2', object version 'PRD', source version '001':
+
+```
+$ zowe mat monitor codeview histogram ideal --mon_num 5 --system '$ID' --program 'BAGTEST2' --objVersion 'PRD' --srcVersion '001'
+```
+
+- Get the Histogram data in Ideal mode for the latest monitor in the TESTPROF profile for system ID '$ID', program name 'BAGTEST2', object version 'PRD', source version '001':
+
+```
+$ zowe mat monitor codeview histogram ideal --profile TESTPROF --system '$ID' --program 'BAGTEST2' --objVersion 'PRD' --srcVersion '001'
+```
+
+- Get the Histogram data in Ideal mode for monitor number 5, system ID '$ID', program name 
+  'BAGTEST2', object version 'PRD', source version '001' with the specific MAT profile details defined:
+
+```
+$ zowe mat monitor codeview histogram ideal --mon_num 5 --system '$ID' --program 'BAGTEST2' --objVersion 'PRD' --srcVersion '001' --host 'example.com' --port 12345 --user 'johndoe' --password 'qwerty'
+```
+
+##### histogram_natural | nat
+
+Get the Histogram measurement details in Natural mode.
+
+**Usage**
+
+```
+$ zowe mat monitor codeview histogram natural [options]
+```
+
+**Options**  
+`--profile` _(string)_  
+Specifies the name of the profile that you want to analyze. When you specify the profile name, you get the data for the latest measurement within the specified profile.
+
+`--mon_num` _(number)_  
+Specifies the unique monitor number of the measurement.
+
+`--library` _(string)_  
+Specifies the library name that you request the Histogram data for. You get the library name from the
+'codeview natural' command response. This is mandatory option.
+
+`--routine` _(string)_  
+Specifies the routine name that you request the Histogram data for. You get the routine name from the
+'codeview natural' command response. This is mandatory option.
+
+**Examples**
+
+- Get the Histogram data in Natural mode for monitor number 5, library name 'CATAPPS', routine name 'IFEX1R':
+
+```
+$ zowe mat monitor codeview histogram natural --mon_num 5 --library 'CATAPPS' --routine 'IFEX1R'
+```
+
+- Get the Histogram data in Natural mode for the latest monitor in the TESTPROF profile for library name 'CATAPPS', routine name 'IFEX1R':
+
+```
+$ zowe mat monitor codeview histogram natural --profile TESTPROF --library 'CATAPPS' --routine 'IFEX1R'
+```
+
+- Get the Histogram data in Natural mode for monitor number 5, library name 'CATAPPS', routine 
+  name 'IFEX1R' with the specific MAT profile details defined:
+
+```
+$ zowe mat monitor codeview histogram natural --mon_num 5 --library 'CATAPPS' --routine 'IFEX1R' --host 'example.com' --port 12345 --user 'johndoe' --password 'qwerty'
+```
+
 ### db2
 
 The commands from the DB2 group enable you to get the DB2 measurement details.
@@ -859,10 +1049,6 @@ Specifies the unique monitor number of the measurement.
 `--top` _(number)_  
 Specifies the maximum number of the top consuming DB2 statements that you want to obtain in the response (e.g., --top 5). If you specify --top 0, you get the list of of all DB2 statements that MAT has detected during the measurement. The --top parameter is optional. Values: numbers between 0 and 300.
 
-**Profile Options**  
-`--mat-profile` | `--mat-p` _(string)_  
-The name of a (mat) profile to load for this command execution.
-
 **Examples**
 
 - Get the DB2View details for monitor number 5:
@@ -909,10 +1095,6 @@ Specifies the statement number that you request the SQL details for (e.g., `--st
 `--totalsamps` _(number)_  
 Specifies the total number of samples taken for the requested statement (e.g., `--totalsamps 1`). You get the totalsamps value from the 'db2 db2view' command response.
 
-**Profile Options**  
-`--mat-profile` | `--mat-p` _(string)_  
-The name of a (mat) profile to load for this command execution.
-
 **Examples**
 
 - Get the DB2 SQL statement details for monitor number 5 for DBRM CUPBTSDY, statement number 464, with total number of taken samples 1:
@@ -962,10 +1144,6 @@ Specifies the name of the profile that you want to analyze. When you specify the
 `--mon_num` _(number)_  
 Specifies the unique monitor number of the measurement.
 
-**Profile Options**  
-`--mat-profile` | `--mat-p` _(string)_  
-The name of a (mat) profile to load for this command execution.
-
 **Examples**
 
 - Get the dml measurement details for the latest monitor in the TESTPROF profile:
@@ -1009,10 +1187,6 @@ Specifies the identifier of the Run Unit that you request the details for.
 `--linecmd` _(string)_  
 Specifies the line command to be used for the row data.
 
-**Profile Options**  
-`--mat-profile` | `--mat-p` _(string)_  
-The name of a (mat) profile to load for this command execution.
-
 **Examples**
 
 - Get the idms details of the measurement for the latest monitor in the profile:
@@ -1050,10 +1224,6 @@ Specifies the name of the profile that you want to analyze. When you specify the
 `--mon_num` _(number)_  
 Specifies the unique monitor number of the measurement.
 
-**Profile Options**  
-`--mat-profile` | `--mat-p` _(string)_  
-The name of a (mat) profile to load for this command execution.
-
 **Examples**
 
 Get the idms measurement details in Task mode for monitor number 5:
@@ -1097,10 +1267,6 @@ Specifies the name of the profile that you want to analyze. When you specify the
 `--mon_num` _(number)_  
 Specifies the unique monitor number of the measurement.
 
-**Profile Options**  
-`--mat-profile` | `--mat-p` _(string)_  
-The name of a (mat) profile to load for this command execution.
-
 **Examples**
 
 - Get the IMS View details for monitor number 5:
@@ -1132,10 +1298,6 @@ Specifies the name of the profile that you want to analyze. When you specify the
 `--mon_num` _(number)_  
 Specifies the unique monitor number of the measurement.
 
-**Profile Options**  
-`--mat-profile` | `--mat-p` _(string)_  
-The name of a (mat) profile to load for this command execution.
-
 **Examples**
 
 - Get the IMS View DBDName details for monitor number 5:
@@ -1167,10 +1329,6 @@ Specifies the name of the profile that you want to analyze. When you specify the
 `--mon_num` _(number)_  
 Specifies the unique monitor number of the measurement.
 
-**Profile Options**  
-`--mat-profile` | `--mat-p` _(string)_  
-The name of a (mat) profile to load for this command execution.
-
 **Examples**
 
 - Get the IMS View PSBName details for monitor number 5:
@@ -1202,10 +1360,6 @@ Specifies the name of the profile that you want to analyze. When you specify the
 `--mon_num` _(number)_  
 Specifies the unique monitor number of the measurement.
 
-**Profile Options**  
-`--mat-profile` | `--mat-p` _(string)_  
-The name of a (mat) profile to load for this command execution.
-
 **Examples**
 
 - Get the IMS View Region details for monitor number 5:
@@ -1246,10 +1400,6 @@ Specifies the database details for the specified monitor number or profile name.
 `--psbname` _(string)_  
 Specifies the PSB name details for the specified monitor number or profile name.
 
-**Profile Options**  
-`--mat-profile` | `--mat-p` _(string)_  
-The name of a (mat) profile to load for this command execution.
-
 **Examples**
 
 - Get the IMS View SSA details for monitor number 5 with the specific MAT profile details defined:
@@ -1284,10 +1434,6 @@ Specifies the unique monitor number of the measurement.
 `--trancode` _(string)_  
 Specifies the transaction name for specified monitor number or profile name.
 
-**Profile Options**  
-`--mat-profile` | `--mat-p` _(string)_  
-The name of a (mat) profile to load for this command execution.
-
 **Examples**
 
 - Get the IMS View Statement details for monitor number 5 with trancode:
@@ -1334,10 +1480,6 @@ Specifies the unique monitor number of the measurement.
 `--tran` _(string)_  
 Specifies the transaction activity. Tran = N/A is displayed for the activity that could not be attributed to a particular transaction in the address space.
 
-**Profile Options**  
-`--mat-profile` | `--mat-p` _(string)_  
-The name of a (mat) profile to load for this command execution.
-
 **Examples**
 
 - Get the TranView measurement details for monitor number 5:
@@ -1372,10 +1514,6 @@ Specifies the unique monitor number of the measurement.
 `--tran` _(string)_  
 Specifies the transaction activity. Tran = N/A is displayed for the activity that could not be attributed to a particular transaction in the address space.
 
-**Profile Options**  
-`--mat-profile` | `--mat-p` _(string)_  
-The name of a (mat) profile to load for this command execution.
-
 **Examples**
 
 - Get the idms details of the measurement for the latest monitor in the profile:
@@ -1416,10 +1554,6 @@ Specifies the unique monitor number of the measurement.
 `--tran` _(string)_  
 Specifies the transaction activity. Tran = N/A is displayed for the activity that could not be attributed to a particular transaction in the address space.
 
-**Profile Options**  
-`--mat-profile` | `--mat-p` _(string)_  
-The name of a (mat) profile to load for this command execution.
-
 **Examples**
 
 - Get the caller details for monitor number 5:
@@ -1454,10 +1588,6 @@ Specifies the unique monitor number of the measurement.
 `--tran` _(string)_  
 Specifies the transaction activity. Tran = N/A is displayed for the activity that could not be attributed to a particular transaction in the address space.
 
-**Profile Options**  
-`--mat-profile` | `--mat-p` _(string)_  
-The name of a (mat) profile to load for this command execution.
-
 **Examples**
 
 - Get the callstack details for monitor number 5:
@@ -1474,7 +1604,7 @@ $ zowe mat monitor tranview callstack --profile TESTPROF
 
 #### csect | csd
 
-Get the CodeView details for transaction in Csect mode.
+Get the CodeView details for transaction in CSECT mode.
 
 **Usage**
 
@@ -1492,25 +1622,21 @@ Specifies the unique monitor number of the measurement.
 `--tran` _(string)_  
 Specifies the transaction activity. Tran = N/A is displayed for the activity that could not be attributed to a particular transaction in the address space.
 
-**Profile Options**  
-`--mat-profile` | `--mat-p` _(string)_  
-The name of a (mat) profile to load for this command execution.
-
 **Examples**
 
-- Get the CodeView details for transaction in Csect mode for monitor number 5:
+- Get the CodeView details for transaction in CSECT mode for monitor number 5:
 
 ```
 $ zowe mat monitor tranview csect --mon_num 5
 ```
 
-- Get the CodeView details for transaction in Csect mode for the latest monitor in the TESTPROF profile:
+- Get the CodeView details for transaction in CSECT mode for the latest monitor in the TESTPROF profile:
 
 ```
 $ zowe mat monitor tranview csect --profile TESTPROF
 ```
 
-- Get the CodeView details for transaction in Csect mode for the monitor number 5 with specific host:
+- Get the CodeView details for transaction in CSECT mode for the monitor number 5 with specific host:
 
 ```
 $ zowe mat monitor tranview csect --mon_num 5 --host \"example.com\" --port 12345 --user User1 --password qwerty
@@ -1536,10 +1662,6 @@ Specifies the unique monitor number of the measurement.
 `--tran` _(string)_  
 Specifies the transaction activity. Tran = N/A is displayed for the activity that could not be attributed to a particular transaction in the address space.
 
-**Profile Options**  
-`--mat-profile` | `--mat-p` _(string)_  
-The name of a (mat) profile to load for this command execution.
-
 **Examples**
 
 - Get the DelayView measurement details of a transaction for monitor number 5:
@@ -1584,10 +1706,6 @@ Specifies the transaction activity. Tran = N/A is displayed for the activity tha
 Specifies the type of CICS Transaction.
 Default value: DISP
 
-**Profile Options**  
-`--mat-profile` | `--mat-p` _(string)_  
-The name of a (mat) profile to load for this command execution.
-
 **Examples**
 
 - Get the CICS statistic details for monitor number 5: