HP 3000 Manuals HP 3000 Manuals
GLOSSARY Construct. A command recognized by the Virtuoso Code Generator such as #if or #for. The command instructs the generator to perform a specific operation. Keyword. A symbolic name. The generator stores a value for each keyword as a keyword-value pair. A keyword may be referenced in a Virtuoso Source File by preceding its name with the substitution character. Include File. A Virtuoso Source File that is included into another Virtuoso Source File via the #include construct. Typically, an Include File contains non-reusable logic. Macro. A reusable component which performs a logical operation or function, such as creating a record or adding an entry to a dataset. The component is reusable because it does not contain specific data names or specific logic. Model. A Virtuoso Source File which is reusable because it does not contain specific data names or specific logic. A single model may be used with different data definitions to create multiple output files. For example, a COBOL model may be used with different data definitions to generate multiple COBOL modules. Module. A program source file. For example, a COBOL module is either a COBOL main program or a COBOL subprogram. Parameter Replacement. The process of replacing keywords with their respective values within a Virtuoso Source File. A keyword is replaced with its value whenever it is preceded by the substitution character. Processed Macro File. A binary file which contains the definition of one or more macros. This file is accessed by the generator to retrieve the definition of a macro whenever one is invoked at generation-time. Reusable Component. Any component which may be used more than once and therefore is a candidate to become a macro or a model. It is up to each programming shop to determine which components should become macros and models. Scoping. The feature which allows a programmer to create multiple occurrences of the same keyword, each in a different nesting level. Macro invocations and the constructs #block and #for cause a new nesting level to be created. Scoping is analogous to local variables in languages like Pascal. Source Macro File. An ASCII file which contains the source definition of one or more macros. The file may be created/modified using any standard text editor. The file must be processed into a Processed Macro File before the macro(s) may be invoked at generation-time. Substitution. See Parameter Replacement. User Text. The non-Virtuoso Statements in a Virtuoso Source File. These lines are used to generate the output file. The lines are written to the output file verbatim with the exception that substitution is performed on any keywords. The type of text determines the type of output file produced by the generator. For example, if the text is COBOL statements, the output file is a COBOL source file; if the text is documentation, the output file is a document. Virtuoso Source File. An input file to the Virtuoso Code Generator. The file consists of Virtuoso Statements intermixed with User Text. If the file may be reused to generate multiple output files, then it is also called a Model. Virtuoso Statement. A statement in a Virtuoso Source File which is either a construct or a macro call. These lines are identified by placing the sentinel character (#) as the first non-blank character of the line.