IBM United States
Software Announcement 203-125
May 13, 2003
IBM SMP/E for z/OS and OS/390 V3.2 Simplifies Software Installation and Maintenance
At a Glance
SMP/E V3.2 is designed to provide the following enhancements for this release:
For ordering, contact:
Your IBM representative, an IBM Business Partner, or the Americas Call Centers at 800-IBM-CALL (Reference: LE001).
SMP/E is the software installation and maintenance tool for the z/OS, z/OS.e, and OS/390® platforms. It also maintains an inventory of the installed software and service.
SMP/E V3.2 is available under its own product number and also remains a base element of z/OS and z/OS.e. This allows customers who are licensed for a currently supported release of z/OS, z/OS.e, or OS/390 to order and install the latest release of SMP/E without upgrading their entire operating system. The advantage is that with products other than z/OS, z/OS.e, and OS/390 you can exploit the packaging and installation enhancements in SMP/E without having to install the prerequisites for a new level of the operating system.
In addition, since SMP/E plays a key role in Internet delivery of software, it allows IBM to exploit the Internet delivery and installation technologies in SMP/E sooner without having to wait for customers to migrate to new levels of the operating system. SMP/E V3.2 is available at no additional charge to customers. It is intended for customers who have a license for OS/390 V2.10 (5647-A01) or z/OS V1.1 (5694-A01) and above, or z/OS.e V1.3 (5655-G52) and above.
SMP/E V3.2 runs on:
SMP/E V3.2 contains the following functional enhancements:
More efficient use of the SMPLTS Data Set
In prior releases of SMP/E, the SMPLTS data set was very large because it was used to store copies of all load modules that have a CALLLIBS subentry (load modules that exploit the link edit autocall facility). In SMP/E V3.2, the SMPLTS data set will be used only to store permanent copies of load modules that both use CALLLIBS and contain cross-zone modules. If a load module uses CALLLIBS but does not contain any cross-zone modules, SMP/E is designed to rebuild the load module from scratch during link edit operations, rather than saving a version of the load module in the SMPLTS data set. The result is a much smaller, or possibly empty, SMPLTS data set. SMP/E will delete unneeded load modules from the SMPLTS data set during APPLY, RESTORE, and CLEANUP command processing. However, because such an SMPLTS data set will not be compatible with prior releases of SMP/E, this cleanup of existing load modules will occur only after you use the new UPGRADE command to indicate your desire to exploit new functions.
LINK LMODS Command
The LINK LMODS command replaces the REPORT CALLLIBS command. The LINK LMODS command is designed to provide all of the functions of the REPORT CALLLIBS command with additional benefits. The LINK LMODS command refreshes the content of the load modules by rebuilding them from scratch. Any load module may be specified by name or you can use the CALLLIBS operand to refresh only load modules that have a dependency on particular CALLLIBS. The LINK LMODS command will perform the link edit operations directly for the load modules, instead of producing a JCL job to perform the link edit operations. In addition, SMP/E will attempt recovery from out-of-space conditions encountered during those link edit operations.
New releases of SMP/E must sometimes make changes to SMP/E data sets that cannot be properly processed by prior SMP/E releases. SMP/E usually makes incompatible changes only when necessary to provide new and improved capabilities. For example, a new type of element requires a new entry type in SMPCSI data sets and these new entry types are typically not understood or processed correctly by SMP/E levels that have not been specifically updated to do so. The UPGRADE command is designed to allow you to specify when SMP/E is permitted to make incompatible changes to SMP/E data sets. SMP/E will continue to use processing that is compatible with prior releases until you use the UPGRADE command. This, in turn, can allow you to make the trade-off between exploiting new SMP/E functions and preserving compatibility with prior SMP/E releases.
Java Archive (JAR) File Installation Support
The JAR file format is based on the popular ZIP file format and is used for aggregating many files into one. Although JAR can be used as a general archiving tool, the primary motivation for its development was to allow Java applets and their requisite components (.class files, images, and sounds) to be downloaded to a browser in a single HTTP transaction, instead of opening a new connection for each piece. This can greatly improve the speed with which an applet can be loaded onto a Web page and start functioning. The JAR format also supports compression, which can help reduce the size of the file and further improve download time. These attributes make the JAR file format the preferred method of bundling Java applets and applications.
Fundamental operations on a JAR file are performed using the Java Archive Tool provided as part of the Java Development Kit (JDK). The Java Archive Tool is invoked using the JAR command. The JAR command is used to create JAR files, view and extract the contents of JAR files, and update the contents of JAR files. To update the contents of a JAR file means to replace a subset of the files within the archive, add additional files to the archive, or both.
SMP/E has introduced new element types to describe JAR files and SMP/E will replace and update such files. The ++JAR element type is used to add and replace entire JAR files and the ++JARUPD element type is used to provide an update for a JAR file.
To update a JAR file, SMP/E will add or replace component files within a Java Archive, instead of replacing the entire Java Archive file. This can allow much smaller and more granular PTFs for products that use Java and JAR files. JAR files reside in directories within the UNIX® file system and SMP/E will use the Java jar command to update a JAR file when processing a ++JARUPD element.
Note: IBM Developer Kit for OS/390, Java Technology Edition (5655-D35) is required for SMP/E to perform JARUPD processing.
Internet Packaging Extensions
The GIMZIP service routine creates portable packages of software and related materials. These packages are used to deliver software over the Internet. In SMP/E V3.2, users have more control over the structure of GIMZIP packages.
Large archive files within GIMZIP packages may be divided into smaller segments. The GIMZIP service routine is now designed to enable you to specify (in megabytes) the maximum size of the portable objects that are produced. GIMZIP will then divide large archive files into multiple smaller physical files, thus helping to more efficiently perform network transport and retry operations on the packages.
In addition, subdirectories can be specified in which to group and store documentation, samples, readme files, and other types of data within GIMZIP packages. The subdirectory is created in a hierarchical file system within the package directory specified on the SMPDIR DD statement. This allows users to organize these items to suit their needs, thereby enhancing the usability of the GIMUNZIP service routine and the RECEIVE FROMNETWORK command. The RECEIVE FROMNETWORK and FROMNTS commands, as well as the GIMUNZIP Service Routine, have been updated to support processing of packages with segmented archive files and subdirectories that may be produced by GIMZIP.
Allow Dummy SYSDEFSD Data Set
During link edit operations, the SYSDEFSD DD statement defines the location for the program binder to write IMPORT statements for all exported symbols of a DLL load module. Whenever symbols are to be exported, the program binder expects the SYSDEFSD data set, and if it is not present, it will issue a warning message (return code four) indicating the missing dataset.
Product developers who supply DLLs do not always want or need retention of the IMPORT statements associated with a DLL. However, to receive a return code of zero from the program binder during SMP/E installation, the developer is required to provide a SYSDEFSD data set. In these instances, the IMPORT statements are not wanted, and SYSDEFSD would be better defined as either a temporary or DUMMY data set.
SMP/E is defining a new ddname called SMPDUMMY which is designed to always be allocated as "DD DUMMY." The product developer may now specify the SYSDEFSD DD statement in the JCLIN input stream as any of the following:
In each case, the SIDE DECK LIBRARY subentry of the LMOD entry will be set to SMPDUMMY. When needed for processing, SMPDUMMY will be dynamically allocated by SMP/E as a DUMMY data set.
Easier SMP/E Dialog Customization
SMP/E is now designed to provide a new, easier method for customizing the SMP/E dialog panels. Instead of modifying panel GIM@UPRM (as was done previously), you may now use the SETTINGS option on the SMP/E Primary Option Menu, GIM@PRIM, to enter or change the values for the dialog customization options. The options that you specify affect how JCL jobs are generated and how temporary and permanent data sets are allocated by the dialogs. These options will be saved permanently in the user profile data set for later use by other SMP/E dialog processes. If you migrate to a new release of SMP/E and continue to use the same ISPF profile data set (as is usually the case), then no migration actions are required to use the options previously entered and saved.
SMP/E will no longer support customization using the GIM@UPRM mechanism. All dialog customization formerly specified on panel GIM@UPRM must now be specified using the new SETTINGS option.
New Data Collection Routine for ShopzSeries (GIMXSID)
The GIMXSID service routine is used as part of the ShopzSeries offering. GIMXSID creates a single data source required by ShopzSeries to place customized software product and service orders. The data source created by GIMXSID, the software inventory data, is a composite of these three types of information:
Internet Download Availability
SMP/E V3.2 is available on the Internet for download on the same general availability date. Customers who download SMP/E are expected to have an existing license for OS/390, z/OS, or z/OS.e. SMP/E V3.2 replaces the existing SMP/E V3.1 on the download site and can be obtained at:
Order SMP/E via the Internet
ShopzSeries (formerly SHOPS390) provides an easy way to plan and order SMP/E via CBPDO (or in a ServerPac). It will analyze your current installation, determine the correct product migration, and present your new configuration based on z/OS. Additional products can also be added to your order (including determination of whether all product requisites are satisfied).
ShopzSeries is available in the U.S. and several countries in Europe. In countries where ShopzSeries is not available yet, contact your IBM representative (or Business Partner) to handle your order via the traditional IBM ordering process.
For more details and availability, visit the ShopzSeries Web site at:
z/OS Service through the Internet: Effective March 29, 2002, IBM Service is available through ShopzSeries as an Internet-based, strategic software tool. Through Service in ShopzSeries, customers can quickly and easily order and receive corrective or preventive service electronically over the Internet or by standard physical media. For preventive service, customers can order just critical service (HIPERs and PTFs that resolve PE PTFs), the latest recommended service (which includes all critical service), or all available service. Service in ShopzSeries reduces customers' research time and effort by using their uploaded SMP/E Consolidated Software Inventory (CSI) so that all applicable service, including reachahead service, for the installed FMIDs in the target zones is selected. ShopzSeries also uses the CSI information to limit the size of the service order, sending applicable service that has not already been processed by SMP/E. IBM Technical Support is available through RETAIN® for problems and Q&A.
For more details, visit the ShopzSeries Web site at:
Hardware and Software Support Services
IBM Global Services provides a number of remote and on-site IBM SmoothStart Services, Operational Support Services, Migration Services, and Installation Services designed to accelerate your productive use of your IBM solution. These services are provided by IBM Global Services or your IBM Business Partner at an additional charge. For additional information, contact your IBM representative and ask for IGS Services for z/OS or z/OS.e.
SMP/E education is part of OS/390® and z/OS education.
The following worldwide courses are available for classroom delivery:
In the United States and Canada call 800-IBM-TEACH (426-8322) to enroll in one or more of these classes.
Specified Operating Environment
SMP/E V3.2 runs in the same operating environments required by OS/390 V2.10, z/OS V1.1 and higher, and z/OS.e V1.3 and higher.
To use the SMP/E RECEIVE FROMNETWORK function, SMP/E requires that (ICSF) is operational (refer to
section below), which requires either the Integrated Cryptographic Feature or the Cryptographic
Coprocessor Feature of the processor.
ICSF, part of the z/OS, z/OS.e, and OS/390 base element Cryptographic Services, is a functional requisite to use SMP/E RECEIVE FROMNETWORK feature and the GIMZIP packaging service routine. ICSF is not required for installation of SMP/E, but is needed at run time to use this SMP/E function. An operational ICSF is also needed to use GIMZIP and may be needed to use GIMUNZIP depending on the execution parameters used when invoking GIMUNZIP.
Compatibility: SMP/E V3.2 runs on OS/390 V2.10, z/OS V1.1 or higher, and z/OS.e V1.3 or higher. The new UPGRADE command allows you to determine when and if incompatible changes should be made to SMP/E data sets. If the UPGRADE command is run, then SMP/E V3.2 should be used to process the SMP/E data sets affected by that command from then on. Such data sets may not be processed correctly by previous releases of SMP/E.
SMP/E data sets created and processed by earlier levels of SMP/E can be processed properly by SMP/E V3.2.
The following PTFs prevent corruption of SMPCSI data sets and provide some coexistence support when such data sets are processed by both SMP/E V3.1 and prior levels of SMP/E (OS/390 V2.10 through z/OS V1.4 and z/OS.e V1.4).
ServerPac SMP/E support: ServerPac orders are built using either a default level of SMP/E or the lowest supported level of SMP/E that is required for the products in your order. The higher of these two SMP/E levels is used. For example, z/OS orders are built with the level of z/OS SMP/E provided in that release of z/OS. However, if your order also includes SMP/E 3.2 (5655-G44), then your order is built with this higher level. Subsystem orders are built with OS/390 V2.10 SMP/E, unless a product in your order has a dependency on a higher level of SMP/E. Your subsystem order would then be built with the minimum level of SMP/E that satisfies the requirement.
The level of SMP/E used to build your order is documented in ServerPac Installing Your Order .
Additionally, the Customized Offerings Driver, 5665-343, which is a subset of an OS/390 V2.10 system, is updated to include SMP/E V3.2 (5655-G44) and additional service.
Security, Auditability, and Control
Current licensees of SMP/E for z/OS and OS/390 V3.1 can migrate to SMP/E for z/OS and OS/390 V3.2 by
ordering the release through the Customized Offerings (CBPDO, ServerPac, SystemPac, ProductPac) as
done in the past.
Shipment will not occur before the availability date.
The SMP/E product is only shipped via Customized Offerings (CBPDO, ServerPac, SystemPac and ProductPac). Non-customized items (for example, CD-ROMs) will continue to be shipped via the stand-alone product.
Production of SMP/E V3.2 orders will begin on the general availability date, May 30, 2003 . Shipment dates for orders will be based on order sequence, Customized Offering selected, production capability, and customer-requested arrival date. Due to the amount of customization of ServerPac orders, shipments will begin approximately two weeks after general availability. Due to the amount of additional customization of SystemPac orders, shipments will begin approximately four weeks after order and data input verification. For CBPDO orders, shipments will begin one week after general availability. In all cases, no delivery commitments are to be made to the customer until confirmed arrival dates are in ESW.
Description Distribution Medium SMP/E V3.2 Base * Refer to notes
Notes: This product is available in customized offerings only. The media type is chosen during the customized offering ordering procedure.
Description Distribution Medium SMP/E V3.2 Japanese Base * Refer to note
A memo and Program Directory are automatically supplied with the basic machine-readable material.
Order Title Number SMP/E Version 3 for z/OS and SK3T-4323 OS/390 Product Library
For a fee, you can purchase additional copies of the product library CD-ROM using the IBM Publications Center on the World Wide Web at:
The SMP/E Version 3 for z/OS and OS/390 Product Library contains the SMP/E Version 3 product books for both BookManager® and PDF softcopy formats on CD-ROM. By general availability, the SMP/E Version 3 books will also be available at:
For those customers who want to upload BookManager softcopy and create softcopy repositories, the SoftCopy Librarian is our strategic tool for uploading and managing BookManager files on a z/OS or OS/390 host or server, as well as on LANs and workstations. SoftCopy Librarian, a free program that is provided with the CD collections, also provides you with management functions for your bookshelves and book files.
SoftCopy Librarian runs on Windows® 95 or later and Windows NT® 4.0 or later. The latest versions of the Softcopy Librarian can be downloaded from the following site:
A Program directory and a CD-ROM, SMP/E Version 3 for z/OS and OS/390 Product Library , (SK3T-4323) are supplied automatically as part of the basic package.
The CD-ROM includes the following softcopy publications:
Order Title Number IBM SMP/E for z/OS and OS/390 Messages, Codes and Diagnosis GA22-7770 IBM SMP/E for z/OS and OS/390 SA22-7771 Commands IBM SMP/E for z/OS and OS/390 SA22-7772 Reference IBM SMP/E for z/OS and OS/390 User's SA22-7773 Guide IBM SMP/E for z/OS and OS/390 Licensed Programming Specifications GI10-0681
This product's executable code is available via Customized Offerings (CBPDO, ServerPac, SystemPac and ProductPac). Non-customized items (CD-ROM) will continue to be shipped via the stand-alone product.
The charges for SMP/E V3.2 are unaffected by this announcement.
IBM Global Financing offers competitive financing to credit-qualified customers to assist them in acquiring IT solutions. Our offerings include financing for IT acquisition, including hardware, software, and services, both from IBM and other manufacturers or vendors. Offerings (for all customer segments: small, medium, and large enterprise), rates, terms, and availability can vary by country. Contact your local IBM Global Financing organization or visit the Web at:
To order, contact the Americas Call Centers, your local IBM representative, or your IBM Business Partner.
To identify your local IBM representative or IBM Business Partner, call 800-IBM-4YOU (426-4968).
Phone: 800-IBM-CALL (426-2255) Fax: 800-2IBM-FAX (242-6329) Internet: email@example.com Mail: The Americas Call Centers Dept. LE001 P.O. Box 2690 Atlanta, GA 30301-2690 Reference: LE001
The Americas Call Centers, our national direct marketing organization, can add your name to the mailing list for catalogs of IBM products.
Note: Shipments will begin after the planned availability date.