Requesting RECEIVE ORDER via a batch job

BMC fully supports the IBM SMP/E RECEIVE ORDER command via a batch job.

This topic contains the following information:

Requirements for using RECEIVE ORDER via a batch job

To use RECEIVE ORDER for your BMC products, you must have the following certificates installed and accessible in a security keyring 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 

For more information about obtaining these certificates, see File server and certificate information.

Details about using RECEIVE ORDER via a batch job

We do not fully document the use of SMP/E RECEIVE ORDER or digital certificates. 

Important

The information in this topic only points out information specific to BMC. All other usage and reference information should be obtained 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.

To create a RECEIVE ORDER batch job

  1. Ensure all necessary 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 sample from Sample RECEIVE ORDER batch job).
  3. Modify the generated batch job to meet your site requirements.

    Use the following information in the ORDSRVR DD statement:

    ParameterValueComments
    url https://ws-prod.bmc.com/smpe This is the URL for the BMC Automated Service Request server.
    inventoryallThe inventory keyword for environments other than IBM must be set to all.  
    keyring keyringNameContainingX509Certificate
    The name of the keyring that contains the x.509 user certificate.
    certificate labelOfBMCX509Certificate The label assigned to the x.509 user certificate in the keyring.

Sample RECEIVE ORDER batch job

An example of a RECEIVE ORDER batch job follows:

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