Program Overview

YearIn demonstrates a routine that properly handles two-digit year inputs for the current and next century.  For example, 98 converts to 1998 and 3 becomes 2003.  The pair of partial years (90, 95) converts to (1890, 1995) for a difference of 105 years.  In addition, this routine is incorporated into an edit box or data-entry field that expands a two-digit year into a four-digit year when you move away from it.  Thus, YearIn's year-resolution routine virtually eliminates the need to enter four-digit years and allows databases that use two-digit years to continue to be usable in the 21st century.

To use YearIn in Windows 3.1 or 95, start YEARIN.EXE, click on the Input menu, and select either A Year, Year Difference, Examples, or Dynamic Edit Box.  For the first option, enter a one-, two-, or three- digit year and click on the OK button or press Enter to close the dialog box.  The input and the result will appear in a scrolling list in the YearIn's main window.  In addition, you may set the active year in this dialog box to some year other than the current one.  For example, try entering 98 for active years 1996 and 2000.  You will get the same four-digit year.

The year-difference option will produce a dialog box that accepts a pair of two-digit years and allows setting the active year and the minimum difference between years.  Try entering 90 and 95 to get a difference of 105 years.  The inputs and outputs for this calculation will also appear in the main window.  The primary benefit of the year-difference logic is that databases that use two-digit years to store birth and current (or death) years do NOT need to be modified.  Following is the sample output from this program that is generated by selecting the Examples option.

Input(s)     Full Year(s)     Difference     Active Year  MinDiff

--------     ------------     ----------     -----------  -------

   98            1998                           1996

    3            2003                           1996

   98            1998                           2000

    3            2003                           2000

  3, 98       1903, 1998          95            1996        25

 90, 95       1890, 1995         105            1996        25

  3, 98       1903, 1998          95            2000        25

 90, 95       1890, 1995         105            2000        25

   75            1975                           1996

   75            2075                           2060

Selecting the Dynamic Edit Box option will present an edit box (or data-entry field) that converts a partial year input into a four-digit year when you move away from it by clicking on another entry field, selecting a button, or using a keyboard command.  This edit box is designed to relieve data-entry personnel from repeatedly having to type all four digits of an input year.

YearIn is a freely-distributable $10 to $5000 shareware program by FileJockey Software, which can be reached by e-mail (71573.1023 @compuserve.com) or postal mail (289 S. Robertson Blvd., Suite 373, Beverly Hills, CA 90211).  Registered users will receive the C/C++/Fortran/COBOL source code for this routine and the C++ source code for this edit box.  FileJockey Software is also maintaining a list of year-2000 articles in YR2000.TXT in CompuServe's OAFORUM and PCPROG forums.


Source Code Availability
Source-Code Availability

The source code for YearIn's year-conversion routine and dynamic edit box are available from FileJockey Software.  The routine is written in C, C++, Fortran, and COBOL while the edit box is written in C++.

Licence options

$10	single-user licence

$100	site licence for all of your company's computers in one state of the U.S.

$100	site licence for all of your company's computers in one country outside of the U.S.

$2500	site licence for all of your company's computers in the U.S

$2500	site licence for all of your company's computers outside of the U.S

$5000	site licence for all of your company's computers in the world

Shipping/handling/tax

By 3.5" disk:	$4 and CA tax (if CA resident)

By e-mail:	no extra charge

Payment methods

By CompuServe's Software Registration Service

GO  SWREG #11545

For site licenses, register multiple copies.

By check

Make your check payable to David Wincelberg and mail it to

FileJockey Software

YearIn 1.1 Registration

289 S. Robertson Blvd., Suite 373

Beverly Hills, CA 90211

An order form is contained in YearIn.REG.

Inquires

71573.1023@compuserve.com


License Agreement

This is a legal agreement between you ("Licensee") and FileJockey Software ("Licensor").  Licensor owns all worldwide rights, title, copyright and other interests in and to the demonstration computer program identified as YearIn 1.1 ("Software").  By using the Software, you are agreeing to be bound by the following terms:

1.   Licensor grants to Licensee the non-exclusive and non-assignable right to use the Software without paying a fee to Licensor.

2.   Licensee may distribute copies of the Software and related files to others provided Licensee informs the recipients that the Software is subject to a license agreement.  The attached VENDINFO data record is hereby incorporated by reference.  Any distribution satisfying all the distribution requirements expressed in that data record is hereby authorized.

3.   Licensor hereby alerts Licensee that the Software and accompanying documentation are provided "AS IS" without warranty of any kind.  Licensee assumes all risks involving use of the Software and its results and performance.

4.   Licensee hereby acknowledges that Licensor bears no responsibility or liability which may arise or result from Licensee's use of the Software.  Licensee hereby waives and releases Licensor from any and all claims for damages, losses and costs therefrom.  In no event shall Licensor's liability for any damages ever exceed the price paid for license and registration, regardless of the form of the claim.

5.   This license agreement shall be construed and enforced in accordance with the laws of the State of California.  This agreement may not be modified except by written instrument signed by both parties.  If any provisions of this agreement are found to be invalid or unenforceable by the operation of the law, then invalidity or unenforceability of such provision(s) shall not affect the validity or enforceability of the other provisions of this agreement.  Any dispute arising from this agreement shall be submitted to California courts located in Los Angeles County, and Licensee hereby submits to the jurisdiction of such courts.


Uninstalling YearIn

To uninstall YearIn, delete its files from the YEARIN directory (or folder) and delete YEARIN.INI from the WINDOWS directory.  YearIn does not change any system .INI file or registry and does not create a group file.


FileJockey Software Products

System Tools

WRDGRB 1.4	Copies Words From DOS Screen to Command Line

LISTRS 2.0	Program/Directory Lists With Action Options

C2DD 1.0	Change to Drive/Directory and Back

Programmer Tools

SRLIB 1.1	Alphanumeric Filename Sorting Library

PROGCR 1.0	Prepares Programs for Copyrighting

BBS-Session Tool

FRMDSK 1.0	Enters Text From Disk With Line Preview & Edit


Contacting FileJockey Software

FileJockey Software can be reached by e-mail:

71573,1023  (CompuServe)

71573.1023@compuserve.com  (Internet)

or by postal mail:

David Wincelberg

FileJockey Software

289 S. Robertson Blvd., Suite 373

Beverly Hills, CA 90211


Copyright Notice
YearIn Copyright Notice

Copyright © 1995-1996 by David M. Wincelberg


WRDGRB description
WRDGRB 1.4

Copies Words From DOS Screen to Command Line

WordGrab v1.4 is a 23K memory-resident program for quickly copying text from the DOS screen to the command line using a mouse.  After displaying a directory list, you can paste a filename to the command line in the form required by DOS using a double click followed by a single click (for confirmation).  WordGrab also works in a full-screen DOS session under Windows.  GO SWREG (#5571) to register on-line.  (GO PCUTIL, Library 3, $10)


LISTRS description
LISTRS 2.0

Program/Directory Lists With Action Options

LISTRS v2.0 is a pair of DOS programs to help users find DOS programs (.EXE, .COM or .BAT files) and subdirectories within a directory.  ProgList can run a selected program with or without parameters.  It looks inside files to exclude Windows 3.x/95 programs.  DirList can show a selected subdirectory's files and change to it.  Both programs ignore Windows 95 long-filename directory entries and sort alphanumerically (FILE_2 before FILE_10).   (GO PCUTIL, Library 5, $10)


SRLIB description
SRLIB 1.1

Alphanumeric Filename Sorting Library

SRLIB v1.1 is a set of library routines to sort filenames alphanumerically.  For example, it places FILE_2 before FILE_10 and can handle long file names, leading zeros and spaces.  SRLIB is compiled for Microsoft C/C++'s and Borland TC++'s small and large memory models.  (See SRDEMO in MSLANG, Library. 3.)  New: case-insensitive routine, 3rd space-handling option, commas-within-numbers handling, and more.  SRDEMO.C, included in SRLIB.ZIP, reads a directory once even for an unknown number of files.  GO SWREG (#5947) to purchase SRLIB on-line.  Site licenses and source code are available.  ($24 plus $1 S/H (by e-mail) or $24 plus CA tax plus $4 S/H (by disk))


PROGCR description
PROGCR 1.0

Prepares Programs for Copyrighting

ProgCR v1.0 protects the privacy of your C/C++ or PASCAL source code copyright deposit by removing comments after each file's header (which should primarily consist of your copyright notice) from copies of the original files.  Also, copies words displayed by standard or user-specified print commands to a file for spell checking.  (GO PCPROG, Library 6, $10)


FRMDSK description
FRMDSK 1.1

Enters Lines From Disk With Preview & Edit

Use FRMDSK v1.0 when BBS software (or another program) requires you to type in text instead of allowing you to upload a file.  It copies lines from a file to your program after giving you preview, edit, and other options.  Works only with DOS text programs that use standard keyboard reading, such as VendEdit (mentioned with permission).  New features include: safe command-line unloading and selectable hot-key sequence.    37K or 63K TSR.  (GO PCCOM, Library 2, $5)


C2DD description
C2DD 1.0

Change to Drive/Directory and Back

C2DD v1.0 changes the current drive/directory to a specified pair and records path information for moving back to any of several previous drive/directories.  It can move back one pair at a time or present a graphical pick list.  C2DD can be used with any DOS directory navigator and is useful for returning to the starting drive/directory in batch (.BAT) files.  (GO PCUTIL, Library 1, $0)


GO definition
GO

GO is the CompuServe command to move to a specified forum or service.


SWREG description
SWREG

SWREG is the CompuServe service for registering shareware online.  Use the provided number to find the program you are registering.  The registration fee will be billed to your credit card or deducted from your checking account, depending on your billing option.


BBS definition
BBS

Bulletin Board Service.


TSR definition
TSR

Terminate and Stay Resident.  TSR programs stay in memory so that they can perform some useful function in conjunction with DOS or an application program.  They are typically activated with a hot-key sequence such as <Ctrl>-<Right Shift>-W.


Main index
YearIn Help Index

General Information

 	Program Overview

Source Code Availability

Uninstalling YearIn

License Agreement

Copyright Notice

FileJockey Software Products

Contacting FileJockey Software

Commands

File menu

Input menu

Help menu


File menu commands

The File menu offers the following commands:

New 	Creates a new document.

Open	Opens an existing document.

Save	Saves an opened document using the same file name.

Save As	Saves an opened document to a specified  file name.

1, 2, 3, 4	Recalls a recently opened file.

Exit 	Exits YearIn.


Input menu command
Input menu commands

The Input menu offers the following commands:

A Year	Presents a dialog box for entering a partial year (one, two, or three digits).

Year Difference	Presents a dialog box for entering a pair of two-digit years that represent a time span such as age.

Examples	Processes a set of sample inputs based on the current year (up to 1999).

Dynamic Edit Box	Presents an edit box (data-entry field) that expands a two-digit year into a four-digit year when you move away from it.


A Year command
A Year command (Input Menu)

Use this command to enter a partial year to be converted into a full year.  For example, 98 will become 1998, regardless of whether the current year is 1996 or 2003.


Year Difference command
Year Difference command (Input Menu)

Use this command to enter a pair of two-digit years that represent a time span.  For example, (90, 95) converts to (1890, 1995) for a difference of 105 years.  The logic behind this command is well suited for using a database that contains many two-digit years.


Year Difference dialog box

The following options allow you to enter a pair of two-digit years where the first one is earlier than the second one:

Enter first partial year

Type a one- or two-digit year that represents an earlier year than the second year.

Enter second partial year

Type a one- or two-digit year that represents a later year than the first year.

Set active year

You may change the year shown so that YearIn bases its calculations on another year.

Reset

Pressing this button will set the active year to the current year (the year in your PC's clock).

Set minimum difference

You may change the number shown so that YearIn bases its calculations on another minimum separation between the first and second partial years.  For a separation of 25 years, the pair of partial years (90, 95) will convert to (1890, 1995) instead of (1990, 1995).   Requiring this quantity does not significantly limit the benefits of YearIn's logic since, in many applications, there is a natural lower bound on the separation between a pair of  years.  For example, life insurance companies may assume that such insurance is not sold to anyone who is not at least 25 years old.

During a YearIn session, the screen location of this dialog box will be the same as what it was when you selected OK or Cancel to end its previous use.


Examples command
Examples command (Input menu)

Use this command to generate and process a set of sample year inputs.  These examples show how YearIn works on both single-year and year-difference inputs.  The active year will be the current year up to 1999.


Year Input Dialog Box
A Year dialog box

The following options allow you to enter a partial year to be converted to a full year:

Enter a partial year

Type a one-, two- or three-digit year.

Set active year

You may change the year shown so that YearIn bases its calculations on another year.

Reset

Pressing this button will set the active year to the current year (the year in your PC's clock).

Limit full year to active year

Checking this box will restrict the full year to the active year.  For an active year of 1996, an input of 98 will become 1998 with this box not checked or 1898 with this box checked.  On output lines, the symbol "<=" will appear in the Full Year(s) column if this box is checked.

During a YearIn session, the screen location of this dialog box will be the same as what it was when you selected OK or Cancel to end its previous use.


Dynamic Edit command
Dynamic Edit Box command (Input menu)

Use this command to test an edit box or data-entry field that expands a two-digit year into a four-digit year when you move away from it by clicking on another field, pressing a button, or using a keyboard command.  The purpose of this edit box is to allow users to enter four-digit years without having to type all four digits.  When you select the OK button, the most recent partial-year input and its four-digit equivalent will appear in YearIn's main window.


Dynamic Edit dialog box
Dynamic Edit Box dialog box

The following options allow you to test an edit box that expands a two-digit year into a four-digit year when you move away from it.

Enter a partial year

Type a one-, two- or three-digit year.

Then click here

Click or tab to this item in order for the partial year in the above entry field to be replaced with the corresponding four-digit year.  It doesn't matter what you type in this entry field.

OK

Pressing this button will add the most recent partial year and its four-digit equivalent to the summary in YearIn's main window.

During a YearIn session, the screen location of this dialog box will be the same as what it was when you selected OK or Cancel to end its previous use.


Help menu commands

The Help menu offers the following commands, which provide you assistance with this application:

Contents	Offers you an index to topics on which you can get help.

Search for ...	Displays the Search for Keyword dialog box.

Using Help	Provides general instructions on using help.

FileJockey ...	Displays a list of FileJockey Software Products with links to descriptions.

About YearIn	Displays the version number of this application.


File New command
New command (File menu)

Use this command to create a new document in YearIn.

You can open an existing document with the Open command.

Shortcut

Keys:	CTRL+N


File Open command
Open command (File menu)

Use this command to open an existing document.  You will be presented with the File Open dialog box.

You can create a new document with the New command.

Shortcut

Keys:	CTRL+O


File Open dialog box

The following options allow you to specify which file to open:

File Name

Type or select the filename you want to open.

Drives

Select the drive in which YearIn stores the file that you want to open.

Directories

Select the directory in which YearIn stores the file that you want to open.

Network...

Choose this button to connect to a network location, assigning it a new drive letter.


File Save command
Save command (File menu)

Use this command to save the active document to its current name and directory.  When you save a document for the first time, YearIn displays the Save As dialog box so you can name your document.  If you want to change the name and directory of an existing document before you save it, choose the Save As command.

Shortcut

Keys:	CTRL+S


File Save As command
Save As command (File menu)

Use this command to save and name the active document.  YearIn displays the Save As dialog box so you can name your document.

To save a document with its existing name and directory, use the Save command.


File Save As dialog box

The following options allow you to specify the name and location of the file you're about to save:

File Name

Type a new filename to save a document with a different name.  YearIn adds the extension TXT if you don't specify an extension.

Drives

Select the drive in which you want to store the document.

Directories

Select the directory in which you want to store the document.

Network...

Choose this button to connect to a network location, assigning it a new drive letter.


File 1, 2, 3, 4 command
1, 2, 3, 4 command (File menu)

Use the numbers and filenames listed at the bottom of the File menu to open the last four documents you closed.  Choose the number that corresponds with the document you want to open.


File 2 sensitive help
1, 2, 3, 4 command (File menu)

Use the numbers and filenames listed at the bottom of the File menu to open the last four documents you closed.  Choose the number that corresponds with the document you want to open.


File 3 sensitive help
1, 2, 3, 4 command (File menu)

Use the numbers and filenames listed at the bottom of the File menu to open the last four documents you closed.  Choose the number that corresponds with the document you want to open.


File 4 sensitive help
1, 2, 3, 4 command (File menu)

Use the numbers and filenames listed at the bottom of the File menu to open the last four documents you closed.  Choose the number that corresponds with the document you want to open.


File Exit command
Exit command (File menu)

Use this command to end your YearIn session.  You can also use the Close command on the application Control menu.  YearIn prompts you to save documents with unsaved changes.

Shortcuts

Mouse:	Double-click the application's Control menu button.

Keys:	ALT+F4


Help Index command
Contents command (Help menu)

Use this command to display the opening screen of Help.  From the opening screen, you can jump to step-by-step instructions for using YearIn and various types of reference information.

Once you open Help, you can click the Contents button whenever you want to return to the opening screen.


Search for command
Search For command (Help menu)

Use this command for quick access to the Search for Keyword dialog box.


Using Help command
Using Help command (Help menu)

Use this command for instructions about using Help.


FJS Products command
FileJockey Software Products command (Help menu)

Use this command to display a list of FileJockey Software products.


Help About command
About YearIn command (Help menu)

Use this command to display the copyright notice and version number of your copy of YearIn.


Help About dialog box

Displays the copyright notice and version number of this copy of YearIn.  The icon implies that, when using the year-conversion routine, the fall from entering a two-digit year of 99 to entering 0 is as safe as using a good parachute.


Context-Sensitive Help
Context Help command

Use the Context Help command to obtain help on some portion of YearIn.  When you press SHIFT+F1, the mouse pointer will change to an arrow and question mark.  Then click somewhere in the YearIn window.  The Help topic will be shown for the item you clicked.

Shortcut

Keys:	SHIFT+F1


Title Bar

 The title bar is located along the top of a window.  It contains the name of the application and document.

 To move the window, drag the title bar.  Note: You can also move dialog boxes by dragging their title bars.

A title bar may contain the following elements:

 	Application Control-menu button

 	Document Control-menu button

 	Maximize button

 	Minimize button

 	Name of the application

 	Name of the document

 	Restore button


Scroll bars

Displayed at the right and bottom edges of the document window.  The scroll boxes inside the scroll bars indicate your vertical and horizontal location in the document.  You can use the mouse to scroll to other parts of the document.


System Size command
Size command (Control menu)

Use this command to display a four-headed arrow so you can size the active window with the arrow keys.

After the pointer changes to the four-headed arrow:

1.	Press one of the DIRECTION keys (left, right, up, or down arrow key) to move the pointer to the border you want to move.

2.	Press a DIRECTION key to move the border.

3.	Press ENTER when the window is the size you want.

Note:  This command is unavailable if you maximize the window.

Shortcut

Mouse:	Drag the size bars at the corners or edges of the window.


Control Move command
Move command (Control menu)

Use this command to display a four-headed arrow so you can move the active window or dialog box with the arrow keys.

Note:  This command is unavailable if you maximize the window.


System Minimize Command
Minimize command (Control menu)

Use this command to reduce the YearIn window to an icon.

Shortcut

Mouse: Click the minimize icon [image] on the title bar.


System Maximize command
Maximize command (Control menu)

Use this command to enlarge the active window to fill the available space.

Shortcut

Mouse: Click the maximize icon [image] on the title bar; or double-click the title bar.


Control Close command
Close command (Control menu)

Use this command to close the active window or dialog box.

Double-clicking a Control-menu box is the same as choosing the Close command.

Shortcut

Keys: 	ALT+F4 closes the YearIn window or dialog box


Control Restore command
Restore command (Control menu)

Use this command to return the active window to its size and position before you chose the Maximize or Minimize command.


Control Switch command
Switch To command (Control menu)

Use this command to display a list of all open applications.  Use this "Task List" to switch to or close an application on the list.

Shortcut

Keys:	CTRL+ESC

Dialog Box Options

When you choose the Switch To command, you will be presented with a dialog box with the following options:

Task List

Select the application you want to switch to or close.

Switch To

Makes the selected application active.

End Task

Closes the selected application.

Cancel

Closes the Task List box.

Cascade

Arranges open applications so they overlap and you can see each title bar.  This option does not affect applications reduced to icons.

Tile

Arranges open applications into windows that do not overlap.  This option does not affect applications reduced to icons.

Arrange Icons

Arranges the icons of all minimized applications across the bottom of the screen.


No Help Available

No help is available for this area of the window.


No Help -- message box
No Help Available

No help is available for this message box.