Linkage options part

A linkage options part specifies details on the following issues:

Specifying when linkage options are final

You can choose between two alternatives:
  • The linkage options specified at generation time are in effect at run time; or
  • The linkage options specified in a linkage properties file at deployment time are in effect at run time. Although you can write that file by hand, EGL generates it in this situation:
    • You set the linkage options property remoteBind to RUNTIME; and
    • You generate a Java™ program or wrapper with the build descriptor option genProperties set to GLOBAL or PROGRAM.

    For details on using the file, see Deploying a linkage properties file. For details on customizing the file, see Linkage properties file (reference).

Elements of a linkage options part

The linkage options part is composed of a set of elements, each of which has a set of properties and values. The following types of elements are available:

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

Feedback
(C) Copyright IBM Corporation 2000, 2005. All Rights Reserved.