Build file list

20% Command group 20% Flag affected 20% Reversible 20% Execute on client 20% Platform(s)
Files YES YES NO All

Syntax

Build file list ([Clear list])

Options

20% 80%
Clear list If specified, the command empties the current list, and defines it to have a single hash variable column, before executing

Description

This command builds a list containing the name of each file class in the current library. The list is built in the current list for which you must specify the following columns.

50% Column 1 (Character) 50% Column 2 (Character)
File name Description for file (if you have entered one)

When you use the Clear list option you get column 1 only defined as #S5. With this option the command becomes reversible, that is, the original contents of the list are restored. The flag is cleared if the number of lines in the list exceeds LIST.$linemax.

Example

# Build a list of file classes in the current library
Set current list lFileList
Build file list (Clear list )
# alternatively $makelist can be used
Do $files.$makelist($ref.$name) Returns lFileList