Summary in English: Converting the AS/400 code to summary in English like langauage

25 pts.
Tags:
AS/400
CLLE
RPGLE
Hi ALL, For every new requirement or changes in RPGLE/CLLE/RPG/SQLRPGLE/RPT code I need to write program flow after making the changes. I will include these program synopsis in Requirement Analysis Document(RAD). So it takes much time to write synopsis. Is there any chance to convert AS/400 code to English like language and then summarizes the process flow. Or else anyone having any idea regarding how can we achieve this ? it is very useful if someone provides me valuable feedback. I just wanted to develop a tool for this so that I can save much time in writing the summary of program each time. I'm using IBM iSeries V7R1. Thanks in advance. Waiting for valuable input and is this is possible to convert? Regards, Poojary


Software/Hardware used:
ibm i-series, as400 , rpgle, summary
0

Answer Wiki

Thanks. We'll let you know when a new response is added.
Send me notifications when members answer or reply to this question.

Discuss This Question: 9  Replies

 
There was an error processing your information. Please try again later.
Thanks. We'll let you know when a new response is added.
Send me notifications when members answer or reply to this question.
  • TheRealRaven
    There isn't much that doesn't need some work to be useful, most especially by adding good comments to begin with. And if you're already adding good comments and creating decent modular code, you can almost create your documentation simply by extracting the comments.

    See RPGDOC -- JVADOC style documentation for RPGRPGLERPG /FREE for a project that attempts to help for RPG. You might adapt it for other languages.
    34,430 pointsBadges:
    report
  • ToddN2000
    Unfortunately I have never seen anything. I think you are looking for something like self documenting code. With RPG being able to be written standard or free form. With code in copybooks and stored procedures I can't imagine it being done effectively. The best alternative is document all aspects of the code. You might be able to use that as a guide.
    131,585 pointsBadges:
    report
  • TheRealRaven
    I'd think that good use of /COPY and procs (stored or otherwise) could give excellent help to self-documenting code. E.g., a proc named addOrderListItems() may be the only thing needed to describe what a block of code does, while one named ADDORDLI() could need comments just to clarify why it was being referenced. The /COPY would only need to carry the prototype plus perhaps any template DSs used for interfacing with the proc.
    34,430 pointsBadges:
    report
  • azohawk

    I have not encountered anything to do this; but, how much detail are you being required to provide?  I have had to this for some employers; but typically a couple of sentences covers it.  (Users requested program.... or Program was not calculating... etc.  and  Added a subroutine that....  Changed the calculation from  ... to .... etc.). Normally, 4 to 6 sentences (and sometimes that was more than the code change). Write good documentation in the program so if you win the lottery and quit, the next guy can see exaclty what you did. 

    I have encountered programs that will review code and create a flow chart of the program; but that would be a lot of detail.

    4,055 pointsBadges:
    report
  • RPOOJA1
    Hi azohawk,

    can u please tell me the programs that review and create flow chart of the program. i needed this kind functionality.
    25 pointsBadges:
    report
  • azohawk

    I encountered a couple of ERP packages that had a variation on this. 

    I have been to demo's where this was demoed as part of the native GUI (however, when I get home, I can never get it to work)

    One I have used with success is part of Pathfinder (Hawkeye Information Systems in Iowa  Hawkinfo.com). I have seen ads for others in the past but I don't have anything readily accessable right now to point you to.

    4,055 pointsBadges:
    report
  • azohawk
    You might look and see if TAATools has something also.
    4,055 pointsBadges:
    report
  • ToddN2000
    I forgot about Pathfinder / Hawkeye myself. That was pretty good when I worked with it about 12 years ago. Nice package for the AS/400 at the time. Have not seen it lately but can only imagine how it would work now with all the built in functions in RPG/ILE. I'd look into that one.
    131,585 pointsBadges:
    report
  • philpl1jb

    Pathfinder / Hawkeye flow chart program didn't get anything out of my ILE code ..

    the Subroutine explosion .looked promising. 



    54,090 pointsBadges:
    report

Forgot Password

No problem! Submit your e-mail address below. We'll send you an e-mail containing your password.

Your password has been sent to:

To follow this tag...

There was an error processing your information. Please try again later.

Thanks! We'll email you when relevant content is added and updated.

Following

Share this item with your network: