PYVMS - Python on OpenVMS -getting started guide PAGE 1 title page __ | \ | | _ |__/ | | - / \ -O- | \ / \_/ \_/ | | _ | | /\/\ / \ | | / || \ \_ \ / | | \ \/ | | \_/ Copyright, 1996 - 1999 by Uwe Zessin ------------------------------------------------------------------------ PYVMS - getting started guide March 1999 This manual contains documentation about 'Python on OpenVMS'. Revision/Update Information: This is version 8. Software Version: PYVMS V1.5.1-V008 Uwe Zessin, Germany ------------------------------------------------------------------------ 27-MAR-1999 ZE. PYVMS - Python on OpenVMS -getting started guide PAGE 2 Python copyright 0.1 The original Python Copyright (copied from MISC/COPYRIGHT.) Copyright 1991-1995 by Stichting Mathematisch Centrum, Amsterdam, The Netherlands. All Rights Reserved Permission to use, copy, modify, and distribute this software and its documentation for any purpose and without fee is hereby granted, provided that the above copyright notice appear in all copies and that both that copyright notice and this permission notice appear in supporting documentation, and that the names of Stichting Mathematisch Centrum or CWI or Corporation for National Research Initiatives or CNRI not be used in advertising or publicity pertaining to distribution of the software without specific, written prior permission. While CWI is the initial source for this software, a modified version is made available by the Corporation for National Research Initiatives (CNRI) at the Internet address ftp://ftp.python.org. STICHTING MATHEMATISCH CENTRUM AND CNRI DISCLAIM ALL WARRANTIES WITH REGARD TO THIS SOFTWARE, INCLUDING ALL IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS, IN NO EVENT SHALL STICHTING MATHEMATISCH CENTRUM OR CNRI BE LIABLE FOR ANY SPECIAL, INDIRECT OR CONSEQUENTIAL DAMAGES OR ANY DAMAGES WHATSOEVER RESULTING FROM LOSS OF USE, DATA OR PROFITS, WHETHER IN AN ACTION OF CONTRACT, NEGLIGENCE OR OTHER TORTIOUS ACTION, ARISING OUT OF OR IN CONNECTION WITH THE USE OR PERFORMANCE OF THIS SOFTWARE. ------------------------------------------------------------------------ 18-MAY-1998 ZE. PYVMS - Python on OpenVMS -getting started guide PAGE 3 PYVMS copyright 0.2 The PYVMS Copyright Copyright 1996-1999, by Uwe Zessin This software is provided to you free of charge. Use at your own risk - if it doesn't work, I disclaim all responsibility. This software may be freely distributed as long as it is accompanied by the copyright notice. If you change this software, you may re-distribute it only if you keep the original notes AND an additional notice identifying you and indicating that you have changed it. ------------------------------------------------------------------------ I have found this wording somewhere on the Internet and liked it. Unfortunately I haven't noted the author's name so I cannot give credit. ------------------------------------------------------------------------ 14-FEB-1999 ZE. PYVMS - Python on OpenVMS -getting started guide PAGE 4 table of contents CONTENTS 0.1 The original Python Copyright . . . . . . . . . . 2 0.2 The PYVMS Copyright . . . . . . . . . . . . . . . 3 CHAPTER 1 Introduction 1.1 Welcome . . . . . . . . . . . . . . . . . . . . . 1-1 CHAPTER 2 FILES FROM THE PYTHON DISTRIBUTION 2.1 the Python core files . . . . . . . . . . . . . . 2-1 2.2 the Python documentation . . . . . . . . . . . . . 2-1 CHAPTER 3 FILES FROM THE PYVMS DISTRIBUTION 3.1 the PYVMS source kit . . . . . . . . . . . . . . . 3-1 3.2 the PYVMS documentation . . . . . . . . . . . . . 3-1 3.3 precompiled object code . . . . . . . . . . . . . 3-3 3.4 tools to build Python on OpenVMS . . . . . . . . . 3-3 INDEX INDEX-1 CHAPTER 1 Introduction __ | \ | | _ |__/ | | - / \ -O- | \ / \_/ \_/ | | _ | | /\/\ / \ | | / || \ \_ \ / | | \ \/ | | \_/ 1.1 Welcome Welcome to PYVMS - the Python programming language running on the OpenVMS operating system. This is the 'Getting Started Guide'. This guide tells you what you need to get Python running on OpenVMS. Please read the entire guide and, perhaps the 'building' section in the 'General Manual', too before you start. Descriptions of modules with their interface routines, defined symbols and VMS objects are in the 'REFerence MANual'. ------------------------------------------------------------------------ 26-FEB-1999 ZE. CHAPTER 2 FILES FROM THE PYTHON DISTRIBUTION 2.1 the Python core files You always need to download the file 'pyth151.tgz' (4389 blocks) from: - http://www.python.org/ftp/python/src/pyth151.tgz or - ftp://ftp.python.org/ftp/python/src/pyth151.tgz Mirror sites are available - please start from http://www.python.org/ to find out where they are. 'pyth151.tgz' contains the complete source of the core interpreter and the Python library. Even if you download precompiled object code (described later) for OpenVMS, you still need the library files from this file! I will not make an edited Python distribution available !! ------------------------------------------------------------------------ 2.2 the Python documentation The Python documentation has been de-coupled from the interpreter distribution some time ago. Start at: - http://www.python/org/doc/ or PYVMS - Python on OpenVMS -getting started guide PAGE 2-2 files from the Python distribution - ftp://ftp.python.org/pub/python/doc/151p1/ (This is the most recent documentation for Python V1.5.1 I am aware of) Note that the PYVMS documentation only describes OpenVMS specifics. You should download the Python documentation, too. ------------------------------------------------------------------------ 14-FEB-1999 ZE. CHAPTER 3 FILES FROM THE PYVMS DISTRIBUTION 3.1 the PYVMS source kit You always need to download the PYVMS 'source kit'. It is currently available from: - http://www.decus.de/~zessin/pyvms1_5_1-v008src.zip about 2000 blocks There are currently no mirror sites available. I welcome offers, but request that we keep in touch for updates. You need this file, even if you intend not to build the Python interpreter yourself, but download the pre-compiled object modules! ------------------------------------------------------------------------ 3.2 the PYVMS documentation The documentation is available in different forms: HTML documentation The '.HTML' files are distributed within the 'source kit'. You can put these files on a web server or directly read them with a browser. See the 'GENeral MANual' for more details. Keep the [.VMS.DOC] tree intact, because there are hyperlinks between the 'manuals'. simple text format This is a file that has been run through a text formatter without any information about bold printing. You can send this file to a printer that doesn't understand that or read it directly with a text editor. All three manuals are separately available: PYVMS - Python on OpenVMS -getting started guide PAGE 3-2 files from the PYVMS distribution * the 'getting started guide' - http://www.decus.de/~zessin/docu/startgde/pyvmsstartgde.txt about 30 blocks * the 'general manual' - http://www.decus.de/~zessin/docu/genman/pyvmsgenman.txt about 30 blocks * the 'reference manual' - http://www.decus.de/~zessin/docu/refman/pyvmsrefman.txt about 1020 blocks printer format There are files that have been run through the RUNOFF text formatter that contain information for bold printing. Two variants are available: * a '.MEM' file for output on line printers This file can be converted to the 'simple text format' mentioned above. However you do need access to an OpenVMS system to do that. * a '.LNI' file for output on printers understanding ANSI sequences All 3 manuals are stored in an OpenVMS text library. The library contains a file (README_TLB.TXT) with detailed instructions how to extract the manuals from the library, how to re-apply the correct record attributes to the '.MEM' and '.TXT' files and how to convert a '.MEM' file to a '.TXT' file to get the 'simple text format' mentioned above. Start at: * http://www.decus.de/~zessin/kits/pyvms1_5_1-v008doc.tlb about 1590 blocks After the download to an OpenVMS system do a: $ LIBRARY /EXTRACT= README_TLB.TXT - /OUTPUT= README_TLB.TXT - PYVMS1_5_1-V008DOC.TLB Note that the PYVMS documentation only describes OpenVMS specifics. You should download the Python documentation, too. ------------------------------------------------------------------------ PYVMS - Python on OpenVMS -getting started guide PAGE 3-3 files from the PYVMS distribution 3.3 precompiled object code For very specific configurations I MIGHT make precompiled object code available. They may NOT work on your configuration! I'm sorry, but that is the best you can expect from a 'hobby project'. Start at http://www.decus.de/~zessin/py_obj.html to see if and what versions are available. I appreciate feedback and offers for other versions. ------------------------------------------------------------------------ 3.4 tools to build Python on OpenVMS You need some tools that, unfortunately, are not build into the OpenVMS operating system. These are: - GZIP (de)compress a single file. - UNZIP Decompressing single or multiple files from a '.ZIP' archive. - VMSTAR (or another version of TAR) TAR (Tape ARchive) is used to store multiple files (with their directory path) in a single file (the archive) and later retrieve them. Explaining these tools in more detail is beyond the scope of this guide, sorry. You should be able to get along with them if you follow the instructions in the 'building' section of the 'General Manual'. I have made available executable files of the tools that I use. They can be downloaded from: http://www.decus.de/~zessin/py_tools.html Of course, there is NO guarantee that they work for you. The 'General Manual' of the PYVMS documentation has pointers where more up-to date versions (perhaps including source) can be found. ------------------------------------------------------------------------ 27-MAR-1999 ZE. Index PAGE INDEX-1 INDEX files README_TLB.TXT, 3-2 pyth151.tgz, 2-1