TechTip: Defining Prototypes in a /COPY File

RPG
Typography
  • Smaller Small Medium Big Bigger
  • Default Helvetica Segoe Georgia Times
When defining prototypes in a /COPY file, you may want to define return values or parameters LIKE some of the fields in an externally described file. This works fine if all the programs using the /COPY file also define that file and don't use any PREFIX on the file. To ensure that all programs can use the /COPY file even if they don't define the file, use an externally described data structure in your /COPY file. Use a prefix to keep your names different from any names in the program itself.

D            E DS    BASED(TYPE_DEFINITION_POINTER)
D                    EXTNAME(somefile)
D                    PREFIX(SOMEFILE_TYPES_)

D proc         PR
D   parm             LIKE(SOMEFILE_TYPES_FLD1)


If you are on V5R1 or later, you could use QUALIFIED instead of PREFIX:

D somefileTypes...
D            E DS    BASED(TYPE_DEFINITION_POINTER)
D                    EXTNAME(somefile)
D                    QUALIFIED

D proc         PR
D   parm             LIKE(somefileTypes.FLD1)


Note: BASED(TYPE_DEFINITION_POINTER) is used to avoid having any storage assigned to the data structure. Sixteen bytes of storage will be assigned to the pointer itself, so you should always use the same pointer for this kind of "type definition."

--Barbara Morris
This email address is being protected from spambots. You need JavaScript enabled to view it.

BLOG COMMENTS POWERED BY DISQUS

LATEST COMMENTS

Support MC Press Online

$

Book Reviews

Resource Center

  •  

  • LANSA Business users want new applications now. Market and regulatory pressures require faster application updates and delivery into production. Your IBM i developers may be approaching retirement, and you see no sure way to fill their positions with experienced developers. In addition, you may be caught between maintaining your existing applications and the uncertainty of moving to something new.

  • The MC Resource Centers bring you the widest selection of white papers, trial software, and on-demand webcasts for you to choose from. >> Review the list of White Papers, Trial Software or On-Demand Webcast at the MC Press Resource Center. >> Add the items to yru Cart and complet he checkout process and submit

  • SB Profound WC 5536Join us for this hour-long webcast that will explore:

  • Fortra IT managers hoping to find new IBM i talent are discovering that the pool of experienced RPG programmers and operators or administrators with intimate knowledge of the operating system and the applications that run on it is small. This begs the question: How will you manage the platform that supports such a big part of your business? This guide offers strategies and software suggestions to help you plan IT staffing and resources and smooth the transition after your AS/400 talent retires. Read on to learn: