----^--->
/\

//\\
//The\
/Sy
stem\
////
Guard
\

In the mount of the LORD it shall be seen. Genesis 22:14

WAITFOR

Booming Or Fuming? | MasterCatalog | ntlib (FREE) | NTCmdLib | MtCmds | Scripts | Almost Free | TheGuardBook | Help

 

Library
Resources

Constants | Functions | GlobalSwitches | GuardNotes | Command Shorthand | MountCommands | Procedures
Functions   CENTER | DEQUOT | ESC | FCOUNT | LEN | PAD | SCOUNT | SEQNUM | WAITFOR

$WAITFOR (Wait for a specified time)

Description

Waits for the requested time (with screen updates), then executes an [optional] command.

Syntax

At the Command Prompt (library IS NOT initialized)

C:\>NTCmdLib $WAITFOR WaitTime RefreshInterval ["Command/Program"]

At the Command Prompt (library IS initialized)

C:\>L $WAITFOR WaitTime RefreshInterval ["Command/Program"]

In a Script (library IS NOT initialized)

CALL NTCmdLib $WAITFOR WaitTime RefreshInterval ["Command/Program"]

In a Script (library IS initialized)

%.Call% $WAITFOR WaitTime RefreshInterval ["Command/Program"]

Parameters and Switches

WaitTime   How long to wait (in minutes).
RefreshInterval   How often to update the console status message (in minutes)
"[Command/Program]"   Optional Command or Program to execute after waiting.  If no Command/Program is specified, a default of .Rem will be executed.

Errorlevels, Output Variables and Custom Mount/\Commands

Name

 

Value

  Description/Contents

_WAITFOR

 

string

  Text message indicating Success or Failure

 

ErrorLevel

 

Description/Contents

0

  Success

2

  Missing or invalid parameter

Examples, Notes and Instructions

Example 1 - Start a batch file after two hours, updating the console every 30 minutes

C:\GuardPost>NTCmdLib $WAITFOR 120 30 "DailyBackup.cmd"

  ^   =========================================================================
 /!\   NTCmdLib.cmd 2003.04.24 NT/2K/XP/K3 ("Almost Freeware" at $9 or less!)
/LIB\ =========================================================================
 

[Thu 04/24/2003 18:00:00] 120 minute(s) left...
[Thu 04/24/2003 18:30:00] 90 minute(s) left...
[Thu 04/24/2003 19:00:00] 60 minute(s) left...
[Thu 04/24/2003 19:30:00] 30 minute(s) left...
[Thu 04/24/2003 20:00:00] WAITFOR Completed.
{DailyBackup.cmd starts here}

Example 2 - Display a message after five minutes, updating the console each minute

C:\GuardPost>NTCmdLib $WAITFOR 5 1 "ECHO:We're movin' on!"

  ^   =========================================================================
 /!\   NTCmdLib.cmd 2003.04.24 NT/2K/XP/K3 ("Almost Freeware" at $9 or less!)
/LIB\ =========================================================================\
 

[Thu 04/24/2003 14:47:24] 5 minute(s) left...
[Thu 04/24/2003 14:48:24] 4 minute(s) left...
[Thu 04/24/2003 14:49:24] 3 minute(s) left...
[Thu 04/24/2003 14:50:24] 2 minute(s) left...
[Thu 04/24/2003 14:51:24] 1 minute(s) left...
[Thu 04/24/2003 14:52:24] WAITFOR Completed.
We're movin' on!


C:\GuardPost>SET _WAITFOR
_WAITFOR=Waited for about 5 minutes as requested.

Notes

  • Output is displayed to STDOUT, errors to STDERR
  • To suppress console display, use the library GlobalSwitch /Quiet (or simply /q)

    NTCmdLib /Q TaskID /TaskSwitches Parameters

    CALL NTCmdLib /Q TaskID /TaskSwitches Parameters

    %.Call% /Q TaskID /TaskSwitches Parameters


Related .Mount/\Commands, #Constants, $Functions, :Procedures

Resource

  Short Description
     

K

E

Y

Common Commands INTERNAL External /SWITCH Parameter Help text AddonTool
Mounted Commands .Mount/\Command CmdShorthand #Constant $FUNCTION :Procedure !GuardNote
Operating Systems NT/2K/XP/K3 NT Only NT/2K 2K Only 2K/XP XP Only XP/K3 K3 Only 2K/XP/K3

Functions   CENTER | DEQUOT | ESC | FCOUNT | LEN | PAD | SCOUNT | SEQNUM | WAITFOR

/\
//\\
//
The\
/Sy
stem\
////
Guard
\
COME ON UP WITH US!
and
Congratulations On Your Decision
to
RISE ABOVE
THE REST!

^
/
!\
/LIB\

TheSystemGuard.com [Revised: 2007-03-29]
Copyright 1995-2007, JWC
Computer Communications,
All Rights Reserved, Worldwide.
 Disclaimer       Privacy       About Us       More


Communication Is Business!

We Master It With Knowledge!

^
/
.\
/M^C\