|
The SYSMOD selection operands of the APPLY command can be specified
separately or in combination to control the SYSMODs that SMP/E is
to process. When you specify them separately, SMP/E selects only SYSMODs
meeting the one criterion specified. When you specify them in combination,
SMP/E does the following checking to build the complete candidate
list:
- SMP/E checks the global zone and the specified target zone to
determine which SYSMODs present in the global zone and SMPPTS have
not already been applied to the target zone. For each such SYSMOD,
SMP/E checks to see if it meets the criteria of any additional selection
operands.
- If
the EXCLUDE operand was specified, SMP/E makes sure the SYSMOD was
not specified in the exclude list.
- If one or more of the SYSMOD type operands (that is, FUNCTIONS,
PTFS, APARS, or USERMODS) were specified, SMP/E checks to make sure
the SYSMOD type was one of those specified. If no type operand was
specified, the default is for SMP/E to process only PTF SYSMODs.
- If the FORFMID operand was specified, SMP/E makes sure that either
the FMID value on one of the ++VER statements within the SYSMOD or
the SYSMOD ID itself matches either an FMID specified in FORFMID or
one of the FMID values in a specified FMIDSET.
- If the SOURCEID operand was specified, SMP/E makes sure one of
the source IDs of the SYSMOD matches a source ID that was either explicitly
or implicitly specified on the SOURCEID operand.
- If the EXSRCID operand was specified, SMP/E makes sure none of
the source IDs of the SYSMOD matches a source ID that was either explicitly
or implicitly specified on the EXSRCID operand.
Note: If a given
SYSMOD has multiple source IDs and you specify at least one of them,
implicitly or explicitly, on the SOURCEID operand, and you specify
another one implicitly or explicitly, on the EXSRCID operand, that
SYSMOD is excluded from processing. Similarly, if a given source
ID is implicitly or explicitly specified on the EXSRCID operand and
also on the SOURCEID operand, all SYSMODs with that source ID are
excluded from processing.
Each SYSMOD satisfying all these conditions is a candidate
for the APPLY process. In other words, specifying the SYSMOD type
operands, the FORFMID operand, or the SOURCEID operand in combination
causes SMP/E to select those SYSMODs meeting all the specified conditions.
- If you specify the SELECT operand, each SYSMOD specified in the select list is a candidate regardless
of its SYSMOD type, FMID value, or SOURCEID value. That is, SELECT
has an additive effect on the SYSMOD selection. This is called select-mode processing. If SELECT is
not specified, this is called mass-mode processing.
Note: If SELECT is
the only specified operand, SMP/E processes only the SYSMODs in the
select list.
- If you specify the XZREQ operand, unsatisfied cross-zone requisites
that are needed in the set-to zone become candidates for installation. These SYSMODs are in addition to
other SYSMODs that are chosen due to other operands, such as FORFMID
and SOURCEID. If FORFMID is specified, only cross-zone requisites
for the FMIDs specified on the FORFMID operand become candidates for
installation. Other operands on the command, such as EXSRCID, have
no effect on which cross-zone requisites become candidates for installation.
- If the GROUP or GROUPEXTEND operand was specified, SMP/E checks
each of the candidate SYSMODs to determine if it has any requisites
that must also be applied. SMP/E automatically includes the following
SYSMODs, as long as they were not specified on the EXCLUDE operand
or excluded by the EXSRCID operand:
- Any SYSMOD not already applied and specified as a prerequisite
(that is, specified in the ++VER statement PRE operand) of one of
the candidate SYSMODs
- Any SYSMOD not already applied and specified as a corequisite
(that is, specified in the ++VER statement REQ operand) of one of
the candidate SYSMODs
- Any SYSMOD not already applied and specified as a conditional
requisite (that is, specified in the ++IF statement REQ operand) of
one of the candidate SYSMODs
- Any SYSMOD not already applied and specified as a conditional
requisite (CIFREQ subentry) in the target zone SYSMOD entry for one
of the candidate SYSMODs
If one of these requisites is held or not available, and
you specified GROUPEXTEND, SMP/E checks
the global zone for any SYSMODs that have been received and that either
supersede the requisite, or satisfy or supersede its HOLDERROR reason
ID. If so, the lowest-level SYSMOD found is used to satisfy the requisite.
- If you specified NOAPARS with GROUPEXTEND,
SMP/E does not include APARs that resolve error reason IDs for the
held requisites.
- If you specified NOUSERMODS with GROUPEXTEND,
SMP/E does not include USERMODs that resolve error reason IDs for
the held requisites.
Once a SYSMOD is added to the candidate list, it is
eligible to be checked for additional requisites. The FORFMID, SOURCEID,
and SYSMOD type operands have no effect on SYSMODs brought in because
of the GROUP or GROUPEXTEND operand. The following example applies
all those SYSMODs with a source ID of PUT 0701 that
are applicable to EBB1102, plus any additional SYSMODs that are required,
even though their source ID is not PUT 0701 or their
FMID is not EBB1102: SET BDY(TGT1) /* Set to target zone. */.
APPLY SOURCEID(PUT0701) /* */
FORFMID(EBB1102) /* */
GROUP /* */.
|