* ** README *** ---------------------------------------------------------------* * * &PREFIX..README L=012 --- 2024/04/18 09:53:02 (NBJ) * * Licensed Materials - Property of Compute (Bridgend) Ltd * * Copyright (C) 2004-2010 - Compute (Bridgend) Ltd. * All rights reserved. * * History: * * L=012 2024/04/18 -nbj- IQ005508 - CBL Product Suite. * L=011 2023/03/16 -nbj- IQ005496 - FTP replaced with HTTP/HTTPS transfer. * L=010 2021/02/11 -nbj- CBL Product Suite 3.50 package CBL21042. * L=009 2017/07/14 -nbj- CBL Product Suite 3.40 package CBL17293. * L=008 2015/04/22 -nbj- Product package CBL15112. * L=007 2014/12/12 -nbj- Service package naming and update product package. * L=006 2013/01/31 -nbj- Remove statement re: service in the product package. * L=005 2012/03/15 -nbj- Reference selc310.html. * L=004 2011/09/22 -nbj- Include pax.Z in FTP alternatives. * L=003 2011/08/04 -jge- Minor mods for SMPE novices. * L=002 2011/03/18 -nbj- Include FTPJOB and CBLFTPZ reference. * L=001 2010/11/22 -nbj- Started for SMP/E Install of CBL Product Suite. * * -----------------------------------------------------------------------------* This document provides the initial steps for installing CBL Product Suite packages. ** Get the Product Package ** Transfer the CBL Product Suite package data to the package id HFS or zFS sub-directory under the SMPNTS directory of your host UNIX file system. (e.g. /u/smpe/smpnts/CBL24234/ ) This is achieved via one of the following methods: 1. ** Transfer directly to the z/OS host with SHA-1 checks & SMP/E RECEIVE ** Use this method to transfer the product material via HTTPS to the z/OS host and optionally do the following: a) Validate file data after transfer. (SHA-1 hash checking) b) SMP/E RECEIVE package data to an existing CSI. | Copy or Paste the supplied RFNJOBHS job to your host system, modify and execute it to perform an SMP/E RECEIVE FROMNETWORK with or without the TRANSFERONLY operand. (TRANSFERONLY will perform the file transfer but bypass RECEIVE processing.) SMP/E RECEIVE requires that an existing SMP/E global CSI is identified via the SMPCSI DD statement. If TRANSFERONLY is used no RECEIVE processing is actioned and so the CSI is unchanged. RECEIVE FROMNETWORK performs a SHA-1 hash check following the transfer to ensure data integrity. This requires one of the following: i) ICSF Cryptographic Services activated on the host system. ii) SMP/E 3.4 level (34.09) or later *and* JAVA Run Time 1.4.3 or later. | Note: | Java 8.0 SR5 FP15 is the minimum service level required for SSL/TLS | communication with the HTTPS server using the standard Java truststore. | The Java truststore supplied with this level of service contains the | "LetsEncrypt ISRG Root X1" root certificate required for successful SSL | handshake withe the HTTPS server. Without this certificate, use of the | Java truststore in this job will return the following: | | javax.net.ssl.SSLException: java.net.SocketException: Connection reset | | If your Java service level does not include this root certificate, use | the RFNJOBH job instead. RFNJOBH will transfer the product data via HTTP | as opposed to HTTPS. 2. ** Transfer the package .pax.Z archive to your workstation ** Use this method if your firewalls do not allow file transfer from an external HTTP/HTTPS server to the z/OS host, but you are able to do the following: a) Transfer data from a Windows/Mac/Linux workstation to the z/OS host. b) Execute z/OS UNIX shell command, pax. Download the product package .pax.Z archive from the CBL products download page of the CBL web site, then upload it to an HFS directory of the z/OS host (using an FTP client or 3270 emulator file transfer facility.) Execute the z/OS UNIX shell command, pax, to extract package files to a smpnts subdirectory. e.g. pax -rvzf /u/smpe/smpnts/CBL24234.pax.Z -s##/u/smpe/smpnts/CBL24234# where: "/u/smpe/smpnts/CBL24234.pax.Z" is the pax.Z fileid. "/u/smpe/smpnts/CBL24234" is the destination sub-directory. 3. ** Transfer the package .ZIP archive to your Windows workstation ** Use this method if your firewalls do not allow file transfer from an external HTTP/HTTPS server to the z/OS host, but you are able to transfer data from your Windows workstation to the z/OS host. Download and explicitly unzip (extract) the product package .zip archive to a new folder on your Windows workstation. The .zip archive is available via the CBL products downloads page of the CBL web site. Upload the product package files to a z/OS host directory, ensuring that the directory structure is preserved. To do this, you can execute (double-click) the CBLFTPZ.CMD Windows command script icon from the new extracted package folder. Note: You *must* extract all files from the archive and execute CBLFTPZ from the extracted folder. i.e. Do not attempt to execute CBLFTPZ from a Windows temporary folder. A Windows temporary folder is created when... 1. The .zip archive is opened directly from the web link. 2. The contents of the .zip archive are displayed in a Windows Explorer view without first selecting "Extract all Files". CBLFTPZ will prompt the user for input parameters before invoking the Microsoft Windows CURL command line utility to transfer the data from the HTTP/HTTPS server, and then the Microsoft FTP client utility to perform file transfer to the z/OS host. Alternatively, use your preferred FTP client software or 3270 emulator file transfer facility to upload the files individually. Notes: 1. The CBL Product Suite package id is in the format CBLyyddd where yy is the year and ddd the Julian day that the package was released. 2. To avoid space issues on your z/OS host UNIX system, it is recommended that a new HFS or zFS file system be allocated and mounted at the CBLyyddd package directory path. In general, the size of the file system should be 3 times the size of the compressed package size. 3. If you wish to install into a new SMP/E environment and you use RFNJOBHS to transfer the product package directly to the z/OS host, you should uncomment the TRANSFERONLY parameter before running the job. Following file transfer, review installation steps in the Program Directory (found in the non-SMP/E package material) for defining a new SMP/E environment and performing RECEIVE FROMNTS. ** Extract Non-SMP/E Material ** Following transfer, non-SMP/E installable material contained in the CBL Product Suite package exists in RIMLIB and PGMDIR libraries which are initially in pax compressed format (pax.Z). RIMLIB contains Related Installation Materials for the CBL Product Suite package, PGMDIR contains the CBL Product Suite Program Directory. This material should be extracted to libraries in your z/OS environment using the sample SMP/E GIMUNZIP job provided as part of the package. To do this, copy or cut/paste contents of HFS member "Snnnn.CBL.PROD.CBLyyddd.GIMUNZIP" to a z/OS JCL library member GIMUNZIP, modify it as described in the comment data, then submit to batch. As a result, z/OS libraries hlq.RIMLIB and hlq.PGMDIR should now exist. Note: 1. The CBL Product Suite Program Directory is also available as an Adobe PDF document on the CBL web site. ** Download Product Publications ** The CBL Product Suite Program Directory and other related documentation describing installation, customisation and execution of the software, may be downloaded in Adobe PDF format from the CBL web site: https://www.cbl.com/documentation.php ** Copy Sample Installation Jobs ** Sample install jobs referenced by the Program Directory (hlq.PGMDIR(CBLPRODS)) are supplied in the CBL Product Suite package. During the install procedure, these jobs may be modified to suit your system standards and executed to perform relevant installation tasks. If RFNJOBHS was executed without TRANSFERONLY, then RECEIVE processing has occurred and the sample jobs are available in SMPTLIB libraries. In this case, use the COPYJCL job in the hlq.RIMLIB library to copy the relevant install jobs to your JCL work library. Alternatively, if RECEIVE processing has not occurred (RFNJOBHS not used or TRANSFERONLY operand specified), then use UZIPJCL job in the hlq.RIMLIB lib to extract all sample members from the appropriate, compressed RELFILEs. UZIPJCL uses the SMP/E GIMUNZIP service to perform SHA-1 hash checking and unzip the libraries to the specified JCL work library. hlq.RIMLIB also contains install job ZZSIRUNZ which extracts the SMP/E material to PDS libraries before performing an SMP/E RECEIVE. This offers an alternative to performing an SMP/E RECEIVE FROMNTS which receives package SYSMODs directly from the smpnts HFS directory. See "4.4.5 SMP/E RECEIVE CBL Product Suite Components" in the PGMDIR file hlq.PGMDIR(CBLPRODS). ** Program Directory ** Continue the installation procedure as documented in the CBL Product Suite Program Directory - hlq.PGMDIR(CBLPRODS). To complete installation, you must also perform configuration tasks as described in the CBL Product Suite Customisation Guide. See https://www.cbl.com/pdf/CBL_Product_Suite_Customisation_Guide.pdf ** Service Information ** PTF and APAR Fixes (Zaps) are made available as service packages identified as Xyyyyddd (PTFs) and Syyyyddd (APAR Fixes) where yyyyddd is the Julian date stamp of the service package. "S" bundles containing APAR fixes are ultimately superseded and replaced by "X" bundles containing one or more PTF module replacements. Service packages are cumulative with all previous packages being pre-requisite to the most recent. Therefore, all previously available PTFs must be applied before applying the latest service package. HOLDDATA is also included and contains any applicable ERROR holds against CBL Product Suite component FMIDs and PTFs. See the following CBL web page for all available service to CBL Product Suite: https://www.cbl.com/s360maint.php --- End of README ---