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.
In addition to these options, you can use the PARM option to identify a list of records to be marked. To use the PARM option, you specify a character string of record numbers in a parameter expression. The parameter expression can contain:
  • Individual record numbers, separated by commas.
  • Ranges of record numbers, with the low and high numbers separated by a colon.
The whole parameter expression must end with a period.
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:
  1. 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.
  2. 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.
  3. 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.


eyup1a7.html | Timestamp icon Last updated: Sunday, 4 June 2017