AVOID VMFP2P1965E ERROR FOR MONDCSS SEGMENT BUILD


 
 APAR Identifier ...... VM65651      Last Changed ........ 15/03/12
 AVOID VMFP2P1965E ERROR FOR MONDCSS SEGMENT BUILD
 
 Symptom ...... IN INCORROUT         Status ........... CLOSED  PER
 Severity ................... 3      Date Closed ......... 15/03/05
 Component .......... 568411209      Duplicate of ........
 Reported Release ......... 630      Fixed Release ............ 999
 Component Name ESA VMSESS           Special Notice
 Current Target Date ..15/01/29      Flags
 SCP ...................
 Platform ............
 
 Status Detail: SHIPMENT - Packaged solution is available for
                           shipment.
 
 PE PTF List:
 
 PTF List:
 Release A62   : UM34557 available 15/03/12 (1000 )
 Release A63   : UM34558 available 15/03/12 (1000 )
 Release 620   : UM34559 available 15/03/12 (1000 )
 Release 630   : UM34560 available 15/03/12 (1000 )
 
 Parent APAR:
 Child APAR list:
 
 ERROR DESCRIPTION:
 Attempts to rebuild the MONDCSS saved segment using PUT2PROD
 (whether on an individual basis, or when all segments are
 rebuilt using a PUT2PROD SEGMENTS ALL command) often fail
 because one or more virtual machines continue to actively use
 this segment during service-related tasks.  The messages that
 follow are indicative of this kind of problem:
 ...
  VMFP2P1965E The command, SEND BLDSEG EXEC VMFBLD PPF SEGBLD
              ESASEGS SEGBLIST MONDCSS.SEGMENT LINK (ALL NOLOG,
              failed with return code 8
  VMFP2P2760I PUT2PROD processing completed unsuccessfully for
              SEGMENTS
  VMFP2P2760I PUT2PROD processing completed unsuccessfully
 ...
 
 LOCAL FIX:
 Ensure no users are actively using the MONDCSS segment when
 service tasks are performed.  Such users can be identified
 via the command: CP QUERY NSS USERS MONDCSS
 (Here, the the monitor segment name of 'MONDCSS' is presumed to
 be in use).
 
 PROBLEM SUMMARY:
 ****************************************************************
 * USERS AFFECTED: All z/VM customers applying z/VM service.    *
 ****************************************************************
 * PROBLEM DESCRIPTION:                                         *
 ****************************************************************
 * RECOMMENDATION: APPLY PTF                                    *
 ****************************************************************
 When the MONDCSS segment is rebuilt, the segment cannot be in
 active use by any users (which, for a system that is actively
 collecting monitor data would be a normal case).  Currently,
 when this segment is built using the PUT2PROD SEGMENTS
 command, and the segment is in use, the build attempt fails
 and the previously described errors are reported.  These
 messages, and their explanatory documentation, do not provide
 sufficient information for one to take corrective actions that
 will allow an ensuing segment build to complete as intended.
 Better information about this type of segment build error is
 needed to assist whomever is performing the segment-related
 maintenance tasks.
 
 PROBLEM CONCLUSION:
 The PUT2PROD EXEC has been updated to include additional logic
 to determine whether the monitor segment (defined with the
 default name of MONDCSS, or otherwise) is in active use by any
 user IDs.  If the monitor segment is found to be in use, and
 this is the -only- segment that is to be built, this condition
 will be reported by a new message, VMF1241E, and no attempt will
 be made to build the segment.  PUT2PROD command processing will
 end due to this error condition.
 
 If the monitor segment is in use, and it is being built in
 conjunction with other segments (as is done for a PUT2PROD
 SEGMENTS ALL command), message VMF1241W will be reported.
 Again, this segment will not be built, but processing will
 continue to allow the building of other segments to continue.
 
 PUT2PROD also has been modified with this APAR, such that its
 terminating message (2760) now will have a severity that
 reflects encountered conditions (W, for encountered warnings, E
 for encountered errors), instead of informational (I)
 status for all invocations.
 
 Documentation updates that pertain to new messages VMF1241W and
 VMF1241E are cited below.
 
 The following changes have been made to the system reference
 libraries:
 
 ***START PUBLICATION CHANGE*************************************
 Publication Title: z/VM: Other Components Messages and Codes
 Release:      z/VM 6.3.0
 Order number: GC24-6207-02
 Release:      z/VM 6.2.0
 Order number: GC24-6207-01
 
 ----------------------------------------------------------------
 Chapter 3. System Messages
 Section: VMSES/E Messages
 Page(s): 166  <z/VM 6.3.0>
          165  <z/VM 6.2.0>
 
 The description for messages VMF11241 is added:
 
  --------------------------------------------------------------
  VMF1241W  Segment segname cannot be built because it in use by
            these user IDs: userid_list
            (The segment is also in use by CP system event and
            sample monitoring)
 
  Explanation:  The monitor saved segment cited by the message is
  actively being used by one or more user IDs, as listed by the
  message.  Because this segment is in active use, it cannot be
  built at this time.
 
  Use of the segment by the CP system (listed as user ID
 
  'SYSTEM') is further noted by additional message text, when
  appropriate.
 
  System Action:  RC=4. Command processing continues.
 
  User Response:  The monitor saved segment needs to be rebuilt
  only when the definition for it has been altered (such as to
  increase the segment size).  However, when PUT2PROD is used to
  build ALL segments, or the monitor segment is named along with
  other segments that are to be built, an attempt will be made to
  build the monitor segment.  If no definition changes have been
  made with respect to the monitor segment, this warning
  condition can likely be dismissed.
 
  If monitor segment definition changes have been made, then take
  appropriate action for each listed user ID to discontinue its
  use of the named segment.  Such action might require logging
  off the subject virtual machine, or instead, quiescing the
  services that it provides.  When necessary, CP system event or
  sample monitoring can be stopped by use of the CP MONITOR STOP
  command.
 
  If the subject segment is in use by the CP system (listed as
  user ID 'SYSTEM') for event or sample monitoring, this activity
  also must be stopped before the segment can be built.
 
  After the segment has been successfully built, take appropriate
  action to resume its use by the listed user IDs.
 
  For more information about the monitor segment and its use,
  consult the z/VM Performance Toolkit Guide or z/VM Performance
  publications.
 
  --------------------------------------------------------------
  VMF1241E  Segment segname cannot be built because it in use by
            these user IDs: userid_list
            (The segment is also in use by CP system event and
            sample monitoring)
 
  Explanation:  The monitor saved segment cited by the message is
  actively being used by one or more user IDs, as listed by the
  message.  Because this segment is in active use, it cannot be
  built at this time.
 
  Use of the segment by the CP system (listed as user ID
  'SYSTEM') is further noted by additional message text, when
  appropriate.
 
  System Action:  RC=100. Command processing stops.
 
  User Response:  The monitor saved segment needs to be rebuilt
  only when the definition for it has been altered (such as to
  increase the segment size).  Because PUT2PROD has been invoked
  specifically to build just this segment, it is presumed to be
  to account for changes to the segment definition.
 
  Take appropriate action for each listed user ID to discontinue
  its use of the named segment.  Such action might require
  logging off the subject virtual machine, or instead, quiescing
  the services that it provides.  When necessary, CP system event
  or sample monitoring can be stopped by use of the CP MONITOR
  STOP command.
 
  If the subject segment is in use by the CP system (listed as
  user ID 'SYSTEM') for event or sample monitoring, this activity
  also must be stopped before the segment can be built.
 
  After the segment has been successfully built, take appropriate
  action to resume its use by the listed user IDs.
 
  For more information about the monitor segment and its use,
  consult the z/VM Performance Toolkit Guide or z/VM Performance
  publications.
 
 ***END PUBLICATION CHANGE***************************************
 
 TEMPORARY FIX:
 
 COMMENTS:
 
 MODULES/MACROS:   PUT2PROD VMFUME   VMFUMEA  VMFUMEB  VMF1241E
 VMF1241W
 
 SRLS:      GC24620701 GC24620702
 
 RTN CODES:
 
 CIRCUMVENTION:
 
 MESSAGE TO SUBMITTER: