dnicli

Purpose

Use this program to start the CLI to issue operation and administration commands.

Format

Parameters

-i instance

The name of the instance where the command is to be processed. The default is the value of the environment variable DNI_I. If DNI_I is not set, -i must be specified.

-ou ou

The identifier of the OU for which the command is to be processed. The default is the value of the environment variable DNI_OU. If DNI_OU is not set, -ou must be specified.

-s service

The name of the service. This service is addressed when the command is entered. The default is the value of the environment variable DNI_S. If DNI_S is not set, -s must be specified.

-tl

The trace level, which determines the type of information recorded in the trace for the CLI:

Error: Only error information is recorded in the trace.
Warning: Error and warning information is recorded in the trace.
Informational: Informational, error, and warning information is recorded in the trace.
Debug: The maximum amount of information is recorded in the trace.

The default is the value of the environment variable DNI_TL. If DNI_TL is not set, the default trace level is Warning.

-to timeout

The timeout interval that the CLI waits for responses before it prints an error message. The timeout interval is in milliseconds per command. The default is the value of the environment variable DNI_TO. If DNI_TO is not set, the default is 20000 milliseconds (20 seconds) per command.

-fmt

Whether date and time formatting is to be activated or reactivated. The default is the value of the environment variable DNI_FMT. If DNI_FMT is not set, date and time formatting is activated.

-c "command_name"

The command that is to be processed. When you specify this parameter, the CLI program processes the command in a single-command mode.

parm

The name of a parameter of the command to be issued. This parameter might correspond to a parameter definition set, that is, a parameter whose value comprises a set of parameters.

value

The value of a parameter. If this value contains a space, it must be enclosed in quotation marks.

parm_def_set

A set of parameters and their values, enclosed in parentheses. This can be specified only if the corresponding parameter requires a value in this form.

-cf command_file

A plain text file containing a list of commands that are to be issued sequentially. When you specify this parameter, the CLI program processes the command file in non-transactional command-file mode.

Examples

This example illustrates the single-command mode. The following command initializes the CLI settings and issues a cre (create) command.

dnicli -i INST1 -ou SYSOU -s DNI_SECADM -c "cre -ro Approver"

This example illustrates the multi-command mode. First you must set the necessary parameters by entering:

dnicli -i INST1 -ou BANKA -s DNI_SECADM

You can then type in commands, such as:

ac -user JSMITH -ou BANKA -par(-ct DniSecAdm.com -co DniSecAdm.com -attr user)

This example illustrates the command-file mode. The following command initializes the CLI settings and processes the command file with the name CMDFILE3.CLI.

dnicli -i INST1 -ou BANKA -s SERVICENAME -cf CMDFILE3.CLI