To make it easier for you to install the applicable SYSMODs named
in the SYSMOD Comparison report, SMP/E writes the necessary commands
to the SMPPUNCH data set: SET BOUNDARY, RESETRC, and either ACCEPT
(for distribution zones) or APPLY (for target zones). Nothing is written
to SMPPUNCH for a specified zone in the following cases:
- There are no applicable SYSMODs in the input zone.
- NOPUNCH was specified on the REPORT
SYSMODS command.
When a global zone CSI data set name is specified
on the COMPAREDTO operand, SMPCSI and SMPCNTL DD statements will be
included in the SMPPUNCH output. These DD statements will appear
before the SET BDY command and must be copied into the users job before
the output can be used. When the global zone CSI data set name is
not specified on the COMPAREDTO operand, the SMPCSI and SMPCNTL DD
statements will not be included in the SMPPUNCH output.
The code sample below shows
the format of the SMPPUNCH output from the REPORT SYSMODS command.
//* DD statement for zone zone2
//SMPCSI DD DSN=globalcsi,DISP=SHR
//SMPCNTL DD *
SET BDY (zone2).
RESETRC /*
THE FOLLOWING command COMMAND(S) WERE GENERATED BY A REPORT SYSMODS
COMMAND ON yy.ddd AT hh:mm:ss. THE SELECTED SYSMODS WERE FOUND IN
THE INPUT ZONE (zone1_) BUT NOT IN THE COMPARISON ZONE (zone2_)
AND APPEAR APPLICABLE TO THE COMPARISON ZONE.
SYSMODS IN THE SELECT LIST ARE GROUPED BY FMID. FUNCTIONS APPEAR
FIRST FOLLOWED BY SERVICE SYSMODS (PTFS, APARS, AND USERMODS IN THAT
ORDER).
FUNCTIONS AND PTFS THAT WERE AVAILABLE IN THE GLOBAL ZONE AND ARE
APPLICABLE TO THE COMPARISON ZONE APPEAR AS NORMAL SELECT LIST
VALUES WITH AN APPROPRIATE COMMENT. FUNCTIONS AND PTFS THAT WERE
NOT AVAILABLE IN THE GLOBAL ZONE OR HAVE UNKNOWN APPLICABILITY
APPEAR AS SMP COMMENTS. PTFS FOR AN APPLICABLE FUNCTION, NOT
AVAILABLE IN THE GLOBAL ZONE, APPEAR AS COMMENTS EVEN IF THEY ARE
AVAILABLE. SUCH COMMENTED SYSMODS CAN BE CHANGED TO NORMAL SELECT
LIST VALUES WHEN THEY OR THEIR APPLICABLE FUNCTIONS ARE RECEIVED OR
ARE DETERMINED TO BE APPLICABLE.
APARS AND USERMODS APPEAR AS SMP COMMENTS. THESE COMMENTED SYSMODS
CAN BECOME NORMAL SELECT LIST VALUES IF YOU DESIRE TO INSTALL THEM
IN THE zone2__ ZONE AND THEY ARE AVAILABLE IN THE GLOBAL ZONE. THE
COMMENTARY TEXT INDICATES THEIR AVAILABILITY AND APPLICABILITY
STATUS.
THE COMMAND(S) WERE GENERATED WITH THE BYPASS(HOLDSYSTEM), GROUP AND
CHECK OPTIONS. GROUP CAUSES REQUISITE SYSMODS TO BE INCLUDED ALONG
WITH THE SELECTED SYSMODS. CHECK CAUSES A DRYRUN OF THE COMMAND
BEFORE LIBRARIES ARE UPDATED SO THAT ANY NEEDED CORRECTIVE ACTION
CAN BE TAKEN BEFORE REAL INSTALLATION. BYPASS(HOLDSYSTEM) CAUSES
ALL SYSTEM HOLD REASON IDS TO BE BYPASSED.
REDO WAS GENERATED IF A FUNCTION IS TO BE REINSTALLED. IF REDO IS
USED, ONLY THE FUNCTION BEING REINSTALLED AND ITS SERVICE ARE
SELECTED ON THAT COMMAND.
**** WARNING ****
IT IS POSSIBLE THAT ALL SYSMODS SELECTED WILL APPEAR AS SMP
COMMENTS. IF THIS IS THE CASE, SMP WILL ISSUE A SYNTAX ERROR IF YOU
RUN THE GENERATED COMMAND(S) AS IS.
**** WARNING ****
*/
.
command
SELECT(
sysmdid /* smdtype FOR fmid RECEIVED */
/* sysmdid smdtype FOR fmid NOT RECEIVED */
/* sysmdid smdtype FOR fmid RECEIVED, fmid NOT RECV'D */
/* sysmdid smdtype FOR fmid NOT RECEIVED, fmid NOT RECV'D */
/* sysmdid smdtype FOR fmid RECEIVED, APPLICABILITY UNKNOWN */
/* sysmdid smdtype FOR fmid NOT RECV'D, APPLICABILITY UNKNOWN */
/* sysmdid APAR FOR fmid RECEIVED */
/* sysmdid APAR FOR fmid NOT RECEIVED */
/* sysmdid USERMOD FOR fmid RECEIVED */
/* sysmdid USERMOD FOR fmid NOT RECEIVED */
)
[REDO]
GROUP
BYPASS (HOLDSYSTEM)
CHECK.
/*
- globalcsi
- the global zone CSI data set in which zone2 is
defined.
- zone2
- is the name of the target or distribution zone specified on the
COMPAREDTO operand (the comparison zone).
- command
- is the command to be used to install the SYSMODs: ACCEPT for a
distribution zone, and APPLY for a target zone.
- yy.ddd
- is the year and Julian date that the command was generated by
the REPORT SYSMODS command.
- hh:mm:ss
- is the time of day at which the command was generated by the REPORT
SYSMODS command.
- zone1
- is the name of the target or distribution zone specified on the
INZONE operand (the input zone).
- sysmdid
- is the ID of an applicable SYSMOD that appears in the SYSMOD Comparison
report.
A SYSMOD is commented out in the following cases:
- The SYSMOD is an APAR fix or a USERMOD.
- The SYSMOD or its owning function (FMID) is not in the global
zone.
- SMP/E cannot determine whether the SYSMOD is applicable to the
comparison zone.
- smdtype
- is the SYSMOD type of the indicated SYSMOD.
- fmid
- is the SYSMOD ID of the function that owns the indicated SYSMOD.
You can edit the SMPPUNCH output before using it. For example,
if any applicable SYSMODs were not in the global zone at the time
of the report and you have since received them, you may want to change
the comments for those SYSMODs to normal SELECT list values and install
them.
Note: There may have been SYSMODs whose applicability was unknown
(for example, they were not in the global zone), and which you have
determined to be applicable. You may want to receive these SYSMODs
and change them from comments to normal select list values so they
can be installed.
You can determine whether a SYSMOD is applicable
to the comparison zone by checking the program directory or installation
manual for the FMID to find out the SREL, or you can receive the SYSMOD
into the global zone and run the REPORT SYSMODS command again.
Multiple APPLY or ACCEPT commands may be generated if one or more
functions are being reinstalled. Each function SYSMOD to be reinstalled
appears on a separate APPLY or ACCEPT command along with its own service.
Other SYSMODs belonging to functions not being reinstalled appear
on a separate APPLY or ACCEPT command.