AWS prescriptive-guidance documentation change
Summary
Updated references from 'Quick Suite' to 'Quick Sight' and corrected product name capitalization (e.g., 'File Transfer' to 'file transfer'). Fixed documentation links and clarified Amazon Q integration details.
Security assessment
Changes are primarily editorial corrections (brand name consistency, URL fixes, and typo fixes). No explicit security vulnerabilities or new security controls are introduced. The existing security recommendation about IAM least privilege remains unchanged except for capitalization.
Diff
diff --git a/prescriptive-guidance/latest/patterns/generate-data-insights-by-using-aws-mainframe-modernization-and-amazon-q-in-quicksight.md b/prescriptive-guidance/latest/patterns/generate-data-insights-by-using-aws-mainframe-modernization-and-amazon-q-in-quicksight.md index cc915673c..bb3c159d5 100644 --- a//prescriptive-guidance/latest/patterns/generate-data-insights-by-using-aws-mainframe-modernization-and-amazon-q-in-quicksight.md +++ b//prescriptive-guidance/latest/patterns/generate-data-insights-by-using-aws-mainframe-modernization-and-amazon-q-in-quicksight.md @@ -15 +15 @@ If your organization is hosting business-critical data in a mainframe environmen -This pattern presents a solution for generating business insights and creating sharable narratives from mainframe data by using [AWS Mainframe Modernization File Transfer](https://docs.aws.amazon.com/m2/latest/userguide/filetransfer.html) with BMC and [Amazon Q in QuickSight](https://docs.aws.amazon.com/quicksight/latest/user/quicksight-gen-bi.html). Mainframe datasets are transferred to [Amazon Simple Storage Service (Amazon S3)](https://docs.aws.amazon.com/AmazonS3/latest/userguide/Welcome.html) by using AWS Mainframe Modernization File Transfer with BMC. An AWS Lambda function formats and prepares mainframe data file for loading into Amazon Quick Suite. +This pattern presents a solution for generating business insights and creating sharable narratives from mainframe data by using [AWS Mainframe Modernization file transfer](https://docs.aws.amazon.com/m2/latest/userguide/filetransfer.html) with BMC and [Amazon Q in Quick Sight](https://docs.aws.amazon.com/quicksight/latest/user/quicksight-gen-bi.html). Mainframe datasets are transferred to [Amazon Simple Storage Service (Amazon S3)](https://docs.aws.amazon.com/AmazonS3/latest/userguide/Welcome.html) by using AWS Mainframe Modernization file transfer with BMC. An AWS Lambda function formats and prepares mainframe data file for loading into Quick Sight. @@ -17 +17 @@ This pattern presents a solution for generating business insights and creating s -After the data is available in Quick Suite, you can use natural language prompts with Amazon Q in QuickSight to create summaries of the data, ask questions, and generate data stories. You don't have to write SQL queries or learn a business intelligence (BI) tool. +After the data is available in Quick Sight, you can use natural language prompts with [Amazon Q](https://docs.aws.amazon.com/quicksight/latest/user/quicksight-gen-bi.html) in Quick Sight to create summaries of the data, ask questions, and generate data stories. You don't have to write SQL queries or learn a business intelligence (BI) tool. @@ -53 +53 @@ After you create the dashboard, you generate a data story that explains the insi - * Your mainframe data file should be in one of the file formats supported by Quick Suite. For a list supported file formats, see the [Amazon Quick Suite documentation](https://docs.aws.amazon.com/quicksight/latest/user/supported-data-sources.html#file-data-sources). + * Your mainframe data file should be in one of the file formats supported by Quick Sight. For a list supported file formats, see [Supported data sources](https://docs.aws.amazon.com/quicksuite/latest/userguide/supported-data-sources.html). @@ -55 +55 @@ After you create the dashboard, you generate a data story that explains the insi -This pattern uses a Lambda function to convert the mainframe file into a format supported by Quick Suite. + * This pattern uses a Lambda function to convert the mainframe file into a format supported by Quick Sight. @@ -62 +62 @@ This pattern uses a Lambda function to convert the mainframe file into a format -The following diagram shows an architecture for generating business insights from mainframe data by using AWS Mainframe Modernization File Transfer with BMC and Amazon Q in QuickSight. +The following diagram shows an architecture for generating business insights from mainframe data by using AWS Mainframe Modernization file transfer with BMC and Amazon Q in Quick Sight. @@ -68 +68 @@ The diagram shows the following workflow: - 1. A mainframe dataset containing business data is transferred to Amazon S3 by using AWS Mainframe Modernization File Transfer with BMC. + 1. A mainframe dataset containing business data is transferred to Amazon S3 by using AWS Mainframe Modernization file transfer with BMC. @@ -74 +74 @@ The diagram shows the following workflow: - 4. The data in the file is ingested by Quick Suite. + 4. The data in the file is ingested by Quick Sight. @@ -76 +76 @@ The diagram shows the following workflow: - 5. Users access the data in Quick Suite. You can use Amazon Q in QuickSight to interact with the data by using natural language prompts. + 5. Users access the data in Quick Sight. You can use Amazon Q in Quick Sight to interact with the data by using natural language prompts. @@ -87 +87 @@ The diagram shows the following workflow: - * [AWS Mainframe Modernization File Transfer with BMC](https://docs.aws.amazon.com/m2/latest/userguide/filetransfer.html) converts and transfers mainframe datasets to Amazon S3 for mainframe modernization, migration, and augmentation use cases. + * [AWS Mainframe Modernization file transfer with BMC](https://docs.aws.amazon.com/m2/latest/userguide/filetransfer.html) converts and transfers mainframe datasets to Amazon S3 for mainframe modernization, migration, and augmentation use cases. @@ -89 +89 @@ The diagram shows the following workflow: - * [Amazon Quick Suite](https://docs.aws.amazon.com/quicksight/latest/user/welcome.html) is a cloud-scale BI service that helps you visualize, analyze, and report your data in a single dashboard. This pattern uses the generative BI capabilities of [Amazon Q in QuickSight](https://docs.aws.amazon.com/quicksight/latest/user/working-with-quicksight-q.html). + * [Amazon Quick Sight](https://docs.aws.amazon.com/quicksight/latest/user/welcome.html) is a cloud-scale BI service that helps you visualize, analyze, and report your data in a single dashboard. This pattern uses the generative BI capabilities of [Amazon Q in Quick Sight](https://docs.aws.amazon.com/quicksight/latest/user/working-with-quicksight-q.html). @@ -98 +98 @@ The diagram shows the following workflow: - * When you create the AWS Identity and Access Management (IAM) roles for AWS Mainframe Modernization File Transfer with BMC and the Lambda function, follow the principle of [least privilege](https://docs.aws.amazon.com/IAM/latest/UserGuide/best-practices.html#grant-least-privilege). + * When you create the AWS Identity and Access Management (IAM) roles for AWS Mainframe Modernization file transfer with BMC and the Lambda function, follow the principle of [least privilege](https://docs.aws.amazon.com/IAM/latest/UserGuide/best-practices.html#grant-least-privilege). @@ -100 +100 @@ The diagram shows the following workflow: - * Ensure that your source dataset has [supported data types](https://docs.aws.amazon.com/quicksight/latest/user/supported-data-types-and-values.html) for Quick Suite. If your source dataset contains unsupported data types, convert them to supported data types. For information about unsupported mainframe data types and how to convert them to data types supported by Amazon Q in QuickSight, see the Related resources section. + * Ensure that your source dataset has [supported data types](https://docs.aws.amazon.com/quicksight/latest/user/supported-data-types-and-values.html) for Quick Sight. If your source dataset contains unsupported data types, convert them to supported data types. For information about unsupported mainframe data types and how to convert them to data types supported by Amazon Q in Quick Sight, see the Related resources section. @@ -109,2 +109,2 @@ Task| Description| Skills required -Install the file transfer agent.| To install AWS Mainframe Modernization File Transfer Agent on your mainframe, follow the instructions in the [AWS documentation](https://docs.aws.amazon.com/m2/latest/userguide/m2-agent-installation.html).| Mainframe system administrator -Create an S3 bucket for mainframe file transfer.| [Create an S3 bucket](https://docs.aws.amazon.com/AmazonS3/latest/userguide/create-bucket-overview.html) to store the output file from AWS Mainframe Modernization File Transfer with BMC. In the architecture diagram, this is the file-transfer destination bucket.| Migration engineer +Install the file transfer agent.| To install AWS Mainframe Modernization file transfer agent, follow the instructions in the [AWS documentation](https://docs.aws.amazon.com/m2/latest/userguide/m2-agent-installation.html).| Mainframe system administrator +Create an S3 bucket for mainframe file transfer.| [Create an S3 bucket](https://docs.aws.amazon.com/AmazonS3/latest/userguide/create-bucket-overview.html) to store the output file from AWS Mainframe Modernization file transfer with BMC. In the architecture diagram, this is the file-transfer destination bucket.| Migration engineer @@ -113 +113 @@ Create the data transfer endpoint.| - 1. Create an S3 bucket to stage the input mainframe file for AWS Mainframe Modernization File Transfer with BMC. + 1. Create an S3 bucket to stage the input mainframe file for AWS Mainframe Modernization file transfer with BMC. @@ -129 +129 @@ Create a Lambda function.| To create a Lambda function that changes the file ext - 7. Choose the **Code** tab, and then paste the `S3CopyLambda.py` Python code that's provided in the Additional information section. The Python code was generated by using [Amazon Q Developer](https://docs.aws.amazon.com/amazonq/latest/qdeveloper-ug/what-is.html) in the Microsoft Visual Studio integrated development environment (IDE). + 7. Choose the **Code** tab, and then paste the `S3CopyLambda.py` Python code that's provided in the Additional information section. The Python code was generated by using Amazon Q in the Microsoft Visual Studio integrated development environment (IDE). @@ -155 +155 @@ Verify the transfer task.| To verify that the data transfer is successful, follo -Verify the Lambda copy function.| Verify that the Lambda function is initiated and that the file is copied with a .csv extension to the source dataset S3 bucket.The .csv file created by the Lambda function is the input data file for Quick Suite. For example data, see the `Sample-data-member-healthcare-APG` file in the Attachments section.| Migration lead +Verify the Lambda copy function.| Verify that the Lambda function is initiated and that the file is copied with a .csv extension to the source dataset S3 bucket.The .csv file created by the Lambda function is the input data file for Quick Sight. For example data, see the `Sample-data-member-healthcare-APG` file in the Attachments section.| Migration lead @@ -159,2 +159,2 @@ Task| Description| Skills required -Set up Quick Suite.| To set up Quick Suite, follow the instructions in the [AWS documentation](https://docs.aws.amazon.com/quicksight/latest/user/setting-up.html).| Migration lead -Create a dataset for Quick Suite.| To create a dataset for Quick Suite, follow the instructions in the [AWS documentation](https://docs.aws.amazon.com/quicksight/latest/user/create-a-data-set-s3.html). The input data file is the converted mainframe file that was created when you defined the mainframe data transfer task.| Migration lead +Set up Quick Sight.| To set up Quick Sight, follow the instructions in the [AWS documentation](https://docs.aws.amazon.com/quicksight/latest/user/setting-up.html).| Migration lead +Create a dataset for Quick Sight.| To create a dataset for Quick Sight, follow the instructions in the [AWS documentation](https://docs.aws.amazon.com/quicksight/latest/user/create-a-data-set-s3.html). The input data file is the converted mainframe file that was created when you defined the mainframe data transfer task.| Migration lead @@ -172 +172 @@ Set up Amazon Q in QuickSight.| This capability requires Enterprise Edition. To -Analyze mainframe data and build a visual dashboard.| To analyze and visualize your data in Quick Suite, do the following: +Analyze mainframe data and build a visual dashboard.| To analyze and visualize your data in Quick Sight, do the following: @@ -210 +210 @@ Issue| Solution -Unable to discover the mainframe files or datasets entered in **Data sets search criteria** for **Create transfer task** in AWS Mainframe Modernization File Transfer with BMC.| +Unable to discover the mainframe files or datasets entered in **Data sets search criteria** for **Create transfer task** in AWS Mainframe Modernization file transfer with BMC.| @@ -219 +219 @@ Unable to discover the mainframe files or datasets entered in **Data sets search -To convert mainframe data types such as [PACKED-DECIMAL (COMP-3)](https://www.ibm.com/docs/en/cobol-zos/6.3?topic=v6-packed-decimal-comp-3) or [BINARY (COMP or COMP-4)](https://www.ibm.com/docs/en/cobol-zos/6.3?topic=v6-binary-comp-comp-4) to a [data type](https://docs.aws.amazon.com/quicksight/latest/user/supported-data-types-and-values.html) supported by Quick Suite, see the following patterns: +To convert mainframe data types such as [PACKED-DECIMAL (COMP-3)](https://www.ibm.com/docs/en/cobol-zos/6.3?topic=v6-packed-decimal-comp-3) or [BINARY (COMP or COMP-4)](https://www.ibm.com/docs/en/cobol-zos/6.3?topic=v6-binary-comp-comp-4) to a [data type](https://docs.aws.amazon.com/quicksight/latest/user/supported-data-types-and-values.html) supported by Quick Sight, see the following patterns: @@ -232 +232 @@ To convert mainframe data types such as [PACKED-DECIMAL (COMP-3)](https://www.ib -The following Python code was generated by using a prompt with Amazon Q Developer in an IDE: +The following Python code was generated by using a prompt with Amazon Q in an IDE: