++PRODUCT MCS

The ++PRODUCT MCS is used to describe information about a product. It introduces descriptive information about a new or replacement product into the global zone.

Operands

The PRODUCT is identified by the combination of the prodid and the vv.rr.mm values.

prodid

is a 1- to 8-character product identifier. It can contain uppercase alphabetic, numeric, and national ($, #, @) characters. It may also contain one or more dashes (-). For IBM® products, the prodid is assumed to be the IBM program product number (5647-A01, for example).

vv.rr.mm

specifies the version, release, and modification level of this PRODUCT. It is 5 to 8 characters long in the form vv.rr.mm. The version (vv), release (rr), and modification (mm) values must be one or two numeric characters separated by a period ('.'). SMP/E will insert leading zeros to each section of the vv.rr.mm value that is one character long. That is, 2.5.0 will become 02.05.00 when stored.

DESCRIPTION

a text description of the product.

• DESCRIPTION can also be specified as DESC.
• The DESCRIPTION value can be in single-byte characters (such as English alphanumeric) or double-byte characters (such as Kanji).
• The DESCRIPTION value can contain up to 64 bytes of data, including blanks. (For double-byte data, the 64-byte maximum includes all shift-in and shift-out characters, as well as the double-byte characters.) Extra blanks as well as leading and trailing blanks are deleted.
• The DESCRIPTION value can span multiple 80-byte records. Data must continue up to and including column 72 and begin in column 1 of the next line. All data past column 72 is ignored. The break does not translate to a blank unless a blank is explicitly coded in column 72 of the first line or in column 1 of the second line.
• The DESCRIPTION value cannot be only blanks.
• If parentheses are included in the text, they must be in matched pairs.

SREL

specifies the system or subsystem releases on which the PRODUCT can be installed. Each SREL value must be four alphanumeric characters, usually one alphabetic character followed by three numeric characters. These are the systems and subsystems defined by IBM, with their SRELs:

System

SREL

DB2®

P115

CICS®

C150

IMS™

P115

MVS™

Z038

NCP

P004

The list of SRELs is used during RECEIVE processing to determine whether a PRODUCT should be received.

PRODSUP

indicates which PRODUCTs are superseded (replaced) by this PRODUCT. It is a list of prodid,vv.rr.mm values for the PRODUCTs being superseded. The combination of prodid and vv.rr.mm determines the uniqueness of an entry in the PRODSUP operand list.

The PRODSUP operand must not specify a prodid,vv.rr.mm combination matching the prodid,vv.rr.mm combination of the ++PRODUCT statement on which it is specified.

URL

specifies a uniform resource locator (URL) that can be used to obtain additional information about this product.

• The URL can be in single-byte characters (such as English alphanumeric) or double-byte characters (such as Kanji).
• The URL can contain up to 256 bytes of data, excluding blanks. (For double-byte data, the 256-byte maximum includes all shift-in and shift-out characters, as well as the double-byte characters.) All blanks including leading and trailing blanks are deleted.
• The URL can span multiple 80-byte records. Data must continue up to and including column 72 and begin in column 1 of the next line. All data past column 72 is ignored, including blanks. The break does not translate to a blank.
• The URL cannot be only blanks.
• If parentheses are included in the text, they must be in matched pairs.

VENDOR

specifies the name of the vendor supplying the product.

• The VENDOR can be in single-byte characters (such as English alphanumeric) or double-byte characters (such as Kanji).
• The VENDOR can contain up to 64 bytes of data, including blanks. (For double-byte data, the 64-byte maximum includes all shift-in and shift-out characters, as well as the double-byte characters.) Extra blanks as well as leading and trailing blanks are deleted.
• The VENDOR can span multiple 80-byte records. Data must continue up to and including column 72 and begin in column 1 of the next line. All data past column 72 is ignored. The break does not translate to a blank unless a blank is explicitly coded in column 72 of the first line or in column 1 of the second line.
• The VENDOR cannot be only blanks.
• If parentheses are included in the text, they must be in matched pairs.

REWORK

is the level of this ++PRODUCT MCS, which was reworked for minor changes. Up to eight numeric characters can be specified.

REWORK is generally used only for ++PRODUCT statements supplied by IBM that have been reworked for minor changes. For these ++PRODUCT statements, the REWORK level is yyyyddd, which is the year followed by the Julian date (for example, 2008110).

REWORK allows an updated ++PRODUCT MCS to be automatically received again, as long as it is more recent than the version that has already been received. This takes the place of rejecting the ++PRODUCT MCS and receiving it again.

Note: If a ++PRODUCT MCS appears more than once in the SMPPTFIN data set, the first occurrence may be received. However, none of the subsequent versions of the ++PRODUCT MCS are received, even if their rework level is higher than the one for the first version of the ++PRODUCT MCS.

Usage notes

• The ++PRODUCT statements are processed whenever the SMPPTFIN data set is processed. This is true whether only selected SYSMODs are being processed or the entire SMPPTFIN data set is being processed.

  ++PRODUCT statements are not processed when only the SMPHOLD data set is being processed.

• The prodid, vv.rr.mm, DESCRIPTION, and SREL values are required and cannot be blank or null.
• The ++PRODUCT MCS is used in the SMPPTFIN data set and can be placed between, before, or after SYSMODs, ++FEATURE MCS, or ++PRODUCT MCS. It must be followed by one of the following: a ++APAR, ++ASSIGN MCS, ++FEATURE MCS, ++FUNCTION, ++PTF, ++USERMOD, another ++PRODUCT MCS, or an end-of-file. If one of these does not follow, SMP/E does not receive the SYSMOD being processed and it skips the ++PRODUCT MCS.

Example

++PRODUCT(5647-A01,2.5.0)       /* Product definition */
  DESCRIPTION(OS/390)                 /* Description  */
  URL(http://www.S390.ibm.com/os390/) /* URL          */
  SREL(Z038)                          /* SREL value   */
  PRODSUP((5645-001,01.04.00))        /* Product sups */
  VENDOR(IBM)                      /* Product Vendor */.