Obtaining the Installation System image by using the direct file transfer method

The direct file transfer method uses FTP or SFTP to download the Installation System image and decompression job from the BMC Electronic Software Distribution File Transfer Protocol (BMC ESD FTP) site. Use the following procedure to use the direct file transfer method:
  1. Create a job by copying and modifying the appropriate sample JCL:

    Tip

    You can copy the sample JCL from the Installation System web page as follows:

    1. Go to BMC Support Central and log on.

    2. Select Downloads & Products > Mainframe Installation > Sample JCL.

    3. Click the appropriate link under "Sample JCL when using the direct file transfer method."

  2. Make the changes described in the following table.

    When editing the JCL:

    • Ensure that the JCL is unnumbered; FTP or SFTP reads all 80 characters.
    • Set CAPS OFF and NUM OFF.
    • Remove the angle brackets (< >) from around the variables when you update them.

    Item

    Description

    JOB statement

    Customize the jobcard or jobcards to comply with your site’s requirements.

    Note: This job requires a REGION parameter value of 0M.

    Variable text in the INPUT DD section

    Change the following variables in the input section.

    Note: The BMC ESD FTP server is case sensitive. You must use lowercase letters for all data in the INPUT DD section.

    • <FTP_Password> to the ESD password

      To view the current password, go to http://www.bmc.com/support/reg/esd-password.html. When prompted, provide a valid support user ID and password. To register for a support user ID and password, go to http://www.bmc.com/support.

    • <unit>, <volume>, and, optionally, the SMS variables to the correct values for your site

      If you do not use a variable, delete the line. Do not leave unused lines in the JCL.

    • (For SFTP only) FileSystem-Path to the USS path name to be used for control card and transfer of files to your host system

    • <VRMM> to the current Installation System version number

      To determine the version number, see the most recent Installation System release notes on any product page on Support Central.

    • <InstallImageDatasetName> to a valid data set name for your site

      This data set should not already exist. The data set is created when the image file is downloaded.

    • <INSTDCMPDatasetName> to a valid data set name for your site

      This data set should not already exist. The data set is created when the image file is downloaded.

    • Make any additional changes that your site requires, such as providing proxy information to get outside your firewall.
  3. Submit the JCL to perform the download.
  4. Continue to Decompressing the Installation System image.

FTP sample JCL

//<JOB_NAME> JOB (<ACCOUNT>),'USER COMMENT',
// CLASS=<JOB_CLASS>,MSGCLASS=<MSG_CLASS>,
// TIME=1440,REGION=0M,NOTIFY=&SYSUID
//*
//********************************************************************
//*                                                                  *
//* DESCRIPTION:                                                     *
//*    This job downloads the Installation System base image         *
//*    and sample JCL to decompress the installation image.          *
//*                                                                  *
//* STEPS:                                                           *
//*                                                                  *
//* 1. Customize the jobcard to comply with your site's requirements.*
//*                                                                  *
//*    PARAMETER         TO OVERRIDE/CHANGE:                         *
//*    --------------------------------------------------------------*
//*    Job Name        - Change <JOB_NAME> to a valid job name for   *
//*                      your site.                                  *
//*                                                                  *
//*    Job Account     - Change <ACCOUNT> to a valid job account for *
//*                      your site.                                  *
//*                                                                  *
//*    Job Class       - Change <JOB_CLASS> to a valid job class for *
//*                      your site.                                  *
//*                                                                  *
//*    Message Class   - Change <MSG_CLASS> to a valid message class *
//*                      for your site.                              *
//*                                                                  *
//* 2. Change the FTPGET step parameters to comply with your site    *
//*    requirements.  Remove any parameters that are not needed.     *
//*    The syntax in the input DD is case sensitive.                 *
//*                                                                  *
//*    PARAMETER         TO OVERRIDE/CHANGE:                         *
//*    --------------------------------------------------------------*
//*                                                                  *
//*    UNIT            - Change <unit> to a valid DASD unit          *
//*                      for your site.                              *
//*                                                                  *
//*    VOLUME          - Change <volume> to a valid VOLUME serial    *
//*                      number for YOUR SITE.                       *
//*                                                                  *
//*    SMS storage     - CHANGE <smsStorageClass> to a valid SMS     *
//*    class             storage class for your site.                *
//*                                                                  *
//*    SMS management  - CHANGE <smsManagementClass> to a valid      *
//*    class             SMS management class for your site.         *
//*                                                                  *
//*    SMS data class  - Change <smsDataClass> to a valid SMS data   *
//*                      class for your site.                        *
//*                                                                  *
//*    Installation    - Change <InstallImageDatasetName> to         *
//*    System Image      name be allocated on your host system.      *
//*                                                                  *
//*    Decompress JOB  - Change <INSTDCMPDatasetName> to name to be  *
//*                      allocated on your host system.              *
//*                                                                  *
//* 3. Make any additional changes that your site requires, such as  *
//*    providing proxy information to get outside firewall.          *
//*                                                                  *
//* 4. Submit this JOB to FTP requested files.                       *
//*                                                                  *
//********************************************************************
//FTPGET EXEC PGM=FTP,REGION=5120K,
// PARM='epddownload.bmc.com (timeout 720 exit=8'
//SYSMDUMP DD SYSOUT=*
//SYSPRINT DD SYSOUT=*
//SYSOUT DD SYSOUT=*
//OUTPUT DD SYSOUT=*
//INPUT DD *
mainframe <FTP_Password>
cd /bmc/esd/ozi
binary
locsite rec=fb lr=80 blk=6160
locsite cy pri=1 sec=1
locsite u=<unit>
locsite vol=<volume>
locsite stor=<smsStorageClass>
locsite mg=<smsManagementClass>
locsite datac=<smsDataClass>
get bmcozi-v<VRMM>-image.bin +
'<InstallImageDatasetName>'
locsite tr pri=2 sec=1
ascii
get inst_dcmp_sample_jcl.txt +
'<INSTDCMPDatasetName>'
quit
/*
//

SFTP sample JCL

//<JOB_NAME> JOB (<ACCOUNT>),'USER COMMENT',
// CLASS=<JOB_CLASS>,MSGCLASS=<MSG_CLASS>,
// TIME=1440,REGION=0M,NOTIFY=&SYSUID
//*
//********************************************************************
//*                                                                  *
//* DESCRIPTION:                                                     *
//*    This job downloads the Installation System image              *
//*    and sample JCL to decompress the Installation System image.   *
//*                                                                  *
//* STEPS:                                                           *
//*                                                                  *
//* 1. Customize the job cards to comply with your site requirements *
//*                                                                  *
//*    PARAMETER         TO OVERRIDE/CHANGE:                         *
//*    --------------------------------------------------------------*
//*    Job Name        - Change <JOB_NAME> to a valid job name for   *
//*                      your site.                                  *
//*                                                                  *
//*    Job Account     - Change <ACCOUNT> to a valid job account for *
//*                      your site.                                  *
//*                                                                  *
//*    Job Class       - Change <JOB_CLASS> to a valid job class for *
//*                      your site.                                  *
//*                                                                  *
//*    Message Class   - Change <MSG_CLASS> to a valid message class *
//*                      for your site.                              *
//*                                                                  *
//* 2. Modify the following step parameters to comply with your      *
//*    site requirements.  Remove any parameters that are not needed.*
//*    The syntax in the input DD is case sensitive.                 *
//*                                                                  *
//*    PARAMETER         TO OVERRIDE/CHANGE:                         *
//*    --------------------------------------------------------------*
//*                                                                  *
//*    UNIT            - Change <unit> to a valid DASD unit          *
//*                      for your site.                              *
//*                                                                  *
//*    VOLUME          - Change <volume> to a valid VOLUME serial    *
//*                      number for YOUR SITE.                       *
//*                                                                  *
//*    SMS storage     - CHANGE <smsStorageClass> to a valid SMS     *
//*    class             storage class for your site.                *
//*                                                                  *
//*    SMS management  - CHANGE <smsManagementClass> to a valid      *
//*    class             SMS management class for your site.         *
//*                                                                  *
//*    SMS data class  - Change <smsDataClass> to a valid SMS data   *
//*                      class for your site.                        *
//*                                                                  *
//*    Install Image   - Change <InstallImageDatasetName> to name to *
//*                      be allocated on your host system.           *
//*                                                                  *
//*    Decompress JOB  - Change <INSTDCMPDatasetName> to name to be  *
//*                      allocated on your host system.              *
//*                                                                  *
//*    USS Path        - Change <FileSystem-Path> to path name to be *
//*                      used for control card and transfer of files *
//*                      to your host system                         *
//*                                                                  *
//* 4. Submit this JOB to SFTP requested files.                      *
//*                                                                  *
//********************************************************************
//*
//********************************************************************
//*                                                                  *
//* Pre-allocate files for the BMC Installation System Image and the *
//* decompression sample JCL.                                        *
//*                                                                  *
//********************************************************************
//*
//DSALLOC  EXEC PGM=IEFBR14
//DD1      DD  DSN=<InstallImageDatasetName>,
//             DISP=(NEW,CATLG,DELETE),
//             SPACE=(CYL,(27,5)),
//             DCB=(RECFM=FB,BLKSIZE=6160,LRECL=80,DSORG=PS),
//             UNIT=<unit>,
//             VOL=SER=<volume>,
//             DATACLAS=<smsDataClass>,
//             MGMTCLAS=<smsManagementClass>,
//             STORCLAS=<smsStorageClass>
//*
//DD2      DD  DSN=<INSTDCMPDatasetName>,
//             DISP=(NEW,CATLG,DELETE),
//             SPACE=(CYL,(1,1)),
//             DCB=(RECFM=FB,BLKSIZE=6160,LRECL=80,DSORG=PS),
//             UNIT=<unit>,
//             VOL=SER=<volume>,
//             DATACLAS=<smsDataClass>,
//             MGMTCLAS=<smsManagementClass>,
//             STORCLAS=<smsStorageClass>
//*
//********************************************************************
//*                                                                  *
//* Copy download syntax and logon credential information to USS     *
//* mount point directory for use by the SFTP step                   *
//*                                                                  *
//********************************************************************
//COPYSTEP EXEC PGM=IKJEFT01,COND=(4,LT)
//INZOS1  DD *
binary
lcd /<FileSystem-Path>
cd /bmc/esd/ozi
get bmcozi-v<VRMM>-image.bin bmcozi-v<VRMM>-image
!cp -B bmcozi-v<VRMM>-image "//'<InstallImageDatasetName>'"
!rm bmcozi-v<VRMM>-image
ascii
get inst_dcmp_sample_jcl.txt inst_dcmp_sample_jcl
!cp -F crnl inst_dcmp_sample_jcl "//'<INSTDCMPDatasetName>'"
!rm inst_dcmp_sample_jcl
!rm BMCInstImageDwld
!rm askpass.sh
/*
//OUTHFS1 DD PATH='/<FileSystem-Path>/BMCInstImageDwld',
//           PATHDISP=(KEEP,DELETE),
//           PATHOPTS=(OWRONLY,OCREAT),
//           PATHMODE=(SIRUSR,SIWUSR,SIRWXU)
//*
//INZOS2  DD *
#!/bin/bash
echo <FTP_Password>
/*
//OUTHFS2 DD PATH='/<FileSystem-Path>/askpass.sh',
//           PATHDISP=(KEEP,DELETE),
//           PATHOPTS=(OWRONLY,OCREAT),
//           PATHMODE=(SIRUSR,SIWUSR,SIRWXU)
//*
//SYSTSPRT DD SYSOUT=*
//SYSTSIN DD *
OCOPY INDD(INZOS1) OUTDD(OUTHFS1) TEXT CONVERT(YES) PATHOPTS(USE)
OCOPY INDD(INZOS2) OUTDD(OUTHFS2) TEXT CONVERT(YES) PATHOPTS(USE)
/*
//********************************************************************
//*                                                                  *
//* SFTP download step to acquire the Installation System image      *
//* and the sample decompress JCL.                                   *
//*                                                                  *
//********************************************************************
//SFTP EXEC PGM=BPXBATCH,
//       PARM=('sh sftp -vvv mainframe@filedownload.bmc.com')
//SYSPRINT DD SYSOUT=*
//STDOUT   DD SYSOUT=*
//STDERR   DD SYSOUT=*
//STDIN  DD PATH='/<FileSystem-Path>/BMCInstImageDwld'
//*
//STDENV DD *
DISPLAY=FOO
SSH_ASKPASS=/<FileSystem-Path>/askpass.sh
QUIT
/*
//

FTPS sample JCL

//<JOB_NAME> JOB (<ACCOUNT>),'USER COMMENT',
// CLASS=<JOB_CLASS>,MSGCLASS=<MSG_CLASS>,
// TIME=1440,REGION=0M,NOTIFY=&SYSUID
//*
//********************************************************************
//*                                                                  *
//* DESCRIPTION:                                                     *
//*    This job downloads the Installation System image              *
//*    and sample JCL to decompress the Installation System image.   *
//*                                                                  *
//* STEPS:                                                           *
//*                                                                  *
//* 1. Customize the jobcard to comply with your site's requirements.*
//*                                                                  *
//*    PARAMETER         TO OVERRIDE/CHANGE:                         *
//*    --------------------------------------------------------------*
//*    Job Name        - Change <JOB_NAME> to a valid job name for   *
//*                      your site.                                  *
//*                                                                  *
//*    Job Account     - Change <ACCOUNT> to a valid job account for *
//*                      your site.                                  *
//*                                                                  *
//*    Job Class       - Change <JOB_CLASS> to a valid job class for *
//*                      your site.                                  *
//*                                                                  *
//*    Message Class   - Change <MSG_CLASS> to a valid message class *
//*                      for your site.                              *
//*                                                                  *
//* 2. If required, uncomment DD statement and update accordingly    *
//*                                                                  *
//*    PARAMETER         TO OVERRIDE/CHANGE:                         *
//*    --------------------------------------------------------------*
//*    SYSTCPD DD      - Change <SecurityCertKeyRing>                *
//*                      to DSN containing reference to BMC          *
//*                      EV security certificate                     *
//*                                                                  *
//* 3. Change the FTPGET step parameters to comply with your site    *
//*    requirements.  Remove any parameters that are not needed.     *
//*    The syntax in the input DD is case sensitive.                 *
//*                                                                  *
//*    PARAMETER         TO OVERRIDE/CHANGE:                         *
//*    --------------------------------------------------------------*
//*                                                                  *
//*    UNIT            - Change <unit> to a valid DASD unit          *
//*                      for your site.                              *
//*                                                                  *
//*    VOLUME          - Change <volume> to a valid VOLUME serial    *
//*                      number for YOUR SITE.                       *
//*                                                                  *
//*    SMS storage     - CHANGE <smsStorageClass> to a valid SMS     *
//*    class             storage class for your site.                *
//*                                                                  *
//*    SMS management  - CHANGE <smsManagementClass> to a valid      *
//*    class             SMS management class for your site.         *
//*                                                                  *
//*    SMS data class  - Change <smsDataClass> to a valid SMS data   *
//*                      class for your site.                        *
//*                                                                  *
//*    Installation    - Change <InstallImageDatasetName> to         *
//*    System Image      name to be allocated on your host system.   *
//*                                                                  *
//*    Decompress JOB  - Change <InstallDCMPDatasetName> to name     *
//*                      to be allocated on your host system.        *
//*                                                                  *
//* 3. Make any additional changes that your site requires, such as  *
//*    providing proxy information to get outside firewall.          *
//*                                                                  *
//* 4. Submit this JOB to FTP requested files.                       *
//*                                                                  *
//********************************************************************
//FTPGET EXEC PGM=FTP,REGION=5120K,
// PARM='filedownload.bmc.com -a TLS -v (timeout 720 exit=8'
//SYSMDUMP DD SYSOUT=*
//SYSPRINT DD SYSOUT=*
//SYSOUT DD SYSOUT=*
//OUTPUT DD SYSOUT=*
//*
//*SYSTCPD  DD  DISP=SHR,DSN=<SecurityCertKeyRing>
//*
//INPUT DD *
mainframe Gmna5t1c
cd /bmc/esd/ozi
binary
locsite rec=fb lr=80 blk=6160
locsite cy pri=50 sec=5
locsite u=<unit>
locsite vol=<volume>
locsite stor=<smsStorageClass>
locsite mg=<smsManagementClass>
locsite datac=<smsDataClass>
get bmcozi-v3900-image.bin +
'<InstallImageDatasetName>'
locsite tr pri=2 sec=1
ascii
get inst_dcmp_sample_jcl.txt +
'<InstallDCMPDatasetName>'
quit
/*
//




Was this page helpful? Yes No Submitting... Thank you

Comments