This is the primary help frame for the incredible MMS application.
1 – About frame
HP CONFIDENTIAL. This software is confidential proprietary software licensed by Hewlett-Packard Development Company, L.P., and is not authorized to be used, duplicated or disclosed to anyone without the prior written permission of HP. © 2015 Copyright Hewlett-Packard Development Company, L.P. VMS SOFTWARE, INC. CONFIDENTIAL. This software is confidential proprietary software licensed by VMS Software, Inc., and is not authorized to be used, duplicated or disclosed to anyone without the prior written permission of VMS Software, Inc. © 2015 Copyright VMS Software, Inc. Software Version: Module Management System for OpenVMS, version V4.0 For more information about the Module Management System for OpenVMS (MMS), double click on Overview of MMS from the additional topics below.
2 – Overview frame
The Module Management System for OpenVMS (MMS) automates and
simplifies the building of software systems. MMS serves the
following functions:
o You can specify exactly how a software system is to be built
and rebuilt.
o System rebuilds can be done quickly when parts of the system change.
o Modules can be built and tested locally before building or testing
the modules in the source directory or library.
For more information about using MMS, managing windows,
or using the mouse, double click on an item from the list of
additional topics below.
For information about using help, choose Help from the
Help menu above.
3 – DECbasics frame
Information about using DECwindows, such as how to use
windows, dialog boxes, and scroll bars, is available from
Session Manager help. A glossary of DECwindows terms is
also available. To get Session Manager help:
1. Move the pointer to the Session Manager icon (the
icon with your user name and the name of your system)
in the Icon Box.
2. Press mouse button 1 (MB1) twice quickly to display
the Session Manager window.
3. Move the pointer to the Help menu; press and
hold MB1 to pull down this menu.
4. Move the pointer to the Overview menu item and
release MB1 to display information about
using DECwindows.
4 – Glossary frame
action
A command-language command that MMS executes to update a
target. (See also action line.)
action line
The part of the dependency rule that contains the commands
that tell MMS how to use the source or sources to update
the target. (See also dependency rule.)
action line prefix
A special character placed at the beginning of an action
line that influences how MMS executes the action. (See
also action line.)
built-in rule
A command that MMS uses when the description file does
not explicitly describe the processing needed to update a
target.
default macro
A name that represents a character string that defines
commonly used operations. MMS built-in rules are expressed
in terms of default macros. (See also built-in rule and
macro.)
dependency rule
The description of a relationship between a target and
one or more sources, and the action or actions required to
update the target. Dependency rules are contained in the
description file. (See also description file.)
description file
A text file that contains the dependency rules, comments,
macros, and directives that MMS uses to build your system.
(See also dependency rule, directive, and macro.)
directive
A word that specifies an action for the processing of the
description file.
included file
A shared file used during software development that
contains code or constant declarations.
library module specification
An OpenVMS file specification for a module in a library.
macro
A name that represents a character string. The string is
substituted for the name in a dependency rule.
macro invocation
The execution of the macro that replaces the macro name
with its definition.
mnemonic name
A name that identifies the purpose of a sequence of
related actions. It can be used as either a source or
a target in the description file. (See also source and
target.)
object library
A single file that contains multiple object files. (See
also object module.)
object module
One or more object files that comprise an object library.
source
In a dependency rule, an entity that is used to create
or to update the target. A source can be an OpenVMS file
specification or a mnemonic name. (See also dependency
rule and mnemonic name.)
special macro
A name that represents a character string that expands
to source or target names in the dependency currently
being processed. A special macro is used instead of a
target or source file specification when writing general
user-defined rules. (See also dependency rule, macro, and
target.)
suffixes precedence list
A list of file types to which MMS refers when it needs to
know which source file can update the specified target.
target
In a description file, the entity that is to be updated. A
target can be an OpenVMS file specification or a mnemonic
name. (See also mnemonic name.)
user-defined rule
A rule that the user specifies in the description file
to add to and/or replace MMS built-in rules. (See also
built-in rule.)
5 – main MnWind
The main window consists of two panes. The top pane displays the description file. The bottom pane displays the log from the build. The main window also contains a set of menus, in the menu bar across the top, that let you set the description file and review the build diagnostics files.
5.1 – help HelpBox
The Help pull-down menu contains the following information:
o On Context --- provides a way to get access to context-sensitive
help.
o On Window --- provides a brief description of the MMS main window.
o On Help --- describes how to get access to the context-sensitive
help.
o On Version --- identifies the product name, version number, and
copyright information.
You can get help in two ways:
o To get help about MMS tasks, choose Overview from the Help menu.
The Overview describes MMS and lists additional topics that
explain how to do common tasks when using MMS. Double click
on an additional topic for more information.
o To get help about screen objects, such as data types, dialog boxes,
and buttons, press and hold the HELP key while you click on the
screen object in which you're interested in getting help.
5.2 – menu bar MenuBar
The MMS menu bar contains the following menus:
o File --- for opening a description file, for fetching a
description file, and for exiting from MMS
o Review --- for reviewing the compilation diagnostics
o Options --- for specifying options for a build, and for
displaying (or not displaying) the description file
o Help --- for obtaining help on MMS and any of the objects in the
MMS window
5.2.1 – file Casc
You can choose one of the following menu items from the File pull-down menu:
o Open Description file... --- opens an existing MMS description file
o Fetch Description file...--- fetches an existing MMS description
file from CMS
o Exit --- terminates the MMS session
5.2.1.1 – open Btn
Choose the Open Description file... menu item from the File pull-down menu to specify the name of a MMS description file to display the contents of in the MMS main window.
5.2.1.2 – fetch Btn
Choose the Fetch Description file... menu item from the File pull-down menu to specify the name of a MMS description file to fetch from CMS and to display the contents of in the MMS main window.
5.2.1.3 – exit Btn
Choose Exit to terminate the current MMS session.
5.2.2 – review Casc
The Review menu is used to review compiled modules' diagnostics files
from the most recent build. You can choose one of the following menu items
from the Review pull-down menu:
o Next Module --- to review the next module's diagnostics file
o Previous Module --- to review the previous module's diagnostics file
o First Module --- to review the first module's diagnostics file
o Last Module --- to review the last module's diagnostics file
5.2.2.1 – next Btn
Choose the Next Module menu item from the Review pull-down menu to review the diagnostic file from the next module's compilation
5.2.2.2 – previous Btn
Choose the Previous Module menu item from the Review pull-down menu to review the diagnostic file from the previous module's compilation
5.2.2.3 – first Btn
Choose the First Module menu item from the Review pull-down menu to review the diagnostic file from the first module's compilation
5.2.2.4 – last Btn
Choose the Last Module menu item from the Review pull-down menu to review the diagnostic file from the last module's compilation
5.2.3 – options Casc
You can choose one of the following menu items from the Options
pull-down menu:
o Input/Output... --- to specify input/output options for
any subsequent build
o Definitions/Directives file...--- to specify definitions and
directives for any subsequent build
o Show Description file --- to specify whether the description file
should be shown or not
5.2.3.1 – io options Btn
Choose the Input/Output ... menu item from the Options pull-down menu to specify input/output options for any subsequent build.
5.2.3.2 – dd options Btn
Choose the Definitions/Directives ... menu item from the Options pull-down menu to specify definitions and directives for any subsequent build
5.2.3.3 – show desc Tgl
Choose the Show Description file menu item from the Options pull-down menu to display the MMS description file.
5.2.4 – help Casc
The Help menu contains the following entries:
o On Context --- Converts the mouse pointer to a question mark,
allowing you to obtain help on any object in the MMS window you
click on. When you click on an object, MMS displays the
DECwindows Help Widget, containing help specific to the object
you clicked on.
o On Help --- Displays the DECwindows Help Widget, containing a list
of topics you can obtain help on.
o On Window --- Displays the DECwindows Help Widget, containing a list
of topics you can obtain help on.
o On Version --- Displays the DECwindows Help Widget, containing
the version identifier of MMS software you are running and a
copyright notice.
5.2.4.1 – On Context Btn
When you click on 'On Context' in the Help menu, MMS provides a fast way to obtain context-sensitive help on any object you click on in the MMS window. Note that when you click on 'On Context', the arrow pointer converts to a question mark, indicating you are in Context-Sensitive Help mode. After the Help Widget is displayed for the window object you clicked on, the arrow pointer reappears.
5.2.4.2 – On Help Btn
To get help on using MMS, you can use one of two methods:
o Choose On Context from the Help menu. Then click on any object in
the MMS window on which you want help.
o Press and hold MB1 on any object in the MMS main window on
which you want help, and press the Help key on your keyboard.
5.2.4.3 – On Window Btn
MMS automates and simplifies the building of software systems.
MMS serves the following functions:
o you can specify exactly how a software system is to be build
and rebuilt.
o system rebuilds can be done quickly when parts of the system change.
o modules can be built and tested locally before building or testing
the modules in the source directory or library.
5.2.4.4 – On Version Btn
HP CONFIDENTIAL. This software is confidential proprietary software licensed by Hewlett-Packard Development Company, L.P., and is not authorized to be used, duplicated or disclosed to anyone without the prior written permission of HP. © 2015 Copyright Hewlett-Packard Development Company, L.P. VMS SOFTWARE, INC. CONFIDENTIAL. This software is confidential proprietary software licensed by VMS Software, Inc., and is not authorized to be used, duplicated or disclosed to anyone without the prior written permission of VMS Software, Inc. © 2015 Copyright VMS Software, Inc. Software Version: Module Management System for OpenVMS, version V4.0 For more information about the Module Management System for OpenVMS (MMS), double click on Overview of MMS from the additional topics below.
5.3 – work area PaneWin
The MMS Main Window is divided into 3 panes - the Build activation area, the MMS Description File area, and the Build log area.
5.3.1 – build_form
The Build activation area can be used to:
o display the current description file name
o create a description file
o specify a possible build target
o to start or stop a build
5.3.2 – descfile Txt
The file specification of the description file which is displayed in the MMS description file area and which will be used by MMS. It cannot be set by the user.
5.3.3 – target Txt
The target for any subsequent build.
5.3.4 – start build Btn
Click on Start Build to start an MMS build.
5.3.5 – stop build Btn
Click on Stop Build to terminate an MMS build.
5.3.6 – stop gen Btn
Click on Stop Generate to terminate a description file generation.
5.3.7 – create mmsfile Btn
Click on Create MMS File... to open a dialog box for specifying input for the automatic description file generator
5.3.8 – desc_pane
The MMS description file area is used to display the current MMS description
file.
The contents of the MMS description file area may be specified by the
following methods:
o with the description file qualifier on the MMS command line.
o with the File pull-down menu options Open Description File... or
Fetch Description File...
o created by the Create MMS File... button
5.3.8.1 – desc_disp
The MMS description file area is used to display the current MMS description
file.
The contents of the MMS description file area may be specified by the
following methods:
o with the description file qualifier on the MMS command line.
o with the File pull-down menu options Open Description File... or
Fetch Description File...
o created by the Create MMS File... button
5.3.9 – log_pane
The Build log area is used to display the output from the most recent build.
5.3.9.1 – log_disp
The Build log area is used to display the output from the most recent build.
6 – open PopForm
Use the Select Description File box to select the MMS description file to be used for any subsequent build.
6.1 – open FilSelB
Enter the name of the description file to be used in any subsequent build.
7 – fetch PopForm
Use the Select Description File from CMS library box to select the MMS description file to be used for any subsequent build. If a CMS library is not defined, the Fetch Description file... menu option will not be enabled.
7.1 – fetch FilSelB
Enter the name of the description file to be used in any subsequent build.
8 – io options PopForm
Use the Input/Output Options box to specify input or output options for any subsequent build.
8.1 – input label Lab
The buttons and text fields following this label are used for specifying input files for any subsequent build.
8.2 – desc Tgl
Click on the button to specify an MMS description file for any subsequent build.
8.3 – desc file Btn
Click on this button to bring up a file selection dialog box to specify the MMS description file.
8.4 – desc file Txt
Enter the file specification of the MMS description file. If the file selection box is used, this field will be filled in with the chosen file.
8.5 – changed Tgl
Click on the button to direct MMS to treat only the specified sources as having been changed, regardless of their actual modification times. No date checking is performed at all; MMS simply rebuilds any targets that depend on one or more of the specified sources.
8.6 – changed sources Btn
Click on this button to bring up the Changed Sources dialog box to specify the source files to be regarded as changed.
8.7 – changed sources Txt
Enter the file specifications of the source files to be regarded as changed. If more than one source is indicated, use comma-separated list. If the Changed Sources dialog box is used, this field will be filled in with the chosen files.
8.8 – output label Lab
The buttons and text fields following this label are for specifying output files for any subsequent build.
8.9 – list Tgl
Click on the button to direct MMS to write dependencies and action lines to an output file as it processes the description file.
8.10 – list file Btn
Click on this button to bring up a file selection dialog box to specify the list file.
8.11 – list file Txt
Enter the file specification of the List file. If the file selection box is used, this field will be filled in with the chosen file.
8.12 – output Tgl
Click on the button to direct MMS to write action lines and output to the specified file.
8.13 – output file Btn
Click on this button to bring up a file selection dialog box to specify the Output file.
8.14 – output file Txt
Enter the file specification of the Output file. If the file selection box is used, this field will be filled in with the chosen file.
8.15 – log Tgl
Click on the button to direct MMS to display informational messages as it processes the description file.
8.16 – io options ok Button
Click on the button to save the current Input/Output Options settings for any subsequent build.
8.17 – io options can Button
Click on the button to cancel the current Input/Output Options settings.
8.18 – io options help Button
Use the Input/Output Options dialog box to define options for any subsequent build. The default values of the options will be reflected when the dialog box comes up. If there are Input/Output Options settings defined for the current context, they will be reflected when the dialog box come up, and they will take precedence over the default settings. If qualifiers have been specified when invoking MMS, the Input/Output Options settings will reflect the qualifier values, and they will take precedence over the context settings.
9 – chngsrc PopForm
Use the Select Changed Sources dialog box to specify files that are to be regarded as changed.
9.1 – add chg Lst
The Changed Sources list box specifies the possible list of those files to be regarded as changed. The OK button must be clicked for the list to be saved. Files are added to the list from the right-hand list box. Files can be removed from the list by means of the arrow button (which is displayed when a file is highlighted).
9.2 – chg all Btn
Click on this button to move all the files listed in the right-hand list box to the left-hand list box.
9.3 – chg left arrow Btn
Click on this button to move the highlighted file from the right-hand list box to the left-hand list box.
9.4 – chg up arrow Btn
Click this button to move the highlighted file to the top of the left-hand list box.
9.5 – chg right arrow Btn
Click this button to remove the highlighted file from the left-hand list box.
9.6 – sel chg Lst
The Changed Sources Selection list box specifies the list of sources
to choose from to add to the left-hand list box.
Files can be moved to the left-hand list in three ways:
o double-click on a file specification
o highlight a file specification, then click on the left arrow button
o click on the All button, which will move all the files from the
right-hand box to the left-hand box
9.7 – chg filter Txt
The filter is used to specify a mask to filter which file names are listed. Click on the Filter button to filter the selection box list.
9.8 – chg Radio
Click on one of the sources areas in the Source radio box to specify where the files listed in the selection list box should come from. You can go from directory to directory to list selection files from.
9.9 – chg context dir Tgl
Click on this button to indicate that sources should be listed from the default directory specified for the current context.
9.10 – chg curr dir Tgl
Click on this button to indicate that sources should be listed from the current default directory.
9.11 – chg other dir Tgl
Click on this button to indicate that sources should be listed from a specified directory. The field to the right is used to specify the other directory to list from.
9.12 – chg other dir Btn
Click on Other Directory... to open a dialog box for specifying the directory to list from.
9.13 – chg other dir Txt
Use this field to specify the directory to list from.
9.14 – chngsrc ok Button
Click on the button to save the current Changed Sources List.
9.15 – chngsrc cancel Button
Click on the button to cancel the current Changed Sources List settings.
9.16 – chngsrc reset Button
Click on the button to reset the dialog box settings to the way they were when the box was entered.
9.17 – chngsrc filter Button
Click on the button to apply the filter mask defined in the Filter field to the specified directory, and the appropriate source files are listed in the Selection list box.
9.18 – chngsrc help Button
Use the Changed Sources dialog box to specify those files which are to be regarded as changed. The right-hand list box contains a list of the possible source files to choose from to insert into the Changed Sources List. Initially, the selection list box lists all the source files in the current default directory. But, there is the option of picking a different directory to list the files from. These options are available by clicking the corresponding radio button. Any file in the right-hand list box that is double-clicked is inserted into the left-hand list box. The left arrow button can also be used for moving a file from the right-hand box to the left-hand box. Clicking the All button will move all the files listed in the right-hand box to the left-hand box. Source files can be removed from or up in the left-hand list by means of arrow buttons (which are displayed when a file is highlighted).
10 – chg other dir PopForm
Use the Other Directory Selection box to specify the other directory from which changed source files should be listed.
10.1 – chg other dir FilSelB
Enter the other directory to list from.
11 – dd options PopForm
Use the Definitions/Directives Options box to specify options for any subsequent build.
11.1 – definitions label Lab
The buttons and text fields following this label are used for specifying definition files for any subsequent build.
11.2 – macro Tgl
Click on the button to direct MMS to add to or override the macro definitions in the description file.
11.3 – macro file Btn
Click on this button to bring up a file selection dialog box to specify the Macro definitions file.
11.4 – macro file Txt
Enter the file specification of the Macro definitions file. If the file selection box is used, this field will be filled in with the chosen file.
11.5 – rules Tgl
Click on the button to direct MMS to apply user-defined built-in rules and a suffixes precedence list when it builds a system.
11.6 – rules file Btn
Click on this button to bring up a file selection dialog box to specify the Rules file.
11.7 – rules file Txt
Enter the file specification of the Rules file. If the file selection box is used, this field will be filled in with the chosen file.
11.8 – override Tgl
Click on the button to control the order in which MMS applies definitions when it process macros.
11.9 – directives label Lab
The buttons and text fields following this label are used for specifying directives for any subsequent build.
11.10 – sca Tgl
Click on the button to direct MMS to generate an SCA library during the build process.
11.11 – sca library Btn
Click on this button to bring up a file selection dialog box to specify the SCA library directory.
11.12 – sca library Txt
Enter the directory specification of the SCA Library. If the file selection box is used, this field will be filled in with the chosen directory. When you specify a library name, MMS defines the macro $(SCA_LIBRARY) to be that library name.
11.13 – ignore Tgl
Click on the button to indicate that MMS should ignore certain severity levels of errors when it executes action lines. The radio buttons to the right correspond to the DCL severity levels W, E, and F.
11.14 – severity Radio
Click on one of the severity levels in the Severity radio box to specify the severity levels of errors that MMS should ignore when it executes action lines. The radio buttons correspond to the DCL severity levels W, E, and F. You cannot click on more than one severity level at a time.
11.14.1 – warning Tgl
Click on this button to indicate that errors of the warning level should be ignored by MMS when it executes action lines.
11.14.2 – error Tgl
Click on this button to indicate that errors of the warning and error levels should be ignored by MMS when it executes action lines.
11.14.3 – fatal Tgl
Click on this button to indicate that errors of the warning, error and fatal levels should be ignored by MMS when it executes action lines.
11.15 – cms Tgl
Click on the button to direct MMS to look for source files, description files and included files in the current default CMS library as well as the specified directories. When you specify Use CMS, and the source in the CMS library is newer, MMS fetches it from the CMS library. If the source in the CMS library is older, MMS instead used the source in the specified directory. CMS must be installed on your system.
11.16 – cms class Txt
Specify the CMS class to direct MMS to use the macro definition "CMSFLAGS=GENERATION=class-name". By specifying a CMS class, MMS still uses the CMS elements as the sources but it uses the designated class of generations, not necessarily the current generations.
11.17 – display Tgl
Click on the button to direct MMS to display action lines before executing them.
11.18 – execute Tgl
Click on the button to direct MMS to execute the action lines in the description file.
11.19 – fromsources Tgl
Click on the button to direct MMS to build a target from its sources, regardless of whether the target is already up-to-date.
11.20 – force Tgl
Click on the button to direct MMS to execute the action lines necessary to update one specific target.
11.21 – check Tgl
Click on the button to direct MMS to return a value in the symbol MMS$STATUS instead of updating a target. This symbol contains the status of the last action line executed by MMS.
11.22 – revise Tgl
Click on the button to direct MMS to only change the revision dates of all the targets that need updating, instead of performing the update.
11.23 – skip Tgl
Click on the button to indicate that MMS should not build intermediate source/target files.
11.24 – list switch Tgl
Click on the button to direct MMS to use the macro definition "LIST=1". Automatically generated description files will contain the following lines: .IFDEF LIST LST = /LIST .ELSE LST = /NOLIST .ENDIF and every compilation command will include the $(LST) macro. If this toggle button is clicked on, then every compilation in the build will produce a listing file. If this toggle button is off, no listings will be produced. Users can use the same mechanism in their own hand-written description files.
11.25 – debug switch Tgl
Click on the button to direct MMS to use the macro definition "DEBUG=1". Automatically generated description files will contain the following lines: .IFDEF DEBUG DBG = /DEBUG DBGOPT = /NOOPTIMIZE/DEBUG .ELSE DBG = /NODEBUG DBGOPT = /OPTIMIZE/NODEBUG .ENDIF and every compilation command will include the $(DBG) or the $(DBGOPT) macro. If this toggle button is clicked on, then every compilation in the build will be compiled with information to be included in the object module for use with the VAX Symbolic Debugger. Also the linker will be directed to generate a debugger symbol table and to give the debugger control when the image is run. Users can use the same mechanism in their own hand-written description files.
11.26 – diag switch Tgl
Click on the button to direct MMS to use the macro definition "DIAG=1". Automatically generated description files will contain the following lines: .IFDEF DIAG DIA = /DIAGNOSTICS .ELSE DIA = /NODIAGNOSTICS .ENDIF and every compilation command will include the $(DIA) macro. If this toggle button is clicked on, then every compilation in the build will produce an diagnostics file. If diagnostics files are produced during a build, and LSE is running, the user is able to do a REVIEW of each compilation from MMS. If this toggle button is off, no diagnostics files will be produced. Users can use the same mechanism in their own hand-written description files.
11.27 – dd options ok Button
Click on the button to save the current Definitions/Directives Options settings for any subsequent build.
11.28 – dd options can Button
Click on the button to cancel the current Definitions/Directives Options settings.
11.29 – dd options help Button
Use the Definitions/Directives Options dialog box to define options for any subsequent build. The default values of the options will be reflected when the dialog box comes up. If there are Definitions/Directives Options settings defined for the current context, they will be reflected when the dialog box come up, and they will take precedence over the default settings. If qualifiers have been specified when invoking MMS, the Definitions/Directives Options settings will reflect the qualifier values, and they will take precedence over the context settings.
11.30 – compa Tgl
Click on this button to enable the extended syntax features of MMS.
When selected, you may use the following in a description file:
o Predefined functions
o Macro redefinition
12 – macro PopForm
Use the Macro File selection dialog box to select the Macro Definitions file.
12.1 – macro FilSelB
Enter the name of the Macro Definitions file.
13 – rules PopForm
Use the Rules File selection dialog box to select the Rules file.
13.1 – rules FilSelB
Enter the name of the Rules Definitions file.
14 – desc PopForm
Use the Description File selection dialog box to select the Description file.
14.1 – desc FilSelB
Enter the name of the Description file.
15 – sca PopForm
Use the SCA Library selection dialog box to select the SCA library directory.
15.1 – sca FilSelB
Enter the directory for the SCA library.
16 – list PopForm
Use the List File selection dialog box to select the List file.
16.1 – list FilSelB
Enter the name of the List file.
17 – output PopForm
Use the Output File selection dialog box to select the Output file.
17.1 – output FilSelB
Enter the name of the Output file.
18 – genfile PopForm
Use the Description File Generator box to specify input for the automatic description file generator.
18.1 – gen descfile Txt
Enter the file specification for the generated description file.
18.2 – sources Btn
Click on Sources... to bring up a dialog box for specifying input sources to be scanned for dependencies when generating the description file.
18.3 – scan Tgl
Click on the button to indicate that C include files should be scanned for dependencies when generating the description file.
18.4 – builtin Tgl
Click on the button to indicate that built-in rules are to be used; no compilation action lines will be included when generating the description file.
18.5 – gen target Txt
Enter the build target name.
18.6 – obj lib Btn
Click on Object Library... to bring up a dialog box for specifying the object library to be included in the LINK command in the generated description file. Object files from the build compilations are inserted in this object library.
18.7 – obj lib Txt
Enter the file specification for the object library to be included in the generated description file LINK command. If the file selection box is used, this field will be filled in with the chosen file.
18.8 – link lib Btn
Click on Additional Link Libraries... to bring up a dialog box for specifying any additional object libraries to be included in the LINK command in the generated description file.
18.9 – opt file Btn
Click on Options Files... to bring up a dialog box for specifying any options files to be included in the LINK command in the generated description file.
18.10 – compile sw Txt
Enter any compilation switches that should be added to every compile command in the generated description file. These must be exactly what would be added to the command; i. e. they should include the slash (/) character. No checking is done to ensure the proper command is created.
18.11 – link sw Txt
Enter any switches that should be added to the LINK command in the generated description file. These must be exactly what would be added to the command; i. e. they should include the slash (/) character. No checking is done to ensure the proper command is created.
18.12 – genfile gen Button
Click on the button to save the settings indicated in the dialog box and to start generation of the description file.
18.13 – genfile cancel Button
Click on the button to cancel the current dialog box settings and to simply exit out of the dialog box without proceeding with the description file generation.
18.14 – genfile help Button
Use the MMS Generate Description File dialog box to specify input to the automatic description file generator. If qualifiers have been specified when invoking MMS, the dialog box settings will reflect the qualifier values.
19 – sources PopForm
Use the Select MMS Sources dialog box to specify the sources to be scanned for dependencies when generating the description file.
19.1 – input src Lst
The Input Source list box specifies the possible list of sources that will be scanned for dependencies when generating the description file. The OK button must be clicked for the list to be saved. Files are added to the list from the right-hand list box. Files can be removed from the list by means of an arrow button (which is displayed when a file is highlighted). The top-most source specifies the source for the target of the complete build. If a target is not specified in the MMS Description File Generator box, the top-most source name will be used for the target name. A file can be moved up to the top of the list by means of the Main button (which is displayed when a file is highlighted).
19.2 – all Btn
Click on this button to move all the files listed in the right-hand list box to the left-hand list box.
19.3 – left arrow Btn
Click on this button to move the highlighted file from the right-hand list box to the left-hand list box.
19.4 – main Btn
Click this button to move the highlighted file to the top of the left-hand list box. This top-most source specifies the source for the target of the complete build. When the file is moved to the top of the left-hand list box, it's name (without file extension) is also moved to the Main Module field. The Main Module field indicates the main module to be included from the object library during the link operation.
19.5 – right arrow Btn
Click this button to remove the highlighted file from the left-hand list box.
19.6 – select Lst
The Input Sources Selection list box specifies the list of sources to
choose from to add to the left-hand list box.
By default, the list will contain files which are found in the current
default directory.
Files can be moved to the left-hand list in three ways:
o double-click on a file specification
o highlight a file specification, then click on the left arrow button
o click on the All button, which will move all the files from the
right-hand box to the left-hand box
19.7 – main mod Txt
The field is used to specify the name of the main module which will be included from the object library in the LINK command of the generated description file. This field will be set automatically if a file is moved to the top of the left-hand list box by means of the Main button. It can (and must) be overridden manually if the main module does not have the same name as the file.
19.8 – filter Txt
The filter is used to specify a mask to filter which file names are listed. Click on the Filter button to filter the selection box list.
19.9 – src Radio
Click on one of the sources areas in the Source radio box to specify where the files listed in the selection list box should come from. You have the option of picking different directories to list the files from or of indicating that files should be listed from the CMS library. You can go from directory to directory to list selection files from, but if you then choose the CMS library, the Input (left-hand) selection list will be cleared; and vice-versa.
19.10 – context dir Tgl
Click on this button to indicate that sources should be listed from the default directory specified for the current context.
19.11 – curr dir Tgl
Click on this button to indicate that sources should be listed from the current default directory.
19.12 – other dir Tgl
Click on this button to indicate that sources should be listed from a specified directory. The field to the right is used to specify the other directory to list from.
19.13 – cms lib Tgl
Click on this button to indicate that sources should be listed from the current CMS library.
19.14 – other dir Btn
Click on Other Directory... to open a dialog box for specifying the directory to list from.
19.15 – other dir Txt
Use this field to specify the directory to list from.
19.16 – cmslib Btn
Click on CMS Library... to bring up a dialog box for specifying the CMS library from which source files will be fetched for generating the description file.
19.17 – cmslib Txt
Enter the directory specification for the CMS library from which source files will be fetched for generating the description file.
19.18 – sources ok Button
Click on the button to save the current Input Source List for any subsequent description file generation.
19.19 – sources cancel Button
Click on the button to cancel the current Input Source List settings.
19.20 – sources reset Button
Click on the button to reset the dialog box settings to the way they were when the box was entered.
19.21 – sources filter Button
Click on the button to apply the filter mask defined in the Filter field to the specified directory (or CMS library), and the appropriate source files are listed in the Selection list box.
19.22 – sources help Button
Use the MMS Generate Description File Sources dialog box to specify the input source list to the automatic description file generator. These sources will be scanned when generating the description file. The right-hand list box contains a list of the possible source files to choose from to insert into the Input Source List. Initially, the selection list box lists all the files in the current default directory, with the exception of the following types: .COM,.DIA,.EXE,.H,.LIS,.LOG,.MMS,.OBJ,.OLB,.OPT,.R32,.REQ The contents of this box can be limited to particular names and types using the filter text field. Any of the above excluded files types can be included by specifying the type in the filter text field. Files may be selected from a different directory or from a CMS library by clicking the corresponding radio button. Any file in the right-hand list box that is double-clicked is inserted into the left-hand list box. The left arrow button can also be used for moving a file from the right-hand box to the left-hand box. Clicking the All button will move all the sources listed in the right-hand box to the left-hand box. The top-most source in the left-hand list box specifies the source for the target of the complete build. If a target is not specified in the MMS Description File Generator box, the top-most source name will be used for the target name. Files can be removed from the list or moved up in the list by means of the right arrow or Main button (which are displayed when a file is highlighted).
20 – other dir PopForm
Use the Other Directory Selection box to specify the other directory from which source files should be listed.
20.1 – other dir FilSelB
Enter the other directory to list from.
21 – cmslib PopForm
Use the CMS Library Selection box to specify the CMS library from which source files should be fetched.
21.1 – cmslib FilSelB
Enter the directory of the CMS Library.
22 – objlib PopForm
Use the Select Object Library box to specify the object library to be included in the LINK command in the generated description file. Object files from the build compilations are inserted in this object library. If the value for the object library is defined in the current context, the dialog box will reflect the context value. If no object library is indicated when the Generate button is clicked, the object library will default to MMS$OLB.OLB.
22.1 – objlib FilSelB
Enter the name of the object library to be used in the LINK command of the generated description file.
23 – linklib PopForm
Use the Select Additional Link Libraries dialog box to specify the additional object libraries to be included in the LINK command in the generated description file. If the value for additional link libraries is defined in the current context, the dialog box will reflect the context value.
23.1 – add lib Lst
The Additional Link Libraries list box specifies the possible list of additional link libraries that will be included in the LINK command of the generated description file. The OK button must be clicked for the list to be saved. Files are added to the list from the right-hand list box. Files can be removed from the list by means of arrow button (which is displayed when a file is highlighted).
23.2 – lib all Btn
Click on this button to move all the files listed in the right-hand list box to the left-hand list box.
23.3 – lib left arrow Btn
Click on this button to move the highlighted file from the right-hand list box to the left-hand list box.
23.4 – lib up arrow Btn
Click this button to move the highlighted file to the top of the left-hand list box.
23.5 – lib right arrow Btn
Click this button to remove the highlighted file from the left-hand list box.
23.6 – sel lib Lst
The Additional Link Libraries Selection list box specifies the list of
additional link libraries to choose from to add to the left-hand list box.
By default, the list will contain files with the file type .OLB which are
found in the current default directory.
If there are Additional Link Libraries defined for the current context, they
will be reflected when the dialog box come up, and they will take precedence
over the default initialization.
Files can be moved to the left-hand list in three ways:
o double-click on a file specification
o highlight a file specification, then click on the left arrow button
o click on the All button, which will move all the files from the
right-hand box to the left-hand box
23.7 – lib filter Txt
The filter is used to specify a mask to filter which file names are listed. Click on the Filter button to filter the selection box list.
23.8 – lib Radio
Click on one of the sources areas in the Source radio box to specify where the files listed in the selection list box should come from. You can go from directory to directory to list selection files from.
23.9 – lib context dir Tgl
Click on this button to indicate that sources should be listed from the default directory specified for the current context.
23.10 – lib curr dir Tgl
Click on this button to indicate that sources should be listed from the current default directory.
23.11 – lib other dir Tgl
Click on this button to indicate that sources should be listed from a specified directory. The field to the right is used to specify the other directory to list from.
23.12 – lib other dir Btn
Click on Other Directory... to open a dialog box for specifying the directory to list from.
23.13 – lib other dir Txt
Use this field to specify the directory to list from.
23.14 – linklib ok Button
Click on the button to save the current Additional Link Libraries List for any subsequent description file generation.
23.15 – linklib cancel Button
Click on the button to cancel the current Additional Link Libraries List settings.
23.16 – linklib reset Button
Click on the button to reset the dialog box settings to the way they were when the box was entered.
23.17 – linklib filter Button
Click on the button to apply the filter mask defined in the Filter field to the specified directory, and the appropriate object library files are listed in the Selection list box.
23.18 – linklib help Button
Use the Additional Link Libraries dialog box to specify any additional object libraries that should be included in the LINK command generated by the automatic description file generator. The right-hand list box contains a list of the possible library files to choose from to insert into the Additional Link Libraries List. Initially, the selection list box lists all the .OLB files in the current default directory. But, there is the option of picking a different directory to list the files from. These options are available by clicking the corresponding radio button. Any file in the right-hand list box that is double-clicked is inserted into the left-hand list box. The left arrow button can also be used for moving a file from the right-hand box to the left-hand box. Clicking the All button will move all the libraries listed in the right-hand box to the left-hand box. Library files can be removed from or up in the left-hand list by means of arrow buttons (which are displayed when a file is highlighted). If there are Additional Link Library settings defined for the current context, they will be reflected when the dialog box come up. If the /LINK_LIBRARY qualifier has been specified when invoking MMS/GENERATE, the dialog box will reflect the qualifier values, and they will take precedence over the context settings.
24 – lib other dir PopForm
Use the Other Directory Selection box to specify the other directory from which additional link library files should be listed.
24.1 – lib other dir FilSelB
Enter the other directory to list from.
25 – optfil PopForm
Use the Select Options Files dialog box to specify the user-written options files to be included in the LINK command in the generated description file. If the value for options files is defined in the current context, the dialog box will reflect the context value.
25.1 – opt Lst
The Options Files list box specifies the possible list of options files that will be included in the LINK command of the generated description file. The OK button must be clicked for the list to be saved. Files are added to the list from the right-hand list box. Files can be removed from the list by means of arrow button (which is displayed when a file is highlighted).
25.2 – opt all Btn
Click on this button to move all the files listed in the right-hand list box to the left-hand list box.
25.3 – opt left arrow Btn
Click on this button to move the highlighted file from the right-hand list box to the left-hand list box.
25.4 – opt up arrow Btn
Click this button to move the highlighted file to the top of the left-hand list box.
25.5 – opt right arrow Btn
Click this button to remove the highlighted file from the left-hand list box.
25.6 – sel opt Lst
The Options Files Selection list box specifies the list of options files
to choose from to add to the left-hand list box.
By default, the list will contain files with the file type .OPT which are
found in the current default directory.
If there are Options Files defined for the current context, they will be
reflected when the dialog box come up, and they will take precedence
over the default initialization.
Files can be moved to the left-hand list in three ways:
o double-click on a file specification
o highlight a file specification, then click on the left arrow button
o click on the All button, which will move all the files from the
right-hand box to the left-hand box
25.7 – opt filter Txt
The filter is used to specify a mask to filter which file names are listed. Click on the Filter button to filter the selection box list.
25.8 – opt Radio
Click on one of the sources areas in the Source radio box to specify where the files listed in the selection list box should come from. You can go from directory to directory to list selection files from.
25.9 – opt context dir Tgl
Click on this button to indicate that sources should be listed from the default directory specified for the current context.
25.10 – opt curr dir Tgl
Click on this button to indicate that sources should be listed from the current default directory.
25.11 – opt other dir Tgl
Click on this button to indicate that sources should be listed from a specified directory. The field to the right is used to specify the other directory to list from.
25.12 – opt other dir Btn
Click on Other Directory... to open a dialog box for specifying the directory to list from.
25.13 – opt other dir Txt
Use this field to specify the directory to list from.
25.14 – optfil ok Button
Click on the button to save the current Options Files List for any subsequent description file generation.
25.15 – optfil cancel Button
Click on the button to cancel the current Options Files List settings.
25.16 – optfil reset Button
Click on the button to reset the dialog box settings to the way they were when the box was entered.
25.17 – optfil filter Button
Click on the button to apply the filter mask defined in the Filter field to the specified directory, and the appropriate options files are listed in the Selection list box.
25.18 – optfil help Button
Use the Options Files dialog box to specify any options files that should be included in the LINK command generated by the automatic description file generator. The right-hand list box contains a list of the possible options files to choose from to insert into the Options Files List. Initially, the selection list box lists all the .OPT files in the current default directory. But, there is the option of picking a different directory to list the files from. These options are available by clicking the corresponding radio button. Any file in the right-hand list box that is double-clicked is inserted into the left-hand list box. The left arrow button can also be used for moving a file from the right-hand box to the left-hand box. Clicking the All button will move all the libraries listed in the right-hand box to the left-hand box. Library files can be removed from or up in the left-hand list by means of arrow buttons (which are displayed when a file is highlighted). If there are Options Files settings defined for the current context, they will be reflected when the dialog box come up. If the /OPTIONS_FILE qualifier has been specified when invoking MMS/GENERATE, the dialog box will reflect the qualifier values, and they will take precedence over the context settings.
26 – opt other dir PopForm
Use the Other Directory Selection box to specify the other directory from which options files should be listed.
26.1 – opt other dir FilSelB
Enter the other directory to list from.
27 – Information Info
28 – Warning Warn
29 – Error Err
30 – Working Work
This box comes up when a description file is being loaded into the Description File area. It gives the user the option of canceling the operation, if it is taking too long.
31 – Message MsgBox