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. 

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:

   Parameter	Value	Comments
   url	https://ws-prod.bmc.com/smpe	This is the URL for the BMC Automated Service Request server.
   inventory	all	The 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>'