Home

HP Printer E0495 User's Manual

1. CI gt lpalt ice 9 bokonon dplan new request id is plan 9 m Send mail to the user that created the request when the request is printed The system on which the request is printed must support Internet mail on the HP 1000 this is provided by the Mail 1000 system ncopies Change the number of copies to print of each file copies must be an integer from 1 to 32767 ooption Change the interface specific options to be passed to the printer interface used to print the request More than one o option may be given to pass more than one option Any existing options on the request are removed See the documentation on the destination printer interface program or routine for the options that it supports Because RTE case folds the 1p runstring by default and because most options are lowercase lpalt reverses the upper or lowercase of each character in the option For example if a printer interface accepts option BSDp the lpalt runstring from CI might be CI gt lpalt mach 5 o bsd p ppriority Change the priority of the request an integer value from 0 to 7 Higher values indicate higher priority for the request This value is used in determining the order in which requests are printed 2 22 LP Spool System lpalt s Suppress informational messages such as new request id is ae t title Change the title to be printed on the banner page of the output The title must be less than 80 characters and must be sur
2. Return Status lpadmin returns the following status RETURNI the number of errors encountered zero if none Examples CI gt lpadmin pp2608 mgeneric v114 Add a new local printer named p2608 to the LP spooler The printer device resides at LU 114 the generic printer model is used to print to the device CI gt lpadmin pp2608 v115 clocal Change the device LU of printer p2608 to LU 115 and insert the printer into class local CI gt lpadmin prlj3d mrhpux ormhpdsorte orplj3d Add a new remote printer named rlj3d to the LP spooler The remote printer is connected to printer 1 3d on HP UX host hpdsorte The rhpux printer model is used to transfer requests to the remote printer Error Messages lpadmin Expected p x or d parm The first option in the runstring must be one of these options lpadmin printer names may not contain dash A dash is illegal in printer names lpadmin invalid priority parm An invalid priority was given in the g option Priorities must be an integer from 0 to 7 lpadmin rinter printer is not a member of class class Pp Pp The r option was given to remove the printer from a class but the printer is not a member of that class lpadmin rinter printer is already a member of class class p p P y The c option was given to insert the printer into a class but t
3. User Programs lp lpstat cancel Creates a request that the LP spool system print the files specified Prints status information about the LP spool system Removes requests from the LP spool system If a cancelled request is currently active on a printer the printing is aborted and the printer is free to print another request Alters various parameters of an existing request such as request priority number of copies and so forth The request must reside on the local system and must not be actively printing System Administration Programs lpadmin accept reject enable disable lpsched lpshut lpmove lpfence Can be used to add or modify a printer delete a destination or set the system default destination Allows print requests to be submitted to the named destinations Prevents print requests from being submitted to the named destinations which may be the names of either printers or classes Allows a printer to print requests queued for that printer or for a class of which the printer is a member Disables the named printers preventing them from printing requests sent to the printers or to classes of which the printers are members Starts the LP spool system allowing it to print requests Shuts down the 1psched program the scheduler for the LP spool system Moves requests from one destination to another Sets the fence priority for a printer The fence priority is the minimum priority
4. 130 Deactivate printer lj0 specifying reason Changing paper LP Spool System 2 11 disable Error Messages disable printer printer was already disabled The named printer was already disabled disable missing trailing quote parm A leading quote was found for the reason string but no matching trailing quote was found 2 12 LP Spool System enable enable The enable program allows a printer to print requests queued for that printer or for a class of which the printer is a member The runstring for the enable program is as follows CI gt enable printer printer Each named printer is enabled New printers added to the LP spooler are initially disabled The enable and disable programs affect only the local spool system Only the local operation of a remote printer is modified A disabled remote printer will not transfer requests to the remote host but the operation of the printer on the remote host is unaffected The enable and disable programs are identical executables one program may be made a copy of or a symbolic link to the other Return Status The enable program returns the following status RETURNI the number of errors encountered zero if none Example CI gt enable vice Activate printer vice Error Messages enable printer printer was already enabled The named printer was already enabled LP Spool System 2 13 lp lp The lp
5. Set the right margin column Esc amp a__M PCL2 Set the top margin line Esc amp l_E PCL4 Turn line wrap on wrap or off nowrap Esc amp s0C PCL4 Turn perforation skip mode on perfskip or off noperfskip Esc amp l1L PCL1 LP Spool System 2 55 e Paper Source available paper sources vary by printer model upper Feed paper from upper tray Esc amp ll1H PCL4 lower Feed paper from lower tray Esc amp l4H PCL4 man or m Feed paper from the manual feed slot Esc amp 12H PCL4 envelope Feed envelope from the manual feed slot Esc amp 13H PCL4 deck Feed paper from the paper deck Escg 15H PCL4 The passthru Interface This interface is for use by devices that are not printers or by printers that are not controlled via the standard RTE printer interfaces All HP plotters that do not have text printing capability fall into this category There is only one model file associated with the passthru interface that model file is also named passthru No processing of the data stream or meddling with the output is performed by this interface the print output is sent as is to the device This is similar to the effect of the raw option supported by many of the other interfaces Transparency or honesty mode is always used in the device driver if one exists for the device See the RTE A Driver Reference Manual part number 92077 90011 for more information on the operation of the various RTE device drivers and on the transparency or
6. Last Addr 36441 Min Part 37 EMA WS 20 Mseg 1 VMA O CI gt sz spget 30 CI gt sz spget Last Addr 36441 Min Part 47 EMA WS 30 Mseg 1 VMA 0 CI gt sp in Maximum Spool Files 112 To increase the spool file limit change the E VMA size of SPGET Spool System Initialized Spooling uses a SPOOLINFO file and creates spooling files on the global directory SPOOL If this global directory does not exist when the SP IN command is given SP creates it on the same LU as the current working directory It is suggested that you create this directory on the desired disk Then SP will use this directory for its SPOOLINFO and default spool files Occasionally the spool system may get lost beyond repair Even attempts to shut down are ignored To force spooling to shut down you may do the following 1 Wait for all ongoing useful spool activity to complete That is if outspooling is still working or a session is still successfully spooling allow it to continue 2 Using the CI OF command off the programs SPGET and SMP 3 Off any hung OUTPT programs They will be renamed to reflect the LU to which they are outputting for example OUTP6 outputs to LU 6 and OUT35 outputs to LU 35 4 Purge the file SPOOL SPOOLINFO SPL 5 Restart spooling by entering SP IN Programmatic Spooling For information on programmatic spooling using the SP spool system refer to the RTE A Programmer s Referen
7. Print 3 copies of files black 1st and aybe c on destination lj3p specifying printer interface option cc CI gt lp t draft copy lt files txt Print each file named in file files txt on the default destination using the banner draft copy The lpalt and lp programs are identical executables Only one of these program files needs to be a type 6 executable the other may be for example a symbolic link to the type 6 file or a prototype ID segment for the type 6 file LP Spool System 2 15 lp Error Messages lp lp Lp Lp lp lp Lp Lps no files to print specified No files to print for the request were given in the runstring you must enter a destination no system default No destination for the request was given using the d option and you do not have a default destination set in the LPDEST environment variable and no system default destination has been set The system default destination may be set using lpadmin Destination dest is not accepting submissions the reason is reason not accepting requests The destination rejects new submissions The second line gives the reason set by the system manager when the destination was made to reject submissions The destination can be made to accept requests by using the accept program destination dest non existent The named destination does not exist To display a list of the valid destinations enter I
8. To select the information shown by user name see the u option By default all requests are shown An example listing is 13 169 emo priority 0 Mar 25 3 14 pm lp lod 2 copies 3 records lp help 2 copies 93 records on printer 133 13 11fthpdsorte samantha priority 0 Mar 25 3 34 pm hpgl2 77212 bytes The above example shows that request ID lj 169 generated by user emo on the local system is currently printing on printer 13 Request ID lj 11 hpdsorte which was entered by user samantha on remote host hpdsorte is queued waiting for an available printer The names of the files included in the request are indented beneath the line displaying the request ID The size of an RTE format file is printed in records the size Of a file spooled from UNIX is printed in bytes The number of copies to print is only displayed if more than one copy is being printed The time shown is the time the request was entered into the local spool system If the request was entered from a remote system this is not the time the request was originally created on the remote host If the destination name or the destination portion of a request ID in the list parameter names a remote printer both local and remote status may be displayed Local requests that match the list are shown first followed by a listing of requests in the queue for the remote printer that match the list Remote status display may be inhibited by specifyin
9. honesty mode processing No data or control requests other than those specified in the print data are sent to the device No banner page is printed no page ejects control requests or device resets are performed by the interface Printer interface options may be specified in the 1p program runstring preceded by a o This interface supports the following options e Device Handling ke The files include EXEC control word headers The files must have been created by the ON command of the SP spooler with the KC option specified These headers specify the control word flags that were used in the redirected EXEC XLUEX writes and preserve information on control requests that were sent to the redi rected device This option has no effect on type 1 files e Other hold Suspend operation before and after printing the request while the printer LU is locked to the lpout program Both times lpout prints a message on the system console of the form prog suspending per user request enter GO prog to resume where prog is the program name of the 1pout copy that is suspending The copy of lpout handling the print operation remains in the paused state until an RTE GO command is issued for that program name In this manner adjustments to the printer such as forms loading may be performed before and after the request is printed 2 56 LP Spool System Remote Printers and Network Peripherals The remote printer interface remote s
10. the RTE A Driver Reference Manual part number 92077 90011 for more information H This option specifies whether or not to print the identifying header before each file printed The header option overrides the defaults in the FFL module set by the system installer at load time Specify H OFF to suppress the identifying header The format of the option is H ON OFF l This option indents each line by the specified number of spaces The default number of spaces is five The format of the option is Iin 4 4 The PRINT Utility L This option specifies the number of characters per line in the banner headline The characters per line option overrides the defaults in the 9 FFL module set by the system installer at load time For example specify L 120 for a banner headline of 120 characters The number of characters per line should exceed the number of spaces between headline characters by at least 6 see the Y option The format of the option is L n M This option merges successive files with the specified number of blank lines between them The default number of blank lines is zero The format of the option is Min N This option produces a numbered listing for each file in the runstring The format of the option is N O This option sends each file listed in the runstring to a specified destination Use the O option to transmit output to other files including files on remote system
11. value that a request must have to be printed on that printer 2 6 LP Spool System accept accept The accept program allows print requests to be submitted to the named destinations The runstring for the accept program is as follows CI gt accept destination destination where destination is the name of a printer or class to which you want print requests to be submitted After running the accept program new print requests are allowed to be submitted to the named destinations No print requests may be entered for a destination that is rejecting submissions until the accept program is run for that destination New printers and classes added to the LP spooler initially reject submissions You must be a superuser to run this program The accept reject and lpshut programs are identical executables Only one of these program files needs to be a type 6 executable the other two may be for example symbolic links to the type 6 file or prototype ID segments for the type 6 file Return Status The following status is returned RETURNI the number of errors encountered zero if none Example CI gt accept charges Accept requests for destination charges The accept program affects only the local spool system Only the local operation of a remote printer is modified A remote printer that rejects submissions will not accept requests for transfer to the remote host but the operation of the prin
12. Also check file usr spool lp log for error messages related to the printer Problem Remote printers on other hosts cannot access the printer on my HP 1000 If r1pdaemon logging is enabled check file usr spool 1lp 1lpd log for error messages logged by the HP 1000 network printing daemon If logging is not enabled you may wish to enable it Logging is enabled by specifying the 1 option in the r1pdaemon runstring in file etc inetd conf Remember to tell inetd to re read that file after changes are made by entering inetd c Common entries in the 1pd log file are discussed in the following items destination dest is not accepting requests An attempt was made to enter a request for a destination that rejects new submissions The destination can be made to accept requests using the accept program destination dest non existent An attempt was made to enter a request for an invalid destination name Check the name of the remote destination on the host that tried to transfer the request On RTE and later HP UX systems this is reported by entering lpstat v IP address not found in etc hosts mnn nn nn nn The IP address of the remote host is not present in the etc hosts file The spool system needs this information to map addresses to a list of host names for matching against the host names in request IDs Each host that sends network spooling requests to the local system should be present in the etc hosts file N
13. FMP error was encountered when retrieving the local host name from the named file 2 24 LP Spool System lpfence lpfence The lpfence program sets the fence priority for a printer The fence priority is the minimum priority value that a request must have to be printed on that printer The runstring is as follows CI gt lpfence printer priority Priority values are from 0 lowest priority to 7 highest priority Only requests with the given priority or greater are printed on the named printer A request that could otherwise be sent to the printer but that has a priority lower than the fence is sent to the printer once the priority fence is lowered or the request may be sent to another member of the destination class This command affects only the local operation of a remote printer The fence setting on the remote host may be different than that of the local system You must be a superuser to run lpfence The lpadmin and lpfence programs are identical executables Only one of these program files needs to be a type 6 executable the other may be for example a symbolic link to the type 6 file or a prototype ID segment for the type 6 file Return Status lpfence returns the following status RETURNI the number of errors encountered zero if none LP Spool System 2 25 lpmove lpmove The lpmove program moves requests from one destination to another The requests leave the queue for the former destination and join t
14. LAN via an HP JetDirect card e hpnp_passthru for printing on plotters connected to a LAN via an HP JetDirect card Each of these models is discussed separately in the following sections The protocol used to transfer print requests to a remote host is based on the Line Printer Daemon Protocol LPDP a de facto standard but not formally standardized protocol documented in Internet RFC document RFC 1179 The LPDP protocol is used to send requests to BSD UNIX hosts via the rosd model Certain extensions to the protocol implemented in HP UX are used in the rhpux model The rrte model implements further extensions that preserve RTE FMP file attributes and offer better performance by avoiding conversions between UNIX and RTE file formats The remote interface disables the printer if network or protocol errors are encountered during the transfer The print request being transferred at the time of the error remains in the request queue The request is retransmitted in its entirety to the remote host once the printer is re enabled The rrte Model The rrte model is used for transferring print requests to a remote RTE host The remote RTE host must also run NS ARPA 1000 and the LP spool system There are no options that are interpreted by the rrte model LP Spool System 2 57 The rhpux Model The rhpux model is used for transferring print requests to a remote HP UX host The remote host must run the HP UX LP spool system This model support
15. LU 8 following the chain of LU redirections Note that only one chain of LU redirections is followed For example if LU 8 above were redirected to another LU output sent to LU 6 would still be sent to LU 8 without following the next link in the chain To inhibit the chaining feature use the DC option of the ON command For example CI gt sp on 6 7 de CI gt sp on 7 6 de In the above output sent to LU 6 is sent to LU 7 and output sent to LU 7 is sent to LU 6 If the DC option were not used output sent to either LU would in effect not be redirected because the chain of redirections would redirect the output back to the same LU Spooling LU Output In order to set up a spool file to a particular LU the ON command is again used This time no redirection LU is specified and if no file name is specified a default output spool file is created by the spool system Any output to the LU is then stored in the default file until the spool system is again entered and the output is terminated using the OF command At that point all of the output is immediately spooled from the default file to the LU The following example shows how to spool all output for LU 6 to a default spool file CI gt sp on 6 Spooling started from LU 6 to OUTSPOOLO1 SPL SPOOL CI gt co boot cmd system 6 CI gt co temporary file texts 6 CI gt co letternine txt texts 6 CI gt sp RTE A Spooling System Type for help st Spool File
16. Problem The printer is disabled or in retry status when it is accessed Check the reason as reported by lpstat p for which the printer is disabled or is retrying requests Some common reasons are discussed in the items that follow new printer The printer has never been enabled after being added to the spool system If the printer is ready to print enable it using the enable program interface program aborted lpsched noticed that the interface program used to print requests on the printer usually either lpout or r1pout aborted without properly telling 1psched the request was complete Check the system console for an abort message e fmp_error program An FMP error was encountered when RP ing the printer interface program 2 46 LP Spool System violation error scheduling program An EXEC error was encountered when scheduling the printer interface program idget error on interface program The printer interface program immediately disappeared after lpsched RP ed a copy Ensure that nothing in the system either aborts or schedules copies of the interface programs that lpsched RP s lurq error violation An EXEC error was encountered by the printer interface program when attempting to lock the device LU Check that the LU is legal violation error on xluex code An EXEC error was encountered by the printer interface program when performing an XLUEX call on the device LU Check that the LU is legal
17. Status Reference gel Filename OUTSPOOL01 SPL SPOOL Owner SCOUT Session 1 Spool LU 56 Status Actively spooling Approx Lines 21 of 6 Spooling terminated from LU 6 to OUTSPOOLO1 SPL SPOOL st Spool File Status Reference s T Filename OUTSPOOLO1 SPL SPOOL Owner SCOUT Session 1 Spool LU 156 Status Outputting to device Approx Lines 21 3 4 SP Spool System The spool file OUTSPOOLO1 SPL SPOOL can be restarted or purged from the spooling system using the RE or PU commands If purged the file itself is removed If errors are encountered messages and suggested solutions are displayed from the spool system You may specify your own file to replace the default file of OUTSPOOLO1 SPL SPOOL in the ON command In this case spooling output is queued into the specified file When the OF lu command is then issued the output does NOT automatically begin at the LU Only in the case of a default spool file name is output automatically sent from the file to the LU when the OF command is issued To output the file to the re directed LU the spool LI command may be used ST Command Listing Format If you specify the ST command the status is displayed in the following format LU redirections for session 93 5 gt 6 8 gt 9 Spool File Status Maximum Spool Files 59 Reference 52 Filename SRC ARF EMO Owner TODD Session 93 Spool LU 6 Status Actively Spooling Approx Lines 0 If
18. The LP spool system supercedes most of the printing capabilities of the other two spoolers SP and PRINT described in Chapters 3 and 4 Chapter 3 Describes the SP spool system The CI SP command had previously been docu mented in the RTE A User s Manual part number 92077 90002 Chapter 4 Describes the PRINT utility PRINT had previously been documented in the RTE A Utilities Manual part number 92077 90004 5 6 Table of Contents Chapter 1 Introduction Chapter 2 LP Spool System O O a 2 1 Output Destination a oa 2 2 Local Printers Sule joes A A A A 2 2 Network Peripherals sorrara ree E te oaa yea Meee htatvines mes aa e 2 2 Remote Printers RS nai ian AREA EEEE ATE 2 3 Printer Interfac s A A o pn p es ARA A AR 2 3 Printer Model Piles SA A A AR ARA A A 2 3 Printer CSS A A EA AAA A 2 4 Destination Availability A A Bees e 2 4 spooled File Formats A A re 2 5 EP Spool System User Interface ra cad 2 6 CCSD A a A e e a ba E AAEE 2 7 CAC A A e eto e to Glin ae vd 2 8 E SA A ee 2 11 O 2 13 A renee ener a eer are 2 14 padmini A aoe a 2 18 Dab ticda ite Cate ea tela acetal eesti asa aa daha ceeds dash a Ge aS eee 2 22 PESA ta eta eka eh eek eta da stand Ged a Seen ea aA Gg a tee eae 2 25 O 2 26 A Se eae Bors Sale Seas del ek a ae ee Sele OR oe a TA 2 28 phutan E Seed Re he 6 Rl ode ty aint ae Adie Deca Naas Lok 2 30 A as hcel ple lacanusteld a ate A aie wecwemecatatelecacneleles 2 31 O E teas aa iaa a i 2 35 LP S
19. allocating a sequence number for the request ID The second line gives the FMP error lpalt you do not own requestid You do not own the request being altered You must be a superuser to alter another user s request LP Spool System 2 23 lpalt lpalt request requestid is active on printer The request is actively printing on a printer Active requests may not be altered To alter the request you may disable the printer on which it is printing alter the request and re enable the printer This will reprint the request in its entirety lpalt no such request requestid The given request ID does not exist Enter lpstat o for a list of requests lpalt invalid of copies parm An invalid number of copies was specified in the n option It must be an integer from 1 to 32767 lpalt invalid priority parm An invalid priority was specified in the p option It must be an integer from 0 to 7 lpalt missing trailing quote parm A matching double quote was not given for the parameter of the t option lpalt unknown option parm An unknown option name was given lpalt warning lpsched is not running The request was modified but the scheduler 1psched is not running The request will not be printed until the scheduler is started lpalt warning violation error scheduling lpsched The lpsched program could not be scheduled lpalt warning fmp error usr spool lp hostname An
20. in the welcome file at boot time The runstring is CI gt lpsched pq where pq An optional parameter that causes a running lpsched to process the remote job queue immediately See below for more information lpsched takes requests from the LP spool system queue and sends them to the appropriate printer When lpsched is not running new requests may be created but the requests are not printed locally or sent to remote printers until lpsched is started 1psched is normally started at system boot time in the welcome file 1psched is shut down by the lpshut program All LP spool system programs continue to function while 1psched is shut down lpsched need not be scheduled without wait via the CI XQ command it allows the scheduling program to continue after lpsched initializes lpsched keeps a log of its activity in file usr spool 1lp log You may wish to periodically purge this file to conserve disk space If file usr spool 1p jobdone cmd exists lpsched runs CI with wait on it each time a request successfully finishes printing before the request files are purged The request ID of the request printed is passed in 1 If lpsched is restarted after being aborted by a means other than the lpshut program it attempts to stop any printing activity it started before it aborted If the print requests it terminates are still present in the queues the requests are restarted When lpsched is run to start the LP spool system it returns
21. is a registered trademark of UNIX System Laboratories Inc in the U S A and other countries LP Spool System 2 3 Printer Classes A class of printers may be defined in the LP spool system A printer class is a named collection of local printers of similar type For example if a host has two printers connected a LaserJet Plus and a LaserJet III then class laserjet could be created with both printers as members of the class If a print request names a class rather than a specific printer as the desired destination then the request is printed on the first available member of the class Thus specifying destination laserjet in a request on our example host prints the request on either the LaserJet Plus or the LaserJet III depending on which printer first becomes available A printer may be a member of only one class Neither remote printers nor network peripherals may be made members of a class Classes are created and deleted using the lpadmin program Many programs in the LP spool system accept parameters called a destination A destination may be either the name of a printer or the name of a class Destination Availability Each destination either a class or printer on a host may be set to either accept or reject new requests At the time a new destination is added to the system it is initially set to reject submissions If an attempt is made to enter a request locally via the LP program or from a remote host the new request
22. number of services and options related to printing formats are provided such as generating banner pages at the start of the output downloading printer fonts and so on There are three spoolers on RTE A e The LP spool system which supports local printers network peripherals and network printing between HP UX and other RTE systems via NS ARPA 1000 The user interface is very similar to that of HP UX allowing users who work on both RTE and HP UX instant familiarity with the other system e The SP spool system This is the system historically known as the VC spooler Most of the printer spooling capabilities of this system are superceded by the LP spool system but are retained for backward compatibility The SP spool system continues to provide the only support for LU redirection diverting output from an LU to a file system error logging and built in support for magnetic tape devices e The RTE A PRINT and PRINO programs which spool files to printers This is the only spooler available without VC Each of these systems can coexist without interfering with the operation of the others Because the output device LU is locked to the program performing the output all three systems may simultaneously attempt to access the same device without disrupting the output of another system The following chapters describe each of the spoolers in detail Introduction 1 1 LP Spool System The LP spool system is a printer spooler for
23. output is performed by this interface the print output is sent as is to the device This is similar to the effect of the raw option supported by many of the other interfaces No data other than the print data are sent to the device No banner page is printed no page ejects or device resets are performed by the interface This model supports the following options e Networking portnn Specify the TCP port number to use when connecting to the network peripheral The default port is 9100 which is the default port used by HP JetDirect network peripherals 2 60 LP Spool System Custom Printer Interfaces This section documents how to modify the HP supplied printer interfaces and printer model files You may also create your own printer interfaces for non HP printers Printer Model File Format Each printer model file contains a set of commands in line 1 the remaining lines are comments The commands in line 1 are a string of keywords and arguments each separated by a blank The commands are intf interfacename Print using the named printer interface The interface name must be recognized by the copy of the lpout program scheduled See the next section for a list of printer interfaces supplied with the LP spooler If this keyword is not given then interface rtestd is used for local printers or interface remote for remote printers exec program Schedule the named program to handle the request By default program lpout is sched
24. regardless of where the LU number appears in the runstring You may enter a file mask in the runstring and you may combine several features into a single runstring as shown in the section on PRINT Examples PRINT Options You can place PRINT options anywhere in the runstring provided a plus sign or a minus sign in the case of the B option precedes each one Options entered once apply to all files entered in a runstring The B T and W options can be entered more than once in a runstring Table 4 1 summarizes the available options The PRINT Utility 4 1 4 2 Table 4 1 PRINT Options Summary output filename string ON OFF n ON OFF output filename filename working directory The PRINT Utility Returns a short explanation of available options Appends the output to a specified file instead of an LU Prints the specified string as a banner headline Do not print a banner Sets the carriage control option ON or OFF Advances paper the specified number of pages after all files are printed Print ON or do not print OFF the header before each file that is printed Indents each line by the specified number of spaces Specifies the number of characters per line in the banner Merges successive files with the specified number of blank lines between them Produces a numbered listing for each file in the runstring Sends each file listed in the runstring to a specified destination Purges p
25. the 1p_remotein and 1p_remoteout variables if this host requires only one direction of network printing Only set this variable if your system has the ARPA 1000 or NS ARPA 1000 networking subsystem installed Set to T if you want to install incoming remote printer support only This variable should be set to T if this host must receive requests from remote hosts but does not require sending requests to remote hosts or network peripherals Only set this variable if your system has the ARPA 1000 or NS ARPA 1000 networking subsystem installed Set to T if you want to install outgoing remote printer support only This variable should be set to T if this host must send requests to remote hosts or network peripherals but does not need to receive requests from remote hosts Only set this variable if your system has the ARPA 1000 or NS ARPA 1000 networking subsystem installed Set to T if you want to update the help files and the lp directory structure The SRTE_USR spool 1lp directory is created The help files in SRTE_HELP are updated The default is T Directory in which help files are to be placed The default is help Directory in which the loader will search for libraries The default is libraries Set to T if you want symbolic links to be created for program files that may be made symbolic links to other program files Otherwise copies of the program files are made using th
26. the attributes listed in Table 4 2 edit and compile amp FFL then link PRINT and PRINO using PRINT and PRINO The PRINT PRINO command files and the amp FFL module all reside in the directory RTE_A Note The amp FFL module requires the HP 92836A FORTRAN 77 product in order to customize it for the PRINT utility The FORTRAN 77 product is an optional product and is not available on the system unless purchased separately Table 4 2 shows the amp FFL variables their defaults and the corresponding PRINT runstring options that can be used to override the value set in amp FFL These variables exist in data statements in the amp FFL module Table 4 2 amp FFL Variables rt PRINT een defbanner Should a banner be printed before each file header Should a header be printed before each file numffs How many form feeds belong at the end of the listing outputlu Default printer LU printmsgquiet Should message Print job supervised by PRINX be suppressed printerlength How many spaces per line sent to the line printer filelength How many spaces per line sent to the file printerbanspace How many spaces between banner characters filebanspace How many spaces between banner characters The PRINT Utility 4 11 A listing of the amp FFL module is given below ftn7x 1 3 S C NAME FFL SOURCE 92077 18067 RELOC 92077 16067 PGMR sb E KKKKKKKKKKKKKKKKKKKKKKKKKKKKKKKKKKKKKKKKKKKKKKKKK AAA
27. the new printer model file for the printer The argument must be an existing model file name within the usr spool lp mode1 directory List that directory to see the model files available For example mpc1 selects printer model file usr spool lp model pc1l rclass Remove the printer from the named class If the printer was the last member of that class the class is removed vlu Set the LU number of the printer device 0 to 255 This value is ignored for remote printers If not specified the LU is 0 The following setopts are used for remote printers and network peripherals ormhost Identify the name of the remote machine where a remote printer resides For network peripherals such as those on JetDirect cards this is the name of the network peripheral In general this is the name in the etc hosts file that may be mapped to the IP address of the remote host or network peripheral orpprinter Identify the name of a remote printer as known on the remote machine that is the name by which the printer is known on the remote host This name may be a class name on the remote host The name will be converted to all lowercase characters and may be up to 14 characters long If not specified the local printer name will also be used as the remote name For network peripherals no value for this option is required because this name is not used in this case However entering a meaningful name that adds to the information shown by
28. the originating session has logged off the session may show 0 The status field can contain any of the following Actively spooling All I O destined for the spool LU is being routed spooled to file name specified Actively spooling disk full Same as above but the disk is full or some other error has occurred Attempts to continue writing to this LU will result in 1024 errors Outputting to device Data in the file name specified is being routed to the spool LU Queued for outspooling Data in the file name specified is waiting to be routed to the spool LU Waiting downed device Output is suspended on a downed LU The line count field contains the current number of lines in the file SP Spool System 3 5 SP Spooler Administration To initialize the spooling system enter the following from CI CI gt sp in Maximum Spool Files 74 To increase the spool file limit change the E VMA size of SPGET Spool System Initialized The default EMA VMA size of program SPGET allows for approximately 70 spool files If the EMA VMA size of SPGET is increased by 1 page approximately three more files may be actively spooling at one time The following example illustrates the process of shutting down the spooling system resizing SPGET and reinitializing This example assumes that SPGET has been loaded as an EMA not VMA program which is the default CI gt sp qu Spool System Shutting Down CI gt sz spget
29. the request if applicable LP Spool System 2 49 The rtestd Interface The rtestd interface is for use by printers that are controlled by the standard RTE printer drivers This interface issues the standard control requests or escape sequences for controlling printer devices and supports the standard set of EXEC control word bits for the RTE printer drivers DD 12 DDC12 DDC00 and DDC01 Two printer model files are supplied for this interface generic and pcl The pcl model file is for printers that support the HP Printer Control Language PCL The generic model file is for printers that do not support PCL Features Common to generic and pcl Models This section lists options common to both the generic and the pcl models of the rtestd interface The options that are supported only by the pc1 model are listed in the following section Printer interface options are specified in the 1p program runstring preceded by a o The options are e Device Handling ee The files contain FORTRAN style carriage control in column 1 Use of the raw or r or nolnc options negates the effect of this option ke The files include EXEC control word headers The files must have been created by the ON command of the SP spooler with the KC option specified These headers specify the control word flags that were used in the redirected EXEC XLUEX writes and preserve information on control requests that were sent to the redi rected device T
30. valid classes lpstat no destinations No destinations exist in the system Destinations may be added using lpadmin lpstat destination dest non existent The named destination does not exist Use Ipstat a to display the names of valid destinations lpstat parm is not a request id A parameter was given not as an option argument that is not a valid request ID 2 34 LP Spool System reject reject The reject program prevents print requests from being submitted to the named destinations which may be the names of either printers or classes The runstring for the reject program is as follows CI gt reject r reason destination destination where r reason specifies a reason for preventing submissions This reason will be reported by lp when an attempt is made to enter a request for the destination and by lpstat The reason must be less than 80 characters and should be sur rounded by double quotes From CI also use backward quotes to prevent upshifting and comma insertion of the reason The specified reason will apply to all destinations named after the r option more than one r may be speci fied intermixed with destination names to associate different reasons with dif ferent destinations If not specified the reason string reason unknown is used No print jobs may be entered for a destination that is rejecting submissions until the accept program is run for
31. 0 2 62 cancel program 2 8 categories of printers 2 2 creating printer class 2 43 destination availability 2 4 disable program 2 11 enable program 2 13 Index 1 Ethernet LAN 2 2 fence priority 2 25 HP JetDirect card 2 2 HP supplied printer interfaces 2 49 passthru interface 2 56 remote interface 2 57 rtestd interface 2 50 inetd program 2 37 installation 2 38 mklp cmd file 2 38 loading new forms 2 44 Ip program 2 14 Ipadmin program 2 18 Ipalt program 2 22 Ipfence program 2 25 Ipmove program 2 26 Ipsched program 2 28 Ipshut program 2 30 Ipstat program 2 31 output destinations 2 2 local printers 2 2 network peripherals 2 2 remote printers 2 3 overview 2 1 printer classes 2 4 printer interfaces 2 3 custom 2 61 local printers 2 49 modifying sources 2 62 network peripherals 2 57 remote printers 2 57 printer model files 2 3 format 2 61 generic model 2 50 hpnp_passthru model 2 60 hpnp_pcl model 2 59 passthru model 2 56 pel model 2 52 rbsd model 2 58 rhpux model 2 58 rrte model 2 57 priority 2 25 setting default for printer 2 18 specifying priority of request 2 15 program summary 2 6 programming considerations 2 62 reject program 2 35 removing a printer 2 43 rlpdaemon program 2 37 rlpout program 2 37 spooled file formats 2 5 troubleshooting 2 46 user interface 2 6 Ipadmin program 2 18 Ipalt program 2 22 Ipfence program 2 25 Ipmove program 2 26 Ipsched prog
32. AAA AAA AAA ARA C COPYRIGHT HEWLETT PACKARD COMPANY 1984 ALL RIGHTS ki RESERVED NO PART OF THIS PROGRAM MAY BE PHOTOCOPIED x REPRODUCED OR TRANSLATED TO ANOTHER PROGRAM LANGUAGE WITHOUT THE PRIOR WRITTEN CONSENT OF HEWLETT PACKARD COMPANY y KKKKKKKKKKKKKKKKKKKKKKKKKKKKKKKKKKKKKKKKKKKKKKKKKKKK KK KKK KKKKKKK CACA FF FF F A F F HF F block data ffl 92077 16067 REV 6100 lt 930709 1609 gt Do not alter these declarations common defoptions defbanner header logical 2 defbanner header common ff numffs integer 2 numffs common outputlu outputlu integer 2 outputlu common lengths printerlength fil printerbanspace f integer 2 printerlength fil printerbanspace f ength lebanspace ength lebanspace common optprintmsg printmsgquiet logical 2 printmsgquiet cat ct common drivers driversok integer 2 driversok 0 3 ii Tailor the values within the slashes below according to local tastes banner before each file header befor ach file data defbanner true print data header true print data numffs 2 number of form feeds after last file 4 12 The PRINT Utility AR F F AR OR OA da da ta outputlu ta printmsgquiet 6 default printer lu false suppres
33. Df Treat the first column of each line as FORTRAN style carriage control BSDI Use an output filter that suppresses page breaks BSDp Use the pr utility to format the printed output BSDh Suppress printing the banner page nb Suppress printing the banner page for compatibility with other printer inter faces This option is preserved in the request sent to the remote host Note that many of the options above contain uppercase characters To enter these options using the o option of the HP 1000 1p program the uppercase characters must be entered in lowercase and quoted to prevent upshifting because the HP 1000 1p program reverses the case of option characters See the documentation on the 1p program for more information Type 1 files are always sent to the remote host as if raw mode were in effect that is linefeed characters are not added to delimit line boundaries The first block containing the valid byte count for the following data in the first 12 characters is dropped during transmission The hpnp_pcl1 Model The hpnp_pcl model prints requests on PCL printers connected to a TCP IP Ethernet LAN by an HP JetDirect card Devices supported by this model include LaserJet and PaintJet printers By specifying an alternate TCP port for the connection you may print to other network peripherals that accept a simple TCP print data stream If the raw or r option is not given the following carriage control processing is perform
34. Esc s2Q PCL3 Set primary print quality to draft also known as normal quality Esc sOQ PCL2 not the same as 2567B draft quality Set primary q or secondary sq print quality by number The available quali ties vary by printer model Esc s_Q PCL2 The acceptable values for all of these options are dependent on the printer model and the fonts available See your printer technical reference manual csid or scsid r8 or k8 Set primary cs or secondary scs character set by symbol set ID Some common values are 8M HP Math 8 OU US ASCII 8U HP Roman 8 ON ECMA 94 Latin 1 10U PC 8 USA 00 OCR A OA HP Math 1E ISO 4 United Kingdom OB HP Line Draw 1U HP US Legal 1G ISO 21 German 8K HP Kana 8 The interface automatically upshifts the last character of the symbol set ID thus the usual rules of upper versus lowercase option characters for the HP 1000 1p program need not be followed Esc __ PCL2 Set the primary character set to Roman 8 r8 or Kana 8 k8 Esc 8U PCL2 LP Spool System 2 53 typenn or stypenn fpn n or sfpn n fhn n or sfhn n stylenn or sstylenn upright or supright Select the primary type or secondary stype font typeface by number Some common values are 0 Line Printer 1 Pica 2 Elite 3 Courier 4 Helvetica 5 Times Roman 6 Letter Gothic 7 Script 8 Prestige 9 Caslon 3 amp 540 10 Orator Esc s__T PCL4 Primary fp or secondary sfp font pitch in characters inc
35. Kir HEWLETT PACKARD RTE A Print and Spooling Reference Manual Software Services and Technology Division 11000 Wolfe Road Cupertino CA 95014 9804 Manual Part No 92077 90248 Printed in U S A April 1995 E0495 Second Edition NOTICE The information contained in this document is subject to change without notice HEWLETT PACKARD MAKES NO WARRANTY OF ANY KIND WITH REGARD TO THE MATERIAL INCLUDING BUT NOT LIMITED TO THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE Hewlett Packard shall not be liable for errors contained herein or for incidental or consequential damages in connection with the furnishing performance or use of this material Hewlett Packard assumes no responsibility for the use or reliability of its software on equipment that is not furnished by Hewlett Packard This document contains proprietary information which is protected by copyright All rights are reserved No part of this document may be photocopied reproduced or translated to another language without the prior written consent of Hewlett P ackard Company RESTRICTED RIGHTS LEGEND Use duplication or disclosure by the Government is subject to restrictions as set forth in subparagraph c 1 ii of the Rights in Technical Data and Computer Software clause at DFARs 252 227 7013 Copyright O 1993 1995 by Hewlett Packard Company Printing History The Printing History below identifies the edition of this manual and
36. P PCL3 Font selection is also influenced by the portrait and landscape options described below Set portrait orientation printing left to right across the width of the page This is usually the default Esc amp l00 PCL4 Set landscape orientation printing top to bottom across the length of the page Esc amp 110 PCL4 Use automatic double sided printing with vertical long edge binding This option is valid only on printers with double sided print capability Esc amp l1S PCL4 Use automatic double sided printing with horizontal short edge binding This option is valid only on printers with double sided print capability Esc amp 12S PCL4 Horizontal spacing increment in 1 120 inches The available increments vary by printer model Esc amp k__H PCL3 Set the number of lines per inch to print This is an alternate way of setting the vertical spacing index see vsi below The default is usually 6 lines per inch Acceptable values vary by printer model Esc amp l__D PCL2 Set the vertical spacing index in 1 48 inches The acceptable values vary by printer model Esc amp l__C PCL3 Set the logical length of the entire page in lines The default is 66 lines Esc amp l_ P PCL2 Set the text length of the page in lines The default is 60 lines in portrait orientation 45 lines in landscape orientation Esc amp l__F PCL2 Set the left margin column the leftmost column is numbered 0 Esc amp a__L PCL2
37. RTE A VC systems that provides compatibility with the HP UX LP spooler and other TCP IP based Internet spoolers The LP spool system supports local printers network peripherals and network printing between HP UX and other RTE systems via NS ARPA 1000 The user interface is very similar to that of HP UX allowing users that work on both RTE and HP UX instant familiarity with the other system The LP spool system can coexist with the SP spool system and the PRINT utility without interfering with their operation Because the output device LU is locked to the program performing the output all three systems may simultaneously attempt to access the same device without disrupting the output of another system Overview The LP spool system consists of a number of programs the majority of which present a user interface that is very similar to the LP spool system that runs on HP UX systems All programs in the system take their input from the runstring there are no interactive programs Therefore the programmatic and interactive modes of access to the system are very similar the programmatic interface consisting of FmpRunProgram calls that are functionally equivalent to entering the runstrings at a CI prompt As an aid to programmatic usage most of the programs return error status to the scheduling program and allow any output generated to be redirected to a file for programmatic processing Each task that the LP spooler handles is
38. When you run it with parameters PRINT displays a warning message if any input file is a type 1 2 5 6 or 7 file or if FMP errors occur while reading a file In these cases control passes from the first unprintable file in the runstring to the next printable file PRINT issues a warning and quits entirely in the following cases e if you enter the system BR Break command e if you enter an unrecognizable option e if you create an unwritable output file or if an FMP error occurs while accessing an output file e if the printer LU goes down or the LU number is outside the 0 to 255 range or does not exist e if PRINT cannot find PRINO the master printing clone or cannot execute PRINO e if nine or more PRINT requests are already active PRINT Return Values PRINT always returns the following values RETURNI the number of errors encountered by PRINT RETURN_S the name under which PRINO was run In addition the Z option can be used to force PRINT to wait for PRINO to finish before PRINT itself completes This allows PRINO to pass return values back to PRINT which can then pass them back to the caller for example CI Therefore if the Z option is specified the following additional values are returned RETURN2 the number of files printed by PRINO RETURN3 the number of errors encountered by PRINO 4 8 The PRINT Utility PRINT Examples Example 1 Print one copy of INPUT ROFF two copies of OUTPUT and one of INDEX CI
39. _pcl model 2 59 passthru model 2 56 pel model 2 52 rbsd model 2 58 rhpux model 2 58 rrte model 2 57 remote 2 57 removing 2 43 priority LP spool system 2 25 fence priority 2 25 setting default for printer 2 18 specifying priority of request 2 15 programming considerations LP spool system 2 62 protocols PCL Printer Control Language 2 52 escape sequence 2 52 font 2 53 horizontal pitch 2 53 language level 2 52 page layout 2 55 paper source 2 56 PCL levels of HP printer models 2 52 print quality 2 53 R rbsd model file 2 58 reject program 2 35 remote printer 2 3 2 57 adding 2 42 interface 2 57 model files 2 57 removing printer LP spool system 2 43 request ID sequence number 2 45 rhpux model file 2 58 rlpdaemon program 2 37 rlpout program 2 37 rrte model file 2 57 S sam program 2 42 SP command 3 1 SP spool system administration 3 6 initialization 3 6 LU redirection 3 3 spooling LU output 3 4 spooled file formats 2 5 spooler See also LP spool system SP spool system administration tasks 2 41 available on RTE A 1 1 usage description 1 1 system administration LP spool system 2 37 administration tasks 2 41 log file maintenance 2 45 network printing 2 37 NS ARPA configuration 2 37 resetting request ID sequence number 2 45 rlpdaemon program 2 37 rlpout program 2 37 T troubleshooting LP spool system 2 46 Index 3
40. a to be printed actually depends on the operation of the printer interface used to print the file The discussion of file formats in this documentation applies only to the printer interfaces supplied by HP see the documentation on the particular interface for the file processing of non HP interfaces As mentioned previously files of type 1 must be in a special format The first block of a type 1 file contains an ASCII representation of the number of valid bytes in the file in the first 12 characters blank extended This count tells the spooler how many bytes to actually print since type 1 files contain no EOF position information The rest of block 1 is unused The remaining blocks starting at block 2 contain the byte stream to print If the type 1 file was spooled from UNIX then the byte stream is the unaltered contents of the UNIX file The rtestd printer interface supports printing files in UNIX format with the appropriate carriage control added see the section on that interface for more information LP Spool System 2 5 LP Spool System User Interface This section describes the LP spool system user interface which consists of programs for both the typical user and the system administrator These programs are summarized in Table 2 1 Most of the programs for system administration require superuser privileges to be executed The detailed description of each program follows Program Table 2 1 LP Spool System Programs Description
41. any updates that are included Periodi cally update packages are distributed that contain replacement pages to be merged into the manual in cluding an updated copy of this printing history page Also the update may contain write in instructions Each reprinting of this manual will incorporate all past updates however no new information will be added Thus the reprinted copy will be identical in content to prior printings of the same edition with its user in serted update information New editions of this manual will contain new information as well as all updates To determine which manual edition and update is compatible with your current software revision code refer to the Manual Numbering File The Manual Numbering File is included with your software It consists of an M followed by a five digit product number First Edition NOV 1993 orrori Eep eel dee wan vere ae Second Edition Apr 1995 ai 3 4 Preface This manual describes the programs available on RTE A to print or spool files It contains usage information for the RTE A user as well as information required by the system administrator to set up the spooling system This manual is organized as follows Chapter 1 Describes the concept of spooling and list the spoolers available on RTE A which are described in Chapters 2 3 and 4 Chapter 2 Describes the LP spool system which is the newest spooler released at Revision 6100 RTE A
42. ation The lpadmin runstring is as follows CI gt lpadmin pprinter setopts add or modify a printer CI gt lpadmin xdest delete a destination CI gt lpadmin d dest set system default destination Only one of the p x or d options must be given when lpadmin is run pprinter xdest d dest sets the printer name to which setopts options apply If the printer does not already exist it is added to the spool system The printer name may be up to 14 characters long may not contain a dash and must be a legal file name Printer names are not case sensitive on the HP 1000 they are always reported in lowercase setopts are a string of options used in creating or modifying the printer as defined below deletes destination dest from the spool system dest may name either a class or a printer If dest names a printer and that printer is the only member of a class then that class is removed also sets the system default destination for requests that do not specify a destina tion The destination may be the name of either a printer or a class of printers If no dest is supplied no system default destination will be in effect Options setopts The following options setopts above are given when the p option is used these options apply to the printer named in that option These options are used to define the attributes of a new printer or modify an existing printer The options are cclass e
43. called a request A request specifies that a certain collection of files is to be printed on a certain printer or on any member of a class of printers as discussed later in a certain format Other properties are associated with the request as well such as the priority of the request for priority based printer scheduling Requests are usually created when a user runs the program named 1p as documented in a following section Each request is assigned a unique request ID that is used when performing subsequent LP spooler commands on the request and in tracking the progress of the request through the system The LP spooler must be configured for each printer it may access using the lpadmin program At that time a name is associated with the printer That name rather than the device LU number is used to refer to the printer within the LP spool system LP Spool System 2 1 The spooler routes a request to be printed on a particular printer when five conditions are met 1 The request names the printer or a class in which the printer is a member as its destination 2 The printer becomes available that is the printer is declared to be operational for spooling purposes and it is not already busy printing a request 3 No higher priority requests are queued for that printer 4 The priority fence for the printer is set such that the request may be sent to the printer Details of priority fences are given in a following sectio
44. ce Manual part no 92077 90007 3 6 SP Spool System The PRINT Utility The Print utility PRINT instructs the line printer to print files PRINT has options that allow you to tailor the output to your individual programming and printing needs PRINT runs in the background instead of tying up your terminal until the printer has finished It recognizes file masks and performs carriage control as specified in your file Optionally PRINT can indent the printed output produce numbered listings and create banners PRINT puts a file identifying header and a banner headline on the first page of each printed file The header contains the complete file name and the create update access and print times of your printed file The banner headline contains your name and file name You can stop the generation of the header and banner headline at link time or with runstring options PRINT Runstring To run PRINT enter the following runstring CI gt RU PRINT filename lu options You may enter more than one file name in the runstring When it runs PRINT starts each file on a new page PRINT returns a listing of the print queue to your terminal screen if you do not enter any parameters in the runstring Normally PRINT defaults to LU 6 You can set a different default LU at link time or you can send the file to another LU by specifying an LU number in the runstring Note that PRINT recognizes the LU specification as the printer
45. cies odie se 2 be a a a oo edie wee 2 62 Chapter 3 SP Spool System DP RUGS HINO td A oia 3 1 Commands e cee aaa a MM a wc aut tlie ta gM ate a a 3 1 ON and LI Command Options ios cido He ws GW GT Oe ee 3 3 EU R direction sosise oii ta SA RAR SAS Se AAA 3 3 Spooling LU Output viccre in A EA IAS A 3 4 ST Command Listing Format AA AAA AAA dea 3 5 SP Spooler Administration A AAA Se ROH A dE 3 6 Programmatic PODIA sor AR A AAA e ida 3 6 Chapter 4 The PRINT Utility PRINT RUN Shane ce to sata ca ds ea le dd e A e T le 4 1 PRIN TOpuOns e o e al dd A O 4 1 e o rl sido do too sido es 4 3 FA cas Stink eek ee y din Shien seb te ts ista ues 4 3 EB duck Gist ee dacels Suck ashes owls Sos ick attest aNd aut EEEE E ap See dt 4 3 O ete aad yes E A Weare eee anhieted tae eau aa ews 4 3 O Saha aa Gee lin E A Beat able aie eee een Baas 4 4 Rc hey Sh Pan hate O O Saree teu eneSaeee 4 4 A A O O oa le Mag ita eck 4 4 SO A O Pele d sath avrg Linke T a Me Pele dain 7 4 4 A sae eGa tease napa ke hie aise O 4 5 FM rios aro Mipeehadow iso Praia 4 5 Na orn Pep utes ER RE NS 4 5 SO a ts at dd bd td ut 4 5 WEP ile ea ae el are A O it Rs ae Gall sui eat ae NE sl 4 5 AO 6 it RIAS ae a ea vig A ied avail ale AS 4 6 A 4 6 ET a di 4 6 PW A sele a e e wie dee 4 6 A A oe Lala ih ath eM ated Mh acd 4 6 BM cash ete ed etch ne ad eM a dtd Manis ad Cos Cd Sd ih dae ea clad As ae 4 6 A BE Rea A acne ae ENE ede kee Meet aE A T Ladin Re San ada Sd ae 4 7 PRINT Op ration e a
46. cribed in Chapter 2 but are retained for backward compatibility The SP spool system may be used to capture output destined for an LU into a file for printing using the LP spool system SP Runstring To run SP enter the following runstring CI gt SP command where command is one of the commands described below Command subparameters are separated by spaces or commas If a command is not specified the spool system enters interactive mode Commands The following are the SP commands that can be entered in the SP runstring or at the prompt when running SP interactively IN Starts the spooling system Needed only when the spooling system is inactive ON S sess lu options Starts spooling for lu The default is LU 6 All subsequent output to this LU is written into a temporary spool file OUTSPOOLxx SPL xx is a spool system code When spooling is stopped the file is sent to the LU and the spool file is purged s sess can be specified by a superuser to start spooling for session number sess By default spooling is started for your session Valid options are NC NE BP and SS as defined at the end of the command descriptions SP Spool System 3 1 ON S sess lul lu2 DC Starts LU redirection from lu1 to lu2 The default Jud is LU 6 All T O to lu will be routed to the u2 specified Both lu and lu2 must be valid LU numbers By default up to 2 levels of I O redirection are allow
47. d seek eae ie Sao 4 7 PRINT Messages tt echt ars ta otal er adage GAN iaa caida 4 8 PRINT Ret rn Valles te a e wana ot is tense hel ados sob aid 4 8 PRINT Examples cca Oke nace RA EA A AAA ORES 4 9 PRINT Administrati t ot 4 11 Table 2 1 Table 2 2 Table 4 1 Table 4 2 Tables LP Spool System Programs Vs 5 ote ds A Ai 2 6 PCL Levels of HP Printer Models sj sso ra ea ea ee Se EO 2 52 PRINT Options Summary ross shee oe 4e A OOS eH ee es 4 2 amp FFL Variables 0 e Sea EAS EES Ns CONG SHS TR ES 4 11 Introduction A spool system or spooler as 1t is often referred to manages concurrent access to system resources by multiple users and processes In particular it manages resources that must be devoted entirely to one task at a time starting a new task only when the current task is complete The spooler establishes a queue of tasks for the resource and decides which of the queued tasks to next schedule for the resource The most common usage of spoolers is the sharing of printers and plotters among users The basic function of the spooler is to accept tasks that request files be printed and send them to an appropriate printer one task at a time Managing printers in this fashion avoids the problem of interleaved output where data from competing print tasks accessing the printer at the same time appears interspersed on the printed page The spool system performs the actual output of the print data to the printer device A
48. d status LR session Displays the LU redirections If session is specified redirections for that session number are displayed If is specified redirections for all sessions are displayed By default redirections for your session are displayed Displays the spool system queue in quick format one line per entry Terminates interactive mode ON and LI Command Options The options that can be used with the ON and LI commands are NC no carriage control NF no form feed KC keep control headers PU purge file when done BP print banner page SS suspend before and after printing LU Redirection LU redirection can be used to direct output to a different LU For example if you have a printer generated into your system at LU 25 but you have a program that outputs to LU 6 you can redirect output to LU 25 by entering the following commands to the SP program I gt sp on 6 25 LU redirection started from LU 6 to LU 25 Now when you run your program the output is rerouted to the printer at LU 25 instead of LU 6 Output begins to come out at the printer immediately To terminate the redirection from LU 6 to 25 enter the following command from SP C I gt sp of 6 LU redirection terminated from LU 6 to LU 25 SP Spool System 3 3 By default two level chains of LU redirections may be created For example CI gt sp on 6 7 CI gt sp on 7 8 In the above output sent to LU 6 is sent to
49. d when receiving a spool request from a remote UNIX host Type 1 files are always printed using transparency also known as honesty mode flags set in the XLUEX write call For the standard RTE drivers this inhibits adding carriage return linefeed sequences at the end of data written via XLUEX write calls and inhibits treating trailing underscore characters as line continuation characters However if the file is in UNIX text format the spooler adds its own carriage control as documented below When printing type 1 files if the raw or r option is not specified in the request the file is assumed to be in UNIX text format In the UNIX text format each line is terminated by a linefeed ASCII code 12b without a carriage return character ASCII code 15b The interface prints a carriage return character after each linefeed character is sent and after each form feed character ASCII code 14b is sent to emulate the behavior of UNIX device drivers If the raw or r option is specified in the request the type 1 file blocks are written to the printer in transparency mode without characters added by the interface See the RTE A Driver Reference Manual part number 92077 90011 for more information on the operation of the various RTE printer drivers and on the transparency or honesty mode processing LP Spool System 2 51 The pc1 Model The pcl model supports printers that use the HP Printer Control Language PCL protoc
50. device is down The printer interface program noticed that the device LU is in the down state If the device is OK then perform an RTE UP command on the LU and enable the printer lpout break flag set for requestid An RTE BR command was issued against the printer interface program If the printer is OK then it may be enabled host unknown in etc hosts The host or network peripheral name must be added to the etc hosts file printer not found in etc services The TCP port definition of service name printer must be added to the etc services file This is normally done automatically at ARPA or NS ARPA installation time unable to create socket A BSD IPC error occurred when creating a socket for contacting the remote host or network peripheral Your NS ARPA or ARPA subsystem may be out of resources unable to connect to remote The remote host or network peripheral cannot be connected to Check that the host name is correct and that the remote machine is up and ready to receive print requests from the network error reading acknowledgement Connection aborted on error A networking error occurred while engaged in the network spooling protocol The remote spooling daemon may have aborted LP Spool System 2 47 remote rejects submissions The remote host rejected an attempt to transfer a request to it This may be because the remote destination rejects new submissions or because the remote destination name is invalid
51. e CI CO command Only set this variable if your file system has symbolic link capability determined at RTE installation time LP Spool System 2 39 rte_progs Directory in which type 6 program files are to be placed The default is programs rte_snap The target snap file for loading programs The default is the current system snap file rte_usr Directory in which usr files are to be placed The default is usr You may also want to set and export the LINK environment variable which contains runstring commands for the 1ink program For example to use snap file system madison snp enter CI gt set x link madison snp The actions that may be performed by this command file subject to the setting of the options above are e Ifthe LP spooler is already running it is shut down e The usr spool 1p directory structure is created if needed e The local host name is set in usr spool 1lp hostname if supplied e Printer model files in the model subdirectory are copied to usr spool 1p model Only files that are missing or newer than the existing printer model files of the same name are copied e Help files are copied to help Only files that are missing or are newer than the existing help files are copied e If remote software is to be installed then etc inetd conf is modified to support the rlpdaemon program e The LP spooler programs are loaded e The LP spooler is restarted The following example ex
52. e name has previously been set If file usr spool 1p hostname already exists and this variable is set the new name replaces the old one in that file 2 38 LP Spool System lp_loadprogs Set to F if you do not want the LP spooler programs to be loaded Use this Slp_local Slp_remote Slp_remotein Slp_remoteout Slp_update Sr Sr te_help te_libs SE te_mklnks option when the programs have already been loaded but the directory structure must be created or other local configuration must be performed The default is to load programs Set to F if you do not want the LP spooler to be installed on the local system The default is to install the spooler locally Unless this variable is set to F the following actions are performed e The usr spool 1p directory structure is created if necessary and files therein are modified e Help files on help are updated e The LP spooler on the local host is shut down before installation and restarted after installation Set this option to F when loading the LP spooler programs for a system other than the local system Set to T if you want to install both incoming and outgoing remote printer support This variable should be set to T if this host must send requests to remote hosts and or to JetDirect network peripherals and must receive requests from remote hosts You can select incoming or outgoing remote printer support separately using
53. e printer newprinter 6 If you wish to remove all traces of the printer from the spool system run the lpadmin program to remove the printer name CI gt lpadmin xprinter LP Spool System 2 43 To load new forms into a printer for printing a single request 1 Spool the request requiring the special forms with the 1p ohold option When the request is sent to the printer the lpout program suspends in the paused state after printing a message on the system console The forms may then be changed When the new forms are in place enter a system GO command for the suspended copy of lpout go lpout lpout will print the proper program name to use as the argument to the above command in its message on the system console 2 When printing is complete 1pout prints an identical message on the console indicating that it is suspending for forms changes Reinstall the original forms into the printer and issue another RTE GO command for the lpout copy To load new forms into a printer and print several requests that use those forms 1 If the first request requiring the special forms has been spooled with the 1p ohold option then when that request is scheduled for the printer the Ipout program will suspend in the paused state after printing a message on the system console The forms may then be changed before a system GO command is issued for the suspended copy of lpout Alternatively the printer may first be disabled such t
54. ecution performs these actions a updates local files b loads programs into programs c installs incoming and outgoing remote printer support d establishes myhost as the local host name e uses symbolic links where possible and f creates the usr directory on LU 22 CI gt set lp_remote T CI gt set lp_hostname myhost CI gt set rte_mklnks T CI gt mklp 22 You may also wish to automatically start the LP spool system at boot time To accomplish this add the command to your welcome file lpsched 2 40 LP Spool System You may now add printers to the system using the lpadmin program If link reports undefined symbol errors on network spooling programs and suggests that some symbols may be found in system common you may need to search the FNDLB library to load the programs This can happen on systems that search the FDSLB library by default Spooler Administration Tasks This section provides an outline of the steps necessary to perform common spooler administrative functions To add a new printer 1 Choose a name for the printer called printer in the examples below You may wish printer names to be unique throughout your network such that the same name may be used from any host to access the same printer Select the appropriate model file to be used for the printer See the section HP Supplied Printer Interfaces for help in choosing a model file If the printer is a local di
55. ed For example sp on 7 9 and sp on 9 11 will redirect LU 7 to LU 11 s sess can be specified by a superuser to start spooling for session number sess By default spooling is started for your session The DC do not chain redirections option can be specified to inhibit chaining of redirection ON S sess lu file options Starts spooling for the LU specified Any subsequent output to lu is written in the file specified At completion the file is removed from the spool system but not purged The default u is LU 6 s sess can be specified by a superuser to start spooling for session number sess By default spooling is started for your session Valid options are NC NE BP SS KC and PU as defined at the end of the command descriptions Note that unless the KC option is given the spooled output written to the specified file does not contain EXEC CNTWD flags that were given in the spooled write requests The file also does not contain device control requests that were issued to the LU via an EXEC 3 LI file lu options Queues the file in the spool system for output to lu The default lu is LU 6 Valid options are NC NF BP SS KC and PU as defined at the end of the command descriptions a E fileref offset Restarts spool file output The optional offset parameter can be either positive or negative If specified the appropriate number of relative records or wi
56. ed If your system runs ARPA 1000 rather than NS ARPA 1000 then you will need to make the networking libraries available for loading the network spooling programs The LOD files for rlpout and rlpdaemon must be modified to reflect the different file names The RTE A master installation command file rte_a rte_install cmd can be used to invoke mklp cmd Please refer to the RTE A System Generation and Installation Manual part number 92077 90034 for information on rte_install cmd usage The file mklp cmd is used to install the LP spool system programs and files This command file should be executed by a superuser with the working directory set to the directory in which the LP product is shipped normally vcplus 1p The runstring is as follows CI gt mklp usrlu where usrlu is the LU on which to create the usr directory if it does not already exist The following CI variables may be set prior to execution of this command file the variables need not be exported lp_hostname Set to the name of the local host to use in file names and request IDs This name must be 8 characters or less and must be a legal file name The name should be entered in all lowercase characters using back quotes to protect the name from upshifting by CL as in CI gt set lp_hostname myhost The name must be unique among all hosts in the remote spooling network This name need not be given if remote spooling is not used on this host or if th
57. ed on the print data sent to the printer e Ifthe file being printed is of type 2 or above RTE text format a carriage return linefeed sequence is sent after each FMP record is sent to the printer e If the file being printed is of type 1 UNIX text format a carriage control character is sent after each linefeed or formfeed character is sent LP Spool System 2 59 This model supports the following options e Data Formatting r Print data should be sent unretouched to the printer If not given carriage control raw characters are added to the print data as documented above If this option is given carriage control is not added the records must already have the necessary carriage control embedded in the text e Networking portan Specify the TCP port number to use when connecting to the network peripheral The default port is 9100 which is the default port used by HP JetDirect network peripherals e Other nb Inhibit printing the banner page In addition this model supports the options listed for the pcl model beginning on page 2 53 The hpnp_passthru Model The hpnp_passthru model prints requests on plotters connected to a TCP IP Ethernet LAN by an HP JetDirect card Devices supported by this model include HP DesignJet plotters By specifying an alternate TCP port for the connection you may print to other network peripherals that accept a simple TCP print data stream No processing of the data stream or meddling with the
58. ends a print request to a remote destination via NS ARPA 1000 The destination may be of two general types e The destination may be a remote printer connected to a remote host The remote host may be an RTE HP UX or a BSD UNIX system that supports network printing separate printer model files are provided for each host type The remote interface transfers the request to the remote host for further processing by the spool system on that host The printer on the remote host may itself be a remote printer the spooler on the remote host may forward the request to another host for printing e The destination may be a network peripheral that is a printer directly connected to a network and shared among the hosts on that network For example a printer may be connected to an Ethernet LAN by an HP JetDirect card which allows printers to be connected directly to a LAN rather than to a host that is connected to a LAN The remote interface opens a connection to the network peripheral and sends it the data to be printed as if the printer were a local printer connected via the LAN The interface consists of a program named rlpout that handles the network transfer The LP spooler provides five printer model files for remote printing e rrte for sending requests to printers on RTE hosts e rhpux for sending requests to printers on HP UX hosts e rbsd for sending requests to printers on BSD UNIX hosts e hpnp_pcl for printing on PCL printers connected to a
59. er Restart the LP scheduler by entering 2 42 LP Spool System lpsched To create a class with existing printers as members 1 Choose a name for the class called class in the examples below 2 Run lpadmin to insert the desired printers into the class The runstring is similar to CI gt lpadmin pprinter cclass 3 Allow requests to be submitted for the class by running accept CI gt accept class 4 If you wish the new class to be the system default destination enter CI gt lpadmin dclass To remove a printer from the system 1 Disallow further submissions to the printer by running reject CI gt reject r reason for removal printer 2 Verify that the printer is not busy by running lpstat CI gt lpstat oprinter If the printer is busy you may wish to terminate the request active on that printer or you may wish to let it complete 3 Disable the printer from printing any further requests by running disable Ifa request is active on the printer this will abort the printing The runstring is CI gt disable r reason for removal printer 4 When activity on the printer stops the physical printer device may be disconnected 5 If any requests remain queued for the printer you may wish to move them to a new destination To see if any requests are queued enter CI gt lpstat oprinter If any requests need to be moved run the lpmove program CI gt lpmov
60. etIPC error nnn An NS ARPA NetIPC error occurred See the NS ARPA Error Messages and Recovery Manual part number 91790 90045 for more information about the error code unknown command code received nn unrecognized receive job subcommand nn control file byte count incorrect invalid control file name name invalid byte count datafile These messages indicate internal errors caused by failure to recognize the network spooling protocol sent by the remote host Contact your HP representative for help in diagnosing the problem Also check for networking errors in file system ns_event log 2 48 LP Spool System HP Supplied Printer Interfaces This section documents the printer interfaces and printer model files supplied by Hewlett Packard with the LP spooler The printer interfaces supplied by HP are Interface Name Usage rtestd Standard local RTE printer using standard drivers passthru Local plotter or other non RTE printer device remote Remote printing via NS ARPA 1000 The printer model files supplied by HP are Model Interface File Used Usage generic rtestd Generic non PCL local printer pel rtestd Local PCL printer passthru passthru Local plotter or other non RTE printer device rrte remote Remote printing to printers on RTE hosts rhpux remote Remote printing to printers on HP UX hosts rbsd remote Remote printing to printers on BSD UNIX hosts hpnp_pcl remote Remote printing to PCL network periphe
61. format of the option is B The PRINT Utility 4 3 C This option sets the carriage control option ON or OFF When you set it ON the line printer does not print the first character of each line Instead it interprets any character in column one of an otherwise blank line as line or page formatting instructions When you set the carriage control OFE the line printer prints the entire line including the first character If you do not specify this option PRINT determines the setting of the option by searching for a carriage control a 1 in column one of an otherwise blank line in the first 70 lines of the file If 1t is not found PRINT assumes that there is no carriage control information in the file The search terminates before the 70 lines have been scanned if PRINT finds anything other than a ae ee 0 SAn or ae TN The format of the option is C ON OFF F This option advances paper the specified number of pages after all files are printed The form feed option overrides the defaults in the FFL module set by the system installer at load time Specify F 3 for example to get three form feeds at the end of a printed file The format of the option is F n Note In the case of serial I O drivers setting bit 10 in the CN 34B word is required to ensure that form feeds are recognized This causes the driver to treat CN 11B 1 as an unconditional page eject See Chapter 4 Serial I O Drivers in
62. g the i option 2 32 LP Spool System p list v list lpstat Display the status of printers list is a list of printer names By default all printers are shown An example listing is printer 133 is idle enabled since Mar 4 3 16 pm fence priority 0 printer 134 now printing 134 166 enabled since Mar 24 5 01 pm fence priority 0 Note that for remote printers only the status of the printers on the local system is shown The full status of printers on remote hosts is unknown A remote printer that is enabled on the local system will transfer requests to the remote host However the printer on the remote host may be disabled Display whether or not the printer scheduler 1psched is running gt Display status summary The same as entering r d c v Display all status The same as entering s a p o Display the status of output requests by user name Jist is a list of user login names optionally qualified by an at sign and a host name By default all requests are shown To select the information shown by other criteria see the o option The report shown is identical to that shown by the o option Example runstrings are lpstat uwoody Show all local requests for user woody lpstat uwoody vanguard Show all requests for user woody that originated on host vanguard If remote printers exist on the system then both local and remote status may be dis
63. gt print input roff output output index Example 2 Send the OUTPUT file to LU 12 instead of LU 6 CI gt print output 12 Example 3 Print every file in the current directory that has a type extension of FTN CI gt print ftn Example 4 Send several files to LU 24 instead of LU 6 CI gt print 24 kalderesult src kalde Example 5 Print MV HELP from the current directory along with the following files HELP RN HELP TUTORIALS CI HELP MO HELP TUTORIALS MAKE HELP CO HELP TUTORIALS MACRO CI gt print mv help w help rn mo co w help tutorials ci make macro Example 6 Print the following files SRC PLIBF FTN SRC PLIBM MAC HELP PRINT HELP FILES SCRATCH OUT CI gt print w src plibf ftn plibm mac w help print files scratch out Note that SRC and HELP are subdirectories of the current directory SCRATCH is a global directory Working directories without a leading slash are interpreted as relative to the working directory Example 7 Print the file MV HELP from the current working directory and the first occurrence of amp PLIBF found on a FMGR cartridge CI gt print mv help w 0 amp plibf The PRINT Utility 4 9 Example 8 Include C 85 as a banner headline along with the default banner headlines CI gt print b C 85 b libraries fnewf ftn mac This example produces a leading page with t
64. h a decimal fraction Esc amp s__H PCL2 Set primary fh or secondary sfh font height in points a decimal fraction Esc amp s__H PCL2 Set the primary style or secondary sstyle font style by number Some common values are 0 upright 1 italic 2 slanted 4 condensed 5 condensed italic 8 compressed 24 expanded 32 outline 64 inline 128 shadowed 160 outline shadowed Esc s__S PCL3 some 256x Set the primary upright or secondary supright font style to upright normally the default Esc sOS PCL3 some 256x italic italics or i sitalic sitalics or si slant or sslant weightnn or sweightnn Set the primary italic or secondary sitalic font style to italic Esc s1S PCL3 some HP 256x Set the primary slant or secondary sslant font style to slant Esc s2S PCL3 Set primary weight or secondary sweight font stroke weight by number In general lt 0 light or thin 0 medium gt 0 bold or black Esc s__B PCL3 2 54 LP Spool System b or bold ps or sps fs or sfs Page Layout portrait landscape double duplex or d hdouble or hduplex hsin n Ipinn vsin n lnnn tlnnn Imnnn rmnnn tmnnn wrap or nowrap perfskip or noperfskip Set primary font stroke weight to bold weight 1 Esc s1B PCL3 Set the primary ps or secondary sps font to proportional spacing Esc s1P PCL3 Set the primary fs or secondary sfs font to fixed spacing Esc sO
65. hat name numeric LUs are always copied Print the files using the named destination either a printer name or the name of a class of printers If a class name is given the files are printed on the first available printer that is a member of that class If a destination is not specified the destination named by environment variable LPDEST is used If that variable does not exist the system default destination is used set by the lpadmin program Send mail when the request is printed The system on which the request is printed must support Internet mail on the HP 1000 this is provided by the Mail 1000 system By default no mail is sent Print the given number of copies copies must be an integer from 1 to 32767 The default is 1 Specify an interface specific option to be passed to the printer interface used to print the request More than one o option may be given to pass more than one option See the documentation on the destination printer interface program or routine for the options that it supports 2 14 LP Spool System lp Because RTE case folds the 1p runstring by default and because most options are lowercase 1p will reverse the upper or lowercase of each character in the option For example if a printer interface accepts option BSDp the 1p runstring from CI might be CI gt lp o bsd p filename ppriority Specify the priority of the request an integer value from 0 to 7 Higher values indicate higher
66. hat no requests are sent to it using the runstring CI gt disable r Changing forms printer If a request is active on the printer it is aborted and the request remains in the queues to be reprinted in its entirety later You may wish to first verify that the printer is not busy by entering CI gt lpstat oprinter 2 While the printer is inactive and either disabled or occupied by a suspended copy of lpout change the forms 3 Using the lpalt program modify the priority of each request that requires the special forms to be above the highest priority of any request that does not For simplicity this example runstring modifies the priority of a request to 7 the highest priority CI gt lpalt requestid p7 4 Using the lpfence program set the priority fence of the printer to the priority of the requests that require the special forms CI gt lpfence printer 7 No lower priority requests will then be sent to the printer If any existing requests are at priority 7 you may wish to lower the priority of those requests in the same manner 2 44 LP Spool System 5 If the printer has been disabled enable the printer as follows CI gt enable printer If the ohold option was used enter an RTE GO command for the suspended copy of lpout go lpout lpout will print the proper program name to use in the above message on the system console Continue entering GO commands as necessary at the sta
67. he following banners C 85 LIBRARIES FNEWF FTN These are followed by the printed contents of FNEWEFTN a page with the following banner FOLDF MAC USERNAME The banner is followed by the contents of the file FOLDEMAC assuming that is the only file matching MAC Example 9 Create the following pages note that the current directory contains A FTN B FTN C FTN ALIB MAC BLIB MAC A MAKE and MAKEFILE MAKE e a page with the banner headlines FMP SOURCES and A FTN followed by the contents of the file A FTN e apage with the banner headline B FTN followed by the contents of the file B FTN e apage with the banner headline C FTN followed by the contents of the file C FTN e a page with the banner headline ALIB MAC followed by the contents of the file ALIB MAC e a page with the banner headline BLIB MAC followed by the contents of the file BLIB MAC e a page with the banner headlines MAKEFILES and A MAKE followed by the contents of the file AMAKE e apage with the banner headline MAKEFILE MAKE followed by the contents of the file MAKEFILE MAKE CI gt print b fmp b sources ftn mac b makefiles make 4 10 The PRINT Utility PRINT Administration Install PRINT by linking PRINT and PRINO and placing the resulting type 6 files on the directory PROGRAMS Use the link command files PRINT and PRINO You can configure certain PRINT attributes at link time using the amp FFL module To change
68. he printer is already a member of a class A printer may be a member of only one class 2 20 LP Spool System lpadmin lpadmin default printer model is model No m option was specified so lpadmin chose a default printer model for you lpadmin more than one model interface type chosen e 1 m Only one of the e i or m options may be given LP Spool System 2 21 lpalt lpalt The lpalt program alters various parameters of an existing request such as request priority number of copies and so forth The request must reside on the local system and must not be actively printing The lpalt runstring is as follows CI gt lpalt id option option where id is the request ID of the request to be altered The request must be present on the local system remote requests cannot be altered You must be a superuser to alter a request that you do not own option is one or more of the valid options described in the following section Options ddest Change the destination of the request either a printer name or the name of a class of printers If a class name is given the files are printed on the first available printer that is a member of that class If this option is given then a new request ID is assigned to the request The new request ID is printed to the terminal and returned in RETURN_S The new request ID is a local request ID even if the altered request originated on a remote host For example
69. he queue for the new destination This command is useful when a printer must be taken out of service and another printer is available that can print the requests queued for the printer being removed from service The lpmove runstring is as follows CI gt lpmove id id todest or CI gt lpmove fromdest todest where gt id A request ID as reported by lpstat o fromdest Names of destinations either printer names or class names todest The first usage above moves one or more requests by request ID to a new destination The second usage above moves all requests for a destination to a new destination The original destination fromdest is then set to reject any new requests with the reason all requests moved to todest To reenable the original destination use the ACCEPT command for example ACCEPT fromdest A request that is moved is assigned a new request ID that names the new destination but retains the same sequence number For example if request ID epoc 220 is moved to destination rtelj then the new request ID is rtelj 220 If a request to be moved is actively printing the print operation is aborted before the request is moved Requests may be moved to a destination that is rejecting new submissions lpmove prints a warning in this case You must be a superuser to move requests that do not belong to you or to move all requests for a destination Examples CI gt lpm
70. his option has no effect on type 1 files r File data should be sent unretouched to the printer Uses transparent also known raw as honesty mode writes to the device that is automatic CRLF adding and trailing underscore processing does not occur This option causes type 1 files to not be pro cessed in UNIX text file format where lines are separated by linefeed characters see below This option cancels the effect of the cc option nolne Do not treat an underscore at the end of a record as a line continuation character A CRLF is still printed at the end of each record Uses transparent also known as honesty mode writes to the device This is the same as using the raw option except that a CRLF sequence is sent at the end of each record This option cancels the effect of the cc option e Other nb Do not print a banner page save a tree 2 50 LP Spool System hold Suspend operation before and after printing the request while the printer LU is locked to the Ipout program Both times 1pout prints a message on the system console of the form prog suspending per user request enter GO prog to resume where prog is the program name of the 1pout copy that is suspending The copy of lpout handling the print operation remains in the paused state until an RTE GO command is issued for that program name In this manner adjustments to the printer such as forms loading may be performed before and after the reque
71. ilarly to local devices connected to your system via a LAN 2 2 LP Spool System Remote Printers A remote printer is a network link to a printer connected on a remote host A request sent to a remote printer is transferred into the spool system on the remote host via the NS ARPA 1000 or ARPA 1000 subsystem The transfer is accomplished using a semi standardized Internet protocol The protocol also supports performing these operations on the local spool system from a remote host e cancelling print requests e obtaining listings of the spool system queues In this documentation the term remote printer does not refer to a network peripheral such as one accessed via a JetDirect card In this manner each host in your network may access any printer connected to any other host in the network The host types that support this network printing include other RTE hosts running NS ARPA 1000 or ARPA 1000 HP 9000 hosts running HP UX and BSD UNIX machines to which NS or ARPA connectivity from the HP 1000 is supported Printer Interfaces Device specific print handlers may be defined for each printer The program or set of routines that handles printing to a particular kind of printer is known as a printer interface In general a printer interface is a set of routines linked into the 1pout program Each printer interface has a name that identifies that interface to the lpout program HP supplies a number of printer interfaces with the LP spo
72. ing This message informs you that lpsched was successfully started It does not indicate an error condition LP Spool System 2 29 lpshut lpshut The lpshut program shuts down the lpsched program the scheduler for the LP spool system The runstring is CI gt lpshut All printing activity at the time of shutdown is halted No further printing occurs until the scheduler is restarted by running lpsched Each print request that is actively printing at the time of shutdown is reprinted in its entirety when 1psched is restarted You must be a superuser to run this program The accept reject and lpshut programs are identical executables Only one of these program files needs to be a type 6 executable the other two may be for example symbolic links to the type 6 file or prototype ID segments for the type 6 file Return Status The following status is returned RETURNI the number of errors encountered zero if none Error Messages lpshut scheduler not running The lpsched scheduler was already shut down scheduler stopped This message indicates that lpsched was successfully shut down It does not indicate an error condition 2 30 LP Spool System lpstat lpstat The lpstat program prints status information about the LP spool system The lpstat runstring is as follows CI gt lpstat option request id option request_id gt gt file Each parameter not starting with a dash or greater
73. is rejected When the system administrator verifies that the system is ready for requests to be entered for the destination the destination may be set to accept submissions using the accept program The destination may later be set to reject new submissions using the reject program This might be done when a printer must be taken out of service for an extended period of time for example Each printer in the system local or remote is either enabled or disabled at any time The spooler will not send requests to a printer that is disabled New requests may be entered for a disabled printer but the requests are not sent to the printer while it is disabled Requests entered for a class of which the printer is a member are printed on another enabled member At the time a new printer is added to the system it is initially disabled When the system administrator verifies that the printer is ready to print requests it may be enabled using the enable program The printer may later be disabled using the disable program This might be done when a printer must be taken out of service for a short time such as to load new paper Thus for a request to be sent to a printer there are two conditions that must be met either the printer or a class of which it is a member must accept new submissions and the printer must be enabled 2 4 LP Spool System Spooled File Formats The LP spool system does not create files to be spooled as can the SP spool system whe
74. its base PCL language level as well as other information on the PCL commands available The following table lists the base PCL language levels of many HP PCL printers Table 2 2 PCL Levels of HP Printer Models Printer Model Base PCL Level HP 256x Dot Matrix HP 2932A Dot Matrix HP 2933A 2934A Dot Matrix DeskJet DeskJet Plus DeskJet 500 500C 550C LaserJet LaserJet LaserJet500 LaserJet Il IID IP LaserJet Ill IID HIP MSI LaserJet 2000 PaintJet PaintJet XL PaintJet XL 300 QuietJet QuietJet Plus RuggedWriter Note that all of the options listed below are also supported by the hpnp_pcl model which supports PCL printers connected to an Ethernet LAN by an HP JetDirect card 2 52 LP Spool System The pcl model supports all the options listed under the generic model plus these options e Horizontal Pitch Selection these are obsolete at PCL4 and above c e 10 12 Compressed print pitch 16 7 CPI for HP 256x Esc amp k2S PCL1 Expanded print pitch Esc amp k1S 10 CPI Pica print pitch Esc amp k3S PCL3 12 CPI Elite print pitch Esc amp k4S PCL3 some HP 256x Also see fp and sfp below e Print Quality Selection these are obsolete at PCL4 and above nlq lq or q dq qn or sqn e Font Selection Set primary print quality to near letter quality Esc s1Q PCL2 called letter or high quality on older models Set primary print quality to letter quality
75. ll be skipped For example RE FILE 5 will restart output five records back The fileref par n may be either the file name or the reference number displayed by the ST command PU fileref Removes the file from the spool system This file is purged only if 1t is a spool file that is OUTSPOOLxx SPL The fileref parameter may be either the file name or the reference number displayed by the ST command F lu session Stops spooling or LU redirection for lu The default is LU 6 If lu was spooled to a default spool file output is started to the device Note that non default spool files are not output See the SP LI command to output non default spool files A superuser may terminate spooling or redirection for another session by specifying the session parameter 3 2 SP Spool System QU LO ON file Initiates error logging to the error file specified The file parameter is a file descriptor of the error log file LO OFF Terminates error logging Terminates the spool system This can only be used by a superuser All spool system activity must be stopped including outputting of files to an I O device and I O redirection All current spool files will be purged and other files removed from the spool system Or Displays all valid parameters their formats and descriptions ST Displays the current status of the spool system including spool file names owners destination spool LU file size an
76. m Administration Manager program to add the printer The appropriate model file name is rmodel The following steps apply if sam is not used Obtain the 8 character remote host name of the HP 1000 called host in the example below and the name of the printer on the HP 1000 called rdest in the example below The host name must be recognized by the HP UX system by entering it into the etc hosts file or adding it to the DNS database Shut down the printer scheduler by entering lpshut This will abort any printing requests so you may wish to wait for any activity to complete Run the lpadmin program to add the printer to the LP spooler The runstring is similar to the following lpadmin ppr v dev null mrmodel ormhost orprdest ocmrcmodel osmrsmodel where pr is the name of the remote printer on the HP UX system host is the name of the RTE system rdest is the name of the remote destination printer on the RTE system See the documentation on the HP UX spooler for more information Note that the last two options are not specified on older HP UX revisions Once the remote printer is ready to print both the accept and the enable programs must be run This allows requests to be submitted for the remote printer and allows the HP UX host to send requests to the HP 1000 The runstrings are accept printer enable printer If you wish the new remote printer to be the system default destination enter lpadmin dprint
77. n 5 The request is the first of all requests with the same priority in the queue for that printer Output Destinations In the LP spool system the term printer refers to any device to which it can output in keeping with the HP UX terminology The actual type of output device is not restricted by the LP spool system although HP provides support only for printer and plotter devices In this documentation the term printer is used to mean any output device unless printer devices are specifically indicated Three general categories of printers are accessed by the LP spool system local printers which are actual print devices directly connected to the local system network peripherals which are printers connected to a LAN not to any one system and remote printers which are network links to printers located on remote hosts Local Printers Local printers are physical print devices directly connected to the local system usually through a MUX ASIC or HP IB interface The LP spooler prints to any supported printer or plotter in a supported configuration using the standard RTE drivers Additionally you can develop your own custom device handlers for other devices to which you want to spool output Network Peripherals The LP spooler prints to network peripherals connected to Ethernet LANs by HP JetDirect cards You must have the NS ARPA 1000 or ARPA 1000 subsystem installed to print to these devices Network peripherals function sim
78. n spooling output from an LU to a spoolfile Instead the LP spooler prints files that have already been created by some other means Any RTE file type may be spooled In general the files fall into three categories e Record structured text files of type 0 or types 2 and above These files are printed as a series of FMP records using a separate XLUEX call to write each record if printed on an RTE system e Redirected LU output captured using the SP spool system These files may have headers that contain the EXEC CNTWD parameters and EXEC 3 control request information from the redirected EXEC calls that generated the output The LP spooler can use these headers when printing the file on an RTE system to reproduce the print formatting specified in the original EXEC calls e Files of type 1 which contain a byte stream of print data that is not organized into FMP records Type 1 files must conform to a special format that tells the spooler how many bytes of the file are valid print data as documented below These are normally introduced into the spool system only by the spool system itself when receiving a request spooled from a remote UNIX host In any case various options are available to specify print formatting such as to treat column one as FORTRAN style carriage control See the following section HP Supplied Printer Interfaces for a list of the options supported by the HP interfaces The processing performed on the file dat
79. nter LP spool system 2 41 remote printer LP spool system 2 42 C cancel program 2 8 carriage control when printing 4 1 4 4 categories of printers 2 2 CI commands SP 3 1 classes See printer classes creating printer class LP spool system 2 43 custom printer interfaces 2 61 D debug LP spool system 2 62 destination availability 2 4 disable program 2 11 E enable program 2 13 escape sequence PCL 2 52 Ethernet LAN 2 2 F fence priority 2 25 files printing See LP spool system files printing See PRINT Utility font selection PCL 2 53 format printer model file 2 61 G generic model file 2 50 H horizontal pitch PCL 2 53 HP JetDirect card 2 2 HP supplied printer interfaces 2 49 passthru interface 2 56 remote interface 2 57 rtestd interface 2 50 hpnp_passthru model file 2 60 hpnp_pcl model file 2 59 inetd program 2 37 installation LP spool system software 2 38 mklp cmd file 2 38 L loading new forms printer LP spool system 2 44 local printers 2 2 log file maintenance 2 45 lp program 2 14 LP spool system etc hosts file 2 37 etc inetd conf file 2 37 2 40 etc services file 2 37 usr spool lp log 2 45 ust spool lp lpd log 2 38 2 45 lausr spool Ip seqfile 2 45 accept program 2 7 adding a printer 2 41 adding a remote printer 2 42 administration 2 37 network printing 2 37 NS ARPA configuration 2 37 sam program 2 42 tasks 2 41 and Debug 100
80. nterface pcl ftn PCL printer support for the pcl and hpnp_pcl models Changes made to this file will be reflected in the operation of both models if both the lpout and rlpout programs are re loaded lpout_passthru ftn The passthru interface Look for the comment POSSIBLE USER MODIFICATION for suggestions on customizing Programming Considerations The lpout program suspends in operator suspend state just after starting if the local printer name begins with the string debug This allows the program to be adopted with Debug 1000 before continuing When an actively printing request is either cancelled via the cancel program or aborted via the disable or lpshut programs the printer interface program scheduled by lpsched is OF ed Any programs scheduled in turn by the interface program are not OF ed Thus any activity performed by programs scheduled by interface programs does not halt when an active request is terminated For this reason the HP supplied interface programs do not schedule other programs that are expected to be OF ed if the interface program is OF ed 2 62 LP Spool System SP Spool System The SP spool system provides three major features e capturing output sent to an LU for spooled printing e redirection of output between LUs and e system error logging Most of the print spooling features of the SP spool system are superceded by those of the LP spool system des
81. ntlan by request ID CI gt cancel antway Cancel the request currently printing on printer antway CI gt cancel antway uantport Cancel all requests for destination antway that are owned by user antport CI gt cancel 133d e i Cancel all local requests bound for remote printer lj3d without attempting to cancel requests on the remote system Error Messages mw cancel must be superuser to use e You must be a superuser to use the e option nw nw cancel must be superuser to use u You must be a superuser to use the u option cancel unknown option parm An unrecognized option was given cancel dest does not name a legal destination The destination name entered is unknown Enter lpstat a to display a list of legal destinations cancel you do not own request requestid You do not own the named request You must be a superuser to cancel another user s request cancel request requestid not found The named request was not found Enter lpstat o for a list of requests LP Spool System 2 9 cancel cancel printer printer was not busy locally cancel was told to cancel the request active on a printer but the named printer was not busy with a request If the printer is a remote printer then the word locally appears at the end to inform you that this message applies only to the local operation of the printer If the i o
82. nvoking PRINO or its clones directly may destroy the parameters passed to it 4 The PRINO clone takes control of the printing process The PRINT command terminates and the CI or FMGR prompt returns to your screen unless the Z option is specified 5 PRINO clone retrieves the working directory and locks the specified output file or device If the carriage control option is not specified the PRINO clone checks the first 70 lines of each input file for carriage control characters The character 1 in the first column of an otherwise blank line signifies a carriage control character and directs the line printer to discard the first column of each line in your file By contrast alphabetic letters in column 1 force PRINT to copy your file column for column to the line printer 6 If the Z option is specified PRINO passes return values to PRINT see the PRINT Return Values section To abort a print job use the CI command WH to determine the name of the PRINO clone doing the actual printing and then use the BR command For example CI gt br prinl The PRINT Utility 4 7 PRINT Messages When you run it without any parameters PRINT displays the printer queue and reports e the name of the file printing slave program the status of the file printing slave program the line printer LU for that print job e the print job s priority lower numbers get printed earlier e the terminal LU from which that print job was invoked
83. ol Use of this model is preferred over the generic model for PCL printers The pcl model supports the options listed for the generic model plus the options listed below Many of the option names are chosen to be compatible with option names supported by common HP UX printer model scripts Each pcl model option description below is followed by information contained in square brackets The information is in two parts The first part is the escape sequence sent to the printer to implement the option with Esc denoting the escape character and underscores _ denoting characters filled in from the option argument If both primary font and secondary font variants of the command exist then only the primary form is shown the secondary generally replaces the character with This information is provided as an aid in determining which variants of which PCL commands are supported by your printer The second part of the information in square brackets is the PCL language level base at which most printers accept the option If your printer is at or above that PCL language level then the option may be accepted if your printer supports that feature Some printer models that are below that PCL level but that are known to support the option may also be listed In general a PCL printer that receives a PCL escape sequence that it does not support will ignore the sequence See the technical reference manual for your printer to find
84. oler The list of interfaces provided appears in the following section HP Supplied Printer Interfaces The source code to the local printer interfaces is included with the LP spooler You may add your own interfaces or customize the existing ones see the following section Custom Printer Interfaces for more information Printer Model Files For each printer on your system local or remote there exists a printer model file This file identifies the printer interface to use when printing to the associated device and may specify options that configure the printer interface for the particular printer model The set of printer model files available on your system are kept in directory usr spool 1p model list this directory to see which are available When a printer is assigned a printer model file the file is copied to usr spool 1p interface printer where printer is the name of the printer being assigned a model file To display a list of options that are valid for a printer on your system list the printer model file named for that printer in the usr spool lp interface directory For example to see the options that are valid for printer raptor enter CI gt li usr spool lp interface raptor Each printer model file contains a set of commands in line 1 the remaining lines are comments The comments provide documentation on that model such as the options supported The line 1 commands are documented on page 2 61 UNIX
85. on dest non existent An invalid destination was specified 2 36 LP Spool System LP Spooler Administration This section documents system administration information Most of the programs mentioned in this section require superuser privileges to be executed For detailed information on how to use the programs refer to the description of each program earlier in this chapter Network Printing Administration This section applies to systems that have the NS ARPA 1000 or ARPA 1000 networking subsystem installed If you do not wish your system to send requests to remote hosts or network peripherals or to receive requests from remote hosts then this section may be skipped NS ARPA ARPA Configuration The network printing utilities use the etc hosts file to map host and network peripheral names to IP addresses and vice versa That file should contain an entry for each 8 character host name that the local host is to send requests to or receive requests from The etc services file must contain an entry similar to printer SL5 tep spooler remote print spooling This entry is contained in the file as shipped with the ARPA and NS ARPA products The rlpout Program The rlpout program contains the remote printer interface which allows sending requests from the local system to remote hosts and to HP JetDirect network peripherals This program is not required if no remote destinations are accessed by the local system rlpout is scheduled b
86. on allows a specified number of spaces to be inserted between headline characters in the banner The number of spaces option overrides the defaults in the FFL module set by the system installer at load time The number of characters per line see the L option should exceed the number of spaces between headline characters by at least 6 The format of the option is Y n 4 6 The PRINT Utility Z This option forces PRINT to wait for PRINO to finish before PRINT itself completes This allows PRINO to pass return values back to PRINT which can then pass them back to the caller for example CI The format of the option is 2 The return values are passed through the RETURN variables as described in the section PRINT Return Values PRINT Operation When you call the PRINT utility the following steps are executed 1 PRINT expands any file masks examines runstring arguments and then stores any numeric argument as the output LU PRINT defers evaluation of all options until the files are ready to print 2 PRINT opens all the files including those specified by the T option to ensure that it can read them 3 PRINT RPs PRINO as PRIN1 or PRIN2 and so on if that program already exists PRINT schedules this clone in the background passing it all options output and input file names Note Because only the PRINT program should invoke the clone Hewlett Packard reserves the right to change the parameter sequence I
87. ove levee chicago Move all requests with destination levee to new destination chicago Destination levee will now reject new submissions CI gt lpmove 13 5 13 7 p3xl Move requests lj 5 and lj 7 to destination pjxl The new request IDs are pjxl 5 and pjxl 7 2 26 LP Spool System lpmove Error Messages lpmove warning destination dest is not accepting requests The destination to which requests are being moved rejects new submissions The requests are moved to the destination anyway lpmove destinations are identical The from and to destination names are the same lpmove you do not own requestid The named request belongs to another user You must be a superuser to move another user s request lpmove request requestid is already destined for dest The named request is already destined for the new destination lpmove parm is not a request id A parameter was expected to be a request ID but that request was not found destination dest is not accepting requests This message informs you that the destination from which all requests have been moved now rejects new submissions This message does not indicate an error condition LP Spool System 2 27 lpsched lpsched The lpsched program is the central printer scheduler for the LP spool system Executing this program allows the LP spool system to print requests It is normally executed
88. played Local requests that match the list are shown first followed by a listing of matching requests in the queue for each remote printer Remote status display may be inhibited by specifying the i option Display the following device information for printers e If the printer is local show the device LU number e If the printer is remote show the remote host name and the name of the printer on that host e If the printer is a network peripheral as on an HP JetDirect card the network peripheral name is shown list is a list of printer names By default all printers are shown An example listing is device for 133 lu 114 device for rl j4 remote to 134 on hpdsolab device for rlj5 remote to jetdirect on hpswt06 LP Spool System 2 33 lpstat Error Messages lpstat missing trailing quote parm A matching double quote was not supplied for a list parameter that began with a double quote lpstat unknown option parm An unrecognized runstring option was given lpstat no printers No printers exist in the system Printers may be added using lpadmin lpstat printer printer non existent The named printer does not exist Use lpstat p to display the names of the valid printers lpstat no classes No class names exist on the system Classes may be added using lpadmin lpstat class class non existent The named class does not exist Use lpstat c to display the names of
89. pm down for repairs default priority 0 Note that for remote printers only the status of the printers on the local system is shown The acceptance status of printers on remote hosts is unknown A remote printer that accepts requests will accept submissions on the local host for transfer to the remote host However the acceptance status of the printer on the remote host may be to reject submissions In this case the local host will place the remote printer in retry status with reason remote host rejects submissions LP Spool System 2 31 lpstat c list o list Display class names and the printers that are members of those classes list is a list of class names By default all classes are shown An example listing is members of class laserjets 1j3 134 Display the system default destination If a request is entered using the 1p program and no destination is specified then by default the request is sent to this destination Inhibit the display of remote status only local status is shown If not given then lpstat will query remote hosts for the status of requests on remote printers when the o or u option is given Display the status of output requests list is a list of destination names and or request IDs Entering a destination name either a printer name or a class name limits the display to requests queued for that destination Entering a request ID displays only that request ID
90. pooler Administration rro cok ace E e a e e eta 2 37 Network Printing Administration ooooooocoooocroorcrrorncronooo 2 37 NS ARPA ARPA Configuration 0 cece eee eee cee eee eens 2 37 Thetipout Propran E oy eal nw IR ei eee eed 2 37 The ri pdacmon Progra i oi A A A RA 2 37 Installing the Spool System Software 00 cece eee eens 2 38 spooler Administration Tasks td ES Whe URN ORS 2 41 Los File Maintenance 3 044 oi eat kee ates e are 2 45 Resetting the Request ID Sequence Number 0 0 cee eee ee ee eee 2 45 Troubleshooting A is E a E nt adit ea ae ie kat p i ada aie att aa 2 46 HP Supplied Printer Interfaces ara nn a Cees pV ERS e 2 49 a A he ae A te ia an yeh O 2 49 Thertestad Interface ends wie 3 os Rath NN Red AAA 2 50 The passthru Interface mess co ee soda ww aloe Tease e sa 9 oh ws 2 56 Remote Printers and Network Peripherals 2 0 cece eee eee eee eee 2 57 The trte Model ici tian nail we Sac eas eee Dae ae WRAL ee E 2 57 The rhipux Model ssi ccecvic caisson eet a ee een 2 58 The rbsarModel 000 he Stet totes cede aids e e e ete do e itd 2 58 The hpnp pel Model voto as rs a dd 2 59 The hpnp passthrtu Model som cosii to a didas OES 2 60 Custom Printer Interfaces cai rd xb wae sch os pe O is BS 2 61 Printer Model File Format 9 49 A AR GL AAA BAT RRS a SHS 2 61 Modifying Printer Interface Sources 2 04 cdi ose 2 doe ediea a cies te e 2 62 Programming Considerations
91. printer gpriority Make the printer a member of the named class The class is created if it does not already exist A printer may be a member of only one class Thus if the printer is already a member of a class then it must be removed from that class using the r option before a new class may be specified Both the r and c options may be specified in the same runstring to accomplish this Class names may be up to 14 characters long and must be legal file names Remote printers may not be made class members Copy an existing printer s model file to be the new printer model file for the printer The argument must name an existing printer in the LP spool system the new or modified printer will use the same printer interface and automatic options as the named printer For example edaves1 4 uses a copy of the model file used for printer daves13 Set the default priority for the printer 0 to 7 Requests sent to this printer will be assigned this priority by default that is if the p option is not specified in the 1p or lpalt runstring Higher values indicate higher priority for each request that has the default priority assigned This value is used in determining the order in which requests are printed If not given the default priority for the printer is 0 2 18 LP Spool System lpadmin ifile Copy the named file to be the new printer model file for the printer mmodel Copy the named printer model file to be
92. priority for the request This value is used in determining the order in which requests are printed If not specified the default priority for the destination printer is used set by lpadmin or the highest default priority of all printers that are a member of the destination class is used s Suppress informational messages such as request id is E t title Use the argument as a title on the banner page of the output The title must be less than 80 characters and must be surrounded by double quotes if it contains blanks or commas When executing 1p from CI use backward quotes to prevent upshifting and comma insertion of the title w Write a message on your terminal when the request is printed The notify program is used to write to all terminals on which sessions are logged in under your user name If the request is printed remotely then e mail is sent instead By default no message is written If the request is successfully created 1p assigns it a request ID which it displays on the terminal This request ID may be used as a parameter to several programs in the LP spool system for example to obtain information about the request using the lpstat program or to cancel the request using the cancel program Return Status 1p returns the following status RETURNI the number of errors encountered zero if none RETURN_S the request ID assigned if successful Examples CI gt lp dlj3p n3 oce black lst aybe c
93. program creates a request that the LP spool system print the files specified The 1p runstring is as follows CI gt lp where options file mask lt fileoffiles Options adest ncopies ooption options file mask file mask lt fileoffiles is one or more options preceded by a dash each separated by a space or comma These may be specified in any order before the first file or mask is given If an option takes an argument it appears directly after the option char acter without an intervening blank or comma The valid options are described in the following section specifies a file or mask of files to be printed The files are printed in the same order in which they are specified in the runstring is the name of a file that contains a list of files to print one per line Copy files to be printed into the spool request directories directories under usr spool lp request that the spool system uses to access the files in a request do not attempt to create symbolic links to the files By default 1p tries to create symbolic link files in the request directories to the files to be printed If symbolic links are created the files must not be opened exclusively at the time the spool system actually prints the files Any changes made to the files since the files were spooled will be reflected in the printed output Files are always copied on systems that do not have symbolic link capability Files t
94. pstat a request not accepted Errors have been found when collecting the list of files to print in the request Error messages giving the FMP errors encountered should already have appeared The request was not created couldn t allocate a sequence number fmp error message An FMP error was encountered when allocating a sequence number for the request ID The second line indicates the FMP error The request was not created Invalid of copies parm An invalid number of copies was specified in the n option It must be an integer from 1 to 32767 invalid priority parm An invalid priority was specified in the p option It must be an integer from 0 to 7 2 16 LP Spool System 1p lp missing trailing quote parm A matching double quote was not given for the parameter in the t option lp unknown option parm An unknown option name was given lp warning lpsched is not running The request was created but the scheduler 1psched is not running The request will not be printed until the scheduler is started lp warning violation error scheduling lpsched The lpsched program could not be scheduled lp warning fmperror usr spool 1p hostname An FMP error was encountered when retrieving the local host name from the named file LP Spool System 2 17 lpadmin lpadmin The lpadmin program can be used to add or modify a printer delete a destination or set the system default destin
95. ption was not given cancel will attempt to perform the cancel operation on the remote host also cancel no requests selected on dest locally No requests were selected for the e or u options If the printer is a remote printer then the word locally appears at the end to inform you that this message applies only to the local operation of the printer If the i option was not given cancel attempts to perform the cancel operation on the remote host also cancel warning fmp error usr spool lp hostname An FMP error was encountered when retrieving the local host name from the named file 2 10 LP Spool System disable disable The disable program disables the named printers preventing them from printing requests sent to the printers or to classes of which the printers are members The runstring for the disable program is as follows CI gt disable c r reason printer printer where g cancels the request if a request is currently active on a printer being disabled By default an active request remains in the queue to be printed on the printer once it is enabled or to be printed on another member of the destination class r reason specifies a reason for taking the printer out of service This reason will be reported by lpstat The reason must be less than 80 characters and should be surrounded by double quotes From CL also use backward quotes to pre vent upshifting and comma in
96. rals hpnp_passthru remote Remote printing to network peripheral plotters The local printer interfaces above handle the printing of requests on directly connected local printers that is printers directly attached to the local system The remote printer interface sends print requests to a remote host for printing on a printer located on that host and prints to network peripherals The various interfaces and model files are discussed in the following sections Local Printers Local printer interfaces handle the printing of requests on printers attached directly to the local system A local printer interface consists of a set of routines linked into the lpout program or a copy of the lpout program with a different name HP recommends that the following local printer model files be used for the named HP printers Printer Model Recommended Model File ThinkJet generic HP 256x 293x DeskJet LaserJet PaintJet pcl QuietJet Rugged Writer Any HP plotter passthru HP local printer interfaces disable the printer if device I O errors are encountered The device is also disabled if the break flag is set on the 1pout program while printing using an HP printer interface using the RTE BR command The print request printing at the time of the error or interruption remains in the request queue The request is reprinted in its entirety on the printer once it is re enabled or is printed on another printer that is a member of the destination class of
97. ram 2 28 Ipshut program 2 30 Ipstat program 2 31 Index 2 LU redirection 3 3 mklp cmd file 2 38 model files See printer model files modifying printer interface sources 2 62 N network peripherals 2 2 2 57 printing administration 2 37 NS ARPA configuration 2 37 rlpdaemon program 2 37 rlpout program 2 37 NS ARPA configuration LP spool system 2 37 P page layout PCL 2 55 paper source PCL 2 56 passthru interface 2 56 model file 2 56 PCL Printer Control Language 2 52 escape sequence 2 52 font 2 53 horizontal pitch 2 53 language level 2 52 page layout 2 55 paper source 2 56 PCL levels of HP printer models 2 52 print quality 2 53 pcl model file 2 52 print quality selection PCL 2 53 PRINT utility amp FFL module 4 12 amp FFL variables 4 11 banner inhibit printing of 4 3 printing 4 3 carriage control 4 4 examples 4 9 form feeds 4 4 form feeds and serial drivers 4 4 loading PRINT 4 11 merging files 4 5 messages 4 8 operation 4 7 options 4 1 PRINT administration 4 11 printing files 4 1 running PRINT 4 1 suppress header 4 4 using the PRINT utility 4 1 printer adding 2 41 classes 2 4 adding 2 43 interfaces 2 3 custom 2 61 HP supplied 2 49 local 2 49 modifying sources 2 62 passthru interface 2 56 remote interface 2 57 rtestd interface 2 50 loading new forms 2 44 model files 2 3 format 2 61 generic model 2 50 hpnp_passthru model 2 60 hpnp
98. rbsd model ignores but passes on to the remote host These options are for interpretation by the destination printer interface All options not listed below will be passed on to the remote host without interpretation This model supports the following options e Data Formatting r Print data should be sent unretouched to the remote host If not given a linefeed raw character will be added to each FMP record sent to the remote host converting the file to UNIX text format as it is transferred If this option is given then the line feed characters are not added between records the records must already have the necessary carriage control embedded in the text This option has no effect on type 1 files which contain no record structure see below This option is preserved in the request as sent to the remote host 2 58 LP Spool System e BSD UNIX Spooler Options unless stated otherwise these options are deleted from the request BSD Use BSD style request conventions such as 3 digit request IDs BSDCclass Specify the class name for the banner page BSDJjob Specify the job name for the banner page BSDTiitle Specify the title used by the pr program if BSDp is given BSDi numcols Specify the number of columns by which the output is to be indented If numcols is not given the default is 8 BSDwcols Specify the page width used by the pr program if BSDp is given BSDd The print data is in DVI format produced by TeX BS
99. rect connect printer select the LU number at which the printer will be connected If it is a remote printer obtain the 8 character remote host name and the name of the printer on the remote host called rprinter in the example below The host name must be entered into the etc hosts file If the new printer is a network peripheral obtain the 8 character network peripheral name called npname in the example below and enter that name into the etc hosts file Run lpadmin to add the printer to the LP spooler The runstring is similar to one of the following e For direct connect local printers CI gt lpadmin pprinter mmodel vlu e For remote printers CI gt lpadmin pprinter mmodel ormhost orprprinter e For network peripherals CI gt lpadmin pprinter mmodel ormnpname orpjetdirect See the section on the 1padmin program for more information Once the new printer is ready to print both the accept and the enable programs must be run This allows requests to be submitted for the printer and allows the printer to print them The runstrings are LP Spool System 2 41 6 CI gt accept printer CI gt enable printer If you wish the new printer to be the system default destination enter CI gt lpadmin dprinter To add a remote printer on an HP UX system that accesses a printer on the HP 1000 these steps are performed on the HP UX machine 1 7 You are encouraged to use the sam Syste
100. rinted files sent to the line printer Suppresses file mask verification Suppresses the message Print job supervised by PRINX Transfers to filename to get the list of files to print Interprets file names from a specified working directory instead of current directory Prints all files contained in the runstring a specified number of times Specifies the number of spaces between characters in the banner PRINT waits for PRINO to finish before completing This option returns a short explanation of the PRINT options The format of the option is A This option appends the output to a specified file instead of an LU Compare A to the O option The format of the option is A outputfilename B This option prints the specified string as a banner headline The format of the option is B string Note that you may use b more than once in a single runstring In the following example you may request up to six headlines per page by extending the option as shown PRINT b pascal b stuff file pas file lod Here b is used to combine specified banner headlines with default banners in the same runstring This runstring prints the following two special headlines before the default banner and header PASCAL STUFF The two headlines in this example precede the first page of output for file pas This option inhibits printing the default banner headline before each file that is printed The
101. rounded by double quotes if it contains blanks or commas When executing lpalt from CI use backward quotes to prevent upshifting and comma insertion of the title w When the request is printed write a message on the terminal of the user that created the request The notify program is used to write to all terminals on which sessions are logged in under that user name If the request is printed remotely or was created remotely e mail is sent instead The lpalt and lp programs are identical executables Only one of these program files needs to be a type 6 executable the other may be for example a symbolic link to the type 6 file or a prototype ID segment for the type 6 file Return Status The following status is returned by lpalt RETURNI the number of errors encountered zero if none RETURN_S the new request ID assigned if the destination is changed Error Messages lpalt can t accept requests for destination dest reason for rejection The destination rejects new submissions The second line gives the reason set by the system manager when the destination was made to reject submissions The destination can be made to accept requests by using the accept program lpalt destination dest non existent The named destination does not exist To display a list of the valid destinations enter 2 lpstat a lpalt couldn t allocate a sequence number fmp error message An FMP error was encountered when
102. rt and end of the printing of requests spooled with ohold 6 When all requests requiring the forms are printed the normal forms may be re installed You may wish to disable the printer while doing this The priority fence may then be lowered to allow normal requests to print CI gt lpfence printer 0 Log File Maintenance The LP spool system keeps two log files usr spool 1p log usr spool lp lpd log The usr spool 1p log file contains a log of spool system activities including an entry for each request printed or transferred to another host This file may also contain error messages logged by various LP spooler programs usr spool 1p lpd log contains error messages logged by the rlpdaemon program New entries are appended to these files so the files may grow without bounds Either file may be purged at any time to reclaim disk space You may wish to periodically rename the files using a old extension after purging an existing old file Resetting the Request ID Sequence Number To restart the request ID sequence number purge the file usr spool lp seqfile The next request will be assigned request ID sequence number 1 LP Spool System 2 45 Troubleshooting This section provides troubleshooting hints for situations in which the spool system is not working Problem Requests are sent to a printer but are never printed Check each of the following Is the printer scheduler r
103. s This option overwrites destination files if they already exist Compare this to the A option The format of the option is 0 outputfilename P This option purges the disk file that you have sent to the line printer The format of the option is PRINT prompts you to confirm before it purges the files unless you qualify the command with OK as shown below P 0K In this case prompting for confirmation is suppressed and the files are purged The PRINT Utility 4 5 Q This option suppresses file mask verification If you do not use Q PRINT displays the files that match your runstring mask and prompts you to verify printing them The format of the option is O S This option suppresses the message Print job supervised by PRINX It overrides the default included in the FFL module set by the system installer The format of the option is 5 T This option allows PRINT to read from a given file the files that are to be printed The format of the option is T filename The file can contain file names file masks blank lines and comment lines Only one file name per line is evaluated W This option interprets file names from a specified working directory instead of your current directory The format of the option is W workingdir X This option prints all files contained in the runstring a specified number of times The format of the option is X n Y This opti
104. s print verification message Print job supervised by PRINx number of banner Following variables are used to determine th characters allowed da da da da ta ta ta ta on one line printerlength 80 filelength 80 printerbanspace 3 filebanspace 3 recognize the most significant significant bit of The following are set by default Driver Type 1 7b 12b data driversok end spaces bet printer line length file line length tween banner chars printer spaces bet tween banner chars file The following array is used to determine which drivers PRINT will These bits correspond to driver types with DVT 0 being t bit of the first word and DVT 77b being the least the last word Device Terminals Printers 077440b driver types 0b 17b 000000b driver types 10b 37b 000000b driver types 40b 57b 000000b driver types 60b 77b The PRINT Utility 4 13 Index Symbols lp_hostname 2 38 lp_loadprogs 2 39 lp_local 2 39 lp_remote 2 39 lp_remotein 2 39 lp_remoteout 2 39 lp_update 2 39 rte_help 2 39 rte_libs 2 39 rte_mklInks 2 39 rte_progs 2 40 rte_snap 2 40 rte_usr 2 40 etc hosts file 2 37 etc inetd conf file 2 37 2 40 etc services file 2 37 usr spool lp log file 2 45 ast spool lp lpd log file 2 38 2 45 lausr spool Ip seqfile file 2 45 A accept program 2 7 adding pri
105. s the following options e Data Formatting r Print data should be sent unretouched to the remote host If not given a linefeed raw character will be added to each FMP record sent to the remote host converting the file to UNIX text format as it is transferred If this option is given then the line feed characters are not added between records the records must already have the necessary carriage control embedded in the text This option has no effect on type 1 files which contain no record structure see below This option is preserved in the request as sent to the remote host Type 1 files are always sent to the remote host as if raw mode were in effect that is linefeed characters are not added to delimit line boundaries The first block containing the valid byte count for the following data in the first 12 characters is dropped during transmission it will be recreated on the remote side if the remote host is an HP 1000 The rbsd Model The rbsd model is used for transferring print requests to a remote BSD UNIX host The remote host must run the BSD spooler lpr 1pd and so on The options accepted by the rosd model fall into three categories e Those that are consumed by the rosd model for its own use These affect the format of the request sent to the remote host the options are not passed to the remote host e Those that the rosd model interprets but leaves intact in the request sent to the remote host e Those that the
106. sertion of the reason The specified reason will apply to all printers named after the r option more than one r may be spe cified intermixed with printer names to associate different reasons with differ ent printers If not specified the reason string reason unknown is used New print requests may still be entered for a printer that is disabled Requests sent to a disabled printer queue for the printer requests sent to a class of which a disabled printer is a member are printed on another member of the class New printers added to the LP spooler are initially disabled If a request is actively printing on a printer being disabled that print request is aborted Ifthe c option is given the request is cancelled Otherwise the request is left in the queue to be printed on the printer once it is enabled or to be printed on another member of the destination class The enable and disable programs affect only the local spool system Only the local operation Of a remote printer is modified A disabled remote printer will not transfer requests to the remote host but the operation of the printer on the remote host is unaffected The enable and disable programs are identical executables one program may be made a copy of or a symbolic link to the other Return Status The disable program returns the following status RETURNI the number of errors encountered zero if none Example CI gt disable r Changing paper
107. st is printed Two of these options are also supported by many HP UX printer interfaces Option nb commonly supresses the banner page and option raw commonly suppresses spooler and device driver meddling with the print data the option is also commonly abbreviated to r None of the other options above should be used when spooling a file to a remote printer on a system other than an HP 1000 See the documentation for the printer interface on the remote host to see which options are supported by that interface The rest of the information in this section applies only to the HP 1000 Files of type 2 and above are printed with an XLUEX call per FMP record The files are assumed to be in RTE FMP format The default file processing performed for file type 2 and above in absence of options to the contrary is e Column one is not treated as FORTRAN style carriage control The cc option overrides this e The default driver dependent output processing is performed for all operations other than column one carriage control For the standard RTE printer drivers this entails adding a carriage return linefeed sequence at the end of each record except for those that end in an underscore _ The nolnc option overrides the line continuation on underscore feature The raw option overrides both of the above Type 1 files are normally introduced into the spool system only by the spool system itself These files are create
108. ter on the remote host is unaffected Error Messages accept destination dest was already accepting requests The named destination already accepted new submissions accept destination dest non existent An invalid destination was specified LP Spool System 2 7 cancel cancel The cancel program removes requests from the LP spool system If a cancelled request is currently active on a printer the printing is aborted and the printer is free to print another request The cancel runstring is as follows CI gt cancel id dest id dest a uuser host i where id is a request ID as reported by lpstat for a request to cancel You may can cel a request that is owned by another user only if you are a superuser dest is the name of a destination printer or class for which the a e or u options apply If none of these options are given each destination specified must be the name of a printer the request currently printing on each named printer will be cancelled If any dashed options are given then the options are applied to each destination specified You may cancel a currently printing request that is owned by another user only if you are a superuser a cancels all of your requests for each dest specified Each request bound for the named destinations that was generated by your logon will be cancelled e empties the queue for the named destinations All requests bound for those destina
109. than gt must be a request ID The status of that request is shown in the same format as if orequest_id were given If gt file is given then lpstat s output is redirected to that file overwriting an existing file If gt gt file is given then lpst at s output is appended to an existing file If neither of these are given then lpstat prints its output to the scheduling terminal Many of the options listed below take an optional parameter named list If given this parameter may be either e A single word not containing blanks or commas For example p133 e A list of words separated by blanks or commas and enclosed in double quotes For example p 133 magiclj3 The description of each option below indicates what kind of names are expected in the list parameter If the list parameter is given only information pertaining to the given names is shown If the list parameter is not given information for all the valid names is shown For example CI gt lpstat p displays information about all printers on the system Options The options are a list Display the acceptance status of destinations for requests that is whether new requests may be entered for the destinations list is a list of printer names and or class names By default all destinations are shown An example listing is 133 accepting requests since Mar 4 2 38 pm default priority 0 134 not accepting requests since Mar 24 11 06
110. that destination New printers and classes added to the LP spooler initially reject submissions Attempts to enter new requests to a destination that rejects submissions either locally with the 1p program or remotely by a remote printer on another host are refused You must be a superuser to run this program The accept and reject programs affect only the local spool system Only the local operation of a remote printer is modified A remote printer that rejects submissions will not accept requests for transfer to the remote host but the operation of the printer on the remote host is unaffected The accept reject and lpshut programs are identical executables Only one of these program files needs to be a type 6 executable the other two may be for example symbolic links to the type 6 file or prototype ID segments for the type 6 file Return Status The following status is returned RETURNI the number of errors encountered zero if none Example mN offer CI gt reject r Printer on loan J Reject submissions to destination offer specifying reason Printer on loan gt LP Spool System 2 35 reject Error Messages reject missing trailing quote parm A leading quote was found for the reason string but no matching trailing quote was found reject destination dest was already not accepting requests The named destination already rejected new submissions reject destinati
111. the 1pstat v option report is suggested For example entering orpjetdirect for a network peripheral on a JetDirect card causes lpstat v to print device for np remote to jetdirect on npname Only one of the e i or m options may be specified in a runstring to select the appropriate printer model file If a new printer is added without specifying one of these options a default model name will be used For local printers the default is generic for remote printers the default is rhpux Once a new destination either a printer or a class is added to the spool system the accept program must be run to allow requests to be entered for that destination A new printer must also be enabled for printing by running the enable program Initially a new destination will reject attempts to enter a print request for that destination with reason new destination A new printer that has not yet been enabled will not print requests queued for it Lpstat will report that the printer is disabled for reason new printer The printer should only be enabled once the physical printer is connected and ready to print You must be a superuser to run lpadmin The lpadmin and 1pfence programs are identical executables Only one of these program files needs to be a type 6 executable the other may be for example a symbolic link to the type 6 file or a prototype ID segment for the type 6 file LP Spool System 2 19 lpadmin
112. the following status RETURNI number of errors encountered zero if none lpsched time schedules itself every 5 minutes to perform cleanup and other periodic chores The actions performed are e Requests are retried on remote printers that are in retry status meaning that temporary network errors have prevented access to the printer e Requests that could be scheduled on a printer but for an unknown reason have not been scheduled are now scheduled This recovers after disruptions such as those caused by program aborts e Printer interface programs that have aborted without properly informing lpsched of their termination are cleaned up The printer handled by the interface is downed with reason interface program aborted and the request that was printing is held in the queues You may schedule 1psched to perform the above actions immediately if needed For example once a network problem is fixed you may want queued remote print jobs on the local host to be retried right away rather than waiting for the next time schedule interval to elapse To cause lpsched to immediately perform the above actions enter CI gt xq lpsched pq You must be a superuser to run lpsched 2 28 LP Spool System lpsched Error messages lpsched scheduler was already active An attempt was made to run lpsched when lpsched was already started lpsched invalid schedule lpsched was run with invalid parameters scheduler is runn
113. tions are cancelled You must be a superuser to use this option uuser host cancels all requests for each dest specified that are owned by user user If the user name is given in the format userthost then all requests owned by user user that originated on host host are cancelled otherwise only requests that originated on the local host are cancelled More than one u option may be given to cancel requests for more than one user You must be a superuser to use this option mE inhibits remote cancels cancel only local requests destined for remote printers If this option is not given remote cancel requests will be sent to remote print ers as discussed below If a dest parameter or a destination within an id parameter names a remote printer then both local and remote cancellation may be performed Requests on the local system that meet the criteria are cancelled the requests are queued waiting to be transferred to the remote host If the i option is not given the remote host is asked to cancel any requests on the remote system that meet the criteria In general you may only cancel remote requests that you own Return Status The following status is returned by cancel RETURNI the number of errors encountered zero for none RETURN2 the number of requests cancelled locally 2 8 LP Spool System cancel Examples CI gt cancel milton 42 milton 43ftantlan Cancel requests milton 42 and milton 43 a
114. uled for local printers program rlpout is scheduled for remote printers including network peripherals This keyword allows separate versions of 1pout that support various printer interfaces to coexist opts options If this keyword is given the rest of the line contains interface specific options to be automatically passed to the printer interface These options are given without the leading o used by the 1p program Options are case sensitive This keyword must be the last in the line For example the model file line 1 intf rtestd opts nb specifies printer interface rtestd with option nb always in effect causing the banner page to never be printed You may wish to make copies of HP supplied printer model files under a new name before making modifications This prevents future HP distributions from overwriting your modified printer model files LP Spool System 2 61 Modifying Printer Interface Sources The HP supplied local printer interfaces are implemented in program lpout the source files to which are provided with the LP spooler See the instructions contained in comments in the files for help in making modifications Some files that you may wish to modify or use as the basis of a new printer interface are lpout_if ftn Interface support routines including those that recognize local interface lpout_m mac names and call the appropriate handler routines lpout_rtestd ftn The non PCL portions of the rtestd i
115. unning Entering lpstat r will display an answer to this question If the scheduler is not running start it by entering Ipsched You can also check that lpsched is not hung up somehow Is the printer enabled or in retry status Check this by entering lpstat p If so see the following discussion on disabled printers Is the priority fence of the printer low enough to print the queued requests Check this by entering lpstat p and comparing the displayed value to the priority of the requests as reported by lpstat o If the priority fence is too high you may wish to lower it Is the printer busy with a request that is hung for some reason If Ipstat p indicates that the printer is busy check the progress of that request The copy of 1pout responsible for printing the request may be in the paused state if the ohold option was given when the request was created Is the proper device LU associated with the printer for a local printer You can check this by entering lpstat v Check file usr spool 1p 1log for error messages related to the printer Note that the spool system can hold off scheduling requests onto printers for short periods of time while spooling utilities modify the queues If a spooling program is aborted while it has a scheduling lock in place the spooler will break the lock after about 5 minutes have elapsed lpsched makes an entry in its log file when it does this
116. y the lpsched program The rlpdaemon Program The rlpdaemon program receives requests from remote hosts for processing on the local system rlpdaemon is scheduled when e A remote host transfers a print request to the local host e A remote host cancels a print request on the local host e A remote host retrieves a queue listing for a local printer as happens in response to an lpstat execution on a remote host This program is not required if no local printers are accessed by remote hosts rlpdaemon is scheduled by the inetd program inetd must be running and the etc inetd conf file must contain an entry similar to printer stream tcp nowait root programs rlpdaemon run rlpdaemon 1 LP Spool System 2 37 This entry is added automatically when installing the LP spooler software The runstring portion of the inetd conf entry has the following syntax CI gt rlpdaemon 1 L logfile where 1 specifies to write error messages to file usr spool 1p lpd log Ifa request from a remote host is rejected by the local system this file may contain more information on the error L logfile specifies to write error messages to the named file instead of the default Installing the Spool System Software If you wish to use networked spooling between different hosts or to network peripherals then the current revision of the ARPA 1000 or NS ARPA 1000 subsystem must be installed on your system before the LP spool system is install

HP Printer E0495 User's Manual

Contents

Download Pdf Manuals

Related Search

Related Contents