New dircmd2 command-line tool for IBM Director 4.1

Published 25 July 2003

Authors: David Watts


With IBM Director 4.x, a command-line tool called dircmd lets you issue commands to the IBM Director management server from a command prompt. This serves as an alternative to the GUI-based management console and lets you incorporate IBM Director tasks into scripts for automation and integration.

However, the dircmd tool requires that you specify the server name, and a superuser ID and password as part of the command line, leading to a potential security exposure. To eliminate this exposure, IBM has provided a tool, dircmd2, for your use “as is”.


Dircmd2 is a replacement for dircmd and does not need the server name and superuser ID/password as parameters. Instead, the command can only be run from the management server in a session logged in by a user with superuser privileges. All other parameters are identical.

Download this utility by clicking the following link:

Note: This ZIP contains another tool that lets you create a report of the tables in the IBM Director 4.1 database. For information about this tool, see

To install the tool on your IBM Director Server system, do the following:

  1. Download the ZIP file to your IBM Director Server system and unpack it.
  2. Review the readme file.
  3. Stop IBM Director. On Windows, use net stop twgipc. On Linux, use twgstop.
  4. Copy the files in the ZIP to the appropriate directories as described in the readme file. If newer versions of these files exist, do not overwrite them unless instructions in the readme file say otherwise.
  5. Restart IBM Director (on Windows, use net start twgipc. On Linux, use twgstart) or restart the server.

The ZIP contains two versions of the dircmd command:
  • dircmd2 is the Linux version
  • dircmd2.bat is the Windows version

As an example of its use, here are the same listgroups command using the standard dircmd and the replacement dircmd2 commands:

dircmd -s -u userid -p password listgroups
dircmd2 listgroups

Note: The user ID you are logged on with must be a member of the dirsuper group to run the dircmd2 command.

Special Notices

This material has not been submitted to any formal IBM test and is published AS IS. It has not been the subject of rigorous review. IBM assumes no responsibility for its accuracy or completeness. The use of this information or the implementation of any of these techniques is a client responsibility and depends upon the client's ability to evaluate and integrate them into the client's operational environment.

Follow IBM Redbooks

Follow IBM Redbooks