// Results stored in %0, %VAR00% & %PCT%, respectively
// Note: %PCT% is assumed to have been previously assigned using VARALIAS.
CALC %0 (((100 - %1) * %2) / %3) + 4
CALC %VAR00% 100 - %CPU_UTIL%
CALC %PCT% (%VOL_USED% * 100) / %VOL_SIZE%

Notes: Evaluates Left-to-Right. Entire calculation must reside on one line. If Dynamic or Environment Variables are used in the calculation, the current contents are substituted prior to computation. If result variable has fixed digit format, CALC will retain format (refer to DEFINE).

Note: Only practical for task debugging.

// Store text string 'Hello World!' in Defined Variable %0
DEFINE %0 Hello World!

// Store custom greeting (with day/date) in Defined Variable %VAR00%
DEFINE %VAR00% Today is %DAY_OF_WEEK%, %MONTH_NAME% %DAY%, %YEAR%.

// Store pre-formatted 4 digit value of 0000 in Defined Variable %0
DEFINE %0 0000

// Increment value of Defined Variable %0 by 2 (0000 + 2 = 0002) and store result in Defined Variable %1
DEFINE %1 %0+=2

// Decrement value of Defined Variable %1 by 1 (0002 - 1 = 0001) and store result in Aliased Variable %COUNTER%
DEFINE %COUNTER% %1-=1

Notes: string can be a text string, a Dynamic or an Environment Variable, or any combination thereof, up to 511 bytes in length. string is stored exactly as specified, after all Variables have had their contents substituted, including any quotes or trailing comments. Increment (+=) / Decrement (-=) only supported for Dynamic Variables which contain a valid numeric string.

// Echo a blank line
ECHO.

// Echo the day of the week (Monday - Sunday)
ECHO Today is %DAY_OF_WEEK%!

// Echo the batch commands as processed (default = OFF)
ECHO ON

// Echo a blank line and write it to the OPEN_WRITE #0 file
ECHO_WRITE.

// Echo the day of the week and write it to the OPEN_WRITE #3 file
ECHO_WRITE #3 Today is %DAY_OF_WEEK%!

Notes: ECHO OFF | ON controls the display of Batch Commands to the screen created for the active task (default = OFF). string can be a text string, a Dynamic or an Environment Variable, or any combination thereof. string is stored exactly as specified, after all Variables have had their contents substituted, including any quotes or trailing comments. ECHO WRITE both displays (echoes) the trailing comments and writes the information to a previously opened OPEN WRITE [#n] file. Failure to properly open an OPEN WRITE [#n] file prior to using ECHO_WRITE will generate a batch processing error.

Notes: The first specification receives the result of the search (0 = not found or 1 - length of string = position of "c" in "str") so it must be a Aliased or Defined Variable. The second and third can be a text string, a Dynamic an Environment Variable, or any combination thereof but must be enclosed in double quotes. If the second specification contains more than one character, only the first character is used for the search.
[opt]: CASE option for case sensitive search &/or LAST option to match the last occurrence of "c" in "str".

Notes: The first specification receives the result (the length) so it must be an Aliased or Defined Variable. The second can be a text string, a Dynamic or an Environment Variable, or any combination thereof but must be enclosed in double quotes.

Notes: The first specification receives the result of the search (0 = not found or 1 - length of string = position of "sub" in "str") so it must be an Aliased or a Defined Variable. The second and third can be a text string, a Dynamic or an Environment Variable, or any combination thereof but must be enclosed in double quotes.
[opt]: CASE option for case sensitive search &/or LAST option to match the last occurrence of "sub" in "str".

// Jump to the label :EXIT
GOTO EXIT

// Conditionally jump to the label :EXIT
IF ERRORLEVEL GOTO EXIT

Notes: GOTO should not be used within IF/WHILE structures. Any task line beginning with a colon (:) is considered a label.

// Type the "password" then press ENTER
KEYIN "password" ENTER

Special keys:
BACKSPACE, ENTER, ESC, ESCAPE, F1 ... F12, UP, DOWN, LEFT, RIGHT, PGUP, PGDN, HOME, END, INS, INSERT, DEL, DELETE, SHIFT-key, ALT-key, CTRL-key, ALT-A ... ALT-Z, CTRL-A ... CTRL-Z

Notes: Multiple "string" & key combinations can be used in a single KEYIN. "string" can be a text string, a Dynamic or an Environment Variable, or any combination thereof but must be enclosed in double quotes. Use CONSOLE SCREEN / CURRENT SCREEN to change the current task I/O screen.

Notes: The ERRORLEVEL condition is set TRUE if the file cannot be opened. Up to 10 (#0 - #9) OPEN READ files can be open simultaneously. If no handle number (#0 - #9) is specified, handle #0 is used. Issuing an OPEN READ using a handle already in use will result in the previously opened file being closed before an attempt is made to open the new file.

Notes: The ERRORLEVEL condition is set TRUE if the file cannot be opened. If no handle number (#0 - #9) is specified, handle #0 is used. Up to 10 (#0 - #9) OPEN WRITE files can be open simultaneously. Issuing an OPEN WRITE using a handle already in use will result in the previously opened file being closed before an attempt is made to open the new file.
[opt]: Specifying the TRUNC or TRUNCATE option causes the file to be truncated (overwritten, default = append).

// Parse byte 80 of Defined Variable %2 into Defined Variable %1
PARSE %1 %2 80

// Parse bytes 1-10 of Defined Variable %2 into Defined Variable %1
PARSE %1 %2 1-10

// Parse byte 10 and bytes 20-29 of Defined Variable %2 into Defined Variable %VAR01%
PARSE %VAR01% %2 10,20-29

// Parse byte 10 and bytes 20-29 of Defined Variable %2 into Defined Variable %VAR01% appending to any existing contents
PARSE %VAR01% %2 10,20-29 APPEND

// Parse bytes 1-10 and bytes 40-99 of Defined Variable %2 into Aliased Variable %KEY% (truncating if shorter)
PARSE %KEY% %2 1-10,40-99 PACK


Notes: string can be a text string, a Dynamic or an Environment Variable, or any combination thereof. Up to 10 byte ranges can be specified.
[opt]: If specified amount of data to PARSE is more than available, extra bytes are padded (space filled) unless PACK option specified. Parsed data overwrites contents of destination unless APPEND option is specified.

// Read next sequential record and store data in Defined Variable %1.
READ %1

// Read next sequential text record and store bytes 10-20 in Defined Variable %1.
READ %1 10-20

// Read next record, storing bytes 1, 11-50 and 512-598 in Aliased Variable %DATA% (pad with spaces if less than 128 bytes retrieved).
READ %DATA% 1,11-50,512-598

// Read next record, storing bytes 1 and 10-127 in Aliased Variable %DATA1% (pack or truncate if less than 119 bytes retrieved).
// Using same record, store bytes 1 and 128-254 in Aliased Variable %DATA2% (pad with spaces if less than 128 bytes retrieved).
READ %DATA1% 1,10-127 PACK %DATA2% 1,128-254

Notes: The ERRORLEVEL condition is set TRUE if a READ error occurs or once the End Of File (EOF) has been reached. #n (#0 - #9) associates the READ to the corresponding OPEN READ #n file. Although the full text record is processed (up to the CR/LF End Of Record or 4095 bytes, whichever is less), a maximum of 511 bytes can be transferred into a single variable (maximum supported variable length). Multiple variable / key combinations are supported.
[opt]: If specified amount of data to READ is more than available, extra bytes are padded (space filled) unless PACK option specified.

// Left justify (shift data left to replace leading spaces) the data in Defined Variable %1 (Before: ' 01210 ' / After: '01210 ')
REFORMAT %1 LEFT

// Right justify (shift data right to replace trailing spaces) the data in Defined Variable %1 (Before: ' 01210 ' / After: ' 01210')
REFORMAT %1 RIGHT

// Pack (remove leading zeroes / leading & trailing spaces) the data in Defined Variable %1 (Before: ' 01210 ' / After: '1210')
REFORMAT %1 PACK

// Re-size to 6 bytes the data in Defined Variable %1 (Before: ' 01210 ' / After: ' 01210')
REFORMAT %1 6

// Left justify, pack and re-size to 6 bytes the data in Defined Variable %VAR00% (Before: ' 01210 ' / After: '1210 ')
REFORMAT %VAR00% 6 LEFT PACK

// Pack, right justify and re-size to 6 bytes the numeric data in Aliased Variable %COUNT% (Before: ' 01210 ' / After: ' 1210')
REFORMAT %COUNT% 6 PACK RIGHT

// Pack, right justify and re-size to 6 bytes the text data in Aliased Variable %COUNT% (Before: ' 01210 ' / After: ' 01210')
REFORMAT %COUNT% 6 PACK RIGHT TEXT

Notes: The single quote marks in the examples are only used to delineate the data (i.e., not considered part of the variable contents).
[opt]: LEFT shifts the data to the left to replace any leading spaces. RIGHT shifts the data to the right to replace any trailing spaces. PACK strips leading zeroes for numeric data (unless the TEXT option is specified), strips leading and trailing spaces for alphanumeric data. Re-sizing truncates longer data and pads (space fills) shorter data.

// Replace dot with dash in Defined Variable %1 (Before: "1.2.3" / After: "1-2-3")
REPLACE %1 ".-"

// Replace braces with brackets in Aliased Variable %GREETING% (Before: "{Hi}" / After: "[Hi]")
REPLACE %GREETING% "{[}]"

Note: Replacement string must "??" have at least one pair of characters specified.

[opt]: TXT | TEXT option writes character data only (default). BIN | BINARY option writes character data with screen attributes. Use CONSOLE SCREEN / CURRENT SCREEN to change the current task I/O screen.

Notes: string can be a text string, a Dynamic or an Environment Variable, or any combination thereof.   GET {string} should be the desired NetWare System Environment variable, excluding the trailing equal sign (i.e., PATH not PATH=).   SET {string} should be the full variable to be stored in the NetWare System Environment table (i.e., PATH=SYS:\SYSTEM). NetWare System Environment variables and TaskMaster Environment Variables are separate entities. (NetWare uses a single preceding % designator while TaskMaster encloses the variable name with a % on each end.) They are not interchangable even if they share the same name.

// Convert first day of year to calendar and store in Defined Variable %0 (After: %0 = 20040101) during 2004
TOCALENDAR %0 1

// Convert 60th day of year to calendar and store in Defined Variable %1 (After: %1 = 20040229) during 2004
TOCALENDAR %1 60

// Set Defined Variable %2 to today's numeric day of year plus 7 days
// then convert that to a calendar format and store the result in %3
DEFINE %2 %NDAY_OF_YEAR%+=7
TOCALENDAR %3 %2

Note: day can be a text string, a Dynamic or an Environment Variable, or any combination thereof. The day number can be one to three digits (1 - 366 or 001 - 366). If a year is not specified (1 - 366 or 001 - 366 only), the current year is assumed.

// Convert 14 February (any year) to numeric day of year then store the result in Defined Variable %0 (After: %0 = 045)
TODAYOFYEAR %0 0214

// Convert 01 March 2003 to numeric day of year then store the result in Defined Variable %1 (After: %1 = 060)
TODAYOFYEAR %1 20030301

// Convert 01 March 2004 to numeric day of year then store the result in Defined Variable %2 (After: %2 = 061) {2004 was a leap year}
TODAYOFYEAR %2 20040301

Note: date can be a text string, a Dynamic or an Environment Variable, or any combination thereof. Calendar date must be formatted either as mmdd (0615) or yyyymmdd (20040615). If a year is not specified (mmdd only), the current year is assumed.

// Assign the alias name %COUNTER% to the reserved Dynamic Variable %0
// Note: Reserved name %0 remains valid - %VAR00% becomes %COUNTER%
VARALIAS %0 %COUNTER%

// Assign an alias name (%NUMBER_9%) to replace the default defined Dynamic Variable name %VAR09%
// Note: Reserved name %9 remains valid - %VAR09% becomes %NUMBER_9%
VARALIAS %VAR09% %NUMBER_9%

// Rename the Alias Variable %NUMBER_9% to %NUMBER_NINE%
// Note: Reserved name %9 remains valid - %NUMBER_9% becomes %NUMBER_NINE%
VARALIAS %NUMBER_9% %NUMBER_NINE%

// Restore default name %VAR09% to the Aliased Variable %NUMBER_NINE%
// Note: Reserved %9 remains valid - Default name %VAR09% restored
VARALIAS %NUMBER_NINE% %VAR09%

Notes: %VAR00% - %VAR99% are default names assigned to the 100 Defined Variables available to each task, each of which can be aliased or renamed to more appropriate references. The first specification must be a valid a Dynamic Variable. The second specification must be a valid and unique alias name. Renaming (or aliasing) a variable does not affect its contents. Once aliased, the previous name is not longer valid (except for the reserved names %0-%9). Naming rules: Must begin and end with a percent sign (%); First character after initial percent sign (%) cannot be numeric (0-9); Maximum of 15 characters, including percent signs (%); Alias names cannot contain spaces.

Notes: The ERRORLEVEL condition is set TRUE if a WRITE error occurs. #n (#0 - #9) associates the WRITE to the corresponding OPEN WRITE #n file. string can be a text string, a Dynamic or an Environment Variable, or any combination thereof. string is stored exactly as specified, after all Variables have had their contents substituted, including any quotes or trailing comments.

[opt]: -EOL suppresses the End Of Line (CR/LF) normally appended to each WRITE, allowing multiple WRITE commands to be issued to build a single contiguous text record.

IF [NOT] {cond} [[AND|OR] [NOT] {cond}]
    command(s)...
[ELSEIF [NOT] {cond}
    command(s)...]
[ELSE
    command(s)...]
ENDIF

// Check if today is New Years Day (01/01 - System Environment Variables %MONTH% & %DAY%)
IF %MONTH%==01 AND %DAY%==01 THEN ECHO Today is: New Years!

// Send hourly messages to employees (nested IF structyre example)
IF %MINUTE%==00
  IF NOT %HOUR24%>07 OR NOT %HOUR24%<18
    // Not 8:00am - 5:00pm so skip.
  ELSEIF %HOUR24%==12
    SEND "*Time to Eat*"
  ELSEIF %HOUR24%==17
    SEND "** Go Home **"
  ELSE
    SEND "Back to Work!"
  ENDIF
ENDIF

Notes: IF / ELSEIF conditions are evaluated sequentially (in order). Supports multiple AND|OR logic (cannot mix AND/OR) & multiple ELSEIFs. Variables used for cond can be a text string, a Dynamic or an Environment Variable, or any combination thereof.

WHILE [NOT] {cond}
    command(s)...
    [IF [NOT] {cond} THEN] BREAK
    [IF [NOT] {cond} THEN] CONTINUE
LOOP

Notes: Nested WHILE & IF support. BREAK aborts. CONTINUE resumes at top. Multiple AND | OR logic (cannot mix AND / OR tests). Variables used for cond can be a text string, a Dynamic or an Environment Variable, or any combination thereof.

Naming rules: Must begin and end with a percent sign (%); First character after initial percent sign (%) cannot be numeric (0-9); Maximum of 15 characters, including percent signs (%); Alias names cannot contain spaces.

Note: When used within a task, an Aliased Variable is handled by the batch parser exactly the same as its corresponding Defined Variable.

Note: %0 - %9 are internally reserved names which correspond to the first 10 data variables (named %VAR00% - %VAR09% respectively, by default). %VAR00% - %VAR99% are default names for all 100 data variables available to each task which can be renamed (or aliased) using VARALIAS. When used within a task script, the batch parser will automatically replace any properly referenced variable name with any value stored in the associated variable. Upon initial task execution, %0 - %9 are assigned any arguments (options) which were specified on the TMRUN command line. Some of the Batch Commands which can be used to assign or modify the contents of Aliased Variables or Defined Variables include: CALC, DEFINE, PARSE, READ, REFORMAT, REPLACE, TOLOWER and TOUPPER.

// Use a specific connection (12)
ECHO Conn 12 netaddr: %CONN_ADDRESS_12%

// Use numeric value defined in %0
WRITE Conn %0 netaddr: %CONN_ADDRESS_%0%

Note: {spec} can be a numeric string or a Dynamic Variable. If an INACTIVE connection, returns zero filled address.

// Find first file in Current Working Directory (CWD) matching *.*
DEFINE %1 %DIR_FILE_*.*%

// Find next file matching last specified pattern (*.*)
DEFINE %1 %DIR_FILE_%

// Find first file matching SYS:\PUBLIC\*.*
DEFINE %1 %DIR_FILE_SYS:\PUBLIC\*.*%

// Find next file matching last specified pattern (SYS:\PUBLIC\*.*)
DEFINE %1 %DIR_FILE_%

// Scan Current Working Directory (CWD)
WHILE
  // If first loop (%1 == NULL - unused), use *.* to initiate scan & no spec (NULL) to find next
  IF "%1"==""
    DEFINE %1 %DIR_FILE_*.*%
  ELSE
    DEFINE %1 %DIR_FILE_%
  ENDIF
  // If %DIR_FILE_% returns a NULL value (%1=="" - i.e., no more) then exit WHILE/LOOP (BREAK)
  IF "%1"=="" THEN BREAK
  // ECHO (display) the returned name
  ECHO %1
LOOP

Notes: A valid DOS search pattern must be specified in the initial (first) request. Subsequent (next) requests should not include a search pattern (i.e., specifying a pattern initiates a new search). A null string is returned if the search is exhausted or fails. If the initial (first) specification does not include a volume and/or path, the Current Working Directory (CWD) is used. A Dynamic Variable may be used for initial (first) specification, if it is defined as a valid DOS search pattern. Wild cards supported.

// Scan & display a specified directory tree
WHILE
  // If first loop (%1 == NULL - unused), use SYS:PUBLIC to initiate scan & no spec (NULL) to find next
  IF "%1"==""
    DEFINE %1 %DIR_TREE_SYS:PUBLIC%
  ELSE
    DEFINE %1 %DIR_TREE_%
  ENDIF
  // If %DIR_TREE_% returns a NULL value (%1=="" - i.e., no more) then exit WHILE/LOOP (BREAK)
  IF "%1"=="" THEN BREAK
  // ECHO (display) the next level traversed in the CWD
  ECHO %CWD%
LOOP

Notes: A valid DOS directory must be specified in the initial (first) request. Subsequent (next) requests should not include a specification (i.e., specifying a directory initiates a new search). A null string is returned if the search is exhausted or fails. The initial (first) specification becomes the base (or root) directory for traversing the tree. A Dynamic Variable may be used for initial (first) specification, if it is defined as a valid DOS directory. Unlike %DIR_SUB_% which only returns a matching directory name, the returned directory also becomes the CWD.

// Store information for Drive C: in %1
DEFINE %1 %DOS_DRIVE_FREE_C%

// Store information for the default (boot) drive in %1
DEFINE %1 %DOS_DRIVE_FREE_%

Note: If a DOS drive (A-Z) is not specified for ? then the default (boot) DOS drive information is returned.

// Store last access for LOGIN.DAT (located in CWD) in %1
DEFINE %1 %FILE_ACCESS_LOGIN.DAT%

// Store last access for SYS:\PUBLIC\LOGIN.DAT in %1
DEFINE %1 %FILE_ACCESS_SYS:\PUBLIC\LOGIN.DAT%

// Store SYS:\PUBLIC\LOGIN.DAT in %0 & last access for %0 in %1.
DEFINE %0 SYS:\PUBLIC\LOGIN.DAT
DEFINE %1 %DIR_FILE_%0%


// Store file search pattern (*.*) in %0.
// Store the directory to search (SYS:\PUBLIC) in %1.
// Use %DIR_FILE_% to search for a match for the combined path/pattern (SYS:\PUBLIC\*.*).
// If a match is returned (%2 is not NULL), store the last access for %1\%2 in %3.
DEFINE %0 *.*
DEFINE %1 SYS:\PUBLIC
DEFINE %2 %DIR_FILE_%1\%0%
IF NOT "%2"=="" THEN DEFINE %3 %FILE_ACCESS_%1\%2%


Notes: {spec} can be fully qualified or relative to the Current Working Directory (CWD) and must reference a valid directory or file. If {spec} does not exist, a null string is returned. If a Dynamic Variable is used for {spec}, it must be defined as a valid directory or file.