Glossary of SMP/E terms used in this book

ACCEPT (function of SMP/E)
SMP/E control statement that controls the placement (installing) of SYSMODs into the distribution libraries. Processing is similar to that during APPLY except that the distribution zone is updated, not the target zone, and JCLIN data is not processed by ACCEPT.

If the installing is successful, any entries in the SCDS created by APPLY are deleted, as are temporary libraries created by RECEIVE. Therefore, after a SYSMOD is accepted, it can no longer be removed by SMP/E.

APAR (authorized program analysis report)
IBM-supplied fixes of a temporary corrective nature to elements of IBM-supplied function SYSMODs. APAR fixes are intended to cure problems currently being experienced by an installation. The APAR fix is usually in the form of either a modification to a load module or an update to card-image data. It is intended as a temporary arrangement until a PTF is issued to fix the problem permanently. This PTF will supersede the APAR fix, and indeed specifies this relationship on its ++VER statement.

To get an APAR SYSMOD accepted into the distribution libraries, the APARS keyword must be specified in the ACCEPT control statement, which protects against inadvertent updating of distribution libraries that are to be kept free of temporary fixes.

The ++VER statement in the APAR SYSMOD must specify the FMID of the function that "owns" the elements being updated.

++APAR(AP12345)
++VER(C150) FMID(HCI6400)

You should not accept APARs into the distribution library, however, because the relevant PTF will become available in due course as a more permanent form of service.

APPLY (function of SMP/E)
SMP/E control statement that applies SYSMODs to the CICS® target libraries, where they can be tested. If the tests are not satisfactory, you can remove all or selected SYSMODs using the RESTORE function. If the test is successful, you can use the ACCEPT function to store the elements from the SYSMOD into the distribution libraries.

During JCLIN processing, every affected entry in the target zone is saved in the SCDS, in case the target system libraries and the target zone have to be restored to their original status.

CSI (consolidated software inventory)
A keyed VSAM data set, logically divided by SMP/E into zones. For further information on the CSI and the logical structure of zones, see the System Modification Program Extended: User’s Guide.
Distribution zone
Describes the structure and contents of a set of distribution libraries.
Function SYSMOD
An IBM-supplied product that can be installed with SMP/E. CICS Transaction Server for z/OS®, Version 3 Release 1 is packaged as a function SYSMOD on a distribution tape. This contains distribution libraries and JCLIN data which SMP/E uses to create the target libraries.
FMID (keyword of CICS SYSMODs)
Keyword identifying the release and option to which a SYSMOD is applicable. For CICS Transaction Server for z/OS, Version 3 Release 1, it is always HCI6400.
Global zone
Logical division of the SMP/E consolidated software inventory (CSI), containing such information as:
load module
In the context of SMP/E, an executable load module in a target library (such as hlq.SDFHLOAD). The standard SMP/E abbreviation for a load module is LMOD.
PTF (program temporary fix)
IBM-supplied fixes to elements of IBM-supplied function SYSMODs. PTFs are intended for installation by all users to avoid possible problems.

A PTF may contain fixes for several different problems. This means that several APAR fixes reported in RETAIN® may all be superseded by the more permanent PTF, which:

Every PTF is introduced by a ++PTF header statement, and contains the FMID keyword on its ++VER modification control statement, identifying CICS (HCI6400) as the owner of the modules being serviced.

For example:

++PTF(UP12345)
++VER(C150) FMID(HCI6400)
PTS (PTF temporary store)
SMP/E primary data set used to store temporarily SYSMODs that are in RECEIVE or APPLY status; that is, they have not been rejected or accepted.
RECEIVE (function of SMP/E)
SMP/E control statement that initiates processing of a SYSMOD. RECEIVE reads the SYSMODs from the SMPPTFIN data set. Each SYSMOD must have been received before any other function can be executed.

RECEIVE updates the SMPPTS data set and performs syntax checking on input. Before any SYSMOD for CICS can be received, the global zone must have been initialized with a global zone entry.

Service SYSMODs can be received into the (PTS) before the function to which it applies has been received, and can be maintained there until the function is received. This allows all service for a product such as CICS to be installed with the base product.

REJECT (function of SMP/E)
SMP/E control statement that removes SYSMODs from the PTS data set and deletes any temporary libraries that SMP/E may have allocated when the SYSMOD was received (RELfiles). If the SELECT or EXCLUDE option is not coded on the REJECT control statement, all SYSMODs not applied or accepted are removed from the PTS. This is called a mass rejection. All other SYSMOD processing functions (RECEIVE, APPLY, RESTORE, and ACCEPT) can have SELECT or EXCLUDE specified, or may default to mass-processing mode.
RESTORE (function of SMP/E)
SMP/E control statement that removes SYSMODs from the target system libraries after they have been applied, and restores the target libraries to their status prior to application of the SYSMODs. If necessary, RESTORE reconstructs the target zone entries from the SCDS. If you select "mass restore", all SYSMODs that have been applied but not accepted are removed from the target libraries.
SYSMOD (system modification)
An IBM-supplied product (function SYSMOD). An IBM-supplied preventive service (PTF). An IBM-supplied corrective service (APAR). A user-supplied modification (USERMOD).
Target zone
Describes the structure and contents of a set of target system libraries.
UCLIN (function of SMP/E)
SMP/E control statement that can be used to manipulate the various data sets that make up the SMP/E data base. The most common use of this function is to initialize the SMP/E database before the first attempt to use it. For CICS, this initialization is performed during installation, when DFHINST4 is run.
USERMOD (user modification)
User-supplied modifications to elements of IBM-supplied function SYSMODs. USERMODs are similar to APAR fixes, but are supplied by the user and not by IBM®. They may be:

The decision to modify CICS, either to add or to alter function, should be taken with caution, because it greatly increases the amount of research you must do before installing PTFs, and may also increase the installation time for PTFs. Furthermore, USERMODS will cause difficulty when you want to install future release of CICS.

[[ Contents Previous Page | Next Page Index ]]