Software Release Notice for Wang VS FaxClean Utility FAXCLEAN/FAXCANCL Version 02.00.00 October 6, 1999 SRNLIB/0019/DOCS _______________________________________________________________________________ Page 1 GetronicsWang VS FaxClean Utility, Release 2.00.00 RELEASE ABSTRACT ________________ FAXCLEAN: The Wang VS FaxClean Utility, Release 02.00.00, FAXCLEAN application is designed to delete records from the Fax Queue database file prior to the date entered. Because this application may take up to 1 to 3 hours to run, it can be submitted to background, thereby, freeing up a workstation. FAXCANCL: The Wang VS FaxCancl Utility, Release 02.00.00, FAXCANCL application is used to cancel FAXCLEAN. Because FAXCLEAN is manipulating the Fax Queue database it is necessary to use FAXCANCL if the VS Multiline Facsimile Gateway administrator needs to cancel the FAXCLEAN before normal completion. NOTE: This utility is Y2K compliant. A date entered as 01/01/01 will be recognised as January 1, 2001. A date entered as 99/01/01 will be recognised as January 1, 1999. In general, the two digit year, YY, will be taken to lie between 1980 and 2079. NOTE: This utility may run for an extended period of time and is both CPU and DISK I/O intensive. The amount of time required for this utility to complete is dependent on the size of the FAX Queue. NOTE: If FAXCLEAN must be cancelled before it has run to completion, it is necessary to run FAXCANCL to prevent the Fax Queue database from becoming corrupted. NOTE: No more than one FAXCLEAN session will run at a time The purpose of FAXCLEAN is: Delete all records prior to the date entered by the user or procedure _____________________________________________________________________ The purpose of FAXCANCL is: Cancel the FAXCLEAN application in progress ___________________________________________ _______________________________________________________________________________ GetronicsWang VS FaxClean Utility, Release 2.00.00 Page 1 To Run: From the Command Processor run FAXCLEAN in @FAX@ on the Fax Volume Submitting to background: The procedure should pass the desired date to FAXCLEAN. The date can be calculated from within the procedure or the date could be in quotes as in "940301". NOTE: When submitting FAXCLEAN to background from a procedure, the date field must be in the (YYMMDD) format. If the date is invalid a GETPARM screen will appear at the operators console asking for input. NOTE: The application will quit if the date field is left blank To Submit to background from a procedure: run FAXCLEAN in @FAX@ on the Fax Volume ENTER INPUT = "950301" _______________________________________________________________________________ Page 2 GetronicsWang VS FaxClean Utility, Release 2.00.00 Example Procedure: *********************************************************************** * * * Wang VS Multiline Facsimile Gateway 2.00.00 * * (c) Copyright 1999 GetronicsWang Co., * * All Rights Reserved * * * *********************************************************************** * A sample procedure for passing the date to FAXCLEAN * *********************************************************************** Procedure FAXPROC declare &rtn code integer declare &proc date string (6) declare &hold date string (6) declare &lits string (10) initial "0123456789" assign &hold date = &date * Now put the date in YYMMDD format assign &proc date(1,2) = &hold date(5,2) assign &proc date(3,2) = &hold date(1,2) assign &proc date(5,2) = &hold date(3,2) - 10 if &proc date(5,2) < "10" call fixday if &proc date(5,2) = "00" assign &proc date(5,2) = "01" assign &rtn code = &verify(&proc date(5,2), &lits) if &rtn code NE 0 assign &proc date(5,2) = "01" fxclean: run faxclean in @fax@ on vol222 enter input purgedat = "940101" assign &rtn code = fxclean return code = &rtn code fixday: assign &proc date(6,1) = &proc date(5,1) assign &proc date(5,1) = "0" end _______________________________________________________________________________ GetronicsWang VS FaxClean Utility, Release 2.00.00 Page 3