BRIGHTWORK DEVELOPMENT, INC. Complimentary PS-User Selection Software User Guide Like the other components of PS-Print, PS-User (PSU) integrates into Netware seamlessly. By bringing the database created by the Netware utility, PRINTCON, to users' fingertips via pop-up windows, the process of accessing shared printers is made as effortless as possible. The software on this diskette is fully functional and may be copied and distributed without obligation. What is PS-User? PS-User is a submodule of PS-Print, Brightwork's LAN utility software for sharing printers on a network. PSU enables a user to direct printer output to any printer on a Novell NetWare 2.1 network without exiting the application they are working in. In addition, a special hot-key feature will pop-up a print option window wherever you are in your program. In essence, PSU executes CAPTURE and ENDCAP commands for you from within the application. Since PSU finds the printer configuration of each work- station user from the PRINTCON database, each user must first run PRINTCON to establish a print job database, or a central database must be distributed to all network users. This will set up individuals' specifications for file servers, print queues, form names, etc. So, read on for specifics on how to make the best use of your new complimentary copy of PS-User software . . . and Welcome to the world of NETWORK ENHANCEMENT SOFTWARE -- Once you have used it, we know you will want to make it an integral part of your standard network system. * Brightwork Development, Inc. (800) 552-9876 * -1- Program Execution PSU can be executed from the DOS command line or made memory resident and invoked through the use of hot keys. As a default, the program executes immediately and returns to DOS without installing itself permanently into memory. Upon invocation of PSU, two windows display on the screen. The upper, Device Status, window displays the destination of printing for each LPT. The second, Print Options window displays the printer options which may be selected. If the memory resident option is selected, PSU terminates immediately consuming less than 11k of memory in the process; invocation of the interactive display is deferred until the appropriate key chord is pressed. Command Line Syntax and Options The DOS command line syntax is as follows: PSU [-R [-K=]] [-U=] [-MDA] -R, Terminate and Stay Resident The program will load into memory and then exit back to the DOS command line immediately. To invoke the pop-up program, press the key combination specified in the -K option, or the default () if no -K option was specified. -K=, Pop-Up Key Chord This option is used to specify a combination of keys which must be pressed simultaneously to invoke the program. It is valid only if the -R option is also used. If -K option is omitted when the -R option is specified, the default key chord is . The specification consists of a combination of two or more of the following letters: A (for Alt key) C (for Ctrl key) L (for Left Shift key) R (for Right Shift key) At least two keys must be specified for the option value to be considered valid. Please be aware that you may already be using certain of these combinations with installed software. -2- Use a combination that is unique to your installation. An example of a valid -K option which would tie PSU to the left and right shift keys is, -K=LR. -U=, Alternate User Database Use this option to simplify the administration of the PRINTCON databases. Users who have Open and Read access to the MAIL directory of the specified user will be able to use that user's PRINTCON database instead of their own. This is particularly useful if the chosen user is created expressly for this purpose; no security hole is created in the MAIL system this way. Note: When PSU is invoked directly from memory via its key chord, it normally uses the PRINTCON database of whatever user is currently logged in. This function is disabled when the -U option is used. -MDA, Monochrome Display Adapter This option should be specified if your display is not readable when the pop-up window appears. PSU tries to create a usable attribute palette for every display/ adapter combination of which it is aware, but sometimes one sneaks by it. Including this option results in a high-contrast display palette which should be legible on all monitors. Device Status Window This window contains three status lines, one for each of the LPT devices which may be redirected to the network at any given time. If a status line reads "Set to local device", it means that anything sent to that device will print on the locally attached device, if one exists. Any other text which appears on a status line will be formatted according to the following specification: /[/#] The first field, , denotes the name of the file server to which printing is directed. This field always appears to indicate that its associated print device is redirected to the network. -3- The second field, represents the name of the print queue on the target server into which the print job will be placed when printing commences. This field is displayed when connection to the queue is established, and generally appears simultaneously with the target server name. Under certain circumstances, however, its display might be deferred until the job is actually created. The third field, , is the number which uniquely identifies the print job in its print queue. This number, unlike the printing sequence number of the job, will never change for the life of the job. The job number is displayed when the first byte of the print job is captured, and remains displayed as long as the job is actively being captured; when the capture file is closed this field will disappear. Print Options Window This is the active window when the interactive portion of PSU is invoked. To exit this window press the key. If PSU is memory resident and was invoked via its key chord, you will be returned to the application you were previously executing. You may select a print option by using the , , and keys to position the highlighted bar over the desired selection, and then pressing the key. The Device Status Window will reflect the effect of your selection. If there is a job currently being captured, you will be given the choice of keeping what has already been captured, or throwing it away. The following prompt will appear: C)ancel or Q)ueue current job? Pressing the or keys will result in the retention of whatever print matter has been captured so far; pressing will result in the deletion of the capture file and its associated queue entry. Pressing the key cancels the selection without affecting the capture status whatsoever. To end the capture process for a particular printing device without restarting it, press the key to invoke the End Capture Window. -4- End Capture Window This window allows you to cancel network redirection for any particular print device. If there is a job currently being captured on the selected print device, you are given the option of queuing that job for printing or throwing the job away. Use the and keys to position the highlighted bar to the print device (LPT1, LPT2, or LPT3) which you wish to cancel redirection of; press the key. If there is a job currently being captured, you will be given the choice of keeping what has already been captured, or throwing it away. The following prompt will appear: C)ancel or Q)ueue current job? Pressing the or keys will result in the retention of whatever print matter has been captured so far; pressing will result in the deletion of the capture file and its associated queue entry. In either case, redirection is terminated for that print device. Pressing the key takes you back to the End Capture Window without affecting the capture status of the selected device whatsoever. PSU LOADTIME MESSAGES -K option not specified. Default key chord is . The -R (resident) option has been specified, but no explicit -K option has been set. PSU therefore selects a default key chord of which, when pressed, will invoke the interactive screen. -K option only valid when used with -R option. Since no -R option has been specified, the -K option is inappropriate. -5- -K option value illegal. You tried to use values for -K that are incorrect. The specification consists of a combination of two to all of the following letters: A (for Alt key) C (for Ctrl key) L (for Left Shift key) R (for Right Shift key) Please be aware that you may already be using certain of these combinations with other TSR-type software. Use a combination that is unique to PSU to avoid difficulties. -K option requires at least two different, valid values. At least two valid keys must be specified in the -K option. -U option requires specification. The correct syntax for the -U option is "-U=", where represents the name of the user whose PRINTCON database you wish to use. User specified in -U option does not exist. The which was specified with the -U option does not exist. A valid user on the "primary" file server must be used here. (The "primary" file server is the one which you logged in to; all others are "attachments".) Program is already loaded. PSU has previously been loaded and may not be loaded again. Press the appropriate key chord to invoke the interactive screen. Program loaded. All loadtime tests have been passed and PSU has been loaded permanently into memory. Use the hot keys to invoke the interactive screen. -6- PSU RUNTIME MESSAGES Error opening PRINTCON file PSU reads the PRINTCON database located in the mail directory of the user located on his primary (logged in) file server. This error indicates that either the database does not exist on that file server, or it is locked (by PRINTCON). PSU will not enter the interactive screen until a valid PRINTCON database file is found. No attachment to file server You will receive this error message when you have selected a print option which specifies a target (print) file server to which you are not attached. Insert ATTACH commands in your login script so that you have access to every file server to which you want to print. The attachment used must have Q_USER access rights to all print queues on that server to which you wish to submit jobs. The selected print option is not put into effect. Queue not found The queue specified in the selected print option could not be found on the target file server. The queue has either been deleted or renamed since the last time PRINTCON was executed. Use PRINTCON to specify a valid queue for this print option. The selected print option is not put into effect. Error opening PRINTDEF file PSU uses the PRINTDEF database file located on the target file server for form and device/mode definitions; the file either doesn't exist or is locked. The selected print option is not put into effect. -7- Form not found The form specified in the print option could not be found in the PRINTDEF database on the target file server. Either the form has been deleted or renamed. Use PRINTCON to specify a valid form for this print option. The selected print option is not put into effect. Device not found The device specified in the print option could not be found in the PRINTDEF database on the target file server. Either the device has been deleted or renamed. Use PRINTCON to specify a valid device for this print option. The selected print option is not put into effect. Setup mode not found The printer setup mode specified in the print option could not be found in the PRINTDEF database on the target file server. Either this mode has been deleted or renamed. Use PRINTCON to specify a valid setup mode for this print option. The selected print option is not put into effect. Reset mode not found The printer reset mode, (Re-Initialize), was not found in the PRINTDEF database on the target file server. PRINTDEF does not allow the deletion of this mode, therefore receipt of this error message indicates that the PRINTDEF file may have been damaged. The selected print option is not put into effect. # # # -8-