SMPPUNCH output

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.