Skip to main content
Version: v1.8.x

Troubleshooting z/OS Services

Troubleshooting z/OS Services

The following topics contain information that can help you troubleshoot problems when you encounter unexpected behavior installing and using Zowe™ z/OS Services.

z/OS Services are unavailable#

Solution:

If the z/OS Services are unavailable, take the following corrective actions.

  • Ensure that the z/OSMF REST API services are working. Check the z/OSMF IZUSVR1 task output for errors and confirm that the z/OSMF RESTFILES services are started successfully. If no errors occur, you can see the following message in the IZUSVR1 job output:

    CWWKZ0001I: Application IzuManagementFacilityRestFiles started in n.nnn seconds.

    To test z/OSMF REST APIs you can run curl scripts from your workstation.

    curl --user <username>:<password> -k -X GET --header 'Accept: application/json' --header 'X-CSRF-ZOSMF-HEADER: true' "https://<z/os host name>:<securezosmfport>/zosmf/restjobs/jobs?prefix=*&owner=*

    where the securezosmfport is 443 by default. You can verify the port number by checking the izu.https.port variable assignment in the z/OSMF bootstrap.properties file.

    If z/OSMF returns jobs correctly, you can test whether it is able to returns files by using the following curl scripts:

    curl --user <username>:<password> -k -X GET --header 'Accept: application/json' --header 'X-CSRF-ZOSMF-HEADER: true' "https://<z/os host name>:<securezosmfport>/zosmf/restfiles/ds?dslevel=SYS1"

    If the restfiles curl statement returns a TSO SERVLET EXCEPTION error, check that the the z/OSMF installation step of creating a valid IZUFPROC procedure in your system PROCLIB has been completed. For more information, see the z/OSMF Configuration Guide.

    The IZUFPROC member resides in your system PROCLIB, which is similar to the following sample:

    //IZUFPROC PROC ROOT='/usr/lpp/zosmf'  /* zOSMF INSTALL ROOT     *///IZUFPROC EXEC PGM=IKJEFT01,DYNAMNBR=200                          //SYSEXEC  DD DISP=SHR,DSN=ISP.SISPEXEC                            //         DD DISP=SHR,DSN=SYS1.SBPXEXEC                           //SYSPROC  DD DISP=SHR,DSN=ISP.SISPCLIB                            //         DD DISP=SHR,DSN=SYS1.SBPXEXEC                           //ISPLLIB  DD DISP=SHR,DSN=SYS1.SIEALNKE                           //ISPPLIB  DD DISP=SHR,DSN=ISP.SISPPENU                            //ISPTLIB  DD RECFM=FB,LRECL=80,SPACE=(TRK,(1,0,1))                //         DD DISP=SHR,DSN=ISP.SISPTENU                            //ISPSLIB  DD DISP=SHR,DSN=ISP.SISPSENU                            //ISPMLIB  DD DISP=SHR,DSN=ISP.SISPMENU                            //ISPPROF  DD DISP=NEW,UNIT=SYSDA,SPACE=(TRK,(15,15,5)),            //         DCB=(RECFM=FB,LRECL=80,BLKSIZE=3120)                     //IZUSRVMP DD PATH='&ROOT./defaults/izurf.tsoservlet.mapping.json'  //SYSOUT   DD SYSOUT=H                                              //CEEDUMP  DD SYSOUT=H                                              //SYSUDUMP DD SYSOUT=H                                              //                                                                 

    Note: You might need to change paths and data sets names to match your installation.

    A known issue and workaround for RESTFILES API can be found at TSO SERVLET EXCEPTION ATTEMPTING TO USE RESTFILE INTERFACE.

  • Check your system console log for related error messages and respond to them.