Expanded Parameter Definitions › LSTOPT Parameter

LSTOPT Parameter

In many of the commands that manipulate lists, either an existing list can be added to, or a new list can be created. The list update option (LSTOPT) parameter denotes which. It may have the following values:

• REPLACE: A new list is to be created, replacing any existing list of the same name in the specified library.
• ADD: If a list of the same name and type already exists in the specified library it will be added to. If the list does not exist an error message is sent. Entries that already exist in the target list are not added or replaced.

The LSTOPT parameter can be used to build up lists from a number of sources, and to merge lists. For instance, the following two commands would result in a list of all programs in QGPL whose names begin with either AB or CD:

YBLDOBJLST OBJ (QGPL/AB) OBJTYPE (PGM) LSTOPT (REPLACE)

YBLDOBJLST OBJ (QGPL/CD) OBJTYPE (PGM) LSTOPT (ADD)