TechTip: Connect ActionScript 3.0 with IBM i to Enable Flash Programs

APIs

Tools

Typography

Smaller Small Medium Big Bigger
Default Helvetica Segoe Georgia Times
Reading Mode

It's true! You can allow Flash programs to work with IBM i via the IBM i host servers.

Adobe Flash (formerly SmartSketch FutureSplash, FutureSplash Animator, and Macromedia Flash) is a multimedia platform used to add animation, video, and interactivity to Web pages. Flash is frequently used for advertisements, games, and animations for broadcast. More recently, it has been positioned as a tool for the development of cross-platform Rich Internet Applications (RIAs).

ActionScript 3.0 (also referred to AS3), a full-featured object-oriented programming language, is the core language of Adobe Flash. Flash programs can run in Adobe Flash Player, which is a Web browser plug-in, in a standalone Flash Player, or as desktop programs with the support of the cross-platform Adobe Integrated Runtime (AIR) runtime environment. Notable Web applications using Flash include Yahoo! Web Messenger and Sherwin-Williams' Color Visualizer.

So, what can we do by connecting Adobe Flash with the platform we work on every day, the IBM i?

1. With Adobe Flash, we can construct IBM i-backed cross-platform applications (either RIAs or desktop applications).

2. Numerous systems and devices can be allowed to connect to IBM i. The Adobe Flash Player exists for a variety of systems and devices: Windows, Mac OS 9/X, Linux, Solaris, HP-UX, Pocket PC/Windows CE, OS/2, QNX, Android, Symbian, Palm OS, BeOS, and IRIX.

3. IBM i-backed applications can take advantage of the extremely strong support provided by Flash for user interfaces and multimedia.

4. Best of all, perhaps we can attract existing Flash developers and users to the very versatile and easy-to-use IBM i platform.

Accessing IBM i from Flash Programs via the IBM i Host Servers

Now comes the next question: how to connect Adobe Flash with IBM i. The solution is to access IBM i from Flash programs via the IBM i host servers. The benefits are the following:

1. For a client program, accessing IBM i via the IBM i host servers is the most direct and efficient way. The IBM i host servers are TCP servers, so clients communicate with the host servers directly at the TCP layer.

2. The IBM i host servers allow client programs to access various resources and consume business logic available on an IBM i server in quite a range of flexible ways. For example, the Remote Command and Distributed Program Call Server allows clients to issue CL commands or call programs on an IBM i server; the DRDA/DDM Server supports record-level access to database files; the File Server allows clients to access IFS resources. In addition, with the program call support, the client can call various kinds of APIs. This further improves the flexibility of the client.

3. Accessing IBM i via the IBM i host servers does not require additional server-side development and deployment.

The Open-Source Project as-400

A subproject of the open-source project i5/OS Programmer's Toolkit has just been launched. It's called as-400 (aka "ActionScript and AS/400"). The as-400 subproject is aimed at implementing an AS3 class library (.swc file) that can be reused by other Flash applications to consume services exposed by the IBM i host servers. Just like the IBM Toolbox for Java and its open-source version, JTOpen, which connects Java clients to IBM i, as-400 will connect Flash clients to IBM i.

Hello, IBM i!

This section will show you a simple but meaningful example of accessing IBM i from a Flash program. We'll call IBM i programs from a Flash program via the Remote Command and Distributed Program Call Server.

The following is a screenshot of Flash program t007.swf, which is compiled from AS3 source file t007.as.

Figure 1: Let's start here.

This Flash program allows browser users to put a queue message onto a User Queue (USRQ) object (QGPL/Q007) on an IBM i server. When the apple is clicked, the following event-handler method is invoked and calls the Queue Object API ENQ to queue up the user-entered message onto QGPL/Q007.

private function onBtnClick(evt:MouseEvent) : void {

var pgm_call:RemoteCommand =

new RemoteCommand(i_host.text,

i_user.text,

i_pwd.text,

"I5TOOLKIT",

"ENQ"); // [3]

var i:int = 0;

var exp_id:String = ""; for(i = 0; i < 7; i++) exp_id += String.fromCharCode(0);

var exp_data:ByteArray = new ByteArray(); for(i = 0; i < 16; i++) exp_data.writeByte(0);

var argl:Vector.<ProgramArgument> =

new <ProgramArgument>[new ProgramArgument(new EBCDIC(20),

ProgramArgument.INPUT,

"Q007 QGPL"),

new ProgramArgument(new EBCDIC(1),

ProgramArgument.INPUT,

String.fromCharCode(2)),

new ProgramArgument(new Bin4(),

ProgramArgument.INPUT,

0),

new ProgramArgument(new EBCDIC(1),

ProgramArgument.INPUT,

String.fromCharCode(0)),

new ProgramArgument(new Bin4(),

ProgramArgument.INPUT,

64),

new ProgramArgument(new EBCDIC(64),

ProgramArgument.INPUT,

i_msg.text),

new ProgramArgument(new CompositeType(new Bin4(),

new Bin4(),

new EBCDIC(7),

new EBCDIC(1),

new HexData(16)),

ProgramArgument.INOUT,

new CompositeData(32,

exp_id,

String.fromCharCode(0),

exp_data)

) // Qus_EC_t

]; // [4]

try {

pgm_call.callx(this, enq_callback, argl); // [5]

} catch(e:*) {

trace("RemoteCommand.callx() failed:", e);

} finally {

trace("After invoking RemoteCommand.callx().");

}

private function enq_callback(rc:int,

argl:Vector.<ProgramArgument>,

msg:String = null) : void { // [6]

trace("Call to ENQ returns with return code:", rc);

}

A detailed explanation of the scenario follows:

1. Before running t007.swf, you need to create USRQ QGPL/Q007 that t007.swf is going to operate on by calling the Create User Queue (QUSCRTUQ) API. For example, you may call QUSCRTUQ interactively at a command line entry like so:

CALL PGM(QUSCRTUQ) PARM('Q007 QGPL' /* Qualified USRQ name */

'UUQQ' /* Extended attribute */

'F' /* Queue type = FIFO */

X'00000000' /* Key length = 0 */

X'00000040' /* Maximum message length = 64 */

X'00000010' /* Initial number of messages = 16 */

X'00000010' /* Additional number of messages = 16 */

'*CHANGE' /* Public authority = *CHANGE */

'FIFO *USRQ, max message length: 64' /* Text description */

)

2. If this is your first time running Flash programs against your IBM i server, you need to deploy a cross-domain policy-file server at your IBM i server. Flash Player requires a cross-domain policy file to be loaded from the server it's going to connect to before actually setting up a socket connection to the server. According to the loaded policy, Flash Player determines whether or not to permit a Flash program to connect to the target server at a specific port via socket. See "How to set up a security policy server for Flash clients at an IBM i server" for details.

3. In event listener onBtnClick, a new instance of class RemoteCommand, pgm_call is created. The name of the target IBM i server, user name, password, library, and name of the target IBM i program to call (I5TOOLKIT/ENQ) are passed to the constructor of RemoteCommand.

4. The list of arguments to pass to target program of type Vector.<ProgramArgument> is constructed. Classes EBCDIC, Bin4, and CompositeType are converter classes that implement interface IAS400Data, which is used for converting PC data types to and from IBM i data types.

5. Method RemoteCommand.callx() is invoked on pgm_call to call I5TOOLKIT/ENQ to queue a user message onto USRQ QGPL/Q007. Arguments being passed to RemoteCommand.callx() include these: the object to receive asynchronous notification when the requested program call is completed (in our example, "this," which is the current object), the callback method (enq_callback) to invoke on "this" to send completion notification, and the argument list to pass to the target IBM i program.

6. When the program call is complete, callback method enq_callback is invoked. The argument list passed to the target IBM i program is returned through the second parameter of the callback method, argl, from which you can retrieve the value of any input/output or output-only arguments.

7. CL command DSPQMSG can be used to check the queue entries being put on USRQ QGPL/Q007.

For detailed documentation on AS3 classes involved in the above example, please refer to Class Reference of as-400.

as/400, os/400, iseries, system i, i5/os, ibm i, power systems, 6.1, 7.1, V7, V6R1

Junlei Li

Junlei Li is a programmer from Tianjin, China, with 10 years of experience in software design and programming. Junlei Li began programming under i5/OS (formerly known as AS/400, iSeries) in late 2005. He is familiar with most programming languages available on i5/OS—from special-purpose languages such as OPM/ILE RPG to CL to general-purpose languages such as C, C++, Java; from strong-typed languages to script languages such as QShell and REXX. One of his favorite programming languages on i5/OS is machine interface (MI) instructions, through which one can discover some of the internal behaviors of i5/OS and some of the highlights of i5/OS in terms of operating system design.

Junlei Li's Web site is http://i5toolkit.sourceforge.net/, where his open-source project i5/OS Programmer's Toolkit (https://sourceforge.net/projects/i5toolkit/) is documented.

BLOG COMMENTS POWERED BY DISQUS

LATEST COMMENTS

Support MC Press Online

Select Your Contribution Amount
$ 12.00 $ 24.00 $ 36.00 $ 48.00 $

RESOURCE CENTER

WHITE PAPERS
WEBCAST
TRIAL SOFTWARE

White Paper: Node.js for Enterprise IBM i Modernization

If your business is thinking about modernizing your legacy IBM i (also known as AS/400 or iSeries) applications, you will want to read this white paper first!

Download this paper and learn how Node.js can ensure that you:
- Modernize on-time and budget - no more lengthy, costly, disruptive app rewrites!
- Retain your IBM i systems of record
- Find and hire new development talent
- Integrate new Node.js applications with your existing RPG, Java, .Net, and PHP apps
- Extend your IBM i capabilties to include Watson API, Cloud, and Internet of Things

Read Node.js for Enterprise IBM i Modernization Now!
Profound Logic Solution Guide

More 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 companyare not aligned with the current IT environment.

Get your copy of this important guide today!
2022 IBM i Marketplace Survey Results

2022 marks the eighth edition of the IBM i Marketplace Survey Results. Each year, Fortra captures data on how businesses use the IBM i platform and the IT and cybersecurity initiatives it supports.

Over the years, this survey has become a true industry benchmark, revealing to readers the trends that are shaping and driving the market and providing insight into what the future may bring for this technology.
Brunswick bowls a perfect 300 with LANSA!

Brunswick is the leader in bowling products, services, and industry expertise for the development and renovation of new and existing bowling centers and mixed-use recreation facilities across the entertainment industry. However, the lifeblood of Brunswick’s capital equipment business was running on a 15-year-old software application written in Visual Basic 6 (VB6) with a SQL Server back-end. The application was at the end of its life and needed to be replaced.
With the help of Visual LANSA, they found an easy-to-use, long-term platform that enabled their team to collaborate, innovate, and integrate with existing systems and databases within a single platform.
Read the case study to learn how they achieved success and increased the speed of development by 30% with Visual LANSA.
The Power of Coding in a Low-Code Solution

When 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:
- Discover the benefits of Low-code's quick application creation
- Understand the differences in model-based and language-based Low-Code platforms
- Explore the strengths of LANSA's Low-Code Solution to Low-Code’s biggest drawbacks
Why Migrate When You Can Modernize?

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.
In this white paper, you’ll learn how to think of these issues as opportunities rather than problems. We’ll explore motivations to migrate or modernize, their risks and considerations you should be aware of before embarking on a (migration or modernization) project.
Lastly, we’ll discuss how modernizing IBM i applications with optimized business workflows, integration with other technologies and new mobile and web user interfaces will enable IT – and the business – to experience time-added value and much more.
UPDATED: Developer Kit: Making a Business Case for Modernization and Beyond

Having trouble getting management approval for modernization projects? The problem may be you're not speaking enough "business" to them.

This Developer Kit provides you study-backed data and a ready-to-use business case template to help get your very next development project approved!
What to Do When Your AS/400 Talent Retires

IT managers hoping to find new IBM i talent are discovering that the pool of experienced RPG programmers and operators or administrators is small.

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:
- Why IBM i skills depletion is a top concern
- How leading organizations are coping
- Where automation will make the biggest impact

Next Previous

Node.js on IBM i Webinar Series Pt. 2: Setting Up Your Development Tools

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. In Part 2, Brian May teaches you the different tooling options available for writing code, debugging, and using Git for version control. Attend this webinar to learn:
- Different tools to develop Node.js applications on IBM i
- Debugging Node.js
- The basics of Git and tools to help those new to it
- Using NodeRun.com as a pre-built development environment
Expert Tips for IBM i Security: Beyond the Basics

In this session, IBM i security expert Robin Tatam provides a quick recap of IBM i security basics and guides you through some advanced cybersecurity techniques that can help you take data protection to the next level. Robin will cover:
- Reducing the risk posed by special authorities
- Establishing object-level security
- Overseeing user actions and data access
Don't miss this chance to take your knowledge of IBM i security beyond the basics.
5 IBM i Security Quick Wins

In today’s threat landscape, upper management is laser-focused on cybersecurity. You need to make progress in securing your systems—and make it fast.
There’s no shortage of actions you could take, but what tactics will actually deliver the results you need? And how can you find a security strategy that fits your budget and time constraints?
Join top IBM i security expert Robin Tatam as he outlines the five fastest and most impactful changes you can make to strengthen IBM i security this year.
Your system didn’t become unsecure overnight and you won’t be able to turn it around overnight either. But quick wins are possible with IBM i security, and Robin Tatam will show you how to achieve them.
Security Bulletin: Malware Infection Discovered on IBM i Server!

Malicious programs can bring entire businesses to their knees—and IBM i shops are not immune. It’s critical to grasp the true impact malware can have on IBM i and the network that connects to it. Attend this webinar to gain a thorough understanding of the relationships between:
- Viruses, native objects, and the integrated file system (IFS)
- Power Systems and Windows-based viruses and malware
- PC-based anti-virus scanning versus native IBM i scanning
There are a number of ways you can minimize your exposure to viruses. IBM i security expert Sandi Moore explains the facts, including how to ensure you're fully protected and compliant with regulations such as PCI.
Encryption on IBM i Simplified

DB2 Field Procedures (FieldProcs) were introduced in IBM i 7.1 and have greatly simplified encryption, often without requiring any application changes. Now you can quickly encrypt sensitive data on the IBM i including PII, PCI, PHI data in your physical files and tables.
Watch this webinar to learn how you can quickly implement encryption on the IBM i. During the webinar, security expert Robin Tatam will show you how to:
- Use Field Procedures to automate encryption and decryption
- Restrict and mask field level access by user or group
- Meet compliance requirements with effective key management and audit trails
Lessons Learned from IBM i Cyber Attacks

Despite the many options IBM has provided to protect your systems and data, many organizations still struggle to apply appropriate security controls.
In this webinar, you'll get insight into how the criminals accessed these systems, the fallout from these attacks, and how the incidents could have been avoided by following security best practices.
- Learn which security gaps cyber criminals love most
- Find out how other IBM i organizations have fallen victim
- Get the details on policies and processes you can implement to protect your organization, even when staff works from home
You will learn the steps you can take to avoid the mistakes made in these examples, as well as other inadequate and misconfigured settings that put businesses at risk.
The Power of Coding in a Low-Code Solution

When 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:
- Discover the benefits of Low-code's quick application creation
- Understand the differences in model-based and language-based Low-Code platforms
- Explore the strengths of LANSA's Low-Code Solution to Low-Code’s biggest drawbacks
Node Webinar Series Pt. 1: The World of Node.js on IBM i

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.
Part 1 will teach you what Node.js is, why it's a great option for IBM i shops, and how to take advantage of the ecosystem surrounding Node.
In addition to background information, our Director of Product Development Scott Klement will demonstrate applications that take advantage of the Node Package Manager (npm).
Watch Now.
The Biggest Mistakes in IBM i Security

The Biggest Mistakes in IBM i Security
Here’s the harsh reality: cybersecurity pros have to get their jobs right every single day, while an attacker only has to succeed once to do incredible damage.
Whether that’s thousands of exposed records, millions of dollars in fines and legal fees, or diminished share value, it’s easy to judge organizations that fall victim. IBM i enjoys an enviable reputation for security, but no system is impervious to mistakes.
Join this webinar to learn about the biggest errors made when securing a Power Systems server.
This knowledge is critical for ensuring integrity of your application data and preventing you from becoming the next Equifax. It’s also essential for complying with all formal regulations, including SOX, PCI, GDPR, and HIPAA
Watch Now.

Next Previous

Comply in 5! Well, actually UNDER 5 minutes!!

TRY 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.

Request your trial now!
Backup and Recovery on IBM i: Your Strategy for the Unexpected

Robot automates the routine 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:
- Simplified backup procedures
- Easy data encryption
- Save media management
- Guided restoration
- Seamless product integration
Make sure your data survives when catastrophe hits. Try the Robot Backup and Recovery Solution FREE for 30 days.
Manage IBM i Messages by Exception with Robot

Managing messages on your IBM i can be more than a full-time job if you have to do it manually. 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:
- Automated message management
- Tailored notifications and automatic escalation
- System-wide control of your IBM i partitions
- Two-way system notifications from your mobile device
- Seamless product integration
Try the Robot Message Management Solution FREE for 30 days.
Easiest Way to Save Money? Stop Printing IBM i Reports

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:

- Automated report distribution
- View online without delay
- Browser interface to make notes
- Custom retention capabilities
- Seamless product integration
Rerun another report? Never again. Try the Robot Report Management Solution FREE for 30 days.
Hassle-Free IBM i Operations around the Clock

For over 30 years, Robot has been a leader in systems management for IBM i.
Manage your job schedule with the Robot Job Scheduling Solution. Key features include:
- Automated batch, interactive, and cross-platform scheduling
- Event-driven dependency processing
- Centralized monitoring and reporting
- Audit log and ready-to-use reports
- Seamless product integration
Scale your software, not your staff. Try the Robot Job Scheduling Solution FREE for 30 days.

Next Previous

Home

Tools

Typography

Share This

Accessing IBM i from Flash Programs via the IBM i Host Servers

The Open-Source Project as-400

Hello, IBM i!

LATEST COMMENTS

MC Press Online

Support MC Press Online

RESOURCE CENTER

WHITE PAPERS

WEBCAST

TRIAL SOFTWARE

White Paper: Node.js for Enterprise IBM i Modernization

Profound Logic Solution Guide

2022 IBM i Marketplace Survey Results

Brunswick bowls a perfect 300 with LANSA!

The Power of Coding in a Low-Code Solution

Why Migrate When You Can Modernize?

UPDATED: Developer Kit: Making a Business Case for Modernization and Beyond

What to Do When Your AS/400 Talent Retires

Node.js on IBM i Webinar Series Pt. 2: Setting Up Your Development Tools

Expert Tips for IBM i Security: Beyond the Basics

5 IBM i Security Quick Wins

Security Bulletin: Malware Infection Discovered on IBM i Server!

Encryption on IBM i Simplified

Lessons Learned from IBM i Cyber Attacks

The Power of Coding in a Low-Code Solution

Node Webinar Series Pt. 1: The World of Node.js on IBM i

The Biggest Mistakes in IBM i Security

Comply in 5! Well, actually UNDER 5 minutes!!

Backup and Recovery on IBM i: Your Strategy for the Unexpected

Manage IBM i Messages by Exception with Robot

Easiest Way to Save Money? Stop Printing IBM i Reports

Hassle-Free IBM i Operations around the Clock

MC Press Users

Explore

Advertise

Help

Articles

Resources

Social