Micro Focus Background Parser Function Package

The Micro Focus Background Parser function package is comprised of features and tools that operate in the context of the Micro Focus COBOL, PL/I, or JCL editor's background parser.

The function package enables you to specify the concatenation of SYSLIB or PROCLIB libraries to be used when copybooks or includes are downloaded from a mainframe.

The function package enables you to specify the structure of the local file cache for the downloaded copybooks or includes. The structure of the local file cache for copybooks or includes is specified by the relationship Micro_Focus_Function_Package_Has_Cache. Under this relationship identifiers can be specified to point to AWM properties. The values of those properties in the specified sequence are used during run time to determine the folder structure to search, or to store downloaded copybooks. The last folder in this structure is always named as the partitioned data set where the copybook or include was located on the mainframe.

The concept is that sources opened from a common context typically have the same copybook or include view.

Note: This cannot prevent a source from opening an incorrect or outdated version of a copybook or include. To prevent this, tools to clear the local copybook or include cache are provided. When the cache is cleared the copybooks or includes are downloaded from the mainframe.

You do not need to explicitly specify the cache structure. In this case, the copybook or include is stored in the internal AWM project under ../FileCache/BackgroundParser/<data_set_name> where <data_set_name> is the name of the data set where the copybook or include was located on the mainframe.

Alternatively, you could specify the cache structure depending on the staging hierarchy or life cycle structure of a Software Configuration Management (SCM) system. In a SCM system, the sources at the same stage typically have the same copybook or include view.

For example, in the SCM system Endevor, the staging hierarchy is defined by the features Environment and Stage. When modeling Endevor you might specify identifiers defining the local copybook/include storage as the properties representing the Endevor Environment and Endevor Stage.

Relationship Cardinality Description
Has_SYSLIB_Definition 0..1 The relationship to a SYSLIB definition describing the concatenation of mainframe libraries to search for COBOL copybooks, or PL/I includes.
Has_PROCLIB_Definition 0..1 The relationship to a PROCLIB definition describing the concatenation of mainframe libraries to search for JCL includes.
Has_Cache 0..1 The relationship to a definition determining the structure of the local cache for downloaded COBOL copybooks, PL/I, or JCL includes.