Operands

BYPASS

You can specify any of these options:

ID
XZIFREQ
XZIFREQ(list)

BYPASS(ID)

indicates that SMP/E should ignore any errors it detects when checking RMID and UMIDs for element entries in the target zone or distribution zone.

BYPASS(XZIFREQ)

indicates that SMP/E should continue RESTORE processing for a SYSMOD even if a SYSMOD in another zone names the SYSMOD being restored as a requisite, regardless of which or how many SYSMODs state the requisite condition or what zones they are in. SMP/E will identify such requisite conditions with a warning message, instead of terminating the RESTORE processing.

Note: CIFREQ conditions within the set-to zone cannot be bypassed.

BYPASS(XZIFREQ(list))

indicates that SMP/E should continue RESTORE processing for a SYSMOD even if a SYSMOD in another zone names the SYSMOD being restored as a requisite, provided that the SYSMOD stating the requisite condition is included in the list provided with the XZIFREQ option. For causer SYSMODs identified in the list, SMP/E will identify such requisite conditions with a warning message.

Each entry in the list must be in one of the following formats:

sysmod_id
(sysmod_id,zone)

sysmod_id: specifies that any requisite condition stated by SYSMOD sysmod_id in any zone (other than the set-to zone) is not to be considered an error condition.
(sysmod_id,zone): specifies that any requisite condition stated by SYSMOD sysmod_id in zone zone is not to be considered an error condition.

Each entry in the list must be unique. Also, a SYSMOD ID must not appear both by itself and as part of a SYSMOD/zone pair. However, a SYSMOD ID may appear in multiple SYSMOD/zone pairs, provided each of the pairs is unique.

The list provided must not be a null list; that is, BYPASS(XZIFREQ()) is not allowed.

Note:

CIFREQ conditions within the set-to zone cannot be bypassed.
If a SYSMOD that is not on the BYPASS XZIFREQ list has stated a requisite condition for the SYSMOD being restored, SMP/E terminates the RESTORE processing.

CHECK

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

Test for errors other than those that can occur when the libraries are actually updated
Report on which libraries are affected
Report on any SYSMOD that would be regressed

COMPRESS

indicates which target libraries should be compressed. SMP/E does not compress any libraries that are actually paths in a UNIX file system.

If you specify ALL, any libraries containing elements that will be updated by this RESTORE command are compressed.
If you specify particular ddnames, those libraries are compressed regardless of whether they will be updated.

Note:

COMPRESS can also be specified as C.
If you specify COMPRESS and CHECK, COMPRESS is ignored, because SMP/E does not update any data sets for CHECK.

GROUP

indicates that if SMP/E determines that additional SYSMODs should be restored, other than those specified in the SELECT list, SMP/E should automatically include them.

For example, Assume that you have applied a function and service for that function. When you select the function and specify the GROUP operand, SMP/E also tries to restore the service that was applied for that function.

Likewise, Assume that you have applied two PTFs, and one defines the other as the prerequisite. When you select the prerequisite and specify the GROUP operand, SMP/E also tries to restore the other PTF. On the other hand, if you select the SYSMOD that specifies the prerequisite, SMP/E restores that particular SYSMOD only if the prerequisite has been accepted.

However, Assume that you have installed two PTFs that affect the same element but that do not define any relationship to each other. If you select one of the PTFs and specify the GROUP operand, SMP/E does not try to restore the other PTF. You have to specify both PTFs on the SELECT operand.

Note: GROUP can also be specified as G.

RC

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

Before SMP/E processes the RESTORE 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 RESTORE command. Otherwise, the RESTORE 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.
If you do specify the RC operand, return codes for commands not specified do not affect processing for the RESTORE command. Therefore, if you use the RC operand, you must specify every command whose return code you want SMP/E to check.

RETRY

indicates whether SMP/E should try to recover from out-of-space errors for utilities it calls.

YES

indicates that SMP/E should try to recover and retry the utility if a RETRYDDN list is available in the OPTIONS entry that is in effect. RETRY(YES) is the default.

If retry processing does not reclaim sufficient space and input to the utility was batched (copy or link-edit utility only), SMP/E debatches the input and retries the utility for each member separately. If this final attempt fails, the resulting x37 abend is treated as an unacceptable utility return code. In this case, processing continues for SYSMODs containing eligible updates to other libraries, but processing fails for SYSMODs containing unprocessed elements for the out-of-space library (and it fails for any SYSMODs that are dependent on the failed SYSMODs). For guidance on setting up the desired retry processing, see SMP/E for z/OS User's Guide. For more information about OPTIONS entries, see SMP/E for z/OS Reference.

If there is no RETRYDDN list, SMP/E does not try to recover from out-of-space errors, even if RETRY(YES) is specified.

NO

indicates that SMP/E should not try to recover from the error.

SELECT

specifies one or more SYSMODs that should be restored.

You may specify any combination of individual SYSMOD IDs and FMIDSET names, provided that there are no duplicate SYSMOD IDs nor any duplicate FMIDSET names. For each FMIDSET specified, all FMIDs defined in the FMIDSET are processed as if they were explicitly specified in the SELECT list.

Note:

SELECT is required for RESTORE. This is the only means of specifying which SYSMODs are eligible to be restored.
SELECT can also be specified as S.
If you use GROUP along with SELECT, make sure to specify the lowest level of service you want restored. For example, if you want to restore PTF1 and PTF2, and PTF1 is a prerequisite for PTF2, specify PTF1 on the SELECT operand.
When using FMIDSETs on the SELECT operand, remember that:
- A value specified in the SELECT list is processed as an FMIDSET if the GLOBAL zone contains an FMIDSET entry by that name.
- A value specified in the SELECT list is processed as a SYSMOD ID if it is not defined as an FMIDSET in the GLOBAL zone and it is a valid SYSMOD ID.
- If the value in the SELECT list is valid both as a SYSMOD ID and as an FMIDSET name, it is processed (for SELECT) as an FMIDSET. If you want to select a SYSMOD that has the same name as an FMIDSET, you must define that SYSMOD in an FMIDSET and then include that FMIDSET name in the SELECT list.
- Any given value (whether it represents a SYSMOD ID, an FMIDSET, or both) may not appear more than once in the SELECT list.
- A SYSMOD ID may be explicitly specified in the SELECT list and also included in an FMIDSET that is also specified in the SELECT list, provided the SYSMOD ID does not have the same name as the FMIDSET. The duplicate SYSMOD ID is ignored.

XZGROUP

indicates that SMP/E's default method for determining the zones to be checked for cross-zone requisites is being overridden. You may specify a list of ZONESETs or zones (or both) that are to be used to establish the zone group for this command execution. Each value in the list must be 1 to 8 alphanumeric or national (@, #, and $) characters. XZGROUP() – a null list – may be specified, which means that SMP/E is to do no cross-zone requisite checking.

Note:

If XZGROUP is specified, whatever ZONESETs the user specifies are used to establish the initial zone group, even if the set-to zone is not in a ZONESET and the XZREQCHK subentry is not set.
If no XZGROUP operand was specified on the RESTORE command, SMP/E reads all ZONESET entries. If a ZONESET entry has its XZREQCHK subentry set to YES and it contains the set-to zone, then all the other zones within the ZONESET entry become part of the initial zone group for the RESTORE command.
After the initial zone group is established, it is culled by removing all distribution zone for RESTORE processing. In other words, only zones having the same type as the set-to zone are left in the final zone group used for cross-zone requisite checking.