BASEstar[TM] Classic DAS for Allen-Bradley INTERCHANGE[TM]_Software____________________________ Installation and User's Guide Order Number: AA-R213A-TE November 1996 This manual describes how to install and use the DAS for Allen-Bradley INTERCHANGE software for BASEstar Classic on OpenVMS. Revision/Update Information: This is a revised document. Operating System and Version: OpenVMS/Alpha Version 6.1 Operating System and Version: OpenVMS/VAX Version 5.5-2 Interface Software and Version:ASEstar Classic Version 3.4 Allen-Bradley Software: INTERCHANGE Software 6.0.2 Software Version: BASEstar Classic DAS for Allen-Bradley INTERCHANGE Software, Version 3.4 Digital Equipment Corporation Maynard, Massachusetts ________________________________________________________________ November 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 1990, 1996. All Rights Reserved. The following are trademarks of Digital Equipment Corporation: Alpha, BASEstar, Digital, OpenVMS, TK, VAX, and the Digital logo. PLC, PLC-2, and PLC-3 are registered trademarks of Allen- Bradley Company Inc. INTERCHANGE, PLC-5, Pyramid Integrator, Data Highway and Data Highway Plus are trademarks of Allen-Bradley Company, Inc. All other trademarks and registered trademarks are the property of their respective holders. This document is available on CDROM. This document was prepared using DEC DOCUMENT Version 3.0. _________________________________________________________________ Contents Preface................................................... vi 1 Overview 1.1 Description................................... 1-1 1.2 Device Communications......................... 1-1 1.3 Supported Functions and Devices............... 1-4 2 Installing and Configuring the DAS for AB INTERCHANGE Software 2.1 Installation Requirements..................... 2-1 2.1.1 Hardware.................................. 2-1 2.1.2 Software.................................. 2-2 2.1.3 Additional Software....................... 2-3 2.1.4 Disk Space................................ 2-3 2.1.5 Preparation for installing over old PI or DTL DAS................................... 2-4 2.2 Installing the DAS for AB INTERCHANGE Software...................................... 2-5 2.2.1 Files Created During Installation......... 2-10 2.2.2 Installation Messages..................... 2-12 2.3 Postinstallation Tasks........................ 2-14 2.3.1 Modify TCP/IP for OpenVMS UCX parameters................................ 2-14 2.3.2 Editing the Configuration File............ 2-15 2.3.2.1 Editing Type Records.................... 2-16 2.3.2.2 Editing Path Records.................... 2-20 2.3.2.3 Editing Device Records.................. 2-21 2.3.2.4 DAS for AB INTERCHANGE Software Configuration File...................... 2-24 2.3.3 Setting the BASEstar Classic Message Port Quota Parameter........................... 2-28 iii 2.3.4 Setting the SPT Block Parameter........... 2-28 2.3.5 Setting the DAS-Specific BASEstar Classic Parameters................................ 2-29 2.3.5.1 ILAN$DTLSRV_PRIORITY.................... 2-29 2.3.5.2 ILAN$DTL_BACKLOG........................ 2-30 2.3.5.3 ILAN$DTL_CYCLE_TIME..................... 2-30 2.3.5.4 ILAN$DTL_DWNL_FLAGS..................... 2-30 2.3.5.5 ILAN$DTL_MAX_ELEMENTS................... 2-31 2.3.5.6 ILAN$DTL_MAX_UNSOL_ELEMENTS............. 2-31 2.3.5.7 ILAN$DTL_SCMP_FLAGS..................... 2-32 2.3.5.8 ILAN$DTL_TIMEOUT........................ 2-32 2.3.5.9 ILAN$DTL_UDC_TIMEOUT.................... 2-32 2.3.5.10 ILAN$DTL_UPL_FLAGS...................... 2-33 2.3.6 Setting the DTL Server Process Quotas..... 2-33 2.3.7 Setting Up Plant-Floor Equipment.......... 2-34 2.4 Tracing Device Communications................. 2-34 2.5 Failures During Product Use................... 2-36 3 Using the DAS for AB INTERCHANGE Software 3.1 Accessing Allen-Bradley INTERCHANGE Functions..................................... 3-1 3.2 Supported Functions........................... 3-2 3.2.1 Read and Write Data Functions............. 3-3 3.2.2 Read Status Function...................... 3-6 3.2.3 Upload and Download Functions............. 3-7 3.2.3.1 DTL_DOWNLOAD............................ 3-9 3.2.3.2 DTL_UPLOAD.............................. 3-11 3.2.4 Loop Diagnostic Function.................. 3-11 3.2.5 Simple Compare Function................... 3-13 3.3 Structured Data............................... 3-14 3.4 Supported Data Types.......................... 3-15 3.4.1 Structured Data........................... 3-16 3.4.2 Restrictions to Data Formats.............. 3-17 3.5 Automatic Data Collection..................... 3-18 3.5.1 Unsolicited Data Collection............... 3-18 3.5.2 Pollsets.................................. 3-23 3.6 Supporting Utilities for the DAS for AB INTERCHANGE Software.......................... 3-23 3.6.1 Stop Server Utility....................... 3-24 3.6.2 Supporting Utilities for Allen-Bradley 6200 Series Software...................... 3-25 3.6.3 Import 6200 File Utility.................. 3-25 iv 3.6.4 Export 6200 File Utility.................. 3-26 A Allen-Bradley PLC-5/250 Addressing B Allen-Bradley PLC-5 Family Addressing C Sample Installation Procedure D DAS for AB INTERCHANGE Software Returned Values and Associated Error Messages Index Examples 2-1 Type Configuration........................ 2-16 2-2 Path Configuration for INTERCHANGE Software for OpenVMS...................... 2-20 2-3 Path Configuration for INTERCHANGE Software for the PI MicroVAX.............. 2-20 2-4 Device Configuration...................... 2-22 2-5 DAS for AB INTERCHANGE Software Configuration File........................ 2-24 3-1 READ DATA Output.......................... 3-5 3-2 WRITE DATA Output......................... 3-6 3-3 READ STATUS Output for PLC-5/250.......... 3-6 3-4 READ STATUS Output for PLC-5.............. 3-7 3-5 UPLOAD and DOWNLOAD Input................. 3-8 3-6 Loop Output............................... 3-12 3-7 Stop Server Utility....................... 3-24 3-8 Import 6200 File Utility.................. 3-25 3-9 Export 6200 File Utility.................. 3-26 C-1 PI Installation Sample.................... C-1 v Figures 1-1 DAS for AB INTERCHANGE Software Communications............................ 1-2 1-2 INTERCHANGE Software for the PI MicroVAX Configuration.................... 1-3 1-3 INTERCHANGE Software for OpenVMS Configuration............................. 1-4 3-1 Valid Unsolicited ID Configuration........ 3-22 3-2 Invalid Unsolicited ID Configuration...... 3-22 Tables 2-1 Disk Space Requirements................... 2-3 2-2 Files Created for the INTERCHANGE Software for OpenVMS Option........................ 2-10 2-3 Files Created for the INTERCHANGE Software for the PI MicroVAX Option................ 2-11 2-4 File modified by the DAS for AB INTERCHANGE software...................... 2-12 2-5 CREATE TYPE Parameters.................... 2-18 2-6 CREATE PATH............................... 2-21 2-7 CREATE DEVICE............................. 2-23 3-1 Supported Devices and Functions........... 3-2 3-2 Supported PLC section files............... 3-4 3-3 Read and Write Data Interface Access...... 3-5 3-4 Read Status Interface Access.............. 3-6 3-5 Upload and Download Interface Access...... 3-8 3-6 Download Qualifiers....................... 3-10 3-7 Upload Qualifiers......................... 3-11 3-8 Loop Interface Access..................... 3-12 3-9 Simple Compare Interface Access........... 3-13 3-10 Simple Compare Qualifiers................. 3-14 3-11 Data Formats Supported for Structured Data...................................... 3-16 3-12 PLC-5 MSG Instruction for Unsolicited Data...................................... 3-20 3-13 PLC-5/250 MSG Instruction for Unsolicited Data...................................... 3-20 vi A-1 Supported PLC-5/250 Addresses and Data Types..................................... A-1 B-1 Supported PLC-5 Family Addresses and Data Types..................................... B-1 vii _________________________________________________________________ Preface This document describes how to install and use the BASEstar Classic DAS for Allen-Bradley INTERCHANGE software. Intended Audience This document is intended for system managers who must set up and maintain the following: o BASEstar Classic software o BASEstar Classic DAS for Allen-Bradley INTERCHANGE software This document is also intended for application programmers who develop plant-floor management software layered on the BASEstar Classic software. Readers of this document should have knowledge of: o OpenVMS operations and administration o OpenVMS application software o BASEstar Classic software o Site-specific installation requirements In addition, knowledge of the Allen-Bradley devices is required. Document Structure This document is organized as follows: o Chapter 1, Overview, is an overview of the DAS for AB INTERCHANGE software. vi o Chapter 2, Installing and Configuring the DAS for AB INTERCHANGE Software, provides the information needed to install and configure the DAS for AB INTERCHANGE software. o Chapter 3, Using the DAS for AB INTERCHANGE Software, describes the supported functions for Allen-Bradley devices and how to access those functions. o Appendix D, DAS for AB INTERCHANGE Software Returned Values and Associated Error Messages, describes provides returned values and associated error messages for the DAS for AB INTERCHANGE software. Associated Documents For information on installing and configuring a BASEstar Classic system, consult the following documents: o BASEstar Classic Release Notes o BASEstar Classic Installation Guide o BASEstar Classic Configuration and Tuning Guide vii For instructions on how to use BASEstar Classic software functions, consult the following documents: o BASEstar Classic Introduction o BASEstar Classic Command Line Interface User's Guide o BASEstar Classic Menu Interface User's Guide For more information on developing software to integrate manufacturing applications and equipment, consult the following documents. o BASEstar Classic Introduction to Callable Services o BASEstar Classic Application Programming Interface Reference Guide o BASEstar Classic Guide to Writing Device Access Software o BASEstar Classic Guide to Writing a Database Server o BASEstar Classic DEC Rdb Database Server Guide For information on Allen-Bradley INTERCHANGE software and devices, consult the following documents: o Pyramid Integrator Design Manual o Pyramid Integrator Start-up and Integration Manual o INTERCHANGE Software User Manual o INTERCHANGE Software Concepts Manual o INTERCHANGE Software Reference Manual o Pyramid Integrator Addressing Reference o 6200 PLC-5/250 Programming Software Documentation Set. o PLC-5 Family Addressing Reference o 6200 PLC-5 Programming Software Documentation Set. ________________________ Note ________________________ Consult with your Allen-Bradley Sales representative for the most up to date document related to the topic. ______________________________________________________ viii Conventions This document uses the following conventions: Boldface Highlights user input within textual descriptions. Press the key labeled Return. Unless otherwise specified, press after entering a command or responding to a prompt. Enter Type the words or symbols described and press . ix 1 _________________________________________________________________ Overview This chapter provides an overview of the BASEstar Classic DAS for Allen-Bradley INTERCHANGE software. It also briefly describes Allen-Bradley device communications, and the supported functions for the DAS for AB INTERCHANGE software. 1.1 Description The DAS for AB INTERCHANGE software allows you to access Allen-Bradley devices using BASEstar Classic device connection management capabilities. Device connection management is the device connection and control component of BASEstar Classic for OpenVMS that provides generic communication with plant equipment, allowing the user to: o Configure device definitions o Collect data from plant equipment o Control device operation Using the DAS for AB INTERCHANGE software, users or applications can perform a variety of device access functions for the Allen-Bradley devices. 1.2 Device Communications The DAS for AB INTERCHANGE software consists of a protocol emulator (PE), a network interface (NI) and an INTERCHANGE server process. The PE and NI work together to provide device-specific communications for BASEstar Classic device connection management functions. The INTERCHANGE server process (DCM_DTL$SRV.EXE) implements these BASEstar Classic device connection management functions through Allen- Bradley INTERCHANGE software function calls. Overview 1-1 Overview 1.2 Device Communications The PE translates BASEstar Classic device connection management generic services into a device-understandable format. The PE also converts device-specific protocol into a BASEstar Classic device connection management format. The NI communicates the requests and data translated by the PE. The NI works directly with the INTERCHANGE server process to send and receive commands which are translated into INTERCHANGE DTL library calls. These INTERCHANGE DTL library calls send data to and receive data from plant-floor devices. Figure 1-1 shows how the DAS for AB INTERCHANGE software facilitates communications between BASEstar Classic device connection management software and INTERCHANGE software and the device. Figure 1-1 DAS for AB INTERCHANGE Software Communications 1 Requests typically are initiated by a BASEstar Classic application making an access call through the BASEstar Classic API. This call results to a service request being sent to the BASEstar Classic DCM server process, ILAN$DEVSRV. 2 ILAN$DEVSRV responds to the request by calling the appropriate PE routine. The PE builds a INTERCHANGE server request packet and calls the NI. 3 The NI sends the request packet in a BASEstar Classic message to the INTERCHANGE server process, DCM_DTL$SRV. 4 The server process makes the appropriate DTL API call based on the information in the request message packet. 5 The desired DTL I/O is performed and status is returned to the server process through INTERCHANGE. 6 The server process creates a response message and sends it back to ILAN$DEVSRV where it is received by the NI and processed by the PE. 1-2 Overview Overview 1.2 Device Communications 7 ILAN$DEVSRV passes the response back to the process which initiated the request The DAS for AB INTERCHANGE software uses the Allen-Bradley INTERCHANGE software products as the means to access Allen-Bradley PLC-5/250 on a Pyramid Integrator chassis, Allen-Bradley PLC processors on a Data Highway/Data Highway Plus (DH/DH+) link off of a Pyramid Integrator chassis or directly connected Allen-Bradley PLC-5/XXE processors. Two versions of INTERCHANGE software are supported by the DAS for AB INTERCHANGE software. They are INTERCHANGE Software for the PI MicroVAX and INTERCHANGE Software for OpenVMS. The INTERCHANGE Software for the PI MicroVAX product runs only on an Allen-Bradley VAX Integration Processor. This is a special OpenVMS/VAX system which fits into the back-plane of a Pyramid Integrator Chassis. INTERCHANGE Software for the PI MicroVAX communicates through the Pyramid Integrator Back Plane Interface (BPI) to the Resource Manager (RM) module. Access to remote PLC's is through Data Highway /Data Highway Plus ports on either the Resource Manager or a KA communications adapter in the Pyramid Integrator. Figure 1-2 shows a typical INTERCHANGE Software for the PI MicroVAX configuration. Figure 1-2 INTERCHANGE Software for the PI MicroVAX Configuration The INTERCHANGE Software for OpenVMS product runs on any standard OpenVMS system. INTERCHANGE Software for OpenVMS communicates using TCP/IP protocol, through an Ethernet Interface Module, to a Pyramid Integrator chassis or PLC- 5/XXE processor. When connecting to a Pyramid Integrator chassis, remote PLC's are linked through the Resource Manager or KA communications adapter modules in the Pyramid Integrator chassis. Communication to these remote PLC Overview 1-3 Overview 1.2 Device Communications processors is through Allen-Bradley's Data Highway/Data Highway Plus network. PLC-5 models with an "E" extension have an Ethernet Interface Module that allows direct connection to the ethernet. Figure 1-3 shows a typical INTERCHANGE Software for OpenVMS configuration. Figure 1-3 INTERCHANGE Software for OpenVMS Configuration INTERCHANGE Software for OpenVMS can support applications with up to 40 connections to Ethernet Interface Modules. Ethernet Interface Modules can support up to 64 connections. Because the DAS for AB INTERCHANGE software is considered a INTERCHANGE application, these restrictions effect how the DAS coexists with other INTERCHANGE applications within a INTERCHANGE/BASEstar Classic network. Because the two versions of INTERCHANGE software are mutually exclusive on an OpenVMS/VAX system, the DAS for AB INTERCHANGE software asks the user at installation time to select which option to install. 1.3 Supported Functions and Devices BASEstar Classic device connection management offers a number of device access functions. To perform a particular operation, the DAS PE must support that function. Device connection management functions are accessed through the following BASEstar Classic interfaces: o Command line interface (CLI) o Menu interface o Application programming interface (API) 1-4 Overview Overview 1.3 Supported Functions and Devices The DAS for AB INTERCHANGE software only supports Allen- Bradley PLC-5 family devices and Allen-Bradley model PLC-5 /250. Not all functions are supported for the model PLC- 5/250 or the INTERCHANGE Software for the PI MicroVAX DAS option. Both options of DAS for AB INTERCHANGE software support the following device connection management functions for Allen-Bradley PLC-5/250 and PLC-5 family devices: o Read data from a specific address in a device's memory o Write data to a specific address in a device's memory o Receive unsolicited data from a device o Read the status for a device o Loop PE o Loop NI In addition to the above, the INTERCHANGE Software for OpenVMS option supports the following functions for PLC-5 family (excluding the 5/250) devices: o Upload the contents of a device's memory to an OpenVMS file o Download an OpenVMS file to a device's memory o Perform a simple compare of device files NOTE: Simple compare is not provided on OpenVMS/Alpha systems. The INTERCHANGE Software for OpenVMS option also provides utilities which import and export OpenVMS device files from and to Allen-Bradley's 6200 Programming Software environment. For more information about supported functions and devices, refer to Chapter 3, Using the DAS for AB INTERCHANGE Software. Overview 1-5 2 _________________________________________________________________ Installing and Configuring the DAS for AB INTERCHANGE Software This chapter provides the information you need to install the DAS for AB INTERCHANGE software and configure your system. 2.1 Installation Requirements Review the following hardware and software requirements to ensure that your system is prepared for the BASEstar Classic DAS 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 AB INTERCHANGE software are the same as those for the BASEstar Classic device connection management services. For specific hardware requirements, see the BASEstar Classic Installation Guide. Additional hardware required for configuring the BASEstar Classic DAS for Allen-Bradley INTERCHANGE software includes one of the following: o Allen-Bradley Pyramid Integrator Chassis with: - Ethernet Interface Module - Resource Manager Module - Optional KA communications adapter modules Installing and Configuring the DAS for AB INTERCHANGE Software 2-1 Installing and Configuring the DAS for AB INTERCHANGE Software 2.1 Installation Requirements - Optional LP processor module(s) or: - Allen-Bradley MicroVAX Information Processor - Resource Manager Module - Optional KA communications adapter module(s) - Optional LP processor module(s) o Allen-Bradley PLC-5/XXE processor o Optional Allen-Bradley PLC-5 system(s) Refer to related Allen-Bradley documentation or your Allen-Bradley representative for more complete and current hardware configurations and revision levels. 2.1.2 Software Before installing the DAS for AB INTERCHANGE software, the following software must already be installed: o OpenVMS Version 5.5-2 or higher (VAX) o OpenVMS Version 6.1 or higher (Alpha) o VAX/FMS Version 2.3 or Version 2.4 (required only when the menu system will be used) (The Menu System is available only on OpenVMS/VAX systems.) o BASEstar Classic for OpenVMS, Version 3.4 (VAX) BASEstar Classic Library System is required only if simple file compare will be used. (BASEstar Classic Library System is available only on OpenVMS/VAX systems.) If the BASEstar Classic software is not already installed on your system, refer to the BASEstar Classic 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, 2-2 Installing and Configuring the DAS for AB INTERCHANGE Software Installing and Configuring the DAS for AB INTERCHANGE Software 2.1 Installation Requirements refer to the License Management Utility Manual for OpenVMS. ______________________________________________________ 2.1.3 Additional Software For the DAS for AB INTERCHANGE software to function correctly, the following software must also be installed for each installation option. For device access over Ethernet: o Allen-Bradley INTERCHANGE Software for OpenVMS 6.0.2 o TCP/IP Services for OpenVMS (UCX) 2.0E For device access from an Allen-Bradley Pyramid Integrator MicroVAX information processor : o Allen-Bradley INTERCHANGE Software for the PI MicroVAX 3.1.1 2.1.4 Disk Space Table 2-1 lists the disk space required to install the DAS for AB INTERCHANGE software. The space requirements are approximations; actual sizes may vary depending on your system environment, configuration, and software options installed. Table_2-1_Disk_Space_Requirements__________________________ Approximate Space Requirements (Blocks) Ethernet PI MicroVAX Usage___________________________option______option_________ Peak (during installation) 1700 (VAX) 1700 1300 (Alpha) Net (after installation) 400 (VAX) 450 600 ________________________________(Alpha)____________________ Installing and Configuring the DAS for AB INTERCHANGE Software 2-3 Installing and Configuring the DAS for AB INTERCHANGE Software 2.1 Installation Requirements 2.1.5 Preparation for installing over old PI or DTL DAS If you are installing the BASEstar Classic DAS for Allen- Bradley INTERCHANGE software on a system where either the BASEstar Classic device access software for Allen-Bradley Pyramid Integrator (PI DAS) or BASEstar Classic device access for Allen-Bradley Data Table Library Software (DTL DAS), then steps must be taken to deactivate these products before continuing the installation. To deactivate the PI DAS do the following: 1. Backup BASEstar Classic definitions to a command file (refer to BASEstar Classic documentation on methods) 2. Disable all devices of type/path PI 3. Disconnect any points, delete any phypoints and pollsets associated with these PI devices 4. Delete the PI devices. 5. Stop the BASEstar Classic system 6. Install the DAS for AB INTERCHANGE software using the PI MicroVAX option. 7. Perform post-installation tasks described later in this document 8. Define the old PI devices as new DTLBPI-path devices. 9. Modify the definition command file to reflect device definition changes and re-establish the BASEstar Classic definitions. To deactivate the Network DTL DAS do the following: 1. Backup BASEstar Classic definitions to a command file (refer to BASEstar Classic documentation on methods) 2. Disable all devices of type/path DTL 3. Disconnect any points, delete any phypoints and pollsets associated with these DTL devices 4. Delete the DTL devices. 5. Stop the BASEstar Classic system 6. Install the DAS for AB INTERCHANGE software using the OpenVMS (Ethernet) option. 2-4 Installing and Configuring the DAS for AB INTERCHANGE Software Installing and Configuring the DAS for AB INTERCHANGE Software 2.1 Installation Requirements 7. Perform post-installation tasks described later in this document 8. Define the old DTL devices as new DTLNET-path devices. 9. Modify the definition command file to reflect device definition changes and re-establish the BASEstar Classic definitions. 2.2 Installing the DAS for AB INTERCHANGE Software When your system meets all hardware and software requirements, you can install the DAS for AB INTERCHANGE software. The installation takes from 5 to 10 minutes, depending on the system load and configuration. Install the DAS for AB INTERCHANGE software 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 DCM_DTLVV034 ddcu: where: o DCM_DTLVV034 argument is the kit name o 034 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 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: Installing and Configuring the DAS for AB INTERCHANGE Software 2-5 Installing and Configuring the DAS for AB INTERCHANGE Software 2.2 Installing the DAS for AB INTERCHANGE Software $ @sys$update:vmsinstal DCM_DTLVV034 mua0: VAX/VMS Software Product Installation Procedure V5.5-2 It is 4-OCT-1996 at 14:15. Enter a question mark (?) at any time for help. * Are you satisfied with the backup of your system disk [YES]? The following products will be processed: DCM_DTL V3.4 Beginning installation of DCM_DTL V034at 14:15 %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 1992, 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. BASEstar Classic DAS for Allen-Bradley INTERCHANGE Software installation procedure. Checking for a valid license... Product: DAS-DTL-CL Producer: DEC Version: 3.4 Release Date: 13-DEC-1996 * Does this product have an authorization key registered and loaded? Y Now checking OpenVMS version... Now checking that BASEstar Classic is installed... 2-6 Installing and Configuring the DAS for AB INTERCHANGE Software Installing and Configuring the DAS for AB INTERCHANGE Software 2.2 Installing the DAS for AB INTERCHANGE Software The BASEstar Classic DAS for Allen-Bradley INTERCHANGE Software installs as two variants: 1) Support for INTERCHANGE Software for OpenVMS. This communicates to Allen-Bradley devices from an OpenVMS system through an Ethernet Interface. 2) Support for INTERCHANGE Software for PI MicroVAX. This option runs only on a PI MicroVAX embedded in a Pyramid Integrator Chassis. Communication to Allen-Bradley devices is over the backplane interface (BPI). These two options are mutually exclusive and require the corresponding type of Allen-Bradley INTERCHANGE Software to be installed. * Do you wish to install the Ethernet version of the DAS? Y %DCM_DTLVVT-I-DTLNET, Installing Ethernet version of the DAS... Now checking INTERCHANGE software version... Now checking disk space... Now checking BASEstar Classic message port quota... The current value for BCC$MAX_PORT_QUOTA of 50000 is too low for the BASEstar Classic DAS for Allen-Bradley INTERCHANGE Software. * Value to set BCC$MAX_PORT_QUOTA to [100000]: The new BCC$MAX_PORT_QUOTA will take effect the next time that BASEstar Classic is restarted. Restart BASEstar Classic software before attempting to use this DAS. * Do you want to purge files replaced by this installation [YES]? * Do you want to run the IVP after the installation [YES]? The installation procedure has no further questions to ask and will complete in 5 to 10 minutes depending on the system and system load. %VMSINSTAL-I-RESTORE, Restoring product save set B ... The configuration template file for DTL support, DCM_DTL_CONFIG.TEMPLATE, is used to define the Allen-Bradley paths, types, and devices. Edit this file, as necessary, to reflect your specific site configuration. During installation it will be placed in the directory BCC$SYSDATA. The BASEstar Classic parameter ILAN$DTL_TIMEOUT has just been created. Installing and Configuring the DAS for AB INTERCHANGE Software 2-7 Installing and Configuring the DAS for AB INTERCHANGE Software 2.2 Installing the DAS for AB INTERCHANGE Software Parameter ILAN$DTL_TIMEOUT, type Value. Current value is 1000, Default value is 1000. Minimum value is 100, Maximum value is 600000. The BASEstar Classic parameter ILAN$DTL_MAX_ELEMENTS has just been created. Parameter ILAN$DTL_MAX_ELEMENTS, type Value. Current value is 500, Default value is 500. Minimum value is 50, Maximum value is 100000. The BASEstar Classic parameter ILAN$DTL_BACKLOG has just been created. Parameter ILAN$DTL_BACKLOG, type Value. Current value is 5, Default value is 5. Minimum value is 1, Maximum value is 40. The BASEstar Classic parameter ILAN$DTL_CYCLE_TIME has just been created. Parameter ILAN$DTL_CYCLE_TIME, type Value. Current value is 70, Default value is 70. Minimum value is 5, Maximum value is 1000. The BASEstar Classic parameter ILAN$DTL_MAX_UNSOL_ELEMENTS has just been created. Parameter ILAN$DTL_MAX_UNSOL_ELEMENTS, type Value. Current value is 100, Default value is 100. Minimum value is 50, Maximum value is 10000. The BASEstar Classic parameter ILAN$DTL_UPL_FLAGS has just been created. Parameter ILAN$DTL_UPL_FLAGS, type String. Current value is "NORUNNING,NOFAULT", Default value is "NORUNNING,NOFAULT". The BASEstar Classic parameter ILAN$DTL_DWNL_FLAGS has just been created. Parameter ILAN$DTL_DWNL_FLAGS, type String. Current value is "MATCH", Default value is "MATCH". The BASEstar Classic parameter ILAN$DTL_SCMP_FLAGS has just been created. Parameter ILAN$DTL_SCMP_FLAGS, type String. Current value is "ALL,NODATATABLES,NOREVISION", Default value is "ALL,NODAT ATABLES,NOREVISION". 2-8 Installing and Configuring the DAS for AB INTERCHANGE Software Installing and Configuring the DAS for AB INTERCHANGE Software 2.2 Installing the DAS for AB INTERCHANGE Software The BASEstar Classic parameter ILAN$DTL_UDC_TIMEOUT has just been created. Parameter ILAN$DTL_UDC_TIMEOUT, type Value. Current value is 300000, Default value is 300000. Minimum value is 1000, Maximum value is 3600000. The BASEstar Classic parameter ILAN$DTLSRV_PRIORITY has just been created. Parameter ILAN$DTLSRV_PRIORITY, type Value. Current value is 6, Default value is 6. Minimum value is 1, Maximum value is 10. %VMSINSTAL-I-MOVEFILES, Files will now be moved to their target directories... Copyright (C) Digital Equipment Corporation 1992, 1996. All rights reserved. Executing the Installation Verification Procedure. Parameter ILAN$DTL_BACKLOG, type Value. Current value is 5, Default value is 5. Minimum value is 1, Maximum value is 40. Parameter ILAN$DTL_CYCLE_TIME, type Value. Current value is 70, Default value is 70. Minimum value is 5, Maximum value is 1000. Parameter ILAN$DTL_MAX_ELEMENTS, type Value. Current value is 500, Default value is 500. Minimum value is 50, Maximum value is 100000. Parameter ILAN$DTL_MAX_UNSOL_ELEMENTS, type Value. Current value is 100, Default value is 100. Minimum value is 50, Maximum value is 10000. Parameter ILAN$DTL_TIMEOUT, type Value. Current value is 1000, Default value is 1000. Minimum value is 100, Maximum value is 600000. Parameter ILAN$DTL_UPL_FLAGS, type String. Current value is "NORUNNING,NOFAULT", Default value is "NORUNNING,NOFAULT". Parameter ILAN$DTL_DWNL_FLAGS, type String. Current value is "MATCH", Default value is "MATCH". Parameter ILAN$DTL_SCMP_FLAGS, type String. Current value is "ALL,NODATATABLES,NOREVISION", Default value is "ALL,NODAT ATABLES,NOREVISION". Installing and Configuring the DAS for AB INTERCHANGE Software 2-9 Installing and Configuring the DAS for AB INTERCHANGE Software 2.2 Installing the DAS for AB INTERCHANGE Software Parameter ILAN$DTL_UDC_TIMEOUT, type Value. Current value is 300000, Default value is 300000. Minimum value is 1000, Maximum value is 3600000. Parameter ILAN$DTLSRV_PRIORITY, type Value. Current value is 6, Default value is 6. Minimum value is 1, Maximum value is 10. BASEstar Classic DAS for Allen-Bradley INTERCHANGE Software installation procedure has succeeded. Installation of DCM_DTL V3.4 completed at 14:20 VMSINSTAL procedure done at 14:20 2.2.1 Files Created During Installation Table 2-2 and Table 2-3 lists the files created by the DAS for AB INTERCHANGE software installation procedure, and the directories in which those files are placed for both the INTERCHANGE OpenVMS (Ethernet) and PI MicroVAX options. Table 2-2 Files Created for the INTERCHANGE Software for __________OpenVMS_Option___________________________________ Directory________Filename__________________________________ BCC$SYSDATA: DCM_DTL$MSG.DAT DCM_DTL_CONFIG.TEMPLATE DCM_DTL$SRV_STARTUP.COM DCM_DTL$SRV_QUOTAS.DAT BCC$SYSTEM: DCM_DTL$SRV.EXE DCM_DTL$EXPORT_6200.EXE DCM_DTL$IMPORT_6200.EXE DCM_DTL$SRV_STOP.EXE SYS$HELP: DCM_DTLVV034.RELEASE_NOTES (VAX) DCM_DTLVA034.RELEASE_NOTES (Alpha) (continued on next page) 2-10 Installing and Configuring the DAS for AB INTERCHANGE Software Installing and Configuring the DAS for AB INTERCHANGE Software 2.2 Installing the DAS for AB INTERCHANGE Software Table 2-2 (Cont.) Files Created for the INTERCHANGE __________________Software_for_OpenVMS_Option______________ Directory________Filename__________________________________ SYS$LIBRARY: ILAN_DTLNET.EXE ILAN_DTL.EXE _________________ILAN_DTL_SCMP.EXE_________________________ Table 2-3 Files Created for the INTERCHANGE Software for __________the_PI_MicroVAX_Option___________________________ Directory________Filename__________________________________ BCC$SYSDATA: DCM_DTL$MSG.DAT DCM_DTL_CONFIG.TEMPLATE DCM_DTL$BPISRV_STARTUP.COM DCM_DTL$SRV_QUOTAS.DAT BCC$SYSTEM: DCM_DTL$BPISRV.EXE DCM_DTL$SRV_STOP.EXE SYS$HELP: DCM_DTLVV034.RELEASE_NOTES (VAX) DCM_DTLVA034.RELEASE_NOTES (Alpha) SYS$LIBRARY: ILAN_DTL.EXE SYS$LIBRARY: ILAN_DTLBPI.EXE SYS$MESSAGE:_____DTL$MSG.EXE_______________________________ Table 2-4 lists the files modified by the DAS for AB INTERCHANGE software installation procedure, and the directories in which those files are located. Installing and Configuring the DAS for AB INTERCHANGE Software 2-11 Installing and Configuring the DAS for AB INTERCHANGE Software 2.2 Installing the DAS for AB INTERCHANGE Software Table 2-4 File modified by the DAS for AB INTERCHANGE __________software_________________________________________ Directory________Filename__________________________________ SYS$HELP:________ILAN$DEVICE_SPECIFIC.HLB__________________ 2.2.2 Installation Messages You may see VMSINSTAL messages during the installation procedure. The following messages are specific to the DAS for AB INTERCHANGE software installation: BADBCC, BASEstar Classic software must be installed before the DAS for AB INTERCHANGE Software, Explanation: Error. BASEstar Classic software must be installed before installing the DAS for AB INTERCHANGE Software. User Action: Install BASEstar Classic software, Version 3.4. BADDCM, BASEstar Classic Device Connect software must be installed before the DAS for AB INTERCHANGE Software, Explanation: Error. BASEstar Classic Device Connect software must be installed before installing the DAS for AB INTERCHANGE Software. User Action: Install BASEstar Classic Device Connect Management software, Version 3.4. BADVMS (Alpha), DAS for AB INTERCHANGE Software 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), DAS for AB INTERCHANGE Software must be installed under OpenVMS V5.5-2., Explanation: Error. The DAS is being installed on a version of OpenVMS that is less than OpenVMS V5.5-2. User Action: Upgrade OpenVMS to the required minimum version and then install the DAS. 2-12 Installing and Configuring the DAS for AB INTERCHANGE Software Installing and Configuring the DAS for AB INTERCHANGE Software 2.2 Installing the DAS for AB INTERCHANGE Software DTLBPI (VAX only), Installing MicroVAX version of the DAS..., Explanation: Information. The INTERCHANGE Software for the PI MicroVAX version of the DAS for AB INTERCHANGE software has been selected to be installed.. User Action: None. Continue with installation. DTLNET, Installing Ethernet version of the DAS..., Explanation: Information. The INTERCHANGE Software for OpenVMS version of the DAS for AB INTERCHANGE software has been selected to be installed.. User Action: None. Continue with installation. NETBLOCKS (VAX), The DAS for AB INTERCHANGE Software requires 400 blocks after installation, Explanation: Error. There is not enough disk space available to install DAS for AB INTERCHANGE software. User Action: Free up sufficient disk space to complete the installation. NETBLOCKS (Alpha), The DAS for AB INTERCHANGE Software requires 600 blocks after installation, Explanation: Error. There is not enough disk space available to install DAS for AB INTERCHANGE software. User Action: Free up sufficient disk space to complete the installation. NODTLNET, Allen-Bradley INTERCHANGE software must be installed before the DAS for AB INTERCHANGE Software, Explanation: Error. Correct version of INTERCHANGE Software for OpenVMS must be installed before the DAS for AB INTERCHANGE software. User Action: Install INTERCHANGE Software for OpenVMS. NODTLPI, Allen-Bradley INTERCHANGE software must be installed before the DAS for AB INTERCHANGE Software, Explanation: Error. Correct version of INTERCHANGE Software for the PI MicroVAX must be installed before DAS for AB INTERCHANGE software. User Action: Install INTERCHANGE Software for the PI MicroVAX. Installing and Configuring the DAS for AB INTERCHANGE Software 2-13 Installing and Configuring the DAS for AB INTERCHANGE Software 2.2 Installing the DAS for AB INTERCHANGE Software 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. 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. 2.3 Postinstallation Tasks Before using the DAS for AB INTERCHANGE software, you must perform the following postinstallation tasks: o Set TCP/IP for OpenVMS UCX parameters (for INTERCHANGE Software for OpenVMS option only). o Edit the configuration file o Set the BASEstar Classic port quota parameter o Set the device connection management SPT (support) block parameter o Set the DAS-specific BASEstar Classic parameters o Set the DTL server process quotas o Set up plant-floor equipment 2.3.1 Modify TCP/IP for OpenVMS UCX parameters The Allen-Bradley INTERCHANGE Software for OpenVMS uses TCP/IP services for OpenVMS (UCX) to communicate to the Ethernet interface. By default, UCX waits 10 minutes before notifying a TCP/IP application that a connection has been broken or that a connection to an unavailable interface has failed. This default timeout characteristic may not be appropriate for your use with the DAS for AB INTERCHANGE software. To override this behavior, the following must be done. 2-14 Installing and Configuring the DAS for AB INTERCHANGE Software Installing and Configuring the DAS for AB INTERCHANGE Software 2.3 Postinstallation Tasks In the system start up file SYS$MANAGER:SYSTARTUP_ V5.COM, after SYS$STARTUP:UCX$STARTUP.COM, but before SYS$STARTUP:DTLNET_STARTUP.COM is invoked add the following two lines: $UCX SET PROTOCOL TCP/PROBETIME=pt $UCX SET PROTOCOL TCP/DROPTIME=dt Where: pt = number of seconds between sending keepalive probe messages. Default value is 75 seconds. Allen-Bradley recommended value is 10 seconds. dt = number of seconds to wait since the last successful probe message before dropping the connection. The default value for dt is 600 seconds (10 minutes). The recommended value is 80 seconds. Note, the rule for setting dt is dt8xpt. Consult the appropriate TCP/IP Services for OpenVMS and Allen-Bradley documentation for more detailed information on configuring the TCP/IP network for INTERCHANGE Software for OpenVMS use. 2.3.2 Editing the Configuration File A configuration file, BCC$SYSDATA:DCM_DTL_CONFIG.TEMPLATE, is supplied with the DAS for AB INTERCHANGE software. This file contains definitions for types, paths, and devices. Copy the template file and edit it to include site-specific information about types, paths, and devices. Then execute the file to create the BASEstar Classic device connection management definitions. The following sections provide examples of type, path, and device definitions from the configuration file, and indicate which attributes are changeable. For more information about creating type, path, and device definitions, refer to the BASEstar Classic Command Line Interface User's Guide. Installing and Configuring the DAS for AB INTERCHANGE Software 2-15 Installing and Configuring the DAS for AB INTERCHANGE Software 2.3 Postinstallation Tasks 2.3.2.1 Editing Type Records The type record associates a device with the correct protocol emulator (PE). Example 2-1 shows the configuration file commands that create type records. Example 2-1 Type Configuration create type DTL_PLC5250_TYPE - /model="PLC-5/250"- /manufacturer="ALLEN-BRADLEY"- /protocol=DTL - /description="Allen-Bradley PLC-5/250"/log create type DTL_PLC5_TYPE - /model="PLC-5"- /manufacturer="ALLEN-BRADLEY"- /protocol=DTL - /description="Allen-Bradley generic PLC-5"/log create type DTL_PLC5E_TYPE - /model="PLC-5E"- /manufacturer="ALLEN-BRADLEY"- /protocol=DTL - /description="Allen-Bradley generic PLC-5, Ethernet interface"/log create type DTL_PLC510_TYPE - /model="PLC-5/10"- /manufacturer="ALLEN-BRADLEY"- /protocol=DTL - /description="Allen-Bradley PLC-5/10"/log create type DTL_PLC512_TYPE - /model="PLC-5/12"- /manufacturer="ALLEN-BRADLEY"- /protocol=DTL - /description="Allen-Bradley PLC-5/12"/log create type DTL_PLC515_TYPE - /model="PLC-5/15"- /manufacturer="ALLEN-BRADLEY"- /protocol=DTL - /description="Allen-Bradley PLC-5/15"/log (continued on next page) 2-16 Installing and Configuring the DAS for AB INTERCHANGE Software Installing and Configuring the DAS for AB INTERCHANGE Software 2.3 Postinstallation Tasks Example 2-1 (Cont.) Type Configuration create type DTL_PLC525_TYPE - /model="PLC-5/25"- /manufacturer="ALLEN-BRADLEY"- /protocol=DTL - /description="Allen-Bradley PLC-5/25"/log create type DTL_PLC520E_TYPE - /model="PLC-5/20E"- /manufacturer="ALLEN-BRADLEY"- /protocol=DTL - /description="Allen-Bradley PLC-5/20E"/log create type DTL_PLC540_TYPE - /model="PLC-5/40"- /manufacturer="ALLEN-BRADLEY"- /protocol=DTL - /description="Allen-Bradley PLC-5/40"/log create type DTL_PLC560_TYPE - /model="PLC-5/60"- /manufacturer="ALLEN-BRADLEY"- /protocol=DTL - /description="Allen-Bradley PLC-5/60"/log create type DTL_PLC540L_TYPE - /model="PLC-5/40L"- /manufacturer="ALLEN-BRADLEY"- /protocol=DTL - /description="Allen-Bradley PLC-5/40L"/log create type DTL_PLC540E_TYPE - /model="PLC-5/40E"- /manufacturer="ALLEN-BRADLEY"- /protocol=DTL - /description="Allen-Bradley PLC-5/40E"/log create type DTL_PLC560L_TYPE - /model="PLC-5/60L"- /manufacturer="ALLEN-BRADLEY"- /protocol=DTL - /description="Allen-Bradley PLC-5/60L"/log Installing and Configuring the DAS for AB INTERCHANGE Software 2-17 Installing and Configuring the DAS for AB INTERCHANGE Software 2.3 Postinstallation Tasks Modify the command for your site configuration. Table 2-5 lists type attributes that can be changed. Table_2-5_CREATE_TYPE_Parameters___________________________ Type_____________Parameter________Modifiable?______________ DTL_PLC5250_ Manufacturer No TYPE Model No Protocol No Description Yes DTL_PLC5_TYPE Manufacturer No Model No Protocol No Description Yes DTL_PLC5E_TYPE Manufacturer No Model No Protocol No Description Yes DTL_PLC510_TYPE Manufacturer No Model No Protocol No Description Yes DTL_PLC512_TYPE Manufacturer No Model No Protocol No Description Yes DTL_PLC515_TYPE Manufacturer No Model No Protocol No Description Yes DTL_PLC520E_ Manufacturer No TYPE (continued on next page) 2-18 Installing and Configuring the DAS for AB INTERCHANGE Software Installing and Configuring the DAS for AB INTERCHANGE Software 2.3 Postinstallation Tasks Table_2-5_(Cont.)_CREATE_TYPE_Parameters___________________ Type_____________Parameter________Modifiable?______________ Model No Protocol No Description Yes DTL_PLC525_TYPE Manufacturer No Model No Protocol No Description Yes DTL_PLC540_TYPE Manufacturer No Model No Protocol No Description Yes DTL_PLC540E_ Manufacturer No TYPE Model No Protocol No Description Yes DTL_PLC540L_ Manufacturer No TYPE Model No Protocol No Description Yes DTL_PLC560_TYPE Manufacturer No Model No Protocol No Description Yes DTL_PLC560L_ Manufacturer No TYPE Model No Protocol No _________________Description______Yes______________________ It should be noted that the Allen-Bradley model PLC-5 /250 is not considered a member of the PLC-5 family. It Installing and Configuring the DAS for AB INTERCHANGE Software 2-19 Installing and Configuring the DAS for AB INTERCHANGE Software 2.3 Postinstallation Tasks is important that the model definition (from the TYPE) be consistent with that of the actual device. Attempts to perform functions on incorrectly defined devices will fail. INTERCHANGE software does not distinguish between PLC-5 family processor models, therefore, only the DTL_PLC5_ TYPE (for connecting off of the pyramid integrator) or DTL_PLC5E_TYPE (for direct connection to ethernet) need be used. The specific PLC-5 model types are provided as a convenience in configuration management of these device networks. 2.3.2.2 Editing Path Records The two options for BASEstar Classic DAS for Allen-Bradley INTERCHANGE software have different network interfaces (NI), one to support each option of INTERCHANGE software. The path record associates a device with the correct NI and communication path. Examples 2-2 and 2-3 show the configuration file commands that create records for Ethernet and PI paths. Example 2-2 Path Configuration for INTERCHANGE Software for OpenVMS create path DTLNET_PATH/vaxport="05.00.00.04"- /netname=DTLNET- /default/io_size=2000/multidrop/log Example 2-3 Path Configuration for INTERCHANGE Software for the PI MicroVAX create path DTLBPI_PATH/vaxport="NL:"/netname=DTLBPI- /default/io_size=2000/multidrop/log Since the two options of the DAS for AB INTERCHANGE software are mutually exclusive, the /NETNAME must correspond to the option that has been installed. For the DAS for AB INTERCHANGE software ethernet option, the /NETNAME parameter must be DTLNET. The VAXPORT parameter of the path definition specifies the network address of the Ethernet interface module connecting the PLC with the TCP/IP network. This address may be either a host 2-20 Installing and Configuring the DAS for AB INTERCHANGE Software Installing and Configuring the DAS for AB INTERCHANGE Software 2.3 Postinstallation Tasks name or an IP address specified in dot notation, with the same value that would be passed to the INTERCHANGE software routine DTL_C_CONNECT. Refer to Allen-Bradley documentation for more information. For the PI MicroVAX option of the DAS for AB INTERCHANGE software, the /NETNAME parameter must be DTLBPI and the VAXPORT parameter must be NL:. Only one path may be defined for this option. The DAS for AB INTERCHANGE software does not require the LINE parameter. Modify the commands for your site configuration, making sure that the VAX port parameters match your plant-floor configuration. Create additional paths as needed. Table 2-6 lists the path attributes that can be changed. Table_2-6_CREATE_PATH______________________________________ Path_____________Parameter________Modifiable?______________ DTLNET_PATH VAXport Yes Netname No Multidrop No I/O size No Retries Yes Line N/A DTLBPI_PATH VAXport Yes Netname No Multidrop No I/O size No Retries Yes _________________Line_____________N/A______________________ 2.3.2.3 Editing Device Records The device record represents a Allen-Bradley device and references previously defined type and path records. Example 2-4 shows the configuration file commands that create device records. Installing and Configuring the DAS for AB INTERCHANGE Software 2-21 Installing and Configuring the DAS for AB INTERCHANGE Software 2.3 Postinstallation Tasks Example 2-4 Device Configuration create dev DTL5 /path=DTLNET_PATH/type=DTL_PLC5_TYPE/netaddr="0RM:2,002"- /timeout=100/vaxport="05.00.00.04"/write_enable/log create dev DTL5E /path=DTLNET_PATH/type=DTL_PLC5E_TYPE/netaddr=","- /timeout=100/vaxport="05.00.00.05"/write_enable/log create dev DTL5250 /path=DTLBPI_PATH/type=DTL_PLC5250_TYPE/netaddr=","- /timeout=10/vaxport="NL:"/write_enable/log For the DAS for AB INTERCHANGE software, the /NETADDRESS parameter specifies the external communication port and station address of a station outside of the Pyramid integrator chassis respectively. The format of the /NETADDRESS parameter is: port_id,station_id. Valid port_id values are as follows: ___________________________________________________________ Port_ID____Description_____________________________________ 2 or Channel 2 of the resource manager in slot 0 0RM:2 3 or Channel 3 of the resource manager in slot 0 0RM:3 nKA:2 Channel 2 of the KA module with pushwheel n(n=0- 4) nKA:3 Channel 3 of the KA module with pushwheel n(n=0- 4) 0RM:2/B:b Channel 2 of the resource manager through bridge address b (b=1-376(octal)) 0RM:2/B:b Channel 2 of the resource manager through bridge /L:l address b (b=1-376(octal)) and link l (l=0- 65535(decimal)) 0RM:2/L:l Channel 2 of the resource manager through link /G:g l (l-0-65535(decimal)) and gateway g (g=1- 376(octal)) 0RM:2/B:b Channel 2 of the resource manager through /L:l/G:g bridge address b (b=1-376(octal)) link l (l=0- ___________65535(decimal))_and_gateway_g_(g=1-376(octal))__ Valid value for the station_id are 1 through 376 (octal) for Data Highway, and 0 through 77 (octal) for Data Highway Plus. 2-22 Installing and Configuring the DAS for AB INTERCHANGE Software Installing and Configuring the DAS for AB INTERCHANGE Software 2.3 Postinstallation Tasks For example, a network address at Data Highway station 7 off of the DH/DH+ port 2 of the resource manager is as follows: /NETADDRESS="0RM:2,007" For a PLC-5/250 sharing the Pyramid integrator chassis with the Ethernet Interface module, the port_id and station_id are null or empty. For PLC-5/XXE with a direct connection to the ethernet, the port_id and station_id are also null. To specify the network address for either of these configurations, use the comma (,) delimiter, as shown: /NETADDRESS="," Modify the command for your site configuration. Table 2-7 lists the device attributes that can be changed. Table_2-7_CREATE_DEVICE____________________________________ Device___________Parameter________Modifiable?______________ DTL5 Path No Type No Description Yes Timeout Yes Netaddr Yes DTL5E Path No Type No Description Yes Timeout Yes Netaddr Yes DTL5250 Path No Type No Description Yes Timeout Yes Netaddr No PI5250 Path No (continued on next page) Installing and Configuring the DAS for AB INTERCHANGE Software 2-23 Installing and Configuring the DAS for AB INTERCHANGE Software 2.3 Postinstallation Tasks Table_2-7_(Cont.)_CREATE_DEVICE____________________________ Device___________Parameter________Modifiable?______________ Type No Description Yes Timeout Yes _________________Netaddr__________No_______________________ 2.3.2.4 DAS for AB INTERCHANGE Software Configuration File Following is an example configuration file for INTERCHANGE Software for OpenVMS option of the DAS. Example 2-5 DAS for AB INTERCHANGE Software Configuration File $! $! Allen-Bradley DTL DAS support for DCM Device Access. $! $! $!********************************************************************! $! ! $! This is a template for the site specific ! $! 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 your devices. ! $! ! $! Add comments to the site specific changes here. ! $! ! $!********************************************************************! $! $ bstar/dcm !*********************************************************************! ! ! ! Create types for the models supported by the DTL DAS. In ! ! general, the type definitions are DAS specific, and should ! ! not be modified. ! ! ! !*********************************************************************! (continued on next page) 2-24 Installing and Configuring the DAS for AB INTERCHANGE Software Installing and Configuring the DAS for AB INTERCHANGE Software 2.3 Postinstallation Tasks Example 2-5 (Cont.) DAS for AB INTERCHANGE Software Configuration File create type DTL_PLC5250_TYPE - /model="PLC-5/250"- /manufacturer="ALLEN-BRADLEY"- /protocol=DTL - /description="Allen-Bradley PLC-5/250"/log create type DTL_PLC5_TYPE - /model="PLC-5"- /manufacturer="ALLEN-BRADLEY"- /protocol=DTL - /description="Allen-Bradley generic PLC-5"/log create type DTL_PLC5E_TYPE - /model="PLC-5E"- /manufacturer="ALLEN-BRADLEY"- /protocol=DTL - /description="Allen-Bradley generic PLC-5, Ethernet interface"/log create type DTL_PLC510_TYPE - /model="PLC-5/10"- /manufacturer="ALLEN-BRADLEY"- /protocol=DTL - /description="Allen-Bradley PLC-5/10"/log create type DTL_PLC512_TYPE - /model="PLC-5/12"- /manufacturer="ALLEN-BRADLEY"- /protocol=DTL - /description="Allen-Bradley PLC-5/12"/log create type DTL_PLC515_TYPE - /model="PLC-5/15"- /manufacturer="ALLEN-BRADLEY"- /protocol=DTL - /description="Allen-Bradley PLC-5/15"/log create type DTL_PLC525_TYPE - /model="PLC-5/25"- /manufacturer="ALLEN-BRADLEY"- /protocol=DTL - /description="Allen-Bradley PLC-5/25"/log (continued on next page) Installing and Configuring the DAS for AB INTERCHANGE Software 2-25 Installing and Configuring the DAS for AB INTERCHANGE Software 2.3 Postinstallation Tasks Example 2-5 (Cont.) DAS for AB INTERCHANGE Software Configuration File create type DTL_PLC520E_TYPE - /model="PLC-5/20E"- /manufacturer="ALLEN-BRADLEY"- /protocol=DTL - /description="Allen-Bradley PLC-5/20E"/log create type DTL_PLC540_TYPE - /model="PLC-5/40"- /manufacturer="ALLEN-BRADLEY"- /protocol=DTL - /description="Allen-Bradley PLC-5/40"/log create type DTL_PLC560_TYPE - /model="PLC-5/60"- /manufacturer="ALLEN-BRADLEY"- /protocol=DTL - /description="Allen-Bradley PLC-5/60"/log create type DTL_PLC540L_TYPE - /model="PLC-5/40L"- /manufacturer="ALLEN-BRADLEY"- /protocol=DTL - /description="Allen-Bradley PLC-5/40L"/log create type DTL_PLC540E_TYPE - /model="PLC-5/40E"- /manufacturer="ALLEN-BRADLEY"- /protocol=DTL - /description="Allen-Bradley PLC-5/40E"/log create type DTL_PLC560L_TYPE - /model="PLC-5/60L"- /manufacturer="ALLEN-BRADLEY"- /protocol=DTL - /description="Allen-Bradley PLC-5/60L"/log (continued on next page) 2-26 Installing and Configuring the DAS for AB INTERCHANGE Software Installing and Configuring the DAS for AB INTERCHANGE Software 2.3 Postinstallation Tasks Example 2-5 (Cont.) DAS for AB INTERCHANGE Software Configuration File !*********************************************************************! ! ! ! Modify these path and device definitions for your specific ! ! configuration. ! ! ! !*********************************************************************! ! ! ! Use the DTLBPI_PATH for INTERCHANGE Software for PI MicroVAX only.! ! ! !********************************************************************** ! create path DTLBPI_PATH/vaxport="NL:"/netname=DTLBPI- ! /default/io_size=2000/multidrop/log ! !*********************************************************************! ! ! ! Use the DTLNET_PATH for INTERCHANGE Software for VMS only. ! ! ! !********************************************************************** ! create path DTLNET_PATH/vaxport="aa.00.00.bb"/netname=DTLNET- ! /default/io_size=2000/multidrop/log ! !********************************************************************** ! ! create dev DTL5 /path=DTLNET_PATH/type=DTL_PLC5_TYPE/netaddr="0RM:2,03"- ! /timeout=100/vaxport="aa.00.00.bb"- ! /write_enable/log ! ! create dev DTL5E /path=DTLNET_PATH/type=DTL_PLC5E_TYPE/netaddr=","- ! /timeout=10/vaxport="aa.00.00.bb"/write_enable/log ! ! create dev DTL5250 /path=DTLNET_PATH/type=DTL_PLC5250_TYPE/netaddr=","- ! /timeout=10/vaxport="aa.00.00.bb"/write_enable/log ! ! create dev PI5250 /path=DTLBPI_PATH/type=DTL_PLC5250_TYPE/netaddr=","- ! /timeout=10/vaxport="NL:"/write_enable/log $ exit Installing and Configuring the DAS for AB INTERCHANGE Software 2-27 Installing and Configuring the DAS for AB INTERCHANGE Software 2.3 Postinstallation Tasks For more information about maintaining type, path, and device definitions, refer to the BASEstar Classic Command Line Interface User's Guide. 2.3.3 Setting the BASEstar Classic Message Port Quota Parameter The DAS for AB INTERCHANGE software requires a message port quota of 100,000. The BASEstar Classic parameter BCC$MAX_ PORT_QUOTA must be set greater than or equal to this value. Use the BASEstar Classic CLI SHOW PARAMETER command to review the value of the maximum port quota parameter. If necessary, use the SET PARAMETER command to adjust it. For more information refer to the BASEstar Classic Configuration and Tuning Guide. 2.3.4 Setting the SPT Block Parameter The ILAN$MAX_SPT_REQUESTS parameter specifies the maximum number of blocks allocated in the SPT (support) global section for all device access software installed on the system. The value of this parameter is approximated by adding the SPT requirements of each DAS on the system. Use the following formula to approximate the SPT requirements of the DAS for AB INTERCHANGE software: SPT = 1.1 * (1 + num_paths + (2 * total_num_devices) + [(2 + num_unsol_devices)]) where: SPT is the approximate number of DAS support blocks required for the DAS for AB INTERCHANGE software. num_paths is the number of paths defined in the configuration file. total_num_devices is the total number of Allen-Bradley devices defined. num_unsol_devices is the number of Allen-Bradley unsolicited devices defined on the system. Use the SPT value to calculate the total block requirements for the ILAN$MAX_SPT_REQUESTS parameter, as follows: o If the DAS for AB INTERCHANGE software is the only DAS defined on the system, set the ILAN$MAX_SPT_REQUESTS parameter to the SPT value. 2-28 Installing and Configuring the DAS for AB INTERCHANGE Software Installing and Configuring the DAS for AB INTERCHANGE Software 2.3 Postinstallation Tasks o If other device access software is installed on the system, increase the ILAN$MAX_SPT_REQUESTS parameter setting by the SPT value or set the ILAN$MAX_SPT_ REQUESTS parameter to the sum of SPT values for all DASes defined on the system. For information on how the SPT global section size is determined by the ILAN$MAX_SPT_REQUESTS parameter, Refer to the BASEstar Classic Configuration and Tuning Guide. 2.3.5 Setting the DAS-Specific BASEstar Classic Parameters The following sections describe how to set the following DAS-specific BASEstar Classic parameters: o ILAN$DTLSRV_PRIORITY o ILAN$DTL_BACKLOG o ILAN$DTL_CYCLE_TIME o ILAN$DTL_DWNL_FLAGS o ILAN$DTL_MAX_ELEMENTS o ILAN$DTL_MAX_UNSOL_ELEMENTS o ILAN$DTL_SCMP_FLAGS o ILAN$DTL_TIMEOUT o ILAN$DTL_UDC_TIMEOUT o ILAN$DTL_UPL_FLAGS None of the parameters created for the DAS for AB INTERCHANGE software are dynamic. BASEstar Classic device connection management must be shut down and started again before parameter modifications become effective. 2.3.5.1 ILAN$DTLSRV_PRIORITY The ILAN$DTLSRV_PRIORITY parameter sets the priority of the INTERCHANGE server process, DCM_DTL$SRV. Values are as follows: Default value 6 Minimum value 1 Maximum value 10 Installing and Configuring the DAS for AB INTERCHANGE Software 2-29 Installing and Configuring the DAS for AB INTERCHANGE Software 2.3 Postinstallation Tasks Use this parameter in conjunction with the ILAN$DTL_ CYCLE_TIME parameter to balance the performance of the INTERCHANGE server process. A high priority setting will give more CPU time to the server process for collecting data and processing requests. Understand, however, that increasing this setting may be at the expense of the applications using this data. Refer to the appropriate documentation on OpenVMS system management and tuning for more information. 2.3.5.2 ILAN$DTL_BACKLOG The ILAN$DTL_BACKLOG parameter sets the number of unsolicited messages which will be buffered by the INTERCHANGE software. Values are as follows: Default value 5 messages Minimum value 1 message Maximum value 40 messages 2.3.5.3 ILAN$DTL_CYCLE_TIME The ILAN$DTL_CYCLE_TIME parameter controls the maximum amount of time the INTERCHANGE server process waits for DTL I/O completion before checking for requests from the NI. Values are as follows: Default value 70 milliseconds Minimum value 5 milliseconds Maximum value 1,000 milliseconds Generally, the smaller the cycle time, the faster the server will respond to the NI requests. If the cycle time is too small, however, the server will consume CPU time checking for requests. 2.3.5.4 ILAN$DTL_DWNL_FLAGS The ILAN$DTL_DWNL_FLAGS parameter sets the default behavior of the download function. This default behavior may be overridden by using /QUALIFIER option on the download command. The flags specified in a download command are logically ORed with those specified by ILAN$DTL_DWNL_FLAGS. 2-30 Installing and Configuring the DAS for AB INTERCHANGE Software Installing and Configuring the DAS for AB INTERCHANGE Software 2.3 Postinstallation Tasks The default value for ILAN$DTL_DWNL_FLAGS is MATCH. This flag requires that the device type, series, and revision match that of the file being downloaded. For more information on valid download flags that can be used for this parameter, refer to Table 3-6. 2.3.5.5 ILAN$DTL_MAX_ELEMENTS The ILAN$DTL_MAX_ELEMENTS parameter controls the maximum number of elements the INTERCHANGE server process can define; that is, the expected number of outstanding solicited requests and the number of unsolicited requests combined. Values are as follows: Default value 500 elements Minimum value 50 elements Maximum value 100,000 elements The value of ILAN$DTL_MAX_ELEMENTS must be greater than the value of ILAN$DTL_MAX_UNSOL_ELEMENTS. Note that ILAN$DTL_ MAX_ELEMENTS only affects the number of points that can be defined as unsolicited and simultaneous pending data reads/writes. The parameter does not affect the number of physical points that can be defined on a BASEstar Classic system. 2.3.5.6 ILAN$DTL_MAX_UNSOL_ELEMENTS The ILAN$DTL_MAX_UNSOL_ELEMENTS parameter controls the maximum number of elements that can be defined as unsolicited phypoints. This number is deducted from the value of ILAN$DTL_MAX_ELEMENTS. Values are as follows: Default value 50 phypoints Minimum value 50 phypoints Maximum value 10,000 phypoints The value of ILAN$DTL_MAX_UNSOL_ELEMENTS must be less than ILAN$DTL_MAX_ELEMENTS. Installing and Configuring the DAS for AB INTERCHANGE Software 2-31 Installing and Configuring the DAS for AB INTERCHANGE Software 2.3 Postinstallation Tasks 2.3.5.7 ILAN$DTL_SCMP_FLAGS The ILAN$DTL_SCMP_FLAGS parameter sets the default behavior of the simple file compare function. The default value for ILAN$DTL_SCMP_FLAGS is ALL,NODATATABLES,NOREVISION. This value will have the compare operation check everything except the data tables and the PLC revision. For more information on valid simple file compare flags which may be used for this parameter, refer to Table 3-10. 2.3.5.8 ILAN$DTL_TIMEOUT The ILAN$DTL_TIMEOUT parameter determines the timeout value for all DTL I/O calls. Values are as follows: Default value 1,000 milliseconds Minimum value 1,000 milliseconds Maximum value 600,000 milliseconds The value of ILAN$DTL_TIMEOUT should be less than the shortest /TIMEOUT of the INTERCHANGE DAS device definitions. The desired behavior is to have the internal INTERCHANGE DTL call timeout before the BASEstar Classic device connect management request. If the BASEstar Classic request times out first, a cancellation request is attempted and any requests completion is ignored. Because INTERCHANGE does not support cancellation of requests, the actual INTERCHANGE DTL request may have successfully completed, yet give the incorrect impression that the INTERCHANGE function was not completed. 2.3.5.9 ILAN$DTL_UDC_TIMEOUT The ILAN$DTL_UDC_TIMEOUT parameter determines the timeout value for all INTERCHANGE upload, download and compare calls. Values are as follows: Default value 300000 milliseconds Minimum value 1000 milliseconds Maximum value 3600000 milliseconds The value of ILAN$DTL_UDC_TIMEOUT should be less than the shortest /TIMEOUT of the INTERCHANGE DAS device definitions. The desired behavior is to have the internal INTERCHANGE DTL call timeout before the BASEstar Classic device connect management request. If the BASEstar 2-32 Installing and Configuring the DAS for AB INTERCHANGE Software Installing and Configuring the DAS for AB INTERCHANGE Software 2.3 Postinstallation Tasks Classic request times out first, a cancellation request is attempted and any requests completion is ignored. Because INTERCHANGE does not support cancellation of requests, the actual INTERCHANGE DTL request may have successfully completed, yet give the incorrect impression that the INTERCHANGE function was not completed. 2.3.5.10 ILAN$DTL_UPL_FLAGS The ILAN$DTL_UPL_FLAGS parameter sets the default behavior of the upload function. This default behavior may be overridden by using /QUALIFIER option on the upload command. The flags specified in a upload command are logically ORed with those specified by ILAN$DTL_UPL_FLAGS. The default value for ILAN$DTL_UPL_FLAGS is NORUNNING,NOFAULT, which requires that the device not be in RUN mode and that it not be faulted. For more information on valid upload flags which may be used for this parameter, refer to Table 3-7. 2.3.6 Setting the DTL Server Process Quotas The DAS for AB INTERCHANGE software allows you to tune the values of process quotas for the DCM_DTL$SRV_X process. Process parameters are read from the file BCC$SYSDATA:DCM_ DTL$SRV_QUOTAS.DAT when a new DCM_DTL$SRV process is created. Process quotas may need to be tuned depending on the number of devices and points configured and the throughput rate of requests through the server. To adjust a quota for the server process do the following: 1. Provide DETACH priviledge to ILAN$DEVSRV by modifying the RUN command in BCC$SYSDATA:ILAN$SYSTEM_STARTUP.COM. 2. Edit the file BCC$SYSDATA:DCM_DTL$SRV_QUOTAS.DAT as follows: 1. Un-comment the line corresponding to the quota to be adjusted by removing the "!" character. 2. Modify the existing quota value. If a value does not exist, add it to the file, separating the quota name and value with a space. Installing and Configuring the DAS for AB INTERCHANGE Software 2-33 Installing and Configuring the DAS for AB INTERCHANGE Software 2.3 Postinstallation Tasks The new quotas will be in effect the next time the server process is started up by the INTERCHANGE DAS. The DCM_ DTL$SRV_STOP utility can be used to shutdown running server processes without shutting down BASEstar Classic DCM. (Note: You will have to shutdown BASEstar Classic DCM the first time you modify ILAN$SYSTEM_STARTUP in order for the change to take effect). 2.3.7 Setting Up Plant-Floor Equipment To set up your plant-floor equipment, refer to the Allen- Bradley documentation for your specific device. While setting up the plant-floor equipment, you should record the following information that will be required for setting up the BASEstar Classic path and device definitions: o The Ethernet Address of the Ethernet Interface(s) o The Data Highway addresses of remote PLC stations 2.4 Tracing Device Communications The DAS for AB INTERCHANGE software has built into it the capability to trace INTERCHANGE software communications and to send this output to either a file, a user terminal or to the BASEstar Classic history file. The purpose of this tracing is to allow the troubleshooting of INTERCHANGE software communications and is intended to be used primarily under the direction of support personnel. To enable tracing to send trace information to a file do the following: o Set one or more of the following logicals to 1: DCM_DTL$PE_TRACE Trace the PE (Protocol Emulator) DCM_DTL$SRV_TRACE Trace the DCM_DTL$SRV process(es) The logical name must be defined in a scope that will be seen by the associated server process (ILAN$DEVSRV or DCM_DTL$SRV). 2-34 Installing and Configuring the DAS for AB INTERCHANGE Software Installing and Configuring the DAS for AB INTERCHANGE Software 2.4 Tracing Device Communications o Set the corresponding output logical to a file or other output device: DCM_DTL$PE_TRACE_ Trace the PE (Protocol Emulator) OUTPUT DCM_DTL$SRV_TRACE_ Trace the DCM_DTL$SRV process OUTPUT_X "X" The logical name must be defined in a scope that will be seen by the associated server process (ILAN$DEVSRV or DCM_DTL$SRV). o Start the tracing. To start the tracing for the DCM_DTL$SRV process, stop the associated server process and restart it. The trace logicals are read only at process startup. To start tracing for the PE, disable the device for which tracing is desired and reenable it. The trace logicals are read when the device is enabled. The trace output is flushed to the file after every 100 lines that are traced, so trace output may lag actual device I/O. To enable tracing to send trace information to the BASEstar history file do the following: o Set one or more of the following logicals to 1: DCM_DTL$NI_DEBUG Trace the NI (Network Interface) DCM_DTL$PE_DEBUG Trace the PE (Protocol Emulator) DCM_DTL$SRV_DEBUG Trace the DCM_DTL$SRV process(es) The logical name must be defined in a scope that will be seen by the associated server process (ILAN$DEVSRV or DCM_DTL$SRV). o Start the tracing. To enable tracing for the NI or for the DCM_DTL$SRV process shutdown and restart the associated server process. The trace logical is read only at process startup. Installing and Configuring the DAS for AB INTERCHANGE Software 2-35 Installing and Configuring the DAS for AB INTERCHANGE Software 2.4 Tracing Device Communications To start tracing for the PE, disable the device for which tracing is desired and reenable it. The trace logical is read when the device is enabled. 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 INTERCHANGE software you are using - The version number of BASEstar Classic you are using - The hardware system you are using (such as a model number) - The Allen-Bradley PLCs you are communicating with - A brief description of the problem (one sentence if possible) - How critical the problem is o If you have a Self-Maintenance Software Agreement, you can submit a Software Performance Report (SPR). o If you do not have any type of software services support agreement and you purchased this product within the past year, you can submit an SPR if you think the problem is caused by a software error. 2-36 Installing and Configuring the DAS for AB INTERCHANGE Software Installing and Configuring the DAS for AB INTERCHANGE Software 2.5 Failures During Product Use 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. Installing and Configuring the DAS for AB INTERCHANGE Software 2-37 3 _________________________________________________________________ Using the DAS for AB INTERCHANGE Software This chapter provides information about the supported functions for Allen-Bradley devices, and how to access these functions. 3.1 Accessing Allen-Bradley INTERCHANGE Functions DAS for AB INTERCHANGE software functions are accessed through the following BASEstar Classic device connection management interfaces: o Command line interface (CLI) o Menu interface o Application programming interface (API) Command Line Interface (CLI) To access the BASEstar Classic device connection management CLI, enter the following command at the DCL prompt ($): $ BSTAR DCM For information about BASEstar Classic device connection management commands, refer to the BASEstar Classic Command Line Interface User's Guide. Menu Interface To access the BASEstar Classic device connection management menu interface, enter the following command: $ BSTAR/MENU For additional information about the BASEstar Classic device connection management menu interface, refer to the BASEstar Classic Menu Interface User's Guide. Using the DAS for AB INTERCHANGE Software 3-1 Using the DAS for AB INTERCHANGE Software 3.1 Accessing Allen-Bradley INTERCHANGE Functions Application Programming Interface (API) For information on accessing BASEstar Classic device connection management callable services, refer to the BASEstar Classic Introduction to Callable Services. Not all device connection management functions are available through every interface. When a function is limited to a particular interface, it is described specifically in the description of the function. If a limitation is not specified, the function is available through all device connection management interfaces. 3.2 Supported Functions Table 3-1 describes the functions supported by the DAS for AB INTERCHANGE software. Table_3-1_Supported_Devices_and_Functions________________________ __________________Devices__________________ PLC-5 PLC-3 PLC-2 Function______________PLC_5/250___Family______Family______Family_ Read Data Yes Yes No No Write Data Yes Yes No No Start No No No No Stop No No No No Upload No Yes[1] No No Download No Yes[1] No No Read Status Yes Yes No No Loop Yes Yes No No Delete File No No No No Select File No No No No Directory No No No No Allocate-Deallocate No No No No Device-Specific No No No No Simple Compare No Yes[1] No No [1]Valid_only_for_the_INTERCHANGE_Software_for_OpenVMS_option.___ _________________________________________________________________ 3-2 Using the DAS for AB INTERCHANGE Software Using the DAS for AB INTERCHANGE Software 3.2 Supported Functions 3.2.1 Read and Write Data Functions Use the BASEstar Classic device connection management read data and write data functions to read data from and write data to a specific address in device memory. Address syntax is specific to each device or device family. The general format for specifying addresses for the PLC-5 /250 and the PLC-5 family devices is: $mFSf:nn/bb or $FSf:nn/bb where: m-module number - used for the PLC-5/250 only. FS-file specifier - specifies the device file type f -decimal file number nn-decimal element number rr-octal rack number bb-bit address - octal if following rr, decimal if following nn mne-sub-element or bit mnemonic The file specifiers for the PLC-5/250 and the PLC-5 family that are supported by the DAS for AB INTERCHANGE software are listed in Table 3-2. Using the DAS for AB INTERCHANGE Software 3-3 Using the DAS for AB INTERCHANGE Software 3.2 Supported Functions Table_3-2_Supported_PLC_section_files______________________ Native data Section Mnemonic type Raw Size in bytes PLC-5 _________________________________________PLC-5/250___family System S Signed word 2 2 Status Binary B Signed word 2 2 Integer N Signed word 2 2 ASCII A Signed word - 2 Long L Signed Long 4 - Floating F IEEE single 4 4 Point precision Timer T Structure 12 6 Counter C Structure 6 6 Message MSG Structure 112 - Message MG Structure - 112[1] Control R Structure 6 6 PID PD Structure 164 164[1] String ST Structure 84 84[1] Input I Signed word 2 2 Image Output O Signed word 2 2 Image [1]Valid_only_for_PLC-5_models_30,_40,_40L,_60_and_60L.____ ___________________________________________________________ For specific information regarding the addressing syntax for the Allen-Bradley PLC-5/250 and the PLC-5 family, refer to Allen-Bradley documentation for those devices. Table 3-3 describes how to access the read and write data functions through the BASEstar Classic interfaces. 3-4 Using the DAS for AB INTERCHANGE Software Using the DAS for AB INTERCHANGE Software 3.2 Supported Functions Table_3-3_Read_and_Write_Data_Interface_Access_____________ Interface___Function_Name__________________________________ CLI READ DATA READ PHYPOINT WRITE DATA WRITE PHYPOINT API ILAN$READ_DATA ILAN$READ_DATA_A ILAN$GET_DATA ILAN$WRITE_DATA ILAN$WRITE_DATA_A ILAN$PUT_DATA Menu DCM Devices Read Register DCM Devices Read Phypoint DCM Devices Write Register ____________DCM_Devices_Write_Phypoint_____________________ Example 3-1 shows the information displayed when you enter the READ DATA command. Example 3-1 READ DATA Output DCM> READ DATA DTL5/FORMAT=WORD/ADDRESS="$N17:0"/NUMBER=20 Device : DTL5 Address : $N17:0 Format : ARRAY[20]:S_WORD Data: 0 : 5 3 7 495 3504 495 366 7 : 297 6252 222 8771 5132 495 5133 14 : 495 5135 495 5139 495 0 Using the DAS for AB INTERCHANGE Software 3-5 Using the DAS for AB INTERCHANGE Software 3.2 Supported Functions Example 3-2 shows the information displayed when you enter the WRITE DATA command. Example 3-2 WRITE DATA Output DCM> WRITE DATA DTL5/FORMAT=BIT/ADDRESS="$B3:1/2" Device : DTL5 Address : $B3:1/2 Format : BIT Data value 0 : 1 3.2.2 Read Status Function The read status function issues a diagnostic status request to the device, interprets the device response, and returns the response as a character buffer. If a device definition does not match the device in the device response, an error message is displayed and the device definition must be corrected before you can perform an upload function or download function. Table 3-4 shows the how to access the read status function through the BASEstar Classic interfaces. Table_3-4_Read_Status_Interface_Access_____________________ Interface___Function_Name__________________________________ CLI READ STATUS API ILAN$READ_DEVICE_STATUS ILAN$READ_DEVICE_STATUS_A Menu________DCM_Devices_Status_____________________________ For more information about the READ STATUS command, refer to the BASEstar Classic Command Line Interface User's Guide. Example 3-3 and Example 3-4 provide example output of the READ STATUS command. Example 3-3 READ STATUS Output for PLC-5/250 (continued on next page) 3-6 Using the DAS for AB INTERCHANGE Software Using the DAS for AB INTERCHANGE Software 3.2 Supported Functions Example 3-3 (Cont.) READ STATUS Output for PLC-5/250 DCM> READ STATUS DTL52/FULL Status of device DTL52 at 22-DEC-1992 10:01:10.18 PLC Modes: Run PLC Type: PLC-5/250 Communication adapters: 5130-RM Octal station number: 0 Program change sequence: 54 Data change sequence: 18 User data change Sequence: 0 Example 3-4 READ STATUS Output for PLC-5 DCM> READ STATUS DTL5_3/FULL Status of device DTL5_3 at 22-DEC-1992 10:01:01.08 PLC Modes: Rem. program PLC Type: 1785-L40B (PLC-5/40B) Series B Revision B Communication adapters: 1785-LT (PLC-5) Octal station number: 3 Memory size in bytes: 98304 Number data table files: 40 Number program files: 5 I/O address if an adapter: 253 Baud rate: The read status function allows you to verify if the BASEstar Classic device definition MODEL attribute is compatible with the corresponding physical device. If the BASEstar Classic definition is not compatible, the read status function displays an informational message stating what the actual device is and what it was defined as in BASEstar Classic. 3.2.3 Upload and Download Functions The upload function transfers the contents of a device's memory to an OpenVMS file. The download function transfers the contents of an OpenVMS file to a device's memory. Upload and download functions are only supported for the INTERCHANGE Software for OpenVMS version of the DAS. Only PLC-5 processors (not including the PLC-5/250) may be uploaded or downloaded. Using the DAS for AB INTERCHANGE Software 3-7 Using the DAS for AB INTERCHANGE Software 3.2 Supported Functions Table 3-5 describes how to access the upload and download functions through the BASEstar Classic interfaces. Table_3-5_Upload_and_Download_Interface_Access_____________ Interface___Function_Name__________________________________ CLI UPLOAD DOWNLOAD API ILAN$UPLOAD_FILE ILAN$UPLOAD_FILE_A ILAN$DOWNLOAD_FILE ILAN$DOWNLOAD_FILE_A Menu DCM Devices Files Upload ____________DCM_Devices_Files_Download_____________________ Example 3-5 shows the CLI commands to upload and download files. Example 3-5 UPLOAD and DOWNLOAD Input DCM> UPLOAD device_name filename /QUALIFIER="RUNNING" DCM> DOWNLOAD device_name filename /QUALIFIER="CLEAR" In the first command, the BASEstar Classic device device_ name is being uploaded to file filename. The "RUNNING" qualifier allows the PLC to be uploaded while it is in RUN or REMOTE RUN mode. In the second command, the file filename is to be downloaded to device_name. The CLEAR qualifier is used to clear the faulted PLC, allowing the download to proceed. The DAS for AB INTERCHANGE software uses the Allen-Bradley INTERCHANGE Software for OpenVMS DTL_DOWNLOAD and DTL_ UPLOAD services to perform these functions. Consequently, the DAS for AB INTERCHANGE software upload and download functions have the same functional limitations. Note that communication failures between the BASEstar Classic system and a device being uploaded or downloaded may leave a device in an state that prevents further access from the DAS for AB INTERCHANGE software. If 3-8 Using the DAS for AB INTERCHANGE Software Using the DAS for AB INTERCHANGE Software 3.2 Supported Functions such an error occurs, refer to the appropriate Allen- Bradley documentation for that device for trouble shooting assistance. 3.2.3.1 DTL_DOWNLOAD For downloading, the OpenVMS file must have been created from the BASEstar Classic upload function or imported using the DCM_DTL$IMPORT_6200 utility. DCM_DTL$IMPORT_6200 creates a BASEstar Classic downloadable file from files generated from an Allen-Bradley's 6200 PLC-5 Programming Software environment or a INTERCHANGE Software for OpenVMS utility program. The default behavior of the DAS for AB INTERCHANGE software download allows download providing all of the following conditions are met: o The PLC is in program or remote program mode. o There are no major faults. o The revision and series of the PLC match the memory image to be downloaded. Table 3-6 describes the qualifiers used to modify the default download behavior. Using the DAS for AB INTERCHANGE Software 3-9 Using the DAS for AB INTERCHANGE Software 3.2 Supported Functions Table_3-6_Download_Qualifiers______________________________ Qualifier________Default__________Description______________ [NO]REMOTE NOREMOTE Enables download if the PLC is in REMOTE PROGRAM mode. The default is that the PLC must be in program mode. [NO]CHANGE_MODE NOCHANGE_MODE Changes the mode of PLC from remote run or remote test to remote program before starting download. The default behavior does not change the mode at the beginning of the download, nor does it reset the mode to remote run or remote test after completing the download. The REMOTE qualifier must also be used with CHANGE_MODE to enable downloading in REMOTE PROGRAM mode. [NO]CLEAR NOCLEAR Clears major faults on download if the PLC is faulted. The default is not to clear major faults. [NO]MATCH MATCH Download only if the PLC type, revision and series are an exact match. The default is not to download if the revision and series do __________________________________not_match._______________ The default values of these qualifiers may be modified through setting the BASEstar Classic parameter ILAN$_DTL_ DWNL_FLAGS. 3-10 Using the DAS for AB INTERCHANGE Software Using the DAS for AB INTERCHANGE Software 3.2 Supported Functions _______________________ Warning _______________________ Devices can control complex and perhaps dangerous industrial processes. Do not use the /CHANGE_ MODE qualifier until you take the required safety precautions and put required operating restrictions into effect. Refer to the device manufacturer's documentation for specific safety precautions. ______________________________________________________ 3.2.3.2 DTL_UPLOAD The default behavior of the upload function for DAS for AB INTERCHANGE software is to allow an upload to occur if the target PLC is not running and is not faulted. This behavior may be modified by using the upload qualifiers described in Table 3-7. Table_3-7_Upload_Qualifiers________________________________ Qualifier________Default__________Description______________ [NO]RUNNING NORUNNING Enables upload if the processor is in run mode. Note that the data table values may be changing. [NO]FAULT NOFAULT Enables upload when PLC has a major fault. Note archive files created from faulted PLC may be downloaded but not __________________________________compared.________________ To modify the default values of these qualifiers, use the BASEstar Classic parameter ILAN$_DTL_UPL_FLAGS. 3.2.4 Loop Diagnostic Function The loop function sends a diagnostic loop-back message and waits for a response. The source of the response depends upon the extent of the diagnostic message as determined by the LOOP command qualifier or the loop_flag argument to the device connection management callable service. Table 3-8 describes the path of the diagnostic message according to the specified parameter. Using the DAS for AB INTERCHANGE Software 3-11 Using the DAS for AB INTERCHANGE Software 3.2 Supported Functions ___________________________________________________________ Parameter_____________Response_____________________________ /PE Elapsed time ILAN$K_LOOP_PE /NI Elapsed time ILAN$K_LOOP_NI_____________________________________________ The Loop PE function sends a message to the PE and a response is returned by the PE. The Loop NI function is routed through the NI to the DTL server process. The server process returns the message back through the NI. The Loop NI function is a good method of determining the availability of the DTL server process. Table 3-8 describes how to access the loop diagnostic function through the BASEstar Classic interfaces. Table_3-8_Loop_Interface_Access____________________________ Interface___Function_Name__________________________________ CLI LOOP API ILAN$LOOP_DEVICE ILAN$LOOP_DEVICE_A Menu________Not_available__________________________________ Example 3-6 shows the information displayed by the LOOP command. Example 3-6 Loop Output DCM> LOOP DTL5/PE ELAPSED: 0 00:00:00.04 CPU: 0:00:00.03 BUFIO: 0 DIRIO: 0 FAULTS: 0 DCM> LOOP DTL5/NI ELAPSED: 0 00:00:00.11 CPU: 0:00:00.02 BUFIO: 0 DIRIO: 0 FAULTS: 0 3-12 Using the DAS for AB INTERCHANGE Software Using the DAS for AB INTERCHANGE Software 3.2 Supported Functions 3.2.5 Simple Compare Function The simple compare function allows a BASEstar Classic library file related to a device to be compared to another existing BASEstar Classic library file of the same type. The BASEstar Classic library file must have been uploaded into the library directly or imported by the appropriate library function. Simple compare is only supported by the INTERCHANGE Software for OpenVMS option of the DAS. Only PLC-5 family memory images (not including the PLC-5/250) may be compared. Table 3-9 describes how to access the simple compare function through the BASEstar Classic interfaces. Table_3-9_Simple_Compare_Interface_Access__________________ Interface___Function_Name__________________________________ CLI Not available API Not available Menu Library File Compare File Menu________Library_External_Compare_Device________________ The default compare behavior for DAS for AB INTERCHANGE software is controlled by the BASEstar Classic parameter ILAN$DTL_SCMP_FLAGS. The values and defaults for these compare qualifiers are described in Table 3-10. Using the DAS for AB INTERCHANGE Software 3-13 Using the DAS for AB INTERCHANGE Software 3.2 Supported Functions Table_3-10_Simple_Compare_Qualifiers_______________________ Qualifier________Default__________Description______________ ALL All compare options are checked [NO]TYPE TYPE Memory images must be of the same PLC type [NO]REVISION NOREVISION Memory images must be of the same PLC type, series and revision [NO]MEMSIZE MEMSIZE Memory images must have the same memory size [NO]NUMTABLES NUMTABLES Memory images must have the same number of data table files. [NO]NUMPROGRAMS NUMPROGRAMS Memory images must have the same number of program files. [NO]DATATABLES NODATATABLES Compare the data tables [NO]FORCES FORCES Compare the forces [NO]DIRECTORY DIRECTORY Compare program directories [NO]LADDER_______LADDER___________Compare_the_ladder_logic. 3.3 Structured Data Structured data is a block of data composed of multiple data elements. These data elements can have the same or different data types or formats. BASEstar Classic software's support of structured data allows complex information to be processed more efficiently. Regardless of whether a device supports the use of structured data, BASEstar Classic device connection management allows you to impose a structure on a contiguous block of device memory for read or write operations. For example, a device may store temperature and humidity data in contiguous positions in memory with a Longword representing temperature, and a word representing humidity. 3-14 Using the DAS for AB INTERCHANGE Software Using the DAS for AB INTERCHANGE Software 3.3 Structured Data The following format defines a physical point and specifies the physical point address as starting at the beginning of the Longword: /FORMAT="STRUCTURE(LONGWORD,WORD)" Using this format, device connection management references the data as a single structure. Physical points with a format of STRUCTURE can be connected to logical points with a format of STRUCTURE, allowing plant-wide distribution of the data. Structured logical points can represent synchronized data elements from a single source (such as a plant-floor device) or composite views of different data elements from different sources (such as the total part counts from several different plant-floor devices). 3.4 Supported Data Types The following data types are supported by the DAS for AB INTERCHANGE software: o BIT o ARRAY[]:BIT o S_BYTE o U_BYTE o S_WORD o U_WORD o S_LONGWORD o U_LONGWORD o F_FLOATING o STRING o ARRAY Using the DAS for AB INTERCHANGE Software 3-15 Using the DAS for AB INTERCHANGE Software 3.4 Supported Data Types 3.4.1 Structured Data Not all available data formats will work in a format of STRUCTURE. Table 3-11 lists the supported and unsupported formats for structured data: Table_3-11_Data_Formats_Supported_for_Structured_Data______ Format___________Supported___Unsupported___________________ BIT X[1] ARRAY[n]:BIT X[1,2] S_BYTE X[3] U_BYTE X[3] U_WORD X S_WORD X U_LONGWORD X S_LONGWORD X F_FLOAT X STRING:n X[3] ARRAY[n]: X[4] [1]The_use_of_the_BIT_or_BOOLEAN_format_in_structures_must_ be in contiguous multiples of eight (8). The length of the structure containing a bit field must be an even number of target elements. [2]The array size must be a multiple of 16 for PLC-5 family devices. The array size must be less than or equal to 16 for the PLC-5/250. [3]The size must be an even multiple of 2 bytes or characters. [4]The size of the array must be an even multiple of the target PLC data type. For example: ARRAY[3]:S_WORD for a Longword target would not be valid. The forth word would have to be padded out by making the array size 4 or adding other members to a structure. ___________________________________________________________ 3-16 Using the DAS for AB INTERCHANGE Software Using the DAS for AB INTERCHANGE Software 3.4 Supported Data Types 3.4.2 Restrictions to Data Formats This section describes restrictions and limitations to data format usage. o BIT - For the PLC-5 family, the only data formats which are valid for bit writes are single bits or bit arrays with sizes that match that of the target element. For example the only valid formats for writing to a PLC-5 binary file would be: /FORM=BIT/NUMBER=1 /FORM=BIT/NUMBER=16 /FORM=ARRAY[16]:BIT The use of the BIT or BOOLEAN format in structures must be in contiguous multiples of eight (8). A field can contain less than 8 bits as long as there is another bit field (or bit fields) contiguous to it that makes the total 8 bits. The length of the structure must be an even number of target elements. Bit writes are of less than 16 bits are allowed for PI (PLC-5/250) devices. Bit writes cannot span element boundaries, unless the bit array is an even multiple of the element size. o BYTE - The PLC-5/250 and the PLC-5 family are word- oriented devices. The byte formats are only valid in the context of a structure. The byte formats may be used on any file type; the restriction is that the number of bytes used in the format must be a multiple of the PLC data element being accessed. Normally this is two for integer and binary files and Longword files are four. Other structured PLC elements such as timers and counters vary. Refer to the Allen-Bradley documentation for more information. o STRING - The BASEstar Classic STRING data type may be used for any PLC file type with the following restrictions: - When used within a STRUCTURE, the length must be a multiple of two characters - When used to access string section files (ST) on PLC- 5/250 or PLC-5 family devices, the maximum length of the string is 82 bytes. Using the DAS for AB INTERCHANGE Software 3-17 Using the DAS for AB INTERCHANGE Software 3.4 Supported Data Types - When accessing string section files, lengths smaller than 82 may be used. However an error is returned if the actual length of a string on the PLC is longer that specified in the STRING format. - The DAS for AB INTERCHANGE software expects the bytes to be in Allen-Bradley byte swapped order. o F_FLOATING - The BASEstar Classic data type F_FLOATING may be used on PLC floating point files with no restrictions. There are, however, some behaviors with the BASEstar Classic F_FLOATING format and PLC floating point files that should be taken into consideration. When using the F_FLOATING format on PLC files other than floating, the value is converted to and from an integer, thereby truncating the fractional part. For example: writing the value of 1.324E+2 to an integer address using the F_FLOATING format results in the integer value of 132 being placed at the address. Reading it back, using the same format, results in 1.320E+2 being returned. When using the F_FLOATING format within a STRUCTURE data type, the DAS for AB INTERCHANGE software assumes the data on the PLC is formatted in the IEEE floating format. If this is not the case, data could be incorrectly converted when reading or writing. 3.5 Automatic Data Collection The following section describe unsolicited data collection and pollset for the DAS for AB INTERCHANGE software. 3.5.1 Unsolicited Data Collection BASEstar Classic device connection management can receive data values generated by plant devices without issuing a request. To use this unsolicited data collection capability, the devices and physical points must be correctly defined using BASEstar Classic software. For information on defining devices and data for unsolicited collection, refer to the BASEstar Classic Command Line Interface User's Guide. 3-18 Using the DAS for AB INTERCHANGE Software Using the DAS for AB INTERCHANGE Software 3.5 Automatic Data Collection Allen-Bradley devices can send unsolicited messages to the VAX host. To enable unsolicited messaging, define the device (and any required physical points) as unsolicited and enable the device, as follows: DCM> MODIFY DEVICE device_name /UNSOLICITED/ENABLE The DAS posts an unsolicited read request to the device. When the device sends an unsolicited message to the DAS, the read operation completes and the DAS forwards the message to BASEstar Classic device connection management software. Messages sent from the PLC's and received by the DAS through the INTERCHANGE software are identified by an identifier. This identifier is referred to in INTERCHANGE documentation as the application address. In BASEstar Classic software, this is the unsolicited identifier, whose format is an octal value ranging from 0 to 77777. Unsolicited data may be sent from multiple devices with the same ID, only if the size and format are consistent. The INTERCHANGE software will reject unsolicited messages that are inconsistent. The maximum unsolicited message size is 2000 bytes for local PLC-5/250 or 236 bytes for devices connected to a Pyramid Integrator via Data Highway. The DAS for AB INTERCHANGE software supports only unique unsolicited identifiers defined for an individual device. Digital recommends that the address of the phypoint match the PLC-5 Data Table Address of the message instruction. The Allen-Bradley PLC-5/250 and PLC-5 family sends unsolicited data to the VAX and through the INTERCHANGE software by means of the message (MSG) instruction. The values of some elements in the message instruction are critical for successfully sending data from the PLC to the DAS. The critical definitions in the message instruction are listed in Table 3-12 and Table 3-13. Using the DAS for AB INTERCHANGE Software 3-19 Using the DAS for AB INTERCHANGE Software 3.5 Automatic Data Collection Table_3-12_PLC-5_MSG_Instruction_for_Unsolicited_Data______ Command_field______________Value___________________________ Communication Command: PLC-2 UNPROTECTED WRITE Size in elements: Must match the format of the unsolicited point Destination Data Table The unsolicited ID value Address Local/Remote Local Local_Node_Address_________DH/DH+_address_of_the_EI_module_ Table_3-13_PLC-5/250_MSG_Instruction_for_Unsolicited_Data__ Command_field______________Value___________________________ Module ID CLASS= UAM Local/Remote Local Local Node Address DH/DH+ address of the EI module Communication Command: PLC-2 UNPROTECTED WRITE External Data Addr The unsolicited ID value Requested Size: Must match the format of the ___________________________unsolicited_point_______________ For more specific information on how to program the PLC's, refer to the Allen-Bradley INTERCHANGE reference and the programming manuals for the PLC-5/250 and PLC-5. The following is an example of an unsolicited phypoint definition. This phypoint is a 100 word array starting at address $N17:0 on device DTL5. The unsolicited ID is 200 octal. DCM> DEFINE PHYPOINT - /DEV=DTL5 - /ADDR="$N17:0" - /FORM=ARRAY[100]:WORD - /UNSOL=200 - /COLLECT 3-20 Using the DAS for AB INTERCHANGE Software Using the DAS for AB INTERCHANGE Software 3.5 Automatic Data Collection The corresponding message instruction definition for a PLC-5 would appear as follows: MESSAGE INSTRUCTION DATA ENTRY FOR CONTROL BLOCK MG10:1 Communication Command: PLC-2 UNPROTECTED WRITE PLC-5 Data Table Address: N17:0 Size in Elements: 100 Local/Remote: LOCAL Remote Station: N/A Link ID: N/A Remote Link Type: N/A Local Node Address: 01 Destination Data Table Address: 200 Port Number: 1A In this configuration, the PLC-5 is connected to the PI through the DH/DH+ port 1A. The corresponding message instruction definition for a PLC-5/250 (with address $0N17:0) would appear as follows: CONTROL BLOCK 0MSG0:1 F1 Module ID: Class = UAM Pw# = 1 Port# = 1 F2 Priority: HIGH F3 Local/Remote: LOCAL F4 Local Link Type: DH+ F5 Remote Link Type: N/A F6 Station ID: Node# = 0 F7 Communication Command: PLC-2 UNPROTECTED WRITE F8 Internal Data Table Addr: 0N17:0 F9 External Data Table Addr: 0200 Parameters: N/A F10 Requested Size: 100 In this configuration, the PLC-5/250 is in the Pyramid Integrator chassis with the Ethernet Interface Module and the DH+ station ID is 0. There is a restriction concerning the assignment of the unsolicited identifiers to DAS for AB INTERCHANGE software phypoints. The Ethernet Interface only allows one destination for an unsolicited ID. All messages coming from networked PLCs with a particular message ID are routed to only one destination on the TCP/IP network. If a Using the DAS for AB INTERCHANGE Software 3-21 Using the DAS for AB INTERCHANGE Software 3.5 Automatic Data Collection INTERCHANGE application and a BASEstar Classic unsolicited point attempt to request data for the same ID, only one will be successful; the other will be returned with an error. The same is true for multiple BASEstar Classic systems. Only one BASEstar Classic system can use an unsolicited ID if they are going through the same Ethernet Interface. Figure 3-1 and Figure 3-2 show a valid and an invalid configuration. Figure 3-1 Valid Unsolicited ID Configuration Figure 3-1 illustrates a valid unsolicited configuration. The BASEstar Classic system ALPHA has two unsolicited physical points with the same unsolicited ID of 200 octal. The configuration is valid only because the two physical points are on different devices and their format and sizes are identical. BASEstar Classic system BETA also has a physical point from device D1; because of the restriction, however, a different unsolicited ID must be used. Figure 3-2 Invalid Unsolicited ID Configuration Figure 3-2 illustrates an invalid unsolicited configuration. Here both BASEstar Classic systems are attempting to use the same unsolicited ID (that both phypoints are on the same device is irrelevant). This is an invalid configuration because both BASEstar Classic systems need to route through the same Ethernet Interface module to access the unsolicited data. 3-22 Using the DAS for AB INTERCHANGE Software Using the DAS for AB INTERCHANGE Software 3.5 Automatic Data Collection 3.5.2 Pollsets BASEstar Classic device connection management physical points may be grouped together into pollsets to optimize data collection. Pollsets created for the Allen-Bradley devices have the following limitations: o Physical points of differing data types cannot be part of the same pollset. For example, a physical point of type WORD and a physical point of type BIT cannot be members of the same pollset. Physical points of the same data type with varying element counts can reside in the same pollset. o The maximum solicited read/write operation is 2000 bytes for local PLC-5/250 or 236 bytes for devices connected to a Pyramid Integrator via Data Highway. The size of any pollset cannot exceed these maximum contiguous bytes limits, regardless of the number of physical points in the pollset. Therefore, the first byte of the physical point with the lowest address cannot be more than the maximum bytes away from the last byte of the physical point with the highest address. o Points that are defined as format structure can be polled, provided that the structures of all the points in the pollset are identical. o Members of pollsets created for the PLC-5 family must have identical file numbers. o PLC-5/250 pollsets members must have identical module numbers. For more information on physical points, refer to the BASEstar Classic Command Line Interface User's Guide. 3.6 Supporting Utilities for the DAS for AB INTERCHANGE Software Three utilities are provided with BASEstar Classic DAS for Allen-Bradley INTERCHANGE software. These utilities provide logistical and maintenance support for the DAS. These utilities are: o BCC$SYSTEM:DCM_DTL$SRV_STOP - stop server process o BCC$SYSTEM:DCM_DTL$IMPORT_6200 - import 6200 Series Programming software files Using the DAS for AB INTERCHANGE Software 3-23 Using the DAS for AB INTERCHANGE Software 3.6 Supporting Utilities for the DAS for AB INTERCHANGE Software o BCC$SYSTEM:DCM_DTL$EXPORT_6200 - export 6200 Series Programming Software files These files utilities will be discussed in the following sections. 3.6.1 Stop Server Utility This utility is used to stop one or more of the INTERCHANGE server process if that should be come necessary. There are some instances where anomalies outside of the control of the DAS for AB INTERCHANGE software cause a INTERCHANGE server process to no longer function properly. In most cases, this is cleared up by shutting down the server process and starting it up again. Stopping a server is done by sending a shutdown message. It should be noted that if the server is not in a state where it can process messages, it may be necessary to kill the process in some other way ($STOP/ID=). Example 3-7 provides an example of how to use the stop INTERCHANGE Server utility. Example 3-7 Stop Server Utility $ DTLSRV_STOP:==$BCC$SYSTEM:DCM_DTL$SRV_STOP $ DTLSRV_STOP srv_id Where: srv_id is the number of the server or *. The number of the server can be obtained by looking at the BASEstar Classic history file. Both the INTERCHANGE server and ILAN$DEVSRV logs a message correlating server with the Ethernet interface it is connecting to. An asterisk (*) will send a shutdown message to all known servers. 3-24 Using the DAS for AB INTERCHANGE Software Using the DAS for AB INTERCHANGE Software 3.6 Supporting Utilities for the DAS for AB INTERCHANGE Software 3.6.2 Supporting Utilities for Allen-Bradley 6200 Series Software Allen-Bradley 6200 Series Programming Software for the PLC- 5 family provides online and off line programming of PLC-5, as well as upload, download, and compare operations. Allen- Bradley supports this software on both OpenVMS and DOS operating systems. 6200 software also supports the transfer of files between VAX systems and DOS-based T50 programming terminals using KERMIT. Allen-Bradley 6200 programming software organizes and manipulates a PLC-5's memory image in multiple files. BASEstar Classic device connection management software performs uploads, downloads, and compares using only a single file. Because of this incompatibility, the DAS for AB INTERCHANGE software provides two utilities to transfer compatible files between the Allen-Bradley 6200 programming software and the DAS for AB INTERCHANGE software environments. The following sections describe how to use these utilities. 3.6.3 Import 6200 File Utility The Import 6200 File Utility copies a PLC-5 memory image from a 6200 Programming software environment into a DAS for AB INTERCHANGE software downloadable file. Example 3-8 provides an example of how to use the Import 6200 File utility. Example 3-8 Import 6200 File Utility $ IMPORT6200:==$BCC$SYSTEM:DCM_DTL$IMPORT_6200 $ IMPORT6200 6200_file dcm_file Where: 6200_file is the file name of the files produced in the set up. dcm_file is the name of the BASEstar Classic downloadable file. By convention, use the file extension .LOGIC_PROGRAM Using the DAS for AB INTERCHANGE Software 3-25 Using the DAS for AB INTERCHANGE Software 3.6 Supporting Utilities for the DAS for AB INTERCHANGE Software Three 6200 files are required. They must have the same file name and their extensions must be .AF5, .D1$, and .P1$. If these files are not in the same directory, or one or more is missing, the import utility will fail. 3.6.4 Export 6200 File Utility The Export 6200 File Utility creates the necessary 6200 Programming Software files from a DAS for AB INTERCHANGE software downloadable file. Example 3-9 Export 6200 File Utility $ EXPORT6200:==$BCC$SYSTEM:DCM_DTL$EXPORT_6200 $ EXPORT6200 dcm_file 6200_file Where: dcm_file is the name of a file that was uploaded from BASEstar Classic software. 6200_file is the file name for the 6200 compatible files. Three files will be created by the export utility. The utility provides the directory and file names, as well as file extensions of .AF5, .D1$, AND .P1$. 3-26 Using the DAS for AB INTERCHANGE Software A _________________________________________________________________ Allen-Bradley PLC-5/250 Addressing Table A-1 provides the addressing mnemonics for Allen- Bradley PLC5/250 models. Table_A-1_Supported_PLC-5/250_Addresses_and_Data_Types___________ PLC Data_Section_________PLC_Address_Format_______________Format_____ Byte Size Outputs $O:000/000 - $O377/15 Unsigned 2 Word Inputs $I000/00 - $I377/15 Unsigned 2 Word Forced internal $IS:000 - $IS:777 Signed 2 Storage Word Binary $nB0000:0000/00 - $nB9999:9999 Signed 2 /15 Word Integer $nN0000:0000/00 - $nN9999:9999 Signed 2 /15 word Long Integer $nL0000:0000/00 - $nL9999:9999 Signed 4 /15 long Floating point $nF0000:0000/00 - $nF9999:9999 Floating 4 /15 Point[1] Addapter Status $AS00:0,1,2,3 - $AS37:0,1,2,3 Structure 4 System Public $0S:0 - $0S:350 Word 2 Status Module Public $nS:0 - $nS:20 Word 2 Status [1]In_IEEE_32_bit_floating_point_format._________________________ (continued on next page) Allen-Bradley PLC-5/250 Addressing A-1 Allen-Bradley PLC-5/250 Addressing Table_A-1_(Cont.)_Supported_PLC-5/250_Addresses_and_Data_Types___ PLC Data_Section_________PLC_Address_Format_______________Format_____ Byte Size Timer structure $nT0000:0000/00 - $nT9999:9999 Structure 12 /15 _______________________________ Mnemonic_Instruction___Type____ .EN Enable Bit .TT Timing Bit .DN Done Bit .PRE Preset Long Value .ACC Accumulated Long _________Value_________________ Counter Structure $nC0000:0000/00 - $nC9999:9999 Structure 6 /15 _______________________________ Mnemonic_Instruction___Type____ .CU Up Enable Bit .CD Down Enable Bit .DN Done Bit .OV Overflow Bit .UN Underflow Bit .PRE Preset Word Value .ACC Accumulated Word _________Value_________________ String $nST0000:0000/00 - Structure[2]84 $nST9999:9999/15 _______________________________ Mnemonic_Instruction___Type____ .LEN Length Word .DATA[] Position 82 _______________________Bytes___ [2]Data_in_the_.DATA_portion_of_the_structure_is_byte_swaped.____ (continued on next page) A-2 Allen-Bradley PLC-5/250 Addressing Allen-Bradley PLC-5/250 Addressing Table_A-1_(Cont.)_Supported_PLC-5/250_Addresses_and_Data_Types___ PLC Data_Section_________PLC_Address_Format_______________Format_____ Byte Size Control $nR0000:0000/00 - $nR9999:9999 Structure 6 /15 _______________________________ Mnemonic_Instruction___Type____ .EN Enable Bit .WU Enable Bit Unloading .DN Done Bit .EM Empty Bit .ER Error Bit .UL Unload Bit .IN Inhibit Bit Comparisons .FD Found Bit .LEN Length Word .POS_____Position______word____ (continued on next page) Allen-Bradley PLC-5/250 Addressing A-3 Allen-Bradley PLC-5/250 Addressing Table_A-1_(Cont.)_Supported_PLC-5/250_Addresses_and_Data_Types___ PLC Data_Section_________PLC_Address_Format_______________Format_____ Byte Size Message Control $nMSG0000:0000 - Structure 112 $nMSG9999:9999/15 _______________________________ Mnemonic_Instruction___Type____ .EN Enable Bit .ST Start Bit Transmision .AD Asynchronous Bit Done .AE Asynchronous Bit Error .CO Continuous Bit .EW Enabled Bit Waiting .DN Done Bit .ER Error Bit .ERR Error Code Word .RLEN Requested Word Length .DLEN Done Length Word .DATA Reserved 52 /Interim Words _________Use___________________ (continued on next page) A-4 Allen-Bradley PLC-5/250 Addressing Allen-Bradley PLC-5/250 Addressing Table_A-1_(Cont.)_Supported_PLC-5/250_Addresses_and_Data_Types___ PLC Data_Section_________PLC_Address_Format_______________Format_____ Byte Size PID Control $nPD0000:0000/00 - Structure 164 $nPD9999:9999/15 _______________________________ Mnemonic_Instruction___Type____ .EN Enable Bit .CT Cascaded Bit Type .CL Cascaded Bit Loop .PVT PV Tracking Bit .DO Derivative Bit Of .SWM Software Bit A/M Mode .CA Control Bit Action .MO Mode Bit .PE PID Bit Equation .INI PID Bit Initialized .SPOR SP Out of Bit Range .OLL Output Bit Limit Low .OLH Output Bit Limit High .EWD Error Bit Within Deadband .DVNA Deviation Bit High Alarm .DVPA Deviation Bit Low Alarm .PVLA PV Low Bit Alarm .PVHA PV High Bit _________Alarm_________________ (continued on next page) Allen-Bradley PLC-5/250 Addressing A-5 Allen-Bradley PLC-5/250 Addressing Table_A-1_(Cont.)_Supported_PLC-5/250_Addresses_and_Data_Types___ PLC Data_Section_________PLC_Address_Format_______________Format_____ Byte Size PID Control $nPD0000:0000/00 - Structure 164 $nPD9999:9999/15 _______________________________ Mnemonic_Instruction___Type____ .SP Setpoint Floating .KP Proportional Floating Gain .KI Integral Floating Gain .KD Derivative Floating Time .BIAS Output Bias Floating % .MAXS Setpoint Floating Maximum .MINS Setpoint Floating Minimum .DB Deadband Floating .SO Set Output Floating % .MAXO Output Floating Limit High % .MINO Output Floating Limit Low % .UPD Update Time Floating .PV Process Floating Variable .ERR Error Floating .OUT Output Floating .PVH PV Alarm Floating High .PVL PV Alarm Floating Low .DVP Deviation Floating Alarm + .DVN Deviation Floating Alarm - .PVDB PV Deadband Floating .MAXI Input Range Floating Maximum A-6 Allen-Bradley PLC-5/250 Addressingnge Floating Minimum .TIE Tieback % Floating .ADDR Address of bytes Master Loop % .DVDB Deviation Floating Alarm Deadband .DATA[] Reserved 14 /Interim Floating _________Use___________________ _________________________________________________________________ B _________________________________________________________________ Allen-Bradley PLC-5 Family Addressing Table B-1 provides the addressing mnemonics for Allen- Bradley PLC5 family models. Table_B-1_Supported_PLC-5_Family_Addresses_and_Data_Types________ PLC Data_Section_________PLC_Address_Format_______________Format_____ Byte Size Outputs $O0/0 - $O37/17 ($O277/17 for Unsigned 2 new modles) Word Inputs $I0/0 - $I37/17 ($I1277/17 for Unsigned 2 new modles) Word ASCII[2] $A:3/0 - $A999:999/15 Signed 2 Word BCD $D?:0/0 - $D999:999/15 Signed 2 Word Binary $B3:0/0 - $B999:999/15 Signed 2 Word Integer $N7:0/0 - $N999:999/15 Signed 2 word Floating point $F8:0/0 - $F999:999/15 Floating 4 Point[1] System Public $0S:0/0 - $0S:128/15 Word 2 Status [1]In_IEEE_32_bit_floating_point_format._________________________ [2]Not supported on PLC-5/10, -5/12, -5/15, -5/25 models. (continued on next page) Allen-Bradley PLC-5 Family Addressing B-1 Allen-Bradley PLC-5 Family Addressing Table_B-1_(Cont.)_Supported_PLC-5_Family_Addresses_and_Data_Types PLC Data_Section_________PLC_Address_Format_______________Format_____ Byte Size Timer structure $T4:0 - $T999:999 Structure 6 _______________________________ Mnemonic_Instruction___Type____ .EN Enable Bit .TT Timing Bit .DN Done Bit .PRE Preset Word Value .ACC Accumulated Word _________Value_________________ Counter Structure $C5:0 - $C999:999 Structure 6 _______________________________ Mnemonic_Instruction___Type____ .CU Up Enable Bit .CD Down Enable Bit .DN Done Bit .OV Overflow Bit .UN Underflow Bit .PRE Preset Word Value .ACC Accumulated Word _________Value_________________ (continued on next page) B-2 Allen-Bradley PLC-5 Family Addressing Allen-Bradley PLC-5 Family Addressing Table_B-1_(Cont.)_Supported_PLC-5_Family_Addresses_and_Data_Types PLC Data_Section_________PLC_Address_Format_______________Format_____ Byte Size Control $R6:0 - $R999:999 Structure 6 _______________________________ Mnemonic_Instruction___Type____ .EN Enable Bit .EU Enable Bit Unloading .DN Done Bit .EM Empty Bit .ER Error Bit .UL Unload Bit .IN Inhibit Bit Comparisons .FD Found Bit .LEN Length Word .POS_____Position______word____ Message[2] $MG9:0 - $MG999:584 Structure 112 _______________________________ Mnemonic_Instruction___Type____ .NR No Response Bit .EN Enable Bit .TO Timeout Bit .ST Start Bit .AD Async done Bit .AE Async error Bit .CO Continuous Bit .EW Enable Bit waiting .DN Done Bit .ER Error Bit .ERR Error Word .RLEN Receive Word length .DLEN____Done_length___Word____ [2]Not_supported_on_PLC-5/10,_-5/12,_-5/15,_-5/25_models.________ (continued on next page) Allen-Bradley PLC-5 Family Addressing B-3 Allen-Bradley PLC-5 Family Addressing Table_B-1_(Cont.)_Supported_PLC-5_Family_Addresses_and_Data_Types PLC Data_Section_________PLC_Address_Format_______________Format_____ Byte Size PID Control[2] $PD9:000 - $PD999:398 Structure 164 _______________________________ Mnemonic_Instruction___Type____ .EN Enable Bit .CT Cascaded Bit Type .CL Cascaded Bit Loop .PVT PV Tracking Bit .DO Derivative Bit Of .SWM Software Bit A/M Mode .CA Control Bit Action .MO Mode Bit .PE PID Bit Equation .INI PID Bit Initialized .SPOR SP Out of Bit Range .OLL Output Bit Limit Low .OLH Output Bit Limit High .EWD Error Bit Within Deadband .DVNA Deviation Bit High Alarm .DVPA Deviation Bit Low Alarm .PVLA PV Low Bit Alarm .PVHA PV High Bit _________Alarm_________________ (continued on next page) B-4 Allen-Bradley PLC-5 Family Addressing Allen-Bradley PLC-5 Family Addressing Table_B-1_(Cont.)_Supported_PLC-5_Family_Addresses_and_Data_Types PLC Data_Section_________PLC_Address_Format_______________Format_____ Byte Size [2]Not_supported_on_PLC-5/10,_-5/12,_-5/15,_-5/25_models.________ (continued on next page) Allen-Bradley PLC-5 Family Addressing B-5 Allen-Bradley PLC-5 Family Addressing Table_B-1_(Cont.)_Supported_PLC-5_Family_Addresses_and_Data_Types PLC Data_Section_________PLC_Address_Format_______________Format_____ Byte Size PID Control[2] $PD9:000 - $PD999:398 Structure 164 _______________________________ Mnemonic_Instruction___Type____ .SP Setpoint Floating .KP Proportional Floating Gain .KI Integral Floating Gain .KD Derivative Floating Time .BIAS Output Bias Floating % .MAXS Setpoint Floating Maximum .MINS Setpoint Floating Minimum .DB Deadband Floating .SO Set Output Floating % .MAXO Output Floating Limit High % .MINO Output Floating Limit Low % .UPD Update Time Floating .PV Process Floating Variable .ERR Error Floating .OUT Output Floating .PVH PV Alarm Floating High .PVL PV Alarm Floating Low .DVP Deviation Floating Alarm + .DVN Deviation Floating Alarm - .PVDB PV Deadband Floating .MAXI Input Range Floating Maximum .MINI Input Range Floating B-6 Allen-Bradley PLC-5 FamilyMAddressing .TIE Tieback % Floating .ADDR Address of bytes Master Loop % .DVDB Deviation Floating Alarm Deadband .DATA Reserved 14 /Interim Floating _________Use___________________ (continued on next page) Allen-Bradley PLC-5 Family Addressing Table_B-1_(Cont.)_Supported_PLC-5_Family_Addresses_and_Data_Types PLC Data_Section_________PLC_Address_Format_______________Format_____ Byte Size SFC status[2] $SC9:0/0 - $SC999:999/15 Structure 6 _______________________________ Mnemonic_Instruction___Type____ .EN Enable Bit .SA Scan active Bit .FS First Scan Bit .LS Last Scan Bit .OV Timer Bit overflow .ER Step Bit errored .TIM Active Time Word .PRE Preset Word _________Value_________________ String $ST0:0 - $ST999:779 Structure[2]84 _______________________________ Mnemonic_Instruction___Type____ .LEN Length Word .DATA Position 82 _______________________Bytes___ [2]Not_supported_on_PLC-5/10,_-5/12,_-5/15,_-5/25_models.________ _________________________________________________________________ Allen-Bradley PLC-5 Family Addressing B-7 C _________________________________________________________________ Sample Installation Procedure Example C-1 is an example of a DAS for AB INTERCHANGE software installation for the INTERCHANGE Software for the PI MicroVAX option. Example C-1 PI Installation Sample VAX/VMS Software Product Installation Procedure V5.5-2 It is 4-OCT-1996 at 14:15. Enter a question mark (?) at any time for help. * Are you satisfied with the backup of your system disk [YES]? The following products will be processed: DCM_DTL V3.4 Beginning installation of DCM_DTL V034at 14:15 %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 1992, 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. (continued on next page) Sample Installation Procedure C-1 Sample Installation Procedure Example C-1 (Cont.) PI Installation Sample BASEstar Classic DAS for Allen-Bradley INTERCHANGE Software installation procedure. Checking for a valid license... Product: DAS-DTL-CL Producer: DEC Version: 3.4 Release Date: 13-DEC-1996 * Does this product have an authorization key registered and loaded? Y Now checking OpenVMS version... Now checking that BASEstar Classic is installed... The BASEstar Classic DAS for Allen-Bradley INTERCHANGE Software installs as two variants: 1) Support for INTERCHANGE Software for OpenVMS. This communicates to Allen-Bradley devices from an OpenVMS system through an Ethernet Interface. 2) Support for INTERCHANGE Software for PI MicroVAX. This option runs only on a PI MicroVAX embedded in a Pyramid Integrator Chassis. Communication to Allen-Bradley devices is over the backplane interface (BPI). These two options are mutually exclusive and require the corresponding type of Allen-Bradley INTERCHANGE Software to be installed. * Do you wish to install the Ethernet version of the DAS? Y %DCM_DTLVVT-I-DTLNET, Installing Ethernet version of the DAS... Now checking INTERCHANGE software version... Now checking disk space... Now checking BASEstar Classic message port quota... (continued on next page) C-2 Sample Installation Procedure Sample Installation Procedure Example C-1 (Cont.) PI Installation Sample The current value for BCC$MAX_PORT_QUOTA of 50000 is too low for the BASEstar Classic DAS for Allen-Bradley INTERCHANGE Software. * Value to set BCC$MAX_PORT_QUOTA to [100000]: The new BCC$MAX_PORT_QUOTA will take effect the next time that BASEstar Classic is restarted. Restart BASEstar Classic software before attempting to use this DAS. * Do you want to purge files replaced by this installation [YES]? * Do you want to run the IVP after the installation [YES]? The installation procedure has no further questions to ask and will complete in 5 to 10 minutes depending on the system and system load. %VMSINSTAL-I-RESTORE, Restoring product save set B ... The configuration template file for DTL support, DCM_DTL_CONFIG.TEMPLATE, is used to define the Allen-Bradley paths, types, and devices. Edit this file, as necessary, to reflect your specific site configuration. During installation it will be placed in the directory BCC$SYSDATA. The BASEstar Classic parameter ILAN$DTL_TIMEOUT has just been created. Parameter ILAN$DTL_TIMEOUT, type Value. Current value is 1000, Default value is 1000. Minimum value is 100, Maximum value is 600000. The BASEstar Classic parameter ILAN$DTL_MAX_ELEMENTS has just been created. Parameter ILAN$DTL_MAX_ELEMENTS, type Value. Current value is 500, Default value is 500. Minimum value is 50, Maximum value is 100000. The BASEstar Classic parameter ILAN$DTL_BACKLOG has just been created. Parameter ILAN$DTL_BACKLOG, type Value. Current value is 5, Default value is 5. Minimum value is 1, Maximum value is 40. The BASEstar Classic parameter ILAN$DTL_CYCLE_TIME has just been created. (continued on next page) Sample Installation Procedure C-3 Sample Installation Procedure Example C-1 (Cont.) PI Installation Sample Parameter ILAN$DTL_CYCLE_TIME, type Value. Current value is 70, Default value is 70. Minimum value is 5, Maximum value is 1000. The BASEstar Classic parameter ILAN$DTL_MAX_UNSOL_ELEMENTS has just been created. Parameter ILAN$DTL_MAX_UNSOL_ELEMENTS, type Value. Current value is 100, Default value is 100. Minimum value is 50, Maximum value is 10000. The BASEstar Classic parameter ILAN$DTL_UPL_FLAGS has just been created. Parameter ILAN$DTL_UPL_FLAGS, type String. Current value is "NORUNNING,NOFAULT", Default value is "NORUNNING,NOFAULT". The BASEstar Classic parameter ILAN$DTL_DWNL_FLAGS has just been created. Parameter ILAN$DTL_DWNL_FLAGS, type String. Current value is "MATCH", Default value is "MATCH". The BASEstar Classic parameter ILAN$DTL_SCMP_FLAGS has just been created. Parameter ILAN$DTL_SCMP_FLAGS, type String. Current value is "ALL,NODATATABLES,NOREVISION", Default value is "ALL,NODAT ATABLES,NOREVISION". The BASEstar Classic parameter ILAN$DTL_UDC_TIMEOUT has just been created. Parameter ILAN$DTL_UDC_TIMEOUT, type Value. Current value is 300000, Default value is 300000. Minimum value is 1000, Maximum value is 3600000. The BASEstar Classic parameter ILAN$DTLSRV_PRIORITY has just been created. (continued on next page) C-4 Sample Installation Procedure Sample Installation Procedure Example C-1 (Cont.) PI Installation Sample Parameter ILAN$DTLSRV_PRIORITY, type Value. Current value is 6, Default value is 6. Minimum value is 1, Maximum value is 10. %VMSINSTAL-I-MOVEFILES, Files will now be moved to their target directories... Copyright (C) Digital Equipment Corporation 1992, 1996. All rights reserved. Executing the Installation Verification Procedure. Parameter ILAN$DTL_BACKLOG, type Value. Current value is 5, Default value is 5. Minimum value is 1, Maximum value is 40. Parameter ILAN$DTL_CYCLE_TIME, type Value. Current value is 70, Default value is 70. Minimum value is 5, Maximum value is 1000. Parameter ILAN$DTL_MAX_ELEMENTS, type Value. Current value is 500, Default value is 500. Minimum value is 50, Maximum value is 100000. Parameter ILAN$DTL_MAX_UNSOL_ELEMENTS, type Value. Current value is 100, Default value is 100. Minimum value is 50, Maximum value is 10000. Parameter ILAN$DTL_TIMEOUT, type Value. Current value is 1000, Default value is 1000. Minimum value is 100, Maximum value is 600000. Parameter ILAN$DTL_UPL_FLAGS, type String. Current value is "NORUNNING,NOFAULT", Default value is "NORUNNING,NOFAULT". Parameter ILAN$DTL_DWNL_FLAGS, type String. Current value is "MATCH", Default value is "MATCH". Parameter ILAN$DTL_SCMP_FLAGS, type String. Current value is "ALL,NODATATABLES,NOREVISION", Default value is "ALL,NODAT ATABLES,NOREVISION". Parameter ILAN$DTL_UDC_TIMEOUT, type Value. Current value is 300000, Default value is 300000. Minimum value is 1000, Maximum value is 3600000. (continued on next page) Sample Installation Procedure C-5 Sample Installation Procedure Example C-1 (Cont.) PI Installation Sample Parameter ILAN$DTLSRV_PRIORITY, type Value. Current value is 6, Default value is 6. Minimum value is 1, Maximum value is 10. BASEstar Classic DAS for Allen-Bradley INTERCHANGE Software installation procedure has succeeded. Installation of DCM_DTL V3.4 completed at 14:20 VMSINSTAL procedure done at 14:20 C-6 Sample Installation Procedure D _________________________________________________________________ DAS for AB INTERCHANGE Software Returned Values and Associated Error Messages This appendix contains returned values and associated error messages for the DAS for AB INTERCHANGE software. The return values generated by DAS for AB INTERCHANGE software are either standard ILAN$_ values or are from Allen-Bradley INTERCHANGE software. The return values generated by DTL have the facility code of DTL_. For more information about these messages, refer to Allen-Bradley documentation or the file SYS$LIBRARY:DTL.H. To enable message translation of these DTL_ messages for each process, enter the following command: $ SET MESSAGE SYS$MESSAGE:DTLMSG.EXE The following messages are messages are logged to the BASEstar Classic message file by the DAS for AB INTERCHANGE software. These messages are logged to provide more detailed diagnostic information than what is supplied by the returned status values. DTLNI, Established connection with Ethernet Interface !AD., DCM_DTL$SRV, Established connection with Ethernet Interface !AD., Explanation: Success. A successful connection to the corresponding Ethernet Interface has occurred. The Ethernet Interface corresponds to the /VAXPORT attribute of the device definitions. User Action: None. DTLNI, Lost connection with Ethernet Interface !AD. !/DTL error code: !UL hex=!XL., INTERCHANGE Software Returned Values and Associated Error Messages D-1 DAS for AB INTERCHANGE Software Returned Values and Associated Error Messages DCM_DTL$SRV, Lost connected with Ethernet Interface !AD. !/DTL error code: !UL hex=!XL., Explanation: Success or Error. The DTL NI has been notified that the DAS has lost connection to the corresponding Ethernet Interface. A code other than 0 indicates an error. Refer to Allen-Bradley documentation for information on how to interpret DTL error codes. User Action: If the error code indicates a failure, determine the cause and take corrective measures. DTLNI, Unknown state of Ethernet Interface !AD: !/ rhdr_l_ iostat = !UL; iosb = !UL , DTL_SRV_EI_EVENT_HANDLER, Ethernet Interface !AD in unknown state !UL. !/DTL error code: !UL hex=!XL., Explanation: Error. An error has occurred which has left the connection to the corresponding Ethernet Interface indeterminate. This is usually due to an internal DAS or DTL error. User Action: Contact support. DTLNI, DTL NI disconnected circuit from server process, Explanation: Information. The DTL NI has terminated communication with the DTL server process. This is usually due to a fatal error with the server process. User Action: The DTL NI should attempt to start the server process the next time a device connection is attempted. Enabling a DTL device will force this. If unsuccessful, shut down BASEstar Classic device connection management and start it up again. DTLNI, DTL DAS process shutting down., Explanation: Information. The DTL NI has been informed that the DTL server process is shutting down. User Action: None. D-2 DAS for AB INTERCHANGE Software Returned Values and Associated Error Messages AB INTERCHANGE Software Returned Values and Associated Error Messages DTL_SRV_DO_UNSOL_DEF, Error w/ DTL_UNSOL_DEF defining:!/ id:!OW on EI: !AD , Explanation: Error. An error was encountered while attempting to create an unsolicited definition by the server process. User Action: Determine cause of error and take corrective measures. DTL_PE_DO_WRITE, Error converting data to be written:, Explanation: Error. An error occurred when converting data from the write request to a format that is compatible with the DTL_WRITE command. This message is logged to provide additional information to that of the status returned. User Action: Determine cause of error and take corrective measures. DTL_SRV_EXCEPTION_HANDLER, Error for unsol data:, Explanation: Error. An error occurred while DTL was processing unsolicited data for the server process. User Action: Determine cause of error and take corrective measures. DTL_SRV_EXCEPTION_HANDLER, No defined unsol point for data received from:, Explanation: Informational. The DTL server process has received unsolicited data from a device for which there is no corresponding unsolicited phypoint defined or enabled. This message typically occurs when there are multiple PLC sending messages with the same unsolicited ID and the corresponding phypoints have not been enabled or defined. User Action: Define or enable the phypoints, have the PLC stop sending the message, or ignore the message. DTL_SRV_READ, Read failed for: !/!AD, Explanation: Error. An attempted read operation failed. This message is logged to provide additional diagnostic information to that of the status returned. User Action: Determine cause of error and take corrective measures. INTERCHANGE Software Returned Values and Associated Error Messages D-3 DAS for AB INTERCHANGE Software Returned Values and Associated Error Messages DTL_SRV_RUNDOWN, Max queued for this run:!UL, Explanation: Informational. The number of requests that were queued up by the server process while other requests were being serviced. This number gives a relative idea of the server process throughput. This message is logged during shutdown. User Action: If the number is high, consider adjusting some of the BASEstar Classic ILAN$DTLxxx parameters or other tuning procedures. DTL_SRV_WRITE, Write failed for !/!AD, Explanation: Error. An attempted write operation failed. This message is logged to provide diagnostic information additional to that of the status returned. User Action: Determine cause of error and take corrective measures. ILAN$$DTL_NI_INIT, Unable to find BASEstar Classic parameter !AD, Explanation: Error. The specified BASEstar Classic parameter is not defined or is invalid. User Action: Reinstall the DAS for AB INTERCHANGE software. ILAN$$DTL_NI_INIT, Unable to start server process:, Explanation: Error. The DTL NI was not able to start the DTL server process. The DAS for AB INTERCHANGE software will not function. User Action: Determine cause of error and take corrective measures. ILAN$$DTL_PE_COMP_ADDR, Device address string too long: !/ "!AD", Explanation: Error. The address to a read, write or polling definition is too long and is most likely invalid. User Action: Check address string and make appropriate corrections. D-4 DAS for AB INTERCHANGE Software Returned Values and Associated Error Messages AB INTERCHANGE Software Returned Values and Associated Error Messages ILAN$$DTL_SCMP, Invalid compare qualifier: !AD, Explanation: Error. An attempt to perform a simple compare failed because an invalid qualifier was supplied. This message is logged to indicate the invalid qualifier because this information is not in the status returned. User Action: Retry compare with a different qualifier. ILAN_DTL, Invalid download qualifier: !AD, Explanation: Error. An attempt to perform a download failed because an invalid qualifier was supplied. This message is logged to indicate the invalid qualifier because this information is not in the status returned. User Action: Retry download with different qualifier(s). ILAN_DTL, Invalid upload qualifier: !AD, Explanation: Error. An attempt to perform an upload failed because an invalid qualifier was supplied. This message is logged to indicate the invalid qualifier because this information is not in the status returned. User Action: Retry upload with different qualifier(s). DCM_DTL$SRV, Connection made with DTL DAS NI., Explanation: Success. The DTL server process has successfully established communications with the DTL NI and is ready to process requests. User Action: None. DCM_DTL$SRV, DTL DAS server process running., Explanation: Informational. Logged after a successful server process startup. User Action: None. DCM_DTL$SRV, DTL DAS Server process shutting down., Explanation: Informational. Logged during a normal server process shutdown. User Action: None. INTERCHANGE Software Returned Values and Associated Error Messages D-5 DAS for AB INTERCHANGE Software Returned Values and Associated Error Messages DCM_DTL$SRV, Failed to connect with Ethernet Interface !AD. !/DTL error code: !UL hex=!XL., Explanation: Error. The server process was unable to establish connection with the corresponding Ethernet Interface. User Action: Determine cause of error and take corrective measures. DCM_DTL$SRV, Failed to disconnect with Ethernet Interface !AD. !/DTL error code: !UL hex=!XL., Explanation: Error. The server process failed to disconnect from the corresponding Ethernet Interface. User Action: Determine cause of error and take corrective measures. It may be necessary to stop the server process or restart BASEstar Classic device connection management. DCM_DTL$SRV, Processing terminating abnormally:, Explanation: Error. The server process encountered a severe error and is shutting down. User Action: Determine cause of error and take corrective measures. DCM_DTL$SRV, Successful disconnection from Ethernet Interface !AD., Explanation: Success. This event usually occurs when the last device on that /VAXPORT is disabled. User Action: None. D-6 DAS for AB INTERCHANGE Software Returned Values and Associated Error Messages _________________________________________________________________ Index A______________________________ D______________________________ Accessing DAS functions, 3-1 DAS C See Device access software _______________________________ Data collection, automatic, Configuration 3-18 device records, 2-21 pollsets, 3-23 editing configuration file, unsolicited, 3-18 2-15 Data format network addresses, 2-21 restrictions, 3-17 path records, 2-20 Data type formats, 3-15 TCP/IP parameters, 2-14 structured data, 3-14 type records, 2-16 Device access software Configuration file, 2-24 accessing functions, 3-1 Configuring parameters description of, 1-1 BCC$MAX_PORT_QUOTA, 2-28 functions, 1-5 ILAN$DTLSRV_PRIORITY, 2-29 installation of, 2-1 ILAN$DTL_BACKLOG, 2-30 installation requirements, ILAN$DTL_CYCLE_TIME, 2-30 2-1 ILAN$DTL_DWNL_FLAGS, 2-30 overview, 1-1 ILAN$DTL_MAX_ELEMENTS, 2-31 supported data types, 3-15 ILAN$DTL_MAX_UNSOL_ELEMENTS, supported devices, 1-4 2-31 supported functions, 1-4, ILAN$DTL_SCMP_FLAGS, 2-32 3-2 ILAN$DTL_TIMEOUT, 2-32 using, 3-1 ILAN$DTL_UDC_TIMEOUT, 2-32 Device communications, 1-1 ILAN$DTL_UPL_FLAGS, 2-33 tracing, 2-34 ILAN$MAX_SPT_REQUESTS, 2-28 Device records, 2-21 Download function, 3-7 DTL Server Process quotas for, 2-33 Index-1 Pollsets, 3-23 F______________________________ Postinstallation tasks, 2-14 Files, created during Problem reporting, 2-36 installation, 2-10 Product failure, 2-36 Functions, 3-1 Q download, 3-7 _______________________________ read data, 3-3 Quotas, 2-33 read status, 3-6 upload, 3-7 R______________________________ write data, 3-3 Read data function, 3-3 I Read status function, 3-6 _______________________________ Installation, 2-1 S______________________________ files created, 2-10 SPT block usage, 2-28 messages, 2-12 Structured data, 3-14, 3-16 procedure, 2-5 Supported data types, 3-15 Installation requirements, 2-1 disk space, 2-3 T hardware, 2-1 _______________________________ software, 2-2, 2-3 Trace using, 2-34 M______________________________ Type records, 2-16 Message port quota, 2-28 U Messages _______________________________ error and return values, D-1 Unsolicited data collection, installation, 2-12 3-18 logged, D-1 Upload function, 3-7 _______________________________ W______________________________ Path records, 2-20 Write data function, 3-3 Plant-floor equipment, setting up, 2-34 Index-2