z/OS system installation and maintenance
Previous topic | Next topic | Contents | Glossary | Contact z/OS | PDF


The SMP/E ACCEPT command

z/OS system installation and maintenance

When a SYSMOD is installed into its target library, and you have tested it, you then accept the change through the ACCEPT command. This step takes the selected SYSMODs and installs them into the associated distribution libraries.

On the ACCEPT command, you specify operands to indicate which of the received SYSMODs are to be selected for installation. During this phase, SMP/E also ensures that the correct functional level of each element is selected.

Figure 1. SMP/E ACCEPT processing

The ACCEPT command performs the following tasks, shown in Figure 1:

  • Updates CSI entries with the targeted elements in the distribution zone.
  • Rebuilds or creates the targeted elements in the distribution libraries using the content of the SYSMOD as input.
  • Verifies the target zone CSI entries for the affected modules and SYSMODs, ensuring that they are consistent with the library content.
  • Performs housekeeping of obsolete or expired elements. ACCEPT processing deletes the global zone CSI entries, PTS members and SMPTLIBs for those SYSMODs affected. For example, ACCEPT deletes the global zone SYSMOD entries and MCS statements in the SMPPTS data set for those SYSMODs that have been accepted into the distribution zone.

As a further option, you can skip having SMP/E clean up the global zone cleanup. If so, SMP/E saves this information.

There is a "stop" ACCEPT processing that SMP/E provides so you can ensure that all prerequisites are satisfied before the installation of the SYSMODs. This is a check for you to see what will happen (assist you in detecting problems) without actually modifying the distribution libraries.

After applying the SYSMODs into the Target zone, you can then tell SMP/E to install only the eligible PTF SYSMODs into the Distribution zone:
SET     BDY(ZOSDLB1).
ACCEPT  PTFS.

Examples of ACCEPT commands

To install PTF SYSMODS selecting the particular ones:
SET     BDY(ZOSDLB1).
ACCEPT  SELECT(UZ00001,UZ00002).
There are situations where you may want to update a particular product with all SYSMODs:
SET     BDY(ZOSDLB1).
ACCEPT  PTFS
        FORFMID(H28W500).
Or:
SET     BDY(ZOSDLB1).
ACCEPT  FORFMID(H28W500).
In these two examples, SMP/E accepts all applicable PTFs for the product whose FMID is H28W500 located in the Distribution zone ZOSDLB1.
Note: Should the SYSMOD be in error, do not accept it. Use the RESTORE process which takes the updated modules and rebuilds the copies in the Target libraries from the specific modules in the Distribution libraries. Additionally, RESTORE updates the Target zone CSI entries to reflect the removal of the SYSMOD.
Note: When ACCEPT processing is complete, it cannot be backed out. ACCEPT should only be performed after you are satisfied with the performance and stability of the elements of the SYSMOD. The changes from ACCEPT processing are permanent.

The ACCEPT processing for prerequisite SYSMODs

When installing a SYSMOD, you may not know whether it has prerequisites (sometimes, an ERROR SYSMOD is held). In these situations, you can direct SMP/E to check whether an equivalent (or superseding) SYSMOD is available by specifying the GROUPEXTEND operand:
SET     BDY(ZOSDLB1).
ACCEPT  PTFS
        FORFMID(H28W500)
        GROUPEXTEND.
A good way to see which SYSMODs are included before you actually install them is with the CHECK operand:
SET     BDY(ZOSTGT1).
ACCEPT  PTFS
        FORMFMID(H28W500)
        GROUPEXTEND
        CHECK.
Note: If SMP/E cannot find a required SYSMOD, it looks for and uses a SYSMOD that supersedes the required one.

ACCEPT reporting

When this last phase is completed, the following reports will assist you to assess the results:
  • SYSMOD Status Report: Provides a summary of the processing that took place for each SYSMOD, based on the operands you specified on the ACCEPT command.
  • Element Summary Report: Provides a detailed look at each element affected by the ACCEPT processing and in which libraries they reside.
  • Causer SYSMOD Summary Report: Provides a list of SYSMODs that caused other SYSMODs to fail and describes the errors that must be fixed in order to be successfully processed.
  • File Allocation Report: Provides a list of the data sets used for the ACCEPT processing and supplies information about these data sets.




Copyright IBM Corporation 1990, 2010