>>-PERFORM--SET--ACTION(data-value)-----------------------------> .-ALL-------------------. >--+-----------------------+--+-----------+---------------------> +-CURRENT---------------+ '-NOREFRESH-' +-FILTER(cpsm-token)----+ +-MARKED----------------+ +-NOTFILTER(cpsm-token)-+ +-NOTMARKED-------------+ '-POSITION(data-value)--' >--+-------------------------------+----------------------------> '-NOWAIT--+-------------------+-' '-TOKEN(data-value)-' >--+--------------------------------------+---------------------> '-PARM(data-area)--PARMLEN(data-value)-' >--RESULT(cpsm-token)--THREAD(cpsm-token)--RESPONSE(data-ref)---> >--REASON(data-ref)--------------------------------------------><
This command performs an action on one or more resources as represented by resource table records in an existing result set. If the context and scope in effect when you issue a PERFORM SET command include CICS® systems that do not support the requested action, the request is ignored for those CICS systems.
LOCATE, MARK, PERFORM OBJECT, SET, SPECIFY FILTER
For a description of the actions that are valid for a given resource table, see the CICSPlex® System Manager Resource Tables Reference.
The cpsm-token value that identifies a filter is returned by the SPECIFY FILTER command.
If you do not specify the NOREFRESH option, the resource table records are refreshed to reflect the resource status after this operation is complete.
The cpsm-token value that identifies a filter is returned by the SPECIFY FILTER command.
If you specify the NOWAIT option, you must use a subsequent RECEIVE command to test for the completion of this request. The results of an asynchronous request are returned as ASYNCREQ resource table records. For a complete description of asynchronous processing, see CICSPlex System Manager Application Programming Guide.
For details on how to use a parameter expression with the PERFORM SET command, see CICSPlex System Manager Application Programming Guide. For a description of the parameters that are required for a given resource table action, see the CICSPlex System Manager Resource Tables Reference.
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 perform the specified action on 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 PERFORM SET command. The description of each RESPONSE includes a list of associated REASON values, if appropriate.