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.

Unable to generate unique CeaTso APPTAG

Symptom:

When you request a Zowe data set or z/OS Files API, you receive a response code 500 - 'Internal Server Error', with a message "Unable to generate unique CeaTso APPTAG".

Solution:

Check z/OSMF settings of REST API of file. You must define RESTAPI_FILE in IZUPRMxx by the following statement:

RESTAPI_FILE ACCT(IZUACCT) REGION(32768) PROC(IZUFPROC)

The default IZUFPROC can be found in SYS1.PPROCLIB. And the proper authorization is needed to get IZUFPROC work successfully.

z/OS Services are unavailable

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.