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:
Writes an informational message to the end of the current log files
Repeats the steps it executed at startup
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.