Topic: DMD0279

Insert Instructions from a File

This utility is used to import new ladder logic instructions from a text file into an existing ladder logic program. The contents of the text file can be an entire code-block which will be imported as a complete code-block, or it can contain just ladder logic instructions that will be added to a code-block that already exists in the project. The source text file can optionally include element documentation, and rung comments.

 

Insert Instructions from a File is opened by selecting the Tools-> Insert Instructions from File... menu selections, or by clicking the Insert Instructions button on the Tools toolbar.

 

 

Instruction Import Method - these selections determine how the new instructions are to be interpreted and where the new instructions will be placed in the project

As Code Blocks - select this option if the file contains one or more code-blocks that should be imported as new code-blocks in the current project

 

As Rungs of Logic - select this option if the file contains ladder logic instructions that should be imported into an existing code-block

 

  • Import Rungs into Code-Block - designates the destination code-block, click the down arrow to select from the list of Programs and Tasks
     

  • Insert at Beginning - the new instructions will be inserted at the top of the code-block, all existing rungs will be shifted down as needed to make room for the new instructions
     

  • Insert at End - the new instructions will be appended to the end of the code-block
     

  • Insert Before Rung Number - the new instructions will be inserted before the user-designated rung number, rungs existing after the specified rung number will be shifted down to make room for the new instructions.

 

Documentation Import Method - this selection specifies what to do with the Element Documentation found in the import file.

 

  • Merge (.PRJ Priority) - if both the code-block and the import file have documentation for the same element, the element documentation from the existing code-block is retained.

     

  • Merge (.TXT Priority) - if both the code-block and the import file have documentation for the same element, the element documentation from the import file is used to overwrite the element documentation in the existing project.

     

  • Ignore Element Documentation - the element documentation in the code-block file is retained and none of the element documentation from the import file is used.

 

Ignore MEM_CONFIG Sections

 

This option enables / disables the inclusion of the memory configuration from the import file. The mem_config sections will contain the heap item and/or memory block configuration data that are required by the instructions to be imported. Normally this option should be unchecked, which will include the mem_config sections.

 

See Also: