>>-MARK--| records_group |--+-----------------+-----------------> '-COUNT(data-ref)-' >--+-----------------------------------+--+-------+-------------> '-INTO(data-area)--LENGTH(data-ref)-' '-RESET-' >--RESULT(cpsm-token)--THREAD(cpsm-token)--RESPONSE(data-ref)---> >--REASON(data-ref)-------------------------------------------->< records_group .-CURRENT------------------------------. |--+--------------------------------------+---------------------| +-ALL----------------------------------+ +-FILTER(cpsm-token)-------------------+ +-NOTFILTER(cpsm-token)----------------+ +-POSITION(data-value)-----------------+ '-PARM(data-area)--PARMLEN(data-value)-'
This command marks selected resource table records in a result set.
COPY, DELETE, FETCH, GROUP, LOCATE, PERFORM SET, REFRESH, SET, SPECIFY FILTER, UNMARK
The cpsm-token value that identifies a filter is returned by the SPECIFY FILTER command.
This buffer must be long enough to hold the maximum number of record numbers that could result from your MARK request (in the event that none of them can be marked). Record numbers are listed individually (not by range) in the INTO buffer and are separated by commas.
The value that CICSPlex® SM returns in this field depends on the RESPONSE value for the MARK command:
The cpsm-token value that identifies a filter is returned by the SPECIFY FILTER command.
The parameter expression for the MARK command is a character string of record numbers. For example:
PARM('1,3,6:9,24.')
To specify individual records, separate the record numbers with a comma. To specify a range of records, separate the low and high record numbers with a colon. The whole parameter expression must end with a period.
For details on how to use a parameter expression with the MARK command, see CICSPlex System Manager Application Programming Guide.
This value must be a number that identifies the record’s relative position in the result set. The first record in a result set is identified by the number 1.
For example, to mark the fifth resource table record in a result set, you would specify POSITION(5).
If you do not use the RESET option, any records that you marked previously remain marked. That is, the records identified in the current MARK request are marked in addition to any previously marked records.
The following is a list of the RESPONSE values that can be returned by the MARK command. The description of each RESPONSE includes a list of associated REASON values, if appropriate.