Oracle® Application Server Adapters for VSAM User's Guide 11g Release 1 (11.1.1) Part Number E16088-01 |
|
|
View PDF |
Troubleshooting Oracle AS Adapter for VSAM involves checking various definitions and properties in Oracle Connect, including daemon status, workspace options, server parameters, and various system logs.
This chapter contains the following topics:
Troubleshooting the daemon and the communication between Oracle Application Server and OracleAS Adapter for VSAM is performed using Oracle Studio. It is used to monitor the daemon and server activity and control what happens to the daemon and server processes.
See Also:
Appendix C, "Advanced Tuning of the Daemon" for details about the configuration settings.This section contains the following topics:
The daemon is started when OracleAS Adapter for VSAM is installed. In case you have shut down the daemon, as described in "Shutting Down the Daemon", you can restart the daemon as described in the following task.
Note:
The daemon is started on the IBM z/OS platform. It cannot be started remotely using Oracle Studio.To shut down the daemon use Oracle Studio, as follows:
From the Start menu, select Start, Programs, Oracle, and then select Studio.
Select the computer defined in Setting Up the IBM z/OS Platform in Oracle Studio.
Right-click the computer and select Open Runtime Perspective.
In the Runtime Explorer, right-click the computer and select Shutdown Daemon.
Use the Runtime Manager perspective of Oracle Studio to monitor the daemon during run time.
Perform the following steps:
From the Start menu, select Start, Programs, Oracle, and then select Studio.
Right-click the computer defined in Setting Up the IBM z/OS Platform in Oracle Studio, and select Open Runtime Perspective.
You can manage the daemon by expanding the relevant node, daemon, workspace or server process, as described in the following sections.
Right-click the daemon to display the options available for it, including the ability to display the daemon log.
The following table lists the available daemon options:
Table 7-1 Daemon Options
Option | Description |
---|---|
Edit Daemon Configuration |
Opens the daemon editor, which enables you to reconfigure the daemon. For more information, see Appendix C, "Advanced Tuning of the Daemon" for details about the configuration settings. |
Status |
Checks the status of the daemon. The information about the daemon includes the name of the daemon configuration used, the active client sessions, and logging information. |
Reload Configuration |
Reloads the configuration after any changes. Servers currently started are not affected by the changed configuration. For more information, see Appendix C, "Advanced Tuning of the Daemon" for details about the configuration settings. |
View Log |
Displays the daemon log. For more information, see "Daemon Logs". |
View Events |
Displays the daemon events log. |
Daemon Properties |
Displays information about the computer where the daemon is running, such as the physical address and any user name and password needed to access the computer. |
Recycle servers |
Closes all unused servers and prepares all active servers to close when the client disconnects. New connection requests are allocated with new servers. |
Kill servers |
Immediately closes all active and unused servers. Note: Use this option with caution, as it may lead to data loss. |
Shutdown Daemon |
Shuts down the daemon on the computer. |
Rename |
Enables changing the name of the daemon displayed in the Runtime Explorer. |
Remove |
Removes the daemon from the Runtime Explorer. |
Refresh |
Refreshes the display. |
Right-click a workspace to display the options available for the workspace, including the ability to display the workspace log.
The following table lists the available options:
Table 7-2 Workspace Options
Option | Description |
---|---|
Edit Workspace Configuration |
Opens the daemon editor to enable you to reconfigure the workspace. For more information, see Appendix C, "Advanced Tuning of the Daemon" for details about the configuration settings. |
Status |
Checks the status of the workspace whether it is available or not. |
Reload Configuration |
Reloads the configuration of the workspace after any changes. Servers currently started are not affected by the changed configuration. |
View Log |
Displays the log for all servers for the workspace. For more information, see "Daemon Logs" |
View Events |
Displays the workspace events log. |
Recycle Servers |
Closes all unused servers and prepares all active servers to close when the client disconnects. New connection requests are allocated with new servers. |
Kill Servers |
Immediately closes all active and unused servers. Note: Use this option with caution, as it may lead to data loss. |
Remove |
Removes the selected workspace from the Runtime Explorer. |
Disable |
Disables the selected workspace. |
Refresh |
Refreshes the display. |
Right-click a server to display the options available for the server, including the ability to display the server log.
The options available at the server level are listed in the following table:
Table 7-3 Server Options
Option | Description |
---|---|
Status |
Checks the status of the server. The information about the server includes the server mode and the number of active client sessions for the server. |
View Log |
Displays the server log. For more information, see "Daemon Logs". |
View Events |
Displays the server events log. |
Kill server |
Ends the server process, regardless of its activity status. Note: Use this option with caution, as it may lead to data loss. |
Refresh |
Refreshes the display. |
Oracle Connect produces several logs that you can use to troubleshoot problems. The daemon manages the following logs:
Daemon
Workspace
Server process
The Runtime Manager perspective of Oracle Studio provides a monitor for these logs as shown in the following figure:
Display the required log by right-clicking the level you want (daemon, workspace or server) and selecting View Log. Each log is displayed in a different tab. You can flick between logs by clicking the required tab.
The daemon log displays activity between clients and the daemon, including clients logging in and logging out from the daemon.
You can change the level of logging by clicking Properties. The following levels of logging are available:
none
: The log displays who has logged in and out from the daemon.
error
: The log displays who has logged in and out from the daemon and any errors that have been generated.
debug
: The log displays who has logged in and out from the daemon, any errors that have been generated, and any tracing that has been specified in the daemon configuration.
See Also:
"Logging".The workspace log displays information about the workspace being used by the client.
You can change the level of logging by clicking Properties. The following levels of logging are available:
none
: The log displays who has connected and disconnected from the server process.
error
: The log displays who has connected and disconnected from the server process and any errors that have been generated.
debug
: The log displays who has connected and disconnected from the server process, any errors that have been generated, and any tracing that has been specified in the daemon configuration.
See Also:
"Logging".The server log displays activity between clients and the server process used by that client to handle the client request.
You can change the level of logging by clicking Properties. The following levels of logging are available:
none
: The log displays who has connected and disconnected from the server process.
error
: The log displays who has connected and disconnected from the server process and any errors that have been generated.
debug
: The log displays who has connected and disconnected from the server process, any errors that have been generated, and any tracing that has been specified in the daemon configuration.
See Also:
"Logging".When Oracle Studio disconnects from the IBM z/OS computer, the computer is displayed in Oracle Studio with an X in a red circle. If this situation occurs, try to access the computer later.
The following table describes the various scenarios that may exist when Oracle Application Server disconnects from the IBM z/OS computer.
Table 7-4 Scenarios When a Client Is Disconnected
To troubleshoot client/server communication problems, you must be familiar with the following:
Daemon configuration settings
Oracle Connect security
TCP/IP subsystem. Oracle Application Server Adapter for VSAM uses TPC/IP for internal intercomputer communications.
System details, such as the account name and password of the administrator account, the IP address of the computers involved and whether a portmapper is being used.
The following error messages relate to errors received from Oracle Connect.
See Also:
"Security".See Also:
"Security".See Also:
"General".Number of sub-tasks
in the WS Server section of the daemon configuration.
See Also:
"Server Mode".[C015] Failed to start NAVIGATOR server process: No server account name defined for anonymous client; code: -1601: SQL code: 0
To set impersonation:
APF authorize all the steplibs in the server script on a z/OS computer. For example:setprog... ada622-volume adavol CICS.CICS.SDFHEXCI - p390dx INSTROOT.load - 111111 INSTROOT.loadaut - 111111
INSTROOT
is the high level qualifier where Oracle Connect is installed.
In the Security tab of the Navigator workspace, under the daemon node in the Configuration Explorer, select Use specific workspace account and clear the Workspace account field of all values.
See Also:
"General".Set maximum number of servers
and Maximum
parameter for the Clients per server limit in the WS Server section of the daemon configuration.
See Also:
"Server Mode".See Also:
"Logging".Clients per server limit
field value in the WS Info. section of the daemon configuration.
See Also:
"General".