Download HOLDDATA

cmcm10
When you apply maintenance, you typically encounter SMP/E HOLDDATA. We use HOLDDATA to notify your SMP/E system of SYSMODs that have errors or special conditions. Download HOLDDATA on a regular cadence and review the ERRSYSMODS report before applying maintenance. The following HOLDDATA is supported:
  • ERROR HOLDDATA
    ERROR HOLDDATA identifies critical maintenance that should be applied for your product. The HOLDDATA file contains cumulative enhanced ERROR HOLDDATA for all mainframe products. Obtain this HOLDDATA file before installing new product FMIDs or applying maintenance to ensure you have received any new or updated HOLDDATA. Doing so ensures that you have received the latest current HOLDDATA. Review and install critical fixes at least once a week.
    ERROR HOLDDATA is used for SYSMODS that have errors or special conditions. ERROR HOLDDATA prevents PTFs in error from being applied without a fixing PTF. When a published SYSMOD resolves the error HOLDDATA, the resolving SYSMOD supersedes the error HOLDDATA. This action lets you apply the original SYSMOD with the fixing SYSMOD.
    To ensure that you have received new or updated HOLDDATA, obtain this HOLDDATA file before installing new product FMIDs or applying maintenance. SMP/E checks the HOLDDATA before applying or accepting PTFs. You can bypass ERROR HOLDDATA in situations that are not applicable to you. For example, a problem with a hardware device that you do not have or a product feature that you do not use.
    To use ERROR HOLDDATA:
    1. Download the latest HOLDDATA.
    2. RECEIVE the ERROR HOLDDATA into your global zone
      before
      applying any maintenance
      SMP/E checks the HOLDDATA before applying or accepting PTFs. You can bypass ERROR HOLDDATA in situations that are not applicable to you. For example, a problem with a hardware device that you do not have or a product feature that you do not use.
    3. Execute REPORT ERRORSYSMODS after all HOLDDATA has been received.
      This report identifies any held SYSMODs that have already been applied on your system. This report also identifies any resolving SYSMODs that are in RECEIVE status. SMP/E identifies the SYSMOD to apply to correct the situation.
    ++ASSIGN HIPER statements have also been consolidated into a single file. The consolidation of ERROR HOLDDATA and ++ASSIGN HIPER statements into a single location helps identify critical maintenance that should be applied to all Broadcom mainframe products that are packaged using SMP/E.
  • System HOLDDATA
    System HOLDDATA specifies data that is an in-stream part of the SYSMOD, informing you of special conditions. For more information about the special conditions, see the product-specific documentation.
  • FIXCAT HOLDDATA
    FIXCAT HOLDDATA helps to identify maintenance that is required to support a particular hardware device, software, or function. Fix categories are supplied as SMP/E FIXCAT HOLDDATA statements. Each FIXCAT HOLDDATA statement associates an APAR and its related fixing PTF to one or more fix categories. Use FIXCAT HOLDDATA to prepare for upcoming upgrades.
    The SMP/E FIXCAT HOLDDATA statements are supplied in the same file as the consolidated ERROR HOLDDATA statements provided as part of the external HOLDDATA. Download FIXCAT HOLDDATA after you have downloaded the published PTFs for your products.
    During SMP/E RECEIVE command processing, SMP/E translates fix category values into source IDs and assigns them to the resolving (fixing) PTFs that the HOLDDATA identifies. You can then use the fix category values as source IDs when selecting a set of PTFs to be applied.
  • External HOLDDATA
    The external HOLDDATA resides in a separate file and contains cumulative enhanced ERROR and FIXCAT HOLDDATA. External HOLDDATA is not part of the PTF.
    Download the external HOLDDATA (ERROR and FIXCAT) from Broadcom Support to a DASD file, and then allocate the file to the SMPHOLD DD statement. To resolve the external HOLDDATA, receive it into your SMP/E environment. SMP/E receives the HOLDDATA from Broadcom supplied jobs. You can find JCL to download the external HOLDDATA in your SAMPJCL member. Open
    hlq
    1HOLD or
    hlq
    60RCH in an edit session and execute the
    hlq
    SEDIT macro on the command line. Then, submit the JCL.
    If your product was released after December 22, 2016, use
    xxx
    60RCH. For more information about which member to use, see your product-specific documentation.
HOLDDATA resides in a separate file and contains ERROR and FIXCAT data. This HOLDDATA is not part of the PTF. HOLDDATA also contains ++ASSIGN statements. Obtain this HOLDDATA file on a regular cadence and before installing new FMIDs or applying maintenance to ensure you have received any new or updated HOLDDATA.
You can download HOLDDATA automatically using the CA SMP/E Internet Retrieval Service and CA Chorus Software Manager. You can also download HOLDDATA manually as described in this topic.
To download the HOLDDATA file as text (TXT) or packed (BIN) directly to the mainframe, go to ftp://ftp.broadcom.com/pub/HoldData. Sample JCL is provided so that you can download HOLDDATA for the last 30 days (monthly), 90 days (quarterly), 365 days (yearly). Or, you can download all HOLDDATA.
Download the HOLDDATA File as TXT
Use the following procedure to download the HOLDDATA file from the FTP site as
TXT
directly to the mainframe.
Follow these steps:
  1. Customize and execute the following JCL:
    //FTPSTEP EXEC PGM=FTP,PARM='(EXIT=08' //SYSTCPD DD DSN=
    TCP/IP_data_set
    ,DISP=SHR //SYSPRINT DD SYSOUT=* //OUTPUT DD SYSOUT=* //INPUT DD * ftp.broadcom.com 21 anonymous
    email_address
    cd /pub/HoldData/ dir asc locsite LR=80 REC=FB BLOCKSI=0 locsite PRI=20 SEC=10 CY get
    HOLDDATA_file
    '
    z/OS_data_set
    ' (REPLACE quit
  2. Replace TCP/IP_data_set with your TCPIP data set name.
  3. Replace email_address with your valid email address.
  4. Replace HOLDDATA_file with the HOLDDATA file name (MONTHLY-HOLDDATA.TXT, QUARTER-HOLDDATA.TXT, YEARLY-HOLDDATA.TXT, ALL-HOLDDATA.TXT) that you want to download.
  5. Replace z/OS_data_set with a valid z/OS data set name where you want to save the HOLDDATA file. If the data set does not exist, it is created during the download process.
Download the HOLDDATA File as BIN
Use the following procedure to download the HOLDDATA file from the FTP site as
BIN
directly to the mainframe.
Follow these steps:
  1. Customize and execute the following JCL:
    //FTPSTEP EXEC PGM=FTP,PARM='(EXIT=08' //SYSTCPD DD DSN=TCP/IP_data_set,DISP=SHR //SYSPRINT DD SYSOUT=* //OUTPUT DD SYSOUT=* //INPUT DD * ftp.broadcom.com 21 anonymous
    email_address
    cd /pub/HoldData/ dir bin locsite LR=80 REC=FB BLOCKSI=0 locsite PRI=20 SEC=10 CY get
    HOLDDATA_file
    '
    z/OS_data_set
    ' (REPLACE quit
    1. Replace TCP/IP_data_set with your TCPIP data set name.
    2. Replace email_address with your valid email address.
    3. Replace HOLDDATA_file with the HOLDDATA file name (MONTH.BIN, QUARTER.BIN, YEAR.BIN, COMPLETE.BIND) that you want to download.
    4. Replace z/OS_data_set with a valid z/OS data set name where you want to save the HOLDDATA file. If the data set does not exist, it is created during the download process.
  2. FTP the file to the mainframe as a fixed file with RECFM=FB and LRECL=1024
  3. Unterse the file (the OUTFILE should
    not
    be preallocated).
//UNTERSE EXEC PGM=TRSMAIN,PARM='UNPACK' //SYSPRINT DD SYSOUT=* //INFILE DD DISP=SHR,DSN=
your_data_set_name
//OUTFILE DD DSN=
your_output_data_set_name
, // UNIT=SYSDA,SPACE=(CYL,(5,1),RLSE), // DISP=(NEW,CATLG,DELETE)
Use HOLDDATA
After all HOLDDATA has been received, execute REPORT ERRORSYSMODS to identify any missing HIPER or resolving PE PTF fixes that are needed. This report identifies any held SYSMODs that have already been applied on your system. HOLDDATA also identifies any resolving SYSMODs that are in RECEIVE status.
Download ++ASSIGN Statements
Receive the HIPER assign statements into your global zone
before
applying maintenance to ensure that any critical service is applied.