A.2 Command Line Mode

The command line mode allows you to use script or batch files. Table A-8 lists the different options that are available.

To use the command line options, decide which items you want to use and string them together.

Example: dxcmd -user admin.headquarters -host 10.0.0.1 -password n0vell -start test.driverset.headquarters

This example command starts the driver.

Table A-8 Command Line Options

Option

Description

Configuration

 

-user <user name>

Specify the name of a user with administrative rights to the drivers you want to test.

-host <name or IP address>

Specify the IP address of the server where the driver is installed.

-password <user password>

Specify the password of the user specified above.

-port <port number>

Specify a port number, if the default port is not used.

-q <quiet mode>

Displays very little information when a command is executed.

-v <verbose mode>

Displays detailed information when a command is executed.

-s <stdout>

Writes the results of the dxcmd command to stdout.

-? <show this message>

Displays the help menu.

-help <show this message>

Displays the help menu.

Actions

 

-start <driver dn>

Starts the driver.

-stop <driver dn>

Stops the driver.

-getstate <driver dn>

Shows the state of the driver as running or stopped.

-getstartoption <driver dn>

Shows the startup option of the driver.

-setstartoption <driver dn> <disabled|manual|auto> <resync|noresync>

Sets how the driver starts if the server is rebooted. Sets whether the objects are to be resynchronized when the driver restarts.

-getcachelimit <driver dn>

Lists the cache limit set for the driver.

-setcachelimit <driver dn> <0 or positive integer>

Sets the cache limit for the driver.

-migrateapp <driver dn> <filename>

Processes an XML document that contains a query command.

Create the XML document that contains a query command by using the Novell nds.dtd.

-setshimpassword <driver dn> <password>

Sets the application password. This is the password of the user account you are using to authenticate into the connected system with.

-clearshimpassword <driver dn> <password>

Clears the application password.

-setremoteloaderpassword <driver dn> <password>

Sets the Remote Loader password.

The Remote Loader password is used to control access to the Remote Loader instance.

<clearremoteloaderpassword <driver dn>

Clears the Remote Loader password.

-sendcommand <driver dn> <input filename> <output filename>

Processes an XDS command document.

Specify the XDS command document as the input file.

Examples:

NetWare: sys:\files\user.xml

Windows: c:\files\user.xml

Linux: /files/user.log

Specify the output filename to see the results.

Examples:

NetWare: sys:\files\user.log

Windows: c:\files\user.log

Linux: /files/user.log

-sendevent <driver dn> <input filename>

Submits a document to the driver’s Subscriber channel, bypassing the driver cache. The document is processed ahead of anything that might be in the cache at the time of the submission. It also means that the submission fails if the driver is not running.

-queueevent <driver dn> <input filename>

Submits a document to the driver’s Subscriber channel by queuing the document in the driver cache. The document is processed after anything that might be in the cache at the time of the submission. The submission won’t fail if the driver isn’t running.

-setlogevents <dn> <integer ...>

Sets Novell Audit log events on the driver. The integer is the option of the item to log. See Table A-6 for the list of the integers to enter.

-clearlogevents <dn>

Clears all Novell Audit log events that are set on the driver.

-setdriverset <driver set dn>

Associates a driver set with the server.

-cleardriverset

Clears the driver set association from the server.

-getversion

Shows the version of Identity Manager that is installed.

-initdriver object <dn>

Performs an internal initialization of data on a new Driver object. This is only for testing purposes.

-setnamedpassword <driver dn> <name> <password> [description]

Sets named passwords on the driver object. You specify the name, the password, and the description of the named password.

-clearnamedpassword <driver dn> <name>

Clears a specified named password.

-startjob <job dn>

Starts the specified job.

-abortjob <job dn>

Aborts the specified job.

-getjobrunningstate <job dn>

Returns the specified job’s running state.

-getjobenabledstate <job dn>

Returns the specified job’s enabled state.

-getjobnextruntime <job dn>

Returns the specified job’s next run time.

-updatejob <job dn>

Updates the specified job.

-clearallnamedpaswords<driver dn>

Clears all named passwords set on a specific driver.

If a command is executed successfully, it returns a zero. If the command returns anything other than zero, it is an error. For example, 0 means success, and -641 means invalid operation. -641 is an eDirectory error code. Table A-9 contains other values for specific command line options.

Table A-9 Command Line Option Values

Command Line Option

Values

-getstate

0- stopped

1- starting

2- running

3- shutting down

11- get schema

Anything else that is returned is an error.

-getstartoption

0- disabled

1- manual

2- auto

Anything else that is returned is an error.

-getcachelimit

0- unlimited

Anything else that is returned is an error.

-getjobrunningstate

0- stopped

1- running

Anything else that is returned is an error.

-getjobenabledstate

0- disabled

1- enabled

2- configuration error

Anything else that is returned is an error.

-getjobnextruntime

Returns the next scheduled time for the job in eDirectory time format (number of seconds since 00:00:00 Jan 1, 1970 UTC).