Computer - Hibernate

Declaration

<AMCOMPUTER ACTIVITY="hibernate" WAKEDELAY="number" MEASURE="text (options)" FORCE="YES/NO" />

Description: Powers down the computer while retaining its state.

Practical Usage

When used to save power, hibernation is similar to sleep mode and saves more power at the cost of slower resumption. hibernation is a means of avoiding the burden of saving unsaved data before shutting down and restoring all running programs after powering back on.

General Parameters

Property

Type

Required

Default

Markup

Description

Wake up

 

 

 

 

If enabled, specifies that a wake up delay or specific wake up time should be set after the computer goes into hibernation. This is a visual mode parameter used during design time, therefore, contains no markups.

After this delay

Number

No

 

WAKEDELAY="5"

If enabled, specifies the amount of time that should elapse after the computer goes into hibernation before it should automatically resume normal operation (enabled by default). If this parameter is enabled, the At this time parameter becomes inactive.

Wake Measure

Text (options)

No

Minutes

  1. MEASURE="milliseconds"

  2. MEASURE="seconds"

  3. MEASURE="minutes"

  4. MEASURE="hours"

Specifies the time measurement that should correspond with the numeric value entered under the After this delay parameter. The available options are:

  • Milliseconds - The value specified in the After this delay parameter is measured in milliseconds.

  • Seconds - The value specified in the After this delay parameter is measured in seconds.

  • Minutes - The value specified in the After this delay parameter is measured in minutes.

  • Hours - The value specified in the After this delay parameter is measured in hours.

At this time

Number

No

current time

WAKETIME="122236"

If enabled, denotes that the computer should wake up from hibernation at the time specified (disabled by default). If this parameter is enabled, the After this delay parameter becomes inactive.

Ignore step if specified time has passed

Yes/No

No

No

IGNOREWHENLATE="YES"

If set to YES, the step will be ignored if the time specified in the At this time parameter has already passed. Set to NO by default.

Message to display in the shut down dialog box

Text

No

(Empty)

MESSAGE="Please begin to panic now"

A user-defined message that windows should display on the restart notification dialog. This parameter is active only if the Prompt user to log off parameter is set to YES. The message will be displayed for the number of seconds, minutes or hours specified in the Shutdown after  parameter.

Note: Due to operating system limitations this parameter is not supported on Windows 95/98/ME systems.

Force hibernate (do not send permission request to applications)

Yes/No

No

No

FORCE="YES"

If set to YES, specifies that the computer should hibernate immediately without notifying and waiting for applications to return a message that they are ready to close.

Description tab - A custom description can be provided on the Description tab to convey additional information or share special notes about a task step.

Error Causes tab - Specify how this step should behave upon the occurrence of an error. (Refer to Task Builder > Error Causes Tab for details.)

On Error tab - Specify what AWE should do if this step encounters an error as defined on the Error Causes tab. (Refer to Task Builder > On Error Tab for details.)

Examples

The sample AML code below can be copied and pasted directly into the Steps panel of the Task Builder.

Description: Set computer in hibernate mode.  System will wake up after 12 Hours. Hibernate system immediately without requesting permission to running applications.

<AMCOMPUTER ACTIVITY="hibernate" WAKEDELAY="12" MEASURE="hours" FORCE="YES" />