Sun Enterprise Systems Interface 1.0 Installation
Total Page:16
File Type:pdf, Size:1020Kb
Sun Enterprise™ Systems Interface 1.0 Installation and User Guide With Release Notes and Reference Section Sun Microsystems, Inc. 901 San Antonio Road Palo Alto,CA 94303-4900 U.S.A. 650-960-1300 Part No. 806-5690-10 January 2001, Revision A Send comments about this document to: [email protected] Copyright 2001 Sun Microsystems, Inc., 901 San Antonio Road, Palo Alto, California 94303-4900 U.S.A. All rights reserved. This product or document is protected by copyright and distributed under licenses restricting its use, copying, distribution, and decompilation. No part of this product or document may be reproduced in any form by any means without prior written authorization of Sun and its licensors, if any. Third-party software, including font technology, is copyrighted and licensed from Sun suppliers. Parts of the product may be derived from Berkeley BSD systems, licensed from the University of California. UNIX is a registered trademark in the U.S. and other countries, exclusively licensed through X/Open Company, Ltd. For Netscape Communicator™, the following notice applies: (c) Copyright 1995 Netscape Communications Corporation. All rights reserved. Sun, Sun Microsystems, the Sun logo, docs.sun.com, Sun Enterprise, and Solaris are trademarks, registered trademarks, or service marks of Sun Microsystems, Inc. in the U.S. and other countries. All SPARC trademarks are used under license and are trademarks or registered trademarks of SPARC International, Inc. in the U.S. and other countries. Products bearing SPARC trademarks are based upon an architecture developed by Sun Microsystems, Inc. The OPEN LOOK and Sun™ Graphical User Interface was developed by Sun Microsystems, Inc. for its users and licensees. Sun acknowledges the pioneering efforts of Xerox in researching and developing the concept of visual or graphical user interfaces for the computer industry. Sun holds a non-exclusive license from Xerox to the Xerox Graphical User Interface, which license also covers Sun’s licensees who implement OPEN LOOK GUIs and otherwise comply with Sun’s written license agreements. Federal Acquisitions: Commercial Software-Government Users Subject to Standard License Terms and Conditions. DOCUMENTATION IS PROVIDED “AS IS” AND ALL EXPRESS OR IMPLIED CONDITIONS, REPRESENTATIONS AND WARRANTIES, INCLUDING ANY IMPLIED WARRANTY OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE OR NON-INFRINGEMENT, ARE DISCLAIMED, EXCEPT TO THE EXTENT THAT SUCH DISCLAIMERS ARE HELD TO BE LEGALLY INVALID. Copyright 2001 Sun Microsystems, Inc., 901 San Antonio Road, Palo Alto, Californie 94303 Etats-Unis. Tous droits réservés. Ce produit ou document est protégé par un copyright et distribué avec des licences qui en restreignent l’utilisation, la copie, la distribution, et la décompilation. Aucune partie de ce produit ou document ne peut être reproduite sous aucune forme, par quelque moyen que ce soit, sans l’autorisation préalable et écrite de Sun et de ses bailleurs de licence, s’il y en a. Le logiciel détenu par des tiers, et qui comprend la technologie relative aux polices de caractères, est protégé par un copyright et licencié par des fournisseurs de Sun. Des parties de ce produit pourront être dérivées des systèmes Berkeley BSD licenciés par l’Université de Californie. UNIX est une marque déposée aux Etats-Unis et dans d’autres pays et licenciée exclusivement par X/Open Company, Ltd. La notice suivante est applicable à Netscape Communicator™: (c) Copyright 1995 Netscape Communications Corporation. Tous droits réservés. Sun, Sun Microsystems, le logo Sun, docs.sun.com, Sun Enterprise, et Solaris sont des marques de fabrique ou des marques déposées, ou marques de service, de Sun Microsystems, Inc. aux Etats-Unis et dans d’autres pays. Toutes les marques SPARC sont utilisées sous licence et sont des marques de fabrique ou des marques déposées de SPARC International, Inc. aux Etats-Unis et dans d’autres pays. Les produits portant les marques SPARC sont basés sur une architecture développée par Sun Microsystems, Inc. L’interface d’utilisation graphique OPEN LOOK et Sun™ a été développée par Sun Microsystems, Inc. pour ses utilisateurs et licenciés. Sun reconnaît les efforts de pionniers de Xerox pour la recherche et le développement du concept des interfaces d’utilisation visuelle ou graphique pour l’industrie de l’informatique. Sun détient une licence non exclusive de Xerox sur l’interface d’utilisation graphique Xerox, cette licence couvrant également les licenciés de Sun qui mettent en place l’interface d’utilisation graphique OPEN LOOK et qui en outre se conforment aux licences écrites de Sun. CETTE PUBLICATION EST FOURNIE "EN L’ETAT" ET AUCUNE GARANTIE, EXPRESSE OU IMPLICITE, N’EST ACCORDEE, Y COMPRIS DES GARANTIES CONCERNANT LA VALEUR MARCHANDE, L’APTITUDE DE LA PUBLICATION A REPONDRE A UNE UTILISATION PARTICULIERE, OU LE FAIT QU’ELLE NE SOIT PAS CONTREFAISANTE DE PRODUIT DE TIERS. CE DENI DE GARANTIE NE S’APPLIQUERAIT PAS, DANS LA MESURE OU IL SERAIT TENU JURIDIQUEMENT NUL ET NON AVENU. Please Recycle Contents Preface xi How This Book Is Organized xi Using UNIX Commands xii Typographic Conventions xiii UNIX Shell Prompts xiii Related Documentation xiv Ordering Sun Documentation xiv Accessing Sun Documentation Online xiv Sun Welcomes Your Comments xv 1. Release Notes 1 General Issues 1 Minimum Hardware Requirement 1 Supported Platforms 1 PCI I/O Board Limitation 2 Known Software Bugs 2 Bug ID 4373467 - prtdiag Command Does Not Show the ESI Board 2 2. Overview 3 Uses for the TCP/IP Interface Software 3 iii Uses for the Tape Emulation Software 4 Features of the Sun ESI 1.0 Software 4 Requirements for Using Sun ESI 1.0 Software 4 External Documentation 5 For Operating Channel and Devices 5 For Operating TCP/IP 5 3. Installing Sun ESI 1.0 Software 7 Gathering Configuration Information for TCP/IP Interface Software 7 Gathering Configuration Information for Tape Emulation Software 9 Sample Sun ESI Configuration Worksheets 10 Installing the Sun ESI 1.0 Software 11 4. Configuring and Testing TCP/IP Interface Software 15 Configuring the TCP/IP Interface Software 15 Determining Data Transfer Properties 15 Identifying Control Unit Addressing Parameters 16 Defining the Sun ESI Configuration File 17 Administering the Sun ESI 1.0 Software 17 Using the Sun ESI Administration Program 18 Initial Configuration and Testing of the TCP/IP Interface 18 Ensuring That Changes Take Effect in the Sun ESI Configuration File 20 Disabling or Restoring the Automatic Sun ESI Configuration 22 Configuring the TCP/IP Interface Software for Multiple Interfaces 22 Creating a Network Configuration Persistent Across System Boots 24 Removing a TCP/IP Network Interface 25 5. Configuring, Testing, and Using Tape Emulation Software 27 Configuring Tape Emulation Software 27 Identifying Control Unit Addressing Parameters 27 iv Sun Enterprise Systems Interface 1.0 Installation and User Guide • January 2001 Defining the Channel Configuration File 28 Administering the Sun ESI Software 29 Initial Configuration and Testing of Tape Emulation Devices 29 Transferring Files 30 Messages from the Mainframe 31 Mount Message 31 Verification Message 32 Dismount Command 32 System Error Message 32 A. Reference Section 35 Reference Manual (man) Pages 35 changet(1) 35 chanput(1) 35 chanadm(1M) 35 chan.conf(4) 36 chanip(7D) 36 chantape(7D) 36 esi(7D) 36 B. Troubleshooting 57 Using Diagnostics 57 Operating the Sun ESI Diagnostics 58 Indicating Errors 58 Obtaining Traces 59 C. Using Dynamic Reconfiguration (DR) With Sun ESI 1.0 Software 61 Suspending the Operating System and Sun ESI Boards 61 Removing a Sun ESI Board from the System 61 v Adding a Sun ESI Board to the System 63 D. Configuring Mainframe Information 67 Configuring Mainframe for TCP/IP Interface and Tape Emulation Using IOCP Macros 68 Defining IOCP Macros for Configuring the Mainframe 69 CHPID 69 CNTLUNIT 70 IODEVICE 71 Configuring Mainframe for TCP/IP Interface and Tape Emulation Using HCD 72 Mapping IOCP Macros to HCD 72 Defining Devices Using HCD 73 Configuring the TCP.PROFILE.TCPIP Data Set 89 Registering the Missing Interrupt Handler (MIH) 89 E. Configuring Multiple Images 91 F. Configuring Multiple Sun ESI Boards 93 G. Using JCL Scripts for Tape Emulation Software 95 vi Sun Enterprise Systems Interface 1.0 Installation and User Guide • January 2001 Tables TABLE 3-1 Summary of Configuration Information for the TCP/IP Interface 8 TABLE 3-2 Sample Sun and Mainframe Configuration Details Worksheet 10 TABLE 3-3 Sample IP Addresses Worksheet 10 vii viii Sun Enterprise Systems Interface 1.0 Installation and User Guide • January 2001 Figures FIGURE E-1 Illustration of a Multiple Image Configuration 92 FIGURE F-1 Example of IBM TCP/IP Data Set Addressing 94 ix x Sun Enterprise Systems Interface 1.0 Installation and User Guide • January 2001 Preface The Sun Enterprise Systems Interface 1.0 Installation and User Guide describes how to install, configure, and use the Sun Enterprise™ Systems Interface (ESI) software that supports the Sun Enterprise Systems Interface board. The manual includes Release Notes in Chapter <$elemparanumonly and Reference Manual pages in Appendix <$elemparanumonly<$elemtext. This document is intended for the user who installs, configures, and uses Enterprise Systems Interface 1.0 software to transfer files to a Sun server from a mainframe and from a mainframe to a Sun server. This user should have a working knowledge of UNIX® systems, particularly those based on the Solaris™ operating environment. The document is also of interest to the mainframe system programmer who is configuring the mainframe for use with the Sun server. This user should be an experienced mainframe professional with basic TCP/IP administration skills. How This Book Is Organized The Sun Enterprise Systems Interface 1.0 Installation and User Guide is organized as follows: Chapter <$elemparanumonly contains Release Notes. Chapter <$elemparanumonly is an overview of the Sun Enterprise Systems Interface 1.0 software.