ampex-data dstdis tape drive programmer s guide, part no. 1308911-02 User Manuals

Table of Contents

• Addendum

  3
  • Introduction

    3
  • API Functions

    3
  • Device Special Files

    4
  • dst_setnoflush()

    6
  • dst_getptpathname()

    7
  • dd2_setnoflush_drive

    9
• Contents

  10
• Figures

  14
• Tables

  15
• General Information

  17
  • 1.1 Introduction

    17
  • 1.2 Manual Contents

    18
  • 1.3 Notational Conventions

    19
  • 1.4 Notices and Notes

    20
  • 1.5 Related Documents

    20
  • 1.6 Technical Support

    21
  • 1.7 Documentation Support

    21
• Software Overview

  23
  • 2.1 Introduction

    23
  • 2.2 Tape Device Driver

    23
  • 2.3 Tape Drive Behavior

    27
  • 2.4 libdd2 API Overview

    27
    • 2.4.1 Operation of libdd2

      28
    • 2.4.2 Function Return Values

      28
    • 2.4.3 Errors

      28
    • 2.4.4 UNIX Platform Compatibility

      28
    • 2.4.5 Restrictions

      28
  • 2.5 DD2 Utilities Overview

    29
    • 2.5.1 Exit Status

      29
    • 2.5.2 Errors

      29
    • 2.5.3 UNIX Platform Compatibility

      29
    • 2.5.4 Open behavior

      29
    • 2.5.5 Restrictions

      29
• DD-2 Tape Format

  31
  • 3.1 Introduction

    31
  • 3.2 DST Cartridge

    31
  • 3.3 DD-2 Tape Entities

    31
  • 3.4 DD-2 Format Types

    32
    • 3.4.1 System Zones

      33
    • 3.4.2 Partitions

      33
    • 3.4.3 File Sections

      34
    • 3.4.4 Data Blocks

      34
  • 3.5 Instrumentation and Data Storage Recording

    35
• Tape Drive Operational Characteristics

  37
  • 4.1 Introduction

    37
  • 4.2 Tape Drive Block Size

    39
  • 4.3 Tape Partitions

    39
• libdd2 API Functions

  41
  • 5.1 Introduction

    41
  • 5.2 DST API Overview

    41
    • 5.2.1 libdd2 Functions Summary

      41
    • 5.2.2 Position Specifications

      42
      • dst_position_st

        42
      • dst_pos_type_en

        43
      • dst_position_un

        43
      • dst_pos_tok_t

        44
      • dst_dd2_pos_st

        44
      • dst_600_pos_st Structure

        45
      • dst_dis_pos_st Structure

        46
    • 5.2.3 Return Values

      47
    • 5.2.4 See Also

      51
  • 5.3 dst_clrlog

    52
  • 5.4 dst_convpos

    53
  • 5.5 dst_format

    56
  • 5.6 dst_getdrive

    62
  • 5.7 dst_getdrive_ex

    66
  • 5.8 dst_getlog

    71
  • 5.9 dst_getparam

    75
  • 5.10 dst_getpos

    78
  • 5.11 dst_getstate

    80
  • 5.12 dst_gettrace

    82
  • 5.13 dst_reset

    85
  • 5.14 dst_rewind

    86
  • 5.15 dst_setdrive

    87
  • 5.16 dst_setparam

    91
  • 5.17 dst_setpos

    94
  • 5.18 dst_space

    97
  • 5.19 dst_status

    99
  • 5.20 dst_unload

    103
  • 5.21 dst_version

    104
  • 5.22 dst_weof

    106
  • 5.23 dst_weof_ex

    108
• DD-2 Utilities Manual Pages

  111
  • 6.1 Introduction

    111
  • 6.2 DD-2 Utilities Overview

    111
    • 6.2.1 Utilities

      111
    • 6.2.2 Input Conventions

      112
    • 6.2.3 Output Conventions

      113
    • 6.2.4 Arguments

      113
    • 6.2.5 Options

      114
    • 6.2.6 Environment

      115
    • 6.2.7 Exit Status

      115
    • 6.2.8 See Also

      116
  • 6.3 dd2_clrlog_drive

    117
  • 6.4 dd2_format_tape

    119
  • 6.5 dd2_getlog_drive

    124
  • 6.6 dd2_getparam_drive

    127
  • 6.7 dd2_getpos_tape

    130
  • 6.8 dd2_gettrace_drive

    133
  • 6.9 dd2_query_drive

    135
  • 6.10 dd2_query_tape

    141
  • 6.11 dd2_read_perf

    145
  • 6.12 dd2_reset_drive

    148
  • 6.13 dd2_rewind_tape

    150
  • 6.14 dd2_set_drive

    152
  • 6.15 dd2_setparam_drive

    156
  • 6.16 dd2_setpos_tape

    159
  • 6.17 dd2_space_tape

    163
  • 6.18 dd2_status_drive

    166
  • 6.19 dd2_unload_tape

    169
  • 6.20 dd2_weof_tape

    171
  • 6.21 dd2_write_perf

    173
• Glossary and Acronyms

  177
  • A.1 Glossary

    177
  • A.2 Acronyms

    189
• Device Special Files

  191
  • B.1 Introduction

    191
• Result Codes and Machine Status

  215
  • C.1 Introduction

    215
• MSR Diagnostic Status Information

  227
  • D.1 Introduction

    227
  • D.2 RF Status Field

    227
  • D.3 Latched/Continuous Status Field

    228
  • D.4 Physical Block Related Status Field

    239
• Statistics

  243
  • E.1 Introduction

    243
  • E.2 Service Statistics Parameters (Log Page 31h)

    243
  • E.3 Operational Statistics Parameters 1 (Log Page 32h)

    245
  • E.4 Operational Statistics Parameters 2 (Log Page 33h)

    246