From d718ce3b149d197d24370141c9fb21dc3f476f80 Mon Sep 17 00:00:00 2001 From: zFernand0 <37381190+zFernand0@users.noreply.github.com> Date: Mon, 28 Aug 2023 18:42:21 +0000 Subject: [PATCH] update badge image Signed-off-by: zFernand0 <37381190+zFernand0@users.noreply.github.com> --- CHANGELOG.md | 4 +++ README.md | 74 +++++++++++++++++++++++------------------------ package-lock.json | 4 +-- package.json | 2 +- 4 files changed, 44 insertions(+), 40 deletions(-) diff --git a/CHANGELOG.md b/CHANGELOG.md index fce9767..bea8d2f 100644 --- a/CHANGELOG.md +++ b/CHANGELOG.md @@ -2,6 +2,10 @@ All notable changes to the "cics-extension-for-zowe" extension will be documented in this file. +## `2.3.2` + +- BugFix: Updated badge images in README.md + ## `2.3.1` - BugFix: Updated Zowe Explorer API depepdency to leverage the Secrets for Zowe SDK. [#324](https://github.com/zowe/vscode-extension-for-cics/issues/324) diff --git a/README.md b/README.md index cf725b0..094517c 100644 --- a/README.md +++ b/README.md @@ -1,7 +1,7 @@ # Zowe CICS Explorer -[![version](https://vsmarketplacebadge.apphb.com/version-short/zowe.cics-extension-for-zowe.svg)](https://vsmarketplacebadge.apphb.com/version-short/Zowe.cics-extension-for-zowe.svg) -[![downloads](https://vsmarketplacebadge.apphb.com/downloads-short/zowe.cics-extension-for-zowe.svg)](https://vsmarketplacebadge.apphb.com/downloads-short/Zowe.cics-extension-for-zowe.svg) +[![version](https://img.shields.io/visual-studio-marketplace/v/zowe.cics-extension-for-zowe.svg)](https://img.shields.io/visual-studio-marketplace/v/zowe.cics-extension-for-zowe.svg) +[![downloads](https://img.shields.io/visual-studio-marketplace/d/zowe.cics-extension-for-zowe.svg)](https://img.shields.io/visual-studio-marketplace/d/zowe.cics-extension-for-zowe.svg) [![slack](https://img.shields.io/badge/chat-on%20Slack-blue)](https://openmainframeproject.slack.com/archives/CUVE37Z5F) [![open issues](https://img.shields.io/github/issues/zowe/vscode-extension-for-cics)](https://github.com/zowe/vscode-extension-for-cics/issues) @@ -62,7 +62,7 @@ To Install CICS Extension for Zowe Explorer see [Installation](./docs/installati ### Create Profile -If you already have a Zowe CICS CLI profile, the CICS tree will load the default profile on startup. +If you already have a Zowe CICS CLI profile, the CICS tree will load the default profile on startup. If you don't have an existing Zowe CICS CLI profile, follow these steps to create one: @@ -79,7 +79,7 @@ If you don't have an existing Zowe CICS CLI profile, follow these steps to creat 5. Select the **+** button in the CICS tree and click the newly created profile to load it into view.

-Zowe CICS Explorer config profiles +Zowe CICS Explorer config profiles

Here's an example of a CICS profile entry in the config file: @@ -109,12 +109,12 @@ Here's an example of a CICS profile entry in the config file: 2. Select the **Create New CICS profile** option to open a panel that defines connection details. -**Note**: The connection must point to a CICS region's CICS Management Client Interface (CMCI) TCP/IP host name and port number. The region can be a WUI server in a CICSPlex, or else a stand-alone Single Management Application Programming (SMSS) region. +**Note**: The connection must point to a CICS region's CICS Management Client Interface (CMCI) TCP/IP host name and port number. The region can be a WUI server in a CICSPlex, or else a stand-alone Single Management Application Programming (SMSS) region. Configuring a CICS region to have a connection is a system programmer task and more details can be found in [Setting up CMCI with CICSPlex SM](https://www.ibm.com/docs/en/cics-ts/5.3?topic=explorer-setting-up-cmci-cicsplex-sm) or [Setting up CMCI in a stand-alone CICS region](https://www.ibm.com/docs/en/cics-ts/5.3?topic=suace-setting-up-cmci-in-stand-alone-cics-region). If your CMCI connection is configured to use a self-signed certificate that your PC's trust store doesn't recognize, see [Untrusted TLS certificates](#untrusted-tls-certificates).

-Zowe CICS Explorer profiles +Zowe CICS Explorer profiles

To show more than one CICS profiles in the tree, select the **+** button and choose from the list of profiles. Only profiles that not already included in the CICS tree will be shown. @@ -123,17 +123,17 @@ To show more than one CICS profiles in the tree, select the **+** button and cho The connection must point to a CICS region's CICS Management Client Interface (CMCI) TCP/IP host name and port number. The region can be a WUI server in a CICSPlex, a stand-alone Single Management Application Programming (SMSS) region, or a CICS system group. -If neither of the fields under 'CICS Details' (for users using v1 profiles) or neither the 'cicsPlex' or 'regionName' properties (for users using team configuration) are specified, the profile will show all CICSPlex for the WUI server. Specify a Plex Name to just view data for a single CICSPlex. +If neither of the fields under 'CICS Details' (for users using v1 profiles) or neither the 'cicsPlex' or 'regionName' properties (for users using team configuration) are specified, the profile will show all CICSPlex for the WUI server. Specify a Plex Name to just view data for a single CICSPlex. For a CICSPlex, all managed regions will be shown unless you specify a specific region name. Instead of a region name, you may also enter a CICS System Group to allow scoping of resources within the CICSPlex. For a stand-alone CICS region, the Region Name may be entered but is optional. Do not enter a CICSPlex name for a stand-alone CICS region. -Configuring a CICS region to have a connection is a system programmer task and more details can be found in [Setting up CMCI with CICSPlex SM](https://www.ibm.com/docs/en/cics-ts/5.3?topic=explorer-setting-up-cmci-cicsplex-sm) or +Configuring a CICS region to have a connection is a system programmer task and more details can be found in [Setting up CMCI with CICSPlex SM](https://www.ibm.com/docs/en/cics-ts/5.3?topic=explorer-setting-up-cmci-cicsplex-sm) or [Setting up CMCI in a stand-alone CICS region](https://www.ibm.com/docs/en/cics-ts/5.3?topic=suace-setting-up-cmci-in-stand-alone-cics-region). If your CMCI connection is configured to use a self-signed certificate that your PC's trust store doesn't recognize, see [Untrusted TLS certificates](#untrusted-tls-certificates) -To show more than one CICS profile in the tree, select the + button and choose from the list of profiles. Only profiles not already included in the CICS tree will be shown. To view all Zowe CICS CLI profiles use the command `zowe profiles list cics` from a terminal. +To show more than one CICS profile in the tree, select the + button and choose from the list of profiles. Only profiles not already included in the CICS tree will be shown. To view all Zowe CICS CLI profiles use the command `zowe profiles list cics` from a terminal. ### Update Profile @@ -148,7 +148,7 @@ To show more than one CICS profile in the tree, select the + button and choose f 4. Refresh the Zowe Explorer for IBM CICS extension by either clicking the button at the top level of the CICS view, or the `Zowe Explorer for IBM CICS: Refresh` command palette option.

-Zowe CICS Explorer Filter +Zowe CICS Explorer Filter

#### Using Zowe v1 profiles @@ -162,7 +162,7 @@ To show more than one CICS profile in the tree, select the + button and choose f 3. Once the details are updated, click the **Update Profile** button to apply the changes to the profile.

-Zowe CICS Explorer Filter +Zowe CICS Explorer Filter

### Hiding Profiles @@ -170,7 +170,7 @@ To show more than one CICS profile in the tree, select the + button and choose f Open the menu actions for a profile by right-clicking a profile and select `Hide Profile` to hide it from the CICS view. To add the profile back, click the + button and select the profile from the quick pick list.

-Zowe CICS Explorer NewCopy Program +Zowe CICS Explorer NewCopy Program

### Deleting Profiles @@ -186,7 +186,7 @@ Open the menu actions for a profile by right-clicking a profile and select `Hide 4. Refresh the Zowe Explorer for IBM CICS extension by either clicking the button at the top level of the CICS view, or the `Zowe Explorer for IBM CICS: Refresh` command palette option.

-Zowe CICS Explorer NewCopy Program +Zowe CICS Explorer NewCopy Program

#### Using Zowe v1 profiles @@ -196,7 +196,7 @@ Open the menu actions for a profile by right-clicking a profile and select `Hide 2. Select **Delete Profile** and click the **Yes** button when prompted to confirm the action of permanently deleting the profile. The functionality deletes the CICS profile from the persistent storage directory `~/.zowe/profiles/cics`.

-Zowe CICS Explorer NewCopy Program +Zowe CICS Explorer NewCopy Program

## CICS Resources @@ -207,27 +207,27 @@ Expand a CICS profile to see the region name, and expand the region to view its Expand a CICS region to show folders for the resource types `Programs`, `Transactions`, `Local Files` and `Tasks`. Expand each type to show the resources. The number of resources in a resource tree will appear in square brackets next to the tree name. -The list of resources are pre-filtered to exclude many of the IBM supplied ones to narrow the contents to just include user programs. Use the search icon against a resource type to apply a filter. This can be an exact resource name or else you can use wildcards. The search history is saved so you can recall previous searches. +The list of resources are pre-filtered to exclude many of the IBM supplied ones to narrow the contents to just include user programs. Use the search icon against a resource type to apply a filter. This can be an exact resource name or else you can use wildcards. The search history is saved so you can recall previous searches. To reset the filter to its initial criteria use the clear filter icon against the resource type. If you wish to see all resources in a region (including IBM supplied ones) you can use "*" as a filter.

-Zowe CICS Explorer Filter +Zowe CICS Explorer Filter

-**Tip:** To apply multiple filters, separate entries with a comma. You can append any filter with an *, which indicates wildcard searching. +**Tip:** To apply multiple filters, separate entries with a comma. You can append any filter with an *, which indicates wildcard searching. ### Show and Filter Resources in a Plex -Similar to filtering resources in a region, it is also possible to apply a filter on a all region resources in a plex. Use the search icon inline with the `Regions` tree and then select either `Regions`, `Programs`, `Local Transactions` or `Local Files` from the drop-down menu to specify which resource type the filter should be applied to for all regions in the plex. +Similar to filtering resources in a region, it is also possible to apply a filter on a all region resources in a plex. Use the search icon inline with the `Regions` tree and then select either `Regions`, `Programs`, `Local Transactions` or `Local Files` from the drop-down menu to specify which resource type the filter should be applied to for all regions in the plex. To reset the filter to its initial criteria use the clear filter icon against the `Regions` tree. This will open a drop-down menu which gives the option to clear the filter for all the `Regions`, `Programs`, `Local Transactions` or `Local Files` in the plex, and an option to otherwise clear `All` filters within the plex.

-Zowe CICS Explorer Filter +Zowe CICS Explorer Filter

-**Tip:** To apply multiple filters, separate entries with a comma. You can append any filter with an *, which indicates wildcard searching. +**Tip:** To apply multiple filters, separate entries with a comma. You can append any filter with an *, which indicates wildcard searching. ### Show and Filter Resources in an 'All' Resource Tree Plexes contain an `All Programs`, `All Local Transactions`, `All Local Files` and `All Tasks` trees which contain all the corresponding resources from all regions in the plex. @@ -235,7 +235,7 @@ Plexes contain an `All Programs`, `All Local Transactions`, `All Local Files` an To view resources under these trees, use the search icon inline with the tree and apply a filter.

-Zowe CICS Explorer Filter +Zowe CICS Explorer Filter

If the applied filter results in over 500 records, either change the filter to narrow down the search, or click the `view X more ...` item to retrieve 'X' more resources. @@ -243,15 +243,15 @@ If the applied filter results in over 500 records, either change the filter to n **Tip:** The default 500 count can be modified via the `Record Count Increment` property in Settings (UI).

-Zowe CICS Explorer Record Count Increment in Setting UI +Zowe CICS Explorer Record Count Increment in Setting UI

### Show Attributes -Right-click and use the pop-up menu against a program to list the available actions that can be performed. For every resource, including a CICS region, `Show Attributes` opens a viewer listing all attributes and their values. The attributes page has a filter box at the top that lets you search for attributes matching the criteria. +Right-click and use the pop-up menu against a program to list the available actions that can be performed. For every resource, including a CICS region, `Show Attributes` opens a viewer listing all attributes and their values. The attributes page has a filter box at the top that lets you search for attributes matching the criteria.

-Zowe CICS Explorer Filter +Zowe CICS Explorer Filter

### Enable and Disable @@ -259,7 +259,7 @@ Right-click and use the pop-up menu against a program to list the available acti Right-click against a program, local transaction or local file to open up the pop-up menu and click `Disable [CICS resource]` to disable the resource. When a resource is already disabled the first option becomes `Enable [CICS resource]` to allow its enablement state to be toggled. A disabled resource is identified by a `(Disabled)` text next to its name.

-Zowe CICS Explorer Filter +Zowe CICS Explorer Filter

### New Copy and Phase In @@ -269,17 +269,17 @@ Use `New Copy` -Zowe CICS Explorer NewCopy Program +Zowe CICS Explorer NewCopy Program

### Open and Close Local Files -Right-click against a closed local file and perform the `Open Local File` menu action to toggle the `openstatus` attribute to 'OPEN'. +Right-click against a closed local file and perform the `Open Local File` menu action to toggle the `openstatus` attribute to 'OPEN'. To close a local file, right-click against an open local file and perform the `Close Local File` menu action. This will bring up a prompt on the bottom right corner requesting to choose one of `Wait`, `No Wait` or `Force` for the file busy condition. Once an option has been selected, the local file name will be appended with a `(Closed)` label upon success.

-Zowe CICS Explorer NewCopy Program +Zowe CICS Explorer NewCopy Program

### Purge Task @@ -289,7 +289,7 @@ Right-click against a task and click the `Purge Task` command. This will open a Select the appropriate condition to perform the purge.

-Zowe CICS Explorer Purge Task +Zowe CICS Explorer Purge Task

### Inquire Functionality @@ -299,7 +299,7 @@ Right-click against a Task and perform the `Inquire Transaction` command. This w The same can be done on a Local Transaction to find the associated Program by executing the `Inquire Program` right-click menu action against a Local Transaction.

-Zowe CICS Explorer Inquire functionality +Zowe CICS Explorer Inquire functionality

### View Datasets under Libraries @@ -307,25 +307,25 @@ The same can be done on a Local Transaction to find the associated Program by ex Expand libraries of a region to view specific datasets belonging to a library. Right-click on libraries to `Show Attributes` to view library attributes. Similarly, right-click on datasets to `Show Attributes` to view dataset attributes.

-Zowe CICS Explorer View Datasets functionality +Zowe CICS Explorer View Datasets functionality

### View four CICS Web Resources under the Web Folder -Expand the Web folder to view TCPIP Services, URI Maps, Pipelines and Web Services. Each of these resources can be expanded and allows for right-click functionality on the specific resource to execute the `Show Attributes` command. Use the search icon to filter down specific resources by applying a filter. +Expand the Web folder to view TCPIP Services, URI Maps, Pipelines and Web Services. Each of these resources can be expanded and allows for right-click functionality on the specific resource to execute the `Show Attributes` command. Use the search icon to filter down specific resources by applying a filter.

-Zowe CICS Explorer Web resources under the Web folder +Zowe CICS Explorer Web resources under the Web folder

## Untrusted TLS Certificates If the CMCI connection is using a TLS certificate that your PC doesn't have in its trust store, then by default the connection will be rejected as potentially this could be from an unsafe site. To override this behavior, either set the `Only accept trusted TLS certificates` field on the form when creating/updating the profile to `False`. This is the same as setting `rejectUnauthorized=false` on the Zowe CICS CLI profile. -If you define a profile as only accepting trusted TLS certificates when the Zowe Explorer first connects it will detect the mismatch and allow you to override the setting and proceed. This is done through a pop-up message with a `Yes` button to accept the untrusted certificate authority, which changes the profile's setting. +If you define a profile as only accepting trusted TLS certificates when the Zowe Explorer first connects it will detect the mismatch and allow you to override the setting and proceed. This is done through a pop-up message with a `Yes` button to accept the untrusted certificate authority, which changes the profile's setting.

-Zowe CICS Explorer accepted untrusted certificate +Zowe CICS Explorer accepted untrusted certificate

## Usage tips @@ -337,9 +337,9 @@ If you define a profile as only accepting trusted TLS certificates when the Zowe ## Providing feedback or help contributing ### Checking the source of an error -Before filing an issue, check if an error is arising from the Zowe Explorer for IBM CICS extension and not the Zowe Explorer extension by expanding the error message and checking if the `Source` is `Zowe Explorer for IBM CICS (Extension)`. +Before filing an issue, check if an error is arising from the Zowe Explorer for IBM CICS extension and not the Zowe Explorer extension by expanding the error message and checking if the `Source` is `Zowe Explorer for IBM CICS (Extension)`.

-Zowe CICS Explorer NewCopy Program +Zowe CICS Explorer NewCopy Program

Error messages arising from the Zowe Explorer extension will have the `Source` as `Zowe Explorer(Extension)`. diff --git a/package-lock.json b/package-lock.json index 06a8533..67a5968 100644 --- a/package-lock.json +++ b/package-lock.json @@ -1,12 +1,12 @@ { "name": "cics-extension-for-zowe", - "version": "2.4.0-SNAPSHOT", + "version": "2.3.2", "lockfileVersion": 2, "requires": true, "packages": { "": { "name": "cics-extension-for-zowe", - "version": "2.4.0-SNAPSHOT", + "version": "2.3.2", "dependencies": { "@types/axios": "^0.14.0", "@zowe/cics-for-zowe-cli": "^5.0.0", diff --git a/package.json b/package.json index 20d97db..406150b 100644 --- a/package.json +++ b/package.json @@ -6,7 +6,7 @@ "repository": { "url": "https://github.com/zowe/vscode-extension-for-cics" }, - "version": "2.4.0-SNAPSHOT", + "version": "2.3.2", "engines": { "vscode": "^1.50.0" },