IBM Books

Administrative API Reference

sqledreg - Deregister

Deregisters the DB2 server from a network file server. The DB2 server's network address is removed from a specified registry on the file server.

Authorization

None

Required Connection

None

Version

sqlenv.h

C API Syntax 



/* File: sqlenv.h */
/* API: Deregister */
/* ... */
SQL_API_RC SQL_API_FN
  sqledreg (
    unsigned short Registry,
    void * pRegisterInfo,
    struct sqlca * pSqlca);
/* ... */

Generic API Syntax 



/* File: sqlenv.h */
/* API: Deregister */
/* ... */
SQL_API_RC SQL_API_FN
  sqlgdreg (
    unsigned short Registry,
    void * pRegisterInfo,
    struct sqlca * pSqlca);
/* ... */

API Parameters

Registry
Input. Indicates where on the network file server to deregister the DB2 server. In this release, the only supported registry is SQL_NWBINDERY (NetWare file server bindery, defined in sqlenv).

pRegisterInfo
Input. A pointer to the sqle_reg_nwbindery structure. In this structure, the caller specifies a user name and password that are valid on the network file server. For more information about this structure, see SQLE-REG-NWBINDERY.

pSqlca
Output. A pointer to the sqlca structure. For more information about this structure, see SQLCA.

REXX API Syntax

This API can be called from REXX through the SQLDB2 interface. See How the API Descriptions are Organized, or the Application Development Guide. For a description of the syntax, see the Command Reference.

Sample Programs

C
\sqllib\samples\c\regder.c

COBOL
\sqllib\samples\cobol\regder.cbl

FORTRAN
\sqllib\samples\fortran\regder.f

Usage Notes

When Registry has a value of SQL_NWBINDERY, this API uses the NetWare user name and password supplied in the sqle_reg_nwbindery structure to log onto the NetWare file server (FILESERVER) specified in the database manager configuration file. The object name (OBJECTNAME) specified in the database manager configuration file is deleted from the NetWare file server bindery.

The NetWare user name and password specified must have supervisory or equivalent authority.

This API must be issued locally from the DB2 server. It is not supported remotely.

If the IPX/SPX fields are reconfigured, or the DB2 server's IPX/SPX internetwork address changes, deregister the DB2 server from the network file server before making the changes, and then register it again after the changes have been made.

See Also

sqleregs - Register.

[ Top of Page | Previous Page | Next Page | Table of Contents | Index ]

[ DB2 List of Books | Search the DB2 Books ]