Digital Device Access Software for Allen-Bradley with DEComni[TM] on_OpenVMS__________________________________________ Installation and User's Guide Order Number: AA-Q5FZB-TE August 1996 This manual describes how to install and use the Digital Device Access Software for Allen-Bradley PLCs 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.0 Software Version: Device Access Software for Allen-Bradley, Version 3.0 Digital Equipment Corporation Maynard, Massachusetts ________________________________________________________________ August 1996 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, 1996. 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, and PLC-3 are registered trademarks of Allen- Bradley Company Inc. PLC-5, 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 2.3. _________________________________________________________________ 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 PLCs 2.1 Installation Requirements..................... 2-1 2.1.1 Hardware.................................. 2-1 2.1.2 Software.................................. 2-2 2.1.3 Disk Space................................ 2-2 2.2 Installing the DAS for Allen-Bradley PLCs..... 2-3 2.2.1 Files Created During Installation......... 2-6 2.2.2 Installation Messages..................... 2-6 2.3 Postinstallation Tasks........................ 2-9 2.3.1 Editing the Configuration Files........... 2-9 2.3.1.1 Editing ODS Registrations............... 2-9 2.3.1.2 DAS for Allen-Bradley PLCs Configuration Files................................... 2-13 2.3.2 Configuring Ports......................... 2-14 2.3.3 Setting Up Plant-Floor Equipment.......... 2-15 2.4 Tracing device communications................. 2-16 2.5 Failures During Product Use................... 2-17 iii 3 Using the DAS for Allen-Bradley PLCs 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-2 3.2.3 Information Report and Abort Indications............................... 3-4 3.3 Addressing Syntax and Supported Data Types.... 3-5 3.3.1 PLC-2 Addressing Syntax and Supported Data Types..................................... 3-5 3.3.2 PLC-3 Addressing Syntax and Supported Data Types..................................... 3-6 3.3.2.1 PLC-3 Data Table Addressing............. 3-7 3.3.2.2 PLC-3 Extended Addressing............... 3-12 3.3.3 PLC-5 Addressing Syntax and Supported Data Types..................................... 3-13 3.3.4 PLC-5/250 Addressing Syntax and Supported Data Types................................ 3-25 A Error Messages Index Examples 2-1 ODS Registration.......................... 2-10 2-2 DAS for Allen-Bradley PLCs ODS Configuration File........................ 2-13 Figures 1-1 DAS Communications........................ 1-2 2-1 Allen-Bradley Device Connector Layout..... 2-2 3-1 General PLC-2 Address Format.............. 3-6 3-2 PLC-3 I/O Data Table Address Format....... 3-7 3-3 PLC-3 Timer and Counter Data Table Address Format.................................... 3-8 3-4 PLC-3 Timer Structure..................... 3-9 3-5 PLC-3 Counter Structure................... 3-9 iv 3-6 PLC-3 ASCII, Binary, Decimal, Floating-Point, High-Order Integer, Integer and Status Data Table Address Format.................................... 3-10 3-7 PLC-3 Pointer Data Table Address Format... 3-12 3-8 PLC-3 Pointer Structure................... 3-12 3-9 PLC-3 Extended Address Format............. 3-13 3-10 PLC-5 I/O Data Table Address Format....... 3-14 3-11 PLC-5 Status Data Table Address Format.... 3-15 3-12 PLC-5 ASCII, Binary, Decimal, Floating-Point and Integer Data Table Address Format............................ 3-16 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-18 3-14 PLC-5 Timer Structure..................... 3-18 3-15 PLC-5 Counter Structure................... 3-18 3-16 PLC-5 Control Structure................... 3-19 3-17 PLC-5 SFC Status Structure................ 3-19 3-18 PLC-5 Block-Transfer Control Structure.... 3-19 3-19 PLC-5 Token Data Structure................ 3-19 3-20 PLC-5 ASCII String Structure.............. 3-20 3-21 PLC-5 PID Control Structure............... 3-20 3-22 PLC-5 Message Control Structure........... 3-20 3-23 PLC-5/250 Binary, Floating-Point, Long Integer and Integer Address Format........ 3-26 3-24 PLC-5/250 Timer, Counter, Control, ASCII String, PID Control and Message Control Address Format............................ 3-28 3-25 PLC-5/250 Timer Structure................. 3-28 3-26 PLC-5/250 Counter Structure............... 3-28 3-27 PLC-5/250 Control Structure............... 3-28 3-28 PLC-5/250 ASCII String Structure.......... 3-29 3-29 PLC-5/250 PID Control Structure........... 3-29 3-30 PLC-5/250 Message Control Structure....... 3-29 3-31 PLC-5/250 Status Address Format........... 3-33 3-32 PLC-5/250 I/O Address Format.............. 3-34 v 3-33 PLC-5/250 Block-Transfer Data Address Format.................................... 3-35 3-34 PLC-5/250 Block-Transfer Read/Write Control Address Format.................... 3-36 3-35 PLC-5/250 Block-Transfer Read/Write Control Structure......................... 3-37 3-36 PLC-5/250 Adapter Status Address Format... 3-38 3-37 PLC-5/250 Adapter Status Structure........ 3-38 3-38 PLC-5/250 Internal Storage Address Format.................................... 3-39 3-39 PLC-5/250 Shared Data Address Format...... 3-40 Tables 2-1 Disk Space Requirements................... 2-3 2-2 Files Created for the DAS for Allen-Bradley PLCs........................ 2-6 2-3 REGISTER Attributes....................... 2-11 2-4 KE/KF/KF-2 Switch Settings................ 2-16 3-1 Connect, Conclude and Abort Interface Access.................................... 3-2 3-2 Read and Write Variable Types............. 3-3 3-3 Read and Write Variable Interface Access.................................... 3-3 3-4 Supported PLC Write Functions............. 3-4 3-5 Indication Interface Access............... 3-5 3-6 Example PLC-2 Data Types.................. 3-6 3-7 Example PLC-3 I/O Data Table Addresses.... 3-8 3-8 Example PLC-3 Timer and Counter Data Table Addresses................................. 3-9 3-9 Example PLC-3 ASCII, Binary, Decimal, Floating-Point, High-Order Integer, Integer and Status Data Table Address Format.................................... 3-11 3-10 Example PLC-3 Pointer Data Table Addresses................................. 3-12 3-11 Example PLC-3 Extended Addresses.......... 3-13 3-12 Example PLC-5 I/O Data Table Addresses.... 3-15 vi 3-13 Example PLC-5 Status Data Table Addresses................................. 3-16 3-14 Example PLC-5 ASCII, Binary, Decimal, Floating-Point and Integer Data Table Address Format............................ 3-17 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-20 3-16 Example PLC-5/250 Binary, Floating-Point, Long Integer and Integer Address Format... 3-27 3-17 Example PLC-5/250 Timer, Counter, Control, ASCII String, PID Control and Message Control Address Formats................... 3-29 3-18 Example PLC-5/250 Status Addresses........ 3-34 3-19 Example PLC-5/250 I/O Addresses........... 3-35 3-20 Example PLC-5/250 Block-Transfer Data Addresses................................. 3-36 3-21 Example PLC-5/250 Block-Transfer Read/Write Control Addresses.............. 3-37 3-22 Example PLC-5/250 Adapter Status Addresses................................. 3-39 3-23 Example PLC-5/250 Internal Storage Addresses................................. 3-40 3-24 Example PLC-5/250 Shared Data Addresses... 3-40 vii _________________________________________________________________ Preface This document describes how to install and use the Digital Device Access Software for Allen-Bradley PLCs. Intended Audience This document is intended for system managers who must set up and maintain the following: o DEComni software o Digital Device Access Software for Allen-Bradley PLCs 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 PLCs. o Chapter 2 provides the information you need to install and configure the DAS for Allen-Bradley PLCs. 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 Allen-Bradley 1785 PLC-5 Programmable Controllers Addressing Reference o Allen-Bradley Pyramid Integrator System Addressing Reference Conventions This document uses the following conventions: Boldface Highlights user input within textual descriptions. viii 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 Digital Device Access Software for Allen-Bradley PLCs. It also briefly describes Allen-Bradley PLC communications, and the supported functions for the DAS for Allen-Bradley PLCs. 1.1 Description The DAS for Allen-Bradley PLCs 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 PLCs. Using the DAS for Allen-Bradley PLCs, applications can perform a variety of device access functions for the Allen- Bradley PLCs. 1.2 Device Communications The DAS for Allen-Bradley PLCs 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 PLCs 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 PLCs 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 an information report from a device's memory (omni_get_indications) o Receive an abort from a device (omni_get_indications) The DAS for Allen-Bradley PLCs 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 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 PLCs This chapter provides the information you need to install the DAS for Allen-Bradley PLCs 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 PLCs 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 PLCs 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 PLCs includes: o Any supported Allen-Bradley PLC o Allen-Bradley KE, KF or KF/2 communications card o A cable from the OpenVMS system to the communications card Installing and Configuring the DAS for Allen-Bradley PLCs 2-1 Installing and Configuring the DAS for Allen-Bradley PLCs 2.1 Installation Requirements The cable to the KE or KF communications card must be terminated with a 15 pin male RS232-C connector as shown in Figure 2-1. Figure 2-1 Allen-Bradley Device Connector Layout 2.1.2 Software The following software must be installed prior to installing DAS for Allen-Bradley PLCs: o OpenVMS/Alpha Version 6.1 o OpenVMS/VAX Version 6.1 o DEComni Version 3.0 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. ______________________________________________________ 2.1.3 Disk Space Table 2-1 lists the disk space required to install the DAS for Allen-Bradley PLCs. The space requirements are approximations; actual sizes may vary depending on your system environment and configuration. 2-2 Installing and Configuring the DAS for Allen-Bradley PLCs Installing and Configuring the DAS for Allen-Bradley PLCs 2.1 Installation Requirements 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 PLCs When your system meets all hardware and software requirements, you can install the DAS for Allen-Bradley PLCs. The installation takes from 1 to 5 minutes, depending on your system load and configuration. Install the DAS for Allen-Bradley PLCs 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 ABDVA030 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 030 portion of the name is the version number 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 Installing and Configuring the DAS for Allen-Bradley PLCs 2-3 Installing and Configuring the DAS for Allen-Bradley PLCs 2.2 Installing the DAS for Allen-Bradley PLCs 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 T3.0 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, 1996. 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. Digital Device Access Software for Allen-Bradley 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... Now checking DEComni logicals... Now checking the DEComni integrator registration utility... * Do you want BASEstar Open support [YES]? ? 2-4 Installing and Configuring the DAS for Allen-Bradley PLCs Installing and Configuring the DAS for Allen-Bradley PLCs 2.2 Installing the DAS for Allen-Bradley PLCs 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 Digital Device Access Software for Allen-Bradley with DEComni... %VMSINSTAL-I-MOVEFILES, Files will now be moved to their target directories... Now registering Digital Device Access Software for Allen-Bradley with DEComni... Installing and Configuring the DAS for Allen-Bradley PLCs 2-5 Installing and Configuring the DAS for Allen-Bradley PLCs 2.2 Installing the DAS for Allen-Bradley PLCs Copyright (C) Digital Equipment Corporation 1994, 1996. All rights reserved. Executing the Installation Verification Procedure. Digital Device Access Software for Allen-Bradley installation procedure has succeeded. Installation of ABDVA T3.0 completed at 14:33 Adding history entry in VMI$ROOT:[SYSUPD]VMSINSTAL.HISTORY Creating installation data file: VMI$ROOT:[SYSUPD]ABDVA030.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 PLCs installation procedure, and the directories in which those files are placed. Table_2-2_Files_Created_for_the_DAS_for_Allen-Bradley_PLCs_ 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 PLCs installation: BADOMNI, The version of DEComni required is DEComni V3.0 or later., Explanation: Error. This version of the DAS is designed to work with DEComni V3.0 or later. User Action: Install DEComni V3.0 or later and then reinstall the DAS. 2-6 Installing and Configuring the DAS for Allen-Bradley PLCs Installing and Configuring the DAS for Allen-Bradley PLCs 2.2 Installing the DAS for Allen-Bradley PLCs BADVMS (Alpha), Digital Device Access Software for Allen- Bradley PLCs 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), Digital Device Access Software for Allen-Bradley PLCs 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), Digital Device Access Software for Allen- Bradley PLCs 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), Digital Device Access Software for Allen- Bradley PLCs 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. Installing and Configuring the DAS for Allen-Bradley PLCs 2-7 Installing and Configuring the DAS for Allen-Bradley PLCs 2.2 Installing the DAS for Allen-Bradley PLCs 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 Digital Device Access Software for Allen-Bradley PLCs., 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.0 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. 2-8 Installing and Configuring the DAS for Allen-Bradley PLCs Installing and Configuring the DAS for Allen-Bradley PLCs 2.2 Installing the DAS for Allen-Bradley PLCs 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 PLCs 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 PLCs. 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. Installing and Configuring the DAS for Allen-Bradley PLCs 2-9 Installing and Configuring the DAS for Allen-Bradley PLCs 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 "/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" 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. 2-10 Installing and Configuring the DAS for Allen-Bradley PLCs Installing and Configuring the DAS for Allen-Bradley PLCs 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[5] ENQ_RETRIES[6] 0-20 NAK_RETRIES[7] 0-20 TRACE[8] TRUE, ON, YES, 1 or FALSE, OFF, NO, 0 DH_PATH LINE_NAME /LINE=xxx[9] STATION 0-377[4] TRACE[8] 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. [4]Octal. [5]The KE timeout value is specified in cycles. Consult the KE/KF/KF-2 documentation to determine how long the time is in seconds. [6]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. [7]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. [8]Trace is used to allow troubleshooting of the PLC communications. See Section 2.4 for details. [9]Specify a name registered earlier with ODS that specifies the line that the PLC with this station address will be using. Installing and Configuring the DAS for Allen-Bradley PLCs 2-11 Installing and Configuring the DAS for Allen-Bradley PLCs 2.3 Postinstallation Tasks ___________________________________________________________ 2-12 Installing and Configuring the DAS for Allen-Bradley PLCs Installing and Configuring the DAS for Allen-Bradley PLCs 2.3 Postinstallation Tasks 2.3.1.2 DAS for Allen-Bradley PLCs Configuration Files Example 2-2 is a sample of the ODS configuration file for the DAS for Allen-Bradley PLCs. Example 2-2 DAS for Allen-Bradley PLCs ODS Configuration File $ ! $ !********************************************************************! $ ! ! $ ! 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:[EXE]ODSCL.EXE $ ! $ ! Register the ODS definitions. $ ! $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/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" (continued on next page) Installing and Configuring the DAS for Allen-Bradley PLCs 2-13 Installing and Configuring the DAS for Allen-Bradley PLCs 2.3 Postinstallation Tasks Example 2-2 (Cont.) DAS for Allen-Bradley PLCs ODS Configuration File 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" 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. 2.3.2 Configuring Ports You can physically 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 2-14 Installing and Configuring the DAS for Allen-Bradley PLCs Installing and Configuring the DAS for Allen-Bradley PLCs 2.3 Postinstallation Tasks 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 PLCs 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: 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 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. Installing and Configuring the DAS for Allen-Bradley PLCs 2-15 Installing and Configuring the DAS for Allen-Bradley PLCs 2.3 Postinstallation Tasks Table_2-4_KE/KF/KF-2_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) Computer Comm Rate Yes 110 - 19200[2] [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]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 PLCs 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. 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. 2-16 Installing and Configuring the DAS for Allen-Bradley PLCs Installing and Configuring the DAS for Allen-Bradley PLCs 2.4 Tracing device communications 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 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 Installing and Configuring the DAS for Allen-Bradley PLCs 2-17 Installing and Configuring the DAS for Allen-Bradley PLCs 2.5 Failures During Product Use - 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-18 Installing and Configuring the DAS for Allen-Bradley PLCs 3 _________________________________________________________________ Using the DAS for Allen-Bradley PLCs 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 PLCs. 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 PLCs 3-1 Using the DAS for Allen-Bradley PLCs 3.2 Supported Functions The DAS for Allen-Bradley PLCs 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 PLCs supports the following server functions (indications) for all supported devices: o Info Report o Abort 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.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. 3-2 Using the DAS for Allen-Bradley PLCs Using the DAS for Allen-Bradley PLCs 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_______________________________ Using the DAS for Allen-Bradley PLCs 3-3 Using the DAS for Allen-Bradley PLCs 3.2 Supported Functions 3.2.3 Information Report 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 information report and abort indications. The information report indication is used when the PLC is sending data to the host. In order to use the info report function, a variable must be created on the host 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, an info report 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 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. Table_3-4_Supported_PLC_Write_Functions____________________ PLC Family_Function_Name____Address_Type_______________________ PLC 2 Unprotected PLC-2 address Write PLC 3 Word Range PLC-3 Logical binary address Write PLC 5 Typed Write PLC-5 Logical binary or ASCII ________________________address____________________________ 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. 3-4 Using the DAS for Allen-Bradley PLCs Using the DAS for Allen-Bradley PLCs 3.2 Supported Functions 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. 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. Using the DAS for Allen-Bradley PLCs 3-5 Using the DAS for Allen-Bradley PLCs 3.3 Addressing Syntax and Supported Data Types Figure 3-1 General PLC-2 Address Format 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-6 Using the DAS for Allen-Bradley PLCs Using the DAS for Allen-Bradley PLCs 3.3 Addressing Syntax and Supported Data Types 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 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 Using the DAS for Allen-Bradley PLCs 3-7 Using the DAS for Allen-Bradley PLCs 3.3 Addressing Syntax and Supported Data Types 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. ___________________________________________________________ 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 3-8 Using the DAS for Allen-Bradley PLCs Using the DAS for Allen-Bradley PLCs 3.3 Addressing Syntax and Supported Data Types Figure 3-4 PLC-3 Timer Structure Figure 3-5 PLC-3 Counter Structure 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. ___________________________________________________________ Using the DAS for Allen-Bradley PLCs 3-9 Using the DAS for Allen-Bradley PLCs 3.3 Addressing Syntax and Supported Data Types 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. Figure 3-6 PLC-3 ASCII, Binary, Decimal, Floating-Point, High-Order Integer, Integer and Status Data Table Address Format 3-10 Using the DAS for Allen-Bradley PLCs Using the DAS for Allen-Bradley PLCs 3.3 Addressing Syntax and Supported Data Types 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. ___________________________________________________________ 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. Using the DAS for Allen-Bradley PLCs 3-11 Using the DAS for Allen-Bradley PLCs 3.3 Addressing Syntax and Supported Data Types 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. ___________________________________________________________ 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. 3-12 Using the DAS for Allen-Bradley PLCs Using the DAS for Allen-Bradley PLCs 3.3 Addressing Syntax and Supported Data Types 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.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 Using the DAS for Allen-Bradley PLCs 3-13 Using the DAS for Allen-Bradley PLCs 3.3 Addressing Syntax and Supported Data Types 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 3-14 Using the DAS for Allen-Bradley PLCs Using the DAS for Allen-Bradley PLCs 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 Using the DAS for Allen-Bradley PLCs 3-15 Using the DAS for Allen-Bradley PLCs 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 3-16 Using the DAS for Allen-Bradley PLCs Using the DAS for Allen-Bradley PLCs 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. Using the DAS for Allen-Bradley PLCs 3-17 Using the DAS for Allen-Bradley PLCs 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 3-18 Using the DAS for Allen-Bradley PLCs Using the DAS for Allen-Bradley PLCs 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 Using the DAS for Allen-Bradley PLCs 3-19 Using the DAS for Allen-Bradley PLCs 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) 3-20 Using the DAS for Allen-Bradley PLCs Using the DAS for Allen-Bradley PLCs 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) Using the DAS for Allen-Bradley PLCs 3-21 Using the DAS for Allen-Bradley PLCs 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 the default timer 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 [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-22 Using the DAS for Allen-Bradley PLCs Using the DAS for Allen-Bradley PLCs 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______________ BT11:2 Structure[4] All of Block Transfer Control 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 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) Using the DAS for Allen-Bradley PLCs 3-23 Using the DAS for Allen-Bradley PLCs 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) 3-24 Using the DAS for Allen-Bradley PLCs Using the DAS for Allen-Bradley PLCs 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.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 Using the DAS for Allen-Bradley PLCs 3-25 Using the DAS for Allen-Bradley PLCs 3.3 Addressing Syntax and Supported Data Types 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 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-26 Using the DAS for Allen-Bradley PLCs Using the DAS for Allen-Bradley PLCs 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 PLCs 3-27 Using the DAS for Allen-Bradley PLCs 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-28 Using the DAS for Allen-Bradley PLCs Using the DAS for Allen-Bradley PLCs 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 PLCs 3-29 Using the DAS for Allen-Bradley PLCs 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-30 Using the DAS for Allen-Bradley PLCs Using the DAS for Allen-Bradley PLCs 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 PLCs 3-31 Using the DAS for Allen-Bradley PLCs 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-32 Using the DAS for Allen-Bradley PLCs Using the DAS for Allen-Bradley PLCs 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 PLCs 3-33 Using the DAS for Allen-Bradley PLCs 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-34 Using the DAS for Allen-Bradley PLCs Using the DAS for Allen-Bradley PLCs 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 PLCs 3-35 Using the DAS for Allen-Bradley PLCs 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-36 Using the DAS for Allen-Bradley PLCs Using the DAS for Allen-Bradley PLCs 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 rack 2, group UNSIGNED_16 7, remote 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. UNSIGNED_16 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 PLCs 3-37 Using the DAS for Allen-Bradley PLCs 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-38 Using the DAS for Allen-Bradley PLCs Using the DAS for Allen-Bradley PLCs 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, group 1, remote UNSIGNED_16 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 PLCs 3-39 Using the DAS for Allen-Bradley PLCs 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-40 Using the DAS for Allen-Bradley PLCs A _________________________________________________________________ Error Messages This appendix contains returned values and associated error messages specific to the DAS for Allen-Bradley PLCs. 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. 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 line 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. Error Messages A-1 Error Messages 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. 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 line 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. 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. A-2 Error Messages Error Messages 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. disconnerror, An error occurred when assigning a disconnect AST to a port, Explanation: Error. An error occurred when assigning a disconnect AST to an OpenVMS port. The disconnect AST allows the DAS to determine if the LAT port has been disconnected and to to abort communications with the VMD. User Action: An error message detailing the error should have been logged. Examine the error to determine the proper corrective action. Error Messages A-3 Error Messages disconnstatus, Status for line XX returned from SYS$QIOW (IO$_ SETMODE | IO$M_CTRLYAST), XX, Explanation: Error. An error occurred when requesting a disconnect AST from 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. duptrans, Duplicate transaction received on line XX, transaction number = !UW, Explanation: Error. 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. 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. A-4 Error Messages Error Messages 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. 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. Error Messages A-5 Error Messages 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. 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. A-6 Error Messages Error Messages 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. 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. 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. Error Messages A-7 Error Messages 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. 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. 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. A-8 Error Messages Error Messages 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. latcode, Status for line 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". Error Messages A-9 Error Messages latstatus, Status for line 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. 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. 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. A-10 Error Messages Error Messages 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. 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. 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. noalttypeahead, "/ALTYPEAHD" must be specified for the given port, Explanation: Error. The AB DAS requires that /ALTYPEAHD be specified for the port that is being used to communicate to the PLCs. ALTYPEAHD helps to ensure that characters transmitted by the PLC 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 PLCs. Error Messages A-11 Error Messages 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. 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. A-12 Error Messages 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. 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. Error Messages A-13 Error Messages 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. 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. A-14 Error Messages Error Messages 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. 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. Error Messages A-15 Error Messages 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. 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. 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. tracerddev, XX Trace for device XX - read:, Explanation: Error. Tracing has been enabled for the indicated device. The message is data written to the device. User Action: None. A-16 Error Messages Error Messages tracerdline, XX Trace for line XX - read:, Explanation: Error. Tracing has been enabled for the indicated line. The message is data read from the line. User Action: None. tracewrdev, XX Trace for device XX - write:, Explanation: Error. Tracing has been enabled for the indicated device. The message is data written to the device. User Action: None. tracewrline, XX Trace for line XX - write:, Explanation: Error. Tracing has been enabled for the indicated line. The message is data written to the line. User Action: None. 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. 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. 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. Error Messages A-17 Error Messages 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. vmsreaderror, QIO read error on line 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. vmsttcharstatus, Status for line 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. 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. A-18 Error Messages _________________________________________________________________ Index A Device access software _______________________________ (cont'd) Abort function, 3-2 installation of, 2-1 Abort indication, 3-4 installation requirements, Accessing DAS functions, 3-1 2-1 Address syntax, 3-5 overview, 1-1 PLC-2, 3-5 supported client functions, PLC-3, 3-6 3-2 PLC-5, 3-13 supported data types, 3-5 PLC-5/250, 3-25 supported devices, 1-2 C supported functions, 1-2, _______________________________ 3-1 Conclude function, 3-2 supported server functions, Configuration 3-2 editing configuration files, using, 3-1 2-9 Device communications ODS registrations, 2-9 cabling, 2-1 Configuration files, 2-13 overview, 1-1 Configuring ports, 2-14 tracing, 2-16 Connect function, 3-2 Devices PLCs supported, 1-2 D______________________________ DAS E______________________________ See Device access software Extended addressing Data table addressing PLC-3, 3-12 PLC-3, 3-7 PLC-5, 3-13 F______________________________ Data types, 3-5 Files, created during Device access software installation, 2-6 accessing functions, 3-1 Functions, 3-1 address syntax, 3-5 abort, 3-2 description of, 1-1 conclude, 3-2 functions, 1-2 connect, 3-2 Index-1 Functions (cont'd) PLC-3 data table address read variable, 3-2 (cont'd) supported, 3-1 counter, 3-9 write variable, 3-2 decimal, 3-10 floating-point, 3-10 I______________________________ high-order integer, 3-10 Indications I/O, 3-8 abort, 3-4 integer, 3-10 info report, 3-4 pointer, 3-12 Information report indication, status, 3-10 3-4 timer, 3-9 Installation, 2-1 PLC-5 files created, 2-6 address syntax, 3-13 messages, 2-6 data table addressing, 3-13 procedure, 2-3 supported data types, 3-13 Installation requirements, 2-1 PLC-5/250 disk space, 2-2 address syntax, 3-25 hardware, 2-1 supported data types, 3-25 software, 2-2 supported modules, 3-25 PLC-5/250 address format M adapter status, 3-38 _______________________________ ASCII string, 3-29 Messages binary, 3-27 error and return values, A-1 block-transfer, 3-36 installation, 2-6 block-transfer read/write MMS data type, 3-5 control, 3-37 control, 3-29 O______________________________ counter, 3-29 ODS registrations, 2-9 floating-point, 3-27 I/O, 3-35 P integer, 3-27 _______________________________ internal storage, 3-40 Plant-floor equipment, setting long integer, 3-27 up, 2-15 message control, 3-29 PLC-2 PID control, 3-29 address syntax, 3-5 shared data, 3-40 supported data types, 3-5 status, 3-34 PLC-3 timer, 3-29 address syntax, 3-6 PLC-5 data table address data table addressing, 3-7 ASCII, 3-17 extended addressing, 3-12 ASCII string, 3-20 supported data types, 3-6 binary, 3-17 PLC-3 data table address block-transfer control, 3-20 ASCII, 3-10 control, 3-20 binary, 3-10 counter, 3-20 Index-2 PLC-5 data table address (cont'd) R______________________________ decimal, 3-17 Read variable function, 3-2 floating-point, 3-17 I/O, 3-15 S______________________________ integer, 3-17 Supported data types, 3-5 message control, 3-20 PLC-2, 3-5 PID control, 3-20 PLC-3, 3-6 SFC status, 3-20 PLC-5, 3-13 status, 3-16 PLC-5/250, 3-25 timer, 3-20 token data, 3-20 T Postinstallation tasks, 2-9 _______________________________ Problem reporting, 2-17 Trace Product failure, 2-17 ODS configuration, 2-9 using, 2-16 W______________________________ Write variable function, 3-2 Index-3