&nbsp;................MAXIMUM AUTHORIZATION LEVELS BY APPLICATION....................<br />G/L (01):&nbsp;_&nbsp; A/P (02):&nbsp;_<br />&nbsp; SPLR(48):&nbsp;9&nbsp; SEC.49:&nbsp;9&nbsp; PROG(50):&nbsp;9<br />Press PF4 for browse (LOC)SCREEN&nbsp; Press PF13 for Hardcopy<br />Press PF16 for Copy field to buffer&nbsp; Press PF17 to Paste data from buffer<br />Press PF2 for field-level HELP<br />```** <br />Figure 01 --&nbsp; Device Control Screen<br />## <br />RPH File<br />The RPH file contains control and status information about every spooled report. The file has a maximum capacity of (cont.)<br />99,999 Report Header records; thus, the TP Spooling System can accommodate up to that many Spooled reports at any given (cont.)<br />time. The usual configuration is with 999 Report Header records activated with the remaining numbers held in (cont.)<br />reserve.<br />The only key to this file is Report Number. As reports are spooled they are assigned Report Numbers, starting with 001 (cont.)<br />and incrementing up to the maximum (usually 999) then "wrapping" back to 001. As each new report is STARTed and its (cont.)<br />number is assigned, the appropriate Report Header record is updated with the parameters specified by the originator (cont.)<br />program.<br />This file does not contain spooled print data. That data is on the Spool file (SPL file). The Report Header record (cont.)<br />"points" to the record on the SPL file where the actual report data begins and also to where it (cont.)<br />ends.<br />When a report is "flushed", usually after being printed, the Report Header record is cleared and all the SPL file records associated with the report are "freed" for subsequent use by other reports.<br />Inquiry, browse, and partial update capabilities are provided via the online function codes:<br />**<br />RPHSEE<br />**<br />SEE a report header<br />**<br />RPHCHG<br />**<br />CHanGe a report header<br />**<br />RPHLOC<br />**<br />LOCate a report header<br />**<br />RPHLST<br />**<br />LiST report headers for this LOCATION<br />RPHLOC requires a Level 9 authorization.<br />RPHLST must be done from a device which is defined to the DVC file, even if you are a Level 9.<br />RPHCHG and RPHSEE must be done from a terminal which is defined to the DVC file unless you are a Level 9. They will only access Report Headers routed to the same LOCATION as the terminal you are at.<br />## <br />RPH File Maintenance<br />Real-time access to Report Header data is provided using the Report Control Screen shown in Figure 02.<br />The key value in SKEY is a 4-digit report number.<br />**Report Number** is not enterable, it is where the system displays the Report Number on inquiries.<br />**Desc** is where the report description (up to 30 characters) is displayed, you can alter it here also.<br />**Origin** is where the system displays the terminal-id of the device which originated this report. It is not enterable.<br />**Location** is the 3-character location code to which this report is directed. The value in this field will be validated against MAGEC Lookup Table # 252. You may alter it here.<br />**Class** is the print class of this report, you can alter it here. Any alphabetic or numeric character will be accepted.<br />**Form** is the 4-character form code (or number) on which this report is to be printed. A value of blanks indicates that it may be printed on whatever paper happens to be on the printer.<br />**Disposition** is the report disposition, you may alter it. The report disposition obviously has a significant impact on the actions taken by the Spooler. Valid values are:<br />**<br />F<br />or<br />FLUSH<br />**<br />Flush the report to recapture space<br />**<br />H<br />or<br />HOLD<br />**<br />Don't print/Don't flush<br />**<br />D<br />or<br />DELETE<br />**<br />Print report then flush it<br />**<br />L<br />or<br />LEAVE<br />**<br />Same as HOLD<br />**<br />K<br />or<br />KEEP<br />**<br />Print then set to LEAVE<br />**Copies Requested** is the number (00 to 99) of copies of this report which are requested. The first time a report is (cont.)<br />printed is considered "original" and subsequent printings are considered "copies"; thus a value of 99 will result in (cont.)<br />the report's being printed 100 times, 00 will cause it to print once. You may alter this.<br />**Copies Printed** is not enterable, it is where the system displays the number of times a report has been printed thus far.<br />**Status**** **is not enterable, it is where the current status of this report is displayed. Possible values are:<br />**<br />SPOOLING<br />**<br />In process of being spooled<br />**<br />DONE<br />**<br />Done printing, waiting to be flushed<br />**<br />READY<br />**<br />Spooled, ready to print<br />**<br />PRINTING<br />**<br />Being printed at a device<br />**<br />PRINTED<br />**<br />Through printing (at least once), waiting to be reprinted<br />**or set to DONE status<br />FLUSHED<br />**<br />All resources returned to system, all records released for re-use.<br />**Printer Trmid** is the Terminal ID of the device on which this report is printing or has been printed. Not alterable.<br />**Number Of Spool Records** is not enterable, it is a display of the number of SPL file records used to hold this report.<br />**First** is not enterable, it is the record number of the first SPL file record for this report.<br />**Next** is not enterable, it is the record number of the SPL file record next-in-line to be printed at the device. It can only have a non-zero value while the report is printing.<br />**Last** is not enterable, it is the Record Number of the last SPL file record used to contain this report. Note that (cont.)<br />SPL file records are not necessarily used in any particular sequence and that it is perfectly normal for the "last" (cont.)<br />record to be a lower number than the "first" record, or vice-versa.<br />**Lines of Print** is not enterable, it displays the number of lines of print in the report.<br />**Pages of Print**** **is not enterable, it displays the number of pages of print in the report.<br />**<br />NOTE:<br />**<br />On the RPHSEE function the operator may transfer to a display of the beginning of the actual report data, then use PF8 (cont.)<br />to "chain" forward and PF7 to "chain" backward through the report, which is stored on the SPL file.<br />| ```<br />**<br />RPH... rrrr<br />&nbsp; M A G E C<br />TP SPOOLING REPORT CONTROL SCREEN<br />REPORT NO rrrr DESC:...................... ORIGIN:....<br />LOCATION: ... CLASS: . FORM: .... DISPOSITION: ..........<br />COPIES REQUESTED: .. PRINTED ..<br />STATUS= ........ PRINTER TRMID ....<br />NUMBER OF SPOOL RECORDS ..... FIRST=.....,NEXT=.....,LAST=.....<br />LINES OF PRINT=....<br />PAGES OF PRINT=....<br />Hit PF6 to view the report<br />```** <br />Figure 02 --&nbsp; Report Control Screen<br />## <br />SPL File<br />The SPL file is where the actual reports are stored. As print lines are spooled (via the Spool Subroutine) they are (cont.)<br />compressed and "blocked" to conserve space. A "block" (one SPL file record) consists of up to 1,920 characters of (cont.)<br />report data plus 20 characters of SPL record ID and "chaining" information.<br />The SPL file consists of a fixed number (usually 15,360) of preinitialized records, plus one control record for (cont.)<br />maintaining status of the system and each of the SPL file records. The possible statuses for a SPL file record are (cont.)<br />:<br />AVAILABLE<br />&nbsp;<br />IN USE<br />&nbsp;<br />Initially, of course, all of them are AVAILABLE. When a report is spooled it occupies one or more SPL file record(s), (cont.)<br />these are marked IN USE as thay are used. When that report is flushed, then all the SPL file records which it formerly (cont.)<br />occupied are marked AVAILABLE once again. They may then be re-used to contain other reports' data.<br />Any number of SPL file records may be used by a report, they are not necessarily used in any particular sequence. As a (cont.)<br />report is spooled it obtains (and occupies) SPL records one by one as needed depending on the size of the report. Any (cont.)<br />number of concurrently active tasks may be spooling at any given time.<br />SPL records are identified (keyed) by Ordinal Record Number, a numeric value from 00001 through the maximum (usually 15,360).<br />As each report being spooled needs another SPL record it is given the lowest SPL record which is AVAILABLE. In a (cont.)<br />multi-tasking environment where records are being used and released by many concurrent tasks this means that the second (cont.)<br />record (or subsequent records) might very well have a lower number than the first record. In order for the Spooler to (cont.)<br />be able to "navigate" from the first to the second and so on, a technique of "chaining" is employed. As each SPL record (cont.)<br />is used for the report it is updated to contain the Record Number of the Prior (last) record and the Next record for (cont.)<br />this report.<br />The actual report detail data stored in each SPL file record is compressed (trailing blanks truncated) and contains some special control characters which have meaning to the online printer:<br />**<br />FF<br />**<br />Form Feed<br />**<br />NL<br />**<br />New Line<br />**<br />NULL<br />**<br />Null (Idle), non-printing "padding"<br />Online inquiry into the SPL file is provided via the function codes:<br />**<br />SPLSEE<br />**<br />SEE a Spool record<br />**<br />SPLNXT<br />**<br />See the NeXT Spool record<br />**<br />Program Function keys (PF keys) are used to move about within the report you are viewing. The display screen presented (cont.)<br />contains the Identification and chaining data as well as the actual spooled report detail data, plus PF key (cont.)<br />instructions.<br />**<br />The SPLSEE/SPLNXT display shows reports approximately as they will appear when printed (if, that is, you decide to (cont.)<br />actually print them). The major difference is that the amount of data displayed is limited by the width and length of (cont.)<br />the screen (24 by 80). Therefore, these functions include PF keys to control scrolling up and down and left and (cont.)<br />right.<br />PF8 will scroll forward a screenful at a time<br />PF7 will scroll backward a screenful at a time<br />PF20 will scroll forward one line at a time<br /><br />next: splr03.md.txt