Version PK-3.02
(Nov 22, 1998)
DISCLAIMER: THIS PRODUCT IS SUPPLIED "AS IS". DREAMLAN DISCLAIMS ALL WARRANTIES, EXPRESSED OR IMPLIED, INCLUDING, WITHOUT LIMITATION, THE WARRANTIES OF MERCHANTABILITY AND OF FITNESS FOR ANY PURPOSE. DREAMLAN ASSUMES NO LIABILITY FOR DAMAGES, DIRECT OR CONSEQUENTIAL, WHICH MAY RESULT FROM THE USE OF THIS PRODUCT. |
DSQMover is a DOS command-line program that allows you, the network administrator or a print queue operator to move (print) jobs from one NetWare queue to another.
Why may you want to use DSQMover? Consider the following:
- Have you ever had the needs to moving jobs from one queue to another because the queue is clogged with other jobs?
- Or the printer is down and the queue is building up?
- Or the queue is held up due to a large job?
- Or simply someone captured to the wrong queue and it will take hours to re-generate that data?
DSQMover can help you solve these problems.
DSQMover v2 added the ability to extract the print job to a file. DSQMover v3 added the ability to move job by position instead of by job id.
If you need a more "automated" version of DSQmover, please contact us about DS-QSS, an NDS version of Queue Shuttle Server. DS-QSS requires a dedicated workstation to move jobs between queues (An NLM version called DSQCopy is available in beta at this time, so if that's your requirement, do let us know).
- DSQMover v3 added the ability to move job by position instead of by job id.
- NetWare 5 certified. (YES Bulletin #44432)
You need to "install" DSQMover on your server(s) only if you are not using an Admin or Admin-Equivalent userid. Use the following steps to set up the userid you will be using DSQMover with:
- Log into your NDS tree as Admin or equivalent.
- Use FILER (or RIGHTS) to give the user that will be using DSQMover RF to all the queue directories. The default queue directory is under SYS:QUEUES. Therefore, you can simply grant RF to SYS:QUEUES.
- Use PCONSOLE to make the user a Queue Operator for the input queues. For example, if you wish the user be able to move jobs from queueLASER_PRINTER_1 to LASER_PRINTER_2, make the user a Queue Operator for LASER_PRINTER_1 and ensure the user is a Queue User for LASER_PRINTER_2.
- If you want to do cross-server job moving, repeat Steps 1-3 for each server. [Multi-server support is only available in the registered version]
DSQMover, like many other NDS-enabled utilities, needs the unicode files. By default, the application looks for the unicode files in the same directory from which it is launched, then from the NLS directory under that directory. If you place DSQMover in a directory other than SYS:PUBLIC and SYS:LOGIN, you need to ensure either the unicode files are in the same directory as DSQMover or have a search map to one of the unicode directories.
DSQMover is a strictly a DOS command line program. It was designed to be "quick and dirty". Therefore, no fancy windowing or point-and-shoot interface are used. A number of command-line switches or parameters are expected:
DSQMOVER -S queue -T queue -J jobnumber [-Help] [-Debug] -Q -F -N name -Keep -W datetime
where
- -S queue. Gives the name of the source print queue name. It must be given in absolute NDS path; it can be typeless. e.g. source_q.ou.o. Alias name can be used.
- -T queue. Gives the name of the target print queue name. It must be given in absolute NDS path; it can be typeless. e.g. target_q.ou.o. Alias name can be used.
- -J # . Gives the print job number to be moved from the source queue. You can find this using PCONSOLE. That is the number listed on the rightmost side of the screen, under the "Job" title. Note that NetWare 4 uses HEX numbers for print job numbers. If you omit this parameter, the first job in the queue will be moved. If you wish to move all the jobs in the queue, use a "*", e.g. -J * . You can also use "#x" to specify a job's position within the queue.
- -N name. Gives the name of the "file" that you printed. You can use this instead of a job number. When you NPRINT a file, for example, the Description field of the print job is set to the name of the file you printed. If you use CAPTURE, the Description field matches the /BANNER switch of the CAPTURE command. By default, CAPTURE uses LPT1 for the /BANNER option (or LPTx, depending on which LPT port you CAPTURE'd).
- -Q. Suppress the copyright banner from DSQMover Useful in a batch file.
- -F. Extracts print job to a file called DSQUEUE.OUT.
- -Keep. Will not delete the print job after it is moved. Therefore, this functions as a "copy".
- -W YYYYMMDDHHMMSS. Allows you to set the date and time for the moved print job to be available for servicing. NOTE that you need to use 4-digits for the year field as it supports Y2K.
The options and names are not case sensitive. Not all options are available in the evaluation version of DSQMover.
Example
- To move job #01A52012 from INPUT (located in OU=Toronto.O=N_America) to LASER_Q (located in OU=Paris.O=Europe), use the following command:
DSQMOVER -S input.toronto.n_america -T laser_q.paris.europe -J 01A52012- To copy the first job from INPUT (located in OU=Toronto.O=N_America) to LASER_Q (located in OU=Paris.O=Europe), use the following command:
DSQMOVER -S input.toronto.n_america -T laser_q.paris.europe -Keep- To move all the jobs from INPUT (located in OU=Toronto.O=N_America) to LASER_Q (located in OU=Paris.O=Europe), use the following command:
DSQMOVER -S input.toronto.n_america -T laser_q.paris.europe -J *- To move the first job from INPUT (located in OU=Toronto.O=N_America) to LASER_Q (located in OU=Paris.O=Europe) that has the Description of AUTO.BAT, use the following command:
DSQMOVER -S input.toronto.n_america -T laser_q.paris.europe -N AUTO.BAT- To extract the first job from INPUT (located in OU=Toronto.O=N_America) to a file, use the following command:
DSQMOVER -S input.toronto.n_america -F- To copy the first job from INPUT (located in OU=Toronto.O=N_America) to a file, use the following command:
DSQMOVER -S input.toronto.n_america -F -KEEP- To move the 5th job from INPUT (located in OU=Toronto.O=N_America) to LASER_Q (located in OU=Paris.O=Europe), use the following command:
DSQMOVER -S input.toronto.n_america -T laser_q.paris.europe -J #5(NOTE that the "#" symbol is required.)It is very important that the absolute and complete NDS print queue name be used.
Advanced Uses
DSQMover makes use of two DOS environment variables: QMOVER4$IN and QMOVER4$OUT. You can use these two DOS variables to set the source and target queues, respectively. After they are set, you no longer need to specify the print queue names for the -S and -T options. This is handy if your print queue names don't change often.
Should you suddendly need to move jobs from or to print queues other than the ones you set in the DOS variables, simply specify the queue name as part of the -S or -T options as illustrated in the examples above. Any parameters specified in the -S or -T overrides the DOS variable settings.
n/a
Two variations of DSQMover are available. The version included here is a Freeware version. You are granted an umlimited usage at no cost. However, you are not allowed to sell or package this utility as part of another software package or service contract. Bottom line: you can not make money using this Freeware version. All standard Freeware limitation applies. You are not to include this utility on any CD-ROMs without permission from DreamLAN Network Consulting Ltd.
The Freeware version has the following limitation:
- Does not perform cross-server job moving.
- Does not support the -Q option.
- Does not support the -W option.
- Does not support the -N option.
- Does not support the -K option.
- There is no technical support for the Freeware version.
Should you find the need to do cross-server job moving, a registered verison is available by registering on-line through the following Web sites:
The NDS tree name is required as it is used to generate a key. The registration cost is $50 US. Canadian registration is $70 CDN plus GST. All other countries, please remit in US funds.
You can also FAX a company Purchase Order or credit card information to +1 (905) 887-3836. Please make sure you either include your tree name information on the FAX or send a follow up email.
The registered version allows you to move jobs from queues residing on one server to queues on a different server and has all command-line options enabled. This will be a NETWORK license, limited to ONE NDS TREE. This license does not allow you include it as part of another software package or service contract. Reseller inquiries welcome. Special site agreements for multiple trees is available.
DSQMover is written in C using Microsoft C compiler and Novell Developer Kit.
Inclusion of this utility on CD-ROMs (except for backup purposes) without permission from DreamLAN Network Consulting Ltd. is expressly prohibited.