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.


dfha3_xpi_dd_free_search.html | Timestamp icon Last updated: Monday, 5 June 2017