• The Four Hundred
  • Subscribe
  • Media Kit
  • Contributors
  • About Us
  • Contact
Menu
  • The Four Hundred
  • Subscribe
  • Media Kit
  • Contributors
  • About Us
  • Contact
  • Comment Your Binder Language

    July 11, 2007 Hey, Ted

    Because of Sarbanes-Oxley, we have a new requirement in our shop that all source members must include comments that tell the usual stuff–who did what, when and why they did it, etc. While we have always done that sort of thing (well, most of the time), there are certain types of source members we never bothered to comment. A good example is ILE binder language. I’ve looked for, but never found, a document that tells how to comment binder language. Do you know?

    –Pat

    IBM didn’t make it easy for you, Pat. I wondered the same thing myself a while back, and finally found one reference, in the V5R2 ILE Concepts manual.

    According to the manual, you can use the same /* and */ comment delimiters that are used in such programming languages as CL, C, and Java. Here’s an example from that book.

    STRPGMEXP  PGMLVL(*CURRENT)
     EXPORT SYMBOL('Term')
     EXPORT SYMBOL('Old_Rate') /* Original Rate procedure with four parameters */
     EXPORT SYMBOL('Amount')
     EXPORT SYMBOL('Payment')
     EXPORT SYMBOL('OpenAccount')
     EXPORT SYMBOL('CloseAccount')
     EXPORT SYMBOL('Rate')           /* New Rate procedure that supports +
                                         a fifth parameter, Credit_History */
    ENDPGMEXP
    

    Notice that there are two comments. The second one appears to need a plus sign to continue on to the next line.

    Before I found this link, I had employed a brute-force method, trying delimiters that worked in other source types, and my findings were a little different from what the book says.

    First, I found that the double-dash method, which I often use in SQL scripting, works in binder language.

    -- Author: Prunus Amygdalus Dulcis, Ph.D.
    -- Date written:  July 11, 2007
    

    Second, I also discovered that the CL comment delimiters are allowed, but I never used a continuation character for multi-line comments.

    /*   Author: Prunus Amygdalus Dulcis, Ph.D.
         Date written:  July 11, 2007           */
    

    However, nobody told SEU about my two findings, so SEU flags these comment structures as errors.

    I also discovered that the binder language processor ignores blank lines.

    I hope that helps, Pat. I’d hate to see you shipped off to the pen for failure to comment your binder language. 😉

    –Ted



                         Post this story to del.icio.us
                   Post this story to Digg
        Post this story to Slashdot

    Share this:

    • Reddit
    • Facebook
    • LinkedIn
    • Twitter
    • Email

    Tags:

    Sponsored by
    WorksRight Software

    Do you need area code information?
    Do you need ZIP Code information?
    Do you need ZIP+4 information?
    Do you need city name information?
    Do you need county information?
    Do you need a nearest dealer locator system?

    We can HELP! We have affordable AS/400 software and data to do all of the above. Whether you need a simple city name retrieval system or a sophisticated CASS postal coding system, we have it for you!

    The ZIP/CITY system is based on 5-digit ZIP Codes. You can retrieve city names, state names, county names, area codes, time zones, latitude, longitude, and more just by knowing the ZIP Code. We supply information on all the latest area code changes. A nearest dealer locator function is also included. ZIP/CITY includes software, data, monthly updates, and unlimited support. The cost is $495 per year.

    PER/ZIP4 is a sophisticated CASS certified postal coding system for assigning ZIP Codes, ZIP+4, carrier route, and delivery point codes. PER/ZIP4 also provides county names and FIPS codes. PER/ZIP4 can be used interactively, in batch, and with callable programs. PER/ZIP4 includes software, data, monthly updates, and unlimited support. The cost is $3,900 for the first year, and $1,950 for renewal.

    Just call us and we’ll arrange for 30 days FREE use of either ZIP/CITY or PER/ZIP4.

    WorksRight Software, Inc.
    Phone: 601-856-8337
    Fax: 601-856-9432
    Email: software@worksright.com
    Website: www.worksright.com

    Share this:

    • Reddit
    • Facebook
    • LinkedIn
    • Twitter
    • Email

    Sponsored Links

    Bsafe:  Enterprise security for System i and Linux systems
    New Generation Software:  Leading provider of iSeries BI and financial management software COMMON:  Join us at the Annual 2008 conference, March 30 - April 3, in Nashville, Tennessee

    IT Jungle Store Top Book Picks

    The System i Pocket RPG & RPG IV Guide: List Price, $69.95
    The iSeries Pocket Database Guide: List Price, $59.00
    The iSeries Pocket Developers' Guide: List Price, $59.00
    The iSeries Pocket SQL Guide: List Price, $59.00
    The iSeries Pocket Query Guide: List Price, $49.00
    The iSeries Pocket WebFacing Primer: List Price, $39.00
    Migrating to WebSphere Express for iSeries: List Price, $49.00
    iSeries Express Web Implementer's Guide: List Price, $59.00
    Getting Started with WebSphere Development Studio for iSeries: List Price, $79.95
    Getting Started With WebSphere Development Studio Client for iSeries: List Price, $89.00
    Getting Started with WebSphere Express for iSeries: List Price, $49.00
    WebFacing Application Design and Development Guide: List Price, $55.00
    Can the AS/400 Survive IBM?: List Price, $49.00
    The All-Everything Machine: List Price, $29.95
    Chip Wars: List Price, $29.95

    Wireshark Fixes iSeries ‘Wiretap’ Bug The Database Is the Computer

    Leave a Reply Cancel reply

Volume 7, Number 25 -- July 11, 2007
THIS ISSUE SPONSORED BY:

WorksRight Software
Help/Systems
COMMON

Table of Contents

  • Comment Your Binder Language
  • Load a Spreadsheet from a DB2/400 Database: Part 2
  • Admin Alert: More Info on SAVSYSINF, Green-Screen Printing, Performance PTFs, and Batteries

Content archive

  • The Four Hundred
  • Four Hundred Stuff
  • Four Hundred Guru

Recent Posts

  • To Comfort The Afflicted And Afflict The Comfortable
  • How FalconStor Is Reinventing Itself, And Why IBM Noticed
  • Guru: When Procedure Driven RPG Really Works
  • Vendors Fill In The Gaps With IBM’s New MFA Solution
  • IBM i PTF Guide, Volume 27, Number 27
  • With Power11, Power Systems “Go To Eleven”
  • With Subscription Price, IBM i P20 And P30 Tiers Get Bigger Bundles
  • Izzi Buys CNX, Eyes Valence Port To System Z
  • IBM i Shops “Attacking” Security Concerns, Study Shows
  • IBM i PTF Guide, Volume 27, Number 26

Subscribe

To get news from IT Jungle sent to your inbox every week, subscribe to our newsletter.

Pages

  • About Us
  • Contact
  • Contributors
  • Four Hundred Monitor
  • IBM i PTF Guide
  • Media Kit
  • Subscribe

Search

Copyright © 2025 IT Jungle