FLAGVAL, OUTFLAGVAL, and UPDLST Parameters

Expanded Parameter Definitions › FLAGVAL, OUTFLAGVAL, and UPDLST Parameters

FLAGVAL, OUTFLAGVAL, and UPDLST Parameters

The FLAGVAL parameter controls which items in a list are processed. When a list command is executed with the FLAGVAL parameter specified, only those items with the specified value in the flag field are processed. The others are ignored.

The FLAGVAL parameter is a simple list made up of two terms:

Relational operator: (EQ/NE) To specify whether the associated flag value is or is not to be selected.
Flag value: Value upon which to select

A single value of ANY is allowed for the FLAGVAL parameter.

Examples:

Select all items with a flag value other than F:

YFLTOBJLST FLAGVAL (NE FAIL)

Process all items with a flag value of U:

YEXCOBJLST FLAGVAL (EQ ‘U’)

Process all items:

YEXCOBJLST FLAGVAL (ANY)

The following table lists special flag values with equivalent flag values.

Special Value	Flag Storage Value
BLANK	"
ON	‘Y’
NULL	‘0’, ‘1"
FAILOBJ	‘O’
FAILMBR	‘M’
FAIL	‘F’
SUBMITTED	‘S’
PRESENT	neither ‘1’ nor ‘0’

Note: Values are stored in the century byte field as set by i OS DSPxxx commands with OUTFILE specified; therefore both 0 and 1 are valid values for *NULL. When NULL is specified as FLAGVAL, items with either 0 or 1 are selected.