RTEM-11 User's Guide AA-N435C-TK

January 1984

This manual describes the use of RTEM-11 software, which emulates the RT-11 program development system on RSX-11 and VAX/VMS operating systems.

This manual supersedes the RTEM-11 User's Guide, AA-N435B-TK.

Operating Systems: RSX-11 M Version 4 RSX-11 M-PLUS Version 2 VAX/VMS Version 3

Software: RTEM-11 Version 2

To order additional documents from within DIGITAL, contact the Software Distribution Center, Northboro, Massachusetts 01532.

To order additional documents from outside DIGITAL, refer to the instructions at the back of this document. digital equipment corporation · maynard, massachusetts First Printing, August 1982 Revised, April 1983 Revised, January 1984

The information in this document is subject to change without notice and should not be construed as a commitment by Digital Equipment Corporation. Digital Equipment Corporation assumes no responsibility for any errors that may appear in l;ithis docu ment. The software described in this document is furnished under a license and may be used or copied only in accordance with the terms of such license. No responsibility is assumed for the use or reliability of software on equipment that is not supplied by DIGITAL or its affiliated companies.

Printed in U.S.A.

A postage-paid READER'S COMMENTS form is included on the last page of this document. Your comments will assist us in preparing future documentation.

The following are trademarks of Digital Equipment Corporation:

~D~DDmDTM DEC MASSBUS UNIBUS DECmate PDP VAX DECsystem-10 P/OS VMS DECSYSTEM-20 Professional VT DECUS Rainbow Work Processor DECwriter RSTS DIBOL RSX

M24300 CONTENTS

Page

PREFACE vii

CHAPTER 1 INTRODUCTION TO RTEM-ll 1-1

1.1 RTEM-11 FEATURES 1-1 1.2 RSX-ll CONVENTIONS 1-2 1.2.1 Logging In 1-2 1.2.2 Logging Off 1-2 1.2.3 RSX-ll File Management 1-3 1.2.4 RSX-ll Device Usage 1-4 1.2.5 HELP Command 1-5 1.3 SPECIAL CONSIDERATIONS FOR RTEM-ll, RSX-ll USERS 1-5 1.3.1 Task or Job? 1-6 1.3.2 Files-II or RT-11 Directory Structure? 1-6 1.3.3 Multiuser or Single User? 1-6 1.3.4 Device Driver or Handler? 1-6 1.3.5 Device or Volume? 1-7 1.3.6 CTRL/C or CTRL/Z? 1-7 1.4 RSX-ll DOCUMENTATION REFERENCES 1-7 1.5 VAX/VMS CONVENTIONS 1-8 1.5.1 Logging In 1-8 1.5.2 Logging Off 1-8 1.5.3 VAX/VMS File Management 1-8 1.5.4 VAX/VMS Device Usage 1-10 1.5.5 HELP Command 1-11 1.6 SPECIAL CONSIDERATIONS FOR RTEM-ll, VAX/VMS USERS 1-11 1.6.1 Process or Job? 1-11 1.6.2 Files-II or RT-ll Directory Structure? 1-11 1.6.3 Multiuser or Single User? 1-12 1.6.4 Device Driver or Handler? 1-12 1.6.5 Device or Volume? 1-12 1.6.6 CTRL/C or CTRL/Y? 1-12 1.7 VAX/VMS DOCUMENTATION REFERENCES 1-13 CHAPTER 2 RTEM-ll SYSTEM CONCEPTS AND OPERATING PROCEDURES 2-1

2.1 RTEM-l1 MONITOR 2-1 2.2 RTEM-l1 SYSTEM DEVICE 2-1 2.2.1 Virtual System Device 2-2 2.2.2 Foreign Volume System Device 2-2 2.3 RTEM-ll TERMINAL COMMUNICATION CONVENTIONS 2-3 2.3.1 prompt Characters 2-3 2.3.2 Special Function Keys 2-3 2.4 START-UP PROCEDURE 2-5 2.4.1 Start-up from Virtual System Device 2-6 2.4.2 Start-up from Foreign Volume System Device 2-6 2.4.3 Exiting from RTEM-ll 2-7 2.5 RTEM-ll START-UP COMMAND OPTIONS 2-8

iii 2.5.1 Specifying an Abort Character Code ( / [ - ] AB [ : n 1 ) 2-9 2.5.2 Extending the Private Area (/EX[:n]) 2-9 2.5.3 Displaying HELP Text (/HE) 2-10 2.5.4 Displaying Version Identifier (/10) 2-10 2.5.5 Changing Line Printer Spool Device (/LP) 2-10 2.5.6 Specifying Private Area of Virtual System Device (/PR[:n[:m]]) 2-10 2.5.7 Making System Device Read-Only (/RO) 2-12 2.5.8 Specifying a Foreign Volume System Device (/RT) 2-13 2.5.9 Specifying the Shared Area (/SH) 2-15 2.5.10 Invoking RTEM-11 from Default Virtual System Device (/VS) 2-15 2.6 PERIPHERAL DEVICE NAMES AND USAGE 2-16 2.6.1 Foreign Devices Supported by RTEM-ll 2-16 2.6.2 Differences in Device Naming Conventions 2-23 2.6.3 Line Printer Support 2-23 2.6.4 RP02/RP03 Device Support on RSX-l1 2-24 2.7 RESTRICTIONS ON USING RT-ll FEATURES 2-25 2.7.1 Using DATE and TIME Commands 2-25 2.7.2 Using COPY/BOOT Command 2-25 2.7.3 Using COPY/DEVICE Command 2-26 2.7.4 Debugging with Virtual Debugging Technique (VDT) 2-26 2.7.5 Summary of Restrictions 2-26 2.7.5.1 Keyboard Monitor Commands 2-27 2.7.5.2 RT-ll Utility Programs 2-28 2.7.5.3 RT-ll Programmed Requests 2-29 2.7.5.4 Unsupported RT-ll Devices 2-30 2.7.5.5 Unsupported Control Characters 2-30 2.8 COMMAND-LINE ERROR MESSAGES 2-31

CHAPTER 3 EXTENDED COMMAND STRING INTERPRETER (ECSI) 3-1

3.1 CALLING ECSI 3-1 3.2 ECSI SYNTAX 3-1 3.3 WILDCARD USAGE 3-3

CHAPTER 4 JACK-OF-ALL-TRADES UTILITY PROGRAM (JOAT) 4-1

4.1 CALLING AND TERMINATING JOAT 4-1 4.1.1 JOAT Command String 4-1 4.1.2 HELP Command 4-2 4.2 JOAT COMMAND OPTIONS 4-2 4.2.1 Attaching a Physical Device (/A) 4-3 4.2.2 Creating a Virtual Device (/C[:nl) 4-4 4.2.3 Detaching a Device (/D) 4-5 4.2.4 Exiting from RTEM-ll (/E[:n]) 4-6 4.2.5 Listing RTEM-ll Device Usage (/L) 4-7 4.2.6 passing Commands to RSX-ll (/M) 4-8 4.2.7 Ordering Files on a Virtual System Device (/o[:xxxl) 4-9 4.2.8 Creating a Shared Area (/S) 4-11 4.2.9 Extending a Virtual Device (/T:n) 4-11 4.2.10 Updating a Virtual Device (/U) 4-12 4.2.11 Attaching a Virtual Device (/V[:VSn]) 4-12 4.2.12 Write-protecting a Volume (/W(:NO]) 4-13 4.2.13 Suppressing Query Message (/Y) 4-13 4.2.14 Creating Temporary Virtual Device (/Z) 4-13 4.3 JOAT ERROR MESSAGES 4-14

iv CHAPTER 5 FILE INTERCHANGE PROGRAM (FIP) 5-1

5.1 CALLING AND TERMINATING FIP 5-1 5.1.1 HELP Command 5-1 5.1.2 FIP Command String 5-2 5.2 FIP COMMAND OPTIONS 5-2 5.2.1 Copying in ASCII Mode (/A[:n]) 5-3 5.2.2 Copying in Binary Mode {/B[:n]} 5-4 5.2.3 Creating Contiguous Output Files {/C} 5-4 5.2.4 Specifying Files-II Transfers {IF} 5-5 5.2.5 Copying New Files (/G) 5-5 5.2.6 Copying in Image Mode (/I[:n]) 5-5 5.2.7 Copying Without Replacing (IN) 5-5 5.2.8 Excluding Files {/p} 5-5 5.2.9 Copying with Ouery (/O) 5-6 5.2.10 Copying STREAM Files, Creating FORTRAN IV Files (IT) 5-6 5.2.11 Logging While Copying (/W) 5-6 5.2.12 Copying System Files (/Y) 5-7 5.2.13 Default Values 5-7 5.3 FIP ERROR MESSAGES 5-7

CHAPTER 6 MODIFYING THE VIRTUAL SYSTEM DEVICE 6-1

6.1 MODIFICATION PROCEDURE 6-1 6.1.1 Establish Shared Area as a Temporary File 6-1 6.1.2 Update and Compress the Virtual Device (JOAT IU) 6-2 6.1.3 Add, Delete, or Modify Files on the Virtual Device 6-2 6.1.4 Create a New Shared Area (JOAT IS) 6-2 6.1.5 Establish the Order of Files in Shared Area (JOAT IO[:XXX]) 6-3 6.1.6 Maintain the Host System 6-4 6.2 SAMPLE MODIFICATION 6-4

GLOSSARY Glossary-l

INDEX Index-l

TABLES

TABLE 2-1 Foreign Devices Supported by RTEM-ll 2-17 2-2 SET Options for RTEM-ll Devices 2-18

PREFACE

This manual introduces you to RTEM-ll, the RT-ll emulator. The main purpose of RTEM-II is to let you develop and debug RT-II programs, using the facilities of a multiuser system such as RSX-II or VAX/VMS. This manual gives you the information you need to do this.

DIGITAL recommends that you consult the RTEM-ll Release Notes that is shipped as part of the RTEM-ll documentation set. The release notes contain information on the latest features of RTEM-II.

Intended Audience To use this manual you should have some experience using RT-II, but you don't need to know too much about the host system (RSX-II or VAX/VMS). All you need to know is some host system commands such as DIRECTORY, SHOW DEFAULTS, ALLOCATE, and MOUNT, and conventions for interacting with your host system through the terminal. These subjects are summarized in Chapter 1.

Chapter Summary

Chapter 1 lists RTEM-II features and describes RSX-II and VAX/VMS concepts and conventions.

Chapter 2 tells you how to invoke RTEM-Il and alter the default operating condition