Copyright and RPGLE for the New Year

  • Home
  • /
  • Blog
  • /
  • Copyright and RPGLE for the New Year

January 2, 2018

Copyright and RPGLE for the New Year

By NickLitten

January 2, 2018

2018, copyright, IBM i OS, NewYears, RPG, RPGLE

+Happy New Year 2018. One of my new years resolutions was to write cleaner code, and in the spirit of out with the old and in with the new

I already use the RPG COPYRIGHT statement and the CL COPYRIGHT STATEMENT to store the copyright message and (more importantly to me) the Version or Release number of this code.

But we want the copyright shown in DUMPS

Copyright and RPGLE for the New Year 1

Lots of IBM i shops have old AS400 and iSeries RPG applications that have evolved over the years. They are still using the good old fashioned compile time array (aka table) technique to store COPYRIGHT information in their RPG and RPGLE programs.

Perhaps, 2018 is the time to upgrade this old RPGLE Compile Time Array technique with a newer dcl-s statement technique?

Out with the old and in with the new from RPGLE Arrays to DCL-S Copyrights

It’s less code, simpler to write, saves a lot of time and therefore money 😉

Upgrading the COPYRIGHT technique in RPG and CL

Add a member(copyright) to a standard copybook:

dcl-s CopyrightCompanyName varchar(256)
 inz('Application Version x.y Copyright © SOMETHING LLC 2018 - Program Property of SOMETHING LLC. All Rights Reserved.');

dcl-s Copyright_ptr pointer inz(%addr(CopyrightCompanyName));

The CopyrightCompanyName variable is the copyright and the Copyright_ptr pointer tricks IBM I into flagging it as used, so it shows in program dumps without having to MOVE or EVAL.

Then each program just has one line in it

/include copyright

Benefits
• No need for array definition
• No need for c-spec move statement
• No Need for footer table in each program
• No code changes needed if copyright is updated — copybook member(copyright) will be automatically picked up as each program is recompiled

The same technique can be used for CLLE programs using CLP INCLUDE and the same copyright statement in a CL copybook.

The CL Looks like this:

DCL VAR(&COPYRIGHT) TYPE(*CHAR) LEN(256) + 
 VALUE('Application Version x.y Copyright © SOMETHING LLC 2018 - Program Property of SOMETHING LLC. All Rights Reserved.')

DCL VAR(&COPYRIGHTP) TYPE(*PTR) STG(*DEFINED) DEFVAR(&COPYRIGHT)

I hope that helps somebody else out there suffering from post christmas blues. Or at least gives you some food for thought.

Talking about food… where is that Turkey Sandwich??

  • For RPG – not CL sadly – you could change the definition to use Ctl-Opt Copyright(‘This is mine all mine!!’);

    Has the added advantage that there are standard system commands that will show you the value. i.e. DSPMOD mylib/mymod DETAIL(*COPYRIGHT) or DSPPGM with DETAIL(*COPYRIGHT) and DSPSRVPGM DETAIL(*COPYRIGHT).

    I think I am right in saying that the information if coded this way cannot be hacked as it would screw up some checksum or other in the program whereas changing a variable would not have that effect.

    P.S. Have only just rediscovered your blog – which as another ex-Brit I find very refreshing. But how the heck do I subscribe to be notified of new posts?

  • {"email":"Email address invalid","url":"Website address invalid","required":"Required field missing"}

    Join the IBM i Community for FREE Presentations, Lessons, Hints and Tips

    >