Previous Topic: Syntax DiagramNext Topic: YFLTDBFLST (Filter Database List)


Parameters

Parameter

Definition

Value and Description

RQSDTA

Request data to execute upon each item in the specified object list. The request string can be up to 256 characters long (see below for further details). To invoke the command prompter on the request string, place a ? as the first character in the request data.

  • *USROPT: (default) Use the user option specified by the USROPT parameter

USROPT

Two character user-defined option identifying a record in the specified user-defined option file, containing user option text for substitution in the RQSDTA string

  • *NONE: (default) No user-defined option text is to be substituted

OPTFIL

Qualified name of file containing the user-defined option text

  • QAUOOPT: (default) File name

OPTMBR

Name of member containing the user option text

  • *FILE:(default) The member has the same name as the file

OBJLST

Qualified name of Synon/1E object list which is to be executed

  • QTEMP/TEMPLST: (default) Object list name
  • *SELECT: Display object lists for selection

FLAGVAL

Flag value of list entries to select for execution

  • *ANY: (default) Execute all list entries
  • Otherwise, FLAGVAL is a list parameter made up of the following two elements:
  • Relational operator for selection of flags
  • *EQ: (default) Equal to
  • *NE: Not equal to
  • Flag value
  • Single character flag value or one of the special flag values

ERRLVL

Number of execution errors allowed before the list execution is abandoned

  • *NONE:(default) No errors are allowed
  • *NOMAX: There is no limit on the number of errors allowed
  • Note that execution does not take place if syntax errors are detected in the request string

UPDLST

List update option

  • *NONE: (default) The list is not to be updated.
  • Otherwise, UPDLST can be up to two of the following:
  • *RMVOK: If the requested command completes without error for a list entry, then the list entry is removed from the list.
  • *RMVERR: If an error occurs when the requested command is executed upon a list entry, then the list entry is removed from the list.
  • *FLAGERR: If an error occurs when the requested command is executed upon a list entry, then the list entry is to be flagged with the flag specified by the OUTFLAGVAL parameter.
  • *FLAGOK: If the requested command completes without error for a list entry, then the list entry is flagged with the flag specified by the OUTFLAGVAL parameter.
  • If more than one value is specified, *RMVERR + *FLAGOK and *RMVOK + *FLAGERR are the only valid combinations

OUTFLAGVAL

Flag value to be given to flagged entries when the UPDLST parameter is *FLAGERR or *FLAGOK

  • Single character flag value or one of the special flag values