gmplGlobalStubsStatement

Owned by Mark Juras
Last updated: Jul 25, 2018Version comment
2 min read

GlobalStubs Statement Summary

GlobalStubs is a nonterminal, utility statement that occurs in command scripts. It authors the stubs for a set of references that have been loaded previously via the Reference statement. The statement is followed by a set of Load substatements which specify which compiled VBI files are to be used to determine which components in the references have been referenced.

The GlobalStubs statement itself has no attributes.

The substatements of the GlobalStubs statement are as follows:

Substatement Description
Load This substatement specifies the full pathname of a virtual binary information file via an id attribute. This file is loaded into a temporary storage area where it is searched for references to the components in the load references.

The script errors associated with the GlobalStubs statement are as follows:

Error Description
1064 Language command missing required id attribute.
1065 Unable to store Language id: %1d"
1066 The following record is not recognized: %1d

The typical script using the GlobalStubs statement would be as follows.

First, a storage statement is needed to hold the references to be loaded. 


   <gmBasic>
      <Storage Action="Create" Identifier="..." />

Second, all of the standard locations need to be specified so that the reference files themselves can be located and loaded and the authored stubs can be sent to the desired deployment location. 


      <Select DeployLocation="..." />
      <Select Library="..." />
      <select Target="..." />
      <Select Local="..." />
      <Select System="..." />

Third, a set of reference statements is used to specify the references for which stubs are to be authored. The actual declarations within these references are loaded in the storage area created above. 


      <Reference id="..." />
      <Reference id="..." />
    ....
Fourth, an output statement is needed to specify the file to receive the authored stubs. 


      <Output Status="New" Filename="GlobalStubs.bnd" />
Finally, the GlobalStubs statement itself is used to specify the previously compiled VBI files whose content makes references to components in the loaded references. 


      <GlobalStubs >
         <Load id="...vbi" />
         <Load id="....vbi" />
             ....
         <Load id="....vbi" />
      </GlobalStubs>
      <Storage Action="Close" />
   </gmBasic>


Table of Contents