02
Sat, Nov
2 New Articles

RPG API Express Version 3.5.0: Lightning-Fast JSON Composition and More!

Programming News
Typography
  • Smaller Small Medium Big Bigger
  • Default Helvetica Segoe Georgia Times

Introducing RXS 3.5.0

By Kato Integration

We’re happy to announce that RPG API Express (RXS) Version 3.5.0 is here! With the introduction of the new BLDCMP command, RXS developers can compose JSON significantly faster. We’ll touch on several other features and enhancements that make this version an excellent upgrade to your RPG-based API operations. Let’s delve deeper into why these changes matter.

BLDCMP: A Big Change in JSON Composition

In addition to several other code generation enhancements, BLDCMP is the latest addition to RPG API Express, helping developers build JSON quickly using 100% RPG.

How Does it Work?

It’s simple! BLDCMP takes a sample JSON file from the IFS and uses it to generate RPG code that can produce an identical JSON document.

How Does BLDCMP Help You Build JSON Quickly?

  1. Accelerating Development – BLDCMP is designed to help you build out complete JSON composition subroutines quickly with only a sample JSON file.
  2. Minimizing Errors – You can not only develop JSON faster; you can do it with fewer errors. BLDCMP automates your code production, thereby reducing keystrokes, and ultimately mistakes and errors.
  3. Simplifying Program Complexity – JSON documents can be intricate; BLDCMP simplifies them by generating a solid code foundation, which you can then modify to fit more complex scenarios, such as nested fields.

Practical Applications

Consider a challenging scenario where your development team is tasked with building an application that integrates with a new payment processing API, and you have only a couple days to finish the job. Worse yet, this API requires a huge JSON payload consisting of multiple nested objects and arrays for each transaction. Suffice to say, manually coding this in RPG would be a tedious, error-prone process.

Instead of starting from scratch with the traditional JSON composition subprocedures, your team decides to use BLDCMP to kickstart the process. It couldn’t be easier – all you end up having to do is…

  1. Choose a JSON input stream file
  2. Choose whether you want the generated code to be free-format or mixed-format RPG

… and that’s it! Your team has a foundation for building JSON to communicate with an API.

Other Significant Updates

New HTTP Communication Features

RXS 3.5.0 enhances your HTTP development with a variety of new, powerful features, including large / complex JSON Web Token (JWT) handling, and the ability to request HTTP compression via gzip for API responses:

  • JWT – The new HeaderAuthScheme and HeaderAuthCredentials subfields in RXS_TransmitDS_t expand RXS_Transmit()‘s authentication capabilities, allowing for credentials or tokens up to 8K in length. This enhancement is particularly beneficial for supporting complex JWT tokens in Bearer authentication schemes.
  • HTTP compression via gzip – RXS_Transmit() now includes a HeaderAcceptEncoding subfield in RXS_TransmitDS_t, enabling the automatic request and decoding of gzip encoded response data. This feature is set as the default behavior and aims to improve performance when interacting with web APIs that support gzip encoding.

Some other HTTP-related features and enhancements from this RXS release include:

  • Added support for unlimited timeouts when performing API calls
  • RXS_Transmit() now allows output to be directed to both a response field and a response IFS file
  • Improved IFS log file output to properly display chunked encoding
  • New RXSCB constants to make it easier to reference standard HTTP status codes

Encryption, Hashing, and HMAC Support

RPG API Express now features the new RXS_HMAC() subprocedure, elevating its capabilities in terms of data integrity and security. HMAC (Hash-based Message Authentication Code) is particularly important when it comes to generating or verifying secure tokens in your applications. HMAC provides a robust method for authenticating your data, effectively safeguarding it against unauthorized alterations and access. By supporting a variety of algorithms such as SHA1, SHA256, SHA384, SHA512, and MD5, RXS_HMAC() offers developers the flexibility to choose the best cryptographic hash function to fit their security requirements.

Example Programs

We’ve updated our example programs to now include both traditional/mixed and fully free format RPG, maximizing developer flexibility. In addition to format updates, these programs have also been revised to meet our team’s current recommended best practices. We have also revised the example programs’ names for clarity based on the new fixed and free formatting options. See the changelog for more information.

… And More!

While we’ve highlighted some of the major updates in RXS 3.5.0, it’s also worth mentioning that this release is also packed with other valuable enhancements and fixes aimed at improving your overall development experience. In fact, many of these updates were implemented based directly on customer feedback.

What’s New and Improved?

Offering Web Services/APIs: The CRTRXSSVR command now supports 5-digit port numbers up to 65535; it also includes new *HTTP and *HTTPS options for setting its port number to ports 80 and 443 respectively. Additionally, RXS Router now includes an -aspgrp flag for swapping the ASP Group prior to any library list changes or program calls.

Conversion APIs: Improvements have been made in the Base64 and Base64URL decoding features of RXS_Convert(), most of which help with issues around supporting arbitrary whitespace.

Other Changes: This release includes other improvements, such as:

  • The DSPMCHINF command which shows hardware details now also includes the partition UUID
  • The APYLIC command used to apply product license keys no longer interactively prompts when run as part of batch jobs to better support automation

RXS 3.5.0 in a Nutshell

RXS Version 3.5.0 isn’t merely a set of new features; it’s a full-fledged upgrade to your favorite RPG development toolkit! BLDCMP in particular is bound to be a staple in your future JSON composition. Combined with all the other updates, RXS continues to evolve as a comprehensive solution for your API development needs.

To find out more and to get started with these new features, check out our updated documentation site. Your journey towards more efficient IBM i development starts here!


BLOG COMMENTS POWERED BY DISQUS

LATEST COMMENTS

Support MC Press Online

$

Book Reviews

Resource Center

  • SB Profound WC 5536 Have you been wondering about Node.js? Our free Node.js Webinar Series takes you from total beginner to creating a fully-functional IBM i Node.js business application. You can find Part 1 here. In Part 2 of our free Node.js Webinar Series, Brian May teaches you the different tooling options available for writing code, debugging, and using Git for version control. Brian will briefly discuss the different tools available, and demonstrate his preferred setup for Node development on IBM i or any platform. Attend this webinar to learn:

  • SB Profound WP 5539More than ever, there is a demand for IT to deliver innovation. Your IBM i has been an essential part of your business operations for years. However, your organization may struggle to maintain the current system and implement new projects. The thousands of customers we've worked with and surveyed state that expectations regarding the digital footprint and vision of the company are not aligned with the current IT environment.

  • SB HelpSystems ROBOT Generic IBM announced the E1080 servers using the latest Power10 processor in September 2021. The most powerful processor from IBM to date, Power10 is designed to handle the demands of doing business in today’s high-tech atmosphere, including running cloud applications, supporting big data, and managing AI workloads. But what does Power10 mean for your data center? In this recorded webinar, IBMers Dan Sundt and Dylan Boday join IBM Power Champion Tom Huntington for a discussion on why Power10 technology is the right strategic investment if you run IBM i, AIX, or Linux. In this action-packed hour, Tom will share trends from the IBM i and AIX user communities while Dan and Dylan dive into the tech specs for key hardware, including:

  • Magic MarkTRY the one package that solves all your document design and printing challenges on all your platforms. Produce bar code labels, electronic forms, ad hoc reports, and RFID tags – without programming! MarkMagic is the only document design and print solution that combines report writing, WYSIWYG label and forms design, and conditional printing in one integrated product. Make sure your data survives when catastrophe hits. Request your trial now!  Request Now.

  • SB HelpSystems ROBOT GenericForms of ransomware has been around for over 30 years, and with more and more organizations suffering attacks each year, it continues to endure. What has made ransomware such a durable threat and what is the best way to combat it? In order to prevent ransomware, organizations must first understand how it works.

  • SB HelpSystems ROBOT GenericIT security is a top priority for businesses around the world, but most IBM i pros don’t know where to begin—and most cybersecurity experts don’t know IBM i. In this session, Robin Tatam explores the business impact of lax IBM i security, the top vulnerabilities putting IBM i at risk, and the steps you can take to protect your organization. If you’re looking to avoid unexpected downtime or corrupted data, you don’t want to miss this session.

  • SB HelpSystems ROBOT GenericCan you trust all of your users all of the time? A typical end user receives 16 malicious emails each month, but only 17 percent of these phishing campaigns are reported to IT. Once an attack is underway, most organizations won’t discover the breach until six months later. A staggering amount of damage can occur in that time. Despite these risks, 93 percent of organizations are leaving their IBM i systems vulnerable to cybercrime. In this on-demand webinar, IBM i security experts Robin Tatam and Sandi Moore will reveal:

  • FORTRA Disaster protection is vital to every business. Yet, it often consists of patched together procedures that are prone to error. From automatic backups to data encryption to media management, Robot automates the routine (yet often complex) tasks of iSeries backup and recovery, saving you time and money and making the process safer and more reliable. Automate your backups with the Robot Backup and Recovery Solution. Key features include:

  • FORTRAManaging messages on your IBM i can be more than a full-time job if you have to do it manually. Messages need a response and resources must be monitored—often over multiple systems and across platforms. How can you be sure you won’t miss important system events? Automate your message center with the Robot Message Management Solution. Key features include:

  • FORTRAThe thought of printing, distributing, and storing iSeries reports manually may reduce you to tears. Paper and labor costs associated with report generation can spiral out of control. Mountains of paper threaten to swamp your files. Robot automates report bursting, distribution, bundling, and archiving, and offers secure, selective online report viewing. Manage your reports with the Robot Report Management Solution. Key features include:

  • FORTRAFor over 30 years, Robot has been a leader in systems management for IBM i. With batch job creation and scheduling at its core, the Robot Job Scheduling Solution reduces the opportunity for human error and helps you maintain service levels, automating even the biggest, most complex runbooks. Manage your job schedule with the Robot Job Scheduling Solution. Key features include:

  • LANSA Business users want new applications now. Market and regulatory pressures require faster application updates and delivery into production. Your IBM i developers may be approaching retirement, and you see no sure way to fill their positions with experienced developers. In addition, you may be caught between maintaining your existing applications and the uncertainty of moving to something new.

  • LANSAWhen it comes to creating your business applications, there are hundreds of coding platforms and programming languages to choose from. These options range from very complex traditional programming languages to Low-Code platforms where sometimes no traditional coding experience is needed. Download our whitepaper, The Power of Writing Code in a Low-Code Solution, and:

  • LANSASupply Chain is becoming increasingly complex and unpredictable. From raw materials for manufacturing to food supply chains, the journey from source to production to delivery to consumers is marred with inefficiencies, manual processes, shortages, recalls, counterfeits, and scandals. In this webinar, we discuss how:

  • The MC Resource Centers bring you the widest selection of white papers, trial software, and on-demand webcasts for you to choose from. >> Review the list of White Papers, Trial Software or On-Demand Webcast at the MC Press Resource Center. >> Add the items to yru Cart and complet he checkout process and submit

  • Profound Logic Have you been wondering about Node.js? Our free Node.js Webinar Series takes you from total beginner to creating a fully-functional IBM i Node.js business application.

  • SB Profound WC 5536Join us for this hour-long webcast that will explore:

  • Fortra IT managers hoping to find new IBM i talent are discovering that the pool of experienced RPG programmers and operators or administrators with intimate knowledge of the operating system and the applications that run on it is small. This begs the question: How will you manage the platform that supports such a big part of your business? This guide offers strategies and software suggestions to help you plan IT staffing and resources and smooth the transition after your AS/400 talent retires. Read on to learn: