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

Setting List Flag Values

Toolkit List Processing and Generic commands set list flag values. This may be either:

• Implicit - some of the Toolkit generic commands automatically set flags to indicate whether items have been processed successfully or not. For example, the Toolkit command Move Member (YMOVM) flags the list entries for any members which it failed to move, with a *FAILMBR status.
• Explicit - On other Toolkit generic commands you may use the OUTFLAGVAL parameter optionally to specify a flag value to be given to particular items. You must also specify a value of *FLAGOK or *FLAGERR for the UPDLST parameter to indicate the circumstances under which the flag is to be set.

For example, on the Toolkit command Filter Object List (YFLTOBJLST) you could specify that items which meet the filter criteria are to be given a particular flag value:

YFLTOBJLST TEXT(‘USRPGM’) OUTFLAGVAL(*ON) UPDLST(*FLAGOK)

Similarly, you could use the Toolkit command Scan Source (YSCNSRC) specifying that items which meet the search criteria are to be given a particular flag value:

YSCNSRC SELN(*IF ‘QCAEXEC’ *FALSE’)  UPDMBRLST(*FLAGERR) OUTFLAGVAL(‘X’)