EGL Reference Guide for iSeries

Identifying the programs or records to which an element refers

In each element, a property (for example, pgmName) identifies the programs or records to which the element refers; and unless otherwise stated, the value of that property can be a valid name, an asterisk, or the beginning of a valid name followed by an asterisk. The asterisk is the wild-card equivalent of one or more characters and provides a way to identify a set of names.

Consider a callLink element that includes the following value for the pgmName property:

  myProg*

That element pertains to any EGL program part that begins with the letters myProg.

If multiple elements are valid, EGL uses the first element that applies. A series of callLink elements, for example, might be characterized by these pgmName values, in order:

   YourProgram
   YourProg*
   *

Consider the element associated with the last value, where the value of pgmName is only an asterisk. Such an element could apply to any program; but in relation to a particular program, the last element applies only if the previous elements do not. If your program calls YourProgram01, for instance, the linkage specified in the second element (YourProg*) supersedes the third element (*) to define how EGL handles the call.

In most cases, elements with more specific names should precede those with more general names. In the previous example, the element with the asterisk is appropriately positioned to provide the default linkage specifications.


Related concepts
Java wrapper
Parts


Related tasks
Adding a linkage options part
Deploying a linkage properties file
Editing the asynchLink element of a linkage options part
Editing the callLink element of a linkage options part


Editing the transfer-related elements of a linkage options part
Setting up the J2EE run-time environment for EGL-generated code


Related reference
asynchLink element
call
callLink element


linkage
Linkage properties file (details)


sysLib.startTransaction
transfer
transferToProgram element
transferToProgram element


[ Top of Page | Previous Page | Next Page | Table of Contents | Index ]