z/OSMF | Applying Maintenance Gets TsoServletException
search cancel

z/OSMF | Applying Maintenance Gets TsoServletException

book

Article ID: 253133

calendar_today

Updated On:

Products

SYSVIEW Performance Management

Issue/Introduction

User sees the following message when trying to start the z/OSMF recommended maintenance process for SYSVIEW:

Data set 'DSN.SMPOUT' in system SYSX cannot be allocated.
message: startDispatcher: received unexpected TsoServletException while starting dispatcher (see log)
category: 2
rc: 4
reason: 2

We also see an SVC dump for the CEA address space as follows:

DUMP TITLE=COMPON=CEA,COMPID=SCCEA,ISSUER=CEAMIREC,MODULE=CEAWI 
         FCN+01EE,ABEND=S01D0,REASON=060E0415                 

The message above says that SMPOUT cannot be allocated. The user reviewed all DDDEFs in the SYSVIEW target zone - identifying one present for SMPOUT:

SYSOUT CLASS: *

Environment

Release : 17.0

Cause

This KD was created because the resolution doesn't have anything to do with the errors received above. Instead, the customer identified a PROCLIB concatenation entry from an older z/OS release. This was found by reviewing the z/OSMF user log and identifying the following:

TSSJNP IZUFPROC IZUFPROC - ABEND=S222 U0000 REASON=00000000

z/OSMF was attempting a logon using IZUFPROC but it wasn't in the expected PROCLIB and differed from the one IBM provides in "SYS1.IBM.PROCLIB".

Resolution

The IZUFPROC in the local library showed the following:

//IZUFPROC EXEC PGM=IKJEFT01,DYNAMNBR=200                          
//****************************************************************/
//* TSO PROCEDURE FOR THE Z/OS DATA SET AND FILE REST API        */
//*                                                              */
//* PROPRIETARY STATEMENT:                                       */
//*                                                              */
//*     LICENSED MATERIALS - PROPERTY OF IBM                     */
//*     5610-A01                                                 */
//*     COPYRIGHT IBM CORP. 2014                                 */
//*     STATUS = HSMA210                                         */
//****************************************************************/

HSMA210 is the FMID for z/OS 2.1. it was probably copied in there quite some time ago.


The one in SYS1.IBM.PROCLIB showed this:

//IZUFPROC PROC ROOT='/usr/lpp/zosmf'  /* zOSMF INSTALL ROOT     */
//         EXPORT SYMLIST=(XX)                                    
//         SET QT=''''                                            
//         SET XX=&QT.&ROOT.&QT.                                  
//IZUFPROC EXEC PGM=IKJEFT01,DYNAMNBR=200                         
//****************************************************************/
//* TSO LOGON PROC FOR Z/OS DATA SET AND FILE REST INTERFACE     */
//*                                                              */
//* PROPRIETARY STATEMENT:                                       */
//*                                                              */
//*     LICENSED MATERIALS - PROPERTY OF IBM                     */
//*     5650-ZOS                                                 */
//*     COPYRIGHT IBM CORP. 2014, 2019                           */
//*     STATUS = HSMA240                                         */
//****************************************************************/

HSMA240 is the FMID for z/OS 2.4.


To resolve this, the site renamed the one in the local library and copied IZUFPROC from SYS1.IBM.PROCLIB to the local library. The z/OSMF user is able to proceed, showing the following screen when selecting the ‘Install Recommended’ button: