EPUP.DOC DOCUMENTATION FOR EPUP.COM , EPUPMOD.COM & WSL2.SUB COPYRIGHT 1985 (C) BY PHIL PFLAGER MAY BE USED FOR NON-COMMERCIAL PURPOSES ONLY RIGHTS TO COPY FOR COMMERCIAL DISTRIBUTION RESERVED BY AUTHOR USE: FOR SENDING CONTROL CODES TO PRINTERS SUCH AS THE EPSON FX-80 OR PRINTERS USING SIMILAR CONTROL CODES. THE PROGRAM IS WRITTEN IN 8080 ASSEMBLY LANGUAGE FOR COMPUTERS USING CP/M 2.2 SUMMARY: ALLOWS CONTROL CODES OR A SERIES OF CONTROL CODES TO BE SENT TO THE PRINTER BY PRESSING A SINGLE KEY. KNOWLEDGE OF HEXADECIMAL OR CONTROL CODES IS NOT REQUIRED. CHOICES ARE OFFERED BY A MENU OR A SERIES OF MENUS. SOME CHOICES REQUIRE A NUMBER TO BE INPUT IN DECIMAL. CHOICE #3 FROM THE MAIN MENU ALLOWS SENDING HEX CODES DIRECTLY TO THE PRINTER. ALL OTHER DATA IS ENTERED IN DECIMAL. SEE "SETUPS" FOR A DESCRIPTION OF USER DEFINABLE CONTROL CODE STRINGS. CHOICE "K" FROM THE MAIN MENU ALLOWS YOU TO USE THE KEYBOARD TO TYPE A LINE OF TEXT DIRECTLY TO THE PRINTER. ****BE SURE TO TURN YOUR PRINTER ON BEFORE RUNNING EPUP.**** HOW I USE EPUP: I CREATE MY TEXT FILES WITH A WORD PROCESSOR WITHOUT PRINT COMMANDS. WHEN I WANT A PRINTED COPY I USE EPUP TO SET MARGIN, FONT AND PAGE LENGTH. THE WORD PROCESSOR OR ANY PROGRAM THAT WILL PRINT A FILE CAN BE USED TO SEND THE TEXT TO THE PRINTER. AS LONG AS THE PROGRAM DOES NOT RESET THE PRINTER FOR YOU, THE FILE WILL BE PRINTED IN THE FORMAT YOU SET WITH EPUP. MAIN MENU: YOU MAY SELECT ANY OF THE CHOICES FROM THE MAIN MENU BY PRESSING THE APPROPRIATE KEY AT THE PROMPT; "CHOICE ?". TYPE ^Q TO EXIT TO CPM. SOME CHOICES FROM THE MAIN MENU WILL ENABLE A SECONDARY MENU. SECONDARY MENUS: SOME OF THE SECONDARY MENUS ALLOW SELECTING SEVERAL CHOICES AT ONCE. THE FONT MENU ALLOWS CONDENSED, DOUBLE STRIKE ETC. TO BE SELECTED AT THE SAME TIME. SOME MENUS WILL TOGGLE BETWEEN TWO CHOICES. IT IS NOT NECESSARY TO DEFINE ALL CHOICES. TYPE CARRIAGE RETURN TO SKIP A CHOICE AND LEAVE IT UNCHANGED. TYPE ^Q TO RETURN TO THE MAIN MENU. SETUPS: ON THE RIGHT SIDE OF THE MAIN MENU ARE A SERIES OF SETUPS, A THROUGH I. WHEN ONE OF THESE ARE SELECTED A STRING OF CONTROL CODES ARE SENT TO THE PRINTER. THE STRING OF CODES CAN BE CHANGED WITH THE PROGRAM EPUPMOD.COM. EPUPMOD.COM IS A MENU DRIVEN PROGRAM THAT ALLOWS PRE-SETTING CHOICES A THROUGH I. NO KNOWLEDGE OF HEXADECIMAL OR PRINTER CONTROL CODES IS REQUIRED. HOWEVER, CHOICES F THROUGH I CAN BE PRESET WITH UP TO THIRTY HEX CODES EACH, ENTERED FROM THE KEYBOARD. SEE "MODIFYING SETUPS F THROUGH I." EPUPMOD.DOC DOCUMENTATION FOR EPUPMOD.COM EPUPMOD.COM IS A PROGRAM USED TO MODIFY CHOICES A THROUGH I OF EPUP.COM. WHEN ONE OF THESE CHOICES IS SELECTED A SERIES OF UP TO THIRTY CONTROL CODES ARE SENT TO THE PRINTER. BY USING EPUPMOD.COM THE SERIES OF CODES THAT ARE SENT CAN BE PRE-SET. EPUPMOD.COM REQUIRES NO KNOWLEDGE OF HEXADECIMAL OR PRINTER CONTROL CODES. HOWEVER IT IS POSSIBLE TO ENTER HEX CODES IF DESIRED. SEE "MODIFYING SETUPS F THROUGH I." TO USE EPUPMOD.COM: TYPE EPUPMOD AT THE CPM PROMPT. THE PROGRAM WILL LOAD AND YOU WILL BE ASKED IF YOU WOULD LIKE TO MODIFY EPUP.COM ON DRIVE A. IF YOU HAVE RENAMED EPUP.COM OR IF IT IS ON ANOTHER DRIVE, RESPOND "N". YOU WILL BE ASKED FOR A CPM FILE NAME. IF YOU RESPOND "Y", EPUPMOD.COM WILL BE LOADED AND YOU WILL BE PRESENTED WITH A MENU WITH CHOICES 1 THROUGH 4 AND CHOICES A THROUGH I. TO SETUP SELECTIONS A THROUGH E: SELECT "A" THROUGH "E" AT THE MENU. YOU WILL THEN BE LED THROUGH A SERIES OF QUESTIONS WHICH ALLOW YOU TO SET FONT, MARGINS, PAGE LENGTH. SKIP OVER PERFORATION AND SPACING BETWEEN LINES. ANSWER "Y" TO SET A FONT OR ENTER A DECIMAL NUMBER TO SET A MARGIN OR PAGE LENGTH. A CARRIAGE RETURN WITH NO OTHER CHARACTER WILL SKIP THAT SELECTION AND IT WILL REMAIN UNCHANGED. THIS IS USEFUL BECAUSE IT ALLOWS YOU TO CHANGE ONE THING AND SKIP OVER EVERYTHING ELSE. ENTERING "0", "00", OR "000" WILL CAUSE THAT SELECTION TO REMAIN SET TO THE DEFAULT VALUE THE PRINTER SETS WHEN IT IS TURNED ON. A POINT TO REMEMBER IS THAT THERE ARE CERTAIN COMBINATIONS THAT THE PRINTER WILL NOT ACCEPT. FOR EXAMPLE ELITE CAN NEVER BE EMPHASIZED. IF YOU SELECT ELITE AND EMPHASIZED THEN THE EMPHASIZED COMMAND WILL BE IGNORED. PROPORTIONAL PRINTING IS ALWAYS EMPHASIZED SO ELITE CAN NEVER BE PROPORTIONAL. IF YOU ARE HAVING TROUBLE GETTING THE SETUPS YOU WANT, RESET THE PRINTER, TRY AGAIN AND MAKE SURE THE PRINTER WILL ACCEPT THE COMBINATION. WATCH OUT FOR PROGRAMS THAT RESET THE PRINTER FOR YOU! MODIFYING SETUPS F THROUGH I: WHEN F THROUGH I ARE SELECTED YOU WILL BE ASKED IF YOU WOULD LIKE TO DO A HEX SETUP. IF YOU ANSWER "N", THE SETUP WILL BE IDENTICAL TO SETUPS A THROUGH E. IF YOU ANSWER "Y", YOU WILL BE ABLE TO ENTER UP TO THIRTY HEX CONTROL CODES. THESE WILL BE SENT TO THE PRINTER IN THE ORDER THEY ARE ENTERED. THIS TYPE OF SETUP WAS ADDED TO ALLOW FOR ANY POSSIBLE COMBINATION OF CODES. IN ADDITION TO ALLOWING MODIFICATION OF SETUPS, THE EPUPMOD MENU HAS THE FOLLOWING CHOICES: 1. EXIT AND SAVE THE CHANGES TO DISC 2. EXIT NO CHANGES (^C WILL WORK ALSO) 3. DISPLAY SETUPS 4. MODIFY MENU 1. EXIT AND SAVE THE CHANGES TO DISC: YOU WILL BE ASKED FOR A CPM FILE NAME. YOU CAN SAVE EPUP.COM UNDER A NEW NAME OR UNDER THE SAME NAME. 2. EXIT NO CHANGE 3. DISPLAY SETUPS: DISPLAYS THE HEX NUMBERS STORED IN MEMORY WHICH CONTROL SETUPS A THROUGH I. 4. MODIFY MENU: WHEN THE SETUPS ARE CHANGED IT IS CONVENIENT TO CHANGE THE MENU TO DESCRIBE THE NEW SETUP. THIS MENU WILL BE TRANSFERRED TO THE NEW EPUP.COM YOU ARE CREATING. EACH SETUP HAS NINETEEN SPACES FOR A DESCRIPTION OF ITS' FUNCTION. AFTER SELECTING "4" AT THE MENU YOU WILL BE PRESENTED WITH A SCREEN WITH THE CURSOR UNDER THE FIRST CHARACTER OF SELECTION A. A CARRIAGE RETURN WILL SKIP THAT SELECTION LEAVING IT UNCHANGED. TO MAKE CHANGES, JUST TYPE OVER THE EXISTING DESCRIPTION. WHEN YOU HAVE MADE ALL THE CHANGES, USE CARRIAGE RETURNS TO RETURN TO THE MENU. YOU CAN CHANGE THE DESCRIPTIONS AS MANY TIMES AS YOU WANT BECAUSE THEY ARE NOT SAVED TO DISC UNTIL "1" IS SELECTED AT THE MENU. ATTACHING EPUP TO WORDSTAR 2.26: I HAVE INCLUDED, WSL2.SUB, A SUBMIT TYPE PROGRAM WHICH ENABLES YOU TO ATTACH EPUP TO YOUR WORDSTAR 2.26. THIS WILL ALLOW THE PRINTER TO BE SET UP EVERY TIME A FILE IS PRINTED. ALSO INCLUDED IS WSLMOD2.COM WHICH FUNCTIONS LIKE EPUPMOD.COM EXCEPT IT IS USED WHEN EPUP IS ATTACHED TO WORDSTAR. WSL2.SUB: WSL2.SUB IS A SUBMIT TYPE PROGRAM USED TO ATTACH EPUP, MY PRINTER SETUP PROGRAM, TO THE END OF YOUR WORDSTAR. ONCE ATTACHED, EPUP WILL BE CALLED EVERY TIME A FILE IS PRINTED AND EVERY TIME A FILE FINISHES PRINTING. THIS ALLOWS SETTING UP THE PRINTER BEFORE PRINTING AND SENDING FORM FEEDS AFTER PRINTING. TO ATTACH EPUP TO YOUR WORDSTAR 2.26, COPY THE FOLLOWING FILES TO A FORMATTED DISC: WS.COM SUBMIT.COM XSUB.COM DDT.COM L2.PTH WSL2.SUB (ALWAYS USE COPIES - NEVER USE MASTERS!) AT THE CPM "A>" PROMPT TYPE THE FOLLOWING: SUBMIT WSL2.SUB AFTER YOU TYPE A CARRIAGE RETURN, SEVERAL PROGRAMS WILL LOAD AND RUN. THE FINAL RESULT WILL BE A FILE CALLED WSTEST.COM. TRANSFER WSTEST.COM TO YOUR WORDSTAR DISC AND TEST IT.(BE SURE YOU ARE USING A COPY OF YOUR WORDSTAR DISC. THE ORIGINAL SHOULD BE IN A SAFE PLACE.) TRY PRINTING A FILE TO SEE IF EPUP IS CALLED. IF THE PROGRAM WORKS, YOU CAN RENAME IT TO WS.COM. BE SURE TO START WITH AN INSTALLED WS.COM. IF YOU RUN INSTALL.COM IT WILL ONLY SAVE WORDSTAR. THE EPUP ROUTINE YOU JUST ADDED WILL BE CUT OFF AND YOU WILL HAVE TO DO THE WHOLE THING OVER AGAIN. WSLMOD2 - THIS PROGRAM IS USED TO MODIFY THE EPUP PROGRAM ATTACHED TO WORDSTAR. IT WORKS JUST LIKE EPUPMOD.COM EXCEPT THAT IT LOADS YOUR MODIFIED WORDSTAR INTO MEMORY INSTEAD OF JUST LOADING EPUP.COM. WHEN YOU RUN WSLMOD, YOU WILL BE PROMPTED FOR A CPM TYPE FILE NAME. RESPOND WITH THE NAME THAT YOU HAVE GIVEN TO WSTEST.COM. WSLMOD2.COM WORKS JUST LIKE EPUPMOD.COM SO SEE EPUP.DOC FOR DETAILS. IF YOU FIND ANY BUGS OR HAVE ANY COMMENTS, I CAN BE REACHED AT THE FOLLOWING ADDRESS: PHIL PFLAGER P.O. BOX 435 CUPERTINO, CALIFORNIA 95051 TRADEMARKS: CP/M IS A TRADEMARK OF DIGITAL RESEARCH WORDSTAR IS A TRADEMARK OF MICROPRO INTERNATIONAL EPSON IS A TRADEMARK OF EPSON AMERICA INC.