The following topics contain information that can help you troubleshoot problems when you encounter unexpected behavior installing and using Zowe z/OS Services.
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
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.