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

M.1.1 create

Function

This method creates an instance and stores parameters in instance variables used for socket connection.

Syntax

ShunSearch create (
   String   host_Name, /* (1) Host name                                 */
   int      port_No,   /* (2) Port number                               */
   String   Reserve2,  /* (3) Reserved (null)                           */
   String   strCode,   /* (4) Character encoding of data                */
   String   getCode    /* (5) Character encoding of returned result data*/
);

Return Value

The instance is returned if the function completes normally.

Parameters

(1) Host name

Specifies the host name of the server where the conductor (or director) is running.

If the conductor function is to be used, specify the host name of the server where the conductor will be running.

If the conductor is not to be used, specify the host name of the server where the director will be running.

(2) Port number

Specifies the port number of the conductor (or director).

If the conductor is used, specify the port number for receiving requests of the conductor in the system environment file.

If the conductor is not used, specify the port number for receiving requests of the director in the system environment file.

(3) Reserved

Specify null.

(4) Character encoding of data

Specifies the character encoding of the data:

Setting	Meaning
UTF-8	UTF-8
GB2312	GB2312 (for Chinese language)
big5	big5 (for Chinese language)
KSC5601	KSC5601 (for the Hangul alphabet (Korean))

The XML document specified when the ShunSearch class method runs is converted to the character encoding specified in this parameter, and then passed to Shunsaku.

Refer to M.3 Character Encoding for details on character code conversion.

(5) Character encoding of returned result data

Specifies the character encoding of the returned search result data:

Setting	Meaning
UTF-8	UTF-8
GB2312	GB2312 (for Chinese language)
big5	big5 (for Chinese language)
KSC5601	KSC5601 (for the Hangul alphabet (Korean))

Search result data is converted to the character encoding specified by this parameter and returned to the application. Refer to M.3 Character Encoding for details on character code conversion.

Exceptions

ShunException

This is output when the parameter value is invalid.

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