Compaq Software Product Description ___________________________________________________________________ PRODUCT NAME: DIGITAL SNA Data Transfer SPD 27.85.08 Facility for OpenVMS, Version 3.3 This SPD describes DIGITAL SNA Data Transfer Facility for OpenVMS, which is available for the OpenVMS Alpha and OpenVMS VAX platforms. All in- formation applies to both platforms unless otherwise indicated. DESCRIPTION The DIGITAL SNA Data Transfer Facility for OpenVMS (DTF) is a layered software product that provides data transfer capabilities between IBM MVS systems in a Systems Network Architecture (SNA) environment, and DIGITAL nodes in a DIGITAL network. DTF supports the following: Open- VMS Alpha systems running DECnet for OpenVMS and OpenVMS VAX systems running DECnet-VAX. Access between the cooperating Digital and IBM en- vironments is via one of the following products: TCP/IP or DECnet Connections o DIGITAL SNA Peer Server o DIGITAL SNA Domain Gateway o DIGITAL SNA Access Server for Windows NT DECnet Only Connections o DECnet SNA Gateway for Synchronous Transport o DECnet SNA Gateway for Channel Transport Single OpenVMS VAX System o OpenVMS SNA (VAX systems only) February 1999 AE-KL24J-TE HIGHLIGHTS The following paragraphs briefly highlight the features of DTF. More detailed information is given in the Features section of this SPD. Client/Server-Style Operation The DTF product provides a client/server style of operation. The Open- VMS DTF server can support file operations between IBM MVS and DEC- net OpenVMS. No additional software besides DECnet software is required on the DECnet clients (except for OpenVMS recoverable copy operations). Refer to the Configuration section of this SPD for more information. Ease of Use DTF provides a familiar user interface for both Digital and IBM users. This feature supports easy application development and reduces staff training. Comprehensive, Bidirectional Access from All Supported Clients The DTF product enables bidirectional file transfer between all DTF- supported DECnet nodes and IBM MVS systems. Checkpoint and Recovery DTF provides OpenVMS and IBM users with checkpoint and recovery sup- port in the event of a system or network failure. This feature allows DTF to resume an interrupted recoverable copy operation when the net- work returns to a normal state. This saves significant time and sys- tem resources when large files are transferred. File Backup DTF allows OpenVMS users to target IBM disks and tapes for backup and restore operations. In large coresident Digital and IBM sites, this capability optimizes system resource usage. Users have the ability to include an allocation space qualifier when backing up files to tar- get IBM disks to ensure proper disk space availability. Remote Job Submission 2 DTF users can submit jobs remotely from all DECnet clients. Post-Processing Using DTF, OpenVMS, and IBM, users can provide a post-processing file to be executed after a file transfer is completed. This feature al- lows OpenVMS and IBM users to logically connect the running of a batch job to the successful completion of a DTF file transfer. This makes the implementation of distributed processing functions significantly easier to synchronize between IBM applications and DECnet-based ap- plications. Record-Level Access DTF supports record-level access from OpenVMS systems to IBM MVS sys- tems. Supported File Types DTF supports multiple file types (RMS, VSAM, BSAM, and CMS), allow- ing easy applications development. DTF also supports mixed case IBM file specifications. HSM Support DTF supports IBM's Hierarchical Storage Management (HSM) facility. IBM Enterprise Architecture and SMS Support DTF runs in compliance with IBM's Enterprise Architecture and will sup- port SMS-managed data sets (refer to the Supported IBM Configurations section). Data Translation Using Load Balancing and Performance Tuning DTF supports text translation from DMCS (Digital Multinational Char- acter Set, a superset of ASCII) to EBCDIC and vice versa on a record- by-record basis. DTF supports load balancing and performance tuning between the IBM system and the OpenVMS DTF server node by allowing users 3 to select which system performs the text translation. Enhanced per- formance of the OpenVMS DTF server often results when this transla- tion is performed on the IBM system. DTF also supports, through the Oracle CDD/Repository product, field-level translation. See Oracle Soft- ware Product Information SPI 003. Data Security Security is enhanced by the use of proxies. IBM users are not required to specify a DECnet password; DTF will initiate the access on the Open- VMS systems with a user ID derived from the IBM User ID. DTF controls access and protects valuable data with superior security capabilities. DTF supports the following industry-standard security interfaces that run on IBM machines: RACF, CA-ACF2[TM], SAF, and VMSECURE[TM]. Server Management The DTF product includes a management utility to manage the OpenVMS DTF server. Event Logging DTF for IBM logs events which can be used for historical inquiry or accounting. System programmers can easily write specialized account- ing and bill-back reports using DTF's logs. Components [**MOVE BACK TO DESCRIPTION SECTION??]There are three components to the DIGITAL SNA Data Transfer Facility for OpenVMS product: o Data Transfer Facility server (OpenVMS DTF server) software o Data Transfer Facility utilities (OpenVMS DTF utilities) software o Data Transfer Facility for IBM MVS system (DTF for MVS) software OpenVMS DTF Server Software 4 The OpenVMS DTF server software can be installed on any OpenVMS Al- pha or OpenVMS VAX system in a DECnet network containing an SNA gate- way or on any OpenVMS VAX system running OpenVMS SNA. The node that is running the OpenVMS DTF server software is referred to as the server node. All DTF file requests go through this server node which commu- nicates with the appropriate DTF for IBM system by using an SNA gate- way or by using OpenVMS SNA software. The server software also per- forms text translation (DMCS/EBCDIC). However, this can be done op- tionally by the DTF for IBM software. The Oracle CDD/Repository prod- uct is required on the OpenVMS DTF server node for the translation of data types other than DMCS/EBCDIC. The OpenVMS DTF server software in- cludes the OpenVMS DTF utilities software described in the next sec- tion. OpenVMS DTF Utilities Software The OpenVMS DTF utilities software is an optional component that can be installed on any OpenVMS system where users wish to transfer files using the recoverable copy feature. The utilities software should also be installed if IBM users will be requesting recoverable copies in- volving that OpenVMS node. The utilities software consists of a server management utility and a checkpoint/recovery utility (TRANSFER/DTF). The OpenVMS DTF utilities software communicates with the OpenVMS DTF server software to accomplish the data transfer. It is not necessary to install the OpenVMS DTF utilities software on the server node since these utilities are included in the OpenVMS DTF server software pack- age. DTF for MVS Software The DTF for MVS software can be installed on any IBM S/370-class or IBM S/390-class machine system running the MVS Operating System. DTF for MVS accepts file operation commands from the OpenVMS DTF server software and maps them into MVS file commands to perform the opera- tion. It also provides interfaces so TSO users can issue recoverable and non-recoverable copy commands in interactive or batch mode. DTF for MVS software consists of two parts: a VTAM application program that controls the communications with the OpenVMS DTF server nodes for the 5 purpose of transferring files, and user interfaces. The three user in- terfaces are: a TSO command processor, a single-line command inter- face (REXX required), and an ISPF dialog. Configuration A DTF for IBM component must be installed on each IBM system with which users want to communicate. The DECnet network requires one OpenVMS DTF server component installed on a OpenVMS system, and may require mul- tiple server component installations depending on the amount of use of DTF. All other OpenVMS nodes in the DECnet network do not require any additional software since DTF allows users to use standard DEC- net file transfer commands to access IBM files. The OpenVMS DTF util- ities software is required only if a particular OpenVMS system's users need the recoverable copy feature or if IBM users desire recoverable copy operations to that OpenVMS system. Recoverable copy works only to OpenVMS nodes with the OpenVMS DTF server software or the OpenVMS DTF utilities software installed. FEATURES The DTF product uses a variety of familiar user interfaces to make users more productive. Users do not have to learn new commands and proce- dures. Users in the OpenVMS environment can issue standard DCL commands, like COPY, TYPE, DIRECTORY, and so on. Alternatively, they can use the Record Management System (RMS) programming interface or the TRANSFER/DTF util- ity for data exchange between DECnet and IBM systems. IBM MVS users can access and transfer data by using the TSO DTF com- mand processor, the TSO ISPF panels, or the single-line interface. IBM VM users can use the CMS DTF command processor, the CMS ISPF panels or the single-line interface. The TSO and CMS command processors can also be invoked in batch mode. 6 DTF Access from OpenVMS Clients OpenVMS DTF users can initiate non-recoverable or recoverable, bidi- rectional file transfers between IBM DTF clients and themselves. DTF supports the following OpenVMS DCL commands. Note: Some of the qualifiers associated with these DCL commands are sub- ject to restrictions when used with DTF. APPEND DELETE SEARCH BACKUP DIFFERENCES REMOTE SUBMIT CLOSE DIRECTORY TYPE CONVERT EXCHANGE WRITE /NETWORK COPY OPEN CREATE READ DTF Access from IBM Clients IBM DTF users can initiate nonrecoverable or recoverable, bidirectional file transfers between OpenVMS DTF clients running the OpenVMS/DTF util- ities software and themselves. In addition, they can initiate nonre- coverable, bidirectional file transfer between all other DTF clients (including other IBM systems) and themselves. MVS TSO users have the following commands available to transfer files to or from other DTF clients. DTFSEND DTFRECV DTFRESUM DTF com- DTF ISPF DTF non-ISPF panels mand panels processor Checkpoint and Recovery Checkpoint and recovery capabilities ensure that data remains accu- rate and intact, even in the event of system or network failure. When OpenVMS users transfer files using the TRANSFER/DTF utility, it au- tomatically resumes an interrupted file-transfer process with no loss of data when communications between sending and receiving systems is 7 reestablished. Checkpoint and recovery is supported for non-VSAM and CMS files that are disk or tape resident. Checkpoint and recovery is not supported on VSAM files. IBM users have a similar checkpoint and recovery feature. A recover- able copy operation performed from an IBM system sets environment vari- ables (CLIST in MVS). If the transfer terminates with a network er- ror, these variables contain information to allow the user to resume the transfer. File Backup DTF allows OpenVMS users to back up and restore their disks directly to IBM tapes or disks using the OpenVMS BACKUP command. Users have the ability to include an allocation space qualifier when backing up files to target IBM disks to ensure proper disk space availability. Remote Job Submission OpenVMS users can submit JCL files on the IBM system to be executed by JES or by a batch machine. These users can use the standard DEC- net file operation commands to initiate the job submission. For ex- ample, OpenVMS users use SUBMIT/REMOTE. Users will not get the sta- tus of the job completion. IBM DTF users can submit jobs by using the post-processing feature described in the next section. Post-Processing Post-processing is the ability to submit a DCL command procedure or MVS JCL procedure after a file transfer is completed. IBM users can use the post-processing feature from either the command processor or the panel interface. OpenVMS users can use the post-processing fea- ture only through the TRANSFER/DTF utility. Record-Level Access DTF allows an OpenVMS user record-level access to IBM files by means of an RMS application, DCL commands, or DATATRIEVE. DTF does not sup- port record-level access initiated from IBM to OpenVMS RMS files. Supported File Types 8 All OpenVMS file types are supported. For IBM MVS systems, supported non-VSAM file types are those with the physical sequential data set organization. This includes normal se- quential files as well as partitioned data set members. Both disk-resident and tape-resident non-VSAM files are supported. Supported VSAM file types include entry-sequenced data sets (ESDS), relative-record data sets (RRDS), and key-sequenced data sets (KSDS). DTF provides an option for users to overcome the null record restric- tion by substituting a record containing a character or value chosen by the user. A mixed-case option supports applications on the IBM side that create file specifications that are case sensitive. The case qual- ifier supports file specifications that contain lower case characters. HSM Support DTF for MVS supports the Hierarchical Storage Management (HSM) facil- ity and allows users to recall migrated data sets. IBM system program- mers can tailor the number of concurrent outstanding HSM requests as well as device recall capability. SMS Support DTF for MVS supports the MVS Storage Management Subsystem (SMS) fa- cility. Data Translation DTF provides three options for data translation: no data translation at all, DMCS (Digital Multinational Character Set, a superset of ASCII) to EBCDIC and vice versa, and field-level translation. o Users can specify that DTF should perform no data translation dur- ing a file transfer. This option is useful for transferring image files. o By default, DTF performs data translation from DMCS to EBCDIC and vice versa on a record-by-record basis. This is the option normally used to transfer text files. 9 o Users can specify that DTF use alternate field-level translation. In this case, the OpenVMS DTF server software translates data types such as binary, integer, floating point, packed decimal, and nu- meric strings using Oracle CDD/Repository record definitions sup- plied by the user. The semantics of data in the file is maintained across a file transfer. The CDD/Repository product is required on the OpenVMS DTF server node for alternate field-level data trans- lation. By default, data translation is performed on the OpenVMS DTF server node. To decrease the load on the OpenVMS DTF server, the server man- ager can optionally specify that data translation (DMCS/EBCDIC) oc- cur on the IBM DTF client. Data Security Files on the IBM system are accessible only to Digital users who know the valid access control information. DTF for IBM provides interfaces into the CA-ACF2, RACF, and VMSECURE security systems and a standard user exit for other security mechanisms (such as CA-TOPSECRET[TM]) through the System Authorization Facility (SAF) interface. For Digital sys- tems, security is maintained by using the standard file protection mech- anism provided by the base operating system. DTF also allows DECnet style proxy information to be stored on the IBM system using standard IBM system security packages (CA-ACF2, RACF). For ease of use, DTF for IBM allows users to perform file transfers without having to provide passwords for their files located on their own IBM system. Server Management DTF for OpenVMS provides a management utility to manage the server ac- count database, the file definition database, and the DTF proxy databases on the OpenVMS DTF server. The server account database allows the server to support file transfer requests to many different IBM DTF clients. The file definition database allows users to store the IBM file spec- ifications for frequently accessed files. The proxy database allows 10 the server manager to set up mappings that allow users to enter re- quests without specifying their IBM passwords. Refer to the Data Se- curity section for more information. Event Logging DTF for IBM logs events which can be used for historical inquiry or for accounting usage. Historical logging can be used to characterize the use of DTF for IBM. Such information is necessary for decisions involving operating hours, performance tuning, and load analysis of the network and operating system. Account logging allows users of DTF for IBM functions to be recorded along with the resources they con- sume. The granularity of the information is sufficient to provide a bill-back capability. Implementation of the accounting and billing ca- pability is handled with a user exit and can be customized on a per- site basis. INSTALLATION Installation services from Compaq are recommended for a customer's first purchase of this software product. These services provide for instal- lation of the software product by an experienced software specialist. Customer Responsibilities Before installation of the software, the customer must: o Previously have installed all prerequisite software and hardware including terminals. o Have demonstrated, to Compaq's satisfaction, any necessary IBM host software that will be communicating with the SNA gateway and the APPC programming Interface. o Make available for a reasonable period of time, as mutually agreed by Compaq and the customer, all hardware, communications facili- ties, and terminals that are to be used during installation. Installation service is available on a time and material basis. Con- tact your local Compaq office for more detailed information. 11 HARDWARE REQUIREMENTS Processors Supported For a list of supported processors, refer to the OpenVMS Operating Sys- tem for Alpha and VAX Software Product Description (SPD 25.01.xx). Disk Space Requirements DTF Server for OpenVMS (Block Cluster Size = 1): VAX Alpha Disk space 5006 5547 blocks required for blocks installation: Disk space 1987 3196 blocks required for blocks use: DTF Utilities for OpenVMS (Block Cluster Size = 1:) VAX Alpha Disk space 2323 2462 blocks required for blocks installation: Disk space 1101 1544 blocks required for blocks use: DTF for MVS (Listed in 3380 Tracks): Disk space 185 required for tracks installation: Disk space 61 required for tracks use: 12 SOFTWARE REQUIREMENTS The DIGITAL SNA Data Transfer Facility for OpenVMS requires the fol- lowing software: For OpenVMS DTF Server and OpenVMS DTF Utilities on OpenVMS Alpha Sys- tems o OpenVMS Operating System for Alpha and VAX Version 6.2, 7.1, or 7.2 (SPD 25.01.xx) o DECnet for OpenVMS AXP (SPD 42.25.xx) o DIGITAL TCP/IP Services for OpenVMS, V4.0 (SPD 46.46.xx) For OpenVMS DTF Server and OpenVMS DTF Utilities on OpenVMS VAX Sys- tems in an SNA Gateway Environment o OpenVMS Operating System for Alpha and VAX Version 6.2, 7.1, or 7.2 (SPD 25.01.xx) o DECnet for OpenVMS and Alpha (SPD 48.48.xx) o DEC TCP/IP Services for OpenVMS VAX, V3.3 (SPD 25.A4.xx) Required SNA Gateway One of the following SNA gateways is required for DTF to run: o DECnet SNA Gateway for Channel Transport (SPD 29.76.xx) o DECnet SNA Gateway for Synchronous Transport (SPD 25.C6.xx) o DIGITAL SNA Domain Gateway (SPD 38.69.xx) o DIGITAL SNA Peer Server (SPD 51.08.xx) o DIGITAL SNA Access Server for Windows NT (SPD 64.79.xx) For OpenVMS DTF Server and OpenVMS DTF Utilities on OpenVMS VAX Sys- tems in an OpenVMS SNA Environment o OpenVMS Operating System for Alpha and VAX Version 6.2, 7.1, or 7.2 (SPD 25.01.xx) 13 o OpenVMS SNA (SPD 27.01.xx) For OpenVMS Clients o DECnet-VAX For IBM MVS Clients o VTAM o MVS/ESA or MVS/XA o DFP/ESA or DFP/XA o SMP/E o High-Level Assembler o DTF for MVS SOFTWARE LICENSING This software is furnished under a license. For more information about Compaq's licensing terms and policies, contact your local Compaq of- fice. DTF for IBM MVS Software License is by IBM Model Number regardless of the CPUs incorporated in a given IBM Model Number. For example, IBM Model 3090-600S. License Management Facility Support The OpenVMS portions of this software product support the OpenVMS Li- cense Management Facility. License units for this product are allocated on an Unlimited System Use basis. For more information on the License Management Facility, refer to the OpenVMS Operating System for Alpha and VAX Software Product Descrip- tion (SPD 25.01.xx), or the License Management Facility manual of the OpenVMS Operating System documentation set. 14 GROWTH CONSIDERATIONS The minimum hardware and software requirements for any future version of this product may be different from the requirements for the cur- rent version. DISTRIBUTION MEDIA This product is available as part of the OpenVMS Alpha and OpenVMS VAX Software Product Libraries on CD-ROM. The software documentation is available as part of the OpenVMS Alpha and OpenVMS VAX Online Documentation Libraries on CD-ROM. Documenta- tion in hardcopy format can be ordered separately. YEAR 2000 READY This product is capable of accurately processing, providing, and/or receiving date data from, into, and between the twentieth and the twenty- first centuries and the years 1999 and 2000, including leap year cal- culations, when used in accordance with the associated product doc- umentation and provided that all hardware, firmware, and software used in combination with the product properly exchange accurate date data with the product. SOFTWARE WARRANTY This software product is provided by Compaq with a 90-day conformance warranty in accordance with the Compaq warranty terms applicable to the license purchase. The DTF for IBM software described in this SPD has been written in ac- cordance with the following IBM System Integrity Standards: o MVS System Integrity Standard as defined in IBM Programming Announce- ment P81-174 dated October 21, 1981 Warranty Limitations 15 Supported IBM Configurations This software has been tested and is warranted against IBM System/370 and IBM System/390 (includes 9xxx, 30xx, and 43xx series) class pro- cessor systems configured with the following IBM software. While this software may function correctly with other IBM software and equipment, and with software other than that supported by IBM, Compaq cannot of- fer its standard warranty for this software unless it has been tested with such equipment and software configurations. The DIGITAL SNA Data Transfer Facility Version 3.3 product has been tested and warranted against the following IBM software configurations: ___________________________________________________________________ Software Prod- uct________________Version___Release_______________________________ MVS/ESA 5 2.2 ACF/VTAM 4 4.0 TSO/E All All OS/390 All All Communications All All Server_____________________________________________________________ ORDERING INFORMATION DECnet SNA Data Transfer Facility for OpenVMS For DTF Server on OpenVMS Alpha: Software Licenses: QL-205A*-** Software Documentation: QA-VEBA*-GZ Software Product Services: QT-205A*-** For DTF Utilities on OpenVMS Alpha: Software Licenses: QL-206A*-** Software Documentation: QA-VEKA*-GZ Software Product Services: QT-206A*-** 16 Media and documentation for this product are available on the Open- VMS Alpha and OpenVMS VAX Software Product and Online Documentation Libraries on CD-ROM. Documentation in hardcopy format can be ordered separately. For DTF Server on OpenVMS VAX: Software Licenses: QL-VEBA*-** Software Media: QL-VEBA*-** Software Documentation: QL-VEBA*-GZ Software Product Services: QT-VEBA*-** For DTF Utilities on OpenVMS VAX: Software Licenses: QL-VEKA*-** Software Media: QA-VEKA*-** Software Documentation: QA-VEKA*-GZ Software Product Services: QT-VEKA*-** DTF for IBM Software DTF for MVS: Software License: QL-1GQA9-AA Software Media: QA-1GQAA-** Software Documentation: QA-1GQAA-GZ Software Product Services: QT-1GQA*-** * Denotes variant fields. For additional information on available li- censes, services, and media, refer to the appropriate price book. SOFTWARE PRODUCT SERVICES A variety of service options are available from Compaq. For more in- formation, contact your local Compaq office. 17 [R] IBM and VTAM are registered trademarks of International Business Machines Corporation. [R] CDD/Repository is a registered trademark of Oracle Corpora- tion. [TM] CA-ACF2 and CA-TOPSECRET are trademarks of Computer Asso- ciates International, Inc. [TM] DEC, DECnet, DIGITAL, OpenVMS, and VAX are trademarks of Compaq Computer Corporation. Compaq and the Compaq logo are registered in the United States Patent and Trademark Office. Other product names mentioned herein may be trademarks and /or registered trademarks of their respective companies. © 1999 Digital Equipment Corporation. All rights reserved. 18