Error #1 NO FILE SPECIFIED FOR ACTIONUser's Guide Reference: p. A-3 1 - You have tried to generate a diagram without selecting a file for action. 2 - You have tried to select functions for actions with [F9]without first selecting a file. You MUST specify the name of file which is to be the object of CLEAR processing. Use the Select File option of the FILE menu, or press the [F7] key to type in the file name. As soon as the file is selected, CLEAR proceeds directly to the SELECT FUNCTIONS (or [F9]) display where you should mark thedesired functions for CLEAR actions. 0123456789012345678901234567890123456789012345678901234567 0NJQQKOQOKPLLKLNMQNMIKPPMOQMQIINLKNKJMJKIMMQLOOIMMNMLQJKKMQQ Error #2 SOURCE PRINT INCONSISTENT WITH SCREEN DISPLAYUser's Guide Reference: p. A-3 1 - You have selected the Source Print, Cross Reference, or Prototype File action with screen display as the output device. Printing text diagrams to the screen is not supported. Use the Output Device option in the ACTIONS menu to set output device to Printer or PRINT File, or change the active CLEAR diagram type to view the program tree chart or flow chart. Error #3 INCORRECT HARDWARE SETUPUser's Guide Reference: p. A-4 1 - Your PC doesn't have a graphics card installed (neither tree charts nor flow charts can be displayed on the screen using the IBM MONO adapter). If you have a CLEAR-supported graphics printer, use the Output Device option in the ACTIONS menu to redirect output to printer. If you have neither a graphics card nor a supported graphics printer, CLEAR can print only formatted source listings on your printer. 2 - Your PC has a graphics card installed, but you have specified IBM MONO adapter as graphics card type during the installation procedure. Use the Reconfigure option in the QUIT/RUN menu to set graphics card type correctly in order for CLEAR to use it. Error #4 PRINTER IS NOT READYUser's Guide Reference: p. A-4 1 - Your printer is off or unplugged. 2 - No paper is in the printer or paper is incorrectly fed. 3 - Your printer is not ON-LINE. 4 - Your printer is not properly connected. 5 - Printer is not on correct printer port of your system. Check paper supply and power connections of your printer before hitting [F10]. You MUST also verify that the printer is connected to the printer port specified during the installation procedure prior to making a hardcopy of the diagrams. If you are absolutely sure that the printer is ready, use the Reconfigure utility (QUIT/RUN menu) to de-activate the On- Line Printer Check. In some situations (e.g. when the printer is shared through a spooler or network) CLEAR can be wrong. Error #5 DOS ERROR READING FILEUser's Guide Reference: p. A-5 1 - You have changed diskettes after file selection. You have to keep the same data disk with program files in the working disk drive until the diagram is generated. Put the old diskette in the default drive and try again. 2 - Your data disk is damaged and DOS cannot access it. Try to restore your data files by copying from your backup disk or using the Norton Utilities or a similar program. Error #6 ERROR READING DIRECTORYUser's Guide Reference: p. A-5 1 - Directory specifications are not entered correctly. 2 - The directory or drive cannot be found. 3 - "FILES TO LIST" specification is incorrect. Use the Change Directory option in the FILE menu to verify the directory and "FILES TO LIST" specifications. Use the standard DOS format to specify drive and path when you set the working directory. "FILES TO LIST" has exactly the same format as that used in the DOS DIR command. You should initially set "FILES TO LIST" to *.* to work with all the files in the directory. You can later change it to *.C or *.L or some other file name setting you prefer. Error #7 UNABLE TO DELETE FILEUser's Guide Reference: p. A-5 1 - Data disk is write-protected. Remove the write-protect tab from the data disk and try deleting the file again. 2 - Error reading directory on the default drive. Your data disk has been damaged. Make a new copy from your backup disk or use the Norton Utilities or a similar program to recover the data. CLEAR will NEVER damage your diskette or hard disk files; the only file it ever writes is the CLEAR configuration file on the System disk or disk drive. 3 - You have removed the data disk from the default drive. Put the old data diskette back into the working drive and try deleting the file again. Error #8 UNABLE TO RENAME FILEUser's Guide Reference: p. A-6 1 - Data disk is write-protected. Remove the write-protect tab from the data disk and try to renaming the file again. 2 - A file with that name already exists. Try again using a different new file name. 3 - Your data disk has been damaged. Make a new copy from your backup disk or use the Norton Utilities or a similar program to recover the data. 4 - You have removed the data disk from the default drive. Put the old data diskette back into the working drive and try renaming the file again. Error #9 INCORRECT VERSION OF DOSUser's Guide Reference: p. A-6 1 - You have tried to run an external program (e.g. Text Editor or other DOS command using the [F2] key) from CLEAR, while your computer has DOS version which does not support that option. In order to use the external command control feature of CLEAR, you should upgrade your operating system to DOS version 3.0 or higher. Error #10 FLOW CHART IS TOO BIG IN FULL MODEUser's Guide Reference: p. A-7 1 - The selected program is very long and its flow chart is too big to plot using the memory available in your PC. Use the Flow Chart Option option in the Actions menu to select Control, Compressed, or Logic flow chart mode and try generating the diagram again. To remind you, control mode flow charts are rather close to full mode in size, for they represent each function call with a separate symbol. In fact, a diagram of that big a size (around 2,050 symbols) would hardly be useful for either analysis or documentation purposes. Thus, if you encounter the size problem, a more effective measure would be to change flow chart mode to compressed or logic. Error #11 INCORRECT IF BLOCK STRUCTUREUser's Guide Reference: p. A-7 1 - The selected function has a greater number of ELSE then IF statements. Use CLEAR source print of the program to find the problem. The discrepancy in logic lines on the program source print should make the blocking error readily apparent. You can directly call your Text Editor from CLEAR in order to find the problem. Once the error has been corrected, return to CLEAR and try generating the flow chart again. Error #12 INCORRECT SWITCH BLOCK STRUCTUREUser's Guide Reference: p. A-7 1 - The selected function has a CASE statement without the corresponding SWITCH command. Use CLEAR source print of the program to find the problem. The discrepancy in logic lines on the program source print should make the blocking error readily apparent. You can directly call your Text Editor from CLEAR in order to find the problem. Once the error has been corrected, return to CLEAR and try generating the flow chart again. Error #13 NO DIAGRAM TYPE SPECIFIED FOR ACTIONUser's Guide Reference: p. A-8 1 - You have tried to generate a diagram without specifying its type (all the diagram types are set to "off"). Use the Diagram Type option in the ACTIONS menu to specify the desired diagram type(s) for action. Remember that Source Print, Cross Reference, and Prototype File are invalid option when the Output Device is set to screen display, PCX file, or PIC file. Error #14 MORE THAN 2,048 FUNCTIONS IN FILE(S)User's Guide Reference: p. A-8 1 - The selected file (or group of files listed in in the .L file) has more than 2,048 functions in it. CLEAR has reached the limit set for valid file decomposition. If you are working with a set of files, we recommend that you take some of the .C files out of the list file and process them separately. If you are working with one file, which is highly unlikely, you should split it into two or more files and process them separately. Error #15 RESET DIRECTORY FAILEDUser's Guide Reference: p. A-8 1 - Directory specifications are not entered correctly. 2 - The specified directory or drive cannot be found. 3 - "FILES TO LIST" specification is incorrect. Use the Change Directory option in the FILE menu to verify the directory and "FILES TO LIST" settings. Use the standard DOS format to specify the drive and path when you set the working directory. "FILES TO LIST" specification has exactly thesame format as that used in the DOS DIR command. You should initially set "FILES TO LIST" to *.* to make sure the file name setting you are using is valid. Error #16 TWO DIAGRAM TYPES SELECTED FOR DISPLAYUser's Guide Reference: p. A-9 1 - You have selected two diagram types for screen display. CLEAR allows you to view only one diagram type at a time. Use the Diagram Type option in the ACTIONS menu to set one of the diagram types to "off." After displaying one type of diagram(s) you can return to the menu to make the other type active. Then select Go or press [F10], and you will see the other diagram type of the function. You should always make sure to press the [F9] key to set thedesired diagram types for functions you want to process. Error #17 FILE ACCESS DENIED BY DOSUser's Guide Reference: p. A-9 1 - You have incorrectly specified the drive, path, or file name of your external program. Use the External Systems option in the Reconfigure utility to verify the name and path settings for your external Text Editor, Application, or Publisher. 2 - Your CONFIG.SYS file doesn't have the right settings for the number of files and buffers. Check your Text Editor, Application, and Publisher manuals for the required number of files and buffers. Change the CONFIG.SYS file accordingly and restart the system. 3 - CLEAR cannot find COMMAND.COM file. To execute any external command CLEAR must re-allocate the COMMAND.COM file; it has to be accessible to CLEAR at all times.Error #18 PATH SPECIFICATION ERROR FOR DATA BUFFERUser's Guide Reference: p. A-10 1 - You have incorrectly specified the drive or path for the Data Buffer. 2 - You have included a subdirectory in the path for the DataBuffer which does not exist. Use the Reconfigure utility (Diagram Buffers option) in orderto verify the path. You should use the standard DOS format for defining the path, e.g. C:\PATH\PATH. CLEAR has to have access to the Data Buffer at all times during diagram generation in order to write and store temporary data files. Error #19 INSUFFICIENT MEMORY TO LOAD EXTERNAL PROGRAMUser's Guide Reference: p. A-10 1 - Your PC doesn't have enough RAM available for running the specified Application, Text Editor, or Publisher. 2 - You have memory-resident programs, such as Sidekick or special DOS device drivers, in your system's memory. Such programs considerably reduce the memory available to CLEAR. If possible, remove some of the memory-resident programs from RAM and try this operation again. Alternatively, don't attempt to run the specified External Application, Text Editor, or Publisher from within CLEAR. Error #20 RESERVED FOR FUTURE USEUser's Guide Reference: p. A-10 Error #21 DIAGRAM TYPE INCONSISTENT WITH PCX OR PIC FORMATUser's Guide Reference: p. A-10 1 - You have selected the Source Print, Cross Reference, or Prototype File action with PCX file or PIC file as the output device. PCX and PIC format of a text diagram is not supported by CLEAR. Use the Output Device option in the ACTIONS menu to set output device to Printer or PRINT File, or change the active CLEAR diagram type to program tree chart or flow chart. Error #22 NO FUNCTIONS SPECIFIED FOR FLOW CHARTUser's Guide Reference: p. A-11 1 - You have not specified any of the functions for Flow Chart action. 2 - You have edited the selected file with a Text Editor which results in clearing of the current [F9] settings. 3 - You have changed preprocessor or language which results in clearing of the current [F9] settings. You MUST use the [F9] key (again) to specify functions for which flow charts are to be generated. You can select more than one function for Flow Chart action,which allows you to continuously view flow charts of your functions, using the Previous ([F3]) and the Next ([F4]) commandkeys. Error #23 NO FUNCTIONS SPECIFIED FOR TREE CHARTUser's Guide Reference: p. A-11 1 - You have not specified any of the functions for Tree Chart action. 2 - You have edited the selected file with a Text Editor which results in clearing of the current [F9] settings. 3 - You have changed preprocessor or language which results in clearing of the current [F9] settings. You MUST use the [F9] key (again) to specify functions for which tree charts are to be generated. You can select more than one function for Tree Chart action,which allows you to continuously view tree charts of your functions, using the Previous ([F3]) and the Next ([F4]) commandkeys. Error #24 EXTERNAL PREPROCESSOR FATAL ERRORUser's Guide Reference: p. A-11 1 - CLEAR halted file or diagram processing because it received a fatal error report from the External preprocessor. To find out what that error was you should check the last line of the .i (intermediate) file created by the preprocessor. The most common cause of this fatal condition is preprocessor's inability to find all the header (or include) files which are referenced in the source code files. You should make sure that all the necessary header files are located either in the currentdata directory or in the standard-path directory specified in the Argument for Preprocessor string (Reconfigure utility). Alternatively, you can de-activate the preprocessor option whichwould also speed up the process of diagram generation and file processing. Error #25 2,048 TREE CHART SYMBOLS LIMITATION EXCEEDEDUser's Guide Reference: p. A-12 1 - The selected function makes more than 2,048 calls, CLEARis unable to offer the complete system hierarchy (or tree) chartfor your review. Reduce the number of levels to be diagrammed (to the number specified by CLEAR in the error message) using the Number of Levels option in the Tree Chart menu. You may then generate separate tree charts for every subroutine marked with the "Limitation on the number of levels" box corner shading on the tree chart of the main program. If your programs make heavy useof library functions, set External Functions to "off" using the Tree Chart Options submenu of the ACTIONS menu. Error #26 DATA BUFFER IS TOO SMALLUser's Guide Reference: p. A-12 1 - The free space available in your Data Buffer directory is insufficient to create the scratch data files necessary for flow chart or tree chart generation. 2 - CLEAR cannot write a scratch file to the Data Buffer directory, for it will exceed the DOS limitation on the number of files allowed per single directory. CLEAR requires that at least 80 K of free space be availablein the Data Buffer directory at all times. Check the Data Buffer for the free space and either delete some files from it files from it or select a different buffer using the Data Buffer option in the Configuration submenu. You can also enter the Reconfigure utility (QUIT/RUN menu) and re-define some of the paths for the four buffer choices. Error #27 2,048 FLOW CHART SYMBOLS LIMITATION EXCEEDEDUser's Guide Reference: p. A-13 1 - The selected file or procedure contains more than 2,048 recognized flow chart statements, even in Compressed or Logic mode. This does NOT mean that CLEAR imposes a 2,048 lines per program limit. A 5,000 line function could generate less than 2,000 CLEAR flow chart symbols in Compressed or Logic mode. Split the complicated code into several functions using the Structured Programming Techniques which will also make the program much easier to understand and correct. Remember that you can directly call your Text Editor from CLEAR. Error #28 GRAPHICS BUFFER IS TOO SMALLUser's Guide Reference: p. A-13 1 - The free space available in your Graphics Buffer directory is insufficient to create the scratch graphics files necessary for flow chart or tree chart display. If you are not doing so already, you can try any number of the following measures (all of which reduce graphics buffer space requirements): change flow chart mode to Logic Only, turn comments OFF, change diagram size to Reduced, etc. 2 - CLEAR cannot write a scratch file to the Graphics Bufferdirectory, for it will exceed the DOS limitation on the number of files allowed per single directory. Check the Graphics Buffer for the free space and either delete some files from it or select a different buffer using the Graphics Buffer option in the Configuration submenu. Error #29 NON-ASCII SOURCE CODE FILEUser's Guide Reference: p. A-14 1 - The selected file is not in ASCII format and CLEAR cannot process it for diagram generation. You should make sure that you are working with the right file. Remember that CLEAR generates diagrams from source code files ONLY. Error #30 NON-MATCHING BRACES FOUNDUser's Guide Reference: p. A-14 1 - The selected function doesn't have a right brace for every encountered left brace, or vice versa. You can directly call your Text Editor from CLEAR in order to find the problem. Once the error has been corrected, return to CLEAR and try generating the flow chart again. Error #31 PATH SPECIFICATION ERROR FOR FILE BUFFERUser's Guide Reference: p. A-14 1 - You have incorrectly specified the drive or path for the File Buffer. 2 - You have included a subdirectory in the path for the FileBuffer which does not exist. Use the Reconfigure utility (Diagram Buffers option) in orderto verify the path. You should use the standard DOS format for defining the path, e.g. C:\PATH\PATH. CLEAR has to have access to the File Buffer during diagram generation if the output device is set to PRINT, PCX, or PIC file. Error #32 NON-ACCESSIBLE CODE ENCOUNTEREDUser's Guide Reference: p. A-15 1 - The logical block structure of the selected file or procedure contains non-executable commands (for example, programlines after CONTINUE in a WHILE block will never be accessed). You can directly call your Text Editor from CLEAR in order to find the problem. CLEAR provides information (in the error message) on the number of the first command line for the non- executable piece of code. Once the error has been corrected, return to CLEAR and try generating the flow chart again. Error #33 INCORRECT BREAK POSITION FOUNDUser's Guide Reference: p. A-15 1 - The selected function contains a BREAK statement outsideof a WHILE loop. 2 - The selected function contains a BREAK statement outsideof a SWITCH block. You can directly call your Text Editor from CLEAR in order to find the problem. Once the error has been corrected, return to CLEAR and try generating the flow chart again. Error #34 PATH SPECIFICATION ERROR FOR GRAPHICS BUFFERUser's Guide Reference: p. A-15 1 - You have incorrectly specified the drive or path for the Graphics Buffer. 2 - You have included a subdirectory in the path for the Graphics Buffer which does not exist. Use the Reconfigure utility (Buffers option) in order to verify the path. You should use the standard DOS format for defining the path, e.g. C:\PATH\PATH. CLEAR has to have access to the Graphics Buffer during diagram generation in order to write and store temporary graphics files, if the output device is set to screen. Error #35 INVALID SYNTAX FOUNDUser's Guide Reference: p. A-16 1 - The selected function contains bad C syntax around the line number provided by CLEAR in the error message. You can directly call your Text Editor from CLEAR in order to find the problem. Once the error has been corrected, return to CLEAR and try generating the flow chart again. Please remember that CLEAR can generate accurate flow chartsONLY from source code which compiles. Error #36 FILE NOT FOUNDUser's Guide Reference: p. A-16 1 - You have entered a name of file (using the [F7] key) which is not in the working directory. Use the Change Directory option in the FILE menu to verify the directory specification. You can also use the List Directory option in the FILE menu to quickly review the list of files currently available for selection. Error #37 TREE CHART IS TOO BIG VERTICALLYUser's Guide Reference: p. A-16 1 - The tree chart is too big vertically to print on the selected printer with the active settings. You should change the settings so that the drawing becomes shorter (e.g. de-activate box rotation or decrease the number oflevels) or so that the vertical page capacity becomes bigger (e.g. select portrait mode or high-resolution printing). CLEAR does not support vertical paging for tree charts, for an 8-level tree chart fits easily (in the vertical dimension) ona single page, even in landscape mode. Error #38 INSUFFICIENT MEMORY FOR PARSINGUser's Guide Reference: p. A-17 1 - CLEAR does not have enough memory to complete parsing for the list of functions. First of all, you should remove all the memory-resident programs from RAM and try again. If the memory is still insufficient, you should take some of the .C files out of the .L file or some of the functions out of the .C file. Error #39 BACKGROUND PRINT IN PROGRESSUser's Guide Reference: p. A-17 1 - You have tried to generate a diagram to the printer while DOS background print is in progress. You MUST wait until the background print is completed beforeyou can directly generate other diagrams on the printer. If youwish to terminate the background printing, you can temporarily exit to DOS using the System option of the QUIT/RUN menu, enter "PRINT /T", and type "EXIT" to return to CLEAR. Error #40 INCORRECT CONTINUE POSITION FOUNDUser's Guide Reference: p. A-17 1 - The selected function contains a CONTINUE statement outside of a WHILE loop. You should directly call your Text Editor from CLEAR in order to find the problem. Once the error has been corrected, return to CLEAR and try generating the flow chart again. Error #41 WRONG COMMENT LOCATIONUser's Guide Reference: p. A-17 1 - You have marked for flow chart a comment line which is in a position never accessed by CLEAR during program processing, e.g. after a RETURN statement, or after a CONTINUE statement. If you wish the comment line to be included in the program flow chart, you MUST make sure that the comment line is located in an accessible position. You should apply the same rules to special comment locations as those you use to evaluate positionsof any other C program statement. Error #42 EXTERNAL PREPROCESSOR NOT FOUNDUser's Guide Reference: p. A-18 1 - You have activated External preprocessor and CLEAR cannot find the corresponding .EXE file (CPP for Turbo C, MSC for Microsoft C, or DCPP for Generic C). If you are using Language preprocessor, you should always make sure that the directory holding all of the compiler files (including the preprocessor files) is in the current path. Alternatively, you can de-activate the preprocessor option whichwould also speed up the process of diagram generation and file processing. Error #43 FILE BUFFER IS TOO SMALLUser's Guide Reference: p. A-18