Remove Directory Server Inst (RMVDIRINST)

The Remove Directory Server Instance (RMVDIRINST) command is used to remove a Directory Server instance. The user database library and change log library can be specified to be removed, and the instance configuration library is removed, and also the configuration and schema files for the instance are removed. The server instance can be created by running the Add Directory Server Instance (ADDDIRINST) command.

Restrictions:

• You must have all object (*ALLOBJ) and input/output system configuration (*IOSYSCFG) special authorities to use this command.

Parameters

Instance (INSTANCE)

Specifies the name of the Directory Server instance to be removed.

This is a required parameter.

QUSRDIR

This is the system default Directory Server instance.

name

Specify a Directory Server instance name. The name has a minimum of one character and a maximum of eight characters.

Delete instance libraries (DLTLIB)

Specifies whether to delete the user database and change log libraries for the Directory Server instance to be removed.

*NO

Do not delete the user database and change log libraries.

*YES

Delete the user database and change log libraries.

Examples

Example 1: Remove the Instance But Keep the Instance Libraries

RMVDIRINST  INSTANCE(MYINST1)
            DLTLIB(*NO)

This command is used to remove the Directory Server instance named 'MYINST1'. The libraries for the user database and change log for the instance are not removed.

Example 2: Remove the Instance and the Instance Libraries

RMVDIRINST  INSTANCE(MYINST1)
            DLTLIB(*YES)

This command is used to remove the Directory Server instance named 'MYINST2'. The libraries for the user database and change log for the instance are also removed.

Error messages

*ESCAPE Messages

GLD0276

Server instance &1 cannot be deleted while the server is in use.

GLD0215

Directory server instance &1 not found.

GLD021C

The caller of the API must have &1 and &2 special authority to configure the server.