A +-------------------------------------------------------------+ | Readme file for PERL V5.8A | | Edition: April 2008 | +-------------------------------------------------------------+ Contents 1 Overview . . . . . . . . . . . . . . . . . . . . . . . . 2 2 Installation . . . . . . . . . . . . . . . . . . . . . . 3 2.1 Course of preinstallation scripts . . . . . . . . . 3 2.2 Course of postinstallation script . . . . . . . . . 3 2.3 Listing of the most important files and directories used by Perl . . . . . . . . . . . . . . . . . . . 4 3 Deinstallation . . . . . . . . . . . . . . . . . . . . . 6 4 Usage instructions . . . . . . . . . . . . . . . . . . . 7 4.1 locale settings . . . . . . . . . . . . . . . . . . 7 4.2 Incompatibilities on SX machines . . . . . . . . . 7 5 License arrangements . . . . . . . . . . . . . . . . . . 8 6 Literature . . . . . . . . . . . . . . . . . . . . . . . 9 6.1 Additional literature . . . . . . . . . . . . . . . 9 - 1 - A 1 Overview -------- This README file describes the BS2000 specific supplements and differences to the online documentation and to the generally available literature named in the literature chapter. Perl ("Practical Extraction and Report Language") is an inter- preted script language known from the unix environment, which has been developed by Larry Wall and is maintained by the Perl5 Por- ters Group. Perl syntax borrows from C, C++ and miscellaneous shell script languages. PERL (BS2000/OSD) V5.8A is based on Perl's developer version 5.8.8. Additionally to the basic Perl some CPAN modules have been por- ted, in detail: Term::ReadKey, Spiffy, Convert::EBCDIC, Di- gest::MD5, Digest::SHA1, Pod::Escapes, Pod::Simple, Pod::POM, Test::Base, Test::Pod, File::Temp, WWW::Curl, HTML::Tagset, HTML::Parser, DBI, DBD::Oracle, libnet, URI, libwww::perl, Apa- che::DBI, Business::ISBN::Data, Business::ISBN, DB_File, Imager and GD. The Perl interpreter can be used for CGI scripts in connection with the Apache webserver (via mod_perl), but it is also usable as a standalone interpreter. - 2 - A 2 Installation ------------ This chapter describes the installation of PERL (BS2000/OSD) V5.8A. For PERL V5.8A BS2000 version V6.0 or newer and POSIX-BC with the correction level A39 or newer is needed. Also required is BLSSERV V2.6 or newer. For the usage of the CPAN module DBD::Oracle Oracle 10g oder higher is required. Perl is installed like a POSIX program package with the POSIX in- stallation programm (see manual "POSIX Basics for Users and Sys- tem Administrators"), whereas an already installed, e.g. older Perl version must be deinstalled beforehand. For installation and operating of Perl the PLAM library SINLIB.PERL.058 for /390 and SPULIB.PERL.058 for SPARC must be available and readable by all users. The POSIX subsystem must be started. Furthermore the APACHE base package, which contains the shared objects used by some CPAN modules (C library, graphics libraries etc.) must be installed under /opt/apache22/lib (this does not mean, that the Apache webserver itself has to be installed). Because also privileged actions have to be performed, the instal- lation is done under the TSOS account with the POSIX installation command: /START-POSIX-INSTALLATION In doing so for the installation of Perl following selections have to be made and specifications have to be given: Function: Install packages on POSIX and then on the next screen: IMON support ? : Y name of product : PERL package of product : version of product : 058 ... The installation path showed in the course can be changed, but it is recommended to use the default /opt/perl. In the following this default is assumed at the naming of files. 2.1 Course of preinstallation scripts At first several scripts check, whether required products are in- stalled actually, whether perhaps a Perl installation is al- ready/still present and whether the /opt file system has enough free space. When one of this checks fails, the installation is cancelled, otherwise the installation program copies all files from the PLAM library into the POSIX file system or creates links to PLAM library elements alternatively. 2.2 Course of postinstallation script After all files are copied, the postinstallation script, which handles the host-specific set-up of Perl, is started automati- cally. Two symbolic links, /usr/bin/perl and /opt/bin/perl, are created, which both point to /opt/perl/bin/perl. When Perl is not in- stalled under the default path /opt/perl, then a symbolic link is created, which refers from /opt/perl to this non-standard path. This is necessary, because the standard path is "burned" into Perl and Perl otherwise would not find Perl packages to be load- ed. - 3 - A Finally it will be tried to create a /etc/resolv.conf file, if there is not already one, for ensuring a working DNS name resolu- tion. For this the files $.SYSDAT.LWRESD.*.RESOLV.CONF and $.SYSDAT.SOCKETS.*.SOC6.RESOLV are analyzed, whether they contain a valid nameserver line. If yes, then the first file with such a line found is copied to /etc/resolv.conf. A warning notice men- tioning a missing /etc/resolv.conf file can be ignored, when you are sure, that you don't need DNS name resolution with your Perl utilization. 2.3 Listing of the most important files and directories used by Perl +-------------------------+-----------+-----------------------+ | Name | Type | Explanation | +-------------------------+-----------+-----------------------+ | /opt/perl | Directory | Standard Perl | | | | installation | | | | directory | +-------------------------+-----------+-----------------------+ | /opt/perl/bin | Directory | Executable | | | | programs and general | | | | Perl scripts | +-------------------------+-----------+-----------------------+ | /opt/perl/bin/perl | Program | Perl interpreter | +-------------------------+-----------+-----------------------+ | /opt/perl/bin/perl5.8.8 | Program | Perl interpreter | +-------------------------+-----------+-----------------------+ | /opt/perl/lib | Directory | Perl packages | +-------------------------+-----------+-----------------------+ | /opt/perl/lib/5.8.8 | Directory | Basic Perl packages | +-------------------------+-----------+-----------------------+ | /opt/perl/lib/5.8.8/ | Link | Refers to the | | BS2000-posix-bc | | appropriate | | | | architecture-specific | | | | directory | +-------------------------+-----------+-----------------------+ | /opt/perl/lib/5.8.8/ | Directory | /390-specific | | BS2000-posix-bc-390 | | parts of basic | | | | Perl packages | +-------------------------+-----------+-----------------------+ | /opt/perl/lib/5.8.8/ | Directory | SPARC-specific | | BS2000-posix-bc-sparc | | parts of basic | | | | Perl packages | +-------------------------+-----------+-----------------------+ | /opt/perl/lib/ | Directory | Additional Perl | | site_perl | | packages (e.g. CPAN) | +-------------------------+-----------+-----------------------+ | /opt/perl/lib/ | Directory | Additional Perl | | site_perl/5.8.8 | | packages (e.g. CPAN), | | | | built with Perl 5.8.8 | +-------------------------+-----------+-----------------------+ | /opt/perl/lib/ | Link | Refers to the | | site_perl/5.8.8/ | | appropriate | | BS2000-posix-bc | | architecture-specific | | | | directory | +-------------------------+-----------+-----------------------+ | /opt/perl/lib/ | Directory | /390-specific | | site_perl/5.8.8/ | | parts of CPAN | | BS2000-posix-bc-390 | | Perl packages | +-------------------------+-----------+-----------------------+ - 4 - A +-------------------------+-----------+-----------------------+ | /opt/perl/lib/ | Directory | SPARC-specific | | site_perl/5.8.8/ | | parts of CPAN | | BS2000-posix-bc-sparc | | Perl packages | +-------------------------+-----------+-----------------------+ | /opt/perl/man | Directory | Link to | | | | /opt/perl/share/man | +-------------------------+-----------+-----------------------+ | /opt/perl/share/man | Directory | Documentation in | | | | form of man pages | +-------------------------+-----------+-----------------------+ | /opt/perl/readme | Directory | Readme files | +-------------------------+-----------+-----------------------+ | /opt/perl/readme/html | Directory | Documentation in | | | | form of | | | | HTML files | +-------------------------+-----------+-----------------------+ | /etc/default/PERL | Script | Configuration | | | | options | +-------------------------+-----------+-----------------------+ | /etc/default/ | Script | Template file for | | PERL_default_tmpl | | /etc/default/PERL | +-------------------------+-----------+-----------------------+ - 5 - A 3 Deinstallation -------------- The deinstallation is carried out under the TSOS account too with the POSIX installation command: /START-POSIX-INSTALLATION Doing so select the function "Delete packages from POSIX". In the list showing up for deinstallation mark the line with Prod- uct=PERL and Version=058 and follow the further instructions of the tool. The symbolic links created during the postinstallation are removed too. - 6 - A 4 Usage instructions ------------------ 4.1 locale settings Perl scripts don't work with many national 7 bit character sets, because in such character sets Perl syntax elements as e.g. curly brackets aren't available. E.g. one such national 7 bit character set is activated implicitly with the locale setting ,LANG=De', therefore a locale environment with an 8 bit character set (or a suitable 7 bit character set) has to be established. 4.2 Incompatibilities on SX machines On SX machines problems can occur at the loading of certain sha- red objects (.so-libraries), when the TU subsystem CRTEC is star- ted. Especially affected is the CPAN module Imager (i.e. the shared object Imager.so). One circumvention of the problem is the unloading of the CRTEC subsystem. An alternative solution is the application of the optional correction A0566079-001. - 7 - A 5 License arrangements -------------------- For the utilization of Perl two different licenses are available, either the GNU GPL or the so-called Artistic License. For par- ticulars please read the files /opt/perl/readme/README, /opt/perl/readme/Artistic and /opt/perl/readme/Copying. - 8 - A 6 Literature ---------- POSIX (BS2000/OSD) Basics for Users and System Administrators User Guide Target group BS2000 system administrators, POSIX administrators, BS2000 users, users of UNIX workstations Contents - Introduction to and working with POSIX - BS2000 software products in a POSIX environment - Installing POSIX - Controlling POSIX and administering file systems - Administering POSIX users - BS2000 commands for POSIX 6.1 Additional literature Under http://books.perl.org/ one finds a very comprehensive over- view over Perl literature, therefore here only the "Camel Book" is mentioned: Programming Perl, 3rd Edition from Larry Wall, Tom Christiansen and Jon Orwant ISBN 0-596-00027-8 (Original edition) ISBN 3-89721-144-0 (German translation) Contents Comprehensive Perl description (based on Perl 5.6) In addition have a look at the Perl websites http://www.perl.org/ and http://www.perl.com/. - 9 -