The SMP/E RECEIVE command

The RECEIVE command allows you to take a SYSMOD that is outside of SMP/E and stage it into the SMP/E library domain, which begins to construct the CSI entries that describe them. This staging allows them to be queried for input into later processes. More recently, the source can be electronic from a Web site, although usually it comes from a tape or even a third-party vendor media.

The RECEIVE process accomplishes several tasks that are shown in Figure 1.

Figure 1. SMP/E RECEIVE processing

These tasks include:

Constructing entries in the Global Zone for describing the SYSMOD.
Ensuring the SYSMOD is valid, such as the syntax for modification control statements (MCS) associated to the products installed in the CSI.
Installing the SYSMOD into the libraries. Example: the PTF temporary store library.
Assessing the HOLDDATA to ensure errors are not introduced.

During the RECEIVE processing, the MCS for each SYSMOD is copied to an SMP/E temporary storage area called the SMPPTS data set, which contains the inline element replacement or update for that SYSMOD. There are also RELFILEs that package the elements in relative files that are separate from MCSs, which are mostly used by function SYSMODs. Relative files are stored in another temporary storage area called SMPTLIB data sets.

SMP/E updates the global zone with information about the SYSMODs that it has received.

In the course of maintaining the system, you need to install service and process the related HOLDDATA. For example, assume that IBM® has supplied you with a service tape (such as a CBPDO or ESO tape) and you want to install it on the system. The first step is to receive the SYSMODs and HOLDDATA that are contained on the tape by entering these commands:

SET      BDY(GLOBAL).
RECEIVE.

Doing so causes SMP/E to receive all the SYSMODs and HOLDDATA on the tape.

Examples of RECEIVE commands

To receive only HOLDDATA that might require special handling or that is in error, you use this command:

SET      BDY(GLOBAL).
RECEIVE  HOLDDATA.

To receive only SYSMODs for installation into the global zone, you use this command:

SET      BDY(GLOBAL).
RECEIVE  SYSMODS.

To receive all SYSMODs, including HOLDDATA, for a specific product (for example, WebSphere® Application Server), you use a command like the following:

SET      BDY(GLOBAL).
RECEIVE  FORFMID(H28W500).