@broadcom/mat-analyze-for-zowe-cli 1.0.13 → 1.0.15

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