CONTENTS Title Page Copyright Page Preface 1 Overview 1.1 Introduction 1.2 DCSC Server Components 1.3 Naming Conventions 1.3.1 Named Constants 1.3.2 DCSC RTL Routines 1.3.3 File and Device Names 1.3.4 Data Structures 1.4 DCSC RTL and the DCSC Server Interface 2 Applications Programming Considerations 2.1 DCSC Server Configuration Maintenance 2.2 Request Authorization Levels 2.2.1 Unsupported Functions 2.3 Option Flags 2.3.1 DCSC_NOWAIT Option 2.3.2 DCSC_FORCE Option 2.3.3 DCSC_PRIVOP Option 2.3.4 DCSC_XPOOLID Option (Extended Scratch Subpool ID Parameters) 2.4 Response Data Files 2.5 Data Input and Output Operations 2.6 Virtual Device Assignments 2.7 Status and Error Reporting 2.7.1 Return Status 2.7.2 Response Status 2.7.3 Expanded Status 2.8 Programming Environment Support 2.8.1 Include Files 2.8.2 DCSC RTL Data Types 2.9 Compiling and Linking Application Programs 2.10 Common Data Structures 3 DCSC RTL Routine Descriptions CANCEL REQUEST CHECK REQUEST DISMOUNT SCRATCH DISMOUNT VOLUME EJECT VOLUME ENTER VOLUME GET_MESSAGE MOUNT SCRATCH MOUNT VOLUME QUERY ACS QUERY DRIVE QUERY DRIVE LIST QUERY FUNCTION QUERY LOGS QUERY LOGUNIT QUERY LSM QUERY REQUEST QUERY RESERVE QUERY SCRATCH QUERY SYSTEM QUERY VOLUME RELEASE SCRATCH RELEASE VOLUME REMOUNT SCRATCH REMOUNT VOLUME RESERVE SCRATCH RESERVE VOLUME SET FUNCTION SET LOG SET TRACE SET VOLUME SHUTDOWN A Sample DCSC RTL Program B DCSC RTL Request Type Codes C Error Status Codes EXAMPLES A-1 Sample DCL Command File A-2 DCSC$RTL_Sample.C Source Code A-3 Sample Output FIGURES 1-1 Automated Cartridge System 1-2 DCSC Server Environment 2-1 Expanded Status Field TABLES 2-1 DCSC RTL Routines 2-2 DCSC Server Configuration Save Options 2-3 Option Flags 2-4 WAIT Option Flags 2-5 Extended Subpool ID Subfield Definitions 2-6 Return Status Codes 2-7 DCSC RTL Data Types 2-8 Field Definitions for dcsc_response_hdr 3-1 Routine Description Format B-1 DCSC RTL Request Type Codes B-2 DCSC Internal Server Request Type Codes C-1 Error Status Codes