nbspool for MPE Reference Guide 610 Newport Center Drive, Suite 1400, Newport Beach, CA 92660
This manual contains proprietary information which is protected by copyright. The information in this manual is subject to change without notice and does not represent a commitment on the part of Quest Software. The software described in this manual is furnished under a license or nondisclosure agreement. This software may be used or copied only in accordance with the terms of this agreement.
T A B L E O F C O N T E N T S NBSpool for MPE Reference Guide Introduction - Welcome to NBSpool ........................................................................................................................... i NBSpool Features .................................................................................................................................... ii About This Reference Guide ..........................................................................................................
NBSpool Reference Guide Chapter 3 - NBSpool Output Commands .............................................................................................................. 3-1 Command Summary ..............................................................................................................................3-2 Output Commands.................................................................................................................................3-5 ALTER.....................................
Table of Contents Chapter 4 - NBSpool Input Commands..................................................................................................................4-1 Command Summary ............................................................................................................................. 4-2 Input Commands .................................................................................................................................. 4-4 ALTER .......................................
NBSpool Reference Guide Define Banners Screen.....................................................................................................................6-20 Report Maintenance Screen..............................................................................................................6-23 Name Maintenance Screen...............................................................................................................6-26 Define Distribution Lists Screen..................................
I N T R O D U C T I O N Welcome to NBSpool NBSpool streamlines and automates the management of spool files generated by all applications, seamlessly distributing the printing function across networks and printer devices. Originally written to provide a method of moving spool files across a network, NBSpool quickly grew into a powerful, easy-to-use facility for performing a large variety of functions on spool files.
Introduction NBSpool Features This section provides information on NBSpool features. These features have been designed to allow you to easily and quickly interact with spool files. These features include: • A flexible method of selecting subsets of spool files to alter, move, store, purge etc.
Welcome to NBSpool • A SORT command which allows sorts by any or all of the following spool file attributes: Spool file name Device number/class User name Creation date and time Job/session number Output priority Spool file size • A ONCE=Y subset which instructs NBSpool to BANNER, ARCHIVE or VSAVE a file only once. The ONCE=Y subset causes NBSpool to operate on a spool file only once for any particular command.
Introduction iv • A STORE and RESTORE capability for off-line storage. These commands are faster than SPOOK, and they use less tape. Also, multiple STOREs can be appended to the same tape. • A tape directory function so you can see what is on a tape, including SPOOK tapes. • An ARCHIVE and UNARCHIVE command to store and optionally compress a set of spool files to disk. Also, an ARCDIR command to see what is in an archived file.
Welcome to NBSpool About This Reference Guide Each chapter in this guide is designed to quickly teach you the fundamentals of working with NBSpool. The following is a summary of the chapters in this guide. Chapter 1 provides instructions for installation, configuration and network printing. Chapter 2 discusses administrative commands, UDCs, security, subset parameters, variable substitution and command redirection. Chapter 3 lists all output commands with syntax, parameters and examples.
C H A P T E R 1 Installation and Configuration This chapter provides information and instructions on installing NBSpool. NBSpool can be installed as a stand alone application or with NetBase. This chapter also provides information on installing and configuring NBSpool for networked printers. The instructions for installing NBSpool vary depending on whether you are running NBSpool by itself, or if you are running NBSpool with NetBase.
Chapter 1 NBSpool Stand-Alone Installation This section provides information and instructions on installing NBSpool by itself. Follow the instructions in this section if you are installing or updating NBSpool. Note. If this is an upgrade, be sure that no one is accessing NBSpool or VISTA Plus before you perform the upgrade. You must also stop all NBSpool background processes before performing the upgrade. 1. Logon as MANAGER.SYS. :HELLO MANAGER.SYS 2. Restore the install job. :RESTORE;NBINSTAL.JOB.
Installation and Configuration 6. Stream the install job. Note. If you have a lockword on QUERY.PUB.SYS, remove it prior to streaming NBINSTAL. :STREAM NBINSTAL 7. Put the tape back online and reply to the request when it comes up on the console. 8. Change the passwords on the NETBASE account if desired. 9. Installation is complete. You may now use NBSPOOL.PUB.NETBASE.
Chapter 1 NBSpool Installation With NetBase This section provides information and instructions on installing or upgrading your copy of NBSpool without upgrading your version of NetBase. Note. If you are installing on an MPE 5.0 system, skip to Step 2. To install NBSpool with NetBase: 1. Verify that you have a version of NetBase which will allow an update to NBSpool without an update to NetBase: :RUN NBSPOOL.PUB.NETBASE NetBase Spooling Utility [x.x] :LISTF QUESTXL.PUB.
Installation and Configuration If spooling is active, issue an ABORT SPOOLING command, or wait until spooling stops. :RUN NBCTRL.PUB.NETBASE *> ABORT SPOOLING *> EXIT 5. Exit all users from NBSpool and VISTA Plus. Once all users are out, stop all NBSpool and VISTA Plus background jobs. 6. Insert the NBSpool tape, restore the install job, and reply to any tape requests. :HELLO MANAGER.SYS :RESTORE;NBINSTAL.JOB.@;LOCAL 7. Add the passwords for MANAGER.
Chapter 1 12. You may now resume spooling. :RUN NBCTRL.PUB.NETBASE *> START SPOOLING *> EXIT 13. Installation is complete. You may now use NBSPOOL.PUB.NETBASE.
Installation and Configuration Network Printing This section provides information and instructions on configuring HP LAN printers to work with JetDirect cards. The following procedures are covered in this section: • Enabling Ethernet • Adding the LAN Printer to the HP 3000 • Sending a Test Print Job Enabling Ethernet This section provides instructions on enabling Ethernet. You must enable Ethernet to print to LAN printers.. 1. Run the NMMGR program. The NMMGR program screen #1 will be displayed.
Chapter 1 3. Press the Shift+Tab keys to move your cursor to the command line. Type the text shown below and then press Enter. The Return key does not work. @netxport.ni 1-8 4. Press F6, Modify to pass through the current screen and to the one displayed below: 5. Enable the Ethernet by entering Y in the Enable Ethernet field. Press F6, Save Data.
Installation and Configuration 6. Press Shift+Tab. Type EXIT in uppercase and then Enter to exit the program. Adding the LAN Printer to the HP 3000 This section provides instructions on adding the LAN Printer to the HP 3000 network directory. You should be logged on as MANAGER.SYS before starting this procedure. 1. Run the NMMGR program. The NMMGR program screen #1 will be displayed. :NMMGR 2. Press F2, Open Directory. A new screen will be displayed.
Chapter 1 1-10 3. Press F1, Update Directory. The screen shown below is displayed. In the Node name field, enter the new printer’s name, including the domain and organization, for example, LJ4B.QUESTS.COM. 4. Press F5, Add. A screen similar to the one shown below will be displayed. Set the transport services as follows: • TCP should be set to Y. • Checksum for TCP should be set to Y. • PXP should be set to N. 5. Set the IP Address field to the IP address of the printer. 6.
Installation and Configuration 8. To save the information, press F6, Save Data. Press Shift+Tab and type Exit in the Command field. Press Enter. Sending a Test Print Job Follow the instructions in this section to send a test print job to the network printer you just configured on the HP 3000. 1. Log on as MANAGER.SYS: :HELLO MANAGER.SYS 2. Start NBSpool: :run nbspool.pub.
Chapter 1 3. Copy a spool file to the newly defined printer. In the example shown below, the TEST file is being copied to the LJ4B printer. COPY TEST TO LJ4B;PTYPE=LJ Spool File Qualifies SFID FILENAME JOB USER NAME SECTORS STATUS ----------------------------------------------------------#O32008 TEST #S’2113 MGR.NETBASE 16 Sent 4. Exit NBSpool.
Installation and Configuration Troubleshooting Network Printing This section provides steps for troubleshooting network printing. The steps include information on printing to printers that support their own IP address, verifying that a node name is properly resolved to the IP address, and adjusting the NMMGR settings for the printer. To check your network printing, take the following steps. To check network printing: 1.
Chapter 1 6. Some other settings in NMMGR may benefit from adjustment. NBSpool customers frequently increase the Retransmission Lower Bound to 8, as well as Initial Retransmission Interval and Max Retransmissions per Packet. Note. If you change a configuration setting in NMMGR, you may need to stop and restart the network for the change to take effect. 7. If you changed the NMMGR entry for the printer, you will need to clear the cache for it so that the new information is accessed.
C H A P T E R 2 Running NBSpool This chapter provides information on running NBSpool. NBSpool is a command driven program. When you run NBSpool, it gives you a O> prompt and waits for a command from you. Your commands instruct NBSpool to display, modify, and delete spool files. NBSpool enables you to save spool files in an organized manner, to print sections or all of a spool file and to merge spool files. If NBSpool is run from a job, it behaves somewhat differently.
Chapter 2 Administrative Commands Most NBSpool commands are performed on spool files. However, some NBSpool commands change the mode of operation, provide information, or allow access to MPE commands. These commands are described in this section. HELP The HELP command displays a list of commands that are valid in the current mode. The syntax of this command is just like MPE’s help command. If the HELP command is followed by a valid command, NBSpool displays the command syntax and a brief description.
Running NBSpool LISTREDO and REDO The LISTREDO and REDO commands allow you to quickly repeat previously entered commands. The REDO command allows the last command entered to be modified and re-executed. To repeat the previously typed command simply type REDO at the NBSpool prompt, modify the line using standard EDITOR commands, and enter a carriage return to execute the command. The REDO command can also be used with the LISTREDO command. The LISTREDO command displays a list of previously entered commands.
Chapter 2 UDC Commands To facilitate the creation of user defined commands (UDCs), a list of commands to be executed may be passed to NBSpool via the ;INFO= parameter of the :RUN command. Multiple commands may be separated by backslash (\) characters. After the commands are executed, the user will be left in the program unless the last command is EXIT or QUIT. The following is a sample UDC that allows texting of spool files: TS SPOOLID=”$” RUN NBSPOOL.PUB.
Running NBSpool UDC Commands User security is implemented in a manner similar to SPOOK. The user running NBSpool can access spool files based on their capability.
Chapter 2 Subset Parameters The subset parameter is common to almost all of the NBSpool output commands. It is very flexible and uses a wide range of values to define groups of spool files. Specifying a subset of spool files can be accomplished using a variety of subset designators. Full use of the MPE wild card characters ( ?, #, @) are allowed. Numeric values may be specified individually or as a range. Ranges are from low to high and are inclusive.
Running NBSpool The !PREV subset generally contains original spool files, not those which are the product of a command. For example, if a MOVE command follows a DUP command, the !PREV subset will move the original spool files, not the duplicated ones. Spool file subsets operate on READY spool files unless otherwise specified or as defined in the individual command descriptions. Spool file states are checked at the beginning of command execution.
Chapter 2 2-8 Subset Spool File Selection [mm/dd/yy][-[mm/dd/yy]] This designator selects all files created during the specified date range. [date time][-[date time]] This designator selects all files created during the specified date and time range. Format for date time is mm/dd/yy hh:mm. =TODAY[-days] This designator selects files created on the specified date. If -days is omitted, the date is today’s date.
Running NBSpool Textual Subset Designators These subset designators mostly duplicate the designators listed in the previous section. These designators are provided just in case you do not understand the designators listed in the previous section. Some of the subsets must be specified using the designators listed below. Subset Spool File Selection ABORTED={TRUE|FALSE} This designator selects (or not) $STDLISTs of aborted jobs.
Chapter 2 Subset Spool File Selection ONCE=Y This designator specifies that each qualifying spool file will only be selected once for this command. Upon successful completion of a command, the spool file will not qualify again if ONCE=Y is subsequently specified. The following commands can use this subset: ALTER ARCHIVE BANNER COPY DUP MERGE PRINT STORE SUBMIT VSAVE Although the syntax ONCE=N is valid, it will be ignored if it is specified. WARNING! You must change SYSSTART.PUB.
Running NBSpool Subset Spool File Selection STATE=state Selects spool files by state. Some of the states apply only to the native mode spooler. The valid states are shown below. The upper-case characters shown below are the minimum necessary to designate a particular state. Active Create DEFer DELpnd Locked Opened Print PROblem Ready SPSave TRansfer RDefer RNondefer The RDEFER and RNONDEFER states mean READY state, deferred (or not) because a spool file is below or above the OUTFENCE.
Chapter 2 Special Subset Designators Subset Spool File Selection ~designator This designator specifies that if a spool file matches the criteria specified by designator, it will not be selected. Designator is any of the above selection parameters specified in the previous sections. ! This designator uses the subset specified in the last SHOW command. Each SHOW command saves the subset for later use in other commands. May not be used with the tilde (~) or any other designator.
Running NBSpool Subset Value Spool Files Selected ?@ This selects all spool files except $STDLISTs. @.DEV This selects spool files created by any user in the DEV account. BOB.OPERATOR.SYS This selects all spool files created by the user who logged on as BOB,OPERATOR.SYS. INV@,MGR.@ This selects any file with a name starting with INV that was created by MGR users in any account. %8-13,7/4/88,@.
Chapter 2 Variable Substitution NBSpool will substitute JCWs and MPE/iX variables into a command string. To insert a value of a variable into a command, preface the JCW or variable name with an exclamation point. For example, to insert the value or variable of the JCW PRI into an ALTER command, enter: O> ALTER $,MGR.SPOOL;P=!PRI If a variable name is specified but not found, no substitution will be made. Furthermore, using two exclamation points will prevent the insertion of a value.
Running NBSpool Variables Set by NBSpool The following variables, which are actually JCW’s, are set by NBSpool during normal operation. Variable Description NBQUALIFIED Count of spool files that qualified on the last command. This is not a count of spool files that were successfully processed. NBSTRINGFOUND If a LIST command with a string is executed, this JCW is created. It is set to 1 if the string was found, otherwise it is set to 0.
Chapter 2 Variable Description CURRDEV This variable is used to specify the device class/ldev of current spool file. CURRENV This variable is used to specify the environment file name of current spool file. CURRJNUM This variable is used to specify the job/session number of the current spool file’s creator (without a leading # character). CURRJOB This variable is used to specify the job/session name of the current spool file’s creator.
Running NBSpool LOOKUP Variables NBSpool also has a class of variables that are created by the SET command and are available for use in WHILE commands. A limited set of these variables is also available for use outside WHILE commands. LOOKUP variables are used to predefine a set of values based on spool file and user attributes for use in NBSpool and MPE commands. The general form of LOOKUP variables are: Variable Description CURR_key_name Looks up values based on the current spool file.
Chapter 2 The LOOKUP_USER_QUEUE variable will also only be defined if it was previously created with a SET command. The LOOKUP variables use the logon user’s information as opposed to a spool file’s user information. In the following example, any $STDLISTs created by one of the three specified users will be archived to the corresponding files. Spool files created by other users will be ignored. 0> SET VAR=ARCHIVE;USER=MGR.NETBASE;VALUE=’STUFF.ARC’ 0> SET VAR=ARCHIVE;USER=MANAGER.SYS;VALUE=’SMSTUFF.
Running NBSpool Command Redirection Redirection allows the output of certain commands to be sent to an output file other than $STDLIST. The syntax for redirection is: O> command >[filespec] The filespec entry is a file name or back-referenced file equation. • If no filespec is specified, the output will go to NBOUTPUT, which by default is directed to the device class LP. If no file exists, one will be built as a temporary, variable ASCII file with CCTL enabled.
Chapter 2 Examples of Command Redirection To create a fixed ASCII disk file in the permanent domain, issue the following commands: O> :FILE SAVEOUT;REC=-80,16,F;NOCCTL;SAVE O> S $STDLIST > *SAVEOUT To redirect the output to the device class LASER, do one of the following: O> :FILE LISTING;DEV=LASER O> ARC @;FILE=BIGARC > *LISTING or O> :FILE NBOUTPUT=WHATEVER;DEV=LASER O> P @.SYS > In this last example, the file name is missing, so the default was taken.
C H A P T E R 3 NBSpool Output Commands The NBSpool output mode determines the set of valid NBSpool output commands that can be used on output spool files. This chapter describes each output command, with information on the operation, syntax and parameters for each command. Examples are also provided. Review the “Command Summary” section for a brief overview of the output commands. The NBSpool output commands appear in alphabetical order in this chapter.
Chapter 3 Command Summary This section summarizes the available NBSpool output commands. The output commands are listed in alphabetical order. Command Function O>ALTER This command changes device, outpri, creator and other attributes of a spool file. O> ARCDIR This command displays the directory of files in an archive file. O>ARCHIVE This command stores and optionally compresses a subset of spool files to a disk file. Spool files may be restored with the UNARCHIVE command.
NBSpool Output Commands Command Function O>LIST This command lists a range of lines of the currently texted spool file. O>LISTREDO This command displays a list of previously entered commands. O>MAIL This command converts spool file data to text format and sends it via HPDesk to a specified user. O>MERGE This command copies a subset of spool files into one disk or spool file. O>MOVE This command moves spool files from one computer to another.
Chapter 3 3-4 Command Function O>TEXT This command opens a spool file for listing with the LIST and KEEP command. O>UNARCHIVE This command extracts and rebuilds spool files from a previously created archive file. O>VDIR This command displays a directory of a VISTA Plus folder file. O>VERIFY This command displays the current value of NBSpool configuration options.
NBSpool Output Commands Output Commands The following sections describe the NBSpool output commands in detail. For each command, you will find information on the operation, syntax and parameters. Examples are also provided. The NBSpool output commands appear in alphabetical order. ALTER The ALTER command changes local spool file characteristics such as OUTPRI, DEVICE or COPIES. The ALTER command allows mass changes to a subset of spool files. Each qualifying spool file will be displayed as it is altered.
Chapter 3 ALTER Syntax O> ALTER subset [;PRI =outpri ] ] [;COPIES=copies [;DEV ={class} ] [ {ldev } ] [;CREATOR=user ] [;ENV=envfile ] [;FORMID=[formid] ] [;FORMS=”formmsg” ] [;JOBNAME=jobname ] [;NAME=name ] [;PRINTER=printdef] [;SPSAVE={Y | N} ] [;STATE=state ] [;ASK ] [;NOENV ] [;NOFORMS ] [;NOPAGE ] [;NEWTIME ] [;NOQUOTE ] ALTER Parameters Parameter Description subset This parameter specifies the subset of spool files to be altered. Turn to Chapter 2 for more information on using subsets.
NBSpool Output Commands Parameter Description formmsg This parameter specifies the new forms message to be used by this spool file. Trailing periods are ignored. jobname This parameter specifies the new job name for the spool file. This name can be omitted. envfile This parameter specifies the name of an environment file to be added to the spool file. If an environment already exists in the spool file, it will be changed to the new environment.
Chapter 3 ARCDIR The ARCDIR command displays a formatted listing of the spool files stored in an archive file. The format of the display is the same as the SHOW command. Information about the size of the archive and its directory is displayed before the listing of spool files. The available space in an archive is also displayed. If an archive has its security released, the word *RELEASED* will be displayed in the archive directory header.
NBSpool Output Commands ARCDIR Examples In the following example, the spool files in the A111188 archive file are displayed. O> ARCDIR A111188.ARCSPOOL Archive Directory for file created on 11/11/88 16:30:54 Archive Directory Limit Directory Entries Available = 26 = 15 Archive Limit in Sectors Archive Sectors Available = 4000 = 2880 DFID FILENAME JOB USER NAME SECTORS DEVICE PRI WHEN CREATED -------------------------------------------------------------------------#O6 LIST #S463 MGR.
Chapter 3 ARCHIVE The ARCHIVE command stores and compresses spool files to disk for later unarchiving. This provides a disk-based alternative to the STORE and RESTORE to tape feature. Press Ctrl+y to terminate the command. If the PURGE option was specified, none of the archived spool files will be purged. The archive file is created by this command, so if a file with the same name already exists, it will be purged after confirmation from the user.
NBSpool Output Commands ARCHIVE Syntax O> ARCHIVE [subset] ;FILE=[filename] [;LIMIT=files,sectors] [;NEWPRI=outpri ] [;PURGE ] [;ASK ] [;NOCOMP ] [;APPEND ] [;RELEASE ] User Tip. This command may be abbreviated to ARC. ARCHIVE Parameters Parameter Description subset This parameter specifies the subset of spool files to be archived. Turn to Chapter 2 for information on using subsets. filename This parameter specifies the formal file designator of the new archive file.
Chapter 3 ARCHIVE Examples In the following example, every spool file is archived and then purged. O> ARCHIVE @;FILE=A111188.SPOOLARC;PURGE 10 Spool files Qualify DFID FILENAME JOB USER NAME SECTORS STATUS --------------------------------------------------------------#O6 LIST #S463 MGR.NETBASE 44 Archived #O7 BIGLIST #S497 MGR.NETBASE 1960 Archived #O8 PRINTER #S415 MGR.NETBASE 36 Archived #O9 PORT #S222 MGR.NETBASE 40 Archived #O275 OFFLINE #S35 MGR.NETBASE 76 Archived #O278 OFFLINE #S35 MGR.
NBSpool Output Commands ARCPURGE The ARCPURGE command purges selected spool files that were archived with the ARCHIVE command. Any subset of spool files in the archive may be purged. Only the archive’s creator may use the ARCPURGE command. Pressing Ctrl+y will terminate the archive purging process. If a fileset was specified, any fully processed archive files will be left in their newly cleaned state.
Chapter 3 ARCPURGE Examples In the following example, all spool files from the STUFF archive are purged of outpri 7. O> ARCP %7;FILE=STUFF In the following example, all spool files for device class LPSLOW are purged. O> ARCPURGE *LPSLOW;FILE=ARCFILE In the following example, all spool files more than 10 days old are purged.
NBSpool Output Commands BANNER The BANNER command takes spool files and attaches header and trailer banners to them. The information displayed on the banner as well as the format of the banners is predefined in the BANNER database. In addition, the distribution lists for a particular spool file come from the BANNER database. If a distribution list exists for a spool file, the BANNER command will create one spool file for each user on the distribution list. This can be overridden with the SINGLE parameter.
Chapter 3 BANNER Parameters 3-16 Parameter Description subset This parameter specifies the subset of spool files to be processed. Turn to Chapter 2 for information on using the subset parameter. outpri This parameter specifies the output priority of the new spool files. This parameter must be an integer from 1 to 14. copies This parameter specifies the number of copies for the new spool files. This parameter must be an integer from 1 to 127.
NBSpool Output Commands BANNER Examples In the following example, a banner is added to all $STDLISTs with an output priority of 6. O> B $,%6 In the following example, a banner is added to spool file #O102, leaving the original alone and suppressing a trailer. O> BANNER 102;SAVE;NOTRAIL In the following example, a banner is added to GLREPORT and prevents the creation of multiple spool files for everyone on the distribution list.
Chapter 3 BROWSE The BROWSE command executes in two stages. The first stage processes the subset of spool files for viewing. The second stage invokes the VISTA Plus online viewer. The user is then able to use VISTA Plus to view any report specified in the subset. The BROWSE command operates only on spool files in the READY state. By default, the BROWSE command simply displays a Processing Files... message while it preprocesses the spool files.
NBSpool Output Commands BROWSE Parameters Parameter Description subset This parameter specifies the subset of spool files to be viewed. Turn to Chapter 2 for more information on using subsets. ASK This parameter prompts at each file to include for processing. COMP This parameter specifies that compression should be used when processing the spool files. FFSCAN This parameter scans the contents of each report for form feed characters to determine page breaks.
Chapter 3 COPY The COPY command copies one or more spool files to a remote node. When the command is first executed, NBSpool will contact the remote computer and establish a connection. Any subsequent access to that node will not require an additional connection. This command may be stopped at any time by pressing Ctrl+y. If a copy is in process, the unfinished remote copy will be purged. Note. Unlike the MOVE command, the COPY command does not purge the original spool file.
NBSpool Output Commands If you are sending copies via LPR/LPD, the destination can be followed by an option string that will be sent to the remote system. The option string must be in the following format: “dest -option1 [ -option2[...]]” For example: lj -olandscape -tHello. To alter the printing characteristics of a spool file destined for a NetWare printer, the PRINTER parameter can be used. As with the PRINT command, various control strings can be specified, as well as paging control.
Chapter 3 COPY Parameters (for all destinations) Turn to the “MOVE Parameters” section in this chapter for information on the available COPY command parameters. All parameters are the same, with one exception for the COPY command. The parameter is defined as follows: Parameter Description newpri This parameter specifies the output priority that will be assigned to the original spool file after successful completion of a copy. Must be between 0 and 14.
NBSpool Output Commands The COPY command is often used in background jobs to continually copy spool files from one computer to another. In the following example, all spool files with a priority of 8 to 14 are copied to the remote computer, ENGINE, every 60 seconds. !JOB COPYJOB,OPERATOR.SYS ! !DSLINE ENGINE;LOGON=SPXFER,OPERATOR/SECRET.SYS ! !RUN NBSPOOL.PUB.NETBASE XEQ;WAIT=60 COPY %8-14 TO *ENGINE;NEWPRI=7 END EXIT !EOJ Note.
Chapter 3 COPYF The COPYF command performs a file transfer operation between the HP 3000 and a Novell NetWare server. This command operates only on disk files. Binary disk files are transferred without any data translation. ASCII files are converted to DOS format (trailing spaces truncated, CR/LF appended to the end of each line). A transfer will not be made if the destination file exists unless the REP parameter is specified.
NBSpool Output Commands COPYF Example In the following example, the file BIGREPT.DATA is copied to the directory \HOME\JANE on the SYS volume of the file server ACCTNG. O> COPYF BIGREPT.DATA TO GATE;Q=ACCTNG/SYS:HOME/JANE/BIGREPT.
Chapter 3 DUP The DUP command duplicates existing spool files. The new spool files may have their outpri, copies and device specifications changed, but will otherwise be exact copies of the originals. This command may be interrupted at any time by pressing Ctrl+y. If a spool file is being copied, the new incomplete copy will be purged. Note. The DUP command operates only on spool files in the READY state. To denote the copies, the job/session number will be changed to include an apostrophe, as in #S’1.
NBSpool Output Commands DUP Syntax O> DUP subset [;PRI =outpri ] [;COPIES=copies ] [;DEV ={class} ] [ {ldev } ] [;NEWPRI=newpri ] [;CREATOR=user ] [;ENV=envfile ] [;FORMS=”formmsg”] [;NAME=name ] [;ASK ] [;NOENV ] [;INTERLEAVE ] [;NEWTIME ] [;NOPAGE ] [;NOQUOTE ] [;PURGE ] DUP Parameters Parameter Description subset This parameter specifies the subset of spool files to be duplicated. Turn to Chapter 2 for information on using subsets.
Chapter 3 Parameter Description formmsg This parameter specifies the new forms message to be used by this spool file. A trailing period will be ignored if specified. name This parameter specifies the name of the new spool file. Can be any valid spool file name except $STDLIST. ASK This parameter prompts at each file to include for processing. NEWTIME This parameter changes the creation date and time to be the current time when creating the duplicate spool file.
NBSpool Output Commands INDICATE This command inserts a line of text to indicate where the strings used in a subset were found in qualified spool files. The WITH parameter allows the default text *** to be overridden. INDICATE operates only on spool files in the READY state. INDICATE Syntax O> INDICATE subset [;WITH [;SHOW ="string" ] ] User Tip. This command may be abbreviated to INDI. INDICATE Parameters Parameter Description subset Specifies the subset of spool files to be processed.
Chapter 3 INPUT The INPUT command switches the mode of NBSpool to look at job $STDIN files. A new set of commands will appear, and the operation of other commands may change. If a file is texted when switching modes, it will be closed. In addition, the sorting order will be reset when switching modes. Finally, the prompt will change to show the new mode. To secure the INPUT mode, you may use the SET command to specify a password required with the command.
NBSpool Output Commands KEEP The KEEP command copies some or all of the currently texted spool file into a permanent disk file. By default, the new file will contain all of the carriage control ( CCTL) information from the spool file. It can then be edited and FCOPYed back into a spool file without losing formatting information. Important! Laser printer environment information is not written to the keep file and will be lost.
Chapter 3 KEEP Parameters Parameter Description filename This parameter specifies the name of the file to create. If the file already exists, you will be asked for permission to overwrite it. AUTO This parameter specifies that the record length for the keep file should be determined automatically. The size will be that of the longest record in the spool file. recsize This parameter specifies the record size for the keep file. Type a negative for bytes. The default is 132 byte records.
NBSpool Output Commands KEEP Example In the following example, the spool file OFFLINE is saved as TEMPLIST, stripping out the printer carriage control information. The LISTF command shows the default parameters NBSpool uses to build the disk file if the REC= parameter is omitted. O> TEXT OFFLINE Opened spool file #O3419 (OFFLINE), last line is 84.
Chapter 3 LIST The LIST command displays some or all of the spool file opened by a prior TEXT command. The format of the command closely approximates that of the contributed library program QUAD. To copy a subset of a spool file to another spool file, use the UNN and OFFLINE parameters. This will copy the selected range of lines to a new spool file named NBSPLIST. All carriage control will be retained in the new file. All FDEVICECONTROL records will be stripped.
NBSpool Output Commands LIST Parameters Parameter Description range This parameter specifies the range of lines to be displayed. If this parameter is not specified, only the current line will be listed. Range is expressed as one of the following: ALL Selects all lines in the spool file. @ Selects all lines in the spool file. line Line designator. A line is one of the following: A positive integer specifying a particular line in the file. The first line in a spool file is line 0.
Chapter 3 Parameter Description UNN This parameter suppresses line numbers in the listing, and causes all carriage control directives to be executed. VARS When selected, two CI variables (or JCWs on MPE/V) are created: NBFIRSTLINE and NBLASTLINE which contain the line numbers of the first and last line listed. If nothing is listed, the values will be -1 (or 65535 on MPE/V).
NBSpool Output Commands LIST Examples In the following example, texting in a $STDLIST and using the LIST command to display the contents are illustrated. O> T $STDLIST 4 Spool files Qualify DFID FILENAME JOB USER NAME SECTORS DEVICE PRI WHEN CREATED ---------------------------------------------------------------------------#O3434 $STDLIST #J1065 MGR.NETBASE 384 LP 1 OPENED #O3404 $STDLIST #J1052 MGR.NETBASE 40 LP 1 10/03/88 14:51 #O3415 $STDLIST #J1058 MGR.
Chapter 3 If you are only interested in the RUN commands, the following command can be used: O> L “RUN” 11 :RUN COPYN.PUB.NETBASE;INFO=”FROM=NBLOG.DATA.NETBASE;TO=NBLOGBK.DATA” 20 :RUN NBCOP.PUB.NETBASE In the following example, the last 100 lines of the current spool are copied to a new spool file.
NBSpool Output Commands LISTREDO The LISTREDO and REDO commands allow you to quickly repeat previously entered commands. The LISTREDO command displays a list of previously entered commands. To repeat a command that appears in the list, enter the REDO command followed by the number that appeared next to the LISTREDO command’s display. LISTREDO Syntax O> LISTREDO LISTREDO Parameters No parameters exist for the LISTREDO command.
Chapter 3 MAIL The MAIL command converts spool file data to text format and sends it via HPDesk to a specified user. This command requires that HPDesk be installed and enabled on the system. A user must be specified in order to send any messages. The CI variable DESKUSER must first be defined before the MAIL command can be used.
NBSpool Output Commands Mail Examples In the following example, the DESKUSER variable must be set first before executing the MAIL command: :SETVAR DESKUSER "JANE DOE;MYPASS;DEMO/00" :RUN NBSPOOL.PUB.
Chapter 3 MERGE The MERGE command merges a subset of spool files together to form one new file. The order in which the files will be merged is determined by the SORT command. If a range is specified, only those lines within the range from each spool file will be merged. If the output file is a disk file, it will be created if it does not exist. If it does exist, it will be purged unless a file equation has been issued with the ACC=APPEND parameter.
NBSpool Output Commands MERGE Parameters Parameter Description subset This parameter specifies the subset of spool files to be merged. Turn to Chapter 2 for information on working with subsets. filename This parameter specifies the name of the file to create. If the disk file exists, the user will be asked to purge it. recsize This parameter specifies the record size for the output file. Negative for bytes. The default is 132 byte records.
Chapter 3 Parameter Description REPEAT This parameter causes the string to be repeated across the full width of the spool file. range This parameter specifies the range of lines to be merged. If this parameter is not specified, all lines will be merged. Range is expressed as one of the following: ALL Selects all lines in the spool file. @ Selects all lines in the spool file. line Line designator. A line is one of the following: line# A positive integer specifying a particular line in the file.
NBSpool Output Commands In the following example, a set of $STDLISTs are appended to the file HOLDSTDL.DATA, and the file is created if it does not exist. O> :FILE HOLDSTDL.DATA;ACC=APPEND;DISC=10000 O> MER $STDLIST;FILE=*HOLDSTDL.DATA Note. If the HOLDSTDL.DATA file existed, the records would have been appended to the end. If the file did not exist, it would have been built with the example size of 10,000 records.
Chapter 3 MOVE The MOVE command moves one or more spool files to a remote node. When the command is first executed, NBSpool will contact the remote computer and establish a connection. Any subsequent access to that node will not require an additional connection. This command may be stopped at any time by pressing Ctrl+y. If a move is in process, the unfinished remote copy will be purged.
NBSpool Output Commands If you are moving spool files via LPR/LPD, the destination can be followed by an option string that will be sent to the remote system. The option string must be in the following format: “dest -option1 [ -option2[...]]” For example: lj -olandscape -tHello. To alter the printing characteristics of a spool file destined for a NetWare printer, the PRINTER parameter can be used. As with the PRINT command, various control strings can be specified, as well as paging control.
Chapter 3 Destinations for the MOVE Command The following sections provide information on the MOVE command’s syntax and parameters for the several different destination types. These destinations include HP 3000, UNIX, NetWare/iX, NFS/iX, Gateway, LAN-connected printer and LPR/LPD. The parameters are defined after each syntax destination type. Moving spool files to some of the destinations listed in this section may require additional utilities.
NBSpool Output Commands Parameter Description outpri This parameter specifies the output priority used when creating the spool file on the remote computer. This must be between 1 and 13. copies This parameter specifies the number of copies used when creating the spool file on the remote computer. This must be between 1 and 127. class This parameter specifies the device class used when creating the spool file on the remote computer. This must be a valid spooled device class.
Chapter 3 MOVE Syntax for UNIX Destinations O> MOVE [subset] TO nodename ;HPUX="options" [;COPIES=copies [;DEST="destination" [;DUP [;PRINTER=printername [;START=record [;TIMEOUT=seconds [;RETRY [;RETRYDELAY=seconds ] ] ] ] ] ] ] ] MOVE Parameters for UNIX Destinations Parameter Description subset This parameter specifies the subset of spool files to be copied. Turn to Chapter 2 in this guide for information on using subsets.
NBSpool Output Commands Parameter Description seconds This parameter specifies the number of seconds to wait for a response from the remote system before aborting a transfer. This should only be used if errors or hanging occurs during moves. A value of 0 disables the timeout entirely. RETRY Specifies that during a MOVE, if the destination node is unavailable, a delay of five seconds should be followed by an attempt to reconnect.
Chapter 3 MOVE Syntax for NetWare/iX Destinations O> MOVE [subset] TO server/queue [;COPIES=copies [;DUP [;NOENV [;FORM={formname} [ {* } [;PRINTER=printername [;RETRY [;RETRYDELAY=seconds ] ] ] ] ] ] ] ] MOVE Parameters for NetWare/iX Destinations Parameter Description subset This parameter specifies the subset of spool files to be copied. Turn to Chapter 2 for information on using subsets. server This parameter specifies the name of a Novell NetWare server.
NBSpool Output Commands Parameter Description printername The name of a configured printer definition. Printer definitions are maintained by the PRINTDEF program. RETRY Specifies that during a MOVE, if the destination node is unavailable, a delay of five seconds should be followed by an attempt to reconnect. RETRYDELAY Specifies RETRY, as above, with a delay in seconds as specified, instead of the default time of five seconds.
Chapter 3 MOVE Syntax for Quest Gateway Destinations O> MOVE [subset] TO gateway ;QUEUE={server/queue} {path }[;COPIES=copies ] [;NOENV ] [;DUP ] [;PRINTER=printername ] [;START=record ] [;TIMEOUT=seconds ] [;RETRY ] [;RETRYDELAY=seconds ] MOVE Parameters for Quest Gateway Destinations Parameter Description subset This parameter specifies the subset of spool files to be copied. Turn to Chapter 2 for information on subsets.
NBSpool Output Commands Parameter Description printername This parameter specifies the name of a configured printer definition. Printer definitions are maintained by the PRINTDEF program. record This parameter specifies the first record in the spool file that will be sent to the remote system or printer. The LIST command can be used to determine this number. seconds This parameter specifies the number of seconds to wait for a response from the remote system before aborting a transfer.
Chapter 3 MOVE Syntax for LAN-connected Printer Destinations O> MOVE [subset] TO nodename ;PTYPE=printertype [;COPIES=copies [;NOENV [;DUP [;PRINTER=printername [;START=line [;TIMEOUT=seconds [;RETRY [;RETRYDELAY=seconds ] ] ] ] ] ] ] ] MOVE Parameters for LAN-connected Printer Destinations Parameter Description subset This parameter specifies the subset of spool files to be copied. Turn to Chapter 2 for information on using subsets.
NBSpool Output Commands Parameter Description NOENV This parameter prevents inserting Term Type file initialization strings from being added to the output data. By default, these strings will be inserted in the output data. DUP This parameter causes a spool file to be sent multiple times to the destination if the number of copies is greater than one. Useful if the destination does not support multiple copy printing. printername This parameter specifies the name of a configured printer definition.
Chapter 3 MOVE Syntax for NFS/iX Routed Destinations O> MOVE [subset] TO nodename ;NFS ;DEST=”device[ user]” [;COPIES=copies ] [;NOENV ] [;PRINTER=printername ] [;START=record ] [;RETRY ] [;RETRYDELAY=seconds ] MOVE Parameters for NFS/iX Destinations Parameter Description subset This parameter specifies the subset of spool files to be copied. Turn to Chapter 2 for information on using subsets.
NBSpool Output Commands Parameter Description record This parameter specifies the first record in the spool file that will be sent to the remote system or printer. The LIST command can be used to determine this number. RETRY Specifies that during a MOVE, if the destination node is unavailable, a delay of five seconds should be followed by an attempt to reconnect. RETRYDELAY Specifies RETRY, as above, with a delay in seconds as specified, instead of the default time of five seconds.
Chapter 3 MOVE Syntax for LPR/LPD Routed Destinations O> MOVE [subset] TO nodename ;LPR ;DEST=”device[ options]” [;COPIES=copies ] [;NOBANNER ] [;NOENV ] [;PRINTER=printername ] [;START=record ] [;TIMEOUT=seconds ] [;RETRY ] [;RETRYDELAY=seconds ] MOVE Parameters for LPR/LPD Routed Destinations Parameter Description subset This parameter specifies the subset of spool files to be moved. Turn to Chapter 2 for information on using subsets.
NBSpool Output Commands Parameter Description seconds This parameter specifies the number of seconds to wait for a response from the remote system before aborting a transfer. This should only be used if errors or hanging occurs during moves. A value of -1 disables the timeout entirely. device This parameter specifies the destination device name. Case is significant. ASK This parameter prompts at each file to include for processing.
Chapter 3 logon. If the remote computer ENGINE goes down, NBSpool will logon again without any operator intervention. In the following example, some sample JCL do this. !JOB MOVEJOB,OPERATOR.SYS ! !DSLINE ENGINE;LOGON=SPXFER,OPERATOR/SECRET.SYS ! !RUN NBSPOOL.PUB.NETBASE XEQ;WAIT=60 ERROR IGNORE MOVE %8-14 TO *ENGINE END EXIT !EOJ In the following example, the Quest Novell PC Gateway Product moves all spool files for device class RLASER to Novell Server MYSERVER, Printer Queue HPLJQ.
NBSpool Output Commands PRINT The PRINT command allows a user to print a spool file on a printer attached to a local terminal or PC. Every attempt has been made to reproduce the output of normal line printers on local printers. Most carriage control directives are translated to the appropriate line and form feed commands. In normal operation, the PRINT command will purge a spool file once a copy has been successfully sent to a printer. The SAVE or NEWPRI parameters will override this default.
Chapter 3 By default, the PRINT command assumes 60 lines per page, 6 lines per inch, with automatic page ejects. PRINTDEF can be used to override these defaults. The LPP parameter can override the lines per page without requiring a printer definition. RAW is used to pass spool files with HP 3000 escape sequences, and does not do any PCL conversion.
NBSpool Output Commands Parameter Description bytes This parameter specifies the maximum number of bytes to send to the terminal at one time. This parameter should be used if some of the data appears on the terminal instead of printing or other protocol problems appear. This can be between 32 and 256. ASK This parameter prompts at each file to include for processing. NOCCTL This parameter ignores all carriage control directives in a spool file, except %320, which is no space, no return.
Chapter 3 PRINTDEF Program The PRINTDEF program enables users to customize local printing and LAN printing. Printer definitions can be setup to provide users the ability to specify how their reports should be printed. Default definitions exist for printing to HP laser printers allow reports to be printed in landscape or portrait, 8 lines per inch. To run PRINTDEF, type: :RUN PRINTDEF.PUB.NETBASE Maintain Printer Definitions [X.
NBSpool Output Commands PRINTDEF Fields After a command is issued, the PRINTDEF program will prompt you for or display information for the specified printer definition. The defaults for these fields are displayed in parentheses. Field Description Description This entry is an optional description of the printer definition. This entry can not exceed 36 characters in length. Lines per page (60) The lines per page is used by NBSpool in converting a spool file from carriage control to flat printer output.
Chapter 3 3-68 Field Description Send LaserJet page controls (Y) NBSpool will send LaserJet page controls that allow printing more than 60 lines per page if perforation skipping is disabled in the spool file. Strip PJL escape sequences (N) If this is set to Y, NBSpool removes PJL sequences from a spool file. You would only need to use this if a printer is set to “postscript” and PJL is embedded in the spool file with PCL escape sequences.
NBSpool Output Commands PRINTDEF Control Strings Control strings may be defined to be sent to the printer before and after the spool file is printed. The control string is entered and displayed by entering or displaying the numeric value of the nonprintable characters and by delimiting the printable characters with quotes. The two need to be separated by commas. For example: 27,”(s0p12H”,27,”&l1H” The control string may be up to 192 ASCII characters long.
Chapter 3 PRINTDEF Example In the following example, all spool files QUADLIST created by the logged on user at 132 columns, 8 lines per inch on a HP LaserJet, are printed. O> MOVE QUADLIST,#*;PRINTER=LJ8LPI In the following example, all currently defined printer definitions are listed. :RUN PRINTDEF.PUB.NETBASE Maintain Printer Definitions [0.9.
NBSpool Output Commands In the following example, the new printer definition LJP is added.
Chapter 3 In the following example, the printer definition LJP is printed. Enter a printer definition (or LIST, DELETE, EXIT) PRINT LJP In the following example, the printer definition LJP is deleted. Enter a printer definition (or LIST, DELETE, EXIT) DELETE LJP In the following example, the new printer definition LAND66 is added.
NBSpool Output Commands In the following example, the new printer definition RAW is added.
Chapter 3 PURGE The PURGE command purges all qualified spool files. The PURGE command operates only on spool files in the READY state. The execution of the command may be stopped by pressing Ctrl+y. If this command is run interactively, and more than one spool file qualifies, a question will be asked to confirm the purge. This helps to prevent accidentally deleting spool files.
NBSpool Output Commands PURGE Examples In the following example, the SHOW command is first used to display the files that will be purged. O> SHOW LP 4 Spool files Qualify DFID FILENAME JOB USER NAME SECTORS DEVICE PRI WHEN CREATED -------------------------------------------------------------------------#O3445 LP #S’457 MGR.NETBASE 48 LP 1 10/06/88 17:04 #O3436 LP #S457 MGR.NETBASE 48 LP 1 10/06/88 17:04 #O3450 LP #S’457 MGR.NETBASE 48 LP 1 10/06/88 17:04 #O3451 LP #S’457 MGR.
Chapter 3 REDO The REDO command allows a prior command to be modified and reexecuted. To repeat the last command simply type REDO at the NBSpool prompt, modify the line using standard EDITOR commands, and enter a carriage return to execute the command. The REDO command can also be used with the LISTREDO command as described below. Turn to the “LISTREDO” section in this chapter for more information.
NBSpool Output Commands Parameter Description d DELETE. Deletes a character. You may specify multiple ds to delete a series of characters. Or, you may type multiple ds, followed by spaces, then followed by more ds to delete some characters while skipping others. You may follow this directive with other edits. > APPEND TO EOL. Appends the text to the end of the current line.
Chapter 3 RESTORE The RESTORE command recreates spool files that were stored using the NBSpool STORE command. When restoring, a specific tape file or all tape files may be specified for searching and restoring. This command normally executes much more quickly than the same command in SPOOK. Pressing Ctrl+y will stop the restore in progress. Incomplete spool files will be not be restored. To denote the restored files, the job/session number will be altered to include an apostrophe, for example #J’8.
NBSpool Output Commands Parameter Description @ This parameter scans all tape files during the restore operation. This will cause the restore to search all files on a volume set for the specified spool files. Qualifying spool files from all tape files will be restored. seq# This parameter specifies which tape file will be used for the restore. This is only applicable if the STORE command’s APPEND parameter has been used to create multiple tape files on one tape. The first sequence number is 1.
Chapter 3 SET The SET command sets run time and configuration options for NBSpool. The USERCAP keyword allows a user’s normal MPE security to be changed for the purpose of manipulating spool files. This command has no effect on users with SM capability. Note. This command cannot be used to give a user less security (OPERATOR.SYS cannot be given AM security). Also, MPE commands are not affected by this value. Only users with SM capability can give OP capability.
NBSpool Output Commands SET Parameters Parameter Description ABORT When set to TRUE (default), any unrecoverable error causes NBSpool to terminate immediately. Interactive users never abort due to syntax or other user recoverable errors. FROMNODE This parameter is used with the MOVE and COPY commands to set the node name used when connecting to a remote HP 3000 system.
Chapter 3 Parameter Description SPSAVE This parameter causes the MOVE command to respect the SPSAVE flag for spool files. If SPSAVE is set for a spool file, the MOVE command will not purge the original spool file. Instead, it will be put into the SPSAVE state when moved. If the default is FALSE, it purges the spool file after the move. SYSTEMLOG Setting the SYSTEMLOG parameter to ON causes NBSpool to write system log records (type 120, native mode spooler) to the system log files.
NBSpool Output Commands Parameter Description varname A 1 to 8 character alphanumeric name. The first byte must be alphabetic. key One of the following values: DEVICE Spool file device used as a key JOBNAME Spool file job/session name NAME Spool file name USER Spool file creator user/account keyvalue The actual device, job name, file name or user. SUPRESS Affects error messages which would be displayed either on the console or on the standard list only.
Chapter 3 In the following example, the same user is given access to all spool files on the system. O> SET USERCAP=OP;USER=BOB.MFG In the following example, a user capability override is deleted. O> SET USERCAP=;USER=BOB.MFG VAR Parameter Examples To create a variable that will have the value “GLREPORT.ARCHIVE” for all reports on the device class GLPRINT, enter: O> SET VAR=FOLDER;DEVICE=GLPRINT;VALUE=”GLREPORT.
NBSpool Output Commands SHOW The SHOW command provides a listing of a specified spool subset. The three keywords DATES, LINES and USERS cause the display to be formatted in one of three different ways. Once one of these keywords is specified, all subsequent SHOW commands will use the same format until another format keyword is specified. This command may be interrupted at any time by pressing Ctrl+y.
Chapter 3 Parameter Description LINES This parameter replaces the creation date in the listing with the number of records in the spool file as well as the number of copies. This parameter can be abbreviated to ;L. This is the default. USERS This parameter specifies that the job/session names be included in the display. Due to space limitations, the creation date is not displayed. This parameter can be abbreviated to ;U.
NBSpool Output Commands In the following example, the SHOW format AGE displays the number of days or how old a file is. O> show 46473;age DFID FILENAME JOB USER NAME SECTORS DEVICE PRI CREATED AGE -------------------------------------------------------------------------#O46473 $STDLIST #J’19 MGR.NETBASE 16 LP 1 10/20/92 29 In the following example, the SHOW format FORMS displays the formid.
Chapter 3 SORT The SORT command allows you to specify the order in which all other commands will display lists of spool files. The default is that no sorting will be done. The most minor sort will always be done by device file ID number if any sorting is specified. Using the OFF parameter specifies a return to the default state. The default sorting order is by DFID number. SORT Syntax O> SORT {[sortspec][,sortspec][,...
NBSpool Output Commands Parameter Description DESC This parameter specifies that the sort should be done in descending order. This applies to all sortspec keys at once. OFF This parameter specifies that no sorting is to be done. SORT Examples The following example illustrates the before and after effects of the SORT command. In this example, the first SHOW uses the default.
Chapter 3 START The START command starts the background execution of various NBSPOOL services such as BOOTP and UNIX receiving. With this command, additional jobs for the running of these services are unnecessary. Once a background service is started, it remains running until either a STOP command is executed, or the QUIT command is detected. If NBSPOOL is run from a job, it will suspend when the EXIT command is executed unless all background services are explicitly stopped. START Syntax.
NBSpool Output Commands STOP The STOP command stops the specified background services. These services are terminated immediately. For BOOTP, this command must be executed from the same NBSpool process that originally started the background BOOTP service. Any user with OP capability can stop the RECV or LPD processes. STOP Syntax. O> STOP {BOOTP | LPD | RECV | SPOOLING} STOP Parameters Parameter Description BOOTP This parameter stops the BOOTP service. LPD This parameter stops the LPD service.
Chapter 3 STORE The STORE command saves spool files to tape for archival purposes and to facilitate inter-computer spool file transfers. This command uses and requires labeled tapes. The formal file designator is NSPOOL, and a file equation may be used to change the volume name or expiration dates if desired. This command is much faster than the equivalent SPOOK command and consumes considerably less tape. Tapes are not compatible with SPOOK, unless the SPOOK parameter is specified.
NBSpool Output Commands STORE Parameters Parameter Description subset This parameter specifies the subset of spool files to be stored. Turn to Chapter 2 in this guide for information on working with subsets. class The device class of the tape or serial disk device used to store the spool files. ldev The logical device number of the tape or serial disk device used to store the spool files. outpri The output priority that all successfully stored spool files will have after being stored.
Chapter 3 STORE Examples The following example demonstrates one method that can be used to archive all spool files to tape periodically through out the day appending to the same tape. O> SHOW $STDLIST 3 Spool files Qualify DFID FILENAME JOB USER NAME SECTORS DEVICE PRI WHEN CREATED --------------------------------------------------------------------------#O3473 $STDLIST #J1074 MGR.NETBASE 36 LP 1 10/10/88 13:01 #O3415 $STDLIST #J1058 MGR.NETBASE 36 LP 1 10/05/88 10:51 #O3399 $STDLIST #J1049 MGR.
NBSpool Output Commands The outpri is being used here to flag what $STDLISTs have been archived to tape. The list below displays some more $STDLISTs that need to be appended to the tape. O> SHOW $STDLIST 6 Spool files Qualify DFID FILENAME JOB USER NAME SECTORS DEVICE PRI WHEN CREATED --------------------------------------------------------------------------#O3486 $STDLIST #J1080 MGR.NETBASE 40 LP 1 10/10/88 13:22 #O3473 $STDLIST #J1074 MGR.NETBASE 36 LP 2 10/10/88 13:01 #O3488 $STDLIST #J1082 MGR.
Chapter 3 SUBMIT The SUBMIT command translates the specified spool files into fixed ASCII files, then submits them to an IBM host via SNA NRJE. If the file is successfully submitted, it will optionally be purged or altered. The SUBMIT command can process spool files of up to 100,000 records.
NBSpool Output Commands SUBMIT Parameters Parameter Description subset This parameter specifies the subset of spool files to be submitted. Turn to Chapter 2 for information on using subsets. wsid This parameter specifies the workstation ID to which the spool files will be submitted. front This parameter specifies the name of an MPE file that will be placed in front of each spool file in the subset.
Chapter 3 SUBMIT Examples To submit all the GLREPORT spool files to the workstation BIGBLUE, and to purge the spool files as they are submitted, enter: O> SUBMIT GLREPORT TO BIGBLUE;PURGE To include a file named ERRORS containing OS/JCL in front of all spool files that were created today, and to give them a job name of BADSTUFF, enter: O> SUBMIT ERRORS,=TODAY TO BIGBLUE;J=BADSTUFF To submit all the GLREPORT spool files to the workstation RMT8, and to purge the spool files as they are submitted, enter O>
NBSpool Output Commands To send all spool files, with device class RM105 created today with priority greater than 1, to the IBM node name RMT2, and to create 2 copies and, after they are moved, change the priority to 1, enter: O> SUBMIT DEV=RM105,=TODAY,>%1 TO RMT2;JCL=RM105,BACK;NEWPRI=1 Where RM105 contains the following JCL: //RM02JOB JOB /*JOBPARM LINECT=60 /*ROUTE PRINT RMT2 /*OUTPUT DIST DEST=RM105,COPIES=2 //STEP1 EXEC PGM=NBSPIBM //STEPLIB DD DSN=RM00.
Chapter 3 TAPEDIR The TAPEDIR command displays the directory of one or all tape files on a NBSpool created STORE tape. The format is the same as the SHOW command’s listing. If the tape is in SPOOK format, the keyword SPOOK must be specified. The size of files in sectors will be replaced with the number of records in the spool file, due to a lack of information needed to compute the size of the spool file. The formal file designator for the tape file is NSPOOL.
NBSpool Output Commands TAPEDIR Examples The following example shows how TAPEDIR can be used to display all spool files stored using the STORE command. O> TAPEDIR @ Waiting for operator to mount tape... Tape mounted. Tape Directory for File #1, created on 10/10/88 13:21:32 DFID FILENAME JOB USER NAME SECTORS DEVICE PRI WHEN CREATED ---------------------------------------------------------------------------#O3473 $STDLIST #J1074 MGR.NETBASE 36 LP 1 10/10/88 13:01 #O3415 $STDLIST #J1058 MGR.
Chapter 3 TEXT The TEXT command opens a READY or OPENED spool file for use with the LIST command. If a subset specification qualifies more than one spool file, you will be prompted to select one of the qualifying spool files. If no subset is specified, the currently TEXTed spool file, if any, is closed. TEXT Syntax O> TEXT [subset] User Tip. This command may be abbreviated to T. TEXT Parameters Parameter Description subset This parameter specifies a subset of spool files to be processed.
NBSpool Output Commands Since the file $STDLIST is not unique, NBSpool displays all qualifying files and asks the user to resolve the ambiguity: Enter SEQ or DFID number of desired file: 4 Opened spool file #O3434 ($STDLIST), last line is 40.
Chapter 3 UNARCHIVE The UNARCHIVE command recreates spool files that were archived with the ARCHIVE command. Any subset of spool files in the archive may be extracted. If possible, the original device of the spool file will be used when recreating the file. Pressing Ctrl+y will terminate the unarchiving and will purge any partially recreated spool files.
NBSpool Output Commands Parameter Description class This parameter specifies the device class assigned to the new spool files. Must be a valid spooled output device class. ldev This parameter specifies the logical device number of the new spool files. Must be a valid spooled output device. outpri This parameter specifies the output priority of the new spool files. Must be an integer from 1 to 14. Default is the original outpri of the spool file.
Chapter 3 To extract all spool files of outpri 7 from the archive STUFF, enter: O> UNARC %7;FILE=STUFF To extract all spool files from the archive RESTART without changing the job/session number display, enter: O> UNARC @;FILE=RESTART;NOQUOTE To extract all spool files for device class LPSLOW, and change the device to LPFAST, enter: O> UNARC *LPSLOW;DEV=LPFAST;FILE=ARCFILE 3-106
NBSpool Output Commands VDIR The VDIR command displays a formatted listing of the spool files saved in a VISTA Plus folder file. The format of the display is similar to the SHOW command. A sector count shows how many sectors in the folder are used by each spool file, not the original number of sectors in the spool file. Information about the size of the folder and its directory is displayed before the listing of spool files. The available space in a folder is also displayed.
Chapter 3 VERIFY The VERIFY command is used to display the current value of the NBSpool configuration options. When you enter the command with an option, the value of that option is returned. VERIFY Syntax O> O> O> O> O> O> O> O> VERIFY VERIFY VERIFY VERIFY VERIFY VERIFY VERIFY VERIFY ABORT MAXPROCS PRIVATE SEARCH SPSAVE SYSTEMLOG USERCAP VAR=[varname];key VERIFY Parameters Parameter Description varname This parameter specifies a 1 to 8 character alphanumeric name of a variable.
NBSpool Output Commands VERIFY Examples The VERIFY command is used to display the current value of the NBSpool configuration options. When you enter the command with an option, the value of that option is returned.
Chapter 3 VFILE The VFILE command provides a method of adding non-spool files to a VISTA Plus folder. The VFILE command operates on any ASCII file with a record size of no more than 512 bytes. The block size must be less than 8192 bytes. The default page parameters of 60 lines per page will be used for page formatting unless overridden with the LPP or PRINTER parameters. The VFILE command also provides a method of saving unlinked spool files. These files are spool files that do not reside in the OUT.
NBSpool Output Commands VFILE Parameters Parameter Description fileset This parameter specifies the set of disk files to be saved. The format of this fileset is the same as that used by MPE :LISTF command. Only ASCII and spool files will be used. TEMP This parameter specifies that only files in the temporary domain will be processed. filename This parameter specifies the formal file designator of the new folder file.
Chapter 3 Parameter Description printername A 1 to 8 character name of a printer definition defined by the PRINTDEF program. This allows certain default information to be overridden, such as lines per page, perforation control etc. RELEASE This parameter allows any user to view spool files from the folder file. By default, only the creator may view these files. VFILE Examples To add all files in the DOC group to the folder DOCFILES: O> VFILE @.
NBSpool Output Commands VIEW The VIEW command allows a set of spool files to be displayed one after another on the terminal. After a spool file is completely listed or after press Ctrl+Y, the user will be prompted with one of the following messages: * Alter, Next, Purge, or Relist? * Next, Purge, or Relist? * Hit RETURN to continue or EXIT to stop: The first question is asked if any of the ALTER-like parameters are specified. The second is asked if no ALTER parameters are used.
Chapter 3 Parameter Description class This parameter specifies the new device class assigned to all qualified spool files. This must be a valid spooled device class. ldev This parameter specifies the new logical device number assigned to all qualified spool files. This must be a valid spooled output device. WIDE This parameter changes the display to 132 column mode for the duration of command execution. This parameter is ignored if the terminal cannot display 132 columns.
NBSpool Output Commands VSAVE The VSAVE command processes and saves spool files for later viewing by the VISTA Plus online report viewer. Compression and translation of the spool files occurs as the command executes. If necessary, default parameters about the page format can be overridden with the LPP or PRINTER parameters. The VSAVE command operates only on spool files in the READY state that are not empty. Pressing Ctrl+y will terminate this command. The folder file is created by this command.
Chapter 3 VSAVE Command Syntax O> VSAVE [subset] ;FILE=[filename] [;DESC="description" ] [;FLAG=errorflag ] [;LIMIT=files[,sectors]] [;LPP=lines ] [;NEWPRI=outpri ] [;OVERSTRIKE={Y|N|C} ] [;PRINTER=printername ] [;RDESC="reportdesc" ] [;START=firstrec ] [;APPEND ] [;ASK ] [;FFSCAN[="ffdelim"] ] [;INDEX ] [;NOCOMP ] [;NOSTRIP ] [;PURGE ] [;RELEASE ] User Tip. This command may be abbreviated to VS.
NBSpool Output Commands Parameter Description files This parameter specifies the maximum number of spool files that may be put into the folder. sectors This parameter specifies the size in sectors of the folder. outpri This parameter specifies the output priority that all successfully saved spool files will have after being processed. This parameter must be between 0 and 14. lines This parameter specifies the number of lines per page that will be assumed for each spool file.
Chapter 3 Parameter Description OVERSTRIKE This parameter determines if VISTA Plus will treat lines that have been overstriked as separate display lines or not. If set to Y, overstriked lines will appear as one line on the screen display. PURGE When the entire folder is successfully created and closed, all spool files saved will be purged. RELEASE This parameter allows any user to view spool files from the folder file. By default, only the creator may view these files.
NBSpool Output Commands WIDTH The WIDTH command changes the display width on certain Hewlett-Packard terminals to either 80 or 132 columns. The command will only work on Hewlett-Packard terminals that support this line width. All other terminals will ignore this command. The WIDE option is reset when the program terminates or following the completion of a subsequent VIEW command that specifies WIDE. WIDTH Syntax O> WIDTH {WIDE } {NARROW} User Tip. This command may be abbreviated to W.
C H A P T E R 4 NBSpool Input Commands NBSpool provides a set of valid input commands that can be utilized to control input spool files. This chapter describes each input command, with information on the operation, syntax and parameters for each command. Examples are also provided. Review the “Command Summary” section for a brief overview of the input commands covered in this chapter. The NBSpool input commands appear in alphabetical order in this chapter.
Chapter 4 Command Summary This section summarizes the available NBSpool input commands. The input commands are listed in alphabetical order. Command Function I>ALTER This command changes local job characteristics such as INPRI and OUTDEV. I>COPY This command copies jobs from one computer to another. I>EXIT This command exits NBSpool. This command suspends NBSpool if it is running as a son process from another program. I>HELP This command provides online help on NBSpool commands for current mode.
NBSpool Input Commands Command Function I>SHOW This command displays a subset of the local jobs. I>SORT This command specifies sort criteria to be used whenever a list of jobs is displayed. I>START This command starts the background execution of various NBSpool services. Turn to the “START” section in Chapter 3 for more information. I>STOP This command stops the specified background services. Turn to the “STOP” section in Chapter 3 for more information.
Chapter 4 Input Commands The following sections describe the NBSpool input commands in detail. For each command, you will find information on the operation, syntax and parameters. Examples are also provided. The NBSpool input commands appear in alphabetical order. ALTER The ALTER command allows changes to groups of files using local job characteristics such as INPRI and OUTDEV. Each qualifying job will be displayed as it is altered. This command works exactly like the MPE ALTJOB command.
NBSpool Input Commands COPY The COPY command moves an exact copy of a waiting or scheduled job to a remote computer without purging the original jobs. If wild cards are specified, all jobs meeting the specified criteria will be copied to the remote computer. The original copies will not be modified unless the optional NEWPRI parameter is specified to alter the INPRIs of the original jobs upon successful completion of the copy. The correct passwords are inserted in the :JOB command on the remote computer.
Chapter 4 COPY Syntax I> COPY [subset] TO {nodename} [;PRI =outpri {*envname} [;COPIES=copies [;DEV ={class} [ {ldev } [;INPRI =inpri [;NEWPRI=outpri [;ASK [;NOSCHED [;RETRY [;RETRYDELAY=seconds ] ] ] ] ] ] ] ] ] ] User Tip. This command may be abbreviated to CO. COPY Parameters Parameter Description subset This parameter specifies the subset of spool files to be copied. Turn to Chapter 2 for information on working with subsets. nodename This parameter specifies the name of the destination node.
NBSpool Input Commands Parameter Description inpri This parameter specifies the input priority of the job on the remote computer. This parameter must be between 0 and 15. A value of 15 is the same as specifying HIPRI. ASK This parameter prompts at each file for processing. NOSCHED This parameter eliminates all scheduling information when creating the job on the remote computer.
Chapter 4 The COPY command is often used in background jobs to continually copy jobs from one computer to another. If a line or computer goes down, it is often preferable to have NBSpool keep trying to connect until the remote computer comes back up, for example: To copy all jobs with a priority of 2 to 6 to the remote computer VGER every 60 seconds: :JOB COPYJOBS,OPERATOR.SYS : :DSLINE VGER;LOGON=SPXFER,OPERATOR/SECRET.SYS : :RUN NBSPOOL.PUB.
NBSpool Input Commands KEEP The KEEP command copies the currently texted job into a permanent disk file. The new file will not contain any passwords, and all sequence numbers will be stripped off. Turn to the “STREAM” section in this chapter for more information. If a job is in the scheduled state, the first record of the file will contain the scheduling information. The NBSpool STREAM command will use this information when restreaming the job, if desired.
Chapter 4 Parameter Description blkfact This parameter specifies the blocking factor for the new file. If omitted, the optimum blocking factor will be determined. F This parameter indicates that the keep file should have fixed length . V This parameter indicates that the keep file should have variable length records. This is the default. ASCII This parameter indicates that the keep file should be ASCII. This is the default. BINARY This parameter indicates that the keep file should be BINARY.
NBSpool Input Commands LIST The LIST command displays some or all of the job opened by a prior TEXT command. The format of the command closely approximates that of the contributed library program QUAD. Any of the text subcommands in the LIST command may be shortened to as little as one character. For example, FIRST may be abbreviated to F. Each subcommand must be separated by a space. Note. JOB records will have passwords stripped off.
Chapter 4 LIST Parameters Parameter Description range This parameter specifies the range of lines to be displayed. If this parameter is not specified, only one line will be listed (the current line). Range is expressed as one of the following: ALL @ line Selects all lines in the spool file. Selects all lines in the spool file. Line designator. A line is one of the following: line# A positive integer specifying a particular line in the file. The first line in a spool file is line 0.
NBSpool Input Commands Parameter Description VARS When selected, two CI variables (or JCW’s on MPE/V) are created: NBFIRSTLINE and NBLASTLINE. These variables contain the line numbers of the first and last line listed. If nothing is listed, the values will be -1 (or 65535 on MPE/V). string This parameter causes only those lines containing the specified string to be listed. Strings may be delimited by single (‘) or double quotes (“).
Chapter 4 MERGE The MERGE command merges a subset of spool files together to form one new disk file. The order in which the files will be merged is determined by the SORT command. If the output file is a disk file, it will be created if it does not exist. If it does exist, it will be purged unless a file equation is issued with ACC=APPEND. Append access will do just that, append to an existing file. Like the KEEP command, sequencing information and passwords will be stripped out.
NBSpool Input Commands MERGE Parameters Parameter Description subset This parameter specifies the subset of spool files to be merged. Turn to Chapter 2 for information on working with subsets. filename This parameter specifies the name of the file to create. If it exists and is a disk file, the user will be asked to purge it. recsize This parameter specifies the record size for the output file. Negative for bytes. The default is 2044 byte records.
Chapter 4 MOVE The MOVE command is functionally identical to the COPY command with one very important difference; the MOVE command purges the original jobs upon completing the transfer to the remote node. If wild cards are specified, all jobs meeting the specified criteria will be moved to the remote computer. The correct passwords are inserted in the :JOB command on the remote computer. If a job streams another job, imbedded :JOB commands will not be modified to include any appropriate passwords. Note.
NBSpool Input Commands MOVE Syntax I> MOVE [subset] TO {nodename} [;PRI =outpri {*envname} [;COPIES=copies [;DEV ={class} [ {ldev } [;INPRI =inpri [;ASK [;NOSCHED [;RETRY [;RETRYDELAY=seconds ] ] ] ] ] ] ] ] ] User Tip. This command may be abbreviated to MO. MOVE Parameters Parameter Description subset This parameter specifies the subset of spool files to be moved. Turn to Chapter 2 for information on working with subsets. nodename This parameter specifies the name of the destination node.
Chapter 4 Parameter Description ldev This parameter specifies the logical device number used when creating the spool file on the remote computer. This parameter must be a valid spooled output device. inpri This parameter specifies the input priority of the job on the remote computer. This parameter must be between 0 and 15. A value of 15 is the same as specifying HIPRI. ASK This parameter prompts at each file for processing.
NBSpool Input Commands The MOVE command is often used in background jobs to continually move jobs from one computer to another. If a line or computer goes down, it is often preferable to have NBSpool keep trying to connect until the remote computer comes back up. To move all jobs with a priority of 2 to 6 to the remote computer VGER every 60 seconds: :JOB MOVEJOBS,OPERATOR.SYS : :DSLINE VGER;LOGON=SPXFER,OPERATOR/SECRET.SYS : :RUN NBSPOOL.PUB.
Chapter 4 OUTPUT The OUTPUT command changes the operating mode of NBSpool from input spool files (jobs) to output spool files. The prompt will change to show the new mode. If a file is texted when switching modes, it will be closed. In addition, the sorting order will be reset when switching modes. OUTPUT Syntax I> OUTPUT OUTPUT Parameters No parameters exist for the OUTPUT command.
NBSpool Input Commands PURGE The PURGE command purges (aborts) all qualified jobs. The execution of the command may be stopped by pressing Ctrl+y. If this command’s ASK parameter is included, a question will be asked to confirm the purge. This helps to prevent accidentally deleting jobs. The PQ form of this command streamlines the purge operation in that no questions are asked and only one line of output is generated.
Chapter 4 SET The SET command sets run time and configuration options for NBSpool. This command can be used with the INPUTPASS parameter to prevent users from accessing the NBSpool input commands. SET Syntax I> SET {INPUTPASS=[password]} SET Parameters 4-22 Parameter Description INPUTPASS This parameter changes/sets the input mode password. This requires users to enter a password upon the first entry to input mode. Setting the password requires SM capability.
NBSpool Input Commands SHOW The SHOW command provides a listing of a specified job subset. Specifying the STATE parameter allows further selection of jobs by their current state. Omitting the STATE parameter will cause all jobs to be displayed. If a file is currently TEXTed, it will appear with a star (*) in front of the file name. The subset specified in the SHOW command is saved for later reuse if so desired.
Chapter 4 SORT The SORT command allows you to specify the order in which all other commands will display lists of jobs. The default is no sorting. The most minor sort will always be done by device file ID number if any sorting is specified. Using the OFF parameter specifies a return to the default state. The default sorting order is EXEC jobs first, then waiting jobs, then scheduled jobs. SORT Syntax I> SORT {[sortspec][,sortspec][,...
NBSpool Input Commands SORT Parameters Parameter Description sortspec This parameter specifies the order in which all listings will be produced. Sortspec is expressed as one of the following: CREATION DEVICE FILENAME JOB NAME PRI SIZE USER Sort by time it was introduced, or the scheduled execution time. Sort by device class and logical device. Logical devices sort before device classes. Sort by job name (always $STDIN). Sort by job number. Sort by job/session name. Sort by input priority.
Chapter 4 STREAM The STREAM command processes a stream file for password insertion, then streams the jobs. If the file contains scheduling information, those jobs will be streamed with their original scheduling information unless the NOSCHED parameter is specified. Password processing is subject to MPE security restraints. Passwords will be automatically inserted into a job only if the user executing the STREAM command has enough capability to access the passwords through other means.
NBSpool Input Commands STREAM Parameters Parameter Description file This parameter specifies the name of the file to be streamed. This file can be any valid stream file. All passwords in the file will be ignored. char As with the MPE STREAM command, this causes the STREAM command to look for command lines to start with the specified character. NOSCHED This parameter ignores all scheduling information in the file, if it exists.
Chapter 4 TEXT The TEXT command opens a READY or OPENED job for use with the LIST command. When the job is opened, its state will be changed to LOCKED if it is currently READY. If a subset specification qualifies more than one job, the user will be prompted to select one of the qualifying jobs. If no subset is specified, the currently TEXTed job, if any, is closed. TEXT Syntax I> TEXT [subset] User Tip. This command may be abbreviated to T.
NBSpool Input Commands VERIFY The VERIFY command is used to display the current value of the NBSpool configuration options. When you enter the command with an option, the value of that option is returned. VERIFY Syntax I> I> I> I> I> I> I> I> VERIFY VERIFY VERIFY VERIFY VERIFY VERIFY VERIFY VERIFY ABORT MAXPROCS PRIVATE SEARCH SPSAVE SYSTEMLOG USERCAP VAR=[varname];key VERIFY Parameters Parameter Description varname This parameter specifies a 1 to 8 character alphanumeric name of a variable.
Chapter 4 VERIFY Examples The VERIFY command is used to display the current value of the NBSpool configuration options. When you enter the command with an option, the value of that option is returned.
NBSpool Input Commands VIEW The VIEW command allows a set of jobs to be displayed one after another on the terminal. After a job is completely listed or after pressing Ctrl+y, the user will be prompted with one of the following messages: * Alter, Next, Purge, or Relist? * Next, Purge, or Relist? * Hit RETURN to continue or EXIT to stop: The first question is asked if any of the ALTER-like parameters are specified. The second question is asked if no ALTER parameters are used.
Chapter 4 VIEW Parameters 4-32 Parameter Description subset This parameter specifies the subset of spool files to be viewed. Turn to Chapter 2 for information on working with subsets. inpri This parameter specifies the new input priority that will be assigned to all jobs qualified by the subset parameter. Must be an integer from 1 to 14. class This parameter specifies the new device class assigned to all qualified jobs. Must be a valid spooled device class.
NBSpool Input Commands WHILE Like the XEQ command, the WHILE command allows you to repeatedly execute a set of commands. Unlike XEQ, the WHILE command executes the series of commands once per qualifying spool file. Once all spool files are processed, the command terminates. The subset is evaluated at the time the WHILE command is entered. Any spool files qualifying at that time will be used. Any files created after the WHILE command is entered will be ignored, whether they meet the subset or not.
Chapter 4 WHILE Parameters Parameter Description subset This parameter specifies the subset of spool files to be passed to the following commands. Turn to Chapter 2 for information on working with subsets. filename This parameter specifies the name of an ASCII file containing one or more NBSpool commands. SHOW This parameter displays each command as they are executed. By default, only commands that fail are displayed.
NBSpool Input Commands WIDTH The WIDTH command changes the display width to either 80 or 132 columns. The command will only work on Hewlett-Packard terminals that support this line width. All other terminals will ignore this command. The WIDE option is reset when the program terminates or following the completion of a subsequent command that specifies WIDE. VIEW WIDTH Syntax I> WIDTH {WIDE } {NARROW} User Tip. This command may be abbreviated to W.
C H A P T E R 5 Background Processing NBSpool’s background processing capability is another, very powerful feature of this product. Certain commands or groups of commands may be executed repetitively as a background task. Background processing is available through two methods a background job that invokes NBSpool and its XEQ command, or SPOOLCMD files that contain NBSpool commands to operate on spool files based on their device class. The first part of this chapter addresses background jobs.
Chapter 5 Overview NBSpool background jobs may contain several different components: • • • JCWs to modify NBSpool’s behavior (For a list of available JCWs, turn to the “JCWs for Network Printing” section in Chapter 7.) RUN NBSPOOL.PUB.
Background Processing XEQ Command File The XEQ command will execute a list of commands from a command file. When the XEQ command is executed, NBSpool first parses all the commands in the command file. If any command is not valid, the entire XEQ command is terminated. As each command is parsed, it will be displayed with a special X> prompt. Continuation lines are valid up to 254 characters. The command file contains the commands to be executed, one command to a line.
Chapter 5 Background Execution More than one XEQ command can be executed simultaneously in one job or session by using the XEQ…;BACKGROUND option. This option starts a son process, and executes in the background. Each son process has its option routed to a spool file named XEQOUTn, where n is a number from 1 to 8 of the process in question. All output from the son processes is directed to one of these files. To increase the maximum number of processes, use the NBSpool SET command.
Background Processing Background Jobs With XEQ This section discusses background jobs that invoke NBSpool and its XEQ command. The NBSpool commands that are used in the background job are XEQ, XEQSTOP, END, ERROR and WHILE. XEQ Command The XEQ command causes a file of commands to be executed either once or repetitively. The major use of this command is to execute various NBSpool functions as a background task. This command can be issued from either INPUT or OUTPUT command modes.
Chapter 5 XEQ Parameters 5-6 Parameter Description filename This parameter specifies the name of the file that contains the commands to be executed. If omitted, the commands will come from $STDIN. The format of the command file is described in the beginning of this section. count This parameter specifies the number of times to execute the commands. The default is 1 unless a WAIT= parameter is specified, in which case the default is repeat forever.
Background Processing XEQ Examples The file MOVECMDS.SPOOL is an ASCII file containing a number of MOVE commands. To repeat these MOVE commands every 20 seconds, enter: O> XEQ MOVECMDS.SPOOL;WAIT=20 To execute the same file only once and to show the commands as they occur, enter: O> XEQ MOVECMDS.SPOOL;SHOW To enter a list of commands that should be repeated 100 times every 60 seconds (the default wait time), enter: O> XEQ;REPEAT=100 Notes By default, XEQOUTn processes have a priority of 1.
Chapter 5 XEQSTOP Command The XEQSTOP command is used to stop an executing NBSpool background process. An NBSpool process is one which is executing an XEQ command with either a repeat or wait option. The process number is assigned when the process is first started, and is displayed in the $STDLIST and on the console. The XEQSTOP command takes effect when the executing process reaches the end of its list of commands to execute. Note. This command requires SM or OP capability.
Background Processing END Command The END command terminates the parsing phase of the XEQ command and ignores any additional records in the file. This command is only needed if the commands are being entered from $STDIN. END Syntax X> END END Parameters No parameters exist for the END command.
Chapter 5 ERROR Command By default, if a command in the command list should fail, execution of the XEQ command terminates immediately. However, with the ERROR command this action can be altered a number of ways. NBSpool can be directed to either abort, ignore the error or execute the file up to the command that caused the error. Unlike the MPE command :CONTINUE, once an ERROR command is encountered it stays in effect until another ERROR command is found or the end of the XEQ list is reached.
Background Processing The command file may then be executed with a wait time specified to operate continuously: O> XEQ COPYSTD.SPOOL;WAIT=120 The following background job operates once a minute, moving spool files with output priorities between 8 and 14 to another machine. !JOB MOVEJOB,OPERATOR.SYS ! !DSLINE ENGINE;LOGON=SPXFER,OPERATOR/SECRET.SYS ! !RUN NBSPOOL.PUB.
Chapter 5 WHILE Command Like the XEQ command, the WHILE command allows the user to repeatedly execute a set of commands. Unlike XEQ, the WHILE command executes the series of commands once per spool file qualifying. Once all spool files are processed, the command terminates. Note. Do not attempt to execute the XEQ command from the WHILE command. The subset is evaluated at the time the WHILE command is entered. Any spool files qualifying at that time will be used.
Background Processing WHILE Parameters Parameter Description subset This parameter specifies the subset of spool files to be passed to the following commands. Turn to Chapter 2 for information on working with subsets. filename This parameter specifies the name of an ASCII file containing one or more NBSpool commands. SHOW This parameters displays each command as they are executed. By default, only commands that fail are echoed.
Chapter 5 This section is a step by step explanation of the previous example: 1) The XEQ loop contains a WHILE block that will run with a 60 second delay between executions. 2) The WHILE command selects $STSLISTs that are in the READY state at a priority of 8. This should match exactly all newly completed $STDLIST spoolfiles. 3) For each spoolfile that the WHILE command selects, it will execute the following commands (up to the next END command).
Background Processing Tips on Writing Background Jobs This section provides some tips on writing background jobs. These tips include information on choosing a value for the ;WAIT= parameter and avoiding faulty logic in XEQ loops.
Chapter 5 The reason that a spoolfile could get printed (altered to pri=13) without a banner added is that each command in the XEQ loop executes independently. The BANNER command will seek out all spoolfiles owned by MGR.PROD (it only operates on READY spoolfiles) and add a banner to them. The ALTER command changes the priority on all spoolfiles created by MGR.PROD to 13.
Background Processing Example The following example shows a background job that has multiple XEQs and WHILE loops within a single job: !JOB NBSPOOL,MGR.NETBASE ! !RUN NBSPOOL.PUB.
Chapter 5 Background Processing With SPOOLCMD Files This section discusses background processing with SPOOLCMD files, which contain NBSpool commands to operate on spool files based on their device class. The NBSpool command that is used in this background processing is the SPOOLER command. SPOOLER Command The SPOOLER command controls the execution of background NBSpool spooler processes.
Background Processing SPOOLER Parameters Parameter Description spoolname Name of the spooler command file. This file must exist in the SPOOLCMD.NETBASE group. It consists of a list of commands, normally with an XEQ command, that will be executed by the background spooler process. This file will be used as the $STDIN for the NBSPOOL process. If the STOP command is used, a name of @ will stop all spoolers. START This parameter causes the specified NBSpool spooler process to be started.
Chapter 5 Below is a sample job that can be used to start the spooler control process and the individual spooler command files: !JOB NBSPJOB,MGR.NETBASE !RUN NBSPOOL.PUB.NETBASE START SPOOLING SPOOLER MYLJ;START EXIT !EOJ Notes 5-20 • Altering a spool file with MPE/iX’s SPOOLF or ALTSPOOLFILE, will not trigger the background process. The NBSPOOL ALTER command triggers the background process. • Command files created in SPOOLCMD.NETBASE must be kept unnumbered.
C H A P T E R 6 Banner Maintenance The BANNER command is used to add banners to spool files. However, this command requires the existence of a banner database. The layouts for the banners, the spooler devices, reports and distribution lists are defined in the database. The banner maintenance program, BANMAIN, maintains the banner database.
Chapter 6 Background Processing With SPOOLCMD Files The BANNER database is created as part of the NBSpool installation process with some default entries so that any file can be bannerized without running BANMAIN. When using BANMAIN for the first time, check the following notes: • The banner page may include information about the spool file, the distribution, or the device. Turn to the “Banner Page” section in this chapter for a detailed description of the banner page.
Banner Maintenance Running Banner Maintenance Reports are defined using a file name, job name, user name, account and device name. When the BANNER command is issued, the banner function uses the spool file name, session name, user name account and device name. These are from the spool file that is specified to find a match in the reports defined in the banner database. If a match is not found, the command displays an error message.
Chapter 6 Report Search Logic The Report Maintenance screen attaches printing and layout information to a specific report or set of reports. For flexibility, the report name can be defined by its filename, job name, user name, account name or device name. Use the @ sign for any part of the report name that is undefined, for example: GLDLRPT.GENLEDG.GLUSER.PROD.LP GLDLRPT.GENLEDG.@.@.@ GLDLRPT.@.@.@.@ @.GENLEDG.GLUSER.PROD.
Banner Maintenance The templates are used in series. If the templates are defined as above, and the name of the report specified in the BANNER command is GLDLRPT.JOHN.MGR.PROD.LP, then: 1. First, the banner function searches the database for a report named GLDLRPT.JOHN.MGR.PROD.LP. 2. Second (if the above name is not found), it searches for GLDLRPT.@.MGR.PROD.@. 3. Third (if the above name is not found), it searches for GLDLRPT.@.@.@.@. 4. Fourth (if the above name is not found), it searches for @.@.
Chapter 6 Banner Page The banner page is divided into two parts. The banner header is printed at the top in large scale print. A detail area is printed at the bottom. The detail area includes the spool file and distribution information. The banner header is four lines of text printed in a large scale font. The information that is printed in the header is variable and may be defined at the time the banner is printed. This is accomplished with control words.
Banner Maintenance For instance, a banner may be defined as follows: BIN: bin NAME: distname FILE: filename beginend Then, if the banner is printed for file GLREPORT, and this copy of the report is to be distributed to John Stuart at bin location LU 234, the banner header will be printed: BIN: LU 234 NAME: JOHN STUART FILE: GLREPORT /*BEGIN*/ The banner function uses one of two large fonts for the header.
Chapter 6 The banner header and the detail information are printed on the banner page in the following format: [Control 1] [Form feed 1] [Banner line 1] [Banner line 2] [Banner line 3] [Banner line 4] [Date Stamp] *************************************************************************** * BIN NAME DEPT PHONE * [Message 1] * * -------- ------------------------------- ------ ---------- * [Message 2] * * [Distribution 1] * [Message 3] * * [Next distribution] * [Message 4] * * .
Banner Maintenance The following table provides descriptions of the fields in the banner page. Field Description Control 1 This is an optional device control string that may be defined for a particular spool device. The control string will only be printed if the spool device is defined in the banner database, and a control string is defined for that device. Form feed 1 A form feed that may be sent to the printer before the trailer banner page.
Chapter 6 Field Description Last distribution listed If the banner is printed with the SINGLE option, the banner function attempts to print the entire distribution list. One of the parameters in the Banner Control Information screen determines the number of banner pages. If the distribution list cannot fit on one page, and the number of banner pages is greater than one, the list will be completed on the next page. Creator The creator information, printed in the following format: Creator: name.
Banner Maintenance Distribution List A feature of NBSpool’s banner function is the ability to attach a distribution list to a report. The distribution list is a list of people who will receive a copy of the report. For each person in the list, the program allows you to enter a department, phone number and bin location. The device information can also be specified for different distributions.
Chapter 6 Banner Maintenance Program The main screen in the banner maintenance program is shown in the illustration below. From this screen the user can enter screens to modify Banner Control Information, define spool devices for reports, define the banner layouts for reports and make distribution lists for reports. ____________________________________________________________________________ s.VV QUEST Banner Maintenance Program 1. Banner Control Information 2. Define Devices 3. Define Banners 4.
Banner Maintenance The following table provides descriptions of the fields in the Banner Maintenance Program screen. Field Description Option The option field is used to enter a banner maintenance screen or to exit the program. Any command that is valid in this field may be abbreviated to the first character.
Chapter 6 Banner Control Information Screen The Banner Control Information screen is shown in the illustration below. The Banner Control Information screen is used for entering company information, the report search logic, a default message, a default banner header and a number of banner controls.
Banner Maintenance The following table provides descriptions of the fields in the Banner Control Information screen. Field Description 1) Name The company name 2) Address The company address-this field is optional Zip The company zip code-this field is optional 3) Message This is the default detail area message. This is a five line message that is printed in the detail area of the banner page. The message also may be defined for individual reports. 4) Banner The default banner header.
Chapter 6 Field Description 10) Suppress creator If Y, suppress the printing of the creator name and job number in the detail area. 11) Float detail area If Y, the detail area will be printed immediately following the last non-blank banner line. This overrides the usual banner format where the detail area is printed at the bottom of the page. Option 12) Banner format 6-16 The option field is used to modify the information described in this screen.
Banner Maintenance Define Devices Screen The Define Devices screen is shown in the illustration below. This screen is used to define the spool devices used for the reports.
Chapter 6 The following table provides descriptions of the fields in the Define Devices screen. Field Description Device The device class name of a spool device. This is the key for the device set. Enter E or EXIT to exit this screen. To list all devices to the screen enter *. Each device will be displayed and the user will be prompted to modify this device or list the next device. 1) Description The device description-this field is optional 2) Lines Per Page This is the number of lines per page.
Banner Maintenance Field Option Description The option field is used to modify the information described in this screen. Any command that is valid in this field may be abbreviated to the first character. The valid values are: Modify field #nn. Modify all fields. ALL DELETE Delete this device class definition. Update this device and exit this screen. EXIT Update this device and prompt for a new device. // Clear the screen, prompt for a new device name.
Chapter 6 Define Banners Screen The Define Banners screen is shown in the illustration below. This screen is used to define the banner layouts used for the reports. Note. The default banner opens from the Banner Control Information screen and is named SYSTEM.
Banner Maintenance The following table provides descriptions of the fields in the Define Banners screen. Field Description Banner Name An eight character name used to identify this banner layout. The banner name is used to attach a banner layout to a report, or to define the default banner layout in the Banner Control Information screen. To list all banner layouts to the screen enter *. Each banner will be displayed and the user will be prompted to modify this banner or list the next banner.
Chapter 6 Field Description Option The option field is used to modify the information described in this screen. Any command that is valid in this field may be abbreviated to the first character. The valid values for this field are: Modify field #nn. Modify all fields. Delete this banner layout definition. Update this banner and exit the screen. Update this banner and prompt for a new banner. Clear the screen, prompt for a new banner name.
Banner Maintenance Report Maintenance Screen The Report Maintenance screen is shown in the illustration below. This screen is used to define the banner and distribution list for a report. If a field has defaults, the default value is displayed. The default values are explained in the detail information for the fields.
Chapter 6 Field Description 1) Desc The report description. This field is optional. 2) Message A five line message that is printed in the detail area of the banner page. If no entry is made in this field, BANMAIN will display the default. The default detail message is defined in the Banner Control Information screen. 3) Device The spool device used for this report. If this field is not entered, the device will be determined by NBSpool. Enter * to select from the defined devices.
Banner Maintenance Field 9) Description Truncate Distribution List 10) Distribution List Option If the value of this field is Y, the Distribution List will be truncated to one page. Display the Distribution List screen. This screen is used to enter and modify a distribution list for this report. The option field is used to modify the information described in this screen. Any command that is valid in this field may be abbreviated to the first character.
Chapter 6 Name Maintenance Screen The Name Maintenance screen is shown in the illustration below. This screen maintains the default values for a name used in a distribution. Every name used in a distribution list has a default set of values for the department, phone number, device, bin and node. This screen is used to modify the default values. The screen also lists the entry for the name in all distribution lists that includes the name.
Banner Maintenance The Maintain Distribution by Name screen is shown in the illustration below. This is the Name Maintenance screen as it appears for the full listing of the reports. Notice that although either screen may be used for listing the reports, only the following screen is used when the name associated with a report is modified.
Chapter 6 Field Description 3) Device The default device for the name. If a device is entered in this field, the number of copies and the output priority for the device are displayed to the right. These are the default number of copies and output priority for the name in a distribution list. Enter * to display and choose from all defined devices. 4) Bin The default bin for the name 5) Node This is the default node for the name. The node name as it appears in the NetBase configuration is displayed.
Banner Maintenance Field Description Dev/Node Dev is the device for the distribution name when receiving this spool file. When listed, if this field is blank then the device is same as the default. Node is the node for the distribution name when receiving this spool file. When listed, if this field is blank then the node is same as the default. Enter * to display and choose from all defined devices or nodes. #Cp The number of copies of this spool file to be created for this name.
Chapter 6 Field Description Option The option field is used to modify the information described in this screen. Any command that is valid in this field may be abbreviated to the first character. However, only DELETE may be used to delete the name. These valid options apply to the distribution name: 1 2 3 4 5 ALL DELETE EXIT // Modify the default department. Modify the default phone number. Modify the default device. Modify the default bin. Modify the default node. Modify all defaults for this name.
Banner Maintenance Define Distribution Lists Screen The Define Distribution Lists screen is shown in the illustration below. This screen is used to enter a distribution list for a report. Turn to the “Distribution List” section in this chapter for more information.
Chapter 6 Field Description Dev/Node Dev is the device used for this distribution. If no entry is made in this field, and a device is defined for the report, the device for the report will be displayed in this field. Node is the node for this distribution. The node must be a valid NetBase node name or number. Enter * display and choose from all defined devices or nodes. #Cp The number of copies of the report for this distribution.
Banner Maintenance Banner Configuration Reports The Banner Configuration Reports screen is shown in the illustration below. This screen provides reports on different aspects of the BANNER database. Selecting one of the options on this screen causes BANMAIN to stream a job that reads the BANNER database and produces a report. The job number is printed in the message window at the bottom of the screen. The report filename is BANREP0#, where # is replaced by the option number of the report.
C H A P T E R 7 Troubleshooting NBSpool This chapter provides NBSpool troubleshooting information. The list of the error messages includes explanations of the messages and also actions to take. If the explanation for an error message indicates that you should contact Quest Technical Support, please note the error message number and the version of the software you are running.
Chapter 7 JCWs for Network Printing NBSpool supports numerous JCWs for modifying the way NBSpool runs. These JCWs must be set prior to running NBSpool (above the RUN statement in the background job). 7-2 JCW Description spoolackfreq=1 By default, NBSpool sends an acknowledgement to the printer after every 5 packets. Setting this JCW forces NBSpool to send an acknowledgement after every packet. spoolpacket=1024 By default, NBSpool sends 8096 byte packets.
Troubleshooting NBSpool Error Messages The following NBSpool error messages are listed in alphabetical order. Some error messages require that you contact Quest Technical Support for correction. If you encounter a message that is not listed here, please contact Quest Technical Support. Make sure that you note the error message, any details included in the message, and also the version of NBSpool that you are running. A few of the following error messages have some similarities.
Chapter 7 7-4 Error Message Explanation/Action #THE GATEWAY IS AT CAPACITY OR THE GATEWAY SOFTWARE IS NOT RUNNING Ask your network administrator to verify that the Gateway software is running. If it is, its number of connections may need to be increased. *2 $BACK IS NOT SUPPORTED You may not specify the MPE BACK command within NBSpool. *2 47UNABLE TO WRITE ON REMOTE NBSpool cannot write a file to the remote.
Troubleshooting NBSpool Error Message Explanation/Action CANNOT KEEP SPOOL FILE IN THE “OPENED” STATE The spoolfile you have attempted to KEEP is currently OPEN. You may not KEEP any portion of an OPEN spool file. *2 CANNOT OPEN DISK FILE See the FSERR message for more information. CANNOT OPEN NETWARE QUEUE The network is not responding to NBSpool. NBSpool cannot perform the trans-network function requested until the network responds.
Chapter 7 Error Message Explanation/Action DATE RANGE IS BACKWARDS The date range you entered has a later date listed as the first element of the range, rather than as the second. Correct, and execute the command. *2 DESTINATION PRINTER NOT DEFINED While moving or copying a spool file to a UNIX destination, the printer specified on ;DEST= does not exist on the UNIX system. DFID entered is not in the selected subset The spool file you have specified is not within the subset you selected.
Troubleshooting NBSpool Error Message Explanation/Action EXPECTED “INTRO”, “SCHED”, “WAIT”, “EXEC”, OR “SUSP” You did not specify a valid state. Re-enter. *2 EXPECTED “PASS” NBSpool expected a password specified with the appropriate syntax. *2 EXPECTED “PREV” OR ANOTHER PREDEFINED VARIABLE You must SET variables prior to invoking them. Turn to the “Variable Substitution” section in Chapter 2 for more information.
Chapter 7 7-8 Error Message Explanation/Action EXPECTED A VALUE FOR NUMBER OF SECTORS The value you entered was illogical for number of sectors. Re-enter your value. *2 EXPECTED AN INTEGER BETWEEN 1 AND 9999, “@”, OR “SPOOK” You entered a value NBSpool did not anticipate. Re-enter, according to the options listed. *2 EXPECTED ONE OR MORE SORT SPECIFICATION The syntax you entered lacked a sort specification. Verify your syntax, add a sort option, and execute.
Troubleshooting NBSpool Error Message Explanation/Action INVALID DATE SPECIFIED The date you entered was not in mm/dd/yy format, or it was not for a valid date. *2 INVALID DELIMITER You have used an invalid delimiter. Correct and execute. *2 INVALID DEVICE CLASS or LDEV SPECIFIED The device class or LDEV you specified does not exist. Verify and re-enter.
Chapter 7 7-10 Error Message Explanation/Action INVALID NETBASE TAPE LABEL The tape you loaded has an invalid NetBase label. Without a valid NetBase label, you may not use NBSpool to access its files. INVALID NETWARE QUEUE NAME Ask your network adminstrator to correct the queue name. *2 INVALID NETWARE SERVER NAME NBSpool has detected an invalid NetWare server name. Ask your network administrator to correct the issue. *2 INVALID NODE NUMBER SPECIFIED The node number you specified does not exist.
Troubleshooting NBSpool Error Message Explanation/Action INVALID SUBSET KEYWORD SPECIFIED The keyword you specified for a subset does not exist. *2 INVALID USE OF “NOT” DESIGNATOR The NOT designator (~) should be applied to further limit a subset. For example, file=A*,~AR. Specifying file=A*,~R* would be invalid. Correct your syntax and re-execute. *2 INVALID USE OF LINE RANGE DESIGNATOR You may not specify a line range at this point in the command, or possibly with this command.
Chapter 7 Error Message Explanation/Action MISSING “TO node” SPECIFICATION You must specify the node to which you want this spool file to go. *2 MISSING FILE NAME You must specify a filename with this command. *2 MISSING NBSPOOL CONFIGURATION FILE ! NBSpool cannot locate the configuration file. Restore it from tape, or contact Quest Technical Support to transfer one to you. *2 MISSING NETBASE TAPE LABEL The tape you loaded does not have a NetBase label.
Troubleshooting NBSpool Error Message Explanation/Action NFS/iX IS NOT INSTALLED ON THIS SYSTEM Without NFS/iX on your system, this command will not work. Contact your Quest Sales Representative for more information. *2 NO CLOSING QUOTE FOUND FOR STRING You began a string specification with a quotation mark, but you omitted the closing one. Correct, and execute. *2 NO FILES FOUND IN SPECIFIED FILE SET The fileset you specified does not contain any files.
Chapter 7 7-14 Error Message Explanation/Action NOT LOGGED ON AND NO LOGON SPECIFIED WITH DSLINE COMMAND You may not access a remote environment without first establishing communication and logging on, or specifying a valid ;LOGON= on the DSLINE command. *2 NOT VALID FOR INPUT FILES The command you specified is not valid for INPUT files. You may have reviewed the OUTPUT version of the command rather than the INPUT one. Use HELP Icommand to view the INPUT version of the help for this command.
Troubleshooting NBSpool Error Message Explanation/Action RANGE NOT SPECIFIED You did not specify a range. *2 RECORD SIZE MUST NOT BE GREATER THAN 1024 BYTES You specified a record size that exceeds 1024 bytes. Please modify. *2 REEL IS NOT A MEMBER OF THE CURRENT SET The tape you loaded does not belong to the store set. Locate and load the proper tape. REMOTE SESSION IS RUNNING A PROGRAM The remote session you have attempted to access is busy running a program.
Chapter 7 7-16 Error Message Explanation/Action SPOOL FILE HAS BEEN PURGED The spool file you have specified has been purged. Please verify, and re-enter. *2 SPOOL FILE IS EMPTY You may not view an empty spool file. SPOOL FILE NOT ALTERED The spool file you specified was not altered. The values which were to be changed may have been equal to the new values, so no modification was necessary. SPOOL FILE NOT PURGED The spool file you specified was not purged, due to an error.
Troubleshooting NBSpool Error Message Explanation/Action THIS COMMAND DOES NOT SUPPORT STRING SUBSETS You attempted to specify a string subset for a command which does not operate with them. *2 THIS COMMAND IS NOT ALLOWED IN AN XEQ FILE The command you have specified in an XEQ file cannot be performed (in an XEQ file). *2 THIS COMMAND IS NOT AVAILABLE IN INPUT MODE You may not use this command during INPUT mode.
Chapter 7 7-18 Error Message Explanation/Action THIS PARAMETER IS NOT APPLICABLE IN OUTPUT MODE You may not specify this parameter during OUTPUT mode. Review the HELP output command for valid parameters in the OUTPUT mode. *2 THIS PARAMETER IS NOT VALID FOR GATEWAY DESTINATIONS You may not specify this parameter when using Gateway destinations.
Troubleshooting NBSpool Error Message Explanation/Action TOO MANY PARAMETERS SPECIFIED You specified too many parameters for this command. *2 UNABLE TO ACCESS REMOTE NODE NBSpool cannot access the remote node as necessary for this command. Ask the network coordinator to research this problem. *2 UNABLE TO ACCESS REMOTE PROGRAM “!” NBSpool cannot access the remote copy of the program you have specified.
Chapter 7 7-20 Error Message Explanation/Action UNEXPECTED ADDITIONAL PARAMETERS You specified unnecessary parameters which cannot be executed. *2 UNEXPECTED PARAMETERS AFTER NODE NAME The parameters you specified after the node name are inappropriate for this command, or they must precede the node name specification. *2 UNEXPECTED RESPONSE FROM REMOTE: !! The remote computer is not behaving normally. Ask you network operator to investigate.
Troubleshooting NBSpool Error Message Explanation/Action WARNING: HELP command failed with error ! NBSpool had difficulty performing your HELP command. Verify your syntax, and re-enter. WARNING: IGNORING SPECIFIED BLOCKING FACTOR Block size exceeds 16284 bytes, and it will be reduced. WARNING: INVALID INTERNAL EOF IN ARCHIVE - SOME DATA MAY BE LOST The archive file is corrupt. Retrieve as much data as possible.
A P P E N D I X A Index A B ABORT ........................................................ 5-10 Addendums ....................................................... v Administrative commands HELP command.......................................... 2-2 LISTREDO command................................. 2-3 REDO command......................................... 2-3 START command....................................... 2-3 STOP command.......................................... 2-3 ALTER input command Overview ...
Appendix A BROWSE output command Examples.................................................. 3-19 Overview .................................................. 3-18 Parameters................................................ 3-19 Syntax ...................................................... 3-18 C Command redirection ................................... 2-19 Commands that support ............................ 2-19 Examples.................................................. 2-20 Commands Administrative commands ...
Index H L Help command Examples.................................................... 2-2 Overview .................................................... 2-2 Syntax ........................................................ 2-2 HP 3000 destination Parameters................................................ 3-48 Syntax ...................................................... 3-48 LAN printer destination Parameters ................................................3-56 Syntax .........................................
Appendix A MOVE input command Examples.................................................. 4-18 NEWPRI parameter.................................. 4-19 Overview .................................................. 4-16 Parameters................................................ 4-17 SM capability ........................................... 4-16 Syntax ...................................................... 4-17 Troubleshooting........................................ 4-16 MOVE output command Examples..............
Index PRINT ...................................................... 3-66 Running Printdef ...................................... 3-66 PURGE input command Overview .................................................. 4-21 Parameters................................................ 4-21 Syntax ...................................................... 4-21 PURGE output command Examples.................................................. 3-75 Overview .................................................. 3-74 Parameters...
Appendix A SPOOLER output command Examples.................................................. 5-19 Overview .................................................. 5-18 Parameters................................................ 5-19 Syntax ...................................................... 5-18 SPSAVE.............................................. 3-46, 3-84 START command Overview .................................................. 3-90 Parameters................................................ 3-90 Syntax ....
Index Variables CURR....................................................... 2-15 JCW variables........................................... 2-14 Lookup ..................................................... 2-17 LPP value ................................................. 2-15 MPE/iX variables...................................... 2-14 Predefined................................................. 2-15 Set by NBSpool......................................... 2-15 SETJCW command...................................
