HEWLETT-PACKARD Software Product Description ___________________________________________________________________ PRODUCT NAME: HP SNA Data Transfer SPD 27.85.13 Facility for OpenVMS, Version 3.6 This SPD describes HP SNA Data Transfer Facility for OpenVMS, which is available for the OpenVMS I64, OpenVMS Alpha and OpenVMS VAX plat- forms. All information applies to all platforms unless otherwise in- dicated. DESCRIPTION The HP SNA Data Transfer Facility for OpenVMS (DTF/VMS) is a layered software product that provides data transfer capabilities between IBM mainframe systems in a Systems Network Architecture (SNA) environment and OpenVMS nodes in an OpenVMS network. The Data Transfer Facility for OpenVMS software communicates with the Mainframe Data Transfer Facility software (MDU) running on the IBM sys- tem. DTF for OpenVMS supports I64, Alpha and VAX systems in a DECnet en- vironment. Access between the cooperating HP and IBM environments is via one of the following products: o HP SNA Server for OpenVMS Alpha, a layered product that supports local access as well as remote DECnet clients. o HP SNA Server for OpenVMS VAX, a layered product that supports lo- cal access as well as remote DECnet clients. o HP SNA Peer Server o HP SNA Domain Gateway o HP SNA Access Server for Windows NT o HP DECnet SNA Gateway for Synchronous Transport December 2006 HP SNA Data Transfer SPD 27.85.13 Facility for OpenVMS, Version 3.6 o HP DECnet SNA Gateway for Channel Transport HIGHLIGHTS The following paragraphs briefly highlight the features of DTF for Open- VMS. More detailed information is given in the Features section of this SPD. Client/Server-Style Operation The DTF for OpenVMS product provides a client/server style of oper- ation. The OpenVMS DTF server can support file operations between IBM mainframe systems in an SNA environment and OpenVMS in a DECnet en- vironment. No additional software is required on other nodes in the OpenVMS network (except for OpenVMS recoverable copy operations). Re- fer to the Configuration section of this SPD for more information. Ease of Use DTF for OpenVMS provides a familiar user interface for both HP and IBM users. This feature supports easy application development and reduces staff training. Comprehensive, Bidirectional Access The DTF for OpenVMS product enables bidirectional file transfer be- tween all DTF-supported nodes and IBM mainframe systems. Checkpoint and Recovery DTF for OpenVMS provides OpenVMS and IBM users with checkpoint and re- covery support in the event of a system or network failure. This fea- ture allows DTF to resume an interrupted recoverable copy operation when the network returns to a normal state. This saves significant time and system resources when large files are transferred. File Backup DTF for OpenVMS allows OpenVMS users to target IBM disks and tapes for backup and restore operations. In large co-resident HP and IBM sites, this capability optimizes system resource usage. Users have the abil- ity to include an allocation space qualifier when backing up files to target IBM disks to ensure proper disk space availability. 2 HP SNA Data Transfer SPD 27.85.13 Facility for OpenVMS, Version 3.6 Remote Job Submission DTF for OpenVMS users can submit jobs remotely from all clients. Post-Processing Using DTF for OpenVMS, OpenVMS, and IBM, users can provide a post-processing file to be executed after a file transfer is completed. This feature allows 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 OpenVMS-based ap- plications. Record-Level Access DTF for OpenVMS supports record-level access from OpenVMS systems to IBM mainframe systems. Supported File Types DTF for OpenVMS supports multiple file types (RMS, VSAM, and BSAM), allowing easy applications development. DTF also supports mixed case IBM file specifications. HSM Support DTF for OpenVMS supports IBM's Hierarchical Storage Management (HSM) facility. IBM Enterprise Architecture and SMS Support DTF for OpenVMS runs in compliance with IBM's Enterprise Architecture and will support SMS-managed data sets (refer to the Supported IBM Con- figurations section). Data Translation Using Load Balancing and Performance Tuning DTF for OpenVMS supports text translation from HP DMCS (Digital Multi- national Character Set, a superset of ASCII) to EBCDIC and vice versa on a record-by-record basis. DTF for OpenVMS supports load balancing and performance tuning between the IBM system and the OpenVMS DTF server node by allowing users to select which system performs the text trans- lation. Enhanced performance of the OpenVMS DTF server often results when this translation is performed on the IBM system. 3 HP SNA Data Transfer SPD 27.85.13 Facility for OpenVMS, Version 3.6 Data Security DTF for OpenVMS controls access and protects valuable data with su- perior security capabilities. The mainframe component supports the industry- standard SAF security interface that runs on IBM machines. Proxy access to the IBM system allows OpenVMS users to access the main- frame system without IBM user IDs and passwords flowing over the net- work connections. Server Management The DTF for OpenVMS product includes a management utility to manage the OpenVMS DTF server. Event Logging The mainframe component logs events which can be used for historical inquiry or accounting. System programmers can easily write special- ized accounting and bill-back reports using DTF's logs. Components There are three components to the HP SNA Data Transfer Facility for OpenVMS Version 3.6 product: o Data Transfer Facility server (OpenVMS DTF server), Version 3.6 o Data Transfer Facility utilities (OpenVMS DTF utilities), Version 3.6 o Mainframe Data Transfer Facility (MDU), Version 3.2 OpenVMS DTF Server The OpenVMS DTF server software can be installed on any OpenVMS I64, OpenVMS Alpha or OpenVMS VAX system in a network containing an SNA gate- way or server. The node that is running the OpenVMS DTF server soft- ware is referred to as the server node. All DTF file requests go through this server node which communicates with the Mainframe DTF system us- ing an SNA gateway or server. The DTF server software also performs text translation (DMCS/EBCDIC). However, this can be done optionally 4 HP SNA Data Transfer SPD 27.85.13 Facility for OpenVMS, Version 3.6 by the MDU software. The OpenVMS DTF server software includes the Open- VMS DTF utilities software described in the next section. OpenVMS DTF Utilities 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. Mainframe DTF Mainframe DTF (MDU) is a layered software product that operates on an IBM mainframe. The Mainframe DTF (MDU) software can be installed on any IBM S/370-class, IBM S/390-class, or IBM zSeries Server running in 31-bit mode. MDU is also supported under z/OS running in 64-bit mode. MDU accepts file operation commands from the OpenVMS DTF server soft- ware and maps them into mainframe file commands to perform the oper- ation. It also provides interfaces so TSO users can issue recoverable and non-recoverable copy commands in interactive or batch mode. MDU software consists of two parts: a VTAM application program that con- trols the communications with the OpenVMS DTF server nodes for the pur- pose 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. 5 HP SNA Data Transfer SPD 27.85.13 Facility for OpenVMS, Version 3.6 Configuration MDU must be installed on each IBM system with which users want to com- municate. The HP network requires one OpenVMS DTF server component in- stalled on a OpenVMS system, and may require multiple server compo- nent installations depending on the amount of use of DTF. Other Open- VMS nodes in the network do not require any additional software since DTF allows users to use standard file transfer commands to access IBM files. The OpenVMS DTF utilities software is required only if a par- ticular OpenVMS system's users need the recoverable copy feature or if IBM users desire recoverable copy operations to that OpenVMS sys- tem. Recoverable copy works only to OpenVMS nodes with the OpenVMS DTF server software or the OpenVMS DTF utilities software installed. FEATURES The DTF for OpenVMS product uses a variety of familiar user interfaces to make users more productive. Users do not have to learn new commands and procedures. 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 OpenVMS and IBM systems. IBM mainframe users can access and transfer data by using the TSO DTF command processor, the TSO ISPF panels, or the single-line interface. The TSO command processor can also be invoked in batch mode. 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 6 HP SNA Data Transfer SPD 27.85.13 Facility for OpenVMS, Version 3.6 BACKUP DIFFERENCES REMOTE SUBMIT CLOSE DIRECTORY TYPE CONVERT EXCHANGE/NETWORK WRITE COPY OPEN CREATE READ DTF Access from the Mainframe 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. Mainframe 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 reestablished. Checkpoint and recovery is supported for non-VSAM files that are disk or tape resident. Checkpoint and recovery is not sup- ported on VSAM files. 7 HP SNA Data Transfer SPD 27.85.13 Facility for OpenVMS, Version 3.6 IBM users have a similar checkpoint and recovery feature. A recover- able copy operation performed from an IBM system sets environment vari- ables (CLISTs). If the transfer terminates with a network error, these variables contain information to allow the user to resume the trans- fer. File Backup DTF for OpenVMS 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 back- ing up files to target IBM disks to ensure proper disk space avail- ability. 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 file operation commands to initiate the job submission. For example, Open- VMS users use SUBMIT/REMOTE. Users will not get the status 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 mainframe JCL procedure after a file transfer is completed. IBM users can use the post-processing feature from either the command proces- sor or the panel interface. OpenVMS users can use the post-processing feature only through the TRANSFER/DTF utility. Record-Level Access DTF for OpenVMS allows an OpenVMS user record-level access to IBM files by means of an RMS application or DCL commands. DTF does not support record-level access initiated from IBM to OpenVMS RMS files. 8 HP SNA Data Transfer SPD 27.85.13 Facility for OpenVMS, Version 3.6 Supported File Types All OpenVMS file types are supported. ODS-5 Extended File Specifica- tion is not supported. For IBM mainframe systems, supported non-VSAM file types are those with the physical sequential data set organization. This includes normal sequential 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 for OpenVMS provides an option for users to overcome the null record restriction 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 qualifier supports file specifications that contain lower case characters. HSM Support MDU supports the Hierarchical Storage Management (HSM) facility and allows users to recall migrated data sets. IBM system programmers can tailor the number of concurrent outstanding HSM requests as well as device recall capability. SMS Support MDU supports the mainframe Storage Management Subsystem (SMS) facil- ity. Data Translation DTF for OpenVMS provides two options for data translation: no data trans- lation at all and HP DMCS (Digital Multinational Character Set, a su- perset of ASCII) to EBCDIC and vice versa. o Users can specify that DTF for OpenVMS should perform no data trans- lation during a file transfer. This option is useful for transfer- ring image files. 9 HP SNA Data Transfer SPD 27.85.13 Facility for OpenVMS, Version 3.6 o By default, DTF for OpenVMS performs data translation from DMCS to EBCDIC and vice versa on a record-by-record basis. This is the op- tion normally used to transfer text files. 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 system. Data Security Files on the IBM system are accessible only to HP users with valid ac- cess control information. MDU provides a standard user exit for se- curity mechanisms through the System Authorization Facility (SAF) in- terface. For OpenVMS systems, security is maintained by using the stan- dard file protection mechanism provided by the base operating system. MDU also allows proxy information to be stored on the IBM system us- ing standard IBM system security packages. For ease of use, the proxy information allows OpenVMS users to per- form file transfers without having to provide passwords for their files located on the 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 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. 10 HP SNA Data Transfer SPD 27.85.13 Facility for OpenVMS, Version 3.6 Event Logging MDU logs events which can be used for historical inquiry or for ac- counting usage. Historical logging can be used to characterize the use of MDU. Such information is necessary for decisions involving oper- ating hours, performance tuning, and load analysis of the network and operating system. Account logging allows users of MDU functions to be recorded along with the resources they consume. The granularity of the information is sufficient to provide a bill-back capability. Imple- mentation of the accounting and billing capability is handled with a user exit and can be customized on a per-site basis. INSTALLATION Installation services from HP 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. HARDWARE REQUIREMENTS Processors Supported For a list of supported processors, refer to the OpenVMS Operating Sys- tem for I64, Alpha and VAX Software Product Description (SPD 82.35.xx and 25.01.xx). Disk Space Requirements DTF Server for OpenVMS (Block Cluster Size = 1): I64 Alpha VAX Disk space 18200 5547 5006 blocks required for blocks blocks installation: Disk space re- 11854 3196 1987 blocks quired for use blocks blocks (permanent): DTF Utilities for OpenVMS (Block Cluster Size = 1:) I64 Alpha VAX 11 HP SNA Data Transfer SPD 27.85.13 Facility for OpenVMS, Version 3.6 Disk space 5940 2462 2323 blocks required for blocks blocks installation: Disk space re- 3820 1544 1101 blocks quired for use blocks blocks (permanent): SOFTWARE REQUIREMENTS Using HP SNA Data Transfer Facility for OpenVMS requires: o OpenVMS Operating System for I64 Version 8.2-1 or 8.3 (SPD 82.35.xx) o OpenVMS Operating System for Alpha Version 8.2 or 8.3 (SPD 82.35.xx) o OpenVMS Operating System for VAX Version 7.3 (SPD 25.01.xx) A networking product appropriate for the version of OpenVMS, plus one of the SNA server or gateway products listed below. Networking options include: o DECnet for OpenVMS (Phase IV, SPD 48.48.xx) o DECnet-Plus (Phase V, SPD 50.45.xx for I64 and Alpha, SPD 25.03.xx for VAX) Choose a networking option appropriate for the selected OpenVMS ver- sion from the following table: ________________________________________________________________ DECnet OpenVMS_____IV__________DECnet_V________________________________ 8.3 8.3 8.3 (I64) 8.2-1 8.2-1 8.2-1 (I64) 12 HP SNA Data Transfer SPD 27.85.13 Facility for OpenVMS, Version 3.6 ________________________________________________________________ DECnet OpenVMS_____IV__________DECnet_V________________________________ 8.3 8.3 8.3 (Alpha) 8.2 8.2 8.2 (Alpha) 7.3 7.3 7.3 (VAX)___________________________________________________________ o One of the following SNA server or gateway products: o HP DECnet SNA Gateway for Channel Support (SPD 29.76.xx) o HP DECnet SNA Gateway for Synchronous Transport (SPD 25.C6.xx) o HP SNA Domain Gateway (SPD 38.69.xx) o HP SNA Peer Server (SPD 51.08.xx) o HP SNA Server for OpenVMS Alpha (SPD 70.89.xx) o HP SNA Server for OpenVMS VAX (SPD 27.01.xx) o HP SNA Access Server for Windows NT (SPD 64.79.xx) o On the IBM System, Mainframe Data Transfer Facility (MDU) is re- quired. OPTIONAL SOFTWARE This HP OpenVMS SNA access routine has been qualified and tested to run over the Data Access Incorporated (DAI) Mainframe Gateway for Open- VMS (MGO). Questions and issues related to the DAI MGO product are man- aged by DAI and are not an HP OpenVMS obligation. 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. 13 HP SNA Data Transfer SPD 27.85.13 Facility for OpenVMS, Version 3.6 DISTRIBUTION MEDIA The DTF Server for OpenVMS and the DTF Utilities for OpenVMS are avail- able as part of the OpenVMS I64, Alpha and VAX Software Product Li- braries on CD-ROM. The software documentation is available as part of the OpenVMS I64, Alpha and VAX Online Documentation Libraries on CD-ROM. Documentation in hardcopy format can be ordered separately. MDU is available on 3480 cartridge tape. SOFTWARE LICENSING License Management Facility Support HP SNA 3270 Data Stream Programming Interface for OpenVMS supports the OpenVMS License Management Facility (LMF). This facility allocates li- cense units as follows: o For OpenVMS Integrity, each Per Core License (PCL) allows any num- ber of individuals to use the product at the same time, with one PCL license required for each processor core running OpenVMS. o For OpenVMS Alpha and VAX, the Unlimited license allows any num- ber of individuals to use the product at the same time. ORDERING INFORMATION Licenses License types vary by platform. 14 HP SNA Data Transfer SPD 27.85.13 Facility for OpenVMS, Version 3.6 ___________________________________________________________________ __________________HP_OpenVMS_Integrity_Licenses[1]_________________ SNA DTF Server Per Core BA479AC License (PCL)[2]: SNA DTF Utilities Per BA480AC Core License (PCL)[2]: ___________________________________________________________________ [1]Update licenses not available; updates available through SW Updates Service. [2]Order one PCL license for each active processor core running OpenVMS.___________________________________________________________ ___________________________________________________________________ _____________________HP_OpenVMS_Alpha_Licenses_____________________ SNA DTF Server Unlimited QL-205A*-AA[1] Use License SNA DTF Server Unlimited QL-205A*-RA[1] Use Update License SNA DTF Utilities Unlim- QL-206A*-AA[1] ited Use License SNA DTF Utilities Unlim- QL-206A*-RA[1] ited Use Update License ___________________________________________________________________ [1]Asterisk denotes system tier. E=workgroup tier, G=departmental tier,_Q=enterprise_tier.___________________________________________ ___________________________________________________________________ ______________________HP_OpenVMS_VAX_Licenses______________________ SNA DTF Server Unlimited QL-VEBA*-AA[1] Use License ___________________________________________________________________ [1]Asterisk denotes system tier. B=workgroup tier, 2=departmental tier, 5=enterprise tier. 15 HP SNA Data Transfer SPD 27.85.13 Facility for OpenVMS, Version 3.6 ___________________________________________________________________ ______________________HP_OpenVMS_VAX_Licenses______________________ SNA DTF Server Unlimited QL-VEBA*-RA[1] Use Update License SNA DTF Utilities Unlim- QL-VEKA*-AA[1] ited Use License SNA DTF Utilities Unlim- QL-VEKA*-RA[1] ited Use Update License ___________________________________________________________________ [1]Asterisk denotes system tier. B=workgroup tier, 2=departmental tier,_5=enterprise_tier.___________________________________________ Media and Documentation Product binary kits and online documentation are delivered on consol- idated media libraries. Delivery model varies by platform. ___________________________________________________________________ _______HP_OpenVMS_Integrity_Media_and_Online_Documentation[1]______ Foundation Operating BA322AA#AJR Environment Enterprise Operating BA323AA#AJR Environment Mission Critical Operat- BA324AA#AJR ing Environment ___________________________________________________________________ [1]Product ships on Layered Products Library media included in all Operating Environment media kits, available with initial OpenVMS OE_order.__________________________________________________________ 16 HP SNA Data Transfer SPD 27.85.13 Facility for OpenVMS, Version 3.6 ___________________________________________________________________ __________HP_OpenVMS_Alpha_Media_and_Online_Documentation__________ Software Layered Products QA-03XAA-H8 Library Package[1] Software Layered Products QA-5G98A-H8 and Operating System Library Package [1] ___________________________________________________________________ [1]Quarterly_Software_Updates_Service_is_available.________________ ___________________________________________________________________ ___________HP_OpenVMS_VAX_Media_and_Online_Documentation___________ Software Layered Products QA-5G88A-H8 Library Package[1] Software Layered Products QA-YL48A-H8 and Operating System Library Package [1] ___________________________________________________________________ [1]Quarterly_Software_Updates_Service_is_available.________________ ___________________________________________________________________ _________________HP_OpenVMS_Documentation_(Printed)________________ SNA_DTF_Documentation________QL-VEBAA-GZ___________________________ 17 HP SNA Data Transfer SPD 27.85.13 Facility for OpenVMS, Version 3.6 ___________________________________________________________________ _________________HP_OpenVMS_Integrity_SW_Update[1]_________________ HP SNA DTF Server VMS I64 BA479AA Media HP SNA DTF Utilities VMS BA480AA I64 Media ___________________________________________________________________ [1]For the OpenVMS Integrity platform, media updates are ordered by adding SW Updates Service to individual products. The above media product numbers must be pulled into an order if SW Updates Service_is_planned.________________________________________________ NOTE: If you are adding a layered product to an existing OpenVMS In- tegrity system and do not have the latest software revision on site, please contact your local Sales Representative to request a Special Media kit. SOFTWARE PRODUCT SERVICES A variety of service options are available from HP. For more infor- mation, contact your HP account representative or distributor. Infor- mation is also available on www.hp.com/hps/software. SOFTWARE WARRANTY This software is provided by HP with a ninety-day conformance warranty in accordance with the HP warranty terms applicable to a license pur- chase. © 2006 Hewlett-Packard Development Corporation, L.P. Confidential computer software. Valid license from HP required for pos- session, use, or copying. Consistent with FAR 12.211 and 12.212, Com- mercial Computer Software, Computer Software Documentation, and Tech- nical Data for Commercial Items are licensed to the U.S. Government under vendor's standard commercial license. 18 HP SNA Data Transfer SPD 27.85.13 Facility for OpenVMS, Version 3.6 The information contained herein is subject to change without notice. The only warranties for HP products and services are set forth in the express warranty statements accompanying such products and services. Nothing herein should be construed as constituting an additional war- ranty. HP shall not be liable for technical or editorial errors or omis- sions contained herein. Apple is a trademark of Apple Computer, Inc., registered in the U.S. and other countries. Intel, Intel Itanium and Pentium are trademarks or registered trade- marks of Intel Corporation or its subsidiaries in the United States and other countries. Motif and OSF/1 are registered trademarks of The Open Group. PostScript is a registered trademark of Adobe Systems Incorporated. TEKTRONIX and Tek are registered trademarks of Tektronix, Inc. X Window System is a trademark of Massachusetts Institute of Technol- ogy. 19