iSeries EXTRA: Using Conditional Compiler Directives | IBM i | IBM Sy...

1 of 6

http://www.ibmsystemsmag.com/ibmi/november01/enewsletterexclusive/...

Administrator
Backup and Recovery
DB2
High Availability
LPAR
Networks
Performance
Security
Systems Management
Tivoli
Trends
AIX
Linux
Open Source
What's New
Tips & Techniques
Application Development
Systems Management
Miscellaneous
Case Studies
Automotive
Healthcare
Manufacturing
Miscellaneous
Non-profit
Retail
Storage
Disk
Servers
Software
Tape
Product News
Buyer's Guide
Administrator
Backup and Recovery
DB2
Domino
High Availability
LPAR
Networks
Performance
Printing
Security
Systems Management
WebSphere
Windows Integration
Developer
General
Java
Modernization
RPG
WebSphere
Trends
IBM Announcements
Linux
Open Source
SOA
What's New
Tips & Techniques
Application Development

9/27/2010 9:01 AM

iSeries EXTRA: Using Conditional Compiler Directives | IBM i | IBM Sy...

2 of 6

http://www.ibmsystemsmag.com/ibmi/november01/enewsletterexclusive/...

Systems Management

Storage
Disk
Optical
Servers
Tape
Product News
Product Reviews
ENDPGM Main Page
Administrator
Backup and Recovery
CICS
DB2
High Availability
IMS
LPAR
Migration
Networks
Performance
Security
Systems Management
Tivoli
Trends
Linux
Open Source
Security
SOA
What's New
z/OS
z/VM
Tips & Techniques
Application Development
Systems Management
Case Studies
Automotive
Banking/Finance
Healthcare
Insurance
Manufacturing
Miscellaneous
Retail
Storage
Disk
Servers
Software
Tape
Product News
Stop Run
Buyer's Guide Main Page

9/27/2010 9:01 AM

iSeries EXTRA: Using Conditional Compiler Directives | IBM i | IBM Sy...

3 of 6

http://www.ibmsystemsmag.com/ibmi/november01/enewsletterexclusive/...

Business Strategy
Competitive Advantage
Consolidation
Executive Perspective
Green IT
Migration
Open Source
ROI
Infrastructure
Blades
Storage
Systems Management
Case Studies
Distribution
Healthcare
Manufacturing
Services
Web 2.0
Cloud
Social Media
Trends
Collaboration
IBM Announcements
IBM Research
Open Source
Social Media
What's New
Product News

AIX
MAINFRAME
POWER
Newsletters
About Us

Subscribe
Current Issue
Archive

IBM i
ALL EDITIONS
ADMINISTRATOR
DEVELOPER
TRENDS
TIPS & TECHNIQUES
CASE STUDIES

9/27/2010 9:01 AM

iSeries EXTRA: Using Conditional Compiler Directives | IBM i | IBM Sy...

4 of 6

http://www.ibmsystemsmag.com/ibmi/november01/enewsletterexclusive/...

STORAGE
PRODUCT NEWS
ENDPGM
BUYER'S GUIDE

Developer > RPG

iSeries EXTRA: Using Conditional Compiler Directives

November 2001 | by Susan Gantner and Jon Paris

Print

Email

Authors' note: In this series of articles we intend to feature some of the more useful and lesser known gems in the RPG IV language. If you have any
suggestions for future editions, please let us know.
Imagine you're trying to debug a particularly stubborn problem with a batch program. In desperation, you decide to add some additional logic to record the details of
certain variables as the program progresses. Later, having decided you've fixed the problem, you remove these lines from the program. However, you didn't
completely fix it. Oops (that is the polite response); now you must put the lines back in again. When you've "fixed" it a second time, instead of removing the lines, you
get smart and simply comment them out. Great idea, save for one tiny problem: When you reinstate them again the next time around, you accidentally "uncomment"
a line of code that was first commented out during a maintenance fix back in 1987. The program still doesn't work, but at least its for a different reason.
If this scenario sounds familiar, you should know about Conditional Compiler Directives. Though these useful little devils were added to RPG IV in V3R7, many
programmers have never heard of them.
Let's look at a simple example:
* Normal program logic goes here
/If Defined(TESTING)
* Include here any lines that relate only to test/debug
C
Eval
DebugRec = CustomerDS
C
Write
DebugFile
/EndIf
* More regular program logic
If this program is simply compiled with the normal CRTBNDRPG directives, the lines between "/If Defined(TESTING)" and "/EndIF" will be excluded from the
compilation. That is because the ConditionName TESTING hasn't been set. Think of a ConditionName as a named indicator, and you won't go far wrong. Conditions
can be set within the source, or on the CRTBNDRPG or CRTRPGMOD commands. With our simple example, whenever we want to produce a test version, we
simply add the DEFINE(TESTING) option to the compile command. This causes the compiler to include all of the previously excluded lines. It can't get much simpler
than that. We can also say that a section of source is to be included if the ConditionName isn't defined -- e.g., /IF NOT DEFINED(TESTING).
In addition to being set on the compile command, Conditions can also be set within the source program itself. They can be set with the /DEFINE(ConditionName)
directive and cleared via /UNDEFINE(ConditionName).
Two other directives are currently supported:
/ELSEIF {NOT} DEFINED(ConditionName)
/EOF
The latter is a handy feature that tells the compiler to skip directly to the end of the current source file (i.e., Do not pass Go, do not collect $200...). The links in the
following paragraphs will take you to examples of its usage.

Next page: >>

Page 1 2

9/27/2010 9:01 AM

iSeries EXTRA: Using Conditional Compiler Directives | IBM i | IBM Sy...

5 of 6

http://www.ibmsystemsmag.com/ibmi/november01/enewsletterexclusive/...

Susan Gantner is a technical editor with IBM Systems Magazine and co-owner of Partner400.
More Articles From Susan Gantner
Jon Paris is a technical editor with IBM Systems Magazine and co-owner of Partner400.
More Articles From Jon Paris

Advertisement

How Frontline Homeowners Insurance SOA - Enables their IBM i Policy and Claims Applications
Wednesday, October 13, 2010 - 2pm EST

Browse products and services for Developer.

Advertisement

9/27/2010 9:01 AM

iSeries EXTRA: Using Conditional Compiler Directives | IBM i | IBM Sy...

6 of 6

http://www.ibmsystemsmag.com/ibmi/november01/enewsletterexclusive/...

Maximize your IT investment with monthly information from THE source...IBM Systems Magazine EXTRA & Marketplace eNewsletters.
SUBSCRIBE NOW.
View past IBM i EXTRAs here

Related Articles
RPG for the Web
Paging RPG IV
iSeries EXTRA: Service Programs and Signatures
E-Newsletter Exclusive
Get More from RPG
E-Newsletter Exclusive | SPECIAL files process IFS directories and more
Three Good Reasons to Stop Writing Subroutines
E-Newsletter Exclusive | Save time and reduce errors with subprocedures
IBM i
AIX
MAINFRAME
POWER
Homepage
About Us
Contact Us
Subscriptions
Editorial Calendar
Advertise With Us
Reprints
Privacy Policy
Terms of Service
Sitemap
IBM Systems Magazine is a trademark of International Business Machines Corporation. The editorial content of IBM Systems Magazine is placed on
this website by MSP TechMedia under license from International Business Machines Corporation.
2010 MSP Communications, Inc. All rights reserved

9/27/2010 9:01 AM