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

 ENUS203-125.PDF (43KB)


At a Glance

SMP/E V3.2 is designed to provide the following enhancements for this release:

  • Substantial reduction in the amount of space required for the SMPLTS data set.
  • The new LINK LMODS command is used to refresh the contents of load modules and to replace the REPORT CALLLIBS command.
  • The new UPGRADE command allows you to indicate when SMP/E is permitted to make incompatible changes to SMP/E data sets.
  • Java™ Archive (JAR) file installation support with full replacement and update capabilities.
  • New data collection routine for ShopzSeries orders.
  • Internet packaging enhancements allow more control over the directory structure of Internet packages, and of the maximum size of archive files within Internet packages created by GIMZIP service routine.
  • The SYSDEFSD library can be allocated to "DD DUMMY" when performing link edit operations on DLLs.
  • Easier SMP/E dialog customization.

For ordering, contact:

Your IBM representative, an IBM Business Partner, or the Americas Call Centers at 800-IBM-CALL (Reference: LE001).

Overview

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.

Key Prerequisites

SMP/E V3.2 runs on:

  • OS/390 V2.10, or higher
  • z/OS.e V1.3, or higher
  • z/OS V1.1, or higher

Planned Availability Date

May 30, 2003

Description

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.

UPGRADE Command

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:

  • //SYSDEFSD DD DSN=SMPDUMMY,DISP=xxx
  • //SYSDEFSD DD DSN=NULLFILE
  • //SYSDEFSD DD DUMMY

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:

  1. A list of FEATUREs found in the SMPCSI data sets is used by ShopzSeries to perform product requisite checking and also to prime the order checklist when a ServerPac is ordered.
  2. A list of FMIDs found in the SMPCSI data sets is used by ShopzSeries to scope service orders to the PTFs applicable solely to the user's desired configuration of target and global zones.
  3. A bitmap representation of the PTFs found in the specified target zones and global zones is used by ShopzSeries to produce service packages that do not contain PTFs already present in the user's configuration.

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

SmoothStart™/Installation 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.

Reference Information

  • Software Announcement 201-257 , dated September 11, 2001
  • Software Announcement 202-197 , dated August 13, 2002
  • Software Announcement 202-191 , dated August 13, 2002
  • Software Announcement 200-145 , dated May 16, 2000

Trademarks

 
z/OS and SmoothStart are trademarks of International Business Machines Corporation in the United States or other countries or both.
 
OS/390 and RETAIN are registered trademarks of International Business Machines Corporation in the United States or other countries or both.
 
Java is a trademark of Sun Microsystems, Inc.
 
UNIX is a registered trademark of the Open Company in the United States and other countries.
 
Other company, product, and service names may be trademarks or service marks of others.

Education Support

SMP/E education is part of OS/390® and z/OS™ education.

The following worldwide courses are available for classroom delivery:

  • Introduction to z/OS and OS/390 Environment (ES05)
  • Fundamental System Skills for z/OS and OS/390 (ES10)
  • z/OS and OS/390 Facilities (ES15)
  • z/Architecture™ for zSeries™ (OZ09)
  • Migration to Parallel Sysplex® for zSeries (OZ40)

In the United States and Canada call 800-IBM-TEACH (426-8322) to enroll in one or more of these classes.

To enroll in one or more of these classes, call your local IBM education center.

Technical Information

Specified Operating Environment

Hardware Requirements

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 the Software Requirements section below), which requires either the Integrated Cryptographic Feature or the Cryptographic Coprocessor Feature of the processor.

Software Requirements

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

  • OS/390 V2.10 and z/OS V1.1 — PTF UR53976
  • z/OS V1.2, R3, and R4 PTF — UR53977
  • z/OS.e V1.3 + R4 PTF — UR53977
  • SMP/E V3.1 PTF — UR53977

User Group Requirements: SMP/E V3.2 satisfies or partially satisfies recommendations from IBM customers and one or more of the worldwide user group communities.

  • 00022381 Enhance error isolation information
  • 00022378 Avoid SYSLIB allocation when not needed
  • 00014675 Require SYSLIB concatenation only if assemblies done
  • 00070141 Missing seq numbers in SMP/E CSECT delete processing
  • 00066957 Develop a means to manage size of the SMPLTS
  • 00063208 Automate CALLLIBS ran after APPLY or RESTORE
  • 00074061 Automate REPORT CALLLIBS process
  • MR0810016625 SMP/E msg GIM69012I does not give causing SYSMOD
  • MR0807002542 Automate REPORT CALLLIBS process
  • MR091902157 Include from SMPLTS during first link should be removed
  • MR0416014030 GIMXTRX should recognize and use PROCESS=WAIT as Parm
  • MR0410023620 Users running multiple levels of SMP/E including V3R1

Planning Information

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.

Withdrawal 6250 Media Support: 6250 is no longer a supported media for the Customized Offerings: CBPDO, ServerPac, RefreshPac, ProductPac®, FunctionPac® (EMEA only), and Systempac®.

Packaging: This product's executable code is not offered via standard stand-alone product media. It is available through the following customized offerings only:

  • CBPDO (Custom-Built Product Delivery Offering)
  • ServerPac
  • SystemPac
  • ProductPac

Security, Auditability, and Control

The customer is responsible for evaluation, selection, and implementation of security features, administrative procedures and appropriate controls in application systems and communication facilities.

Ordering Information

Current Licensees

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.

New Licensees

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.

Basic License: To order this product specify the 5655-G44 program number. Specify the feature number for Basic no-charge and then choose either Base or Japanese feature for distribution media.

Basic Machine-Readable Material

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.

Optional Machine-Readable Material: To order, select the feature number for the desired distribution medium:

Description                             Distribution Medium
 
SMP/E V3.2 Japanese Base                * Refer to note

Note: Media type is chosen during customized offering ordering procedure.

Basic Publications

A memo and Program Directory are automatically supplied with the basic machine-readable material.

Basic/Unlicensed Displayable Softcopy Publications: All SMP/E publications are provided on the following CD-ROM as part of the basic machine-readable material at no extra charge.

                                                            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:

and

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:

    ftp://ftp.software.ibm.com/ps/products/ibmreader/ tools/

Publications

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

Licensed Documentation: There are no licensed publications with this product.

Customized Offerings

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.

Terms and Conditions

IBM Operational Support Services — Support Line: Yes

Prices

The charges for SMP/E V3.2 are unaffected by this announcement.

If a replacement program is announced and the customer elects to license the replacement program for a OTC and replace the prior program, an upgrade charge may apply.

Global Financing

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:

Order Now

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:  ibm_direct@vnet.ibm.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.

Trademarks

 
z/OS, z/Architecture, and zSeries are trademarks of International Business Machines Corporation in the United States or other countries or both.
 
OS/390, Parallel Sysplex, FunctionPac, ProductPac, Systempac, RETAIN, and BookManager are registered trademarks of International Business Machines Corporation in the United States or other countries or both.
 
Windows and Windows NT are registered trademarks of Microsoft Corporation.
 
Requisite is a registered trademark of IBM Corporation and Rational Software Corporation, in the United States, other Countries or both.
 
Other company, product, and service names may be trademarks or service marks of others.