Native Mode Spooler Reference Manual HP 3000 MPE/iX Computer Systems ABCDE HP Part No. 32650-90166 Printed in U.S.A.
PostScript R is a registered trademark of Adobe Systems, Inc. UNIX R is a registered trademark of Unix System Laboratories, Inc. in the U.S.A. and other countries. Acknowledgements The information contained in this document is subject to change without notice. Hewlett-Packard makes no warranty of any kind with regard to this material, including, but not limited to, the implied warranties of merchantability or tness for a particular purpose.
Printing History The following table lists the printings of this document, together with the respective release dates for each edition. The software version indicates the version of the software product at the time that this document was issued. Many product releases do not require changes to the document; therefore, do not expect a one-to-one correspondence between product releases and document editions.
iv
Preface MPE/iX, Multiprogramming Executive with Integrated POSIX, is the latest in a series of forward-compatible operating systems for the HP 3000 line of computers. In HP documentation and in talking with HP 3000 users, you will encounter references to MPE XL, the direct predecessor of MPE/iX. MPE/iX is a superset of MPE XL. All programs written for MPE XL will run without change under MPE/iX.
Appendix D Glossary Index vi Migration Information and Limitations contains information about the changes involved in moving to the Native Mode Spooler and describes the limitations of NMS.
Contents 1. Getting Started What is the native mode spooler? . . . . . . . System requirements and restrictions . . . . . A note on device con guration . . . . . . . . Spooler commands, utilities, and user capabilities Working with spool les . . . . . . . . . . . . Types of spool les . . . . . . . . . . . . . Input spool les . . . . . . . . . . . . . Output spool les . . . . . . . . . . . . Checkpoint les . . . . . . . . . . . . . Private and nonprivate spool les . . . . . . . Private spool les . . . . . .
Specifying where to resume . . . . . . . . . Suspending a network printer spooler . . . . . Resuming a spooler . . . . . . . . . . . . . . Releasing a suspended spool le . . . . . . . . Displaying spooler process status . . . . . . . . Opening the spool queues . . . . . . . . . . . Shutting the spool queues . . . . . . . . . . . Controlling printer access . . . . . . . . . . . Controlling the printing of headers and trailers . . Reprinting spool les . . . . . . . . . . . . . Printing an unlinked spool le .
Storing spool les . . . . . . . . . . . . . Restoring spool les . . . . . . . . . . . . Using the SPFXFER utility . . . . . . . . . Transferring spool les to native mode . . . Input by user and account name . . . . . Input by DFID . . . . . . . . . . . . . Transferring spool les out of native mode . . Output by user and account name . . . . Outputting by SPOOLID . . . . . . . . Spool File Recovery At System Startup . . . . . Recovery process improvements . . . . . . . Spooler behavior during recovery . . .
A Large Sample Con guration . . . . . . . . . . The sample NPCONFIG le . . . . . . . . . . The sample printer setup les . . . . . . . . . LPGLOBAL.HPENV.SYS . . . . . . . . . . LJMPE.HPENV.SYS . . . . . . . . . . . . LJPORTRT.HPENV.SYS . . . . . . . . . . LJPS.HPENV.SYS . . . . . . . . . . . . . Spooler Processes and Network Printing . . . . . . Network spooler process operation . . . . . . . Page Count Logging for network printers . . . . Operating a Network Printer . . . . . . . . . . .
Command recognition . . . . . . . . . Output display . . . . . . . . . . . . New commands . . . . . . . . . . . Enhancements to FIND . . . . . . . . Other enhancements . . . . . . . . . . Error and warning messages . . . . . . . Control-Y . . . . . . . . . . . . . . . Retained (SPOOK-like) features . . . . . . Features not retained (from SPOOK) . . . . Security . . . . . . . . . . . . . . . . . Console user . . . . . . . . . . . . . . Other users . . . . . . . . . . . . . . Private spool les . . . . . . . .
A. Spool File Block Format (SBF) B. Spooler Command Comparison Altering a Spool File . . . . . . . . . . . . . . Deleting a Spool le . . . . . . . . . . . . . . . Stopping and Resuming Header and Trailer Output . Enabling and Disabling Spooling . . . . . . . . . Controlling the Processing of Output Spool Files . . Starting Spooling . . . . . . . . . . . . . . . . Stopping Spooling . . . . . . . . . . . . . . . Suspending Spooling . . . . . . . . . . . . . . Suspending a class . . . . . . . . . . . . . .
Printer must stop at physical top-of-form . . . D. Migration Information and Limitations Setting Up Some Basic Tasks . . . . . . . . . . Con guring devices . . . . . . . . . . . . . . Spool File space and limits . . . . . . . . . Allowing users control of spooled devices with the ASSOCIATE facility . . . . . . . . . . . . Initiating spooling . . . . . . . . . . . . . . Automatically initiating spooling with system startups . . . . . . . . . . . . . . . . Migrating . . . . . . . . . . . . . . . . . . .
Figures 5-1. PRINTSPF Sample Output . . . . . . . . . . . A-1. Example: FUNC, P1, P2 . . . . . . . . . . . 5-64 A-4 Tables 1-1. 3-1. 3-2. 3-3. 3-4. A-1. A-2. B-1. D-1. D-2. Contents-8 Summary of Spooler Commands and Utilities Support Networked Devices . . . . . . . . Summary of NPCONFIG File Items . . . . Description of NPCONFIG File Items . . . . Setup elements for the LJ4SISET.HPENV.SYS Global File . . . . . . . . . . . . . . Physical Record (Block) . . . . . . . . . . Spool File Block . . . . . . .
1 Getting Started This chapter introduces you to the MPE/iX native mode spooler.
A note on device configuration Spooler commands, utilities, and user capabilities Your system manager is responsible for properly con guring the output devices that are managed by the native mode spooler program. Con guring channel-attached printers or plotters using the NMMGR utility is not explained in this manual.
Table 1-1. Summary of Spooler Commands and Utilities (continued) Command De nition LISTEQ LISTF LISTFILE LISTSPF OPENQ OUTFENCE PRINTSPF PURGE RENAME RESTORE SHOWDEV SPFXFER SPIFF SPOOLER SPOOLF STORE Displays all active le equations for a job or session so that you can nd out if a job's output spool le is private or will be saved. Displays a list of one or more les for the system, account or group. The spool les you see listed depend upon your capabilities.
Working with spool files To the typical MPE/iX user, the Native Mode Spooler makes it appear as though he or she has exclusive access to the printer. That is, whenever users need to print something, or if they stream a job that produces a printed report, they simply issue a command without checking to see if the printer is busy or not and the spooler handles the rest.
Input spool files The spooler creates input spool les when you submit jobs or enter data either via command line input (i.e. issuing the JOB or DATA commands) or from a spooled input device. The spooler copies a streamed or input spooled job to an input spool le and MPE schedules the job. When the job logs on, the spool le becomes the job's input ($STDIN). See the JOB command in the MPE/iX Commands Reference Manual Volumes 1 and 2 (32650-60115) for more information.
The OUT.HPSPOOL group contains only linked output spool les. If you copy an output spool le from OUT.HPSPOOL to your account, the copy is not linked into the spooling subsystem. If you issue the SPOOLF command with the parameters PRINT and DEV on the copy, another copy is made in OUT.HPSPOOL and this copy is linked. You can also create unlinked output spool les by using the BUILD or FILE commands with the ;SPOOL parameter or with the HPFOPEN intrinsic.
Private and nonprivate spool files All input spool les are automatically created private. By default, an output spool le is nonprivate, but you may choose to make it private for greater data security. Private spool files Private output spool les di er from regular nonprivate spool les in the following ways: Since they are level 2 privileged les, you may access them only by processes that call the HPFOPEN intrinsic while running at level 2 privileged mode.
There are many di erent ways to create spool les. This section provides a quick overview of some of them. Creating spool files Using a text editor To have the spooler create a spool le, you direct output to a device whose spool queue is open. For example, when you issue the command to send a le to the printer from within a text editing program, the spooler creates an output spool le containing, among other information, the data you want to print. Try this simple example to see: 1.
Streaming a batch job A second way to generate a spool le is to submit a batch job that includes, as one of the list of command it executes, a command for sending a report to the printer. You use the STREAM command, followed by the name of the job le, to submit a job. For example: STREAM job le d c Try these steps to create and stream a simple job that sends a few lines of text output to a printer. 1. Log on to your MPE/iX system and start the text editor of your choice 2.
Using the PRINT command A fourth way to create a spool le is to use the PRINT command with a standard MPE/iX le. For example: FILE SPPRNT;DEV=LP;CCTL PRINT MYFILE;OUT=*SPPRNT Using the BUILD command To create an unlinked spool le, you use the SPOOL parameter of the BUILD command.
The ;PRIVATE option of the FILE command also generates a spool le, but one that may be accessed in privileged mode only. Private spool les may not be saved or copied. They may only be purged, printed, or (within limits) altered using the SPOOLF command. The PURGE or COPY commands may not be used on private les. To create a private spool le, simply add ;PRIVATE onto a le equation for a spool le .
Copying a spool file The spooler places input and output spool les in a special group and account reserved for that purpose, and not in your own group and account. Input spool les are stored in IN.HPSPOOL and output spool les are stored in OUT.HPSPOOL. You cannot copy input spool les; they are reserved for the exclusive use of the spooler process. If you want to save an output spool le into your account, you may do so by copying this le from the group OUT.HPSPOOL with the COPY or FCOPY commands.
3. To verify the change, issue the LISTSPF command. Deleting a spool file You can use the SPOOLF command to delete one or more of your output spool les before they are printed. To do so: 1. Enter LISTSPF and choose an output spool le to delete. 2. Issue the SPOOLF command with the DELETE parameter to delete the le. SPOOLF Onnnn;DELETE 3. Issue the LISTSPF command once again to verify that the output spool le no longer appears on the list.
3. If you use EDITOR to modify the le, you cannot save the modi ed le with its original name in OUT.HPSPOOL. You may, however, save it in your logon group and account. 4. When you nish viewing the le, exit the editor. Using the PRINT command You can also view output spool les with the PRINT command. When you use PRINT, MPE/iX displays the spool le one screen at a time, without the overhead in each record.
Using the PRINTSPF utility The PRINTSPF utility allows viewing of both input spool les and output spool les. The standard MPE/iX user may not view input spool les, however, since you must have system manager (SM) capability to do so. The advantage of using PRINTSPF is that it displays the spool le in a formatted manner so that you can examine the contents of both the data and the special overhead in each record.
2 Spooler and Spool File Management Tasks This chapter shows you how to use various commands and utilities to accomplish spooler and spool le management tasks. It deals primarily with output spool les because input spool les are managed by the system and generally don't require user intervention. The topics in this chapter include: spooler management tasks including starting, stopping, suspending and resuming a spooler, opening and shutting spool queues, and controlling user access to a spooled device.
2 SPOOLER DEV= 8 ldev 3< : 9 = devclass ; devname 8 ;SHOW 2 > > 3 > > ;OPENQ 2 ;SHOW 3 > > > > > ;SHUTQ ;SHOW > > > 3 > ;OPENQ 2 > > ;SHOW ;START > > ;SHUTQ > > > > 3 ;FINISH ;OPENQ 2 > > > ;SHOW ;STOP > > ;NOW ;SHUTQ > > 3 2 > > ;FINISH ;NOKEEP < 9 > > > > > > > > > > > > > > > > > > > > > > > > > > > > > > = 6 ;NOW ;KEEP 7 6 7 > > > > 6 7 > > + > > 6 ;OFFSET= 7 > > ;SUSPEND page > > 6 7 > > > > 6 7 > > > > 4 ;OPENQ 2 5 > > 3 > > > > ;SHOW > > > > > > ;SHUTQ > >
Suspending a spooler To suspend a spooler process, use the SPOOLER command with the SUSPEND parameter or use the SUSPENDSPOOL command. When you issue either of these commands, the spooler process retains ownership of the spool le that it is currently processing, but pauses the output. While the spooler is suspended, users may continue to create spool les, but no printing takes place. The printer(s) whose spooler process(es) have been suspended will remain idle until you command the spooler(s) to resume.
Release the spool file You can suspend spooling and direct the printer to release the currently printing spool le. If a spool le is released, a di erent spool le may begin printing when spooling is resumed. Or, the released spool le could be printed by another spooler process. To release a spool le, you use the NOKEEP parameter. ;NOKEEP may only be used when ;NOW is speci ed or taken by default.
Suspending a network printer spooler When using network printers, avoid using the following commands to suspend the spooler in mid- le: SPOOLER . . . ; STOP SPOOLER . . . ; SUSPEND; OFFSET=anything SPOOLER . . . ; RESUME; OFFSET=anything SPOOLER . . . ; SUSPEND; NOKEEP SPOOLER . . . ; RELEASE Many interfaces drop a network connection if the printer is ready to receive data but no data is being sent within a speci c time period.
Note Releasing a suspended spool file If you use the following RESUMESPOOL commands to interrupt printing of a spool le on a printer that does not support Page Level Recovery (PLR), the spooler displays a warning on your $STDLIST indicating it is initiating a recovery sequence. (Refer to appendix C for details on PLR.) RESUMESPOOL . . . ; BEGINNING RESUMESPOOL . . . ; BACK any PAGES RESUMESPOOL . . .
Displaying spooler process status The SPOOLER command ;SHOW parameter displays the status of the spooling process. To issue this command, enter: SPOOLER 6;SHOW If a device class is speci ed, status is displayed for all spoolable devices in the class. You may use ;SHOW with any combination of other SPOOLER command parameters.
Shutting the spool queues The SHUTQ command prohibits anyone from creating new spool les but has no e ect on spool les which have already been opened. It does not prevent spool les from printing. To do that, you must stop or suspend the spooler. The SHUTQ command may be entered only from the system console unless allowed to other users with the ALLOW or ASSOCIATE commands.
For example, to prevent anything from printing on all devices which are members of the device class LP, enter: OUTFENCE 14;DEV=LP To set the outfence to 8 for LDEV 6, enter: OUTFENCE 8;DEV=6 Controlling the printing of headers and trailers You may use the HEADON and HEADOFF commands to print or supress printing of a paper header and trailer page between each report.
Printing on special forms The ;FORMID parameter, in conjunction with the ;FORMS parameter, may be used to specify a unique special form for printed output. The ;FORMID parameter saves the operator from interacting with the console when multiple spool les are printed with the same special forms.
;SELEQ parameter with the LISTSPF and SPOOLF commands, which are described later in this chapter. The FORMS=formsmessage must end with a period or you get an error message. The FORMID must be no longer than eight characters and must begin with a letter. An example of FORMS= (notice the period) and FORMID follows: FILE SPPRNT;FORMS=MOUNT TAX FORM.;FORMID=TAX1040 In this case, the FORMID is TAX1040. The LISTSPF command with the ;DETAIL parameter displays TAX1040 along with the spool le.
Viewing Data About Spool Files Use the LISTSPF command to display information about input and output spool les. The set of spool les that you are allowed to see depends on your capabilities. The general form of the LISTSPF command appears below. For a detailed explanation of this command and its parameters refer to chapter 4. LISTSPF Viewing specific spool files 2 2 IDNAME= ;SELEQ= 3 3 spoolid 2 3 (spoolid ,spoolid . . .
Viewing multiple spool files Use the following command to display information about multiple spool les (those spool les residing in IN.HPSPOOL and OUT.HPSPOOL ): LISTSPF @ This command displays information for the following: All spool les in IN.HPSPOOL and OUT.HPSPOOL, if you are the console user, or if you have SM or OP capability. All spool les created by any user in your logon account, if you have AM capability. All spool les in your user.account , if you are a user other than a console user.
If you are the console user or a user with SM or OP capability and you want to obtain information about all output spool les, enter: :LISTSPF O@ If you are a user with AM capability, the LISTSPF O@ command displays all output spool les created by users in your account. If you are any other user, the LISTSPF O@ displays all the output spool les for your user.account . If you are not the console user and do not have SM or OP capability, to obtain information about input spool les for your user.
Or, for example, to display information for all output spool les with priority less than or equal to 10 or with destination device EPOC you would enter: :LISTSPF;SELEQ=[PRI <= 10 OR DEV = EPOC] Excluding items in the selection equation Use NOT to exclude speci ed items with the selection equation. You may use NOT with AND and OR. For example, if you are the console user or if you have SM or OP capability, to select all spool les not created by MANAGER.SYS, enter: :LISTSPF @;SELEQ=[NOT(OWNER=MANAGER.
Using relational operators for the selection equation You may use the following relational operators in the ;SELEQ equation: = equal <> not equal > greater than >= greater than or equal < less than <= less than or equal Selection equation parameters Use the relational operators with any of the following keyword parameters to construct the selection equation of your choice.
Using wildcard characters in the selection equation Wildcards are also supported in selection equations specifying owners . Use the @ sign to represent any combination of characters. For example, if you are the console user and you want to select all output spool les created by any user in the MFG account, you would enter: LISTSPF;SELEQ=[OWNER=@.MFG] If you want to do the same thing but you are a user with SM or OP capability and not a console user, enter: LISTSPF @;SELEQ=[OWNER=@.
Spool file identification after a system reboot Spool le job and session numbers are transposed from the Jnnn or Snnn format to the J'nnn or S'nnn format whenever you perform a system START with the NORECOVERY option or whenever you import les to the system with RESTORE or the SPFXFER utility. In the above command, J@ or S@ also selects output spool les with job/session identi ers in the J'nnn or S'nnn format. Specifying J'@ or S'@ selects only spool les with J'nnn or S'nnn identi ers.
Managing Spool Files Altering spool files The SPOOLF command lets you change the characteristics of spool les such as the device, the output priority, the number of copies to print, and whether or not the spool le should be saved or deferred. You may also use it to print or delete spool les. You may use the ;ALTER parameter of the SPOOLF command to alter the characteristics of spool les. The ;ALTER parameter may not be used concurrently with the ;PRINT or ;DELETE parameters described below.
You may give your indirect le any name that suits you. Remember to precede the indirect le with the ^ sign in the SPOOLF command. When you use selection equations, the les that qualify depend upon your capabilities and whether or not you issue the command from the console. The selection is made from all output spool les if you are the console user or if you have SM or OP capability. If you are an AM user, the selection is made from all output spool les in your logon account.
Saving a spool file To save one or more output spool les, enter: SPOOLF (357,375,458);ALTER;SPSAVE or SPOOLF (357,375,458);SPSAVE The second example uses ;ALTER as the default. When an output spool le is saved , a copy of it remains in the OUT group of the HPSPOOL account after it is printed. Deferring a spool file To defer one or more spool les, enter: SPOOLF (357,375,458);ALTER;DEFER A deferred spool le does not print until it is undeferred .
Printing spool files You may use the ;PRINT option of the SPOOLF command to print output spool les. The ;PRINT option makes a linked copy of the speci ed spool le. Like the ;ALTER option described above, you may also use it to save; defer and undefer a spool le; and to specify the print device, the priority, and the number of copies. The general form of the ;PRINT option of the SPOOLF command is as follows: 2 3 2 38 IDNAME= SPOOLF leset ( leset , leset 9. .3.
Printing a spool file in your logon group and account Suppose that you have copied a spool le from the OUT group of the HPSPOOL account into the PUB group of the MFGRPTS account and named it MFGDATA. To print this spool le, while you are logged onto that group and account, you would enter: SPOOLF MFGDATA;PRINT;DEV=LP Printing a spool file from a different group and account To print MFGDATA from a di erent logon group and account, add the spool le's group and account name as follows: SPOOLF MFGDATA.PUB.
Deleting spool files The ;DELETE option of the SPOOLF command allows you to delete linked spool les. The IDNAME and ;SELEQ parameters of the ;DELETE option of the SPOOLF command operate in precisely the same way as they do for the ;ALTER parameter previously described in this section. The general form of the SPOOLF command with the ;DELETE option is: spoolid 2 3 (spoolid ,spoolid . . .
Transferring spool files between systems You may transport NMS nonprivate output spool les between NMS MPE/iX systems with STORE and RESTORE. You need not be a system manager to use these programs to store and restore spool les, but you must have nonshareable device (ND) capability. However, if you are working with spool les that were created on an early version of MPE/iX (or classic MPE/V) that does not support the Native Mode Spooler, you use a di erent method to transfer les.
capability, you can restore les created by any user in your account provided the user exits. If you are a general user, you can restore les that you created. Specifying the GROUP=OUT ;ACCOUNT=HPSPOOL option with RESTORE. You may be logged on anywhere, but you must have SM or OP capability. This method is not recommended, however, since it also restores les that are not spool les in the selected le set. If you have SM or OP capability and you restore les to OUT.
If you restore a le to OUT.HPSPOOL and that le is destined for a device or class not con gured on the target system, the le is put in the PROBLM state. The system links the le to the queue and creates the queue if necessary. The ;SHOW=LONG option of the RESTORE command displays both the original SPOOLID and the new SPOOLID of spool les restored to OUT.HPSPOOL . Refer to the STORE and TurboSTORE/iX Manual (30319-90001) for detailed information on storing and restoring les.
Input by user and account name. To input all spool les created under a speci c user and account name, enter: INPUT USER.ACCT;*T To input all spool les created by all users in a speci c account, enter: INPUT @.ACCT;*T To input all spool les created by a given user in your logon account, enter: INPUT USER;*T To input all spool les created by a given user name in any account, enter: INPUT USER.@;*T To input all spool les created by all users in all accounts, enter: INPUT @.
To run the SPFXFER utility, enter: SPFXFER Since native mode spool les can be much larger than those spool les created on MPE/iX systems prior to version A.40.00 or spool les created on MPE V/E systems, you may not be able to move NMS spool les onto those systems. Output by user and account name. To output all spool les for a speci c user and then purge them, enter: OUTPUT USER.ACCT;*T;PURGE The ;PURGE parameter is optional and causes les to be purged from your system after being written to tape.
Spool File Recovery At System Startup The input SPool File DIRectory (SPFDIR) and the output SPFDIR, which are created by Progen near the end of the system startup (boot) process, are lled with information from spool les in IN.HPSPOOL and OUT.HPSPOOL. This provides a run-time \cache" for spool le management.
Spooler behavior during recovery There may be a period after the system is available to users when some spool les in OUT.HPSPOOL do not have an entry in the output SPFDIR. While some features of the spooling subsystem (described below) are a ected during SPFDIR recovery, existing capability, resource limits, and security restrictions have not changed. While the SPFDIR recovery process is running: Users can stream jobs without restrictions.
If you issue one of the spool le management commands for a list of speci c spoolids (for example, LISTSPF #O8072 or LISTSPF (#O8072, #O7963, #O8010) it searches for each individual spool le in the list. If it cannot nd an SPFDIR entry for the le, it returns error -8039 (Cannot nd the spool le).
If none of the system volumes are in volume class SPOOL, spool les may be allocated disk space on any of the system volumes con gured as DISC. File space limits Purging spool files from the IN and OUT groups Since spool les are normal MPE/iX disk les in an ordinary account structure, the con guration for NUMBER OF SECTORS PER SPOOL FILE EXTENT and MAX NUMBER OF SPOOL FILE KILOSECTORS does not apply and has been deleted from the SYSGEN utility.
File security File security for the HPSPOOL account and its groups are as follows: HPSPOOL account: (R,A,W,L,X:ANY) Groups in HPSPOOL: IN and OUT (R,A,W,L,X,S:ANY) Device name groups: (R,A,W,L,X,S:GU) where R is read, A is append, W is write, L is lock, X is execute, S is save, ANY is any user, and GU is group user. When the HPSPOOL account is created during system startup, a user called MGR for the HPSPOOL account is created. The existence of user MGR is required by the account creation process. MGR.
then, is the group name. For example, the default device name for logical device 6 is 00000006. The device name group is D0000006. Each spooler creates its device only if the group does not already exist. You must explicitly purge the group if you have su cient capabilities and if the group is no longer useful (as when the spooling device has been removed from the system con guration). The spooler process that owns the group creates and manages its checkpoint les.
3 Configuring and Operating Network Printers Before Release 5.5 of MPE/iX, the Native Mode Spooler (NMS) allowed many programs to share a single printer connected directly to the HP 3000. Starting with Release 5.5, the spooler now supports any Printer Command Language (PCL)-based printers attached to the HP 3000 via a TCP/IP network connection and a JetDirect interface card. A printer connected to the system in this way is called a \network printer.
Supported Devices You must connect and prepare network printers according to the instructions furnished with your printer's hardware and with the printer's network interface. This information is not covered in this manual. However, the table below does list all of the HP devices that you can use in a network printing environment on an HP 3000. Some of the devices are listed by family, such as \PaintJet".
Configuring a Network Printer with SYSGEN The set of instructions below take you through the process of adding a network printer to your I/O con guration with SYSGEN. This is the rst part of the network printer con guration process. These instructions assume that you are an experienced system manager who has previously used SYSGEN. If you need more information, read Performing System Management Tasks (32650-90004).
6. At a convenient time, perform an orderly shutdown of the system and then restart it to have the new I/O con guration take e ect. d The following gure shows you a sample of the SYSGEN dialog needed to begin con guring LDEV 19 as a network printer. :SYSGEN a SYSGEN version E.00.00 : catalog version E.00.00 WED, AUG 23, 1995, 4:16 PM Copyright 1987 Hewlett-Packard Co. All Rights Reserved.
Preconfiguring network printers If you have planned the expansion of your network printing capability, you can use SYSGEN to pre-con gure the printers you will be physically adding at some future date. Other than counting toward the maximum number of devices on a system, there is no penalty for doing this. As you add the printers, you can write corresponding entries into the network printer con guration le (NPCONFIG.PUB.SYS) and place the printers in service without restarting the system.
Creating the Network Printer Configuration File The network printer con guration le NPCONFIG.PUB.SYS is a at ASCII le that the system manager creates and modi es using a text editor. The purpose of the NPCONFIG le is to supply to the system additional con guration data about network printers that is not de ned in SYSGEN. The NPCONFIG con guration le is designed to be extensible. As needed, for example, when placing a new network printer in service, the system manager may update the entries in NPCONFIG.
Syntax of NPCONFIG entries When you add an entry to NPCONFIG, it must conform to a speci c syntax. The entry consists of an entry_id which is either the keyword global for the one global entry in NPCONFIG, or the LDEV number of the network printer you are adding to the con guration (without leading zeros). The remainder of the entry is composed of keywords which indicate the item you are de ning and the value you assign to it.
Item Table 3-2. Summary of NPCONFIG File Items De nition network_address TCP_port_number program_file poll_interval poll_interval_max setup_file run_priority SNMP_get_community_name data_timeout snmp_timeout snmp_max_retries message_interval banner_intray data_intray banner_header and banner_trailer pjl_supported jam_recovery socket_trace Network address of the printer, speci ed either as an IP address or as a domain name that resolves to an IP address. This item is required. No default.
Item Table 3-2. Summary of NPCONFIG File Items (continued) De nition transport_trace default_page_size When ON (enabled), initiates a TCP-level trace of the socket in addition to a socket-level trace of the TCP connection. Default is OFF. The Banner page size can be speci ed. Default is Letter. Each of the items that you can use in an network printer entry in the NPCONFIG con guration le is described below. Table 3-3.
Table 3-3. Description of NPCONFIG File Items (continued) Item poll_interval Description If the printer is unavailable to print a le, this is the initial time interval, in seconds, that the spooler waits before again attempting to connect to the printer. The default is 10 seconds. If you specify another value, it must be a positive integer. Optional. This value only has meaning when the spooler process is not suspended, when there is a le to print, and when the printer is busy or unavailable.
Table 3-3. Description of NPCONFIG File Items (continued) Item run_priority Description The scheduling queue to which the output spooler process is assigned when it is created. Acceptable values are BS, CS, DS, or ES. The default value, CS, is used if you specify any value other than these choices. Spooler processes for system printers (HP2680, HP5000, etc.
Table 3-3. Description of NPCONFIG File Items (continued) Item data_timeout Description The amount of time, in seconds, that the native mode spooler waits for a speci c network I/O request to complete before it checks whether or not the printer and network are operating properly. This item is one of four that you may use to determine how network and/or printer problems are managed. Default is 10 seconds, but you may enter another positive integer or 0.
Table 3-3. Description of NPCONFIG File Items (continued) Item banner_intray Description Controls whether or not a PCL Paper Source command is sent to the printer, allowing banner pages to be taken from a separate paper tray. No default. Optional. The spooler performs no checks on the value you enter for banner_intray except to verify that it is an integer. It is your responsibility to provide a valid positive value. Typical values are 1 (selects the upper tray) or 4 (lower tray).
Table 3-3. Description of NPCONFIG File Items (continued) Item banner_header banner_trailer Description Used to restrict banner printing to either a header or a trailer, or neither one. The default is TRUE for both items, which prints headers and trailers, but you may also set either or both to FALSE. The values are not case-sensitive. Optional. The banner_header and banner_trailer items are only tested if Headers have been enabled for the device with MPE's HEADON command.
Table 3-3. Description of NPCONFIG File Items (continued) Item socket_trace Description Speci es whether or not socket-level tracing is on. The default is OFF. Optional. When this item is ON (enabled), it initiates a socket-level trace of the TCP connection. Socket-level tracing is useful when you suspect that the problem is in the bytestream of data sent to the printer as opposed to a problem that may be occuring at the TCP transport layer.
1. Open the le NPCONFIG.PUB.SYS in the editor of your choice and modify the entry as needed. 2. Save your changes to the le and exit the text editor. 3. Issue the STOPSPOOL or SPOOLER ; STOP command for the LDEV whose con guration you need to modify. 4. Issue the STARTSPOOL or SPOOLER ; START command for the LDEV.
since you must enter their fully-quali ed le names in NPCONFIG anyway; for example, setup_file = LJPORTRT.HPENV.SYS. Here is the standard security matrix for NPCONFIG.PUB.SYS, which is also appropriate for your setup les. d FILE: NPCONFIG.PUB.
Creating and Using Setup Files Any user, regardless of their assigned capability, may create les containing customized setup strings (analogous to environment les) to specify the printer operating mode for network printers. Such les can be used in one of two ways: If you have system manager (SM) capability and therefore can edit NPCONFIG, you can name such a le as the setup_file for a particular printer LDEV so that it becomes the default.
The MPE/iX default environment Setup strings For backward compatibility, the MPE system default environment is landscape mode, courier font, 132 characters per line, 6 lines per inch, 60 printed lines per page with a three line top and bottom margin, and single-sided operation. This is often not appropriate for output printed on a cut sheet device such as the LaserJet 4Si.
If the spooler uses one or both of the setup les speci ed in NPCONFIG, the setup le(s) are attached when the le is printed, not when it is opened for printing. This means that if you preview the spool le using the SPIFF utility or other browser, you do not see default setup information. Also, any changes to either setup are re ected the next time the spool le is printed. The attributes are not bound to the spool le when it is created.
Network Printing Configuration Tips Entering a numeric IP address correctly This section gives the system manager some tips for creating a valid network con guration le that will work well in your environment. The topics in this section include: Entering IP addresses correctly Setting appropriate poll intervals Using I/O timing e ectively For each network printer you are con guring, you must enter in the NPCONFIG le the printer's TCP/IP network domain name or its IP address in the form aaa.bbb.ccc.ddd.
Setting appropriate poll intervals At a given time, only one host can be connected to a network printer and others must wait until the printer is available. If the spooler has a spool le to print, and either the network or the printer are unavailable, it may need to attempt connecting to the printer many times before it nally succeeds. You may con gure the length of time between retries by de ning values for the poll_interval and poll_interval_max items.
Using I/O timing effectively Four I/O timing items that you may enter into the NPCONFIG le control the frequency of status checking for network printers. They are: data_timeout snmp_timeout snmp_max_retries message_interval The default values for these items are suitable for text-based reports sent to a printer such as the LaserJet 4Si, which is separated from the HP 3000 by a small number of network devices (routers, bridges, etc.).
The printer is o ine The network is slow The data_timeout timer expires and the ensuing SNMP request completes normally. No SNMP retries are required, so a \device o ine" message is displayed. Because message_interval = 0, this message is not repeated, although the spooler continues to cycle through data_timeout and SNMP requests until the printer is placed online again. Suppose that after displaying the \device o ine" message, a subsequent SNMP request times out three times.
Second scenario In this scenario, suppose that each I/O requires 15 seconds to complete, and that the I/O timing items have been set to the following values in NPCONFIG: data_timeout = 20 seconds snmp_timeout = 5 seconds snmp_max_retries = 0 message_interval = 15 Condition Result Since the I/O completes within the required Output is printer bound 20 seconds, no further checking is performed. The printer is o ine The data_timeout expires.
This section shows you a sample network printer con guration that might be appropriate for a small network con ned to one site with identical LaserJet 4Si printers. This example shows con gurations for three such printers, LDEVs 6, 200, 210. One printer, LDEV 200, is used heavily for PostScript output, so it has been con gured as two separate logical devices: LDEV 200, which uses a standard LaserJet setup le, and LDEV 201, which uses a PostScript setup le.
The sample printer setup files The setup les used in the small con guration example are explained below. LJ4SISET.HPENV.SYS The global setup le LJ4SISET.HPENV.SYS is a typical setup for portrait mode printing. It consists of several groups of settings which are rst shown in tabular form in Table 3-4, then as they might actually appear in the setup le. This le completely de nes the printer setup. You may choose to con gure many of these settings at the printer itself and omit them from the setup le.
Table 3-4. Setup elements for the LJ4SISET.HPENV.SYS Global File Group Printer Control Attribute Display functions Value O Reset defaults Job Control Page Control Font speci cation (primary \(" and secondary \)" character sets) PCL Code 4Esc5Z 4Esc5E Number of copies 1 4Esc5&l 1X Logical page origin on physical page (x,y) = (0,0) 4Esc5&l 0u0Z Orientation Portrait 4Esc5&l 0O One side/two sides Duplex, long edge 4Esc5&l 1S Paper source Bottom tray 4Esc5&l 4H Page size Letter (8.
LJ4PSSET.HPENV.SYS The contents of an LDEV-speci c setup le are appended to those of any global setup le. This means that the setup data shown below, contained in the le LJ4PSSET.HPENV.SYS, is sent after the data shown above as LJ4SISET. This setup le merely switches the printer's language personality to PostScript so that it interprets the data properly. The rst line of the setup le is a Universal Exit Language command.
The next example of a network printer con guration le might be appropriate for a large network with many printers at di erent sites. This example includes ve such printers (listed below). Four are LaserJet 4Si printers and the fth is a DeskJet 1200C used for making color prints and slides. \Local" and \remote" are used with respect to the site of the host HP3000. The network printers are: A local printer for MPE-style reports (landscape, 132 chars, 60 lines per page).
d # # # # # # # # # # # NPCONFIG.PUB.SYS This configuration uses the default values for the following items. They are not explicitly defined in this file. program_file = OUTSPTJ.PUB.SYS banner_header = TRUE poll_interval = 10 seconds Since most printers are LaserJet 4Si, their major properties are defined in the global entry. Items affected by the behavior of local versus remote printing are specified in the individual LDEV entries. global (setup_file = LJGLOBAL.HPENV.
The sample printer setup files The printer setup les described here are similar to those used in the small con guration example. To avoid repeating identical information, you are referred to the previous section where it is appropriate. LPGLOBAL.HPENV.SYS The global setup le LPGLOBAL.HPENV.SYS is identical to the setup le LJ4SISET used in the small con guration. Refer to that section for more information. LJMPE.HPENV.
LJPS.HPENV.SYS This example, like the previous one, assumes that all required PostScript, including any necessary non-resident font de nition, is in the user's data stream. The LJPS setup le merely switches the printer's language personality to PostScript so that it interprets the data properly. The rst line of the setup le is a Universal Exit Language command.
Spooler Processes and Network Printing The spooler uses two spooler programs, OUTSPOOL.PUB.SYS for non-network printers and OUTSPTJ.PUB.SYS for network printers. Both are similar in operation and internal interface. The main di erence is the type of printers they support. SPOOLMOM.PUB.SYS, the parent process of all spoolers, chooses the correct spooler program le for a given printer based on information available when it creates the spooler process for that printer.
Network spooler process operation A network spooler process operates quite similarly to a traditional spooler process. You create a spooler process by issuing a STARTSPOOL or SPOOLER ; START command, manage spooler processes by the other usual MPE/iX spooler commands, select les to print using the same mechanism as a traditional spooler process, and so on. The major di erence between the two spooler processes is their device management.
Operating a Network Printer Using the ENV parameter to designate a setup file This section includes information for people using a network printer that the system manager has already con gured. Such users can be a member of the system administration sta (managers, operators, etc.) or a standard MPE/iX user.
If you do use a dedicated network printer for printing special forms, you may also want to ensure that the spooler always conducts the forms message dialog for all copies of all les that include a forms message. The spooler's default behavior is to conduct such a dialog only when the forms message of the current le is di erent from that of the previous le. To override the default so that the spooler conducts the dialog each time, you can use the FORMSALIGN command.
Acceptable text formats for network printers This section describes the two forms in which applications can generate data destined for network printers which support only PCL, or PCL and, via PJL, the PostScript language. These forms are MPE record-oriented output or bytestream les, which may be raw PCL data, PostScript data, or ASCII text. MPE record-oriented output MPE record-oriented output is typically one line of ASCII text per spool le record.
Printing a bytestream disc file. Bytestream les can exist on disc, either written directly to the HP 3000 by a POSIX application or transferred to the HP 3000 from a backup archive or another system. What method you use to successfully print a bytestream disc le depends upon whether or not the le contains motion control sequences to manipulate the logical pen of the printer other than simple and characters.
Examples of converting bytestream files. Consider the following example, where myfile is a bytestream le: :FILE FROM=myfile :FILE TO;DEV=LP;CCTL :FCOPY FROM=*FROM; TO=*TO FCOPY opens le *TO with CCTL, using the con gured record length of a printer in class LP as a default. Since my le does not have a carriage control attribute, FCOPY speci es a CCTL code of 0 when writing a record to *TO. This code, having no special function, results in a single by default.
4 Commands Reference The commands that a ect spooling have the following major functions: to control spool les to control spooler processes (processes operating spooled devices) This chapter contains the complete syntax for the native mode spooler commands as well as other related commands.
Creates and immediately allocates a new empty le on disk.
BUILD SPOOL SPOOL speci es an output spool le that is not linked to the spool le directory (SPFDIR) and, therefore, is not printed automatically. No spooling attributes are initialized. If the output spool le is ever linked to the SPFDIR by using the SPOOLF . . . ;PRINT command, all attributes are set at that time according to the rules of the command. Spool Files cannot be temporary les. If you specify the ;SPOOL keyword, a le code of 1516 (output spool le) is forced.
Copies one le to another by creating a new le or by overwriting an existing le. (Native Mode) COPY Syntax Enhancements 4-4 Commands Reference 2 3 COPY FROM= source le ;TO= , target 93 28 < ASK = le4 YES 5 ; : NO The COPY command allows the copying of nonprivate output spool les. The new le is not linked to the spool le directory (SPFDIR).
FILE Declares the le attributes to be used when a le is opened. This declaration, informally known as a le equation, may be used to override programmatic or system default le speci cations. With the addition of shared parameters from the NS3000/XL AdvanceNet subsystem, the declaration may specify a formal le designator that may be used to access a remote le or device in a subsequent command or intrinsic.
FILE Syntax for access ;NOCCTL ;CCTL 2 6 6 6 6 6 ;ACC= 6 6 4 93 28 < ;NOMULTI = ;NOMR ;WAIT 4 ;MULTI 5 : ; ;MR :NOWAIT ;GMULTI 933 28 IN > > > > > 77 6> > > > > OUT > 77 6> > > 6< =77 77 6 UPDATE 77 6 7 6> >7 > OUTKEEP > 77 6> > > 5 5 4> > > APPEND > > > > ; : INOUT 2 ;BUF= numbu ers ;NOBUF 3 ;LOCK ;NOLOCK 28 ;EXC > > 2 36 < ;SHR ;FORMS=formsmsg 6 4 > ;EAR > : ;SEMI ;COPY ;NOCOPY 93 > > =7 7 5 > > ; 93 28 < ;NOLABEL = 5 4 33 32 2 3 2 2 IBM
FILE formid PRIVATE SPSAVE No spooling attributes are initialized. If the output spool le is ever linked to the SPFDIR by using the SPOOLF . . . ;PRINT command, all attributes are set at that time according to the rules of the command. If you specify ;SPOOL, a le code of 1516 (output spool le) is forced. The formid parameter applies only to output spool les. It is a string of up to 8 alphanumeric characters, beginning with a letter, that uniquely identi es a special form to mount.
Con gures one spooled printer, or a group of spooled printers related by device class, to conditionally enter into a forms message dialog with its operator(s) when the current spool le includes a forms message.
FORMSALIGN process, the current spool le contains a forms message and when an overriding formid speci cation is not in e ect EACHCOPY FORMIDOVERRIDE The second and subsequent copies of the same spool le will print without the forms message dialog if they are printed consecutively. The spooler process conducts the forms message dialog for every copy of every spool le that contains a forms message if an overriding formid speci cation is not in e ect. This is a subparameter of the chosen EACHxxxx keyvalue.
FORMSALIGN select a subset of all spool les to alter, delete or display, based on FORMID=, regardless of the setting of (NO)FORMIDOVERRIDE for a given device. They are independent of each other. Note No matter which set of the above options is selected, if the current spool le has no forms message but special forms are mounted on the device, the spooler conducts the standard forms dialog. If the DIALOG option is omitted, the con guration is not changed.
FORMSALIGN Note Because this command may a ect more than one device (if applied to all devices in a class), it is possible to get warnings for some of those devices and not for others. A warning on one or more devices a ects only that device. The command continues to execute until all selected devices have been con gured and/or shown, or an error is detected. An error terminates the command.
FORMSALIGN Example 2 The MPE V/E and CM spoolers conducted a forms message dialog for each copy of each spool le printed. To duplicate this operation, enter: FORMSALIGN 6; DIALOG=EACHCOPY, NOFORMIDOVERRIDE Examples 3 and 4 assume that LDEV 6's spooler process prints the sequence of les shown below, and that the sequence starts with standard forms on the device. The FORMID and FMSG columns denote actual text except for \(none)", that denotes the absence of text.
FORMSALIGN MSG03, to be skipped. That may not be the e ect 10 12 14 you intend. The standard forms dialog is not repeated, even with a new FORMID. Here the FORMID changes from SEQ 11 but the forms message does not. Since we are using FORMIDOVERRIDE, the FORMID change triggers the forms message dialog. Same as note 12, except that the FORMID change is from an explicit FORMID to no FORMID. Because the forms message is nonblank, the spooler enters into a normal forms message dialog.
FORMSALIGN Example 4 SEQ # SPOOLID ----- ------1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 O100 O100 O101 O102 O102 O103 O103 O104 O105 O106 O107 O108 O108 O109 O110 NOFORMIDOVERRIDE FORMID -------- FMSG ------ COPY # ------ EACHCHANGE ---------- EACHFILE -------- EACHCOPY -------- (none) (none) (none) (none) (none) FORM02 FORM02 FORM02 FORM02 FORM00 FORM04 FORM05 FORM05 (none) (none) MSG01 MSG01 MSG01 (none) (none) MSG02 MSG02 MSG03 (none) (none) MSG04 MSG04 MSG04 MSG04 (none) 1 2 1 1 2 1 2 1 1 1 1 1 2
JOB De nes a job to be scheduled with the STREAM command or an input spooled device to run in batch mode. JOB 3 2 Syntax 2 3 2 jobname2, username3 3/userpass .
Displays all active le equations for a job or session. LISTEQ 2 Syntax Enhancements 4-16 Commands Reference LISTEQ list le 3 LISTEQ displays the parameters PRIVATE and SPSAVE.
LISTF Displays information about one or more permanent les. LISTF does not display le information for les residing in hierarchical directories. To list such les, use the LISTFILE command. Refer to MPE/iX Commands Reference Manual Volumes 1 and 2 (32650-60115) for more information on listing hierarchical les. LISTF LISTF Syntax leset Parameters listlevel -3 -2 -1 Note 2 32 32 leset ,listlevel ;list le 3 Speci es the set of les to be listed.
LISTF 2 3 4 6 4-18 Commands Reference or binary records, carriage-control option, current end-of- le location, and the maximum number of records allowed in the le. Displays the le name, le code, record size, record format, and other le characteristics such as ASCII or binary records, carriage-control option, current end-of- le location, and the maximum number of records allowed in the le.
LISTFILE Lists le information. The LISTFILE command displays le information for les residing in hierarchical directories. For more information about the LISTFILE command, refer to MPE/iX Commands Reference Manual Volumes 1 and 2 (32650-60115) LISTFILE Note Spool les, which reside in IN.HPSPOOL or in OUT.HPSPOOL, are named according to MPE conventions and appear in a hierarchical listing only to the extent that all MPE les do so. . Syntax leset 2 3 32 LISTFILE , . . .
LISTFILE Format Selection Option Name Displayed Information 03 (DETAIL) Shows LISTF, 3 data plus the lockword, creator, and label address. AM or SM capability required. 02 01 ACD Shows only the access control de nition (ACD) . LABEL Shows only the le label in hex. 0 FILES Shows only the le name. 1 SUMMARY Shows LISTF,1 data. 2 DISC Shows LISTF,2 data. 3 DETAIL Shows LISTF,3 data. 4 SECURITY Shows LISTF,4 data.
LISTFILE PERM TEMP PERMTEMP USENAME TREE NOTREE Operation notes An option that is used to display permanent les only. This is the default. An option that is used to display temporary les only. An option that is used to display both permanent and temporary les. Temporary les are listed after the permanent les. Applies only to Hierarchical File Syntax (HFS) named les. This option indicates that the name is to be used to determine how many levels to display.
LISTFILE Use This command may be issued from a session or a job, in program, or in BREAK. It is breakable. (You may abort its execution.) If the leset is in MPE syntax, LISTFILE will not display any directories, or any les that do not follow MPE naming syntax (LISTFILE @,2, for example) will not display the le \am pm" created by some HFS application; however, LISTFILE ./@,2 will. Refer to MPE/iX Commands Reference Manual Volumes 1 and 2 (32650-60115) for more information on listing hierarchical les.
LISTFILE Example 1 LISTFILE SPRLRFMT, 5 ******************** FILE: SPLRFMT.SPLR.
Produces a listing of spooled les, both input and output. (Native Mode) LISTSPF Syntax LISTSPF Parameter definitions 2 2 IDNAME= ;SELEQ= spoolid 3 3 spoolid 2 3 (spoolid ,spoolid . . . ) select-eq ^indirect le ;DETAIL ;STATUS One or more spool le IDs: #Innn for input spool les or #Onnn for output spool les. These IDs are assigned by the spooling subsystem at spool le creation time. The # is optional; but if it is used, an O or I must also be used.
LISTSPF LISTSPF O@;SELEQ=[(OWNER=user.acct)AND(PAGES<100)] If you are not an SM, OP, AM, or console user, the following command displays all the output les in your default group with a priority greater than 2 that were created before September 30, 1989. LISTSPF 2 3 O@;SELEQ= (PRI>2)AND(DATE<09/30/89) Selection equations have this format: (In this display, interpet ::= as \can be replaced by".) 2 3 select-eq ::= equation Begin and end a selection equation with square brackets ([ and ]).
LISTSPF parm ::= FILEDES: Formal or actual le designator for the spool le. For example, if you enter the le equation below and print to it, EPOCLONG becomes the spool le's FILEDES. FILE EPOCLONG;DEV=EPOC;ENV=LPLONG.ENV.SYS PRINT MYFILE,*EPOCLONG You may use wildcards. This keyword supports selection on the null string by entering FILEDES= "" (You may also use single quotes). You must include such a construct if you speci cally want to select such an attribute.
LISTSPF parm ::= DISP: Disposition: SPSAVE or PURGE. Refer to the notE accompanying the PAGES description. parm ::= COPIES: Number of copies. Minimum is 1, maximum is 65,535. Refer to the note accompanying the PAGES description. parm ::= PRI: Output priority minimum is 0, maximum is 14.refer to the note accompanying the PAGES description. parm ::= JOBNUM: Job or session number under which the spool le was created, for example: #S257, #J329, or Sn (the \#" is optional) where 1 n 16,383.
LISTSPF ^indirect le Note The indirect le parameter speci es the name of a le containing the selection equation. It must be preceded by a caret (^). The selection equation contained in the le may not exceed 277 characters in length, including the brackets in which it must reside. There is no restriction on the indirect le code. If the record size exceeds 277, only 277 characters per record are read and a warning is issued.
LISTSPF Operation notes This command is provided to enable users to obtain a list of spool le information without having to look for it within a list that includes other les. The display for LISTSPF is di erent from the SHOWIN/SHOWOUT display. LISTSPF displays both output and input spool les. The display shows output spool les, then input spool les, and nally a summary status display. The parameters are divided into three groups: selection, detail and status.
LISTSPF SPOOLID JOBNUM FILEDES The unique spool le identi er. The job or session identi er of the job or session that created the spool le. The exception to this is that the jobnum for a JOB input spool le is the job number assigned the process whose $STDIN is (or will be) this input spool le, as opposed to the jobnum of the process that streamed the job. Job numbers containing an apostrophe (J123) indicate that the spool le was imported by SPFXFER or RESTORE, or was recovered after a START NORECOVERY.
LISTSPF The native mode spooler does not open its own spool les. It calls a spool le management routine to select the next spool le and open it. 4Is the following information still true?5 In addition, there is a new NMS per-device con guration parameter that is currently not enabled because of a lack of a user interface for it. This allows you to specify that no banner (trailer and header) be printed between copies of the same spool le if copies are printed consecutively on the same device.
LISTSPF waiting for the last FCLOSE of the spool le before purging it. These commands place a spool le in the DELPND state: PURGE DELETESPOOLFILE SPOOLF nnn ;DELETE STORE with the PURGE option XFER: The spool le has been selected for RSPFN OWNER 4-32 Commands Reference transportation from one node of a network to another. The XFER state is supported (in that it may be displayed, and used as a STATE in a selection equation), but is provided only for use as desired by third-party software providers.
LISTSPF Display field and The optional second line of the display has the following appearance: description: d c FORMID JOBNAME COPSRM TESTJOB 1 SECTS 250 FORMID JOBNAME COPSRM SECTS RECS PAGES Note RECS PAGES 500 ~9 DATE TIME 12/20/88 8:39 An 8-character display, the rst of which is a letter. If an F appears in the RSPFN column but this eld is blank, it means that the le has a forms message but formid was not speci ed.
LISTSPF d c The status display has the following format: INPUT SPOOL FILES ACTIVE = 1; OPEN = 2; READY = 3; OUTPUT SPOOL FILES CREATE = 2; DEFER = 1; DELPND = 0; PRINT = 1; PROBLM = 0; TOTAL IN FILES = 6; IN SECTORS = 144; TOTAL OUTFILES = 8; OUT SECTORS = 13090; READY SELECTED SPSAVE XFER = = = = 3; 4; 1; 0; OUTFENCE = 6 OUTFENCE = 10 FOR LDEV 6 b This display consists of three parts. The values in the rst two parts represent only those spool les selected for display.
LISTSPF Examples d c Following are some examples of the displays produced by LISTSPF. The rst and third examples display all output spool les for the current user.account not using the console. The second example displays all spool les for the current user.account not using the console.
LISTSPF d a LISTSPF @;DETAIL SPOOLID JOBNUM FORMID FILEDES PRI COPIES JOBNAME COPSRM DEV SECTS STATE RSPFN OWNER RECS PAGES DATE #O123 J12 SP 13 TESTJOB 2 1 PP 250 PRINT 500 F DEV.HPE 125 07/09/88 8:39 #O124 S14 LIST PAYCHECK TESTJOB 9 1 1 00000012 250 READY 500 F DEV.HPE ~9 12/20/88 8:39 #O128 J144 $STDLIST 8 LPJOB 5 3 EPOC 250 READY 127 DEV.HPE 21 12/20/88 22:19 #O1233 S1234 OUTLIST TESTJOB 1 1 FASTLP 250 DEFER DEV.
LISTSPF d c a LISTSPF;STATUS INPUT SPOOL FILES ACTIVE = 0; OPEN = 0; READY = 0; OUTPUT SPOOL FILES CREATE = 0; READY DEFER = 1; SELECTED DELPND = 0; SPSAVE PRINT = 1; XFER PROBLM = 0; TOTAL IN FILES = 0; IN SECTORS = 0 ; TOTAL OUTFILES = 4; OUT SECTORS = 1000; OUTFENCE = = = = 2; 3; 0; 0; = 6 b Status Display Related information Commands Manuals SPOOLF, SHOWIN, SHOWOUT, LISTFILE MPE/iX Commands Reference Manual Volumes 1 and 2 (32650-60115) Commands Reference 4-37
Opens the spool queue for a speci ed logical device, device name, or all devices of a device class. OPENQ Syntax OPENQ 2 3 8 ;SHOW ldev > > 2 < devclass > devname > : @ Enhancements devname SHOW @ 9 3 > > = ;SHOW 2 3 ;SHOW > > ; The device name of the spooled device. devname must begin with a letter and consist of 8 or fewer alphanumeric characters. Note that it is not possible to have a device class name and a device that are the same.
OPENQ d c SPOOLING QUEUE OPENED FOR DEVICE device, BUT NOT IN EFFECT SINCE THE SPOOLING QUEUES ARE GLOBALLY DISABLED. (CIWARN 4625) a b Refer to appendix B for more discussion on global enabling and disabling of spooling queues. Use the @ option without any other parameter. The SHOW option entered with the @ option returns an error.
De nes the minimum priority an that output spool le needs in order to be printed. OUTFENCE 2 Syntax OUTFENCE outputpriority ;LDEV=dev 2 4 ;DEV= Enhancements dev devclass devname 4-40 Commands Reference 8 < dev : devclass devname 3 93 = 5 ; The logical device number of an output device. The name of a class of devices that are to have their outfence value changed. Devclass must begin with a letter and consist of eight or fewer alphanumeric characters. Devname is the name of the device.
PURGE Deletes a le from the system. PURGE 2 Syntax Enhancements Note PURGE lereference ,TEMP 3 You may purge a nonprivate output spool le by entering PURGE spool le where spool le is the le name of the spool le. The PURGE command deletes the speci ed spool le, its spool le directory (SPFDIR) entry, and any checkpoint les that may exist for the spool le. The spool le does not print after it has been purged.
Changes identity ( le name, lockword, and/or group name) of a disk le. RENAME 2 Syntax Enhancements 4-42 Commands Reference RENAME old lereference,new lereference ,TEMP 3 You may rename spool les using the RENAME command if you have access to them. This is allowed only with spool les that are not linked to the spool le directory (SPFDIR).
SHOWDEV Reports the status of input/output devices. SHOWDEV Syntax Parameters ldev SHOWDEV classname ldev 2 ;ACD 3 Logical device number of device for which status information is to be displayed. This number is unique for each device. Default is that status information for all system devices on the system is displayed. Device class name of device(s) for which status information is to be displayed. This name may apply to several devices.
SHOWDEV UNAVAIL DISC DISC (RPS) 4-44 Commands Reference The device is not available; it is under the control of a job, session, or a system process, such as a spooler. The device is a disk and is always available. The device is a CS-80 disk on which rotational position sensing (RPS) has been enabled.
SHOWDEV OWNERSHIP Includes device ownership and may include one of the following: SYS Controlled by the system. If #nnn appears, it speci es the process identi cation number (PIN) of the controlling process (program). SPOOLER IN Input spooling in e ect, controlled by spooler. SPOOLER OUT Output spooling in e ect, controlled by spooler. #Jnnn Controlled by the indicated job. #Snnn Controlled by the indicated session. nn FILES Indicates number of les currently in use on a disk.
SHOWDEV ASSOCIATION ACD Use Examples Indicates the logical devices by device class that have been established by the user with the ASSOCIATE command. Access Control De nition. May include any of the following information per username.acctname: R Read access. W Write access. L Lock access. A Append access. X Execute access. None No access. RACD Copy or read the ACD. This command may be issued from a session, a job, a program, or in Break. Pressing 4Break5 aborts the execution of this command.
SHUTQ Closes the spool queue for the speci ed logical device, device name, or all devices of a device class. SHUTQ Syntax SHUTQ 2 3 8 ;SHOW ldev > > 2 < devclass > devname > : @ Enhancements devname SHOW @ d c 9 3 > > = ;SHOW 2 3 ;SHOW > > ; The device name of the device. Note that it is not possible to have a device class name and a device name that are the same. If you enter an alphanumeric character string, the command searches the device class list rst, and then the device name list.
Controls spooler processes.
SPOOLER Parameters ldev devclass devname START The logical device number of the spooled device. The device class name of the spooled devices. devclass must begin with a letter and consist of eight or fewer alphanumeric characters. The device name of the spooled device. The devname parameter must begin with a letter and consist of eight or fewer alphanumeric characters. Note that it is not possible to have a device class name and a device name that are the same.
SPOOLER or SPOOLER devclass;SHOW or SPOOLER devname;SHOW The STOP option is valid only if a spooler is in the ACTIVE, SUSPEND or IDLE state, or (if accelerating a previous STOP ;FINISH to STOP ;NOW) the STOP pending (*STOP) state. If neither the NOW nor the FINISH option is speci ed, NOW is taken as the default. If neither the OPENQ nor the SHUTQ option is speci ed, SHUTQ is taken as the default.
SPOOLER The STOP option is valid only if a spooler is in the IDLE or ACTIVE state. Except for a short period during startup when it is in the START state, an input spooler is always in the IDLE or ACTIVE state. SUSPEND The NOW, FINISH, OPENQ, and SHUTQ options are not applicable to an input spooler process and result in an error message if any is used. The SUSPEND option is valid only for output spooler processes. It suspends output to one or more spooled devices.
SPOOLER SUSPEND with certain other parameters presents special cases: SPOOLER dev ;SUSPEND;NOW;KEEP with no ;OFFSET= (NOW and KEEP are defaults.) With no o set, the spooler suspends as soon as it processes the command. It suspends after processing the current spool le block and reads no more data from the spool le; nor does it ush existing data from the le system or device bu ers. How you resume the spooling a ects the subsequent data output.
SPOOLER spooler, a page number is saved in the spool le's le label extension (FLABX). This page number is either the last complete page that was printed (if no OFFSET was speci ed) or one page prior to that speci ed by the nal OFFSET applied to the le (with a lower limit of 0). The next time the le is selected for printing by any spooler, output resumes at the page following the page saved in the FLABX.
SPOOLER d a c b Output spooler, LDEV #ldev : Received a command while outputting a file. RESUME RELEASE Note When the le is released by the spooler, a page number is saved in the spool le's le label extension (FLABX). This page number is either the last complete page that was printed (if no OFFSET was speci ed) or one page prior to that speci ed by the nal OFFSET applied to the le (with a lower limit of 0).
SPOOLER Note The FINISH option is not valid for spooled input devices. Either a STOP or SUSPEND that includes the FINISH option may be accelerated to a higher-priority command without waiting for the present spool le to nish printing. For example, SPOOLER . . . ; SUSPEND; FINISH may be followed by: SPOOLER...;SUSPEND;NOW or SPOOLER...;STOP;FINISH or SPOOLER...;STOP;NOW NOW Similarly, a SPOOLER . . . ;STOP;FINISH may be accelerated to SPOOLER . . . ;STOP;NOW. To go in the opposite direction is an error.
SPOOLER NOKEEP is used as a parameter to the SUSPEND option. The spooler is actively processing a le or is suspending. The NOW parameter is also speci ed or taken by default. [+/-]page Page Definition Directs the spooler to close the spool le that it is currently processing.
SPOOLER an extremely limited interpretation of the spool le by the storage manager, because a serial printer does not return page data to its storage manager. The storage manager does not attempt to interpret the spool le data, looking for escape sequences that may advance paper, eject a page, or change the page length or line density. This would degrade performance to an unacceptable level. Instead, it checks the carriage-control character supplied as part of the user's FWRITE intrinsic call.
SPOOLER OPENQ are processed rst, so the SHOW option re ects the updated state of the process(es) at the completion of the command executor. Please refer to the note following the example below. The OPENQ option or parameter enables spooling for a speci ed logical device, device name, or all devices of a device class. This allows users to generate spool les on that device(s). Refer to the OPENQ command for more information. OPENQ is the default value for the START option.
SPOOLER If you use any of the following commands to interrupt printing of a spool le (anywhere but at the end of the le) on a printer that does not support Page Level Recovery (PLR), the spooler displays a warning on your $STDLIST indicating it is initiating a recovery sequence. (Refer to appendix D for details on PLR.) SPOOLER . . . ; STOP SPOOLER . . . ; SUSPEND; OFFSET=anything SPOOLER . . . ; RESUME; OFFSET=anything SPOOLER . . . ; SUSPEND; NOKEEP SPOOLER . . .
SPOOLER If the SHOW option is used, the display shows the current state of the selected spooler(s) at the time that the command executor has completed processing the command . This means that the selected spooler(s) may not actually be in the requested state, but in a pending state on the way to achieving the requested state. This is because it has not nished acting on the command and updating the process state before the SHOW option is performed.
SPOOLF Allows a quali ed user to alter, print, or delete output spool le(s). (Native Mode) SPOOLF Syntax SPOOLF has three possible execution branches. Which branch you choose depends upon whether your objective is to alter, print, ;delete. Branch 1 (;ALTER) SPOOLF 9 8 2 3 spoolid > > > > 3 2 IDNAME= > > > > , spoolid . . .
SPOOLF branch and any of its parameters. If your objective is to delete, use the third execution branch and any of its parameters. Caution When using network printers, avoid using SPOOLF . . . ; DEFER or SPOOLF . . . ; DEV=new LDEV to suspend the spooler in mid- le. Many interfaces drop a network connection if the printer is ready to receive data but no data is being sent within a speci c time period.
SPOOLF select-eq lename[/lockword[.groupname[.accountname]]] You may use wildcards. Files that are not spool les are ignored. An error is returned for each input spool le in the le set. If the le name or set is not fully quali ed, the default is the user's current logon group and account. In batch mode, if any le in the set has a lockword, it must be supplied with the command; therefore, the le cannot be part of a set that contains wildcards.
SPOOLF Note The logical operator AND takes precedence over the logical operator OR. For example: SPOOLF O@;DELETE;SELEQ=[FILEDES=REPT OR OWNER=BOB.ACCTG AND PRI>8] [FILEDES=REPT OR OWNER=BOB.ACCTG AND PRI>8] is the same as [FILEDES=REPT OR (OWNER=BOB.ACCTG AND PRI>8)]. value ::= Appropriate values per data type. parm ::= The parameter (parm ) may be one of several attributes of the spool le to be altered or deleted, such as the dev parm, the FILEDES parm, and so on. The parm choices are described below.
SPOOLF Note This attribute does not apply to input spool les; therefore, any logical condition involving the attribute always returns FALSE when tested against an input spool le. parm ::= FORMID: Form name. You may use wildcards. (The formid is an ASCII string up to 8 characters, the rst of which must be a letter.). Refer to the note accompanying the FILEDES and pages description. parm ::= STATE: READY, ACTIVE, OPEN, CREATE, PRINT, PROBLM, DELPND, SPSAVE, DEFER, XFER.
SPOOLF n 16,383. (The commas are for clarity; do not enter any commas in the actual equation.) For a job input spool le, the JOBNUM shown is allocated to the job, not the job or session that streamed it. You may use some wildcards; J@ accepts all jobs, S@ accepts all sessions. J'@ and S'@ are also allowed, The apostrophe (') indicates an imported spool le or a spool le recovered during START NORECOVERY. parm ::= RECS: Number of records in the spool le. A positive integer is expected.
SPOOLF ALTER Records are processed as follows: Leading and trailing blanks are stripped. If the last nonblank character is an ampersand (&), it is also stripped; otherwise, one blank is added back to the end of the record as a delimiter. The character count of the record is added to that of the records processed previously. If the total character count exceeds 277, an error is returned. If the total is less than 277, the current record is appended to previous records.
SPOOLF PRINT Depending on both the content of the data and the amount of bu ering, this may require a signi cant part of a page or even several pages. The PRINT option copies the speci ed le sets to the HPSPOOL account and links the new output spool les into the spool queues for printing. It is especially useful for generating more copies of a spool le in the SPSAVE state. If the target device or class information exists in the le label extension, that device or class is used as the default.
SPOOLF Depending on both the content of the data and the amount of bu ering, this may require a signi cant part of a page or even several pages. The following command returns the spool le to its previous state from the DELPND state, if the command is issued before the le is actually deleted: SPOOLF nnn ;ALTER Interruptions to the spooling process are di erent, depending on whether the spool le was opened by a spooler or by a user process.
SPOOLF Someone opens it and closes it (with PURGE, SPOOLF;DELETE, FCOPY, PRINT, or an editor). STORE completes and the PURGE option was selected. It is made ready by raising the number of copies such that after the SPOOLF . . . ;ALTER completes, the number of copies to be printed exceeds the number already printed. ldev The DELETE option works on either DATA input spool les in the READY state, or all output spool les in the READY, PRINT, DEFER, SPSAVE, or PROBLM state.
SPOOLF outpri numcopies SPSAVE Speci es the output priority of the designated spool les, where 0 is the lowest and 14 is the highest. Only an OP user or the console can specify an outpri of 14; other users are limited to 13. The default is 8 with the PRINT option and no change for the ALTER option. Speci es the number of copies of the designated spool les to be printed. The allowable range is 1 through 65,535. (The commas are for clarity; do not enter any commas in the actual command.
SPOOLF The SHOW option allows a user to display the results of the SPOOLF command. All other parameters are processed before the SHOW. Here is an example: SHOW d c a SPOOLF O@;SELEQ=[DEV=16];ALTER;PRI=8;SHOW SPOOLID #O414 #O416 JOBNUM FILEDES PRI J5 $STDLIST 8 J7 HOTSTUFF 8 Operation notes COPIES 1 2 DEV 00000016 00000016 STATE RSPFN READY READY OWNER ALIX.MKT JACK.SALES Input spool le attributes cannot be altered, but input spooled DATA les can be deleted.
SPOOLF listspf SPOOLID JOBNUM FILEDES #O620 #O621 #O622 #O623 #O624 #O625 S327 S327 S327 S327 S327 S327 NOFORMID NOFORMID FORMID1 FORMID1 FORMID2 FORMID2 PRI COPIES DEV 2 2 2 2 2 2 1 1 1 1 1 1 LP LP LP LP LP LP STATE RSPFN OWNER READY READY READY READY READY READY INPUT SPOOL FILES ACTIVE = 0; OPEN = 0; READY = 0; OUTPUT SPOOL FILES CREATE = 0; DEFER = 0; DELPND = 0; PRINT = 0; PROBLM = 0; TOTAL IN FILES = 0; IN SECTORS = 0; TOTAL OUT FILES = 6; OUT SECTORS = 96; USER.ACCT USER.ACCT USER.
SPOOLF listspf;seleq=[formid=formid2] SPOOLID JOBNUM FILEDES #O624 #O625 S327 S327 FORMID2 FORMID2 PRI COPIES DEV 2 2 1 LP 1 LP STATE RSPFN OWNER READY READY INPUT SPOOL FILES ACTIVE = 0; OPEN = 0; READY = 0; OUTPUT SPOOL FILES CREATE = 0; DEFER = 0; DELPND = 0; PRINT = 0; PROBLM = 0; TOTAL IN FILES = 0; IN SECTORS = 0; TOTAL OUT FILES = 2; OUT SECTORS = 32; USER.ACCT USER.
SPOOLF Use This command may be issued from a session, a job, a program, or in Break, . The SPOOLF . . . ;SHOW command is breakable. The actions, however, cannot be stopped by Break. It may be executed by any user. What les the user can access with the command depends on the user's capabilities. If your need is only to list spool les, use the LISTSPF command. SPOOLF O@;SHOW, for example, must retrieve each SPFDIR entry and write it back.
5 Utilities The Spoolfile Interface Facility (SPIFF) The spool le interface facility (SPIFF) allows you to list, manipulate, and transfer spooled device les (spool les) that are created and maintained by MPE/iX. SPIFF is an MPE/iX replacement for the MPE CM SPOOK5 program. SPIFF supports many (but not all) of the commands of the SPOOK5 program. Several existing features have been enhanced, and new features have been added.
PURGE QUIT SHOW STORE TEXT XPLAIN Operation notes Deletes one or more spool les from the system. Terminates SPIFF, returning control to its parent process. Displays information about one or more spool les. Stores one or more les to tape using the MPE/iX STORE subsystem. Accesses an output spool le for use by the ALTER, APPEND, BROWSE, COPY, FIND, LIST, PURGE, and SHOW commands. Displays a summary of SPIFF commands. To run SPIFF, enter this: SPIFF or this: RUN SPIFF.PUB.
File equations and formal file designators. SPIFF opens the formal le designator SPIFFIN as its $STDINX and the formal le designator SPIFFOUT as its $STDLIST. You may redirect these les as desired with a le equation. However the record width of any redirected SPIFFOUT should not be less than 80 bytes; otherwise displays and messages may generate an error when SPIFF directs them to SPIFFOUT. Do not specify a REC= parameter in a le equation for any tape le.
Command line INFO string. You may specify one command in the INFO string (for example, SPIFF;INFO="SHOW @.@"). SPIFF executes the speci ed command before displaying the rst command prompt. One and only one command is allowed in the INFO string. The entire INFO string is parsed. If it contains a syntax error, an error message is displayed and the command is ignored. You may slso specify the le name of a le containing SPIFF commands ( . . .
their raw form. You may set non-conversion as the default by using MODE DOTS = OFF. Entering 4Ctrl54Y5 during a search aborts the search or the display, depending upon which is occurring when you enter 4Ctrl54Y5. Other enhancements Several other commands have been enhanced. For example, COPY and APPEND now support selection equations in determining their working leset. The HELP command operation has been changed to resemble that of the MPE/iX help facility.
Security Console user The SPIFF console user can access any spool le on the system, regardless of capabilities. This is consistent with the spool le access rights of MPE/iX commands. By contrast, a SPOOK5 user at the console gained no additional spool le access rights by using the console. A user having neither SM nor AM capability could access only those les that she or he had created.
ALTER Alters the priority, number of copies, target device, or any combination of these attributes, of one spool le or of many spool les. ALTER Syntax > A[LTER] 8 spool > > < * username > > : 2 seleq 8 2 8 ; option , option 2 2 leid ,spool leid , . . . 92 where foption g is .acctname , . ..
ALTER This alters all spool les created by the user MANAGER.SYS that have priority less than 3. If you choose this (seleq ) form of le set selection, SPIFF inserts an OWNER=!HPUSER.!HPACCOUNT in its internal selection equation, unless you explicitly include your own OWNER de nition. This prevents users with SM, OP, or AM capabilities from accidentally accessing les that they did not create.
ALTER Options may appear in any order. If a particular option appears more than once, the last such option is used. For example, ALTER 15928;p=2,p=3 |the resulting priority is 3. Example Assume that spoolid #O6490 exists and is accessible to you: ALTER 6490;c=3,p=4 SPOOLID JOBNUM FILEDES #O6490 > S35 MYFILE PRI COPIES DEV 4 3 LP STATE RSPFN OWNER READY MYUSER.
APPEND Appends all or part of one or many spool les to a new spool le. The rst spool le processed by the command creates the new spool le. Subsequent spool les are appended to it. APPEND Syntax > AP[PEND] 22 2 2 spool leid ,spool leid , . . . 66* ; 66 3 2 6 4 username .
APPEND If you have no current spool le, the source le speci cation (something other than *) is a required parameter. Parameters spool leid username acctname seleq An existing spoolid to which the user has access. To be taken as a spoolid (instead of a username ), this parameter must begin with a number or with a pound sign (#). The full syntax is [#O]nnnnn , where the n 's represent digits. If the # is used, the O must also be used.
APPEND lename Any line number speci ed that is outside the range of lines in the spool le will be handled as though FIRST or LAST was speci ed, as appropriate. If your range consists of two expressions, the rst expression must evaluate to a number no larger than than the second. The name of the target le, the le being appended to. It must be a spooled le. You may specify lename with or without the backreferencing *, as long as the corresponding le equation already exists.
APPEND Operation Notes The APPEND command (abbreviated AP) appends all or a range of one or more spool les to a new spooled device le ( lename in the syntax above). Spool les may be designated explicitly in a list (#O12345, #O67890), by user and/or account (MYUSER.MYACCT), or by selection equation. If you have a current spool le you may omit the source le speci cation and SPIFF will take its source from the current spool le.
APPEND In general, for a given device or class queue, the order of source spool les is determined rst by output priority, then by the time they rst entered the READY state. To ensure a speci c order in the target le, enter an explicit list of spoolid's. These will be processed in left-to-right order. Entering 4Ctrl54Y5 during command execution stops the execution after the current record is transferred. The current target le remains open for possible use by subsequent APPEND commands.
APPEND APPEND [OWNER=SOMEBODY.ELSE];ALL,*MYLP The specified fileset contains no accessible spoolfiles. (SPERR 82) The user does not have SM or OP capability or is not an AM user in the ELSE account. APPEND 10000;ALL One or more of the specified spoolfile(s) is invalid. (SPERR 44) Spool le #O10000 does not exist or is inaccessible to this user. Assume that MYLP is a terminal for a session and that spool leid 101 was sent to it.
BROWSE Invokes the HPBROWSE utility, if it is available. BROWSE > B[ROWSE] Syntax Semantics Parameters * The spool leid parameter is optional only if you have previously TEXTed in a spool le; otherwise it is a required parameter. spool leid * Operation Notes spool leid An existing spoolid to which the user has access. This speci es the source le to be browsed. To be interpreted as a spoolid, this parameter must begin with a number or with a pound sign (#).
COPY Copies all or part of one or many spool les to a new spool le. COPY 2 33 3 6* ; 6 3 2 4 username .acctname ; 7 7 5 2 Syntax > C[OPY] 2 spool leid ,spool leid , . . .
COPY Parameters spool leid username acctname seleq An existing spoolid to which the user has access. This speci es the source of the data to be copied. To be taken as a spoolid (instead of a username ), this parameter must begin with a number or with a pound sign (#). The full syntax is [#O]nnnnn , where the n 's represent digits. If the # is used, the O must also be used. If the O is used without the #, the parameter is interpreted as a username and will probably cause an error.
COPY lename The name of the target le, the le being copied to. You may specify lename with or without the backreferencing *, as long as the corresponding le equation already exists. If you omit this parameter, SPIFF tries to open the target le using the formal le designator of the rst source spool le. The controlling le equation may have been canceled with a RESET command since the source spool le was created. In this case, the attributes of the source spool le are given to the target spool le.
COPY #O18450, but you then COPY #O18451,#O18452;ALL , the current spool le at the end of the command is #O18452. The target le must be a local spooled device le. An ordinary disc le, a spooled device le on a remote node, or a non-spooled device le (such as a tape drive) is not supported and, if speci ed, results in an error.
COPY COPY #O6490;ALL Creates a new spool le with attributes identical to #O6490. COPY [OWNER=MYUSER.MYACCT];ALL,*MYPP Creates a new spool le targeted to device class PP using environment le MYENV. Spool Files belonging to MYUSER.MYACCT are copies to the target le following the environment information. COPY 101,102,103;ALL,*MYPP This is the same as the previous example, except that an explicit list of spool leid s has been used. COPY [OWNER=SOMEBODY.
DEBUG Invokes the MPE/iX DEBUG facility if the SPIFF user has privileged mode (PM) capability. DEBUG Syntax Operation Notes Caution Additional Discussion 5-22 Utilities > D[EBUG] The DEBUG command (abbreviated D) allows a user with privileged mode capability to enter the MPE/iX DEBUG facility. This is seldom necessary in normal use. The normal checks and limitations that apply to standard MPE/iX users are bypassed in privileged mode.
EXIT Terminates SPIFF, returning control to its parent process. EXIT Syntax Operation Notes > E[XIT] The EXIT command (abbreviated E) terminates the SPIFF process. Any current spool le is closed before SPIFF terminates. Control is returned to SPIFF's parent process. This is usually a command interpreter, but may be another application if that application supports creation of a child process. In particular, SPIFF may be run from within another copy of SPIFF, using the RUN command.
FIND Locates a speci ed pattern in a speci ed range of the current spool le.
FIND + By default, the FIND operation stops at the rst occurrence of the pattern in the speci ed (or defaulted) line range. Speci cation of + causes FIND to locate all occurrences of the pattern in the range. You can use the MODE + = . . . command to enable or disable the + option. With the option enabled, it is not necessary to specify the + as part of the FIND command; however, specifying it is not an error and has no e ect on command operation.
FIND count Operation Notes A numeric value, the number of lines to be searched, including the starting record. The FIND command searches a range of records in the currently TEXTed spool le for a speci ed pattern string, displaying the rst one found. A command option allows displaying all matches found in the range. With no options speci ed, the FIND command searches for and displays the rst case sensitive match of the speci ed string if the match begins in column 1 of the record.
FIND FIND @ \error", */LAST'' Locates the rst occurrence of the pattern whose case, upper or lower, exactly matches that speci ed, this time somewhere between the current record and the last.
HELP Displays information about SPIFF and its commands. HELP 2 FEATURES 6 SUMMARY 6 Syntax > H[ELP] 2 6 6 66 6 6 command 44 3 7 337 7 ALL 7 6 PARMS 777 6 777 4 OPERATION 5 5 5 2 EXAMPLE Parameters none FEATURES SUMMARY command ALL PARMS OPERATION EXAMPLE Operation Notes 5-28 Utilities If you invoke HELP with no parameters, the Help Facility will be interactive until you enter E or EXIT. Refer to the \Operation Notes" section. To enter the MPE/iX help facility, use :HELP.
HELP Interactive access mode If HELP is entered with no parameters, as in HELP it enters the interactive mode, displays a table of contents and double greater-than (>>) prompt, and awaits your input. Entering any topic in the table of contents produces a description of that topic. Entering any command name (except EXIT) produces the syntax for that command and a list of the keywords. Entering a keyword such as PARMS produces a listing of all the items for that keyword (all parameters in this case).
HELP SPIFF HELP vs. MPE/iX HELP Entering H[ELP] puts you in the interactive mode of SPIFF Help. Entering :HELP puts you in the interactive mode of of the MPE/iX help facility. Entering H[ELP] followed by one or more parameters causes SPIFF to search its help le (SPHLP000.PUB.SYS) rst. If it nds an entry for the rst parameter, it displays appropriate text and returns to the SPIFF prompt. If it cannot nd an entry corresponding to the rst parameter, it passes the parameter list to the MPE/iX help facility.
INPUT Inputs one or more spool les from a tape created by SPOOK5 or SPFXFER. INPUT Syntax Parameters > I[NPUT] spool leid username acctname tape le Operation Notes 2 2 spool leid2 ,spool leid3 , . . . username .acctname 33 ; *tape le An existing spoolid to which the user has access. To be taken as a spoolid (instead of a username ), this parameter must begin with a number or with a pound sign (#). The full syntax is [#O]nnnnn , where the n 's represent digits.
INPUT SPFXFER displays a prompt before reading the command from the temporary le. You cannot and need not respond to the prompt. If control does not return to you immediately, either SPFXFER is currently reading in the spool les as requested, or (more likely) SPFXFER is waiting for a console reply|indicating that the desired tape has been mounted, enabling it to access the tape drive speci ed by *tapefile SPFXFER requires a space between the I[NPUT] command and the source le speci cation.
LIST Lists a line range of the currently TEXTed spool le to $STDLIST.
LIST LAST * recnumber o set count Operation Notes The last record in the spool le. The current record in the spool le. An absolute record or line number of text in the spool le. Records are numbered starting with 0. A relative number of records before (-) or after (+) the speci ed record. A numeric value, the number of lines to be listed, including the starting record. The LIST command (abbreviated L) lists a range of records of the current spool le to $STDLIST.
LIST EXAMPLE OF A COMMAND: LIST FIRST/10 0 1 2 :JOB MYJOB,MYUSER.MYACCT. 3 PRIORITY = DS; INPRI = 8; TIME = UNLIMITED SECONDS. 4 JOB NUMBER = #J624. 5 THU, DEC 19, 1991, 10:24 AM. 6 HP3000 RELEASE: B.30.00 USER VERSION: B.30.00 7 MPE XL HP31900 B.08.14 Copyright Hewlett-Packard 1987. 8 All Rights Reserved. 9 STREAMED BY MYUSER.
MODE Controls the width and format of the displayed output of the LIST and FIND commands. MODE Syntax 8 2 2 option ,option , . . .
MODE as many as 75 characters of data per record are displayed. Only the display width is a ected. The FIND command can successfully match a pattern even if the pattern lies partly or entirely beyond that part of the record that is displayed. CONTROLS The + and - are optional. If either is used, there must be no space between it and the number that follows. CONTROLS=OFF (default) disables formatted display of I/O control information. CONTROLS=ON enables formatted display of I/O control information.
MODE Caution Operation Notes Many display devices and communication links respond to escape sequences and other non-printing characters. Similar sequences may occur randomly in binary data. You should not set DOTS=OFF if your communication link may be adversely a ected. You should set your terminal to \Display Functions" before displaying any unknown data. This mode is intended primarily for checking or debugging output data.
MODE Examples Assume that the spool le used in the example for the LIST command is also the currently TEXTed spool le here. Here is the same fragment of display output: LIST FIRST/10 0 1 2 :JOB MYJOB,MYUSER.MYACCT. 3 PRIORITY = DS; INPRI = 8; TIME = UNLIMITED SECONDS. 4 JOB NUMBER = #J624. 5 THU, DEC 19, 1991, 10:24 AM. 6 HP3000 RELEASE: B.30.00 USER VERSION: B.30.00 7 MPE XL HP31900 B.08.14 Copyright Hewlett-Packard 1987. 8 All Rights Reserved. 9 STREAMED BY MYUSER.
MODE MODE WIDTH=-60,CONTROLS=ON LIST 0/10 0 OP P1=$0000 P2=$0000 1 WR P1=$0001 P2=$0000 CC=%061 2 WR P1=$0001 P2=$0000 CC=%000 3 WR P1=$0001 P2=$0000 CC=%000 4 WR P1=$0001 P2=$0000 CC=%000 5 WR P1=$0001 P2=$0000 CC=%000 6 WR P1=$0001 P2=$0000 CC=%000 7 WR P1=$0001 P2=$0000 CC=%000 8 WR P1=$0001 P2=$0000 CC=%000 9 WR P1=$0001 P2=$0000 CC=%000 10 WR P1=$0001 P2=$0000 CC=%000 5-40 Utilities BUF/# BUF/# BUF/# BUF/# BUF/# BUF/# BUF/# BUF/# BUF/# 25= 51= 19= 28= 48= 56= 20= 40= 45= :JOB MYJOB,MYUSE PRIORITY =
OUTPUT Outputs one or more spool les to a tape in SPOOK5/SPFXFER format. OUTPUT Syntax > O[UTPUT] 2 Parameters ;PURGE spool leid username acctname tape le PURGE Operation Notes 3 2 2 spool leid2 ,spool leid3 , . . . username .acctname 33 ; *tape le An existing spoolid to which the user has access. Speci es the source of the data to be output to tape. To be taken as a spoolid (instead of a username ), this parameter must begin with a number or with a pound sign (#).
OUTPUT FILE MYTAPE;DEV=TAPE SPFXFER does not support full wildcarding for either the username or the acctname parameters. The only wildcard permitted for either parameter is @. SPFXFER requires a space between the O[UTPUT] command and the source le speci cation. If you omit the space, as in > O@.@, SPFXFER reports an error. SPFXFER displays a prompt before reading the command from the temporary le. You cannot and need not respond to the prompt.
PURGE Deletes one or more spool les from the system. PURGE Syntax 2 > P URGE Parameters spool leid * username acctname Note 3 8 spool > > < * > > : 2 2 leid ,spool leid , . . . 2 username .acctname seleq 33 3 ASK ; YES 9 > > = > > ; An existing spoolid to which the user has access. This parameter must begin with a number or with a pound sign (#). The full syntax is [#O]nnnnn , where the n 's represent digits. If the # is used, the O must also be used.
PURGE users with SM, OP, or AM capabilities from accidentally accessing les that they did not create. Because les in the CREATE state cannot be deleted, SPIFF inserts a STATE <> CREATE in its internal selection equation even if you explicitly include your own STATE de nition.
PURGE When SPIFF is run non-interactively, it is impossible to conduct a con rmation dialog. Examples of non-interactive operation include running SPIFF in a job or with redirected $STDIN or $STDLIST. In such cases, SPIFF operates as though YES had been speci ed. Operation Notes The PURGE command (abbreviated P) marks one or more spool les for deletion from the system, displaying identifying information (in LISTSPF format) for each marked spool le.
PURGE The following examples assume that you are MGR.ACCT (the manager of an account), and that you have AM capability. > PURGE USER1.ACCT The following spoolfiles have been selected for purging: SPOOLID JOBNUM FILEDES #O452 #O781 #O779 #O782 #O784 J265 J518 J514 J520 J524 $STDLIST $STDLIST $STDLIST $STDLIST $STDLIST PRI COPIES DEV 2 2 2 2 2 1 1 1 1 1 PP PP PP PP PP STATE RSPFN OWNER READY READY READY READY READY USER1.ACCT USER1.ACCT USER1.ACCT USER1.ACCT USER1.
QUIT Terminates SPIFF and returns control to its parent process. QUIT Syntax Operation Notes > Q[UIT] The QUIT command (abbreviated Q) terminates the SPIFF process. If a le has been opened by the TEXT command, it is closed before SPIFF terminates. Control is returned to SPIFF's parent process. This is usually a command interpreter, but may be another application if that application supports creation of a child process.
SHOW Displays information about one or more spool les. SHOW 2 Syntax > S[HOW] 2 none spool leid * username acctname seleq 33 3 7 6* 6 2 2 337 7 6 2 3 @ 7 6 username .acctname 4 4 ;4 I 5 5 5 seleq Parameters 2 spool leid ,spool leid , . . . O Displays all spool les (input and output) belonging to the logon user in the logon account. An existing spoolid to which the user has access.
SHOW If you choose this (seleq ) form of le set selection, SPIFF inserts an OWNER=!HPUSER.!HPACCOUNT in its internal selection equation, unless you explicitly include your own OWNER de nition. This prevents users with SM, OP, or AM capabilities from accidentally accessing les that they did not create.
SHOW Examples SHOW ;O SPOOLID JOBNUM FILEDES PRI COPIES DEV STATE RSPFN OWNER #O7817 #O7820 J166 S104 $STDLIST MYFILE CREATE READY 2 2 1 LP 1 PP INPUT SPOOL FILES ACTIVE = 0; OPEN = 0; READY = 0; OUTPUT SPOOL FILES CREATE = 1; DEFER = 0; DELPND = 0; PRINT = 0; PROBLM = 0; TOTAL IN FILES = 0; IN SECTORS = 0; TOTAL OUT FILES = 2; OUT SECTORS = 2128; MYUSER.MYACCT MYUSER.MYACCT READY SELECTED SPSAVE XFER = = = = 1; 0; 0; 0; OUTFENCE = 6 > SHOW * You have no current TEXT file.
SHOW > SHOW MYUSER.MYACCT;@O SPOOLID JOBNUM FORMID FILEDES JOBNAME PRI COPIES DEV COPSRM SECTS STATE RSPFN OWNER RECS PAGES DATE #O7817 J166 $STDLIST MYJOB 2 1 LP 1 2048 CREATE 0 #O7820 S104 MYFILE 2 1 PP 1 80 READY 234 INPUT SPOOL FILES ACTIVE = 0; OPEN = 0; READY = 0; OUTPUT SPOOL FILES CREATE = 1; DEFER = 0; DELPND = 0; PRINT = 0; PROBLM = 0; TOTAL IN FILES = 0; IN SECTORS = 0; TOTAL OUT FILES = 2; OUT SECTORS = 2128; TIME MYUSER.MYACCT MYUSER.
STORE Stores one or more les to tape using the MPE/iX STORE subsystem. STORE Syntax 8 < spool 2 Parameters 2 2 leid2 ,spool leid3 , . . . > ST[ORE] username .acctname : seleq 2 2 ;store option ;store option ; . . . spool leid username acctname seleq 339 = ; 333 An existing output spoolid to which the user has access. To be taken as a spoolid (instead of a username ), this parameter must begin with a number or with a pound sign (#).
STORE as a tape drive, or be left empty (but with the semicolon to mark its position). Refer to the Storing Files and Backing Up the System Reference Manual (32650-90140) for a full list of available options. Operation Notes SPIFF's STORE command (abbreviated ST) is an interface to the MPE/iX STORE subsystem that allows leset selection by speci c spool leid (s), username.acctname , or seleq . This augments normal MPE/iX STORE leset wildcarding with attributes speci c to spool les.
TEXT Accesses an output spool le for use by the ALTER, APPEND, BROWSE, COPY, FIND, LIST, PURGE, and SHOW commands. TEXT > T[EXT] Parameters spool leid * Operation Notes spool leid * An existing spoolid to which the user has access. This parameter must begin with a number or with a pound sign (#). The full syntax is [#O]nnnnn , where the n 's represent digits. If the # is used, the O must also be used. If the O is used without the #, an error message is displayed.
TEXT The last spool le processed by the APPEND, BROWSE, or COPY command is left open as the current spool le.
XPLAIN Displays a summary of SPIFF commands. XPLAIN Syntax Parameters Operation Notes > X[PLAIN] The X[PLAIN] command has no parameters. The XPLAIN command (abbreviated X) is implemented as the HELP SUMMARY command. This serves two purposes: It retains SPOOK5's XPLAIN command in the form most nearly compatible with that command. It provides a simple interface to that form of help for users who would rather not concern themselves with some of the subtleties of the revised HELP command.
Spool File Transfer Utility (SPFXFER) The spool le tape transfer utility (SPFXFER) transports spool les between MPE/iX systems containing the native mode spooler and MPE systems that do not. The SPFXFER utility is located in the PUB group of the SYS account. This utility can do the following: transfer NMS spool les to tape in a format that SPOOK and SPOOK5 (on MPE V/E releases G.02.
Note The system does not restore user labels because NMS spool les do not have them. For each restored spool le, SPFXFER displays: the old and the new spool le identi cations new job or session number in the format #Jnnnn or #Snnnn (The single quote distinguishes these spool les from those originally created on this system.) the target device or class name the owner A restored spool le has the same output priority as it did before it was stored on tape. The syntax for INPUT is: INPUT 33 2 2 .
To restore spool les #O100 and #O200 from a tape formally designated in a le equation as T, mount the tape, put it online, and enter: FILE T;DEV=TAPE SPFXFER INPUT #O100,#O200 ;*T or FILE T;DEV=TAPE SPFXFER INPUT 100,200 ;*T A message like the following example appears on the console: ?10:41/#559/45/LDEV# FOR "T" ON TAPE (NUM)? If you are the console user, respond with 4CTRL5 A. An \=" sign appears.
The syntax for OUTPUT is: OUTPUT 33 2 2 . accountname username 3 3 2 2 ;*tape spoolid ,spoolid . . . 2 le ;PURGE 3 Parameter definitions username accountname spoolid Note The user name of the creator of the les or @ to designate all users. The account name of the creator of the les or @ to designate all accounts. The spool le identi cation number in the form [#O]nnnn of the spool les. It has a maximum value of 9,999,999.
TAPEFILE mounted on a tape drive whose device class name is TAPE, enter: FILE TAPEFILE; DEV=TAPE SPFXFER INPUT @ ;*TAPEFILE If the system restores les from or stores les to multiple tape reels, the operator must respond to the following prompt: CHANGE REELS ON LDEV nnn? (Y / N) Entering N (for \no") aborts the operation. Entering any other key means \yes," and the operator must mount another tape.
The Print Spool File Utility (PRINTSPF) The print spool le utility (PRINTSPF) displays both the data and the special overhead area of each record of a spool le. The syntax of PRINTSPF is similar to that of the MPE/iX PRINT command. You can use PRINTSPF to print ranges of records (both absolute and relative to the EOF) and to display the record number of each record. Although the primary purpose of PRINTSPF is to display formatted spool le records, you may use it to display other le types as well.
Parameter definitions lename startrec endrec linewidth NUM Output format Actual name of the le to be printed to $STDLIST. The system ignores le equations unless an asterisk (*) precedes the le name, indicating a backreference. If the le name is of the form Innnn or Onnnn , then PRINTSPF searches the current logon directory for the spool le rst. If it does not nd the le there, PRINTSPF then searches IN.HPSPOOL for Innnn or OUT.HPSPOOL for Onnnn .
WRITE WR P1=$xxxx P2=$xxxx [CC=%cc] [BUF/#llll=aaa...a] where xxxx are the hex values for P1 and P2, cc is the octal value of the carriage control, llll is the bu er length in decimal, and aaa...a is the ASCII contents (data) of the bu er. CONTROL CO P1=$xxxx P2=$xxxx where xxxx are hex values for P1 and P2.
Error messages The following are error messages of PRINTSPF: Command syntax error. The le name is too long. No le name was speci ed.
A Spool File Block Format (SBF) All regular MPE disk les have one of three logical record formats: xed length, variable-length, or unde ned length. We usually speak of a le in terms of its record format, for example, \variable-length le". Spool les are variable-length les with additional overhead. Here is a quick review of the essential elements of any MPE variable-length le.
Logical records never span a physical record boundary, so eventually there comes a time when you write a record that does not t in the space remaining in the current physical record. When the le system discovers this situation, it writes a special byte count of -1 (octal 177777), then writes your record at the start of a new physical record. The space between the -1 and the end of the physical record is not used.
Field Description Same as the \byte count" shown in table A-1. The new name distinguishes it from \logical byte count". The original byte count of the data portion of the spool le record (nominally everything between the P2 eld and the physical byte count eld of the next record). It was included originally so that trailing blanks of a record could be left out of the spool le and reinserted at some lower printing level such as the printer driver, if necessary.
PARAMETER FUNC P1 VALUE MEANING 1 1 P1 <> 1 P2 Bitmask Write The first byte of the data portion of the record is a carriage control (CCTL) byte, usually the one specified by a user in his/her FWRITE intrinsic call. It is not part of the user data and should not be displayed on the printer. P1 is itself the CCTL byte. The first byte of the data portion is part of the user data and should be displayed. If the least significant bit (15) is 1, the record is to be printed in prespace mode.
B Spooler Command Comparison The MPE/iX (version B.40.00 and later versions) native mode spooler (NMS) is a complete native mode replacement of the previous MPE XL spooling subsystem. The utility SPOOK no longer exists. Instead, SPOOK commands are replaced with command interpreter (CI) commands, the PRINTSPF and SPIFF utilities, the SPFXFER utility, STORE, RESTORE, and editor subsystems.
NMS spool les are variable-length les that are identi ed by a special le type. Input and output spool les are automatically created in the groups IN.HPSPOOL and OUT.HPSPOOL, respectively. An input spool le is linked to the spooling subsystem until the job has logged o , been aborted, or the DATA le has been read by a user process. An output spool le is linked to the spooling subsystem until the last copy has been printed. Then the spool le is deleted unless it is saved with the command SPOOLF . . .
To change the priority of output spool le O2050 to 9, enter: SPOOLF O2050;ALTER;PRI=9 or SPOOLF O2050;PRI=9 To save spool le O2050 in the HPSPOOL account after the last copy has printed, enter: SPOOLF O2050;ALTER;SPSAVE or SPOOLF O2050;SPSAVE To change to a total number of copies greater than 127, use SPOOLF.
Stopping and Resuming Header and Trailer Output Use the commands HEADOFF and HEADON. They remain the same. Header and trailer information pages are the data pages that appear before and after a printed le, but that are not part of the le's text. To stop header/trailer output to logical device 6, enter: HEADOFF 6 To resume header/trailer output to logical device 6, enter: HEADON 6 Both HEADON and HEADOFF take e ect between copies of a spool le.
Suppose OPENQ @ is in e ect (the default at boot time). Consider the following sequence: OPENQ OPENQ SHUTQ OPENQ SHUTQ OPENQ Controlling the Processing of Output Spool Files 6 11 @ 19 11 @ (Spools data to LDEV 6.) (Spools data to LDEV 11.) (Cannot spool data to any device) (Still cannot spool data to any device) (Still cannot spool data to any device) (Spools data to LDEVs 6 and 19 but not LDEV 11 since LDEV 11's spool queue was shut with the previous command) Use OUTFENCE.
Stopping Spooling Use the NMS command SPOOLER with the parameter STOP or the command STOPSPOOL. By default, these commands also close the spooling queues for the device(s). Both commands stop spooling for all devices in a speci ed device class. To stop spooling for device class LP, which contains three devices 6, 11, and 19, enter: SPOOLER LP;STOP The spooling process is stopped for each of the devices 6, 11, and 19. By default, the spooling queues for the three devices are closed.
The behavior of SUSPENDSPOOL di ers from its functionality in release 2.05 and in earlier releases. This di erence is a result of mapping the command onto the native mode spooler command set. The di erence permits RESUMESPOOL . . . ;BACK nnn and RESUMESPOOL . . . ;FORWARD nnn to function as they did in the 2.05 and earlier releases. A consequence is that SUSPENDSPOOL does not relinquish ownership of a spool le that is printing.
Resuming Spooling Use the NMS command SPOOLER with the parameter RESUME or the command RESUMESPOOL. Both SPOOLER . . . ;RESUME and RESUMESPOOL begin printing where the printer left o , provided that the following conditions are met: You suspended the spooler with either SUSPENDSPOOL (without the ;FINISH option) or SPOOLER ldev ;SUSPEND (without the ;FINISH option but with the ;KEEP option and with no speci ed o set). You did not enter SPOOLER ldev ;RELEASE while the spooler was suspended.
a requested state. If this is true, an asterisk (*) precedes the state of the process on the display. Listing Input and Output Spool Files To display information about one or more spool les, use one of these: the command LISTSPF the commands SHOWIN and SHOWOUT These produce a listing of input and output spool les and their characteristics. The LISTSPF command provides more information than the SHOWIN and SHOWOUT commands and the display for LISTSPF is di erent from the SHOWIN/SHOWOUT display.
Copying Spool Files To copy a spool le, use one of these: the COPY command the FCOPY command You may copy a nonprivate spool le from OUT.HPSPOOL to your account with the COPY or FCOPY commands. The le copied with FCOPY or COPY is not linked to the spooling subsystem. To copy spool le O2050 to an unlinked le called NEWFILE, enter: FCOPY FROM=O2050.OUT.
The EDIT/3000 command SET VARIABLE ensures that the editor treats the le as variable-record. The commands SET LENGTH and SET RIGHT override the default display of 72 characters in EDIT/3000. You may use EDIT/3000|or any editor that edits variable-length les and that does not have restricted le codes|to modify the contents of a spool le, but you cannot save the modi ed text under its current name in the OUT.HPSPOOL group. You may save it under any valid le name in your local le space.
Storing/Restoring Spool Files NMS format You may store and restore spool les in NMS format or in SPOOK5/SPXFER format. To store or restore one or more spool les in NMS format to tape, use this combination: the STORE command. the RESTORE command The STORE and RESTORE commands create and restore spool les only in the NMS format. Such spool les cannot be restored to MPE V/E systems. SPOOK5/SPFXFER To store and restore spool les in a SPOOK5 or SPFXFER format, use the SPXFER utility.
Suppose that your spool les O12, O34, and O56 are stored to tape and suppose that you are USER, the creating user, and are in the group and account GROUP.ACCOUNT at store time. The spool les themselves reside in OUT.HPSPOOL. Now suppose that you want NEWUSER to be the creator of the spool les when you restore them. Enter: RESTORE *T ;@.OUT.HPSPOOL ;CREATOR=NEWUSER The spool les are in OUT.HPSPOOL and NEWUSER.ACCOUNT is the creator of the spool les.
Replacing SPOOK MPE/iX provides three utilities, SPIFF, PRINTSPF, and SPFXFER, for manipulating spool les. Consult Chapter 5 for details on these utilities. Table B-1. SPOOK Replacements SPOOK Command Replaced Use MPE/iX Command or Utility SHOW LISTSPF or SPIFF PURGE PURGE, SPOOLF . . .
C Page Level Recovery and Checkpoints The native mode spooler (NMS) supports Page Level Recovery (PLR) and checkpoints, which provide the ability to restart printing at any page of the document due to device problems (such as power failure, paper jams, running out of paper, ink, toner, etc.) or a suspended spooler. The Page Level Recovery and checkpoint functions recover spooler output in di erent ways. Which method you use is determined by the type of device you are using.
The process is almost the same for a jam recovery or device power failure. After either of these situations occur and has been corrected, appropriate status is reported to the spooler. The spooler then asks the printer for the last page it successfully printed. That page + 1 becomes the new target page, and the spooler then invokes the same recovery mechanism described at the start of this section.
Note Components of successful Page Level Recovery If either the bidirectional interface or required PJL support is missing, and printing is interrupted for any reason (device power failure, operator command, etc.), the entire le must be reprinted when printing is resumed. If the interruption is due to a device exception, a warning message to this e ect is displayed on the system console or the $STDLIST of a user who has Associated the device.
For example, at the end of every copy the spooler sends a special control sequence indicating that the copy has nished. The serial printer PSM uses this to disconnect the printer from either its DTC or its dialup line if no new spool le is started within a certain number of seconds. Since the spooler does not know whether its device is truly a serial printer, it must send this sequence after every copy. Non-serial printer PSMs simply ignore it (by reporting successful completion).
The printer's second contribution is the ability to silent run . This allows (re)printing to start at some page other than the beginning of the output without printing all the pages that preceded it. Here is a list of the printers that support PLR: Color LaserJet LaserJet 4 family (except 4L) HP 5000/C30 and C40 HP 2680 HP 2688 HP-IB CIPER A checkpoint is a snapshot of the state of a printer at a particular point in the data stream.
Checkpoint files Although only CIPER protocol devices return checkpoints, the spooler always creates a checkpoint le. This is primarily for device independent operation. The checkpoint le always has a dummy \checkpoint 0" entry. When silent running is invoked, the spooler rst looks for the closest checkpoint preceding the target page as a starting point for silent running. The checkpoint 0 entry assures that such a checkpoint always exists.
spool le nor the checkpoint le when it nished storing them. This problem has been corrected in MPE/iX Release C.50.00. Any user with SM capability can purge any checkpoint le which is not being accessed. Even if the corresponding spool le still exists, no harm is done. If the le is selected for printing, the spooler generates a new checkpoint le. If the le is deleted without being printed, the system does not care if no checkpoint le exists.
On MPE V/E, the catalog of checkpoints was in the spool le's user labels. The number of user labels available, and the size of the checkpoint structure limited the number of checkpoints to 32. These were managed in a circular fashion, with the 33rd checkpoint replacing the rst, and so on. The spooler stored every eighth checkpoint (remember, the printer generates one at the top of each page), allowing a range of 256 pages.
Checkpoints versus silent running Note the di erence between checkpoints and silent running. The HP 2680, HP 5000, color LaserJet, LaserJet 4 family, and all CIPER printers (HP-IB versions of HP 256x printers) all support silent running. Only the CIPER printers support checkpoints. Checkpoints make it possible to minimize the time a printer spends silent running. Serially-connected printers do not have hardware support of silent running.
Non-recoverable checkpoints Even with a CIPER printer, a checkpoint is only valid when it represents the full state of the printer as of a given page. Such a checkpoint is a recoverable checkpoint , but \recoverable" is usually omitted from the description. If the state of the printer cannot be fully represented in the space available in the checkpoint structure, the checkpoint is called a nonrecoverable checkpoint , meaning it cannot be used in a recovery situation.
Checkpoints defined by printer's physical top-of-form As mentioned earlier, CIPER printers generate a checkpoint at the top of each page. But there are two kinds of pages. The physical page length is settable only on the printer's front panel (that is, it cannot be set programmatically, and so is unavailable even to the spooler). Logical page lengths can be set through the proper PCL command sequence, but are usually set by the VFC de nition in the CIPER ENV le speci cation.
D Migration Information and Limitations The native mode spooler (NMS), MPE/iX version B.40.00 and later versions, is a complete replacement of spooling subsystems on previous MPE V/E and MPE XL systems. With MPE/iX version B.40.00 and beyond, SPOOK and SPOOK5 (MPE V/E) functions are replaced by the SPIFF utility. The SPOOK utility is still supported for all MPE V/E releases and for all MPE XL releases that contain it. With MPE/iX version B.40.
Note If you use COPY or FCOPY to copy a spool le from the HPSPOOL account, the copy le is an unlinked spool le. The COPY command of the SPIFF utility copies a linked spool le to a new linked spool le. A separate spooler process manages each spooled device. A logical device number or a device name, which is an alphanumeric string of up to eight characters, de nes a device. In addition, a device class de nes a related set of devices.
The following operator commands that relate to spooling are then available to you once you are associated to a device or if you are at the console: SPOOLER dev ;START ;STOP ;SUSPEND ;RESUME ;OPENQ ;SHUTQ ALTSPOOLFILE DELETESPOOLFILE FORMSALIGN HEADOFF HEADON OPENQ OUTFENCE RESUMESPOOL SHUTQ STARTSPOOL STOPSPOOL SUSPENDSPOOL dev is either a logical device number, a device class, or a device name.
The system startup le (SYSSTART.PUB.SYS) may contain commands to enable spooling and to start spooling processes. What follows is an example of a system startup le. STARTUP ALLOW @@.@@;COMMANDS=LOG comment System Startup File OUTFENCE 14 spooler 6;openq spooler 19;openq spooler 18;start streams 10 headoff 18 limit 5,30 outfence 6 jobfence 7 Welcome SYSMSG.MESSAGE VMOUNT ON,AUTO Comment End of systart file. The system manager oversees any changes to the system startup le.
Method 1: Con gure at least two devices in a particular device class. Suppose that LDEV 6 and nonexistent LDEV 19 are con gured for device class LP. Make sure that the queue for LDEV 19 is open. One way to do this is to enter an OPENQ 19 command in your SYSSTART le. If LDEV 6 is usually spooled, you can also enter the STARTSPOOL 6 command or SPOOLER 6;START command in your SYSSTART le. Make sure that your applications generating spooled output direct that output to class LP.
di erent ways some of the commands operated on a logical device and the device class to which the logical device belonged. Simpli cation. Previously, managing separate queues for logical devices and their device classes was messy. You could never be sure when you would get a spool le or a hot device.
Spool File recovery Since spool les are permanent disk les, recovery is no more complicated than it is for other disk les. When the system executes the INSTALL command, all les, including spool les, are purged. The system preserves all output spool les for all other startups, including UPDATE. The system only recovers input spool les for every START with the RECOVERY option. There is a job master table (JMAT) entry for each job input spool le. The JMAT is only recovered during a START RECOVERY.
Table D-2. Output Spool File States LISTSPF SHOWOUT READY READY or LOCKED CREATE OPEN DEFER READY, D DELPND (underlying states are READY or ACTIVE) SPSAVE READY, D PROBLM READY, D PRINT ACTIVE XFER ACTIVE or LOCKED The LISTSPF command, described in chapter 4, contains information about the states. DEFER state DEFER is a state of an output spool le, not just the condition of a spool le at priority 0 as in the past.
The DFID and the SPOOLID Before version A.40.00 of MPE XL, the spooler kept track of individual spool les by assigning a unique device le identi er (DFID) number to each le. The MPE/iX (and MPE XL) NMS assigns a unique spool le identi cation number (SPOOLID) to each spool le. SPOOLIDs are similar to DFID, but are not the same. The IDD and ODD (CM tables) management routines assign DFIDs to unspooled input and output device les such as terminals, tape drives, and unspooled printers.
SPOOK Limitations The SPOOK utility does not exist on MPE/iX version A.40.00 and later versions. Command interpreter (CI) commands, the PRINTSPF utility, the SPFXFER and SPIFF utilities, STORE, RESTORE, editor subsystems, and the FCOPY subsystem, replace SPOOK commands. Refer to Appendix B and chapter 2.
and print \hot" to the printer while spool les were being created for the device classes associated with that LDEV. This is no longer possible since device classes are collections of logical devices. There are two workarounds. If the device that you want to operate unspooled is part of a class that contains at least one other device that can remain spooled, there is no problem. The following examples assume that this other device does not presently exist.
Recovery limitations Device recovery The NMS uses all available device features to aid in device recovery, either automatically (following a device power failure) or manually triggered by an operator. The CIPER devices support page checkpoints. The spooler uses the checkpoints to recover quickly to a speci c page. Refer to appendix D for detailed information on checkpoints.
Space limitations Since spool les are permanent disk les, their size limit is 4 gigabytes. This is currently the le size limit of any MPE/iX disk le. You may want to limit the linked spool le space on the HPSPOOL account and on its groups IN and OUT by using the ALTACCT and ALTGROUP commands, respectively. If you do this and encounter a directory le space limit on HPSPOOL or its IN or OUT groups at the time of the creation of a linked spool le, all spooling queues are globally disabled.
Editor limitations You can browse output spool les using any editor that supports variable-length record les. EDIT/3000 is one editor that you can use. To use EDIT/3000 to browse a spool le, you must use the command SET VARIABLE before copying the spool le into your work space. Suppose you want to browse spool le O2050.OUT.HPSPOOL. Enter: editor set variable set length=NN set right=NN t o2050.out.hpspool NN is the record length of the longest record in the le.
Note If the system cannot gain exclusive access to the le (for example, if a spooler is printing the le), PURGE fails. The system deletes unlinked spool les in the same manner as it deletes any permanent disk les. Renaming a spool You may not rename spool les linked to the spooler queues.
Glossary banners batch job checkpoint checkpoint le CIPER CM spooler The generic term for either the header or trailer of a printout. It contains identi cation information for the listing. A batch job is the noninteractive execution of a series of MPE/iX commands and/or user programs. The commands and programs are preceded by a valid JOB command and followed by the EOJ command. Batch jobs are submitted to the system with a spooled input device or the STREAM command.
conditional top-of-page data le FLABX linked spool le MOM operator private spool le selection equation Glossary-2 The motion of the logical pen or physical paper such that the next output begins at the top of the next logical page, on the same physical sheet, or on a new physical sheet (depending on use).
silent run SPFDIR SPIT spool spooler A method of recovery to a particular page following an interruption of the printing process. The interruption can be expected, as in SPOOLER . . . ;SUSPEND , or unexpected, as in a device power failure. Silent run requires hardware support in the device or software support in the device's storage manager. When in silent run mode, the device or storage manager interprets, but does not print, all data sent to it.
spool le SPOOLID storage manager stream system manager type manager Glossary-4 The term spool le refers to a le originating from or directed to a nondisk spooled device. When a nonshareable device is spooled, any user program attempting to access the device is actually accessing an opened input spool le or a created output spool le instead of the device itself.
Index 3 A B 3000devs account, 4-10 ABORTJOB, 1-5 access control de nitions (ACD), 4-43, 4-46 account management, 2-32 accounts 3000devs, 4-10 HPSPOOL, 1-5, 2-34 reserved, 2-32 ACD access control de nition, 4-43, 4-46 activating spooler process, 2-2 ACTIVE state, 4-30 adding a network printer, 3-3 aligning forms, 4-8 ALTER SPIFF command, 5-6 altering number of copies, 4-65 spool le characteristics, 4-61 spool les, 1-12, 2-19, B-2 ALTSPOOLFILE command, B-2 AND logical operators, 2-14, 4-63 selection equat
building spool les, 1-10 building spool les, 1-10 bytestream ASCII text les, 3-38 C Index-2 changing le identities, 4-42 number of copies, 2-20 output devices, 2-20 output priority, 2-20 priority, 2-20 changing network printer con guration, 3-15 checkpoint, C-5 les, 1-6, B-2, C-5 naming convention, C-7 non-recoverable, C-9 checkpoint les purging, 2-33 CIPER protocol printers, D-10 classes devices, 2-7, D-10{11 CLASSES.
RESUMESPOOL, 2-5, B-8 SHOWDEV, 4-43{46, B-8 SHOWIN, B-9, D-7 SHOWOUT, B-9, D-7 SHUTQ, 2-8, 4-47, B-4 SPOOL, B-2, B-3 SPOOLER, 1-2, 2-1, 2-2, 2-3, 2-4, 2-5, 2-7, 4-48{60, D-3 SPOOLER'', 2-4 SPOOLER, , 2-6 SPOOLF, 1-2, 1-13, 2-9, 2-22, 2-23, 4-61{75, B-2, B-3 SPOOLF'', 2-23 STARTSPOOL, B-5 STOPSPOOL, B-6 STORE, 2-25, B-12 STREAM, 1-9 SUSPENDSPOOL, 2-3, B-6 commands native mode spooler (NMS), B-1{14 RESUMESPOOL, 2-5 spooling-related, D-3 compatibility NM and CM, 2-2 compatibility mode (CM) spooler, B-1{14 con
spool les, 1-8 D Index-4 data intray, 3-13 data timeout, 3-12 DEBUG SPIFF command, 5-22 default page size, 3-15 deferring, spool les, 2-21 DEFER state, 4-31, D-8 DELETESPOOLFILE command, B-3 deleting les, 4-41 limitations, D-14{15 selected spool les, 2-24 spool les, 1-13, 2-19, 2-24, B-3 DELPND state, 4-31 device classes opening spooling queues, 4-38 device les identi ers, D-9 device names groups, 2-34 devices changing output, 2-20 class, 2-7 classes, D-10{11 con guring, 1-2, D-2 controlling, D-2 input/ou
statistical summary, 2-17 status, B-8 status of input/output devices, 4-43 E F EDIT/3000 limitations, D-14 program, 1-13, B-10, D-14 viewing spool les, 1-13 editing NPCONFIG, 3-15 EDITOR command, 1-13 enabling spooling, B-4 end-of- le SPIFF and, 5-3 error messages, PRINTSPF utility, 5-65 errors handling, D-9 example large network con guration, 3-30 small network con guration, 3-26 excluding by selection equations, 2-15 EXIT SPIFF command, 5-23 EXIT command SPFXFER utility, 5-61 FCOPY command, 1-7, 1-12, 1
FOPEN intrinsic, 1-7 formal le designator SPIFFIN, 5-3 formats native mode spooler, B-12 spool le block, A-1, A-2 FORMIDS and forms messages, 2-11 forms aligning, 4-8 forms message dialog, 3-36 messages, 2-11 special, 3-36 specifying, 2-10 FORMSALIGN command, 2-10, 4-8{14 G H I Index-6 getting help SPFXFER, 5-57 group CLASSES.3000devs, 4-10 DEVICES.3000devs, 4-10 IN.HPSPOOL, 1-12, 2-13, 2-34, B-1 OUT.
input devices displaying status of, 4-43 status, B-8 input spool les, 1-5, 2-1 viewing with PRINTSPF, 1-15 installing, D-7, D-12 NMS, 1-1 intrinsic FOPEN, 1-7 introducing the spooler, 1-1 J K L jam recovery, 3-14 JMAT (job master table), 1-5, D-12 JOB command, 1-11, 4-15 job master table (JMAT), 1-5, D-12 job numbers, 4-15 jobs, nsac.
opening spooling queues, 4-38 logical operators AND, 2-14, 4-63 NOT, 2-15 OR, 2-14, 4-63 precedence, 4-63 M N Index-8 managing, HPSPOOL account, 2-32 marking point to resume, 2-4 message interval, 3-12 messages forms, 2-11 migrating CM to NM, D-4{9 mnemonics le codes, 1-10 MODE SPIFF command, 5-36 MPE record-oriented le, 3-38 multiple operations, 2-21 native mode transferring from, 2-28 transferring to, 2-27 Native Mode Spooler overview, 1-1 native mode spooler (NMS), 1-1, B-1{14 commands, B-1{14 directo
banner trailer, 3-14 data intray, 3-13 data timeout, 3-12 default page size, 3-15 jam recovery, 3-14 message interval, 3-12 network address, 3-9, 3-10, 3-11, 3-12, 3-13, 3-14, 3-15 pjl supported, 3-14 poll interval, 3-10 poll interval max, 3-10 program le, 3-9 run priority, 3-11 security matrix, 3-16 setup le, 3-10 setup le hierarchy, 3-19 setup strings, 3-19 SNMP get community name, 3-11 snmp max retries, 3-12 snmp timeout, 3-12 socket trace, 3-15 syntax, 3-7 TCP port number, 3-9 transport trace, 3-15 NPCO
PRINTSPF utility, 5-63 output, limitations, D-10 output priority changing, 2-20 spool les, 4-40 output spool les, 2-29 viewing, 1-13 viewing with PRINTSPF, 1-15 OUTSPOOL.PUB.SYS, 3-34 OUTSPTJ.PUB.
;SPSAVE, (SPOOLF), 2-21, B-2 ;START, (SPOOLER), 2-2, B-5, D-3 ;STOP, (SPOOLER), 2-2, B-6 ;SUSPEND, (SPOOLER), 2-3, B-6 ;UNDEFER, (SPOOLF), 2-21 pjl supported, 3-14 plotters serially connected, D-10 PLR, C-1 poll interval, 3-10 poll interval max, 3-10 PRINT command, 1-10, 1-14, B-10 printer output z-fold paper, 3-37 printers CIPER protocol, D-10 con guring, 4-8 controlling access, 2-8 hot, 2-11 laser page, D-10 network supported, 3-2 serially connected, D-10 print headers turning o , 2-9 turning on, 2-9 turn
PURGEGROUP command, 2-34 purging checkpoint les, 2-33 purging spool les, 2-33 Q R S Index-12 queue priority, 4-15 QUIT SPIFF command, 5-47 READY state, 4-30 records blocks, A-1, A-2 spool les, 5-63 recovering checkpoint, D-6 devices, D-6, D-12 limitations, D-12 spool les, D-7, D-12 redirecting SPIFF output, 5-3 relational operators, selection equations, 2-16 releasing spool les, 2-6 RENAME command, 4-42, B-11 renaming spool les, B-11, D-15 replacing SPOOK, B-14 reserved accounts, 2-32 groups, 2-32 users
serially connected printers, D-10 setting outfence, 2-8 setup le, 3-10 security matrix, 3-16 setup les, 3-18 setup le hierarchy, 3-19 setup strings, 3-19 SFB (spool le block format), A-1 SHOW SPIFF command, 5-48 SHOWDEV command, 4-43{46, B-8 SHOWIN command, B-9, D-7 SHOWOUT command, B-9, D-7 SHUTQ command, 4-47, B-4 silent run, D-12 size, spool les, D-13 SNMP get community name, 3-11 snmp max retries, 3-12 snmp timeout, 3-12 socket trace, 3-15 software requirements, 1-1 space limitations, D-13 spool les, D-
console user, 5-6 end-of- le, 5-3 le equations and, 5-3 INFO string, 5-4 other users, 5-6 output display, 5-4 redirecting output, 5-3 SPIFF and SPOOK5 di erences, 5-2 SPIFF utility, D-1, D-6, D-9 SPOOK5 and SPIFF di erences, 5-2 SPOOK utility, B-1, B-2, B-3, B-10, B-12, B-13, B-14, D-1, D-6 job streams containing, D-6 limitations, D-10 replacing, B-14 SPOOL command, B-3 spooler controlling processes, 2-1 overview, 1-1 SPOOLER command, 1-2, 2-1, 2-2, 2-3, 2-4, 2-5, 2-6, 2-7, 4-48{60 spooler functions, 1-1 sp
deleting, 1-13, 2-19, 2-24, B-3 deleting limitations, D-14{15 directory (SPFDIR), B-2 dispaying by exclusion with NOT, 2-15 dispaying, selected with AND or OR, 2-14 dispaying statistical summary, 2-17 dispaying subset with LISTSPF, 2-14 dispaying with LISTFILE, 2-18 dispaying with LISTSPF, 2-12, 2-17 dispaying with selection equations, 2-16 dispaying with wildcard speci cation, 2-17 displaying, 4-24, 4-29, 4-75, B-9 displaying with wildcard speci cation, 2-13 indirect le, 2-19 input, 1-5, 2-1 limiting space
commands related to, 4-1{75, B-1, D-3 disabling, B-4 enabling, B-4 initiating, B-5, D-3 initiating with system startups, D-3 resuming, B-8 starting, 2-2, B-5, D-3 starting with system startups, D-3 stopping, 2-2, B-6 suspending, 2-3, B-6 spooling queues closing, 2-8, 4-47 opening, 2-7, 4-38 SPOOLMOM.PUB.
pre-con guring network printers, 3-5 system startup spool le recovery, 2-30 system startup le, D-3 T U V TCP port number, 3-9 TEXT SPIFF command, 5-54 text editor, 1-13 text speci cations, 3-38 bytestream ASCII, 3-38 MPE record-oriented, 3-38 trailers resuming, B-4 transferring spool les, 2-25, 2-27 transferring from native mode , 2-28 transferring to native mode , 2-27 transporting spool les, 2-25, 2-27, 2-28, B-13, D-6 transport trace, 3-15 turning o print headers, 2-9 turning on print headers, 2-9 typ
W X Z Index-18 wildcards printing, and, 2-23 printing spool les, and, 2-22 selection equations, 2-17 SPOOLID, 2-13, 2-19 XFER state, D-8 XPLAIN SPIFF command, 5-56 z-fold paper, 3-37
