Document 1502927.1
Document 1502927.1
Document 1502927.1
In this Document
Purpose
Troubleshooting Steps
Common Issues When Submitting UBEs
All Server Platforms
Issue 1: Invalid Job Queue
Issue 2: Invalid Enterprise Server name in F986130
Issue 3: Unable to Insert Job Record in F989110 Because of Duplicate Job Number
Issue 4: Unable to Save Temporary Files on the Enterprise Server
Issue 5: Security Server is Disabled in Local JDE.INI
Issue 6: Spec Errors When Submitting from EnterpriseOne Web Client
Issue 7: Not Enough Disk Space on Web Server
Issue 8: "Not Authorized to Run Report" Errors in Server Process Log
Issue 9: Error "There was a problem with the server while running the business function
IsXMLP2SPPresent"
Issue 10: Error "There was a problem with the server while running the business function
IsPrinterMappingPresent"
Issue 11: Error "Security token not valid" when Submitting UBEs from a Windows/Fat Client
Issue 12: All UBEs fail with error, *ERRROR* LaunchUBE: LaunchUBE failed- JDEKDCL.h/UBEERRORCODE
error 22 user
Unix and Linux Server Platforms
Issue 1: Server Name Mismatch in F986130
Issue 2: All UBEs fail with error, *ERRROR* LaunchUBE: LaunchUBE failed[4] - Invalid Queuename - not
defined for server
AS/400 Server Platform
Issue 1: UBEs fail to Submit when SQL Server Mode is Enabled
Issue 2: AS/400 User Permissions Issues
Issue 3: Custom Job Queue outside System Library on AS400
Issue 4: Other AS/400 Issues
Other Less Common Issues
References
APPLIES TO:
PURPOSE
This document provides troubleshooting information and solutions to common issues that occur when submitting UBEs.
UBE submission issues are any issues that prevent a batch record to be added to the Job Table F986110. If a job record
is added to this table and it can be seen from Work with Submitted Jobs (WSJ) application, then the submission is
1 of 12 8/7/2022, 9:08 PM
Document 1502927.1 https://support.oracle.com/epmos/faces/DocumentDisplay?_adf.ctrl-stat...
considered to be successful. Any problem that happens after the record is added is considered a UBE processing or
runtime issue.
For more information on the UBE Submission process refer to Doc ID 1498831.1
For information and issues that happen while processing the UBE refer to Doc ID 1502974.1 and Doc ID 1502985.1
TROUBLESHOOTING STEPS
The majority of issues related to UBE Submission will result on the following error messages on EnterpriseOne clients:
Web Client: ERROR / Your report has NOT been submitted successfully.
Windows Client: Remote Job / An error occurred submitting batch REPORTID, VERSIONAME to SERVERNAME
When this happens the following errors will be found in client log, JAS logs or in the log created by the server process
which tried to submit the UBE on the server itself (report interconnect calls, business functions, SCHEDULER kernel,
RUNUBE and RUNUBEXML).
Web client:
[SEVERE] USERID - [KERNEL] *ERRROR* LaunchUBE: LaunchUBE failed- JDEKDCL.h/UBEERRORCODE error XX; job
Number = JOB# user:USERID Env:ENVIRONMENT
[SEVERE] USERID - [JAS] SubmitUBE.launchUBE() : Exception thrown during UBE submission! | Report Name :
REPORTID, Version Name : VERSIONNAME, Server Name : null, User Name : USERID
...
[SEVERE] USERID - [KERNEL] *ERRROR* LaunchUBE: Fatal: Internal LaunchUBE error. user:USER Env:JPD900
[SEVERE] USERID - [JAS] SubmitUBE.launchUBE() : Exception thrown during UBE submission! | Report Name :
REPORTID, Version Name : VERSIONNAME, Server Name : null, User Name : USERID
com.jdedwards.system.kernel.LaunchUBEException: Fatal: Internal LaunchUBE error.
Even though these symptoms are common to most issues related to job submission, their causes may vary. This is the
reason it is important to know the process in order to understand the potential points of failure.
A powerful tool in diagnosing submission issues is the UBEERRORCODE error number found in JAS logs when
submitting UBEs from a web client. These are the known codes and their meanings:
2 of 12 8/7/2022, 9:08 PM
Document 1502927.1 https://support.oracle.com/epmos/faces/DocumentDisplay?_adf.ctrl-stat...
JDEKDCL.h/UBEERRORCODE INVALID QUEUE NAME The default job queue does not
error 4 exist or is invalid
3 of 12 8/7/2022, 9:08 PM
Document 1502927.1 https://support.oracle.com/epmos/faces/DocumentDisplay?_adf.ctrl-stat...
JDEKDCL.h/UBEERRORCODE GET JOB NUMBER FAILED There were issues reading from
error 25 F986111. Example UBE kernel
fails to read F986111:
OCI0000017 - Unable to execute
statement for describe - SELECT
SVM920.F986111.*, ROWID
FROM SVM920.F986111 WHERE (
JCEXEHOST = :KEY1 ) ORDER BY
JCEXEHOST ASC FOR UPDATE OF
JCJOBNBR
If available, these error codes can lead you directly to the root cause of the issue.
For database related errors such as error 11 or error 15 , UBE kernel Logs will show you exact database errors such as:
Or
OR
You should then investigate with help of your Database Administrator , why these errors such as ORA-01653 or ORA-1
appear in logs. E.g.
Doc ID 1025288.6 Troubleshooting Guide - 'Unable to Extend / Create' Errors and Doc ID 151994.1 Overview Of
ORA-01653: Unable To Extend Table %s.%s By %s In Tablespace %s
You may also refer ORA errors resolutions here : ORA ERROR REFERENCE
In the following sections you will find known issues. Some of these issues are specific to the server platform.
4 of 12 8/7/2022, 9:08 PM
Document 1502927.1 https://support.oracle.com/epmos/faces/DocumentDisplay?_adf.ctrl-stat...
If for some reason the job queue the UBE defaults into does not exist in F986130 or in case of AS/400 servers is not
defined at the OS level, the job will fail to submit. This can be further verified by reviewing the UBE kernel log for
queries against table F986130. Typically in these cases you will find the following messages in the UBE kernel log:
JOBQ "INVQUEUE" does not exist - the job was not submitted
For more detailed information about how EnterpriseOne determines the appropriate Job Queue please review Doc ID
643483.1 E1: UBE: Job Queue Precedence and Inheritance for EnterpriseOne.
Changing the job queue to which the version defaults to or setting up the correct job queue in P986130 or AS/400
server will resolve the problem.
Also make sure that the appropriate queue type is defined in F986130 based on the underlying OS of server.
If you try to change your enterprise server by assigning it an ALIAS in HOSTS file or DNS server you might run into
problems submitting UBEs to that enterprise server.
Usual symptom besides the inability to submit UBEs to that server are the following messages in UBE kernel / RUNUBE
log:
The reason this happens is because when server processes start they automatically retrieve the ACTUAL server name
from the operating system (gethostname). This process bypasses any alias you might have defined elsewhere. Oracle
support does not recommend you use a server alias. Make sure you the correct name at the time you install your
servers as changing the name after the fact might require updates in several EnterpriseOne tables and is not supported
by Oracle. For reference, some suggestions are given in the issue below Server Name Mismatch in F986130.
Issue 3: Unable to Insert Job Record in F989110 Because of Duplicate Job Number
This issue may happen when the UBE kernel is unable to obtain a job number from server map table F986111 (Job
Number File) or when the next job number in F986111 and job numbers already in F986110 (Job Table) are out of sync
or overlap. These are the errors you will likely find in the UBE kernel log file:
In some cases if for some reason a job number cannot be retrieved from F986111, the UBE kernel may assume it to be
'0' (zero). What will happen then is that the very first UBE submitted to the server will run ok, but all subsequent jobs
will fail because they will all try to assume the number '0' and therefore fail to insert to table F986110. If you
5 of 12 8/7/2022, 9:08 PM
Document 1502927.1 https://support.oracle.com/epmos/faces/DocumentDisplay?_adf.ctrl-stat...
encounter this issue, you should capture the UBE kernel debug logs and look for any issues around queries against
F986111. One known scenario that will lead to this error is on installs with multiple AS/400 servers and when
communication between the servers is required in order to access F986111. Refer to Doc ID 642116.1 for more details
on issue and resolution.
Sometimes restoring either table F986111 or F986110 from backup will also cause this issue as the next job number
will likely be out of sync with records already in F986110. To address this situation, use Work with Submitted Jobs
(WSJ) application to find the record with the highest job number in F986110. Then update the record in server map
table F986111 with that job number plus '1'. Refer to Doc ID 658577.1 E1: UBE: How to Reset Job Numbers of UBE
Reports Submitted to the Server - for information on how to update the job number in F986111.
EnterpriseOne will try to save temporary files as part of submitting and running UBEs on the server. The location where
these files are saved is controlled by the parameter netTemporaryDir in the server JDE.INI or if this parameter is not
defined, by environment variables defined at the server operating system leve.
If the jdenet, UBE kernel or RUNBATCH are unable to create and access these temporary files, they will fail. If you
encounter a sudden systematic failure to submit or run UBEs on your enterprise server verify the temporary location
and make sure there is enough disk space to create new files, that the directory has not reached its maximum number
of files, or that it points to a valid location on the server.
[JDENET]
netTemporaryDir=path
where path points to a valid folder on your enterprise server. Note the OS User ID which starts EnterpriseOne services
need to have full access to this directory. On AS/400 servers this points to a directory in IFS.
You will not be able to submit UBEs from a Windows client and if a security server is not defined in the local JDE.INI.
The solution is to add a security server to your local JDE.INI:
[SECURITY]
SecurityServer=SERVERNAME
A clue of this issue is if you see the following message in the UBE kernel log:
UBE Submission spec issues on web clients are caused by problems with serialized report specs. Up until EnterpriseOne
application release 8.12 if a report version was created on a Windows client, it was necessary to generate any new
report version before you could submit it from a web client. If the version was not generated, then users would get a
pop-up message saying "COULD NOT LOAD REPORT / Please user the latest Java generator to regenerate the
report.REPORTID":
6 of 12 8/7/2022, 9:08 PM
Document 1502927.1 https://support.oracle.com/epmos/faces/DocumentDisplay?_adf.ctrl-stat...
With application release 8.12 and later object specs are generated on demand. This feature can however be disabled
through the jdbj.ini settings
autoDetectPackage=false
specGenerateOnDemand=false
If for some reason on-demand generation is disabled and a user tries to submit a new UBE version the job will fail to
submit and the following errors will be found in the jasroot log of your web server:
To address this issue you can either manually generate the report version, or enable auto-generation by setting the
following parameters in the web server jdbj.ini:
[JDBj-RUNTIME PROPERTIES]
autoDetectPackage=true
specGenerateOnDemand=true
Refer to Doc ID 787291.1 E1: GEN: Frequently Asked Questions on Spec Generation on Demand and Package Discovery
for more information on these parameters.
Another possibility is that EnterpriseOne is configured to process UBE reports and business functions on different
servers. The Business Function B98305V must follow the default UBE mapping. This Business Function actually prompts
the installation of specs to the server it is running on. If this Business Function is not running on the same server where
the UBE is being processed, the specs will never get installed. If this is the case, map this business function to the
same server as the DEFAULT UBE OCM definition.
In the process of submitting a version from a web client, the version specs, processing options, printer information will
be stored in a temporary file on the web application server (the location is defined by parameter tempFileDir in jas.ini).
If there is not enough space to store this file, the job will fail to submit. The following errors accompany this issue:
To address this problem make sure there is enough disk space on your web server. The directory also contains UBE
7 of 12 8/7/2022, 9:08 PM
Document 1502927.1 https://support.oracle.com/epmos/faces/DocumentDisplay?_adf.ctrl-stat...
PDFs (copied when viewing output in WSJ) which are automatically cleaned up. If the PDFs remain, they can be
deleted.
Review application security records that might be preventing the user ID, role or *PUBLIC from running the UBE. Once
security is modified the user should no longer see any error when submitting the UBE using a server process.
Issue 9: Error "There was a problem with the server while running the business function IsXMLP2SPPresent"
This error is usually seen after upgrading the tools release to 8.97 or 8.98 on EnterpriseOne 8.11SP1 and 8.12. The
issue is related to an enhancement to embedded BI Publisher which require business function N95620A to be compiled
on the new tools release and to operate together with later release of object P98305W.
The problem can be addressed by applying the latest ESUs containing P98305W for your application release, building a
full package and re-serializing all object specs.
Refer to Doc ID 837395.1 for more details about issues, symptoms and resolution.
Issue 10: Error "There was a problem with the server while running the business function
IsPrinterMappingPresent"
Logs shows this error message: Business function load failed - COBJLIB - _IsPrinterMappingPresent@12
This error is usually seen if the source and/or header files of the BSFN N95620A are missing.
The problem can be addressed by applying the latest ESUs containing BSFN N95620A for your application release,
building a full package and re-serializing all object specs. Otherwise try to promote the specs for this BSFN from
working environments and building an update package.
Issue 11: Error "Security token not valid" when Submitting UBEs from a Windows/Fat Client
This error indicates the security token for the Windows client is expired.
A security token is issued to the EnterpriseOne client at the time user logs in. This security token has an expiration
date/time. When submitting UBEs to sever, this security token is used to validate the user session and authorize the
user to run the UBE on the server. If enough time has passed however, the token will have expired, resulting on this
error message.
There is an internal time setting - "Regular Token Lifetime" that is timing out. The default setting for this timeout is 12
hours. To resolve the issue, the user will need to logout and back in and only then submit the UBE.
To change the timeout setting value, please see "Setting Up a Token Lifetime Configuration Record" in the
EnterpriseOne Security Administration guide available from the Oracle Technology Network documentation sit
Issue 12: All UBEs fail with error, *ERRROR* LaunchUBE: LaunchUBE failed- JDEKDCL.h/UBEERRORCODE
error 22 user
8 of 12 8/7/2022, 9:08 PM
Document 1502927.1 https://support.oracle.com/epmos/faces/DocumentDisplay?_adf.ctrl-stat...
jas log:
14 Aug 2020 00:44:58,179 [SEVERE] JDE - [KERNEL] *ERRROR* LaunchUBE: LaunchUBE failed-
JDEKDCL.h/UBEERRORCODE error 22 user:JDE Env:JPD910
14 Aug 2020 00:44:58,179 [SEVERE] JDE - [JAS] SubmitUBE.launchUBE() : Exception thrown during
UBE submission! | Report Name : R0006P, Version Name : XJDE0004, Server Name : <Server Name>,
User Name : JDE com.jdedwards.system.kernel.LaunchUBEException: LaunchUBE failed-
JDEKDCL.h/UBEERRORCODE error 22
• Make sure that the security server is enabled in jde.ini and pointing to the right server
• Make sure that the server jde.ini is pointing to the right pathcode.
This is a variation of the "Invalid Job Queue" problem described above. When UBE kernel looks for the job queue in
F986130 it tries to find the record based on three keys: job queue name, server name and jdenet port number.
Because Unix and Linux operating systems are case sensitive, if a server name is defined in upper case when installing
EnterpriseOne, queues in F986130 will also be in upper case. However a typical Unix or Linux server name will be in
lower case. This will lead to a mismatch and cause the query on F986130 to not return any result, making the UBE
kernel to interpret it as if the job queue was not correctly defined EnterpriseOne.
Just as before, this type of issue will result in the following message being written to the UBE kernel log:
This issue can be addressed by changing the server name to match that which is used in EnterpriseOne, or by manually
updating any table and file that has the server name in uppercase to lowercase. The former process is usually simpler.
In Linux for example the server name is usually defined in file '/etc/sysconfig/network'. The later process is not
supported by GCS, but some clients reported successful results following these steps:
• Change client machines INI files to reflect the new enterprise server name.
• Change JDE.INI on Enterprise server, including sections [INSTALL] and [BSFN BUILDER].
• Update tables F986130, F986110 (Job Table), F00053, F000531, and F000532 (B73.2 and lower) to reflect the
server name.
• You might need to update F9650, F9651 and F96511 tables as well.
• You should also change the data source names.
• Update the host files.
• Be sure you can ping the Enterprise server by name.
• Update services file on the host machine.
Issue 2: All UBEs fail with error, *ERRROR* LaunchUBE: LaunchUBE failed[4] - Invalid Queuename - not defined
9 of 12 8/7/2022, 9:08 PM
Document 1502927.1 https://support.oracle.com/epmos/faces/DocumentDisplay?_adf.ctrl-stat...
for server
Linux box was configured with the 'short' hostname as the FQDN name, whereas E1 was set up, P986130, to just use
"host" as the name (not FQDN). But the customer had 'host.example.com' in F986130.
11108 Tue Apr 6 12:29:44.400112 lanchube.c2991 LANCHUBE-0101-Failed to get queue type for
snrjdeent01d.snackinternal.com_6017_QBATCH
11108 Tue Apr 6 12:29:44.400707 queueapi.c221 QUEUE05000030-Failed to FetchKeyed for
snrjdeent01d.snackinternal.com_6017_QBATCH_ from F986130
11108 Tue Apr 6 12:29:44.400753 jdeknube.c1206 KNT0010080 - Queue
snrjdeent01d.snackinternal.com_6017_QBATCH_ is not defined in F986130
The PrimaryNode setting under the [CLUSTER] section tells the jdeGetHostName() API to use that name, instead of
what the OS-level 'gethostname()' API would return -- which, in this case, the gethostname() would return
host.example.com. There is no clustering, and this setting just acts as an override, allowing them to set the shortname
for E1, despite the OS being configured with the FQDN and the 'short' hostname.
Solution
1. Verify (in this case) FQDN lower case is set on Linux server (If FQDN is in lower case, verify value in Cluster is in
lower case)
2. Verified CLUSTER in JDE.INI setting has server name set to SHORT_HOST_NAME
3. Re-started ENT server
4. Tested by running R0006P
5. Version should run normally
6. Review WSJ and hostname, verify it was the same as the CLUSTER setting
JDE.INI Example
[CLUSTER]
PrimaryNode=shorthostname
Beginning with OneWorld Service Pack 23 and EnterpriseOne Tools Release 8.96 Bug 12520704, CLI SQL Server Mode
is enabled by default to support third party application Vertex 3.2.3 and later. This change caused some issues that
manifested themselves as issues submitting and running UBEs on AS/400 servers.
The majority of these issues are addressed either applying required IBM PTFs to server, or by disabling SQL Server
Mode when not using Vertex 3.2.3 or later, not using Vertex, or if using an application release prior to 8.12.
For detailed information about the different scenarios and issues related to SQL Server Mode review the following
documents:
Doc ID 661312.1 E1: UBE: Unable To Submit UBEs to AS/400 Server After Installing Service Pack 23 or Later
Doc ID 663627.1 E1: UBE: UBEs Fail to Run on EnterpriseOne 8.12 on AS/400 Server Due to Database Errors in
METADATA Kernel
10 of 12 8/7/2022, 9:08 PM
Document 1502927.1 https://support.oracle.com/epmos/faces/DocumentDisplay?_adf.ctrl-stat...
Doc ID 664626.1 E1: UBE: UBEs Fail to Run on EnterpriseOne 8.12 on AS/400 Server Due to Database Errors in UBE
Kernel
Doc ID 662878.1 E1: UBE: Memory Pool, Priority and QAQQINI Settings Are Not Being Inherited from Batch Job
It is important that the user under which EnterpriseOne services run on the server have the adequate privileges to
perform database operations and access EnterpriseOne libraries and directories in IFS.
One clue of permission issues is if you find the following type of error messages in the UBE kernel log:
ODB0000164 - STMT:00 [42000][-551] [IBM][iSeries Access ODBC Driver][DB2 UDB]SQL0551 - Not authorized to
object F986110 in SVM900 type *FILE.
ODB0000164 - STMT:00 [42000][-551] [IBM][iSeries Access ODBC Driver][DB2 UDB]SQL0551 - Not authorized to
object F986111 in SVM900 type *FILE
To address this type of issue make sure user ONEWORLD, PSFT or JDE have *ALL object authority, for example:
*PUBLIC *ALL X X X
Another scenario is when limited privileges prevents the use of the IBM i5/OS SwapUserProfile handle API to change
the job to run under the system user profile (proxy user) associated with the EnterpriseOne user account. In this case,
the UBE kernel will crash.
Refer to Doc ID 835577.1 E1: UBE: System Users Other Than JDE Cannot Run UBEs on IBM iSeries.
UBE fails to submit on the newly created custom Job queue on iseries in custom library.
[SEVERE] JDE [KERNEL] *ERRROR* LaunchUBE: LaunchUBE failed- JDEKDCL.h/UBEERRORCODE error 4; job Number =
1206500 user:JDE Env:JPY910
[SEVERE] JDE [JAS] SubmitUBE.launchUBE() : Exception thrown during UBE submission! | Report Name :
R98OWSECA, Version Name : XJDE0001, Server Name : null, User Name : JDE
com.jdedwards.system.kernel.LaunchUBEException: LaunchUBE failed- JDEKDCL.h/UBEERRORCODE error 4; job
Number = 1206500
[WARN ] JDE [RUNTIME] JASServiceException is occured in the SysFunctionStaement.launchBatchApp():Report
R98OWSECA_XJDE0001 has not been successfully submitted. The following JASServiceException has been
caught:Errors on JAS: Please check JAS.log for details.
Cause: The new job queue is created in Custom Library, which is not added to the Library List.
Solution: In case of custom library you need to ensure that the library containing the jobq is in the library list in which
the job is being submitted. The custom library hosting the custom jobQ should be reachable via *LIBL
To Resolve:
1) Add the custom library to the job description NETJOBD in library E910SYS. This is the job description that the E1
services uses when launching the E1 kernels
2) Stop and Start the E1 services on the as400 via server manager. Alternatively, logon to the AS400 machine as
11 of 12 8/7/2022, 9:08 PM
Document 1502927.1 https://support.oracle.com/epmos/faces/DocumentDisplay?_adf.ctrl-stat...
ONEWORLD user profiile and issue the ENDNET, CLRIPC and STRNET commands.
3) Retest by launching the batch job in custom job queue
Review Doc ID 2011153.1 E1: UBE: How to create custom Job Queue outside of System library list in IBM i (AS/400)
Doc ID 628191.1 E1: UBE: Unable to Submit Some UBEs from Web Client on OneWorld Xe, ERP8 or EnterpriseOne
Tools 8.95 and Older
Doc ID 638685.1 E1: UBE: Error "Failed to Validate Auth Token" When Submitting UBE's to Enterprise Server
Doc ID 646270.1 E1: UBE: Unable to Submit UBEs to AS/400 Enterprise Server Because Limited Access to QTEMP
Library
Doc ID 659422.1 E1: UBE: Submit UBE from Web Client Skips Printer Selection After Applying Baseline Tools ESU
JK14530 to EnterpriseOne 8.12
Doc ID 643398.1 E1: UBE: Unable to Submit UBEs from Custom Web Environment If Override Job Queue is Selected
Doc ID 1065903.1 E1: UBE: Intermittent Communication Problem on UBEs Submitting to Batch Server
Doc ID 1294416.1 E1: UBE: Unable to Submit UBEs to AS/400 Server Due to Database Error SQL7008 on Table
F986111
Doc ID 1374813.1 E1: UBE: Error "Local Submission Is Not Supported From Skinny Batch Versions/Menus" when
Submitting UBE from Standalone Client
Doc ID 1338447.1 E1: UBE: Unable to Submit UBEs Intermittently to AS/400 Server Because of Failure to Connect to
Server Map Data Source
Doc ID 1189698.1 E1: UBE: Unable To Submit UBEs to Server Receiving Error "IPC3400007 - startProcess
CreateProcess for runbatch.exe failed, err=2"
To discuss this information further with Oracle experts and industry peers, we encourage you to review, join or start
a discussion in the Design Tools & Output Technologies - JDE1 Community
To look at upcoming or archived Advisor Webcasts review Doc ID 1450327.1 Advisor Webcast JD Edwards
EnterpriseOne Schedule and Archived Recordings. If your topic is not currently scheduled please suggest it.
REFERENCES
12 of 12 8/7/2022, 9:08 PM