Programmer Utilities › Lists › Flagging Lists › Using List Flag Values

Using List Flag Values

List flag values may be used to control processing on most of the Toolkit generic commands, which allow the specification of an existing list. In general, only the list items having the specified flag value will be processed by the command.

For example, on the Toolkit command Execute Object List (YEXCOBJLST) you might specify that only those items with a flag value of A are to be processed - the others are ignored. If an error occurs when an item is processed then it will be removed from the list.

YEXCOBJLST FLAGVAL(‘A’) RQSDTA(‘DSPOBJD @L/@O @T’) UPDLST(*RMVERR)

In the special case of the Filter List commands (YFLTxxxLST), items that do not satisfy the flag value may be subject to further processing (depending on the UPDLST parameter).

For example, the following command will remove, from the list, all items that do not have a flag value of A.

YFLTOBJLST FLAGVAL(‘A’) UPDLST(*RMVERR)

The following table shows which Toolkit list commands support the use of flag values. Note that for some commands the use and value of an output flag value is automatically assumed.

O = Optional A = Assumed