@broadcom/mat-analyze-for-zowe-cli 1.0.7 → 2.0.1

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 (44) hide show
  1. package/CHANGELOG.md +5 -28
  2. package/README.md +121 -100
  3. package/lib/api/MATRest.d.ts +1 -1
  4. package/lib/api/MATRest.js +3 -5
  5. package/lib/api/MATRest.js.map +1 -1
  6. package/lib/cli/monitor/Monitor.definition.js +13 -2
  7. package/lib/cli/monitor/Monitor.definition.js.map +1 -1
  8. package/lib/cli/monitor/codeview/Histogram/Histogram.definition.js +11 -6
  9. package/lib/cli/monitor/codeview/Histogram/Histogram.definition.js.map +1 -1
  10. package/lib/cli/monitor/codeview/Histogram/Histogram.handler.js +42 -20
  11. package/lib/cli/monitor/codeview/Histogram/Histogram.handler.js.map +1 -1
  12. package/lib/cli/monitor/codeview/callerid/Callerid.definition.js +6 -1
  13. package/lib/cli/monitor/codeview/callerid/Callerid.definition.js.map +1 -1
  14. package/lib/cli/monitor/codeview/csect/Csect.definition.js +5 -1
  15. package/lib/cli/monitor/codeview/csect/Csect.definition.js.map +1 -1
  16. package/lib/cli/monitor/codeview/module/Module.definition.js +6 -1
  17. package/lib/cli/monitor/codeview/module/Module.definition.js.map +1 -1
  18. package/lib/cli/monitor/db2/db2view/DB2View.definition.js +6 -2
  19. package/lib/cli/monitor/db2/db2view/DB2View.definition.js.map +1 -1
  20. package/lib/cli/monitor/db2/sqlview/SQLView.definition.js +6 -1
  21. package/lib/cli/monitor/db2/sqlview/SQLView.definition.js.map +1 -1
  22. package/lib/cli/monitor/delayview/address/Address.definition.js +6 -1
  23. package/lib/cli/monitor/delayview/address/Address.definition.js.map +1 -1
  24. package/lib/cli/monitor/delayview/delay/Delay.definition.js +5 -1
  25. package/lib/cli/monitor/delayview/delay/Delay.definition.js.map +1 -1
  26. package/lib/cli/monitor/history/History.definition.js +6 -1
  27. package/lib/cli/monitor/history/History.definition.js.map +1 -1
  28. package/lib/cli/monitor/overview/Overview.definition.js +5 -1
  29. package/lib/cli/monitor/overview/Overview.definition.js.map +1 -1
  30. package/lib/cli/profile/Profile.definition.js +13 -2
  31. package/lib/cli/profile/Profile.definition.js.map +1 -1
  32. package/lib/cli/profile/create/CreateProfile.definition.js +47 -43
  33. package/lib/cli/profile/create/CreateProfile.definition.js.map +1 -1
  34. package/lib/cli/profile/invoke/InvokeProfile.definition.js +14 -9
  35. package/lib/cli/profile/invoke/InvokeProfile.definition.js.map +1 -1
  36. package/lib/cli/profile/listprofile/ListProfile.definition.js +1 -1
  37. package/lib/cli/session/MATSession.d.ts +24 -5
  38. package/lib/cli/session/MATSession.js +97 -31
  39. package/lib/cli/session/MATSession.js.map +1 -1
  40. package/lib/handlers/AbstractRestHandler.js +12 -6
  41. package/lib/handlers/AbstractRestHandler.js.map +1 -1
  42. package/lib/imperative.js +19 -15
  43. package/lib/imperative.js.map +1 -1
  44. package/package.json +16 -16
package/CHANGELOG.md CHANGED
@@ -1,32 +1,9 @@
1
1
  # Change log
2
2
  All notable changes to this project are documented in this file.
3
3
 
4
- ## `1.0.7`
5
- - Security updates
6
-
7
- ## `1.0.6`
8
- - Issue resolution for correct boolean datatype for zowediscoverable/zdis parameter.
9
-
10
- ## `1.0.6`
11
- - Issue resolution for correct boolean datatype for zowediscoverable/zdis parameter.
12
-
13
- ## `1.0.5`
14
- - Program listing support enhancements: The `zowe mat profile invoke` command is enhanced with the `listing` option, which activates the automated retrieval of Cobol, C/C++, and Assembler program listings through CA Endevor® footprints and registers the listing with CA MAT after the measurement is completed. Optional parameter `listingDir` added to the MAT profile options. The parameter defines the local directory to store retrieved listings. The `zowe mat monitor codeview histogram` command is enhanced with the `listing` option that retrieves the program listing details pertaining to the specific statement and CSECT. Users of Visual Studio Code IDE can navigate from the command response in their IDE terminal directly to the specific line and column of the retrieved source code.
15
-
16
- ## `1.0.4`
17
- - Issue resolution for unit test coverage and DB2view related details.
18
-
19
- ## `1.0.3`
20
- - DB2View and SQL statement details added under the DB2 command group
21
- - Removed overrides configuration form imperative.ts.
22
-
23
- ## `1.0.2`
24
- - Enabled CodeView histogram and CodeView CallerID.
25
-
26
- ## `1.0.1`
27
- - Updated License.
28
-
29
- ## `1.0.0`
30
- - Initial release.
31
-
4
+ ## `2.0.1`
5
+ - Update doc
32
6
 
7
+ ## `2.0.0`
8
+ - Release for Zowe v2
9
+ - Changed Endevor package to version 7.0.0
package/README.md CHANGED
@@ -1,27 +1,25 @@
1
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">
2
2
 
3
- # CA MAT Analyze Plug-in for Zowe CLI
4
- The CA MAT Analyze plug-in for Zowe CLI provides access to CA Mainframe Application Tuner (CA MAT) functionality. The plug-in ensures interaction with CA MAT and enables you to measure your mainframe applications and get the analysis data in the form of CA MAT analysis views using Zowe command line interface.
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.
5
5
 
6
- You can use the CA MAT Analyze plug-in for Zowe CLI to perform the following tasks:
6
+ You can use the MAT Analyze plug-in for Zowe CLI to perform the following tasks:
7
7
  * Manage monitor profiles.
8
8
  Create and invoke monitor profiles, view the lists of available profiles, and retrieve the measurement history.
9
9
  * Analyze the measurement data.
10
- Access the measurement data from CA Mainframe Application Tuner that is available to you in the CLI in the form of CA MAT analysis views.
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
11
  * Address performance issues.
12
- With the source program listing registered with CA 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 CA 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.
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
13
 
14
14
 
15
15
  Table of Contents
16
16
  =================
17
17
  * [Installation](#installation)
18
18
  * [Prerequisites](#prerequisites)
19
- * [Install the CA MAT Analyze Plug-in for Zowe CLI From Packages](#install-the-ca-mat-analyze-plug-in-for-zowe-cli-from-packages)
20
- * [Install the CA MAT Analyze Plug-in for Zowe CLI From Source](#install-the-ca-mat-analyze-plug-in-for-zowe-cli-from-source)
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
21
  * [Validate the Installation](#validate-the-installation)
22
- * [Create a z/OSMF Profile](#create-a-zosmf-profile)
23
22
  * [Create a MAT Profile](#create-a-mat-profile)
24
- * [Update a MAT Profile](#update-a-mat-profile)
25
23
  * [Using Profile Options](#using-profile-options)
26
24
  * [Use Cases and Commands](#use-cases-and-commands)
27
25
  * [PROFILE](#profile)
@@ -42,23 +40,22 @@ Table of Contents
42
40
  * [db2](#db2)
43
41
  * [db2view | db2](#db2view--db2)
44
42
  * [sqlstmt | sql](#sqlstmt--sql)
45
- * [Uninstall the CA MAT Analyze Plug-in for Zowe CLI](#uninstall-the-ca-mat-analyze-plug-in-for-zowe-cli)
43
+ * [Uninstall the MAT Analyze Plug-in for Zowe CLI](#uninstall-the-mat-analyze-plug-in-for-zowe-cli)
46
44
 
47
45
 
48
46
 
49
47
  # Installation
50
- You can install the CA MAT Analyze Plug-in for Zowe CLI:
48
+ You can install the MAT Analyze Plug-in for Zowe CLI:
51
49
  * From the Zowe Package
52
50
  * From Source
53
51
 
54
52
  ## Prerequisites
55
- Before starting the installation of the CA MAT Analyze Plug-in for Zowe CLI, verify that you have:
56
- * Zowe CLI installed
57
- * Zosmf profile created.
58
- * CA MAT database and the REST API installed, configured, and running.
59
- * (Optional) To use the automated listing registration and retrieval option through CA Endevor® footprints, install and configure the CA Endevor® Web Services and specify the CA Endevor® web server details in the CA MAT database configuration.
53
+ Before starting the installation of the MAT Analyze Plug-in for Zowe CLI, verify that you have:
54
+ * Zowe CLI installed.
55
+ * MAT database and the REST API installed, configured, and running.
56
+ * (Optional) To use the automated listing registration and retrieval option through Endevor® footprints, install and configure the Endevor® Web Services and specify the Endevor® web server details in the MAT database configuration.
60
57
 
61
- ## Install the CA MAT Analyze Plug-in for Zowe CLI From Packages
58
+ ## Install the MAT Analyze Plug-in for Zowe CLI From Packages
62
59
  Issue the following command:
63
60
 
64
61
  ```
@@ -67,8 +64,8 @@ $ zowe plugins install @broadcom/mat-analyze-for-zowe-cli
67
64
  **Note:**
68
65
  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
66
 
70
- ## Install the CA MAT Analyze Plug-in for Zowe CLI From Source
71
- To install the CA MAT Analyze plug-in for Zowe CLI from source, follow these steps:
67
+ ## Install the MAT Analyze Plug-in for Zowe CLI From Source
68
+ To install the MAT Analyze plug-in for Zowe CLI from source, follow these steps:
72
69
 
73
70
  1. `git clone git@github.gwd.broadcom.net:MFD/mat-analyze-for-zowe-cli.git`
74
71
  2. `cd mat-analyze-for-zowe-cli`
@@ -87,102 +84,68 @@ $ zowe plugins validate @broadcom/mat-analyze-for-zowe-cli
87
84
  ```
88
85
  Successful validation of the plug-in returns the response "This plugin was successfully validated. Enjoy the plugin."
89
86
 
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:
92
-
93
- ```
94
- $ zowe profiles create zosmf-profile --help
95
- ```
96
87
 
97
88
  ## Create a MAT Profile
98
- To enable the interaction of the CA MAT Analyze plug-in for Zowe CLI with CA MAT, you need to create a MAT profile. You set up a CA 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 CA MAT REST API server, and your mainframe username and password. You can create multiple profiles and switch between them if necessary.
89
+ 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 configation file and add a section with the MAT profile details:
99
90
 
100
- **Usage**
101
91
  ```
102
- $ zowe profiles create mat-profile <profileName> [options]
92
+ "mat": {
93
+             "type": "mat",
94
+             "properties": {
95
+                 "host": "example.com",
96
+                 "protocol": "http",
97
+                 "port": "12345",
98
+                 "user": "johndoe",
99
+                 "password": "qwerty",
100
+                 "listingDir": "c:\listings",
101
+                 "rejectUnauthorized": false
102
+             },
103
+             "secure": []
104
+         },
103
105
  ```
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
-
106
+
109
107
  **MAT Profile Options**
110
- `--protocol` | `--prt` *(string)*
108
+ `--protocol` | `--o` *(string)*
111
109
  Specifies the protocol defined for the MAT REST API server (http or https).
112
110
  Allowed values: http, https.
113
111
 
114
- `--hostname` | `--hn` *(string)*
112
+ `--host` | `--H` *(string)*
115
113
  Specifies the hostname or IP address defined for the MAT REST API server (e.g. 127.0.0.0 or localhost).
116
114
 
117
- `--port` | `--pt` *(number)*
115
+ `--port` | `--P` *(number)*
118
116
  Specifies the server port (e.g. 8080).
119
117
 
120
- `--username` | `--user` *(string)*
118
+ `--user` | `--u` *(string)*
121
119
  Your mainframe username.
122
120
 
123
- `--password` | `--pass` *(string)*
121
+ `--password` | `--pw` *(string)*
124
122
  Your mainframe password.
125
123
 
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 CA MAT REST API server settings.
124
+ `--base-path` | `--bp` *(string)*
125
+ The base path for your API mediation layer instance. Specify this option to prepend the base path to all resources when making REST requests. Do not specify this option if you are not using an API mediation layer.
126
+
127
+ `--reject-unauthorized` | `--ru` *(boolean)*
128
+ Reject self-signed certificates.
129
+ Default value: true
128
130
 
129
131
  `--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 CA MAT and listing retrieval through CA Endevor® footprints for Cobol, C/C++, and Assembler programs. When a source program listing is registered with CA 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 CA Endevor® footprints, you need to have the CA Endevor® Web Services installed and configured and specify the CA Endevor® web server details in the CA MAT database configuration. The `--listingDir` parameter is optional.
131
-
132
+ Specifies the directory where you want to store the registered program listings (e.g. 'c:\listings') for your immediate source code inspection. You can use the advantage of automated listing registration with MAT and listing retrieval through Endevor® footprints for Cobol, C/C++, and Assembler programs. When a source program listing is registered with MAT, you can enhance the histogram analysis data with the program listing details that pertain to the specific CSECT and program statement. The listing is transfered to the specified directory, which enables you to navigate directly to the line of the source code in you VS Code IDE and inspect the program statement. To use the listing retrieval option through Endevor® footprints, you need to have the Endevor® Web Services installed and configured and specify the Endevor® web server details in the MAT database configuration. The `--listingDir` parameter is optional.
132
133
 
133
- **Options**
134
- `--overwrite` | `--ow` *(boolean)*
135
- Overwrite the MAT profile when a profile of the same name exists.
134
+ If the details are not specified or if you want to temporarily use different MAT profile settings, you can specify all or some MAT profile details with each command. The MAT profile details that are provided with a command have the highest priority and override all other values. For more information about using profiles in Zowe, see [Using Global Profile Configuration](https://docs.zowe.org/stable/user-guide/cli-using-global-profile-configuration/) in the Zowe documentation.
136
135
 
137
- **Examples**
138
- * Create a MAT profile called 'matprofile' using your CA MAT configuration and REST API details, with the CA 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 CA MAT configuration and the details of the CA 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.
161
-
162
- **Options**
163
- Use the same options as for the create profile operation, and define only the new values that you want update.
164
-
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.
171
-
172
- You can also have other MAT connection options apart from the MAT profile and use them as options in the commands.
173
136
 
174
137
  # Use Cases and Commands
175
- The CA MAT Analyze plug-in for Zowe CLI enables you to manage monitor profiles and get the measurement analysis data using CA Mainframe Application Tuner (CA MAT).
138
+ The MAT Analyze plug-in for Zowe CLI enables you to manage monitor profiles and get the measurement analysis data using Mainframe Application Tuner (MAT).
176
139
  ```
177
140
  $ zowe mat <group>
178
141
  ```
179
142
 
180
- The CA MAT Analyze plug-in for Zowe CLI commands are organized in the following **command groups**:
143
+ The MAT Analyze plug-in for Zowe CLI commands are organized in the following **command groups**:
181
144
 
182
145
 
183
146
 
184
147
  ## PROFILE
185
- The commands from the PROFILE group enable you to create, invoke, and list CA MAT monitor profiles.
148
+ The commands from the PROFILE group enable you to create, invoke, and list MAT monitor profiles.
186
149
 
187
150
  **Usage**
188
151
  ```
@@ -192,7 +155,7 @@ $ zowe mat profile <command>
192
155
  The following **commands** are available for the PROFILE group:
193
156
 
194
157
  ### create | cr
195
- Create a CA MAT monitor profile.
158
+ Create a MAT monitor profile.
196
159
 
197
160
  **Usage**
198
161
  ```
@@ -201,7 +164,7 @@ $ zowe mat profile create [options]
201
164
 
202
165
  **Required Options**
203
166
  `--profile` *(string)*
204
- Specifies the name of the profile that you create in CA MAT (e.g. PROFILE1).
167
+ Specifies the name of the profile that you create in MAT (e.g. PROFILE1).
205
168
  Values: 1 to 8 characters, a combination of alphanumeric and national characters (A-Z, 0-9, and @), the first character must be an alphabetic or @. The profile name must not contain characters # and $.
206
169
 
207
170
  `--jobname` *(string)*
@@ -222,8 +185,8 @@ Allowed values: yes, no.
222
185
  Provide the monitor description (maximum 24 characters).
223
186
 
224
187
  `--mondsn` *(string)*
225
- Specifies the monitor data set name where CA MAT saves the measurement (e.g. DEMO.MAT.MONITOR).
226
- Values: data set name pattern, maximum 46 characters. If not specified, your default CA MAT monitor DSN pattern is applied.
188
+ Specifies the monitor data set name where MAT saves the measurement (e.g. DEMO.MAT.MONITOR).
189
+ Values: data set name pattern, maximum 46 characters. If not specified, your default MAT monitor DSN pattern is applied.
227
190
 
228
191
  `--stepname` *(string)*
229
192
  Specifies the name of the job step to monitor.
@@ -366,8 +329,13 @@ $ zowe mat profile create --profile PROFILE1 --jobname JOB1 --targsys AA31
366
329
  $ zowe mat profile create --profile PROFILE1 --jobname JOB1 --targsys AA31,AA32 --elapstime 90s
367
330
  ```
368
331
 
332
+ * Create the PROFILE1 monitor profile to measure job JOB1 that runs on the AA31 system, with the specific MAT profile details defined:
333
+ ```
334
+ $ zowe mat profile create --profile PROFILE1 --jobname JOB1 --targsys AA31 --host "example.com" --port 12345 --user johndoe --password qwerty
335
+ ```
336
+
369
337
  ### invoke | ivk
370
- Invoke a CA MAT monitor profile to start measurement. If you invoke a monitor profile that does currently exist, CA MAT creates the profile with the provided name and invokes the measurement for this profile.
338
+ Invoke a MAT monitor profile to start measurement. If you invoke a monitor profile that does currently exist, MAT creates the profile with the provided name and invokes the measurement for this profile.
371
339
 
372
340
  **Usage**
373
341
  ```
@@ -376,7 +344,7 @@ $ zowe mat profile invoke [options]
376
344
 
377
345
  **Required Options**
378
346
  `--profile` *(string)*
379
- Specifies the name of the profile in CA MAT that you invoke (e.g. PROFILE1).
347
+ Specifies the name of the profile in MAT that you invoke (e.g. PROFILE1).
380
348
  Values: 1 to 8 characters, a combination of alphanumeric and national characters (A-Z, 0-9, and @), the first character must be an alphabetic or @. The profile name must not contain characters # and $.
381
349
 
382
350
  `--jobname` *(string)*
@@ -389,8 +357,8 @@ Values: a comma separated list of up to 4 values is allowed, maximum 8 character
389
357
 
390
358
  **Options**
391
359
  `--mondsn` *(string)*
392
- Specifies the monitor data set name where CA MAT saves the measurement (e.g. DEMO.MAT.MONITOR).
393
- Values: data set name pattern, maximum 46 characters. If not specified, your default CA MAT monitor DSN pattern is applied.
360
+ Specifies the monitor data set name where MAT saves the measurement (e.g. DEMO.MAT.MONITOR).
361
+ Values: data set name pattern, maximum 46 characters. If not specified, your default MAT monitor DSN pattern is applied.
394
362
 
395
363
  `--moiuuid` *(string)*
396
364
  Specifies the MOI UUID.
@@ -401,7 +369,7 @@ Specifies the MOI timestamp.
401
369
  Values: maximum 12 characters, numbers only (0-9). If you use this parameter for command execution, the value cannot be blank.
402
370
 
403
371
  `--listing` *(boolean)*
404
- Activates automated registration of Cobol, C/C++, and Assembler program listings through CA Endevor® footprints. After completion of the measurement that you invoke with the '--listing' parameter, the CA MAT Analyze plug-in for Zowe CLI automatically retrieves the program listing that is associated with the monitored job and registers the listing with CA 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.
372
+ Activates automated registration of Cobol, C/C++, and Assembler program listings through Endevor® footprints. After completion of the measurement that you invoke with the '--listing' parameter, the MAT Analyze plug-in for Zowe CLI automatically retrieves the program listing that is associated with the monitored job and registers the listing with MAT. A registered program listing enhances the analysis possibilities of the 'codeview histogram' command and enables you to inspect the source code statements that are associated with specific modules and CSECTs.
405
373
 
406
374
  **Profile Options**
407
375
  `--mat-profile` | `--mat-p` (string)
@@ -420,6 +388,10 @@ $ zowe mat profile invoke --profile PROFILE1 --jobname JOB1 --targsys AA31 --mon
420
388
  ```
421
389
  $ zowe mat profile invoke --profile PROFILE1 --jobname JOB1 --targsys AA31 --listing
422
390
  ```
391
+ * Invoke the PROFILE1 monitor profile to measure job JOB1 that runs on the AA31 system, with the specific MAT profile details defined:
392
+ ```
393
+ $ zowe mat profile invoke --profile PROFILE1 --jobname JOB1 --targsys AA31 --host "example.com" --port 12345 --user johndoe --password qwerty
394
+ ```
423
395
 
424
396
  ### list | lip
425
397
  Get the list of available monitor profiles.
@@ -434,7 +406,7 @@ $ zowe mat profile list [options]
434
406
  The name of a (mat) profile to load for this command execution.
435
407
 
436
408
  ## MONITOR
437
- The commands from the MONITOR group enable you to get monitor history and measurement analysis data from CA MAT.
409
+ The commands from the MONITOR group enable you to get monitor history and measurement analysis data from MAT.
438
410
 
439
411
  **Usage**
440
412
  ```
@@ -464,6 +436,10 @@ The name of a (mat) profile to load for this command execution.
464
436
  ```
465
437
  $ zowe mat monitor history --profile TESTPROF
466
438
  ```
439
+ * Get the list of all available measurements that are stored in the history of the monitor profile TESTPROF, with the specific MAT profile details defined:
440
+ ```
441
+ $ zowe mat monitor history --profile TESTPROF --host "example.com" --port 12345 --user johndoe --password qwerty
442
+ ```
467
443
 
468
444
  ### overview | ov
469
445
  Get the Overview details of the measurement.
@@ -494,6 +470,11 @@ $ zowe mat monitor overview --mon_num 5
494
470
  $ zowe mat monitor overview --profile TESTPROF
495
471
  ```
496
472
 
473
+ * Get the measurement overview details for monitor number 5, with the specific MAT profile details defined:
474
+ ```
475
+ $ zowe mat monitor overview --mon_num 5 --host "example.com" --port 12345 --user johndoe --password qwerty
476
+ ```
477
+
497
478
  The following **subgroups** are available for the MONITOR command group:
498
479
 
499
480
  ### delayview
@@ -536,6 +517,11 @@ $ zowe mat monitor delayview delay --mon_num 5
536
517
  $ zowe mat monitor delayview delay --profile TESTPROF
537
518
  ```
538
519
 
520
+ * Get the DelayView measurement details for monitor number 5, with the specific MAT profile details defined:
521
+ ```
522
+ $ zowe mat monitor delayview delay --mon_num 5 --host "example.com" --port 12345 --user johndoe --password qwerty
523
+ ```
524
+
539
525
  #### address | ad
540
526
  Get the delay address details for the measurement.
541
527
 
@@ -572,6 +558,11 @@ $ zowe mat monitor delayview address --mon_num 5 –-majorcategory "PC routine d
572
558
  $ zowe mat monitor delayview address --profile TESTPROF –-majorcategory "PC routine delay" –-minorcategory "PC CALL"
573
559
  ```
574
560
 
561
+ * Get the delay address details for majorcategory "PC routine delay" and minorcategory "PC CALL" for monitor number 5, with the specific MAT profile details defined:
562
+ ```
563
+ $ zowe mat monitor delayview address --mon_num 5 –-majorcategory "PC routine delay" –-minorcategory "PC CALL" --host "example.com" --port 12345 --user johndoe --password qwerty
564
+ ```
565
+
575
566
  ### codeview
576
567
  The commands from the CODEVIEW group enable you to get the CodeView measurement details.
577
568
 
@@ -612,6 +603,11 @@ $ zowe mat monitor codeview module --mon_num 5
612
603
  $ zowe mat monitor codeview module --profile TESTPROF
613
604
  ```
614
605
 
606
+ * Get the CodeView measurement details in Module mode for monitor number 5, with the specific MAT profile details defined:
607
+ ```
608
+ $ zowe mat monitor codeview module --mon_num 5 --host "example.com" --port 12345 --user johndoe --password qwerty
609
+ ```
610
+
615
611
 
616
612
  #### csect | cs
617
613
  Get the CodeView measurement details in Csect mode.
@@ -643,6 +639,11 @@ $ zowe mat monitor codeview csect --mon_num 5
643
639
  $ zowe mat monitor codeview csect --profile TESTPROF
644
640
  ```
645
641
 
642
+ * Get the CodeView measurement details in Csect mode for monitor number 5, with the specific MAT profile details defined:
643
+ ```
644
+ $ zowe mat monitor codeview csect --mon_num 5 --host "example.com" --port 12345 --user johndoe --password qwerty
645
+ ```
646
+
646
647
 
647
648
  #### histogram | hsg
648
649
  Get the Histogram details for the measurement.
@@ -666,13 +667,13 @@ Specifies the module name that you request the Histogram data for. You get the m
666
667
  Specifies the CSECT name that you request the Histogram data for. You get the csect value from the 'codeview csect' command response. The CSECT name can be empty (e.g., --csect "TUNCOB01" or --module '""').
667
668
 
668
669
  `--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 CA MAT has detected during the measurement. The --top parameter is optional. Values: numbers between 0 and 300.
670
+ Specifies the maximum number of the top consuming CSECT activity locations that you want to obtain in the response (e.g., --top 5). If you specify --top 0, you get the list of all CSECT activity locations that MAT has detected during the measurement. The --top parameter is optional. Values: numbers between 0 and 300.
670
671
 
671
672
  `--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 CA MAT, the group parameter is ignored. The --group parameter is optional.
673
+ Specifies the histogram group size parameter that defines the resolution of the histogram. If you do not specify the group parameter, the group size defaults to 4 bytes (e.g., --group 32). If program listing is registered with MAT, the group parameter is ignored. The --group parameter is optional.
673
674
 
674
675
  `--listing` *(boolean)*
675
- 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 CA Endevor® Web Services and have the program listing for the specific measurement registered with CA MAT. The source code listing is retrieved through CA 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
+ 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
677
 
677
678
  **Profile Options**
678
679
  `--mat-profile` | `--mat-p` *(string)*
@@ -694,6 +695,11 @@ $ zowe mat monitor codeview histogram --profile TESTPROF --csect "TUNCOB01" --mo
694
695
  $ zowe mat monitor codeview histogram --mon_num 5 --csect "TUNCOB01" --module "RUNCOB" --top 5 --listing
695
696
  ```
696
697
 
698
+ * Get the Histogram details with the group size defaulting to 4 bytes for monitor number 5, CSECT name TUNCOB01, module name RUNCOB, with the specific MAT profile details defined:
699
+ ```
700
+ $ zowe mat monitor codeview histogram --mon_num 5 --csect "TUNCOB01" --module "RUNCOB" --host "example.com" --port 12345 --user johndoe --password qwerty
701
+ ```
702
+
697
703
  #### callerid | cil
698
704
  Get the CodeView CallerID details for the specific CSECT and module.
699
705
 
@@ -730,6 +736,11 @@ $ zowe mat monitor codeview callerid --mon_num 5 --csect "TUNCOB01" --module "RU
730
736
  $ zowe mat monitor codeview callerid --profile TESTPROF --csect "TUNCOB01" --module '""'
731
737
  ```
732
738
 
739
+ * Get the CallerID details for monitor number 5, CSECT name TUNCOB01, and module name RUNCOB, with the specific MAT profile details defined:
740
+ ```
741
+ $ zowe mat monitor codeview callerid --mon_num 5 --csect "TUNCOB01" --module "RUNCOB" --host "example.com" --port 12345 --user johndoe --password qwerty
742
+ ```
743
+
733
744
  ### db2
734
745
  The commands from the DB2 group enable you to get the DB2 measurement details.
735
746
 
@@ -756,7 +767,7 @@ Specifies the name of the profile that you want to analyze. When you specify the
756
767
  Specifies the unique monitor number of the measurement.
757
768
 
758
769
  `--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 CA MAT has detected during the measurement. The --top parameter is optional. Values: numbers between 0 and 300.
770
+ Specifies the maximum number of the top consuming DB2 statements that you want to obtain in the response (e.g., --top 5). If you specify --top 0, you get the list of of all DB2 statements that MAT has detected during the measurement. The --top parameter is optional. Values: numbers between 0 and 300.
760
771
 
761
772
 
762
773
  **Profile Options**
@@ -774,6 +785,11 @@ $ zowe mat monitor db2 db2view --mon_num 5
774
785
  $ zowe mat monitor db2 db2view --profile TESTPROF --top 5
775
786
  ```
776
787
 
788
+ * Get the DB2View details for monitor number 5, with the specific MAT profile details defined:
789
+ ```
790
+ $ zowe mat monitor db2 db2view --mon_num 5 --host "example.com" --port 12345 --user johndoe --password qwerty
791
+ ```
792
+
777
793
  #### sqlstmt | sql
778
794
  Get SQL details for the DB2 statement.
779
795
 
@@ -814,9 +830,14 @@ $ zowe mat monitor db2 sqlstmt --mon_num 5 --dbrm CUPBTSDY --stmtnum 464 --total
814
830
  $ zowe mat monitor db2 sqlstmt --profile TESTPROF --dbrm CUPBTSDY --stmtnum 464 --totalsamps 1
815
831
  ```
816
832
 
833
+ * Get the DB2 SQL statement details for monitor number 5 for DBRM CUPBTSDY, statement number 464, with total number of taken samples 1, with the specific MAT profile details defined:
834
+ ```
835
+ $ zowe mat monitor db2 sqlstmt --mon_num 5 --dbrm CUPBTSDY --stmtnum 464 --totalsamps 1 --host "example.com" --port 12345 --user johndoe --password qwerty
836
+ ```
837
+
817
838
 
818
- # Uninstall the CA MAT Analyze Plug-in for Zowe CLI
819
- To uninstall the CA MAT Analyze plug-in for Zowe CLI, issue the following command:
839
+ # Uninstall the MAT Analyze Plug-in for Zowe CLI
840
+ To uninstall the MAT Analyze plug-in for Zowe CLI, issue the following command:
820
841
  ```
821
842
  $ zowe plugins uninstall @broadcom/mat-analyze-for-zowe-cli
822
843
  ```
@@ -21,7 +21,7 @@ export declare class MATRest {
21
21
  static readonly ANALYSIS_CODEVIEW_CALLERID: string;
22
22
  static readonly ANALYSIS_CODEVIEW_HISTOGRAM: string;
23
23
  static readonly TOKEN_OFFSET = 25;
24
- static GetAuth(session: AbstractSession, username: string, password: string, endpoint: string): Promise<IAuth>;
24
+ static GetAuth(session: AbstractSession, endpoint: string): Promise<IAuth>;
25
25
  static sendGetRequest<T extends IResponse>(session: AbstractSession, resource: string, headers?: any[], parameters?: Map<string, object>): Promise<T>;
26
26
  static sendPostRequest<T extends IResponse>(session: AbstractSession, resource: string, headers?: any[], payload?: any): Promise<T>;
27
27
  static sendPostRequestWithParm<T extends IResponse>(session: AbstractSession, resource: string, headers?: any[], parameters?: Map<string, object>, payload?: any): Promise<T>;
@@ -34,13 +34,11 @@ Object.defineProperty(exports, "__esModule", { value: true });
34
34
  exports.MATRest = void 0;
35
35
  const imperative_1 = require("@zowe/imperative");
36
36
  class MATRest {
37
- static GetAuth(session, username, password, endpoint) {
37
+ // public static async GetAuth(session: AbstractSession, username: string, password: string, endpoint: string): Promise<IAuth> {
38
+ static GetAuth(session, endpoint) {
38
39
  return __awaiter(this, void 0, void 0, function* () {
39
- const auth = "Basic " + Buffer.from(username + ":" + password).toString("base64");
40
- const header = { Authorization: auth };
41
40
  const resource = endpoint + MATRest.AUTH;
42
- const headers = [header];
43
- const response = yield this.sendPostRequest(session, resource, headers);
41
+ const response = yield this.sendPostRequest(session, resource);
44
42
  return response;
45
43
  });
46
44
  }
@@ -1 +1 @@
1
- {"version":3,"file":"MATRest.js","sourceRoot":"","sources":["../../src/api/MATRest.ts"],"names":[],"mappings":"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"}
1
+ {"version":3,"file":"MATRest.js","sourceRoot":"","sources":["../../src/api/MATRest.ts"],"names":[],"mappings":"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"}
@@ -39,12 +39,23 @@ const CodeviewDefinition = require("./codeview/Codeview.definition");
39
39
  const DelayviewDefinition = require("./delayview/Delayview.definition");
40
40
  const DB2Definition = require("./db2/DB2.definition");
41
41
  const History_definition_1 = require("./history/History.definition");
42
+ const MATSession_1 = require("../session/MATSession");
42
43
  const MonitorDefinition = {
43
44
  name: "monitor",
44
45
  summary: "Get monitor data",
45
- description: "Get monitor history and measurement analysis data from CA MAT.",
46
+ description: "Get monitor history and measurement analysis data from MAT.",
46
47
  type: "group",
47
- children: [Overview_definition_1.OverviewDefinition, CodeviewDefinition, DelayviewDefinition, History_definition_1.HistoryDefinition, DB2Definition]
48
+ children: [Overview_definition_1.OverviewDefinition, CodeviewDefinition, DelayviewDefinition, History_definition_1.HistoryDefinition, DB2Definition],
49
+ passOn: [
50
+ {
51
+ property: "options",
52
+ value: MATSession_1.MATSession.PMA_CONNECTION_OPTIONS,
53
+ merge: true,
54
+ ignoreNodes: [
55
+ { type: "group" }
56
+ ]
57
+ }
58
+ ]
48
59
  };
49
60
  module.exports = MonitorDefinition;
50
61
  //# sourceMappingURL=Monitor.definition.js.map
@@ -1 +1 @@
1
- {"version":3,"file":"Monitor.definition.js","sourceRoot":"","sources":["../../../src/cli/monitor/Monitor.definition.ts"],"names":[],"mappings":";AAAA;;;;;;;;;;;;;;;;;;;;;GAqBG;AAGH;;;;;;;;;;;;GAYG;AACH,wEAAoE;AACpE,qEAAsE;AACtE,wEAAyE;AACzE,sDAAuD;AAEvD,qEAAiE;AACjE,MAAM,iBAAiB,GAAuB;IAC1C,IAAI,EAAE,SAAS;IACf,OAAO,EAAE,kBAAkB;IAC3B,WAAW,EAAE,gEAAgE;IAC7E,IAAI,EAAE,OAAO;IACb,QAAQ,EAAE,CAAC,wCAAkB,EAAE,kBAAkB,EAAE,mBAAmB,EAAE,sCAAiB,EAAE,aAAa,CAAC;CAC5G,CAAC;AAEF,iBAAS,iBAAiB,CAAC"}
1
+ {"version":3,"file":"Monitor.definition.js","sourceRoot":"","sources":["../../../src/cli/monitor/Monitor.definition.ts"],"names":[],"mappings":";AAAA;;;;;;;;;;;;;;;;;;;;;GAqBG;AAGH;;;;;;;;;;;;GAYG;AACH,wEAAoE;AACpE,qEAAsE;AACtE,wEAAyE;AACzE,sDAAuD;AAEvD,qEAAiE;AACjE,sDAAmD;AACnD,MAAM,iBAAiB,GAAuB;IAC1C,IAAI,EAAE,SAAS;IACf,OAAO,EAAE,kBAAkB;IAC3B,WAAW,EAAE,6DAA6D;IAC1E,IAAI,EAAE,OAAO;IACb,QAAQ,EAAE,CAAC,wCAAkB,EAAE,kBAAkB,EAAE,mBAAmB,EAAE,sCAAiB,EAAE,aAAa,CAAC;IACzG,MAAM,EAAE;QACJ;YACI,QAAQ,EAAE,SAAS;YACnB,KAAK,EAAE,uBAAU,CAAC,sBAAsB;YACxC,KAAK,EAAE,IAAI;YACX,WAAW,EAAE;gBACT,EAAC,IAAI,EAAE,OAAO,EAAC;aAClB;SACJ;KACJ;CACJ,CAAC;AAEF,iBAAS,iBAAiB,CAAC"}
@@ -31,7 +31,7 @@ exports.HistogramDefinition = {
31
31
  type: "command",
32
32
  handler: __dirname + "/Histogram.handler",
33
33
  profile: {
34
- required: ["mat"]
34
+ optional: ["mat"]
35
35
  },
36
36
  options: [
37
37
  {
@@ -64,7 +64,7 @@ exports.HistogramDefinition = {
64
64
  name: "group",
65
65
  description: "Specifies the histogram group size parameter that defines the resolution of the histogram " +
66
66
  "(e.g., --group 32). If you do not specify the group parameter, the group size value defaults to 4 bytes. " +
67
- "If the source program listing is registered with CA MAT, the group size parameter is ignored. " +
67
+ "If the source program listing is registered with MAT, the group size parameter is ignored. " +
68
68
  "The --group parameter is optional. " +
69
69
  "Lower values of the --group parameter result in more granular representation of the histogram data. " +
70
70
  "Values: numbers between 2 and 999999.",
@@ -74,16 +74,16 @@ exports.HistogramDefinition = {
74
74
  name: "top",
75
75
  description: "Specifies the maximum number of the top consuming CSECT activity locations " +
76
76
  "that you want to obtain in the response (e.g., --top 5). If you specify --top 0, " +
77
- "you get the list of all CSECT activity locations that CA MAT has detected during the measurement." +
77
+ "you get the list of all CSECT activity locations that MAT has detected during the measurement." +
78
78
  "The --top parameter is optional. Values: numbers between 0 and 300.",
79
79
  type: "number"
80
80
  },
81
81
  {
82
82
  name: "listing",
83
83
  description: "Enables you to retrieve program listing details that pertain to the specific CSECT and statement. " +
84
- "To use the listing retrieval option, you must install and configure the CA Endevor® Web Services and have the " +
85
- "program listing for the specific measurement registered with CA MAT. The source code listing is retrieved " +
86
- "through CA Endevor® footprints for Cobol, C/C++, and Assembler programs. The program listing file is downloaded " +
84
+ "To use the listing retrieval option, you must install and configure the Endevor® Web Services and have the " +
85
+ "program listing for the specific measurement registered with MAT. The source code listing is retrieved " +
86
+ "through Endevor® footprints for Cobol, C/C++, and Assembler programs. The program listing file is downloaded " +
87
87
  "to your local directory that you specified with the \'listingDir\' parameter in your MAT configuration profile. " +
88
88
  "When you request the histogram details with the \'--listing\' option, the \'histogram\' command returns the " +
89
89
  "additional \'listing\' column that contains a reference to the program listing with the specific CSECT name, " +
@@ -109,6 +109,11 @@ exports.HistogramDefinition = {
109
109
  "limit the number of returned records to 5 top consumers, and request the listing details",
110
110
  options: "--mon_num 5 --csect \"TUNCOB01\" --module \"RUNCOB\" --top 5 --listing",
111
111
  },
112
+ {
113
+ description: "Get the Histogram details for monitor number 5, CSECT name TUNCOB01, and module name RUNCOB, " +
114
+ "with the specific MAT profile details defined",
115
+ options: "--mon_num 5 --csect \"TUNCOB01\" --module \"RUNCOB\" --host \"example.com\" --port 12345 --user johndoe --password qwerty",
116
+ },
112
117
  ]
113
118
  };
114
119
  //# sourceMappingURL=Histogram.definition.js.map
@@ -1 +1 @@
1
- {"version":3,"file":"Histogram.definition.js","sourceRoot":"","sources":["../../../../../src/cli/monitor/codeview/Histogram/Histogram.definition.ts"],"names":[],"mappings":";AAAA;;;;;;;;;;;;;;;;;;;;;GAqBG;;;AAGU,QAAA,mBAAmB,GAAuB;IACnD,IAAI,EAAE,WAAW;IACjB,OAAO,EAAE,CAAC,KAAK,CAAC;IAChB,OAAO,EAAE,oBAAoB;IAC7B,WAAW,EAAE,gDAAgD;IAC7D,IAAI,EAAE,SAAS;IACf,OAAO,EAAE,SAAS,GAAG,oBAAoB;IACzC,OAAO,EAAE;QACL,QAAQ,EAAE,CAAC,KAAK,CAAC;KACpB;IACD,OAAO,EAAE;QACL;YACI,IAAI,EAAE,SAAS;YACf,WAAW,EAAE,8DAA8D;gBAC3E,iFAAiF;gBACjF,+BAA+B;YAC/B,IAAI,EAAE,QAAQ;SACjB;QACD;YACI,IAAI,EAAE,SAAS;YACf,WAAW,EAAE,yDAAyD;YACtE,IAAI,EAAE,QAAQ;SACjB;QACD;YACI,IAAI,EAAE,QAAQ;YACd,WAAW,EAAE,qEAAqE;gBAClF,yEAAyE;gBACzE,iFAAiF;YACjF,IAAI,EAAE,eAAe;SACxB;QACD;YACI,IAAI,EAAE,OAAO;YACb,WAAW,EAAE,oEAAoE;gBACjF,oGAAoG;gBACpG,oDAAoD;YACpD,IAAI,EAAE,eAAe;SACxB;QACD;YACI,IAAI,EAAE,OAAO;YACb,WAAW,EAAE,4FAA4F;gBACzG,2GAA2G;gBAC3G,gGAAgG;gBAChG,qCAAqC;gBACrC,sGAAsG;gBACtG,uCAAuC;YACvC,IAAI,EAAE,eAAe;SACxB;QACD;YACI,IAAI,EAAE,KAAK;YACX,WAAW,EAAE,6EAA6E;gBAC1F,mFAAmF;gBACnF,mGAAmG;gBACnG,qEAAqE;YACrE,IAAI,EAAE,QAAQ;SACjB;QACD;YACI,IAAI,EAAE,SAAS;YACf,WAAW,EAAE,oGAAoG;gBACjH,gHAAgH;gBAChH,4GAA4G;gBAC5G,kHAAkH;gBAClH,kHAAkH;gBAClH,8GAA8G;gBAC9G,+GAA+G;gBAC/G,uGAAuG;gBACvG,qHAAqH;gBACrH,0GAA0G;gBAC1G,sCAAsC;YACtC,IAAI,EAAE,SAAS;SAClB;KACJ;IACD,QAAQ,EAAE;QACN;YACI,WAAW,EAAE,6FAA6F;YAC1G,OAAO,EAAE,sDAAsD;SAClE;QACD;YACI,WAAW,EAAE,oGAAoG;gBACjH,8GAA8G;YAC9G,OAAO,EAAE,8EAA8E;SAC1F;QACF;YACK,WAAW,EAAE,+FAA+F;gBAC5G,0FAA0F;YAC1F,OAAO,EAAE,wEAAwE;SACpF;KACJ;CACJ,CAAC"}
1
+ {"version":3,"file":"Histogram.definition.js","sourceRoot":"","sources":["../../../../../src/cli/monitor/codeview/Histogram/Histogram.definition.ts"],"names":[],"mappings":";AAAA;;;;;;;;;;;;;;;;;;;;;GAqBG;;;AAGU,QAAA,mBAAmB,GAAuB;IACnD,IAAI,EAAE,WAAW;IACjB,OAAO,EAAE,CAAC,KAAK,CAAC;IAChB,OAAO,EAAE,oBAAoB;IAC7B,WAAW,EAAE,gDAAgD;IAC7D,IAAI,EAAE,SAAS;IACf,OAAO,EAAE,SAAS,GAAG,oBAAoB;IACzC,OAAO,EAAE;QACL,QAAQ,EAAE,CAAC,KAAK,CAAC;KACpB;IACD,OAAO,EAAE;QACL;YACI,IAAI,EAAE,SAAS;YACf,WAAW,EAAE,8DAA8D;gBAC3E,iFAAiF;gBACjF,+BAA+B;YAC/B,IAAI,EAAE,QAAQ;SACjB;QACD;YACI,IAAI,EAAE,SAAS;YACf,WAAW,EAAE,yDAAyD;YACtE,IAAI,EAAE,QAAQ;SACjB;QACD;YACI,IAAI,EAAE,QAAQ;YACd,WAAW,EAAE,qEAAqE;gBAClF,yEAAyE;gBACzE,iFAAiF;YACjF,IAAI,EAAE,eAAe;SACxB;QACD;YACI,IAAI,EAAE,OAAO;YACb,WAAW,EAAE,oEAAoE;gBACjF,oGAAoG;gBACpG,oDAAoD;YACpD,IAAI,EAAE,eAAe;SACxB;QACD;YACI,IAAI,EAAE,OAAO;YACb,WAAW,EAAE,4FAA4F;gBACzG,2GAA2G;gBAC3G,6FAA6F;gBAC7F,qCAAqC;gBACrC,sGAAsG;gBACtG,uCAAuC;YACvC,IAAI,EAAE,eAAe;SACxB;QACD;YACI,IAAI,EAAE,KAAK;YACX,WAAW,EAAE,6EAA6E;gBAC1F,mFAAmF;gBACnF,gGAAgG;gBAChG,qEAAqE;YACrE,IAAI,EAAE,QAAQ;SACjB;QACD;YACI,IAAI,EAAE,SAAS;YACf,WAAW,EAAE,oGAAoG;gBACjH,6GAA6G;gBAC7G,yGAAyG;gBACzG,+GAA+G;gBAC/G,kHAAkH;gBAClH,8GAA8G;gBAC9G,+GAA+G;gBAC/G,uGAAuG;gBACvG,qHAAqH;gBACrH,0GAA0G;gBAC1G,sCAAsC;YACtC,IAAI,EAAE,SAAS;SAClB;KACJ;IACD,QAAQ,EAAE;QACN;YACI,WAAW,EAAE,6FAA6F;YAC1G,OAAO,EAAE,sDAAsD;SAClE;QACD;YACI,WAAW,EAAE,oGAAoG;gBACjH,8GAA8G;YAC9G,OAAO,EAAE,8EAA8E;SAC1F;QACF;YACK,WAAW,EAAE,+FAA+F;gBAC5G,0FAA0F;YAC1F,OAAO,EAAE,wEAAwE;SACpF;QACD;YACI,WAAW,EAAE,+FAA+F;gBAC5G,+CAA+C;YAC/C,OAAO,EAAE,2HAA2H;SACvI;KACJ;CACJ,CAAC"}