PSCREEN is copyright (c) 1986 Allegro Consultants, Inc. Written by Stan Sieler (sieler@allegrosupport.com) Version 96B PSCREEN copies all (or a portion) of the text on your screen to the printer or to a flat disc file. To run PSCREEN, simply type: RUN PSCREEN.group.account or: RUN PSCREEN.group.account;INFO="...options..." Here are 3 questions about PSCREEN you might ask... (1) where does the input come from? (2) where does the output go? (3) how many characters per line can PSCREEN handle? Funny that you should ask those questions...here are the answers... (1) The input comes from your CRT screen...but only if you have an HP terminal (or compatible terminal/emulator). By default, the entire screen's contents is read and printed. This was satisfactory in the days of old, when even the BEST HP terminals (264x family, sigh) could contain at most 12k bytes of display memory, and therefore were restricted to at most one or two hundred lines of text. With such a relatively small amount of display memory, users didn't mind that the older PSCREENs copied ALL of it to the printer! But...time & technology march on. Today, many people access the HP3000 via micro-computers running an HP terminal emulator (e.g.: Walker, Richer, and Quinn's REFLECTION). These often have THOUSANDS of lines of display memory...the older PSCREEN's simple minded copying of the entire screen is no longer acceptable. This PSCREEN allows you, optionally, to indicate the FIRST and LAST screen lines to be copied. This option is selected by running PSCREEN with a PARM of 1: RUN PSCREEN.group.account; PARM = 1 or: RUN PSCREEN.group.account; INFO="partial" Then, PSCREEN will prompt you to move the cursor to the LAST line to be printed, and then to the FIRST line to be printed. After printing this range, PSCREEN will move down to the end of your display memory and return control back to you. (2) The output of PSCREEN goes to a printer, whose formal name is 'PRINTER'. It may be file equated, if desired. (3) PSCREEN will read up to 8100 characters per input line. ================================================================= As you probably gathered from reading the above information, PSCREEN's options can be selected via the PARM parameter. Here is the complete list of PARM bits and their meanings. NOTE: every PARM option has a corresponding keyword, shown on the following line, which can be specified via an INFO string. PARM bit meaning -------- ---------------------------------------------------- 15 Partial PSCREEN wanted. If this is set, then PARTial PSCREEN will ask you to mark the last and first lines you want pscreened. 14 FLAT PSCREEN. If this is set, then PSCREEN opens a FLAT file whose formal name is "FLAT" with a default recsize of 80 bytes. At the end of copying the screen to this file, PSCREEN tries to lock it onto disc as a permanent file. If this fails, it tries to close it as a session temporary file. If this fails, you lose your pscreened data...sorry! 13 Suppress CHECKS. This bit tells PSCREEN to: NOCHEck 1) assume you have an HP CRT and that AUTO-LF is turned off already; 2) assume you know what you are doing if you are running PSCREEN from a batch job. You will typically never use this option...but it is here if you need it! If you encounter problems running PSCREEN any any HP terminal, please contact the author at: (408) 252-2330. 12 Want a clean screen (no summary output at end). NOSUMmary By default, PSCREEN prints a summary line after copying the screen. The NOSUMmary option (or PARM bit 12) suppresses this line of output. The FLAT option also suppresses it. 11 Strip display enhancement sequences. NOENhance (or STRIP) When this option is specified, the text read from the screen is examined for display enhancement sequences ("&dc" where "c" is one of: @, A,B,...,O). If such a sequence is found, it is dropped from the buffer before printing. 10 Append escape sequence at the ENHOFfeol end of any lines that contain escape characters. This solves the problem of LaserJet printers printing multiple lines that are underlined after the first line of screen text that had been enhanced. 9 Suppress copying the "stopper line" to the NOAUTHOR printer. By default, PSCREEN starts by displaying a "stopper line" to the screen. This line contains the time & date of the PSCREEN run, the PSCREEN version number, and the name of the author. By default, this will be copied to the printer UNLESS the NOAUTHOR option is specified (or PARM bit 9). Note: the default value of this setting has changed several times recently. It was changed to print the "stopper line" by default in version 89A at the request of some users. 8 \ ... > reserved, should be 0 2 / 1 This option tells PSCREEN to suppress any error QUIET messages that might be generated. AUTHOR This keyword (no PARM bit available) tells PSCREEN that you want the "stopper line" to appear on your printout. This keyword has been included for those users who WANT this feature, and are concerned that the default may change in the future. They can setup a UDC: PSCREEN OPTIONS = " " RUN PSCREEN.PUB;INFO="AUTHOR !OPTIONS" Option names may be abbreviated to simply the uppercase portion shown above. PSCREEN doesn't care if an option is specified via the INFO parameter or PARM bits. PSCREEN 20141023