MIISClearRunHistory

MIISClearRunHistory clears the management agent run histories from the MIIS 2003 server up to a specified date. The tool provides an option for saving the run histories to a text file before deleting them from the MIIS 2003 server. Used without parameters, MIISClearRunHistory will prompt the user before deleting all run histories from the MIIS 2003 server.

Syntax

miisclearrunhistory [/d:MM-DD-YYY [/t:HH:MM[:SS]]] [/s:Servername[/u:[Domain\]Username [/p:Password]]] [/f Filename] [/l:Loglevel]

Parameters

/d:Date

Specifies the date of the latest run history that will be deleted from the server. Runs after this specified date will be preserved. The date format may be mm-dd-yyyy or mm/dd/yyyy. If the date is not specified, the current date will be used.

/t:Time

Specifies the time of the latest run history for the specified date in the /d: switch. It should be specified in 24 hour format - HH:MM:SS. If the /d: parameter is specified without the /t: parameter then the Time parameter is automatically set to midnight of that date as "00:00:00."

/pr:Preserve days

Specifies the number of days to preserve run histories. If the /d: parameter is specified, then the /pr: parameter is ignored.

/s:Server name

Specifies the MIIS 2003 server name where the management agent history is to be deleted. If the parameter is not specified then the local MIIS 2003 server will be accessed.

/u:User name

Specifies the user name used to authenticate to the specified MIIS 2003 server. If MIISClearRunHistory is run on the MIIS 2003 server, it will ignore the /u: parameter and use the default credentials. The user needs to be a member of the MIISAdmins security group to delete a run history.

/p:Password

Specifies the password for the user account used to authenticate to the MIIS 2003 server. If MIISClearRunHistory is run on the MIIS 2003 server, it will ignore the /u: parameter and use the default credentials. If the user name is specified but the password is not, MIISClearRunHistory will prompt for the password.

/f Filename

Specifies that data from the run histories is saved to a plain text file before deleting the run histories from the MIIS 2003 server. The data will be saved to the file name and path specified. If the file name is not specified then the data will be saved to a file named MIISClearRunHistoryMMDDYYYYHHMMSS.txt in the current working folder, where MMDDYYYYHHMMSS equals the values of the date and time parameter.

/l:Loglevel

Specifies the message, warning, and error logging level. The possible values are:

• 1 – Logs messages, warnings, and errors.
• 2 – Logs warnings and errors.
• 3 – Logs errors only.

The log file will be created in the current working directory with the name MIISClearRunHistory.log.

/y

Suppresses the warning prompt that is otherwise displayed when MIISClearRunHistory is run without any parameters.

/?

Displays help at the command prompt.

Remarks

• Management agent run history data contains Name, RunProfile, RunStatus, RunStartTime, RunEndTime, and RunNumber.
• MIISClearRunHistory can be run either on a local server with MIIS 2003 installed or from a remote system by specifying the MIIS 2003 server name and user credentials.

Examples

To clear the run histories up to and including midnight, December 2, 2003, type the following command:

miisclearrunhistory /d:12-02-2003

To clear the run histories up to the current MIIS 2003 server date and time, type the following command:

miisclearrunhistory

To clear the run histories from a remote MIIS 2003 server MIIS-1 specifying the user name and password, type the following command:

miisclearrunhistory /s:MIIS-1 /u:MIISuser /p:MIISpwd

To clear the run histories from a remote MIIS 2003 server by specifying the domain server name and domain user name, type the following command:

miisclearrunhistory /d:12/12/2003 /s:MIISdomain/MIIS-1 /u:MIISdomain/MIISuser

To specify the IP address for the MIIS 2003 server name and prompt for the password, type the following command:

miisclearrunhistory /d:12/12/2003 /s:208.147.66.254 /u:208.147.66.254/MIISuser

To save the deleted run histories to the savehistory.txt file in c:\MIIShistory folder, type the following command:

miisclearrunhistory /d:01-08-2003 /t:10:30:45 /f c:\MIIShistory\savehistory.txt /l:2

To save the log information miisclearrunhistory.log, to the savehistory.txt file in c:\MIIShistory folder, type the following command:

miisclearrunhistory /d:10-10-2003 /t:18:10:10 /s:MIIS-1 /u:MIISuser /f c:\MIIShistory\savehistory.txt /l:1

To save the deleted run histories to a network path by using the default file name, type the following command:

miisclearrunhistory /d:10-10-2003 /t:18:10:10 /s:RemoteServer /u:RemoteUser /f \\RemoteServer\RunHistory /l:1

MIISClearRunHistory errors and warnings

Common command-line errors and warnings