CONTENTS

  Title Page

  Copyright Page

  Preface

  1      Introducing the Data Transfer Facility (DTF) Product

  1.1     What Is the DTF Product?

  1.2     What Are the Components of the DTF Product?

  1.3     What Are the Capabilities of the DTF Product?
    1.3.1      Multiple User Interfaces (All Clients)
      1.3.1.1      DECnet User Interfaces
      1.3.1.2      IBM User Interfaces
    1.3.2      Data Translation (All Clients)
    1.3.3      Multiple File Types (All Clients)
      1.3.3.1      Supported Non-IBM Files
      1.3.3.2      Supported IBM Files
    1.3.4      Remote Job Submission and Post Processing (All Clients)
    1.3.5      Directory Capability (VMS, ULTRIX, RSX-11M/M-PLUS, MS-DOS, and OS/2 Clients)
    1.3.6      Recoverable File Transfer (VMS TRANSFER/DTF and IBM Clients Only)
    1.3.7      RMS Programming Interface (VMS Clients Only)
    1.3.8      DCL Record Level Access and DATATRIEVE Access (VMS Clients Only)

  1.4     What Does the DTF Product Allow Me to Do?
    1.4.1      VMS DCL Commands
    1.4.2      VMS TRANSFER/DTF Commands
    1.4.3      IBM DTF Panel Interface Operations
    1.4.4      IBM DTF File Transfer Commands
    1.4.5      IBM DTF Command Processor Commands
    1.4.6      DECnet-ULTRIX Network File Transfer Commands
    1.4.7      RSX-11M/M-PLUS DCL Commands
    1.4.8      DECnet-RSX NFT Switches
    1.4.9      DECnet-RSX FTS Switches
    1.4.10     PATHWORKS for DOS NFT Commands
    1.4.11     PATHWORKS for OS/2 NFT Commands
    1.4.12     VMS RMS Programming Access

  2      DTF File Specifications

  2.1     Specifying Remote IBM Files for DTF File Access

  2.2     Specifying Remote DECnet Files for IBM-Initiated DTF File Access
    2.2.1      Specifying Remote VMS Files
    2.2.2      Specifying Remote RSX-11M/M-PLUS Files
    2.2.3      Specifying Remote MS-DOS or OS/2 Files
    2.2.4      Specifying Remote ULTRIX Files

  2.3     IBM File Specification Qualifiers
    2.3.1      Qualifier Defaults
    2.3.2      Qualifier Restrictions When Accessing Remote VM and MVS Clients
    2.3.3      Qualifier Descriptions

  2.4     Setting Up DTF File Definition Files
    2.4.1      Adding an Entry to the File Definition Database
    2.4.2      Modifying an Entry in the File Definition Database
    2.4.3      Displaying File Definitions from the File Definition Database
    2.4.4      File Format and Syntax
    2.4.5      BASE and ALTERNATE_INDEX Sections
    2.4.6      INDEX, DATA, and PATH Subsections
    2.4.7      File Attributes

  3      DTF-Supported File Types

  3.1     Supported Input File Types
    3.1.1      Supported File Organizations
    3.1.2      Supported Record Formats
    3.1.3      Supported Record Lengths
    3.1.4      Supported Record Attributes

  3.2     Supported Output File Types
    3.2.1      Supported File Organizations
    3.2.2      Supported Record Formats
    3.2.3      Supported Record Lengths
    3.2.4      Supported Record Attributes

  3.3     File Transfer Considerations
    3.3.1      Transferring Files Between IBM Clients
    3.3.2      Transferring Files Between an IBM System and an ULTRIX, RSX-11M/M-PLUS, MS-DOS, or OS/2 Client
    3.3.3      VSAM File Transfer Restrictions
    3.3.4      Printer File Transfer Restrictions
    3.3.5      Transferring IBM Tape-Resident Files
    3.3.6      Transferring Files with Horizontal Tab Characters
    3.3.7      Keyed Access to Sequential Files

  4      Data Security

  4.1     Local Data Security

  4.2     Remote Data Security Without Proxy

  4.3     How to Specify an IBM User ID and Password

  4.4     What Is Proxy?
    4.4.1      Benefits of Using Proxy Access

  4.5     DECnet-Initiated Proxy

  4.6     IBM-Initiated Proxy
    4.6.1      Example of IBM-Initiated Transfer Request

  5      VMS File Transfer Operations

  5.1     Transferring Files Between VMS DTF Clients and IBM DTF Clients

  5.2     APPEND Command

  5.3     BACKUP Command

  5.4     CLOSE Command

  5.5     CONVERT Command

  5.6     COPY Command

  5.7     CREATE Command

  5.8     DELETE Command

  5.9     DIFFERENCES Command

  5.10    DIRECTORY Command
    5.10.1     Date and Time Restrictions for Created, Revised, and Expires Fields

  5.11    EXCHANGE/NETWORK Command

  5.12    OPEN Command

  5.13    READ Command

  5.14    SEARCH Command

  5.15    SUBMIT/REMOTE Command

  5.16    TYPE Command

  5.17    WRITE Command

  6      VMS TRANSFER/DTF File Transfer Operations

  6.1     Invoking the TRANSFER/DTF Utility

  6.2     Exiting the TRANSFER/DTF Utility

  6.3     Copying Files with the TRANSFER/DTF Utility

  6.4     Defining VMS/DTF Queue Attributes

  6.5     Displaying the Status of File Transfer Jobs

  6.6     Displaying VMS/DTF Queue Characteristics

  6.7     Displaying the VMS/DTF Software Version Number

  6.8     Canceling File Transfer Jobs

  6.9     Displaying VMS/DTF Error Messages

  7      Using the DTF for IBM Panel Interface

  7.1     The DTF Panel Interface

  7.2     The Operation Selection Panel

  7.3     The Send to Remote Panel

  7.4     The Receive from Remote Panel

  7.5     The Resume Previously Failed Transfer Panel

  7.6     The Transfer Execution Panel

  7.7     The Remote Node Options Panel

  7.8     The MVS Input File Options Panel

  7.9     The VM Input File Options Panel

  7.10    The MVS Output File Options Panel

  7.11    The VM Output File Options Panel

  7.12    The Network File Options Panel

  7.13    The Data Translation Options Panel

  7.14    The Post-Processing Options Panel

  7.15    The Batch Options Panel

  8      Using the DTF for IBM File Transfer Commands

  8.1     DTFSEND

  8.2     DTFRECV

  8.3     DTFRESUM

  9      Using the DTF for IBM Command Processor

  9.1     Invoking the DTF Command Processor

  9.2     The DTF Command

  9.3     DTF Subcommands
    9.3.1      CLEAR Subcommand
    9.3.2      DEFINE Subcommand
      9.3.2.1      Keywords and Keyvalues for Specifying the Input File
      9.3.2.2      Keywords and Keyvalues for Specifying the Output File
      9.3.2.3      Keywords and Keyvalues for Specifying Transfer Parameters
    9.3.3      END Subcommand
    9.3.4      TRANSFER Subcommand
    9.3.5      HELP
    9.3.6      LIST Subcommand
    9.3.7      RECALL Subcommand
    9.3.8      RESUME Subcommand
    9.3.9      SET Subcommand
    9.3.10     SHOW Subcommand

  9.4     DTF Command Processor Usage Considerations
    9.4.1      Using Tapes (MVS Systems)
    9.4.2      Using Tapes (VM Systems)
    9.4.3      Overriding the Server and Server Account

  9.5     Executing the DTF Command Processor in Batch Mode (VM Systems)

  9.6     Executing the DTF Command Processor in Batch Mode (MVS Systems)
    9.6.1      The SYSTSIN DD Card
    9.6.2      Notes and Restrictions for DTF Batch Mode Operations

  9.7     DTF Return Codes in DTF Batch Mode Operations

  9.8     Initiating DTF Command Processor Operations from Command Procedures
    9.8.1      Variables Set by DTF

  10     ULTRIX File Transfer Operations

  10.1    Transferring Files Between ULTRIX and IBM DTF Clients

  10.2    dcat Command

  10.3    dcp Command

  10.4    Remote Backup and Restore Operations

  10.5    dls Command

  10.6    drm Command

  10.7    Error Reporting

  11     RSX-11M/M-PLUS File Transfer Operations

  11.1    Transferring Files Between RSX-11M/M-PLUS DTF Clients and IBM DTF Clients

  11.2    APPEND Command

  11.3    COPY Command

  11.4    CREATE Command

  11.5    DELETE Command

  11.6    DIRECTORY Command

  11.7    SUBMIT/REMOTE Command

  11.8    TYPE Command

  11.9    Setting Default File Information

  11.10  Error Reporting

  12     MS-DOS and OS/2 File Transfer Operations

  12.1    Transferring Files Between MS-DOS or OS/2 DTF Clients and IBM DTF Clients

  12.2    APPEND Command

  12.3    COPY Command

  12.4    DELETE Command

  12.5    DIRECTORY Command

  12.6    SUBMIT Command

  12.7    TYPE Command

  12.8    Error Reporting

  A   Using VMS DATATRIEVE with DTF

  A.1     Defining a DATATRIEVE Domain to Access an IBM File
    A.1.1      Before Defining Your DATATRIEVE Domain
    A.1.2      Using the DATATRIEVE DEFINE Command

  A.2     Preparing a DATATRIEVE Domain for Access to an IBM File

  A.3     Manipulating Records from a Domain on an IBM System

  A.4     Ending a DATATRIEVE Session That Is Accessing an IBM File

  B   RMS File System and Programming Constraints

  B.1     RMS File System Constraints

  B.2     RMS Programming Restrictions
    B.2.1     Record Level Access to VSAM Files
      B.2.1.1      Unsupported VAX RMS Service Calls
      B.2.1.2      Unsupported RMS Extended Attribute Blocks
      B.2.1.3      Record Locking
      B.2.1.4      Programming Considerations for VSAM Indexed Files
      B.2.1.5      Programming Considerations for VSAM Relative Files
      B.2.1.6      Programming Considerations for VSAM Sequential Files
    B.2.2     Record Level Access to IBM Non-VSAM Files

  B.3     Supported RMS Service Calls
    B.3.1     $CLOSE
    B.3.2     $CONNECT
    B.3.3     $CREATE
    B.3.4     $DELETE
    B.3.5     $DISCONNECT
    B.3.6     $DISPLAY
    B.3.7     $ERASE
    B.3.8     $FIND
    B.3.9     $FREE
    B.3.10    $GET
    B.3.11    $OPEN
    B.3.12    $PARSE
    B.3.13    $PUT
    B.3.14    $RELEASE
    B.3.15    $REWIND
    B.3.16    $SEARCH
    B.3.17    $UPDATE

  C   Maintaining the VMS/DTF File Definition Database

  C.1     Adding Entries to the File Definition Database

  C.2     Displaying File Definition Attributes

  C.3     Modifying a File Definition
    C.3.1      Modifying the File Definition BASE Section
    C.3.2      Modifying File Definition ALTERNATE_INDEX Sections

  C.4     Removing an Entry from the File Definition Database

  D   VSAM File Support

  D.1     A VSAM Primer for Non-IBM Users
    D.1.1     Sequential and Relative Files
    D.1.2     Indexed Files

  D.2     DTF for IBM and VSAM Naming Conventions
    D.2.1     DTF for IBM Naming Conventions
    D.2.2     VSAM Naming Conventions
    D.2.3     Choosing Your Own Name for ALTERNATE_INDEX

  D.3     VSAM Cluster Attribute Defaults

  E   FTAM File Support

  E.1     Overview of VAX FTAM

  E.2     VAX FTAM User Facilities
    E.2.1      VAX FTAM Components
    E.2.2      File Transfers Using VAX FTAM Software and a DAP-FTAM Gateway

  E.3     FTAM Document Types
    E.3.1      Restrictions

  E.4     Examples of OSI-Initiated File Transfer Operations
    E.4.1      Examples of File Transfers Using the DAP-FTAM Gateway

  F   DTF Data Translation

  F.1     Controlling Data Translation on DECnet-Initiated File Transfers

  F.2     Controlling Data Translation on IBM-Initiated File Transfers

  F.3     DMCS/EBCDIC Translation Tables

  F.4     Field-Level Translation
    F.4.1      Creating a New Record Definition
    F.4.2      Supported CDD Data Structures
    F.4.3      Translation of Digital CDD and IBM Data Types

  G   Correspondence Between DTF for IBM Keywords and VMS/DTF Qualifiers

  EXAMPLES

  9-1        Sample REXX EXEC to Perform Post-Processing

  9-2        Sample JCL to Perform a Post-Processing Function

  9-3        Sample REXX EXEC to Automatically Recover a Transfer

  FIGURES

  1-1        Software Components in a DTF Environment

  2-1        Using the /MD x PASSWORD Qualifier - Part 1

  2-2        Using the /MD x PASSWORD Qualifier - Part 2

  4-1        Request Verified by MVS Proxy

  4-2        IBM-Initiated Access:  DECnet Client Node Not Running DTF

  7-1        Operation Selection Panel

  7-2        Send to Remote Panel

  7-3        Receive from Remote Panel

  7-4        Resume Previously Failed Transfer Panel

  7-5        Transfer Execution Panel (MVS Systems)

  7-6        Transfer Execution Panel (VM Systems)

  7-7        Remote Node Options Panel

  7-8        MVS Input File Options Panel

  7-9        VM Input File Options Panel

  7-10       MVS Output File Options Panel

  7-11       VM Output File Options Panel

  7-12       Network File Options Panel

  7-13       Data Translation Options Panel

  7-14       Post-Processing Options Panel

  7-15       Batch Options Panel (VM Systems)

  7-16       Batch Options Panel (MVS Systems)

  D-1        File Structure of VSAM Sequential or Relative Files

  D-2        File Structure for VSAM Indexed Files

  D-3        File Structure for VSAM Indexed File with Multiple Keys

  E-1        File Transfers Using VAX FTAM Software and a DAP-FTAM Gateway

  TABLES

  2-1        IBM File Specification Qualifiers and Their Usage for Remote VM Files

  2-2        IBM File Specification Qualifiers and Their Usage for Remote MVS Files

  2-3        MVS File Attributes and Their Usage in the BASE and ALTERNATE_INDEX Sections

  2-4        VM File Attributes and Their Usage in the BASE and ALTERNATE_INDEX Sections

  4-1        User ID and Password Syntax Rules

  4-2        Access to Remote Systems Without Proxy

  5-1        DTF Level of Support for APPEND Command Qualifiers

  5-2        DTF Level of Support for BACKUP Command Qualifiers

  5-3        DTF Level of Support for CLOSE Command Qualifiers

  5-4        DTF Level of Support for CONVERT Command Qualifiers

  5-5        DTF Level of Support for COPY Command Qualifiers

  5-6        DTF Level of Support for CREATE Command Qualifiers

  5-7        DTF Level of Support for DELETE Command Qualifiers

  5-8        DTF Level of Support for DIFFERENCES Command Qualifiers

  5-9        DTF Level of Support for DIRECTORY Command Qualifiers

  5-10       DTF Level of Support for EXCHANGE/NETWORK Command Qualifiers

  5-11       DTF Level of Support for OPEN Command Qualifiers

  5-12       DTF Level of Support for READ Command Qualifiers

  5-13       DTF Level of Support for SEARCH Command Qualifiers

  5-14       DTF Level of Support for SUBMIT/REMOTE Command Qualifiers

  5-15       DTF Level of Support for TYPE Command Qualifiers

  5-16       DTF Level of Support for WRITE Command Qualifiers

  6-1        Recoverable File Operations

  6-2        TRANSFER/DTF Support for DCL COPY Command Qualifiers

  6-3        Unique TRANSFER/DTF COPY Command Qualifiers

  10-1       DTF Level of Support for dcat Command Options

  10-2       DTF Level of Support for dcp Command Options

  10-3       DTF Level of Support for dls Command Options

  10-4       DTF Level of Support for drm Command Options

  11-1       Supported RSX-11M/M-PLUS File Transfer Commands

  11-2       DTF Level of Support for APPEND Command Qualifying Switches

  11-3       DTF Level of Support for COPY Command Qualifying Switches

  11-4       DTF Level of Support for CREATE Command Qualifying Switches

  11-5       DTF Level of Support for DELETE Command Qualifying Switches

  11-6       DTF Level of Support for DIRECTORY Command Qualifying Switches

  11-7       DTF Level of Support for SUBMIT/REMOTE Command Qualifying Switches

  11-8       DTF Level of Support for TYPE Command Qualifiers

  11-9       DAP Error Codes

  12-1       DTF Level of Support for APPEND Command Switches

  12-2       DTF Level of Support for COPY Command Switches

  12-3       VMS/DTF Level of Support for DELETE Command Switch

  12-4       DTF Level of Support for DIRECTORY Command Switches

  12-5       DTF Level of Support for SUBMIT Command Switch

  12-6       DTF Level of Support for TYPE Command Switch

  12-7       DAP Error Codes

  B-1        $CLOSE FAB and XAB Input Fields

  B-2        $CONNECT RAB Input Fields

  B-3        $CREATE FAB Input Fields

  B-4        $CREATE XAB Output Fields

  B-5        $DELETE RAB Input Fields

  B-6        $DISPLAY NAM Input Fields

  B-7        $DISPLAY FAB and XAB Output Fields

  B-8        $FIND RAB Input Fields

  B-9        $GET RAB Input Fields

  B-10       $OPEN FAB Input Fields

  B-11       $OPEN XAB Output Fields

  B-12       $PUT RAB Input Fields

  B-13       $RELEASE RAB Input Fields

  B-14       $UPDATE RAB Input and Output Fields

  E-1        VAX FTAM User Facilities Supported by DTF Software

  E-2        Restrictions

  E-3        DTF Support and Mapping Among FTAM, VMS, and IBM (MVS and VM) File Attributes

  F-1        Correspondence of CDD Data Types and IBM Data Types

  F-2        Limitations on Data Transferred from Digital to IBM

  F-3        Limitations on Data Transferred from IBM to Digital

  G-1        Correspondence Between VMS/DTF Qualifiers, DTF for IBM Command Processor Keywords, and DTF ISPF Entry Fields