Requesting RECEIVE ORDER via the web
At times, you might not be able to use the RECEIVE ORDER batch job to request and download maintenance directly to your mainframe. At those times, you can use a web-based maintenance request service. See the following procedures:
To request a maintenance package
- Create a software inventory XML file:
On the mainframe system for which you want maintenance, run the IBM software inventory routine (GIMXSID).
Use the following sample JCL statements to run GIMXSID://STEP EXEC PGM=GIMXSID,PARM='INVENTORY=ALL' //SMPOUT DD SYSOUT=* //SMPXTOUT DD DSN=outputdsn, DISP=(,CATLG), //SPACE=(TRK,(1,1)),UNIT=unit //SYSIN DD* CSI=TEST.CSI TARGET=target /*
- Download the created software inventory XML file (with an extension of .xml) to your workstation.
- Access the BMC web-based service for RECEIVE ORDER:
- On your workstation, log in to
BMC Support Central
.
- Go to https://www.bmc.com/available/zso.html to access the BMC web-based service for SMP/E RECEIVE ORDER.
- On your workstation, log in to
BMC Support Central
- Click Mainframe - Services.
- Specify the service you want:
- In My support contracts, select a Contract ID.
- In the Services list, select Request PTF maintenance.
- Click Continue.
- Specify the type of maintenance you want:
- In the Package Category list, select the required RECEIVE ORDER content type.
For example, to request a PTF delivery, select PTFS. - Click Start order.
- If you have requested for APARS or PTFS, specify the required details.
- Review the order information.
- Click Continue.
- In the Package Category list, select the required RECEIVE ORDER content type.
If requested, upload the software inventory XML file you created.
Important
If you are requesting HOLDDATA or APARS no software inventory XML file is requested.
- Click Upload file, navigate to the XML file location, click the file, and click Open.
The file is uploaded. - Click Continue.
- Click Upload file, navigate to the XML file location, click the file, and click Open.
- Specify the type of shipment you want.
By default, shipments are provided in electronic format.- If you require a physical shipment, click Physical Media and complete the form.
- Click Continue.
- Review and submit your order:
- (Optional) In Alternative Email Address, provide an additional individual or group email address to which the order status emails are sent.
The order status emails are sent to the email associated with the BMC Support ID you used to log in. - Click Submit order.
A confirmation of the order is displayed. You will also receive an email with this information.
- (Optional) In Alternative Email Address, provide an additional individual or group email address to which the order status emails are sent.
- Click Home.
To retrieve a maintenance package using the distributed option
After you receive the email stating your maintenance order is complete, perform the following procedure:
- Click the link in the email or go to https://www.bmc.com/available/zso.html.
- Click Order - Dashboard and Processed.
- On the row for your order number, click the link in the Current Status column.
Information about the maintenance package is displayed. - Log on to the indicated server with the provided credentials.
The list of files and folders required for the requested maintenance is displayed. - Select the download folder and click Download.
The request service creates a .zip file of the folder's contents and initiates the download. Navigate to the downloaded .zip file on your computer and unzip the downloaded file.
The downloaded maintenance package is in standard SMP/E GIMZIP format.Important
Maintenance orders are available in the Order - Dashboard for 14 days.
- Using FTP, upload the maintenance package files to the USS directory on your z/OS system.
Use your FTP software tool or the following FTP commands in a command window.ftp zosHost
userID
password
bin
Important
If you are transferring multiple files, we recommend that you use a
prompt
command. Theprompt
command turn offs the Interactive mode so that you can avoid responding to eachmput
command.prompt
mkdir /smpNTS/orderID
cd /smpNTS/orderID
mput /pcDir/*.*
mkdir /smpNTS/orderID/SMPHOLD
cd /smpNTS/orderID/SMPHOLD
mput /pcDir/SMPHOLD/*.*
mkdir /smpNTS/orderID/SMPPTFIN
cd /smpNTS/orderID/SMPPTFIN
mput /pcDir/SMPPTFIN/*.*
quit
Variable Description zosHost The name or address of the z/OS host system. smpNTS The path name of the directory in the host file system where the package will reside. orderID The service package order ID that was provided by the web-based maintenance request service. pcDir The directory path on your local workstation where the unzipped files are located. Generate and submit the RECEIVE FROMNTS job by using the SMP/E ISPF interface or the following sample job:
//S1 EXEC PGM=GIMSMP, // PARM='PROCESS=WAIT', // DYNAMNBR=120 //* //SMPCSI DD DISP=SHR,DSN=<globalDSN> //* //SMPCNTL DD * SET BOUNDARY (GLOBAL) . RECEIVE FROMNTS( <orderID> ) DELETEPKG . //* //SMPNTS DD PATHDISP=KEEP, // PATH='<smpNTS>'
Variable Description globalDSN The name of the CSI dataset for the global zone. orderID The service package order ID that was provided by the web-based maintenance request service. smpNTS The path name of the directory in the host file system where the package will reside.
To retrieve a maintenance package using the network option
After you receive the email stating your maintenance order is complete, perform the following procedure:
Click the link in the email or go to https://www.bmc.com/available/zso.html.
Click Order - Dashboard and Processed.
- On the row for your order number, click the link in the Current Status column.
Information about the maintenance order is displayed. - Click the Maintenance Server XML accordion and then click the plus icon to view the Server XML content.
- Click the copy XML to clipboard icon to copy the contents of the Server XML file.
- Save the copied Server XML into a sequential file or PDS member on the mainframe to use for processing a RECEIVE FROMNETWORK command.
Generate and submit the RECEIVE FROMNETWORK job by using the SMP/E ISPF interface or the following sample job:
//S1 EXEC PGM=GIMSMP, // PARM='PROCESS=WAIT', // DYNAMNBR=120 //* //SMPCSI DD DISP=SHR,DSN=<globalDSN> //* //SMPCNTL DD * SET BOUNDARY (GLOBAL) . RECEIVE FROMNETWORK( SERVER(SMPSRVR) CLIENT(SMPCLNT) ) . //********************************************************************* //* ADDITIONAL JCL FOR THE RECEIVE COMMAND. //* //********************************************************************* //SMPSRVR DD DISP=(SHR,KEEP), // DSN=<smpSRVR> //SMPCLNT DD DISP=(SHR,KEEP), // DSN=<smpCLNT> //SMPNTS DD PATHDISP=KEEP, // PATH='<smpNTS>'
Variable Description globalDSN The name of the CSI data set for the global zone. smpSRVR The name of the smpSRVR data set containing the copied XML. smpCLNT The name of the smpCLNT data set containing environment of local system. orderID The service package order ID that was provided by the web-based maintenance request service. smpNTS The path name of the directory in the host file system where the package will reside.
To process a maintenance package
Generate and submit the APPLY job by using the SMP/E ISPF interface or the following sample statement in your job:
//SMP.SMPCNTL DD * SET BDY(BMC0TZN). APPLY PTFS APARS GROUPEXTEND NOJCLR BYPASS(HOLDSYS(DOC,ACTION,DB2BIND,DELETE)) /* REVIEW THE HOLD INFORMATION IN THE */ /* OUTPUT OF THE JOB. IT IS IMPORTANT */ /* TO FOLLOW ALL NECESSARY ACTIONS. */ CHECK .
Generate and submit the ACCEPT job by using the SMP/E ISPF interface or the following sample statement in your job:
//SMP.SMPCNTL DD * SET BDY(BMC0DZN). ACCEPT PTFS APARS GROUPEXTEND NOJCLR BYPASS(HOLDSYS(DOC,ACTION,DB2BIND,DELETE)) /* REVIEW THE HOLD INFORMATION IN THE */ /* OUTPUT OF THE JOB. IT IS IMPORTANT */ /* TO FOLLOW ALL NECESSARY ACTIONS. */ CHECK .
For more information, see IBM SMP/E for z/OS Commands documentation.
Comments
Hello, can you please clarify the input needed when requesting PTF maintenance. Please explain on how to create the XML file. Please check, if the XML is requested all times. Thanks Feli
you can use a job like this
//STEP1 EXEC PGM=GIMXSID,PARM='WAIT=10MIN,L=ENU,INVENTORY=ALL'
//SYSPRINT DD SYSOUT=*
//SMPOUT DD SYSOUT=*
//SMPXTOUT DD DISP=(,CATLG),DSN=&SYSUID..TW000.SMPXTOUT.MVP121.XML, // RECFM=VB,LRECL=255,DSORG=PS,BLKSIZE=0,
// UNIT=SYSALLDA,SPACE=(CYL,(10,10))
//SYSIN DD DATA,DLM=$$
CSI=YZ00BMC.VS000.MVPERF.V121.GLOBAL.CSI
TARGET=BMC0TZN
$$
and after transfer the file on your pc like TXT file (not in bynary mode)
question: what's the suffix of the XML file name stored on my laptop ?,for example ABC.suffix
XML is the suffix.
thx, I see
hi ,
i used the below step to run the job ,but that did not work
//STEP1 EXEC PGM=GIMXSID,PARM='INVENTORY=ALL' //SYSPRINT DD SYSOUT=* //SMPOUT DD SYSOUT=* //SMPXTOUT DD DSN=output.dataset,DISP=(NEW,CATLG), // DCB=(RECFM=FB,LRECL=12560,BLKSIZE=25120), // SPACE=(TRK,(10,10)) //* //SYSIN DD DATA,DLM=$$ CSI=csi name TARGET=Target name $$
when im trying to upload the file its says Provided xml doesn't match inventory specification. please provide me the alternate way to upload the file
Hello, Shrutika,
I have reached out to Customer Support with your questions. I will get back to you as soon as I can.
Cannot upload an XML file, says "Provided xml doesn't match inventory specification."
How may I fix this?
Thanks
Hi, Stephen. Thank you for your query. I have forwarded it to the writer who is responsible for this content.
Dov
I was able to resolve this, the parameter INVENTORY=ALL must be used. Without it, I get the above error.
Thanks TANK
Exist a way to download the PTFs to a PDS file, instead to apply directly to SMP ?
Hi, Luis. Thank you for your question. I have forwarded it to the writer who is responsible for this content.
Hi, Luis.
RECEIVE ORDER maintenance packages are always delivered in GIMZIP format, regardless of how the order was placed (SMP/E Batch JOB or web-based order). This is an IBM SMP/E specification for the packaging.
After following above instructions, I get: GIM45800S ** PACKAGE W1681747075877 WAS NOT FOUND IN THE SMPNTS.
Hi, Jeff. Thank you for your feedback. I have forwarded it to the writer who is responsible for this content.
Hi, Jeff. I recommend that you create a Support case at Support Central.
Log in or register to comment.