* ** README.SERVICE *** -------------------------------------------------------*
*
* &PREFIX..README             L=006 --- 2013/06/24 15:45:59 (NBJ)
*
*  Licensed Materials - Property of Compute (Bridgend) Ltd
*
*  Copyright (C) 2004-2010 - Compute (Bridgend) Ltd.
*  All rights reserved.
*
*  History:
*
*    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 a workstation running an FTP server
  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 FTP 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 FTP 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 a workstation if the workstation is
      running an FTP server. (See 3.1)

   2. 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)

   3. 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/S0000001/ )

  This is achieved by copying the SVCRFN 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, use the supplied FTPJOB to perform the transfer only.
| See Note 2. below.

  Notes:

|  1. 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.

   2. If you are unable to execute RECEIVE FROMNETWORK, use FTP client on z/OS
      to transfer the service package files directly to your HFS sub-directory
      of the SMPNTS directory.
|     You may use the supplied batch job, FTPJOB, to do this.

   3. If TRANSFERONLY was specified in SVCRFN or the service directory FTP'd
      directly, 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 or FTP client.
  (Logon to the CBL FTP server as "anonymous" with null password. Service is
   found in directory /mvs/smpe/smpnts/)

  When using this method, ensure that all file 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 by FTP 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/X0000009.pax.Z   -s##/u/smpe/smpnts/X0000009#
|
| where:
|   "/u/smpe/smpnts/X0000009.pax.Z" is the pax.Z fileid.
|   "/u/smpe/smpnts/X0000009" is the destination sub-directory.




3.0  ** Receive Service SYSMODs ***

  If job SVCRFN 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 a workstation running an FTP server **

  If the workstation is running an FTP server, then, provided all service
  files were downloaded to the workstation without translation and the
  directory structure preserved, the SVCRFN job may be tailored and executed to
  receive the SYSMODs.

  The SVCRFN job must reference the workstation ftp host on the SERVER host
  parameter and TRANSFERONLY deactivated. The package hash value should be
  unchanged and as supplied in the SVCRFN job for this service package.


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 ---