Welcome to the ServerPac Installation using z/OSMF content solution, your homepage for technical resources.
Announced! Updated plans for data set merge function in z/OSMF Software Management and ServerPac CustomPac dialog removal
In order to have ServerPac installed with z/OSMF Software Management, you should have z/OSMF up and running on at least one system. Therefore, z/OSMF Software Management is a driving system requirement.
In order to install ServerPac using z/OSMF, you must first ensure that you have z/OSMF properly configured and are granted the necessary authorization to use it.
For a new installation of z/OSMF, it is recommended that you begin by creating a base configuration. If you are installing z/OSMF for the first time. please begin by clicking the link below and following the directions listed.
If you are upgrading from a previous release of z/OSMF, perform the upgrade actions for z/OSMF.
In addition to z/OSMF, you must also have the Software Management plugin activated and the authority to use both Software Management and Workflows.
Beyond plugins and authority, you must also have certain PTFs installed on your system used to drive the installation actions (the system where the z/OSMF server is running). These PTFs are identified by SMP/E Fix Category IBM.DrivingSystem-RequiredService. To determine if you are missing any of the required PTFs, follow these steps:
Obtain the latest HOLDDATA
Obtain the latest HOLDDATA from IBM using your preferred method and receive it into the SMP/E global zone for your driving system. The HOLDDATA contains information to associate fix categories to PTFs.
Run the SMP/E REPORT MISSINGFIX command
The SMP/E REPORT MISSINGFIX command identifies PTFs associated with fix categories that are not yet installed. Run the REPORT MISSINGFIX command like this:
REPORT MISSINGFIX ZONES(ZOS24)
Specify the target zone name for your driving system on the ZONES operand. If any PTFs are identified in the report, they are missing. That is, they are required for installing a ServerPac Portable Software Instance but are not yet installed. You must install them before installing a ServerPac Portable Software Instance.
When ordering your ServerPac in Shopz, you will have the option to choose an installation method: z/OSMF Software Management or ServerPac ISPF Dialog. This option is now available for all IBM products found in Shopz, except for z/OS V2.4. By selecting the z/OSMF Software Management installation method, you are taking a step towards a consistent package format for all future ServerPacs.
ServerPac is orderable from Shopz. To submit an order for a ServerPac using z/OSMF, select the Installation Method of z/OSMF SW Management from the drop-down menu.
- Begin the order process at Shopz
- Proceed through Steps 1 - 6 of the order process as usual
- Step 7 requires you to choose both a delivery and an installation method. For Installation method, select z/OSMF Software Management for a ServerPac in portable software instance format.
- Continue through the remainder of the order process as usual.
For ServerPac orders that are delivered in portable software instance format, you will use z/OSMF Software Management to acquire the files. The eletronic delivery method are ones that you are already using, and you can continue to use with a ServerPac portable software instance. There are two download options for ServerPac in portable software instance format
The download option you select will depend on whether you have direct connection to an IBM download server.
You need to have acquired it through z/OSMF in order to deploy it.
If you currently download software orders from IBM’s download server direct to your z/OS System, you can continue to do so for a portable software instance. On the Software Management Portable Software Instance page, choose Actions --> Add --> From Download Server.
As you have done before, the Shopz download page for your order will contain information necessary to add your portable software instance with z/OSMF.
If you currently download software orders from IBM’s download server to your workstation and subsequently upload them to a z/OS System, you can continue to do so for a portable software instance. Do the following:
- On the Shopz download page for your order, use Download to your workstation using IBM Download Director to download the files from the IBM server to your workstation.
- On the Software Management Portable Software Instance page, choose Actions --> Add --> From Local Workstation to upload the files from your workstation to z/OS.
A Software Management task deployment is a checklist that guides you through the software deployment process, and it is the object in which z/OSMF stores your input and any output generated for each step in the checklist. Deployment is the process you use to install your z/OSMF Portable Software Instance.
When the deployment is complete, your software will be installed, configured, and verified. The configuration and verification will be accomplished with z/OSMF workflows, provided with the portable software instance, performed during the deployment operation.
To try it yourself, install a sample z/OSMF Portable Software Instance onto your system by using the demo package below. By installing this sample, you can help verify your z/OSMF configuration and learn the steps to download and deploy a z/OSMF Portable Software Instance.
You can use z/OSMF Software Management to download the sample Portable Software Instance directly to your z/OS host, or you can download the Portable Software Instance to your workstation and then use z/OSMF Software Management to upload it from your workstation to your z/OS host.
Watch the tutorial series for step-by-step instructions on how to download and install software onto z/OS using z/OSMF Software Management. This series provides an end-to-end walkthrough, from gaining access to a Portable Software Instance to finishing the deployment.
Q: What is a ServerPac?
A: A ServerPac is a product upgrade or system replacement package where IBM performs the SMP/E install (RECEIVE, APPLY, ACCEPT) of the products and installs service in your order. The latest Recommended Service Upgrade (RSU) level and all HIPER and PRP service available approximately one day before your order is built will be installed for the products included in your order. The resulting target libraries, distribution libraries, and the SMP/E environment are delivered in the order package. During the ServerPac installation, you configure your installation to map to your environment, such as data set naming, data set placement, catalog specification, etc. The Shopz ordering checklist for ServerPac is refreshed monthly to add/withdraw product support; therefore products are typically supported within a month of their General Availability (GA).
Additionally, ServerPacs can be delivered in Portable Software Instance (PSWI) format that are deployed using z/OSMF Software Management and workflows.
Q: I see that z/OS V2.5 will be installable as a z/OSMF ServerPac (also know as a portable software instance). Can I order z/OS V2.4 as a z/OSMF ServerPac?
A: No. z/OS V2.5 will be available as a z/OSMF ServerPac, but z/OS V2.4 will not be a z/OSMF ServerPac. In fact, no Z038 SREL product is available as a z/OSMF ServerPac, until the general availability of z/OS V2.5 (planned for September 2021).
For example, before z/OS V2.5 is generally available,
Q: Must I get z/OS V2.5 as a z/OSMF ServerPac?
If you order z/OS V2.5 (or
Today, CICS, Db2, IMS, and z/OS V2.5 are available as a ServerPac which can install either as a CustomPac ISPF dialog or z/OSMF. You have a choice to install either ServerPac before the discontinuance of the CustomPac ISPF dialog, which is planned to be announced in 2Q 2022. IBM encourages you to select z/OSMF as that will be the only ServerPac option available after CustomPac dialog is removed. This is also a great way to learn how to install a z/OSMF portable software instance if you have not done already.
For z/OS V2.5 (and the rest of the Z038 SREL, like
Q: What will happen to the Shopz ServerPac CustomPac Installation Dialog method, after the date included in the 2Q 2022 announcement?
The CustomPac Installation Dialog method for ServerPac will be removed across the Shopz ServerPac catalog, leaving only the z/OSMF ServerPac as the sole ServerPac choice. CBPDO is not being removed. Remember, though, CBPDO may be harder to install for a product as large as z/OS V2.5. If you've always preferred doing a CBPDO for
Q: Why was the CustomPac ISPF dialog extended in Shopz from January 2022 until a date that will be provided in 2Q2022?
A: In order to ensure that those customers who must have the ability to perform data set merges during the installation of z/OS V2.5, we decided that the CustomPac ISPF dialog must be extended beyond the originally planned January 2022 date. Meaning, because some customers need to perform data set merges during the installation of z/OS V2.5, the CustomPac ISPF dialog will still be available and will provide that necessary function until data set merge becomes available in z/OSMF Software Management.
When the CustomPac ISPF dialog is removed depends on two things:
- The z/OSMF Software Management function itself needs to deliver the data set merge capability in APAR PH42028.
- Then, your z/OSMF portable software instance can be created with this data set merge capability integrated into your Shopz order.
For the first dependency, APAR PH42028 is planned to be available in April 2022. Moving to the second dependency, that capability will be announced in the 2Q 2022 Announcement. It is not anticipated that it would be long after the 2Q 2022 Announcement that the CustomPac ISPF dialog installation method will be discontinued. For this reason, it is most prudent to not plan on having CustomPac ISPF dialog as a Shopz option after 2Q 2022. By preparing now, and anticipating that the installation of z/OS V2.5 after 2Q22 will likely only be with z/OSMF, removal of the CustomPac Dialog installation method may not impact you.
Q: What is the high level flow of installing a z/OSMF ServerPac?
- Open z/OSMF Software Management
- Go to Portable Software Instance --> Add
- Go to Deployment and complete the Deployment Steps, including Perform Workflows for the first 2 workflows
- Once complete, IPL your target system
- Go back to the Deployment Checklist to the Perform Workflows step and do the third workflow
Q: What are the driving system requirements for z/OS V2.5, as a z/OSMF ServerPac?
A: The requirements are provided in the z/OS V2.5 Planning for Installation book, but you can also find the list on this website z/OSMF ServerPac Overview found above.
Q: What if I can't get z/OSMF active on my driving system before I have to install z/OS V2.5?
A: If you can't get z/OSMF active on your driving system, then you can get a Customized Offerings Driver (COD). Remember, z/OSMF automatically starts when IPLing z/OS V2.3, and the z/OSMF quick start instructions help to get just the minimum driving system activated. At z/OS V2.5 GA, the COD will have z/OSMF active and will be able to install a z/OS V2.5 z/OSMF ServerPac.
Q: If I install z/OS as a z/OSMF ServerPac, what will the resulting system look like? Can I still use my local deployment tools on it?
A: It will look exactly like what you had when you installed z/OS as a ServerPac for CustomPac Dialog. You will have SMP/E CSIs, you will have target libraries, you will have DLIBs, you will have sample libraries. You will have run batch jobs (from a workflow) which did configuration of the products you ordered. You will have full access to do SMP/E maintenance on the resulting system. Just as a ServerPac fits into your existing enterprise's environment, this z/OS portable software instance will also fit into your environment. Your existing deployment tooling should be able to be used, as is. IBM recommends that you consider using the deployment function in z/OSMF Software Management for subsequent deployments into your enterprise.
Q: If I install z/OS V2.5 with a z/OSMF ServerPac, must I use z/OSMF Software Update to install PTFs on it?
A: No. You can use the SMP/E batch JCL jobs you've always used for z/OS. Of course, IBM recommends that you try to use z/OSMF Software Update, though, to see if that simplified method of service installation is beneficial to you (see z/OSMF Software Update). We do welcome feedback and we have several customer requirements which we know we need to do for z/OSMF Software Update, so keep an eye out for future new function in z/OSMF Software Update.
Q: I am looking to make my z/OSMF portable software instance install simpler. Am I able to save a previous configuration and merge it forward?
A: Yes! If you have a software instance that is similar to the portable software instance you are installing, then you can model after it during deployment. This will bring forward to your new software instance configuration information you had specified previously. This will save you a lot of time, as your prior customization information, such as data set names and volume placement will be re-used. Of course, any changes you'd like make to that configuration are still able to be done.
Let's look at a specific example. If you are installing a z/OS V2.5 z/OSMF portable software instance, and you wanted to model it after your existing z/OS V2.4, you would define your existing z/OS V2.4 system as a z/OSMF software instance (Software Instance -> Actions -> Add). Then, when installing your z/OS V2.5 z/OSMF portable software instance, you would use the Model function (Deploy -> Configure -> Model -> An existing software instance).
Q: What configuration and verification assistance is provided when deploying a z/OS portable software instance
A: Just as with a CustomPac ServerPac installation, configuration and verification assistance is provided. For the CustomPac ServerPac installation, that assistance was provided in JCL jobs that you submit. For a z/OSMF ServerPac (which is a portable software instance) those configuration and verification steps have been included in two z/OSMF workflows for you: POSTDEPLOY and VERIFY. There is another workflow (YOURORDER) which contains useful information on your specific order, but does not contain configuration or verification steps.
Q: Where will the steps in the ServerPac-supplied POSTDEPLOY and VERIFY Workflows run?
A: During the Perform Workflows step of the z/OS portable software instance deployment, the POSTDEPLOY Workflow will perform any configuration tasks you will need for the products in your portable software instance. This workflow will be run from your driving system prior to the first IPL of z/OS.
The VERIFY Workflow will perform the verification steps to ensure that your products were installed and configured correctly. The VERIFY Workflow should be run after your z/OS system is IPLed, on the target system.
Q: During the Perform Workflows step of the z/OS portable software instance deployment, in the POSTDEPLOY Workflow, the first step is called 'Collect Configuration Options'. What does the 'Installation Type' mean, and which option should I select?
The 'Installation Type' identifies which operational data sets you will use for z/OS. Operational data sets must be provided for a first successful IPL of z/OS, and include
'Create new operational data sets for an IPLable standalone system'
When you allow IBM to create a set of operational data sets for you, you are assured of having a successful first IPL. When you select this option, new operational data sets will be created for you. The steps to do this are provided in this workflow and are marked with a state of Ready, and the step title begins with “(Optional)”. By performing each of these steps, you will be provided with a complete set of operational data sets for the first IPL of z/OS. If you choose not to run a particular step identified as “Optional”, that operational data set will not be provided for your first IPL os z/OS.
'Use existing operational data sets. You must update them prior to IPLing the new system'
Use this option when you wish to provide your own operational data sets for the first IPL of z/OS. You will be responsible for ensuring that these operational data sets are adequate for the z/OS system you IPL. When selecting this option, the steps that provide new operational data sets are marked with a state of Skipped, and the step title begins with '(Optional)'. You may still decide to run a Skipped step if you desire to create that specific operational data set from the workflow.
Q: Does this mean that the IPL'd z/OS target system should have z/OSMF active, or be part of a sysplex that has z/OSMF active?
A: Either. From the Perform Workflows step of the z/OS portable software instance deployment, when you create the VERIFY Workflow instance, you will be prompted to provide the “System (where the workflow steps will be performed)”. Here, the active target system should be specified - ensuring that system has z/OSMF up and running or is within a sysplex that has z/OSMF active, so the verification steps in the workflow can be run. Note that the target system needs to be known from the driving system's z/OSMF Systems definition for the VERIFY Workflow instance to be created. For information on how this is done, consult the z/OSMF Configuration Guide. Also, note that as of z/OS V2.3, z/OSMF automatically starts at IPL time.
Learn more about how ServerPac Installation using z/OSMF will streamline software management.
This video series provides an end-to-end walkthrough, from gaining access to a Portable Software Instance to finishing the deployment.
See an overview of how a single install method within z/OSMF can help system programmers manage software more consistently and be productive more quickly.
The link to the announcement was updated to show the z/OS V2.5 2Q 2022 enhancements.
Transcript added for ServerPac Installation using z/OSMF overview video.
The link for ServerPac Installation Using IBM z/OS Management Facility Streamlines Software Management, on the Other resources tab in the Technical resources section, was updated to find the article on the new IBM Z Hot Topics website.
Added tutorial videos for ServerPac Installation.
Added a new link for a Hot Topics article in the Technical resources section.
z/OSMF Portable Software Instance Demo added to the Try It tab of the Getting started section.
An intro video was added to the top of the page and the Multimedia tab of the Resources section.