DeveloperNet Professional Developer Avanti Product Banner PartnerNet Authorized ISV Partner
avanti's TaskMaster® /
TaskMaster Lite (TMLite)

Quick Start Guide

Download Install Load
TMConsole Tasks SYNC



Download
Demo / Evaluation software can be downloaded from avanti's WEB Site. For Licensed software, a link to a hidden file in a protected directory on avanti's FTP Server is E-Mailed to the principal End User contact.

Demo / Evaluation Software:
Download and save the self-extracting software installation archive (TASKMSTR.EXE - full version / TMLITE.EXE - Lite version) from the Evaluation Software page on avanti's WEB site:

http://www.avanti-tech.com/evalsw.htm

Licensed Software:
Download and save the self-extracting software installation archive (unique DOS 8.3 formatted name - ????????.EXE) from avanti's FTP Server using the instructions provided in the ESD (Electronic Software Delivery) Notice E-Mail sent to the principal End User contact as specified on the order.




Install
Execute the self-extracting software installation archive (here after referred to as the "Installation Programi") either by locating the Installation Program using Windows Explorer and then double clicking on the entry or by using the Start -> Run option on the Windows Taskbar then browsing to locate the Installation Program and clicking OK.

Answer the prompts affirmatively to proceed through the installation process.

    Notes:
    • When prompted to "Choose the location for installing TaskMaster's files," specify the Server name, volume, and path in proper UNC format (i.e., two backslashes preceding the Server name and a single backslash separating the remaining components - Volume and Path).
    • The destination directory will be created, if it does not exist.

The Installation Program will confirm successful completion.




Load
The NLM must initially be loaded manually on the Server by accessing the Server's System Console prompt and entering the appropriate NetWare LOAD command:
    Example: LOAD SYS:\SYSTEM\TASKMSTR\TASKMSTR

    The above line is entered after the ServerName: prompt on the Server's System Console. If the software was not installed in the default \\ServerName\SYS\SYSTEM\TASKMSTR directory, substitute the appropriate Volume and Path as appropriate.

    Note:
    • It is advisable to add the LOAD command line to the Server SYS:\SYSTEM\AUTOEXEC.NCF configuration file to insure the NLM is automatically loaded whenever the Server starts.



TMConsole
When the TaskMaster Server Module is loaded, the TMConsole (Shell) screen appears. This screen provides access to the Extended Console Command set provided by TaskMaster. It is designed to mimic a cross between a DOS Box for the Server and the Server's System Console, providing support for commands which can be used to view and manage the File System, as well as execute tasks and perform other special operations.

Among the dozens of Extended Console Commands supported by the TMConsole (Shell) are the following key commands:

TaskMaster & TaskMaster Lite
Command Description
Arrow Keys Use to scroll through & edit previously executed commands.
ABORT {command} | {task} Terminates {command} or {task}. {task} supports wild cards.
CLS Clear TMConsole (Shell) screen.
EXIT Close TMConsole (Shell) screen.
SYSTEM CONSOLE [command] Change screen to Server System Console. If [command] specified, execute [command] at System Console prompt.
TASKLIST List tasks currently being processed by Server Module.
TMCONSOLE [command] When executed at Server System Console prompt:
If no TMConsole (Shell) screen (see EXIT), activate it. If TMConsole (Shell) screen, change to it. If [command] specified, execute [command] at TMConsole (Shell) prompt.
TMHELP [command] General or Extended Console Comand [command] help.
TMINFO Licensing & version information for the Server Module.
TMRELOAD UNLOADs then LOADs (i.e., reloads) the Server Module.
TMRUN {[vol:path\]task} Manually launch batch processing of {task}. [vol:path\] required if {task} is not in a default directory (SYS:\SYSTEM or directory from which Server Module loads).
TMUNLOAD Must be executed at the TMConsole (Shell) prompt or the Server System Console to UNLOAD the Server Module.
 
TaskMaster only
Command Description
STASKLIST {server} List tasks actively being processed by the Server Module on {server}.
STMINFO [server] Licensing & version information for Server Module loaded on [server] (use * for all Servers with Server Module loaded).
TMSCMD {server} {command} Send {command} to {server}. Both {server} & {command} required. {server} must have Server Module loaded.
TMUPDATE [server] Copy Server Module & associated files to [server] then send TMRELOAD to [server]. If [server] not specified, update any Server with Server Module loaded. Wild cards supported in [server] to limit update to specific name patterns.
    Notes:
    • For any Server-to-Server operations, a compatible version of the TaskMaster Server Module must be loaded on both Servers.
    • TaskMaster Lite does not support Server-to-Server operations.
    • Parameters in { } are required. Parameters in [ ] are optional. Do not include { } or [ ] (for documentation purposes only).

For more information on the Extended Console Command set, review:

TaskMaster / TMLite Quick Reference
quickref.pdf (included in distribution archive)

TaskMaster / TMLite User's Guide
manual.pdf (included in distribution archive)

TaskMaster / TMLite: Extended Console Commands
http://www.avanti-tech.com/taskmstr/conslcmd.htm

TaskMaster / TMLite: Frequently Asked Questions (FAQs)
http://www.avanti-tech.com/taskmstr/tm_faq.htm

TaskMaster / TMLite: Tips & Tricks
http://www.avanti-tech.com/taskmstr/tiptrick.htm




Tasks
TaskMaster / TaskMaster Lite both incorporate Extended Console Command sets and Extended Batch Command sets with an integrated Batch Processor and Scheduler. Text files containing scripted instructions or commands can be scheduled for processing by TaskMaster / TaskMaster Lite as tasks.

Task Scripting:
When loaded, the Batch Processor integrated into the Server Module is capable of processing ASCII text files which contain a series of instructions / commands intended to perform a specific set of operations (a scripted task). The instructions / commands in the file are parsed and interpreted by the integrated Batch Processor which either performs the scripted processing or submits it to the Server System Console to be processed.

The integrated Batch Processor supports a simple English language set of scripting commands which resemble a cross between the DOS Batch and NetWare Login syntax, with enhancements including dynamic variables, system environment variables, user defined variables, IF/WHILE structures, IF/WHILE conditional tests, data manipulation commands, display/file I/O commands, and support for the Extended Console Command set supported by the Server Module.

For more information on the scripting tasks, review:

TaskMaster / TMLite Quick Reference
quickref.pdf (included in distribution archive)

TaskMaster / TMLite User's Guide
manual.pdf (included in distribution archive)

TaskMaster / TMLite: Extended Batch Commands
http://www.avanti-tech.com/taskmstr/batchcmd.htm

TaskMaster / TMLite: Extended Console Commands
http://www.avanti-tech.com/taskmstr/conslcmd.htm

TaskMaster / TMLite: Sample Tasks Page
http://www.avanti-tech.com/taskmstr/smpltask.htm

TaskMaster / TMLite: Frequently Asked Questions (FAQs)
http://www.avanti-tech.com/taskmstr/tm_faq.htm

TaskMaster / TMLite: Tips & Tricks
http://www.avanti-tech.com/taskmstr/tiptrick.htm


Task Execution:
Tasks can be executed either manually or as a scheduled process. The TMRUN Extended Console Command is used for manual execution. Scheduled processing can be accomplished using either the TMSCHEDULE Extended Console Command or the TMClient Task Management Windows Client (TMClient.EXE). Tasks can be scheduled to run on a specific date, a specific day of the month, or specific days of the week at a specific time, a specific time after each hour, or at specific intervals.




SYNC (TaskMaster only)
Among the dozens of Extended Console Commands added by the TaskMaster Server Module through the TMConsole (Shell) interface is the SYNC command. The SYNC command, which can be executed manually via the TMConsole (Shell) prompt or incorporated into scheduled tasks, provides an easy to use yet scalable option for replicating files and synchronizing data across directories, volumes, and Servers, local or remote, on a scheduled basis.

The SYNC command is as simple to use as the DOS XCOPY command, whether executed directly at the TMConsole (Shell) prompt or within a scheduled task. It not only replicates files / synchronizes data but also the names (DOS / Long / Macintosh / NFS), Ownership, Trustee Rights, DOS attributes, NetWare attributes, Inherited Rights Mask (IRM), and originating Name Space for both directories and files.

A source specification, a destination specification, and the appropriate options are required (no default options are assumed). The source specification can be a file, a file pattern, a directory, or a volume. The only requirement is that it MUST reside on the local Server and MUST be the first specification. The destination can be a directory within the same volume, a directory on a different Volume on the same (Local) Server, or a Volume and directory combination residing on a different Server, even across NDS trees.

The format of the SYNC command is as follows:

    SYNC src dest opts [<sync.exc] [>sync.log]
The following are some of the most commonly used options for data synchronization / file replication processing:

/A Add source entries that do not exist on destination
/D Delete entries that exist on the destination but not on source
/H Hidden / System entries are processed
/I Ignore non-critical errors (default = Abort on any error)
/Q Query mode (simulated processing - no changes made)
/S Subdirectory recursion
/V Verify destination (replace if different from source)
>sync.log Redirected processing output (overwrite sync.log)
>>sync.log Redirected processing output (append to sync.log)
<sync.exc Redirected exclusion list input (source dirs/files to exclude)

SYNC Example:

    SYNC DATA:\*.* RSERVER/DATA:\ /A /D /H /I /S /V
    Process the DATA: volume starting at the root (\) and recursing through all subdirectories (/S) adding any entry (directory &/or file) on the source that does not exist on the destination (/A), deleting any entry on the destination that does not exist on the source (/D), process Hidden &/or System entries (/H), ignore any non-critical error (/I - i.e., ignore any open file conflict), and update any destination file which does not match the corresponding source file (/V - Last Modified Date/Time and Size comparison).

    Exclusion List:

      Using input redirection (<vol:\path\filename.ext), specific files, file patterns, and directories can be excluded from processing. The exclusion list must be an ASCII text file containing one specification per line which matches the source file(s) to be excluded from the SYNC process. Wild cards are supported in the exclusion specification.

      The following criteria or rules apply:

      • Exclusion entries are specific to the source. Destination entries cannot be excluded.
      • NetWare Server or Volume specific system files, such as SYS:\_SWAP_.MEM, SYS\:VOLDATA.TDF, SYS:\VOL$LOG.ERR, SYS:\BACKOUT.TTS, and other common system files, are automatically excluded.
      • A generic file pattern (*.JPG) excludes any files in the base source directory which match the pattern. If the /S option is appended to the file pattern (i.e., *.JPG /S), any files matching the file pattern which reside in the subdirectory tree beneath the source are also excluded.
      • A path specific file or file pattern (e.g., SYS:\SYSTEM\DS.NLM or SYS:\SYSTEM\DS*.NLM) excludes any files in the specified directory which match (i.e., both examples will exclude the SYS:\SYSTEM\DS.NLM file). If the /S option is appended to the specification (i.e., SYS:\SYSTEM\DS.NLM /S), any files matching the file pattern which reside in the subdirectory tree beneath the specified path (SYS:\SYSTEM) are also excluded.
      • A subdirectory specification without wild cards or file pattern (e.g., VOL:\PATH) will exclude all directories and files in the specified subdirectory, including any which reside beneath the specification. It is more efficient to specify only the subdirectory instead of the subdirectory with a generic all file wild card (i.e., VOL:\PATH is more efficient than VOL:\PATH\*.*) as both provide the same exclusion results but the wild card specification requires additional processing.

      Input redirection of an exclusion file must follow all other options (except output redirection). A valid file specification must be provided (no wild cards). The file specification can be either fully qualified (vol:path) or relative to the Current Working Directory (CWD).


    Log Processing Activity:

      By default, SYNC will create a screen and display what processing occurs which can be redirected to a file for logging purposes by appending an output redirection option (>vol:\path\filename.ext - similar to DOS but using NetWare Volume:\Path format rather than Drive:\Path - use > to overwrite an existing log file or >> to append to an existing log file - either method will create the file if it does not already exist). Output redirection to a log file must follow all other options.

For more information on the Extended Console Command SYNC, review:

TaskMaster / TMLite Quick Reference
quickref.pdf (included in distribution archive)

TaskMaster / TMLite User's Guide
manual.pdf (included in distribution archive)

TaskMaster / TMLite: Extended Console Commands
http://www.avanti-tech.com/taskmstr/conslcmd.htm

TaskMaster / TMLite: Sample Tasks Page
http://www.avanti-tech.com/taskmstr/smpltask.htm

SYNC: Frequently Asked Questions (FAQs)
http://www.avanti-tech.com/taskmstr/sync_faq.htm