diff --git a/README.md b/README.md index 3cd579b..39ae383 100644 --- a/README.md +++ b/README.md @@ -24,6 +24,8 @@ This CICS Extension for Zowe Explorer adds additional functionality to the popul - [Enable and Disable](#enable-and-disable) - [New Copy and Phase In](#new-copy-and-phase-in) - [Open and Close Local Files](#open-and-close-local-files) + - [Purge Task](#purge-task) + - [Reveal Functionality](#reveal-functionality) - [Untrusted TLS Certificates](#untrusted-tls-certificates) - [Usage Tips](#usage-tips) - [Providing feedback or help contributing](#providing-feedback-or-help-contributing) @@ -38,6 +40,7 @@ Ensure that you meet the following prerequisites before you use the extension: - Install Zowe Explorer v2 **Tip**: See [Troubleshooting guide](./docs/Troubleshooting.md) for solutions to common problems. + ## Features - Load profiles directly from Zowe instance locally installed. @@ -45,9 +48,10 @@ Ensure that you meet the following prerequisites before you use the extension: - Work with multiple regions containing programs, local transactions and local files within a plex in a comprehensible tree-like format. - Perform actions such as `Enable`, `Disable`, `New Copy` and `Phase In` directly from the UI. - Perform additional actions on local files including `Open` and `Close` directly from the UI. +- Perform a `Purge` on Tasks with the option to select from a `Purge`, `Force Purge` or `Kill`. - View and search attributes of resources and regions by right-clicking and using the dynamic filtering feature. - Create new CICS profiles, update session details, and delete profiles using the user-friendly interface. -- Apply multiple filters to regions, programs, local transactions and/or local files. +- Apply multiple filters to regions, programs, local transactions local files and/or tasks. - View and interact with all resources under a plex. To Install CICS Extension for Zowe Explorer see [Installation](./docs/installation-guide.md). @@ -199,7 +203,7 @@ Expand a CICS profile to see the region name, and expand the region to view its ### Show and Filter Resources in a Region -Expand a CICS region to show folders for the resource types `Programs` , `Transactions` and `Local Files` . 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. +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. @@ -224,7 +228,7 @@ To reset the filter to its initial criteria use the clear filter icon inline with the tree and apply a filter. @@ -233,6 +237,13 @@ To view resources under these trees, use the search icon + +
+ ### 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. @@ -269,6 +280,26 @@ To close a local file, right-click against an open local file and perform the `C +### Purge Task + +Right-click against a task and click the `Purge Task` command. This will open a prompt asking whether to perform a `Purge`, `Force Purge` or `Kill`. + +Select the appropriate condition to perform the purge. + ++ +
+ +### Reveal Functionality + +Right-click against a Task and perform the `Reveal Transaction` command. This will reveal the associated Local Transaction (i.e. the transaction with the name that matches the `tranid` attribute of the selected Task) under the Local Transactions folder. + +The same can be done on a Local Transaction to find the associated Program by executing the `Reveal Program` right-click menu action against a Local Transaction. + ++ +
+ ## 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. @@ -276,7 +307,7 @@ If the CMCI connection is using a TLS certificate that your PC doesn't have in i 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.- +
## Usage tips diff --git a/docs/images/purge-task.gif b/docs/images/purge-task.gif new file mode 100644 index 0000000..6ac7646 Binary files /dev/null and b/docs/images/purge-task.gif differ diff --git a/docs/images/record-count-increment.png b/docs/images/record-count-increment.png new file mode 100644 index 0000000..8ed309d Binary files /dev/null and b/docs/images/record-count-increment.png differ diff --git a/docs/images/reveal.gif b/docs/images/reveal.gif new file mode 100644 index 0000000..56a2040 Binary files /dev/null and b/docs/images/reveal.gif differ