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 RC11
Reason code 11 means that a class file is missing.
Check if auifw.jar, cwbuntpi.jar & cwbuntuc.jar are missing by doing WRKLNK '/qibm/proddata/os400/universalconnection/*'
Check also for JAVA_HOME environment variable. If pointing to an older JDK, need to be removed.
Check the options from above error, might help as well.
Assure to also have the latest Recommended Fixes for Electronic Services:
- 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.
- Check whether these ports, 8470-8476, can be used. More information in following link: https://www.ibm.com/docs/en/i/7.4?topic=numbers-port-host-servers-server-mapper
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 - Check whether these ports, 8470-8476, can be used. More information in following link: https://www.ibm.com/docs/en/i/7.4?topic=numbers-port-host-servers-server-mapper
Document Location
Worldwide
Was this topic helpful?
Document Information
Modified date:
17 February 2022
UID
nas8N1022494