LIST

Controls the location and name of the detail listing file, which includes items such as source listings, completion status, error messages and execution statistics.

Note: Supported by all mfims imsdbu functions.

Syntax:

>>-.---.-.-------LIST--(filespec)--.-----><
   +-/-+ +.----.-LIST--------------+
          +-NO-+

Parameters:

filespec: The name and location to use for the listing file. filespec can include a drive and/or directory if required. If you do not specify a drive or directory, MFIMS or IMSDBU creates the listing file in the current directory.

Properties:

Default:

LIST(*.LST)

Comments:

NOLIST suppresses the creation of the listing file.

To specify a path, you can use the convention of placing a dollar sign ($) in front of the name of an environment variable that represents a path. For example, LIST($ENVVAR\*.DOC) creates a list file of dbdname.DOC in the directory named by the ENVVAR environment variable.

Specifying LIST(*.LST) or LIST(*.RPT) causes the listing file to be created in the project listing directory. If no path is specified, the listing file is created in the current directory.

Specifying LIST is equivalent to specifying LIST(*.LST).

If you specify the basename of filespec as an asterisk (*) it is replaced by the DBD name; this allows IMSDBU to provide separate reports for functions which can operate on multiple databases, such as Reorganize. It also assists in maintaining historical detailed reports by DBD name.