CONTENTS

  Title Page

  Copyright Page

  Preface

  1      Introduction

  1.1     Overview of the FTAM API

  1.2     Mapping Block Types to Primitives

  1.3     Handling FTAM API Calls

  1.4     Managing the User Buffer

  1.5     Handling User Data

  1.6     Using Document Types
    1.6.1      Using the FTAM-1 Document Type
    1.6.2      Using the FTAM-2 Document Type
    1.6.3      Using the FTAM-3 Document Type
    1.6.4      Using the NBS-9 Document Type
    1.6.5      Default Document Type Parameter Values

  1.7     Passive Versus Active Responders

  1.8     Using Presentation Addresses
    1.8.1      Matching NSAPs and Templates

  2      Building and Running FTAM API Programs

  2.1     Compiling Programs with DEC C on OpenVMS VAX

  2.2     Linking Programs on OpenVMS

  2.3     Running Programs on OpenVMS

  2.4     Compiling and Linking Programs on Digital UNIX

  2.5     FTAM API Example Files

  3      FTAM File Services

  3.1     Service Sequences
    3.1.1      Creating a New File and Writing Data
    3.1.2      Deleting a File Using Grouping
    3.1.3      Reading and Changing Attributes
    3.1.4      Performing a Series of Writes and Reads
    3.1.5      Transferring a File to a Peer System
    3.1.6      Canceling a Data Transfer

  3.2     FTAM File Services and Parameters

  3.3     Parameter Block Description

  3.4     Parameter Description

  4      Data Structures

  4.1     FTAM Parameter Block

  4.2     String Descriptor Specification

  4.3     Binary Descriptor Specification

  4.4     Filename

  4.5     Diagnostic

  4.6     Contents Type List

  4.7     Contents Type

  4.8     Document Type Parameter

  4.9     Application Entity Entry

  4.10    Application Entity Address

  4.11    Network Selector and Transport Options Queue (V3.0 Only)

  4.12    Network Selector and Transport Provider Queue (V3.2 Only)

  4.13    Transport Template Queue (V3.2 Only)

  4.14    Concurrency Control

  4.15    Access Control

  4.16    Access Passwords

  4.17    File Access Data Unit

  4.18    File Access Data Unit Access Context

  4.19    Charging

  4.20    User Buffer

  5      Function Calls

  osif_assign_port

  osif_deassign_port

  osif_get_event

  osif_give_buffer

  osif_send

  A   Error Messages

  B   Diagnostic Errors

  TABLES

  3-1        FTAM Primitives and Corresponding Parameters