@broadcom/mat-analyze-for-zowe-cli 2.0.5 → 2.0.7

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (180) hide show
  1. package/README.md +1193 -429
  2. package/lib/api/MATRest.d.ts +17 -0
  3. package/lib/api/MATRest.js +21 -1
  4. package/lib/api/MATRest.js.map +1 -1
  5. package/lib/api/response/ICallStack.d.ts +4 -0
  6. package/lib/api/response/ICallStack.js +25 -0
  7. package/lib/api/response/ICallStack.js.map +1 -0
  8. package/lib/api/response/ICicstat.d.ts +4 -0
  9. package/lib/api/response/ICicstat.js +25 -0
  10. package/lib/api/response/ICicstat.js.map +1 -0
  11. package/lib/api/response/IDML.d.ts +4 -0
  12. package/lib/api/response/IDML.js +25 -0
  13. package/lib/api/response/IDML.js.map +1 -0
  14. package/lib/api/response/IIDMSModule.d.ts +4 -0
  15. package/lib/api/response/IIDMSModule.js +25 -0
  16. package/lib/api/response/IIDMSModule.js.map +1 -0
  17. package/lib/api/response/IIDMSModuleDetail.d.ts +4 -0
  18. package/lib/api/response/IIDMSModuleDetail.js +25 -0
  19. package/lib/api/response/IIDMSModuleDetail.js.map +1 -0
  20. package/lib/api/response/IIDMSTask.d.ts +4 -0
  21. package/lib/api/response/IIDMSTask.js +25 -0
  22. package/lib/api/response/IIDMSTask.js.map +1 -0
  23. package/lib/api/response/IIMSSSAView.d.ts +4 -0
  24. package/lib/api/response/IIMSSSAView.js +25 -0
  25. package/lib/api/response/IIMSSSAView.js.map +1 -0
  26. package/lib/api/response/IIMSStatement.d.ts +4 -0
  27. package/lib/api/response/IIMSStatement.js +25 -0
  28. package/lib/api/response/IIMSStatement.js.map +1 -0
  29. package/lib/api/response/IIMSView.d.ts +4 -0
  30. package/lib/api/response/IIMSView.js +25 -0
  31. package/lib/api/response/IIMSView.js.map +1 -0
  32. package/lib/api/response/IIMSViewDBDName.d.ts +4 -0
  33. package/lib/api/response/IIMSViewDBDName.js +25 -0
  34. package/lib/api/response/IIMSViewDBDName.js.map +1 -0
  35. package/lib/api/response/IIMSViewPSBName.d.ts +4 -0
  36. package/lib/api/response/IIMSViewPSBName.js +25 -0
  37. package/lib/api/response/IIMSViewPSBName.js.map +1 -0
  38. package/lib/api/response/IIMSViewRegion.d.ts +4 -0
  39. package/lib/api/response/IIMSViewRegion.js +25 -0
  40. package/lib/api/response/IIMSViewRegion.js.map +1 -0
  41. package/lib/api/response/ITranview.d.ts +4 -0
  42. package/lib/api/response/ITranview.js +25 -0
  43. package/lib/api/response/ITranview.js.map +1 -0
  44. package/lib/cli/monitor/Monitor.definition.js +6 -1
  45. package/lib/cli/monitor/Monitor.definition.js.map +1 -1
  46. package/lib/cli/monitor/codeview/Histogram/Histogram.handler.d.ts +5 -4
  47. package/lib/cli/monitor/codeview/Histogram/Histogram.handler.js +236 -123
  48. package/lib/cli/monitor/codeview/Histogram/Histogram.handler.js.map +1 -1
  49. package/lib/cli/monitor/codeview/callerid/Callerid.handler.js +2 -0
  50. package/lib/cli/monitor/codeview/callerid/Callerid.handler.js.map +1 -1
  51. package/lib/cli/monitor/codeview/csect/Csect.handler.js +1 -0
  52. package/lib/cli/monitor/codeview/csect/Csect.handler.js.map +1 -1
  53. package/lib/cli/monitor/codeview/module/Module.definition.js +1 -1
  54. package/lib/cli/monitor/codeview/module/Module.definition.js.map +1 -1
  55. package/lib/cli/monitor/codeview/module/Module.handler.js +1 -0
  56. package/lib/cli/monitor/codeview/module/Module.handler.js.map +1 -1
  57. package/lib/cli/monitor/db2/db2view/DB2View.handler.js +1 -0
  58. package/lib/cli/monitor/db2/db2view/DB2View.handler.js.map +1 -1
  59. package/lib/cli/monitor/db2/sqlview/SQLView.handler.js +1 -0
  60. package/lib/cli/monitor/db2/sqlview/SQLView.handler.js.map +1 -1
  61. package/lib/cli/monitor/delayview/address/Address.handler.js +1 -0
  62. package/lib/cli/monitor/delayview/address/Address.handler.js.map +1 -1
  63. package/lib/cli/monitor/delayview/delay/Delay.handler.js +1 -0
  64. package/lib/cli/monitor/delayview/delay/Delay.handler.js.map +1 -1
  65. package/lib/cli/monitor/history/History.handler.js +1 -0
  66. package/lib/cli/monitor/history/History.handler.js.map +1 -1
  67. package/lib/cli/monitor/idms/IDMS.definition.d.ts +16 -0
  68. package/lib/cli/monitor/idms/IDMS.definition.js +76 -0
  69. package/lib/cli/monitor/idms/IDMS.definition.js.map +1 -0
  70. package/lib/cli/monitor/idms/dml/DML.definition.d.ts +3 -0
  71. package/lib/cli/monitor/idms/dml/DML.definition.js +64 -0
  72. package/lib/cli/monitor/idms/dml/DML.definition.js.map +1 -0
  73. package/lib/cli/monitor/idms/dml/DML.handler.d.ts +7 -0
  74. package/lib/cli/monitor/idms/dml/DML.handler.js +53 -0
  75. package/lib/cli/monitor/idms/dml/DML.handler.js.map +1 -0
  76. package/lib/cli/monitor/idms/module/IDMSModule.definition.d.ts +16 -0
  77. package/lib/cli/monitor/idms/module/IDMSModule.definition.js +101 -0
  78. package/lib/cli/monitor/idms/module/IDMSModule.definition.js.map +1 -0
  79. package/lib/cli/monitor/idms/module/IDMSModule.handler.d.ts +8 -0
  80. package/lib/cli/monitor/idms/module/IDMSModule.handler.js +91 -0
  81. package/lib/cli/monitor/idms/module/IDMSModule.handler.js.map +1 -0
  82. package/lib/cli/monitor/idms/task/IDMSTask.definition.d.ts +3 -0
  83. package/lib/cli/monitor/idms/task/IDMSTask.definition.js +64 -0
  84. package/lib/cli/monitor/idms/task/IDMSTask.definition.js.map +1 -0
  85. package/lib/cli/monitor/idms/task/IDMSTask.handler.d.ts +7 -0
  86. package/lib/cli/monitor/idms/task/IDMSTask.handler.js +51 -0
  87. package/lib/cli/monitor/idms/task/IDMSTask.handler.js.map +1 -0
  88. package/lib/cli/monitor/ims/IMS.definition.d.ts +16 -0
  89. package/lib/cli/monitor/ims/IMS.definition.js +59 -0
  90. package/lib/cli/monitor/ims/IMS.definition.js.map +1 -0
  91. package/lib/cli/monitor/ims/dbdname/DBDName.definition.d.ts +2 -0
  92. package/lib/cli/monitor/ims/dbdname/DBDName.definition.js +61 -0
  93. package/lib/cli/monitor/ims/dbdname/DBDName.definition.js.map +1 -0
  94. package/lib/cli/monitor/ims/dbdname/DBDName.handler.d.ts +7 -0
  95. package/lib/cli/monitor/ims/dbdname/DBDName.handler.js +51 -0
  96. package/lib/cli/monitor/ims/dbdname/DBDName.handler.js.map +1 -0
  97. package/lib/cli/monitor/ims/imsview/IMSView.definition.d.ts +2 -0
  98. package/lib/cli/monitor/ims/imsview/IMSView.definition.js +61 -0
  99. package/lib/cli/monitor/ims/imsview/IMSView.definition.js.map +1 -0
  100. package/lib/cli/monitor/ims/imsview/IMSView.handler.d.ts +7 -0
  101. package/lib/cli/monitor/ims/imsview/IMSView.handler.js +52 -0
  102. package/lib/cli/monitor/ims/imsview/IMSView.handler.js.map +1 -0
  103. package/lib/cli/monitor/ims/psbname/PSBName.definition.d.ts +2 -0
  104. package/lib/cli/monitor/ims/psbname/PSBName.definition.js +61 -0
  105. package/lib/cli/monitor/ims/psbname/PSBName.definition.js.map +1 -0
  106. package/lib/cli/monitor/ims/psbname/PSBName.handler.d.ts +7 -0
  107. package/lib/cli/monitor/ims/psbname/PSBName.handler.js +61 -0
  108. package/lib/cli/monitor/ims/psbname/PSBName.handler.js.map +1 -0
  109. package/lib/cli/monitor/ims/region/Region.definition.d.ts +2 -0
  110. package/lib/cli/monitor/ims/region/Region.definition.js +61 -0
  111. package/lib/cli/monitor/ims/region/Region.definition.js.map +1 -0
  112. package/lib/cli/monitor/ims/region/Region.handler.d.ts +7 -0
  113. package/lib/cli/monitor/ims/region/Region.handler.js +63 -0
  114. package/lib/cli/monitor/ims/region/Region.handler.js.map +1 -0
  115. package/lib/cli/monitor/ims/ssa/SSA.definition.d.ts +2 -0
  116. package/lib/cli/monitor/ims/ssa/SSA.definition.js +82 -0
  117. package/lib/cli/monitor/ims/ssa/SSA.definition.js.map +1 -0
  118. package/lib/cli/monitor/ims/ssa/SSA.handler.d.ts +8 -0
  119. package/lib/cli/monitor/ims/ssa/SSA.handler.js +55 -0
  120. package/lib/cli/monitor/ims/ssa/SSA.handler.js.map +1 -0
  121. package/lib/cli/monitor/ims/statement/Statement.definition.d.ts +2 -0
  122. package/lib/cli/monitor/ims/statement/Statement.definition.js +68 -0
  123. package/lib/cli/monitor/ims/statement/Statement.definition.js.map +1 -0
  124. package/lib/cli/monitor/ims/statement/Statement.handler.d.ts +8 -0
  125. package/lib/cli/monitor/ims/statement/Statement.handler.js +65 -0
  126. package/lib/cli/monitor/ims/statement/Statement.handler.js.map +1 -0
  127. package/lib/cli/monitor/tranview/Tranview.definition.d.ts +16 -0
  128. package/lib/cli/monitor/tranview/Tranview.definition.js +81 -0
  129. package/lib/cli/monitor/tranview/Tranview.definition.js.map +1 -0
  130. package/lib/cli/monitor/tranview/all/All.definition.d.ts +3 -0
  131. package/lib/cli/monitor/tranview/all/All.definition.js +80 -0
  132. package/lib/cli/monitor/tranview/all/All.definition.js.map +1 -0
  133. package/lib/cli/monitor/tranview/all/All.handler.d.ts +7 -0
  134. package/lib/cli/monitor/tranview/all/All.handler.js +51 -0
  135. package/lib/cli/monitor/tranview/all/All.handler.js.map +1 -0
  136. package/lib/cli/monitor/tranview/callerid/Callerid.definition.d.ts +3 -0
  137. package/lib/cli/monitor/tranview/callerid/Callerid.definition.js +70 -0
  138. package/lib/cli/monitor/tranview/callerid/Callerid.definition.js.map +1 -0
  139. package/lib/cli/monitor/tranview/callerid/Callerid.handler.d.ts +8 -0
  140. package/lib/cli/monitor/tranview/callerid/Callerid.handler.js +56 -0
  141. package/lib/cli/monitor/tranview/callerid/Callerid.handler.js.map +1 -0
  142. package/lib/cli/monitor/tranview/callstack/CallStack.definition.d.ts +3 -0
  143. package/lib/cli/monitor/tranview/callstack/CallStack.definition.js +70 -0
  144. package/lib/cli/monitor/tranview/callstack/CallStack.definition.js.map +1 -0
  145. package/lib/cli/monitor/tranview/callstack/CallStack.handler.d.ts +8 -0
  146. package/lib/cli/monitor/tranview/callstack/CallStack.handler.js +55 -0
  147. package/lib/cli/monitor/tranview/callstack/CallStack.handler.js.map +1 -0
  148. package/lib/cli/monitor/tranview/csect/CsectDetail.definition.d.ts +2 -0
  149. package/lib/cli/monitor/tranview/csect/CsectDetail.definition.js +70 -0
  150. package/lib/cli/monitor/tranview/csect/CsectDetail.definition.js.map +1 -0
  151. package/lib/cli/monitor/tranview/csect/CsectDetail.handler.d.ts +8 -0
  152. package/lib/cli/monitor/tranview/csect/CsectDetail.handler.js +55 -0
  153. package/lib/cli/monitor/tranview/csect/CsectDetail.handler.js.map +1 -0
  154. package/lib/cli/monitor/tranview/delay/DelayDetail.definition.d.ts +2 -0
  155. package/lib/cli/monitor/tranview/delay/DelayDetail.definition.js +70 -0
  156. package/lib/cli/monitor/tranview/delay/DelayDetail.definition.js.map +1 -0
  157. package/lib/cli/monitor/tranview/delay/DelayDetail.handler.d.ts +8 -0
  158. package/lib/cli/monitor/tranview/delay/DelayDetail.handler.js +55 -0
  159. package/lib/cli/monitor/tranview/delay/DelayDetail.handler.js.map +1 -0
  160. package/lib/cli/monitor/tranview/module/Module.definition.d.ts +2 -0
  161. package/lib/cli/monitor/tranview/module/Module.definition.js +70 -0
  162. package/lib/cli/monitor/tranview/module/Module.definition.js.map +1 -0
  163. package/lib/cli/monitor/tranview/module/Module.handler.d.ts +7 -0
  164. package/lib/cli/monitor/tranview/module/Module.handler.js +51 -0
  165. package/lib/cli/monitor/tranview/module/Module.handler.js.map +1 -0
  166. package/lib/cli/monitor/tranview/stat/Cicstat.definition.d.ts +3 -0
  167. package/lib/cli/monitor/tranview/stat/Cicstat.definition.js +80 -0
  168. package/lib/cli/monitor/tranview/stat/Cicstat.definition.js.map +1 -0
  169. package/lib/cli/monitor/tranview/stat/Cicstat.handler.d.ts +8 -0
  170. package/lib/cli/monitor/tranview/stat/Cicstat.handler.js +175 -0
  171. package/lib/cli/monitor/tranview/stat/Cicstat.handler.js.map +1 -0
  172. package/lib/handlers/AbstractGetHandler.js +9 -9
  173. package/lib/handlers/AbstractGetHandler.js.map +1 -1
  174. package/lib/handlers/AbstractPostHandler.js +2 -2
  175. package/lib/handlers/AbstractPostHandler.js.map +1 -1
  176. package/lib/handlers/AbstractRestHandler.js +3 -3
  177. package/lib/handlers/AbstractRestHandler.js.map +1 -1
  178. package/lib/index.js +6 -2
  179. package/lib/index.js.map +1 -1
  180. package/package.json +11 -12
package/README.md CHANGED
@@ -1,94 +1,104 @@
1
- <img src="https://github.com/openmainframeproject/artwork/blob/master/other/zowe-conformant/zowev1/cli/color/zowe-conformant-zowev1-cli-color.png?raw=true" width=25% alt="Zowe Conformance Badge">
1
+ <img src="https://artwork.openmainframeproject.org/other/zowe-conformant/zowev2/cli/color/zowe-conformant-zowev2-cli-color.png" width="100" height="75" alt="Zowe Conformance Badge">
2
2
 
3
3
  # MAT Analyze Plug-in for Zowe CLI
4
- The MAT Analyze plug-in for Zowe CLI provides access to Mainframe Application Tuner (MAT) functionality. The plug-in ensures interaction with MAT and enables you to measure your mainframe applications and get the analysis data in the form of MAT analysis views using Zowe command line interface.
4
+
5
+ The MAT Analyze plug-in for Zowe CLI provides access to Mainframe Application Tuner (MAT) functionality. The plug-in ensures interaction with MAT and enables you to measure your mainframe applications and get the analysis data in the form of MAT analysis views using Zowe command line interface.
5
6
 
6
7
  You can use the MAT Analyze plug-in for Zowe CLI to perform the following tasks:
7
- * Manage monitor profiles.
8
- Create and invoke monitor profiles, view the lists of available profiles, and retrieve the measurement history.
9
- * Analyze the measurement data.
10
- Access the measurement data from Mainframe Application Tuner that is available to you in the CLI in the form of MAT analysis views.
11
- * Address performance issues.
12
- 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.
13
-
14
-
15
- Table of Contents
16
- =================
17
- * [Installation](#installation)
18
- * [Prerequisites](#prerequisites)
19
- * [Install the MAT Analyze Plug-in for Zowe CLI From Packages](#install-the-mat-analyze-plug-in-for-zowe-cli-from-packages)
20
- * [Install the MAT Analyze Plug-in for Zowe CLI From Source](#install-the-mat-analyze-plug-in-for-zowe-cli-from-source)
21
- * [Validate the Installation](#validate-the-installation)
22
- * [Create a MAT Profile](#create-a-mat-profile)
23
- * [Using Profile Options](#using-profile-options)
24
- * [Use Cases and Commands](#use-cases-and-commands)
25
- * [PROFILE](#profile)
26
- * [create | cr](#create--cr)
27
- * [invoke | ivk](#invoke--ivk)
28
- * [list | lip](#list--lip)
29
- * [MONITOR](#monitor)
30
- * [history | hs](#history--hs)
31
- * [overview | ov](#overview--ov)
32
- * [delayview](#delayview)
33
- * [delay | de](#delay--de)
34
- * [address | ad](#address--ad)
35
- * [codeview](#codeview)
36
- * [module | cm](#module--cm)
37
- * [csect | cs](#csect--cs)
38
- * [histogram | hsg](#histogram--hsg)
39
- * [callerid | cil](#callerid--cil)
40
- * [db2](#db2)
41
- * [db2view | db2](#db2view--db2)
42
- * [sqlstmt | sql](#sqlstmt--sql)
43
- * [Uninstall the MAT Analyze Plug-in for Zowe CLI](#uninstall-the-mat-analyze-plug-in-for-zowe-cli)
44
-
45
-
46
-
8
+
9
+ - Manage monitor profiles.
10
+ Create and invoke monitor profiles, view the lists of available profiles, and retrieve the measurement history.
11
+ - Analyze the measurement data.
12
+ Access the measurement data from Mainframe Application Tuner that is available to you in the CLI in the form of MAT analysis views.
13
+ - Address performance issues.
14
+ 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.
15
+
16
+ # Table of Contents
17
+
18
+ - [Installation](#installation)
19
+ - [Prerequisites](#prerequisites)
20
+ - [Install the MAT Analyze Plug-in for Zowe CLI From Packages](#install-the-mat-analyze-plug-in-for-zowe-cli-from-packages)
21
+ - [Validate the Installation](#validate-the-installation)
22
+ - [Create a MAT Profile](#create-a-mat-profile)
23
+ - [Use MAT Profile Options](#use-mat-profile-options)
24
+ - [Use Cases and Commands](#use-cases-and-commands)
25
+ - [PROFILE](#profile)
26
+ - [create | cr](#create--cr)
27
+ - [invoke | ivk](#invoke--ivk)
28
+ - [list | lip](#list--lip)
29
+ - [MONITOR](#monitor)
30
+ - [history | hs](#history--hs)
31
+ - [overview | ov](#overview--ov)
32
+ - [delayview](#delayview)
33
+ - [delay | de](#delay--de)
34
+ - [address | ad](#address--ad)
35
+ - [codeview](#codeview)
36
+ - [module | mod](module--mod)
37
+ - [csect | cs](#csect--cs)
38
+ - [histogram | hsg](#histogram--hsg)
39
+ - [callerid | cil](#callerid--cil)
40
+ - [db2](#db2)
41
+ - [db2view | db2](#db2view--db2)
42
+ - [sqlstmt | sql](#sqlstmt--sql)
43
+ - [idms](#idms)
44
+ - [dml | dml](#dml--dml)
45
+ - [module | mod](#idms)
46
+ - [task | ts](#task--ts)
47
+ - [ims](#ims)
48
+ - [dbdname | dbd](#dbdname--dbd)
49
+ - [imsview | imsv](#imsview--imsv)
50
+ - [psbname | psb](#psbname--psb)
51
+ - [region | reg](#region--reg)
52
+ - [ssa | ssa](#ssa--ssa)
53
+ - [statement | stat](#statement--stat)
54
+ - [tranview](#tranview)
55
+ - [all | all](#all--all)
56
+ - [module | mod](#tranview)
57
+ - [callerid | cid](#callerid--cid)
58
+ - [callstack | csk](#callstack--csk)
59
+ - [csect | csd](#csect--csd)
60
+ - [delay | dl](#delay--dl)
61
+ - [stat | cis](#stat--cis)
62
+ - [Uninstall the MAT Analyze Plug-in for Zowe CLI](#uninstall-the-mat-analyze-plug-in-for-zowe-cli)
63
+
47
64
  # Installation
48
- You can install the MAT Analyze Plug-in for Zowe CLI:
49
- * From the Zowe Package
50
- * From Source
65
+
66
+ You can install the MAT Analyze Plug-in for Zowe CLI from the Zowe Package.
51
67
 
52
68
  ## Prerequisites
69
+
53
70
  Before starting the installation of the MAT Analyze Plug-in for Zowe CLI, verify that you have:
54
- * Zowe CLI installed.
55
- * MAT database and the REST API installed, configured, and running.
56
- * (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.
71
+
72
+ - Zowe version 2 (Zowe CLI version 7.x) is installed.
73
+ - MAT database and the REST API installed, configured, and running.
74
+ - (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.
57
75
 
58
76
  ## Install the MAT Analyze Plug-in for Zowe CLI From Packages
77
+
59
78
  Issue the following command:
60
79
 
61
80
  ```
62
81
  $ zowe plugins install @broadcom/mat-analyze-for-zowe-cli
63
82
  ```
83
+
64
84
  **Note:**
65
85
  The `latest` npm tag installs a version of the product that is intended for public consumption. You can use different npm tags to install other versions of the product. For example, you can install with the `@beta` tag to try new features that have not been fully validated. For more information about tag usage, see [NPM Tag Names](https://github.com/zowe/zowe-cli/blob/master/docs/MaintainerVersioning.md#npm-tag-names).
66
86
 
67
- ## Install the MAT Analyze Plug-in for Zowe CLI From Source
68
- To install the MAT Analyze plug-in for Zowe CLI from source, follow these steps:
69
-
70
- 1. `git clone git@github.gwd.broadcom.net:MFD/mat-analyze-for-zowe-cli.git`
71
- 2. `cd mat-analyze-for-zowe-cli`
72
- 3. `npm install`
73
- 4. `npm run build`
74
- 5. Navigate one level up in the folder hierarchy: `cd..`
75
- 6. `zowe plugins install ./mat-analyze-for-zowe-cli`
76
- 7. `zowe mat`
77
-
78
- You should see help text displayed if the installation was successful.
79
-
80
87
  ## Validate the Installation
88
+
81
89
  To validate the installation, issue the following command:
90
+
82
91
  ```
83
92
  $ zowe plugins validate @broadcom/mat-analyze-for-zowe-cli
84
93
  ```
85
- Successful validation of the plug-in returns the response "This plugin was successfully validated. Enjoy the plugin."
86
94
 
95
+ Successful validation of the plug-in returns the response "This plugin was successfully validated. Enjoy the plugin."
87
96
 
88
97
  ## Create a MAT Profile
98
+
89
99
  To enable the interaction of the MAT Analyze plug-in for Zowe CLI with MAT, you need to specify the MAT profile details that include the protocol type, host, and port that you defined for the MAT REST API server, and your mainframe username and password. The details of the MAT profile are stored in the Zowe configuration file. To create a global Zowe configuration file, use the command `zowe config init --global-config`, then edit the configuration file and add a section with the MAT profile details:
90
100
 
91
- ```
101
+ ```
92
102
  "mat": {
93
103
              "type": "mat",
94
104
              "properties": {
@@ -102,744 +112,1498 @@ To enable the interaction of the MAT Analyze plug-in for Zowe CLI with MAT, you
102
112
              },
103
113
              "secure": []
104
114
          },
105
- ```
106
-
107
- **MAT Profile Options**
108
- `--protocol` | `--o` *(string)*
109
- Specifies the protocol defined for the MAT REST API server (http or https).
110
- Allowed values: http, https.
111
-
112
- `--host` | `--H` *(string)*
113
- Specifies the hostname or IP address defined for the MAT REST API server (e.g. 127.0.0.0 or localhost).
114
-
115
- `--port` | `--P` *(number)*
116
- Specifies the server port (e.g. 8080).
117
-
118
- `--user` | `--u` *(string)*
119
- Your mainframe username.
120
-
121
- `--password` | `--pw` *(string)*
122
- Your mainframe password.
123
-
124
- `--base-path` | `--bp` *(string)*
125
- The base path for your API mediation layer instance. Specify this option to prepend the base path to all resources when making REST requests. Do not specify this option if you are not using an API mediation layer.
126
-
127
- `--reject-unauthorized` | `--ru` *(boolean)*
128
- Reject self-signed certificates.
129
- Default value: true
130
-
131
- `--listingDir` | `--ldir` *(string)*
132
- Specifies the directory where you want to store the registered program listings (e.g. 'c:\listings') for your immediate source code inspection. You can use the advantage of automated listing registration with MAT and listing retrieval through Endevor® footprints for Cobol, C/C++, and Assembler programs. When a source program listing is registered with MAT, you can enhance the histogram analysis data with the program listing details that pertain to the specific CSECT and program statement. The listing is transfered to the specified directory, which enables you to navigate directly to the line of the source code in you VS Code IDE and inspect the program statement. To use the listing retrieval option through Endevor® footprints, you need to have the Endevor® Web Services installed and configured and specify the Endevor® web server details in the MAT database configuration. The `--listingDir` parameter is optional.
133
-
134
- If the details are not specified or if you want to temporarily use different MAT profile settings, you can specify all or some MAT profile details with each command. The MAT profile details that are provided with a command have the highest priority and override all other values. For more information about using profiles in Zowe, see [Using Global Profile Configuration](https://docs.zowe.org/stable/user-guide/cli-using-global-profile-configuration/) in the Zowe documentation.
135
-
115
+ ```
116
+
117
+ ## Use MAT Profile Options
118
+
119
+ `--protocol` | `--o` _(string)_
120
+ Specifies the protocol defined for the MAT REST API server (http or https).
121
+ Allowed values: http, https.
122
+
123
+ `--host` | `--H` _(string)_
124
+ Specifies the hostname or IP address defined for the MAT REST API server (e.g. 127.0.0.0 or localhost).
125
+
126
+ `--port` | `--P` _(number)_
127
+ Specifies the server port (e.g. 8080).
128
+
129
+ `--user` | `--u` _(string)_
130
+ Your mainframe username.
131
+
132
+ `--password` | `--pw` _(string)_
133
+ Your mainframe password.
134
+
135
+ `--base-path` | `--bp` _(string)_
136
+ The base path for your API mediation layer instance. Specify this option to prepend the base path to all resources when making REST requests. Do not specify this option if you are not using an API mediation layer.
137
+
138
+ `--reject-unauthorized` | `--ru` _(boolean)_
139
+ Reject self-signed certificates.
140
+ Default value: true
141
+
142
+ `--listingDir` | `--ldir` _(string)_
143
+ Specifies the directory where you want to store the registered program listings (e.g. 'c:\listings') for your immediate source code inspection. You can use the advantage of automated listing registration with MAT and listing retrieval through Endevor® footprints for Cobol, C/C++, and Assembler programs. When a source program listing is registered with MAT, you can enhance the histogram analysis data with the program listing details that pertain to the specific CSECT and program statement. The listing is transfered to the specified directory, which enables you to navigate directly to the line of the source code in you VS Code IDE and inspect the program statement. To use the listing retrieval option through Endevor® footprints, you need to have the Endevor® Web Services installed and configured and specify the Endevor® web server details in the MAT database configuration. The `--listingDir` parameter is optional.
144
+
145
+ If the details are not specified or if you want to temporarily use different MAT profile settings, you can specify all or some MAT profile details with each command. The MAT profile details that are provided with a command have the highest priority and override all other values. For more information about using profiles in Zowe, see [Using Global Profile Configuration](https://docs.zowe.org/stable/user-guide/cli-using-global-profile-configuration/) in the Zowe documentation.
136
146
 
137
147
  # Use Cases and Commands
138
- The MAT Analyze plug-in for Zowe CLI enables you to manage monitor profiles and get the measurement analysis data using Mainframe Application Tuner (MAT).
148
+
149
+ The MAT Analyze plug-in for Zowe CLI enables you to manage monitor profiles and get the measurement analysis data using Mainframe Application Tuner (MAT).
150
+
139
151
  ```
140
152
  $ zowe mat <group>
141
- ```
142
-
143
- The MAT Analyze plug-in for Zowe CLI commands are organized in the following **command groups**:
144
-
145
-
153
+ ```
154
+
155
+ The MAT Analyze plug-in for Zowe CLI commands are organized in the following **command groups**:
146
156
 
147
157
  ## PROFILE
148
- The commands from the PROFILE group enable you to create, invoke, and list MAT monitor profiles.
149
158
 
150
- **Usage**
159
+ The commands from the PROFILE group enable you to create, invoke, and list MAT monitor profiles.
160
+
161
+ **Usage**
162
+
151
163
  ```
152
164
  $ zowe mat profile <command>
153
- ```
165
+ ```
154
166
 
155
- The following **commands** are available for the PROFILE group:
167
+ The following **commands** are available for the PROFILE group:
156
168
 
157
169
  ### create | cr
158
- Create a MAT monitor profile.
170
+
171
+ Create a MAT monitor profile.
159
172
 
160
173
  **Usage**
174
+
161
175
  ```
162
176
  $ zowe mat profile create [options]
163
- ```
177
+ ```
164
178
 
165
179
  **Required Options**
166
- `--profile` *(string)*
180
+ `--profile` _(string)_
167
181
  Specifies the name of the profile that you create in MAT (e.g. PROFILE1).
168
- Values: 1 to 8 characters, a combination of alphanumeric and national characters (A-Z, 0-9, and @), the first character must be an alphabetic or @. The profile name must not contain characters # and $.
182
+ Values: 1 to 8 characters, a combination of alphanumeric and national characters (A-Z, 0-9, and @), the first character must be an alphabetic or @. The profile name must not contain characters # and $.
169
183
 
170
- `--jobname` *(string)*
184
+ `--jobname` _(string)_
171
185
  Specifies the name of the job that you want to measure (e.g. JOB1).
172
- Values: 1 to 8 characters, alphanumeric (A-Z capitals only and 0-9), national (#, $, @), and wildcards (* or %).
186
+ Values: 1 to 8 characters, alphanumeric (A-Z capitals only and 0-9), national (#, $, @), and wildcards (\* or %).
173
187
 
174
- `--targsys` *(string)*
188
+ `--targsys` _(string)_
175
189
  Specifies the target system in SYSPLEX.
176
- Values: a comma separated list of up to 4 values is allowed, 1-8 characters each, a combination of alphanumeric (A-Z and 0-9) and national (@,#,$), the first character must be an alphabetic (A-Z) or a national (@, #, $), e.g. AA31,AA32).
190
+ Values: a comma separated list of up to 4 values is allowed, 1-8 characters each, a combination of alphanumeric (A-Z and 0-9) and national (@,#,$), the first character must be an alphabetic (A-Z) or a national (@, #, $), e.g. AA31,AA32).
177
191
 
178
192
  **Options**
179
- `--batchreports` *(string)*
193
+ `--batchreports` _(string)_
180
194
  Specifies the setting for the Batch report option upon monitor completion.
181
195
  Default value: no.
182
- Allowed values: yes, no.
196
+ Allowed values: yes, no.
183
197
 
184
- `--description` *(string)*
185
- Provide the monitor description (maximum 24 characters).
198
+ `--description` _(string)_
199
+ Provide the monitor description (maximum 24 characters).
186
200
 
187
- `--mondsn` *(string)*
201
+ `--mondsn` _(string)_
188
202
  Specifies the monitor data set name where MAT saves the measurement (e.g. DEMO.MAT.MONITOR).
189
- Values: data set name pattern, maximum 46 characters. If not specified, your default MAT monitor DSN pattern is applied.
203
+ Values: data set name pattern, maximum 46 characters. If not specified, your default MAT monitor DSN pattern is applied.
190
204
 
191
- `--stepname` *(string)*
205
+ `--stepname` _(string)_
192
206
  Specifies the name of the job step to monitor.
193
- Values: maximum 8 characters, alphanumeric (A-Z capitals only and 0-9), national (#, $, @), and wildcards (* or %).
207
+ Values: maximum 8 characters, alphanumeric (A-Z capitals only and 0-9), national (#, $, @), and wildcards (\* or %).
194
208
 
195
- `--mstep` *(string)*
209
+ `--mstep` _(string)_
196
210
  Indicates whether the multi-step monitoring option is enabled.
197
211
  Default value: no.
198
- Allowed values: yes, no.
212
+ Allowed values: yes, no.
199
213
 
200
- `--procstep` *(string)*
214
+ `--procstep` _(string)_
201
215
  Specifies the name of the procedure step.
202
- Values: maximum 8 characters, alphanumeric (A-Z capitals only and 0-9), national (#, $, @), and wildcards (* or %).
216
+ Values: maximum 8 characters, alphanumeric (A-Z capitals only and 0-9), national (#, $, @), and wildcards (\* or %).
203
217
 
204
- `--program` *(string)*
218
+ `--program` _(string)_
205
219
  Specifies the name of the program to monitor.
206
- Values: maximum 8 characters, alphanumeric (A-Z capitals only and 0-9), national (#, $, @), and wildcards (* or %).
220
+ Values: maximum 8 characters, alphanumeric (A-Z capitals only and 0-9), national (#, $, @), and wildcards (\* or %).
207
221
 
208
- `--elapstime` *(string)*
222
+ `--elapstime` _(string)_
209
223
  Specifies the required monitor duration followed by s (seconds) or m (minutes) (e.g. 60s).
210
224
  Values: maximum 6 characters total, number must be > 0.
211
- Default value: 60s.
225
+ Default value: 60s.
212
226
 
213
- `--smon` *(string)*
227
+ `--smon` _(string)_
214
228
  Specifies whether to monitor the entire step.
215
229
  Default value: no.
216
- Allowed values: yes, no.
230
+ Allowed values: yes, no.
217
231
 
218
- `--tasklib` *(string)*
232
+ `--tasklib` _(string)_
219
233
  Specifies an additional DD name for load modules.
220
- Values: maximum 8 characters, alphanumeric (A-Z capitals only and 0-9), national (#, $, @), and wildcards (* or %).
234
+ Values: maximum 8 characters, alphanumeric (A-Z capitals only and 0-9), national (#, $, @), and wildcards (\* or %).
221
235
 
222
- `--samplecnt` *(string)*
236
+ `--samplecnt` _(string)_
223
237
  Specifies the number of observations requested.
224
238
  Values: maximum 6 characters, numbers between 10 and 999999.
225
- Default value: 6000.
239
+ Default value: 6000.
226
240
 
227
- `--succnt` *(string)*
241
+ `--succnt` _(string)_
228
242
  Specifies the maximum number of monitors to run per job execution. Values: maximum 4 characters, numbers between 1 and 9999.
229
- Default value: 1.
243
+ Default value: 1.
230
244
 
231
- `--reccnt` *(string)*
245
+ `--reccnt` _(string)_
232
246
  Specifies the number of times this job step will be monitored. Values: maximum 4 characters, numbers between 1 and 9999.
233
- Default value: 1.
247
+ Default value: 1.
234
248
 
235
- `--sampdelay` *(string)*
249
+ `--sampdelay` _(string)_
236
250
  Specifies the delay monitoring time in seconds after the step start. Values: maximum 4 characters, numbers between 0 and 9999.
237
- Default value: 0.
251
+ Default value: 0.
238
252
 
239
- `--userexit1` *(string)*
253
+ `--userexit1` _(string)_
240
254
  Specifies the name for the call user written Data Base.
241
- Values: maximum 8 characters, alphanumeric (A-Z capitals only and 0-9), national (#, $, @), and wildcards (* or %) (e.g. DBEXIT1).
255
+ Values: maximum 8 characters, alphanumeric (A-Z capitals only and 0-9), national (#, $, @), and wildcards (\* or %) (e.g. DBEXIT1).
242
256
 
243
- `--userexit2` *(string)*
257
+ `--userexit2` _(string)_
244
258
  Specifies the name 1 for the call user written 4GL exit programs for this monitor.
245
- Values: maximum 8 characters, alphanumeric (A-Z capitals only and 0-9), national (#, $, @), and wildcards (* or %) (e.g. UEXIT1).
259
+ Values: maximum 8 characters, alphanumeric (A-Z capitals only and 0-9), national (#, $, @), and wildcards (\* or %) (e.g. UEXIT1).
246
260
 
247
- `--userexit3` *(string)*
261
+ `--userexit3` _(string)_
248
262
  Specifies the name 2 for the call user written 4GL exit programs for this monitor.
249
- Values: maximum 8 characters, alphanumeric (A-Z capitals only and 0-9), national (#, $, @), and wildcards (* or %) (e.g. UEXIT2).
263
+ Values: maximum 8 characters, alphanumeric (A-Z capitals only and 0-9), national (#, $, @), and wildcards (\* or %) (e.g. UEXIT2).
250
264
 
251
- `--inctask` *(string)*
265
+ `--inctask` _(string)_
252
266
  Specifies the task name to define the tasks that you want to sample in a multitasking environment and restrict monitoring to the specific subtask within the address space.
253
- Values: a comma separated list of up to 4 values is allowed, maximum 8 characters each, alphanumeric (A-Z capitals only and 0-9), national (#, $, @), and wildcards (* or %) (e.g. INC31,INC32).
267
+ Values: a comma separated list of up to 4 values is allowed, maximum 8 characters each, alphanumeric (A-Z capitals only and 0-9), national (#, $, @), and wildcards (\* or %) (e.g. INC31,INC32).
254
268
 
255
- `--exctask` *(string)*
269
+ `--exctask` _(string)_
256
270
  Specifies the task name to omit from sampling in a multitasking environment.
257
- Values: a comma separated list of up to 4 values is allowed, max. 8 characters each, alphanumeric (A-Z capitals only and 0-9), national (#, $, @), and wildcards (* or %) (e.g. EXC31,EXC32).
271
+ Values: a comma separated list of up to 4 values is allowed, max. 8 characters each, alphanumeric (A-Z capitals only and 0-9), national (#, $, @), and wildcards (\* or %) (e.g. EXC31,EXC32).
258
272
 
259
- `--tran` *(string)*
273
+ `--tran` _(string)_
260
274
  Specifies the CICS transaction code name to monitor.
261
- Values: a comma separated list of up to 4 values is allowed, maximum 8 characters each, alphanumeric (A-Z capitals only and 0-9), national (#, $, @), and wildcards (* or +) (e.g. TRAN1,TRAN2).
275
+ Values: a comma separated list of up to 4 values is allowed, maximum 8 characters each, alphanumeric (A-Z capitals only and 0-9), national (#, $, @), and wildcards (\* or +) (e.g. TRAN1,TRAN2).
262
276
 
263
- `--term` *(string)*
277
+ `--term` _(string)_
264
278
  Specifies the CICS terminal IDs to monitor.
265
- Values: a comma separated list of up to 4 values is allowed, maximum 8 characters each, alphanumeric (A-Z capitals only and 0-9), national (#, $, @), and wildcards (* or +) (e.g. TERM1,TERM2).
279
+ Values: a comma separated list of up to 4 values is allowed, maximum 8 characters each, alphanumeric (A-Z capitals only and 0-9), national (#, $, @), and wildcards (\* or +) (e.g. TERM1,TERM2).
266
280
 
267
- `--userid` *(string)*
281
+ `--userid` _(string)_
268
282
  Specifies the CICS user IDs to monitor.
269
- Values: a comma separated list of up to 4 values is allowed, maximum 8 characters each, alphanumeric (A-Z capitals only and 0-9), national (#, $, @), and wildcards (* or +) (e.g. USER1,USER2).
283
+ Values: a comma separated list of up to 4 values is allowed, maximum 8 characters each, alphanumeric (A-Z capitals only and 0-9), national (#, $, @), and wildcards (\* or +) (e.g. USER1,USER2).
270
284
 
271
- `--db2expl` *(string)*
285
+ `--db2expl` _(string)_
272
286
  Indicates whether the Explain SQL option is enabled for DB2 SQL statements.
273
287
  Default value: no.
274
- Allowed values: yes, no.
288
+ Allowed values: yes, no.
275
289
 
276
- `--db2ctsql` *(string)*
290
+ `--db2ctsql` _(string)_
277
291
  Indicates whether the Collect SQL from Catalog option is enabled for DB2 SQL statements. If you specify db2expl=yes, then db2ctsql must be also set to yes.
278
292
  Default value: no.
279
- Allowed values: yes, no.
293
+ Allowed values: yes, no.
280
294
 
281
- `--db2hvloc` *(string)*
295
+ `--db2hvloc` _(string)_
282
296
  Indicates whether the Requestor Location option is enabled for DB2 measurements.
283
297
  Default value: no.
284
- Allowed values: yes, no.
298
+ Allowed values: yes, no.
285
299
 
286
- `--db2hvcor` *(string)*
300
+ `--db2hvcor` _(string)_
287
301
  Indicates whether the Correlation ID option for SQL statements is enabled for DB2 measurements.
288
302
  Default value: no.
289
- Allowed values: yes, no.
303
+ Allowed values: yes, no.
290
304
 
291
- `--db2hviid` *(string)*
305
+ `--db2hviid` _(string)_
292
306
  Indicates whether the Operator ID option for SQL statements is enabled for DB2 measurements.
293
307
  Default value: no.
294
- Allowed values: yes, no.
308
+ Allowed values: yes, no.
295
309
 
296
- `--db2hvthd` *(string)*
310
+ `--db2hvthd` _(string)_
297
311
  Indicates whether the Thread Address option for SQL statements is enabled for DB2 measurements.
298
312
  Default value: no.
299
- Allowed values: yes, no.
313
+ Allowed values: yes, no.
300
314
 
301
- `--wasexprt` *(string)*
315
+ `--wasexprt` _(string)_
302
316
  Indicates whether the Expert Mode is enabled for Java measurement.
303
317
  Default value: no.
304
- Allowed values: yes, no.
318
+ Allowed values: yes, no.
305
319
 
306
- `--urlfilt` *(string)*
320
+ `--urlfilt` _(string)_
307
321
  A filtering string to restrict monitoring to the specific application URL, transaction, or stored procedure for Java measurements.
308
- Values: a comma separated list of up to 4 values is allowed, max. 64 characters (e.g. mypage1.html,mypage2.html).
322
+ Values: a comma separated list of up to 4 values is allowed, max. 64 characters (e.g. mypage1.html,mypage2.html).
309
323
 
310
- `--sysfilt` *(string)*
324
+ `--sysfilt` _(string)_
311
325
  A filtering string to include the specified system class for Java measurements. If you specify a value for sysfilt, the measurement includes only the classes that match the filtering string pattern.
312
- Values: a comma separated list of up to 3 values is allowed, max. 64 characters (e.g. user1.class,user2.class).
326
+ Values: a comma separated list of up to 3 values is allowed, max. 64 characters (e.g. user1.class,user2.class).
313
327
 
314
- `--schedule` *(string)*
315
- Specifies the name of the schedule that you want to apply to the monitor profile (maximum 8 characters).
328
+ `--schedule` _(string)_
329
+ Specifies the name of the schedule that you want to apply to the monitor profile (maximum 8 characters).
316
330
 
317
331
  **Profile Options**
318
- `--mat-profile` | `--mat-p` *(string)*
319
- Specifies the name of a (mat) profile to load for this command execution.
332
+ `--mat-profile` | `--mat-p` _(string)_
333
+ Specifies the name of a (mat) profile to load for this command execution.
334
+
335
+ **Examples**
336
+
337
+ - Create the PROFILE1 monitor profile to measure job JOB1 that runs on the AA31 system:
320
338
 
321
- **Examples**
322
- * Create the PROFILE1 monitor profile to measure job JOB1 that runs on the AA31 system:
323
339
  ```
324
340
  $ zowe mat profile create --profile PROFILE1 --jobname JOB1 --targsys AA31
325
- ```
341
+ ```
342
+
343
+ - Create the PROFILE1 monitor profile to measure for 90 seconds job JOB1 that runs on the AA31 and AA32 systems:
326
344
 
327
- * Create the PROFILE1 monitor profile to measure for 90 seconds job JOB1 that runs on the AA31 and AA32 systems:
328
345
  ```
329
346
  $ zowe mat profile create --profile PROFILE1 --jobname JOB1 --targsys AA31,AA32 --elapstime 90s
330
- ```
347
+ ```
348
+
349
+ - Create the PROFILE1 monitor profile to measure job JOB1 that runs on the AA31 system, with the specific MAT profile details defined:
331
350
 
332
- * Create the PROFILE1 monitor profile to measure job JOB1 that runs on the AA31 system, with the specific MAT profile details defined:
333
351
  ```
334
352
  $ zowe mat profile create --profile PROFILE1 --jobname JOB1 --targsys AA31 --host "example.com" --port 12345 --user johndoe --password qwerty
335
- ```
353
+ ```
336
354
 
337
355
  ### invoke | ivk
338
- Invoke a MAT monitor profile to start measurement. If you invoke a monitor profile that does currently exist, MAT creates the profile with the provided name and invokes the measurement for this profile.
339
356
 
340
- **Usage**
357
+ Invoke a MAT monitor profile to start measurement. If you invoke a monitor profile that does currently exist, MAT creates the profile with the provided name and invokes the measurement for this profile.
358
+
359
+ **Usage**
360
+
341
361
  ```
342
362
  $ zowe mat profile invoke [options]
343
- ```
363
+ ```
344
364
 
345
365
  **Required Options**
346
- `--profile` *(string)*
366
+ `--profile` _(string)_
347
367
  Specifies the name of the profile in MAT that you invoke (e.g. PROFILE1).
348
- Values: 1 to 8 characters, a combination of alphanumeric and national characters (A-Z, 0-9, and @), the first character must be an alphabetic or @. The profile name must not contain characters # and $.
368
+ Values: 1 to 8 characters, a combination of alphanumeric and national characters (A-Z, 0-9, and @), the first character must be an alphabetic or @. The profile name must not contain characters # and $.
349
369
 
350
- `--jobname` *(string)*
370
+ `--jobname` _(string)_
351
371
  Specifies the name of the job to be measured (e.g. JOB1).
352
- Values: 1 to 8 characters, alphanumeric (A-Z capitals only and 0-9), national (#, $, @), and wildcards (* or %).
372
+ Values: 1 to 8 characters, alphanumeric (A-Z capitals only and 0-9), national (#, $, @), and wildcards (\* or %).
353
373
 
354
- `--targsys` *(string)*
374
+ `--targsys` _(string)_
355
375
  Specifies the target system in SYSPLEX.
356
- Values: a comma separated list of up to 4 values is allowed, maximum 8 characters each, a combination of alphanumeric (A-Z and 0-9) and national (@,#,$), the first character must be an alphabetic (A-Z) or a national (@, #, $) (e.g. AA31,AA32).
376
+ Values: a comma separated list of up to 4 values is allowed, maximum 8 characters each, a combination of alphanumeric (A-Z and 0-9) and national (@,#,$), the first character must be an alphabetic (A-Z) or a national (@, #, $) (e.g. AA31,AA32).
357
377
 
358
378
  **Options**
359
- `--mondsn` *(string)*
379
+ `--mondsn` _(string)_
360
380
  Specifies the monitor data set name where MAT saves the measurement (e.g. DEMO.MAT.MONITOR).
361
- Values: data set name pattern, maximum 46 characters. If not specified, your default MAT monitor DSN pattern is applied.
381
+ Values: data set name pattern, maximum 46 characters. If not specified, your default MAT monitor DSN pattern is applied.
362
382
 
363
- `--moiuuid` *(string)*
383
+ `--moiuuid` _(string)_
364
384
  Specifies the MOI UUID.
365
- Values: maximum 61 characters, alphanumeric (A-Z and 0-9). If you use this parameter for command execution, the value cannot be blank.
385
+ Values: maximum 61 characters, alphanumeric (A-Z and 0-9). If you use this parameter for command execution, the value cannot be blank.
366
386
 
367
- `--moitimestamp` *(string)*
387
+ `--moitimestamp` _(string)_
368
388
  Specifies the MOI timestamp.
369
- Values: maximum 12 characters, numbers only (0-9). If you use this parameter for command execution, the value cannot be blank.
389
+ Values: maximum 12 characters, numbers only (0-9). If you use this parameter for command execution, the value cannot be blank.
370
390
 
371
- `--listing` *(boolean)*
372
- 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.
391
+ `--listing` _(boolean)_
392
+ 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.
373
393
 
374
394
  **Profile Options**
375
395
  `--mat-profile` | `--mat-p` (string)
376
- The name of a (mat) profile to load for this command execution.
396
+ The name of a (mat) profile to load for this command execution.
397
+
398
+ **Examples**
399
+
400
+ - Invoke the PROFILE1 monitor profile to measure job JOB1 that runs on the AA31 system:
377
401
 
378
- **Examples**
379
- * Invoke the PROFILE1 monitor profile to measure job JOB1 that runs on the AA31 system:
380
402
  ```
381
403
  $ zowe mat profile invoke --profile PROFILE1 --jobname JOB1 --targsys AA31
382
- ```
383
- * Invoke the PROFILE1 monitor profile to measure job JOB1 that runs on the AA31 system and save the measurement result in the DEMO.MAT.MONITOR.PROFILE1 data set:
404
+ ```
405
+
406
+ - Invoke the PROFILE1 monitor profile to measure job JOB1 that runs on the AA31 system and save the measurement result in the DEMO.MAT.MONITOR.PROFILE1 data set:
407
+
384
408
  ```
385
409
  $ zowe mat profile invoke --profile PROFILE1 --jobname JOB1 --targsys AA31 --mondsn DEMO.MAT.MONITOR.PROFILE1
386
- ```
387
- * Invoke the PROFILE1 monitor profile to measure job JOB1 that runs on the AA31 system and register the program listing:
410
+ ```
411
+
412
+ - Invoke the PROFILE1 monitor profile to measure job JOB1 that runs on the AA31 system and register the program listing:
413
+
388
414
  ```
389
415
  $ zowe mat profile invoke --profile PROFILE1 --jobname JOB1 --targsys AA31 --listing
390
- ```
391
- * Invoke the PROFILE1 monitor profile to measure job JOB1 that runs on the AA31 system, with the specific MAT profile details defined:
416
+ ```
417
+
418
+ - Invoke the PROFILE1 monitor profile to measure job JOB1 that runs on the AA31 system, with the specific MAT profile details defined:
419
+
392
420
  ```
393
421
  $ zowe mat profile invoke --profile PROFILE1 --jobname JOB1 --targsys AA31 --host "example.com" --port 12345 --user johndoe --password qwerty
394
- ```
422
+ ```
395
423
 
396
424
  ### list | lip
397
- Get the list of available monitor profiles.
398
425
 
399
- **Usage**
426
+ Get the list of available monitor profiles.
427
+
428
+ **Usage**
429
+
400
430
  ```
401
431
  $ zowe mat profile list [options]
402
- ```
432
+ ```
403
433
 
404
434
  **Profile Options**
405
- `--mat-profile` | `--mat-p` *(string)*
406
- The name of a (mat) profile to load for this command execution.
435
+ `--mat-profile` | `--mat-p` _(string)_
436
+ The name of a (mat) profile to load for this command execution.
407
437
 
408
438
  ## MONITOR
409
- The commands from the MONITOR group enable you to get monitor history and measurement analysis data from MAT.
410
439
 
411
- **Usage**
440
+ The commands from the MONITOR group enable you to get monitor history and measurement analysis data from MAT.
441
+
442
+ **Usage**
443
+
412
444
  ```
413
445
  $ zowe mat monitor <command|group>
414
- ```
446
+ ```
415
447
 
416
- The following **commands** are available for the MONITOR group:
448
+ The following **commands** are available for the MONITOR group:
417
449
 
418
450
  ### history | hs
419
- Get the list of all available measurements that are stored in the history of the specific monitor profile.
420
451
 
421
- **Usage**
452
+ Get the list of all available measurements that are stored in the history of the specific monitor profile.
453
+
454
+ **Usage**
455
+
422
456
  ```
423
457
  $ zowe mat monitor history [options]
424
- ```
458
+ ```
425
459
 
426
460
  **Options**
427
- `--profile` *(string)*
428
- Specifies the name of the profile.
461
+ `--profile` _(string)_
462
+ Specifies the name of the profile.
429
463
 
430
464
  **Profile Options**
431
- `--mat-profile` | `--mat-p` *(string)*
432
- The name of a (mat) profile to load for this command execution.
465
+ `--mat-profile` | `--mat-p` _(string)_
466
+ The name of a (mat) profile to load for this command execution.
467
+
468
+ **Examples**
469
+
470
+ - Get the list of all available measurements that are stored in the history of the monitor profile TESTPROF:
433
471
 
434
- **Examples**
435
- * Get the list of all available measurements that are stored in the history of the monitor profile TESTPROF:
436
472
  ```
437
473
  $ zowe mat monitor history --profile TESTPROF
438
- ```
439
- * Get the list of all available measurements that are stored in the history of the monitor profile TESTPROF, with the specific MAT profile details defined:
474
+ ```
475
+
476
+ - Get the list of all available measurements that are stored in the history of the monitor profile TESTPROF, with the specific MAT profile details defined:
477
+
440
478
  ```
441
479
  $ zowe mat monitor history --profile TESTPROF --host "example.com" --port 12345 --user johndoe --password qwerty
442
- ```
480
+ ```
443
481
 
444
482
  ### overview | ov
445
- Get the Overview details of the measurement.
446
483
 
447
- **Usage**
484
+ Get the Overview details of the measurement.
485
+
486
+ **Usage**
487
+
448
488
  ```
449
489
  $ zowe mat monitor overview [options]
450
- ```
490
+ ```
491
+
451
492
  **Options**
452
- `--profile` *(string)*
453
- 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.
493
+ `--profile` _(string)_
494
+ 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.
454
495
 
455
- `--mon_num` *(number)*
456
- Specifies the unique monitor number of the measurement.
496
+ `--mon_num` _(number)_
497
+ Specifies the unique monitor number of the measurement.
457
498
 
458
499
  **Profile Options**
459
- `--mat-profile` | `--mat-p` *(string)*
460
- The name of a (mat) profile to load for this command execution.
500
+ `--mat-profile` | `--mat-p` _(string)_
501
+ The name of a (mat) profile to load for this command execution.
502
+
503
+ **Examples**
504
+
505
+ - Get the measurement overview details for monitor number 5:
461
506
 
462
- **Examples**
463
- * Get the measurement overview details for monitor number 5:
464
507
  ```
465
508
  $ zowe mat monitor overview --mon_num 5
466
- ```
509
+ ```
510
+
511
+ - Get the measurement overview details for the latest monitor in the TESTPROF profile:
467
512
 
468
- * Get the measurement overview details for the latest monitor in the TESTPROF profile:
469
513
  ```
470
514
  $ zowe mat monitor overview --profile TESTPROF
471
- ```
515
+ ```
516
+
517
+ - Get the measurement overview details for monitor number 5, with the specific MAT profile details defined:
472
518
 
473
- * Get the measurement overview details for monitor number 5, with the specific MAT profile details defined:
474
519
  ```
475
520
  $ zowe mat monitor overview --mon_num 5 --host "example.com" --port 12345 --user johndoe --password qwerty
476
- ```
521
+ ```
477
522
 
478
- The following **subgroups** are available for the MONITOR command group:
523
+ The following **subgroups** are available for the MONITOR command group:
479
524
 
480
525
  ### delayview
481
- The commands from the DELAYVIEW group enable you to get the DelayView measurement details.
482
526
 
483
- **Usage**
527
+ The commands from the DELAYVIEW group enable you to get the DelayView measurement details.
528
+
529
+ **Usage**
530
+
484
531
  ```
485
532
  $ zowe mat monitor delayview <command>
486
- ```
533
+ ```
487
534
 
488
- The following **commands** are available for the DELAYVIEW group:
535
+ The following **commands** are available for the DELAYVIEW group:
489
536
 
490
537
  #### delay | de
491
- Get the delay details for the measurement.
492
538
 
493
- **Usage**
539
+ Get the delay details for the measurement.
540
+
541
+ **Usage**
542
+
494
543
  ```
495
544
  $ zowe mat monitor delayview delay [options]
496
- ```
545
+ ```
497
546
 
498
547
  **Options**
499
- `--profile` *(string)*
500
- 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.
548
+ `--profile` _(string)_
549
+ 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.
501
550
 
502
- `--mon_num` *(number)*
503
- Specifies the unique monitor number of the measurement.
551
+ `--mon_num` _(number)_
552
+ Specifies the unique monitor number of the measurement.
504
553
 
505
554
  **Profile Options**
506
- `--mat-profile` | `--mat-p` *(string)*
507
- The name of a (mat) profile to load for this command execution.
555
+ `--mat-profile` | `--mat-p` _(string)_
556
+ The name of a (mat) profile to load for this command execution.
557
+
558
+ **Examples**
559
+
560
+ - Get the DelayView measurement details for monitor number 5:
508
561
 
509
- **Examples**
510
- * Get the DelayView measurement details for monitor number 5:
511
562
  ```
512
563
  $ zowe mat monitor delayview delay --mon_num 5
513
- ```
564
+ ```
565
+
566
+ - Get the DelayView measurement details for the latest monitor in the TESTPROF profile:
514
567
 
515
- * Get the DelayView measurement details for the latest monitor in the TESTPROF profile:
516
568
  ```
517
569
  $ zowe mat monitor delayview delay --profile TESTPROF
518
- ```
570
+ ```
571
+
572
+ - Get the DelayView measurement details for monitor number 5, with the specific MAT profile details defined:
519
573
 
520
- * Get the DelayView measurement details for monitor number 5, with the specific MAT profile details defined:
521
574
  ```
522
575
  $ zowe mat monitor delayview delay --mon_num 5 --host "example.com" --port 12345 --user johndoe --password qwerty
523
- ```
576
+ ```
524
577
 
525
578
  #### address | ad
526
- Get the delay address details for the measurement.
527
579
 
528
- **Usage**
580
+ Get the delay address details for the measurement.
581
+
582
+ **Usage**
583
+
529
584
  ```
530
585
  $ zowe mat monitor delayview address [options]
531
- ```
586
+ ```
532
587
 
533
588
  **Options**
534
- `--profile` *(string)*
535
- 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.
589
+ `--profile` _(string)_
590
+ 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.
536
591
 
537
- `--mon_num` *(number)*
538
- Specifies the unique monitor number of the measurement.
592
+ `--mon_num` _(number)_
593
+ Specifies the unique monitor number of the measurement.
539
594
 
540
- `--majorcategory` *(string)*
541
- 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.
595
+ `--majorcategory` _(string)_
596
+ 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.
542
597
 
543
- `--minorcategory` *(string)*
544
- 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.
598
+ `--minorcategory` _(string)_
599
+ 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.
545
600
 
546
601
  **Profile Options**
547
- `--mat-profile` | `--mat-p` *(string)*
548
- The name of a (mat) profile to load for this command execution.
602
+ `--mat-profile` | `--mat-p` _(string)_
603
+ The name of a (mat) profile to load for this command execution.
604
+
605
+ **Examples**
606
+
607
+ - Get the delay address details for majorcategory "PC routine delay" and minorcategory "PC CALL" for monitor number 5:
549
608
 
550
- **Examples**
551
- * Get the delay address details for majorcategory "PC routine delay" and minorcategory "PC CALL" for monitor number 5:
552
609
  ```
553
610
  $ zowe mat monitor delayview address --mon_num 5 –-majorcategory "PC routine delay" –-minorcategory "PC CALL"
554
- ```
611
+ ```
612
+
613
+ - Get the delay address details for majorcategory "PC routine delay" and minorcategory "PC CALL" for the latest monitor in the TESTPROF profile:
555
614
 
556
- * Get the delay address details for majorcategory "PC routine delay" and minorcategory "PC CALL" for the latest monitor in the TESTPROF profile:
557
615
  ```
558
616
  $ zowe mat monitor delayview address --profile TESTPROF –-majorcategory "PC routine delay" –-minorcategory "PC CALL"
559
- ```
617
+ ```
618
+
619
+ - 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:
560
620
 
561
- * 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:
562
621
  ```
563
622
  $ zowe mat monitor delayview address --mon_num 5 –-majorcategory "PC routine delay" –-minorcategory "PC CALL" --host "example.com" --port 12345 --user johndoe --password qwerty
564
- ```
623
+ ```
565
624
 
566
625
  ### codeview
567
- The commands from the CODEVIEW group enable you to get the CodeView measurement details.
568
626
 
569
- **Usage**
627
+ The commands from the CODEVIEW group enable you to get the CodeView measurement details.
628
+
629
+ **Usage**
630
+
570
631
  ```
571
632
  $ zowe mat monitor codeview <command>
572
- ```
633
+ ```
634
+
635
+ The following **commands** are available for the CODEVIEW group:
573
636
 
574
- The following **commands** are available for the CODEVIEW group:
637
+ #### module | mod
575
638
 
576
- #### module | cm
577
- Get the CodeView measurement details in Module mode.
639
+ Get the CodeView measurement details in Module mode.
640
+
641
+ **Usage**
578
642
 
579
- **Usage**
580
643
  ```
581
644
  $ zowe mat monitor codeview module [options]
582
- ```
645
+ ```
583
646
 
584
647
  **Options**
585
- `--profile` *(string)*
586
- 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.
648
+ `--profile` _(string)_
649
+ 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.
587
650
 
588
- `--mon_num` *(number)*
589
- Specifies the unique monitor number of the measurement.
651
+ `--mon_num` _(number)_
652
+ Specifies the unique monitor number of the measurement.
590
653
 
591
654
  **Profile Options**
592
- `--mat-profile` | `--mat-p` *(string)*
593
- The name of a (mat) profile to load for this command execution.
655
+ `--mat-profile` | `--mat-p` _(string)_
656
+ The name of a (mat) profile to load for this command execution.
657
+
658
+ **Examples**
659
+
660
+ - Get the CodeView measurement details in Module mode for monitor number 5:
594
661
 
595
- **Examples**
596
- * Get the CodeView measurement details in Module mode for monitor number 5:
597
662
  ```
598
663
  $ zowe mat monitor codeview module --mon_num 5
599
- ```
664
+ ```
665
+
666
+ - Get the CodeView measurement details in Module mode for the latest monitor in the TESTPROF profile:
600
667
 
601
- * Get the CodeView measurement details in Module mode for the latest monitor in the TESTPROF profile:
602
668
  ```
603
669
  $ zowe mat monitor codeview module --profile TESTPROF
604
- ```
670
+ ```
671
+
672
+ - Get the CodeView measurement details in Module mode for monitor number 5, with the specific MAT profile details defined:
605
673
 
606
- * Get the CodeView measurement details in Module mode for monitor number 5, with the specific MAT profile details defined:
607
674
  ```
608
675
  $ zowe mat monitor codeview module --mon_num 5 --host "example.com" --port 12345 --user johndoe --password qwerty
609
- ```
610
-
676
+ ```
611
677
 
612
678
  #### csect | cs
613
- Get the CodeView measurement details in Csect mode.
614
679
 
615
- **Usage**
680
+ Get the CodeView measurement details in Csect mode.
681
+
682
+ **Usage**
683
+
616
684
  ```
617
685
  $ zowe mat monitor codeview csect [options]
618
- ```
686
+ ```
619
687
 
620
688
  **Options**
621
- `--profile` *(string)*
622
- 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.
689
+ `--profile` _(string)_
690
+ 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.
691
+
692
+ `--mon_num` _(number)_
693
+ Specifies the unique monitor number of the measurement.
623
694
 
624
- `--mon_num` *(number)*
625
- Specifies the unique monitor number of the measurement.
626
-
627
695
  **Profile Options**
628
- `--mat-profile` | `--mat-p` *(string)*
629
- The name of a (mat) profile to load for this command execution.
696
+ `--mat-profile` | `--mat-p` _(string)_
697
+ The name of a (mat) profile to load for this command execution.
698
+
699
+ **Examples**
700
+
701
+ - Get the CodeView measurement details in Csect mode for monitor number 5:
630
702
 
631
- **Examples**
632
- * Get the CodeView measurement details in Csect mode for monitor number 5:
633
703
  ```
634
704
  $ zowe mat monitor codeview csect --mon_num 5
635
- ```
705
+ ```
706
+
707
+ - Get the CodeView measurement details in Csect mode for the latest monitor in the TESTPROF profile:
636
708
 
637
- * Get the CodeView measurement details in Csect mode for the latest monitor in the TESTPROF profile:
638
709
  ```
639
710
  $ zowe mat monitor codeview csect --profile TESTPROF
640
- ```
711
+ ```
712
+
713
+ - Get the CodeView measurement details in Csect mode for monitor number 5, with the specific MAT profile details defined:
641
714
 
642
- * Get the CodeView measurement details in Csect mode for monitor number 5, with the specific MAT profile details defined:
643
715
  ```
644
716
  $ zowe mat monitor codeview csect --mon_num 5 --host "example.com" --port 12345 --user johndoe --password qwerty
645
- ```
646
-
717
+ ```
647
718
 
648
719
  #### histogram | hsg
649
- Get the Histogram details for the measurement.
650
720
 
651
- **Usage**
721
+ Get the Histogram details for the measurement.
722
+
723
+ **Usage**
724
+
652
725
  ```
653
726
  $ zowe mat monitor codeview histogram [options]
654
- ```
727
+ ```
655
728
 
656
729
  **Options**
657
- `--profile` *(string)*
658
- 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.
730
+ `--profile` _(string)_
731
+ 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.
659
732
 
660
- `--mon_num` *(number)*
661
- Specifies the unique monitor number of the measurement.
733
+ `--mon_num` _(number)_
734
+ Specifies the unique monitor number of the measurement.
662
735
 
663
- `--module` *(string)*
664
- 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 '""').
736
+ `--module` _(string)_
737
+ 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 '""').
665
738
 
666
- `--csect` *(string)*
667
- 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 '""').
739
+ `--csect` _(string)_
740
+ 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 '""').
668
741
 
669
- `--top` *(number)*
670
- 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.
742
+ `--top` _(number)_
743
+ 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.
671
744
 
672
- `--group` *(number)*
673
- 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.
745
+ `--group` _(number)_
746
+ 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.
674
747
 
675
- `--listing` *(boolean)*
748
+ `--listing` _(boolean)_
676
749
  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.
677
750
 
678
751
  **Profile Options**
679
- `--mat-profile` | `--mat-p` *(string)*
680
- The name of a (mat) profile to load for this command execution.
752
+ `--mat-profile` | `--mat-p` _(string)_
753
+ The name of a (mat) profile to load for this command execution.
754
+
755
+ **Examples**
756
+
757
+ - Get the Histogram details with the group size defaulting to 4 bytes for monitor number 5, CSECT name TUNCOB01, module name RUNCOB:
681
758
 
682
- **Examples**
683
- * Get the Histogram details with the group size defaulting to 4 bytes for monitor number 5, CSECT name TUNCOB01, module name RUNCOB:
684
759
  ```
685
760
  $ zowe mat monitor codeview histogram --mon_num 5 --csect "TUNCOB01" --module "RUNCOB"
686
- ```
761
+ ```
762
+
763
+ - 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:
687
764
 
688
- * 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:
689
765
  ```
690
766
  $ zowe mat monitor codeview histogram --profile TESTPROF --csect "TUNCOB01" --module '""' --top 5 --group 32
691
- ```
767
+ ```
768
+
769
+ - 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:
692
770
 
693
- * 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:
694
771
  ```
695
772
  $ zowe mat monitor codeview histogram --mon_num 5 --csect "TUNCOB01" --module "RUNCOB" --top 5 --listing
696
- ```
773
+ ```
774
+
775
+ - 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:
697
776
 
698
- * 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:
699
777
  ```
700
778
  $ zowe mat monitor codeview histogram --mon_num 5 --csect "TUNCOB01" --module "RUNCOB" --host "example.com" --port 12345 --user johndoe --password qwerty
701
- ```
779
+ ```
702
780
 
703
781
  #### callerid | cil
704
- Get the CodeView CallerID details for the specific CSECT and module.
705
782
 
706
- **Usage**
783
+ Get the CodeView CallerID details for the specific CSECT and module.
784
+
785
+ **Usage**
786
+
707
787
  ```
708
788
  $ zowe mat monitor codeview callerid [options]
709
- ```
789
+ ```
710
790
 
711
791
  **Options**
712
- `--profile` *(string)*
713
- 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.
792
+ `--profile` _(string)_
793
+ 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.
714
794
 
715
- `--mon_num` *(number)*
716
- Specifies the unique monitor number of the measurement.
795
+ `--mon_num` _(number)_
796
+ Specifies the unique monitor number of the measurement.
717
797
 
718
- `--module` *(string)*
719
- Specifies the module name that you request the CallerID details 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 '""').
798
+ `--module` _(string)_
799
+ Specifies the module name that you request the CallerID details 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 '""').
720
800
 
721
- `--csect` *(string)*
722
- 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 '""').
801
+ `--csect` _(string)_
802
+ 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 '""').
723
803
 
724
804
  **Profile Options**
725
- `--mat-profile` | `--mat-p` *(string)*
726
- The name of a (mat) profile to load for this command execution.
805
+ `--mat-profile` | `--mat-p` _(string)_
806
+ The name of a (mat) profile to load for this command execution.
807
+
808
+ **Examples**
809
+
810
+ - Get the CallerID details for monitor number 5, CSECT name TUNCOB01, and module name RUNCOB:
727
811
 
728
- **Examples**
729
- * Get the CallerID details for monitor number 5, CSECT name TUNCOB01, and module name RUNCOB:
730
812
  ```
731
813
  $ zowe mat monitor codeview callerid --mon_num 5 --csect "TUNCOB01" --module "RUNCOB"
732
- ```
814
+ ```
733
815
 
734
- * Get the CallerID details for the latest monitor in the TESTPROF profile for CSECT name TUNCOB01, and empty module name:
816
+ - Get the CallerID details for the latest monitor in the profile for CSECT name TUNCOB01, and empty module name:
817
+
818
+ ```
819
+ $ zowe mat monitor codeview callerid --profile TESTPROF --csect "TUNCOB01" --module '""'
735
820
  ```
736
- $ zowe mat monitor codeview callerid --profile TESTPROF --csect "TUNCOB01" --module '""'
737
- ```
738
821
 
739
- * Get the CallerID details for monitor number 5, CSECT name TUNCOB01, and module name RUNCOB, with the specific MAT profile details defined:
822
+ - Get the CallerID details for monitor number 5, CSECT name TUNCOB01, and module name RUNCOB, with the specific MAT profile details defined:
823
+
740
824
  ```
741
825
  $ zowe mat monitor codeview callerid --mon_num 5 --csect "TUNCOB01" --module "RUNCOB" --host "example.com" --port 12345 --user johndoe --password qwerty
742
- ```
826
+ ```
743
827
 
744
828
  ### db2
745
- The commands from the DB2 group enable you to get the DB2 measurement details.
746
829
 
747
- **Usage**
830
+ The commands from the DB2 group enable you to get the DB2 measurement details.
831
+
832
+ **Usage**
833
+
748
834
  ```
749
835
  $ zowe mat monitor db2 <command>
750
- ```
836
+ ```
751
837
 
752
- The following **commands** are available for the DB2 group:
838
+ The following **commands** are available for the DB2 group:
753
839
 
754
840
  #### db2view | db2
755
- Get the DB2View details for the measurement.
756
841
 
757
- **Usage**
842
+ Get the DB2View details for the measurement.
843
+
844
+ **Usage**
845
+
758
846
  ```
759
847
  $ zowe mat monitor db2 db2view [options]
760
- ```
848
+ ```
761
849
 
762
850
  **Options**
763
- `--profile` *(string)*
764
- 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.
851
+ `--profile` _(string)_
852
+ 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.
765
853
 
766
- `--mon_num` *(number)*
767
- Specifies the unique monitor number of the measurement.
768
-
769
- `--top` *(number)*
770
- 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.
854
+ `--mon_num` _(number)_
855
+ Specifies the unique monitor number of the measurement.
771
856
 
857
+ `--top` _(number)_
858
+ 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.
772
859
 
773
860
  **Profile Options**
774
- `--mat-profile` | `--mat-p` *(string)*
775
- The name of a (mat) profile to load for this command execution.
861
+ `--mat-profile` | `--mat-p` _(string)_
862
+ The name of a (mat) profile to load for this command execution.
863
+
864
+ **Examples**
865
+
866
+ - Get the DB2View details for monitor number 5:
776
867
 
777
- **Examples**
778
- * Get the DB2View details for monitor number 5:
779
868
  ```
780
869
  $ zowe mat monitor db2 db2view --mon_num 5
781
- ```
870
+ ```
871
+
872
+ - Get the DB2View details for the latest monitor in the profile, with the top consumer limitation set to 5 top consumers:
782
873
 
783
- * Get the DB2View details for the latest monitor in the TESTPROF profile, with the top consumer limitation set to 5 top consumers:
784
874
  ```
785
875
  $ zowe mat monitor db2 db2view --profile TESTPROF --top 5
786
- ```
876
+ ```
877
+
878
+ - Get the DB2View details for monitor number 5, with the specific MAT profile details defined:
787
879
 
788
- * Get the DB2View details for monitor number 5, with the specific MAT profile details defined:
789
880
  ```
790
881
  $ zowe mat monitor db2 db2view --mon_num 5 --host "example.com" --port 12345 --user johndoe --password qwerty
791
- ```
882
+ ```
792
883
 
793
884
  #### sqlstmt | sql
794
- Get SQL details for the DB2 statement.
795
885
 
796
- **Usage**
886
+ Get SQL details for the DB2 statement.
887
+
888
+ **Usage**
889
+
797
890
  ```
798
891
  $ zowe mat monitor db2 sqlstmt [options]
799
- ```
892
+ ```
800
893
 
801
894
  **Options**
802
- `--profile` *(string)*
803
- 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.
895
+ `--profile` _(string)_
896
+ 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.
804
897
 
805
- `--mon_num` *(number)*
806
- Specifies the unique monitor number of the measurement.
898
+ `--mon_num` _(number)_
899
+ Specifies the unique monitor number of the measurement.
807
900
 
808
- `--dbrm` *(string)*
809
- Specifies the DBRM/Package name that the requested DB2 statement belongs to (e.g., `--dbrm CUPBTSDY`). You get the dbrm value from the 'db2 db2view' command response.
901
+ `--dbrm` _(string)_
902
+ Specifies the DBRM/Package name that the requested DB2 statement belongs to (e.g., `--dbrm CUPBTSDY`). You get the dbrm value from the 'db2 db2view' command response.
810
903
 
811
- `--stmtnum` *(number)*
812
- Specifies the statement number that you request the SQL details for (e.g., `--stmtnum 464`). You get the stmtnum value from the 'db2 db2view' command response.
813
-
814
- `--totalsamps` *(number)*
815
- 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.
904
+ `--stmtnum` _(number)_
905
+ Specifies the statement number that you request the SQL details for (e.g., `--stmtnum 464`). You get the stmtnum value from the 'db2 db2view' command response.
816
906
 
907
+ `--totalsamps` _(number)_
908
+ 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.
817
909
 
818
910
  **Profile Options**
819
- `--mat-profile` | `--mat-p` *(string)*
820
- The name of a (mat) profile to load for this command execution.
911
+ `--mat-profile` | `--mat-p` _(string)_
912
+ The name of a (mat) profile to load for this command execution.
913
+
914
+ **Examples**
915
+
916
+ - Get the DB2 SQL statement details for monitor number 5 for DBRM CUPBTSDY, statement number 464, with total number of taken samples 1:
821
917
 
822
- **Examples**
823
- * Get the DB2 SQL statement details for monitor number 5 for DBRM CUPBTSDY, statement number 464, with total number of taken samples 1:
824
918
  ```
825
919
  $ zowe mat monitor db2 sqlstmt --mon_num 5 --dbrm CUPBTSDY --stmtnum 464 --totalsamps 1
826
- ```
920
+ ```
827
921
 
828
- * Get the DB2 SQL statement details for the latest monitor in the TESTPROF profile, for DBRM CUPBTSDY, statement number 464, with total number of taken samples 1:
922
+ - Get the DB2 SQL statement details for the latest monitor in the profile, for DBRM CUPBTSDY, statement number 464, with total number of taken samples 1:
923
+
924
+ ```
925
+ $ zowe mat monitor db2 sqlstmt --profile TESTPROF --dbrm CUPBTSDY --stmtnum 464 --totalsamps 1
829
926
  ```
830
- $ zowe mat monitor db2 sqlstmt --profile TESTPROF --dbrm CUPBTSDY --stmtnum 464 --totalsamps 1
831
- ```
832
927
 
833
- * Get the DB2 SQL statement details for monitor number 5 for DBRM CUPBTSDY, statement number 464, with total number of taken samples 1, with the specific MAT profile details defined:
928
+ - Get the DB2 SQL statement details for monitor number 5 for DBRM CUPBTSDY, statement number 464, with total number of taken samples 1, with the specific MAT profile details defined:
929
+
834
930
  ```
835
931
  $ zowe mat monitor db2 sqlstmt --mon_num 5 --dbrm CUPBTSDY --stmtnum 464 --totalsamps 1 --host "example.com" --port 12345 --user johndoe --password qwerty
836
- ```
932
+ ```
837
933
 
934
+ ### idms
935
+
936
+ The commands from the idms group enable you to get the IDMS measurement details in DML mode.
937
+
938
+ **Usage**
838
939
 
839
- # Uninstall the MAT Analyze Plug-in for Zowe CLI
840
- To uninstall the MAT Analyze plug-in for Zowe CLI, issue the following command:
841
940
  ```
842
- $ zowe plugins uninstall @broadcom/mat-analyze-for-zowe-cli
843
- ```
941
+ $ zowe mat monitor idms <command>
942
+ ```
943
+
944
+ The following **commands** are available for the IDMS group:
945
+
946
+ #### dml | dml
947
+
948
+ Get the IDMS measurement details in DML mode.
949
+
950
+ **Usage**
951
+
952
+ ```
953
+ $ zowe mat monitor idms dml [options]
954
+ ```
955
+
956
+ **Options**
957
+ `--profile` _(string)_
958
+ 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.
959
+
960
+ `--mon_num` _(number)_
961
+ Specifies the unique monitor number of the measurement.
962
+
963
+ **Profile Options**
964
+ `--mat-profile` | `--mat-p` _(string)_
965
+ The name of a (mat) profile to load for this command execution.
966
+
967
+ **Examples**
968
+
969
+ - Get the dml measurement details for the latest monitor in the TESTPROF profile:
970
+
971
+ ```
972
+ $ zowe mat monitor idms dml --profile TESTPROF
973
+ ```
974
+
975
+ - Get the dml details of the measurement for monitor number 5:
976
+
977
+ ```
978
+ $ zowe mat monitor idms dml --mon_num 5
979
+ ```
980
+
981
+ #### module | mod
982
+
983
+ Get the IDMS measurement details.
984
+
985
+ **Usage**
986
+
987
+ ```
988
+ $ zowe mat monitor idms module [options]
989
+ ```
990
+
991
+ **Options**
992
+ `--profile` _(string)_
993
+ 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.
994
+
995
+ `--mon_num` _(number)_
996
+ Specifies the unique monitor number of the measurement.
997
+
998
+ `--module` _(string)_
999
+ Specifies the module name that you request the details for. The module name can be empty (e.g., --module "IGZCPAC" or --module '""').
1000
+
1001
+ `--taskid` _(number)_
1002
+ Specifies the identifier of the Task that you request the details for.
1003
+
1004
+ `--ruid` _(number)_
1005
+ Specifies the identifier of the Run Unit that you request the details for.
1006
+
1007
+ `--linecmd` _(string)_
1008
+ Specifies the line command to be used for the row data.
1009
+
1010
+ **Profile Options**
1011
+ `--mat-profile` | `--mat-p` _(string)_
1012
+ The name of a (mat) profile to load for this command execution.
1013
+
1014
+ **Examples**
1015
+
1016
+ - Get the idms details of the measurement for the latest monitor in the profile:
1017
+
1018
+ ```
1019
+ $ zowe mat monitor idms module --profile TESTPROF
1020
+ ```
1021
+
1022
+ - Get the module details of the measurement for monitor number 5:
1023
+
1024
+ ```
1025
+ $ zowe mat monitor idms module --mon_num 5
1026
+ ```
1027
+
1028
+ - Specify the module taskid, ruid, and linecmd option of the measurement for the module mode for the TESTPROF profile:
1029
+
1030
+ ```
1031
+ $ zowe mat monitor idms module --profile TESTPROF --module SQLA01D --taskid 1 --ruid 33333 --linecmd dispatch
1032
+ ```
1033
+
1034
+ #### task | ts
844
1035
 
1036
+ Get the IDMS measurement details in Task mode.
845
1037
 
1038
+ **Usage**
1039
+
1040
+ ```
1041
+ $ zowe mat monitor idms task [options]
1042
+ ```
1043
+
1044
+ **Options**
1045
+ `--profile` _(string)_
1046
+ 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.
1047
+
1048
+ `--mon_num` _(number)_
1049
+ Specifies the unique monitor number of the measurement.
1050
+
1051
+ **Profile Options**
1052
+ `--mat-profile` | `--mat-p` _(string)_
1053
+ The name of a (mat) profile to load for this command execution.
1054
+
1055
+ **Examples**
1056
+
1057
+ Get the idms measurement details in Task mode for monitor number 5:
1058
+
1059
+ ```
1060
+ $ zowe mat monitor idms task --mon_num 5
1061
+ ```
1062
+
1063
+ Get the idms measurement details in Task mode for the latest monitor in the profile:
1064
+
1065
+ ```
1066
+ $ zowe mat monitor idms task --profile TESTPROF
1067
+ ```
1068
+
1069
+ ### ims
1070
+
1071
+ The commands from the ims group enable you to get the IMS measurement details.
1072
+
1073
+ **Usage**
1074
+
1075
+ ```
1076
+ $ zowe mat monitor ims <command>
1077
+ ```
1078
+
1079
+ The following **commands** are available for the IMS group:
1080
+
1081
+ #### imsview | imsv
1082
+
1083
+ Get the IMS View details for the measurement.
1084
+
1085
+ **Usage**
1086
+
1087
+ ```
1088
+ $ zowe mat monitor ims imsview [options]
1089
+ ```
1090
+
1091
+ **Options**
1092
+ `--profile` _(string)_
1093
+ 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.
1094
+
1095
+ `--mon_num` _(number)_
1096
+ Specifies the unique monitor number of the measurement.
1097
+
1098
+ **Profile Options**
1099
+ `--mat-profile` | `--mat-p` _(string)_
1100
+ The name of a (mat) profile to load for this command execution.
1101
+
1102
+ **Examples**
1103
+
1104
+ - Get the IMS View details for monitor number 5:
1105
+
1106
+ ```
1107
+ $ zowe mat monitor ims imsview --mon_num 5
1108
+ ```
1109
+
1110
+ - Get the IMS View details for the latest monitor in the profile:
1111
+
1112
+ ```
1113
+ $ zowe mat monitor ims imsview --profile TESTPROF
1114
+ ```
1115
+
1116
+ #### dbdname | dbd
1117
+
1118
+ Get the IMS View DBDName data.
1119
+
1120
+ **Usage**
1121
+
1122
+ ```
1123
+ $ zowe mat monitor ims dbdname [options]
1124
+ ```
1125
+
1126
+ **Options**
1127
+ `--profile` _(string)_
1128
+ 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.
1129
+
1130
+ `--mon_num` _(number)_
1131
+ Specifies the unique monitor number of the measurement.
1132
+
1133
+ **Profile Options**
1134
+ `--mat-profile` | `--mat-p` _(string)_
1135
+ The name of a (mat) profile to load for this command execution.
1136
+
1137
+ **Examples**
1138
+
1139
+ - Get the IMS View DBDName details for monitor number 5:
1140
+
1141
+ ```
1142
+ $ zowe mat monitor ims dbdname --mon_num 5
1143
+ ```
1144
+
1145
+ - Get the IMS View DBDName details for the latest monitor in the profile:
1146
+
1147
+ ```
1148
+ $ zowe mat monitor ims dbdname --profile TESTPROF
1149
+ ```
1150
+
1151
+ #### psbname | psb
1152
+
1153
+ Get the IMS View PSBName measurement details.
1154
+
1155
+ **Usage**
1156
+
1157
+ ```
1158
+ $ zowe mat monitor ims psbname [options]
1159
+ ```
1160
+
1161
+ **Options**
1162
+ `--profile` _(string)_
1163
+ 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.
1164
+
1165
+ `--mon_num` _(number)_
1166
+ Specifies the unique monitor number of the measurement.
1167
+
1168
+ **Profile Options**
1169
+ `--mat-profile` | `--mat-p` _(string)_
1170
+ The name of a (mat) profile to load for this command execution.
1171
+
1172
+ **Examples**
1173
+
1174
+ - Get the IMS View PSBName details for monitor number 5:
1175
+
1176
+ ```
1177
+ $ zowe mat monitor ims psbname --mon_num 5
1178
+ ```
1179
+
1180
+ - Get the IMS View PSBName details for the latest monitor in the profile:
1181
+
1182
+ ```
1183
+ $ zowe mat monitor ims psbname --profile TESTPROF
1184
+ ```
1185
+
1186
+ #### region | reg
1187
+
1188
+ Get the IMS View Region measurement details.
1189
+
1190
+ **Usage**
1191
+
1192
+ ```
1193
+ $ zowe mat monitor ims region [options]
1194
+ ```
1195
+
1196
+ **Options**
1197
+ `--profile` _(string)_
1198
+ 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.
1199
+
1200
+ `--mon_num` _(number)_
1201
+ Specifies the unique monitor number of the measurement.
1202
+
1203
+ **Profile Options**
1204
+ `--mat-profile` | `--mat-p` _(string)_
1205
+ The name of a (mat) profile to load for this command execution.
1206
+
1207
+ **Examples**
1208
+
1209
+ - Get the IMS View Region details for monitor number 5:
1210
+
1211
+ ```
1212
+ $ zowe mat monitor ims region --mon_num 5
1213
+ ```
1214
+
1215
+ - Get the IMS View Region details for the latest monitor in the profile:
1216
+
1217
+ ```
1218
+ $ zowe mat monitor ims region --profile TESTPROF
1219
+ ```
1220
+
1221
+ #### ssa | ssa
1222
+
1223
+ Get the IMS View Region measurement details.
1224
+
1225
+ **Usage**
1226
+
1227
+ ```
1228
+ $ zowe mat monitor ims ssa [options]
1229
+ ```
1230
+
1231
+ **Options**
1232
+ `--profile` _(string)_
1233
+ 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.
1234
+
1235
+ `--mon_num` _(number)_
1236
+ Specifies the unique monitor number of the measurement.
1237
+
1238
+ `--call` _(string)_
1239
+ Specifies the call details for the specified monitor number or profile name.
1240
+
1241
+ `--dbdname` _(string)_
1242
+ Specifies the database details for the specified monitor number or profile name.
1243
+
1244
+ `--psbname` _(string)_
1245
+ Specifies the PSB name details for the specified monitor number or profile name.
1246
+
1247
+ **Profile Options**
1248
+ `--mat-profile` | `--mat-p` _(string)_
1249
+ The name of a (mat) profile to load for this command execution.
1250
+
1251
+ **Examples**
1252
+
1253
+ - Get the IMS View SSA details for monitor number 5 with the specific MAT profile details defined:
1254
+
1255
+ ```
1256
+ $ zowe mat monitor ims ssa --mon_num 5 --call TESTCALL --dbdname TESTDBDNAME --psbname TESTPSBNAME
1257
+ ```
1258
+
1259
+ - Get the IMS View SSA details for the latest monitor in the TESTPROF profile with the specific MAT profile details defined:
1260
+
1261
+ ```
1262
+ $ zowe mat monitor ims ssa --profile TESTPROF --call TESTCALL --dbdname TESTDBDNAME --psbname TESTPSBNAME
1263
+ ```
1264
+
1265
+ #### statement | stat
1266
+
1267
+ Get the IMS View Statement measurement details.
1268
+
1269
+ **Usage**
1270
+
1271
+ ```
1272
+ $ zowe mat monitor ims statement [options]
1273
+ ```
1274
+
1275
+ **Options**
1276
+ `--profile` _(string)_
1277
+ 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.
1278
+
1279
+ `--mon_num` _(number)_
1280
+ Specifies the unique monitor number of the measurement.
1281
+
1282
+ `--trancode` _(string)_
1283
+ Specifies the transaction name for specified monitor number or profile name.
1284
+
1285
+ **Profile Options**
1286
+ `--mat-profile` | `--mat-p` _(string)_
1287
+ The name of a (mat) profile to load for this command execution.
1288
+
1289
+ **Examples**
1290
+
1291
+ - Get the IMS View Statement details for monitor number 5 with trancode:
1292
+
1293
+ ```
1294
+ $ zowe mat monitor ims statement --mon_num 5 --trancode TESTTRANCODE
1295
+ ```
1296
+
1297
+ - Get the IMS View Statement details for the latest monitor in the profile with trancode:
1298
+
1299
+ ```
1300
+ $ zowe mat monitor ims statement --profile TESTPROF --trancode TESTTRANCODE
1301
+ ```
1302
+
1303
+ ### tranview
1304
+
1305
+ The commands from the tranview group enable you to get the TranView measurement details.
1306
+
1307
+ **Usage**
1308
+
1309
+ ```
1310
+ $ zowe mat monitor tranview <command>
1311
+ ```
1312
+
1313
+ The following **commands** are available for the TranView group:
1314
+
1315
+ #### all | all
1316
+
1317
+ Get the TranView measurement details in Module mode.
1318
+
1319
+ **Usage**
1320
+
1321
+ ```
1322
+ $ zowe mat monitor tranview all [options]
1323
+ ```
1324
+
1325
+ **Options**
1326
+ `--profile` _(string)_
1327
+ 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.
1328
+
1329
+ `--mon_num` _(number)_
1330
+ Specifies the unique monitor number of the measurement.
1331
+
1332
+ `--tran` _(string)_
1333
+ 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.
1334
+
1335
+ **Profile Options**
1336
+ `--mat-profile` | `--mat-p` _(string)_
1337
+ The name of a (mat) profile to load for this command execution.
1338
+
1339
+ **Examples**
1340
+
1341
+ - Get the TranView measurement details for monitor number 5:
1342
+
1343
+ ```
1344
+ $ zowe mat monitor tranview all --mon_num 5
1345
+ ```
1346
+
1347
+ - Get the TranView measurement details for the latest monitor in the TESTPROF profile:
1348
+
1349
+ ```
1350
+ $ zowe mat monitor tranview all --profile TESTPROF
1351
+ ```
1352
+
1353
+ #### module | mod
1354
+
1355
+ Get the TranView measurement details.
1356
+
1357
+ **Usage**
1358
+
1359
+ ```
1360
+ $ zowe mat monitor tranview module [options]
1361
+ ```
1362
+
1363
+ **Options**
1364
+ `--profile` _(string)_
1365
+ 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.
1366
+
1367
+ `--mon_num` _(number)_
1368
+ Specifies the unique monitor number of the measurement.
1369
+
1370
+ `--tran` _(string)_
1371
+ 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.
1372
+
1373
+ **Profile Options**
1374
+ `--mat-profile` | `--mat-p` _(string)_
1375
+ The name of a (mat) profile to load for this command execution.
1376
+
1377
+ **Examples**
1378
+
1379
+ - Get the idms details of the measurement for the latest monitor in the profile:
1380
+
1381
+ ```
1382
+ $ zowe mat monitor tranview module --profile TESTPROF
1383
+ ```
1384
+
1385
+ - Get the module details of the measurement for monitor number 5:
1386
+
1387
+ ```
1388
+ $ zowe mat monitor tranview module --mon_num 5
1389
+ ```
1390
+
1391
+ - Specify the module taskid, ruid, and linecmd option of the measurement for the module mode for the TESTPROF profile:
1392
+
1393
+ ```
1394
+ $ zowe mat monitor tranview module --tran MVGT
1395
+ ```
1396
+
1397
+ #### callerid | cid
1398
+
1399
+ Get the caller identifier details.
1400
+
1401
+ **Usage**
1402
+
1403
+ ```
1404
+ $ zowe mat monitor tranview callerid [options]
1405
+ ```
1406
+
1407
+ **Options**
1408
+ `--profile` _(string)_
1409
+ 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.
1410
+
1411
+ `--mon_num` _(number)_
1412
+ Specifies the unique monitor number of the measurement.
1413
+
1414
+ `--tran` _(string)_
1415
+ 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.
1416
+
1417
+ **Profile Options**
1418
+ `--mat-profile` | `--mat-p` _(string)_
1419
+ The name of a (mat) profile to load for this command execution.
1420
+
1421
+ **Examples**
1422
+
1423
+ - Get the caller details for monitor number 5:
1424
+
1425
+ ```
1426
+ $ zowe mat monitor tranview callerid --mon_num 5
1427
+ ```
1428
+
1429
+ - Get the caller details for the latest monitor in the TESTPROF profile:
1430
+
1431
+ ```
1432
+ $ zowe mat monitor tranview callerid --profile TESTPROF
1433
+ ```
1434
+
1435
+ #### callstack | csk
1436
+
1437
+ Get CallStack data in Module mode.
1438
+
1439
+ **Usage**
1440
+
1441
+ ```
1442
+ $ zowe mat monitor tranview callstack [options]
1443
+ ```
1444
+
1445
+ **Options**
1446
+ `--profile` _(string)_
1447
+ 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.
1448
+
1449
+ `--mon_num` _(number)_
1450
+ Specifies the unique monitor number of the measurement.
1451
+
1452
+ `--tran` _(string)_
1453
+ 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.
1454
+
1455
+ **Profile Options**
1456
+ `--mat-profile` | `--mat-p` _(string)_
1457
+ The name of a (mat) profile to load for this command execution.
1458
+
1459
+ **Examples**
1460
+
1461
+ - Get the callstack details for monitor number 5:
1462
+
1463
+ ```
1464
+ $ zowe mat monitor tranview callstack --mon_num 5
1465
+ ```
1466
+
1467
+ - Get the callstack details for the latest monitor in the TESTPROF profile:
1468
+
1469
+ ```
1470
+ $ zowe mat monitor tranview callstack --profile TESTPROF
1471
+ ```
1472
+
1473
+ #### csect | csd
1474
+
1475
+ Get the CodeView details for transaction in Csect mode.
1476
+
1477
+ **Usage**
1478
+
1479
+ ```
1480
+ $ zowe mat monitor tranview csect [options]
1481
+ ```
1482
+
1483
+ **Options**
1484
+ `--profile` _(string)_
1485
+ 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.
1486
+
1487
+ `--mon_num` _(number)_
1488
+ Specifies the unique monitor number of the measurement.
1489
+
1490
+ `--tran` _(string)_
1491
+ 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.
1492
+
1493
+ **Profile Options**
1494
+ `--mat-profile` | `--mat-p` _(string)_
1495
+ The name of a (mat) profile to load for this command execution.
1496
+
1497
+ **Examples**
1498
+
1499
+ - Get the CodeView details for transaction in Csect mode for monitor number 5:
1500
+
1501
+ ```
1502
+ $ zowe mat monitor tranview csect --mon_num 5
1503
+ ```
1504
+
1505
+ - Get the CodeView details for transaction in Csect mode for the latest monitor in the TESTPROF profile:
1506
+
1507
+ ```
1508
+ $ zowe mat monitor tranview csect --profile TESTPROF
1509
+ ```
1510
+
1511
+ - Get the CodeView details for transaction in Csect mode for the monitor number 5 with specific host:
1512
+
1513
+ ```
1514
+ $ zowe mat monitor tranview csect --mon_num 5 --host \"example.com\" --port 12345 --user User1 --password qwerty
1515
+ ```
1516
+
1517
+ #### delay | dl
1518
+
1519
+ Get the delay details for the measurement.
1520
+
1521
+ **Usage**
1522
+
1523
+ ```
1524
+ $ zowe mat monitor tranview delay [options]
1525
+ ```
1526
+
1527
+ **Options**
1528
+ `--profile` _(string)_
1529
+ 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.
1530
+
1531
+ `--mon_num` _(number)_
1532
+ Specifies the unique monitor number of the measurement.
1533
+
1534
+ `--tran` _(string)_
1535
+ 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.
1536
+
1537
+ **Profile Options**
1538
+ `--mat-profile` | `--mat-p` _(string)_
1539
+ The name of a (mat) profile to load for this command execution.
1540
+
1541
+ **Examples**
1542
+
1543
+ - Get the DelayView measurement details of a transaction for monitor number 5:
1544
+
1545
+ ```
1546
+ $ zowe mat monitor tranview delay --mon_num 5
1547
+ ```
1548
+
1549
+ - Get the DelayView measurement details for the latest monitor in the TESTPROF profile:
1550
+
1551
+ ```
1552
+ $ zowe mat monitor tranview delay --profile TESTPROF
1553
+ ```
1554
+
1555
+ - Get the DelayView measurement details for monitor number 5, with the specific MAT profile details defined:
1556
+
1557
+ ```
1558
+ $ zowe mat monitor tranview delay --mon_num 5 --host \"example.com\" --port 12345 --user User1 --password qwerty
1559
+ ```
1560
+
1561
+ #### stat | cis
1562
+
1563
+ Get the CICS statistics details.
1564
+
1565
+ **Usage**
1566
+
1567
+ ```
1568
+ $ zowe mat monitor tranview stat [options]
1569
+ ```
1570
+
1571
+ **Options**
1572
+ `--profile` _(string)_
1573
+ 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.
1574
+
1575
+ `--mon_num` _(number)_
1576
+ Specifies the unique monitor number of the measurement.
1577
+
1578
+ `--tran` _(string)_
1579
+ 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.
1580
+
1581
+ `--type` _(string)_
1582
+ Specifies the type of CICS Transaction.
1583
+ Default value: DISP
1584
+
1585
+ **Profile Options**
1586
+ `--mat-profile` | `--mat-p` _(string)_
1587
+ The name of a (mat) profile to load for this command execution.
1588
+
1589
+ **Examples**
1590
+
1591
+ - Get the CICS statistic details for monitor number 5:
1592
+
1593
+ ```
1594
+ $ zowe mat monitor tranview stat --mon_num 5 --type DB
1595
+ ```
1596
+
1597
+ - Get the CICS statistics details for the latest monitor in the TESTPROF profile:
1598
+
1599
+ ```
1600
+ $ zowe mat monitor tranview stat --profile TESTPROF
1601
+ ```
1602
+
1603
+ # Uninstall the MAT Analyze Plug-in for Zowe CLI
1604
+
1605
+ To uninstall the MAT Analyze plug-in for Zowe CLI, issue the following command:
1606
+
1607
+ ```
1608
+ $ zowe plugins uninstall @broadcom/mat-analyze-for-zowe-cli
1609
+ ```