#### Understanding the Syntax for the PRINT/REPORT Command

The syntax of the command is as follows:

PRINT/REPORT,EXEC MODE=END,$

TO_FILE=OFF,TOG1,$

TO_PRINTER=OFF,$

TO_DMIS_REPORT=OFF,FILE_OPTION=OVERWRITE,FILENAME=,$

REPORT_THEORETICALS=ALL,REPORT_FEATURE_WITH_DIMENSIONS=YES,$

PREVIOUS_RUNS=DELETE_INSTANCES

EXEC MODE = Because DMIS and PC-DMIS manage report data differently, this option lets you control how and when the software sends report data to DMIS and PC-DMIS output files. DMIS requires that the output filenames and other printing parameters be defined first before the program is executed. PC-DMIS, on the other hand, waits until after the part program is executed before deciding where to dump the report data. This option allows you to support both formats. It takes one of two values, either START or END.

START
This tells PC-DMIS to begin printing when it either encounters the end of program or another PRINT/REPORT command. If you import a DMIS file, and it has a print report command, it will use START as its initial value.

END
This tells PC-DMIS to print everything already executed up to this PRINT/REPORT command. If you don't import a DMIS file with a print report command, but instead insert your own PRINT/REPORT command from within PC-DMIS, it will have END as its initial value.

Important: If your part program contains more than one PRINT/REPORT command, be aware that PC-DMIS may not print some commands. For example, if your first PRINT/REPORT command uses END and your second print report command uses START, then PC-DMIS will not print everything in between.
Also if a PRINT/REPORT command uses START and then your very next print report command uses END, the second printing will be empty since the first print report command has cleared the report buffer.

TO_FILE= Use this option to indicate whether the printed report should be sent to a file (ON) or not (OFF).

AUTO= Use this option to have PC-DMIS generate the report filename automatically. When the AUTO option is selected, this keyword is followed by a numeric field, for example, AUTO=10. The name of the generated filename will have the same name as the part program appended by the numerical index and a .RTF extension. Also, the generated file will be located in the same directory as the part program. If a file exists with the same name as the generated filename, AUTO will increment the index until a unique filename is found.

TOG1 This value controls the action taken when printing to a file. The options available are APPEND / AUTO / OVERWRITE / PROMPT. Depending on the option selected, different information may appear.

OVERWRITE
Use this option to overwrite report information to the specified filename. When the OVERWRITE option is selected, this keyword is followed by a filename field, for example, OVERWRITE=D:\REPORTS\FILE001.RTF. Note that the complete path must be specified otherwise PC-DMIS will assume the same directory as the part program. Also, if the file does not exist, it will be created when the PRINT/REPORT command is executed.

APPEND
Use this option to append report information to the specified filename. When the APPEND option is selected, this keyword is followed by a filename field, for example, APPEND=D:\REPORTS\FILE001.RTF. Note that the complete path must be specified otherwise PC-DMIS will assume the same directory as the part program. Also, if the file does not exist, it will be created when the PRINT/REPORT command is executed.

PROMPT
Use this option to cause PC-DMIS to query the user, via a Save As dialog box, for the filename to which the report information will be written.

TO_PRINTER= Use this option to indicate whether the printed report should be sent to the printer (ON) or not (OFF).

TO_DMIS_REPORT= Use this option to determine whether or not PC-DMIS will send the report to a DMIS Output file (.dmo) specified in FILENAME. This can be ON or OFF.

FILENAME= Use this option to specify a DMIS output directory location and filename. If TO_DMIS_REPORT is set to ON, then PC-DMIS stores the report data in the file specified. For example, if this field had d:\pcdmisreports\mydmis.dmo, PC-DMIS cause the report data to be saved in that DMIS file in that location.

FILE_OPTION= This option lets you choose one of the following file options for your DMIS file output:

APPEND
This appends the report data to the end of the DMIS file specified in FILENAME.

OVERWRITE
This overwrites the DMIS file specified in FILENAME with the latest report data.

INDEX
This appends to the DMIS filename specified in FILENAME a numerical value that increments on subsequent part program executions. For example, if FILENAME is mydmis.dmo, it would become mydmis001.dmo, then mydmis002.dmo, then mydmis003.dmo, and so forth, similar to the AUTO= option.

REPORT_THEORETICALS= This tells how PC-DMIS reports theoretical values in the DMIS output file.

ALL
PC-DMIS outputs all theoretical values along with the measured values to the output DMIS file.

NONE
No theoretical values are included in the report.

IMPORT_SETTINGS
Only those theoretical values explicitly output by the original DMIS program are output in the report.

REPORT_FEATURE_WITH_DIMENSIONS= This determines whether or not PC-DMIS will keep the measured features and associated tolerances together in the output file. It takes either YES or NO.

YES
In the DMIS report file, PC-DMIS writes the measurement results immediately before their associated tolerance results for each dimension associated to the feature itself. If a feature is not associated with any tolerance, PC-DMIS will not generate any output.

NO
In the DMIS report file, PC-DMIS writes the measurement results exactly when the feature is measured and not later when PC-DMIS executes the associated dimensions.

PREVIOUS_RUNS= This option is particularly useful when using the PRINT/REPORT command from within a loop. When a feature is measured more than once in a single execution, previous instances of that feature's measured data are saved. Use TOG2 to have PC-DMIS delete (DELETE_INSTANCES) or keep (KEEP_INSTANCES) the saved measured data.