Previous Topic: Output ListsNext Topic: Flagging Lists

Programmer Utilities › Lists › Updating Lists › Output Lists and the UPDLST Parameter

Output Lists and the UPDLST Parameter

The UPDLST action always applies only to the output list. If no separate output list is specified, then the input list is effectively the output list as well. In either case the same logic is used: each item in the list is processed and then its list entry included or flagged into the output list according to the UPDLST parameter.

If an outlist is not specified, then for each item processed the input list will be updated according to any actions specified for the UPDLST parameter.

For example, if UPDLST(*RMVERR) is specified, those items for which an error occurred on processing will be removed from the list. Only the items which are successfully processed remain in the input list.

If an outlist is specified, then for each item processed the output list will be updated according to any actions specified for the UPDLST parameter.

For example, if UPDLST(*RMVERR) is specified, those items for which an error occurred on processing will be removed from further consideration: they will not be added to the output list. (If however they are already present in the output list they will not be removed from it). Only those items which are successfully processed are added to the output list.

The following table lists commands with the UPDLST parameter.

Command

UPDLST Value

None

UPDLST Value

FLAGERR

UPDLST Value

FLAGOK

UPDLST Value

RMVERR

UPDLST Value

RMVOK

OUTFLAGVAL

Ass/Opt

OUTFLAGVAL

Default
Value

YBLYxxxLST

 

 

A

A

 

O

Null

YFLTxxxLST

 

 

Y

Y

-(1)

O

On

YEXCxxxLST

Y

Y

Y

Y

Y

O

Fail

YCHKLSTE

 

Y

Y

Y

Y

O

On

YSCNSRC

-(2)

Y

Y

Y

Y

O

On

YCMPSRC

 

Y

Y

Y

Y

O

Fail

YCRTOBJ

 

Y

A

Y

Y

O

Fail (3)

YMOVOBJ

 

Y

A

Y

Y

A

FailOBJ

YMOVM

 

Y

 

Y

Y

A

FialMBR

YMOVOBJSR

 

Y

 

Y

Y

A

(4)

UPDLST

: A = Always assumed

: Y = Default, may be overridden

Y = Available

OUTFLAGVAL

:O = Optional, that is chosen value or *NULL

A = Always assumed, value cannot be changed