
*********  Beta  Version  **********  *********  Beta  Version  **********
*********  Beta  Version  **********  *********  Beta  Version  **********

This program does work with Netware 4.1, but it is still evolving.
Please send bug reports (or suggestions) to Compuserve: 75600, 2274.

I believe, I can also be reached by:
      (Internet)  DARWIN@DART.MHS.COMPUSERVE.COM
      or
      (MHS)       DARWIN@DART   via NHUB

This utility is tested with Netware 4.1.   Not tested with Netware 4.0x.

Do not use this utility after April 1995.  The fully working version
should be available by this time.

Thank You!        Darwin Collins

*********  Beta  Version  **********  *********  Beta  Version  **********
*********  Beta  Version  **********  *********  Beta  Version  **********


Application:    NCAPTURE.EXE   

Display to the network user, a pick list of all allowable network print
queues and print job names, and allow the user to redirect their LPT ports
to the desired choice.   These choices can be saved by the user for later
use.  (ie: Activation upon network login)
Fully compatible with Netware 4.1 's NDS.   Does not use Bindery Emulation.


Purpose:

   . User may make minor changes to their printer port redirection.
   . The user's choices are saved in their personal sys:mail\userid
     subdirectory.
   . The user's printing environment may be automatically activated when the
     user logs into the network.   (The admin places the command
     "NCAPTURE SET" in the login script or batch file.)
   . This utility does not use any 'Bindery Emulation' API calls.
   . The user's settings may be overridden by the administrator placing a
     'master' ncapture.cfg in the sys:public subdirectory.
   . The administrator may disable the ability of the user to modify their
     options for printer redirection.

Workstation Requirements:

   . DOS 5.0 or later.
   . Workstation with at least 460K of available conventional memory.
   . Novell VLM (network requestor) logged into a Netware 4.1 server.
     It must be a NDS (Netware Directory Services) connection.
   . Search drive to sys:public\nls or place the Novell unicode file in
      current subdirectory that the NCAPTURE.EXE is copied too.

Limitations:

   . Expects the full object name to be less than 80 characters.
   . Will display upto 50 print queue / print job names.
   . Requires at least 460K (maybe more) of available conventional memory.
   . Expects 3 redirectable printer ports.

Sample Usage:

   . To automatically enable the individual's preferred printing defaults,
     you will need to execute the NCAPTURE utility in the login script or
     in a batch file that is called by the login script.
     For example, you have copied the NCAPTURE.EXE into the
     sys:public\autoexec subdirectory.
     Normally, at the end of your login script, you would call a batch file
     that would then take you to your network menu system.
     Near the start of the batch file you would place the command:
     \PUBLIC\AUTOEXEC\NCAPTURE SET
     The 'SET' parameter instructs the utility to read the individual/master
     NCAPTURE.CFG file and setup the printer redirection.

   . For the user to access the NCAPTURE utility from the network menu or
     from the DOS prompt, you could simply copy the NCAPTURE.EXE utility
     to a subdirectory that is a 'search drive' or simply in the sys:public
     subdirectory.

Configuration file:

   NCAPTURE.CFG is created by the NCAPTURE.EXE automatically, when the user
   selects 'Save' in the menu.   Use any normal text editor to edit the
   NCAPTURE.CFG file.

   NCAPTURE.EXE will attempt to write the NCAPTURE.CFG file in:
      SYS:PUBLIC              subdirectory.
          This location is used as the 'Master' CFG file.  Whatever is in
          this file, will override the individual user's CFG file.
          You (the administrator) may delete any of the 'nouns' (identifers)
          out of the file, that you do not want to override the individual's
          CFG file.
          Normally, you would only place information for the default printer
          settings, and the NDS containers to search for printer queues.
          You may FLAG the file sys:public\ncapture.cfg as Read-Only, so
          that you do not accidently overwrite it, while logged in as an
          administrator.

      SYS:MAIL\UserObjectID   subdirectory.
          This location is used for the individiual's CFG file.  This file
          has the preferred printer settings and options that will be used
          by NCAPTURE unless it is overwritten by the 'Master' CFG file.


NCAPTURE.CFG nouns:

   ContainersAvailable
      Sample:         Printers.ABC;Finance.NYC.ABC
      Lists all NDS containers (in addition to current) that the utility
      should search in for the print queues and print job names.
      Separate each container name by a semicolon.

   AllowChangeDefault
      Settings are  Y  or  N
      Normal setting is  Y
      Set to Y, to allow the user to change their printing options.
      Set to N, to not allow the user to change their default printing
      options.
      This noun does not effect the selection of Print Queue names or Print
      Job names.

   The nouns that start with the text 'Default' are the settings that will
   be automatically used when a user chooses a print queue.   The 'default'
   settings are not used if the user selects a print job name.

   DefaultNumberOfCopies
      Settings is from 1 to 1000.
      Normal setting is 1.
   DefaultTimeOut
      Setting is the number of seconds for capture timeout.
      Same meaning as 'TimeOut' for CAPTURE.EXE.
   DefaultFormFeed
      Setting is Y or N.
      Set to Y, to send a FormFeed trailing the print job.
      Same meaning as 'FormFeed' for CAPTURE.EXE.
   DefaultAutoEndCap
      Setting is Y or N.
      Same meaning as 'FormFeed' for CAPTURE.EXE.
   DefaultBanner
      Setting is Y or N.
      If set to Y, then the Banner will printed preceding the printjob.
   DefaultBannerName
      If LPTxBanner is set to Y, then it use this noun for the Banner name.
   DefaultBannerText
      If LPTxBanner is set to Y, then it use this noun for the Banner text.

   For each of the below nouns, x means the printer port from 1 to 3.  The
   settings below are those that the user has defined when running the
   NCAPTURE utility.

   LPTxContextName
      Setting is the container name of the print queue, or blank if 'local'.
      Sample:     Printers.ABC
   LPTxQueueName
      Setting is the full name of the print queue, or blank if 'local'.
      Sample:     CN=Q-BJ600E.OU=Printers.O=ABC
   LPTxPrintJobName
      Setting is the print job name (if there is one), or blank if 'local'.
      Sample:     CHECKS
   LPTxNumberOfCopies
      Settings is from 1 to 1000.
      Normal setting is 1.
   LPTxTimeOut
      Setting is the number of seconds for capture timeout.
      Same meaning as 'TimeOut' for CAPTURE.EXE.
   LPTxFormFeed
      Setting is Y or N.
      Set to Y, to send a FormFeed trailing the print job.
      Same meaning as 'FormFeed' for CAPTURE.EXE.
   LPTxAutoEndCap
      Setting is Y or N.
      Same meaning as 'FormFeed' for CAPTURE.EXE.
   LPTxBanner
      Setting is Y or N.
      If set to Y, then the Banner will printed preceding the printjob.
   LPTxBannerName
      If LPTxBanner is set to Y, then it use this noun for the Banner name.
   LPTxBannerText
      If LPTxBanner is set to Y, then it use this noun for the Banner text.
