IBM Support

CRTSRVCFG/CHGSRVCFG fails with msgCPD0A35: Java exception not handled for user-defined

Troubleshooting


Problem

CRTSRVCFG fails with CPD0A35 Java exception not handled for user-defined category.

Diagnosing The Problem

CPD0A35 could have different RC posted. Usually are solved by following recreation steps, assuring to delete all the IFS files listed, from document:

Configuration Instructions for Electronic Customer Support (ECS) and Electronic Service Agent (ESA) for IBM i

If that doesn't solve the problem, the following are the most typical ones received with more steps to try.

Resolving The Problem

NOTE: If the RC received is not listed, or the steps described for your RC don't help, check steps from RC255 anyway.

  • CPD0A35 RC255

    1. QSECOFR user profile is disabled or its password expired. Check by doing DSPUSRPRF USRPRF(QSECOFR) and correct if needed.


    2. User QTCP has insufficient authority to the /TCPIP and /PPP directories
    WRKLNK '/QIBM/userData/OS400/'
    Locate the TCPIP directory
    Select opt 9=work with authority
    Verify user QTCP has *RWX data authority
    If not, 1=add user QTCP or 2=change user authority
    After verifying/changing, press F12=cancel
    Select opt 5=display next to the TCPIP directory
    Locate the PPP directory
    Select opt 9=Work with authority
    Verify user QTCP has *RWX Data Authority


    3. Verify the QSERVER subsystem is active by doing WRKSBS and put 5=Display subsystem description next to the entry.


    4. Exit programs for exit point QIBM_QPWFS_FILE_SERV and QIBM_QZRC_RMT. Do the following to check:
    WRKREGINF
    Locate exit point QIBM_QPWFS_FILE_SERV
    select opt 8=work with exit programs
    Is there an exit program? If so remove it

    Locate exit point QIBM_QZRC_RMT
    select opt 8=work with exit programs
    Is there any exit programs? If so remove it
    Press F12=cancel


    5. TCP/IP is not configured as expected on the system. Verify the TCP/IP configuration:
    CFGTCP and select option 12. Change TCP/IP domain information.
    Must have a host name and domain name.
    The Host Name Search Priority should be set to *LOCAL
    There should be at least one IP address listed under the Domain Name Server. If there are multiple addresses, each must be unique.

    CFGTCP and select option 10. Work with TCP/IP host table entries.
    Locate the host table entry for the system, What is the IP address associated with this entry?
    This entry should contain the short name for the system (Host Name from CFGTCP option 12) and the long name (HostName.DomainName from CFGTCP option 12).
    Use option 2=Change to make any changes, if necessary. There should not be any other Host Table Entries that have the same short and/or long name for the system.

    CFGTCP and select option 2. Work with TCP/IP routes.
    There should be a *DFTROUTE. The Next Hop should be valid as well.

    CFGTCP and select option 1. Work with TCP/IP interfaces.
    Locate the IP address shown for the system under CFGTCP option 10, then press F11=Display interface status.
    This Interface should be ACTIVE

    PING LOOPBACK and LOCALHOST and ensure it is successful. Both should return 127.0.0.1.


    7. Review NETSTAT Option 3 to verify HostServers are started or restart them by doing:
    ENDHOSTSVR *ALL
    STRHOSTSVR *ALL

     

  • CPD0A35 RC-9


    Reason code -9 means that no Java Development Kit is installed on the system.

    ECS requires JDK 8 be used.
    Ensure that product 5770JV1 options 16 and 17 be installed along with the latest Java group PTF

     

  • CPD0A35 RC17


    This typically indicates an issue with the Java or PASE install on the system. If so, will require a reinstall of the product options and PTFs.
    Output from the following program can usually confirm:
    QSYS/CALL PGM(QSYS/QHCRPRECHK) PARM('-v')
    Review if anything is marked as ERROR

    Another less common cause, is if the system is redirecting standard out (STDIO). Use the following commands to determine what is set:
    WRKENVVAR LEVEL(*JOB)
    WRKENVVAR LEVEL(*SYS)

    If you find QIBM_USE_DESCRIPTOR_STDIO is set, make note of the current value.
    In order to create the service configuration, temporarily change the environment variable then set it back after creating the configuration. For example:
    1. CHGENVVAR ENVVAR(QIBM_USE_DESCRIPTOR_STDIO) VALUE('N') LEVEL(*JOB)
    2. CHGENVVAR ENVVAR(QIBM_USE_DESCRIPTOR_STDIO) VALUE('N') LEVEL(*SYS)
    3. Create the service configuration by using CRTSRVCFG
    4. CHGENVVAR ENVVAR(QIBM_USE_DESCRIPTOR_STDIO) VALUE('Y') LEVEL(*JOB)
    5. CHGENVVAR ENVVAR(QIBM_USE_DESCRIPTOR_STDIO) VALUE('Y') LEVEL(*SYS)

  • CPD0A35 RC4


    Reason code 4 is likely related to QSECOFR disabled or password expired.

    Check by doing DSPUSRPRF USRPRF(QSECOFR) and correct if needed.

  • CPD0A35 RC5


    There are numbers of possible problems leading into this. Could be issued by running in restricted state or directly from console. Another option is not having Host Servers running or incorrect TCP configuration.
     

    Review NETSTAT Option 3 to verify HostServers are started or restart them by doing: ENDHOSTSVR *ALL

    STRHOSTSVR *ALL

    Are the host servers started? If started, then try the following commands:

    STRQSH

    export -s CLASSPATH=/QIBM/ProdData/HTTP/Public/jt400/lib/jt400.jar

    java utilities.JPing localhost

    This checks if toolbox whether able to connect to the local host servers. Something like this display if all is correct:

    > java utilities.JPing localhost                              
    
      Verifying connections to system localhost...                
                                                                  
      Successfully connected to server application:  as-file      
      Successfully connected to server application:  as-netprt    
      Successfully connected to server application:  as-rmtcmd    
      Successfully connected to server application:  as-dtaq      
      Successfully connected to server application:  as-database  
      Successfully connected to server application:  as-ddm       
      Successfully connected to server application:  as-central   
      Successfully connected to server application:  as-signon    
      Connection verified                                         
      $   
    • TCP/IP is not configured as expected on the system. Verify the TCP/IP configuration:

    CFGTCP and select option 12. Change TCP/IP domain information.
    Must have a host name and domain name.
    The Host Name Search Priority should be set to *LOCAL
    There should be at least one IP address listed under the Domain Name Server. If there are multiple addresses, each must be unique.

    CFGTCP and select option 10. Work with TCP/IP host table entries.
    Locate the host table entry for the system, What is the IP address associated with this entry?
    This entry should contain the short name for the system (Host Name from CFGTCP option 12) and the long name (HostName.DomainName from CFGTCP option 12).
    Use option 2=Change to make any changes, if necessary. There should not be any other Host Table Entries that have the same short and/or long name for the system.

    CFGTCP and select option 2. Work with TCP/IP routes.
    There should be a *DFTROUTE. The Next Hop should be valid as well.

    CFGTCP and select option 1. Work with TCP/IP interfaces.
    Locate the IP address shown for the system under CFGTCP option 10, then press F11=Display interface status.
    This Interface should be ACTIVE

    PING LOOPBACK and LOCALHOST and ensure it is successful. Both should return 127.0.0.1

    • Other problem might be the exit program blockage. Exit programs for exit point QIBM_QPWFS_FILE_SERV and QIBM_QZRC_RMT. Do the following to check:
       

    WRKREGINF
    Locate exit point QIBM_QPWFS_FILE_SERV
    select opt 8=work with exit programs
    Is there an exit program? If so remove it

    Locate exit point QIBM_QZRC_RMT
    select opt 8=work with exit programs
    Is there any exit programs? If so remove it
    Press F12=cancel

Document Location

Worldwide

[{"Type":"MASTER","Line of Business":{"code":"LOB57","label":"Power"},"Business Unit":{"code":"BU058","label":"IBM Infrastructure w\/TPS"},"Product":{"code":"SWG60","label":"IBM i"},"ARM Category":[{"code":"a8m0z0000000CGRAA2","label":"Electronic Service Agent"}],"ARM Case Number":"","Platform":[{"code":"PF012","label":"IBM i"}],"Version":"All Versions"}]

Document Information

Modified date:
17 February 2022

UID

nas8N1022494