Home

About Us

Books

Free Stuff

Oh, So That's How It Works!

Fellow Magicians

Useful Links



Program

WWSLEEP

Version

1,0,1,0

Synopsis

Console Mode Batch File Timed Delay (Sleep) Program, to suspend a batch file or character mode script for a specified maximum number of seconds, to allow time for the user to read the output.

WizardWrx Logo

Syntax

WWSLEEP is a console program, with the following syntax.

          WWSLEEP.exe [-time -q -s]

Where:                   time  = Maximum time, in seconds, to sleep

Default = 30 seconds

Switches:       Q        = Quiet mode – suppress the countdown display

S        = Stop event, which must be one of the following

          c = CTRL-C

          r = Return (Enter) key

          cr = CTRL-C or Return (Enter) key

          rc = CTRL-C or Return (Enter) key

          Default = rc

WWSLEEP is intended to be run from a batch file or script, though it can, of course, be run directly from a command prompt.

Notes

¨              Switches may be specified in any order.

¨              Switches may be upper or lower case.

¨              Invalid switches are ignored and discarded. All errors are reported on the system console (STDOUT).

Description

Given a command line with no parameters, the following happens.

¨              The program waits for up to 30 seconds.

¨              If the CTRL-C or CTRL-BREAK key combination is pressed, the program stops the countdown, reports the actual time waited, and exits.

Quiet mode causes a silent countdown, which may be interrupted as described above.

The Stop event argument is a place holder. The actual value must be one of the four documented values, c, r, cr, or rc.

Installation

The WWSLEEP package consists of one stand alone executable file, WWSLEEP.exe, and a documentation file, WWSLEEP.pdf. Since the program is self contained, no formal installation is required. Copy the files into any convenient location, such as a directory on your MS-DOS path.

Support

This program is free software. As such, it comes without support or a warranty. Nevertheless, we shall entertain questions about its use, ways that we could improve it, or problems that you have had with it. We are especially interested in learning how people use it. You can reach us through this form, which sends email directly to our Chief Wizard, David Gray, who designed, created, and maintains this program.

License

This program is licensed under the GNU General Public License. Accordingly, all of the source code that went into its development is freely available, including the source code of a static link library. The source code comprises three archives, detailed in Table 1 below.

Location

Content

Program Source

Visual C++ Projects for WWSLEEP

P6CLIB1 Custom Function Library

Visual C++ Project for static library P6CLIB1

P6CLIB1 Header Files

C Header files for static library P6CLIB1

Table 1 - Source Code for WWSLEEP

This entire package, including the function library, was created using Microsoft Visual C++ 6.0, Service Pack 6, and supports Microsoft Windows 95 or later. Although it could be ported to UNIX, Linux, and other platforms that support ANSI C, I chose not to do so, so that I could use the library of C functions that I developed for internal use.

Revision History

Date

Version

Comment

2007/09/11

1.0.0.0

Initial, limited release.

2008/05/25

1.0.1.0

Fix formatting bug in countdowns > 10 seconds.

Copyright

This program is copyright 2007-2008, Simple Soft Services, Inc., d/b/a WizardWrx, Irving, Texas, USA. All rights reserved world wide.

The above copyright declaration applies to both the source and object forms of the programs, and to the functions from static link library P6CLIB1, regardless of whether they are used by WWSLEEP. To the extent that such copyright conflicts with the GPL, the terms of the GPL shall govern.

Availability

The latest version is always posted here.

Publisher Information

The publisher of this software is Simple Soft Services, Inc., d/b/a WizardWrx.

Address:

4835 North O'Connor Road

Suite 200

Irving TX 75062-2742

Phone:

+1 (817) 812-3041

Email:

support@wizardwrx.com

WWW:

www.wizardwrx.com


P6C Contact Info

Copyright and Legal Notice