[307,100]README.1ST

THIS UIC INCLUDES TWO SUBMISSIONS:

1.  A REVISED VERSION OF ACCOUNT.MAC; A PROGRAM TO LOG ACCOUNTING STATISTICS
    FROM AN RSX-11M V3.2 SYSTEM.  THE PROGRAM PROVIDES SAMPLED DATA SUITABLE
    FOR IMPLEMENTING CHARGEBACK ACCOUNTING; IT IS NOT SO WELL SUITED FOR
    SYSTEM PERFORMANCE ANALYSIS.

    THIS LOGGING PACKAGE IS NOT AS COMPREHENSIVE AS THE KMS FUSION PACKAGE.
    IT'S MAJOR ADVANTAGE IS THAT NO SYSGEN IS REQUIRED.  THE PACKAGE LOGS
    RESOURCE USAGE DATA - CONNECT TIME, CPU TIME, MEMORY
    USAGE, TASK PRIORITY, I/O, AND OTHER SYSTEM RESOURCES - ON A TASK-BY-TASK
    AND TERMINAL-BY-TERMINAL BASIS.

    ACCOUNT IS OPTIONALLY DRIVEN BY A PARAMETER FILE, ALLOWING EACH SITE TO
    CONTROL VARIOUS "THRESHHOLDS" FOR DATA LOGGING.  THE THRESHHOLDS MAY BE
    CHOSEN TO LOG REQUIRED DATA WHILE MINIMIZING THE TOTAL SIZE OF THE
    LOG FILE GENERATED.

    ACCOUNT HAS NOT BEEN TESTED UNDER 11M V4.0.  DEC HAS MODIFIED CERTAIN
    TCB AND UCB ATTRIBUTES FOR 4.0; THESE MAY REQUIRE MODIFICATION TO THE
    ACCOUNT SOURCES.  NOTE IN PARTICULAR THAT CODE FOLLOWING LABEL TTUTCB::
    (SETTING UP PSEUDO DATA STRUCTURES FOR CONNECT TIME LOGGING SUPPORT)
    MAY REQUIRE MODIFICATION.  IN ADDITION ANY SITE USING EXTERNAL TASK
    HEADERS MAY RUN INTO PROBLEMS.
 
    **NOTE** THAT SINCE ACCOUNT IS A PRIVILEGED TASK, IT MAY CRASH AN
    11M V4.0 SYSTEM.  BE FOREWARNED!!  

    THE ORIGINAL VERSION OF ACCOUNT APPEARED AS "LOG" UNDER UIC [370,120]
    ON FALL '79/SPRING '80 SIG TAPE.  THANKS TO STEVEN G. DUFF FOR PROVIDING
    A WELL WRITTEN AND FULLY COMMENTED SOURCE.  PLEASE SEE THE SOURCE FOR
    ADDITIONAL DOCUMENTATION.  NOTE THAT THE SOURCE INCLUDES SEVERAL
    CONDITIONAL ASSEMBLY PARAMETERS WHICH MAY BE USED TO FURTHER TAILOR
    THE CODE TO EACH SITE'S REQUIREMENTS.  IN PARTICULAR:
 
    MAXTSK	MUST BE SET TO THE MAXIMUM NUMBER OF ACTIVE TASKS
		PLUS THE MAXIMUM NUMBER OF LOGGED-ON USERS FOR YOUR SITE.
    NUCBS	MUST BE SET EQUAL TO THE TOTAL NUMBER OF DISK UNITS IN
		YOUR SYSTEM, PLUS THE TOTAL NUMBER OF LINEPRINTER UNITS.
		FOR EXAMPLE A SITE WITH 4 RL01'S, 2 RX02'S, AND 1 LP:
		MUST SET NUCBS=7.
    TTSIZE	MUST BE SET TO NN, WHERE TTNN: IS THE HIGHEST TT: UNIT
		NUMBER TO BE LOGGED.

    NOTE ALSO THAT THE SOURCE CODE (AFTER LABEL INI02B) MUST BE MODIFIED
    TO REFLECT EACH SITE'S DISK AND LINEPRINTER CONFIGURATION.
 
    THE SOURCE OF STEVEN G. DUFF'S "DSKLOG" IS ALSO INCLUDED; FOR SITES
    WISHING TO LOG DISK DEVICE USAGE BY FILE OWNER UIC.

    ACCTPRE.FTN IS A HASTILY WRITTEN FORTRAN PROGRAM WHICH TAKES THE
    UNFORMATTED FILE PRODUCED BY ACCOUNT AND "PREPROCESSES" IT INTO
    AN ASCII FILE.  ACCTPRE IS ALSO DRIVEN BY A PARAMETER FILE, ALLOWING
    EACH SITE TO SET ITS OWN CHARGE RATES AND OTHER PARAMETERS.  THE OUTPUT OF 
    ACCTPRE MAY BE FORMATTED INTO FINAL ACCOUNTING REPORTS USING DATATRIEVE;
    ALTERNATIVELY A SITE MAY CHOOSE TO WRITE ITS OWN FINAL PROCESSOR
    FOR CUSTOM-TAILORED ACCOUNTING REPORTS.

    TO BUILD THE PACKAGE, TYPE

		@ACCOUNT
		@ACCTPRE

******************************************************************************

2.  GRAF - A PLOTTING PACKAGE FOR THE HEWLETT-PACKARD 7220 PLOTTER.

    THIS PACKAGE HAS BEEN USED IN THE RT-11 WORLD AT STANFORD FOR SOME TIME;
    IT HAS NOW BEEN MODIFIED FOR RSX-11M.  IT IS DESIGNED FOR MASSAGING AND
    PLOTTING X-Y DATA ON THE HP 7220.

    THE MODULE HP7220.MAC INTERFACES TO THE PLOTTER USING A TERMINAL PORT.
    THE LOGICAL DEVICE HP0: MUST BE ASSIGNED TO ANY TERMINAL DEVICE TTN:
    BEFORE GRAF IS RUN.  GRAF RUNS WITH THE RSX-11M V3.2 FULL DUPLEX TERMINAL
    DRIVER.  IT SHOULD BE COMPATIBLE WITH V4.0 (BUT HAS NOT YET BEEN TESTED).
    IT HAS NOT BEEN TESTED WITH THE HALF-DUPLEX TERMINAL DRIVER.

    THE MODULE DISCO.FTN READS PLOT DATA FROM A FORMATTED ASCII FILE.  EACH
    SITE MUST MODIFY THIS MODULE AS REQUIRED FOR ITS DATA INPUT.

    THE MODULE GRAF.OLB CONTAINS ROUTINES FROM THE CETUS LIBRARY (1980 SIG
    TAPES) WHICH REPLACE SYSTEM ROUTINES AVAILABLE UNDER THE RT-11 MONITOR.

    SEE GRAF.DOC FOR OPERATING INSTRUCTIONS.

    TO BUILD GRAF, TYPE

			@GRAF

*****************************************************************************

    IF YOU HAVE ANY QUESTIONS PLEASE CONTACT ME:

			PHIL KURJAN
			C/O ANAC INC.
			3200 SCOTT BLVD.
			SANTA CLARA,  CA  95051
			(408) 727-5221

    GOOD LUCK!
