Parameter
|
Definition
|
Value and Description
|
SRCFILE
|
Qualified generic name of source file or files which are to be scanned
|
- *LIBL/Q*: (default) Value
- *MBRLST: Use the named member list to obtain source member names
|
SRCMBR
|
Generic name of source members to scan
|
- *ALL: (default) Search all source members
|
SELN
|
A list of up to ten search elements. Each element in the list is made up of the following seven fields
|
- The logical operation for combining this element with other elements.
- *IF: (default) Only valid for the first element
- *AND: This element combines with the previous element(s) in an *OR group
- *OR: This element starts a new *OR group
- Search mask: Up to 21 characters. Can contain any character. Lower case characters should be enclosed in quotes, for example, ‘qtxt’. The mask may contain the wild card character specified by the WILDCHAR parameter.
- *BLANK: (default) Scan for blank characters
- *ANY: All source records are selected. This option normally is used in combination with the SCNCHGDTE parameter
- Length of search mask
- *LEN: (default) Use search mask up to last non-blank
- 1-21: Use specified length
- Case-Sensitive option
- *YES: (default) Treat upper and lower case characters as different for comparison purposes
- *NO: Ignore differences between upper and lower case for comparison purposes. Thus a search mask value of ‘a’ is matched with both a and A
|
|
|
- True/False option
- *TRUE: Search mask must be in the line
- *FALSE: Search mask must NOT be in the line
- Starting column at which to begin search
- 1: (default) Value
- 1-80: Start scanning at this column
- Ending column for search.
- 80: (default) value.
- 1-80: stop scanning at this column
|
SCNCHGDTE
|
Source change date for which to scan. Only records which meet the specified date criteria (in addition to any search criteria specified by the SELN parameter) is selected
|
- *NONE: (default)Do not scan for source change dates
- Otherwise, SCNCHGDTE is a list parameter made up of the following two elements:
- Relational operator for selection of changed source records
- – *EQ: (default) Scan records which were changed on a specified date
- – *GT: Scan records which were changed after a specified date
- – *LT: Scan records which were changed before a specified date
- – Source change date for which to scan in QDATFMT format
|
WILDCHAR
|
Character used as a dummy in any search mask; will match any character during the scan
|
|
FLAGVAL
|
Flag value of list items to be processed
|
- *ANY: (default) Scan all items in list
- Otherwise, FLAGVAL is a list parameter which is used to determine whether the list item will be scanned. It is 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
|
SCAN
|
Scan stop option: denotes whether to stop scanning a specific member after finding a line which satisfies the search conditions
|
- *ALL: (default) Scan and print all lines
- *FIRST: Stop after finding one instance of the search string in the member
|
EXITPGM
|
Qualified name of exit program to be called for user- defined override of match selection
|
- *NONE: Do not call an exit program
|
OUTPUT
|
Print option
|
- *PRINT: (default) Print a report of lines found
- *NONE: Do not print a report
|
UPDMBRLST
|
Update member list option
|
- *NO: (default) Do not update the member list
- *YES: Update the member list by removing members which do not contain the search string. This is equivalent to *RMVERR.
- Or up to two of the following values:
- *FLAGERR: (default) If a member does not contain the specified search string, then its list entry is to be flagged with the value specified by the OUTFLAGVAL.
- *FLAGOK: If a member does contain the specified search string, then its list entry is to be flagged with the value specified by the OUTFLAGVAL
- *RMVERR: If a member does not contain the specified search string, then its list entry is to be removed from the list (equivalent to *YES)
- *RMVOK: If the member does contain the specified search string, then its list entry is to be removed from the list
- If more than one value is specified, *RMVERR + *FLAGOK and *RMVOK + *FLAGERR are the only valid combinations
|
MBRLST
|
Qualified name of a member list
|
- QTEMP/TEMPLST: (default) List name
|
EDIT
|
List edit option
|
- *NO:(default) No editing is required
- *YES: Invoke the edit member list function to edit the list before executing the scan
|
OUTFLAGVAL
|
Flag value to be given to selected items in resulting list if UPDMBRLST is *FLAGOK or *FLAGERR
|
- Single character flag value or one of the special flag values
|
OUTLST
|
Qualified name of member list to which selected entries are copied
|
- *NONE: (default) Selected list entries are not copied to an output list
- QTEMP/TEMPLSTOUT: Default output list name
|
OUTLSTOPT
|
Output list replacement option for the list specified by the OUTLST parameter
|
- *REPLACE: (default) Creates a new output list, replacing any previous list’s contents
- *ADD: Add to any existing list’s contents
|