* ** README.SERVICE *** -------------------------------------------------------*
*
* &PREFIX..README             L=007 --- 2023/03/16 15:00:56 (NBJ)
*
*  Licensed Materials - Property of Compute (Bridgend) Ltd
*
*  Copyright (C) 2004-2010 - Compute (Bridgend) Ltd.
*  All rights reserved.
*
*  History:
*
*    L=007 2023/03/16 -nbj- IQ005496 - FTP replaced with HTTP/HTTPS transfer.
*    L=006 2013/06/24 -nbj- /Mainframe directory removed from ftp link.
*    L=005 2011/09/23 -nbj- Add section 2.4 for pax.Z. archive
*    L=004 2011/03/24 -nbj- Correct typo and document .zip/cblftpz.cmd/FTPJOB.
*    L=003 2011/01/13 -nbj- ??
*    L=002 2011/01/12 -nbj- APPLY and ACCEPT jobs, SVCAPPLY and SVCACPT.
*    L=001 2011/01/07 -nbj- Apply SMP/E Service to SELCOPY Product Suite.
*
* -----------------------------------------------------------------------------*


** Contents **

1.0  Overview

2.0  Transfer
  2.1  Transfer the Service Package directly to the z/OS host
  2.2  Transfer the Service Package files to a workstation
  2.3  Download the Service Package .Zip Archive
  2.4  Download the Service Package .pax.Z Archive

3.0  Receive Service SYSMODs
| 3.1  Receive Service from the CBL web server via HTTPS or HTTP.
  3.2  Receive Service from a local/workstation directory under SMPNTS
  3.3  Receive Service from a local/workstation directory not under SMPNTS

4.0  Apply Service SYSMODs

5.0  Accept Service SYSMODs






1.0  ** Overview **

 This document provides download and install options for applying SMP/E managed
 service to SELCOPY Product Suite.

 Download options are as follow:

   1. Transfer service from the CBL web server to your z/OS host HFS (or ZFS)
      SMPNTS directory without receiving it in the product CSI. (See 2.1)

   2. Transfer service from the CBL web server as in option 1. but receive it
      directly into the product CSI. (See 2.1)

   3. Transfer the individual service package files to a workstation. (See 2.2)

   4. Download the service .Zip archive to a Windows workstation. (See 2.3)

   5. Download the service .pax.Z archive to any workstation. (See 2.4)


 Install options are as follow:

   1. Receive service directly from the CBL web server. (See 2.1)

   2. Receive service directly from a workstation if the workstation is
      running an FTP server. (See 3.1)

   3. Receive service from your z/OS host HFS (or ZFS) SMPNTS directory or
      from your workstation directory which has been mounted on your z/OS host
      (e.g. via NFS.) (See 3.2)

   4. Unzip the service package from your z/OS host HFS (or ZFS) SMPNTS
      directory or from your NFS (or equivalent) mounted workstation directory,
      then recieve service from the resultant sequential data sets. (See 3.3)





2.0  ** Transfer ***

2.1  ** Transfer the Service Package directly to the z/OS host **

  Transfer the SELCOPY Product Suite service package data to the package id
  HFS or zFS sub-directory under your z/OS host's SMPNTS directory and
  optionally RECEIVE the SYSMODs. (e.g. /u/smpe/smpnts/X2022010/ )

| This is achieved by copying the SVCRFNHS (https) job to your host system.
  Modify the job as described in the comment data 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.

  If firewall or other security restrictions preclude use of RECEIVE
  FROMNETWORK, then use one of the other transfer methods detailed below.

  Notes:

|  1. 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. SVCRFNH will transfer the product data via HTTP
|     as opposed to HTTPS.

   2. The SELCOPY Product Suite service package id is in the format Snnnnnnn
      (for APAR fixes) or Xnnnnnnn (for PTFs - MOD replacements, etc.) "X"
      and prefixed service packages supersede "S" prefixed packages.

   3. If TRANSFERONLY was specified, then execute job SVCRNTS (see 3.2) or
      SVCRUNZ (see 3.3) to RECEIVE service and perform data integrity checking.


2.2  ** Transfer the Service Package Files to a workstation **

  Transfer the data to a workstation using an internet browser.

  When using this method, ensure that all files are transferred without
  translation and that the directory structure is preserved.
  Directory and file names are case sensitive.

  If the workstation is not used as an FTP or NFS Server, then execute
  the CBLFTPZ Windows command script to transfer service package files to
  the z/OS host. Note that you will be prompted for the z/OS host name/IP
  address, TSO login userid/password, Windows source folder, HFS target sub-
  directory and the package id.

  Alternatively, use your preferred FTP client software or 3270 emulator
  file transfer facility to upload the service files individually.
  Note that subdirectory structure must be maintained.

  Notes:

   1. No data integrity checking is performed so SHA-1 hash checking in
      subsequent RECEIVE or GIMUNZIP jobs should be actioned to verify integrity
      of the transferred data.  See jobs SVCRNTS and SVCRUNZ for details.

   2. If service is transferred to a workstation directory that is mounted or
      mapped to a directory in your z/OS host HFS (e.g. via NFS), then SYSMODs
      may be received as though the directory was local to the z/OS host system.


2.3  ** Download the Service Package .Zip Archive **

  Each service package is also available via a single downloadable .zip archive.
  This may be downloaded and unzipped on a workstation before uploading the
  components to the z/OS host HFS directory as described in section 2.2 above.


2.4  ** Download the Service Package .pax.Z Archive **

  Each service package is also available via a single downloadable .pax.Z
  archive which may be transferred (if necessary via a Windows/Mac/Linux
  workstation) to a z/OS host HFS subdirectory before it is expanded.

  Execute the z/OS UNIX shell command, pax, to extract package files to
  a smpnts HFS subdirectory. e.g.

   pax -rvzf /u/smpe/smpnts/X2022010.pax.Z   -s##/u/smpe/smpnts/X2022010#

  where:
    "/u/smpe/smpnts/X2022010.pax.Z" is the pax.Z fileid.
    "/u/smpe/smpnts/X2022010"       is the destination sub-directory.




3.0  ** Receive Service SYSMODs ***

  If job SVCRFNHS was successfully executed (RC=0) without the TRANSFERONLY
  option, then the SYSMODs are already received into the global zone of the
  nominated CSI.


3.1  ** Receive Service from the CBL web server via HTTPS or HTTP.

| See 2.1 to transfer the service package directly to the z/OS host using
| sample job SVCRFNHS. If TRANSFERONLY is *not* specified, then the service
| will be received directly to the SMP/E global CSI identified by the SMPCSI
| DD name.


3.2  ** Receive Service from a local/workstation directory under SMPNTS **

  Receive SYSMODs directly using job SVCRNTS which executes a RECEIVE FROMNTS
  command.  SVCRNTS may be executed where either of the following are true:

   1. The service directory has been transferred to a sub-directory of the z/OS
      host's SMPNTS HFS directory (directly from the CBL FTP site or via a
      workstation.)

   2. The service directory is mapped to or mounted as a sub-directory of the
      host SMPNTS HFS directory. (e.g. via DFS SMB or NFS.)

  SVCRNTS should be tailored so that data integrity checking is performed
  during RECEIVE processing. See comment data with in the job text.

  Alternatively, run SVCRUNZ to unzip then receive service SYSMODs from
  sequential data set. (See 3.3)


3.3  ** Receive Service from a local/workstation directory not under SMPNTS **

  Where service files are not in a sub-directory under you host's SMPNTS
  directory, then you must tailor and execute job SVCRUNZ.

  This job will execute SMP/E utility GIMUNZIP to unzip the service directory
  files to a sequential data set which is used as input to the  RECEIVE command.

  Service files may be accessed as specified in section 3.2.

  SVCRUNZ should be tailored so that data integrity checking is performed by
  GIMUNZIP. See comment data with in the job text.





4.0  ** Apply Service SYSMODs ***

  Job SVCAPPLY is supplied as a template for applying all recieved APAR and PTF
  SYSMODS to target libraries.





5.0  ** Accept Service SYSMODs ***

  Job SVCACPT is supplied as a template for accepting all applied APAR and PTF
  SYSMODS to distribution libraries.







                       --- End of README.SERVICE ---