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.