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

N.2 shundeletebyrecid

Function

Deletes the XML document corresponding to the record identifier in the input parameter.

Syntax

#include         "libshun.h"
int     shundeletebyrecid(
       char     *host_Name,    /* in  (1) Host name                      */
       int      Port_No,       /* in  (2) Port number                    */
       int      Request_Cnt,   /* in  (3) Number of deletion requests    */
       char     **cond_ctl,    /* in  (4) Conductor control information  */
                               /*         area                           */
       char     **rec_ID       /* in  (5) Deleted record identifier area */
);

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 deletion requests

Specify the number of data items to delete.

(4) Conductor control information area

Use the following procedure to set up the conductor control information area.

1. Allocate a conductor control information area equal to the length specified in COND_CTL_LEN in libshun.h. Set the conductor control information obtained with shunsearch2.
2. Allocate a pointer array with as many elements as the number of deletion requests.
3. Assign the conductor control information pointers allocated in Step 1 above to each element of the pointer array.
4. Assign the pointer array pointers allocated in Step 2 above to the conductor control information area.

[Figure N-2 Conductor Control Information Area]

(5) Deleted record identifier area

Use the following procedure to set the deleted record identifier area.

1. Allocate a deleted record identifier area equal to the length specified in ROW_ID_LEN in libshun.h. Set the reply record identifiers obtained with shunsearch2.
2. Allocate a pointer array with as many elements as the number of deletion requests.
3. Assign the deleted record identifier pointers allocated in Step 1 above to each element of the pointer array.
4. Assign the pointer array pointers allocated in Step 2 above to the deleted record identifier area.

[Figure N-3 Deleted Record Identifier Area]

A conductor is required to use this function.