From c89f19b7ff33fcb5cde19a2120340151ceaf2fa5 Mon Sep 17 00:00:00 2001 From: Zachariah Mullen Date: Thu, 15 Oct 2020 15:02:34 +0200 Subject: [PATCH 01/11] Add API ML login Signed-off-by: Zachariah Mullen --- README.md | 34 ++++++++++++++++------------------ 1 file changed, 16 insertions(+), 18 deletions(-) diff --git a/README.md b/README.md index 2c470ce3d1..66d8dc52cb 100644 --- a/README.md +++ b/README.md @@ -15,6 +15,7 @@ The Zowe Explorer extension modernizes the way developers and system administrat * Providing a more streamlined way to access data sets, uss files and jobs. * Letting you create, edit, and delete Zowe CLI `zosmf` compatible profiles. * Letting you use the Secure Credential Store plug-in to store your credentials securely in the settings. +* Letting you leverage the token-based authentication of the API Mediation Layer to access z/OSMF. More information: @@ -23,33 +24,18 @@ More information: ## Contents -* [What's new in Zowe Explorer 1.9.0](#what's-new-in-zowe-explorer-1.9.0) +* [What's new in Zowe Explorer 1.10.0](#what's-new-in-zowe-explorer-1.10.0) * [Prerequisites](#prerequisites) * [Getting Started](#getting-started) * [Credentials Security](#credentials-security) * [Usage Tips](#usage-tips) * [Extending Zowe Explorer](#extending-zowe-explorer) -## What's new in Zowe Explorer 1.9.0 +## What's new in Zowe Explorer 1.10.0 New features: -* Added the Allocate Like feature. -* Added the ability to disable/enable profile validation. -* Added the ability to access other profiles during profile validation. - -Enhancements: - -* Datasets and members names are displayed in all uppercase letters even if typed in lowercase letters. -* Grouped Favorites by profile for Datasets, USS, and Jobs. -* Other profiles can be accessed during profile validation. -* Updated the environment check for Theia compatibility. - -Bug Fixes: - -* Fixed USS renaming issues. -* Fixed the deletion of datasets issue. -* Removed errors in Favorites items caused by profiles that are created by other extensions. +* Added base profile support. You can now log in to the API Mediation Layer via Zowe CLI and use that token with a service profile in Zowe Explorer. For more information, see [Changelog](https://marketplace.visualstudio.com/items/Zowe.vscode-extension-for-zowe/changelog). @@ -76,6 +62,18 @@ Create a profile, review the sample use cases to familiarize yourself with the c You can now use all the functionalities of the extension. +### Log in to API Mediation Layer and leverage base profile with token + +1. In your terminal, enter the `zowe auth login apiml` command. +2. Provide your username, password, host, and port for the API ML instance. + A local base profile is created that contains your token. +3. In Zowe Explorer, hover over **DATA SETS**, **USS**, or **JOBS**. +4. Click the **+** icon. +5. Select **Create a New Connection to z/OS**. +6. Provide only a name for your profile and the base path for your API Mediation Layer instance. + You can now use this profile to access z/OSMF via the API Mediation Layer. + + ### Sample use cases Review the following use cases to understand how to work with data sets in Zowe Explorer. For the complete list of features including USS and jobs, see [Zowe Explorer Sample Use Cases](https://docs.zowe.org/stable/user-guide/ze-usage.html#sample-use-cases). From 2580dc0b17cba8a40f4731e52d085676899bca7a Mon Sep 17 00:00:00 2001 From: Zachariah Mullen Date: Thu, 15 Oct 2020 15:10:56 +0200 Subject: [PATCH 02/11] spaces issues Signed-off-by: Zachariah Mullen --- README.md | 17 ++++++++--------- 1 file changed, 8 insertions(+), 9 deletions(-) diff --git a/README.md b/README.md index 66d8dc52cb..c308ce0229 100644 --- a/README.md +++ b/README.md @@ -35,7 +35,7 @@ More information: New features: -* Added base profile support. You can now log in to the API Mediation Layer via Zowe CLI and use that token with a service profile in Zowe Explorer. +* Added base profile support. You can now log in to the API Mediation Layer via Zowe CLI and use that token with a service profile in Zowe Explorer. For more information, see [Changelog](https://marketplace.visualstudio.com/items/Zowe.vscode-extension-for-zowe/changelog). @@ -64,15 +64,14 @@ You can now use all the functionalities of the extension. ### Log in to API Mediation Layer and leverage base profile with token -1. In your terminal, enter the `zowe auth login apiml` command. +1. In your terminal, enter the `zowe auth login apiml` command. 2. Provide your username, password, host, and port for the API ML instance. - A local base profile is created that contains your token. -3. In Zowe Explorer, hover over **DATA SETS**, **USS**, or **JOBS**. -4. Click the **+** icon. -5. Select **Create a New Connection to z/OS**. -6. Provide only a name for your profile and the base path for your API Mediation Layer instance. - You can now use this profile to access z/OSMF via the API Mediation Layer. - + A local base profile is created that contains your token. +3. In Zowe Explorer, hover over **DATA SETS**, **USS**, or **JOBS**. +4. Click the **+** icon. +5. Select **Create a New Connection to z/OS**. +6. Provide only a name for your profile and the base path for your API Mediation Layer instance. + You can now use this profile to access z/OSMF via the API Mediation Layer. ### Sample use cases From 6621c4d558d670718c000e10cbae429ebbd0a08e Mon Sep 17 00:00:00 2001 From: Zachariah Mullen Date: Thu, 15 Oct 2020 15:20:20 +0200 Subject: [PATCH 03/11] Add link to API Mediation layer doc Signed-off-by: Zachariah Mullen --- README.md | 2 ++ 1 file changed, 2 insertions(+) diff --git a/README.md b/README.md index c308ce0229..f504335e19 100644 --- a/README.md +++ b/README.md @@ -73,6 +73,8 @@ You can now use all the functionalities of the extension. 6. Provide only a name for your profile and the base path for your API Mediation Layer instance. You can now use this profile to access z/OSMF via the API Mediation Layer. +For more information about logging in to the API Mediation Layer, see [Integrating with API Mediation Layer](https://docs.zowe.org/stable/user-guide/cli-usingcli.html#integrating-with-api-mediation-layer). + ### Sample use cases Review the following use cases to understand how to work with data sets in Zowe Explorer. For the complete list of features including USS and jobs, see [Zowe Explorer Sample Use Cases](https://docs.zowe.org/stable/user-guide/ze-usage.html#sample-use-cases). From 94dac7f334f2e45cfdfc9faa2af564e5aafc5daf Mon Sep 17 00:00:00 2001 From: Zachariah Mullen Date: Thu, 15 Oct 2020 16:36:26 +0200 Subject: [PATCH 04/11] change procedure Signed-off-by: Zachariah Mullen --- README.md | 10 ++++------ 1 file changed, 4 insertions(+), 6 deletions(-) diff --git a/README.md b/README.md index f504335e19..8cfa7db0cb 100644 --- a/README.md +++ b/README.md @@ -62,16 +62,14 @@ Create a profile, review the sample use cases to familiarize yourself with the c You can now use all the functionalities of the extension. -### Log in to API Mediation Layer and leverage base profile with token +### Log in to API Mediation Layer and leverage existing base profile with token 1. In your terminal, enter the `zowe auth login apiml` command. 2. Provide your username, password, host, and port for the API ML instance. A local base profile is created that contains your token. -3. In Zowe Explorer, hover over **DATA SETS**, **USS**, or **JOBS**. -4. Click the **+** icon. -5. Select **Create a New Connection to z/OS**. -6. Provide only a name for your profile and the base path for your API Mediation Layer instance. - You can now use this profile to access z/OSMF via the API Mediation Layer. +3. In Zowe Explorer, click the **+** icon. +4. Select the service profile you use with your base profile. + The profile appears in the tree and you can now use this profile to access z/OSMF via the API Mediation Layer. For more information about logging in to the API Mediation Layer, see [Integrating with API Mediation Layer](https://docs.zowe.org/stable/user-guide/cli-usingcli.html#integrating-with-api-mediation-layer). From 1a35292e882ca02fd4f44f9a10108fb53e35fb71 Mon Sep 17 00:00:00 2001 From: Igor Kazmyr <43951184+IgorCATech@users.noreply.github.com> Date: Thu, 15 Oct 2020 18:02:27 +0200 Subject: [PATCH 05/11] refactor the proc Signed-off-by: Igor Kazmyr <43951184+IgorCATech@users.noreply.github.com> --- README.md | 31 +++++++++++++++++++++++-------- 1 file changed, 23 insertions(+), 8 deletions(-) diff --git a/README.md b/README.md index 8cfa7db0cb..eef44bb6b1 100644 --- a/README.md +++ b/README.md @@ -15,7 +15,7 @@ The Zowe Explorer extension modernizes the way developers and system administrat * Providing a more streamlined way to access data sets, uss files and jobs. * Letting you create, edit, and delete Zowe CLI `zosmf` compatible profiles. * Letting you use the Secure Credential Store plug-in to store your credentials securely in the settings. -* Letting you leverage the token-based authentication of the API Mediation Layer to access z/OSMF. +* Letting you leverage the API Mediation Layer token-based authentication to access z/OSMF. More information: @@ -62,16 +62,31 @@ Create a profile, review the sample use cases to familiarize yourself with the c You can now use all the functionalities of the extension. -### Log in to API Mediation Layer and leverage existing base profile with token +### Use Base Profiles + +Leverage existing base profiles with a token to log in to API Mediation Layer. + +Before using the base profiles functionality, ensure that you have [Zowe CLI](https://docs.zowe.org/stable/user-guide/cli-installcli.html) installed. + +**Follow these steps:** + +1. Open Zowe CLI and run the following command: + + ``` + zowe auth login apiml + ``` + +2. Follow the instructions and provide all necessary information to create a base profile. + + You have successfully created a base profile. + +3. Run Zowe Explorer and click the **+** icon. + +4. Select the z/OSMF profile you use with your base profile. -1. In your terminal, enter the `zowe auth login apiml` command. -2. Provide your username, password, host, and port for the API ML instance. - A local base profile is created that contains your token. -3. In Zowe Explorer, click the **+** icon. -4. Select the service profile you use with your base profile. The profile appears in the tree and you can now use this profile to access z/OSMF via the API Mediation Layer. -For more information about logging in to the API Mediation Layer, see [Integrating with API Mediation Layer](https://docs.zowe.org/stable/user-guide/cli-usingcli.html#integrating-with-api-mediation-layer). +For more information, see [Integrating with API Mediation Layer](https://docs.zowe.org/stable/user-guide/cli-usingcli.html#integrating-with-api-mediation-layer). ### Sample use cases From d09c2b51ceba5087f395392223804f1de00e7a73 Mon Sep 17 00:00:00 2001 From: Igor Kazmyr <43951184+IgorCATech@users.noreply.github.com> Date: Thu, 15 Oct 2020 18:21:01 +0200 Subject: [PATCH 06/11] more edits Signed-off-by: Igor Kazmyr <43951184+IgorCATech@users.noreply.github.com> --- README.md | 8 +++++--- 1 file changed, 5 insertions(+), 3 deletions(-) diff --git a/README.md b/README.md index eef44bb6b1..cb058b9354 100644 --- a/README.md +++ b/README.md @@ -62,11 +62,11 @@ Create a profile, review the sample use cases to familiarize yourself with the c You can now use all the functionalities of the extension. -### Use Base Profiles +### Use Base Profiles to access API Mediation Layer Leverage existing base profiles with a token to log in to API Mediation Layer. -Before using the base profiles functionality, ensure that you have [Zowe CLI](https://docs.zowe.org/stable/user-guide/cli-installcli.html) installed. +Before using the base profile functionality, ensure that you have [Zowe CLI](https://docs.zowe.org/stable/user-guide/cli-installcli.html) v1.13.0 or higher installed. **Follow these steps:** @@ -76,7 +76,9 @@ Before using the base profiles functionality, ensure that you have [Zowe CLI](ht zowe auth login apiml ``` -2. Follow the instructions and provide all necessary information to create a base profile. +2. Follow the instructions to complete the authentication process and provide all necessary information to create a base profile with a token. + +**Note:** For more information about the process, see [Token Management](https://docs.zowe.org/stable/user-guide/cli-usingcli.html#how-token-management-works). You have successfully created a base profile. From e228f78ae779f082bd35d09c23d55247358e6a53 Mon Sep 17 00:00:00 2001 From: Igor Kazmyr <43951184+IgorCATech@users.noreply.github.com> Date: Thu, 15 Oct 2020 18:23:20 +0200 Subject: [PATCH 07/11] 4 step fix Signed-off-by: Igor Kazmyr <43951184+IgorCATech@users.noreply.github.com> --- README.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/README.md b/README.md index cb058b9354..01cb59e55b 100644 --- a/README.md +++ b/README.md @@ -84,7 +84,7 @@ Before using the base profile functionality, ensure that you have [Zowe CLI](htt 3. Run Zowe Explorer and click the **+** icon. -4. Select the z/OSMF profile you use with your base profile. +4. Select the profile you use with your base profile with the token. The profile appears in the tree and you can now use this profile to access z/OSMF via the API Mediation Layer. From 868d12be4e1fe27b275ea058aaefb83e9b1912e7 Mon Sep 17 00:00:00 2001 From: Igor Kazmyr <43951184+IgorCATech@users.noreply.github.com> Date: Thu, 15 Oct 2020 18:36:54 +0200 Subject: [PATCH 08/11] refactor step 2 Signed-off-by: Igor Kazmyr <43951184+IgorCATech@users.noreply.github.com> --- README.md | 4 ++-- 1 file changed, 2 insertions(+), 2 deletions(-) diff --git a/README.md b/README.md index 01cb59e55b..d5fb775bc5 100644 --- a/README.md +++ b/README.md @@ -76,11 +76,11 @@ Before using the base profile functionality, ensure that you have [Zowe CLI](htt zowe auth login apiml ``` -2. Follow the instructions to complete the authentication process and provide all necessary information to create a base profile with a token. +2. Follow the instructions to complete the login and provide all necessary information to create a base profile with a token. **Note:** For more information about the process, see [Token Management](https://docs.zowe.org/stable/user-guide/cli-usingcli.html#how-token-management-works). - You have successfully created a base profile. + A local base profile is created that contains your token. 3. Run Zowe Explorer and click the **+** icon. From 2af0b6aca6a0a3d955918035bacd67c68b2be311 Mon Sep 17 00:00:00 2001 From: Igor Kazmyr <43951184+IgorCATech@users.noreply.github.com> Date: Thu, 15 Oct 2020 18:43:17 +0200 Subject: [PATCH 09/11] small edit - step 2 Signed-off-by: Igor Kazmyr <43951184+IgorCATech@users.noreply.github.com> --- README.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/README.md b/README.md index d5fb775bc5..2abc54f159 100644 --- a/README.md +++ b/README.md @@ -76,7 +76,7 @@ Before using the base profile functionality, ensure that you have [Zowe CLI](htt zowe auth login apiml ``` -2. Follow the instructions to complete the login and provide all necessary information to create a base profile with a token. +2. Follow the instructions to complete the login. **Note:** For more information about the process, see [Token Management](https://docs.zowe.org/stable/user-guide/cli-usingcli.html#how-token-management-works). From cbad313f1b5f8fdd908e849cd27c710e93220017 Mon Sep 17 00:00:00 2001 From: Igor Kazmyr <43951184+IgorCATech@users.noreply.github.com> Date: Thu, 15 Oct 2020 18:55:32 +0200 Subject: [PATCH 10/11] fix the heading and the meta Signed-off-by: Igor Kazmyr <43951184+IgorCATech@users.noreply.github.com> --- README.md | 4 ++-- 1 file changed, 2 insertions(+), 2 deletions(-) diff --git a/README.md b/README.md index 2abc54f159..052e93802c 100644 --- a/README.md +++ b/README.md @@ -62,9 +62,9 @@ Create a profile, review the sample use cases to familiarize yourself with the c You can now use all the functionalities of the extension. -### Use Base Profiles to access API Mediation Layer +### Use Base Profile and Token with Existing Profiles -Leverage existing base profiles with a token to log in to API Mediation Layer. +Leverage existing base profiles with a token to access z/OSMF via the API Mediation Layer. Before using the base profile functionality, ensure that you have [Zowe CLI](https://docs.zowe.org/stable/user-guide/cli-installcli.html) v1.13.0 or higher installed. From 35c47d1a5c1c716eb015e0588e01573e65a46513 Mon Sep 17 00:00:00 2001 From: Zachariah Mullen Date: Thu, 15 Oct 2020 19:12:23 +0200 Subject: [PATCH 11/11] Fix prepublish Signed-off-by: Zachariah Mullen --- README.md | 15 ++++----------- 1 file changed, 4 insertions(+), 11 deletions(-) diff --git a/README.md b/README.md index 052e93802c..a0b797cb87 100644 --- a/README.md +++ b/README.md @@ -70,17 +70,10 @@ Before using the base profile functionality, ensure that you have [Zowe CLI](htt **Follow these steps:** -1. Open Zowe CLI and run the following command: - - ``` - zowe auth login apiml - ``` - -2. Follow the instructions to complete the login. - -**Note:** For more information about the process, see [Token Management](https://docs.zowe.org/stable/user-guide/cli-usingcli.html#how-token-management-works). - - A local base profile is created that contains your token. +1. Open Zowe CLI and run the following command: `zowe auth login apiml` +2. Follow the instructions to complete the login. + A local base profile is created that contains your token. + **Note:** For more information about the process, see [Token Management](https://docs.zowe.org/stable/user-guide/cli-usingcli.html#how-token-management-works). 3. Run Zowe Explorer and click the **+** icon.