Previous Next

At runtime, gets metadata information about how modules are run. This information extends not just to consumed modules (if any) and plug-in modules (if any), but also to the application itself (the so-called "consumer application" or "main module").

Returns an XML document of the form demonstrated in the Example below.

The return document contains an entry for:

The application itself (the "consumer application" or "main module").

Any module that has been declared for the application with Load Module = Yes.

Any module that is run as a result of being declared as a plug-in module in a .PIN file.

Each entry contains a list of attributes that are name/value pairs. Attributes returned are:




The name of the module, or the name of the consumer application.


For USoft applications, the USoft patch version name (for example, '10.0.1') of the module.

For user-defined applications, the value of VERSION is empty.


Whether the module or consumer application is run from repository ('Y') or from flatfles ('N').

If NAME is for a consumed module or plug-in module, then FROM_DATABASE is forceably 'N'.

If NAME is for a USoft application, eg., USoft Definer, then FROM_DATABASE is forceably 'N'.

It is possible for FROM_DATABASE to be set to 'Y' only if NAME is for a user-defined consumer application.


Whether the module is the consumer application ('Y'), or a consumed module ('N').

"Main module" is a synonym of "consumer application".

There is always exactly 1 main module. Any remaining modules are consumed modules or plug-in modules.


Whether the module is run as a plug-in or not.

For the consumer application, this attribute is set to 'N'.

For modules, if the module is run because it is declared in a .PIN file, this attribute is set to 'Y', otherwise to 'N'.



SELECT USMeta.Modules(
       module-name-pattern     Modules

The name parameter is optional. Parameter values that you pass are mapped to parameters by alias name. The '.*MAIN.*' value in the following example is for module-name-pattern because of the "Modules" alias:

SELECT   USMeta.Modules( '.*MAIN.*' Modules )

Module-name-pattern is a regular expression that matches zero, one or more module names in the model. The result data is limited to modules matching the pattern. If module-name-pattern is omitted, then result data is not limited in this way.


This example returns module information about all modules run, and about the consumer application:

SELECT USMeta.Modules()

The return value of this statement could be:

<?xml version="1.0" encoding="UTF-16"?>



See also

USMeta internal component