idscfgchglg

Use the idscfgchglg command to configure a change log for a directory server instance.

Description

The idscfgchglg command configures a change log for a directory server instance. The change log is a database that is created in the same database server instance as the instance database. The change log entry is added to the ibmslapd.conf file of a directory server instance. A change log requires only the directory server instance name for which it is configured. A change log uses the database instance name that is associated with the directory server instance and creates a database in the same database instance. Before you run this command, ensure that a database instance with the same name as the directory server instance must exist. Also, create a database for a directory server instance. On UNIX and Linux® systems, the local loopback service must be registered in the /etc/services file.

Note: Use the idsicrt command or the idsxinst utility to create a database instance.

You can optionally specify the maximum number of entries to keep in the change log and the maximum age of the entries before it is removed. If you do not specify any options, the entries in the change log never expire and is stored in the change log. A maximum of 1,000,000 entries can be stored in the change log.

Synopsis

idscfgchglg [-I instancename [-m maxentries] [-y maxdays] [-h maxhours]
            [-f configfile] [-d debuglevel] [-b outputfile] [-q] [-n]] | 
            -v | -?

Options

The idscfgchglg takes the following parameters.

-b outputfile: Specifies the full path of a file to redirect console output. If you use this parameter with the -q parameter, errors are sent to the outputfile file. If the debug mode is set, the debug output is also sent to this file.
-d debuglevel: Sets the LDAP debug level to debuglevel. If you specify this parameter, it sends the debug output to stdout. The debuglevel value is a bit mask that controls which output is generated with values from 1 to 65535. For more information about debug levels, see Debugging levels.
-f configfile: Specifies the full path to the configuration file that is to be updated. If this option is not specified, the default configuration file for the directory server instance is used.
-h maxhours: Specifies the maximum duration in hours to keep entries in the change log. This parameter can be used with the -y maxdays to specify the maximum age of a change log entry.
-I instancename: Specifies the directory server instance name for which to configure change log.
-m maxentries: Specify the maximum number of entries to keep in the change log. If 0 is specified, it indicates that there is no limit on the number of entries.
-n: Specifies to run no prompt mode. All output from the command is generated, except for messages that require user interaction. Use this parameter with the -w parameter.
-q: Specifies to run in quiet mode. All output from the command is suppressed, except for error messages. If you specify the -d parameter also, then the trace output is not suppressed.
-y maxdays: Specifies the maximum duration in days to keep the entries in the change log. If 0 is specified, it indicates that there is no age limit on entries in the change log. You can use this parameter with -h maxhours to specify the maximum age of a change log entry.
-v: Specifies to show the version information of the command.
-?: Specifies to show the syntax help.

Examples

Example 1:

To configure a change log with no age limit or size limit, run the following command:

idscfgchglg –m 0

Example 2:

To configure a default change log with a size limit of 1,000,000 and an entry age of 25 hours, run the following command:

idscfgchglg –y 1 –h 1

Note: After you configure the change log, the -y, -h, and -m parameters can be used to update the maximum age and size of the entries in the change log.