>>-UNMARK--| records_group |--+-----------------+---------------> '-COUNT(data-ref)-' >--+-----------------------------------+--RESULT(cpsm-token)----> '-INTO(data-area)--LENGTH(data-ref)-' >--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 removes the marks placed on resource table records by a previous MARK command. The UNMARK command always begins processing with the last record that was fetched, rather than the next one in the result set.
LOCATE, MARK
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 UNMARK request (in the event that none of them can be unmarked). 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 UNMARK command:
The cpsm-token value that identifies a filter is returned by the SPECIFY FILTER command.
The parameter expression for the UNMARK 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 UNMARK 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 unmark the fifth resource table record in a result set, you would specify POSITION(5).
The following is a list of the RESPONSE values that can be returned by the UNMARK command. The description of each RESPONSE includes a list of associated REASON values, if appropriate.