SMP/E RECEIVE ORDER Command Example
Sample SMP/E RECEIVE ORDER job.
After you complete the steps to enable the SMP/E RECEIVE ORDER command on your system, you can run an SMP/E RECEIVE ORDER job similar to the following example. This sample job instructs SMP/E to order and download all CA Recommend Service (CA RS) PTFs that are applicable to the target zones defined in your global zone. You can change this sample to order and download ALL available PTFs, APARs, only CRITICAL, only HOLDDATA, or one or more specific PTFs.
For RECEIVE ORDER command details, see the RECEIVE topic in the IBM documentation for SMP/E for z/OS Commands.
A RECEIVE PENDING order is purged from the download server after seven days. You can submit new orders even if one or more pending orders exist.
//jobname JOB ...,REGION=0M //RECEIVE EXEC PGM=GIMSMP //SMPCSI DD DSN=yourcsi,DISP=SHR //SMPNTS DD PATH=’/u/your/smpnts/directory’,PATHDISP=KEEP //SMPOUT DD SYSOUT=* //SMPRPT DD SYSOUT=* //SYSPRINT DD SYSOUT=* //SMPCNTL DD * SET BDY(GLOBAL). RECEIVE ORDER( ORDERSERVER(ORDSRVR) CLIENT(CLIENT) CONTENT(RECOMMENDED) ) DELETEPKG. /* //ORDSRVR DD * <ORDERSERVER url="https://eapi.broadcom.com/receiveorder" inventory="all" keyring="userid/keyring" certificate="SMPE Client Certificate"> </ORDERSERVER> /* //CLIENT DD * <CLIENT javahome="/usr/lpp/java/J8.0" javadebugoptions="-Dcom.ibm.smp.debug=severe -showversion" downloadmethod="https"> </CLIENT> /*
- yourcsiEnter your SMP/E CSI data set name.
- /u/your/smpnts/directoryEnter your USS directory that SMP/E uses to download your package.
- ORDERDirects SMP/E to place an order with the CA Automated Order server and to download and RECEIVE the resulting HOLDDATA or PTF SYSMODS package when the server fulfills the order. HOLDDATA packages contain all Enhanced HOLDDATA for all CA Mainframe products. PTF packages contain the PTFs ordered based on the specified content criteria and are tailored to the specific SMP/E environment. All Enhanced HOLDDATA is included in the PTF packages.
- ORDERSERVER(ORDSRVR)Specifies the one to eight character ddname that points to the data set where RECEIVE can get the necessary information about the CA Automated Order server that fulfills the order requests from SMP/E.
- CLIENT(CLIENT)Specifies the one to eight character ddname that points to the data set where RECEIVE can get the necessary information about the local z/OS client.
- CONTENT(ALL|APARS|CRITICAL|HOLDDATA|PTFS|RECOMMENDED)Indicates the desired PTF, HOLDDATA content, or both for the order. Specifyoneof the following options:WhenCONTENTis ALL, CRITICAL or RECOMMENDED and no PTFs are selected for packaging, all ++ASSIGN statements are processed. Warning message GIM24801W NO SYSMODS SATISFIED THE OPERANDS SPECIFIED ON THE RECEIVE COMMAND is generated. Processing terminates with return code 4.
- ALLInclude all available PTFs that are applicable to the SMP/E environment in the resulting PTF package.
- APARSInclude the resolving PTF SYSMODs for one or more specified APARS. The resulting PTF package is tailored to the SMP/E environment and contains the requested PTFs, plus any requisite PTFs that are not already present in the SMP/E environment. The specified values must be seven-alphanumeric character SYSMOD-ids.
- CRITICALInclude all available PTFs that resolve a critical problem and are applicable to the SMP/E environment in the resulting PTF package. A critical problem is a HIPER (high impact pervasive) or a PE (PTF in error).
- HOLDDATAInclude only HOLDDATA in the resulting package. The package contains all Enhanced HOLDDATA for Mainframe products.
- PTFSInclude one or more specified PTF SYSMODs in the resulting package. The resulting PTF package is tailored to the SMP/E environment and contains the requested PTFs, plus any requisite PTFs that are not already present in the SMP/E environment. The specified values must be seven alphanumeric character SYSMOD-ids.
- RECOMMENDEDInclude all available Broadcom recommended PTFs that are applicable to the SMP/E environment in the resulting PTF package. A recommended PTF is identified with a CA Recommended Service (CA RS) SOURCEID (CARSyymm). The resulting PTF package includes PTFs, HIPERs, and PRPs through and including the most current CA RS level.More PTFs, HIPER, or PE PTFs may have been published after the CARSyymmlevel. To ensure you have all available PTFs in the package, useALLorCRITICAL.The Order entry in the Global zone displays RSUyymm.
- DELETEPKGSpecifies to delete the package id subdirectory in the SMPNTS directory that was created or used as input for the command following the successful completion of an ORDER.
- A "successful RECEIVE" is defined as no warning or error conditions after the package files have been downloaded, up to the point where the subdirectory is to be deleted.
- This operand is ignored when ORDER is not specified on the RECEIVE command.
- DELETEPKG is mutually exclusive with the TRANSFERONLY option of ORDER.
- FORTGTZONESIdentifies the specific target zones SMP/E should use to create the software inventory on which the resulting PTF package is tailored. The software inventory is used to determine which PTFs are applicable to the SMP/E environment, and which PTFs are already present in the SMP/E environment and, therefore, do not need to be included in the resulting package.PTFs that are requested on the CONTENT PTFS operand are included in the resulting package whether they are already present in the SMP/E environment or not.Using the FORTGTZONES operand, you can specify target zone names, ZONESET names, or both. If FORTGTZONES is not specified, SMP/E uses all target zones (defined by a ZONEINDEX subentry in the current global zone), plus the global zone to create the software inventory.The specified values must be one to eight alphanumeric characters..
- PENDINGSpecifies the name of an ORDER entry whose package has not yet been downloaded. The PENDING operand indicates that SMP/E should attempt to download the package for the specified order. Such an order request is described by an ORDER entry in the global zone that has a status of PENDING.
- WAIT(minutes|NOLIMIT)Indicates how long in minutes SMP/E is to wait until an order is ready for download. This wait includes the time that is associated with connecting to the CA Automated Order server and preparing the order package for download. If the order is not ready within the specified time limit, RECEIVE command processing stops. The value for minutes is a decimal number from 0 through 1440.If WAIT(NOLIMIT) is specified, SMP/E waits for an unlimited time until the order is ready for downloading. If WAIT(0) is specified for a new order, SMP/E sends the order request to the CA Automated Order Server. The RECEIVE command processing is completed without waiting and without downloading the resulting package. If WAIT(0) is specified for a pending order, SMP/E processes the order only if it is ready for download immediately.This operand is optional. If the WAIT operand is not specified, SMP/E waits 120 minutes by default for orders to be ready for downloading.
- TRANSFERONLYIndicates that RECEIVE ORDER processing should stop after the package has been downloaded into the SMPNTS directory. SMP/E does not read the PTFs and HOLDDATA from the package and does not store it in either the global zone or the SMPPTS data set.To receive the PTFs and HOLDDATA from a TRANSFERONLY package, use the RECEIVE FROMNTS command to process the package that is stored in the SMPNTS directory. Specify the ORDER entry name with the ORDER suboperand on the FROMNTS operand.