DB2 Version 9.7 for Linux, UNIX, and Windows

db2LdapUpdateAlternateServerForDB API - Update the alternate server for the database on the LDAP server

Updates the alternate server for a database in Lightweight Directory Access Protocol (LDAP).

Authorization

Read/write access to the LDAP server.

Required connection

None

API include file

db2ApiDf.h

API and data structure syntax

SQL_API_RC SQL_API_FN
  db2LdapUpdateAlternateServerForDB (
   db2Uint32 versionNumber,
   void * pParmStruct,
   struct sqlca * pSqlca);

typedef SQL_STRUCTURE db2LdapUpdateAltServerStruct
{
   char *piDbAlias;
   char *piNode;
   char *piGWNode;
   char *piBindDN;
   char *piPassword;
} db2LdapUpdateAltServerStruct;

db2LdapUpdateAlternateServerForDB API parameters

versionNumber: Input. Specifies the version and release level of the structure passed as the second parameter pParmStruct.
pParmStruct: Input. A pointer to the db2LdapUpdateAltServerStruct structure.
pSqlca: Output. A pointer to the sqlca structure.

db2LdapUpdateAltServerStruct data structure parameters

piDbAlias: Input. A string containing an alias for the database to be updated.
piNode: Input. A string containing the alternate node name. This node name must exist in LDAP.
piGWNode: Input. A string containing the alternate gateway node name. This node name must exist in LDAP. This is used by the IBM® Data Server Runtime Client to connect to the host via the gateway.
piBindDN: Input. Specifies the user's LDAP distinguished name (DN). The user's LDAP DN must have sufficient authority to create and update objects in the LDAP directory. If the user's LDAP DN is not specified, the credentials of the current user will be used.
piPassword: Input. Account password.