The roll_log command is invoked through the dmctl utility, which requires that you attach to a Manager or adapter with administrative privileges. The syntax of the command is:

exec roll_log [<file-name>]

The <file-name> option enables you to specify a new name for current and subsequent log files. If you omit this option, the current naming convention is retained. If you specify a name, the new log file uses that name. Any new log files created with roll_log will also use this name if a different name is not specified. The new name specified by <file-name> is handled in exactly the same manner as the --output option of the sm_server command.

For example, on UNIX systems, the equivalent command is:

         
            BASEDIR/smarts
         /bin/dmctl -s MYDM exec roll_log

When roll_log is invoked, the Manager or adapter does the following:

  1. Writes an informational message to the end of the current log files

  2. Repeats the steps it executed at startup

  3. Creates a new log file and a backup log file for each log file that was currently running.

    All subsequent logging information is recorded to the new files.