04
Wed, Dec
6 New Articles

TechTip: Shoot for Orion with Your RPG

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

We're going to disrupt your comfort zone. RPG in the IFS. Browser-based development environments. T-shirts with tags that line the collar.

 

The April announcement of V7.3 by IBM was a great time to receive new goodies for IBM i. You can gain a full perspective at Steve Will's blog. In this article, I will be focusing on the Orion addition, which is option 8 of 5733OPS. I will also dive into a little bit of Git, which IBM is also now delivering with 5733OPS.

 

First things first: What is Orion?

 

You can gain some initial insight by heading over to orionhub.org. As quoted from the website, the concept is "A modern, open source software development environment that runs in the cloud." The topic of using browser-based development tools has been of great interest to me the past few years. Six years ago, I would have said, "There’s no way I can use a browser-based development environment." However, my perception has changed a lot. To put it into perspective, how much time did you spend updating SEU back in the day? Exactly! It was installed once for all developers. Browser-based tools afford us similar efficiencies. The kicker: SEU is a server-side editor. So we've come full circle and now have a new server-side (browser-based) source code editor. Its name is Orion.

 

Orion goes further than just an editor. It wasn't created for IBM i. Rather, it’s existed for a number of years. Orion was developed by the Eclipse Foundation, among a few other browser-based development environments.

 

It’s important to understand that Orion does not replace RDi. RDi is very feature-rich and very "IBM i aware." Orion not so much. In some ways, that's OK, although I do hope it grows in IBM i capabilities. Check out the Orion docs to learn about the full set of features.

 

Sometimes, the best way to introduce a new tool is to run through a scenario. Our goal for this article is to edit RPG code stored in the IFS and use Git to change manage it, all from the browser-based Orion tooling. We won't be covering the install or startup of Orion on IBM i. Instead, that can be learned from the Orion developerWorks page.

 

"What is this RPG-in-the-IFS you speak of, Aaron?"

 

Yes, you heard me correctly. RPG can be stored in the IFS. Commands like CRTBNDRPG have been "IFS-capable" for a while now. With Git being easy to install, well, it's time we use the free open-source tooling to our advantage.

 

Figure 1 shows the Orion home page being run on my IBM i. Click the Register link.

 

051316bartell figure1 orionhomepage

Figure 1: Orion home page

 

Figure 2 shows the registration page. You can configure Orion to use social media authentication or use the included authentication mechanism by specifying the profile and password of your choice. Note this is not an IBM i profile, although you can name it the same as an IBM i profile. Just know there isn't any direct correlation between Orion and IBM i profiles.

 

051316bartell figure2 orionregister

Figure 2: Orion registration

 

Figure 3 shows the initial Orion workspace. As you can see, there aren't any files or projects in existence yet, so it's time to create some.

 

051316bartell figure3 orionloggedinnoproject

Figure 3: Orion workspace

 

Figure 4 shows how to create a new "Basic" project. Under the covers, this will create a new directory in the IFS where you will store your source code.

 

051316bartell figure4 orioncreateproject

Figure 4: Create a new Basic project

 

It will prompt you for a project name. I specified p1 and was presented with the screen in Figure 5.

 

051316bartell figure5 orionprojectcreated

Figure 5: Project p1 now exists

 

Next create a new file named pgm1.rpgle, as shown in Figure 6.

 

051316bartell figure6 orionnewfile

Figure 6: Create a new file

 

Paste some code in pgm1.rpgle. As you can see in Figure 7, there is RPG syntax coloring. Hurray!

 

051316bartell figure7 orionpgm1

Figure 7: Orion has RPG syntax highlighting

 

Note it is auto-saving after each change you make. I really like this feature for a browser-based editor because it means losing work will be minimal.

 

Next question: Where is code stored in the IFS? Open a shell prompt and run the following command:

 

$ ls /QOpenSys/QIBM/UserData/OPS/Orion/serverworkspace

aa             an             at             metastore.json

 

As you can see, there are many workspaces. The one created for this tutorial is 'aa'. From there, I kept running additional ls commands until I made it to the location of pgm1.rpgle, as shown below.

 

$ ls /QOpenSys/QIBM/UserData/OPS/Orion/serverworkspace/aa/

aaron

$ ls /QOpenSys/QIBM/UserData/OPS/Orion/serverworkspace/aa/aaron

OrionContent             aaron-OrionContent.json p1.json                 user.json

$ ls /QOpenSys/QIBM/UserData/OPS/Orion/serverworkspace/aa/aaron/OrionContent

p1

$ ls /QOpenSys/QIBM/UserData/OPS/Orion/serverworkspace/aa/aaron/OrionContent/p1

pgm1.rpgle

 

Sometimes, when I've navigated to a file, I will use the cat command to display its contents, as shown below.

 

$ cat /QOpenSys/QIBM/UserData/OPS/Orion/serverworkspace/aa/aaron/OrionContent/p1/pgm1.rpgle

dcl-pr pgm1 extpgm;

   char1 char(1);

   dec1 packed(7:4);

end-pr;

dcl-pi pgm1;

   char1 char(1);

   dec1 packed(7:4);

end-pi;

char1 = 'C';

dec1 = 321.1234;

return;

 

OK, now that we've got some code, the next logical step is to compile. We can do that with the below CRTBNDRPG command and make use of the SRCSTMF parameter.

 

CRTBNDRPG PGM(MYLIB/PGM1) SRCSTMF('/QOpenSys/QIBM/UserData/OPS/Orion/serverworkspace/aa/aaron/OrionContent/p1/pgm1.rpgle')

 

At this point, our programming is complete and we should save the code in history using Git. Git is a source change-management (SCM) tool very popular in the open-source community. I use Git on a daily basis and like it a lot, although it took some time to learn the ins and outs.

 

Figure 8 shows the Orion Git page. We need to initialize the previously created directory as a Git repository (repo for short). To do that, we need to be on the Orion Git page (left nav button), select Repositories, select Init Repository, and select More so we can point it at the p1 directory.

 

051316bartell figure8 oriongitinit1

Figure 8: Orion git init

 

Select "Existing folder" on the pop-up, as shown in Figure 9.

 

051316bartell figure9 oriongitinit2

Figure 9: Git init existing directory

 

Expand Orion Content and select the p1 directory, as shown in Figure 10.

 

051316bartell figure10 oriongitinit3

Figure 10: Select existing Orion project directory for Git init

 

You will be brought back to a confirmation dialog where the "Existing folder" will be occupied. You should select OK, as shown in Figure 11.

 

051316bartell figure11 oriongitinit4

Figure 11: Confirm Git init of existing directory

 

Now the Orion Git page will convey the changes that have been made to the p1 directory, as shown in Figure 12. These are the changes needing to be committed to history, basically storing the version of source as it exists at this point in time.

 

051316bartell figure12 oriongitcommit1

Figure 12: Git changes for p1 directory

 

To commit the changes to pgm1.rpgle, we need to add a short message, select the pgm1.rpgle program from the list, and select the Commit button, as shown in Figure 13.

 

051316bartell figure13 oriongitcommit2

Figure 13: Commit pgm1.rpgle program changes

 

False alarm on being able to commit on the last screen. It will recognize you haven't yet configured Git with your personal information, and you will be presented with the following Author and Committer prompts. Fill those out and select the Commit button again, as shown in Figure 14.

 

051316bartell figure14 oriongitcommit3

Figure 14: Specify your personal information

 

This time the commit was a success, as shown in Figure 15.

 

051316bartell figure15 oriongitcommitsuccess

Figure 15: Git Commit is a success

 

What does this mean? Well, when you commit something with Git, it will store a snapshot in the .git directory of the entire directory at this point in time. What ".git" directory? If you navigate back to the Orion editor page and expand the p1 project directory, you will see a .git directory, as shown in Figure 16.

 

051316bartell figure16 oriongitdir

Figure 16: Orion .git directory

 

OK, so you're now tracking your changes with Git and want to share these with another developer. To do this, you need to push your changes to a central repository so another developer can pull the source. The IBM i can act as a central repository, but I prefer to store my source, both public and private, on BitBucket (GitHub works too). The following steps detail how to create and sync your p1 directory with BitBucket.

 

First sign up for a free BitBucket account. Then navigate to the Create Repo URL, as shown in Figure 17.

 

051316bartell figure17 orionbitbucketcreate

Figure 17: Create BitBucket Git repository

 

After clicking the "Create repository" button, you will be redirected to the repository's page. We need to obtain the HTTP repository URL so we can plug it into Orion. Figure 18 shows how to obtain this information.

 

051316bartell figure18 bitbucketcreate2

Figure 18: Obtain the repository URL

 

In my case, I now have URL //This email address is being protected from spambots. You need JavaScript enabled to view it./aaronbartell/p1.git">https://This email address is being protected from spambots. You need JavaScript enabled to view it./aaronbartell/p1.git in my clipboard. Next, navigate to the Orion Git page, select the Reference drop-down, select the New Remote button, specify "origin" for the Name, and paste the aforementioned URL, as shown in Figure 19.

 

051316bartell figure19 oriongitremotecreate

Figure 19: Add new Git remote to p1 repository

 

Now refresh the Git Orion page so it recognizes there is an attached remote repository.

 

The next step is to get the local commits onto BitBucket. Select the "Sync" button. When prompted, enter your Bitbucket password, as shown in Figure 20.

 

051316bartell figure20 oriongitsync

Figure 20: Sync local changes to remote BitBucket repository

 

Orion will now communicate the changes to Bitbucket. Once complete, it will convey there are no outgoing changes, as shown in Figure 21.

 

051316bartell figure21 oriongitsyncd

Figure 21: Orion Git page shows local environment is synced with remote

 

Go to the Bitbucket "Commit" page for the repository, and you can now see the recent commits, as shown in Figure 22.

 

051316bartell figure22 bitbucketcommits

Figure 22: BitBucket commits of IBM i project

 

A repo only needs to be created once by the first developer. Subsequent developers simply have to clone the existing repo. To do this, you navigate to the Orion Git page, select the Repository drop-down, select Clone Repository, specify the repository URL, and click Submit, as shown in Figure 23.

 

051316bartell figure23 oriongitclone

Figure 23: Subsequent developer's clone of p1 repository

 

At this point, you're set for doing development of your RPG with Orion. Developing RPG in the IFS is different on a number of fronts. It's not necessarily a quick change because we haven't yet addressed a solid build solution. One I am fond of is how Mihael Schmidt of RPGNextGen.com does with his projects. For example, check out his JSON project and see how it uses the "make" utility to copy files from the IFS to a temporary library for compilation. That's one of many options.

 

Hopefully, this article gives you a taste for Orion and what it can do. You can head over to planetorion.org to get news and updates about what is going on with Orion. As always, if you have any questions you can leave a comment below or contact me via email at This email address is being protected from spambots. You need JavaScript enabled to view it..

Aaron Bartell

Aaron Bartell is Director of IBM i Innovation for Krengel Technology, Inc. Aaron facilitates adoption of open-source technologies on IBM i through professional services, staff training, speaking engagements, and the authoring of best practices within industry publications andwww.litmis.comWith a strong background in RPG application development, Aaron covers topics that enable IBM i shops to embrace today's leading technologies, including Ruby on Rails, Node.js, Git for RPG source change management, and RSpec for unit testing RPG. Aaron is a passionate advocate of vibrant technology communities and the corresponding benefits available for today's modern application developers. Connect with Aaron via email atThis email address is being protected from spambots. You need JavaScript enabled to view it..

Aaron lives with his wife and five children in southern Minnesota. He enjoys the vast amounts of laughter that having a young family brings, along with camping and music. He believes there's no greater purpose than to give of our life and time to help others.

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: