CONTENTS Title Page Copyright Page Preface 1 Introduction 1.1 Overview of VAX JCS 1.2 RV64 Jukebox Subsystem 1.2.1 RV60 Optical Disk Drives 1.2.2 RV02K Optical Disk Cartridges 1.2.3 Slots 1.2.4 Transport Mechanism 1.2.5 System Information 1.3 Definition of Terms 2 Overview of the Run-Time Library 2.1 Features of VAX JCS Run-Time Library 2.2 Organization of VAX JCS Run-Time Library 2.3 VAX JCS Run-Time Library Routines 2.3.1 Process Security 2.4 Linking with the VAX JCS Run-Time Library 2.4.1 Linking VAX C Programs 2.5 Characteristics of a VAX JCS Application 3 Using Run-Time Library Routines 3.1 Naming Conventions 3.2 Call Formats 3.3 Condition Values Returned 3.4 Documentation Format of Routines 4 Developing New Applications 4.1 Programming Considerations 4.1.1 Writing to Dual-Sided Cartridges 4.1.2 Multiple Applications on a Single Jukebox 4.1.3 Using the JCS$LOCK Routine 4.1.4 Using the JCS$GET_STATUS Routine 4.1.5 Positioning to a File 5 Examples of Calling Routines 5.1 Clean Slots Program 5.2 Clean Jukebox Program 5.3 Examine Labels Program 5.4 Spin Down Program 5.5 Move Cartridge Program 5.6 Test Lock Program VAX JCS Run-Time Library Reference Section JCS$EXCHANGE JCS$EXCHANGEW JCS$GET_DEFAULT_JUKEBOX JCS$GET_DRIVE_NAME JCS$GET_JUKEBOX_ATTRIBUTES JCS$GET_PORT_NAME JCS$GET_STATUS JCS$INIT_SERVER JCS$LOCK JCS$MOVE JCS$MOVEW JCS$SET_SIDE JCS$SPINDOWN JCS$UNLOCK Glossary arm . . . MMSERVER robot . . . VAX Jukebox Control Software EXAMPLES 5-1 VAX FORTRAN Program for Cleaning a Jukebox 5-2 VAX Pascal Program for Cleaning a Jukebox 5-3 VAX Pascal Program for Cataloguing Cartridges 5-4 VAX Bliss Program for Spinning Down Drives 5-5 VAX MACRO Program for Moving Cartridges 5-6 VAX C Program for Testing Lock FIGURES 1-1 Illustration of the RV64 Jukebox Subsystem 2-1 Components of VAX Jukebox Control Software TABLES 1 RV64 and RV20 Documentation 2-1 VAX JCS Run-Time Library Routines 2-2 JCS$MSG and JCS$RTL_DECLARATIONS File Types 3-1 Condition Values 3-2 Main Headings in the Documentation Format for Run-Time Library Routines