Modernize mainframe online printing workloads on AWS by using Micro Focus Enterprise Server and LRS VPSX/MFI
Created by Shubham Roy (AWS), Abraham Rondon (Micro Focus), Guy Tucker (Levi, Ray and Shoup Inc), and Kevin Yung (AWS)
Environment: PoC or pilot | Source: Mainframe | Target: AWS |
R Type: Replatform | Workload: IBM | Technologies: Mainframe; Migration; Modernization |
AWS services: AWS Managed Microsoft AD; Amazon EC2; Amazon RDS; Amazon EBS |
Summary
This pattern shows you how to modernize your business-critical mainframe online printing workloads on the Amazon Web Services (AWS) Cloud by using Micro Focus Enterprise Server as a runtime for a modernized mainframe application and LRS VPSX/MFI (Micro Focus Interface) as a print server. The pattern is based on the replatform
Prerequisites and limitations
Prerequisites
An active AWS account
A mainframe online printing or output management workload
Basic knowledge of how to rebuild and deliver a mainframe application that runs on Micro Focus Enterprise Server (For more information, see the Enterprise Server
data sheet in the Micro Focus documentation.) Basic knowledge of LRS cloud printing solutions and concepts (For more information, see Output Modernization
in the LRS documentation.) Micro Focus Enterprise Server software and license (For more information, contact Micro Focus sales
.) LRS VPSX/MFI, LRS/Queue, and LRS/DIS software and licenses (For more information, contact LRS sales
.)
Note: For more information about configuration considerations for mainframe online printing workloads, see Considerations in the Additional information section of this pattern.
Product versions
Micro Focus Enterprise Server
8.0 or later LRS VPSX/MFI
V1R3 or later
Architecture
Source technology stack
Operating system – IBM z/OS
Programming language – Common Business-Oriented Language (COBOL) and Customer Information Control System (CICS)
Database – IBM DB2 for z/OS IBM Information Management System (IMS) and Virtual Storage Access Method (VSAM)
Security – Resource Access Control Facility (RACF), CA Top Secret for z/OS, and Access Control Facility 2 (ACF2)
Printing and output management – IBM mainframe z/OS printing products (IBM Infoprint Server for z/OS, LRS, and CA View)
Target technology stack
Operating system – Microsoft Windows Server running on Amazon EC2
Compute – Amazon EC2
Programming language – COBOL and CICS
Database – Amazon RDS
Security – AWS Managed Microsoft AD
Printing and output management – LRS printing solution on AWS
Mainframe runtime environment – Micro Focus Enterprise Server
Source architecture
The following diagram shows a typical current state architecture for a mainframe online printing workload.
The diagram shows the following workflow:
Users perform business transactions on a system of engagement (SoE) that’s built on an IBM CICS application written in COBOL.
The SoE invokes the mainframe service, which records the business transaction data in a system-of-records (SoR) database such as IBM DB2 for z/OS.
The SoR persists the business data from the SoE.
A user initiates a request to generate print output from the CICS SoE, which initiates a print transaction application to process the print request.
The print transaction application (such as a CICS and COBOL program) extracts data from the database, formats the data according to business requirements, and generates business output (print data) such as billing statements, ID cards, or loan statements. Then, the application sends a print request by using Virtual Telecommunications Access Method (VTAM). A z/OS print server (such as IBM Infoprint Server) uses NetSpool or a similar VTAM component to intercept the print requests, and then creates print output datasets on the JES spool by using JES output parameters. The JES output parameters specify routing information that the print server uses to transmit the output to a particular network printer. The term VTAM refers to the z/OS Communications Server and the System Network Architecture (SNA) services element of z/OS.
The printing output transmission component transmits the output print datasets from the JES spool to remote printers or print servers, such as LRS (as demonstrated in this pattern), IBM Infoprint Server, or email destinations.
Target architecture
The following diagram shows an architecture for a mainframe online printing workload that’s deployed in the AWS Cloud:
The diagram shows the following workflow:
A user initiates a print request from an online (CICS) user-interface to create print output, such as billing statements, ID cards, or loan statements.
The mainframe online application (replatformed to Amazon EC2
) uses the Micro Focus Enterprise Server runtime to extract data from the application database, apply business logic to the data, format the data, and then send the data to a print destination by using Micro Focus CICS Print Exit (DFHUPRNT). The application database (an SoR that runs on Amazon RDS) persists data for print output.
The LRS VPSX/MFI printing solution is deployed on Amazon EC2, and its operational data is stored in Amazon Elastic Block Store (Amazon EBS). LRS VPSX/MFI uses a TCP/IP-based LRS/Queue transmission agent to collect print data through the Micro Focus CICS Print Exit API (DFHUPRNT) and deliver the data to a specified printer destination. The original TERMID (TERM) that’s used in the modernized CICS application is used as the VPSX/MFI Queue name.
Note: The target solution typically doesn’t require application changes to accommodate mainframe formatting languages, such as IBM Advanced Function Presentation (AFP) or Xerox Line Condition Data Stream (LCDS). For more information about using Micro Focus for mainframe application migration and modernization on AWS, see Empowering Enterprise Mainframe Workloads on AWS with Micro Focus
AWS infrastructure architecture
The following diagram shows a highly available and secure AWS infrastructure architecture for a mainframe online printing workload:
The diagram shows the following workflow:
The mainframe online application (written on a programming language such as CICS or COBOL) uses core business logic to process and generate print output, such as billing statements, ID cards, and loan statements. The online application is deployed on Amazon EC2 across two Availability Zones
(AZ) for high availability (HA) and uses Micro Focus CICS Print Exit to route print output to LRS VPSX/MFI for end-user printing. LRS VPSX/MFI uses a TCP/IP-based LRS/Queue transmission agent to collect or capture print data from the Micro Focus online Print Exit programming interface. Online Print Exit passes the necessary information to enable LRS VPSX/MFI to effectively process the print file and dynamically build LRS/Queue commands.
Note: For more information on various CICS application programing methods for print and how they are supported in Micro Focus Enterprise server and LRS VPSX/MFI, see Print data capture in the Additional information section of this pattern.
A Network Load Balancer provides a DNS name to integrate Micro Focus Enterprise Server with LRS VPSX/MFI. Note: LRS VPSX/MFI supports a Layer 4 load balancer. The Network Load Balancer also does a basic health check on LRS VPSX/MFI and routes traffic to the registered targets that are healthy.
The LRS VPSX/MFI print server is deployed on Amazon EC2 across two Availability Zones for HA and uses Amazon EBS as an operational data store. LRS VPSX/MFI supports both the active-active and active-passive service modes. This architecture uses multiple Availability Zones in an active-passive pair as an active and hot standby. The Network Load Balancer performs a health check on LRS VPSX/MFI EC2 instances and routes traffic to hot standby instances in another Availability Zone if an active instance is in an unhealthy state. The print requests are persisted in the LRS Job Queue locally in each of the EC2 instances. In the event of recovery, a failed instance has to be restarted for the LRS services to resume processing the print request.
Note: LRS VPSX/MFI can also perform health checks at the printer fleet level. For more information, see Printer fleet health checks in the Additional information section of this pattern.
AWS Managed Microsoft AD integrates with LRS/DIS to perform print workflow authentication and authorization. For more information, see Print authentication and authorization in the Additional information section of this pattern.
LRS VPSX/MFI uses Amazon EBS for block storage. You can back up Amazon EBS data from active EC2 instances to Amazon S3 as point-in-time snapshots and restore them to hot standby EBS volumes. To automate the creation, retention, and deletion of Amazon EBS volume snapshots, you can use Amazon Data Lifecycle Manager
to set the frequency of automated snapshots and restore them based on your RTO/RPO requirements.
Tools
AWS services
Amazon Elastic Block Store (Amazon EBS) provides block-level storage volumes for use with Amazon EC2 instances. EBS volumes behave like raw, unformatted block devices. You can mount these volumes as devices on your instances.
Amazon Elastic Compute Cloud (Amazon EC2) provides scalable computing capacity in the AWS Cloud. You can launch as many virtual servers as you need and quickly scale them up or down.
Amazon Relational Database Service (Amazon RDS) helps you set up, operate, and scale a relational database in the AWS Cloud.
AWS Directory Service for Microsoft Active Directory (AD)
, also known as AWS Managed Microsoft Active Directory, enables your directory-aware workloads and AWS resources to use managed Active Directory in AWS.
Other tools
LRS VPSX/MFI (Micro Focus Interface)
, co-developed by LRS and Micro Focus, captures output from a Micro Focus Enterprise Server JES spool and reliably delivers it to a specified print destination. LRS Directory Information Server (LRS/DIS) is used for authentication and authorization during the print workflow.
LRS/Queue is a TCP/IP-based LRS/Queue transmission agent, used by LRS VPSX/MFI, to collect or capture print data through the Micro Focus online Print Exit programming interface.
Micro Focus Enterprise Server
is an application deployment environment for mainframe applications. It provides the execution environment for mainframe applications that are migrated or created by using any version of Micro Focus Enterprise Developer.
Epics
Task | Description | Skills required |
---|---|---|
Set up Micro Focus Enterprise Server and deploy a demo online application. | Set up Micro Focus Enterprise Server on Amazon EC2, and then deploy the Micro Focus Account Demo application (ACCT Demo) on Amazon EC2 by following the instructions from Tutorial: CICS Support The ACCT Demo application is a mainframe online (CICS) application that creates and then initiates print output. | Cloud architect |
Task | Description | Skills required |
---|---|---|
Get an LRS product license for printing. | To get an LRS product license for LRS VPSX/MFI, LRS/Queue, and LRS/DIS, contact the LRS Output Management team | Build lead |
Create an Amazon EC2 Windows instance to install LRS VPSX/MFI. | Launch an Amazon EC2 Windows instance by following the instructions from Step 1: Launch an instance in the Amazon EC2 documentation. Your instance must meet the following hardware and software requirements for LRS VPSX/MFI:
Note: The preceding hardware and software requirements are intended for a small printer fleet (around 500–1000). To get the full requirements, consult with your LRS and AWS contacts. When you create your Windows instance, do the following:
| Cloud architect |
Install LRS VPSX/MFI on the EC2 instance. |
| Cloud architect |
Install LRS/Queue. |
| Cloud architect |
Install LRS/DIS. |
| Cloud architect |
Create a target group and register LRS VPSX/MFI EC2 as the target. | Create a target group by following the instructions from Create a target group for your Network Load Balancer in the Elastic Load Balancing documentation. When you create the target group, do the following:
| Cloud architect |
Create a Network Load Balancer. | Follow the instructions from Create a Network Load Balancer in the Elastic Load Balancing documentation. Your Network Load Balancer routes traffic from Micro Focus Enterprise Server to LRS VPSX/MFI EC2. When you create the Network Load Balancer, do the following on the Listeners and Routing page:
| Cloud architect |
Task | Description | Skills required |
---|---|---|
Configure Micro Focus Enterprise Server for LRS/Queue integration. |
| Cloud architect |
Make CICS Print Exit (DFHUPRNT) available to Micro Focus Enterprise Server initialization. |
Validate that Micro Focus Enterprise Server has detected CICS Print Exit (DFHUPRNT)
| Cloud architect |
Define the CICS printer's terminal ID (TERMIDs) as Micro Focus Enterprise Server. | Enable 3270 printing in Micro Focus Enterprise Server
Define the CICS printer's terminal in Micro Focus Enterprise Server
| Cloud architect |
Task | Description | Skills required |
---|---|---|
Create a print queue in the LRS VPSX. |
Note: The print queue must be equivalent to the Print TERMIDs created in Micro Focus Enterprise Server. | Cloud architect |
Create a print user in LRS VPSX/MFI. |
| Cloud architect |
Task | Description | Skills required |
---|---|---|
Create an AWS Managed Microsoft AD domain with users and groups. |
| Cloud architect |
Join LRS VPSX/MFI EC2 to an AWS Managed Microsoft AD domain. | Join LRS VPSX/MFI EC2 to your AWS Managed Microsoft AD domain automatically | Cloud architect |
Configure and integrate LRS/DIS with AWS Managed Microsoft AD. |
| Cloud architect |
Task | Description | Skills required |
---|---|---|
Initiate an online print request from the Micro Focus ACCT Demo app. |
The “Print Request Scheduled” message appears at the bottom of the screen. This confirms that an online print request was generated from the ACCT Demo application and sent to LRS VPS/MFI for print processing. | Cloud architect |
Check the print output in LRS VPSX/MFI. |
You can now see the print output of an account statement with columns for Account No., SURNAME, FIRST, ADDRESS, TELEPHONE, No. Cards Issued, Date issued, Amount, and Balance. For an example, see the online_print_output attachment for this pattern. | Test engineer |
Related resources
LRS Output Modernization
(LRS documentation) VTAM networking concepts
(IBM documentation) Summary of logical unit (LU) types
(IBM documentation) ANSI and machine carriage controls
(IBM documentation) Empowering Enterprise Mainframe Workloads on AWS with Micro Focus
(AWS Partner Network Blog) Build a Micro Focus Enterprise Server PAC with Amazon EC2 Auto Scaling and Systems Manager (AWS Prescriptive Guidance documentation)
Advanced Function Presentation (AFP) data stream
(IBM documentation) Line Conditioned Data Stream (LCDS)
(Compart documentation)
Additional information
Considerations
During your modernization journey, you may consider a wide variety of configurations for mainframe online processes and the output they generate. The mainframe platform has been customized by every customer and vendor that uses it with particular requirements that directly affect print. For example, your current platform may incorporate the IBM Advanced Function Presentation (AFP) or the Xerox Line Condition Data Stream (LCDS) into the current workflow. Additionally, mainframe carriage control characters
Print data capture
This section summarizes the CICS application programming methods that you can use in an IBM mainframe environment for printing. LRS VPSX/MFI components provide techniques to allow the same application programs to create data in the same way. The following table describes how each application programming method is supported in a modernized CICS application running in AWS and Micro Focus Enterprise Server with an LRS VPSX/MFI print server.
Method | Description | Support for the method in a modernized environment |
---|---|---|
EXEC CICS SEND TEXT.. or EXEC CICS SEND MAP.. | These CICS and VTAM methods are responsible for creating and delivering 3270/SCS print data streams to LUTYPE0, LUTYPE1, and LUTYPE3 print devices. | A Micro Focus online Print Exit (DFHUPRNT) application program interface (API) enables print data to be processed by VPSX/MFI when 3270/SCS print data streams are created by using either of these methods. |
EXEC CICS SEND TEXT.. or EXEC CICS SEND MAP.. (with third-party IBM mainframe software) | The CICS and VTAM methods are responsible for creating and delivering 3270/SCS print data streams to LUTYPE0, LUTYPE1, and LUTYPE3 print devices. Third-party software products intercept the print data, convert the data to standard print format data with an ASA/MCH control character, and place the data on the JES spool to be processed by mainframe-based printing systems that use JES. | A Micro Focus online Print Exit (DFHUPRNT) API enables print data to be processed by VPSX/MFI when 3270/SCS print data streams are created by using either of these methods. |
EXEC CICS SPOOLOPEN | This method is used by CICS application programs to write data directly to the JES spool. The data then becomes available to be processed by mainframe-based printing systems that use JES. | Micro Focus Enterprise Server spools the data to the Enterprise Server spool where it can be processed by the VPSX/MFI Batch Print Exit (LRSPRTE6) that spools the data to VPSX. |
DRS/API | An LRS-supplied programmatic interface is used for writing print data to JES. | VPSX/MFI supplies a replacement interface that spools the print data directly to VPSX. |
Printer fleet health checks
LRS VPSX/MFI (LRS LoadX) can perform deep dive health checks, including device management and operational optimization. Device management can detect failure in a printer device and route the print request to a healthy printer. For more information about deep dive health checks for printer fleets, see the LRS documentation that’s included with your product license.
Print authentication and authorization
LRS/DIS enables LRS applications to authenticate user IDs and passwords by using Microsoft Active Directory or an LDAP server. In addition to basic print authorization, LRS/DIS can also apply granular-level print security controls in the following use cases:
Manage who can browse the printer job.
Manage the browsing level of other user's jobs.
Manage operational tasks. For example, command-level security such as hold/release, purge, modify, copy, and reroute. Security can be set up by either the User-ID or Group (similar to AD group or LDAP group).
Attachments
To access additional content that is associated with this document, unzip the following file: attachment.zip