• 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
    Fresche Solutions

    Let’s Talk IBM i Cloud

    Stop spending money on unnecessary infrastructure. Move and create powerful networks for:

    We can help you with managed services, OS upgrades, SysAdmin services, cloud migration, and HA/DR.

    Get Cloud Now

    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

  • Power Systems Did Indeed Grow Revenues Last Year
  • The IBM Power Trap: Three Mistakes That Leave You Stuck
  • Big Blue Decrees Its 2023 IBM Champions
  • As I See It: The Good, the Bad, And The Mistaken
  • IBM i PTF Guide, Volume 25, Number 5
  • N2i Gains Traction Among IBM i Newbies
  • Realizing The Promise Of Cross Platform Development With VS Code
  • 2023 IBM i Predictions, Part 3
  • Four Hundred Monitor, January 25
  • Join The 2023 IBM i Marketplace Survey Webinar Tomorrow

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 © 2022 IT Jungle

loading Cancel
Post was not sent - check your email addresses!
Email check failed, please try again
Sorry, your blog cannot share posts by email.