access level
Users of Shopz can have a variety of access levels. Your access level defines what tasks you are permitted to perform in Shopz. The possible access levels are:

• non-user
  When you first visit Shopz, you can view the product catalogs and online help, and can submit feedback and questions.
• unauthenticated user
  When you register for Shopz, you can immediately upload installed software reports for your systems and create and save real orders, but you will not be able to view hardware system, software license or shipping information for your customer numbers until you are authenticated. You will also be unable to submit your orders.
• authenticated user and submitter
  Once your account information has been verified, your user ID will be marked as an authenticated user or a submitter, and you will be notified via e-mail. As an authenticated user you will be able to view hardware system and software license information for your customer numbers. As a submitter you will also be permitted to submit orders. Typically you will be made a submitter, but sometimes users intend to use Shopz only for research purposes and prefer to be limited so that they do not accidentally submit an order.

APAR
Authorized Problem Analysis Report. A report of a defect in an IBM system control program or licensed program. An APAR fix is a temporary fix that is normally replaced by a PTF.

Automated delivery certificates
See package type.

CBPDO (products)
See package type.

cookie
Cookies are small bits of data that your Web browser stores on your computer at the request of Web applications like Shopz. Some Web applications require that you enable cookies in your browser preferences, but Shopz does not require this.

customer number
All IBM customers have at least one customer number. Multiple customer numbers are frequently used to manage software on different systems. When you register for Shopz you enter the customer numbers that you use to manage software. After registering, you can add and remove customer numbers by editing your preferences.

Customer numbers must be verified before you can view data related to them or order software for them.

Customized Offerings Driver
See package type.

Delivery media
Software orders can be delivered over the Internet or on DVD. When you place an order through Shopz, make sure you select a delivery media corresponding to the drives you have available. If your order is eligible for Internet delivery, then the Internet option will be included among your choices. For service orders, if you choose Internet delivery, you must also select an alternate delivery media, in case your order turns out to be too large to delivery over the Internet.

e-mail address
Your e-mail address is used to send you information regarding your Shopz profile and orders. Make sure you enter the address carefully. It should be an Internet style address, not a Lotus Notes (or other) style address. For example, gomer@mayberry.net.

FMID
Function Modification Identifier. A serviceable function of a z/OS software product, packaged in SMP/E installable format.

group
A collection of Shopz users within a company based on a set of customer numbers. A group is used to control the roles and authorities of the members of the group. It is also used to control various rules governing the use of Shopz for the company. To create a new group, contact your marketing representative.

group manager
A Shopz user who is authorized by his company to manage membership, rules and other details for a group belonging to his company. To become the group manager of a new group, contact your marketing representative. To become a group manager of an existing group, contact the group manager. The group manager is identified on the My preferences page.

group member
A Shopz user who is authorized by a group manager to perform tasks various Shopz tasks for a group. The specific tasks depend on the user's role or roles in the group. To join a group, go to the My preferences page, enter your customer numbers and click the Request Access button. Your request will be sent to the group manager.

group role
Roles are assigned to all members of a group. Each role allows the user to perform specific Shopz tasks. To request different group roles, contact your group manager. Your group manager is identified on the My preferences page.

HIPER/PE Fix
See service type.

IBM order number
When you submit an order with ShopzSeries, it is assigned an IBM order number. You can use this number to track the progress of your order through the IBM fulfillment systems.

installed software report
This report contains both installed product and installed service information, so using it will save you time. To produce this report you need to have a currently supported level of SMP/E installed. See SMP/E.

JavaScript
JavaScript^TM is a computer programming language which is used to control dynamic content within Web pages. Web browsers generally allow you to enable or disable JavaScript from their preference settings. Shopz requires it to be enabled.

license charge option
Indicates the payment frequency for a software license. For example,

• OTC (one time charge)
• MLC (monthly license charge)

license type
Indicates the rights associated with a software license (e.g. if the license entitles you to a free supply). Typical license types are:

• basic
• registration
• DSLO (distributed system license option)

manufacturing status
A corrective or preventive service order is assigned a manufacturing status as it is being processed by the service manufacturing system. It contains shipping information for physical orders as well as size and media information for both physical and Internet orders.

operating environment
When you create an order with Shopz, you need to specify which operating environment the software will run in. The operating environments include z/OS, z/VM and z/VSE. For each operating environment a different set of package types can be ordered. See package type.

order name
When you create an order with Shopz, a default name is assigned. You can change this name to something that will help you identify the order.

order reference number
When you create an order with Shopz, it is assigned an order reference number. When you submit the order, it is also assigned an IBM order number which you can use to track the order.

order status
When you create an order, Shopz stores and tracks the order through delivery and displays its current status on the My orders page. When additional status or tracking information is available, the status is displayed as a link, which can be followed to view the additional information. The following states are possible for an order:

• Open
  The order has not yet been submitted and you can still modify it.
• OrderCenter
  The order has been submitted to an IBM order center for manual processing. A representative from the order center will contact you if necessary. Orders are processed manually if they contain any new licensing requirements, special instructions, or if local business practices require it.
• Submitted
  The order has been submitted to an IBM fulfillment center for automated processing.
• Received
  The order has been received by the IBM fulfillment center and is being processed.
• Manufacturing
  The order is being manufactured.
• Final Packaging
  The order has been built by the IBM fulfillment center and is now being packaged for electronic download.
• Download
  The order is ready to be downloaded from the Internet. Clicking on this status link brings you to the Download page, so you can download the contents of the order from the Internet.
• Shipped
  The order has been shipped on physical media.
• Delivered on alternate media
  The order has been changed from electronic delivery to physical delivery due to its large size. A shipping notice will follow when your order has shipped.
• Expired
  The order has been removed from the IBM download center because its expiration date has passed. If you did not yet download the order, you must resubmit it.
• Rejected
  The order has been rejected by the IBM fulfillment center due to invalid submission data. You can view the order for more information.
• Canceled
  The order has been canceled by IBM due to an internal processing error. You can view the order for more information.
• Delayed
  The order has been delayed at the IBM fulfillment center due to internal processing. Please be patient and you will receive status updates when your order is completed.
• Archived
  The order has been fulfilled. Shopz keeps a record of the order until you decide to discard it.

Some orders contain both items which can be downloaded from the Internet, and items which are shipped on physical media. Such orders are shown with two separate status values.

package type

Software orders can be packaged in a variety of ways depending on your needs. These packages are grouped into categories. For each operating environment the categories and packages vary.

KVM for IBM z - Standalone products and fixes

• Standalone products and fixes
  • adds individual products on an existing system. These orders initially contain no products, and you shop for products from a catalog. Once you are licensed for these products, you can download them from the My downloads page. You can also search for fixes for the standalone products you are licensed for and download the fixes from the My downloads page.

Linux on z - Standalone products and fixes

• Standalone products and fixes
  • adds individual products on an existing system. These orders initially contain no products, and you shop for products from a catalog. Once you are licensed for these products, you can download them from the My downloads page. You can also search for fixes for the standalone products you are licensed for and download the fixes from the My downloads page.

z/OS - Service

• Individual PTFs
  • Individual PTFs by PTF number
    adds individual PTFs to a system to fix known problems when you know the PTF numbers.
  • Individual PTFs by APAR number
    adds individual PTFs to a system to fix known problems when you know the corresponding APAR numbers. If you do not provide an installed software report, PTFs may be delivered for multiple releases, since an APAR may apply to more than one release of a product. This may increase the size of your order.
• Critical (HIPER/PE) service,
  Recommended (RSU) service,
  All service
  • individual installed FMIDs
    adds PTFs not found in the installed software report for the list of selected FMIDs. Selectable FMIDs are determined from the functions listed in the installed software report PRODLIST.
  • individual installed products
    adds PTFs not found in the installed software report for the list of selected Products. Selectable Products are determined by the FEATURE data listed in the installed software report.
  • all installed products
    adds PTFs not found in the installed software report for all installed FMIDs listed in the installed software report PRODLIST.
• Service certificate
  • uniquely identifies you to IBM's Automated Service Delivery server, so that you can use SMP/E's RECEIVE ORDER function to request PTFs and HOLDDATA, and automatically download the resulting packages.

All z/OS Service orders are now signed by IBM and it is optional to verify the digital signature when receiving the order on to your system. For further details, see Chapter 6 "Preparing to verify signatures for GIMZIP packages" in z/OS SMP/E Users Guide at https://www.ibm.com/docs/en/zos/2.5.0?topic=guide-preparing-verify-signatures-gimzip-packages

z/OS - Products

• ServerPac (system, subsystem, or products)
  • replaces an entire existing system, or subsystem. These orders are automatically primed with the latest releases of all the products installed on your system, making it very easy to order an updated system replacement. You must upload an installed software report to automatically prime the order. Your z/OS license entitles you to order this package. This package is delivered in z/OSMF portable software instance format which is installed using z/OSMF Software Management.
  • adds a SMP/E installable or non-SMP/E product or product set without requiring a base product such as z/OS, DB2, CICS, or IMS. Eligible products are identified in the product catalog with a triangle icon. Like a regular ServerPac, these orders are delivered with the SMP/E installable product or product set installed in its own SMP/E environment (GLOBAL, DLIB, and Target zones). This package is delivered in z/OSMF portable software instance format which is installed using z/OSMF Software Management.
  • All z/OSMF ServerPac portable software instance order packages are now signed by IBM and it is optional to verify the digital signature when using the Add action. For further details, see Chapter 6 "Preparing to verify signatures for GIMZIP packages" in z/OS SMP/E Users Guide at https://www.ibm.com/docs/en/zos/2.5.0?topic=guide-preparing-verify-signatures-gimzip-packages
• CBPDO (products)
  • adds or upgrades individual products on an existing system. These orders initially contain no products and you shop for products from a catalog. null
  • All CBPDO order packages are now signed by IBM and it is optional to verify the digital signature which can be done by updating the RFNJOBH or RFNJOBS Job JCL for Internet orders or RFNJOBD Job JCL for DVD orders. For further details, see Chapter 6 "Preparing to verify signatures for GIMZIP packages" in z/OS SMP/E Users Guide at https://www.ibm.com/docs/en/zos/2.5.0?topic=guide-preparing-verify-signatures-gimzip-packages

z/OS - Open Source SW on z/OS

• CBPDO (products)
  • IBM offers a variety of software (both languages and tools) based on open source software. These offerings are provided on z/OS with no-charge license and IBM optional paid support.

z/OS - Driving Systems

• Customized Offerings Driver
  • is a stand-alone operating system used to install a CBPDO or ServerPac order if you do not have an existing system, or if your existing system does not meet the installation requirements.

z/TPF - Standalone products and fixes

• Standalone products and fixes
  • adds individual products on an existing system. These orders initially contain no products, and you shop for products from a catalog. Once you are licensed for these products, you can download them from the My downloads page. You can also search for fixes for the standalone products you are licensed for and download the fixes from the My downloads page.

z/VM - Service

• Individual PTFs
  • Individual PTFs by PTF number
    adds individual PTFs to a system to fix known problems when you know the PTF numbers.
  • Individual PTFs by APAR number
    adds individual PTFs to a system to fix known problems when you know the corresponding APAR numbers. If you do not provide an installed software report, PTFs may be delivered for multiple releases, since an APAR may apply to more than one release of a product. This may increase the size of your order.
• PSP critical service
  • contains Preventive Service Planning (PSP) buckets which include critical service recommendations consisting of fixes for highly pervasive (HIPER) problems. If an available PTF becomes a PTF in Error (PE), the fix for that error is included in the bucket.
• RSU Recommended Service Upgrade,
  ESO service
  • VM products are serviced with either an RSU or ESO. For products which do not have an RSU, ESO provides a method of ordering corrective service without having to specify individual PTF numbers. When ordering an ESO you can specify starting and ending service levels.

All z/VM Service orders are now signed by IBM. A small new file will be added to the package. Current procedures for uploading service to z/VM including GetShopz will be unaffected by the change. It is recommended to upload all files. An update to allow for verification of the digital signature is planned for the end of 2023. z/VM Service news information can be found here: https://www.vm.ibm.com/service/news/index.html

Learn more about z/VM - Service packages.

z/VM - Products

• VM SDO version 7
  • adds or upgrades individual products on an existing VM SDO version 7 system. These orders initially contain no products and you shop for products from a catalog. Your z/VM license entitles you to order this package.
• Standalone products and fixes
  • adds individual products on an existing system. These orders initially contain no products, and you shop for products from the z/VM Standalone catalog. Once you are licensed for the standalone products you ordered, you can download them from the My downloads page. You can also search for fixes for the standalone products you are licensed for and download the fixes from the My downloads page.

z/VSE - Service

• Individual PTFs
  • Individual PTFs by PTF number
    adds individual PTFs to a system to fix known problems when you know the PTF numbers.
  • Individual PTFs by APAR number
    adds individual PTFs to a system to fix known problems when you know the corresponding APAR numbers. If you do not provide an installed software report, PTFs may be delivered for multiple releases, since an APAR may apply to more than one release of a product. This may increase the size of your order.
• PSP critical service
  • contains Preventive Service Planning (PSP) buckets which include critical service recommendations consisting of fixes for highly pervasive (HIPER) problems. If an available PTF becomes a PTF in Error (PE), the fix for that error is included in the bucket.

Learn more about z/VSE - Service packages.

z/VSE - Products

• VSE SIPO version 6
  • adds or upgrades individual products on an existing z/VSE version 6 system. These orders initially contain no products and you shop for products from a catalog. Your z/VSE license entitles you to order this package.

PTF
Program Temporary Fix. A solution or bypass to a problem that may affect all users and that was diagnosed as the result of a defect in a current unaltered release of the program. In the absence of a new release of a system or component that incorporates the correction, the fix is not temporary but is permanent and the official correction mechanism.

PE
PTF in Error. These PTFs are fixes that have been released and were later identified to contain errors.

PRP
PRP identifies PTFs that resolve PTFs in error (PEs).

PUT
A monthly collection of all closed PTFs identified with a SOURCEID of PUTyymm, where yy indicates the last 2 digits of the year and mm indicates the month. For example, PUT level 0010 indicates the collection of all PTFs that closed in October, 2000. See PTF.

RAM (Roles and Authorization Management)
RAM is the system which keeps track of user groups and their details, including group basics, membership, managers and rules. Most group members will rarely, if ever, use RAM directly. Group managers will use RAM to manager group membership, rules and other details.

requisite service
Requisite service is service that is required to install other service. For z/OS individual PTF orders, you can decide whether you want requisite service to be included. For z/VSE individual PTF orders, you can also decide whether you want requisite service to be included. If you do not provide an installed software report for z/VSE PTF orders, you may choose to include fixes for a specific z/VSE service level by selecting an item from the pull down menu at the bottom of the page. It is therefore recommended to use an installed software report when ordering individual PTFs/APARs.

RSU Recommended Service Upgrade
See service type.

ServerPac (system, subsystem, or products)
See package type.

service type

For some z/OS service orders you can select the type (or amount) of service you would like. There are three types of service you can choose from:

• Critical (HIPER/PE) service includes PTFs (program temporary fixes) that resolve HIPER (high impact pervasive) APARs (authorized problem analysis reports) or PEs (PTFs in error). These fixes are also known as HIPER/PRP and are always included when you order preventive software maintenance.
• Recommended (RSU) service is a pre-defined collection of PTFs identified with a SOURCEID of RSUyymm, where yy indicates the last 2 digits of the year and mm indicates the month. IBM recommends that customers install all RSU PTFs as preventive software maintenance.

  Learn more about RSU.

• All service includes all available service for the products you select.

If you do not provide an installed software report, you may also need to specify a starting service level.

SMP/E
The software product installation and service tool for z/OS.

software license reports
Shopz software license reports are on-line snapshots of your software licenses. You can select your systems from a list and retrieve a software license report. Two reports are available:

• Software License Overview is a matrix of software licenses for multiple systems,
• Software License Detail gives you a detailed list of your software licenses for each system.

SREL

A logical grouping or subsystem of z/OS products. There are three SRELs:

• MVS - base system products
• DBS - database products - Db2 and IMS
• CICS - transaction products

superseded service
Service that is contained in and replaced by another piece of service. In SMP/E, a SYSMOD that contains all the functions in another SYSMOD and is recognized as the equivalent of that other SYSMOD uses the SUP operand on its ++VER statement to specify that it supersedes the other SYSMOD.

user group
See group.

VM SDO version 6
See package type.

VM SDO version 7
See package type.

VSE SIPO
See package type.

z/OSMF Portable Software Instance
A z/OSMF portable software instance is a package format used by z/OSMF Software Manager to deploy the package. ServerPac is delivered in z/OSMF portable software instance format when z/OSMF Software Management is the ServerPac installation method.