//GIMUNZIP JOB (job card information) //********************************************************************* //* * //* Communications Server X11R4 XWindows * //* * //* This sample JCL job can be used to process the download package * //* for Communications Server X11R4 XWindows and to prepare for its * //* installation. * //* * //* Caution: This is neither a JCL procedure nor a complete job. * //* Therefore, before using this sample, you will need to * //* make changes as described throughout. * //* * //* * //* Communications Server X11R4 XWindows is packaged using the SMP/E * //* GIMZIP function. The SMP/E GIMUNZIP function is required to * //* process the download package: * //* * //* You will need to perform the following tasks: * //* * //* 1. Obtain the appropriate SMP/E PTF for your driving system. This * //* PTF is required to extract the GIMZIP archives in the download * //* package. * //* * //* OS/390 R5/R6: PTF UR52470 (and UR52472 for Japanese) * //* OS/390 R7/R8/R9/R10: PTF UR52471 (and UR52473 for Japanese) * //* * //* Refer to the SMP/E website for configuration and usage * //* information for GIMUNZIP: http://www.s390.ibm.com/smpe/ and * //* ensure that configuration requirements for using GIMUNZIP have * //* been completed. * //* * //* 2. Create a directory where the downloaded files can be stored. * //* This directory must be on the z/OS system where the function * //* is to be installed. Ensure you have read and write access to * //* this directory. * //* * //* 3. Download the Communications Server X11R4 XWindows package. * //* The package is available from the following * //* web site: * //* * //* http://www.ibm.com/software/network/commserver/downloads/ * //* * //* There are three files to be downloaded (saved).These files * //* must be downloaded (saved) to a node that has connectivity to * //* your z/OS target system. The files must then be uploaded to * //* the z/OS target system where the function will be installed, * //* and stored in the directory created in step 2 above. * //* * //* The three files to be downloaded are: * //* * //* a) README.TXT (the file you are reading) * //* * //* This is a sample job that performs the following tasks: * //* * //* * Executes the USS pax command to extract the GIMZIP * //* archives from the downloaded package * //* * //* * Executes the GIMUNZIP program to expand the GIMZIP * //* archives and places their contents in data sets that * //* can be processed by SMP/E * //* * //* * Executes the SMP/E RECEIVE function to receive the FMIDs * //* from the data sets created by GIMUNZIP. * //* * //* This job must be updated to reflect your environment. * //* * //* b) Communications Server X11R4 XWindows - * //* This file contains the SMP/E MCS and the associated RELFILEs.* //* * //* c) Communications Server X11R4 XWindows Program Directory * //* This is avaialble in PDF or Book format. * //* * //* 4. Update the job card information and elsewhere as indicated * //* in the sample job provided in the README.TXT (the file you are * //* reading). * //* * //* 5. Run the sample job provided in the README.TXT. This job will * //* perform the required tasks up to and including the SMP/E * //* RECEIVE step. * //* (Insure that at least 66,300,000 bytes are available on dasd * //* mounted as PUBLIC or STORAGE as files will be loaded there.) * //* * //* 6. Complete the installation using the instructions in the * //* program directory. * //* * //********************************************************************* //* This sample contains three job steps to perform the following * //* tasks: * //* * //* (1) Un-pax the single download file into the component archive * //* files which compose the entire download package. * //* * //* (2) Run the SMP/E GIMUNZIP service routine to extract the FMIDs * //* from the download package archive files. For detailed * //* information on the GIMUNZIP service routine, see the * //* following web site: http://www.s390.ibm.com/smpe/ * //* * //* (3) Run SMP/E to receive the FMIDs from the data sets extracted * //* during the previous step. * //* * //* Each of the steps require changes before executing the job. The * //* required changes are described below within each job step. Also, * //* don't forget to update the job card with your specific * //* requirements. * //********************************************************************* //* * //* Un-pax Step: * //* * //* This step expands the single download file into the individual * //* archive files which compose the entire download package. The * //* component archive files are expanded into the same directory * //* where the download file resides. * //* * //* Note: the download file was created using the following: * //* cd /u/userid/Xwindows/ * //* pax -wzv . >/u/userid/Xwindows/Xwindows.pax.Z * //* * //* REPLACE the two occurrences of the directory name * //* "/u/userid/Xwindows/" in the step below with * //* the name of your directory which contains the download file. * //* * //* Be sure to keep the continuation character "+" in column 72. * //* * //* The name of the download file Xwindows.pax.Z may differ * //* depending on the method you chose to upload the file. Change * //* the name of the file in the step below to match your file name * //* if necessary. * //* * //* This step should complete with a return code 0. * //* * //********************************************************************* //UNPAX EXEC PGM=IKJEFT01 //SYSTSPRT DD SYSOUT=* //SYSEXEC DD DSN=SYS1.SBPXEXEC,DISP=SHR //SYSTSIN DD * oshell cd /u/userid/Xwindows/ ; + pax -rvf /u/userid/Xwindows/Xwindows.pax.Z /* //********************************************************************* //* * //* GIMUNZIP Step: * //* * //* This step extracts the FMID and related materials from the * //* download package archive files into data sets. The data sets * //* containing the FMID are then used later as input to the * //* SMP/E RECEIVE command operation. * //* * //* If you want to perform hash checking, ICSF must be configured. * //* Hashing provides additional security and verification for the * //* download file. Refer to ICSF configuration requirements at * //* http://www.s390.ibm.com/smpe/. If you have ICSF configured * //* and want to perform hash checking, change the parameter value * //* on the EXEC statement below to HASH=YES. * //* * //* This step should complete with a return code 0. * //* * //********************************************************************* //GIMUNZIP EXEC PGM=GIMUNZIP,PARM='HASH=NO' //* //* Utility work data sets: //SYSUT3 DD UNIT=SYSALLDA,SPACE=(CYL,(50,10)) //SYSUT4 DD UNIT=SYSALLDA,SPACE=(CYL,(25,5)) //* Message output data sets: //SMPOUT DD SYSOUT=* //SYSPRINT DD SYSOUT=* //* //********************************************************************* //* * //* REPLACE the directory name "/u/userid/Xwindows/" on the SMPDIR * //* DD statement below with the name of your directory which contains * //* the download package. * //* * //********************************************************************* //SMPDIR DD PATH='/u/userid/Xwindows/', // PATHDISP=KEEP //* //********************************************************************* //* * //* REPLACE all occurences of the "dsprefix" value below with your * //* desired data set name prefix. This value is used for the names * //* of the data sets extracted from the download package. * //* * //********************************************************************* //SYSIN DD * /* //* //********************************************************************* //* * //* SMP/E RECEIVE Step: * //* * //* This step performs an SMP/E RECEIVE command operation on the * //* FMIDs extracted from the download package. The FMIDs are * //* received from the data sets produced in the GIMUNZIP step. * //* * //********************************************************************* //RECEIVE EXEC PGM=GIMSMP,REGION=0M //* //********************************************************************* //* * //* REPLACE the CSI name on the SMPCSI DD statement below with the * //* data set name of your global CSI. * //* * //********************************************************************* //SMPCSI DD DSN=smpe.global.csi, // DISP=SHR //* //********************************************************************* //* * //* REPLACE the "dsprefix" value on the SMPPTFIN DD statement * //* below with the data set name prefix specified in the GIMUNZIP * //* step above. * //* * //********************************************************************* //SMPPTFIN DD DSN=dsprefix.HIP612X.SMPMCS, // DISP=SHR //* //********************************************************************* //* * //* REPLACE the "dsprefix" value on the RFPREFIX operand below with * //* the data set name prefix specified in the GIMUNZIP step above. * //* * //********************************************************************* //SMPCNTL DD * SET BDY(GLOBAL). RECEIVE SYSMODS RFPREFIX(dsprefix) SELECT( HIP612X ). /*