Edit

PwrTest ProcessIdle Scenario

  • Article

The PwrTest ProcessIdle Scenario forces background maintenance tasks to run (now rather than at their scheduled time) and monitors their progress.

Syntax

pwrtest /processidle [/t:n] [/?]

/t:n
Specifies the maximum time (in minutes) for the scenario to run, after which the wait is aborted, even if idle tasks are continuing to run (default is to run until all tasks are completed).

Examples

pwrtest /processidle  

pwrtest /processidle  /t:30

XML log file output

<PwrTestLog>
  <SystemInformation>
  </SystemInformation>
  <ProcessIdle> 
    <JobStart>
      <Timestamp></Timestamp>
      <TaskName></TaskName>
    </JobStart>
    <JobEndSuccess>
      <Timestamp></Timestamp>
      <TaskName></TaskName>
    </JobEndSuccess>
    <JobEndFailure>
      <Timestamp></Timestamp>
      <TaskName></TaskName>
    </JobEndFailure>
    <JobEndTermination>
      <Timestamp></Timestamp>
      <TaskName></TaskName>
    </JobEndTermination>
    <JobCompletionPending>
      <Timestamp></Timestamp>
      <TaskName></TaskName>
    </JobCompletionPending>
    <IdleTaskRegister>
      <Timestamp></Timestamp>
      <TaskName></TaskName>
      <ProcessId></ProcessId>
    </IdleTaskRegister>
    <IdleTaskUnregister>
      <Timestamp></Timestamp>
      <TaskName></TaskName>
      <ProcessId></ProcessId>
    </IdleTaskUnregister>
    <IdleTaskStart>
      <Timestamp></Timestamp>
      <TaskName></TaskName>
      <ProcessId></ProcessId>
    </IdleTaskStart>
    <IdleTaskStop>
      <Timestamp></Timestamp>
      <TaskName></TaskName>
      <ProcessId></ProcessId>
    </IdleTaskStop>
    <IdleTaskNotifyStart>
      <Timestamp></Timestamp>
      <TaskName></TaskName>
      <ProcessId></ProcessId>
    </IdleTaskNotifyStart>
    <IdleTaskNotifyComplete>
      <Timestamp></Timestamp>
      <TaskName></TaskName>
      <ProcessId></ProcessId>
    </IdleTaskNotifyComplete>
    <OtherProcessIdleTasksCallsInProgress>
      <Timestamp></Timestamp>
    </OtherProcessIdleTasksCallsInProgress>
  </ProcessIdle>
</PwrTestLog>

The following table describes the XML elements that appear in the log file.

Element Description
<ProcessIdle>

Contains all the different process idle events. Only one <ProcessIdle> element in a PwrTest log file.
<Timestamp>

Time stamp of any given event.
<TaskName>

Name of idle task.
<ProcessID>

Process ID of idle task.
<JobStart>

Event indicates a job started.
<JobEndSuccess>

Event indicates a job finished successfully.
<JobEndFailure>

Event indicates a job failed.
<JobEndTermination>

Event indicates a job was terminated early.
<JobCompletionPending>

Event indicates a job completion is still pending.
<IdleTaskRegister>

Event indicates an idle task was registered.
<IdleTaskUnregister>

Event indicates an idle task was unregistered.
<IdleTaskStart>

Event indicates an idle task started.
<IdleTaskStop>

Event indicates an idle task has stopped.
<IdleTaskNotifyStart>

Event indicates a process has invoked idle tasks.
<IdleTaskNotifyComplete>

Event indicates a process is finished invoking idle tasks.
<OtherProcessIdleTasksCallsInProgress>

Event indicates another process called the ProcessIdleTasks function in the background. Note that Pwrtest calls the ProcessIdleTasks function that is exported by advapi32.dll.

PwrTest Syntax