Operands

APARS

indicates that APARs should be rejected.

Note:

APARS is allowed only in mass mode and PURGE mode.
APARS can also be specified as APAR.

BYPASS

indicates that SMP/E should reject SYSMODs that have been installed.

APPLYCHECK: indicates that selected SYSMODs should be rejected, even if they have been applied.
ACCEPTCHECK: indicates that selected SYSMODs can be rejected, even if they have been accepted.

Note:

BYPASS is allowed only in select mode.
APPLYCHECK can also be specified as APPCHK.
ACCEPTCHECK can also be specified as ACCCHK.
To reject a superseded SYSMOD, you must either specify the appropriate BYPASS operands, or you must use the EXCLUDEZONE operand to specify the zones in which the SYSMOD is superseded.

CHECK

CHECK indicates that SMP/E should not actually update any libraries. Rather it should just take these actions:

Test for errors other than those that could occur when the libraries are actually updated.
Produce a REJECT Summary Report indicating what would have happened if CHECK had not been specified.

COMPRESS

indicates which partitioned data sets should be compressed.

If you specify ALL, any partitioned data sets that were updated are compressed. In addition, the SMPPTS data set is compressed regardless of whether it was updated.
If you specify one or more specific ddnames, only the data sets they apply to are compressed. Those data sets are compressed regardless of whether they were updated.

Note:

COMPRESS is allowed in all modes of REJECT processing.
COMPRESS can also be specified as C.

DELETEFMID

specifies one or more FMID subentries that are to be deleted from the GLOBALZONE entry before SMP/E selects the SYSMODs or HOLDDATA to be rejected.

Note:

DELETEFMID is allowed only in NOFMID mode.
DELETEFMID can also be specified as DFMID.
DELETEFMID does not cause SMP/E to reject the function SYSMODs associated with the specified FMID values.

EXCLUDE

specifies one or more SYSMODs that should not be rejected.

Note:

EXCLUDE is allowed only in mass mode.
EXCLUDE can also be specified as E.

EXCLUDEZONE

indicates that SMP/E should not check whether SYSMODs have been installed in the specified zones or ZONESETs.

For each specified value, SMP/E first checks for a ZONESET with the same name. If none is found, SMP/E checks for a zone with the same name. For example, suppose you have a ZONESET named SYS1 and a zone named SYS1. If you specify SYS1 on this operand, SMP/E assumes you want to use the zones defined in ZONESET SYS1 (which might or might not include zone SYS1), and not the individual zone SYS1.

Note:

EXCLUDEZONE is allowed only in mass mode and select mode.
EXCLUDEZONE can also be specified as EZONE.
EXCLUDEZONE cannot specify all the zones defined by ZONEINDEX subentries. If you are doing select-mode processing and you do not want SMP/E to check any zones, you can specify BYPASS(APPLYCHECK,ACCEPTCHECK). If you are doing mass-mode processing, there is no way to have SMP/E ignore all the zones.
You should be careful when using the EXCLUDEZONE operand. A SYSMOD that is installed in one of the excluded zones may be rejected, even if you were later going to install it in another zone. Because the rejected SYSMOD is no longer in the SMPPTS, it cannot be installed in any more zones.
To reject a superseded SYSMOD, you must either specify the appropriate BYPASS operands, or you must use the EXCLUDEZONE operand to specify the zones in which the SYSMOD is superseded.

FORFMID

indicates that only SYSMODs and HOLDDATA for the specified FMIDs or FMIDSETs should be rejected.

Note:

FORFMID is allowed only in mass mode and PURGE mode.
If no SYSMOD types are specified, only PTFs are processed. To process other types of SYSMODs, you must specify the desired SYSMOD types.

FUNCTIONS

indicates that functions should be rejected.

Note:

FUNCTIONS is allowed only in mass mode and PURGE mode.
FUNCTIONS can also be specified as FUNCTION.

HOLDDATA

indicates that SMP/E should reject HOLDDATA entries. There are two types of HOLDDATA entries: those that have an associated SYSMOD entry, and those that have no associated SYSMOD entry. (For more information, see SMP/E for z/OS Reference.) How SMP/E processes HOLDDATA entries depends on the mode of REJECT processing you choose.

Note: HOLDDATA is allowed for all modes of REJECT processing, but it will be ignored during Mass mode and Purge mode processing. Eligible HOLDDATA entries are deleted only during REJECT Select mode and REJECT NOFMID mode processing when the HOLDDATA operand is specified.

Mass mode: The HOLDDATA operand is ignored when specified for Mass mode REJECT processing. All HOLDDATA entries are retained during Mass mode processing. This includes internal SYSTEM HOLDs even though the containing SYSMOD may be deleted.
Select mode: If you specify HOLDDATA, SMP/E deletes HOLDDATA entries associated with the eligible SYSMOD IDs, regardless of whether an associated SYSMOD entry exists.
If you do not specify HOLDDATA, SMP/E does not delete any HOLDDATA entries, including internal SYSTEM HOLDDATA entries, even though the containing SYSMOD may be deleted.
PURGE mode: The HOLDDATA operand is ignored when specified for Purge mode REJECT processing. All HOLDDATA entries are retained during Purge mode processing. This includes internal SYSTEM HOLDs even though the containing SYSMOD may be deleted.
NOFMID mode: If you specify HOLDDATA, SMP/E deletes HOLDDATA entries associated with the SYSMOD entries that are also being rejected. In addition, SMP/E deletes HOLDDATA entries whose associated FMID is not defined in the global zone.
If you do not specify HOLDDATA, SMP/E does not delete any HOLDDATA entries, including internal SYSTEM HOLDDATA entries, even though the containing SYSMOD may be deleted.

NOFMID

indicates that SMP/E is to reject SYSMODs applicable to functions that are not part of the system. (The FMID they apply to is not in the GLOBALZONE entry.)

If DELETEFMID is also specified, SMP/E deletes the specified FMIDs from the GLOBALZONE entry before determining which SYSMODs and HOLDDATA to delete.

Note: NOFMID is allowed only in NOFMID mode.

PRODUCT

indicates that SMP/E should reject PRODUCT and FEATURE entries.

Note: PRODUCT is allowed only in NOFMID mode.

PTFS

indicates that PTFs should be rejected. This is the default SYSMOD type operand. In mass or PURGE mode processing, if no SYSMOD type is specified, only PTFs are rejected.

Note:

PTFS is allowed only in mass mode and PURGE mode.
PTFS can also be specified as PTF.

PURGE

indicates that SMP/E should reject only SYSMOD entries for SYSMODs that have been accepted into the specified distribution zones or ZONESETs.

Any individual zones you specify must be distribution zones. Among all the zones and ZONESETs you specify, there must be at least one distribution zone.

If you specify a single zone, SMP/E rejects entries only for SYSMODs that have been accepted into that zone.
If you specify more than one zone (including zones in a ZONESET), SMP/E rejects entries only for SYSMODs that have been installed in at least one distribution zone and have been installed in all the distribution zones they apply to.

If TARGETZONE is also specified, SMP/E rejects entries only for SYSMODs that have also been installed in the specified target zones where they are applicable.

HOLDDATA entries are not deleted during Purge mode processing. The HOLDDATA operand is ignored when specified with the PURGE operand.

Note:

PURGE is only allowed in PURGE mode.
PURGE cannot be used to reject specific SYSMODs that have been accepted. To do this you must specify BYPASS(ACCCHK) in select mode.
PURGE uses a SYSMOD's REWORK value to determine whether the SYSMOD should be rejected. If the REWORK value of a SYSMOD in the global zone is higher than the REWORK value of the SYSMOD in the distribution or target zone, then the SYSMOD is not rejected.

RC

changes the maximum return codes allowed for the specified commands. These return codes determine whether SMP/E can process the REJECT command.

Before SMP/E processes the REJECT command, it checks whether the return codes for the specified commands are less than or equal to the values specified on the RC operand. If so, SMP/E can process the REJECT command. Otherwise, the REJECT command fails. For more information about the RC operand, see Processing the SMP/E RC operand.

Note:

The RC operand must be the last operand specified on the command.
RC is allowed in all modes of REJECT processing.
If you do specify the RC operand, return codes for commands not specified do not affect processing for the REJECT command. Therefore, if you use the RC operand, you must specify every command whose return code you want SMP/E to check.

SELECT

specifies one or more SYSMODs that should be rejected.

Note:

SELECT is only allowed in select mode.
SELECT can also be specified as S.

SOURCEID

indicates that only entries for SYSMODs associated with the specified source IDs should be rejected.

Note:

SOURCEID is allowed only in mass mode and PURGE mode.
There are two ways to specify source IDs:
- Explicitly, by fully specifying a particular source ID value (for example, RSU0711). In this case, all SYSMODs that contain the identified source ID are selected.
- Implicitly, by partially specifying a source ID using asterisks (*) as global characters and percent signs (%) as placeholders.
  - A single asterisk, for example, RSU*, *0711, or RSU*1, indicates that zero or more characters can occupy that position.
    - For RSU*, all SYSMODs that contain a source ID that begins with the character string RSU are selected.
    - For *0711, all SYSMODs that contain a source ID that ends with the character string 0711 are selected.
    - For RSU*1, all SYSMODs that contain a source ID that begins with the character string RSU and ends with the character string 1 are selected.
  - A single percent sign, for example, RSU0%11, indicates that any one single character can occupy that position. In this case, SYSMODS that contain any of the following source IDs are selected: RSU0711, RSU0211, and RSU0311. SYSMODs that contain RSU00711 are not selected.
  Any number of asterisks and percent signs can be used within a single partially specified source ID.
  The following examples are valid source ID specifications:
```
RSU0709
RSU*
IBM.Device.20%4
IBM.Device.*.zAAP
```
A given source ID can be explicitly specified only once on the SOURCEID operand.
If no SYSMOD types are specified, only PTFs are processed. To process other types of SYSMODs, you must specify the desired SYSMOD types.
A source ID value might contain mixed case alphabetic characters. However, SMP/E ignores the case when identifying matches for a specified source ID value. For example, a specified source ID value of ABCDEF matches a value of abcdef.

TARGETZONE

indicates that SMP/E should only reject SYSMOD entries for SYSMODs that have been applied to the specified target zones or ZONESETs.

Any individual zones you specify must be target zones. Among all the zones and ZONESETs you specify, there must be at least one target zone.

SMP/E rejects entries for SYSMODs that have been installed in the specified target zones where they are applicable. If a SYSMOD is not applicable to any of the specified target zones, it may still be rejected if it is installed in the specified distribution zones where it is applicable.

Note:

TARGETZONE is allowed only in PURGE mode.
TARGETZONE cannot be used to reject specific SYSMODs that have been applied. To do this, you must specify BYPASS(APPCHK) in select mode.

USERMODS

indicates that USERMODs should be rejected.

Note:

USERMODS is allowed only in mass mode and PURGE mode.
USERMODS can also be specified as USERMOD.