02
Sat, Nov
2 New Articles

Product Review: Harkins Audit Software's Real-Time Program Audit

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

Today's hot, new, custom-developed application is tomorrow's legacy code. It might do everything that the business needs now, but it will eventually need to be modified to accommodate new requirements, not to mention fix bugs. Validating a complex new application can be a challenge in itself, but an even bigger problem arrives when the original developers leave, taking their intimate knowledge of the software with them. Then, determining what the code does and how it does it in order to revise the application when necessary can be a cumbersome, costly, and error-prone task. Harkins Audit Software's Real-Time Program Audit (RTPA) addresses these issues by automating the code analysis process.

The philosophy behind RTPA is much the same as the one that the IT department has been pitching to the rest of the company for years: Use the power of the computer to, wherever possible, automate tedious, labor-intensive, error-prone tasks. Instead of programmers manually wading through thousands of lines of logic in an attempt to understand what is going on under the covers whenever they need to modify or debug a program they aren't familiar with, RTPA can facilitate that understanding without a code walkthrough.

RTPA is a programmer productivity utility that "audit-enables" RPG code. What this means is that it examines the source code and embeds auditing statements within it. The resulting expanded code is placed into a new file in order to leave the original version of the source code unaltered. The audit-enabled version is then compiled using a standard RPG compiler.

Audit Flexibility

When the audit-enabled object code is run, in addition to the normal business processes required of it, it also produces a separate output dataset referred to as an audit file or, more simply, an audit. The audit file can be reviewed in real-time as the program executes. Or after execution, the audit file can be printed because it is a normal spooled file. It can also be displayed online using the standard IBM WRKSPLF command, or by a fully searchable PDF file using IBM utilities. Displaying the file online makes it possible to search for values without having to manually hunt through the output.

The audit can capture a variety of information, depending on the options set by the developer. Data that can be captured includes source statements, comments, contents of variables, compile listing statement sequence numbers, source statement change IDs, statement change dates, and the time of execution.

In addition to determining what is to be audited, a developer can also specify when audit output is to be produced. For example, audit output may be started, stopped, and restarted based on the value of a particular variable or on the relative values of multiple variables. Furthermore, if you need to track down a bug that was introduced with a particular program revision, you can choose to audit only statements with a particular change date or ID.

Normally all of the executable source statements and data being processed are audited as they execute. There is also the flexibility to choose which statements are audited and when, auditing is performed only when needed, thereby limiting any performance impact. In any event, auditing generally introduces a relatively small load on the processor. In an iSeries environment, the additional load of a full audit is reported to be as little as 20% of the total CPU time for the job. Since audit-enabled versions of programs are typically not run in production, performance is usually not a serious issue.

In addition to any performance considerations, if you are auditing a large RPG III program, you might also choose to be selective in what you audit because of the source size limitation of, in particular, the RPG III compiler. Since RTPA adds auditing statements into a copy of a program, it may create a file that is three to five times the size of the original source if the full audit capabilities are used. Therefore, full auditing might push an already large program over the RPG III source restriction that typically limits a program to a maximum of 20,000 to 25,000 statements. This limit was increased with RPG IV, pushing the threshold up to approximately 40,000 to 45,000 source statements.

Audit Sequence

During runtime, the timing of the audit capture for a particular statement depends on the nature of the statement, as follows:

  • For any data modification statements--such as ADD, MULTIPLY, MOVE, or CHAIN--RTPA captures results after the statement has been executed.
  • Auditing of evaluation statements--such as EVAL, DOW, and WHEN--is not done until after both the statement and all associated OR and AND continuation statements are executed.
  • The EXSR, GOTO, and IF branching statements are audited before being executed, and some statements, such as the EXFMT to a display, are audited twice, at the exact time of the Write to the display and then the Read from the display, with the contents of all variables and command keys on the screen shown.

Benefits

When a developer assumes responsibility for an application and must develop, modify or debug it, the traditional approach is to print out and then walk through source code in attempt to determine what it does with the data being processed. In contrast, RTPA reports on what actually happens during execution, thereby eliminating what, because of the complexity of the application, otherwise often ends up being largely guesswork. This ability to clearly report on what is happening when a program is running reduces the cost associated with losing the knowledge inherent in the original application developers because new programmers who must reengineer or debug an existing application can use RTPA to get up to speed on the application's processes more quickly than when using traditional manual approaches.

The auditing process itself places very small demands on IT staff. Once the auditing options have been chosen, the audit-enablement process is entirely automated. Programmers do not have to set breakpoints or code debugging statements as they would in a traditional environment. This reduces development time and the debugging labor costs and decreases the time required to find the source of a problem and implement a fix.

In addition to enhancing programmer productivity, RTPA can also improve software quality. Because the audit shows what is actually going on in the program rather than the developer trying to discern that from the code, considerable human error can be eliminated from the testing and debugging phases.

RTPA is easy to use and provides cursor-sensitive online help text, including detailed information about the screens, important screen fields, and command keys.

Requirements

RTPA works with any type of RPG III and RPG IV program--including RPG, RPT, SQLRPG, RPGMOD, RPGLE, SQLRPGLE, and SQLRPGMOD programs--running on OS/400 V5R1 and later. The minimum hardware requirement for RTPA is an IBM iSeries Model 170 (RISC) system.

You can explore RTPA further by visiting the Harkins Audit Web site and requesting the RTPA White Paper and the RTPA Users Manual.

Joel Klebanoff is a consultant, a writer, and president of Klebanoff Associates, Inc., a Toronto, Canada-based marketing communications firm. Joel has 25 years experience working in IT, first as a programmer/analyst and then as a marketer. He holds a Bachelor of Science in computer science and an MBA, both from the University of Toronto. Contact Joel at This email address is being protected from spambots. You need JavaScript enabled to view it..

http://www.mcpressonline.com/articles/images/2002/120105HarkinsR00.jpg
Harkins Audit Software, Inc.
816 Daisy Lane
West Chester, PA 19382
USA
Web: www.harkinsaudit.com
Email: This email address is being protected from spambots. You need JavaScript enabled to view it.
Tel: 888.350.9148

Joel Klebanoff

Joel Klebanoff is a consultant, writer, and formerly president of Klebanoff Associates, Inc., a Toronto-based marketing communications firm. He has 30 years' experience in various IT capacities and now specializes in writing articles, white papers, and case studies for IT vendors and publications across North America. Joel is also the author of BYTE-ing Satire, a compilation of a year's worth of his columns. He holds a BS in computer science and an MBA, both from the University of Toronto.


MC Press books written by Joel Klebanoff available now on the MC Press Bookstore.

BYTE-ing Satire BYTE-ing Satire
Find out the hilarious answer to the eternal question: "Is technology more hindrance than help?"
List Price $14.95

Now On Sale

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: