SMP/E for z/OS Commands
Previous topic | Next topic | Contents | Contact z/OS | Library | PDF


Candidate selection

SMP/E for z/OS Commands
SA23-2275-01

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:

  1. 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.
    1. If the EXCLUDE operand was specified, SMP/E makes sure the SYSMOD was not specified in the exclude list.
    2. 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.
    3. 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.
    4. 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.
    5. 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.

  2. 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.
  3. 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.
  4. 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:
    1. 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
    2. 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
    3. 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
    4. 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 PUT0701 that are applicable to EBB1102, plus any additional SYSMODs that are required, even though their source ID is not PUT0701 or their FMID is not EBB1102:
    SET      BDY(TGT1)          /* Set to target zone.   */.
    APPLY    SOURCEID(PUT0701)  /*                       */
             FORFMID(EBB1102)   /*                       */
             GROUP              /*                       */.

Go to the previous page Go to the next page




Copyright IBM Corporation 1990, 2014