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

N.1 shunadd

Function

Adds the XML document specified in the input parameter to Shunsaku.

Syntax

#include         "libshun.h"
int     shunadd(
           char     *host_Name,      /* in  (1) Host name              */
           int      Port_No,         /* in  (2) Port number            */
           int      DataArray_Cnt,   /* in  (3) Number of arrays for   */
                                     /*         additional data        */
           char     **DataArray      /* in  (4) Area for arrays for    */
                                     /*         additional data        */
);

Return Value

The error code reported by this function is returned.

Value '0' is returned if the function completes normally.

The validity of the returned result cannot be guaranteed if a value other than '0' is returned.

Refer to N.7 Error Codes Output for details on error codes.

Parameters

(1) Host name

Specify the host name or IP address of the server where the conductor is running.

The host name can be up to 24 bytes long.

(2) Port number

Specify the MySearchPort parameter in the conductor environment file.

(3) Number of arrays for additional data

Specify the number of data arrays for storing the additional XML documents.

Specify a value of 1 or greater.

(4) Area for arrays for additional data

Pointers to the areas where the additional XML documents are stored are set in each array. Specify pointers to these arrays.

[Figure N-1 Area for Arrays for Additional Data]

• Store at least one XML document in each area for additional data. Refer to 11.2.3.1 Adding Data for more information on the format of the XML documents that are stored in these data areas.
• A conductor is required to use this function.