>>-GET--OBJECT(data-value)--+-----------------+-----------------> '-COUNT(data-ref)-' >--+-----------------------------------------+------------------> +-CRITERIA(data-area)--LENGTH(data-value)-+ '-FILTER(cpsm-token)----------------------' >--+--------------------------------------+---------------------> '-PARM(data-area)--PARMLEN(data-value)-' >--+-------------------------------+--+---------------------+---> '-NOWAIT--+-------------------+-' '-CONTEXT(data-value)-' '-TOKEN(data-value)-' >--+-------------------+--RESULT(cpsm-token)--------------------> '-SCOPE(data-value)-' >--THREAD(cpsm-token)--RESPONSE(data-ref)--REASON(data-ref)----><
This command returns a result set containing selected resource table records.
Resource table | Attribute value | CICS Environment |
LOCTRAN | RESSEC(RESSECEXT) | CICS/MVS |
DISCARD, FETCH, GETDEF, QUERY, RECEIVE, REFRESH, SPECIFY FILTER, SPECIFY VIEW
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 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 GET command, see CICSPlex System Manager Application Programming Guide. For a description of the parameters that can be specified for a given resource table, 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.
If the current context (as set by this command or a previous CONNECT or QUALIFY command) is a CICSplex and the OBJECT option identifies a CICS resource, a valid scope is required. The scope can be:
If the current context is a CMAS or the OBJECT option identifies any other type of resource table this option has no meaning and is ignored.
If you do not specify the SCOPE option, the default scope for the thread is assumed. If the current context is a CICSplex and no default scope has been set on a CONNECT or QUALIFY command, you receive an INVALIDPARM response for the SCOPE option.
The following is a list of the RESPONSE values that can be returned by the GET command. The description of each RESPONSE includes a list of associated REASON values, if appropriate.
If only some of the CMASs or MASs did not
respond, the GET can still yield a valid result. COUNT might be greater than
zero and RESULT might be non-zero. Such a result set contains data from those
CMASs and MASs that did respond.