VAXELN Version 2.2 Realtime Software Toolkit for Dedicated VAX and Micro VAX Applications

(

Features · Full VAXELN Toolkit that runs on a VMS or MicroVMS host to produce tight execution code on a dedicated system. • Includes an extended ISO Pascal compiler (EPascal) that is optimized for realtime code. Runtime libraries are also included for EPascal, C, and FORTRAN-n. • Supports an Ada compiler and Ada runtime libraries, a C compiler, a FORTRAN compiler, and Rdb/ELN Relational Database Software. (All of these are options for the VAXELN Toolkit.) • Provides a simple, small kernel to control sharing of the system's resources on the dedicated system. • Supports local debugging on the target system's console terminal and remote debugging over an Ethernet from a user terminal on a VAXIVMS system. • Includes a powerful system builder that combines program images, the kernel image, and runtime routines into a finished VAXELN system image. • Supports multitasking and multiprogramming from the VAXELN kernel, the EPascal compiler, the C runtime library, and Ada~ • Offers device drivers for a range of Q-bus and UNIBUS devices including disks for file storage. • Provides transparent network communications among VAXELN and VMS nodes via Ethernet-based DEe net (DAP) . Description The VAXELN Toolkit Helps You Generate Efficient Runtime VAXELN Version 2.2 adds support Applications for the VAX FORTRAN-77 runtime library to Digital's realtime software The VAXELN Toolkit gives you the development toolkit. The VAXELN development resources you need Toolkit runs on a VAX or MicroVAX to write efficient realtime code. It system to generate tight execution includes the extended EPascal com­ code for a dedicated realtime proces­ piler, libraries with the VAXELN ker­ sor. On the dedicated system, the nel and system services, a system VAXELN kernel controls the use of build utility, and a symbolic debug­ shared system resources. ger. An extended VAX C runtime library and VAX FORTRAN-77 rou­ As a VMS layered product, the VAX­ tines ship with the VAXELN kit. You ELN Toolkit gives you access to the also have the option of ordering rich software development resources Toolkit options such as the VAXELN of the VMS environment. The Toolkit File Service, Network Service, high­ itself provides optimized tools to help performance device drivers, extended you create an execute-only applica­ VAX Ada runtime routines, template tion that runs under the VAXELN ker­ device drivers, the Rdb/ELN rela­ nel on the dedicated system. VAXELN tional database, and compilers for applications work in situations - such VAX C and FORTRAN. as factory automation, dedicated CAD/CAM workstations, and large­ With VAXELN, you work in the scale data collection/reduction familiar VAXIVMS development envi­ systems - in which individual proces­ ronment to create your realtime appli­ sors have dedicated or predetermined cation. (Figure 1 shows the general functions. These applications can be elements in the application develop­ either stand-alone units or part of an ment cycle.) Use VMS language­ Ethernet Local Area Network (LAN) sensitive editors to help you create with VAXIVMS nodes or any other the source code. Write your applica­ node using DEC net service and tion in the Toolkit's EPascal, with calls protocols. to VAX C, VAX FORTRAN-77, and, optionally, VAX Ada~ Link the com­ piled code to the VAXELN Toolkit runtime library using the standard VAXIVMS linker. For easier debug­ ging either locally or remotely across an Ethernet LAN, use the VAXELN debugger: The VAXELN debugger is based on the VAX debugger and lets you debug both modules and entire applications. When you're ready, combine the necessary images with the VAXELN system builder to create an efficient, low-overhead run­ time application. modules already in the program MicroVAX II, VAX 111730, 111750, 11/751, library are automatically checked for 11/780, 111782, 111785 consistency. In addition, full data-type VAX 8200, 8300, 8500, 8600, 8650, 8800 MicroVAX II, checking is maintained on the prede­ 11/ 730, and clared kernel data types DEVICE, 11/750 MicroVMS or VMS EVENT, MESSAGE, NAME, PORT, PROCESS, and SEMAPHORE. VAXELN Toolkit VAXELN Kernel Controls Tight Target CPU Execution Code Development CPU The VAXELN kernel supports both multitasking and multiprogramming. Its multitasking capability lets you Figure 1. VAXELN Application Development Elements declare parts of a program to be scheduled for concurrent execution EPascal Provides an Extended ISO Powerful language extensions simplify with the main program. Its multipro­ Pascal Compiler and speed application development. gramming feature enables you to For example, you can use a generalized schedule entire programs, including EPascal is a highly optimized native mechanism, flexible types, to declare multitasking programs, for concurrent mode Pascal compiler that builds on data with parametric extents. You execution on the same cpu. the ISO standard to provide realtime can predeclare fixed-length strings, extensions. These extensions let you varying length strings, and a series of The kernel uses VAX memory man­ work in the flexible Pascal language­ uninterpreted data types. And you agement to map user processes in the instead of assembly language - to write can declare procedure and function PO and PI regions of a 4-Gbyte virtual even device drivers and other perfor­ parameters with conformant extents. address space. The user stack is inde­ mance-critical parts of your code. The pendently mapped into the PI (con­ EPascal program also lets you include Another EPascal compiler feature trol) region for each process in the routines written in VAX C, FORTRAN, effectively extends Pascal-type check­ system. A VAXELN process running and MACRO-ll. ing to separately compiled modules on a single processor can be as large to let you create and compile source as the amount of physical memory on The EPascal runtime library features code in separate modules. As each that dedicated processor. support for special I/O operations, module is compiled, declarations or standard Pascal routines such as SIN, cross-references involving it and the In general, VAXELN systems are inde­ and certain procedures used in sys­ pendent jobs that exchange informa­ tem programming. This support is tion by message transmissions. Jobs provided in both object-library and can be created dynamically to execute shareable-image forms. a specific program included with the system builder. C, and MACRO-l1. It also collects the necessary images from the VAXELN kernel itself and from the VAXELN Toolkit. Figure 2 illustrates the possi­ ble components in a VAXELN appli­ cation and includes the minimum memory requirements for each.

VAXELN Debugger for Remote Or Local Interactive Debugging You can use the VAXELN Debugger for interactive debugging either locally at the target system's console or remotely over an Ethernet connec­ tion. Either way, you can evaluate expressions in a Pascal-like syntax, execute VAXIVMS-like debugger com­ mands, and debug kernel-mode code. You can also define new debugger commands and variables as necessary.

If you have the optional DECnet-VAX license and Ethernet hardware, you can debug the application from a ter­ minal on another VAXIVMS node. This remote debugger supports sym­ bolic debugging - that is, manipulat­ Figure 2 .· VAXELN Application Components ing variables and other items by their declared names. It can also display the Jobs running on the same processor Broad System Builder Combines status of all VAXELN processes and are scheduled on a preemptive prior­ Images jobs in the LAN. ity basis. Jobs can be assigned up to 32 The VAXELN system builder does the priority levels. Within a job, 16 inde­ VAX C and FORTRAN-77 Runtime majority of the application build work pendent priority levels are available Libraries Arrive With the Kit for you. It combines program images, for preemptive process scheduling. the VAXELN kernel image, and run­ The VAXELN product ships with an You can stop then resume process time routines into one image of the fin­ extended VAX C library and a library rescheduling within a job. ished VAXELN system. The resulting of VAX FORTRAN-77 routines. An image keeps overhead to a minimum extended VAX Ada®runtime library by including only those images neces­ is also available as an option. These , ~ sary for that particular application. libraries let you include existing rou­ tines in your VAXELN application and The system builder accepts program give you the choice of development images from a variety of sources, in­ languages. cluding programs written in EPascal, subprograms written in other VAX languages such as Ada ~ FORTRAN-77, Extended VAX C Runtime Library. • RQDX1, RQDX2, or RQDX3 disk con­ VAXELN Ada Routines Add Ada to 1 VAXELN supports the VAX C language troller with the following drives as Your Language Choices with an extended C runtime library. appropriate to meet hardware config­ The optional VAXELN Ada® routines 1 The library contains over 130 routines uration requirements: RX50 (2 by 400 enable you to include Ada modules in that implement the standard VAX C Kbytes) diskette drive; RD51 (11 Mby­ your application. If you have VAX runtime environment. Realtime exten­ tes), RD52 (31 Mbytes), or RD53 (71 Ada - recognized as among the best sions to the standard library let you Mbytes) Winchester disk drive. VAX­ Ada compilers-you can also write work in this high-level language to ELN supports up to four of either your realtime application in Ada. The write performance-critical code such type of drive. VAX Ada compiler lets you defer the as device drivers. The VAXELN debug­ • KDA50 Q-bus disk adapter for up to choice of target system until you link ger fully supports the VAX C language 4 Digital Storage Architecture (DSA) the application, so you can easily and the runtime library. disks: RASO, RAS1, or RA60. build applications that run under • RQC25 52-Mbyte fixed/removable either VAXELN or VMS. VAXELN VAX FORTRAN-77 Runtime Library. disk subsystem and RC25 add-on Ada also uses the VAX Ada program The VAX FORTRAN-77 runtime drives. library to make it easier to develop library lets you include standard applications for both systems. The FORTRAN-77 modules in your appli­ • DEQNA Ethernet-to-Q22 adapter VAXELN Ada routines are fully inte­ cation system image. The VAXELN • DZV11 or the DZQ114-line asynchro­ grated into the VAXELN execution debugger supports both these mod­ nous multiplexer environment, giving you access to sys­ ules and the runtime library. • DHV11S-line asynchronous tem services, device utility routines, multiplexer and distributed application features. VAXELN Options Tailor the • Console terminal Environment to Your Needs • LPV11 lineprinter controller Optional Services for a Variety of The optional software available for Realtime Applications • DLV11 asynchronous serial controller the VAXELN Toolkit lets you select VAXELN File Service. If your applica­ exactly the components you need. • DRV11 parallel line interface tion includes disks, you can include the In addition to the optional VAX Ada • ADV11-C, AXV11-C, and KWV11-C VAXELN File Service to provide the runtime routines, choose from the realtime devices file support you need. The VAXELN VAXELN File Service, the VAXELN • TK50 streaming tape File Service supports I/O operations Network Service, and the Rdb/ELN • DMF-32 multifunction board (LP32 from EPascal programs to file-storage relational database software. lineprinter and asynchronous line devices, such as disks, and from other support) DEC net nodes (with Network Service). VAXELN also gives you a choice of The VAXELN File Service uses the the following devices that are sup­ • RASO/RL02 combined disk drives VAXIVMS on-disk structure (ODS-2) ported on the dedicated realtime (VAX-111730) or dual RL02 disk internal file format. processor. drives • UDA50 UNIBUS Disk Adapter and up to 4 DSA disks: RASO, RAS1, RA60 • RUC25 52-Mbyte fixed/removable disk subsystem and RC25 add-on disk drives • TUS1 UNIBUS tape drive • DEUNA UNIBUS-to-Ethernet adapter • TU5S cartridge tape VAXELN Network Service. When you Digital Means Service VAXELN Toolkit Requirements develop a distributed realtime appli­ The sophisticated work that goes The host development system for the cation, choose the optional VAXELN into developing realtime applications VAXELN Toolkit should have at least Network Service. These services pro­ requires equally sophisticated support 1 Mbyte of physical memory, 2 Mbytes vide transparent network communi­ and service. Digital has the worldwide of virtual page file quota per user, and cation between VAXELN nodes in a resources required to provide this a 250-page minimum working set per LAN and between VAXELN nodes level of support. These resources take user. Digital recommends the follow­ and VAXIVMS nodes. With Network shape with trained hardware and soft­ ing systems as host for the Toolkit. Services, you can downline load appli­ ware service representatives available cations across an Ethernet network. • MicroVAXII worldwide 24 hours a day, 7 days a week and include a range of service • VAX-ll/730, 750, 780, 782, or 785 Optional Rdb/ ELN Provides offerings such as hardware and soft­ • VAX 8200, 8300, 8500, 8600, 8650, R elational Database Support ware installation, on site consulting, or 8800 Rdb/ ELN enables you to build your and scheduled maintenance. realtime application on a relational The target dedicated system that will database. As a member of Digital's Digital can help you develop your own run the VAXELN application should relational products family, Rdb/ELN resources through our extensive train­ have at least 1 Mbyte of physical supports the Digital Standard Rela­ ing programs. Choose from options memory and a load device. Digital tional Interface (DRSI). This support ranging from classroom courses avail­ recommends the following processors means that applications you devel­ able in our 25 worldwide training as the realtime target system. oped with other DRSI-based products facilities to audio/visual courses that • MicroVAX II will run under Rdb/ELN, and applica­ you can take at your own site within tions you create with Rdb/ELN will your own schedule. • VAX-ll/730 or 750 run under other DRS I products. Digital means service at every level, Digital recommends the following Rdb/ ELN provides full relational everywhere in the world. load devices. database functionality with excellent • Ethernet adapters for downline performance. It also assures data loading integrity. Rdb/ ELN simplifies appli­ • Files-ll disk, RX50, RA60, RC25 , RL02 cation development and increases application flexibility by combining • TU58 cartridge tape the relational data model with remote • TK50 for the MicroVAX II database access and the capability for • ROM (MRVll-D) handling application-defined datatypes. OptionalSo/tware • VAXC • VAX FORTRAN • VAX Rdb/ELN • VAX Ada/ELN Ordering Information for Available VAXELN Products Order Number Description Q"375-UZ Single-user License for Development System Q"376-DZ Single-user License for Target System Multiple Copies of the Single-user License for Target Systems Q1'375-H3, H5, HM Distribution and Documentation Options Q"375-HZ Software Revision Right to Copy Option for the Development System Q"376-HZ Software Revision Right to Copy Option for the Target System Documentation Only Option Installation Service Option Q"'375-93, 95 Digital Support Service Options Basic Service Self-Maintenance Service Q"375-E5 Source License and Sources Distribution "The specific order number is determined by the system for which you are ordering the product. ~g Digital believes the information in this publica­ u tion is accurate as of its publication date; such o information is subject to change without notice. r-­ N Digital is not responsible for any inadvertent ~ errors. ; The fo llowing are trademarks of Digital Equip­ r-- ment Corporation: ALL-IN-I, CI, DEC, DECnet, '8.co N DECUS, DIBOL, the Digital logo, MASSBUS, a MicroVAX II, MicroVMS, Q-bus, ULTRIX, '"..: UNIBUS, Rdb/ELN, RdbIVMS, VAX, VAXBI , vi ;:i VAXc!uster, VAXELN, and VMS . .5 ] Ada is a registered trademark of the U.S. .5 Government. ~