>>-PERFORM--OBJECT(data-value)--ACTION(data-value)--------------> >--+-----------------+------------------------------------------> '-COUNT(data-ref)-' >--+-----------------------------------------+--+-----------+---> +-CRITERIA(data-area)--LENGTH(data-value)-+ '-NOREFRESH-' '-FILTER(cpsm-token)----------------------' >--+-------------------------------+----------------------------> '-NOWAIT--+-------------------+-' '-TOKEN(data-value)-' >--+--------------------------------------+---------------------> '-PARM(data-area)--PARMLEN(data-value)-' >--+---------------------+--+-------------------+---------------> '-CONTEXT(data-value)-' '-SCOPE(data-value)-' >--RESULT(cpsm-token)--THREAD(cpsm-token)--RESPONSE(data-ref)---> >--REASON(data-ref)--------------------------------------------><
This command performs an action on one or more resources.
DISCARD, GET, LOCATE, PERFORM SET, QUERY, 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.
If you do not specify the CONTEXT option, the default context for the thread is assumed.
For details on how to form a filter expression, see CICSPlex System Manager Application Programming Guide.
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.
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 OBJECT 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.
If this field is:
CICSPlex SM creates a new result set and returns its identifying token in the same field.
To use the SCOPE option, the current context (as set by this command or a previous CONNECT or QUALIFY command) must be a CICSplex. The scope can be:
If the current context is a CMAS, this option has no meaning and is ignored.
If you do not specify the SCOPE option, the default scope for the thread is assumed.
The following is a list of the RESPONSE values that can be returned by the PERFORM OBJECT command. The description of each RESPONSE includes a list of associated REASON values, if appropriate.
Use the FEEDBACK command without the RESULT option to obtain information about the error that occurred during the building of the result set. Use the FEEDBACK command with the RESULT option to obtain information about records that caused the TABLEERROR or DATAERROR response or reason.