BASEstar Open DAS for Allen-Bradley with DEComni[TM] on_OpenVMS__________________________________________ Installation and User's Guide Order Number: AA-Q5FZC-TE July 1997 This manual describes how to install and use the BASEstar Open Device Access Software for Allen- Bradley Data Highway with the DEComni for OpenVMS interface. Revision/Update Information: This is a revised document. Operating System and Version: OpenVMS/Alpha Version 6.1 Operating System and Version: OpenVMS/VAX Version 6.1 Interface Software and Version:EComni Version 3.1 Software Version: Device Access Software for Allen-Bradley Data Highway, Version 3.1 Digital Equipment Corporation Maynard, Massachusetts ________________________________________________________________ July 1997 Possession, use, or copying of the software described in this publication is authorized only pursuant to a valid written license from Digital or an authorized sublicensor. Digital Equipment Corporation makes no representations that the use of its products in the manner described in this publication will not infringe on existing or future patent rights, nor do the descriptions contained in this publication imply the granting of licenses to make, use, or sell equipment or software in accordance with the description. © Digital Equipment Corporation 1994, 1997. All Rights Reserved. The following are trademarks of Digital Equipment Corporation: Alpha, BASEstar, DEComni, Digital, OpenVMS, TK, VAX, and the Digital logo. PLC, PLC-2, PLC-3 and PLC-5 are registered trademarks of Allen-Bradley Company Inc. SLC, SLC 500, SLC 5/10, SLC 5/02 SLC 5/03, SLC 5/04, Data Highway and Data Highway Plus are trademarks of Allen- Bradley Company, Inc. All other trademarks and registered trademarks are the property of their respective holders. This document is available on CDROM. This document was prepared using DEC DOCUMENT Version 3.0. _________________________________________________________________ Contents Preface................................................... vii 1 Overview 1.1 Description................................... 1-1 1.2 Device Communications......................... 1-1 1.3 Supported Functions and Devices............... 1-2 2 Installing and Configuring the DAS for Allen-Bradley Data Highway 2.1 Installation Requirements..................... 2-1 2.1.1 Hardware.................................. 2-1 2.1.2 Software.................................. 2-3 2.1.3 Disk Space................................ 2-4 2.2 Installing the DAS for Allen-Bradley Data Highway....................................... 2-4 2.2.1 Files Created During Installation......... 2-7 2.2.2 Installation Messages..................... 2-7 2.3 Postinstallation Tasks........................ 2-10 2.3.1 Editing the Configuration Files........... 2-10 2.3.1.1 Editing ODS Registrations............... 2-10 2.3.1.2 DAS for Allen-Bradley Data Highway Configuration Files..................... 2-14 2.3.2 Configuring Ports......................... 2-16 2.3.3 Configuring TELNET Access................. 2-17 2.3.4 Setting Up Plant-Floor Equipment.......... 2-18 2.4 Tracing device communications................. 2-18 2.5 Failures During Product Use................... 2-19 iii 3 Using the DAS for Allen-Bradley Data Highway 3.1 Accessing Allen-Bradley Functions............. 3-1 3.2 Supported Functions........................... 3-1 3.2.1 Connect, Conclude and Abort Functions..... 3-2 3.2.2 Read and Write Variable Functions......... 3-3 3.2.3 Write and Abort Indications............... 3-5 3.3 Addressing Syntax and Supported Data Types.... 3-7 3.3.1 PLC-2 Addressing Syntax and Supported Data Types..................................... 3-7 3.3.2 PLC-3 Addressing Syntax and Supported Data Types..................................... 3-8 3.3.2.1 PLC-3 Data Table Addressing............. 3-8 3.3.2.2 PLC-3 Extended Addressing............... 3-14 3.3.3 PLC-5 Addressing Syntax and Supported Data Types..................................... 3-15 3.3.4 PLC-5/250 Addressing Syntax and Supported Data Types................................ 3-27 3.3.5 SLC Addressing Syntax and Supported Data Types..................................... 3-43 A I/O Error Messages B DAS Error Messages Index Examples 2-1 ODS Registration.......................... 2-11 2-2 DAS for Allen-Bradley Data Highway ODS Configuration File........................ 2-14 Figures 1-1 DAS Communications........................ 1-2 2-1 Allen-Bradley 15 Pin Device Connector Layout.................................... 2-2 2-2 Allen-Bradley 25 Pin Device Connector Layout.................................... 2-2 iv 2-3 Allen-Bradley 9 Pin Device Connector Layout.................................... 2-2 3-1 General PLC-2 Address Format.............. 3-7 3-2 PLC-3 I/O Data Table Address Format....... 3-9 3-3 PLC-3 Timer and Counter Data Table Address Format.................................... 3-10 3-4 PLC-3 Timer Structure..................... 3-10 3-5 PLC-3 Counter Structure................... 3-10 3-6 PLC-3 ASCII, Binary, Decimal, Floating-Point, High-Order Integer, Integer and Status Data Table Address Format.................................... 3-12 3-7 PLC-3 Pointer Data Table Address Format... 3-13 3-8 PLC-3 Pointer Structure................... 3-13 3-9 PLC-3 Extended Address Format............. 3-14 3-10 PLC-5 I/O Data Table Address Format....... 3-15 3-11 PLC-5 Status Data Table Address Format.... 3-16 3-12 PLC-5 ASCII, Binary, Decimal, Floating-Point and Integer Data Table Address Format............................ 3-17 3-13 PLC-5 Timer, Counter, Control, SFC Status, Block-Transfer Control, Token Data, ASCII String, PID Control and Message Control Data Table Address Format................. 3-19 3-14 PLC-5 Timer Structure..................... 3-19 3-15 PLC-5 Counter Structure................... 3-19 3-16 PLC-5 Control Structure................... 3-20 3-17 PLC-5 SFC Status Structure................ 3-20 3-18 PLC-5 Block-Transfer Control Structure.... 3-20 3-19 PLC-5 Token Data Structure................ 3-20 3-20 PLC-5 ASCII String Structure.............. 3-21 3-21 PLC-5 PID Control Structure............... 3-21 3-22 PLC-5 Message Control Structure........... 3-21 3-23 PLC-5/250 Binary, Floating-Point, Long Integer and Integer Address Format........ 3-28 3-24 PLC-5/250 Timer, Counter, Control, ASCII String, PID Control and Message Control Address Format............................ 3-30 3-25 PLC-5/250 Timer Structure................. 3-30 v 3-26 PLC-5/250 Counter Structure............... 3-30 3-27 PLC-5/250 Control Structure............... 3-30 3-28 PLC-5/250 ASCII String Structure.......... 3-31 3-29 PLC-5/250 PID Control Structure........... 3-31 3-30 PLC-5/250 Message Control Structure....... 3-31 3-31 PLC-5/250 Status Address Format........... 3-35 3-32 PLC-5/250 I/O Address Format.............. 3-36 3-33 PLC-5/250 Block-Transfer Data Address Format.................................... 3-37 3-34 PLC-5/250 Block-Transfer Read/Write Control Address Format.................... 3-38 3-35 PLC-5/250 Block-Transfer Read/Write Control Structure......................... 3-39 3-36 PLC-5/250 Adapter Status Address Format... 3-40 3-37 PLC-5/250 Adapter Status Structure........ 3-40 3-38 PLC-5/250 Internal Storage Address Format.................................... 3-41 3-39 PLC-5/250 Shared Data Address Format...... 3-42 3-40 SLC I/O Data Table Address Format......... 3-43 3-41 SLC Status Data Table Address Format...... 3-44 3-42 SLC ASCII, Binary, Floating-Point and Integer Data Table Address Format......... 3-45 3-43 SLC Timer, Counter, Control and ASCII String Data Table Address Format.......... 3-47 3-44 SLC Timer Structure....................... 3-47 3-45 SLC Counter Structure..................... 3-47 3-46 SLC Control Structure..................... 3-48 3-47 SLC ASCII String Structure................ 3-48 Tables 2-1 Disk Space Requirements................... 2-4 2-2 Files Created for the DAS for Allen-Bradley Data Highway................ 2-7 2-3 REGISTER Attributes....................... 2-12 2-4 KE/KF/KF-2/KF-3 Switch Settings........... 2-18 3-1 Connect, Conclude and Abort Interface Access.................................... 3-2 3-2 Read and Write Variable Types............. 3-4 vi 3-3 Read and Write Variable Interface Access.................................... 3-4 3-4 Supported PLC Write Functions............. 3-6 3-5 Indication Interface Access............... 3-7 3-6 Example PLC-2 Data Types.................. 3-8 3-7 Example PLC-3 I/O Data Table Addresses.... 3-9 3-8 Example PLC-3 Timer and Counter Data Table Addresses................................. 3-11 3-9 Example PLC-3 ASCII, Binary, Decimal, Floating-Point, High-Order Integer, Integer and Status Data Table Address Format.................................... 3-12 3-10 Example PLC-3 Pointer Data Table Addresses................................. 3-13 3-11 Example PLC-3 Extended Addresses.......... 3-14 3-12 Example PLC-5 I/O Data Table Addresses.... 3-16 3-13 Example PLC-5 Status Data Table Addresses................................. 3-17 3-14 Example PLC-5 ASCII, Binary, Decimal, Floating-Point and Integer Data Table Address Format............................ 3-18 3-15 Example PLC-5 Timer, Counter, Control, SFC Status, Block-Transfer Control, Token Data, ASCII String, PID Control and Message Control Data Table Address Formats................................... 3-21 3-16 Example PLC-5/250 Binary, Floating-Point, Long Integer and Integer Address Format... 3-29 3-17 Example PLC-5/250 Timer, Counter, Control, ASCII String, PID Control and Message Control Address Formats................... 3-31 3-18 Example PLC-5/250 Status Addresses........ 3-36 3-19 Example PLC-5/250 I/O Addresses........... 3-37 3-20 Example PLC-5/250 Block-Transfer Data Addresses................................. 3-38 3-21 Example PLC-5/250 Block-Transfer Read/Write Control Addresses.............. 3-39 3-22 Example PLC-5/250 Adapter Status Addresses................................. 3-41 vii 3-23 Example PLC-5/250 Internal Storage Addresses................................. 3-42 3-24 Example PLC-5/250 Shared Data Addresses... 3-42 3-25 Example SLC I/O Data Table Addresses...... 3-44 3-26 Example SLC Status Data Table Addresses... 3-45 3-27 Example SLC ASCII, Binary, Floating-Point and Integer Data Table Address Format..... 3-46 3-28 Example SLC Timer, Counter, Control and ASCII String Data Table Address Formats... 3-48 viii _________________________________________________________________ Preface This document describes how to install and use the BASEstar Open DAS for Allen-Bradley Data Highway. Intended Audience This document is intended for system managers who must set up and maintain the following: o DEComni software o BASEstar Open DAS for Allen-Bradley Data Highway This document is also intended for application programmers who develop plant-floor management software layered on DEComni software. Readers of this document should have knowledge of: o OpenVMS operations and administration o OpenVMS application software o DEComni software o Site-specific installation requirements In addition, knowledge of the Allen-Bradley PLCs is required. Document Structure This document is organized as follows: o Chapter 1 provides an overview of the DAS for Allen- Bradley Data Highway. o Chapter 2 provides the information you need to install and configure the DAS for Allen-Bradley Data Highway. vii o Chapter 3 provides information about the supported functions for Allen-Bradley PLCs, and how to access the functions. Associated Documents For information on installing and configuring a DEComni system, refer to the following documents: o DEComni for OpenVMS Installation Guide o DEComni for OpenVMS Guide to Using Omni Directory Services o DEComni for OpenVMS Guide to Using OmniView For more information on developing software to integrate manufacturing applications and equipment, refer to the following documents: o DEComni for OpenVMS Application Programmer's Interface For information on Allen-Bradley PLC communications and addressing, refer to the following documents: o Allen-Bradley Data Highway/Data Highway Plus/DH-485 Communication Protocol and Command Set o Allen-Bradley PLC-2 Family of Programmable Controllers Addressing Reference o Allen-Bradley PLC-3 Family of Programmable Controllers Addressing Reference o SLC 500 Family of Programmable Controllers Addressing Reference o Allen-Bradley 1785 PLC-5 Programmable Controllers Addressing Reference o Allen-Bradley Pyramid Integrator System Addressing Reference viii Conventions This document uses the following conventions: Boldface Highlights user input within textual descriptions. Press the key labeled Return. Unless otherwise specified, press after entering a command or responding to a prompt. Enter Type the words or symbols described and press . ix 1 _________________________________________________________________ Overview This chapter provides an overview of the BASEstar Open DAS for Allen-Bradley Data Highway. It also briefly describes Allen-Bradley PLC communications, and the supported functions for the DAS for Allen-Bradley Data Highway. 1.1 Description The DAS for Allen-Bradley Data Highway allows you to access Allen-Bradley PLCs using DEComni Services. DEComni Services provides the Applications Programming Interface (API) used to communicate with shop floor devices. DEComni uses the Manufacturing Messaging Specification (MMS) (ISO-9506) model to communicate with shop floor devices. DEComni also has the capability to support non-MMS devices such as Allen-Bradley PLCs through protocol specific Device Access Software, such as the DAS for Allen-Bradley Data Highway. Using the DAS for Allen-Bradley Data Highway, applications can perform a variety of device access functions for the Allen-Bradley PLCs. 1.2 Device Communications The DAS for Allen-Bradley Data Highway consists of software that provides device-specific communications for users of the DEComni API. The DAS software communicates the requests and data directly with an OpenVMS device driver to send data to and receive data from plant-floor devices. Figure 1-1 shows how the DAS for Allen-Bradley Data Highway facilitates communications between DEComni applications and the device. Overview 1-1 Overview 1.2 Device Communications Figure 1-1 DAS Communications 1.3 Supported Functions and Devices You can perform only device access funtions that are supported by the DAS. The DAS for Allen-Bradley Data Highway supports the following DEComni Services functions for Allen-Bradley PLCs: o Initiate a connection to a device (omni_connect) o Conclude a connection with a device (omni_conclude) o Abort a connection with a device (omni_abort) o Get a value from a device's memory (omni_get_value) o Put a value to a device's memory (omni_put_value) o Receive a write indication from a device (omni_get_ indications) o Receive an abort from a device (omni_get_indications) The DAS for Allen-Bradley Data Highway supports the following Allen-Bradley PLCs: o Allen-Bradley PLC-2, PLC-2/5, PLC-2/15, PLC-2/16, PLC-2 /17, PLC-2/20, PLC-2/30 o Allen-Bradley PLC-3 Family o Allen-Bradley PLC-5/10, PLC-5/11, PLC-5/12, PLC-5/15, PLC-5/20, PLC-5/25, PLC-5/30, PLC-5/40, PLC-5/40L, PLC-5 /60, PLC-5/60L, PLC-5/80, PLC-5/250 o Allen-Bradley SLC 500, SLC 5/01, SLC 5/02, SLC 5/03, SLC 5/04 For more information about the supported functions for these PLCs, refer to Chapter 3 of this document. 1-2 Overview 2 _________________________________________________________________ Installing and Configuring the DAS for Allen-Bradley Data Highway This chapter provides the information you need to install the DAS for Allen-Bradley Data Highway and to configure your system. 2.1 Installation Requirements Review the following hardware and software requirements to ensure that your system is prepared for the DAS for Allen-Bradley Data Highway installation. ________________________ Note ________________________ Back up the disks on your system before installing this software. This will provide a method to restore your system in the event of an installation problem. The procedure for backing up disks is described in the OpenVMS System Management Utilities Reference Manual. ______________________________________________________ 2.1.1 Hardware The hardware requirements for the DAS for Allen-Bradley Data Highway are the same as those for the DEComni software. For specific hardware requirements, refer to the DEComni for OpenVMS Installation Guide. Additional hardware required for configuring the DAS for Allen-Bradley Data Highway includes: o Any supported Allen-Bradley PLC o Allen-Bradley KE, KF, KF2 or KF3 communications card o A cable from the OpenVMS system to the communications card Installing and Configuring the DAS for Allen-Bradley Data Highway 2-1 Installing and Configuring the DAS for Allen-Bradley Data Highway 2.1 Installation Requirements The cable used to connect to the communications card depends on the communication option being used. The following figures describe the pinouts for 15 pin (KE card), 25 pin (KF communications) and 9 pin (SLC DF1 communications) connectors. The cable to the KE communications card must be terminated with a 15 pin male connector as shown in Figure 2-1. Figure 2-1 Allen-Bradley 15 Pin Device Connector Layout The cable to the KF communications card must be terminated with a 25 pin male RS232-C connector as shown in Figure 2-2. Figure 2-2 Allen-Bradley 25 Pin Device Connector Layout The cable to the SLC 5/03 or SLC 5/04 DF1 port must be terminated with a 9 pin male RS232 connector as shown in Figure 2-3. Figure 2-3 Allen-Bradley 9 Pin Device Connector Layout 2-2 Installing and Configuring the DAS for Allen-Bradley Data Highway Installing and Configuring the DAS for Allen-Bradley Data Highway 2.1 Installation Requirements 2.1.2 Software The following software must be installed prior to installing DAS for Allen-Bradley Data Highway: o OpenVMS/Alpha Version 6.1 o OpenVMS/VAX Version 6.1 o DEComni Version 3.1 For more information on installing DEComni software, refer to the DEComni for OpenVMS Installation Guide. ________________________ Note ________________________ Before using this product on a system, you must first register a License Product Authorization Key (License PAK) using the License Management Facility (LMF). For more information about the License Management Utility, refer to the License Management Utility Manual for OpenVMS. ______________________________________________________ Installing and Configuring the DAS for Allen-Bradley Data Highway 2-3 Installing and Configuring the DAS for Allen-Bradley Data Highway 2.1 Installation Requirements 2.1.3 Disk Space Table 2-1 lists the disk space required to install the DAS for Allen-Bradley Data Highway. The space requirements are approximations; actual sizes may vary depending on your system environment and configuration. Table_2-1_Disk_Space_Requirements__________________________ Approximate Space Requirements Usage_____________________(Blocks)_________________________ Peak (during 1250 (Alpha) installation) 3000 (VAX) Net (after installation) 600 (Alpha) __________________________1500_(VAX)_______________________ 2.2 Installing the DAS for Allen-Bradley Data Highway When your system meets all hardware and software requirements, you can install the DAS for Allen-Bradley Data Highway. The installation takes from 1 to 5 minutes, depending on your system load and configuration. Install the DAS for Allen-Bradley Data Highway by using the following steps: 1. Log in to a privileged system manager's account. 2. Set the default directory to SYS$UPDATE: $ SET DEFAULT SYS$UPDATE 3. Invoke VMSINSTAL: $ @SYS$UPDATE:VMSINSTAL ABDVA031 ddcu: where: o ABDVA argument is the kit name o VV in the name means this is an OpenVMS/VAX kit o VA in the name means this is an OpenVMS/Alpha kit o 031 portion of the name is the version number 2-4 Installing and Configuring the DAS for Allen-Bradley Data Highway Installing and Configuring the DAS for Allen-Bradley Data Highway 2.2 Installing the DAS for Allen-Bradley Data Highway o ddcu argument represents the name of the device on which the installation media is mounted, where: - dd is the device code - c is the controller designation - u is the unit number VMSINSTAL prompts you for information during the installation. Note that DECnet software does not need to be running to perform the installation procedure. The following is an example of the output from the installation on OpenVMS/Alpha: Beginning installation of ABDVA V3.1 at 12:36 %VMSINSTAL-I-RESTORE, Restoring product save set A ... %VMSINSTAL-I-RELMOVED, Product's release notes have been moved to SYS$HELP. Copyright (C) Digital Equipment Corporation 1994, 1997. All rights reserved. Restricted Rights: Use, duplication, or disclosure by the U.S. Government is subject to restrictions as set forth in subparagraph (c)(1)(ii) of DFARS 252.227-7013, or in FAR 52.227-19, or in FAR 52.227-14 Alt. III, as applicable. This software is proprietary to and embodies the confidential technology of Digital Equipment Corporation. Possession, usr, or copying of this software and media is authorized only pusuant to a valid written license from Digital or an authorized sublicensor. BASEstar Open DAS for Allen-Bradley PLCs installation procedure. Checking for a valid license... Product: ABDAS-V Producer: DEC Version: 1.0 Release Date: 01-JUN-1994 * Does this product have an authorization key registered and loaded? y Now checking OpenVMS version... Now checking that DEComni is installed... Now checking DEComni version... Installing and Configuring the DAS for Allen-Bradley Data Highway 2-5 Installing and Configuring the DAS for Allen-Bradley Data Highway 2.2 Installing the DAS for Allen-Bradley Data Highway Now checking DEComni logicals... Now checking the DEComni integrator registration utility... * Do you want BASEstar Open support [YES]? ? BASEstar Open is installed on this node. If BASEstar Open support is selected, error messages are logged to the BASEstar Open log file rather than syserr and configuration template files for use with BASEstar Open are provided. * Do you want BASEstar Open support [YES]? N Now checking disk space... * Do you want to purge files replaced by this installation [YES]? * Do you want to run the IVP after the installation [YES]? ---------------------------------NOTE------------------------------------ During installation the file ODS_AB_CONFIG.TEMPLATE is copied to the ODS:[SCRIPTS] directory. Copy and edit this file to create site specific /PATH and /LINE directory definitions for devices at your installation. Now modifying the ODS schema to add Allen-Bradley specific object classes and attributes... Checking ODS Attribute Type Schema definitions ... Checking ODS Object Class Schema definitions ... Querying ODS Schema definitions ... Valid Schema definitions found in the attribute schema database as: OC ALIASED_NAME CN C L S O OU P_ADDR APC OWNER APT AEQ MAPV SY OBJ_ID BER PSAP S SAP TSAP N_ADDR AS_LIST DESCR VMD DOM DEL VN APPSN APROF VERSION NLEVEL MAX_CALL ED MAX_CALLING MAX_SEG CBB_LIST SS_LIST VENDOR MODEL REV INUM DN SHARE CONT_FILE CAP_FILE PN REUSE ARG MON DOM_LIST VAR ATYPE ADDR_T ADDR_V PATH LINE STATION LI NE_NAME PORT ENQ_RETRIES NAK_RETRIES TIMEOUT SPEED PARITY MODEM TRACE KE_STATION KE_TIMEOUT Valid Schema definitions found in the object class schema database as: TOP ALIAS C L O OU AP AE DSA DEVICE TAE OAE AS VMD DOMAIN PI NVAR UNVAR DH_LINE DH_PATH Normal Completion. Now registering BASEstar Open DAS for Allen-Bradley PLCs with DEComni... 2-6 Installing and Configuring the DAS for Allen-Bradley Data Highway Installing and Configuring the DAS for Allen-Bradley Data Highway 2.2 Installing the DAS for Allen-Bradley Data Highway %VMSINSTAL-I-MOVEFILES, Files will now be moved to their target directories... Now registering BASEstar Open DAS for Allen-Bradley PLCs with DEComni... Copyright (C) Digital Equipment Corporation 1994, 1997. All rights reserved. Executing the Installation Verification Procedure. BASEstar Open DAS for Allen-Bradley PLCs installation procedure has succeeded. Installation of ABDVA V3.1 completed at 14:33 Adding history entry in VMI$ROOT:[SYSUPD]VMSINSTAL.HISTORY Creating installation data file: VMI$ROOT:[SYSUPD]ABDVA031.VMI_DATA VMSINSTAL procedure done at 14:34 2.2.1 Files Created During Installation Table 2-2 lists the files created by the DAS for Allen- Bradley Data Highway installation procedure, and the directories in which those files are placed. Table 2-2 Files Created for the DAS for Allen-Bradley Data __________Highway__________________________________________ Directory________Filename__________________________________ ODS:[SCRIPTS]____ODS_AB_CONFIG.TEMPLATE____________________ 2.2.2 Installation Messages You may see VMSINSTAL messages during the installation procedure. The following messages are specific to the DAS for Allen-Bradley Data Highway installation: BADOMNI, The version of DEComni required is DEComni V3.1 or later., Explanation: Error. This version of the DAS is designed to work with DEComni V3.1 or later. User Action: Install DEComni V3.1 or later and then reinstall the DAS. Installing and Configuring the DAS for Allen-Bradley Data Highway 2-7 Installing and Configuring the DAS for Allen-Bradley Data Highway 2.2 Installing the DAS for Allen-Bradley Data Highway BADVMS (Alpha), BASEstar Open DAS for Allen-Bradley Data Highway must be installed under OpenVMS V6.1., Explanation: Error. The DAS is being installed on a version of OpenVMS that is less than OpenVMS V6.1. User Action: Upgrade OpenVMS to the required minimum version and then install the DAS. BADVMS (VAX), BASEstar Open DAS for Allen-Bradley Data Highway must be installed under OpenVMS V6.1., Explanation: Error. The DAS is being installed on a version of OpenVMS that is less than OpenVMS V6.1. User Action: Upgrade OpenVMS to the required minimum version and then install the DAS. NETBLOCKS (VAX), BASEstar Open DAS for Allen-Bradley Data Highway requires 1500 blocks after installation., Explanation: Error. There isn't enough space on the system disk to install the DAS. User Action: Delete unneeded files and reattempt the installation. NETBLOCKS (ALPHA), BASEstar Open DAS for Allen-Bradley Data Highway requires 600 blocks after installation., Explanation: Error. There isn't enough space on the system disk to install the DAS. User Action: Delete unneeded files and reattempt the installation. NOLICENSE, No license found for this product - IVP will not be run., Explanation: Informational. A valid license was not found. The installation will continue, but the IVP will not be run. User Action: Register and load a valid license for this product before attempting to use the DAS. 2-8 Installing and Configuring the DAS for Allen-Bradley Data Highway Installing and Configuring the DAS for Allen-Bradley Data Highway 2.2 Installing the DAS for Allen-Bradley Data Highway NOLOAD, License for this product not loaded - IVP will not be run., Explanation: Informational. The license for this product has not been loaded by the License Management Utility. The installation willl proceed, but the IVP will not be run. User Action: Load the license using the License Management Utility before attempting to use the DAS. NOOMNI, DEComni must be installed before BASEstar Open DAS for Allen-Bradley Data Highway., Explanation: Error. The installation procedure could not verify that DEComni was installed on the system. DEComni installation is a prerequisite to the installation of this DAS. User Action: Install DEComni V3.1 and then reinstall the DAS. NOINTREG, Unable to find the integrator registration utility., Explanation: Error. DEComni provides a registration utility for DASes to use to register their presence with DEComni. This registration utility could not be found. User Action: Reinstall DEComni to provide the required registration utility. NOODS, Unable to find the directory for DEComni Directory Services., Explanation: Error. The installation procedure creates classes and attributes in the Omni Directory Services database and this database could not be found. User Action: Reinstall DEComni to set up the Omni Directory Services directory. NOSCRIPT, Unable to find ODS:[SCRIPTS] directory., Explanation: Error. The directory to place the ODS configuration template for Allen-Bradley devices was not found. User Action: Reinstall DEComni to set up the Omni Directory Services directory. Installing and Configuring the DAS for Allen-Bradley Data Highway 2-9 Installing and Configuring the DAS for Allen-Bradley Data Highway 2.2 Installing the DAS for Allen-Bradley Data Highway ODSINI, Omni logicals have not been defined, attempting to define logicals., Explanation: Information. The DAS installation requires that certain DEComni logicals be defined and these logical names were not found. The installation procedure attempts to define the logical names by executing SYS$STARTUP:OMNI_ LOGICALS.COM. User Action: None. 2.3 Postinstallation Tasks Before using the DAS for Allen-Bradley Data Highway you must perform the following postinstallation tasks: o Edit the configuration files o Configure ports o Set up plant-floor equipment 2.3.1 Editing the Configuration Files The configuration file, ODS_AB_CONFIG.TEMPLATE is supplied with the DAS for Allen-Bradley Data Highway. The ODS configuration file contains Omni Directory Services (ODS) registration commands for Allen-Bradley specific classes and attributes. Copy the template file and edit it to include site-specific directory definitions. When you complete your edits, execute the file to create the ODS definitions. The following section provides examples of ODS definitions from the configuration file, and indicates which attributes can be modified. For more information about registering ODS definitions, refer to the DEComni for OpenVMS Guide to Using Omni Directory Services. 2.3.1.1 Editing ODS Registrations ODS registrations allow the DAS software to locate a particular PLC on an Allen-Bradley data highway network. Example 2-1 shows the configuration file commands that create the ODS registrations. 2-10 Installing and Configuring the DAS for Allen-Bradley Data Highway Installing and Configuring the DAS for Allen-Bradley Data Highway 2.3 Postinstallation Tasks Example 2-1 ODS Registration REGISTER DIRECTORY NAME "/LINE=DATA_HIGHWAY" ATTRIBUTES "OC=DH_LINE /PORT=LTA201:/ENQ_RETRIES=10/NAK_RETRIES=3/KE_TIMEOUT=128/SPEED=9600 /PARITY=none/MODEM=0/TRACE=0/KE_STATION=12/TIMEOUT=3" REGISTER DIRECTORY NAME "/LINE=DATA_HIGHWAY_PLUS" ATTRIBUTES "OC=DH_LINE /PORT=LTA202:/ENQ_RETRIES=10/NAK_RETRIES=3/KE_TIMEOUT=128/SPEED=9600 /PARITY=none/MODEM=0/TRACE=0/KE_STATION=13/TIMEOUT=3" REGISTER DIRECTORY NAME "/LINE=DH485" ATTRIBUTES "OC=DH_LINE /PORT=LTA203:/ENQ_RETRIES=10/NAK_RETRIES=3/SPEED=9600 /PARITY=none/MODEM=0/TIMEOUT=3" REGISTER DIRECTORY NAME "/PATH=PLC_2_15_PATH" ATTRIBUTES "OC=DH_PATH /LINE_NAME=(/LINE=DATA_HIGHWAY)/STATION=20/TRACE=0" REGISTER DIRECTORY NAME "/PATH=PLC_2_30_PATH" ATTRIBUTES "OC=DH_PATH /LINE_NAME=(/LINE=DATA_HIGHWAY)/STATION=21/TRACE=0" REGISTER DIRECTORY NAME "/PATH=PLC_3_PATH" ATTRIBUTES "OC=DH_PATH /LINE_NAME=(/LINE=DATA_HIGHWAY)/STATION=22/TRACE=0" REGISTER DIRECTORY NAME "/PATH=PLC_5_40_PATH" ATTRIBUTES "OC=DH_PATH /LINE_NAME=(/LINE=DATA_HIGHWAY_PLUS)/STATION=20/TRACE=0" REGISTER DIRECTORY NAME "/PATH=PLC_5_250_PATH" ATTRIBUTES "OC=DH_PATH /LINE_NAME=(/LINE=DATA_HIGHWAY_PLUS)/STATION=21/TRACE=0" REGISTER DIRECTORY NAME "/PATH=SLC_5_04" ATTRIBUTES "OC=DH_PATH /LINE_NAME=(/LINE=DH485)/STATION=1" You can modify the command for your site configuration. Table 2-3 lists ODS attributes, the class they belong to and valid values for the attributes. Attribute values are not checked until a connection is initiated with the VMD. Installing and Configuring the DAS for Allen-Bradley Data Highway 2-11 Installing and Configuring the DAS for Allen-Bradley Data Highway 2.3 Postinstallation Tasks Table_2-3_REGISTER_Attributes______________________________ Class_______Attribute________Value(s)______________________ DH_LINE PORT TT01:, LTA201:, etc.[1] SPEED 110 - 19200 PARITY NONE, EVEN MODEM TRUE, ON, YES, 1 or FALSE, OFF, NO, 0 TIMEOUT 2-6[2] KE_STATION[3] 0-377[4] KE_TIMEOUT 0-255[6] ENQ_RETRIES[7] 0-20 NAK_RETRIES[8] 0-20 TRACE[9] TRUE, ON, YES, 1 or FALSE, OFF, NO, 0 DH_TELNET IP_ADDRESS xx.xx.xx.xx[11] PORT_NUMBER[12] TIMEOUT 2-6[2] KE_STATION[3] 0-377[4] KE_TIMEOUT 0-255[6] ENQ_RETRIES[7] 0-20 NAK_RETRIES[8] 0-20 TRACE[9] TRUE, ON, YES, 1 or FALSE, OFF, NO, 0 DH_PATH LINE_NAME /LINE=xxx[10] STATION 0-377[4], 1-31[5] TRACE[9] TRUE, ON, YES, 1 or FALSE, OFF, NO, 0 [1]LTAXXX:_is_used_for_LAT_connections._TTXX:_is_used_for__ direct connection. [2]Seconds. [3]If a KE Station address is specified, then the DAS will configure the KE/KF/KF-2 for the ENQ retries, NAK retries and KE timeout values specified. If a KE Station Address of 0 is specified, then the DAS does not configure the KE/KF /KF-2 and the KE timeout value is ignored. Do NOT configure the KE station address if connecting to a DH-485 network. [4]Octal for PLC-2, PLC-3 or PLC-5 controllers. [5]Decimal for SLC controllers. If a SLC controller is connected directly to a data highway plus network, the 2-12 InstallingsandiConfiguringdthe DASifor,Allen-Bradley Data Highway [6]The KE timeout value is specified in cycles. Consult the KE/KF/KF-2 documentation to determine how long the time is in seconds. [7]The ENQ retries is the number of times a request for a response is sent to the PLC before an error is returned to the user. [8]The NAK retries is the number of times a retransmission is attempted when a recoverable error is detected in the message received by the PLC. [9]Trace is used to allow troubleshooting of the PLC communications. See Section 2.4 for details. [10]Specify a name registered earlier with ODS that specifies the line that the PLC with this station address will be using. [11]The TCP/IP address must be in xx.xx.xx.xx notation where xx is a number from 0-255. [12]Put a valid port number for a socket connection to the TELNET server. Installing and Configuring the DAS for Allen-Bradley Data Highway 2.3 Postinstallation Tasks ___________________________________________________________ Installing and Configuring the DAS for Allen-Bradley Data Highway 2-13 Installing and Configuring the DAS for Allen-Bradley Data Highway 2.3 Postinstallation Tasks 2.3.1.2 DAS for Allen-Bradley Data Highway Configuration Files Example 2-2 is a sample of the ODS configuration file for the DAS for Allen-Bradley Data Highway. Example 2-2 DAS for Allen-Bradley Data Highway ODS Configuration File $! $! Copyright (c) Digital Equipment Corporation, 1994, 1997. $! All Rights Reserved. Unpublished rights reserved $! under the copyright laws of the United States. $! $! The software contained on this media is proprietary $! to and embodies the confidential technology of $! Digital Equipment Corporation. Possession, use, $! duplication or dissemination of the software and $! media is authorized only pursuant to a valid written $! license from Digital Equipment Corporation. $! $! RESTRICTED RIGHTS LEGEND Use, duplication, or $! disclosure by the U.S. Government is subject to $! restrictions as set forth in Subparagraph (c)(1)(ii) $! of DFARS 252.227-7013, or in FAR 52.227-19, as $! applicable. $! $!********************************************************************! $! ! $! This is a template for the Allen-Bradley-specific ! $! ODS configuration command file. Rename and edit this command ! $! procedure template to reflect your site-specific ! $! configuration. You must manually execute this command ! $! procedure to configure ODS to provide line configuration ! $! information for your devices. ! $! ! $! Add comments to the site-specific changes here. ! $! ! $!********************************************************************! $! $ODSCL := $ODS:[EXEC]ODSCL $! $! Register the ODS definitions. (continued on next page) 2-14 Installing and Configuring the DAS for Allen-Bradley Data Highway Installing and Configuring the DAS for Allen-Bradley Data Highway 2.3 Postinstallation Tasks Example 2-2 (Cont.) DAS for Allen-Bradley Data Highway ODS Configuration File $! $ODSCL REGISTER DIRECTORY NAME "/LINE=DATA_HIGHWAY" ATTRIBUTES "OC=DH_LINE /PORT=LTA201:/ENQ_RETRIES=10/NAK_RETRIES=3/KE_TIMEOUT=128/SPEED=9600 /PARITY=none/MODEM=0/KE_STATION=12/TIMEOUT=3" REGISTER DIRECTORY NAME "/LINE=DATA_HIGHWAY_PLUS" ATTRIBUTES "OC=DH_LINE /PORT=LTA202:/ENQ_RETRIES=3/NAK_RETRIES=3/KE_TIMEOUT=128/SPEED=9600 /PARITY=none/MODEM=0/KE_STATION=10/TIMEOUT=3" REGISTER DIRECTORY NAME "/LINE=DH485" ATTRIBUTES "OC=DH_LINE /PORT=LTA203:/ENQ_RETRIES=10/NAK_RETRIES=3/SPEED=9600 /PARITY=none/MODEM=0/TIMEOUT=3" REGISTER DIRECTORY NAME "/PATH=PLC_2_15" ATTRIBUTES "OC=DH_PATH /LINE_NAME=(/LINE=DATA_HIGHWAY)/STATION=20" REGISTER DIRECTORY NAME "/PATH=PLC_2_30" ATTRIBUTES "OC=DH_PATH /LINE_NAME=(/LINE=DATA_HIGHWAY)/STATION=21" REGISTER DIRECTORY NAME "/PATH=PLC_3" ATTRIBUTES "OC=DH_PATH /LINE_NAME=(/LINE=DATA_HIGHWAY)/STATION=22" REGISTER DIRECTORY NAME "/PATH=PLC_5_40" ATTRIBUTES "OC=DH_PATH /LINE_NAME=(/LINE=DATA_HIGHWAY_PLUS)/STATION=20" REGISTER DIRECTORY NAME "/PATH=PLC_5_250" ATTRIBUTES "OC=DH_PATH /LINE_NAME=(/LINE=DATA_HIGHWAY_PLUS)/STATION=21" REGISTER DIRECTORY NAME "/PATH=SLC_5_04" ATTRIBUTES "OC=DH_PATH /LINE_NAME=(/LINE=DH485)/STATION=1" EXIT To execute the ODS command file, enter the following command at the user prompt: @ODS:[SCRIPTS]ODS_AB_CONFIG.TEMPLATE For more information about maintaining ODS definitions, refer to the DEComni for OpenVMS Guide to Using Omni Directory Services. Installing and Configuring the DAS for Allen-Bradley Data Highway 2-15 Installing and Configuring the DAS for Allen-Bradley Data Highway 2.3 Postinstallation Tasks 2.3.2 Configuring Ports You can connect a PLC to a Local Area Transport (LAT) port. To use a LAT port with the DAS, you must define the LAT port on the OpenVMS system using the LAT control program. For example, to define port_2 on the LAT node srvr4 as LTA992, enter the following: $ MCR LATCP LCP> CREATE PORT LTA992 LCP> SET PORT LTA992 /NODE=srvr4/PORT=port_2/NOQUEUE Use the LAT port name defined above when defining the port to ODS. You must also set the following SYSGEN parameters to access Allen-Bradley PLCs to reduce the potential for data overruns. Use the SYSGEN utility to display the current values and AUTOGEN to reset the values accordingly. For information on using SYSGEN and AUTOGEN, refer to the OpenVMS System Management Utilities Reference Manual for details. ___________________________________________________________ Parameter________Value_____________________________________ TTY_ALTALARM 0 TTY_ALTYPAHD_____1024______________________________________ To enable use of the alternate typeahead buffer, type the following command from DCL: $ SET TERM LTA992:/ALTYPEAHD/PERMANENT For the DAS for Allen-Bradley Data Highway to send and receive data correctly, you must set and define LAT port characteristics to match the line parameters defined in ODS for the corresponding port. The following example shows the characteristics set at the LAT prompt: 2-16 Installing and Configuring the DAS for Allen-Bradley Data Highway Installing and Configuring the DAS for Allen-Bradley Data Highway 2.3 Postinstallation Tasks Local> DEF PORT n SPEED 9600 Local> DEF PORT n AUTOBAUD DISABLED Local> DEF PORT n AUTOCONNECT DISABLED Local> DEF PORT n FLOW DISABLED Local> DEF PORT n PREFERRED NONE Local> DEF PORT n ACCESS REMOTE Local> DEF PORT n CHAR 8 Local> DEF PORT n PARITY EVEN 2.3.3 Configuring TELNET Access You can connect a PLC to a terminal server using the TELNET protocol. Using the TELNET protocol allows the use of non- proprietary protocols to access terminal servers to perform device communications. The terminal server being used must support the BINARY transfer option (RFC 856). The DAS negotiates binary transfer as part of establishing a connection with the port. If the terminal server will not allow binary transfer, the negotiation fails and a connection is not established. NOTE: Using TELNET communications is slower than either LAT or a directly connected device. Ensure that your throughput requirements will be satisfied before deciding to implement TELNET communications. For the DAS for Allen-Bradley Data Highway to send and receive data correctly using TELNET, you must set up a port on the terminal server to receive a connect from the DAS. The following example shows setting up a port using a DECserver 700. Local> DEF TELNET LISTENER y PORT n Local> DEF TELNET LISTENER y CONNECTIONS ENABLED The following example shows setting up the server for TELNET access. A gateway needs to be configured only if the terminal server is on a different subnet than the host. In general, the terminal server should be on the same subnet as the host in order to reduce communications delays. Local> DEF INTERNET ADDRESS xx.xx.xx.xx Local> DEF INTERNET MASK xx.xx.xx.xx Local> DEF INTERNET GATEWAY xx.xx.xx.xx Installing and Configuring the DAS for Allen-Bradley Data Highway 2-17 Installing and Configuring the DAS for Allen-Bradley Data Highway 2.3 Postinstallation Tasks 2.3.4 Setting Up Plant-Floor Equipment To set up your plant-floor equipment, refer to the Allen- Bradley documentation for your specific PLC. Table 2-4 provides switch settings to use in setting up your KE/KF/KF-2 communications card. Table_2-4_KE/KF/KF-2/KF-3_Switch_Settings__________________ Parameter_____________Supported___Values___________________ Half Duplex No Full Duplex Yes Embedded Response No BCC Error Check Yes CRC Error Check No RS-232C Handshaking Yes[1] Station Number Yes 1-377 (octal)[2], 1-31 (decimal)[3] Computer Comm Rate Yes 110 - 19200[4] [1]If_using_the_handshaking_signals_(RTS,_CTS,_DSR,_DTR,___ DCD) be sure that the computer is also using those signals and that the cable has been wired properly. [2]PLC-2, PLC-3, & PLC-5 controllers [3]SLC controllers [4]The 1771-KE,KF Series A Revision A-G support a maximum of 9600 baud. The 1771-KE,KF Series A Revision H and later, the 1770-KF2 Series B Revision F and later and the 1785-KE support a maximum of 19200 baud. ___________________________________________________________ 2.4 Tracing device communications The DAS for Allen-Bradley Data Highway has built into it the capability to trace PLC communications and to send this output to either a file or to a user terminal. The purpose of this tracing is to allow the troubleshooting of PLC communications. 2-18 Installing and Configuring the DAS for Allen-Bradley Data Highway Installing and Configuring the DAS for Allen-Bradley Data Highway 2.4 Tracing device communications Tracing can be enabled for a device and/or a line. If tracing is enabled for a PLC, then only communications from/to that PLC are traced. If tracing is enabled for a line, then all communications from/to that line are traced. If both PLC and line tracing is enabled, then the trace will contain the output for both the PLC and the line, so the trace output will be duplicated. To enable tracing do the following: o Set the TRACE attribute in the ODS definition for the path or line being traced. o Set the DAS_TRACE_OUTPUT logical name to the name of the file that you want to contain the trace output. The logical name must be defined in a scope that will be seen by the server the DAS is a part of. DEFINE DAS_TRACE_OUTPUT MY_DISK:[MY_DIRECTORY]TRACE_OUTPUT.LOG o Reinitiate communications to the PLC/line. The ODS definition is read when a connection to the device is initiated (device tracing) or when a connection to the line is initiated (line tracing), so communications must be reinitiated in order for tracing to occur. The trace output is flushed to the file after every 10 lines that are traced, so trace output may lag actual device I/O. All trace output is in hexadecimal and shows both input to and output from the PLC. To turn tracing off, reverse the steps used to turn tracing on. 2.5 Failures During Product Use If an error occurs while this product is in use and you believe the error is caused by a problem with the product, take one of the following actions: o If you have a Software Product Services Support Agreement, contact your Customer Support Center (CSC) by telephone or by using the electronic means provided with your support agreement (such as DSNlink). The CSC provides telephone support for high-level advisory and Installing and Configuring the DAS for Allen-Bradley Data Highway 2-19 Installing and Configuring the DAS for Allen-Bradley Data Highway 2.5 Failures During Product Use remedial assistance. When you initially contact the CSC, indicate the following: - The name and version number of the operating system you are using - The version number of the product you are using - The version number of DEComni you are using - The hardware system you are using (such as a model number) - The Allen-Bradley PLCs you are communicating with - A brief description of the problem (one sentence if possible) - How critical the problem is o If you have a Self-Maintenance Software Agreement, you can submit a Software Performance Report (SPR). o If you do not have any type of software services support agreement and you purchased this product within the past year, you can submit an SPR if you think the problem is caused by a software error. When you submit an SPR, take the following steps: 1. Describe as accurately as possible the circumstances and state of the system when the problem occurred. Include the description and version number of the product being used. Demonstrate the problem with specific examples. 2. Reduce the problem to as small a size as possible. 3. Remember to include listings of any command files, INCLUDE files, or relevant data files, and so forth. 4. Report only one problem per SPR. This will facilitate a faster response. 5. Mail the SPR package to Digital. 2-20 Installing and Configuring the DAS for Allen-Bradley Data Highway 3 _________________________________________________________________ Using the DAS for Allen-Bradley Data Highway This chapter provides information about the supported functions for Allen-Bradley PLCs, and how to access these functions. 3.1 Accessing Allen-Bradley Functions Application Programming Interface (API) For information on accessing DEComni Callable Services, refer to the DEComni for OpenVMS Application Programmer's Interface. 3.2 Supported Functions A variety of functions are supported by the DAS for Allen- Bradley Data Highway. These functions may be supported as either client or server or both. If a function is supported as a server, then the application will receive an indication when the VMD is requesting the service. Using the DAS for Allen-Bradley Data Highway 3-1 Using the DAS for Allen-Bradley Data Highway 3.2 Supported Functions The DAS for Allen-Bradley Data Highway supports the following client functions for all supported devices: o Connect o Read Variable o Write Variable o Abort o Conclude The DAS for Allen-Bradley Data Highway supports the following server functions (indications) for all supported devices: o Write indication o Abort ________________________ Note ________________________ Information Report is still supported for backward compatability but support will be dropped in a future release of the DAS. Support for SLC controllers does not include information report as an option. Configurations should be modified to use write indication support as soon as possible. ______________________________________________________ 3.2.1 Connect, Conclude and Abort Functions Table 3-1 lists the connect, conclude and abort functions available through the DEComni (API) interface. Table_3-1_Connect,_Conclude_and_Abort_Interface_Access_____ Interface___Function_Name__________________________________ API omni_connect omni_connect_a omni_conclude omni_conclude_a omni_abort ____________omni_abort_a___________________________________ 3-2 Using the DAS for Allen-Bradley Data Highway Using the DAS for Allen-Bradley Data Highway 3.2 Supported Functions 3.2.2 Read and Write Variable Functions Use the read variable and write variable functions to read data from and write data to a specific address in PLC memory. Using the DAS for Allen-Bradley Data Highway 3-3 Using the DAS for Allen-Bradley Data Highway 3.2 Supported Functions Table 3-2 lists the variable types supported by this DAS. Table_3-2_Read_and_Write_Variable_Types____________________ Variable_Type_________Address_Type__________Supported______ UNNAMED_VARIABLE NUMERIC No SYMBOLIC No UNCONSTRAINED Yes NAMED_VARIABLE______________________________No_____________ An UNNAMED_VARIABLE type describes a specific physical address on a VMD. This address has a predefined type based on the address. Variables of this type are an inherent part of the VMD architecture and are uniquely identified by their physical address. An unnamed variable can be one of the following types: o NUMERIC A numeric address must be an MMS unsigned integer. o SYMBOLIC A symbolic address must be an MMS visible string. o UNCONSTRAINED An unconstrained address can be any MMS octet (byte) string. A NAMED_VARIABLE type describes a variable on a PLC. Variables of this type are uniquely identified by their name. Table 3-3 lists the read and write variable functions available through the DEComni (API) interface. Table_3-3_Read_and_Write_Variable_Interface_Access_________ Interface___Function_Name__________________________________ API omni_get_value omni_get_value_a omni_put_value ____________omni_put_value_a_______________________________ 3-4 Using the DAS for Allen-Bradley Data Highway Using the DAS for Allen-Bradley Data Highway 3.2 Supported Functions 3.2.3 Write and Abort Indications An indication is data that is sent to the DAS from the PLC without the DAS specifically requesting the data. The DAS supports write and abort indications. ________________________ Note ________________________ Information reports are also supported for PLC-2, PLC- 3, and PLC-5 for backward compatability purposes only. Configurations should be migrated to use the write indication support as soon as possible. ______________________________________________________ The write indication is used when the PLC is sending data to the host. In order to use the write indication function, a variable must be created on the host's local VMD that matches the address and size of the data being sent by the PLC. If a PLC has been programmed to send data to the host and a variable is found that matches the address of the data being sent, a write indication is generated specifying the variable that was found. If more than one variable is configured that matches the address of the data being sent, then an indication is generated for only the first variable found. Table 3-4 lists the functions to use when programming the PLC to send data to the host for each PLC family. Sending PLC-2 protected or unprotected writes is supported for all PLC families. For SLC controllers use the 485CIF target device to send PLC-2 messages. Also for SLC controllers the destination address is specified as a decimal byte offset. This value must be converted to a word octal address to obtain the unnamed variable address to use for the message coming from the device. Using the DAS for Allen-Bradley Data Highway 3-5 Using the DAS for Allen-Bradley Data Highway 3.2 Supported Functions Table_3-4_Supported_PLC_Write_Functions____________________ _PLC_Family_ Remote Local VMD____VMD____Function_Name____Address_Type________________ PLC 2 PLC 2 Protected or PLC-2 address Unprotected Write PLC 3 PLC 2 Protected or PLC-2 address Unprotected Write PLC 3 PLC 3 Word Range PLC-3 Logical binary address Write PLC 5 PLC 2 Protected or PLC-2 address Unprotected Write PLC 5 PLC-5 Typed Write PLC-5 Logical binary or ASCII address SLC PLC 2 Protected or PLC-2 address Unprotected Write SLC SLC Protected Typed SLC address ______________Logical_Write________________________________ An abort indication is generated by the DAS when it loses a connection to the PLC. The DAS detects that a connection is broken under the following conditions: o When a request to the KE/KF card times out. In this case all connections using this communication card are aborted. o When an error is returned from a QIO call. In this case all connections using this port are aborted. o When a LOCAL status code of X'02' is returned from the KE/KF card. In this case the KE/KF cards is unable to communicate to the remote PLC. In this case only the connection to the PLC for which the X'02' status code is returned is aborted. 3-6 Using the DAS for Allen-Bradley Data Highway Using the DAS for Allen-Bradley Data Highway 3.2 Supported Functions Table 3-5 lists the indication functions available through the DEComni (API) interface. Table_3-5_Indication_Interface_Access______________________ Interface___Function_Name__________________________________ API omni_get_indications ____________omni_get_indications_a_________________________ 3.3 Addressing Syntax and Supported Data Types Data types are defined at the device and application levels. The device data type is referred to as the MMS data type. The MMS data type is mapped to an application data type. Data types can be either simple or complex. Simple data types are native to the DEComni environment. Complex data types are divided into either arrays or structures. Complex data types must be created by a user before they can be used in defining data points or variables. The following sections describe the supported data types and addressing syntax for each of the supported PLC families. 3.3.1 PLC-2 Addressing Syntax and Supported Data Types Figure 3-1 shows the structure of a legal address for the PLC-2 family. Figure 3-1 General PLC-2 Address Format Using the DAS for Allen-Bradley Data Highway 3-7 Using the DAS for Allen-Bradley Data Highway 3.3 Addressing Syntax and Supported Data Types Table 3-6 shows examples of valid addresses for the PLC-2 family. Table_3-6_Example_PLC-2_Data_Types_________________________ Example Address_____MMS_Type[1]______Description___________________ 377 UNSIGNED_16 Word 377 octal including status bits[2] 20 BCD3[3] Word 20 octal[2] 1777/17 BIT_STRING Bit 17 octal of word 1777 octal[2] 33 Array of 10 Ten words beginning at word 33 BCD3 octal [1]Arrays_are_supported._Structures_are_not_supported._____ Variable size arrays are not supported. [2]Control bits should be treated as read only and modified only under PLC program control. Modifying these bits from a computer can give unpredictable results. [3]The number must be a valid BCD number from 0-999. Status bits are cleared. ___________________________________________________________ 3.3.2 PLC-3 Addressing Syntax and Supported Data Types The PLC-3 family supports the following addressing syntaxes: o Data table addressing o Extended addressing Section 3.3.2.1 and Section 3.3.2.2 describe these addressing syntaxes. 3.3.2.1 PLC-3 Data Table Addressing The structure of a legal data table address for the PLC-3 differs depending on the table that is being addressed. The PLC-3 supports the following data table sections: I - Input O - Output C - Counter T - Timer A - ASCII 3-8 Using the DAS for Allen-Bradley Data Highway Using the DAS for Allen-Bradley Data Highway 3.3 Addressing Syntax and Supported Data Types B - Binary D - Decimal F - Floating-Point H - High-Order Integer N - Integer S - Status P - Pointer Figure 3-2 shows the structure of a legal I/O data table address for the PLC-3. Table 3-7 shows examples of legal I/O data table addresses for the PLC-3. Figure 3-2 PLC-3 I/O Data Table Address Format Table_3-7_Example_PLC-3_I/O_Data_Table_Addresses___________ Example Address_____MMS_Type[1]______Description___________________ I20 UNSIGNED_16 Input image rack 2 group 0 octal I377 INTEGER_16 Input image rack 37 group 7 octal I1:1777/17 BIT_STRING Bit 17 of word 1777 octal in file 1 decimal $O33:77/1 BIT_STRING Bit 1 of word 77 octal in file 33 decimal O99:167 INTEGER_16 Word 167 octal in file 99 decimal I0 Array of 10 Ten words beginning at rack 0 UNSIGNED_16 group 0 [1]Arrays_are_supported._Structures_are_not_supported._____ Variable size arrays are not supported. ___________________________________________________________ Using the DAS for Allen-Bradley Data Highway 3-9 Using the DAS for Allen-Bradley Data Highway 3.3 Addressing Syntax and Supported Data Types Figure 3-3 shows the structure of a legal Timer or Counter data table address for the PLC-3. Figure 3-4 shows a PLC-3 Timer structure. Figure 3-5 shows a PLC-3 Counter structure. Table 3-8 shows examples of legal Timer or Counter data table addresses for the PLC-3. Figure 3-3 PLC-3 Timer and Counter Data Table Address Format Figure 3-4 PLC-3 Timer Structure Figure 3-5 PLC-3 Counter Structure 3-10 Using the DAS for Allen-Bradley Data Highway Using the DAS for Allen-Bradley Data Highway 3.3 Addressing Syntax and Supported Data Types Table 3-8 Example PLC-3 Timer and Counter Data Table __________Addresses________________________________________ Example_Address__MMS_Type[1]______Description______________ $TACC20 UNSIGNED_16 Timer 20 accumulated value CPRE:91 INTEGER_16 Counter 91 preset value TCTL:20/17 BIT_STRING Timer 20 Timer Enable bit[2] T20.TD BIT_STRING Timer 20 Timer Done bit[2] C5 Structure[3] All of counter 5. UNSIGNED_16 Control UNSIGNED_16 Preset value UNSIGNED_16 Accumulated value [1]Arrays_are_not_supported._______________________________ [2]Control bits should be treated as read only and modified only under PLC program control. Modifying these bits from a computer can give unpredictable results. [3]Write operations are not allowed to structures. Fields in the structure can be any combination of three INTEGER_16 or UNSIGNED_16. The control, preset and accumulated values are read in that order. ___________________________________________________________ Figure 3-6 shows the structure of a legal ASCII, Binary, Decimal, Floating-Point, High-Order Integer or Status data table address for the PLC-3. Table 3-9 shows examples of legal ASCII, Binary, Decimal, Floating-Point, High-Order Integer or Status data table addresses for the PLC-3. Using the DAS for Allen-Bradley Data Highway 3-11 Using the DAS for Allen-Bradley Data Highway 3.3 Addressing Syntax and Supported Data Types Figure 3-6 PLC-3 ASCII, Binary, Decimal, Floating-Point, High-Order Integer, Integer and Status Data Table Address Format Table 3-9 Example PLC-3 ASCII, Binary, Decimal, Floating- Point, High-Order Integer, Integer and Status __________Data_Table_Address_Format________________________ Example Address_____MMS_Type[1]______Description___________________ $S0:0 UNSIGNED_16 Word 0 of status file 0 N20:0 INTEGER_16 Word 0 of integer file 20 D20:780 BCD4[2] Word 780 of decimal (BCD) file 20 F39:19 FLOAT[3] Word 19 of floating-point file 39 H8:20 UNSIGNED_32[4] Word 20 of high-order integer file 8 H99:0 INTEGER_32[4] Word 0 of high-order integer file 99 A10:20 VISIBLE_ Word 20 of ASCII file 10 STRING[5] A7:0 OCTET_STRING[5] Word 0 of ASCII file 7 B5:20/10 BIT_STRING[6] Bit 10 octal of word 20 of binary file 5 [1]Arrays_are_supported._Structures_are_not_supported._____ Variable size arrays are not supported. [2]Decimal (BCD) section only. The data must be a valid BCD number from 0-9999. [3]Floating-point section only. [4]High-order integer section only. [5]ASCII section only. [6]Bit writes that span more than one word are not supported. ___________________________________________________________ 3-12 Using the DAS for Allen-Bradley Data Highway Using the DAS for Allen-Bradley Data Highway 3.3 Addressing Syntax and Supported Data Types Figure 3-7 shows the structure of a legal Pointer data table address for the PLC-3. Figure 3-8 shows a PLC-3 Pointer structure. Table 3-10 shows examples of legal Pointer data table addresses for the PLC-3. Figure 3-7 PLC-3 Pointer Data Table Address Format Figure 3-8 PLC-3 Pointer Structure Table_3-10_Example_PLC-3_Pointer_Data_Table_Addresses______ Example_Address__MMS_Type[1]______Description______________ $PFIL:91 INTEGER_16T Pointer 91 file number PSEC:20 UNSIGNED_16 Pointer 20 section number P4 Structure[2] All of pointer 4 UNSIGNED_16 Section UNSIGNED_16 File UNSIGNED_16 Word [1]Writes_are_not_allowed_to_the_pointer_file._Arrays_are__ not supported. [2]Fields in the structure can be any combination of three INTEGER_16 or UNSIGNED_16. The section, file and word values are read in that order. ___________________________________________________________ Using the DAS for Allen-Bradley Data Highway 3-13 Using the DAS for Allen-Bradley Data Highway 3.3 Addressing Syntax and Supported Data Types 3.3.2.2 PLC-3 Extended Addressing Extended addressing is an alternative form of addressing memory in the PLC-3. Only data table area addresses are supported (area 3). Figure 3-9 shows the structure of legal extended addresses. Table 3-11 shows example addresses and supported data types for the PLC-3. Figure 3-9 PLC-3 Extended Address Format Table_3-11_Example_PLC-3_Extended_Addresses________________ Example_Address__MMS_Type[1]______Description______________ E3.1.1.0.0.77 INTEGER_16 Word 77 octal of the output image (1) file E3.1.9.0.0.30 VISIBLE_STRING Word 30 of ASCII (9) file 0 E3.1.10.8.99.0 INTEGER_32 Longword 99 of high-order integer (10) file 8 E3.1.4.0.99.2 UNSIGNED_16 Accumulated value of counter (4) 99 E3.1.8.8.0.183 BIT_STRING Bit 16 octal of word 183 /16 of binary (8) file 8 [1]Support_for_data_types_and_arrays_follow_the_same_rules_ as when using data table addressing. Structures are not supported. ___________________________________________________________ 3-14 Using the DAS for Allen-Bradley Data Highway Using the DAS for Allen-Bradley Data Highway 3.3 Addressing Syntax and Supported Data Types 3.3.3 PLC-5 Addressing Syntax and Supported Data Types This section describes legal data table addresses and data types for the 1785 PLC-5 family. For information on addresses and supported data types for the PLC-5/250 PLC, refer to Section 3.3.4. The structure of a legal data table address for the PLC-5 differs depending on the table that is being addressed. The PLC-5 supports the following data table sections: I - Input O - Output S - Status B - Binary T - Timer C - Counter R - Control N - Integer F - Floating-Point A - ASCII D - Decimal ST - String SC - SFC Status BT - Block-Transfer Control TD - Token Data PD - PID Control MG - Message Control Figure 3-10 shows the structure of a legal I/O data table address for the PLC-5. Table 3-12 shows examples of legal I/O data table addresses for the PLC-5. Figure 3-10 PLC-5 I/O Data Table Address Format Using the DAS for Allen-Bradley Data Highway 3-15 Using the DAS for Allen-Bradley Data Highway 3.3 Addressing Syntax and Supported Data Types Table_3-12_Example_PLC-5_I/O_Data_Table_Addresses__________ Example Address_____MMS_Type[1]______Description___________________ I:20 UNSIGNED_16 Input image rack 2 group 0 octal I:277 INTEGER_16 Input image rack 27 group 7 octal I:177/17 BIT_STRING Bit 17 of rack 17 group 7 octal $O:77/1 BIT_STRING Bit 1 of rack 7 group 7 octal I:0 Array of 10 Ten words beginning at rack 0 UNSIGNED_16 group 0 [1]Arrays_are_supported._Structures_are_not_supported._____ Variable size arrays are not supported. ___________________________________________________________ Figure 3-11 shows the structure of a legal Status data table address for the PLC-5. Table 3-13 shows examples of legal Status data table addresses for the PLC-5. Figure 3-11 PLC-5 Status Data Table Address Format 3-16 Using the DAS for Allen-Bradley Data Highway Using the DAS for Allen-Bradley Data Highway 3.3 Addressing Syntax and Supported Data Types Table_3-13_Example_PLC-5_Status_Data_Table_Addresses_______ Example Address_____MMS_Type[1]______Description___________________ S:20 UNSIGNED_16 Word 20 of the status file S:12 INTEGER_16 Word 12 of the status file $S:125/1 BIT_STRING Bit 1 of word 125 of the status file S:0 Array of 10 Ten words beginning at word 0 UNSIGNED_16 [1]Arrays_are_supported._Structures_are_not_supported._____ Variable size arrays are not supported. ___________________________________________________________ Figure 3-12 shows the structure of a legal ASCII, Binary, Decimal, Floating-Point or Integer data table address for the PLC-5. Table 3-14 shows examples of legal ASCII, Binary, Decimal, Floating-Point and Integer data table addresses for the PLC-5. Figure 3-12 PLC-5 ASCII, Binary, Decimal, Floating-Point and Integer Data Table Address Format Using the DAS for Allen-Bradley Data Highway 3-17 Using the DAS for Allen-Bradley Data Highway 3.3 Addressing Syntax and Supported Data Types Table 3-14 Example PLC-5 ASCII, Binary, Decimal, Floating- ___________Point_and_Integer_Data_Table_Address_Format_____ Example Address_____MMS_Type[1]______Description___________________ $N20:0 INTEGER_16 Word 0 of integer file 20 D20:780 BCD4[2] Word 780 of decimal (BCD) file 20 F39:19 FLOAT[3] Word 19 of floating-point file 39 A10:20 VISIBLE_ Word 20 of ASCII file 10 STRING[5] A11:0 OCTET_STRING[4] Word 0 of ASCII file 11 B91:20/10 BIT_STRING[5] Bit 10 of word 20 of binary file 91 B:33 UNSIGNED_16 Word 33 of the default binary file (3) N:91 UNSIGNED_16 Word 91 of the default integer file (7) F:3 FLOAT Word 3 of the default floating-point file (8) B/155 BIT_STRING Bit 11 of word 9 in the default binary file (3) [1]Arrays_are_supported._Structures_are_not_supported._____ Variable size arrays are not supported. [2]Decimal (BCD) section only. The data must be a valid BCD number from 0-9999. [3]Floating-point section only. [4]ASCII section only. [5]Bit writes that span more than one element are not supported. ___________________________________________________________ Figure 3-13 shows the structure of a legal Timer, Counter, Control, SFC Status, Block-Transfer Control, Token Data, ASCII String, PID Control or Message Control data table address for the PLC-5. Figure 3-14 shows a PLC-5 Timer structure. Figure 3-15 shows a PLC-5 Counter structure. Figure 3-16 shows a PLC-5 Control structure. Figure 3-17 shows a PLC-5 SFC Status structure. 3-18 Using the DAS for Allen-Bradley Data Highway Using the DAS for Allen-Bradley Data Highway 3.3 Addressing Syntax and Supported Data Types Figure 3-18 shows a PLC-5 Block-Transfer Control structure. Figure 3-19 shows a PLC-5 Token Data structure. Figure 3-20 shows a PLC-5 ASCII String structure. Figure 3-21 shows a PLC-5 PID Control structure. Figure 3-22 shows a PLC-5 Message Control structure. Table 3-15 shows examples of legal Timer, Counter, Control, SFC Status, Block-Transfer Control, Token Data, ASCII String, PID Control and Message Control data table addresses for the PLC-5. Figure 3-13 PLC-5 Timer, Counter, Control, SFC Status, Block-Transfer Control, Token Data, ASCII String, PID Control and Message Control Data Table Address Format Figure 3-14 PLC-5 Timer Structure Figure 3-15 PLC-5 Counter Structure Using the DAS for Allen-Bradley Data Highway 3-19 Using the DAS for Allen-Bradley Data Highway 3.3 Addressing Syntax and Supported Data Types Figure 3-16 PLC-5 Control Structure Figure 3-17 PLC-5 SFC Status Structure Figure 3-18 PLC-5 Block-Transfer Control Structure Figure 3-19 PLC-5 Token Data Structure 3-20 Using the DAS for Allen-Bradley Data Highway Using the DAS for Allen-Bradley Data Highway 3.3 Addressing Syntax and Supported Data Types Figure 3-20 PLC-5 ASCII String Structure Figure 3-21 PLC-5 PID Control Structure Figure 3-22 PLC-5 Message Control Structure Table 3-15 Example PLC-5 Timer, Counter, Control, SFC Status, Block-Transfer Control, Token Data, ASCII String, PID Control and Message Control ___________Data_Table_Address_Formats______________________ Example_Address__MMS_Type[1]______Description______________ $T20:0.ACC UNSIGNED_16 Timer 0 in file 20 accumulated value C91:3.PRE INTEGER_16 Counter 91 in file 3 preset value [1]Arrays_are_not_supported_for_structures_other_than_ASCII strings. (continued on next page) Using the DAS for Allen-Bradley Data Highway 3-21 Using the DAS for Allen-Bradley Data Highway 3.3 Addressing Syntax and Supported Data Types Table 3-15 (Cont.) Example PLC-5 Timer, Counter, Control, SFC Status, Block-Transfer Control, Token Data, ASCII String, PID Control and Message Control Data Table Address ___________________Formats_________________________________ Example_Address__MMS_Type[1]______Description______________ T:20.CTL/15 BIT_STRING Timer 20 in the default timer file (4) Enable bit[2] R6:0.UL BIT_STRING Control 0 in file 6 Unload bit[2] T4:20.TD BIT_STRING Timer 20 in file 4 Timer Done bit[2] R:1.LEN INTEGER_16 Control 1 in the default control file (6) Length value SC10:0.TIM INTEGER_16 SFC status 0 in file 10 Active Time value BT11:3.RGS UNSIGNED_16 Block Transfer Control 3 in file 11 Rack/Group /Slot TD15:2.HI INTEGER_16 Token Data 2 in file 15 High Word value ST16:0.LEN INTEGER_16 String 0 in file 16 Length value ST16:2 VISIBLE_ String 2 in file 16 STRING[3] ST16:3 OCTET_STRING[3] String 3 in file 16 PD17:2.DVDB FLOAT PID Control 2 in file 17 Deviation Alarm Dead Band [1]Arrays_are_not_supported_for_structures_other_than_ASCII strings. [2]Control bits should be treated as read only and modified only under PLC program control. Modifying these bits from a computer can give unpredictable results. [3]Only Varying length strings are supported. (continued on next page) 3-22 Using the DAS for Allen-Bradley Data Highway Using the DAS for Allen-Bradley Data Highway 3.3 Addressing Syntax and Supported Data Types Table 3-15 (Cont.) Example PLC-5 Timer, Counter, Control, SFC Status, Block-Transfer Control, Token Data, ASCII String, PID Control and Message Control Data Table Address ___________________Formats_________________________________ Example_Address__MMS_Type[1]______Description______________ PD17:2.EN BIT_STRING PID Control 2 in file 17 Enable PD17:1.ADDR[0] INTEGER_16 PID Control 1 in file 17 Master-to-slave address 0 MG18:3.RLEN INTEGER_16 Message Control 3 in file 18 Requested Length T:5 Structure[4] All of timer 5 in file 4 UNSIGNED_16 Control UNSIGNED_32 Preset value UNSIGNED_32 Accumulated value R8:10 Structure[4] All of control 10 in file UNSIGNED_16 8 INTEGER_16 Control INTEGER_16 Length Position SC9:5 Structure[4] All of SFC status 5 in INTEGER_16 file 9 UNSIGNED_16 Control UNSIGNED_16 Preset value Active Time BT11:2 Structure[4] All of BT 2 in file 11 UNSIGNED_16 Control INTEGER_16 Requested word count INTEGER_16 Transmitted word count INTEGER_16 File-type number INTEGER_16 Word number UNSIGNED_16 Rack/Group/Slot [1]Arrays_are_not_supported_for_structures_other_than_ASCII strings. [4]Write operations are not allowed to structures other than to ASCII strings. (continued on next page) Using the DAS for Allen-Bradley Data Highway 3-23 Using the DAS for Allen-Bradley Data Highway 3.3 Addressing Syntax and Supported Data Types Table 3-15 (Cont.) Example PLC-5 Timer, Counter, Control, SFC Status, Block-Transfer Control, Token Data, ASCII String, PID Control and Message Control Data Table Address ___________________Formats_________________________________ Example_Address__MMS_Type[1]______Description______________ TD15:2 Structure[4] All of Token Data 2 in UNSIGNED_16 file 15 UNSIGNED_16 High Word __________________________________Low_Word_________________ [1]Arrays are not supported for structures other than ASCII strings. [4]Write operations are not allowed to structures other than to ASCII strings. (continued on next page) 3-24 Using the DAS for Allen-Bradley Data Highway Using the DAS for Allen-Bradley Data Highway 3.3 Addressing Syntax and Supported Data Types Table 3-15 (Cont.) Example PLC-5 Timer, Counter, Control, SFC Status, Block-Transfer Control, Token Data, ASCII String, PID Control and Message Control Data Table Address ___________________Formats_________________________________ Example_Address__MMS_Type[1]______Description______________ PD17:0 Structure[4] All of PID Control 0 in UNSIGNED_32 file 17 FLOAT Control FLOAT Set point FLOAT Proportional gain FLOAT Initial gain FLOAT Derivative gain FLOAT Output bias % FLOAT Maximum scaled value FLOAT Minimum scaled value FLOAT Dead band FLOAT Set output % FLOAT Maximum output limit FLOAT Minimum output limit FLOAT Update time FLOAT Process variable FLOAT Error:scaled FLOAT Output FLOAT PV alarm high FLOAT PV alarm low FLOAT Deviation alarm + FLOAT Deviation alarm - FLOAT PV alarm dead band FLOAT Deviation alarm dead band FLOAT Maximum input FLOAT Minimum intput Array of 4 Tieback % UNSIGNED_16 Array of 14 Master-to-slave address FLOAT __________________________________Reserved/internal_use____ [1]Arrays are not supported for structures other than ASCII strings. [4]Write operations are not allowed to structures other than to ASCII strings. (continued on next page) Using the DAS for Allen-Bradley Data Highway 3-25 Using the DAS for Allen-Bradley Data Highway 3.3 Addressing Syntax and Supported Data Types Table 3-15 (Cont.) Example PLC-5 Timer, Counter, Control, SFC Status, Block-Transfer Control, Token Data, ASCII String, PID Control and Message Control Data Table Address ___________________Formats_________________________________ Example_Address__MMS_Type[1]______Description______________ MG18:2 Structure[4] All of Message Control 2 UNSIGNED_16 in file 18 INTEGER_16 Control INTEGER_16 Error code INTEGER_16 Requested length Array of 52 Done length INTEGER_16 [1]Arrays_are_not_supported_for_structures/othernthansASCII strings. [4]Write operations are not allowed to structures other than to ASCII strings. ___________________________________________________________ 3-26 Using the DAS for Allen-Bradley Data Highway Using the DAS for Allen-Bradley Data Highway 3.3 Addressing Syntax and Supported Data Types 3.3.4 PLC-5/250 Addressing Syntax and Supported Data Types This section describes legal addresses and data types for the PLC-5/250 PLC. For information on addresses and supported data types for the 1785 PLC-5 family, refer to Section 3.3.3. The PLC-5/250 supports the following four types of modules: Resource Manager Logic Processor (1-4) Remote Scanner (1-4) CVIM (1-4) Each module can be addressed and supports different types of memory sections. The structure of a legal address for the PLC-5/250 differs depending on the area of memory that is being addressed. The PLC-5/250 supports the following memory sections for the Resource Manager and Logic Processor modules: B - Binary N - Integer L - Long Integer F - Floating-Point T - Timer C - Counter R - Control ST - String PD - PID Control MSG - Message Control S - Status The PLC-5/250 supports the following memory sections for the Remote Scanner module: I - Input O - Output BTD - Block-Transfer Data BR - Block-Transfer Read Control BW - Block-Transfer Write Control AS - Adapter Status IS - Internal Storage Using the DAS for Allen-Bradley Data Highway 3-27 Using the DAS for Allen-Bradley Data Highway 3.3 Addressing Syntax and Supported Data Types The PLC-5/250 supports the following memory section for the CVIM module: SD - Shared Data Figure 3-23 shows the structure of a legal Binary, Floating-Point, Long Integer or Integer table address for the PLC-5/250. Table 3-16 shows examples of legal Binary, Floating-Point, Long Integer and Integer table addresses for the PLC-5 /250. Figure 3-23 PLC-5/250 Binary, Floating-Point, Long Integer and Integer Address Format 3-28 Using the DAS for Allen-Bradley Data Highway Using the DAS for Allen-Bradley Data Highway 3.3 Addressing Syntax and Supported Data Types Table 3-16 Example PLC-5/250 Binary, Floating-Point, Long ___________Integer_and_Integer_Address_Format______________ Example Address_____MMS_Type[1]______Description___________________ $0N20:0 INTEGER_16 Word 0 of integer file 20 0L5:3 UNSIGNED_32[2] Word 3 of long integer file 5 1L3:145 SIGNED_32[2] Word 145 of long integer file 3 0F39:19 FLOAT[3] Word 19 of floating-point file 39 0B91:20/10 BIT_STRING Bit 10 of word 20 of binary file 91 1B3:33 UNSIGNED_16 Word 33 of binary file 3 0N7:91 UNSIGNED_16 Word 91 of integer file 7 0F8:3 FLOAT Word 3 of floating-point file 8 0B2/124 BIT_STRING Bit 12 of word 7 in the binary file 2 0B3:3/3 Array of 10 Ten bits beginning at word 3 BIT[4] of binary file 3 [1]Arrays_are_supported._Structures_are_not_supported._____ Variable size arrays are not supported. [2]Long integer section only. [3]Floating-point section only. [4]Bit writes that span more than one element are not supported. ___________________________________________________________ Figure 3-24 shows the structure of a legal Timer, Counter, Control, ASCII String, PID Control or Message Control data table address for the PLC-5/250. Figure 3-25 shows a PLC-5/250 Timer structure. Figure 3-26 shows a PLC-5/250 Counter structure. Figure 3-27 shows a PLC-5/250 Control structure. Figure 3-28 shows a PLC-5/250 ASCII String structure. Figure 3-29 shows a PLC-5/250 PID Control structure. Figure 3-30 shows a PLC-5/250 Message Control structure. Figure 3-25 shows a PLC-5/250 Timer structure. Figure 3-25 shows a PLC-5/250 Timer structure. Using the DAS for Allen-Bradley Data Highway 3-29 Using the DAS for Allen-Bradley Data Highway 3.3 Addressing Syntax and Supported Data Types Table 3-17 shows examples of legal Timer, Counter, Control, ASCII String, PID Control and Message Control data table addresses for the PLC-5/250. Figure 3-24 PLC-5/250 Timer, Counter, Control, ASCII String, PID Control and Message Control Address Format Figure 3-25 PLC-5/250 Timer Structure Figure 3-26 PLC-5/250 Counter Structure Figure 3-27 PLC-5/250 Control Structure 3-30 Using the DAS for Allen-Bradley Data Highway Using the DAS for Allen-Bradley Data Highway 3.3 Addressing Syntax and Supported Data Types Figure 3-28 PLC-5/250 ASCII String Structure Figure 3-29 PLC-5/250 PID Control Structure Figure 3-30 PLC-5/250 Message Control Structure Table 3-17 Example PLC-5/250 Timer, Counter, Control, ASCII String, PID Control and Message Control Address ___________Formats_________________________________________ Example_Address__MMS_Type[1]______Description______________ $0T20:0.ACC UNSIGNED_32 Timer 0 in file 20 accumulated value 0C91:3.PRE INTEGER_16 Counter 91 in file 3 preset value [1]Arrays_are_not_supported_for_structures_other_than_ASCII strings. (continued on next page) Using the DAS for Allen-Bradley Data Highway 3-31 Using the DAS for Allen-Bradley Data Highway 3.3 Addressing Syntax and Supported Data Types Table 3-17 (Cont.) Example PLC-5/250 Timer, Counter, Control, ASCII String, PID Control and ___________________Message_Control_Address_Formats_________ Example_Address__MMS_Type[1]______Description______________ 0T3:20.CTL/31 BIT_STRING Timer 20 in timer file 3 Enable bit[2] 1R6:0.UL BIT_STRING Control 0 in file 6 unload bit[2] 0T4:20.TD BIT_STRING Timer 20 in file 4 timer done bit[2] 1R6:1.LEN INTEGER_16 Control 1 in control file 6 length value 0ST16:0.LEN INTEGER_16 String 0 in file 16 length value 0ST16:2 VISIBLE_ String 2 in file 16 STRING[3] 0ST16:3 OCTET_STRING[3] String 3 in file 16 0PD17:2.DVDB FLOAT PID Control 2 in file 17 Deviation Alarm Dead Band 0PD17:2.EN BIT_STRING PID Control 2 in file 17 Enable 0PD17:1.ADDR[0] INTEGER_16 PID Control 1 in file 17 Master-to-slave address 0 0MSG18:3.RLEN INTEGER_16 Message Control 3 in file 18 Requested Length 1T0:5 Structure[4] All of timer 5 in file 0 UNSIGNED_16 Control UNSIGNED_32 Preset value UNSIGNED_32 Accumulated value [1]Arrays_are_not_supported_for_structures_other_than_ASCII strings. [2]Control bits should be treated as read only and modified only under PLC program control. Modifying these bits from a computer can give unpredictable results. [3]Only varying length strings are supported. [4]Write operations are not allowed to structures other than to ASCII strings. (continued on next page) 3-32 Using the DAS for Allen-Bradley Data Highway Using the DAS for Allen-Bradley Data Highway 3.3 Addressing Syntax and Supported Data Types Table 3-17 (Cont.) Example PLC-5/250 Timer, Counter, Control, ASCII String, PID Control and ___________________Message_Control_Address_Formats_________ Example_Address__MMS_Type[1]______Description______________ 0R8:10 Structure[4] All of control 10 in file UNSIGNED_16 8 INTEGER_16 Control INTEGER_16 Length __________________________________Position_________________ [1]Arrays are not supported for structures other than ASCII strings. [4]Write operations are not allowed to structures other than to ASCII strings. (continued on next page) Using the DAS for Allen-Bradley Data Highway 3-33 Using the DAS for Allen-Bradley Data Highway 3.3 Addressing Syntax and Supported Data Types Table 3-17 (Cont.) Example PLC-5/250 Timer, Counter, Control, ASCII String, PID Control and ___________________Message_Control_Address_Formats_________ Example_Address__MMS_Type[1]______Description______________ 0PD17:0 Structure[4] All of PID Control 0 in UNSIGNED_32 file 17 FLOAT Control FLOAT Set point FLOAT Proportional gain FLOAT Initial gain FLOAT Derivative gain FLOAT Output bias % FLOAT Maximum scaled value FLOAT Minimum scaled value FLOAT Dead band FLOAT Set output % FLOAT Maximum output limit FLOAT Minimum output limit FLOAT Update time FLOAT Process variable FLOAT Error:scaled FLOAT Output FLOAT PV alarm high FLOAT PV alarm low FLOAT Deviation alarm + FLOAT Deviation alarm - FLOAT PV alarm dead band FLOAT Deviation alarm dead band FLOAT Maximum input FLOAT Minimum intput Array of 4 Tieback % UNSIGNED_16 Array of 14 Master-to-slave address FLOAT __________________________________Reserved/internal_use____ [1]Arrays are not supported for structures other than ASCII strings. [4]Write operations are not allowed to structures other than to ASCII strings. (continued on next page) 3-34 Using the DAS for Allen-Bradley Data Highway Using the DAS for Allen-Bradley Data Highway 3.3 Addressing Syntax and Supported Data Types Table 3-17 (Cont.) Example PLC-5/250 Timer, Counter, Control, ASCII String, PID Control and ___________________Message_Control_Address_Formats_________ Example_Address__MMS_Type[1]______Description______________ 0MSG18:2 Structure[4] All of Message Control 2 UNSIGNED_16 in file 18 INTEGER_16 Control INTEGER_16 Error code INTEGER_16 Requested length Array of 52 Done length INTEGER_16 [1]Arrays_are_not_supported_for_structures/othernthansASCII strings. [4]Write operations are not allowed to structures other than to ASCII strings. ___________________________________________________________ Figure 3-31 shows the structure of a legal Status data table address for the PLC-5/250. Table 3-18 shows examples of legal Status data table addresses for the PLC-5/250. Figure 3-31 PLC-5/250 Status Address Format Using the DAS for Allen-Bradley Data Highway 3-35 Using the DAS for Allen-Bradley Data Highway 3.3 Addressing Syntax and Supported Data Types Table_3-18_Example_PLC-5/250_Status_Addresses______________ Example Address_____MMS_Type[1]______Description___________________ 0S:20 UNSIGNED_16 Word 20 of the status file in the resource manager 1S:12 INTEGER_16 Word 12 of the status file in logic processor 1 $0S:125/1 BIT_STRING Bit 1 of word 125 of the status file in the resource manager 0S:0 Array of 10 Ten words beginning at word 0 UNSIGNED_16 [1]Arrays_are_supported._Structures_are_not_supported._____ Variable size arrays are not supported. ___________________________________________________________ Figure 3-32 shows the structure of a legal I/O data table address for the PLC-5/250. Table 3-19 shows examples of legal I/O data table addresses for the PLC-5/250. Figure 3-32 PLC-5/250 I/O Address Format 3-36 Using the DAS for Allen-Bradley Data Highway Using the DAS for Allen-Bradley Data Highway 3.3 Addressing Syntax and Supported Data Types Table_3-19_Example_PLC-5/250_I/O_Addresses_________________ Example Address_____MMS_Type[1]______Description___________________ I:20 UNSIGNED_16 Input image rack 2 group 0 octal I:277 INTEGER_16 Input image rack 27 group 7 octal I:177/17 BIT_STRING Bit 17 of rack 17 group 7 octal $O:77/1 BIT_STRING Bit 1 of rack 7 group 7 octal I:0 Array of 10 Ten words beginning at rack 0 UNSIGNED_16 group 0 [1]Arrays_are_supported._Structures_are_not_supported._____ Variable size arrays are not supported. ___________________________________________________________ Figure 3-33 shows the structure of a legal Block-Transfer data table address for the PLC-5/250. Table 3-19 shows examples of legal Block-Transfer data table addresses for the PLC-5/250. Figure 3-33 PLC-5/250 Block-Transfer Data Address Format Using the DAS for Allen-Bradley Data Highway 3-37 Using the DAS for Allen-Bradley Data Highway 3.3 Addressing Syntax and Supported Data Types Table_3-20_Example_PLC-5/250_Block-Transfer_Data_Addresses_ Example Address_____MMS_Type[1]______Description___________________ 1BTD0:20 UNSIGNED_16 Word 20 of file 0 in remote scanner 1 1BTD2:12 INTEGER_16 Word 12 of file 2 in remote scanner 1 $2BTD30:125 BIT_STRING Bit 1 of word 125 of file 30 /1 in remote scanner 2 1BTD0:0 Array of 10 Ten words beginning at word 0 UNSIGNED_16 of file 0 in remote scanner 1 [1]Arrays_are_supported._Structures_are_not_supported._____ Variable size arrays are not supported. ___________________________________________________________ Figure 3-34 shows the structure of a legal Block-Transfer Read/Write Control data table address for the PLC-5/250. Figure 3-35 shows a PLC-5/250 Block-Transfer Read/Write Control structure. Table 3-21 shows examples of legal Block-Transfer Read /Write Control data table addresses for the PLC-5/250. Figure 3-34 PLC-5/250 Block-Transfer Read/Write Control Address Format 3-38 Using the DAS for Allen-Bradley Data Highway Using the DAS for Allen-Bradley Data Highway 3.3 Addressing Syntax and Supported Data Types Figure 3-35 PLC-5/250 Block-Transfer Read/Write Control Structure Table 3-21 Example PLC-5/250 Block-Transfer Read/Write ___________Control_Addresses_______________________________ Example Address_____MMS_Type[1]______Description___________________ BR01:1.DLEN UNSIGNED_16 I/O rack 0, group 1, remote scanner 1, slot 1 done length. BW16:0.PLEN INTEGER_16 I/O rack 1, group 6, remote scanner 1, slot 1 programmed length. BR103:1.EN BIT_STRING[2] IO rack 10, group 3, remote scanner 2, slot 1 enable bit. $BW27:1 Structure[3] All of Block-Transfer Write Control for I/O UNSIGNED_16 rack 2, group 7, remote UNSIGNED_16 scanner 1, slot 1. UNSIGNED_16 Error code/status bits. UNSIGNED_16 Done/programmed length. UNSIGNED_16 Time stamp. UNSIGNED_16 Current/programmed time-out. UNSIGNED_16 File number/file offset. UNSIGNED_16 Reserved. BT directory offset. BT directory length. [1]Arrays_are_not_supported_for_structures_other_than_ASCII strings. [2]Control bits should be treated as read only and modified only under PLC program control. Modifying these bits from a computer can give unpredictable results. [3]Write operations are not allowed to Block-Transfer Read /Write Control structures. ___________________________________________________________ Using the DAS for Allen-Bradley Data Highway 3-39 Using the DAS for Allen-Bradley Data Highway 3.3 Addressing Syntax and Supported Data Types Figure 3-36 shows the structure of a legal Adapter Status data table address for the PLC-5/250. Figure 3-37 shows a PLC-5/250 Adapter Status structure. Table 3-22 shows examples of legal Adapter Status data table addresses for the PLC-5/250. Figure 3-36 PLC-5/250 Adapter Status Address Format Figure 3-37 PLC-5/250 Adapter Status Structure 3-40 Using the DAS for Allen-Bradley Data Highway Using the DAS for Allen-Bradley Data Highway 3.3 Addressing Syntax and Supported Data Types Table_3-22_Example_PLC-5/250_Adapter_Status_Addresses______ Example Address_____MMS_Type[1]______Description___________________ AS01:1.RC UNSIGNED_16 I/O rack 1, group 1, remote scanner 1 retry count AS10:0.OI BIT_STRING[2] I/O rack 10, group 0, remote scanner 1 output inhibit $AS27:1 Structure[3] All of adapter status for I/O rack 27 UNSIGNED_16 group 1, remote scanner 3 UNSIGNED_16 Control bits Retry count [1]Arrays_are_not_supported_for_structures_other_than_ASCII strings. [2]Control bits should be treated as read only and modified only under PLC program control. Modifying these bits from a computer can give unpredictable results. [3]Write operations are not allowed to Adapter Status structures. ___________________________________________________________ Figure 3-38 shows the structure of a legal Internal Storage data table address for the PLC-5/250. Table 3-23 shows examples of legal Internal Storage data table addresses for the PLC-5/250. Figure 3-38 PLC-5/250 Internal Storage Address Format Using the DAS for Allen-Bradley Data Highway 3-41 Using the DAS for Allen-Bradley Data Highway 3.3 Addressing Syntax and Supported Data Types Table_3-23_Example_PLC-5/250_Internal_Storage_Addresses____ Example Address_____MMS_Type[1]______Description___________________ IS:20 UNSIGNED_16 Word 20 in remote scanner 1 IS:12 INTEGER_16 Word 12 in remote scanner 1 $IS:203/10 BIT_STRING Bit 10 octal of word 203 octal in remote scanner 2 IS:0 Array of 10 Ten words beginning at word 0 UNSIGNED_16 in remote scanner 1 [1]Arrays_are_supported._Structures_are_not_supported._____ Variable size arrays are not supported. ___________________________________________________________ Figure 3-39 shows the structure of a legal Shared Data data table address for the PLC-5/250. Table 3-24 shows examples of legal Shared Data data table addresses for the PLC-5/250. Figure 3-39 PLC-5/250 Shared Data Address Format Table_3-24_Example_PLC-5/250_Shared_Data_Addresses_________ Example Address_____MMS_Type[1]______Description___________________ 1SD13:20 UNSIGNED_16 Word 20 in CVIM module 1 2SD13:155 INTEGER_16 Word 155 in CVIM module 2 $1SD13:0 BIT_STRING Bit 10 of word 0 in CVIM /10 module 1 1SD13:100 Array of 10 Ten words beginning at word UNSIGNED_16 100 in CVIM module 1 [1]Arrays_are_supported._Structures_are_not_supported._____ Variable size arrays are not supported. ___________________________________________________________ 3-42 Using the DAS for Allen-Bradley Data Highway Using the DAS for Allen-Bradley Data Highway 3.3 Addressing Syntax and Supported Data Types 3.3.5 SLC Addressing Syntax and Supported Data Types This section describes legal data table addresses and data types for the 1747 SLC 500 family. The structure of a legal data table address for the SLC differs depending on the table that is being addressed. The SLC supports the following data table sections: I - Input O - Output S - Status B - Binary T - Timer C - Counter R - Control N - Integer F - Floating-Point A - ASCII ST - String ________________________ Note ________________________ ASCII, ASCII string and floating-point are available only on SLC 5/03 Series C with OS301 and SLC 5/04 Series A with OS400. ______________________________________________________ Figure 3-40 shows the structure of a legal I/O data table address for the SLC. Table 3-25 shows examples of legal I/O data table addresses for the SLC. Figure 3-40 SLC I/O Data Table Address Format Using the DAS for Allen-Bradley Data Highway 3-43 Using the DAS for Allen-Bradley Data Highway 3.3 Addressing Syntax and Supported Data Types ________________________ Note ________________________ Reading and writing of I/O data table addresses is supported only for SLC-5/03 and SLC-5/04 processors. ______________________________________________________ Table_3-25_Example_SLC_I/O_Data_Table_Addresses____________ Example Address_____MMS_Type[1]______Description___________________ I:4 UNSIGNED_16 Input image I/O slot 4 I:5.1 INTEGER_16 Input image I/O slot 5 word 1 I:10.1/15 BIT_STRING Bit 31 of I/O slot 10 $O:8/1 BIT_STRING Bit 1 of I/O slot 8 I:0 Array of 10 Ten words beginning at I/O UNSIGNED_16 slot 0 [1]Arrays_are_supported._Structures_are_not_supported._____ Variable size arrays are not supported. ___________________________________________________________ Figure 3-41 shows the structure of a legal Status data table address for the SLC. Table 3-26 shows examples of legal Status data table addresses for the SLC. Figure 3-41 SLC Status Data Table Address Format 3-44 Using the DAS for Allen-Bradley Data Highway Using the DAS for Allen-Bradley Data Highway 3.3 Addressing Syntax and Supported Data Types Table_3-26_Example_SLC_Status_Data_Table_Addresses_________ Example Address_____MMS_Type[1]______Description___________________ S:20 UNSIGNED_16 Word 20 of the status file S:12 INTEGER_16 Word 12 of the status file $S:5/1 BIT_STRING Bit 1 of word 5 of the status file S:0 Array of 10 Ten words beginning at word 0 UNSIGNED_16 [1]Arrays_are_supported._Structures_are_not_supported._____ Variable size arrays are not supported. ___________________________________________________________ Figure 3-42 shows the structure of a legal ASCII, Binary, Floating-Point or Integer data table address for the SLC. Table 3-27 shows examples of legal ASCII, Binary, Floating- Point and Integer data table addresses for the SLC. Figure 3-42 SLC ASCII, Binary, Floating-Point and Integer Data Table Address Format ________________________ Note ________________________ ASCII and floating-point are available only on SLC 5/03 Series C with OS301 and SLC 5/04 Series A with OS400. ______________________________________________________ Using the DAS for Allen-Bradley Data Highway 3-45 Using the DAS for Allen-Bradley Data Highway 3.3 Addressing Syntax and Supported Data Types Table 3-27 Example SLC ASCII, Binary, Floating-Point and ___________Integer_Data_Table_Address_Format_______________ Example Address_____MMS_Type[1]______Description___________________ $N20:0 INTEGER_16 Word 0 of integer file 20 F39:19 FLOAT[2] Word 19 of floating-point file 39 A10:20 VISIBLE_ Word 20 of ASCII file 10 STRING[3] A11:0 OCTET_STRING[3] Word 0 of ASCII file 11 B91:20/10 BIT_STRING[4] Bit 10 of word 20 of binary file 91 N7:20 UNSIGNED_32[5] Words 20 and 21 of integern file 7 B:33 UNSIGNED_16 Word 33 of the default binary file (3) N:91 UNSIGNED_16 Word 91 of the default integer file (7) F:3 FLOAT Word 3 of the default floating-point file (8) B/155 BIT_STRING Bit 11 of word 9 in the default binary file (3) [1]Arrays_are_supported._Structures_are_not_supported._____ Variable size arrays are not supported. [2]Floating-point section only. [3]ASCII section only. [4]Bit writes that span more than one element are not supported. [5]Word 20 is the least significant word. Word 21 is the most significant word in the longword. Both signed and unsigned longwords are supported. ___________________________________________________________ Figure 3-43 shows the structure of a legal Timer, Counter, Control or ASCII String data table address for the SLC. Figure 3-44 shows a SLC Timer structure. Figure 3-45 shows a SLC Counter structure. Figure 3-46 shows a SLC Control structure. Figure 3-47 shows a SLC ASCII String structure. 3-46 Using the DAS for Allen-Bradley Data Highway Using the DAS for Allen-Bradley Data Highway 3.3 Addressing Syntax and Supported Data Types Table 3-28 shows examples of legal Timer, Counter, Control and ASCII String table addresses for the SLC. Figure 3-43 SLC Timer, Counter, Control and ASCII String Data Table Address Format ________________________ Note ________________________ ASCII string is available only on SLC 5/03 Series C with OS301 and SLC 5/04 Series A with OS400. ______________________________________________________ Figure 3-44 SLC Timer Structure Figure 3-45 SLC Counter Structure Using the DAS for Allen-Bradley Data Highway 3-47 Using the DAS for Allen-Bradley Data Highway 3.3 Addressing Syntax and Supported Data Types Figure 3-46 SLC Control Structure Figure 3-47 SLC ASCII String Structure Table 3-28 Example SLC Timer, Counter, Control and ASCII ___________String_Data_Table_Address_Formats_______________ Example_Address__MMS_Type[1]______Description______________ $T20:0.ACC UNSIGNED_16 Timer 0 in file 20 accumulated value C91:3.PRE INTEGER_16 Counter 91 in file 3 preset value T:20.CTL/15 BIT_STRING Timer 20 in the default timer file (4) Enable bit[2] R6:0.UL BIT_STRING Control 0 in file 6 Unload bit[2] T4:20.TD BIT_STRING Timer 20 in file 4 Timer Done bit[2] [1]Arrays_are_not_supported_for_structures_other_than_ASCII strings. [2]Control bits should be treated as read only and modified only under PLC program control. Modifying these bits from a computer can give unpredictable results. (continued on next page) 3-48 Using the DAS for Allen-Bradley Data Highway Using the DAS for Allen-Bradley Data Highway 3.3 Addressing Syntax and Supported Data Types Table 3-28 (Cont.) Example SLC Timer, Counter, Control and ___________________ASCII_String_Data_Table_Address_Formats_ Example_Address__MMS_Type[1]______Description______________ R:1.LEN INTEGER_16 Control 1 in the default control file (6) Length value ST16:0.LEN INTEGER_16 String 0 in file 16 Length value ST16:2 VISIBLE_ String 2 in file 16 STRING[3] ST16:3 OCTET_STRING[3] String 3 in file 16 T:5 Structure[4] All of timer 5 in file 4 UNSIGNED_16 Control UNSIGNED_16 Preset value UNSIGNED_16 Accumulated value R8:10 Structure[4] All of control 10 in file UNSIGNED_16 8 INTEGER_16 Control INTEGER_16 Length Position [1]Arrays_are_not_supported_for_structures_other_than_ASCII strings. [3]Only Varying length strings are supported. [4]Write operations are not allowed to structures other than to ASCII strings. ___________________________________________________________ Using the DAS for Allen-Bradley Data Highway 3-49 A _________________________________________________________________ I/O Error Messages This appendix contains returned values and associated error messages for the low level I/O routines. allocerror, An error occurred when allocating an OpenVMS port, Explanation: Error. An error occurred when allocating an OpenVMS port. The allocation is done when a connection is initiated with the VMD. User Action: An error message detailing the error should have been logged. Examine the error to determine the proper corrective action. allocstatus, Status for port XX returned from SYS$ALLOC, XX, Explanation: Error. An error occurred when allocating a port. User Action: Examine the error message to determine the cause of the error and take appropriate action based on the error message. assignerror, An error occurred when assigning a channel to an OpenVMS port, Explanation: Error. An error occurred when assigning a channel to an OpenVMS port. The assignment is done when a connection is initiated with the VMD. User Action: An error message detailing the error should have been logged. Examine the error to determine the proper corrective action. assignstatus, Status for port XX returned from SYS$ASSIGN, XX, Explanation: Error. An error occurred when assigning a channel. User Action: Examine the error message to determine the cause of the error and take appropriate action based on the error message. I/O Error Messages A-1 I/O Error Messages connecterror, Error connecting to Internet address, Explanation: Error. An error occurred when attempting to connect to an Internet address. User Action: Examine the log file (BASEstar Open) or stderr to determine the error that occurred. Then take corrective action based on the error that was found. dataoverrun, Data overrun occurred on the line, Explanation: Error. A data overrun occurred on the line. User Action: Use a slower baud rate or switch to a port that has faster hardware. dont, TELNET server refused to allow TELNET option, Explanation: Error. The TELNET server responded with "DON'T" to a request, "WILL", for the requested TELNET option. User Action: Enable the apropriate option on the TELNET server or substitute a server that supports requested option. dontdobin, TELNET server refused to allow binary data reception, Explanation: Error. The TELNET server responded with "DON'T" to a request, "WILL", for the host to send binary data (TELNET option RFC 856). User Action: Enable binary mode transmission on the TELNET server or substitute a server that supports binary mode transmission/reception. econnrefused, The attempt to connect was rejected for port XX, Explanation: Error. An attempt to connect resulted was rejected by the remote server. User Action: If using TELNET, check the terminal server to ensure that the listener port has been properly configured and enabled. ehostunreach, No route to host is present for port XX, Explanation: Error. An attempt to connect to a TELNET port resulted in an unreachable status being returned. User Action: Make sure that the IP address and port number are properly defined and that a gateway is defined on the host. A-2 I/O Error Messages I/O Error Messages enetunreach, No route to the network or host is present for port XX, Explanation: Error. An attempt to connect to a TELNET port resulted in an unreachable status being returned. User Action: Make sure that the IP address and port number are properly defined and that a gateway is defined on the host. etimedout, Connection timed out for port XX, Explanation: Error. An attempt to connect to a port or socket timed out. User Action: If using LAT, make sure that the port is defined in the LAT Control Program and that noone else is using the port. Then attempt to reconnect to the port. If using TELNET, make sure that the IP address and port number are defined properly on the terminal server and that the listener port is enabled. Also ensure that a gateway is defined if the host and the terminal server are not on the same subnet. getdvistatus, Status for port XX returned from SYS$GETDVI, XX, Explanation: Error. An error occurred when getting device information. User Action: Examine the error message and the port definition to determine the cause of the error and take appropriate action based on the error message. inaddrerror, Error when converting an Internet address to binary form, Explanation: Error. An error occurred when convertng an Internet address User Action: Examine the Internet address to determine the error and then correct the Internet address. I/O Error Messages A-3 I/O Error Messages invalidport, An invalid port definition was specified, Explanation: Error. A port definition that was defined in ODS is not valid. Either the port is not a valid TT type device or device characteristics could not be obtained for the port. User Action: Examine the log file (BASEstar) or stderr to determine the error status and the function which detected the error. Take action based on the error message. invalidspeed, An invalid baud rate was specified, Explanation: Error. A baud rate that was defined in ODS is not valid. User Action: Check the documentation to determine valid baud rates for the hardware platform being used. Then modify the baud rate in ODS to a valid value. latcode, Status for port XX returned from SYS$QIOW (IO$_TTY_ PORT | IO$M_LT_CONNECT) = X, Explanation: Error. An error occurred when connecting to a LAT port. User Action: Examine the error code to determine the cause of the error and take appropriate action based on the error code. laterror, An error occurred when connecting to a LAT port, Explanation: Error. An error occurred when connecting to a LAT port. The connection is done when a connection is initiated with the VMD. User Action: An error message detailing the error should have been logged. Examine the error to determine the proper corrective action. latmodeminv, Invalid attempt to enable modem signals on a LAT port, Explanation: Error. LAT ports do not support setting of the "modem" ODS parameter to "TRUE". User Action: Change the port to a non-LAT port or change the "modem" parameter to "FALSE", "0" or "OFF". A-4 I/O Error Messages I/O Error Messages latstatus, Status for port XX returned from SYS$QIOW (IO$_TTY_ PORT | IO$M_LT_CONNECT), XX, Explanation: Error. An error occurred when connecting to a LAT port. User Action: Examine the error message to determine the cause of the error and take appropriate action based on the error message. negfailed, TELNET option negotiation failed, Explanation: Error. An I/O error occurred when attempting to negotiate TELNET options. User Action: Examine the log file (BASEstar Open) or stderr to determine the cause of the error and then take corrective action based on the error found. noalttypeahead, "/ALTYPEAHD" must be specified for the given port, Explanation: Error. The DAS requires that /ALTYPEAHD be specified for the port that is being used to communicate to the device. ALTYPEAHD helps to ensure that characters transmitted by the device are not lost when the host is busy. User Action: Use DCL to "SET TERM/PERM/ALTYPEAHD port_name" on the port being used to communicate to the device(s). nolicense, No software license, Explanation: Error. The DAS requires a software license. User Action: Install the license PAK for the DAS. parity, Parity error, Explanation: Error. A parity error occurred on the port. User Action: Check parity of the device and make sure it matches of the host. (LAT and TELNET parity is set in the terminal server.) If parity is set correctly, then verify that all cabling is grounded and terminated properly. I/O Error Messages A-5 I/O Error Messages portsyncerror, Unable to change file descriptor to blocking, Explanation: Error. An error occurred when using ioctl() to place a file descriptor in blocking mode. User Action: Examine the log file (BASEstar Open) or stderr to determine the error and then take corrective action based on the error found. portsyncstatus, Unable to change file descriptor to blocking for port XX, errno = X, Explanation: Error. An error occurred when using ioctl() to place a file descriptor in blocking mode. User Action: Look up the error and then take corrective action based on the error found. portsyntax, Improper syntax for intenet address, Explanation: Error. There is an error in the syntax of the port address. User Action: Check the syntax of the address and correct it to be a well formed internet address. recverror, Read (recv) error occurred on the port, Explanation: Error. An error was found when reading from the port. Examine the log file (BASEstar Open) or stderr to determine the errno returned by the read. User Action: Examine the log file (BASEstar Open) or stderr to determine the errno returned by the recv call. Then take action based on the error found. recvstatus, Read (recv) error on port XX, errno = X, Explanation: Error. An error was found when reading from the port. The error number for the error is given in the message. User Action: Look up the error and take action based on the error found. socketerror, Error in obtaining a socket for port, Explanation: Error. An error was found when issuing a 'socket' call to obtain a socket for a TCP/IP connection. User Action: Examine the log file (BASEstar Open) or stderr to determine the errno returned by the socket call. Then take action based on the error found. A-6 I/O Error Messages I/O Error Messages socketstatus, Error in obtaining a socket for port XX, errno = X, Explanation: Error. An error was found when issuing a 'socket' call to obtain a socket for a TCP/IP connection. User Action: Look up the error and take action based on the error found. telnetiac, TELNET command XX received on port XX, Explanation: Error. A TELNET command was received when in binary mode. In binary mode no TELNET commands are expected. User Action: No user action should be necessary. The DAS will abort the connection and reset binary mode when it reconnects. ttbreakerror, An error occurred when sending a break to a port, Explanation: Error. An error was returned when sending a break to the port. User Action: Examine the log file (BASEstar Open) or stderr to determine the error that occurred. Then take action based on the error found. ttcharerror, An error occurred when defining TT characteristics, Explanation: Error. An error occurred when setting up TT characteristics. The TT characteristics are set when a connection is initiated with the VMD. User Action: An error message detailing the error should have been logged. Examine the error to determine the proper corrective action. ucxseterror, Error returned from SYS$QIO - IO$_SETMODE, Explanation: Error. An error occurred when attempting to set the socket address. This UCX call is equivalent to the C Socket socket (). User Action: Examine the log file (BASEstar Open) or stderr to determine the error that occurred. Then take corrective action based on the error that was found. I/O Error Messages A-7 I/O Error Messages ucxsetstatus, Status for port XX returned from SYS$QIO - IO$_ SETMODE, XX, Explanation: Error. An error occurred when attempting to set the socket address. This UCX call is equivalent to the C Socket socket (). User Action: Examine the error status and look up the error to determine the cause and corrective action to take. unexpectiac, An unexpected "IAC" was received while in TELNET binary mode, Explanation: Error. An "IAC" (Is A command) character was received after a TELNET line was negotiated to transmit and receive in binary mode. In binary mode, the only expected TELNET control command is the IAC character itself. User Action: No action should be necessary. The DAS will abort the connection if this should occur and then attempt to renegotiate binary transmission/reception when reconnecting. vmsconnectstatus, Status for port XX returned from SYS$QIO - IO$_ACCESS, XX, Explanation: Error. An error occurred when attempting to connect to an Internet address. This UCX call is equivalent to the C connect (). User Action: Look up the error status to determine the error that occurred. Then take corrective action based on the error that was found. vmsreaderror, QIO read error on port, Explanation: Error. An error was found when reading from an OpenVMS port. Examine the log file (BASEstar Open) or stderr to determine the status returned by the read. User Action: Look up the error and take action based on the error found. vmsreadstatus, QIO read error on port XX, XX, Explanation: Error. An error occurred when reading data from an OpenVMS port. User Action: Examine the error message and take corrective action based on the error message. A-8 I/O Error Messages I/O Error Messages vmsrecverror, Error returned from SYS$QIO - IO$_READVBLK, Explanation: Error. An error was found when reading from the port. This UCX call is equivalent to the C Socket recv (). User Action: Examine the log file (BASEstar Open) or stderr to determine the error that occurred. Then take action based on the error found. vmsrecvstatus, Status for port XX:X returned from SYS$QIO - IO$_READVBLK, XX, Explanation: Error. An error was found when reading from the port. This UCX call is equivalent to the C Socket recv (). User Action: Look up the error status to determine the error that occurred. Then take corrective action based on the error that was found. vmsttbreakstatus, Status for port XX returned from SYS$QIO - IO$_SETMODE, XX, Explanation: Error. An error was returned when sending a break to the port. User Action: Look up the error status to determine the error that occurred. Then take corrective action based on the error that was found. vmsttcharstatus, Status for port XX returned from SYS$QIOW (IO$_SETMODE), XX, Explanation: Error. An error occurred when setting port characteristics. User Action: Look up the error number to determine the cause of the error and take appropriate action based on the error code. wont, TELNET server refused to accept TELNET option, Explanation: Error. The TELNET server responded with "WON'T" to a request, "DO", for the requested TELNET option. User Action: Enable the apropriate option on the TELNET server or substitute a server that supports the requested option. I/O Error Messages A-9 I/O Error Messages wontdobin, TELNET server refused to send binary data, Explanation: Error. The TELNET server responded with "WON'T" to a request, "DO", for the server to send binary data (TELNET option RFC 856). User Action: Enable binary mode transmission on the TELNET server or substitute a server that supports binary mode transmission/reception. wrongdevice, An invalid device type was detected for a port, Explanation: Error. A device type other than a terminal was detected for the indicated port. User Action: Modify the ODS port definition to use a valid TT type device. A-10 I/O Error Messages B _________________________________________________________________ DAS Error Messages This appendix contains returned values and associated error messages specific to the DAS for Allen-Bradley Data Highway. aborting, The connection to the device is being aborted, Explanation: Error. The connection to the device is being aborted by an error or by user request. No more requests will be processed by the DAS until the connection is restored. User Action: If the abort was caused by a device error, take action based on the error that occurred. If the abort was a result of a user request. Reconnect to the device before attempting further operations. addresstoolong, Variable address string too long, Explanation: Error. A variable address that is being defined is too long. An address must be 30 characters of less in length. User Action: Redefine the variable using a shorter address. apptypeunsupp, The given application type is not supported for this DAS, Explanation: Error. The application type that was specified in the variable definition is not supported by this DAS. User Action: Change the application type to a valid type for this DAS. DAS Error Messages B-1 DAS Error Messages badaddress, PLC XX sent data for address XX, but this address does not exist on the host, Explanation: Error. A variable was received from a PLC and the address did not match any variables defined on the host. User Action: Define a variable with the correct address on the host or change the address of the variable being sent from the PLC. badbcdvalue, Bad BCD value, Explanation: Error. A request was made to convert from or to a BCD number and the number was not a valid BCD value. User Action: Modify the value to be converted into a valid BCD number. badmodel, The given PLC model is not supported, Explanation: Error. The model number that was specified in the device definition is not supported by this DAS. User Action: Change the model number to one that is supported by this DAS. datatoolarge, Application data too large for the data size of the variable, Explanation: Error. The actual size of a string variable being sent to a device is larger than that defined by the variable definition. An actual size that is smaller than the variable definition is allowed but not one that is larger. User Action: Define a variable with the correct size as the data being sent or change the size of the data being sent by the application. datatoosmall, PLC data too small for the data size of the variable, Explanation: Error. A variable was received from a PLC and the address matched a host variable, but the size of the data defined for the variable is larger than the size of the data actually received. User Action: Define a variable with the correct size as the data being sent or change the size of the data being sent by the PLC. B-2 DAS Error Messages DAS Error Messages datatrunc, PLC data from XX too large for variable XX, Explanation: Error. A variable was received from a PLC and the address matched a host variable, but the size of the data defined for the variable is smaller than the size of the data actually received. The data returned is truncated to fit into the variable. User Action: Define a variable with the correct size as the data being sent or change the size of the data being sent by the PLC. duptrans, Duplicate transaction received on line XX, transaction number = !UW, Explanation: Warning. A duplicate transaction number was received on the data highway line. In most cases this is probably caused by too long a delay in responding to a message sent by the KE/KF card to the host. The duplicate message is discarded by the host. User Action: Increase the KE/KF card timeout value by modifying the KE_TIMEOUT line attribute in ODS. exterrsts, PLC XX sent extended status error = X'XX', Explanation: Error. An Allen-Bradley extended status error occurred. User Action: Consult the Allen-Bradley PLC communications manual to determine the cause of the error and take appropriate action based on the error code. extsts06, Ext Sts X06 - address doesn't point to something usable, Explanation: Error. An attempt was made to read or write to a PLC address that isn't a valid PLC data table address for this PLC. User Action: Define a variable with an address that matches actual PLC memory or reconfigure the PLC memory to include the requested address. DAS Error Messages B-3 DAS Error Messages extsts07, Ext Sts X07 - file is wrong size, Explanation: Error. An attempt was made to write to a PLC address that is beyond the end of a PLC data table address. User Action: Define a variable with an address that matches actual PLC memory or reconfigure the PLC memory to include the requested address. extsts0A, Ext Sts X0A - transaction size plus word address is too large, Explanation: Error. An attempt was made to read from a PLC address that is beyond the end of a PLC data table address. User Action: Define a variable with an address and size that matches actual PLC memory or reconfigure the PLC memory to include the requested address. extsts11, Ext Sts X11 - illegal data type, Explanation: Error. An attempt was made to read from a PLC address that does not exist in the PLC or that is not valid for the table being accessed. User Action: Define a variable with an address that matches the actual PLC memory or reconfigure the PLC memory to include the requested address. extsts12, Ext Sts X12 - invalid parameter or invalid data, Explanation: Error. An invalid command or data was sent to the PLC. User Action: Submit an SPR describing the circumstances that caused the error. extstserr, PLC extended status error, Explanation: Error. An Allen-Bradley extended status error occurred. User Action: Use a data scope to capture the error code and take appropriate action based on the error code. internalerror, Internal error, Explanation: Error. An internal error occurred in the DAS. User Action: Submit an SPR describing the circumstances that caused the error. B-4 DAS Error Messages DAS Error Messages invaddresstype, Invalid address type, Explanation: Error. A variable that is being defined is defined as an illegal address type. Only unconstrained address types are allowed. User Action: Redefine the variable using the unconstrained address type. invalidaddress, The specified PLC address is not supported by this DAS, Explanation: Error. An address was sent by a PLC but the address is not supported by this DAS. User Action: Reprogram the PLC and specify a valid address for this DAS. Consult the DAS documentation to determine a valid address. invalidbitwrite, Bit writes cannot span more than one element, Explanation: Error. An attempt was made to do a bit write that spanned more than one element. The DAS supports writes to only one element at a time. User Action: Change the starting bit or change the number of bits that are being written so that the write spans only one element. invalidcommand, Invalid command code received in a message from the PLC, Explanation: Error. A message was received from the PLC, but the command code used by the PLC in the write command is not supported by the DAS. User Action: Reprogram the PLC to send the correct command code. invalidenqretries, Invalid ENQ retries number in the DH_LINE ODS entry, Explanation: Error. The ENQ retries attribute must be between 0-20. User Action: Use ODS to enter an ENQ retries number between 0-20. DAS Error Messages B-5 DAS Error Messages invalidfunction, Invalid function code received in a message from the PLC, Explanation: Error. A message was sent from the PLC, but the function code used by the PLC in the write command is not supported by the DAS. User Action: Reprogram the PLC to send the correct function code. invalidgroup, Variables in a group must all belong to the same file, Explanation: Error. A group read was attempted without all the variables in the group belonging to the same file type and file number or a subelement of a structure file was included in the group. User Action: Examine the members of the group to determine which variable does not belong, remove that variable from the list and retry the group read. invalidgroupmem, Variable XX in a group read for device XX does not belong, Explanation: Error. A group read was attempted without all the variables in the group belonging to the same file type and file number. User Action: Remove the incorrect variable from the list and retry the group read. invalidipaddress, Invalid IP_ADDRESS ODS attribute for the given line, Explanation: Error. The IP_ADDRESS must be less than 50 characters in length. User Action: Enter an IP address that is 50 characters or less in length. invalidkestation, Invalid KE station number in the DH_LINE ODS entry, Explanation: Error. AB station numbers must be an octal number between 0-377. User Action: Use ODS to enter a station number between 0-377 octal. B-6 DAS Error Messages DAS Error Messages invalidmodem, Invalid modem attribute specified in the DH_LINE ODS entry, Explanation: Error. The modem attribute must be one of TRUE, ON, YES, 1 or FALSE, OFF, NO, 0. User Action: Use ODS to enter a valid modem attribute. invalidnakretries, Invalid NAK retries number in the DH_LINE ODS entry, Explanation: Error. The NAK retries attribute must be between 0-20. User Action: Use ODS to enter a NAK retries number between 0-20. invalidparity, Invalid parity specified in the DH_LINE ODS entry, Explanation: Error. The parity defined must be either EVEN or NONE. User Action: Use ODS to enter a valid parity (EVEN, NONE). invalidport, Invalid port name specified in the DH_LINE ODS entry, Explanation: Error. Port names must be 10 characters or less. User Action: Use ODS to enter a port name that is less than 10 characters. invalidportnum, Invalid PORT_NUMBER ODS attribute for the given line, Explanation: Error. The PORT_NUMBER must be less than 10 characters in length. User Action: Enter a PORT_NUMBER address that is 10 characters or less in length. invalidspeed, Invalid speed (baud rate) specified in the DH_ LINE ODS entry, Explanation: Error. Baud rates from 110 to 19200 are supported for the AB DAS. User Action: Use ODS to enter a speed from 110 to 19200. DAS Error Messages B-7 DAS Error Messages invalidstation, Invalid station number in the DH_PATH ODS entry, Explanation: Error. AB station numbers must be an octal number between 0-377. User Action: Use ODS to enter a station number between 0-377 octal. invalidstructread, Variables in a group must read the entire structure, Explanation: Error. A group read was attempted without all the variables in the group reading a complete structure element. For example, a timer element is being read, and an accumulator subelement was specified in the address. User Action: Examine the variables in the group and specify an address for the entire structure for all members of the group. invalidtimeout, Invalid timeout value in the DH_LINE ODS entry, Explanation: Error. An invalid timeout value was entered for the timeout value in ODS. Timeouts must be between 2 and 6 seconds. User Action: Use ODS to enter a timeout value between 2-6. invalidtrace, Invalid trace attribute specified in the DH_LINE or DH_PATH ODS entry, Explanation: Error. The trace attribute must be one of TRUE, ON, YES, 1 or FALSE, OFF, NO, 0. User Action: Use ODS to enter a valid trace attribute. linenoise, Noise encountered on data highway communications line XX, Explanation: Error. An unexpected character was received on the data highway communications line. The DAS ignores the character received. User Action: Check all cabling to make sure that it is properly shielded, grounded and seated. B-8 DAS Error Messages DAS Error Messages locerrsts, PLC XX sent local status error = X'XX', Explanation: Error. An Allen-Bradley local status error occurred. User Action: Consult the Allen-Bradley PLC communications manual to determine the cause of the error and take appropriate action based on the error code. locsts02, Loc Sts X02 - link layer timed out or received a NAK, Explanation: Error. A local error occurred when communicating with the KE/KF card. User Action: Check cabling to ensure there are no shorts or breaks. Check/replace KE/KF card. locstserr, PLC local status error, Explanation: Error. An Allen-Bradley local status error occurred. User Action: Use a data scope to capture the error code and take appropriate action based on the error code. mmsaddrtypeunsupp, The given MMS type is unsupported for the given address, Explanation: Error. The MMS type is not supported for the variable address given. User Action: Modify the MMS type to one supported for the given address or modify the address to one supported for the MMS type. mmstypeunsupp, The given MMS type is not supported for this DAS, Explanation: Error. The MMS type that was specified in the variable definition is not supported by by this DAS. User Action: Change the MMS type to a valid type for this DAS. DAS Error Messages B-9 DAS Error Messages msgtooshort, A message received from the PLC was too short, Explanation: Error. A message was received from the PLC, but the message couldn't be decoded because it didn't contain enough data. This error is most likely caused by improper programming of the PLC or by communication errors. User Action: Check the PLC program for errors and check that all communications plugs are properly seated and all communications cabling is not shorted, not broken and is properly terminated and shielded. nak, Bad checksum - NAK sent on line XX, transaction number = !UW, Explanation: Warning. A bad checksum was detected, so a NAK was sent in response to the message. A bad checksum is most likely the result of noisy communications. User Action: If NAK messages persist, then check shielding, length of cabling or other factors that may result in a noisy communications signal. Correct any problems that are found. neterr, AB Data Highway Network error occurred, Explanation: Error. A network error on the Allen-Bradley Data Highway occurred. User Action: Examine the network status in the returned IOSB to determine the specific network error that occurred and take action based on that error. noenqretries, No "ENQ_RETRIES" ODS entry for the given line, Explanation: Error. The AB DAS requires an ENQ_RETRIES attribute defined in ODS. The ENQ_RETRIES attribute is defined for the DH_LINE object class within ODS. User Action: Use the DH_LINE object class within ODS to define the ENQ_RETRIES attribute for this line. Use a valid number when defining the ENQ_RETRIES attribute. B-10 DAS Error Messages DAS Error Messages noipaddress, No "IP_ADDRESS" ODS entry for the given line, Explanation: Error. The AB DAS requires an IP_ADDRESS attribute defined in ODS. The IP_ADDRESS attribute is defined for the DH_TELNET class within ODS. User Action: Use the DH_TELNET object class within ODS to define the IP_ADDRESS attribute for this line. Use a valid IP address for this attribute. nokestation, No "KE_STATION" ODS entry for the given line, Explanation: Error. The AB DAS requires a KE_STATION attribute defined in ODS. The KE_STATION attribute is defined for the DH_LINE object class within ODS. User Action: Use the DH_LINE object class within ODS to define the KE_STATION attribute for this line. Use a valid number when defining the KE_STATION attribute. noketimeout, No "KE_TIMEOUT" ODS entry for the given line, Explanation: Error. The AB DAS requires a KE_TIMEOUT attribute defined in ODS. The KE_TIMEOUT attribute is defined for the DH_LINE object class within ODS. User Action: Use the DH_LINE object class within ODS to define the KE_TIMEOUT attribute for this line. Use a valid number when defining the KE_TIMEOUT attribute. nolicense, No software license, Explanation: Error. The AB DAS requires a software license. User Action: Install the license PAK for the AB DAS. noline, No "/LINE=" ODS entry for the given application simple name, Explanation: Error. The AB DAS requires a /LINE= attribute defined for the ODS entry corresponding to the application simple name entry for the VMD. The /LINE= attribute is defined for DH_PATH object class within ODS. User Action: Use the DH_PATH object class within ODS to define the application simple name for this VMD. Use a valid line name when defining the /LINE= attribute. DAS Error Messages B-11 DAS Error Messages nomodem, No "MODEM" ODS entry for the given line, Explanation: Error. The AB DAS requires a MODEM attribute defined in ODS. The MODEM attribute is defined for the DH_ LINE object class within ODS. User Action: Use the DH_LINE object class within ODS to define the MODEM attribute for this line. Modem control is either enabled (TRUE, ON, YES, 1) or disabled (FALSE, OFF, NO, 0). nonakretries, No "NAK_RETRIES" ODS entry for the given line, Explanation: Error. The AB DAS requires a NAK_RETRIES attribute defined in ODS. The NAK_RETRIES attribute is defined for the DH_LINE object class within ODS. User Action: Use the DH_LINE object class within ODS to define the NAK_RETRIES attribute for this line. Use a valid number when defining the NAK_RETRIES attribute. noparity, No "PARITY" ODS entry for the given line, Explanation: Error. The AB DAS requires a PARITY attribute defined in ODS. The PARITY attribute is defined for the DH_ LINE object class within ODS. User Action: Use the DH_LINE object class within ODS to define the PARITY attribute for this line. Use a valid parity (EVEN, NONE) when defining the PARITY attribute. noport, No "PORT" ODS entry for the given line, Explanation: Error. The AB DAS requires a PORT attribute defined in ODS. The PORT attribute is defined for the DH_ LINE object class within ODS. User Action: Use the DH_LINE object class within ODS to define the PORT attribute for this line. Use a valid port name when defining the PORT attribute. noportnumber, No "PORT_NUMBER" ODS entry for the given line, Explanation: Error. The AB DAS requires a PORT_NUMBER attribute defined in ODS. The PORT_NUMBER attribute is defined for the DH_TELNET class within ODS. User Action: Use the DH_TELNET object class within ODS to define the PORT_NUMBER attribute for this line. Use a valid IP port number for this attribute. B-12 DAS Error Messages DAS Error Messages noresponse, No response from the PLC within the timeout period, Explanation: Error. A message was sent to the PLC and was acknowledged, but no confirmation message was received by the host in the required timeframe. User Action: Ensure that the timeout value in the line parameters is large enough based on the data highway network load. nospeed, No "SPEED" ODS entry for the given line, Explanation: Error. The AB DAS requires a SPEED attribute defined in ODS. The SPEED attribute is defined for the DH_ LINE object class within ODS. User Action: Use the DH_LINE object class within ODS to define the SPEED attribute for this line. Use a valid baud rate when defining the SPEED attribute. nostation, No "STATION" ODS entry for the given application simple name, Explanation: Error. The AB DAS requires a STATION attribute defined for the ODS entry corresponding to the application simple name entry for the VMD. The STATION attribute is defined for DH_PATH object class within ODS. User Action: Use the DH_PATH object class within ODS to define the application simple name for this VMD. Use a valid data highway station number when defining the STATION attribute. notimeout, No "TIMEOUT" ODS entry for the given line, Explanation: Error. The AB DAS requires a TIMEOUT attribute defined in ODS. The TIMEOUT attribute is defined for the DH_ LINE object class within ODS. User Action: Use the DH_LINE object class within ODS to define the TIMEOUT attribute for this line. Use a valid number when defining the TIMEOUT attribute. DAS Error Messages B-13 DAS Error Messages notrace, No "TRACE" ODS entry, Explanation: Error. The AB DAS requires a TRACE attribute defined in ODS. The TRACE attribute is defined for the DH_ PATH object class and for the DH_LINE object class within ODS. User Action: Use the DH_LINE and DH_PATH object classes within ODS to define the TRACE attribute for this line. Trace is either enabled (TRUE, ON, YES, 1) or disabled (FALSE, OFF, NO, 0). parsefailed, The parsing of an ASCII address failed, Explanation: Error. When defining a variable, the parsing of the ASCII address failed. Either the syntax or the value of a portion of the address is incorrect. User Action: Consult the user documentation to determine a valid address for the variable being defined and redefine the variable using the correct syntax. rcvthreaddied, Receiver thread died for line XX, status = X, Explanation: Error. Receiver thread exited with an error. User Action: Take action based on the error code. rcvthreadexcep, Receiver thread for line XX caught an exception, status = X, Explanation: Error. Receiver thread caught an exception. The exception that was caught is in this message. User Action: Examine the exception that was caught and take action based on the error code. remerrsts, PLC XX sent remote status error = X'XX', Explanation: Error. An Allen-Bradley remote status error occurred. User Action: Consult the Allen-Bradley PLC communications manual to determine the cause of the error and take appropriate action based on the error code. B-14 DAS Error Messages DAS Error Messages remsts60, Rem Sts X60 - function disallowed due to command protection selection, Explanation: Error. The PLC is in the wrong protection mode for the command being attempted. User Action: Change the protection mode to one appropriate for the command. remsts70, Rem Sts X70 - processor is in program mode, Explanation: Error. The PLC is in the wrong processor mode for the command being attempted. User Action: Change the processor mode to one appropriate for the command. remstserr, PLC remote status error, Explanation: Error. An Allen-Bradley remote status error occurred. User Action: Use a data scope to capture the error code and take appropriate action based on the error code. reqpending, Conclude rejected because of a pending read/write request, Explanation: Error. The conclude request was rejected because either a read or a write request was currently pending. User Action: Either abort the connection or wait for the current request(s) to complete before retrying the conclude. retriesexceeded, The NAK retry count was exceeded, Explanation: Error. When trying to communicate to the device, the NAK retry count was exceeded. The NAK retry being exceeded means that the message being sent to the device was garbled during transmission and did not match the checksum. User Action: Check cabling to ensure there are no shorts or breaks. Check/replace KE/KF card. DAS Error Messages B-15 DAS Error Messages retriesexcline, The NAK retry count was exceeded for line XX, Explanation: Error. When trying to communicate to the device, the NAK retry count was exceeded. The NAK retry being exceeded means that the message being sent to the device was garbled during transmission and did not match the checksum. User Action: Check cabling to ensure there are no shorts or breaks. Check/replace KE/KF card. structwriteunsup, Structure writes are not supported, Explanation: Error. Writes to structure variables are not supported. Reads of structure variables are supported, but not writes. User Action: Write only to elements of the structure. timeout, AB Data Highway timeout when reading from the PLC, Explanation: Error. The PLC did not respond when attempting to read a response from the PLC. The response could be part of a read or a write operation. User Action: Check all cabling to make sure that it is properly shielded, grounded and seated. Verify that the communication parameters are set up properly on both PLC and the host. Verify that the correct station address has been selected on the PLC and on the host. timeoutreq, AB Data Highway request timeout on line XX, Explanation: Error. The PLC did not respond when attempting to read a response from the PLC. The response could be part of a read or a write operation. User Action: Check all cabling to make sure that it is properly shielded, grounded and seated. Verify that the communication parameters are set up properly on both PLC and the host. Verify that the correct station address has been selected on the PLC and on the host. B-16 DAS Error Messages DAS Error Messages timeoutresp, AB Data Highway response timeout on line XX, Explanation: Error. The PLC did not respond when attempting to read a response from the PLC. The response was part of a write indication confirmation. User Action: Check all cabling to make sure that it is properly shielded, grounded and seated. Verify that the communication parameters are set up properly on both PLC and the host. Verify that the correct station address has been selected on the PLC and on the host. tmrthreadcancel, Timer thread was cancelled, Explanation: Error. Timer thread was cancelled. User Action: Restart the DEComni application. tmrthreadexcep, Timer thread caught an exception, status = X, Explanation: Error. Timer thread caught an exception. The exception code that was caught is in the message. User Action: Examine the exception that was caught and take action based on the error code. transnotfound, Matching transaction number not found for data highway message on line XX, station XX, Explanation: Error. A response was received from the PLC but there wasn't found a matching request transaction number to the transaction number in the response. User Action: Check all cabling to make sure that it is properly shielded, grounded and seated. transtimedout, No response from VMD XX, transaction number = !UW, Explanation: Error. A message was sent to the PLC and was acknowledged, but no confirmation message was received by the host in the required timeframe. User Action: Ensure that the timeout value in the line parameters is large enough based on the data highway network load. DAS Error Messages B-17 DAS Error Messages unexpcommand, Unexpected command received from PLC XX. Expected command code was X'XX'; received command code was X'XX', Explanation: Error. An unexpected command was received in a message from the PLC. User Action: Reprogram the PLC to send the correct command code. unexpfunction, Unexpected function received from PLC XX. Expected function code was X'XX'; received function code was X'XX', Explanation: Error. An unexpected function code was received in a message from the PLC. User Action: Reprogram the PLC to send the correct function code. variablenotfound, Variable not found with the specified address, Explanation: Error. A variable was received from a PLC and the address did not match any variables defined on the host. User Action: Define a variable with the correct address on the host or change the address of the variable being sent from the PLC. wrongindication, An indication was received from an unknown PLC - line XX, station XX, Explanation: Error. An indication was received from a PLC station address, but the station is not known by the DAS. User Action: Create a VMD with the station address of the PLC sending data to the DAS, or reprogram the PLC that is sending the data so that it is no longer sends data to the DAS. B-18 DAS Error Messages _________________________________________________________________ Index A Device access software _______________________________ accessing functions, 3-1 Abort function, 3-2 address syntax, 3-7 Abort indication, 3-5 description of, 1-1 Accessing DAS functions, 3-1 functions, 1-2 Address syntax, 3-7 installation of, 2-1 PLC-2, 3-7 installation requirements, PLC-3, 3-8 2-1 PLC-5, 3-15 overview, 1-1 PLC-5/250, 3-27 supported client functions, SLC, 3-43 3-2 supported data types, 3-7 C______________________________ supported devices, 1-2 Conclude function, 3-2 supported functions, 1-2, Configuration 3-1 editing configuration files, supported server functions, 2-10 3-2 ODS registrations, 2-10 using, 3-1 Configuration files, 2-14 Device communications Configuring ports, 2-16 cabling, 2-1 Configuring TELNET, 2-17 overview, 1-1 Connect function, 3-2 tracing, 2-18 Devices D______________________________ PLCs supported, 1-2 DAS E See Device access software _______________________________ Data table addressing Extended addressing PLC-3, 3-8 PLC-3, 3-14 PLC-5, 3-15 SLC, 3-43 Data types, 3-7 Index-1 F______________________________ P______________________________ Files, created during Plant-floor equipment, setting installation, 2-7 up, 2-18 Functions, 3-1 PLC-2 abort, 3-2 address syntax, 3-7 conclude, 3-2 supported data types, 3-7 connect, 3-2 PLC-3 read variable, 3-3 address syntax, 3-8 supported, 3-1 data table addressing, 3-8 write variable, 3-3 extended addressing, 3-14 supported data types, 3-8 I______________________________ PLC-3 data table address Indications ASCII, 3-12 abort, 3-5 binary, 3-12 write, 3-5 counter, 3-10 Installation, 2-1 decimal, 3-12 files created, 2-7 floating-point, 3-12 messages, 2-7 high-order integer, 3-12 procedure, 2-4 I/O, 3-9 Installation requirements, 2-1 integer, 3-12 disk space, 2-4 pointer, 3-13 hardware, 2-1 status, 3-12 software, 2-3 timer, 3-10 PLC-5 L address syntax, 3-15 _______________________________ data table addressing, 3-15 LAT, 2-16 supported data types, 3-15 PLC-5/250 M______________________________ address syntax, 3-27 Messages supported data types, 3-27 DAS error and return values, supported modules, 3-27 B-1 PLC-5/250 address format I/O error and return values, adapter status, 3-40 A-1 ASCII string, 3-31 installation, 2-7 binary, 3-29 MMS data type, 3-7 block-transfer, 3-38 block-transfer read/write O control, 3-39 _______________________________ control, 3-31 ODS registrations, 2-10 counter, 3-31 floating-point, 3-29 I/O, 3-37 integer, 3-29 internal storage, 3-42 Index-2 PLC-5/250 address format SLC data table address (cont'd) (cont'd) long integer, 3-29 integer, 3-45 message control, 3-31 status, 3-45 PID control, 3-31 timer, 3-48 shared data, 3-42 Supported data types, 3-7 status, 3-36 PLC-2, 3-7 timer, 3-31 PLC-3, 3-8 PLC-5 data table address PLC-5, 3-15 ASCII, 3-18 PLC-5/250, 3-27 ASCII string, 3-21 SLC, 3-43 binary, 3-18 block-transfer control, 3-21 T______________________________ control, 3-21 TELNET, 2-17 counter, 3-21 binary transfer, 2-17 decimal, 3-18 Trace floating-point, 3-18 ODS configuration, 2-10 I/O, 3-16 using, 2-18 integer, 3-18 message control, 3-21 W PID control, 3-21 _______________________________ SFC status, 3-21 Write indication, 3-5 status, 3-17 Write variable function, 3-3 timer, 3-21 token data, 3-21 Postinstallation tasks, 2-10 Problem reporting, 2-19 Product failure, 2-19 R______________________________ Read variable function, 3-3 S______________________________ SLC address syntax, 3-43 data table addressing, 3-43 supported data types, 3-43 SLC data table address ASCII, 3-45 ASCII string, 3-48 binary, 3-45 control, 3-48 counter, 3-48 floating-point, 3-45 I/O, 3-44 Index-3