Carlsberg Tools Documentation

From OS2World.com Wiki
Jump to: navigation, search

Contents

Preface

Package contents

This package contains the following files:

File Usage
CBTOOLS.INF This documentation.
TIME20.EXE The Date/time monitor.
SWAP20.EXE The Swap dataset size monitor.
FREE20.EXE The Disk freespace monitor.
COLOR20.DLL Common Color selection dialog.
SIZE20.DLL Common window size selection dialog.
FINDSWAP.DLL Initialization code for the Swap dataset size monitor (locates SWAPPER.DAT).

This package does not contain the following files:

File Usage
INSTALL.EXE The Carlsberg Tools (CB Tools) Install program.

Installation

Since no install program is supplied in this package, you need to go through the following steps to install the CB Tools programs:

  1. Create a directory for the CB Tools files.
  2. Copy all the CB Tools files to a separate directory.
  3. Create a folder on your workplace.
  4. Apply the CB Tools icon to the folder.
  5. Create program entries for the three .EXE files.
  6. Create a program entry for this .INF file (Program name = VIEW.EXE, parameters = CBTOOLS.INF).
  7. Create copies of the desired program entries in the autostart folder.
  8. Change LIBPATH= in CONFIG.SYS to include the directory holding the DLLs - or move the DLLs to a directory referenced by the LIBPATH= statement.

Note: If the LIBPATH= statement references '.', all programs will run.

Changes

Release 1.1

  • Programs converted from 16 to 32 bit.

Release 1.2

  • All programs uses COLOR20.DLL for the 'colors' dialog.
  • All programs uses SIZE20.DLL through the 'window size' option for customization of horizontal window size.
  • Part of the Swap dataset size monitor initialization code moved to FINDSWAP.DLL
  • Error corrections:
    • TIME20 didn't refresh window when text size changed at 2400 hours.
    • FREE20 was expanding downwards if bottom left corner was below the screen border.

Next release

Comming programs may be:

File Usage
INSTALL.EXE The Carlsberg Tools (CB Tools) Install program.
WRLD20.EXE The Worldwide local time monitor

Date/Time Monitor

Description

The Date / time monitor is a low CPU and low memory consuming program which displays the computer date and time in a small window on your workplace.

The window contains day of week, month, day and current time. The current time includes or excludes the seconds at your choise.

The Date / time monitor also contains a stop watch. Please refer to the Mouse buttons and Pop-up menu information windows for a detailed description.

Once a second the Date / time monitor window is forced on top of all other windows - the computer date and time is always visible.

Mouse buttons

Mouse button 1 is used for one of two features depending on your current Mouse button 1 Option setting:

  • If Move window is selected, you can move the Date / time monitor window to any spot on the workplace by:
  1. Position the mouse cursor over the Date / time monitor window.
  2. Press and hold down Mouse button 1.
  3. Move the window by moving the mouse.
  4. Release mouse button 1 at the prefered spot on the workplace.
  • If Stop watch is selected, the Stop watch control Options descripes how the stopwatch is operated:
    • If Down / up is selected, you operate the stop watch by:
    1. Position the mouse cursor over the Date / time monitor window.
    2. Press and hold down Mouse button 1 - the stop watch starts.
    3. Release mouse button 1 - the stop watch stops.
    • If Click is selected, you operate the stop watch by:
    1. Position the mouse cursor over the Date / time monitor window.
    2. Click Mouse button 1 - the stop watch starts.
    3. Click Mouse button 1 again - the stop watch stops.

Mouse button 2 is used to present a pop-up menu.

Simply position the mouse pointer over the Date / time monitor window and click Mouse button 2.

Note: The pop-up menu will not appear if the stop watch is running!

Pop-up menu

Options

Select this pop-up menu item to bring up a window with the available options.

Date / time display

Use this option to include or exclude the seconds when displaying the current time.

Mouse button 1

Use this option to select the action when using mouse button 1.

oIf Move window is selected, you can move the Date / time monitor window by:

1.Position the mouse cursor over the Date / time monitor window. 2.Press and hold down Mouse button 1. 3.Move the window by moving the mouse. 4.Release mouse button 1 at the prefered spot on the workplace.

oIf Stop watch is selected, you can start and stop the stop watch.

Please refer to the Stop watch control and Stop watch removal options for a detailed description.

Stop watch control

This option is only active if you have selected Stop watch as the Mouse button 1 option.

oIf Down / up is selected, you operate the stop watch by:

1.Position the mouse cursor over the Date / time monitor window. 2.Press and hold down Mouse button 1 - the stop watch starts. 3.Release mouse button 1 - the stop watch stops.

This option is usefull for measureing small time durations.

oIf Click is selected, you operate the stop watch by:

1.Position the mouse cursor over the Date / time monitor window. 2.Click Mouse button 1 - the stop watch starts. 3.Click Mouse button 1 again - the stop watch stops.

This option is usefull for measureing large time durations.

Stop watch removal

This option tells the Date / time monitor how many seconds to show the time duration messured after the stop watch has been stopped.

When the selected number of seconds has passed, the Date / time monitor will resume displaying the computer date and time.

Push buttons

Button Usage

OK Click this button to remove the Options window and apply the changed options to the Date / time monitor.

Cancel Click this button to remove the Options window without applying any changed options to the Date / time monitor.

Colors

Select this pop-up menu item to bring up a window with the available foreground and background colors.

Foreground color

Select the prefered foreground color.

The current selected foreground color is highlighted.

Background color

Select the prefered background color.

The current selected background color is highlighted.

Push buttons

Button Usage

OK Click this button to remove the Colors window and apply the changed colors to the main window.

Cancel Click this button to remove the Colors window without applying any changed colors to the main window.

Window Size

Select this pop-up menu item to bring up a window to customize the window size.

Horizontal size (pels)

Select the prefered window size.

The buttons means:

<< Selects the minimum size. 
. Selects the default size. 
>> Selects the maximum size. 
< Decreases the current size by 8 pels. 
> Increases the current size by 8 pels. 

Push buttons

Button Usage

OK Click this button to remove the Window size window and apply the changed size to the main window.

Cancel Click this button to remove the Window size window without applying the changed window size to the main window.

Product Information

Select this pop-up menu item to bring up a window with the product information.

Click the OK button to return to the main window.

Move

Select this pop-up menu item to move the Date / timee monitor window.

The window is moved by the arrow buttons on your keyboard, and the monitor window is repositioned when you hit the return button.

Exit

Select this pop-up menu item to end the Date / time monitor.

All the current Options and Colors are saved and resused when the monitor is restarted.

Swap dataset size monitor

Description

The Swap dataset size monitor is a low CPU and low memory consuming program which displays the size of the swap dataset (SWAPPER.DAT) in a small window on your workplace.

Once a second the Swap Dataset size monitor window is forced on top of all other windows - the current size is always visible.

Mouse Buttons

Mouse button 1 is used for one of two features depending on your current Mouse button 1 Option setting:

  • If Move window is selected, you can move the Swap dataset size monitor window to any spot on the workplace by:
    1. Position the mouse cursor over the Swap dataset size monitor window.
    2. Press and hold down Mouse button 1.
    3. Move the window by moving the mouse.
    4. Release mouse button 1 at the prefered spot on the workplace.
  • If Force update is selected, the Swap dataset size monitor window can be updatet with the current swap dataset size by:
    1. Position the mouse cursor over the Swap dataset size monitor window.
    2. Click Mouse button 1 - the monitor window is updated.

Mouse button 2 is used to present a pop-up menu.

Simply position the mouse pointer over the Swap dataset size monitor window and click Mouse button 2.

Command Line Paramenter

The Swap dataset size monitor need to know where the swap dataset (SWAPPER.DAT) is located on your computer.

When the Swap dataset size monitor is started, it expects to receive a parameter telling which drive your computer was booted from.

If no parameter is received, the monitor asumes the computer was booted from drive C.

Using this information, the monitor scans CONFIG.SYS, which is located in the root of the boot drive.

CONFIG.SYS contains the command SWAPPATH, which points to the directory where the swap dataset is located.

So, type the boot drive letter as the first and only parameter when adding this program to the CB Tools folder.

Disk freespace monitor

Description

The Disk freespace monitor is a low CPU and low memory consuming program which displays the size of the unused disk space for selected drives in a small window on your workplace.

Once a second the Disk freespace monitor window is forced on top of all other windows - the current freespace is always visible.

CONFIG.SYS Requirements

If you plan to monitor the A: or B: drive, it is recomended to insert the AUTOFAIL=YES command in your CONFIG.SYS.

If you are monitoring the A: and/or B: drive while no diskette is inserted in the drive, this will happen:

  • If the AUTOFAIL=YES command isn't included, the system will prompt you whenever the Disk freespace monitor refreshes the window. The prompt will include options to retry, abort or ignore the error.
  • If the AUTOFAIL=YES command is included, the Disk freespace monitor will report Drive not ready!.

However, including the AUTOFAIL=YES command will have effect on your entire system. All other programs have to be able to detect when a drive isn't ready. Most program do have the ability to detect the Not ready responce from the diskette drives!

Monitor Window Size

When the number of drives to monitor changes (through the Drives option), the monitor window size changes too.

Depending on where you have put the monitor window, the window will increase or decrease its size from the top or bottom.

If the lower left corner of the monitor window is placed somewhere on the bottom half of the workplace, the bottom edge of the window will be fixed and the monitor window will stretch upwards as drives are added and collapse downwards as drives are removed.

If the lower left corner of the monitor window is placed somewhere on the top half of the workplace, the top edge of the window will be fixed and the monitor window will stretch downwards as drives are added and collapse upwards as drives are removed.

This enables you to put the Disk freespace monitor window along the top or bottom of your workplace at your choice.

Postcript

Copyright

The CB Tools are copyrighted material.

However, the CB Tools monitors and program are shareware.

Feel free to use, copy and distribute CB Tools for noncommercial use if:

  • No fee is charged for use, copying or distribution.
  • It is not modified in any way.

Disclaimer

The usual stuff:

The author, Carlsberg A/S or any other contributing to these tools and programs disclaims all warranties as to this software, whether express or implied, including without limitation any implied warranties of merchantability, fitness for a particular purpose, functionality or data integrity or protection.

So, what you see is what you get. There is no support and you may use these monitors and programs at your own risk!

Author