Using Picture Editor MPRINT to create DX Files
Honeywell LCN document reference "Picture Editor Reference Manual" details use of the MPRINT command to create the Schematic DX debug files that can be imported into Control Architect for providing entity references and mapping between LCN schematics and configuration entities.
Picture Editor Reference Menu excerpt
3.4.3 Multiple Print Command
Command: MPRINT <pathname>
Abbreviated forms: MPRN <pathname>
MPR <pathname>
MP <pathname>
where <pathname> is a pathname to a Schematic List file.
Use—The Multiple Print command accesses a file that contains a list of schematic source files. It
then attempts to generate a schematic print file for each source file named on the list. There is no
output to the printer. In addition, it generates a file that contains the result of each print request.
The results file is created in the same directory as the schematic list file. The print file contains a
list of objects and text in the picture, including their coordinates, colors, priorities, behaviors, and
target actions.
Schematic List File—Before executing the MPRINT command you must build a Schematic List
file with the Text Editor. The file name can contain up to 8 characters and must end with a .EL
suffix. EL stands for edited list. While using the Picture Editor, you can press the ESC key to
temporarily use the Text Editor. Hold down CTL and press HELP when you are ready to return
to the Picture Editor.
REFERENCE: For details on the Text Editor, refer to the Text Editor Operation manual.
Note that when the MPRINT command is executed, the Default Pathname is initialized to that
path specified for the Schematic List file. As explained below, this may be important if files
specified on the list use a partial pathname.
Within the Schematic List file:
Any line beginning with { (a left curly brace) is treated as a comment line and is not executed.
If a comment requires more than one line, each line must begin with {to be treated as a
comment. A right curly brace (}) is optional at the end of a comment line.
Schematic source file names can be specified with a full or partial pathname. The .DS extension is
optional. If a partial pathname is specified, it is used in conjunction with the Default Pathname.
Specification of a full pathname reinitializes the Default Pathname.
An example of a Schematic List file follows:
$F2>WORK>SCHEM1
NET>HMV1>SCHEM2.DS
{The following file should execute as NET>HMV1>SCHEM3.DS}
SCHEM3.DS
{The next file should execute as NET>HMV1>SCHEM4.DS}
SCHEM4
Picture Editor Reference Manual 39 08/2016
{Use of the right curly brace on comments and addition {of
the .DS extension on source files is optional.
Procedure—On the command line, type MPRINT followed by a full or partial pathname for the
Schematic List file, then press the ENTER key.
For example: MPRINT NET>HMV1>SLIST
The Default Pathname is modified to use the supplied name. Refer to the Set Pathname
command for acceptable forms of the pathname. Press ENTER to continue or press CANCEL to
cancel the command. After pressing ENTER, execution begins and continues until each file on
the list is processed.
If you wish to halt before the operation is complete, hold down CONTROL and press BREAK.
After the current file is processed, the operation is aborted.
Options—within the Schematic List file, several options can be added following the Schematic
Source file names:
• APPEND will append the printed information to the existing print file for that
source file.
• COMMENT will print only the comment sentences for that source file.
• DEBUG will include the debug sentences for that source file.
• SYMBOLS will print only the symbols sentences for that source file.
For example: NET>HMV1>SCHEM1 DEBUG
Errors—If an error occurs during execution, a print error is placed in the Results file and
processing of the list file continues.
If the storage media becomes full during execution of the Multiple Print command, a print error
is placed in the Results file for that schematic name and all remaining schematic names in the list
file. If the Results file cannot be written to the storage media, then an error message appears on
the screen.
Each Schematic Print file is generated in the same directory as its respective schematic source
file. The Print file has the same name as the Schematic Source file, but has a .DX suffix.
Each Schematic Print file is ASCII formatted. Any Schematic Print file with the same name that
existed before executing the Multiple Print command is overwritten (except see the Append
option).
Results File—A Results file is produced by the Multiple Print command. It is generated in the
same directory and with the same name as the Schematic List file except it has a suffix of .ER.
Press the ESC key to temporarily use the Command Processor. Use the Print command to view
the Results file. For example, PR Net>HMV1>SLIST.ER.
The Results file contains one line for each executable file name specified in the Schematic List
file. Each line shows the full or partial file pathname and a print status. List file comments are
Picture Editor Reference Manual 40 08/2016
not included. The .DS suffix does not appear in the Results file even if it was used in the
Schematic List file.
If a previous Results file with the same file name exists, it is overwritten.
Only the first 30 characters of a defined pathname for each line in the list file appear in the
Results file.
If the Multiple Print operation is halted by pressing the CONTROL-BREAK keys, the Results
file contains the message: Aborted by User Request.
An example of a Results file is:
$F2>WORK>SCHEM1 Success!
NET>HMV1>SCHEM2 Print Operation Failed
SCHEM3 Read Operation Failed
SCHEM4 Success!
To view the individual schematic print files, escape from the Picture Editor, then use the
Command Processor functions to view each file. For example:
PR NET>HMV1>SCHEM1.DX.
If you precede the print command with a Data Out command to the printer (DO $Pn), you can
obtain a paper copy.
