You are on page 1of 136

B0193AV REV P

I/A Series Integrated Control Configurator


October 1, 2004

Ladder Logic

Continuous
EXACT_MV

Sequence Logic

Ladder Logic

Continuous
Sequence Logic
EXACT_MV

Continuous
EXACT_MV

Invensys, Foxboro, FIO, I/A Series, SPEC 200, SPECTRUM, and UFM are trademarks of Invensys plc, its subsidiaries, and affiliates. All other brand names may be trademarks of their respective owners. Copyright 1990-2004 Invensys Systems, Inc. All rights reserved

SOFTWARE LICENSE AND COPYRIGHT INFORMATION Before using the Invensys Systems, Inc. supplied software supported by this documentation, you should read and understand the following information concerning copyrighted software. 1. The license provisions in the software license for your system govern your obligations and usage rights to the software described in this documentation. If any portion of those license provisions is violated, Invensys Systems, Inc. will no longer provide you with support services and assumes no further responsibilities for your system or its operation. 2. All software issued by Invensys Systems, Inc. and copies of the software that you are specifically permitted to make, are protected in accordance with Federal copyright laws. It is illegal to make copies of any software media provided to you by Invensys Systems, Inc. for any purpose other than those purposes mentioned in the software license.

Contents
Figures.................................................................................................................................... ix Tables..................................................................................................................................... xi Preface................................................................................................................................. xiii Revision Information ............................................................................................................. xiii Reference Documents ............................................................................................................ xiii 1. Introduction ...................................................................................................................... 1 Document Structure ................................................................................................................. 1 Pointing Devices ....................................................................................................................... 2 Keys Used in ICC ..................................................................................................................... 3 One Function at a Time ............................................................................................................ 3 Selecting Functions and Menu Items ........................................................................................ 3 Menu Icons ............................................................................................................................... 4 Invoking the ICC ...................................................................................................................... 4 AP/AW Hosts ........................................................................................................................... 5 Configuring Hosts, Control Stations, and Volumes .................................................................. 5 Editable Work Areas ................................................................................................................. 6 Configuration Files ................................................................................................................... 7 Station File ................................................................................................................................ 7 Library Volume ......................................................................................................................... 8 Work Volume ........................................................................................................................... 8 ICC Print Configuration ........................................................................................................... Printer Configuration Files ................................................................................................... Printer Configuration Parameters ......................................................................................... Printer Configuration ........................................................................................................... Notes On Printer Configuration .......................................................................................... 8 8 9 9 9

2. The Compound Summary Access Utility ........................................................................ 11 CSA Conventions ................................................................................................................... 11 Selecting Compound Name .................................................................................................... 12 Searching by Character or Character String ............................................................................. 13 Searching for Compounds by Block Name .............................................................................. 13 Searching for Compounds by Block Type ............................................................................... 13
iii

B0193AV Rev P

Contents

Creating a New Compound from CSA ................................................................................... 14 Selecting the OK Key in CSA ................................................................................................. 14 Selecting the Vol Key in CSA .................................................................................................. 15 Selecting the Close Key in CSA ............................................................................................... 15 Selecting Station Type to Edit ................................................................................................. 15 Selecting a Control Processor to Configure ............................................................................. 16 Select Screen ........................................................................................................................... 17 3. Compounds, Blocks, and ECBs ....................................................................................... 19 ICC Basics and Conventions ................................................................................................... 19 Compound Functions ............................................................................................................. Insert New Compound ...................................................................................................... Edit Compound Parameters ............................................................................................... Copy to Paste Buffer .......................................................................................................... Copy and Append to Paste Buffer ...................................................................................... Paste from Paste Buffer ....................................................................................................... Save to Diskette .................................................................................................................. Load from Diskette ............................................................................................................ Move Functions ................................................................................................................. Upload ............................................................................................................................... Delete ................................................................................................................................. Delete (Compound, Block, or ECB) .................................................................................. Delete & Undelete (Compound, Block, or ECB) .......................................................... Cancel ........................................................................................................................... View Blocks/ECBs in this Compound ................................................................................ 19 21 23 24 25 25 25 27 29 31 32 32 32 32 32

Block/ECB Functions Display ................................................................................................ 33 View Compound List .............................................................................................................. 33 Insert New Block .................................................................................................................... 33 Block Name Window .............................................................................................................. 35 Block Type Window ............................................................................................................... 36 Show Block Type Names Window .......................................................................................... 37 Edit Block Parameters Window .............................................................................................. 38 Copy a Block .......................................................................................................................... 38 Block Order ............................................................................................................................ 39 Insert New ECB ...................................................................................................................... 40 ECB Functions Menu ............................................................................................................. 43 ECB Name Window ............................................................................................................... 44 ECB Type Window ................................................................................................................ 45 ECB Device Identification Window ........................................................................................ 46 Copy ECB .............................................................................................................................. 46
iv

Contents

B0193AV Rev P

Edit Block/ECB Parameters .................................................................................................... 47 Warning and Error Messages ................................................................................................... 48 Edit Sequence Logic ................................................................................................................ 50 Edit Ladder Logic ................................................................................................................... 50 Rename Block/ECB ................................................................................................................ 51 4. Menu Bar Functions........................................................................................................ 53 Show Menu ............................................................................................................................. 53 Diskette Directory .............................................................................................................. 53 FBM Menu ............................................................................................................................. 54 Fix All Function ................................................................................................................. 54 Ladder Assignment Function .............................................................................................. 54 Print Menu ............................................................................................................................. 55 New Menu .............................................................................................................................. 55 Checkpoint Menu ................................................................................................................... 55 Maint Menu ........................................................................................................................... LoadAll .............................................................................................................................. SaveAll ............................................................................................................................... SaveAll w/Fmt .................................................................................................................... LoadAll/SaveAll for Batch Processing ................................................................................. Shrink ................................................................................................................................ Initialize ............................................................................................................................. Format Floppy ................................................................................................................... Eject Floppy ....................................................................................................................... 56 56 56 57 57 58 58 58 58

Buffer Menu ........................................................................................................................... 58 Cancel/Done ........................................................................................................................... 59 Exit Menu ............................................................................................................................... 59 5. Block Parameter Connections ......................................................................................... 61 Mixed Data Types ................................................................................................................... 61 Boolean Connection Extensions .............................................................................................. General Format of Boolean Connection Extensions ........................................................... Boolean Extensions to Source Data .................................................................................... Boolean Extensions to Source Status .................................................................................. Boolean Extensions to Status Parameters ............................................................................ Block Status Symbols ..................................................................................................... Alarm Status Symbols .................................................................................................... Packed Boolean Connection Extensions ........................................................................ 63 64 65 66 67 68 69 70

Defaults for Integer and Real Connections .............................................................................. 71 6. Editing Ladder Logic ....................................................................................................... 73 Entering and Exiting the Ladder Logic Editor ......................................................................... 73
v

B0193AV Rev P

Contents

Getting Help ........................................................................................................................... 73 Editing a Ladder Diagram ....................................................................................................... Creating/Modifying Functions ........................................................................................... Positioning Editing Cursor ............................................................................................ Adding or Replacing a Symbol ...................................................................................... Showing Symbols .......................................................................................................... Connecting Two Rows .................................................................................................. Deleting a Symbol ......................................................................................................... Deleting a Rung Descriptor ........................................................................................... Entering Text Associated with a Symbol ........................................................................ Entering a Rung Descriptor ........................................................................................... Adding or Deleting a Ladder Row ................................................................................. Selecting Library Functions ..................................................................................................... View Library ...................................................................................................................... Copy From Library ............................................................................................................ Save In Library ................................................................................................................... Cancel ................................................................................................................................ 74 78 78 80 81 81 82 82 82 84 85 85 85 85 86 87

Printing a Ladder Diagram ...................................................................................................... 87 Checking Syntax ..................................................................................................................... 87 Ladder Installation .................................................................................................................. Installation Requirements ................................................................................................... Uninstallation .................................................................................................................... Prerequisites for Ladder Installation ................................................................................... Causes of Installation Failure .............................................................................................. PLB Ladder Display Installation ......................................................................................... 50 Series Workstation Access ......................................................................................... Location of Ladder Displays .......................................................................................... Configuring Ladder Display Location ................................................................................ 87 88 88 88 89 89 90 90 90

7. Editing Sequence Logic ................................................................................................... 93 Help ........................................................................................................................................ 94 Sequence Files ......................................................................................................................... 94 Source File ......................................................................................................................... 95 Compiler Files .................................................................................................................... 95 Sequence Logic Functions ....................................................................................................... 96 Cancel ................................................................................................................................ 96 Compile Source of this Block ............................................................................................. 96 Copy Source of this Block from Library ............................................................................. 97 Delete Block Source from Library ...................................................................................... 99 Done With Sequence ....................................................................................................... 101 Edit Source of this Block .................................................................................................. 101 Print Compilation Listing ................................................................................................ 105 Print Listing of this Block ................................................................................................. 105 Save Source of this Block to Library ................................................................................. 106 View Compilation Listing ................................................................................................ 108

vi

Contents

B0193AV Rev P

View Include Library Contents ........................................................................................ 109 View Source Library Contents .......................................................................................... 110 Sequence Code Installation ................................................................................................... 110 50 Series Workstation Access ............................................................................................ 111 High Level Batch Language Documentation ......................................................................... 111 Index .................................................................................................................................. 113

vii

B0193AV Rev P

Contents

viii

Figures
1-1. 1-2. 2-1. 2-2. 2-3. 2-4. 3-1. 3-2. 3-3. 3-4. 3-5. 3-6. 3-7. 3-8. 3-9. 3-10. 3-11. 3-12. 3-13. 3-14. 3-15. 3-16. 3-17. 3-18. 3-19. 3-20. 6-1. 7-1. 7-2. 7-3. 7-4. 7-5. 7-6. 7-7. AP Host_Cfg Dialog Box .............................................................................................. 5 Editable Work Areas ..................................................................................................... 7 Compound Summary Access ....................................................................................... 12 Selecting Volume Key from the CSA Utility Screen .................................................... 15 Override Lock Display ................................................................................................ 16 Compound and Block Overview Display .................................................................... 17 Compound Function Display ..................................................................................... 20 Compounds Functions Menu ..................................................................................... 21 Compound Name Window ........................................................................................ 22 Compound Parameters List ......................................................................................... 23 Save to Diskette Dialog Box ........................................................................................ 26 Selected Device ........................................................................................................... 26 Load from Diskette ..................................................................................................... 28 Select Device for Load from Diskette .......................................................................... 28 Moving Objects .......................................................................................................... 30 Delete and Undelete .................................................................................................... 32 Block/ECB Functions Display .................................................................................... 33 Enter New Block Location .......................................................................................... 35 Enter Block Type ........................................................................................................ 36 Show Block Type ........................................................................................................ 37 Edit Block Parameters ................................................................................................. 38 Block Order within a Compound ............................................................................... 40 Insert New ECB .......................................................................................................... 43 Enter Name of New ECB ........................................................................................... 44 ECB Type Window .................................................................................................... 45 ECB Device Identification Window ............................................................................ 46 Data Fields .................................................................................................................. 77 Block/ECB Functions Menu ....................................................................................... 93 Sequence Logic Functions Menu ................................................................................. 94 Copy Source of This Block From Library .................................................................... 98 Delete Block Source From Library ............................................................................ 100 Save Source of this Block to Library .......................................................................... 107 View Include Library Contents ................................................................................. 109 View Source Library Contents ................................................................................... 110

ix

B0193AV Rev P

Figures

Tables
1-1. 1-2. 2-1. 5-1. 6-1. 6-2. 6-3. 6-4. 6-5. Cursor Movement ......................................................................................................... 3 Menu Icons ................................................................................................................... 4 Detail Buttons ............................................................................................................. 18 Valid Mixed Data Peer-to-Peer Connections ............................................................... 63 Field Inputs ................................................................................................................. 74 Cursor Control ........................................................................................................... 74 Editing Keys ................................................................................................................ 75 Symbol Keys ............................................................................................................... 76 Technical Identifiers .................................................................................................... 77

xi

B0193AV Rev P

Tables

xii

Preface
This document is intended for use by process control and applications engineers. It provides specific information and procedures for configuring your process control database including Fieldbus Modules, equipment control blocks, compounds, and blocks and their parameters. Complete block descriptions and lists of their parameters are found in Integrated Control Block Descriptions (B0193AX).

Revision Information
For Release 8.0, the following changes were made to the document: Changed references to Windows NT to Windows. Added references to Fieldbus Communication Modules where appropriate. Removed Chapter 8, Sequence Language, Chapter 9, HLBL Statements, and Appendix A, Sequence Control Printed Error Messages. These topics are covered in detail in High Level Batch Language (HLBL) Users Guide (B0400DF). Chapter 4 Menu Bar Functions Added the FCM100 Addresses Show menu entry Chapter 5 Block Parameter Connections Added relevant status indicators to Block Status Symbols on page 68 and Alarm Status Symbols on page 69.

Reference Documents
Refer to the following documents for additional information: Integrated Control Software Concepts (B0193AW) Control Processor 270 (CP270) Integrated Control Software Concepts (B0700AG) (for V8.0 systems) Integrated Control Block Descriptions (B0193AX) Integrated Control Configurator Application Programming Interface (B0193NE) Intelligent Transmitter Maintenance Workbench and Configurator (B0193MW) Display Engineering for FoxView Software and Display Manager Software (B0193MQ) System Management Displays (B0193JC) Fieldbus Cluster I/O Users Guide (B0193RB)

SPECTRUM Migration Integrator Users Guide (B0193RC) SPEC 200 Control Integrator Users Guide (B0193RD) OpenWindows Users Guide SUN OS Users Guide.

xiii

B0193AV Rev P

Preface

xiv

1. Introduction
This chapter serves as an introduction to the Integrated Control Configurator (ICC) and covers selecting functions and menu items, invoking and configuring the ICC and configuration files including station files, library volume, and work volume. The Integrated Control Configurator (ICC) is intended for use by process control and applications engineers. It provides procedures for configuring your process control database including Fieldbus Modules, equipment control blocks, compounds, and blocks and their parameters.
NOTE

Windows Platform Users: All references in this document to control processors or control stations should be interpreted to mean the processor. Once you have physically connected your system and loaded the appropriate software through the System Definition, you can begin using ICC. The best way to become familiar with the ICC is to just sit down and use it. Use a pointing device (mouse or trackball) to make selections. ICC Help on the Electronic Documentation CD-ROM provides the information on ranges, parameters, and so forth. Compound and block parameters have a default value. Therefore, you can build simple compounds/blocks before you learn all the parameters and their functions. This feature saves time when building control structures for general applications use.
NOTE

The Integrated Control Configurator is an initial condition configurator; that is, updates to parameter values from run-time displays are not automatically passed back to the configuration. You must use the update function to update the configuration.

Document Structure
The Integrated Control document set consists of: Integrated Control Software Concepts (B0193AW) (pre-V8.0 systems) Control Processor 279 (CP270) Integrated Control Software Concepts (B0700AG) (V8.x systems) Integrated Control Block Descriptions (B0193AX)

Integrated Control Configurator (B0193AV) Intelligent Transmitter Maintenance Workbench and Configurator (B0193MW).

B0193AV Rev P

1. Introduction

Integrated Control Software Concepts (B0193AW or B0700AG) contains conceptual information of the control software. It also contains: SCIX tables Parameter list Ranges. The Integrated Control Block Descriptions (B0193AX) document contains descriptions of each block, along with data diagrams and parameter list. This document, Integrated Control Configurator (B0193AV), describes the ICC functions and how to use them. The chapters in this document contain the following information: Chapter 1 Introduction Chapter 2 The Compound Summary Access Utility Chapter 3 Compounds, Blocks, and ECBs Chapter 4 Menu Bar Functions Chapter 5 Block Parameter Connections Chapter 6 Editing Ladder Logic Chapter 7 Editing Sequence Logic. Intelligent Transmitter Maintenance Workbench and Configurator (B0193MW) describes how to configure intelligent field devices. High Level Batch Language (HLBL) Users Guide (B0400DF) describes the HLBL and Sequence Languages.

Pointing Devices
The cursor is the primary means for making menu selections and for selecting ICC functions or data fields. Cursor control is available through the touchscreen, a pointing device (mouse or trackball), or keyboard cursor control keys. A menu or function is selectable if it is highlighted, or when it highlights or frames as the mouse moves over it. In some functions, auxiliary keystrokes from an alphanumeric keyboard are necessary for implementation. Two examples are: Typing in an expected name or value. Pressing Enter or Return to enter a selection. The pointing device can also be used to select compound or block parameters during the compound and block-building processes. This enables you to move quickly around in the list rather than in a line-by-line order that the vertical arrow keys dictate.

1. Introduction

B0193AV Rev P

Keys Used in ICC


In addition to the standard alphanumeric keys, ICC recognizes keys (refer to Table 1-1) that direct: Cursor movement Deletions Entries.
UNIX Platform Users Only:

Ladder logic uses other keys as well, for example, the function keys, Escape key, and Insert, to name a few.
All Users:

Table 1-1 describes the general control keys.


Table 1-1. Cursor Movement

Key or Keys Horizontal Arrows Vertical Arrows* (One Line Scroll) 5 (Numeric Keypad)
Backspace Delete Insert Return/Enter Shift+Delete Shift+End Shift+Home * Or use pointing device

Function Move cursor horizontally to next or previous character position. Move cursor vertically to corresponding position in next or previous row. Select an entry field once the cursor is positioned. Delete previous character of the current field (if any). Delete current character cursor does not move. Insert character(s) at the current cursor position. Press to confirm user input expected by the ICC. Delete all characters on current line in the parameter list. Move cursor to the end of the current entry field. Move cursor to the beginning of the current entry field.

One Function at a Time


In general, ICC functions must be completed or cancelled before another function can begin. For example, if you are in the process of inserting a block, you cannot select another action from the menu bar until the insert is complete. Exceptions are Help and Show.

Selecting Functions and Menu Items


Some functions can be selected either by pointing device or keyboard. When the ICC is expecting input from a pointing device, this document uses Select <function or menu item>.
3

B0193AV Rev P

1. Introduction

When the ICC is expecting input from the keyboard, this document uses Press <key name> or Type.

Menu Icons
Menus that allow cursor movement within a list have icons (refer to Table 1-2) at the bottom of each menu window.
Table 1-2. Menu Icons

Icon Single Up/Down Arrow Double Up/Down Arrow Double Up/Down Arrow with a Rule Octagon

Function Move the highlighted cursor up or down one item. Move the highlighted cursor to the previous page or to the next page. Move the highlighted cursor to the beginning or end of the list. Close the window.

Invoking the ICC


The Integrated Control Configurator resides with other configurators in the process engineers environment.
UNIX Platform Users:

From the engineers environment at a UNIX-based workstation processor (WP) or application workstation (AW), select:
Config

from the menu bar. From the list of configurators that appears, select:
Control_Cfg

which takes you to the following submenu:


CIO_Config CIO_AP_Cfg CIO_STN_Cfg CIO_VOL_Cfg

Selecting CIO_Config invokes the first display of the ICC, the Compound Summary Access (CSA) search utility. The other three are used to configure or display a list of workstation hosts, control stations, or volumes from which or for which an ICC session can be directly invoked.
Windows Platform Users:

From the engineers environment at an AW70, select:


Config

from the menu bar. Selecting CIO_Config invokes the first display of the ICC, the Compound Summary Access (CSA) search utility.

1. Introduction

B0193AV Rev P

AP/AW Hosts
UNIX Platform Users Only:

The ICC executes in an AP/AW, performing remote-draws to the WP. When the CSA compound menu is displayed, the right-hand side of the title shows the letterbug of the AP/AW in which the information resides. Whenever a library or station volume is selected which is not hosted by the AP/AW noted in the title, execution of the ICC transfers from that AP/AW to the AP/AW which hosts the selected station or volume. To configure a list of AP/AWs from which an ICC session can be invoked, see Configuring Hosts, Control Stations, and Volumes on page 5.

Configuring Hosts, Control Stations, and Volumes


UNIX Platform Users Only:

Initial selection of the following options allows you to configure a menu listing all AP/AW hosts, control stations, or volumes from which or for which you wish to directly invoke a ICC session:

CIO_AP_Cfg CIO_STN_Cfg CIO_VOL_Cfg.

After initial selection of the CIO_AP_Cfg, CIO_STN_Cfg, and CIO_VOL_Cfg, a dialog box appears (refer to Figure 1-1).

Figure 1-1. AP Host_Cfg Dialog Box

You use this dialog box to add workstation hosts, control stations, or volumes to the appropriate menu listing, or to delete them. To add AP/AW hosts, control stations, or volumes to the appropriate menu listing: 1. Select the appropriate submenu entry: CIO_AP_Cfg, CIO_STN_Cfg, or CIO_VOL_Cfg. 2. When the dialog box appears, enter All or an individual AP/AW host, control station, or volume name. Press Enter.
NOTE

The entry box is case sensitive. For AP/AW hosts and control stations enter each letterbug in uppercase. For volumes, enter the volume name in lowercase. 3. Select Add. If individual entries are being made, continue to enter the letterbugs or names and select Add after each entry.
5

B0193AV Rev P

1. Introduction

4. A message appears in the message line for each AP/AW, control station, or volume that has been successfully added to the menu or failed addition to the menu. 5. Select Close to close the dialog box. To delete AP/AW hosts, stations, or volumes from the appropriate menu listing: 1. Select the appropriate submenu entry: CIO_AP_Cfg, CIO_STN_Cfg, or CIO_VOL_Cfg. 2. When the dialog box appears, enter All or an individual AP/AW host, control station, or volume name. Press Enter.
NOTE

The entry box is case sensitive. For AP/AW hosts and control stations enter each letterbug in uppercase. For volumes, enter the volume name in lowercase. 3. Select Delete. If individual entries are being made, continue to enter the letterbugs or names and select Delete after each entry. A message appears in the message line for each AP/AW, control station, or volume that has been successfully deleted from the menu. To access the list of AP/AW hosts, control stations, or volumes from which to directly initiate a configuration session: 1. After configuring the appropriate menu listings, select the appropriate option from the Control_Cfg submenu:

CIO_AP_Cfg CIO_STN_Cfg CIO_VOL_Cfg.

2. A menu listing the configured AP/AW hosts, control stations, or volume names for direct access to an ICC session appears. The first entry in each menu listing provides access to the configuration dialog box: APhost_Cfg, Station_Cfg, and Volume_Cfg. Select the desired host, control station, or volume name to initiate the session. When the logical AP host of a WP50 is not configured for the ICC, one of the three new menu picks, CIO_AP_Cfg, CIO_STN_Cfg, or CIO_VOL_Cfg, must be used to access the ICC.

Editable Work Areas


The editable work areas of the ICC (refer to Figure 1-2) are configuration files and a paste buffer. Configuration files consist of both station files and library volumes and are accessed from the CSA utility.
UNIX Platform Users Only:

Configuration files can also be accessed from a direct menu pick of an AP/AW, control station, or volume accessible from the Control_Cfg submenu.
All Users:

The Paste Buffer is an ICC function, and is accessed from the ICC menu bar. Editable file areas are illustrated below.

1. Introduction

B0193AV Rev P

EDIT SESSION

CHECKPOINT FILE
REBOOT

STATION FILE
LOAD/PASTE/EDIT

PASTE COPY

PASTE BUFFER

PASTE COPY

LIB/WORK VOLUME

CHECKPOINT

UPLOAD

CP

LOADALL/SAVEALL LOAD FROM DISKETTE SAVE TO DISKETTE

Figure 1-2. Editable Work Areas

Configuration Files
A configuration file is either a station file, library volume, or work volume. A station file is a set of control compounds installed in a control processor or an AW70. A library volume is a set of uninstalled compounds. A work volume bears the same characteristics as a library volume without a given identifier. This provides a scratchpad volume in which to build compounds before selecting an eventual ICC file destination. These files can be directly accessed through the Vol key from the CSA utility, or indirectly by selecting a compound from the CSA utility.

Station File
When you select a station file to edit: A copy of the current data in a control station (or the AW70 processor) is provided for editing.

Editing is done in an active mode, which means that the control processor is connected. There is data validity checking and linkage to the process. The message line beneath the menu bar indicates that you are editing a station file in a station hosted by the designated AP, for example,
STA = <station name> @ AP <letterbug>.

Following the completion of a station edit, a check point of the control processors database is automatically initiated.

B0193AV Rev P

1. Introduction

Library Volume
When you select a library volume to edit: There is no control processor connected. Editing is done in an inactive mode. There is no data validity checking and linkage to the process.

The message line beneath the menu bar indicates: VOL = <volume name> @ AP <letterbug of hosting AP>. VOL = [volume name] @ AP [letterbug of hosting AP].

Work Volume
You can access a scratchpad work volume from the CSA utility by selecting OK when a new, system-unique, compound name is entered in the Choice field (or the Choice field is blank). The work volume (Volwrk) provides a place to create and edit compounds before assigning them to a particular library volume or station file. There is only one Volwrk (default name) in the system. In Volwrk, you have complete access to all the appropriate ICC functions. When you are finished editing, you can copy the compound to a target configuration file using the copy and paste functions. See Copy to Paste Buffer on page 24.

ICC Print Configuration


Following is a discussion of printer configuration for the Integrated Control Configurator (ICC). The default printer configuration for ICC printed output is the Unix/Solaris standard of 66 lines per page. A partial page is filled out by blank lines up to a full page size of 66 lines. If you want a different page format, you perform the reconfiguration by modifying the file print_cfg.usr.

Printer Configuration Files


The file print_cfg.usr is located in the directory /opt/fox/ciocfg/ciocfg_printers. There are two other files, print_cfg.src and print_cfg.old. print_cfg.usr is the version of the file actually used by the ICC. You modify this file to effect changes in ICC printing format. print_cfg.src is the configuration file initially installed as part of the ICC package. print_cfg.old is a reference version of print_cfg.usr that is used by the software installation process to determine whether changes have been made to the print_cfg.usr file. During the software installation process, the new version of the configuration file, print_cfg.src is copied to print_cfg.usr and print_cfg.old. Any previous versions of these files are lost. If you have modified print_cfg.usr, the new file print_cfg.src is not copied and warning messages are generated in the ICC install log. This means that if you have customized the printer configuration, a new installation of the ICC does not disable the customized file. The ICC install process determines whether the file print_cfg.usr has been modified by comparing it with the previously saved file print_cfg.old. If the files are different, it is assumed that you have modified the file print_cfg.usr.
8

1. Introduction

B0193AV Rev P

In order to customize printer configuration, modify only the print_cfg.usr file. You should not modify other files in the ciocfg_printers directory. To perform configuration file edits on Solaris platforms, go to VT100 mode, then change the directory (cd /opt/fox/ciocfg/ciocfg_printers), then use a text editor to edit the print_cfg.usr file. To perform configuration file edits on Windows platforms, go to the Notepad, then go to the directory /opt/fox/ciocfg/ciocfg_printers, then use the Notepad to edit the print_cfg.usr file.

Printer Configuration Parameters


The file print_cfg.usr contains three parameters as follows: USE_NEW_HEADERS can be set to the values yes (default) or no. For I/A Series Release 6.3 and later, the page headers of PLB ladder diagram printouts and Sequence listings include the applicable compound:block name. The page headers for compound and block reports now include the title of the report as depicted on the ICC PRINT menu. If for some reason this is not desired, USE_NEW_HEADERS should be set to no. Normally, this parameter would not be changed. LINES_PER_PAGE can be set to an integer value from 1 to 200. The usual range is 40 to 80. The default is 66, the Unix standard. This number is the number of lines per page of output. This parameter is used in combination with the EJECT parameter as explained in the following section, Printer Configuration. EJECT can be set to no (default) or yes. If set to yes, a page eject is produced following each printed page. If set to no, a partial page is filled with blank lines out to the number of lines as defined by the LINES_PER_PAGE parameter.

Printer Configuration
The ICC normally assumes that the number of output lines per page is the Unix standard of 66. On some systems, such as Windows, this may not be true. For such cases, the parameter LINES_PER_PAGE can be modified to be equal to the number of lines appropriate to your printer. On a given system, there may be more than one printer, each with a different number of lines per page. For this case, you may configure a lowest common denominator. The parameter LINES_PER_PAGE is set to the smallest page size for any of the systems printers minus one. In addition, EJECT is set to yes. As a result of this, the small size printer contains print on all possible lines. Any larger size printer contains LINES_PER_PAGE lines, followed by a page eject to provide proper alignment of the page header for the next page.

Notes On Printer Configuration


If you want to use all possible lines of a printer (for example 66), and also terminate the page with a page eject, proceed as follows. 1. Set EJECT to yes. 2. Set LINES_PER_PAGE equal to the actual printer page size minus one (65 in this example) because if the number of lines is equal to the page size, the system provides a local page eject and then the ICC adds another one. This results in a printed page followed by an empty page, which is not desirable.

B0193AV Rev P

1. Introduction

If the value of the LINES_PER_PAGE parameter is too small to accommodate the five-line header and five-line footer (that is, if the parameter is between one and ten), the ICC report is not formatted. If the printer configuration file is formatted improperly or is missing altogether, ICC printing still occurs. When you attempt to print, the error message Printer configuration file format/access FAILED appears on the display. However, the print job is still performed using hardcoded default values of USE_NEW_HEADERS=yes, LINES_PER_PAGE=66, and EJECT=no. So, for this case, printing shows no effect except for the annoying error message, which continues to appear until the problem with the printer configuration file is fixed.

10

2. The Compound Summary Access Utility


This chapter contains information on the Compound Summary Access (CSA) utility including CSA conventions, searching for compounds, creating a new compound, selecting a station type to edit, selecting a control processor to configure, and the Select Screen. The Compound Summary Access (CSA) utility is the first display that appears when you select the ICC from the ICC menu. CSA has many uses. Use it to: Find and select a compound that resides anywhere in the system. Find and list all compounds in the system that begin with a particular character or character string. Find and list all compounds that contain a particular block name. Find and list all compounds that contain a particular block type. Create a new compound in a scratchpad work volume. Access the Edit Library Volume menu, which allows you to choose a particular library volume in which to work. Access the Edit Station menu, which allows you to modify a station. The following sections explain the use of the Compound Summary Access utility: CSA Conventions on page 11 Selecting Compound Name on page 12 Searching by Character or Character String on page 13 Searching for Compounds by Block Name on page 13 Searching for Compounds by Block Type on page 13 Creating a New Compound from CSA on page 14 Selecting the OK Key in CSA on page 14 Selecting the Vol Key in CSA on page 15 Selecting the Close Key in CSA on page 15 Selecting Station Type to Edit on page 15 Selecting a Control Processor to Configure on page 16. Windows platform users can also access compounds via the Select Screen.

CSA Conventions

Compound and block names must be in full caps. If you do type a compound or block name in lowercase letters, the ICC converts them to uppercase. A pointing device and the Enter/Return keys govern your selections in the CSA utility. Use the pointing device to select, and the Enter or Return key to enter the

11

B0193AV Rev P

2. The Compound Summary Access Utility

selection. The arrow keys on the numeric keypad also move you through the CSA utility. The hierarchy of CSA is always compound name, block name, and block type; in that order. Therefore, if you want to select either the block name or block type search, you must first select the compound name field to highlight its selection field. However, you do not need to type anything into the compound name field. After the selection box appears, just press the Enter key (or the arrow keys on the numeric keypad) an appropriate number of times to move down to the field of your choice. To create a new compound in the scratchpad work volume using CSA, press the Enter key (or the arrow keys on the numeric keypad) to move down to the Choice field. See Creating a New Compound from CSA on page 14. Spaces are not valid within compound or block names. If you wish to use two words, tie them together with an underscore, for example, REACTOR_1.

Selecting Compound Name


The initial display of the Compound Summary Access is illustrated in Figure 2-1.

Figure 2-1. Compound Summary Access

If the compound that you want to find is visible in the CSA window, go right to Step 4. If it is not: 1. Select the Compound Name field with the pointing device to illuminate a 12-character search field.
12

2. The Compound Summary Access Utility

B0193AV Rev P

2. Type the compound name in the appropriate case (or use the one to 12-character string search, described in Searching by Character or Character String on page 13). 3. Press Enter. The utility searches for, finds, and lists the compound that you requested. It appears highlighted in a list of compounds that reside in the same configuration file. 4. Using the pointing device, select the appropriate compound from the displayed list. Notice that the selected compound now appears under Choice. 5. If you accidentally highlight the wrong compound, go back to Step 4 and select the correct compound. The CSA utility overwrites the incorrect name in the Choice field. 6. When the selected compound is the one you want to view or edit, select OK at the bottom left of the display. CSA gets the selected compound with all its data, and transports it to the ICC. The selected compound appears, highlighted on the left of the display along with other compounds that reside in that same station or volume.

Searching by Character or Character String


1. Select the Compound Name field with the pointing device to illuminate a 12-character search field. 2. Type in a 1 to 12-character string. All compound names are in full caps. However, you may type in lowercase characters. These are automatically converted to uppercase by the system. 3. The UNIX-like wild card characters ? and * may be specified in names. ? matches any single character. * matches any group of characters. 4. Press Enter. The utility searches for, finds, and lists all the compounds in the system that start with the search string that you typed. Any others are removed from the window. You can use this search method for block names and types as well.

Searching for Compounds by Block Name


1. Select the Block Name Search field with the pointing device to illuminate a 12-character search field. 2. Enter the desired name. Include wild card characters to search for multiple names. 3. Press Enter (or Return) to initiate the search. 4. If there are no compounds that contain the block name for which you are searching in the system, the list of compounds disappears and a blank window appears. 5. If there are compounds in the system that contain the block for which you are searching, the appropriate compounds appear in the window and all others disappear.

Searching for Compounds by Block Type


1. Select the Block Type Search field with the pointing device to illuminate a 12-character search field.
13

B0193AV Rev P

2. The Compound Summary Access Utility

2. Enter the desired block type. Include wild card characters to search for multiple types. 3. Press Enter (or Return) to initiate the search. If there are no system compounds in the system that contain a block of the type for which you are searching, the list of compounds disappears and a blank window appears. If there are compounds in the system that contain a block of the type for which you are searching, the appropriate compounds appear in the window and all others disappear.

Creating a New Compound from CSA


You can create compounds both from the CSA utility and the Compound Functions display of the ICC. The advantage to creating compounds from CSA is that the newly created compound resides in the scratchpad work volume. This enables you to build compounds first, then copy them to an appropriate ICC file when you wish. See Copy to Paste Buffer on page 24 for copy information. To create a compound from the CSA utility: 1. Select the Compound Name field with the pointing device to illuminate a 12-character search field. 2. Press the Enter (or Return) key three times to get to the Choice field. 3. Type in a system-unique name. You must not give compounds names that are: a. the same as a letterbug of a CP or processor, or b. the letterbug of a CP or processor, followed by _VSTA, _STA, _VECB, or _ECB. For example, if a CP has the letterbug UCE001, do not assign the name UCE001 or UCE001_ECB to a compound. However, you can use UCE001_ECB07, for example. When building compounds that are to be copied and pasted to another location, assign names different from their final destination name. Otherwise the requirement for system-unique names complicates the copy and paste procedures. For example, when building a compound TOWER1 to be copied later to a CP, build it as TOWER1X in the volume and rename it TOWER1 as you copy or paste to the destination CP. 4. Press Enter. The name that you entered appears in the Choice field and the selection box moves up to the compound name field. 5. If you made a typing error, you can cancel the choice by pressing the Enter key again and repeating Steps 3 and 4. 6. Once the name is correct, select OK at the bottom left of the display. The work volume appears with the newly created compound, with its default values, listed at the top of the compound list in the work volume. All the appropriate compound/block editing functions are now available.

Selecting the OK Key in CSA


Selecting the OK key exits the CSA utility. You can then: 1. View or edit the compound whose name appears in the Choice field.
14

2. The Compound Summary Access Utility

B0193AV Rev P

2. If the Choice field is empty, you enter the work volume directly from the CSA utility without selecting a particular compound.

Selecting the Vol Key in CSA


1. Select the Vol key at the bottom of the display (see Figure 2-2). Selecting Vol exits the CSA utility and calls up the Select Station Type to Edit menu. 2. Select Edit Station or Edit Library Volume from this menu. 3. If you select Edit Library Volume, a list of library volumes appears. Select the volume of your choice. Subsequent editing is done in an inactive mode. 4. Selecting Cancel brings you back to the Select a Station to Edit menu.

Figure 2-2. Selecting Volume Key from the CSA Utility Screen

Selecting the Close Key in CSA


If there are no compounds in the Paste Buffer, selecting Close exits the ICC. If there are compounds in the Paste Buffer when you select the Close key, an error dialog box appears. You must clear the Paste Buffer before you are allowed to exit.

Selecting Station Type to Edit


Selecting the Volume (Vol) key from the CSA utility calls up the Select Station Type to Edit menu with the choices:

Edit Station Edit Library Volume

15

B0193AV Rev P

2. The Compound Summary Access Utility

Cancel.

Selecting Cancel brings you back to the CSA utility menu. Selecting Edit Station displays the Select a Control Processor to Configure menu. Whenever you select a target station or library volume to edit, its corresponding compound database file is locked. You receive a copy of this file.

Selecting a Control Processor to Configure


Selecting a control processor from the Select a Control Processor to Configure menu: Retrieves that stations current data files. Puts the file in an Active editing mode. Lists the compounds in that station. Indicates the station name and AP letterbug, STA = <station name> @ AP <letterbug>, and that the station is Active. The Active/Inactive mode status appears on the line under the menu bar function line. Calls up the Compound Functions menu. Highlights the keys in the system menu bar to show that they are enabled. Selecting a station whose database file has been locked displays the dialog box illustrated in Figure 2-3.

Figure 2-3. Override Lock Display

Selecting Yes from the Database Locked dialog box displays the Communication to CP (-1000) Failed dialog box. Selecting No causes a return to the Select a Control Processor to Configure menu. Selecting Continue from the Communication to CP (-1000) Failed dialog box displays the IUC_ OR UC_OPEN Failed dialog box. Selecting Continue from the IUC_ OR UC_OPEN Failed dialog box causes a return to the CSA utility.

16

2. The Compound Summary Access Utility

B0193AV Rev P

Select Screen
Windows Platform Users Only:

The Select Screen is a scrollable, hierarchical representation of the control database that allows compounds to be selected and turned on or off. It also provides direct access to associated block detail displays. Figure 2-4 shows the compound and block overview display of the Select Screen function.

Figure 2-4. Compound and Block Overview Display

Double clicking on an expandable entry (that is, an entry with a + before it) expands the entry. Each entry includes the compound name, status (on or off ) and alarm state. The entry immediately above the compound names is the name of the AW in which the compound exists. A list of blocks is displayed from the selected compound; each block includes the blocks name, type, Auto/Manual status and alarm state. To call up a detail display for a compound: 1. Select the compound from the list. 2. Select the Detail button. (The Detail button is disabled if no compound has been selected.)

17

B0193AV Rev P

2. The Compound Summary Access Utility

Each compound detail display shows all connectable compound parameters and allows settable parameters to be set. To call up a detail display for a block: 1. Select a compound from the list. 2. Access the list of blocks for the compound. 3. Select a block. 4. Select the Detail button. Detail buttons are listed in Table 2-1.
Table 2-1. Detail Buttons

Button
Cpd On Cpd Off Detail Refresh

Function Turns compound On. If compound is already On, only Cpd Off is selectable. Turns Compound Off. If compound is already Off, only Cpd On is selectable. Brings up the compound detail summary or block display. Refreshes the display to reflect the current status of the compound and blocks.

18

3. Compounds, Blocks, and ECBs


This chapter provides general operating information of ICC software, and includes procedures to create and edit compounds, blocks, and ECBs. Also included in this chapter are descriptions of the various compound and block windows.

ICC Basics and Conventions


This section describes the primary functions of the ICC. Edit Station selection (refer to Figure 3-1) is used to activate these functions. Edit Station allows you to see the compounds in a specific control processor and enables various function keys in the system menu bar.

Compound Functions
The ICC expects certain conditions to be met before making a function selectable. When these conditions are satisfied, the appropriate function highlights. For example, you must: Create a compound before adding any blocks or ECBs (initially) Create a PLB block before accessing ladder logic Create a Sequence block before accessing sequence logic Copy to Paste Buffer before accessing the Rename function Select a station file (Active mode) to edit Fieldbus Modules (ECBs can be edited in volumes, but are not associated with physical FBMs). You can use System Definition to define the letterbugs and hardware and software types of the following Fieldbus devices associated with a control processor: Fieldbus Modules (FBMs) Fieldbus Processor Modules (FBPs) for Fieldbus Cluster and SPECTRUM I/O Fieldbus Cards (FBCs) Fieldbus Communication Modules (FCMs). Whenever these devices are added to the system by the System Definition, its name and specifications are sent to the ICCs equipment list. The ECBs for the above devices are then installed in the ICC database using the Fix All function in the FBM pull-down menu. ECBs for the SPECTRUM I/O cards used in conjunction with the FBPs must be inserted individually via the ICC. Refer to the Fieldbus Cluster I/O Users Guide (B0193RB), SPECTRUM Migration Integrator Users Guide (B0193RC), and SPEC 200 Control Integrator Users Guide (B0193RD) documents for more information on these devices. The ICC allows you to edit ECBs in a manner similar to control blocks. Defining Fieldbus devices for a control processor consists of installing the appropriate ECBs in the ICC database. You can do this using the Fix All function in the FBM pull-down menu, or you can install and manipulate the ECBs in a manner similar to control blocks. ECBs can be part of the built-in ECB compound (<cplbug_ECB>), or you can install them in other compounds.

19

B0193AV Rev P

3. Compounds, Blocks, and ECBs

You can configure: 48 FBMs per CP10 64 FBMs for the CP30, CP30B, CP40, and CP40B 120 FBMs per CP60 (including legacy or 200 Series, migration, FBP, FBC) 32 FCMs per CP60 (or equivalent, including DCM, WFCM, and so forth) 32 FBMs per FCP270 120 FBMs per ZCP270 32 FCMs per ZCP270. All ECBs, except for the primary ECB, have a DEV_ID parameter that contains the letterbug of the Fieldbus device associated with the ECB. In order to preserve backward compatibility and support the ability to install ECBs in any compound, the IOM_ID parameter in the I/O control blocks can contain either the letterbug value or the full pathname of the ECB block.
Compound Functions List

Compound List

Available FBMs

Figure 3-1. Compound Function Display

20

3. Compounds, Blocks, and ECBs

B0193AV Rev P

Insert New Compound


Select Insert New Compound from the Compound Functions menu and fill in a valid name in the name definition field. This causes a new compound to be created with default parameters and inserted before (that is, in front of ) the currently highlighted compound or End position. Selecting End causes the compound to be inserted at the end of the list. (This list order can always be changed.) The procedure is detailed below. 1. Position the highlight bar on a compound or End, as shown in Figure 3-2.

Mixer has been highlighted, so the new compound will be inserted in front of it in the list.

Figure 3-2. Compounds Functions Menu

2. Select Insert New Compound. This displays a name definition window (see Figure 3-3).

21

B0193AV Rev P

3. Compounds, Blocks, and ECBs

Enter the name of the proposed new compound within the yellow data entry field.

Figure 3-3. Compound Name Window

3. Type in a valid compound name and press the Enter (Return) key. (Valid means full caps, alphanumeric, unique in the system, and up to 12 characters.) Selecting Cancel before Enter aborts the insert operation. The ICC checks the validity of the name. If the name is accepted, the name definition template disappears and a compound is created with default parameter values. If the name is not unique, you are notified to enter a new name, or cancel the insert request. The newly inserted compound appears highlighted in the compound summary list. You can then edit the compound parameters, if you want, using the Edit Compound Parameters function (see Figure 3-4).

22

3. Compounds, Blocks, and ECBs

B0193AV Rev P

Edit compound parameters as required.

Figure 3-4. Compound Parameters List

The following two compounds containing one block each are automatically installed in a UNIX platform control processor (on initial boot) and in the ICC when invoked the first time from a control station: Station compound (cplbug_STA) containing the station block (<cplbug>_STA:STATION) ECB compound (cplbug_ECB) containing the primary ECB (<cplbug>_ECB:PRIMARY_ECB). The same is true for Windows platform users, except that the primary ECB is not installed automatically.

Edit Compound Parameters


After you have selected a compound to edit from the summary list, select Edit Compound Parameters from the Compound Functions menu. This retrieves a copy of the current parameter list of the highlighted compound. This list contains parameter labels with adjoining fill-in fields. If the compound has never been edited, it contains default values where applicable. If you are just checking values without making changes, you can select Cancel when you are done. Cancel aborts the edit. However, if you are making edits to the list, always select Done when you are finished. Done saves the edits and overwrites the original.
23

B0193AV Rev P

3. Compounds, Blocks, and ECBs

Copy to Paste Buffer


The Copy to Paste Buffer function is available from the Compound Functions menu. It works only with compounds and is not selectable if the current buffer is the Paste Buffer. Copy to Paste Buffer deletes the present contents of the Paste Buffer and copies the selected compound to the buffer. If you want to queue a list of compounds in the Paste Buffer for a multiple paste function, use the Copy and Append to Paste Buffer function. The copy functions also copy any source code of Sequence blocks (and, in the case of UNIX platform users, PLB blocks) contained in the compound. To copy a compound to the Paste Buffer: 1. Move the highlight frame to the appropriate compound in the left window to select it. 2. Select Copy to Paste Buffer from the Compound Functions menu. 3. Since compound names must be unique within the system, a dialog box returns the name of the selected compound and asks you to rename it for the copy function. 4. Move the cursor to the field next to the new name request and select it with the pointing device. A boxed field is highlighted and the ICC waits for characters to be input from the keyboard. 5. Type in the new name and press Enter (Return). 6. Select Done. If compounds already exist in the Paste Buffer, a dialog box notifies you that the copy function deletes any compounds in the Paste Buffer. 7. Select Yes or No to the question, Empty Paste Buffer, Are You Sure? 8. Select Yes to delete the contents of the Paste Buffer and copy the highlighted compound into the buffer. 9. To verify that the copy function was successful, select Buffer from the menu bar. By selecting Buffer, you can enter the Paste Buffer area and edit the copied compound as you would in a ICC file. 10. Select Buffer again to return to the ICC file. After a successful Copy to Paste Buffer function, the Paste from Paste Buffer function is highlighted and becomes selectable from the Compound Functions menu. If you want the copied compound to assume a particular position in the summary list, select its position before you select Paste from Paste Buffer.
UNIX Platform Users Only:

The paragraph below describes how the Copy to Paste Buffer function could be used in a procedure that moves a compound from one control station to another (to balance loading, for example). Before making this move, ensure that every display in the system is static (not being updated from points in that compound) to avoid problems with connecting displays. To move the compound from the paste buffer into a different ICC file, select New from the menu bar. This closes the current file and returns the ICC to the CSA utility.
24

3. Compounds, Blocks, and ECBs

B0193AV Rev P

Select the Vol key to retrieve the CIO_STN_Cfg or CIO_VOL_Cfg menu. After you have chosen an ICC file, select Copy to Paste Buffer from the Compound Functions menu to retrieve the copied compound. The copied compound is inserted in front of the currently selected compound.

Copy and Append to Paste Buffer


Copy and Append to Paste Buffer is selectable from the Compound Functions menu when the

Paste Buffer already has some contents. This function is not selectable from the Paste Buffer. It mirrors the Copy to Paste Buffer function with the exception that it does not delete the buffer contents before it performs the copy. If any compounds are already in the buffer, it appends the copied compound to the present list. Copy and Append to Paste Buffer allows you to queue a number of compounds in the buffer for a multiple paste operation. Selecting Paste from Paste Buffer causes the entire contents of the Paste Buffer to move to the summary list. If you want the buffer contents to assume a particular position in the summary list, select the position before you select Paste from Paste Buffer.

Paste from Paste Buffer


This function is only available from the Compound Functions menu, and is only selectable when the Paste Buffer has contents. Selecting Paste from Paste Buffer causes any compounds that exist in the Paste Buffer to be moved to the ICC file, in the preselected position in the summary list. 1. Select a compound name (or End) from the left ICC window. This selection indicates the position that the incoming compound takes in the compound summary list. 2. Select Paste from Paste Buffer. The copied compound(s) are inserted above the selected compound. If the Copy to Paste Buffer function was used to copy the compound to the Paste Buffer, only one compound is moved into the list. If the Copy and Append to Paste Buffer function was used to copy compounds to the Paste Buffer, the entire buffer contents are moved into the list. As each compound is successfully inserted into the station or volume, it is added to the workfile and display list. If an insert operation fails, the Paste from Paste Buffer process stops, and an error message is displayed. You can then edit the remaining contents of the Paste Buffer and retry the paste operation.
UNIX Platform Users Only:

The Paste from Paste Buffer function may be part of a procedure to move a compound from one control station to another (to balance loading, for example). See Copy to Paste Buffer on page 24.

Save to Diskette
This function is only available from the Compound Functions menu. It copies only to a high density diskette that has been formatted with the appropriate file system. It copies the following to a diskette in the selected drive:
25

B0193AV Rev P

3. Compounds, Blocks, and ECBs

The currently highlighted compound (including its compound parameter list) All associated block parameter lists All associated ECB parameter lists All associated PLB (UNIX platform users only) and sequence block source files. To execute a Save to Diskette operation: 1. Select Save to Diskette from the Compound Functions menu. This displays the dialog box illustrated in Figure 3-5. If the desired host and drive are listed in this dialog box, go to the next step; otherwise, go to Step 5.

Figure 3-5. Save to Diskette Dialog Box

2. 3. 4. 5.

In the Current Name field, enter the name of the compound to be saved. In the New Name field, enter the name you want the compound to assume on diskette. Select Done to save the compound or select Cancel to exit the operation. If the desired host and drive are not listed in the above dialog box, select Device from the above dialog box to designate the appropriate drive. This displays the following dialog box:

Figure 3-6. Selected Device

6. In the Host Name field, enter the host letterbug.

26

3. Compounds, Blocks, and ECBs

B0193AV Rev P

7. In the Device Name field, enter one of the following: For UNIX platforms, enter:
/dev/fd0

For Windows platforms, enter:


a:

8. Select Done to continue the Save to Diskette operation with Step 2, or select Cancel to exit the operation. If the selected compound name already exists on the diskette, you are given the option of replacing the compound on diskette, renaming the selected compound, or cancelling the operation. ! WARNING Removing a diskette from the diskette drive during a Save to Diskette operation can destroy the information on the diskette. Wait until the menu reappears before removing the diskette.
UNIX Platform Users Only:

A WP failure during a Save to Diskette operation may cause the error message Floppy Disk Mount Failed which indicates that the diskette is still mounted to the file system of the associated AP. To recover when using a drive hosted by a 50 Series AP/AW, access the VT100 mode on the AP/AW hosting the disk drive and enter the commands:
umount /dev/fd0 eject

The diskette is unmounted and ejected from the drive.

Load from Diskette


This function allows you to load a compound and its associated blocks into the configuration file or Paste Buffer from a high density diskette in the designated drive of the designated host AP/AW. ! CAUTION The compound maintains the same parameter settings as when it was saved to diskette. To avoid disruption of the process, the compound can be copied into the Paste Buffer and the parameters modified prior to pasting the compound into an active station. To load a compound from diskette: 1. Select Load from Diskette from the Compound Functions menu. This displays the dialog box illustrated in Figure 3-7. If the desired host and drive have been automatically listed in this dialog box by the ICC, go to the next step; otherwise go to Step 5.

27

B0193AV Rev P

3. Compounds, Blocks, and ECBs

Figure 3-7. Load from Diskette

2. In the Current Name field, enter the name of the compound to be loaded. 3. In the New Name field, enter the name you want the compound to assume when it is loaded. 4. Select Done to load the compound or select Cancel to exit the operation. 5. If the desired host and drive are not listed in the above dialog box, select Device from the above dialog box to designate the appropriate drive. This displays the dialog box illustrated in Figure 3-8.

Figure 3-8. Select Device for Load from Diskette

6. In the Host Name field, enter the host letterbug. 7. In the Device Name field, enter one of the following: For UNIX platforms, enter:
/dev/fd0

For Windows platforms, enter:


a:

8. Select Done to continue the load operation with Step 2, or select Cancel to exit the operation. If the compound cannot be located on the diskette, the ICC displays a notification message and the operation is cancelled.

28

3. Compounds, Blocks, and ECBs

B0193AV Rev P

If the compound exists on diskette, but already exists in the system, you are given the option of renaming the selected compound as it is loaded from the diskette, or cancelling the operation. Load from diskette copies from the currently active disk: The compound parameter list All associated block parameter lists All ECB parameter lists

All associated PLB (UNIX platform users only) and sequence block source files.

UNIX Platform Users Only:

A WP failure during a Save to Diskette operation may cause the error message Floppy Disk Mount Failed which indicates that the diskette is still mounted to the file system of the associated AP. To recover when using a drive hosted by a 50 Series AP/AW, access the VT100 mode on the AP/AW hosting the disk drive and enter the commands:
umount /dev/fd0 eject

The diskette is automatically unmounted and ejected from the drive.

Move Functions
Move and Move Group are used in conjunction with Select to Move and End Move to move one or

more objects in the compound or block/ECB list on the left side of the display (see Figure 3-9). These functions are available from the Compound and Block/ECB Functions menus.

29

B0193AV Rev P

3. Compounds, Blocks, and ECBs

TANK CPD ECB01 ECB02 END ECB*** AIN01 AIN02 AIN44 AIN56 END CON1** MON01 TIM01 EXC03 DEP22 IND01 END SEQ*** DGAP77 CALC22 PID13 PID14 END CON2** END DATA **

Step 1 Select to Move Object to be moved is highlighted in yellow.

TANK CPD ECB01 ECB02 END ECB*** AIN01 AIN44 AIN56 END CON1** MON01 TIM01 EXC03 DEP22 IND01 END SEQ*** DGAP77 AIN02 CALC22 PID13 PID14 END CON2** END DATA **

Step 2 Point to and click on desired target point. Target is highlighted in blue

Step 3 Move Desired object is moved in front of target.

Step 3a If Move Group is selected, new movable object is highlighted.

Figure 3-9. Moving Objects

To move one object in the list: 1. Click on the name of the object in the list. This displays the normal cursor on the object. 2. Click on Select to Move from the Compound or Block/ECB Functions menu. This rehighlights the selected object and displays the differently colored move cursor on it. 3. Click on the object immediately following the desired new position for the selected object. This displays the normal cursor at the target position. 4. Click on Move. This moves the selected object to a position immediately in front of the target position, and deactivates the move functions in the menu. To move more than one object in the list: 1. Click on the name of an object in the list. This displays the normal cursor on the object. 2. Click on Select to Move from the Compound or Block/ECB Functions menu. This highlights the selected object and displays the differently colored move cursor on it. 3. Click on the object immediately following the desired new position for the selected object. This displays the normal cursor at the target position.
30

3. Compounds, Blocks, and ECBs

B0193AV Rev P

4. Click on Move Group. This moves the selected object to a position immediately in front of the target position. This also highlights the object immediately following the original position of the moved object and displays the move cursor on it. The normal cursor remains at the target position. 5. Click on Move Group again. This moves the second highlighted object in front of the target position. This highlights the next object and displays the move and normal cursors as in Step 4. 6. Repeat Step 5 until you have moved all the desired objects. 7. Click on End Move or the move cursor. This ends the move operation and deactivates the move functions in the menu. Clicking on the move cursor also redisplays it as the normal cursor. The Select to Move function is only active when the normal cursor is positioned on a legally movable object. The station and ECB compounds and the End marker cannot be selected for moving. When a valid compound has been selected for moving, it cannot be moved in front of either the station or ECB compounds. Within the Paste Buffer, copies of the station and ECB compounds are treated just like any other compound for moving purposes. A block cannot be moved into an invalid zone. For example, an ECB cannot be moved into the sequence zone. Blocks can be moved back and forth between the two continuous zones (CON1 and CON2). Within the ECB compound, the primary ECB cannot be moved. Neither can another ECB be moved to a position in front of the primary ECB.

Upload
The Upload function retrieves settable configuration compound, block, and ECB parameter values from the station and stores these values into the ICC workfiles. Tuning parameters and alarm limits are examples of settable values which are changed via applications such as default displays, customer-configured displays, and user-written applications. Parameters that are uploaded include: Unconnected, settable parameters Unconnected inputs (value is not a pathname). Parameters that are not uploaded include: Parameters that can be set only by the ICC Connected inputs (value is a pathname) Parameters of string data type. The Upload function appears in three separate menus in the ICC. 1. Selecting Upload Compound Parameters from the Compound Functions display stores the compound, block, and ECB parameter values of the selected compound into the ICC workfiles. 2. Selecting Upload Block/ECB Parameters from the Block/ECB Functions display stores the block or ECB parameter values of the selected block or ECB into the ICC workfiles. 3. Selecting Upload from the menu bars Maint menu stores the compound, block, and ECB parameters of the selected station into the ICC workfiles.
31

B0193AV Rev P

3. Compounds, Blocks, and ECBs

Delete
Delete has two uses. You can use it to:

Delete a compound or block from the display and database Re-establish broken compound or block connections. Selecting Delete from the Compound or Block/ECB Functions screen displays the following dialog box:

Figure 3-10. Delete and Undelete

Delete (Compound, Block, or ECB)


To delete a compound, block, or ECB, select Delete in the dialog box. This sends a delete request to the control station. You cannot delete the station compound, station block, ECB compound, or the primary ECB.

Delete & Undelete (Compound, Block, or ECB)


The Delete & Undelete key moves a selected compound/block or ECB in and out of a temporary delete buffer. The temporary delete buffer is not an editable area. The position of the compound or block in the database is not changed.

Cancel
Selecting Cancel discontinues the operation and returns to the previous display.

View Blocks/ECBs in this Compound


This function is available from the Compound Functions menu. It replaces the compound list in the left window with the Block/ECB list. It replaces the Compound Functions menu with the Block/ECB Functions menu. When the block list appears, the highlight bar illuminates the first block item in the list which is not in the ECB zone. This is either a continuous block or the End CON1 marker.

32

3. Compounds, Blocks, and ECBs

B0193AV Rev P

Block/ECB Functions Display


The Block/ECB Functions display is illustrated in Figure 3-11.

Figure 3-11. Block/ECB Functions Display

View Compound List


This function is available from the Block/ECB Functions menu. It replaces the Block/ECB list in the left window with the compound list. It replaces the Block/ECB Functions menu with the Compound Functions menu. When the compound list appears, note that the highlight bar illuminates the compound name associated with the previous block/ECB list.

Insert New Block


Selecting Insert New Block/ECB in the Block/ECB Functions display allows you to create: A copy of a standard system block or ECB type with default parameters where appropriate. A copy of an existing block or ECB with the parameter settings of that copied block.
33

B0193AV Rev P

3. Compounds, Blocks, and ECBs

Before you can insert a new block or ECB, you must create a new compound or select a compound in which the block or ECB is to reside. Following this action, the View Blocks/ECBs in this Compound option is highlighted in the Compound Functions menu. Selecting it provides access to the Block/ECB Functions menu for inserting a new block or ECB.
NOTE

For PLB (UNIX platform users only) and sequence blocks, only the parameter values are copied to the new block, not the logic. Use the PLB and/or sequence libraries for transporting this logic. To copy a standard system block (for example, AIN or MCOUT): 1. From the block/ECB list for the compound, highlight the block that is to follow the one you are creating. Highlight the appropriate End (End CON1, End SEQ, or End CON2) if the new block is to be last one in the zone (see Block/ECB Functions Display on page 33). 2. Select Insert New Block/ECB from the Block/ECB Functions menu. This displays a window for Block Definition (see Block Name Window on page 35). 3. For the Name, enter a valid (full caps, unique within the compound, up to 12-characters) name for the block to be created. Press Enter (or Return). If the name is accepted, the Block Type window appears (see Block Type Window on page 36). If the name is invalid, you are notified by an error message dialog box. You can then select Continue and enter a new name. 4. For the Type, there are two entry options: a. Enter (in full caps) the valid, block type name and press Enter, or b. Select Show from the menu bar and from the Show pull-down menu select Block Type Names to list all of the block types in the right window of the display (see the Show Block Type Names window). Selecting a block type from this list automatically transfers it to the Type field. Select Done. Select Cancel to abort an insert operation. 5. After the block type is entered, the ICC checks its validity. If valid, the block is inserted. The new block contains the default parameters of the standard block type. If the type is unknown or invalid for the current station or location within the station, you are notified with an error message dialog box. Select Continue and enter a new type, or cancel the insert operation. 6. The new block appears immediately above the selected block in the block/ECB list under the compound name. You can then edit the block parameters, if you wish, using the Edit Standard Block/ECB Parameters or Edit All Block/ECB Parameters selection to display the Edit Block Parameters window. New blocks must be inserted in accordance with the block order zones described in the paragraph Block Order on page 39. You cannot add blocks to the station compound.

34

3. Compounds, Blocks, and ECBs

B0193AV Rev P

Block Name Window


Refer to Figure 3-12 when entering a new block name.

Enter the name of the proposed new block within the yellow data entry field.

Figure 3-12. Enter New Block Location

35

B0193AV Rev P

3. Compounds, Blocks, and ECBs

Block Type Window


Figure 3-13 illustrates the location where the block type is entered.

Enter the type of the proposed new block within the yellow data entry field.

Figure 3-13. Enter Block Type

36

3. Compounds, Blocks, and ECBs

B0193AV Rev P

Show Block Type Names Window


Refer to Figure 3-14 when showing block type.

Select the block type name from the Show Block Type names window which displays the name within the yellow data entry field.

Figure 3-14. Show Block Type

37

B0193AV Rev P

3. Compounds, Blocks, and ECBs

Edit Block Parameters Window

Edit block parameters as required

Figure 3-15. Edit Block Parameters

Copy a Block
To copy a block from an existing block: 1. From the block/ECB list for the compound, highlight the block that is to follow the one you are creating. Highlight the appropriate End (End CON1, End seq, or End CON2) if the new block is to be last one in the zone (see Block/ECB Functions Display on page 33). 2. Select Insert New Block/ECB from the Block/ECB Functions menu. This displays a window for Block Definition (see Insert New Block on page 33). 3. For the Name, enter a valid name (full caps, unique within the compound, up to 12 characters) for the new block. Press Enter (or Return). If accepted, a Block Type window appears (see Block Type Window on page 36). 4. If the name is invalid, you are notified by an error message dialog box. You can then select Continue and enter a new name. 5. For the Type (see Block Type Window on page 36), enter the name of the block to be copied: a. If the block is remote to the current compound, type (in full caps) the name of the block using the COMPOUND:BLOCK_NAME convention and press Enter, or

38

3. Compounds, Blocks, and ECBs

B0193AV Rev P

b. If the block is in the current compound, type in the name of the block using the :BLOCK_NAME convention and press Enter. ! CAUTION The new block has the same parameter settings as the block that was copied. To avoid disruption of the process when copying a block within an active station, you should copy the block into the Paste Buffer and modify the parameters as follows: 1. Create a temporary compound within the Paste Buffer. 2. Copy the desired block into that compound. 3. View the parameter values and edit them for safe and effective operation, especially such settings as FBM assignments and output point connections. 6. After the name of the existing block is entered, the ICC checks its validity. If valid, the block is copied with the new block name. The new block contains the same parameter settings as the block that was copied. 7. If the block entered is unknown or invalid for the current station or location within the station, you are notified with an error message dialog box. Select Continue and enter a new type, or cancel the insert operation. 8. The new block appears immediately above the selected block in the block/ECB list under the compound name. You can then edit the block parameters, if you wish, using the Edit Standard Block/ECB Parameters or Edit All Block/ECB Parameters selection to display the Edit Block Parameters window.

Block Order
To provide you with maximum flexibility in implementing your control scheme, the ICC enforces a particular block building order within a compound (refer to Figure 3-16). The order is: 1. Equipment Control Blocks (ECBs) 2. Pre-Sequence Continuous 3. Sequence Monitor/Timer 4. Sequence Exception 5. Sequence Dependent/Independent 6. Post-Sequence Continuous 7. Data Blocks (non-executing). Before a block insert is permitted, the ICC compares the type of block being inserted to the resident block types. This ensures that the ordering rules are followed. An inappropriate type request generates an error message that the operation is invalid. You can build a control database so that a set of continuous blocks are processed either before or after sequence blocks in the same block processing cycle. These are referred to as pre-sequence and post-sequence blocks. The ICC provides a visual mechanism for differentiating the borders between the sequence blocks and the two sets of continuous blocks. ICC provides the following zones with unique background colors within the block list window at the left of the display and indicates the end of each zone as shown in the figure and diagram below. The zones are:
39

B0193AV Rev P

3. Compounds, Blocks, and ECBs

Equipment control blocks (ECB) Pre-sequence continuous control blocks (CON1) Sequence control blocks (SEQ) Post-sequence continuous control blocks (CON2) Data blocks.

Figure 3-16. Block Order within a Compound

ICC also provides the following sub-zones for sequence blocks with the same background color: Monitor/Timer blocks Exception blocks Dependent/Independent blocks. ICC also provides move functions that enable the blocks to be moved within any zone and between the two continuous zones.

Insert New ECB


Defining Fieldbus devices for a control station (or AW70 processor) consists of installing the appropriate ECBs in the ICC database.
UNIX Platform Users Only:

You can do this using the Fix All function in the FBM pull-down menu, or you can install and manipulate the ECBs in a manner similar to control blocks.
Windows Platform Users Only:

You can install and manipulate the ECBs in a manner similar to control blocks.
40

3. Compounds, Blocks, and ECBs

B0193AV Rev P

All Users:

You can configure: 48 FBMs per CP10 64 FBMs for the CP30, CP30B, CP40, and CP40B 120 FBMs per CP60 (including legacy or 200 Series, migration, FBP, FBC) 32 FCMs per CP60 (or equivalent, including DCM, WFCM, and so forth) 32 FBMs per FCP270 120 FBMs per ZCP270 32 FCMs per ZCP270. ECBs can be part of the built-in ECB compound (<cplbug>_ECB) or you can install them in other compounds. The primary ECB must be in the ECB compound. You can only add ECBs to the built-in ECB compound. To create a new ECB: 1. From the block/ECB list for the compound, highlight the ECB that is to follow the one you are creating. Highlight End ECB if the new ECB is to be last one in the zone (see ECB Functions Menu on page 43). 2. Select Insert New Block/ECB from the ECB Functions menu. This displays the ECB Name window for name definition. 3. For the ECB name, enter a valid (full caps, unique within the compound, up to 12-characters) name for the ECB to be created. Press Enter (or Return). If accepted, the ECB Type window appears. If the name is invalid, you are notified by an error message dialog box. You can then select Continue and enter a new name. 4. Enter (in full caps) the valid ECB type name and press Enter. From the Show pulldown menu, select Legal FBM/ECB Combinations to list all of the ECB types in the right window of the display. Entering the type displays the ECB Device Identification window. 5. Enter the letterbug of the Fieldbus device for the device identification into the DEV_ID field. The DEV_ID values must be unique within the station. For ECBs 43, 44, and 45, entering the device identification displays the Hardware Type window. For all other ECBs, entering the device identification immediately displays a list of all parameters for that ECB.
NOTE

To preserve backward compatibility and support the ability to install ECBs in any compound, the IOM_ID parameter in the I/O control blocks can contain either the letterbug value or the full pathname of the ECB block. (UNIX platform users only: fieldbus device letterbugs do not need to be unique across different control processors.) 6. Perform either Step a or b as appropriate:

41

B0193AV Rev P

3. Compounds, Blocks, and ECBs

7. 8.

9. 10. 11.

a. For ECBs 43, 44, and 45, enter the Fieldbus device hardware type value in the HWTYPE entry field. Entering the hardware type displays a list of all parameters for that ECB. b. For all other ECBs, enter the Fieldbus device hardware type value in the HWTYPE field. Enter the Fieldbus device software type value. Enter the expander type value for the FBM, if required. UNIX Platform Users Only: For Fieldbus device hardware, software, and expander type values, if the DEV_ID value was defined to the System Configurator/Definition, the defaults for HWTYPE, SWTYPE, and EXTYPE are from that configuration, and probably do not need to be changed. However, you can still change them at this point if you desire. All Users: If any of the above parameter values are unknown or invalid, you are notified with an error message dialog box. Select Continue and enter a new value, or cancel the insert operation. If the parameter values are valid, the ECB is inserted. The new ECB contains the default parameters of the standard ECB type. Select Cancel before Done (or Enter) to abort an insert operation. Select Done or press Enter. (To abort an insert operation, select Cancel.) The new ECB appears immediately above the selected ECB in the block/ECB list under the compound name. You can then edit the ECB parameters, if you wish, using the Edit Block/ECB Parameters function.

42

3. Compounds, Blocks, and ECBs

B0193AV Rev P

ECB Functions Menu


Refer to Figure 3-17 when inserting a new ECB.

FBM04 has been highlighted, so the new ECB will be inserted in front of it in the list.

Figure 3-17. Insert New ECB

43

B0193AV Rev P

3. Compounds, Blocks, and ECBs

ECB Name Window


Refer to Figure 3-18 when entering the name of a new ECB.

Enter the name of the proposed new ECB within the yellow data entry field.

Figure 3-18. Enter Name of New ECB

44

3. Compounds, Blocks, and ECBs

B0193AV Rev P

ECB Type Window


Refer to Figure 3-19 when entering the ECB type.

Enter the type of the proposed new ECB within the yellow data entry field.

Refer to the Show Legal FBM/ECB combinations window.

Figure 3-19. ECB Type Window

45

B0193AV Rev P

3. Compounds, Blocks, and ECBs

ECB Device Identification Window


Figure 3-20 shows the Device Identification window.
Software Type Expander Type Hardware Type

Enter the proposed new DEV_ID (Fieldbus device letterbug) within the yellow data entry field.

Refer to the Show Configured ECB window for a list of all system configured Fieldbus device letterbugs.

Figure 3-20. ECB Device Identification Window

Copy ECB
To copy an ECB from an existing ECB: 1. From the block/ECB list for the compound, highlight the ECB that is to follow the one you are creating. Highlight End ECB if the new ECB is to be last one in the zone (see ECB Functions Menu on page 43). 2. Select Insert New Block/ECB from the Block/ECB Functions menu. This displays a window for ECB Definition (see ECB Name Window on page 44). 3. For the ECB Name, enter a valid name (full caps, unique within the compound, up to 12 characters) for the new ECB. Press Enter (or Return). If the name is accepted, the ECB Type window appears. If the name is invalid, you are notified by an error message dialog box. You can then select Continue and enter a new name.
46

3. Compounds, Blocks, and ECBs

B0193AV Rev P

4. For the ECB Type, enter the name of the ECB to be copied. a. If the ECB is remote to the current compound, type (in full caps) the name of the ECB using the COMPOUND:ECB_NAME convention and press Enter, or b. If the ECB is in the current compound, type in the name of the ECB using the :ECB_NAME convention and press Enter. Entering the ECB Type displays the ECB Device Identification window. 5. Enter a new Fieldbus device letterbug for the device identification in the DEV_ID field. The DEV_ID values must be unique within the station. Entering the device identification displays a list of all parameters, all of which are copied from the specified ECB. 6. If changes are desired, you can enter them. These include the Fieldbus device hardware type value, software type, and FBM expander type. If any of the above parameter values is unknown or invalid, you are notified with an error message dialog box. Select Continue and enter a new value, or cancel the insert operation. If the parameter values are valid, the ECB is inserted. The new ECB contains the same parameter settings as the ECB that was copied. 7. Select Done. (Select Cancel before Done or Enter to abort an insert operation.) 8. The new ECB appears immediately above the selected ECB in the block/ECB list under the compound name. You can then edit the ECB parameters if you wish, using the Edit Standard Block/ECB Parameters or Edit All Block/ECB Parameters function.

Edit Block/ECB Parameters


You can either choose to Edit Standard Block/ECB Parameters or Edit All Block/ECB Parameters from the Block/ECB Functions menu. Either selection retrieves the selected block or ECB along with its parameter list. In this scrollable list, each parameter name has an adjoining fill-in value field. The Control Configurator allows you to edit ECBs in a manner similar to control blocks. If a block has never been edited, the field contains the default values for the parameters. You can edit any field in this list except the block name and type. If the block is a (UNIX platform users only) PLB or sequence block type, you can also modify any source code associated with the selected block. If an ECB has never been edited, the field contains the default values for appropriate parameters. You can edit any field in this list except: ECB Name (NAME) ECB Type (TYPE) Letterbug (DEV_ID).
UNIX Platform Users Only:

ICC allows local and peer-to-peer connections for compound and block parameters. Local connections are input parameter connections to source parameters in the same control station. Peerto-peer connections are input parameter connections to source parameters in different control stations.

47

B0193AV Rev P

3. Compounds, Blocks, and ECBs

ICC also allows local and peer-to-peer Boolean input connections to source data of any data type. When configuring Boolean inputs, you can also configure additional extension information at the end of the full pathname of the source parameter to specify additional functions. ICC also allows block parameter (not string type) connections to shared variables that are not in a control processor. The shared variable name consists of up to 12 uppercase characters that contain no colons or periods.
Windows Platform Users Only:

ICC allows local connections for compound and block parameters. Local connections are input parameter connections to source parameters in the AW70. ICC also allows local Boolean input connections to source data of any data type. When configuring Boolean inputs, you can also configure additional extension information at the end of the full pathname of the source parameter to specify additional functions. ICC also allows block parameter (not string type) connections to shared variables that are not in the processor. The shared variable name consists of up to 12 uppercase characters that contain no colons or periods.
All Users:

If the input parameter is a 16-bit packed Boolean variable, you can configure a connection extension to extract a specific set of bits from the source parameter without changing other bits in the input. To enter a hexadecimal number for a packed Boolean parameter value ranging from 0 to FFFF, precede the number with 0X. For example, enter 0XFFFF to set all the bits in the value to one. Enter 0X8000 to set only the high order bit. The same rule applies to a packed long parameter value ranging from 0 to FFFFFFFF. When entering data in the range 32768 through 65535 into a block parameter whose type is an unsigned integer, you must enter the value as a hexadecimal number. For example, to set ECB34.HORVAL to 50000, you must enter 0XC350.

Warning and Error Messages


When a compound or block is sent to the control station by the ICC, a warning or error message may be returned. An error or failure message causes total rejection of all newly entered parameters, including those which were not in error. A warning message allows entry of the compound or block into the control processor. The block parameter window is redisplayed to give you an opportunity to correct the erroneous parameter without re-entering the other new parameters. If you cancel out of the parameter window, all of the changed parameters, including the erroneous one, are retained in the control processor. This results in the block being installed in an undefined state. You must correct the errors in order to properly execute the block. The following is a list of warning messages that can be generated when a compound or block is sent to the control station by the ICC. ICC retains in its work file an incorrect configuration that causes a warning message, as a visual aid in correcting the error.
UNIX Platform Users Only:

The warning messages are:

48

3. Compounds, Blocks, and ECBs

B0193AV Rev P

W43 W44 W45 W46 W47 W48 W49 W50 W51 W52 W53 W54 W55 W56 W57 W58 W59

INVALID PERIOD/PHASE COMBINATION INVALID ENGINEERING RANGE CONFIGURATION ERROR IN STEP INVALID INPUT CONNECTION INVALID PARAMETER CONNECTION INVALID BLOCK OPTION INVALID BLOCK EXTENSION INVALID SIGNAL CONDITIONING INDEX INVALID HARDWARE/SOFTWARE TYPE INVALID I/O CHANNEL/GROUP NUMBER INVALID PARAMETER VALUE ECB DOES NOT EXIST CONTROLLER DOES NOT EXIST INVALID CONTROLLER MODE TUNING_CONSTANT LINKED INSTALL ERROR; DELETE/UNDELETE BLOCK DUPLICATE OUTPUT CHANNEL

UNIX Platform Users Only:

The error messages are:


E0 NO ERROR E1 MISSING EQUALS SIGN E2 MISSING SEMICOLON E3 EXCEEDED SEQUENCE CODE SPACE E4 EXCEEDED MAXIMUM BLOCK SIZE E5 INVALID OPERATION E6 MISSING END KEYWORD; DO DELETE/UNDELETE E7 MISSING START KEYWORD E8 MISSING OPERATION KEYWORD E9 MISSING/INVALID TYPE KEYWORD E10 INVALID SEARCH TYPE E11 MISSING TYPE OF SUBLIST E12 CANNOT DEFINE LIST TYPE E13 CANNOT FIND PARAMETER DEFINITION E14 CANNOT FIND BLOCK DEFINITION E15 INVALID PACKET TYPE; CANNOT FREE MEMORY E16 COMPOUND OR BLOCK NOT FOUND E17 UNABLE TO INSERT BEFORE THIS BLOCK E18 DATE/TIME NOT SET; USE SMDH TO SET TIME E19 MISSING NAME KEYWORD E20 INVALID BLOCK TYPE E21 BLOCK NOT FOUND E22 UNABLE TO OBTAIN DATE/TIME E23 INCOMPLETE ECB PATHNAME E24 LOCAL CONNECTION ERROR E25 REMOTE CONNECTION ERROR E26 HEADER ALLOCATION ERROR E27 ADDRESS LINK ERROR

49

B0193AV Rev P

3. Compounds, Blocks, and ECBs

E28 E29 E30 E31 E32 E33 E34 E35 E36 E37 E38 E39 E40 E41 E42

INVALID SOFTWARE/HARDWARE TYPE IPC ERROR COMPOUND OR BLOCK ON SCAN LOCATE PARAMETER DEFINITION ERROR OBJECT MANAGER OMOPEN FAILED DATA BASE OPERATION IN PROGRESS MISSING SEQUENCE BLOCK SIZE INSUFFICIENT MEMORY FOR BLOCK NONCONNECTABLE PARAMETER LINKAGE TYPE NOT COMPATIBLE INCORRECT INTERPRETIVE CODE SIZE INVALID BLOCK SIZE COMPOUND OR BLOCK ALREADY EXISTS UNLINKED INPUT SECURED; CHECK OM LISTS INVALID/DUPLICATE DEVICE ID

Edit Sequence Logic


This function is not selectable until you have named and defined a block as one of the following sequence block types: MON, EXC, DEP, IND. The definition procedure is the same for all blocks. When you select Edit Sequence Logic, ICC calls the sequence domain and passes to it the sequence block name, type, and a copy of the working sequence source file. The initial working sequence source files are skeleton files, which are only templates to use as guides in laying out the actual sequence code. Display control then shifts to the sequence domain for implementation. It retains display control until you exit sequence Logic and return to the Block/ECB Functions display.

Edit Ladder Logic


UNIX Platform Users Only:

This function is not selectable until you have named and defined a block as type PLB. The definition procedure is the same for all blocks. After naming and defining the block, select Done. This creates a ladder logic block with default values where appropriate. Notice that the Edit Ladder Logic function in the Block/ECB Functions display is now highlighted and selectable. When you select Edit Ladder Logic, ICC calls the ladder logic domain and passes it the current station or library volume letterbug, compound name, and block name. Display control then shifts to the ladder logic domain for implementation. It retains display control until you exit ladder logic and return to the Block Functions menu. Refer to Chapter 7 Editing Sequence Logic and High Level Batch Language (HLBL) Users Guide (B0400DF) for further details.

50

3. Compounds, Blocks, and ECBs

B0193AV Rev P

Rename Block/ECB
This function is available from the Block/ECB Functions menu and is only selectable when the current buffer is the Paste Buffer. It provides a dialog box which requests a new name for the currently selected block or ECB. The name must be unique in the current compound. 1. Select a block or ECB name from the summary list. 2. Select Rename Block/ECB from the Block/ECB Functions menu. 3. A dialog box returns the present name and asks you to enter a new name. 4. Key in the new name (which must be unique within the compound). 5. Once the name is accepted, the Block/ECB display is updated with the new name.

51

B0193AV Rev P

3. Compounds, Blocks, and ECBs

52

4. Menu Bar Functions


This chapter contains information on menu bar functions.

Show Menu
This function enables you to request a variety of lists. Selecting Show provides a menu of the following items: Available CPs (control stations) Available FBMs (Fieldbus devices in <cplbug>_ECB compound only) Block Type Names Diskette Directory (displays the database on a SaveAll diskette) Available WPs (Workstation Processors) Available Printers Available Historians CP Processing Periods Integrator and Gateway Processing Periods Boolean Descriptors (for packed Boolean parameters) Configured ECBs (System Definition ECBs) Legal FBM/ECB Combinations SPECTRUM FBP Configuration SPECTRUM UCM I/O Cards SPECTRUM UIO I/O Cards SPECTRUM FIO I/O Cards SPECTRUM UFM I/O Cards. FCM100 Addresses (Fieldbus Control Modules). Selecting Cancel causes the menu to disappear and the previous display to reappear. Any other selection causes the menu to disappear and a new window to open at the right of the display. A scrollable list appears in this window. If you select one of the items in this list and there is a currently open fill-in field, the selected item is copied to the fill-in field, replacing any previous contents. This window closes when you select the close icon. Several windows do not allow copying data to a fill-in field. They are: Boolean Descriptors, Configured ECBs, Legal FBM/ECB Combinations, and the four SPECTRUM I/O Cards windows. The Boolean Descriptors list contains mnemonic descriptions for each Boolean bit of the selected packed Boolean parameter.

Diskette Directory
When Diskette Directory is selected from the Show menu, the database on a SaveAll diskette is displayed.
53

B0193AV Rev P

4. Menu Bar Functions

FBM Menu
UNIX Platform Users Only:

This function is only selectable when the ICC target is a station. Selecting FBM provides the following choices:

Fix All Ladder Assignment Cancel (to close the FBM menu).

Fix All Function


UNIX Platform Users Only:

Selecting the FBM menu Fix All function installs the ECBs specified by System Definition into the ICC database. These ECBs are installed in the Control Processors ECB compound (<cplbug>_ECB) and can be edited as explained in the Edit Block/ECB Parameters on page 47. As each ECB is created, the block list for the ECB compound is updated with the new ECB name. Any errors are displayed, and you are allowed to continue or exit the operation. The ECBs created by Fix All are appended to the ECB compound. They are added to any ECBs, either system-configured or user-defined, that are already there. If a system-configured ECB being added by Fix All is already present, an error is displayed and the new ECB is not added. The ECBs for the SPECTRUM I/O cards specified by System Definition are not installed by the Fix All function. They must be manually inserted.

Ladder Assignment Function


UNIX Platform Users Only:

The FBM menus Ladder Assignment function enables you to inspect the compound:block names of the PLBs assigned to a selected PLB-type FBM. To initiate the FBM Ladder Assignment function, first select the compound to which the ECB belongs, select the ECB, and select Ladder Assignment.
NOTE

Since ECBs can be contained in any compound, you are required to select the compound containing the PLB ECBs before the ladder assignments for these ECBs can be accessed. Selecting Ladder Assignment moves you into the FBM Ladder Assignment function. The following is an example of the first display, the FBM Ladder Assignment Summary:

54

4. Menu Bar Functions

B0193AV Rev P

Selecting Done causes the FBM menu to exit. The lower portion of the display lists all the PLB-type Fieldbus Modules installed in the control station. When you select one of the FBMs, the ICC pulls down onto the right side of the display a list of the compound:block names of the (up to eight) PLBs assigned to the selected FBM, and automatically exits the FBM menu. The list is displayed at the right side of the display until you overwrite it or until you remove it by clicking on the octagon-shaped icon at the bottom of the list.

Print Menu
The Print menu allows you to print a hard copy of portions of the selected station database. You can select from the Print menu: Parameters of all blocks in a compound Parameters of one compound or block Parameters of all compounds and blocks Names of all compounds Names of all blocks in a compound. If one compound, block, or ECB is selected, you are prompted to fill-in a compound, block, or ECB name. An unknown name causes an error notification and a return to the fill-in field. You may try again with a new name, or Cancel. Once you have made the item selection, you are asked to select a printer from a list of printers in the system. When you select the printer, the print request is sent to the printer queue and control returns to the ICC.

New Menu
Selecting New from the menu bar closes the file that you are working in, and saves it. The system returns to the CSA utility so that you can choose another file.

Checkpoint Menu
UNIX Platform Users Only: Checkpoint saves the selected station database in a check point file on the host file server.

The check point file is the database which is loaded into the control station when that station is rebooted.
Windows Platform Users Only: Checkpoint saves the station database in a check point file on the AW70.

The check point file is the database which is loaded into the AW when it is rebooted.

55

B0193AV Rev P

4. Menu Bar Functions

Maint Menu
This selection provides a menu with the following functions:

LoadAll SaveAll SaveAll w/Fmt Shrink Initialize Upload Format Floppy Eject Floppy.

LoadAll
LoadAll allows you to load the entire contents of a diskette to the currently selected buffer: paste,

volume, or station.
UNIX Platform Users Only:

If LoadAll attempts to load a system-configured ECB that is already loaded in the control station, Integrator, or gateway, an error message is displayed and the loading of the duplicate ECB is not allowed. Selecting Continue allows subsequent ECBs to be loaded.
All Users:

For compounds other than the ECB compound, failure of any block or ECB to load causes failure of the entire compound. When performing a LoadAll operation, any block which causes either an error (failure) or warning message records the associated message in a log file. When an error (failure) is detected, the operation stops and a dialog box is displayed. Select Continue to restart the operation. For warning messages, the operation continues, but at the end of the operation a summary box informs you of the errors and warnings and identifies the file which contains the associated error messages. When you do batch processing (recipes) with sequence type blocks (IND, DEP, TIM, EXC, MON), it is recommended that you use the LoadAll/SaveAll ICCAPI shell scripts to perform LoadAlls/SaveAlls to/from a hard drive. Refer to the Integrated Control Configurator Application Programming Interface (B0193NE) document, the paragraph titled, Load_All/Save_All Recommendations. ! CAUTION The compounds, blocks, and ECBs maintain the same parameter settings as when they were saved to diskette. The compounds can be copied into the paste buffer and the parameters modified prior to installing the compounds into an active station.

SaveAll
SaveAll allows you to save all of the compounds in a control station, volume, or paste buffer to a diskette or, if necessary, multiple diskettes. If the information being saved requires multiple diskettes, the following dialog box appears:
56

4. Menu Bar Functions

B0193AV Rev P

The system indicates the first compound that will be saved to the new diskette. ! WARNING Removing a diskette from the diskette drive during a SaveAll operation may destroy the information on the diskette. Wait until the menu reappears before removing the diskette. Disk drive device errors occur during Maint operations in the ICC if the disk drive is currently selected in a file manager application (for example, Windows Explorer). The device must be deselected in the file manager to allow access to the drive.
UNIX Platform Users Only:

Diskettes containing a file system, such as SaveAll diskettes, created on an AP20/PW drive must be read on an AP20/PW drive; diskettes created on a 50 Series host drive must be read on the 50 Series host drive. A WP failure during a LoadAll or SaveAll operation may cause the error message Floppy Disk Mount Failed which indicates that the diskette is still mounted to the file system of the associated AP. To recover when using a drive hosted by a 50 Series AP/AW, access the VT100 mode on the AP/AW hosting the disk drive and enter the commands:
umount /dev/fd0 eject

The diskette is unmounted and ejected from the drive. When you do batch processing (recipes) with sequence type blocks (IND, DEP, TIM, EXC, MON), it is recommended that you use the LoadAll/SaveAll ICCAPI shell scripts to perform LoadAlls/SaveAlls to/from a hard drive. Refer to the Integrated Control Configurator Application Programming Interface (B0193NE) document, the paragraph titled, Load_All/Save_All Recommendations.

SaveAll w/Fmt
SaveAll w/Fmt formats a double-sided, high density diskette in the designated diskette drive, and then performs a SaveAll.

LoadAll/SaveAll for Batch Processing


When you do batch processing (recipes) with sequence type blocks (IND, DEP, TIM, EXC, MON), it is recommended that you use the LoadAll/SaveAll ICCAPI shell scripts to perform LoadAlls/SaveAlls to/from a hard drive. Refer to the Integrated Control Configurator Application
57

B0193AV Rev P

4. Menu Bar Functions

Programming Interface (B0193NE) document, the paragraph titled, Load_All/Save_All Recommendations.

Shrink
Shrink compresses the current ICC database to save disk space. Upon completion, it automatically selects the New function. NOTE Shrink only affects files on the disk. It does not affect the control processor.

Initialize
Initialize removes all compounds, ECBs, and blocks, including sequence and (UNIX platform

users only) PLB source files, from the configuration file for the current station or volume. The station must be rebooted after Initialize is performed.

Format Floppy
Format Floppy formats a double-sided, high density diskette in the designated diskette drive.

Eject Floppy
UNIX Platform Users Only: Eject Floppy, which applies only to a 50 Series host drive, automatically ejects the diskette from

the designated drive. If you use it with an AW70, nothing happens.

Buffer Menu
The Paste Buffer is a temporary editable area that accommodates: Compound(s) that are being copied from one ICC file to another Compound(s) that you are loading in from diskette Compound(s) that you are creating A block Rename function. You can toggle back and forth between the Paste Buffer area and the configuration file area simply by selecting Buffer on the menu bar. When you do, notice that the status line, immediately beneath the menu bar, reflects the area that is displayed, for example, Paste for the buffer area. When the Paste Buffer is the active buffer, no interaction with the control processor occurs. Paste buffer contents are only transmitted to the control processor during a paste action from paste buffer operation. Most compound/block functions can be performed when either the configuration file or paste buffer is active. The exceptions are:

58

4. Menu Bar Functions

B0193AV Rev P

Configuration File Only Copy to Paste Buffer Copy and Append to Paste Buffer Paste from Paste Buffer Upload Compound Parameters

Paste Buffer Only Rename Block/ECB

Cancel/Done
Cancel always discards an action or menu and returns the previous display. Done always saves the

action and either returns to the previous display or proceeds to the next display.

Exit Menu
Exit indicates that you have completed the editing process and wish to exit from the ICC.

Selecting Exit causes ICC to automatically initiate a check point, save the file that you are working in, and examine the paste buffer. If compounds exist in the paste buffer, ICC warns that they will be deleted upon exit, and asks:
Are You Sure?

If your response is Yes, ICC: Deletes any compounds contained in the paste buffer Discards the contents of the delete buffer Deletes all temporary data files Exits ICC. If your response is No, the Exit request is cancelled and the previous display reappears.

59

B0193AV Rev P

4. Menu Bar Functions

60

5. Block Parameter Connections


This chapter contains information on block parameter connections including mixed data types, Boolean connection extensions, and defaults for integer and real connections. To access a block parameter value from outside the resident compound, you must use the entire path:
Cname:Bname.Pname

where:
Cname = compound name Bname = block name Pname = parameter name.

Connectivity between blocks in different compounds is through this same convention, whether the compounds are in the same or different stations. To connect to either a block parameter value from another block within the same compound, or to a parameter value from within the same block, you can use:
:Bname.Pname

Topics relating to block parameter connections described in the following sections are: Mixed Data Types Boolean Connection Extensions General Format of Boolean Connection Extensions Boolean Extensions to Source Data Boolean Extensions to Source Status Boolean Extensions to Status Parameters Packed Boolean Connection Extensions Defaults for Integer and Real Connections.

Mixed Data Types


Local connections are input parameter connections to source parameters in the same control station. You can connect an input parameter to a source parameter of any data type in any block in the same control station. The control station converts the data from the source format into the sink format when the data is copied into the sink connection. This is done each block execution cycle prior to processing the block algorithm. In most cases, data conversions conform to the standard C programming language conventions used in assignment statements containing mixed data types. For the cases shown below, however, the converted value is clamped at the specified maximum positive or minimum negative value.

61

B0193AV Rev P

5. Block Parameter Connections

Sink Value Short integer Short integer Short integer Integer Integer Long integer

Source Value Integer Long integer Real value Long integer Real value Real value

Maximum 127 127 127 32767 32767 2147483647

Minimum -128 -128 -128 -32768 -32768 -2147483648

The following table summarizes the results of the conversion algorithms. Sink Value Boolean Short integer Source Value Short integer, integer, long integer, real, packed boolean Boolean, packed boolean, packed long Integer, long integer Real Boolean Short integer Long integer Real Packed boolean Packed long Boolean Short integer Packed boolean Integer Real Packed long Boolean, short integer, integer Long integer, packed long Packed boolean Results If source not = 0, result = 1 Else result = 0 Low-order byte of source Clamped source Converted clamped source Unsigned low-order byte of source Extended low-order byte of source Clamped source Converted clamped source Source Unsigned low-order integer of source Unsigned low-order byte of source Extended low-order byte of source Unsigned low-order integer of source Extended low-order integer of source Converted clamped source Source Converted source Converted truncated high-order source Converted unsigned integer of source

Integer

Long integer

Real

62

5. Block Parameter Connections

B0193AV Rev P

Sink Value Packed boolean Boolean

Source Value

Results If source = 0, mask bits cleared in sink If source = 1, mask bits set in sink (unmasked bits are unchanged) Masked unsigned low-order byte of source (unmasked bits are unchanged) Masked unsigned low-order integer of source, (unmasked bits are unchanged) Masked converted clamped integer of source (unmasked bits are unchanged) If source = 0, clear all sink bits If source = 1, set all sink bits Unsigned low-order byte of source Unsigned low-order integer of source Converted clamped long of source Source

Short integer Integer, long integer, packed boolean, packed long Real Packed long Boolean Short integer Integer, packed boolean Real Long integer

Peer-to-peer connections are input parameter connections to source parameters in different control stations. Peer-to-peer connections support a mixture of the following data types. The same conversions specified for the mixed local connections in the previous table are performed for the combinations of mixed peer-to-peer connections listed in the following table.
Table 5-1. Valid Mixed Data Peer-to-Peer Connections

Source Value Long integer Integer Short integer

Sink Value Integer, short integer, boolean, packed boolean, packed long Long integer, short integer, boolean, packed boolean, packed long Long integer, integer, boolean, packed long

Peer-to-peer connections do not support a mixture of real and integer data types, or a mixed connection to a Boolean source.

Boolean Connection Extensions


You can make local and peer-to-peer Boolean input connections to source data of any data type. When configuring Boolean inputs, you also may configure additional extension information at the end of the full pathname of the source parameter to specify any of the following functions: Extract a specified Boolean from the source data Extract individual block status or alarm status Booleans using a mnemonic name Perform a logical OR of a combination of value status bits associated with the source data, using a combination of mnemonic symbols
63

B0193AV Rev P

5. Block Parameter Connections

Perform logic functions (AND, XOR) on the source data against a user-specified Boolean bit mask Invert the extracted result. In conjunction with any of these options, you can specify a default (fallback) value for the Boolean input. When the block is installed, the sink value is initialized to the default value (0 or 1) specified in the connection extension.
NOTE

If the Boolean input is connected to itself, this feature allows you to create a Boolean constant of 0 or 1 that cannot be changed without reconfiguring the connection. If the connection is broken or the source value is BAD or out-of-service (OOS), and a default value is specified in the connection extension, the sink value is set to the default value.
NOTE

This feature allows you to preconfigure deterministic fallback states for any Boolean input that is connected peer-to-peer to a source parameter in a different station. If the extension information is invalid, the connection is marked Unresolved, the block is marked Undefined, and the Object Manager (OM) scan status of the input is set to 0.

General Format of Boolean Connection Extensions


The general format of Boolean connection extensions is:
Cname:Bname.Pname.Extension

where:
Extension = [{0,1}.]{~,[~]Bmask,[~]{A,X}[H]mask,[.][~]symbol}

Legend:
[] {,} ~ B A X H

: : : : : : :

optional select one Invert the Boolean result result = extracted Boolean of source value result = bitwise AND of source value and mask result = bitwise XOR of source value and mask use high-order integer of value

NOTE B, A, or X can be used only if source is integer, long, packed boolean, or packed long

(other types invalid). H can be used only with A or X functions if source is long or packed long (other types invalid).

64

5. Block Parameter Connections

B0193AV Rev P

Mask = 1 to 2 digit boolean number if B function (non-digit, wrong length, or out-of-range)

is invalid. Range is: to 16 if source is integer (1 = high-order bit, 16 = low-order bit) to 32 if source is long integer (1 = high-order bit, 32 = low-order bit). Mask = 1 to 4 digit hexadecimal mask if A or X function (non-hex digit or wrong length are invalid).
0 1 ..

: : :

result = 0 (initial default and fallback value) result = 1 (initial default and fallback value) use status of source value

Symbol = 1 to 4 character symbol (wrong length or wrong character/combination are invalid):

Source status bit(s) if status function Source value bit if Pname is BLKSTA, ALMSTA, or INHSTA.

Boolean Extensions to Source Data


The format of Boolean connection extensions to source data is:
Cname:Bname.Pname.Extension

where:
Extension = [{0,1}.]{~,[~]B mask,[~]{A,X}[H]mask}

Legend:
[] {,}

= =

optional select one

The following table lists examples of this type of extension. Extension*


1

Meaning Set default result = 1. If connection broken, set result = 1. Else, set result = source. If source = 0, set result = 1. Else, set result = 0. Set default result = 1. If connection broken, set result = 1. Else, if source = 0, set result = 1. Else, set result = 0. Set result = boolean 12 of source. Set default result = 0. If connection broken, set result = 0. Else, set result = bit 12 of source. Set default result = 0. If connection broken, set result = 0. Else, set result = inverse of source boolean 12.
65

~ 1.~

B12 0.B12

~B12

B0193AV Rev P

5. Block Parameter Connections

Extension*
A30A0

Meaning Bitwise AND the low-order 16-bits of source with hex 30A0. If result not = 0, set result = 1. Else, set result = 0. Invert result of previous example. Bitwise XOR the low-order 16-bits of source with hex 30A0. If result not = 0, set result = 1. Else, set result = 0. Bitwise XOR the high-order 16-bits of source with hex 30A0. If result not = 0, set result = 1. Else, set result = 0. Invert the result. Set default result = 1. If connection broken, set result = 1. Else, do logic in previous example.

~A30A0 X30A0

~XH30A0

1.~XH30A0

* Extension is preceded by a .

Examples using the full Cname:Bname.Pname.Extension pathname are:


BLENDER1:CIN.CIN.1.~ BLENDER1:MCIN.PACKIN.A30A0.

Boolean Extensions to Source Status


The format of Boolean connection extensions to source status is:
Cname:Bname.Pname.Extension

where:
Extension = [{0,1}.].[~]symbol

Legend:
[] {,}

= optional = select one

NOTE Pname cannot be BLKSTA, ALMSTA, or INHSTA in this format. For a description

of connections to these parameters, see Boolean Extensions to Status Parameters on page 67. The following table lists examples of this type of extension: Extension*
.B .~B .BOD
66

Meaning Result = BAD status bit of source. Invert result of previous example. Result = logical OR of BAD, OOS, and OM Off-Scan status bits of source.

5. Block Parameter Connections

B0193AV Rev P

Extension*
.~BOD

Meaning Invert result of previous example.

* Extension is preceded by a .

Examples using the full Cname:Bname.Pname.Extension pathname are:


BLENDER1:AIN.PNT..B BLENDER1:MAIN.PNT_3..~BOD.

The source status symbols are: B 1 = Bad I/O O 1 = Out_Of_Service D 1 = OM Off-Scan (Disconnected) E 1 = Propagated Error.

Boolean Extensions to Status Parameters


The format of Boolean connection extensions to status parameters is:
Cname:Bname.Pname.Extension

where:
Pname = BLKSTA, ALMSTA, or INHSTA Extension = [{0,1}.]{[~]Bmask,[~]{A,X}[H]mask,[~]symbol}

Legend:
[] {,}

= optional = select one

The following table lists examples of this type of extension. Pname.Extension


BLKSTA.BAD BLKSTA.~BAD ALMSTA.LDA ALMSTA.~LDA INHSTA.HOA INHSTA.~HOA BLKSTA.B12 BLKSTA.AH30A0

Meaning Result = BAD boolean of source BLKSTA. Invert result of previous example. Result = LDA boolean of source ALMSTA. Invert result of previous example. Result = HOA boolean of source INHSTA. Invert result of previous example. Result = boolean 12 of BLKSTA. Bitwise AND the high-order 16-bits of BLKSTA with hex 30A0. If result not = 0, set result = 1. Else, set result = 0.

Examples using the full Cname:Bname.Pname.Extension pathname are:


BLENDER1:PID.ALMSTA.LDA BLENDER1:MAIN.BLKSTA.AH30A0.
67

B0193AV Rev P

5. Block Parameter Connections

Block Status Symbols


The Boolean extension symbols for the block status parameter BLKSTA are: ACC 1 = Accumulating ACT 1 = Active ASP 1 = Alternate Set Point BAD 1 = Bad I/O BADR 1 = Bad Redundant I/O CTL 1 = Controlling DEV 1 = Redundant I/O Deviation DF 1 = Device Failure DSB 1 = Disabled DSR 1 = DSR Mismatch FBM 1 = FBM Failure FBMR 1 = Redundant FBM Fail FOL 1 = Follow FLB 1 = Supervisory Fallback State FS 1 = Fail safe output FTN 1 = Feedforward Tune Active FTNI 1 = Feedforward Tune Inactive HLD 1 = Hold HOL 1 = High Output Limit HRQ 1 = Hold Request ILK 1 = Interlocked INER 1 = Input Error LM1 1 = Limit Switch 1 On LM2 1 = Limit Switch 2 On LOL 1 = Low Output Limit LR 1 = Remote, 0 = Local LRO 1 = LR Override MA 1 = Auto, 0 = Manual MAO 1 = MA Override MO 1 = Manual Override (panel) MTN 1 = Manual Tune
ON 1 = On PAUS 1 = Paused PTN 1 = Pre-Tune RAMP 1 = Ramp Option RED 1 = Redundant Inputs
68

5. Block Parameter Connections

B0193AV Rev P

REPT 1 = Repeat Option RMP 1 = Ramp SBX 1 = Executing SBX statements SC 1 = Supervisor Control SE 1 = Supervisor Enabled SEL 1 = Redundant I/O Select SIM 1 = PLB Simulation Mode SPDN 1 = Set-point Ramp Down SPUP 1 = Set-point Ramp Up STN 1 = Self-Tune STRK 1 = Set-point Track TEST 1 = PLB Test Mode TRIP 1 = Tripped TRK 1 = Track UDEF 1 = Undefined WLCK 1 = Workstation Lock.

Alarm Status Symbols


The Boolean extension symbols for the alarm status parameter ALMSTA are: BAD 1 = I/O Bad Alarm HDA 1 = High Deviation Alarm HHA 1 = High-High Absolute Alarm HMA 1 = High Measurement Alarm HOA 1 = High Output Alarm INH 1 = Inhibit Alarm LDA 1 = Low Deviation Alarm LLA 1 = Low-Low Absolute Alarm
LMA 1 = Low Measurement Alarm LOA 1 = Low Output Alarm OOR 1 = Out of Range Alarm OPER 1 = Operational Error Alarm PNT1 1 = Point 1 Alarm PNT2 1 = Point 2 Alarm PNT3 1 = Point 3 Alarm PNT4 1 = Point 4 Alarm PNT5 1 = Point 5 Alarm PNT6 1 = Point 6 Alarm PNT7 1 = Point 7 Alarm

69

B0193AV Rev P

5. Block Parameter Connections

PNT8 1 = Point 8 Alarm PTRG 1 = Pre-Target Alarm RATE 1 = Rate of Change Alarm STAL 1 = State Change Alarm TARG 1 = Target Alarm TRIP 1 = Trip Alarm UNAK 1 = Unacknowledged.

The Boolean extension symbols for the inhibit status parameter INHSTA are the same as those for the ALMSTA parameter, except for the UNAK symbol.

Packed Boolean Connection Extensions


If the input parameter is a 16-bit packed Boolean variable, you can configure a connection extension to extract a specific set of booleans from the source parameter without changing other booleans in the input. This mask determines which booleans to copy each block cycle from the source parameter when the parameter is refreshed. The booleans specified in the connection mask are not settable by a Setval command, but all other booleans are settable. If an extension mask is not specified in the connection, all booleans are settable. If the extension information is invalid, the connection is Unresolved, the block is marked Undefined, and the OM scan status of the input is set to 0. The format of packed Boolean connection extensions is:
[Cname] :Bname.Pname.mask

Legend:
[] {,} NOTE

= optional = select one

The sink input data type must be packed Boolean. All other cases are invalid (packed long extensions are not supported).

70

5. Block Parameter Connections

B0193AV Rev P

Example
Cname:Bname.Pname.xxxx

1.

2.

3.

Meaning If Pname is Boolean data type: if Pname = 0, clear booleans xxxx in sink. Else, set booleans xxxx in sink. If Pname is integer, long integer, or short integer data type: copy booleans xxxx from Pname to sink. booleans ~xxxx in sink are unchanged. If Pname is real data type: convert Pname to unsigned integer and copy booleans xxxx from converted Pname. booleans ~xxxx in sink are unchanged.

An example using the full Cname:Bname.Pname.mask pathname is:


BLENDER1:CALC.IO01.02D0

Defaults for Integer and Real Connections


The paragraph Boolean Connection Extensions on page 63 explains how default values can be specified for inputs of Boolean type. You can also specify such default values for inputs of integer or real type by configuring the connection according to the following format:
Cname:Bname.Pname.n

where n is the desired default value. If the sink is of integer type, n is an integer. Example:
EVAPORATOR:F1200.HOLIM.7000

If the sink is of real type, then n is a real value in floating-point or scientific notation. Examples:
EVAPORATOR.F1200.HOLIM.124.5 EVAPORATOR.F1200.LOLIM.-3.2E-2

The default value specified is used only until the source value is available (that is, the connection is resolved and the source status is not BAD or OOS). When that happens, the source value is copied into the input parameter, and the default value is lost. The connection is secured while the specified default is in use. If the input parameter is connected to itself, however, the default value specified in the connection is preserved until the parameter is reconfigured. You can use this method of specifying defaults to override the standard default for any parameter, as stated in the parameter tables.

71

B0193AV Rev P

5. Block Parameter Connections

72

6. Editing Ladder Logic


This chapter contains information on editing ladder logic including entering and exiting the ladder logic editor, editing a ladder diagram, selecting library functions, printing a ladder diagram, checking syntax, and ladder installation.
NOTE

This chapter does not apply to the AW70 platform.

Entering and Exiting the Ladder Logic Editor


You enter the ladder logic editor from the Integrated Control Configurator (ICC). In ICC, you create a Programmable Logic Block (PLB) for each ladder diagram. A source file for a given ladder is created the first time you select the corresponding PLB and select Edit Ladder Logic. During an editing session, you create ladder source code. When you end the session, you can have the ladder code compiled and installed in a Fieldbus Module (FBM), saved in a library, or discarded. The following is an overview of an editing session, based on the premise that a compound that is to include ladder logic already exists. 1. Use the Integrated Control Configurator to select or create the compound that does or will contain the desired PLB block. 2. Select an existing PLB or add a PLB using Insert New Block/ECB. 3. From the Block Functions menu of the ICC, select Edit Ladder Logic. 4. Create a new ladder or edit an existing one as described in Creating/Modifying Functions on page 78. 5. Select any additional functions from the menu bar and follow the procedures shown on subsequent displays. 6. After completing all desired ladder diagram functions, select Done, Cancel, or Files. a. Select Done to install the ladder in the FBM specified in the IOM_ID parameter. This option is available only if the ladder is complete, syntactically correct, and compiled. b. Select Cancel to discard the code generated in the current editing session. c. Select Files to display a menu of library functions. Choose Save In Library to preserve a ladder that is not ready to compile and download to an FBM. Such a ladder can also be used in other FBMs. Ladder editing is terminated and control is returned to the ICC menu where you can select another mode of operation.

Getting Help
You can use the ICC Help function on the I/A Series Electronic Documentation CD-ROM which describes the general features of the Integrated Control Configurator.
73

B0193AV Rev P

6. Editing Ladder Logic

You can also use the Symbols function (see Showing Symbols on page 81) to display a list of function key assignments and select a symbol to insert in the ladder.

Editing a Ladder Diagram


The following quick reference tables precede the detailed procedures provided in this section on the use of editing functions: Table 6-1. Field Inputs Table 6-2. Cursor Control Table 6-3. Editing Keys Table 6-4. Symbol Keys Table 6-5. Technical Identifiers. Figure 6-1 shows the data fields of a ladder diagram.
Table 6-1. Field Inputs

Field Selected Symbol position Technical identifier User label Preset/reset value

Input Accepted Function keys, pointing device Alphanumeric keys character string entered must be from the list of valid technical identifiers Alphanumeric keys Numeric keys 0 through 65,000 counts; 0 through 6,500.0 seconds

NOTE

1. Keys other than those listed for a given field are disabled. 2. Only an output symbol is accepted in the extreme right position.

Table 6-2. Cursor Control

Function Move cursor from any symbol position on the display to any other symbol position on display. Move cursor horizontally to next or previous symbol position or to a preset value field. Move cursor up or down one symbol position display scrolls as necessary or between preset and reset value fields. Move cursor to first symbol position display scrolls as necessary. Move cursor to corresponding position in entire ladder display scrolls as necessary.

Pointing Device or Keys Pointing device Horizontal arrow keys Vertical arrow keys
Home key End key

74

6. Editing Ladder Logic

B0193AV Rev P

Table 6-2. Cursor Control (Continued)

Function Move cursor down or up one rung (not ladder line) display scrolls as necessary. Move cursor within preset or reset field. Move cursor between preset and reset fields without changing content. Move cursor from preset to reset fields after entering new information.
NOTE

Pointing Device or Keys


Page Down or Page Up keys

Horizontal arrow keys Vertical arrow keys


Enter or Return keys

1. Ladder line: A horizontal line of ladder logic providing only one path from the input to an output coil or another ladder line. 2. Ladder rung: All ladder lines providing a path to a common output coil or to fanned out output coils.

Table 6-3. Editing Keys

Function Add or replace a symbol

Key or Keys to Use Symbol keys (Table 6-4) (Use menu bar Symbols option to display keys and symbols.) Function Key 7 or Delete key Right arrow, followed by numeric keys

Delete a symbol Enter digits in preset or reset field (from timer or counter symbol) Delete digits in preset or reset field Delete key to remove a digit at the current cursor position; Backspace key to remove a digit to the left of the cursor Delete previous character in a Backspace key technical identifier or name field Add branch leg: From one position to the right of the desired branch: Insert connect down symbol In the upper row, F5 Insert connect up symbol In the lower row, F6 Delete branch leg: From one position to the right of the branch: Remove connect down symbol In the upper row, Shift+Delete keys Remove connect up symbol In the lower row, Shift+Delete keys Move ladder rows down + key (Insert ladder row) Move ladder rows up - key (Delete ladder row) Enter, Return, or Insert key followed by alpha keys (must Enter technical identifier be valid name)

75

B0193AV Rev P

6. Editing Ladder Logic

Table 6-3. Editing Keys (Continued)

Function Enter user-defined label (from technical identifier field, after typing a valid entry) Enter rung descriptor (cursor in last row of rung) Delete rung descriptor (cursor in last row of rung) Check ladder logic syntax Return control to main menu

Key or Keys to Use After tech ID of less than six characters, press Enter or Return; otherwise, type the sixth (last) character, and follow with alpha keys Press Shift+Insert (on the numeric keypad) followed by alpha keys. To return to symbol, press Shift+Insert again. Shift+Insert (on the numeric keypad) followed by the Delete key. Menu bar Compile or Ctrl+X keys Menu bar Done to install ladder or Cancel to discard; (use Save In Library option of Files) to save without installing

NOTE

When using function keys on the numeric keypad, be sure the Num Lock is not on.

Table 6-4. Symbol Keys

Symbol | | |/ | ( ) | | (L) (U) (RTO)(RTF)(RST)(CTU)(CTD)(MCR)(NCR)(ZCL)(NCL)(/) (TON)(TOF)-

Name Normally open contact Normally closed contact Connector Energize coil Vertical connector, down Vertical connector, up Delete Latch coil Unlatch coil Retentive timer-on delay Retentive timer-off delay Counter or timer reset Up counter Down counter Master control relay End of master control relay Zone control logic End of zone control logic Write not coil Non-retentive Timer-on delay Non-retentive Timer-off delay
F1 F2 F3 F4 F5 F6 F7 F8 F9

Key or Keys

F10 Shift+F1 Shift+F2 Shift+F3 Shift+F4 Shift+F5 Shift+F6 Shift+F7 Shift+F8 Shift+F9 Alt+F1 Alt+F2

76

6. Editing Ladder Logic

B0193AV Rev P

Table 6-5. Technical Identifiers

Technical Identifiers CIN_1 through CIN_32 CO_1 through CO_16 IFL_1 through IFL_32 OFL_1 through OFL_32 TC01_S through TC16_S TC01_S through TC16_S TC01_O through TC16_O INT_01 through INT_32 INIT POWERF COMMF FAILSF

Meaning Physical inputs Physical outputs External input flags External output flags Timer or counter coils Timer or counter status contacts Timer or counter overflow contacts Internal flags Initialize flag Power fail flag Communications failure flag Fail-Safe flag

The following terms describe display locations in a ladder display: Display line Ladder line Symbol position One horizontal line of text or symbols (20 available display lines in the ladder edit area) Six display lines, starting with the technical identifier line One of eight locations reserved for ladder symbols in the second display line of a ladder row

Ladder rung All ladder rows connecting to a common coil or coils. Figure 6-1 shows the fields in which data is entered or displayed.
HELP SYMBOLS COMPILE FILES PRINT NEW LINE NEW TI NEXT TI DONE CANCEL LINE: 001 COMPOUND: name BLOCK: name TEST/RUN Tech_ID [Sym1] User Label Tech_ID [Sym2] User Label Tech_ID [Sym3] User Label Tech_ID [Sym4] User Label Tech_ID [Sym5] User Label Tech_ID [Sym6] User Label Tech_ID [Sym7] User Label Tech_ID [Sym8] User Label Preset Reset

Tech_ID [Sym9] User Label Rung Descriptor line 1 Rung Descriptor line 2 Rung Descriptor line 3 Figure 6-1. Data Fields

[Sym1]: Symbol position 1 Preset/Reset: counter/timer values

77

B0193AV Rev P

6. Editing Ladder Logic

Creating/Modifying Functions
The following paragraphs describe the operations for editing ladder logic. The descriptions include the addition and/or replacement of symbols, texts, values, rows, and rungs. When making on-line edits keep in mind that: On-line edits to ladders do not cause the logic processor to re-initialize. On-line edits do not affect accumulated counts or latched coils.

Because timer/counter status flags reflect the relation between the accumulator and the preset registers, edits to preset values can alter status flags.

Positioning Editing Cursor


You can move the editing cursor by any of the following means: Pointing device Arrow keys

Enter or Return keys Page Up or Page Down keys Home or End keys.

The following describes procedures for moving the cursor directly or incrementally between symbol positions, from a timer/counter symbol position to a dialog box for preset/reset values, between text fields, from any symbol position to the beginning or end of the ladder, from any symbol position to the next or previous rung, from a symbol position to any other ladder line, and from a symbol position to another symbol with the same or different technical ID.
Moving Cursor Directly to Any Symbol Position on Display

When the editing cursor is in a symbol position: 1. Use the pointing device to move the arrow cursor near any other symbol position within the current display. 2. Click either pointing device button to bring the editing cursor to that location.
Moving Cursor Horizontally

1. From a symbol position: The right arrow key moves the cursor one position right (hold down to repeat). The left arrow key moves the cursor one position left (hold down to repeat). 2. From the right end of a row with a timer or counter coil: The right arrow key moves the cursor into a dialog box for entering or modifying preset and reset values. 3. From the right end of a row without a timer or counter coil: The right arrow key moves the cursor to the left end of the following row. If necessary, the display scrolls up one ladder row. 4. From the left end of a row: The left arrow key moves the cursor to the right end of the preceding row. If necessary, the display scrolls down one ladder row.
78

6. Editing Ladder Logic

B0193AV Rev P

Moving Cursor Vertically

1. From a symbol position: The up arrow key moves the cursor up one position (hold down to repeat). The down arrow key moves the cursor down one position (hold down to repeat). 2. From any position in the preset value field: The Enter or Return key moves the cursor to the first digit of the reset value field. 3. From any position in the reset value field: The Enter or Return key moves the cursor out of the dialog box. 4. From the first position in the reset or preset value field: The Enter or Return key (used before you type any digits) moves the cursor without changing the value. 5. From a symbol position in the last row: The down arrow key moves the cursor to the corresponding position in a new (blank) row.
Moving Cursor to the Beginning or End of the Ladder

The Home key moves the cursor to the first symbol position in the first row of the ladder. The End key moves the cursor from the current position to the corresponding position in the last row of the ladder.
Moving to the Previous or Next Rung

The Page Up key moves the cursor to the first symbol position in the last row of the previous rung. The Page Down key moves cursor to the first symbol position on the following rung. If necessary, the display scrolls one ladder row in either direction.
Moving to New Ladder Line

The New Line top menu bar button allows you to jump to a new ladder line. 1. Click the New Line button. 2. A dialog box appears, containing a data input field, a Done button and a Cancel button. 3. Enter the number of the ladder line of the target jump. All ladder line numbers can be viewed in the printout of the ladder obtained via the Print function. 4. Press Enter/Return. 5. Select the Done button to execute the jump. 6. Select the Cancel button at any time to exit the dialog box without jumping to the new line.
Moving to the Next Ladder Element Referencing a Particular Tech ID

The New TI top menu bar button allows you to move the cursor to the next (forward) occurrence of the specified Tech ID. The display scrolls, if necessary. 1. Click the New TI button.
79

B0193AV Rev P

6. Editing Ladder Logic

2. A dialog box appears, containing a data input field, a Done button and a Cancel button. 3. Enter a Tech ID name, followed by a carriage return. 4. Select the Done button. This moves the cursor to the next forward ladder element referencing the named Tech ID. The display scrolls, if necessary. If the end of the ladder is reached, the search wraps around to the first ladder line. If the search finds no element with the named Tech ID, the cursor does not move. 5. Select the Cancel button at any time to exit the dialog box without moving the cursor.
Moving to the Next Ladder Element Referencing the Tech ID of the Element at the Current Cursor Position

The Next TI top menu bar button allows you to move the cursor to the next (forward) occurrence of the currently referenced tech ID. The display scrolls, if necessary. Click the Next TI button. This moves the cursor to the next forward ladder element referencing the currently referenced Tech ID. The display scrolls, if necessary. If the end of the ladder is reached, the search wraps around to the first ladder line. If the search finds no element with the named Tech ID, the cursor does not move.

Adding or Replacing a Symbol


To add (or replace) a logic symbol in a ladder diagram: 1. Move the cursor to the desired symbol position. 2. Press a symbol key (See symbol key assignments listed previously in Table 6-4) or use the show Symbols function (see Showing Symbols on page 81). Output symbols must be the final element within a ladder line. At any other position, an error message appears (for example, Coils are last symbol in row). When you insert an NCL or NCR symbol, the editor automatically supplies a direct connection to the left rail (power source). If the symbol position you specify is not unused, the selected symbol, other than an up or down connector, replaces the one to which the cursor points. If you select an up or down connector symbol, it is added to the left of the symbol to which the cursor points. Once you have placed a symbol within a rung, enter the technical identifier directly above it and your choice of label below it. MCR, NCR, ZCL, and NCL have no technical identifiers or labels. You can replace a normally closed contact symbol with a normally open one (or the reverse) and the editor preserves the existing technical identifier and user-defined label. However, when you replace a symbol with a horizontal connector, a blank symbol, or any coil symbol, even the same as an existing coil, the editor deletes the technical identifier and user-defined label. When entering contact and coil symbols in a ladder, you should note that the technical identifiers listed in Table 6-5 constitute a fixed pool of resources associated with the FBM. A given technical identifier (for example, OFL_1) can be entered in more than one ladder segment of a composite ladder, but doing so does not create additional OFLs. There is only one OFL_1, with a single data value, in the FBM. It can be entered as an output coil in multiple segments of the ladder, in which case the final concatenated ladder has more than one rung ending with symbol OFL_1. When the OFL_1 value is transmitted to the control processor, its value depends on the evaluation of the highest numbered rung ending in OFL_1, that is, the last calculation of OFL_1 during the ladder
80

6. Editing Ladder Logic

B0193AV Rev P

scan. All PLBs connected to that FBM receive this value of OFL_1 as an input parameter. This implies that if the usage of technical identifiers is overlapped, a PLB block could receive values of parameters from the FBM different from the ones expected on the basis of their own ladder segments. The same considerations apply to overlapped usage of COs, TCs, and IFLs. The order of concatenation of multiple ladder segments is the same as the order of listing of the PLBs in the Ladder Assignment pick of the FBM menu. If any IFL is referenced in multiple segments of a composite ladder, the value sent down to the FBM for use in solving the ladder is the value of that IFL parameter in the PLB which is processed last. This depends on the zones, and positions within the zones, of the various PLBs involved, as shown on the Block/ECB Functions display of the ICC.

Showing Symbols
The Show Symbols function displays the instruction set and function key assignments. 1. Select the Symbols function from the menu bar. The list of symbols, symbol names, and function key assignments overlays a strip of the ladder extending from the Symbols heading down to the bottom of the work area. 2. After viewing the Symbols display, select the stop sign at the end of the symbol list. The editor withdraws the symbols overlay. While viewing the Symbols display, you can insert a symbol, if the editing cursor is in a symbol position, by either of the following methods: Press a function key. The editor inserts the symbol and withdraws the symbols overlay. Select a symbol from the displayed list and click the pointing device button. The editor inserts the symbol and removes the symbols overlay.

Connecting Two Rows


NOTE

Never attach UP branches to the first line in a rung. To insert a connection from the upper of two rows DOWNward: 1. Move the cursor to the upper of the two rows, one position to the right of the point where you want to make the connection. 2. Press the F5 key for the down vertical connector or select Connect Dn from the Symbols display. 3. Move the cursor to the lower of the two rows, at a symbol location one position to the right of the point where you want to make the connection. 4. Press the F6 key for the up vertical connector or select Connect Up from the Symbols display. To insert a connection from the lower of two rows UPward, do the above steps in the order 3, 4, 1, and 2.

81

B0193AV Rev P

6. Editing Ladder Logic

Deleting a Symbol
Be sure that you want to delete the element at the cursor position before you press the Delete key, because the effect is immediate. As soon as you press the key with a symbol selected, the symbol, its technical identifier, and its label are deleted. If the cursor is in a rung descriptor when you press Delete, all of the descriptor text is deleted immediately. 1. Use the arrow keys to position the cursor at a symbol. 2. See the appropriate subheading for the item to be deleted: a. Coil or contact symbol: press the Delete key, the delete function key (F7), or select Delete from the Symbols display to blank out the symbol, its Technical Identifier and user-defined label, and any up or down connector immediately to the left of it. If a coil represents a counter or timer, the preset and reset values in the column at the right are also deleted. b. Up or down vertical connector: With the cursor positioned at a symbol directly following an up or down vertical connector, press the Shift+Delete keys to blank out only the connector. See previous procedure for deleting a symbol if you want to delete both the symbol and connector. Blanks replacing a symbol open the rung connection, interrupting the power flow path.

Deleting a Rung Descriptor


1. Locate the cursor anywhere in the last row of the rung. 2. Press the Shift key and Insert key (on the numeric keypad) simultaneously. The cursor moves into the first position of the first line of descriptor text. a. To modify (by retyping) one entire line of text, press the Enter key as required to position the cursor at the start of the line to be changed. Retype the entire line. If you go beyond the last character position, you need to retype all of the next line also. b. To delete all lines of the descriptor, press the Delete key. The ladder closes up by six lines formerly occupied by the rung descriptor. 3. Press the Shift+Insert keys. The cursor returns to its original position.

Entering Text Associated with a Symbol


You can cycle the cursor through the text fields associated with a symbol position by using the following key sequence: 1. Using arrow keys or the pointing device, move the cursor to a symbol position. 2. Press the Insert, Enter, or Return key to move the cursor to the first character position of the Technical Identifier field immediately above the symbol.
NOTE

If no Technical Identifier has been entered (the field is blank), pressing Enter or Return repeatedly cycles the cursor back and forth between the symbol position and the Technical Identifier field.

82

6. Editing Ladder Logic

B0193AV Rev P

3. If a valid Technical Identifier exists (see Note under Step 2), press the Enter or Return key to move the cursor to the first character position in the first line of the userdefined label field, immediately below the symbol. 4. Press the Enter or Return key to move the cursor to the first character of the userdefined label second line. 5. Press the Enter or Return key to move the cursor to the symbol position directly above the user-defined label.
NOTE

Pressing the Return key while pointing to a text field without entering data does not affect the original contents of the field. If you make a mistake while typing a text field, use the Backspace key to delete incorrect characters.
Entering a Technical Identifier

1. Move the cursor to the Technical Identifier field (see Entering Text Associated with a Symbol on page 82). The cursor highlights the first position of the field, ready to accept a new or revised identifier. 2. Type one of the predefined technical identifiers. If you make a mistake while typing a text field, use the Backspace key to delete the incorrect characters. If you completed the entry but made a typing error or entered a label that was not from the predefined list, the editor displays the message Invalid tech ID, clears the text just entered, and returns the cursor to the first character position. If a valid identifier existed previously, the editor redisplays it. The cursor automatically moves to the first character position of the user-defined label field once you have completed typing a valid Technical Identifier.
NOTE

If the technical identifier you enter has been used elsewhere in the ladder, the editor fills in the user-defined label fields with the label used previously and moves the cursor to the first position of the first line. If you change the label, the new text appears beneath all other symbols having the same Technical Identifier when they are redisplayed.
Entering a User-Defined Label

1. Move the cursor to the first character, first line of the user-defined label (see Entering Text Associated with a Symbol on page 82). The cursor highlights the first position of the field, ready to accept a new or revised user-defined label. If the Technical Identifier has not been entered, you must enter it before you are allowed to move to the label field (see Entering a Technical Identifier on page 83). 2. Type the first line of the label. 3. To move to the second line, type the seventh character of the first line or press Enter or Return.

83

B0193AV Rev P

6. Editing Ladder Logic

4. To return to the symbol position, type the seventh character of the second line or press Enter or Return.
Entering Preset/Reset Values

1. From the timer or counter symbol position, press the right arrow key to open a dialog box showing a blank preset value field. The cursor is positioned to the first digit of the five-digit field. The values last configured remain visible in the column to the right of the dialog box until they are updated when the cursor returns to the symbol position. 2. Key in a new preset value, 0 through 65,000 counts or 0 through 6,500.0 seconds, or skip to the next step to retain the present value. (For a timer value, the integer value entered is converted to tenths.) 3. Press the Enter or Return key to enter the value (or retain an existing value without change) and open a dialog box showing a blank reset value field. The cursor is positioned to the first digit of the five-digit field. 4. Key in a new reset value, 0 through 65,000 counts or 0 through 6,500.0 seconds. (For a timer value, the integer value entered is converted to tenths.) 5. Press the Enter or Return key to enter the value (or retain an existing value) and return to the symbol position. Digits within a field can be added, deleted, or modified on an individual basis. Use the horizontal arrow keys to position the cursor and the Delete or Backspace key to remove unwanted digits. If you key in leading zeros, they are suppressed when the dialog box is removed. The chosen preset and reset values are assigned to the counter or timer and are also reflected in any other counter(s) or timer(s) within the ladder diagram having the same Technical Identifier (that is, related to the same coil).

Entering a Rung Descriptor


1. Locate the cursor anywhere in the last row of the rung. 2. Press the Shift key and Insert key (on the numeric keypad) simultaneously. The ladder opens up. All ladder rows beyond the one selected scroll down six lines. The cursor moves from its original position into the third display line following the rung. 3. Key in up to three lines of ASCII text; each line can contain up to 60 characters. 4. Once the text has been entered, press Shift+Insert keys a second time to return the cursor to where it was. If you make a mistake while typing within a rung descriptor line, use the Backspace key to delete the incorrect characters. At the end of each rung descriptor line, text wraps around to the beginning of the next line. At the end of the third line, text wraps to the beginning of the first line. Once wraparound occurs, you cannot get back to the end of the previous line without retyping all of it. 5. Each ladder can have a maximum of twenty rung descriptors.

84

6. Editing Ladder Logic

B0193AV Rev P

Adding or Deleting a Ladder Row


The Move Ladder Rows procedure allocates space between two existing ladder rows for inserting an additional ladder row. A ladder row consists of six display lines: one line for the Technical Identifier, one line for the symbol, two lines for the user-defined label, and two blank lines for rung separation. The Plus (+) key function lets you shift all remaining rows of a ladder downward one ladder row (six display lines) to make room for the insertion. (A ladder row actually begins with the display line reserved for the Technical Identifier field.) To insert a ladder row, press the + key. Six display lines are blanked out and the existing lines are redisplayed below the newly created blank area. The cursor moves to the first symbol position of the blank area. The Minus (-) key function lets you shift all remaining rows of a ladder upward one ladder row (six display lines). The procedure removes an existing ladder row. To delete a ladder row, press the - key.

The selected row is overwritten as the rows beyond it are redisplayed. If the cursor was in the last row of a rung, the rung descriptor is overwritten (deleted) as well, as the ladder is closed up.

Selecting Library Functions


1. Select the menu bar Files function. The Library Options menu is displayed:

View Library Copy From Library Save In Library Cancel.

2. Use the pointing device to select a library option. See the following subheadings for the option desired. 3. Select Cancel to exit from the Files menu without any further action. The menu is withdrawn and the top menu bar functions are again pickable.

View Library
The View Library function lists all of the previously saved ladder source files. To list files: 1. Select View Library from the menu. The first page of the library appears. 2. If the library is more than one display long, use the paging icons to view the entire library. 3. To exit the View Library function, select Done. The library window disappears.

Copy From Library


The Copy From Library function copies a source file from the library into the current source file. You can use Copy From Library to create multiple ladders that have the same logic. When you have a source file with a ladder diagram that you plan to use in more than one FBM, save it in the library. You can copy a source file from the library into your current source file at any time.

85

B0193AV Rev P

6. Editing Ladder Logic

When ladders with the same logic differ in areas such as I/O connections, you can edit the current source file after the copy to make adjustments. To copy the contents of a library source file into the current ladder source file: 1. Select Copy From Library from the menu. A dialog box appears on the display. The copy function displays the contents of the library. 2. Use either the alphanumeric keyboard or the pointing device to select a source file or use the pointing device to select Cancel. a. Type the name in the Choice field with the alphanumeric keyboard. If you type the name incorrectly, use the Delete key to delete characters and type the name again. Press the Enter or Return key to register your choice. b. Use the pointing device to select the name from the displayed list. If the menu is more than one display long, use the paging icons to view the entire library. c. To leave the Copy From Library function without copying a file, select Cancel from the dialog box. The copy function is canceled and the Files menu is redisplayed. 3. Select Copy from the dialog box. The source file selected in the previous step is copied into the current ladders source file. An hour glass symbol is displayed until the copy is complete. Then the Files menu is redisplayed.

Save In Library
The Save In Library function copies the current ladder source file into the library. The copy takes place whether or not the ladder contains syntax errors. The Save In Library function is the only way to save a source file that is not ready for compilation when you want to exit the ladder logic editor. The two menu bar options that allow you to exit the editor are Done and Cancel. The Done menu bar option is pickable only if all symbols have valid technical identifiers and all ladder rows provide a complete path to the rung output. Cancel can be selected at any time, but it does not save the source file. Therefore, to save an incomplete ladder, you must save it in the library before selecting Cancel. You can also save a ladder for use in more than one FBM. Once saved in the library, the ladder can be copied into other source files where similar logic is needed. To save the current ladder source file in the library source: 1. Select Save In Library from the menu. A dialog box appears on the display. The save function displays the contents of the library. 2. Type the name in the Choice field with the alphanumeric keyboard. If you type the name incorrectly, use the Delete key to delete characters and type the name again. Press the Enter or Return key to register your choice. It is not necessary for the name to be the same as that of the current PLB. A name can have up to 12 alphanumeric characters and must start with a letter. Scan the library to make sure you do not select a name that already exists. To leave the Save In Library function without saving the file, select Cancel from the dialog box. The save function is canceled and the menu disappears. The top menu bar functions become pickable again.

86

6. Editing Ladder Logic

B0193AV Rev P

Cancel
To exit the Library functions menu, select Cancel. The menu display is removed and the top menu bar functions again become pickable.

Printing a Ladder Diagram


To print a ladder diagram: 1. Select the menu bar Print function. A dialog box appears with a list of available printers. 2. Select a printer. The following message appears: Ladder printout initiated. All other functions are disabled until the print operation completes or you terminate it. 3. To terminate Print, press the Esc key. Control is returned to the menu bar, allowing you to select another mode of operation.

Checking Syntax
1. To check your ladder for syntax errors, select Compile from the menu bar or press the Control and X keys. The keyboard is rendered inactive and the following message is displayed:
Compiling ladder diagram XXXX. Please wait XXXX is the ladder diagram source files related PLB name.

a. If the compilation was successful, the following message appears at the bottom of the display:
Compile concluded ladder is O.K.

b. If errors resulted from the compilation, the following message appears at the bottom of the display:
Compilation complete. Error detected

The symbol associated with the error is highlighted and the error condition is displayed at the bottom of the display in ASCII text. If other errors exist, they remain undetected until you correct the preceding error and perform another syntax check. You should correct error conditions immediately. If uncorrected, errors prohibit downloading the interpretive code to the FBM when you select Done from the menu bar. 2. When the compilation is complete, the ladder diagram reappears on the display and the keyboard functions are reactivated. No interpretive code is generated, since Compile is used only to check syntax. Interpretive code is generated when the ladder is installed in the Fieldbus Module.

Ladder Installation
Ladder installation is the routine that:
87

B0193AV Rev P

6. Editing Ladder Logic

Merges the ladder source code (generated in the Ladder Logic editor) with the source code of the other ladders residing in the assigned FBM. Converts the resultant composite source code (merged ladder) to interpretative code. Sends the interpretative code to the selected PLB-type FBM. Installs ladder displays to make them accessible to workstations on the network. Note that installation (or uninstallation) always occurs as a result of an indirect user action. There is no install ladder or uninstall ladder menu selection anywhere in ICC.

Installation Requirements
Ladder installation takes place automatically as soon as you complete the following two requirements: 1. The ladder source code that you generated in the ladder logic editor has been passed through the editors Compile function, and exited via the Done option (rather than the Cancel option). 2. The associated PLB block has been assigned to an on-line FBM with an ECB8 (making it a PLB-type FBM). The requirement that occurs last automatically triggers ladder installation: That is, if the PLB assignment (requirement 2) was completed first, the installation automatically occurs the moment you select the Done key on the ladder logic editor menu bar (completing requirement 1). Conversely, if the source code has previously been Compiled and Done (requirement 1), the installation automatically occurs the moment the assignment of the PLB to a PLB-type FBM (requirement 2) is completed. ICC actions that can complete requirement 2 (thus triggering the installation if requirement 1 has been met) include: a. Changing a null IOM_ID to a valid IOM_ID. b. Changing one valid IOM_ID to another valid IOM_ID. c. Pasting a compound containing one or more PLB blocks. d. Performing a Maint LoadAll of a compound containing one or more PLB blocks.

Uninstallation
Ladders can be automatically uninstalled, or removed from the FBM. Some operations that can trigger uninstallation are:

Changing a valid IOM_ID to a null IOM_ID Deleting a PLB block Deleting a compound containing one or more PLB blocks.

Prerequisites for Ladder Installation


Procedures that must be done correctly before ladder installation can begin include the following: 1. The associated PLB must be installed in a station (rather than a library volume or Paste Buffer).

88

6. Editing Ladder Logic

B0193AV Rev P

2. The associated PLB block must have a valid FBM letterbug in the IOM_ID field. The following are examples of valid ways to configure the PLB Blocks IOM_ID parameter; these examples assume the FBM letterbug is PLB001: IOM_ID = PLB001 The FBM letterbug PLB001 is configured in the <Station_1bug>_ECB compound.

3. 4. 5. 6.

:PLB001 The FBM letterbug PLB001 is configured within the same compound (current compound) as the PLB block. TEST01:PLB001 The FBM letterbug PLB001 is configured within TEST01 compound. <Station_1bug>_ECB:PLB001 The FBM letterbug PLB001 is configured in the <station_1bug>_ECB compound. An ECB8 block must be built for the associated FBM. The ECB associated with the target FBM must be successfully installed in the target station (by adding the ECB to the station). The targeted FBM must be on-line. The targeted FBM must be downloaded.

Causes of Installation Failure


The following lists some of the causes of installation failures: 1. The FBM file containing the up to eight compound:block names associated with the assigned ladders is missing or corrupted. 2. One or more of the specified ladder source files has not been successfully syntaxchecked by the ladder editor. 3. The merged ladder contains syntax errors. 4. The merged ladder is too large to fit in the FBM. 5. The merged ladder has more than 100 lines of logic. 6. The Object Manager experiences errors communicating with the ECB block.

PLB Ladder Display Installation


ICC builds the ladder displays and stores them in a specified directory after all the following tasks have been completed: Entering valid IOM_ID parameter for PLB block Compiling ladder logic without error Selecting Done from the top menu bar in the Ladder Logic Editor. After Done is selected, ICC builds and installs the ladder displays. The 50 Series ICC can install the ladder displays in 50 Series as well as 20 Series format, depending on the system configuration. The 20 Series ICC only installs the ladder displays in 20 Series format on the CPs host (AP20), even if no WP20s or WP30s are configured for the I/A Series system.
89

B0193AV Rev P

6. Editing Ladder Logic

50 Series Workstation Access


Once the PLB ladder displays are installed, the Display Manager block detail display running on local or remote 50 Series workstations can directly access the ladder displays from any CPs host on the network. This default functionality can be changed. For more information, refer to the Display Engineering for 50 Series Workstations (B0193MQ) document.

Location of Ladder Displays


The 50 Series ICC installs the ladder displays in 50 Series format in the user-defined directory (/usr/plc50 by default) when 50 Series workstations are configured for the I/A Series system.

Configuring Ladder Display Location


By default, ICC installs the ladder displays in /usr/plc50. This location is configurable through ASCII file /usr/plc/plb_dir. Modification of this file allows you to have the ladder display location in different directories or disk partitions. ICC reads the plb_dir file to identify where to install the ladder displays. The Display Manager also reads this file to identify the base directory of the ladder displays for that particular host. The plb_dir file contains the following keywords:
PLB50=<50 Series base directory>

where <50 Series base directory> is the full pathname to the 50 Series display file base directory (maximum of 200 characters) To reallocate a ladder display directory (for example, into the /opt partition), you must: 1. Create or modify the /usr/plc/plb_dir file with the appropriate ladder display directories. 2. Move the ladder displays to the new base directory. When reallocating 20 Series display files on a 50 Series station to a base directory other than /usr/fox/ia16, you must link or loop-back mount the /usr/fox/ia16/<new_directory> to <new_directory>, otherwise WP20s, WP30s, and PWs cannot access the ladder displays. For example, to move all of the 20 Series and 50 Series ladder displays on an AP51 into the /opt/ladder directory, you must: 1. From the VT100 prompt, create the plb_dir file using the vi editor by typing:
vi /usr/plc/plb_dir

2. Set the keywords in the plb_dir file using the vi editor by typing:
PLB50=/opt/ladder/disp50 PLB=/opt/ladder/disp20

3. From the VT100 prompt, loop-back mount the /opt/ladder/disp20 directory: a. For Model 50 stations, type:
mount -t lo /opt/ladder/disp20 /usr/fox/ia16/opt/ladder/disp20

b. For Model 51 stations, type:


mount -F lofs /opt/ladder/disp20 /usr/fox/ia16/opt/ladder/disp20

In addition to the above steps, you must add the new mount point to the Foxboro mount table files, such that the /usr/fox/ia16/opt/ladder/disp20 is mounted when rebooting the AP:
90

6. Editing Ladder Logic

B0193AV Rev P

From the VT100 prompt, use the vi editor to edit the mount table files: a. For Model 50 stations, add the following line to the /etc/fstab file:
/opt/ladder/disp20 /usr/fox/ia16/opt/ladder/disp20 lo rw o o

b. For Model 51 stations, add the following line to the /etc/vfstab file:
/opt/ladder/disp20 - /usr/fox/ia16/opt/ladder/disp20 lofs - yes -

Once these changes are made, all the 50 Series workstations can access the ladder displays from the new directory, and ICC installs the PLB ladder displays into these directories. If a workstation contains ladder displays on its local disk or logical host, the files on the disk can be moved as described above.

91

B0193AV Rev P

6. Editing Ladder Logic

92

7. Editing Sequence Logic


This chapter contains information on editing sequence logic including the use of ICC help, sequence files, sequence logic functions, and sequence code installation. For a detailed description of Sequence language, refer to High Level Batch Language (HLBL) Users Guide (B0400DF). Sequence logic is composed of Sequence language statements and user-labeled parameters (refer to High Level Batch Language (HLBL) Users Guide [B0400DF]). To add sequence logic to a sequential control block: 1. Install a sequential control block in a compound or select a previously installed sequential control block. After the block is selected or installed, the Block/ECB Functions menu appears. Refer to Figure 7-1. 2. Select Edit Sequence Logic from the Block/ECB Functions menu. Edit Sequence Logic cannot be selected unless the current block type is IND, DEP, EXC, or MON. After you have selected Edit Sequence Logic, the Sequence Logic Functions menu appears. See Figure 7-2.
HELP SHOW FBM PRINT NEW CHECKPOINT BUFFER MAINT Integrated Control Configurator Inactive STA =STA101 @ AP1002 DT01BTMLCFC DT01LT1D7 Block/ECB Functions DT01CRC107 View Compound List DT01FT116 Insert New Block/ECB DT01FRC116 Edit Standard Block/ECB Parameters DT01CU120 Edit All Block/ECB Parameters DT01ACUM116 Edit Ladder Logic DT01SEQDEP Edit Sequence Logic END SEQ*** Select to Move END CON2** Move Move Group End Move Upload Block/ECB Parameters Delete Figure 7-1. Block/ECB Functions Menu EXIT

93

B0193AV Rev P

7. Editing Sequence Logic

HELP

SHOW

FBM

PRINT

NEW

CHECKPOINT Inactive

BUFFER

MAINT

EXIT

Integrated Control Configurator Block Definition: Name: DT01SEQDEP Type: DEP

STA =STA101 @ AP1002

Sequence Logic Functions Edit Source of this Block Compile Source of this Block View Compilation Listing View Source Library Contents Copy Source of this Block from Library Save Source of this Block to Library Delete Block Source from Library Print Compilation Listing Print Listing of this Block View Include Library Contents Done with Sequence Cancel Figure 7-2. Sequence Logic Functions Menu

When the Sequence Logic Functions menu is on the display, you cannot select any menu bar functions except Help. The current block name and block type are displayed above the menu. The functions of the Sequence Logic Functions menu only operate on the current block. When creating sequence logic, you are working in a source file. You must compile this file before you can update the current block with the sequence logic. Source and compiler files are described in Sequence Files on page 94. Sequence logic functions are described in Sequence Logic Functions on page 96.

Help
Before or after selecting a function from the Sequence Logic Functions menu, you can use the ICC On-line Help, which describes the general features of the Integrated Control Configurator (ICC).

Sequence Files
A sequential control block has the following files associated with it: A source file

Compiler files.

94

7. Editing Sequence Logic

B0193AV Rev P

Source File
The source file is supplied automatically by the Integrated Control Configurator. As you create sequence logic, it is stored in the source file. The following functions of the Sequence Logic Functions menu operate on the source file:

Cancel Compile Source of this Block Copy Source of this Block From Library Done With Sequence Edit Source of this Block Print Listing of this Block Save Source of this Block to Library.

For a description of each function, refer to Sequence Logic Functions on page 96. The source file has the same name as the current block followed by an .s extension (blockname.s). Source file names appear in the library functions:

Copy Source of this Block from Library View Source Library Contents Save Source of this Block to Library Delete Block Source from Library.

The library is a directory where you can save source files for future use. For more information on the source file, refer to Edit Source of this Block on page 101.

Compiler Files
The compiler produces the executable files needed at run time. The source file must be compiled before you can update the sequence block with the sequence logic. When compilation is successful, the compiler produces the following files: An interpretive code module An operator representation module A formatted sequence program listing. When the compiler detects errors in the source file, it only produces the formatted sequence program listing. The interpretive code module and operator representation module are run-time files. The formatted sequence program listing is a formatted copy of the source file that can be used for archiving or debugging. When the compiler detects errors, it places error messages in the formatted sequence program listing. You can use the following functions in the Sequence Logic Functions menu to look at the compiler error messages:

View Compilation Listing Print Compilation Listing.

For more information on the compiler and compiler files, refer to Compile Source of this Block on page 96.

95

B0193AV Rev P

7. Editing Sequence Logic

Sequence Logic Functions


In the paragraphs that follow, the sequence logic functions are described in alphabetical order.

Cancel
The Cancel function exits the Sequence Logic Functions menu without updating the current sequence block with sequence logic. The source file and compiler files (if the source file has been compiled) are not saved. To exit the Sequence Logic Functions menu without updating the current block; select Cancel from the menu. The Block/ECB Functions menu appears on the display. Refer to Figure 7-1.
NOTE

1. The current block is updated with sequence logic only when the source file compiles without errors and you select Done With Sequence to exit the Sequence Logic Functions menu. See Compile Source of this Block on page 96 and Done With Sequence on page 101. 2. To exit the Sequence Logic Functions menu and save an uncompiled source file, select Save Source of this Block to Library prior to selecting Cancel. This saves the source file for future edits but does not update the current block. Refer to Save Source of this Block to Library on page 106.

Compile Source of this Block


The Compile Source of this Block function creates the executable files from the source file. The current sequential control block cannot be updated with sequence logic until the source file compiles without errors. When the source file compiles without errors, the compiler produces: An interpretive code module An operator representation module A formatted sequence program listing. When the source file compiles with errors, the compiler only produces the formatted sequence program listing. The interpretive code module contains a sequential control blocks executable code. The operator representation module contains a compiler-formatted listing of all sequence language statements. At run time, it shows the progression of statement execution on block displays. The formatted sequence program listing contains the sequence language statements formatted for debugging or archiving. If errors exist, they are noted below the statements in which they occur. The compiler lists external references found in the language statements of the main code, the subroutine code, and the exception handlers. External references are parameters or shared variables from other blocks and applications referred to in the sequence algorithm. They are checked for errors at run time. All of the compiler-generated files have the same name as the current block. The different file types are identified by file name extensions: blockname.i = interpretive code module
96

7. Editing Sequence Logic

B0193AV Rev P

blockname.r = operator representation module blockname.l = formatted sequence program listing.

To compile the current block: 1. Select Compile Source of this Block from the menu. 2. When a source file compiles without errors, the Sequence Logic Functions menu appears. 3. When the compiler detects errors in the source files, it produces the following message:

HLBL Compilation Completed. xxx HLBL Statement Errors Found. Failed. Select CONTINUE to Proceed CONTINUE

xxx is the number of compiler errors found in the source file.

The compilation is canceled. When you select Continue, the Sequence Logic Functions menu appears. 4. When there are errors in the source file, the compiler stores error messages in the formatted sequence program listing file. Refer to View Compilation Listing on page 108 or Print Compilation Listing on page 105. Before you can update the sequence block with sequence logic, you must correct the source file and compile it.

Copy Source of this Block from Library


The Copy Source of this Block from Library function copies a source file from the library into the current source file. You can use Copy Source of this Block from Library to create blocks that have the same sequence logic. When you have a source file with sequence logic that you plan to use in more than one block, save it in the library (refer to Save Source of this Block to Library on page 106). You can copy a source file from the library into your current source file at any time. When blocks with the same sequence logic differ in areas, such as Input/Output connections, you can edit the current source file after the copy to make adjustments (refer to Edit Source of this Block on page 101). To copy the contents of a library source file into the current source file: 1. Select Copy Source of this Block from Library from the menu. A dialog box appears on the display. Refer to Figure 7-3. The copy function displays the contents of the library. 2. Select a source file by entering the name in the Choice field with either the alphanumeric keyboard or the pointing device.

97

B0193AV Rev P

7. Editing Sequence Logic

To enter a name with the keyboard, type in the name and press the Return key. If you enter the name incorrectly, use the Delete key to delete characters, and enter the name again.
HELP SHOW FBM PRINT Integrated Control Configurator NEW CHECKPOINT BUFFER MAINT EXIT Inactive STA =STA101 @ AP1002

Block Definition: Name: DT01SEQDEP Type: DEP

Sequence Block Library CHOICE indblock.s depblock.s excblock.s monblock.s

COPY

CANCEL

Figure 7-3. Copy Source of This Block From Library

To enter a name with the pointing device, select the file name from the list of source files currently in the library. If the library is more than one display long, use the paging icons to view the entire library. To move one display at a time to the end of the library, select the next display icon (a pair of down arrows). To move one display at time to the beginning of the library, select the previous display icon (a pair of up arrows). To go directly to the first display of the library, select the first display icon (a pair of up arrows under a bar). To go directly to the last display of the library, select the last display icon (a pair of down arrows over a bar). 3. Select Copy from the dialog box. The source file selected in the previous step is copied into the current blocks source file. An hour glass is displayed until the copy is complete. Then, the Sequence Logic Functions menu appears. 4. To leave the Copy Source of this Block from Library function without copying a file, select Cancel from the dialog box. The copy function is canceled and the Sequence Logic Functions menu appears. 5. If the selected source file is not found in the library, the following message appears:

98

7. Editing Sequence Logic

B0193AV Rev P

Cannot Copy: - Source Selected to copy from library does not exist. Select CONTINUE to Proceed CONTINUE

The copy function is canceled. When you select Continue, the Sequence Logic Functions menu appears.

Delete Block Source from Library


The Delete Block Source from Library function deletes a source file from the library. ! CAUTION Do not delete any of the following skeleton files from the library: depblock.s, excblock.s, indblock.s, and monblock.s. To delete a block source file from the library: 1. Select Delete Block Source from Library from the menu. A dialog box appears on the display. Refer to Figure 7-4. The delete function displays the contents of the library. 2. Select a source file by entering the name in the Choice field with either the alphanumeric keyboard or the pointing device. To enter a name with the keyboard, type in the name and press the Return key. If you enter the name incorrectly, use the Delete key to delete characters, and enter the name again.

99

B0193AV Rev P

7. Editing Sequence Logic

HELP

SHOW

FBM

PRINT

NEW

CHECKPOINT Inactive

BUFFER

MAINT

EXIT

Integrated Control Configurator Block Definition: Name: DT01SEQDEP Type: DEP

STA =STA101 @ AP1002

Sequence Block Library CHOICE indblock.s depblock.s excblock.s monblock.s

DELETE

CANCEL

Figure 7-4. Delete Block Source From Library

To enter a name with the pointing device, select the file name from the list of source files currently in the library. If the library is more than one display long, use the paging icons to view the entire library. To move one display at a time to the end of the library, select the next display icon (a pair of down arrows). To move one display at time to the beginning of the library, select the previous display icon (a pair of up arrows). To go directly to the first display of the library, select the first display icon (a pair of up arrows under a bar). To go directly to the last display of the library, select the last display icon (a pair of down arrows over a bar). 3. Select Delete from the dialog box. The source file selected in the previous step is deleted from the library. Then, the Sequence Logic Functions menu appears. 4. To leave the Delete Block Source from Library function without deleting a file, select Cancel from the dialog box. The delete function is cancelled and the Sequence Logic Functions menu appears. 5. If the selected source file is not found in the library, the following message appears:

100

7. Editing Sequence Logic

B0193AV Rev P

Cannot Delete: - Source Selected to delete from library does not exist. Select CONTINUE to Proceed CONTINUE

The Delete function is cancelled. When you select Continue, the Sequence Logic Functions menu appears.

Done With Sequence


The Done With Sequence function exits the Sequence Logic Functions menu and updates the current sequence block with the sequence logic that you have created. A sequence block cannot be updated with sequence logic unless the source file containing the logic compiles without errors. To exit and update the sequence block with sequence logic, select Done With Sequence from the menu. The Block/ECB Functions menu appears. Refer to Figure 7-1.
NOTE

To exit the Sequence Logic Functions menu when the source file is not compiled, use Cancel. This does not save the source file. If you want to save the source file, select Save Source of this Block to Library before selecting Cancel.

Edit Source of this Block


The Edit Source of this Block function calls the sequence editor and displays the current source file on the display. Through the editor, you can add Sequence language statements and user-labeled parameter declarations to the source file. Initially the source file contains a template for the current sequential block type. You add parameters and statements to the template to build the sequence logic. Each template includes: Keywords denoting the structure of the source file

Sequential control block type (IND, DEP, EXC, or MON)

Comment lines that serve as guidance. The templates for the Independent, Dependent, and Exception blocks are almost identical, differing only at the title lines at the very beginning of the template. A representation of these three templates is shown below followed by the layout of the Monitor block template.

101

B0193AV Rev P

7. Editing Sequence Logic

INDEPENDENT_SEQUENCE{******************************* ** INDEPENDENT SEQUENCE ** ** CONTROL BLOCK ** *****************************************} CONSTANTS {***************************************** * specify any Constants * * in the following format: * ****************************************** * constant_name = value ; * *****************************************} VARIABLES {***************************************** * specify any Block Local Variables * * in the following format: * ****************************************** * variable_name [ , variable_name ] : type;* * where type is one of B, I, R, S, S12, S6* *****************************************} USER_LABELS{**************************************** * specify any user labeled parameters * * in one of the following formats: * ****************************************** * user_label_name : BI00nn; n = 01 -- 24 * * user_label_name : BO00nn; n = 01 -- 16 * * user_label_name : BA000n; n = 1 -- 4 * * user_label_name : RI00nn; n = 01 -- 15 * * user_label_name : RO00nn; n = 01 -- 15 * * user_label_name : RA000n; n = 1 -- 2 * * user_label_name : II000n; n = 1 -- 8 * * user_label_name : IO000n; n = 1 -- 5 * * user_label_name : IA0001; * * user_label_name : SN00nn; n = 01 -- 10 * *****************************************} {***************************************** * Specify any Subroutines * ****************************************** * SUBROUTINE name ( formal arguments ) * * VARIABLES subr. local variables ; * * STATEMENTS * * ; * * ENDSUBROUTINE * *****************************************} {***************************************** * Specify any * * Standard Block Exception Handlers * ****************************************** * BLOCK EXCEPTION exc_name [ DISABLE ] * * STATEMENTS * * ; * * ENDEXCEPTION * *****************************************} STATEMENTS{***************************************** * Specify the statements here * *****************************************} ENDSEQUENCE

Below is the layout of the Monitor block template.

102

7. Editing Sequence Logic

B0193AV Rev P

MONITOR

{***************************************** * MONITOR * * CONTROL BLOCK * *****************************************}

CONSTANTS {***************************************** * specify any constants in the following * * format: * * * * constant_name = value ; * *****************************************} USER_LABELS{**************************************** * specify user labeled parameters in * * one of the following formats: * * * * user_label_name : BI00nn; n = 01 -- 24 * * user_label_name : RI00nn; n = 01 -- 15 * * user_label_name : II000n; n = 1 -- 8 * *****************************************} {*************************************************************** * specify all monitor case(s) in one of the following formats: * **************************************************************** * nn ; * * nn boolean_expression ; * * nn boolean_expression --> user output ; * * nn WHEN boolean_expression DO Sequence_Block_name ; * * nn WHEN bool_expr --> user output DO Sequence_Block_name ; * ***************************************************************} CASES 1 ; 2 ; 3 ; 4 ; 5 ; 6 ; 7 ; 8 ; 9 ; 10 ; 11 ; 12 ; 13 ; 14 ; 15 ; 16 ; ENDMONITOR

A copy of each template is stored in the library. If, while editing sequence logic, you choose to start over again with a clean template, you can copy the template into the source file, overwriting any previous sequence logic (refer to Copy Source of this Block from Library on page 97). The templates are stored in the library under the following file names: indblock.s (Independent block template) depblock.s (Dependent block template) excblock.s (Exception block template) monblock.s (Monitor block template).

103

B0193AV Rev P

7. Editing Sequence Logic

NOTE

The source file has the same name as the current block followed by an .s extension (blockname.s). The source file name appears in functions that display the library such as Copy Source of this Block from Library, View Source Library Contents, and Save Source of this Block to Library.
UNIX Platform Users Only:

To edit the current source file: 1. Select Edit Source of this Block from the menu. This calls the Sequence editor.
NOTE

Do not enter Control+Z while in the sequence editor. 2. The current blocks source file is displayed. 3. With the editor, you can add or modify sequence logic statements and parameters (refer to Sequence Language in High Level Batch Language (HLBL) Users Guide [B0400DF]). The Sequence editor is one of two possible editors: a. For CPs hosted by SUN workstations, such as an AW51, the vi editor is available. For information on vi editing features for SUN platforms, refer to the SUN OS Users Guide, Getting Started and Editing Text Files. b. For Solaris workstation hosts, such as the AW51F with control capability, Text Editor is available. The editing features of text editor are similar to Notepad on the Windows operating system. For information on available editing features of Text Editor on the Solaris platform, refer to the section titled Text Editor in the OpenWindows Users Guide. 4. After you finish editing the sequence logic, you can compile the source file (refer to the Compile Source of this Block on page 96).
AW70 Users Only:

To edit the current source file: 1. Select Edit Source of this Block from the menu. This causes display of a dialog box. The box instructs you to open a Notepad window and supplies the path to be used in finding the file to be edited. 2. Use the Notepad to display the current blocks source file. 3. With the editor, you can add or modify sequence logic statements and parameters (refer to Sequence Language in High Level Batch Language (HLBL) Users Guide [B0400DF]). 4. When finished editing, save the modified source and exit the Notepad session. 5. Within the ICC display, select Continue in the blue dialog box; at this point, the Sequence Logic Functions menu appears. 6. After you finish editing the sequence logic, you can compile the source file (refer to the Compile Source of this Block on page 96).
104

7. Editing Sequence Logic

B0193AV Rev P

All Users: NOTE

You must use uppercase characters for all compound, block, and parameter names in sequence logic. Since sequence commands (Activate, Start_timer, and so forth) must also be in uppercase characters, you may find it easiest to use uppercase throughout. Always leave a blank line after the Statements line, otherwise the All Code page on the block detail display does not show the first statement.

Print Compilation Listing


The Print Compilation Listing function generates a printed copy of the current blocks formatted sequence program listing. The formatted sequence program listing is a file produced by the compiler that contains a list of the Sequence language statements formatted for debugging or archiving. In this file, any compilation errors that exist are noted below the statements in which they occur. The file also provides you with a list of external references found in the language statements of the main code, the subroutine code, and the exception handlers. External references are parameters from other blocks or shared variables from other applications referred to in the sequence algorithm. External references are not checked for errors until runtime. To print the formatted listing: 1. Select the Print Compilation Listing function from the menu. The Printer Selection menu appears.

PRINTERS AVAILABLE CANCEL smloki lrgoki LP01 Okidata 182 Okidata 293 Okidata 182

2. Select the printer that is to produce the listing, or Cancel the printout. The ICC returns to the Sequence Logic Functions menu.

Print Listing of this Block


The Print Listing of this Block function generates a printed copy of the current block source file. To print the source listing: 1. Select the Print Listing of this Block function from the menu. The Printer Selection menu appears.

105

B0193AV Rev P

7. Editing Sequence Logic

PRINTERS AVAILABLE CANCEL smloki lrgoki LP01 Okidata 182 Okidata 293 Okidata 182

2. Select the printer that is to produce the listing.

Save Source of this Block to Library


The Save Source of this Block to Library function saves a copy of the current source file in a local directory whether it has been compiled or not. Saving a source file in the library does not update the current sequence block with sequence logic. The Save Source of this Block to Library function is the only way to save an uncompiled source file when you exit the Sequence Logic Functions menu. There are two functions to exit the Sequence Logic Functions menu: Done With Sequence and Cancel. Done With Sequence can only be selected when the source file has been compiled. Cancel can be selected at any time, but it does not save the source file. Therefore, to save an uncompiled source file, you must save it in the library before selecting Cancel. Also, it is helpful to save a source file in the library when you plan to use the same sequence logic contained in the source file in more than one block. Once saved in the library, it can be copied into other sequence block source files (refer to Copy Source of this Block from Library on page 97). You can look at the list of files already saved in the library, with the View Source Library Contents function (refer to View Source Library Contents on page 110). To save the current source file in the library: 1. Select Save Source of this Block to Library from the menu. A dialog box appears on the display. Refer to Figure 7-5. The Save function displays the contents of the library.

106

7. Editing Sequence Logic

B0193AV Rev P

HELP

SHOW

FBM

PRINT

NEW

CHECKPOINT Inactive

BUFFER

MAINT

EXIT

Integrated Control Configurator Block Definition: Name: DT01SEQDEP Type: DEP

STA =STA101 @ AP1002

Sequence Block Library CHOICE indblock.s depblock.s excblock.s monblock.s

SAVE

CANCEL

Figure 7-5. Save Source of this Block to Library

2. Type the file name with the alphanumeric keyboard and press the Return key. If the name is entered incorrectly, use the Backspace key to delete characters and enter the name again. The name does not need to be the same as the current block name. A name can be up to 12 alphanumeric characters long. The .s extension that identifies a source file is optional for libraried files. Scan the library to make sure you do not select a name that already exists. If you do, the new file that you are saving overwrites the old file currently in the library. When the library is more than one display long, use the paging icons to view the entire library. To move one display at a time to the end of the library, select the next display icon (a pair of down arrows). To move one display at a time to the beginning of the library, select the previous display icon (a pair of up arrows). To go directly to the first display of the library, select the first display icon (a pair of up arrows under a bar). To go directly to the last display of the library, select the last display icon (a pair of down arrows over a bar). 3. Select Save from the dialog box. The current source is saved in the library. An hour glass is displayed until save is complete. When complete, the Sequence Logic Functions menu appears. 4. To exit without saving the source file in the library, select Cancel from the dialog box. The Sequence Logic Functions menu appears.

107

B0193AV Rev P

7. Editing Sequence Logic

View Compilation Listing


The View Compilation Listing function places the formatted sequence program listing on the display. This file, created by the compiler, is used for archiving or debugging. When errors are detected, they are noted below the statements in which they occur. The file also lists external references found in the language statements of the main code, the subroutine code, and the exception handlers. External references are checked for errors at run time. (External references are parameters from other blocks or shared variables from other applications referred to in the sequence algorithm). Also, you can print a copy of the formatted sequence program listing with the print function (refer to Print Compilation Listing on page 105). Here is an example of a compiler error message:
If the source file had a statement that read: IIF level > 50 THEN ACTIVATE :reactor_1:drain; The listing file would have an error message below IIF: IIF ^^^# ERROR: parameter 'IIF' not declared

Since it does not recognize the beginning of the IF statement due to a typing error, it considers it an undefined parameter. It also produces another error when it reaches the THEN clause in the IF statement since it does not recognize IIF as a corresponding IF. In this way one error can generate several error messages.
UNIX Platform Users Only:

To view the formatted sequence program listing: 1. After the block is compiled, the View Compilation Listing menu function becomes selectable. Select this function. The listing file appears on your display. Error messages appear below the statement where the error is located. There is also an error summary at the end of the file. 2. Like Edit Source of this Block, View Compilation Listing places you in the Sequence editor, vi or Text Editor. You can use the appropriate editing functions to move through the file. The Help function on the menu bar is not active. For information on vi editing features for SUN platforms, refer to the SUN OS Users Guide, Getting Started and Editing Text Files. For information on Text Editor, refer to the section titled Text Editor in the OpenWindows Users Guide. You can only look at errors in the listing file. Corrections must be made to the source file through the Edit Source of this Block function.
AW70 Users Only:

To view the formatted sequence program listing: 1. After the block is compiled, the View Compilation Listing menu function becomes selectable. Select this function. A dialog box appears; it instructs you to open a Notepad window and supplies the path to be used in finding the listing file. Error messages appear below the statement where the error is located. There is also an error summary at the end of the file. 2. Use the Notepad to display the listing file on the display. Error messages appear below the statement where the error is located. There is also an error summary at the end of the file. You can use the editing function to move through the file.
108

7. Editing Sequence Logic

B0193AV Rev P

3. When finished viewing the file, exit the Notepad session. Within the ICC display, select Continue in the blue dialog box to return to the Sequence Logic Functions menu.

View Include Library Contents


The View Include Library Contents function lists all the user-developed sequence include files in the include file directory.
UNIX Platform Users Only:

The include file directory on VENIX platforms is /usr/fox/ciocfg/sequeninclude. The include file directory on SUN platforms is /opt/fox/ciocfg/sequeninclude.
All Users:

1. Select View Include Library Contents from the menu. The first page of the library appears. See Figure 7-6. 2. If the library is more than one display long, use the paging icons to view the entire library. To move one display at a time to the end of the library, select the next display icon (a pair of down arrows). To move one display at a time to the beginning of the library, select the previous display icon (a pair of up arrows). To go directly to the first display of the library, select the first display icon (a pair of up arrows under a bar).

HELP

SHOW

FBM

PRINT

NEW

CHECKPOINT Inactive

BUFFER

MAINT

EXIT

Integrated Control Configurator Block Definition: Name: DT01SEQDEP Type: DEP

STA =STA101 @ AP1002

Sequence Include Library depblock.s excblock.s indblock.s monblock.s INCTEST.seq NOINV.seq

DONE Figure 7-6. View Include Library Contents

To go directly to the last display of the library, select the last display icon (a pair of down arrows over a bar).
109

B0193AV Rev P

7. Editing Sequence Logic

3. To cancel the View Include Library Contents function, select Done. The Sequence Logic Functions menu appears.

View Source Library Contents


The View Source Library Contents function lists all previously saved sequential control block source files. To list files: 1. Select View Source Library Contents from the menu. The first page of the library appears. Refer to Figure 7-7. 2. If the library is more than one display long, use the paging icons to view the entire library. To move one display at a time to the end of the library, select the next display icon (a pair of down arrows). To move one display at a time to the beginning of the library, select the previous display icon (a pair of up arrows). To go directly to the first display of the library, select the first display icon (a pair of up arrows under a bar).
HELP SHOW FBM PRINT Integrated Control Configurator NEW CHECKPOINT Inactive BUFFER MAINT VOL = vo1001 EXIT

Block Definition: Name: DT01SEQDEP Type: DEP Sequence Source Library depblock.s excblock.s indblock.s monblock.s

DONE Figure 7-7. View Source Library Contents

To go directly to the last display of the library, select the last display icon (a pair of down arrows over a bar). 3. To cancel the View Source Library Contents function, select Done. The Sequence Logic Functions menu appears.

Sequence Code Installation


The sequence code files that are used by the block detail display All Code page are installed in the following directory:

110

7. Editing Sequence Logic

B0193AV Rev P

/opt/fox/ciocfg/<compound> (50 Series AP and AW).

50 Series Workstation Access


Once a Sequence block is installed, the Display Manager block detail display on local or remote 50 Series workstations can directly access the sequence code from any CPs host on the network. This default functionality can be changed. For more information, refer to the Display Engineering for 50 Series Workstations (B0193MQ) document.

High Level Batch Language Documentation


For information on the Sequence language, the HLBL preprocessor and compiler, HLBL statements, and error messages, refer to High Level Batch Language (HLBL) Users Guide (B0400DF).

111

B0193AV Rev P

7. Editing Sequence Logic

112

Index
A Archiving sequence logic file 108 Assigning ladder function 54 B Balancing loading 25 Block building order 39 Block parameters edit 47 Block/ECB replace block/ECB list with compound list 33 replace ECB functions menu with compound functions menu 33 Blocks continuous 39 create new 33 delete 32 editing parameters 47 reconnect 32 rename 51 retrieve settable parameter values 31 Boolean variable 16-bit packed 48 C Checkpointing 55 Close current file and choose another 55 Compile ladder logic diagram 87 sequence logic 94, 96 Compound block names 12 create new 21 creating new 12 delete 32 functions menu replace with the block/ECB functions menu 32 list replace with the block/ECB list 32 move to the configurator file in a preselected position 25 parameters
113

B0193AV Rev P

Index

edit 23 reconnect 32 Compound summary access (CSA) search utility 4 Compress configurator database 58 Configuration compound retrieve settable parameter values 31 Connections block parameter 48 Boolean input 48 local 47 peer-to-peer 47 Control keys 3 Control processor 19 selection 16 Copy sequence logic source file from library 97, 99 Create ladder logic 78 new compound 21 CSA 11 hierarchy 12 requirements 11 Cursor control 2 D Database compress 58 Debugging sequence logic file 108 Defining Fieldbus Modules 40 Diskette load compound from 27 save all compound function entities to 25 E ECB adding 41 create new 33 editing functions 19, 47 editing parameters 47 reconnect 32 rename 51 retrieve settable parameter values 31 Edit block parameters 47 compound parameters 23 exit 59
114

Index

B0193AV Rev P

ladder logic 50 sequence logic 50, 93 sequence logic source file 101105 Editing functions ECB 19, 47 Engineers environment 4 Erroneous parameter correction 48 Error failure or warning 48 floppy disk mount failed 27, 29, 57 ladder diagram syntax 87 log file 56 operation is invalid 39 paste insert failure 25 sequence logic compilation 105 summary box 56 unknown name 55 Exit edit 59 sequence logic function 96 the sequence logic functions menu 101 F Failure ladder logic installation 89 FBM Fix all function 54 function 54 pull-down menu 19 Fieldbus defining modules 40 File close current and choose another (new) 55 ladder logic diagram source file 87 remove all compounds, ECBs, and blocks 58 sequence logic 94 sequence logic source file editor 101105 Fix all 54 Formatted sequence program listing sequence logic 96 Function keys 3 Functions FBM 54 selecting 3 sequence logic 96

115

B0193AV Rev P

Index

H Help ladder logic editor 73 Hierarchy control configurator 4 CSA 12 I Initial boot compounds automatically installed 23 Insert new compound 21 Install ladder logic (code) 87 K Keys control 3 function 3 vol 15 L Ladder diagram edit 7477 Ladder displays access 90 configuring location 90 installation 89 location 90 Ladder function assignment 54 Ladder installation 87 requirements 88 Ladder logic diagram syntax 87 installation failure 89 prerequisites 88 print diagram 87 uninstalling 88 Ladder logic block edit 50 Ladder logic diagram source file 87 Ladder logic editor create/modify functions 7885 help 73 introduction 73
116

Index

B0193AV Rev P

library functions 8587 Library functions ladder logic editor 8587 List show various lists of items 25 Load a compound from a high-density diskette 27 the contents of a diskette to the currently-selected buffer paste, volume, or station 56 Loading balancing 25 M Menu item selecting 3 Menus 4 Modify ladder logic 78 station 11 Move block within zone 40 objects in the compound or block/ECB list 29 N Name compound block 12 P Paste load from diskette 56 Paste buffer 15, 58 copy and append 25 copy to 24 Prerequisites ladder logic installation 88 Print a hard copy of the current file 55 sequence logic block listing function 105 sequence logic compilation listing function 105 R Remove all compounds, ECBs, and blocks from the configuration file 58 Rename currently selected block or ECB 51 Requirements
117

B0193AV Rev P

Index

CSA 11 Retrieve settable configuration compound, block, and ECB parameter values 31 settable parameter values from station 31 Return to previous screen 59 S Save action 59 all compound function entities to diskette 25 all the compounds in a control processor, volume, or paste buffer to a diskette 56 sequence logic source file to the library 97, 106 Scratchpad work volume 14 Selecting control processor 16 functions 3 menu item 3 Sequence block type edit 50 Sequence code access 111 installation 110 Sequence language statements list of 105 Sequence logic 50, 93 copy source file from library 97, 99 exit functions 96 files 94 functions 96 print compilation listing function 105 print listing of this block function 105 save source file to library 97 source file 94 view compilation listing 108 view include library contents 109 view source library contents 110 Sequence logic file archiving or debugging 108 Sequence logic source file save to library 106 Show various lists of items 25 Station load from diskette 56 modifying 11 retrieving settable parameter values from 31 Store settable parameter values 31 Syntax errors
118

Index

B0193AV Rev P

ladder logic diagram 87 T Template Dependent block 101 Exception block 101 Independent block 101 sequence file source block 101 Transfer AP hosting the selected volume 5 U Uninstalling ladder logic 88 User-labeled parameters 93 V View sequence logic file compilation listing 108 Volume load from diskette 56 Volume (Vol) key 15 W Workfiles storing settable parameter values into 31 Z Zones background color 39

119

B0193AV Rev P

Index

120

Index

B0193AV Rev P

121

B0193AV Rev P

Index

33 Commercial Street Foxboro, Massachusetts 02035-2099 United States of America www.foxboro.com Inside U.S.: 1-866-746-6477 Outside U.S.: 1-508-549-2424 or contact your local Foxboro representative. Facsimile: 1-508-549-4999 Printed in U.S.A. 1004