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
- Ensure all necessary certificates are installed and accessible on the mainframe system on which you are performing maintenance.
- Generate the RECEIVE ORDER batch job by using the SMP/E ISPF interface (or copy the sample from Sample RECEIVE ORDER batch job).
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>'
Comments
This URL is not correct : https://www.bmc.com/available/zso.html.
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.