Identifying the records to be marked
By default, when you issue a MARK or UNMARK command, only the current resource table record is marked or unmarked.
But there are a variety of ways that you can identify the records to be marked:
- To mark a specific record other than the current record, use the POSITION option and identify the record by its relative position in the result set.
- To mark one or more records that meet previously defined filtering criteria, use the FILTER or NOTFILTER option.
- To mark all the records in a result set, use the ALL option.
- Individual record numbers, separated by commas.
- Ranges of record numbers, with the low and high numbers separated by a colon.
For example, to mark records 1, 3, 6 through 9, and 24 in a result set, you would specify:
PARM('1,3,6:9,24.')
When you use the PARM option, you must also use the PARMLEN option to specify the length of the buffer that contains the parameter expression.
Note:
- Negative values and 0 are not valid record numbers. If you specify an invalid record number, the MARK (or UNMARK) command returns RESPONSE and REASON values of INVALIDPARM PARM.
- If you mistakenly specify the higher value in a range first (such as 9:6), CICSPlex SM reverses the values to produce a valid range.
- If you mistakenly specify a single value preceded or followed by a colon (such as 6:), the colon is ignored. CICSPlex SM marks only the specified record.