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, we provide a web-based maintenance request service. See the following procedures:

To request a maintenance package

  1. Create a software inventory XML file:
    1. 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
      /*                               
      


    2. Download the created software inventory XML file (with an extension of .xml) to your workstation.
  2. Access the BMC web-based service for RECEIVE ORDER:
    1. On your workstation, log in to BMC Support Central .
    2. Go to https://www.bmc.com/available/zso.html to access the BMC web-based service for SMP/E RECEIVE ORDER.
  3. Click Mainframe - Services.
  4. Specify the service you want:
    1. In My support contracts, select a Contract ID.
    2. In the Services drop-down, click Request PTF maintenance.
    3. Click Continue.
  5. Specify the type of maintenance you want:
    1. In the Package Category drop-down, click a RECEIVE ORDER content type. 
    2. Click Start order.
    3. Review the order information.
    4. Click Continue.
  6. 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.

    1. Click Upload file, navigate to the XML file location, click the file, and click Open.
      The file is uploaded. 
    2. Click Continue.
  7. Specify the type of shipment you want.
    By default, shipments are provided in electronic format. 
    1. If you require a physical shipment, click Physical Media and complete the form.
    2. Click Continue.
  8. Review and submit your order:
    1. (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.
    2. Click Submit order.
      A confirmation of the order is displayed. You will also receive an email with this information.
  9. Click Home.

To retrieve a maintenance package

After you receive the email stating your maintenance order is complete, perform the following procedure:

  1. Click the link in the email or go to https://www.bmc.com/available/zso.html.
  2. Click Order - Dashboard and Processed.
  3. On the row for your order number, click the link in the Current Status column.
    Information about the maintenance package is displayed.
  4. Log on to the provided server with the provided credentials.
  5. Check the download folder and click Download.
    The download folder contains all the files required for the requested maintenance. 
    The request service creates a .zip file of the folder's contents and initiates the download.
  6. 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.

To process a maintenance package

  1. 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

    prompt 

    Note

    We recommend that you turn off the interactive mode to avoid responding to each mput command while transferring multiple files.

    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


    VariableDescription
    zosHostThe name or address of the z/OS host system.
    smpNTSThe path name of the directory in the host file system where the package will reside.
    orderIDThe service package order ID as provided by the web-based maintenance request service.
    pcDirThe directory path on your local workstation where the unzipped files are located.
  2. 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>'
    VariableDescription
    globalDSNThe name of the CSI dataset for the global zone.
    orderIDThe service package order ID as provided by the web-based maintenance request service.
    smpNTSThe path name of the directory in the host file system where the package will reside.
  3. 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 
                 .
  4. 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 
                  .
Was this page helpful? Yes No Submitting... Thank you

Comments

  1. Felicitas Brachthaeuser

    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

    Oct 22, 2020 08:21
  2. Ermanno Bertolotti

    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)

    Oct 22, 2020 08:33
  3. Qi Zhou

    question: what's the suffix of the XML file name stored on my laptop ?,for example ABC.suffix

    Oct 26, 2020 06:25
    1. Ermanno Bertolotti

      XML is the suffix.

      Oct 26, 2020 08:07
      1. Scott Zhou

        thx, I see

        Oct 28, 2020 08:03
  4. Shrutika Sawant

    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 $$

    Jan 28, 2021 11:32
  5. Shrutika Sawant

    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

    Jan 28, 2021 11:45
    1. Mary Cameron

      Hello, Shrutika,

      I have reached out to Customer Support with your questions. I will get back to you as soon as I can.

      Jan 28, 2021 12:13