[22,114]README.1ST - Clunk Time Manipulation Routines

	**************************** NOTE ***********************
	* The routines in this directory do NOT require Pascal! *
	*********************************************************

	This UIC contains a set of routines which allow you convert between
DEC style date and time to a clunk style ( 64 bit unsigned integer ) date
and time and visa versa. There are also routines which allow you to 
manipulate clunk values which in turn allow you to manipulate dates and times.
The rudimentary routines to add, subtract, multiply and divide 64 bit unsigned
integers are also accessable.

	The clunk package now consists of nine routines that are all
accessable by higher level languages via the DEC standard call site. These
routines are:

D2CLNK - Converts a DEC style date to a clunk value.

C2DATE - Converts a clunk value to a DEC style date.

A2CLNK - Adds a specificed amount of time to a clunk value.

S2CLNK - Computes the difference in time between two clunk values.

C2WDAY - Tells you what day of the week the clunk value represents.

ADD64  - Adds two clunk values.

SUB64  - Subtracts two clunk values.

MUL64  - Multiplies two clunk values.

DIV64  - Divides two clunk values returning a quotient and remainder.

	All of the above routines are written in MACRO-11 with all parameters
being passed via the DEC standard call site. See the source code listings
for more details. The routinea are written as position independent code
with the stack providing all buffer space. This allows the routines to
be placed in a shared resident or cluster library. A resident library
called 'CLURES' is contained in this UIC. 

See file README.CLU for more information. 


	Written by - 
		Phil Hannay, Bob Thomas, Pete Stadick
	Submitted by 
		Jim Bostwick
		Cargill Inc.
		612/475-6264

