Interstage Shunsaku Data Manager Application Development Guide - Microsoft(R) Windows(R) 2000/ Microsoft(R) Windows Server(TM) 2003 - - UNIX -

M.1.3 executeSearch2

Function

This method performs a search according to the specified parameters and obtains the search result.

Syntax

void executeSearch2(
    String  Query,           /* (1) Search expression               */
    int     Reply_No,        /* (2) Reply start number              */
    int     Request_Cnt,     /* (3) Number of reply requests        */
    String  Return,          /* (4) Return expression               */
    String  Reserve1         /* (5) Reserved (null)                 */
);

Return Value

None.

Parameters

(1) Search expression

Specify the search expression using Unicode.

Ensure that the size of the search expression is between 1 and 65,535 bytes inclusive.

Refer to B.3 Search Expressions for details on search expressions.

(2) Reply start number

Specifies the reply start number.

Specifies from which item of found data to commence retrieval. Specify a number greater than zero.

(3) Number of reply requests

Specifies the number of reply requests.

Specify the maximum number (at least one) of items to be obtained as a search result.

If the specified value exceeds the maximum number of responses to client requests, the number of items to be returned will be restricted to this maximum limit.

To find the maximum number of responses to client requests, refer to the AnsMax parameter in the conductor environment file (if a conductor is being used), or the AnsMax parameter in the director environment file (if a conductor is not being used).

(4) Return expression

Specify the return expression using Unicode.

Ensure that the size of the return expression is between 0 and 65,535 bytes inclusive.

Refer to B.4 Return Expressions for details on return expressions.

(5) Reserved

Specify null.

Exceptions

ShunException

This is output when an error occurs during the search process.

Refer to M.4 Error Codes Output for details on error codes.