Requesting RECEIVE ORDER via a batch job
We fully support the IBM SMP/E RECEIVE ORDER command via a batch job.
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:
- To obtain the required certificates
- To set up your z/OS security server
- To create a RECEIVE ORDER batch job
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
- Create a RACF key ring and connect the DigiCert Global Root G2 certificate to your key ring.
- Make sure that you mark the user certificate as trusted.
- Add the user certificate to the RACF database.
- Connect the user certificate to your key ring.
- If required, set up your Java and network configuration settings for the RECEIVE ORDER command.
To create a RECEIVE ORDER batch job
- Make sure that all required 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 following sample:Click here to expand...
//<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>'
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:
Parameter Value Description inventory
Set the inventory keyword for environments other than IBM to all
url URL of the BMC Automated Service Request server keyring keyringNameContainingX509Certificate Name of the keyring that contains the X.509 user certificate certificate labelOfBMCX509Certificate Label assigned to the X.509 user certificate in the keyring
- 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.
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.
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?
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.
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(SYSUT1) CYLINDERS SPACE(75,50)
REP DDDEF(SYSUT2) CYLINDERS SPACE(75,50)
REP DDDEF(SYSUT3) CYLINDERS SPACE(75,50)
REP DDDEF(SYSUT4) CYLINDERS SPACE(75,50)
REP DDDEF(SYSPUNCH) BLK(3120) SPACE(380,380) DIR(64)
Log in or register to comment.