Requesting RECEIVE ORDER via a batch job

We fully support the IBM SMP/E RECEIVE ORDER command via a batch job.

Important

The information in this topic is specific to BMC. You should obtain all other usage and reference information from IBM:

  • For information about using the required digital certificates, see the IBM z/OS SMP/E User's Guide.
  • For information about using the RECEIVE command, see the IBM SMP/E Command Guide.

This topic contains the following procedures:

Before you begin

For details about obtaining, installing, and using a certificate with RECEIVE ORDER, see the security server information in the z/OS SMP/E User's Guide.

To obtain the required certificates 

  • Install the following certificates on the mainframe system on which you are performing maintenance:
    • X.509 user certificate

    • DigiCert Global Root G2 certificate

    • (Required for FTPS only) EV SSL certificate 

To obtain these certificates, perform the steps in File server and certificate information.

To set up your z/OS security server

  1. Create a RACF key ring and connect the DigiCert Global Root G2 certificate to your key ring.
  2. Make sure that you mark the user certificate as trusted.
  3. Add the user certificate to the RACF database.
  4. Connect the user certificate to your key ring.
  5. If required, set up your Java and network configuration settings for the RECEIVE ORDER command.

To create a RECEIVE ORDER batch job

  1. Make sure that all required certificates are installed and accessible on the mainframe system on which you are performing maintenance.
  2. Generate the RECEIVE ORDER batch job by using the SMP/E ISPF interface or copy the following sample:

    //<JOBCARD>
    //*
    //S1       EXEC PGM=GIMSMP,
    //         PARM='PROCESS=WAIT',
    //         DYNAMNBR=120
    //*
    //*
    //*  SMP ZONE-RELATED FILES ARE DYNAMICALLY ALLOCATED,
    //*  THIS INCLUDES THE SMPPTS, SMPLOG, AND SMPTLIB DATA SETS,
    //*  IF APPLICABLE.
    //*
    //* SMP FILES
    //*
    //SMPCSI DD DISP=SHR,DSN=<your-bmc-global-csi>
    //*
    //*
    //SMPCNTL DD *
      SET BOUNDARY (GLOBAL)
                   .
      RECEIVE
           ORDER (
           ORDERSERVER(
               ORDSRVR
                     )
           CONTENT (
             ALL
                   )
           FORTGTZONES (
               <zone-name>
                   )
           CLIENT(SMPCLNT)
           WAIT(30)
                 )
           DELETEPKG
                    .
    //******************************************
    //* ADDITIONAL JCL FOR THE RECEIVE COMMAND.
    //******************************************
    //ORDSRVR DD *
    <ORDERSERVER
      inventory="all"
      url="https://ws-prod.bmc.com/smpe"
      keyring="<your-keyring>"
      certificate="<label-x.509-certificate>">
    </ORDERSERVER>
    //SMPCLNT DD *
      <See SMP/E command guide for options(ftp,ftps,http,https)>
    //*
    //SMPNTS DD PATHDISP=KEEP,
    //          PATH='<USS-PATH>'
  3. Modify the generated SMP/E RECEIVE ORDER batch job to meet your site requirements.
    You can use the following parameters in the ORDSRVR DD statement:

    ParameterValueDescription
    inventoryall

    Set the inventory keyword for environments other than IBM to all

    url

    https://ws-prod.bmc.com/smpe

    URL of the BMC Automated Service Request server
    keyringkeyringNameContainingX509CertificateName of the keyring that contains the X.509 user certificate
    certificatelabelOfBMCX509CertificateLabel assigned to the X.509 user certificate in the keyring
  4. Run the modified SMP/E RECEIVE ORDER batch job.

This job instructs SMP/E to order and download all recommended PTFs.

Where to go from here

For information about using the RECEIVE ORDER command, see the IBM SMP/E Command Guide.

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

Comments

  1. Cristian Roman

    This URL is not correct : https://www.bmc.com/available/zso.html.

    Nov 18, 2020 05:32
    1. Dov Kaiser

      Hi, Cristian. Thank you for your comment. The URL in question is correct, but to use it, you must first log in to BMC Support Central using your customer support credentials.

      Nov 19, 2020 12:48
  2. Gadi Ben-Avi

    Hi, When I ran the job for the first time, I got messages that there were DDDEFs missing. I added them as DD cards. The Missing DDDEF's were SMPLOG, SMPLOGA, SYSUT1-4 and SMPPTS. There might be others. Is there a list of DDDEF's that should be defined, and their definitions?

    Apr 07, 2021 06:14
    1. Mary Cameron

      Gadi, thank you for your comment. We use standard IBM RECEIVE ORDER processing. Please refer to their documentation for details about using RECEIVE ORDER. I will also pass this comment on to BMC Customer Support. If you need additional assistance, you can open a Case with BMC Customer Support at https://bmcsites.force.com/casemgmt

      Apr 07, 2021 06:52
      1. Mary Cameron

        Gadi,

        I received more information from BMC Customer Support. I hope it helps.

        If the Installation System built the zone, we use the following DDDEF statements. We do not use SMPLOGA.

        REP DDDEF(SMPPTS) SHR DA(RDATQS.TWSMV051.SMPPTS)
                                                   .
        REP DDDEF(SMPLOG) SHR DA(RDATQS.TWSMV051.SMPLOG)
                                                   .
        REP      DDDEF(SMPOUT)
                 SYSOUT(*) .
        REP      DDDEF(SMPLIST)
                 SYSOUT(*) .
        REP      DDDEF(SMPRPT)
                 SYSOUT(*) .
        REP      DDDEF(SMPSNAP)
                 SYSOUT(*) .
        REP      DDDEF(SMPDEBUG)
                 SYSOUT(*) .
        REP      DDDEF(SMPPUNCH)
                 SYSOUT(B) .
        REP      DDDEF(SYSPRINT)
                 SYSOUT(*) .
        REP      DDDEF(SYSUDUMP)
                 SYSOUT(*) .
        REP      DDDEF(SYSTERM)
                 SYSOUT(*) .
        REP      DDDEF(SYSUT1) CYLINDERS SPACE(75,50)
                 UNIT(SYSDA).
        REP      DDDEF(SYSUT2) CYLINDERS SPACE(75,50)
                 UNIT(SYSDA).
        REP      DDDEF(SYSUT3) CYLINDERS SPACE(75,50)
                 UNIT(SYSDA).
        REP      DDDEF(SYSUT4) CYLINDERS SPACE(75,50)
                 UNIT(SYSDA).
        REP      DDDEF(SYSPUNCH) BLK(3120) SPACE(380,380) DIR(64)
                 UNIT(SYSDA) .

        Apr 07, 2021 08:42