DSQMover

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.

Introduction

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:

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).


What's New


Notes

  1. 1. DSQMover is for NetWare 4 only. If you need the same capability for a bindery-based environment, please contact is about QMover; the latest version is QMover v1.2.

  2. DSQMover was developed using Client32 for DOS/Windows. It has been tested in DOS boxes under Win95 or WinNT, and it has been tested to function correctly with VLM.

  3. The full NDS path name for the print queue names must be given. e.g. print_queue.org_unit.org. It is fine to use typeless naming, and the leading period is not required (to indicate relative from [Root]).

  4. The total length of the print queue name can be no more than 255 characters (limit of NDS names).

  5. You must have a (licensed) connection to each of the servers where the print queues are located.
  6. Testing has been done with NetWare 4.10, 4.11, and NetWare 5. However, we don't expect any problems with previous versions of NetWare 4.

  7. 7. Do not specify the same queue as both the source and target queues. Strange things may happen to your workstation <g>. DSQMover checks for that.

  8. The moved job will retain the original banner page information but the job owner will become that of the user doing the move.

  9. Wild card in the -N option is not currently supported.

  10. Only the first job matching the -N option will be processed. If you have multiple jobs with the same name, you need to run DSQMover multiple times.

  11. The -N option expects a filename, therefore, it is limited to 12 chars long.

  12. The -W option expects the DateTime information in the form of YYMMDDHHMMSS. If you use the "wildcard" option on the date, the date portion will default to the same date the job was submitted. For example, if the job was submitted on Feb 12, 1997 at 13:45:00. Using "-W ......202020" will set the new job to be available for service on Feb 12, 1997 at 20:20:20. If you specified "-W ......080808", the same job will be available for service right away as the time is set to Feb 12, 1997 at 08:08:08. Similarly, if you use the "wildcard" option in the time field, the time portion will default to the same time the job was submitted.

  13. Because DSQMover does not access the source print queue as a print server, therefore, if the job is not ready for service (such as the client generating the job hasn't finished printing by doing an end capture), you will receive a sharing violation error. DSQMover is designed to move jobs that are ready for service.

  14. The -F parameter will override the -T parameter setting.


Installation

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:

  1. Log into your NDS tree as Admin or equivalent.

  2. 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.

  3. 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.

  4. 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.


Usage

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

The options and names are not case sensitive. Not all options are available in the evaluation version of DSQMover.

Example

  1. 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
  2. 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
  3. 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 *
  4. 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
  5. 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
  6. 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
  7. 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.


Configuration

n/a


Registration

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:

  1. Does not perform cross-server job moving.
  2. Does not support the -Q option.
  3. Does not support the -W option.
  4. Does not support the -N option.
  5. Does not support the -K option.
  6. 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.


Other Information

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.


Revision History