@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.
- package/CHANGELOG.md +5 -28
- package/README.md +121 -100
- package/lib/api/MATRest.d.ts +1 -1
- package/lib/api/MATRest.js +3 -5
- package/lib/api/MATRest.js.map +1 -1
- package/lib/cli/monitor/Monitor.definition.js +13 -2
- package/lib/cli/monitor/Monitor.definition.js.map +1 -1
- package/lib/cli/monitor/codeview/Histogram/Histogram.definition.js +11 -6
- package/lib/cli/monitor/codeview/Histogram/Histogram.definition.js.map +1 -1
- package/lib/cli/monitor/codeview/Histogram/Histogram.handler.js +42 -20
- package/lib/cli/monitor/codeview/Histogram/Histogram.handler.js.map +1 -1
- package/lib/cli/monitor/codeview/callerid/Callerid.definition.js +6 -1
- package/lib/cli/monitor/codeview/callerid/Callerid.definition.js.map +1 -1
- package/lib/cli/monitor/codeview/csect/Csect.definition.js +5 -1
- package/lib/cli/monitor/codeview/csect/Csect.definition.js.map +1 -1
- package/lib/cli/monitor/codeview/module/Module.definition.js +6 -1
- package/lib/cli/monitor/codeview/module/Module.definition.js.map +1 -1
- package/lib/cli/monitor/db2/db2view/DB2View.definition.js +6 -2
- package/lib/cli/monitor/db2/db2view/DB2View.definition.js.map +1 -1
- package/lib/cli/monitor/db2/sqlview/SQLView.definition.js +6 -1
- package/lib/cli/monitor/db2/sqlview/SQLView.definition.js.map +1 -1
- package/lib/cli/monitor/delayview/address/Address.definition.js +6 -1
- package/lib/cli/monitor/delayview/address/Address.definition.js.map +1 -1
- package/lib/cli/monitor/delayview/delay/Delay.definition.js +5 -1
- package/lib/cli/monitor/delayview/delay/Delay.definition.js.map +1 -1
- package/lib/cli/monitor/history/History.definition.js +6 -1
- package/lib/cli/monitor/history/History.definition.js.map +1 -1
- package/lib/cli/monitor/overview/Overview.definition.js +5 -1
- package/lib/cli/monitor/overview/Overview.definition.js.map +1 -1
- package/lib/cli/profile/Profile.definition.js +13 -2
- package/lib/cli/profile/Profile.definition.js.map +1 -1
- package/lib/cli/profile/create/CreateProfile.definition.js +47 -43
- package/lib/cli/profile/create/CreateProfile.definition.js.map +1 -1
- package/lib/cli/profile/invoke/InvokeProfile.definition.js +14 -9
- package/lib/cli/profile/invoke/InvokeProfile.definition.js.map +1 -1
- package/lib/cli/profile/listprofile/ListProfile.definition.js +1 -1
- package/lib/cli/session/MATSession.d.ts +24 -5
- package/lib/cli/session/MATSession.js +97 -31
- package/lib/cli/session/MATSession.js.map +1 -1
- package/lib/handlers/AbstractRestHandler.js +12 -6
- package/lib/handlers/AbstractRestHandler.js.map +1 -1
- package/lib/imperative.js +19 -15
- package/lib/imperative.js.map +1 -1
- 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
|
-
## `
|
|
5
|
-
-
|
|
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
|
-
#
|
|
4
|
-
The
|
|
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
|
|
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
|
|
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
|
|
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
|
|
20
|
-
* [Install the
|
|
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
|
|
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
|
|
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
|
|
56
|
-
* Zowe CLI installed
|
|
57
|
-
*
|
|
58
|
-
*
|
|
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
|
|
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
|
|
71
|
-
To install the
|
|
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
|
|
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
|
-
|
|
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` | `--
|
|
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
|
-
`--
|
|
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` | `--
|
|
115
|
+
`--port` | `--P` *(number)*
|
|
118
116
|
Specifies the server port (e.g. 8080).
|
|
119
117
|
|
|
120
|
-
`--
|
|
118
|
+
`--user` | `--u` *(string)*
|
|
121
119
|
Your mainframe username.
|
|
122
120
|
|
|
123
|
-
`--password` | `--
|
|
121
|
+
`--password` | `--pw` *(string)*
|
|
124
122
|
Your mainframe password.
|
|
125
123
|
|
|
126
|
-
|
|
127
|
-
|
|
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
|
|
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
|
-
|
|
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
|
|
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
|
|
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
|
|
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
|
|
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
|
|
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
|
|
226
|
-
Values: data set name pattern, maximum 46 characters. If not specified, your default
|
|
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
|
|
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
|
|
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
|
|
393
|
-
Values: data set name pattern, maximum 46 characters. If not specified, your default
|
|
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
|
|
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
|
|
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
|
|
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
|
|
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
|
|
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
|
|
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
|
|
819
|
-
To uninstall the
|
|
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
|
```
|
package/lib/api/MATRest.d.ts
CHANGED
|
@@ -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,
|
|
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>;
|
package/lib/api/MATRest.js
CHANGED
|
@@ -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
|
|
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
|
}
|
package/lib/api/MATRest.js.map
CHANGED
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"MATRest.js","sourceRoot":"","sources":["../../src/api/MATRest.ts"],"names":[],"mappings":";AAAA;;;;;;;;;;;;;;;;;;;;;GAqBG;;;;;;;;;;;;AAEH,iDAA+D;
|
|
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
|
|
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,
|
|
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
|
-
|
|
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
|
|
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
|
|
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
|
|
85
|
-
"program listing for the specific measurement registered with
|
|
86
|
-
"through
|
|
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,
|
|
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"}
|