The FREE_SEARCH_RESULTS call
The FREE_SEARCH_RESULTS call releases all storage held by the SEARCH_LDAP function. The search results are terminated and the search token is invalidated. If the application does not call the FREE_SEARCH_RESULTS function, it is invoked by CICS® when the task is terminated.
FREE_SEARCH_RESULTS
DFHDDAPX [CALL],
[CLEAR],
[IN,
FUNCTION(FREE_SEARCH_RESULTS),
SEARCH_TOKEN(name4),]
[OUT,
[LDAP_RESPONSE(name4),]
RESPONSE(name1 | *),
REASON(name1 | *)]
This command is threadsafe.
- LDAP_RESPONSE(name4)
- specifies the return code that is sent by the LDAP API.
- SEARCH_TOKEN(name4)
- the name of the fullword token that is returned by the SEARCH_LDAP function.
RESPONSE and REASON values for FREE_SEARCH_RESULTS
| RESPONSE | REASON |
|---|---|
| OK | None |
| EXCEPTION | INVALID_TOKEN |
| DISASTER | None |
| INVALID | None |
| KERNERROR | None |
| PURGED | None |
Note: For more detail, refer to the explanation of RESPONSE and REASON
in Making an XPI call.