Using CICSPlex SM tokens
Many of the CICSPlex SM API commands are interrelated; you use them in conjunction with each other to accomplish the objectives of your program. For example, you issue a GET command to build a result set and then issue a FETCH command to access the resource table records in that result set.
To correlate the results of various operations with subsequent
requests that you make, CICSPlex SM assigns
4-byte tokens to the following objects of the API environment:
- Processing threads
- Result sets
- Filters
- Views
- LISTEN requests.
Note:
- CICSPlex SM assigns a token to views for internal use only. Externally, you refer to a view by the name which you assigned to it.
- There is a limit to the number of CICSPlex SM tokens available to each processing thread. In general, the number of result sets, filters, views, and LISTEN requests created on a processing thread cannot exceed 255.
Token values are not only unique for individual objects, but the structure of the tokens varies by object type. So a thread token cannot be mistaken by CICSPlex SM for any other type of token. If you specify an invalid token (such as, a result set token on the FILTER option), you receive a RESPONSE value of INVALIDPARM.