OzCIS Script Language Commands By Name command category syntax summary log safe -------- ------------ ---------------------------------------- ------------------------------------------------------------ ------------ ADD Wait add add a string to a multiple-wait command yes BREAK Online break send a Break signal to CIS yes CALL Flow Control call call a sub-script yes CAPTURE Capture capture [] manage capture files yes CLS Output cls clear the screen yes CONCAT String concat combine two or more strings yes CWRITE Capture cwrite write directly to the capture file yes DEBUG Output debug echo currently executing command on the status line yes DEC Numeric dec [] decrease the value of a numeric variable yes DEFINE Variable define [] create a user variable and optionally give it a value yes DELAY Flow Control delay pause processing for a specified interval yes DELSTR String delstr [] delete a substring from within a larger string yes DL Online dl ;; download a file No DOS Flow Control dos [] run an external program, or get the command processor prompt with caution DWAIT Wait dwait activate a multiple-wait, and continue if nothing found yes END Flow Control end signal the end of the script yes ENTER Online enter go to any CIS service page and wait for first prompt No ERASE File IO erase delete a file from the disk yes ERROR Output error displays an error message in a dialog box yes FAIL Flow Control fail signal that the script ended abnormally yes FAPPEND File IO fappend open a disk file ready to add to the end of it yes FCLOSE File IO fclose close a disk file yes FCREATE File IO fcreate create and open a new disk file yes FEOF File IO feof returns TRUE when the end of the file has been reached yes FERROR File IO ferror returns the DOS error value of the last file operation yes FEXISTS File IO fexists returns TRUE when the specified file is found yes FOPEN File IO fopen open an existing disk file (for reading and writing?) yes FREADLN File IO freadln read the next line of text from a disk file yes FWRITE File IO fwrite write a line of text to a disk file yes GIF Online gif set a filename for the next GIF file to be downloaded/viewed No GO Online go go to any CIS service page and wait for first prompt No GOSUB Flow Control gosub call a script subroutine yes GOTO Flow Control goto go to a label elsewhere in the script yes IF Flow Control if test an expression and branch based on the result yes INC Numeric inc [] increase the value of a numeric variable yes INPUT Input input get input from the user in a pop up dialog box yes JUMP Flow Control jump jump to a label elsewhere in the script yes LENGTH String length set a numeric variable with the length of a string variable yes LSEND Output lsend send a string followed by a CR to the modem yes LWRITE Output lwrite send a string followed by a CR to the screen yes MIDSTR String midstr [] return a substring from a larger string yes MWAIT Wait mwait activate a multiple-wait, exit with error if nothing found yes OFF Online off log off of CIS yes ONERROR Flow Control onerror set the label for an error handling routine yes POS String pos return the position of a substring within a larger string yes POSNC String posnc same as POS but ignores differences in case yes PROMPT Input prompt get input from the user in a pop up dialog box yes RETURN Flow Control return return from a subroutine to the point where it was called yes RUN Flow Control run chain to a sub-script yes SEND Output send send a string to the modem with NO afterwards yes SENDLN Output sendln send a string followed by a CR to the modem yes SET Variable set assign a value to a variable yes SL Online sl [] [] perform a long library scan (full descriptions) No! STATLINE Output statline display a string in the status line (bottom of the screen) yes STATUS Output status display a string in the status line (bottom of the screen) yes STR String str convert a number to a string yes TERM Online term put the user into manual terminal mode with caution TIMEOUT Wait timeout set the number of seconds to wait before generating an error yes TRIM String trim removes leading and trailing whitespace from a string yes ULSEND Output ulsend send an "invisible" string to the modem with a yes UPCASE String upcase convert all letters in a string variable to upper case yes USEND Output usend send an "invisible" string to the modem, without a yes VAL Numeric val convert a string to a numeric variable yes WAIT Wait wait wait until the specified string arrives, or until time is up yes WMH Capture wmh [] write a dummy mail message header to the open capture file yes WRITE Output write send a string without CR to the screen yes WRITELN Output writeln send a string with CR to the screen yes By Category category command syntax summary log safe ------------ -------- ---------------------------------------- ------------------------------------------------------------ ------------ Capture CAPTURE capture [] manage capture files yes Capture CWRITE cwrite write directly to the capture file yes Capture WMH wmh [] write a dummy mail message header to the open capture file yes File IO ERASE erase delete a file from the disk yes File IO FAPPEND fappend open a disk file ready to add to the end of it yes File IO FCLOSE fclose close a disk file yes File IO FCREATE fcreate create and open a new disk file yes File IO FEOF feof returns TRUE when the end of the file has been reached yes File IO FERROR ferror returns the DOS error value of the last file operation yes File IO FEXISTS fexists returns TRUE when the specified file is found yes File IO FOPEN fopen open an existing disk file (for reading and writing?) yes File IO FREADLN freadln read the next line of text from a disk file yes File IO FWRITE fwrite write a line of text to a disk file yes Flow Control CALL call call a sub-script yes Flow Control DELAY delay pause processing for a specified interval yes Flow Control DOS dos [] run an external program, or get the command processor prompt with caution Flow Control END end signal the end of the script yes Flow Control FAIL fail signal that the script ended abnormally yes Flow Control GOSUB gosub call a script subroutine yes Flow Control GOTO goto go to a label elsewhere in the script yes Flow Control IF if test an expression and branch based on the result yes Flow Control JUMP jump jump to a label elsewhere in the script yes Flow Control ONERROR onerror set the label for an error handling routine yes Flow Control RETURN return return from a subroutine to the point where it was called yes Flow Control RUN run chain to a sub-script yes Input INPUT input get input from the user in a pop up dialog box yes Input PROMPT prompt get input from the user in a pop up dialog box yes Numeric DEC dec [] decrease the value of a numeric variable yes Numeric INC inc [] increase the value of a numeric variable yes Numeric VAL val convert a string to a numeric variable yes Online BREAK break send a Break signal to CIS yes Online DL dl ;; download a file No Online ENTER enter go to any CIS service page and wait for first prompt No Online GIF gif set a filename for the next GIF file to be downloaded/viewed No Online GO go go to any CIS service page and wait for first prompt No Online OFF off log off of CIS yes Online SL sl [] [] perform a long library scan (full descriptions) No! Online TERM term put the user into manual terminal mode with caution Output CLS cls clear the screen yes Output DEBUG debug echo currently executing command on the status line yes Output ERROR error displays an error message in a dialog box yes Output LSEND lsend send a string followed by a CR to the modem yes Output LWRITE lwrite send a string followed by a CR to the screen yes Output SEND send send a string to the modem with NO afterwards yes Output SENDLN sendln send a string followed by a CR to the modem yes Output STATLINE statline display a string in the status line (bottom of the screen) yes Output STATUS status display a string in the status line (bottom of the screen) yes Output ULSEND ulsend send an "invisible" string to the modem with a yes Output USEND usend send an "invisible" string to the modem, without a yes Output WRITE write send a string without CR to the screen yes Output WRITELN writeln send a string with CR to the screen yes String CONCAT concat combine two or more strings yes String DELSTR delstr [] delete a substring from within a larger string yes String LENGTH length set a numeric variable with the length of a string variable yes String MIDSTR midstr [] return a substring from a larger string yes String POS pos return the position of a substring within a larger string yes String POSNC posnc same as POS but ignores differences in case yes String STR str convert a number to a string yes String TRIM trim removes leading and trailing whitespace from a string yes String UPCASE upcase convert all letters in a string variable to upper case yes Variable DEFINE define [] create a user variable and optionally give it a value yes Variable SET set assign a value to a variable yes Wait ADD add add a string to a multiple-wait command yes Wait DWAIT dwait activate a multiple-wait, and continue if nothing found yes Wait MWAIT mwait activate a multiple-wait, exit with error if nothing found yes Wait TIMEOUT timeout set the number of seconds to wait before generating an error yes Wait WAIT wait wait until the specified string arrives, or until time is up yes Synonyms command category synonym -------- ------------ ---------- CALL Flow Control RUN ENTER Online GO GO Online ENTER GOTO Flow Control JUMP INPUT Input PROMPT JUMP Flow Control GOTO LSEND Output SENDLN LWRITE Output WRITELN PROMPT Input INPUT RUN Flow Control CALL SENDLN Output LSEND STATLINE Output STATUS STATUS Output STATLINE WRITELN Output LWRITE ADD Wait none BREAK Online none CAPTURE Capture none CLS Output none CONCAT String none CWRITE Capture none DEBUG Output none DEC Numeric none DEFINE Variable none DELAY Flow Control none DELSTR String none DL Online none DOS Flow Control none DWAIT Wait none END Flow Control none ERASE File IO none ERROR Output none FAIL Flow Control none FAPPEND File IO none FCLOSE File IO none FCREATE File IO none FEOF File IO none FERROR File IO none FEXISTS File IO none FOPEN File IO none FREADLN File IO none FWRITE File IO none GIF Online none GOSUB Flow Control none IF Flow Control none INC Numeric none LENGTH String none MIDSTR String none MWAIT Wait none OFF Online none ONERROR Flow Control none POS String none POSNC String none RETURN Flow Control none SEND Output none SET Variable none SL Online none STR String none TERM Online none TIMEOUT Wait none TRIM String none ULSEND Output none UPCASE String none USEND Output none VAL Numeric none WAIT Wait none WMH Capture none WRITE Output none