Skip to main content
Version: v1.9.x LTS

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.