Run the Lister Accessory

Use the following procedure for running the Lister Accessory to produce a database layout report. You can run the Lister Accessory at any time.

To run the Lister Accessory

  1. Using CANDE or another editor, open the sample Lister Accessory parameter file (DATA/LISTER/SAMPLE/CONTROL).
  2. Save the sample parameter file as follows:

    DATA/LISTER/databasename/CONTROL

    where databasename is the name of the database or logical database from which you plan to create the report.

  3. Edit the new Lister Accessory parameter file (DATA/LISTER/databasename/CONTROL), and set report options. See Lister Accessory Parameter File for an explanation of each option.
  4. Start the Lister Accessory using the following syntax.

    Note: For a description of the Lister Accessory WFL runtime options, see Lister Accessory WFL.

    START WFL/DATABRIDGE/LISTER ("databasename")

    — or —

    START WFL/DATABRIDGE/LISTER ("databasename", "logicaldatabasename")

    The logicaldatabasename parameter provides a means for having multiple parameter files for the same database. If logicaldatabasename is the name of a logical database within the databasename database, the Lister Accessory uses that logical database. Otherwise, it simply uses the logicaldatabasename as a way to specify an alternate parameter file (DATA/LISTER/databasename/logicaldatabasename/CONTROL). Lister Accessory then creates a report, which it directs to a printer file.

  5. Print or view the report generated by the Lister Accessory. By default it is named as follows:

    DBBD/RUN/LISTER/databasename

    — or —

    DBBD/RUN/LISTER/logicaldatabasename

    For an example and explanation of this report, see Lister Accessory Report.

    Example:

    The following command:

    START WFL/DATABRIDGE/LISTER ("(PROD)INVENTORY ON DEVPACK")

    indicates that the Lister Accessory should use the following file:

    (PROD)DESCRIPTION/INVENTORY ON DEVPACK

    The Lister printer file will be named as follows:

    DBBD/RUN/LISTER/INVENTORY/=