|
|
This chapter contains the following sections:
SNA View processes relay operating and error messages to several locations.
All SNA View errors are of the form SVXXXnnn message_text, where, XXX is a 2- or 3-letter message category, and nnn is a 3-digit numeric identifier, such as:
SVSOK050 Socket connect failed, will retry momentarily.
This message is from the Socket Communications Messages (SOK) component and has a message identifier of 050. This information can be used to locate the message in this chapter. This chapter provides a detailed description of each message and, if appropriate, a recommended user response.
SNA View contains a debug facility that can be enabled to generate data about SNA View processes. SNA View is shipped with a default debug parameter file in which debug mode is turned OFF for all SNA View processes. There may be times when this debug information is necessary, such as when providing Cisco TAC personnel with problem reports of SNA View errors. It is possible to generate detailed debug data for any reproducible problem.
The SNA View debug parameter file resides in the $SVHOME/parm directory under the filename svdebug.parm. Each line in this file contains a process identifier and a hexadecimal number representing a debug level set for that process. A debug level of 0 indicates no debug data is generated.
Table 6-1 describes the value and description of each debug setting.
| Debug Value | Description |
|---|---|
| 0 | No debug data is produced. |
| 1 | Function tracing statements are produced. |
| 1f | Function tracing statements and function details are produced. |
| ffff | Function traces, details, and hexadecimal dumps of all interprocess message flows are produced. |
To activate debugging for a particular SNA View process, locate the process identifier in the svdebug.parm file and set the debug level accordingly.
Table 6-2 lists the process identifiers found in the svdebug.parm file and the SNA View processes affected by each:
| Process ID | Affected SNA View Processes |
|---|---|
| SVHCI | Host Connection Interface |
| SVVTAMP | VTAM Server, VTAM Message Log, and X VTAM Client |
| SVMVS | MVS Server, MVS Message Log, and X MVS Client |
| SVCMDP | Command Server, X Command Client |
| SVSTATUS | Status Manager |
| SVMENU | Task Manager |
| SVLOGON | N/A |
| SVDISCOVER | Map Builder/Discovery process |
| SVHOSTCMD | Command line command client |
This section highlights problems that are not particular to any single component of SNA View. This section discusses the following problems:
Whether you start SNA View from the Maps Tools menu or with the runsnaview command, the SVHOME environment variable is set automatically. The SVHOME environment variable must be set before SNA View will function properly. This variable must be set to the SNA View home directory; for example, /usr/cw-blue/snaview. It is used by many SNA View processes to find the correct path to the SNA View parm, help, and log directories.
In general, if SNA View is unable to locate specific files that it requires, check the setting of the SVHOME environment variable first.
SNA View configuration file errors are common sources of SNA View failures. While not all possible configuration errors can be covered, those that are encountered most frequently are described in this section.
Each managed SNA View domain has a configuration file prefixed by sv_config_ which resides in the /etc directory. These configuration files contain parameters which affect almost every aspect of SNA View functionality. Several configuration file parameters, if not set correctly, can keep SNA View processes from executing properly.
The following sections describe each of these parameters, and the problems that can arise if they are not set correctly.
SNA View home directory (such as /usr/cw-blue/snaview).
If this parameter is not properly set to SNA View's home directory, as defined during installation, workstation processes will not be able to locate necessary help, log, and parameter files. Most SNA View workstation processes will not initialize without a valid SVPATH parameter value.
For example, if the SVPATH parameter is not set correctly and the Status Manager is started, the following error messages will be written to stderr:
SVEXE010 Set_Debug_Flag2() failed to open file svpath/parm/svdebug.parm, reason: No such file or directory.
SVINI040 Error setting debug value, unable to find module
SVSTATUS in Status Manager.
SVEXE102 Status Manager process of domain [DOMAIN1] has exited.
Machine name of workstation running the VTAM Server.
If this parameter is not properly set to the machine name of the workstation where the VTAM Server will be running, the VTAM Message Log and VTAM Window clients will not be able to register to receive unsolicited VTAM messages.
Two symptoms indicate the SVVTAM_AGENT_ADDR parameter is not set correctly.
For example, if the value of this parameter is mickey, but mickey is not a valid machine in the network, the following error messages will be written to stderr:
SVEXE002 client_bind_udp_socket() failed calling gethostbyname(), reason: Error 0.
SVEXE031 Unable to obtain host TCP/IP address from host name: mickey
SVEXE100 client_bind_udp_socket() process has exited.
If, however, mickey is a valid machine name but the VTAM Server is not currently running on that machine, the following error message will be generated either on stderr if running the VTAM Message Log, or in a Motif pop-up if starting the X VTAM Window:
SVSRV050 Timed out waiting for server registration response.
Machine name of workstation running the MVS Server.
If this parameter is not properly set to the machine name of the workstation where the MVS Server will be running, the MVS Message Log and MVS Window clients will not be able to register to receive unsolicited MVS messages.
Two symptoms indicate the SVMVS_AGENT_ADDR parameter is not set correctly.
For example, if the value of this parameter is mickey, but mickey is not a valid machine in the network, the following error messages will be written to stderr:
SVEXE002 client_bind_udp_socket() failed calling gethostbyname(), reason: Error 0.
SVEXE031 Unable to obtain host TCP/IP address from host name: mickey
SVEXE100 client_bind_udp_socket() process has exited.
If, however, mickey is a valid machine name but the MVS Server is not currently running on that machine, the following error message will be generated either on stderr if running the MVS Message Log, or in a Motif pop-up if starting the X MVS Window:
SVSRV050 Timed out waiting for server registration response.
Machine name of workstation running the Command Server.
If this parameter is not properly set to the machine name of the workstation where the Command Server will be running, the Command Window client and Host Command client processes will not be able to register to receive mainframe command support. Host Command Client processes are generated by SNA View pull-down-generated mainframe commands and by other SNA View processes (such as the Discovery and Status Manager processes).
Two symptoms indicate the SVCMDS_AGENT_ADDR parameter is not set correctly.
For example, if the value of this parameter is mickey, but mickey is not a valid machine in the network, the following error messages will be written to stderr:
SVEXE002 client_bind_udp_socket() failed calling gethostbyname(), reason: Error 0.
SVEXE031 Unable to obtain host TCP/IP address from host name: mickey
SVEXE100 client_bind_udp_socket() process has exited.
If, however, mickey is a valid machine name but the Command Server is not currently running on that machine, the following error message will be generated either on stderr if running the Host Command client, or in a Motif pop-up window if starting an X Command Window client:
SVSRV050 Timed out waiting for server registration response.
Machine name of workstation running the HCI.
If this parameter is not properly set to the machine name of the workstation where the Host Connection Interface is running, the Command, VTAM and MVS Servers as well as the Status Manager will be unable to establish socket communications with the Host Connection Interface.
Two symptoms indicate the SVHCI_AGENT_ADDR parameter is not set correctly.
For example, if the value of this parameter is mickey, but mickey is not a valid machine on the network, the following error messages will be written to stderr when you attempt to start any of the processes named above:
SVEXE002 client_bind_udp_socket() failed calling gethostbyname(), reason: Error 0.
SVEXE031 Unable to obtain host TCP/IP address from host name: mickey
SVEXE100 client_bind_udp_socket() process has exited.
If, however, mickey is a valid machine name but the HCI is not currently running on that machine, the following error messages are written to stderr:
SVSOK001 server_connect_tcp_socket() failed calling connect(), reason: Connection refused
SVSOK051 Socket connect failed, no retry will be attempted.
SVEXE100 server_connect_tcp_socket() process has exited.
Machine name of the IBM mainframe running SNA View.
If this parameter is not properly set to the machine name of the IBM mainframe running SNA View, the Host Connection Interface and the Command Server will not successfully initialize (when using TCP/IP for communications between mainframe and workstation).
Two symptoms indicate the SVMF_AGENT_ADDR parameter is not set correctly.
For example, if the value of this parameter is mickey, but mickey is not a valid machine on the network, you will get the following error messages written to stderr when you attempt to start the HCI or Command Server:
SVEXE002 client_bind_udp_socket() failed calling gethostbyname(), reason: Error 0.
SVEXE031 Unable to obtain host TCP/IP address from host name: mickey
SVEXE100 client_bind_udp_socket() process has exited.
If, however, mickey is a valid machine name but the TCP subtask of the mainframe component is not currently running, you will receive these error messages on stderr:
SVSOK001 server_connect_tcp_socket() failed calling connect(), reason: Connection refused
SVSOK051 Socket connect failed, no retry will be attempted.
SVEXE100 server_connect_tcp_socket() process has exited.
Similar error messages will also be generated if the SVMF_HCI_AGENT_PORT and SVMF_CMDS_AGENT_PORT values are not set properly. These configuration parameters must match the mainframe component TCP subtask's input parameter card. Please see the CiscoWorks Blue SNA View Mainframe Installation Guide for more details.
Timeout period, in seconds, for mainframe commands.
If this parameter is set too low, then mainframe commands issued from the workstation can timeout. This can affect other SNA View processes that must issue mainframe commands to obtain configuration and status information about SNA resources, such as the Discovery and Status Manager processes. This can also affect user-generated commands that are issued via the SNA View pull-down menus.
The default value of this parameter is 30 seconds. In most cases this value is sufficient. However, in extremely large SNA environments or when the workstation to mainframe connection is very slow, this value may need to be increased. If this parameter is set too low, the following error messages will be issued to stderr by the Status Manager, Discovery process, and SNA View menu-generated commands:
SVSRV055 Timed out waiting for command response from Command Server.
SVSRV070 Verify that the HCI and Command Servers are active.
In the case of menu-generated commands, you will also receive the following error messages in the Command Response Display window where the result of the command is normally written:
SVSRV055 Timed out waiting for command response from Command Server.
SVSRV071 Command not processed. Verify that the HCI and Command Servers are active.
If increasing this parameter does not prevent commands from timing out, it may be due to SNA View's performance group of the mainframe task not being set to a high enough priority. See your mainframe system administrator or see the CiscoWorks Blue SNA View Mainframe Installation Guide for assistance.
Valid NetView operator ID.
If this parameter is not set to a valid NetView operator ID, NetView commands issued from the Command Client window will fail.
Valid system directory where SNA View will store work files.
If this parameter is not set to a valid system directory, various SNA View processes will be unable to initialize successfully or run properly. SNA View processes utilize this temporary directory to store various files necessary during normal operation. These files and the processes that create them are described in greater detail in "Authority and Access Problems (Permissions)."
The SNA View server and client processes utilize these port values for socket communications. In a distributed environment (or when running SNA View workstation processes on more than one machine), it is important to match the port values between the machine running the SNA View server and the machine running the corresponding client or clients. Each of the SNA View servers (VTAM, MVS, and Command) have a corresponding port value specified by the above parameters. If these parameters do not match on both workstations, the SNA View client in question will receive the following error message on stderr (or in a Motif pop-up window in the case of an X-window client):
SVSRV050 Timed out waiting for server registration response.
The Host Connection Interface communicates with the VTAM and MVS Servers as well as the Status Manager over these defined ports. In a distributed environment (or when running SNA View workstation processes on more than one machine) it is important to match the port values between the machine running the Host Connection Interface and the machine running the corresponding server process. If these parameters do not match on both workstations, the SNA View server in question will receive the following error messages on stderr during initialization:
SVSOK001 server_connect_tcp_socket() failed calling connect(), reason: Connection refused.
SVSOK051 Socket connect failed, no retry will be attempted.
SVEXE100 server_connect_tcp_socket() process has exited.
These configuration parameters define the port values used for TCP/IP communications between the workstation and mainframe components of SNA View. The HCI and Command Servers use these port values to establish socket communications with the TCP subtask on the mainframe. The port values specified in the configuration file on the workstation must match those defined on the TCP subtask statement in the mainframe component's SYSIN parameter card file. Please see the CiscoWorks Blue SNA View Mainframe Installation Guide for more information on the TCP subtask and SYSIN parameter card file.
If these parameters do not match those defined on the mainframe, SNA View will generate the following error messages on stderr when starting the HCI and Command Server tasks:
SVSOK001 server_connect_tcp_socket() failed calling connect(), reason: Connection refused.
SVSOK051 Socket connect failed, no retry will be attempted.
SVEXE100 server_connect_tcp_socket() process has exited.
File permission problems sometimes arise during the operation of SNA View. One such problem occurs when SNA View is initially run under the superuser shell authority. SNA View processes open files with write permission for various reasons. Log files and temporary work files are two of the most common. An example is the Discovery process, which opens a file in SNA View's temporary work directory, specified by the configuration file parameter SVWORK_AREA (the default value of SVWORK_AREA is $CWBROOT/snaview/tmp).
If the Discover process is originally run under the Root user ID, and later run under a different user's ID, the following error messages are generated by SNA View:
sh:/usr/cw-blue/snaview/temp/discovery.domain: cannot create
In this example, the Discovery process was unable to obtain write authority for the necessary file, so the process exited. Removing all files from the SVWORK_AREA directory would correct the problem.
Table 6-3 lists the files created by each process.
| Process | Files Created |
|---|---|
| Host command interface (HCI) | version, domain |
| Discovery | discovery.domain, pu_data.domain |
As mentioned previously, many SNA View processes also open log files in the $SVHOME/log directory.
Table 6-4 lists those processes and the names of the log files they open.
| Process | Associated Log File |
|---|---|
| VTAM Server | svvtam.log.domain |
| MVS Server | svmvs.log.domain |
| VTAM Message Log | svmessage_log.domain |
| MVS Message Log | svmvs_message_log.domain |
For an SNA View process to function as expected, all of the parameters it references must be available and set correctly. Attempting to kill a process that was started by another user will also fail due to process permissions.
Table 6-5 lists the parameter files referenced by each of the SNA View processes.
This section describes problems that can arise during typical operation of SNA View. The scenarios covered in this chapter are categorized according to the SNA View component or task that can experience a failure. Problems are sorted into the following categories:
SNA View's Task Manager process allows the user to control SNA View processes for all managed SNA domains. Occasionally, problems with starting and stopping SNA View processes may arise. This section documents some of the more common problems and describes the appropriate actions to take to resolve them.
If you attempt to connect to a domain and the connection to the mainframe fails; try the following procedures to resolve this problem.
SNA View on the mainframe may not be active. Start it.
There may be a connectivity problem, see the "Workstation-to-Mainframe Connectivity Problems" section.
There may be a problem with the domain's configuration file. See the "Configuration File Problems" section for more information.
Verify that the SVCMDS_AGENT_ADDR parameter in the desired domain's configuration file in /etc is set to the appropriate workstation--that which is running the Command Server. If this workstation is not the same workstation running the Task Manager, verify that the SVCMDS_AGENT_PORT value is also set correctly. If either of these parameters is set incorrectly, correct them and reattempt to connect to the domain.
If the domain uses LU 6.2 communication between the mainframe and workstation, the SERVER subtask of the mainframe component must be recycled. This will automatically start the HCI and Command Server on the workstation. After the SERVER subtask has been restarted, verify that the HCI and Command Server have started successfully.
If the domain uses TCP/IP communications between the mainframe and workstation, simply restart the HCI and Command Server tasks, noting the SNA View initialization-complete messages as follows:
SVINI001 Host Connection Interface initialized successfully for domain [DOMAIN].
SVINI001 Command Server initialized successfully for domain [DOMAIN].
The VTAM Server is responsible for providing unsolicited VTAM messages to all registered VTAM clients. If the VTAM Server will not initialize successfully, then review the error messages generated and "General Problems" for details on possible solutions. In the "Configuration File Problems" subsection of "General Problems," pay special attention to the SVHCI_AGENT_ADDR and SVHCI_VTAM_PORT configuration parameters. Verify that they are set correctly and that the Host Connection Interface is active.
The MVS Server is responsible for providing unsolicited MVS messages to all registered MVS clients. If the MVS Server will not initialize successfully, then review the error messages generated and "General Problems" for details on possible solutions. In the "Configuration File Problems" subsection of "General Problems," pay special attention to the SVHCI_AGENT_ADDR and SVHCI_MVS_PORT configuration parameters. Verify that they are set correctly and that the Host Connection Interface is active.
The VTAM Message Log process registers as a client of the VTAM Server during initialization. If the VTAM Message Log encounters a problem prior to registration to the VTAM Server, or if it is unable to register to the VTAM Server, the process will fail to initialize. Review the error messages generated and "General Problems" for possible solutions. In the "Configuration File Problems" subsection of "General Problems," pay attention to the SVVTAM_AGENT_ADDR and SVVTAM_AGENT_PORT configuration parameters. Verify that they are set correctly and that the VTAM Server is active.
The MVS Message Log process registers as a client of the MVS Server during initialization. If the MVS Message Log encounters a problem prior to registration to the MVS Server or if it is unable to register to the MVS Server the process will fail to initialize. Review the error messages generated and see "General Problems" for details on possible solutions. In the "Configuration File Problems" subsection of "General Problems," pay special attention to the SVMVS_AGENT_ADDR and SVMVS_AGENT_PORT configuration parameters. Verify that they are set correctly and that the MVS Server is active.
If the Status Manager will not initialize successfully, note the error messages generated and see "General Problems" for details on possible solutions. In the "Configuration File Problems" subsection of "General Problems," pay special attention to the SVHCI_AGENT_ADDR and SVHCI_STATUS_PORT configuration parameters. Verify that they are set correctly and that the Host Connection Interface is active.
Problem relating to discovery and status management include:
Discovery is a process that gathers the information on Physical Units (PUs) for a specific domain and inputs that information into the Sybase database.
To gather information for the discovery process, a connection to the domain must be established. Problems can occur with this connection. See "Workstation-to-Mainframe Connectivity Problems" for more detail.
Discovery gathers the domain information by issuing VTAM displays. These commands may fail in some cases. For details, see "Problems Issuing Mainframe Commands."
The pu_discover process must be given domain name on the command line as its first command argument. If it is not given, the following error will appear:
SVINI011 Domain name must be passed to SNAView pu_discover.
If a user attempts to run the pu_discover process after another user or after Root, the mainframe commands will not be able to write the data to the necessary file. This occurs because the permissions set on that file prevent other users from writing to it.
The System Administrator can fix this problem by changing the permissions on the files, which reside in the SVWORK_AREA directory.
The pu_discover process attempts to initiate a session with the Sybase API. If this attempt fails, the program will exit with the following errors:
The Sybase login failed: exiting.
SVEXE102 pu_discover process of domain [domain] has exited.
The pu_discover process gathers configuration variables from the configuration file for the specified domain. For details regarding errors that may occur during the collection of configuration variables, see "Configuration File Problems." The following error messages will be generated if an error should occur:
SVEXE000 pu_discover failed calling Get_config_vars
SVEXE102 pu_discover process of domain [domain] has exited.
The pu_discover process logs information about how it populated the database in a file. If pu_discover cannot open this log file, it will exit with the following error messages:
pu_discover - Could not open log file: exiting.
SVEXE102 pu_discover process of domain [domain] has exited.
The pu_discover process gathers information about SNA resources by sending a request to the mainframe. The mainframe component of SNA View collects the necessary data and sends it back to the workstation.
The data is written to file(s) in the SVWORK_AREA directory (discover.domain and pu_data.domain). If pu_discover can not open or read these files, error messages are displayed. If not all PUs were discovered, then check that the SVCMD_DEFDIS parameter is set correctly for your VTAM level.
The pu_discover process uses the debug file $SVHOME/parm/svdebug.parm to determine what level of debug to use. If the file does not exist, if it has incorrect permissions assigned, or if SVDISCOVER is not a valid debug process name, the pu_discover process will exit with the following errors:
SVINI040 Error setting debug value, unable to find module pu_discover in pu_discover.
SVEXE102 pu_discover process of domain [domain] has exited.
This is a configuration issue. In "Configuration File Problems," review the information provided for the configuration variable, INCLUDE_LUS. This parameter must be set to "YES" (or "yes") in order to enable discovery of Logical Units.
The Status Manager updates the workstation database with the current statuses of VTAM-known resources. The Status Manager can also keep the workstation management database updated with the appearance of new resources. There is a Status Manager for each managed domain.
To receive information on status changes, a connection to the monitored domain must be established. Problems can occur with this connection. See "Workstation-to-Mainframe Connectivity Problems" for more detail.
If connectivity does not exist when Status Manager is activated, the following messages will be displayed:
SVINI000 Status Manager initialized successfully.
SVSOK001 server_connect_tcp_socket() failed calling connect(), reason: Connection refused
SVSOK051 Socket connect failed, no retry will be attempted.
SVEXE100 server_connect_tcp_socket() process has exited.
The Status Manager gathers information on new resources by issuing VTAM displays. These commands may fail in some cases. For details, see "Problems Issuing Mainframe Commands."
The pu_status_manager process must be given domain name on the command line as its first command argument. If it is not given, the following error will appear:
SVINI011 Domain name must be passed to SNAView Pu_status_manager.
The pu_status_manager process attempts to initiate a session with the Sybase API. If this attempt fails, the program will exit with the following errors:
The Sybase login failed: exiting.
SVEXE102 PU_status_manager process of domain [domain] has exited.
The pu_status_manager process gathers configuration variables from the configuration file for the specified domain. For details regarding errors that may occur during the collection of configuration variables, see "Configuration File Problems." The following error messages will be generated if an error should occur:
SVEXE000 Pu_status_manager failed calling Get_config_vars
SVEXE102 Pu_status_manager process of domain [domain] has exited.
The pu_status_manager process uses the configuration variable SVSOCKET_MODE to determine whether it should connect to the HCI with a TCP or UNIX Domain socket. If this variable is not set correctly, pu_status_manager will exit with the following error messages:
SVINI020 Pu_status_manager encountered invalid value for configuration parameter SVSOCKET_MODE.
SVEXE102 Pu_status_manager process of domain [domain] has exited.
Since pu_status_manager is a standard client, the socket errors (SVSOKxxx) described in "SNA View Workstation Messages" should be referred to for details.
The PU status manager receives updated PU information from the mainframe when a status change occurs, or a new PU is discovered. Data is sent to the workstation in the same fashion as discovery.
The Pu_status_manager process uses the debug file $SVHOME/parm/svdebug.parm to determine what level of debug to use. If the file does not exist, if it has incorrect permissions assigned, or if SVSTATUS is not a valid debug process name, the PU_status_manager process will exit with the following errors:
SVINI040 Error setting debug value, unable to find module Pu_status_manager in Pu_status_manager.
SVEXE102 Pu_status_manager process of domain [domain] has exited.
Check Status is a process that issues a display to the SNA domain in which the resource to be updated resides, then uses the display to update the resource's status. Check Status can also add new nodes under a resource if they are not already in the workstation management database.
Connectivity to the domain in which the resource resides must be established in order to receive the display information. See "Workstation-to-Mainframe Connectivity Problems" for more detail.
If connectivity does not exist when Check Status is activated, the following messages will be displayed:
SVEXE120 Sv_identify cannot reach domain [DOMAIN]: exiting.
SVEXE100 Sv_identify process has exited.
Check Status gathers information on new resources by issuing VTAM displays. These commands may fail in some cases. For details see "Problems Issuing Mainframe Commands."
The pu_identify process must be given a domain name and at least one resource Physical Unit name that exists in the specified domain on the command line. If it is not given, the following error will be generated:
pu_identify - Usage pu_identify <[resource name]... [resource name]>.
The pu_identify process attempts to initiate a session with the Sybase API. If this attempt fails, the program will exit with the following errors:
The Sybase login failed: exiting.
SVEXE102 pu_identify process of domain [domain] has exited.
The pu_identify process gathers configuration variables from the configuration file for the specified domain. For details regarding errors that may occur during the collection of configuration variables, see "Configuration File Problems." The following error messages will be generated if an error should occur:
SVEXE000 pu_identify failed calling Get_config_vars
SVEXE102 pu_identify process of domain [domain] has exited.
The pu_identify process gathers resource specific information by issuing a VTAM command (d net,id=PU_NAME,e) to the mainframe and piping the response into a file (SVWORKAREA/SV_cs_pu_data.[DOMAIN]). If it cannot open the data file, it will stop collecting data for that resource and output the following error message:
pu_identify - data_collection - cannot open pu data file: return.
If pu_identify finds an error in the above-mentioned file it will stop gathering data for that resource and output the following error message:
pu_identify - the clstrs command failed: return.
The pu_identify process gathers the RIF data by issuing a command to NetView or Netmaster (getrif PU_NAME PU_NAME) and piping the response into a file (SVWORKAREA/SV_mac_rif.[DOMAIN]) If an error occurs in attempting to open the file, the following error message will be displayed.
pu_identify - Unable to open RIF-MAC data file.
The pu_identify process must convert the VTAM data into data types that Sybase will be able to store. If an error occurs in type conversion, one of the following sets of error messages will be output:
pu_identify - PU type not converted: return = PU_TYPE_NUMBER
logfile PU NAME = PU_NAME was not added: type conversion failed.
pu_identify - PU status not converted: return = STATUS_NUMBER
logfile PU NAME = PU_NAME was not added: status conversion failed.
pu_identify - LU status not converted: return = STATUS_NUMBER
logfile LU NAME = LU_NAME was not added: status conversion failed.
The pu_identify process uses the debug file $SVHOME/parm/svdebug.parm to determine the level of debug to use. If the file does not exist, if it has incorrect permissions, or if SVSTATUS is not a valid debug process name, the pu_identify process will exit with the following errors:
SVINI040 Error setting debug value, unable to find module pu_identify in pu_identify.
SVEXE102 pu_identify process of domain [domain] has exited.
Users may issue mainframe commands via the Mainframe Commands window and via the SNA View pull-down menus integrated into CiscoWorks Blue Maps. This section discusses solutions to the following potential problems:
If a command client is unable to register to the Command Server, the following error message will be written to a Motif pop-up window (in the case of the Mainframe Commands window):
SVSRV050 Timed out waiting for registration response.
In the instance where the user was issuing an SNA View pull-down menu command, error messages would be written to stderr (on the console where the management platform was launched) and to the Command Response Display window. These messages are shown below.
Console Example:
SVSRV050 Timed out waiting for server registration response.
SVSRV070 Verify that the HCI and Command Servers are active.
SVEXE102 svhost_cmd process of domain [domain name] has exited.
Command Response Display Example:
SVSRV055 Timed out waiting for command response from Command Server.
SVSRV071 Command not processed. Verify that the HCI and Command Servers are active.
There are three possible causes for this problem.
To correct the problem:
Step 1 Verify that the Command Server is active for the desired domain. If it is not, start the HCI and Command Server for that domain.
Step 2 Verify the configuration parameters mentioned above. See "Configuration File Problems" for details on the SVCMDS_AGENT_ADDR and SVCMD_AGENT_PORT configuration parameters.
Step 3 If you determine that the Command Server is running and the configuration parameters are set correctly but the command client will still not register successfully, recycle the HCI and Command Server for this domain.
If, after entering your user ID and password, and selecting the OK button the Mainframe Logon window, you receive an Invalid User ID or an Invalid Password message, then verify your user ID and password and try them again. If you are still unable to log in, check with your mainframe system administrator. There will corresponding ICH408I and IRR013I-prefixed messages on the mainframe console which should aid in diagnosing the problem with the ID and password.
If, after entering your user ID and password, and selecting the OK button the Mainframe Logon window, the response is a Verifying...please wait message which is displayed for an unusually long wait period, verify that the SEC subtask has been started on the mainframe. If the SEC task is not running, you will be unable to log in to issue mainframe commands. Resolve this problem and restart the Mainframe Commands window.
Commands issued through SNA View's integrated pull-down menus rely on the SVCMD_TIMEOUT configuration parameter to specify the length of time (in seconds) that they will wait for a response from the mainframe. If this time is exceeded, error messages will be written to stderr (console where the management platform was launched) and to the Command Response Display Window.
These error messages are shown below:
Console Example:
SVSRV055 Timed out waiting for command response from Command Server.
SVSRV070 Verify that the HCI and Command Servers are active.
SVEXE102 svhost_cmd process of domain [domain name] has exited.
Command Response Display Example:
SVSRV055 Timed out waiting for command response from Command Server.
SVSRV071 Command not processed. Verify that the HCI and Command Servers are active.
See the information on the SVCMD_TIMEOUT information in "Configuration File Problems" for details on this parameter.
The Mainframe Command window will wait indefinitely on command responses from the host. There is no time-out period, but if command responses are very slow or if only partial command responses are returned, there may be a problem with the performance group setting for the mainframe task. See the information on the SVCMD_TIMEOUT parameter in "Configuration File Problems" for details on the performance group setting.
The following situations can arise while issuing VTAM commands.
If the following message is received, VTAM on the mainframe did not recognize the command issued:
IST010I XXX COMMAND INVALID
Verify the syntax of the command you are attempting to issue and try again. See IBM's VTAM Operations Guide for the syntax for specific commands.
If no command responses are returned for VTAM commands issued, verify that at least one SPO subtask is active on the mainframe. At least one SPO subtask must be active in order to process VTAM mainframe commands from the workstation. See the CiscoWorks Blue SNA View Mainframe Installation Guide or your system administrator for details on how to determine if a SPO subtask is active.
If no command responses are returned for MVS commands issued, verify that the CMD subtask is active on the mainframe. The CMD subtask is responsible for processing MVS commands issued through SNA View. See the CiscoWorks Blue SNA View Mainframe Installation Guide or your system administrator for details on determining if the CMD subtask is active.
The following situations can arise while issuing NetView commands.
If no command responses are returned for NetView commands issued, verify that the PPI subtask is active on the mainframe. The PPI subtask is responsible for processing NetView commands issued through SNA View. See the CiscoWorks Blue SNA View Mainframe Installation Guide or your system administrator for details on determining if the PPI subtask is active.
The mainframe component will return an SV315 message when the command operator specified by the SVCMD_OPERATOR configuration parameter is invalid.
For example, if SVCMD_OPERATOR was set to OPERATOR1 and OPERATOR1 was neither a valid NetView operator nor currently logged on, then the SV315 message would be structured as follows:
SV315 OPERATOR1 COMMAND EXECUTION FAILED
See "Configuration File Problems" for details on the SVCMD_OPERATOR configuration parameter.
Potential problems with unsolicited mainframe messages are categorized as follows:
The following situations can arise with receiving unsolicited VTAM messages.
If the VTAM Messages client window does not come up successfully, review the error messages issued by the process to standard error. Also, see "General Problems" for details on possible solutions.
If the VTAM Messages window appears, but times out while attempting to register to the VTAM Server, the following error message will appear in a Timeout Notification popup window:
SVSRV050 Timed out waiting for server registration response
Two things could cause the registration to time out: either the VTAM Server is not up and running properly, or the SVVTAM_AGENT_ADDR and/or SVVTAM_AGENT_PORT configuration parameters are not set correctly. Verify that the VTAM Server is running on the proper machine and, if so, see "Configuration File Problems" for details on the SVVTAM_AGENT_ADDR and SVVTAM_AGENT_PORT parameters.
There are several reasons why the VTAM Message client may not be receiving VTAM messages from the VTAM Server. We will assume at this point that the VTAM messages are currently being generated by VTAM on the mainframe.
When SNA View is running in conjunction with NetView, the PPI subtask must be active in order for SNA View to receive unsolicited VTAM messages. If running in a VTAM-only environment, the PPO subtask must be active in order to receive VTAM messages. Verify that the proper SNA View subtask is currently active on the mainframe by contacting your mainframe system administrator.
Another possibility is system or client filters may be set which are filtering out VTAM messages before they reach the VTAM Message client. The VTAM Server will only forward to clients the VTAM messages that are not eliminated by the filters specified in the $SVHOME/parm/svvtamsysfilter.tbl file. Verify that the contents of this file have not been set in such a way as to filter out the VTAM messages you are expecting. Similarly, client filters set up on the VTAM Window itself may be filtering out the messages you are expecting.
When either NetView or SOLVE:Netmaster is installed, SNA View receives VTAM messages from the network management system. Have the mainframe administrator verify that NetView or SOLVE:Netmaster has been configured properly to forward VTAM messages to SNA View.
The following situations can arise with receiving unsolicited MVS messages.
If the MVS Messages client window does not come up successfully, review the error messages issued by the process to standard error. Also, see "General Problems" for details on possible solutions.
If the MVS Messages window appears but then times out while attempting to register to the MVS Server, this error message will appear in a Timeout Notification popup window:
SVSRV050 Timed out waiting for server registration response
Two things could cause the registration to time out. Either the MVS Server is not up and running properly, or the SVMVS_AGENT_ADDR and/or SVMVS_AGENT_PORT configuration parameters are not set correctly.
Verify that the MVS Server is running on the proper machine and, if so, see "Configuration File Problems" for details on the SVMVS_AGENT_ADDR and SVMVS_AGENT_PORT parameters.
There are several possible explanations why the MVS Message client is not receiving any MVS messages from the MVS Server. We will assume at this point that the MVS messages are currently being generated by MVS on the mainframe.
The MVS subtask of the SNA View Mainframe Component must be active in order to receive unsolicited MVS messages. Verify that this subtask is active by contacting your mainframe system administrator.
System or client filters may be set that filter out MVS messages before they reach the MVS Message client. The MVS Server will only forward MVS messages to clients that are not filtered out by the filters specified in the $SVHOME/parm/svmvssysfilter.tbl file. Verify that the contents of this file has not been set in such a way as to filter out the MVS messages you are expecting. Similarly, client filters set up on the MVS Window itself may be filtering out the messages you are expecting.
This section details problems related to communications between the mainframe and the workstation in TCP/IP and LU 6.2-connected environments.
The SNA View Task Manager will verify that the mainframe component of SNA View is compatible with the workstation component. If the versions are not compatible, the connection to the mainframe will be dropped. The task manager displays its version information in the top line. If the version is not displayed, it is a version prior to 1.1.
If the mainframe component is version 1.1 (viewable via the F NSPOPEN, SHOW VERSION command) and the workstation is not at version 1.1, then the versions are not compatible and the workstation should be upgraded.
If the Host Connection Interface or the Command Server will not initialize successfully and you believe this to be due to communications problems between the workstation and mainframe, perform the following steps:
Step 1 Verify that the SVMF_AGENT_ADDR configuration parameter is set to the correct IP machine name of the mainframe.
Step 2 Verify the network connection from the workstation to the mainframe by issuing a TCP/IP ping command.
Step 3 Verify that the SVMF_HCI_AGENT_PORT and the SVMF_CMDS_AGENT_PORT configuration parameters are set correctly on the workstation. These parameter values must match the parameter card values for the TCP subtask on the mainframe.
Step 4 For IBM TCP/IP connections, verify that the TCP-subtask for your requested ports is active. Issue the F NSPOPEN,SHOW TASK command and look for the desired ports to confirm that the tasks's state is UP.
Step 5 Verify that another workstation is not connected to the subtask. Issue the F NSPOPEN,SHOW CONN command to confirm that there is NO CONNECTION for the relevant TCP subtask.
If any of these steps do not verify correctly, resolve the problem and recycle SNA View.
LU 6.2 connectivity issues can be rather complex to debug. The vast majority of LU 6.2 connectivity issues are resolved during the installation phase of SNA View when communications are initially configured.
The best source of information for debugging LU 6.2 problems is the job log of the SNA View mainframe component. It will contain error messages written by the failed SERVER subtask. Please see the CiscoWorks Blue SNA View Mainframe Installation Guide for more details on problems and solutions with the SERVER subtask and LU 6.2 communications. This section discusses issues specific to the SNA stacks that SNA View will run under.
For LU 6.2 connections, verify that the associated SERVER subtask is active. Issue the F NSPOPEN,SHOW TASK command to confirm the SERVER subtask's states are UP.
If HP SNAplus software is used, two sources of information are helpful for troubleshooting LU 6.2 connectivity problems: logs (audit and error messages) and link traces.
SNAplus generates audit and error messages during operation and writes them to files specified during configuration of SNAplus. The default SNAplus configuration file (com.cfg) shipped with SNA View specifies the default sna.aud and sna.err files as the destinations for audit and error logging, respectively. These files may need to be modified using the snapconfig program. Please see the HP-UX SNAplusLink Administrator's Guide for more details on specifying log files and message severity levels.
Starting a link with tracing means that in addition to the diagnostic messages written to the audit and error logs, tracing information is written to the trace files snafile1.trc and snafile2.trc. You must use the snapmanage program to start a link with tracing. Please see the HP-UX SNAplusLink Administrator's Guide for more details.
The following situations can arise with using IBM's SNA Services or SNA Server software for host connectivity.
When the SNA View mainframe component is started with a SERVER subtask, the SNA Services/Server application running on the RISC/6000 receives an FMH5 transmission from the host and launches the transaction programs specified in the LU 6.2 Transaction Program Profiles configured during SNA View installation. These transaction programs are named as follows:
svhci_server_DOMAIN1
svcommand_server_DOMAIN1
where DOMAIN1 in this example is the SNA View SNA domain to be managed. These executables reside in the $SVHOME/bin directory and should have been created by the SNA View workstation installation program. If these two files are not present for each domain to be managed via LU 6.2 communications, you can create them using the following commands, replacing DOMAIN1 with your domain name.
cp $SVHOME/bin/svhci_server
$SVHOME/bin/svhci_server_DOMAIN1
cp $SVHOME/bin/svcommand_server
$SVHOME/bin/svcommand_server_DOMAIN1
The SNA Services and SNA Server applications maintain error logs which detail SNA (and therefore LU 6.2) failures that occur. Follow these steps or see the appropriate SNA Server/Services documentation to generate error reports:
Step 1 Start the SMIT utility by entering smit at an AIX command prompt.
Step 2 Select Communications Applications and Services.
Step 3 Select SNA Services or SNA Server (whichever is applicable).
Step 4 Select Diagnose SNA Services.
Step 5 Use the SNA Internal Errors and SNA System Errors selections to generate error reports that contain detailed data on SNA failures.
Use this detailed information along with any job log error data from the SNA View mainframe component to determine the cause of the communication failure.
This document explains the messages generated by the SNA View workstation component.
The following categories of messages are described in this appendix:
Explanation The SNA View svbuild_select process could not open the file it uses to see if another svbuild_select is already executing for a particular domain.
Without being able to tell if another svbuild_select is already executing, the svbuild_ select process exits. If it did not exit the two processes could destroy each other's critical files.
Recommended Action Check the configuration file for the particular domain; pay special attention to the SVWORK_AREA configuration parameter to ensure that it is set correctly.
Error Message SVBSEL020 Another Build Select is already running: exiting.Explanation The SNA View svbuild_select process has detected another svbuild_select process already executing for a particular domain.
The SNA View svbuild_select process exits as to not cause any problems with the previous executing version of svbuild_select.
Recommended Action No user action required.
Error Message SVBSEL030 Can not store Build Selects Process ID: exiting.Explanation The SNA View svbuild_select process cannot store its process ID (PID) in a specific file. Since it can't store its PID, no other svbuild_select process will be able to tell if it is still running.
Recommended Action Check the configuration file for the particular domain; pay special attention to the SVWORK_AREA configuration parameter to ensure that it is set correctly.
Explanation An SNA View process detected an invalid -display option usage. The detecting SNA View process will terminate.
Recommended Action Correct the -display option usage problem.
Error Message SVCLI010 SVCLI010 Client received 'message out of sequence' error from server.Explanation An SNA View server process detected an out of sequence message from a client process and issued this notification.
Recommended Action No user action required.
Error Message SVCLI020 client received invalid RSCF return: rcnumberclient is the SNA View client.
rcnumber is the integer return code.
Explanation An SNA View client that requires a mainframe RACF login, supplied by the user, submitted a username and password that failed to pass RACF. The SNA View client must exit.
Recommended Action Ensure that the username and password are valid for RACF on the mainframe for the domain that the client was running under.
Error Message SVCLI030 Invalid command form specified, valid values are 1, 2 or 3.Explanation An SNA View command client was provided an invalid command form. Command client process will terminate.
Recommended Action Specify one of the valid command form values specified below:
1 - Management platform (OVwSelections set)
2 - Special Command Line (Used by status manager)
3 - Normal Command Line
Explanation The SNA View Check Status must have a resource name in order to check that resource's status.
Recommended Action No user action is required.
Error Message SVCS011 A resource must be selected: exiting.Explanation The SNA View Check Status must have a resource selected on the network management platform so that it can check that resource's status. Without selecting a resource, the Check Status process exits.
Recommended Action With the mouse, select the icon of the SNA resource that should have its status checked.
error is the integer error number.
Explanation The SNA View SNA Discover Process has an internal error. The SNA Discover Process will exit.
Recommended Action Contact the Cisco TAC.
Error Message SVDIS353 Unexpected switch value: error.error is the integer error number.
Explanation The SNA View SNA Discover Process has an internal error. The SNA Discover Process will exit.
Recommended Action Contact the Cisco TAC.
Error Message SVDIS354 Unexpected switch value: error.error is the integer error number.
Explanation The SNA View SNA Discover Process has an internal error. The SNA Discover Process will exit.
Recommended Action Contact the Cisco TAC.
Error Message SVDIS500 An unknown IST number message was found: exiting.number is the IST message identifier.
Explanation
The SNA View SNA Discover Process has found an unrecognized IST message. The Discover Process will terminate.
Recommended Action Contact the Cisco TAC.
process is the SNA View process.
Explanation An SNA View process has executed to completion. At the end of a normal completion the process will exit.
Recommended Action No user action required.
Error Message SVEXE000 process failed calling functionprocess is the SNA View process or function.
function is the function.
Explanation An SNA View process or function has failed in its call to a function. In most cases the SNA View process or function will terminate.
Recommended Action Normally, more detailed SNA View error messages will accompany this message. Review all SNA View generated error messages in an effort to resolve the error.
Error Message SVEXE001 process failed calling function with rc: rcnumberprocess is the SNA View process or function.
function is the function.
rcnumber is the integer return code.
Explanation An SNA View process or function has failed in its call to a function and received a return code. In most cases the SNA View process or function will terminate.
Recommended Action Normally, more detailed SNA View error messages will accompany this message. Review all SNA View generated error messages in an effort to resolve the error.
Error Message SVEXE002 process failed calling function, reason: messageprocess is the SNA View process or function.
function is the function.
message is the text return message
Explanation An SNA View process or function has failed in its call to a function and received a text return message. Usually, the SNA View process or function will terminate.
Recommended Action Normally, more detailed SNA View error messages will accompany this message. Review all SNA View generated error messages.
Error Message SVEXE010 process failed to open file path, reason: messageprocess is the SNA View process or function.
path is the full file path.
message is the text return message.
Explanation An SNA View process/function has failed to open a file and received a text return message. The detecting SNA View process will terminate.
Recommended Action Check file permissions to ensure that the process has the ability to read and write to the file.
Error Message SVEXE015 process failed to obtain file statistics for file name, reason: failure.process is the SNA View process.
name is the filename.
failure is the reason for failure.
Explanation SNA View process attempted to query statistical information for a file and failed with failure text. In most cases the process will terminate.
Recommended Action Use failure reason text to determine cause of failure and correct the problem.
Error Message SVEXE020 Memory allocation failure, check available memory.Explanation An SNA View process attempted to obtain more memory from the operating system and failed. The detecting SNA View process will terminate.
Recommended Action Verify that available memory requirements on the workstation have not been exceeded.
Error Message SVEXE030 Unable to obtain machine name.Explanation An SNA View process attempted to get the host name of the machine it was on and failed. The SNA View process that detected this failure will terminate.
Recommended Action Verify that the workstation's machine name is retrievable.
Error Message SVEXE031 Unable to obtain host TCP/IP address from host name: host.host is the TCP/IP host name.
Explanation An SNA View process attempted to get the TCP/IP address for the TCP/IP host machine and failed. The detecting SNA View process will terminate.
Recommended Action If the machine uses the /etc/hosts file to resolve TCP/IP addresses, make certain that the specified host name has an entry. If the machine uses a name server to resolve addresses, verify that the name server knows the host name.
Error Message SVEXE050 Invalid selection made, please select again.Explanation The user made an invalid selection and may try again.
Recommended Action Make a valid selection.
Error Message SVEXE100 process process has exited.process is the SNA View process.
Explanation An SNA View process has terminated.
Recommended Action Review any SNA View generated error messages to determine the cause of the process termination if the termination was abnormal.
Error Message SVEXE102 process process of domain name has exited.process is the SNA View process.
name is the SNA View defined domain name.
Explanation An SNA View process of a domain has terminated.
Recommended Action Review any SNA View generated error messages to determine the cause of the process termination if the termination was abnormal.
Error Message SVEXE110 process popen failed calling name: exiting.process is the SNA View process.
name is the program launched by popen() call.
Explanation SNA View process attempted to issue the popen system call to launch a program and failed. SNA View process will fail.
Recommended Action Ensure that the program exists in the specified path and that its permissions allow the process to execute it.
Error Message SVEXE120 process can not reach domain name: exiting.process is the SNA View process.
name is the SNA View SNA domain name.
Explanation An SNA View process attempted to contact an SNA View SNA domain and failed. SNA View process will terminate.
Recommended Action Verify that both the mainframe and workstation components of SNA View are active for the specified domain.
number is the line number where the error was detected.
type is VTAM or MVS.
Explanation An SNA View process (VTAM or MVS Servers) has encountered a problem with the system filter table file at the specified line number. The detecting SNA View process will terminate.
Recommended Action Edit the appropriate system filter table file located in $SVHOME/parm and make the appropriate corrections.
Error Message SVFIL001 Line number of requested filter is invalid.number is the line number where error was detected.
Explanation An SNA View server process has encountered a problem with a client requested filter table at the specified line number.
The detecting SNA View server process will return an error message to the client process and continue execution.
Recommended Action Correct the client filter table and reissue the filter request.
Error Message SVFIL010 Filter Format: statement.statement is the correct format of filter statement.
Explanation An SNA View process (VTAM or MVS Server) has detected a problem with the format of a filter statement. The detecting SNA View server process will return an error message to the client process and continue execution.
Recommended Action Correct the format of the filter statement and reissue the filter request.
Error Message SVFIL011 First character of filter entry must be an 'I' or 'X'.Explanation An SNA View process (VTAM or MVS Server) has detected that the first character of a client filter statement is not an I or X. The detecting SNA View server process will return an error message to the client process and continue execution.
Recommended Action Correct the format of the filter statement and reissue the filter request.
Error Message SVFIL012 Invalid token position encountered (must be in range 1 to 99): position.position is the invalid token position.
Explanation An SNA View process (VTAM or MVS Server) has detected an invalid token position within a requested filter statement. The largest valid token position is 99; the smallest is 1. The detecting SNA View server process will return an error message to the client process and continue execution.
Recommended Action Select a valid token position, correct the filter statement and reissue the filter request.
Error Message SVFIL013 Incomplete comparison token pairExplanation An SNA View process (VTAM or MVS Server) has detected an incomplete comparison token pair within a requested filter statement. The detecting SNA View server process will return an error message to the client process and continue execution.
Recommended Action Correct the format of the filter statement and reissue the filter request.
Error Message SVFIL014 Invalid DEFAULT entryExplanation An SNA View process (VTAM or MVS Server) has detected an invalid DEFAULT filter entry. The detecting SNA View server process will return an error message to the client process and continue execution.
Recommended Action Correct the format of the DEFAULT filter statement and reissue the filter request.
Error Message SVFIL015 Filter entry must not contain over 19 tokens.Explanation An SNA View process (VTAM or MVS Server) has detected that a filter statement contains more that the maximum of 19 tokens. The detecting SNA View server process will return an error message to the client process and continue execution.
Recommended Action Correct the format of the filter statement and reissue the filter request.
Error Message SVFIL016 Invalid number of comparison tokens in relation to operators.Explanation An SNA View process (VTAM or MVS Server) has detected that a filter statement contained an invalid number of comparison tokens in relation to logical operators. The detecting SNA View server process will return an error message to the client process and continue execution.
Recommended Action Correct the format of the filter statement and reissue the filter request.
Error Message SVFIL017 Filter entries have a maximum length of 80 characters.Explanation An SNA View process (VTAM or MVS Server) has detected that a filter statement exceeded the maximum length of 80 characters. The detecting SNA View server process will return an error message to the client process and continue execution.
Recommended Action Correct the format of the filter statement and reissue the filter request.
name is the SNA View data file.
Explanation A main process, Status Manager or Check Status, tried to issue a display on an unknown resource. The act_stat function will terminate.
Recommended Action Verify that the permissions of the file and its path allow it to read from act_stat. Also make sure that the configuration parameter SVWORK_AREA is properly set.
Error Message SVID015 switched_pu could not open input file name.name is the SNA View data file
Explanation The Status Manager tried to do a display on a switched PU. The return from that display would be piped into a temporary file that the function switched_pu could not open. The switched_pu function will terminate.
Recommended Action Make sure that the permissions of the file and its path allow it to read from the file. Also make sure that the configuration parameter SVWORK_AREA is properly set.
Error Message SVID020 Return from host is not correct in name: returning.name is the SNA View function name.
Explanation An SNA View function has received a bad return form a host command. The function will return to the main process when it has detected this error.
Recommended Action Some errors occur due to workstation system load. Try issuing the process again.
process is the SNA View process.
Explanation An SNA View process has initialized successfully. The SNA View process will continue with execution.
Recommended Action No user action is required.
Error Message SVINI001 process initialized successfully for domain name.process is the SNA View process.
name is the SNA View defined domain name.
Explanation An SNA View process has initialized successfully for the domain. The SNA View process will continue with execution.
Recommended Action No user action is required.
Error Message SVINI010 process started with invalid argument count.process is the SNA View process.
Explanation An SNA View process was started without the correct number of command line arguments. The SNA View process will terminate.
Recommended Action If starting this process from the command line, verify that the proper arguments are being passed to the program; otherwise, contact the Cisco TAC.
Error Message SVINI011 Domain name must be passed in to the SNAView process.process is the SNA View process.
Explanation An SNA View process was started without the domain name passed in as an argument. The SNA View process requires the domain name argument to determine the proper configuration file to utilize. The SNA View process will terminate.
Recommended Action If starting this process from the command line verify that the domain name is being passed to the program; otherwise, contact the Cisco TAC.
Error Message SVINI012 Invalid transaction program name executable used to start serverserver is the HCI or Command Server.
Explanation The HCI or Command Server was started with an invalid transaction program name. The transaction program name did not have the domain name (for which the servers are being started) appended to the executable name. The SNA View process that detected this failure will terminate.
Recommended Action When communication between the mainframe and the workstation is via LU 6.2, the configuration profiles on the workstation must be defined so that the transaction program executable paths for the HCI and Command Servers have the proper domain name appended. The HCI and Command Servers use this appended domain name to access the appropriate SNA View configuration files.
Error Message SVINI013 Resource name with domain extension must be passed in to the process.process is the SNA View process.
Explanation The SNA View process requires that a resource name with a proper domain extension be passed in on the command line. The SNA View process that detected this failure will terminate.
Recommended Action Launch process with the proper command line argument of tag.
Error Message SVINI030 process needs the variable environment variable set properly.process is the SNA View process.
variable is the SNA View environment variable.
Explanation An SNA View process was started without the environment variable set. The specified environment variable is critical to the operation of the process. The SNA View process the detected this failure will terminate.
Recommended Action Set the environment variable with the proper value and restart the process.
Error Message SVINI040 Error setting debug value, unable to find module name in file.name is the SNA View debug module name.
file is the debug parameter file.
Explanation An SNA View process was unable to determine the value of its debug flag because the module name was not found in the debug parameter file. The detecting SNA View process will exit.
Recommended Action Add the SNA View module name to the debug parameter file $SVHOME/parm/sv- debug.parm.
Error Message SVINI050 process unable to open log file: exiting.process is the SNA View process.
Explanation An SNA View process cannot open it's log file. The SNA View process will terminate.
Recommended Action Check the permissions of the log files in $SVHOME/log to ensure that the process has write permission.
process is the SNA View process or routine.
name is the LU 6.2 system routine name.
renumber is the error return.
Explanation The SNA View process or routine failed calling the LU 6.2 system routine and was returned an error code. The SNA View process that detected the error will terminate.
Recommended Action Review any LU 6.2 communication errors generated in the mainframe's system log or the workstation's SNA stack error logs. Verify that your LU 6.2 communications are configured properly.
Error Message SVLUX010 Failure opening direction LU 6.2 conversation.direction is inbound or outbound.
Explanation The HCI or the Command Server failed to open the conversation with the mainframe system. The SNA View process that detected the error will terminate.
Recommended Action Review any LU 6.2 communication errors generated in the mainframe's system log or the workstation's SNA stack error logs. Verify that your LU 6.2 communications are configured properly.
Error Message SVLUX020 Failure allocating direction LU 6.2 conversation.direction is inbound or outbound.
Explanation The HCI or the Command Server failed to allocate the LU62 conversation with the mainframe. The SNA View process that detected the error will terminate.
Recommended Action Review any LU 6.2 communication errors generated in the mainframe's system log or the workstation's SNA stack error logs. Verify that your LU 6.2 communications are configured properly.
Error Message SVLUX030 Failure reading over direction LU 6.2 conversation.direction is inbound or outbound.
Explanation The HCI or the Command Server failed to read from the LU 6.2 connection that exists between it and the mainframe code. The SNA View process that detected the error will terminate.
Recommended Action Review any LU 6.2 communication errors generated in the mainframe's system log or the workstation's SNA stack error logs. Verify that your LU 6.2 communications are configured properly.
Error Message SVLUX035 Control received value from mainframe signals termination.Explanation The HCI or Command Server process received a code format value from the mainframe indicating termination was necessary. The detecting SNA View server process will terminate.
Recommended Action Review any LU 6.2 communication errors generated in the mainframe's system log or the workstation's SNA stack error logs. Verify that your LU 6.2 communications are configured properly.
Error Message SVLUX040 Failure confirming conversation LU 6.2 conversation read.conversation is the inbound or outbound conversation.
Explanation The HCI or Command Server failed to confirm the conversation read as requested by the mainframe. The SNA View process that detected this failure will terminate.
Recommended Action Review any LU 6.2 communication errors generated in the mainframe's system log or the workstation's SNA stack error logs. Verify that your LU 6.2 communications are configured properly.
Error Message SVLUX050 Failure sending over conversation LU 6.2 conversation.conversation is the inbound or outbound conversation.
Explanation The HCI or Command Server detected a failure while attempting to send over the LU 6.2 conversation with the mainframe. The SNA View process that detected this failure will terminate.
Recommended Action Review any LU 6.2 communication errors generated in the mainframe's system log or the workstation's SNA stack error logs. Verify that your LU 6.2 SNA profiles are configured properly.
Error Message SVLUX060 Failure closing conversation LU 6.2 conversation.conversation is the inbound or outbound conversation.
Explanation The HCI or Command Server detected a failure while attempting to close the LU 6.2 conversation with the mainframe. The SNA View process that detected this failure will terminate.
Recommended Action Review any LU 6.2 communication errors generated in the mainframe's system log or the workstation's SNA stack error logs. Verify that your LU 6.2 SNA profiles are configured properly.
path is the full file path.
Explanation The SNA View Refresh process cannot open the data file. The SNA View Refresh process will ignore the rest of this file.
Recommended Action The permission of the file and the path should allow the Refresh process to access it. The full file path should be correct. If it is not, check the configuration file for this particular domain. The configuration parameter SVWORK_AREA should have the correct path set for its value.
Error Message SVREF020 Active_Refresh an unknown ISTXXXI message was found: returning.Explanation The SNA View Refresh process has found an ISTXXXI number that it does not know. The SNA View Refresh process will ignore the rest of this file.
Recommended Action Contact the Cisco TAC.
Error Message SVREF030 PS file could not be opened: exiting.Explanation The Refresh process could not open the file it uses to determine if another Refresh is already running for a particular domain. Without being able to tell if another Refresh is already executing, the Refresh process exits.
Recommended Action Check the configuration file for that particular domain, paying special attention to the SVWORK_AREA configuration parameter to ensure that it is set correctly.
Error Message SVREF040 Another Refresh is already running: exiting.Explanation This Refresh process found that another Refresh process was already running for the same domain. The SNA View Refresh process will terminate.
Recommended Action No user action required.
Error Message SVREF050 Cannot store Refresh Process Id: exiting.Explanation The Refresh process cannot store its process ID in a specific file. Since it cannot store its Process ID, no other Refresh process will be able to tell if it is still running.
Recommended Action Check the configuration file for that particular domain, paying special attention to the SVWORK_AREA configuration parameter to ensure that it is set correctly.
Error Message SVREF060 The domain must exist before you can refresh it: exiting.Explanation The SNA View Refresh process was executed on a domain that does not exist in the management database. The domain must be discovered or exist in the management database before it can be refreshed. Without the existence of the domain in the management database, the SNA View Refresh process will exit.
Recommended Action Discover the particular domain. Because the discovery of the domain should be recent, there will be no need for the SNA View Refresh process to be executed on that particular domain.
Error Message SVREF070 Starting a passive refresh.Explanation The SNA View Refresh process has started a passive refresh. The SNA View Status Manager corrects the statuses of the resource as they change. The SNA View Refresh process exits.
Recommended Action No user action required.
Error Message SVREF100 Starting to input display into a temporary file.display is the type of display.
Explanation The SNA View Refresh process issues a number of display commands to the host machine in order to get new statuses for all existing resources. These displays are stored in a temporary data file in the path specified by the SVWORK_AREA. The SNA View Refresh process is storing the display data in a temporary data file.
Recommended Action No user action required.
Error Message SVREF110 Starting to input display into the management platform.display is the type of mainframe display command.
Explanation The SNA View Refresh process is adding the information received from the mainframe display command to the network management platform database. The SNA View Refresh process is inputting the data into the network management platform database.
Recommended Action No user action required.
Error Message SVREF120 The manipulation of display is complete.display is the type of mainframe display command.
Explanation The SNA View Refresh process has finished manipulating the data for a particular display. The SNA View Refresh process is finished adding the information received from the mainframe display command to the network management platform database.
Recommended Action No user action required.
Explanation The SNA View Status Manager process could not open the file it uses to see if another Status Manager is already executing for a particular domain. Without being able to tell if another Status Manager is already executing, the Status Manager process exits. If it did not exit, the two processes could destroy each other's critical files.
Recommended Action Check the configuration file for that particular domain, paying special attention to the SVWORK_AREA configuration parameter to ensure that it is set correctly.
Error Message SVSM020 Cannot store the Status Manager's Process ID: exiting.Explanation The SNA View Status Manager process cannot store its Process ID in a specific file. Because it cannot store its process ID, no other Status Manager process will be able to tell if it is still running.
Recommended Action Check the configuration file for that particular domain, paying special attention to the SVWORK_AREA configuration parameter to ensure that it is set correctly.
Error Message SVSM030 The input file X will not open: returning.Explanation The SNA View Status Manager Stores the status messages it receives during some points of the execution of the SNA View Refresh process. After the Refresh process is complete, the Status Manager takes the messages out of the temporary storage file and attempts to update the network management platform. But, in this case, it was unable to open the file. Because Status Manager cannot open the file, it returns to normal processing.
Recommended Action Make sure that the permissions of the file and its path allow it to read from Status Manager. The user should ensure the configuration parameter SVWORK_AREA is properly set.
Error Message SVSM121 Another Status Manager is already running: exiting.Explanation The SNA View Status Manager process has detected another copy of itself executing for the same domain. Because there is another Status Manager already executing for this domain, the additional Status Manager exits.
Recommended Action No user action required.
process is the SNA View process or routine.
function is the system socket function.
explanation is the text error explanation.
Explanation An SNA View process has called a system function and that function has failed. The reason is given in the explanation. In most cases, a system function is essential to the process. Without it, the process cannot continue and will exit with an error.
Recommended Action If the explanation is not clear, check to make sure the configuration file for that particular domain is correctly defined. In some cases the error may be due to the system load and the process will run properly if restarted.
Error Message SVSOK010 Unable to open protocol method socket.protocol is the socket protocol.
method is either the stream or datagram method.
Explanation An SNA View process was unable to open a socket type with the indicated communication method. The SNA View process that attempted to open the socket will terminate.
Recommended Action In some cases the error is due to the system load and the process will run properly if restarted.
Error Message SVSOK020 Unable to bind socket.Explanation An SNA View process was unable to bind an opened socket. The SNA View process that attempted to bind the socket will terminate.
Recommended Action In some cases the error is due to the system load and the process will run properly if restarted.
Error Message SVSOK030 Unable to set socket to non-blocking mode.Explanation An SNA View process was unable to set the mode of a socket to nonblocking. Processing will continue.
Recommended Action No user action required.
Error Message SVSOK031 Unable to set socket to blocking mode.Explanation An SNA View process was unable to set the mode of a socket to blocking. Processing continues.
Recommended Action No user action required.
Error Message SVSOK040 Error on listen for socket connection.Explanation An SNA View process was unable to activate a socket for connection. The SNA View process that attempted to listen for the socket connection will terminate.
Recommended Action In some cases the error is due to the system load and the process will run properly if restarted.
Error Message SVSOK050 Socket connect failed, will retry momentarily.Explanation An SNA View process attempted to connect to another SNA View process via socket communications and failed. In most cases the other SNA View process has not had enough time to initialize and establish the socket properly. The process will wait momentarily and then reissue the connection attempt.
Recommended Action No user action required.
Error Message SVSOK051 Socket connect failed, no retry will be attempted.Explanation An SNA View process attempted to connect to another SNA View process via socket communications and failed. The detecting SNA View process will terminate.
Recommended Action Make sure that both processes involved in the connection are executing. Make sure the configuration file for that particular domain is correctly defined. In some cases the error is due to the system load and the process will run properly if restarted.
Error Message SVSOK070 Unable to get socket option: socketsocket is the specific socket option.
Explanation An SNA View process attempted to obtain the socket option and failed. The detecting SNA View process will terminate.
Recommended Action Attempt to restart the failing process.
Error Message SVSOK071 Unable to set socket option: socketsocket is the specific socket option.
Explanation An SNA View process attempted to set the socket option and failed. The detecting SNA View process will terminate.
Recommended Action Attempt to restart the failing process.
Error Message SVSOK080 process failed reading HCI socket, reason: explanationprocess is the SNA View server process.
explanation is the text error explanation.
Explanation An SNA View server process attempted to read from the HCI server and failed. SNA View server will notify its clients and then terminate.
Recommended Action Verify that the HCI is active. In some cases the error is due to the system load and the process will run properly if restarted.
Error Message SVSOK081 Failure reading process client UDP socket.process is the SNA View client process name.
Explanation SNA View server process failed while reading a client's socket. The SNA View server process will terminate.
Recommended Action In some cases the error is due to the system load and the process will run properly if restarted.
Error Message SVSOK082 Failure reading process server UDP socket, number bytes returned is zero.process is the SNA View server process.
Explanation An SNA View client process attempted to read from an SNA View server process and received 0 bytes of data. The detecting SNA View client process will terminate.
Recommended Action Verify that the client's server process is still active and functioning properly. In some cases the error is due to the system load and the process will run properly if restarted.
Error Message SVSOK083 Failure reading process server UDP socket, entire message not received.process is the SNA View server process.
Explanation An SNA View client process attempted to read from an SNA View server process and received only a partial message. The detecting SNA View client process will terminate.
Recommended Action Verify that the client's server process is still active and functioning properly. In some cases the error is due to the system load and the process will run properly if restarted.
Error Message SVSOK090 Failure writing to process client UDP socket.process is the SNA View client process.
Explanation An SNA View server process failed while writing data to an SNA View client process. A server process will continue processing if a write to a client process fails.
Recommended Action Verify that the client process is still active and, if not, restart the client process repeating the desired action.
Error Message SVSOK092 Failure writing to process client UDP socket, entire message not sent.process is the SNA View client process.
Explanation An SNA View server process failed to successfully send entire data. buffer to an SNA View client process. A server process will continue processing if a write to a client process fails.
Recommended Action Verify that the client process is still active and, if not, restart the client process.
Error Message SVSOK199 Failure reading SNAview mainframe Message Server, reason: explanation.explanation is the text error explanation.
Explanation The SNA View Host Connection Interface (HCI) failed while attempting to read from its socket connection with the SNA View Mainframe Message Server. The HCI server will exit, causing the termination of the majority of all SNA View processes.
Recommended Action Review text error explanation and verify TCP/IP support between workstation and the mainframe in question.
Error Message SVSOK200 Lost connection with SNAView Mainframe Message Server.Explanation The SNA View HCI lost connection with the SNA View Mainframe Message Server. This message indicates that some vital process or processes on the mainframe have terminated or become unavailable. The HCI server will exit, causing the termination of the majority of all SNA View processes.
Recommended Action Verify that status of SNA View on the mainframe and TCP/IP support.
Error Message SVSOK201 process has exited due to read failure on HCI connection.process is the SNA View server process.
Explanation An SNA View server process exited because it received a bad return code from its attempted read from the HCI socket. SNA View server process will terminate.
Recommended Action Verify that the HCI for that domain is active.
Error Message SVSOK202 process has exited due to loss of connection with the HCI.process is the SNA View server process.
Explanation An SNA View server process exited because it lost connection with the HCI. This indicates that the HCI process has terminated and is no longer available. SNA View server process will terminate.
Recommended Action Verify that the HCI for that domain is active.
Error Message SVSOK203 process has exited due to loss of connection with the Command Server.process is the SNA View command client process.
Explanation The SNA View command client process has been forced to terminate due to lost connection with its Command Server process. Process will terminate.
Recommended Action Review any accompanying SNA View error messages for the exact cause of the loss of connection. Verify that the Command Server for the client process is still active and functioning properly.
process1 is the SNA View process.
process2 is the SNA View process.
type is the message type.
Explanation An SNA View process received an invalid message type from an SNA View process. The invalid message will be ignored, and processing will continue.
Recommended Action If message persists, note message contents and contact the Cisco TAC.
Error Message SVSRV010 process has exited due to kill/term signal.process is the SNA View server process.
Explanation An SNA View server process has received a kill/term signal. The SNA View server process will notify any registered clients of its termination.
Recommended Action Restart the server process when ready.
Error Message SVSRV020 Client is not currently registered, filter request rejected.Explanation A client process attempted to send a filter request to an SNA View server process to which the client process was not properly registered. The filter request was rejected for this reason by the server. The server process will reject the client process's filter request.
Recommended Action No user action required.
Error Message SVSRV021 Client is not currently registered, command not submitted to mainframe.Explanation A client process attempted to send a mainframe command to the SNA View Command Server process to which the client process was not properly registered. Command Server will reject the client's mainframe command request.
Recommended Action No user action required.
Error Message SVSRV030 Maximum number of clients already registered, request rejected.Explanation An SNA View client process attempted to register with an SNA View server process, but the server process already had the maximum number of 100 clients it was permitted to serve. The SNA View server process rejected the client's request. The server process will reject the client's register request.
Recommended Action No user action required.
Error Message SVSRV040 Invalid receive sequence value encountered. Old seq: value, new seq: valuevalue is the integer sequence value.
Explanation While receiving a number of datagrams, an SNA View process detected that one or more datagrams is out of order or missing. Missing sequence number is reported.
Recommended Action Reissue the mainframe command.
Error Message SVSRV050 Timed out waiting for server registration response.Explanation An SNA View client process issued a registration request to its server process and no registration response has been received by the client in the provided time. SNA View client will either continue to wait or exit depending upon the user action chosen.
Recommended Action User may decide to continue waiting for the registration response or exit the SNA View client process. Verify that the proper SNA View server process is active and that the SNA View configuration parameters for the appropriate domain are correct.
Error Message SVSRV060 process error message: message.process is the SNA View server process that detected the error.
message is the error message text.
Explanation SNA View server process detected a critical error and notified the client of the error with message text.
Recommended Action Review the error message to determine the cause of the error and correct the problem.
Error Message SVSRV070 Verify that the HCI and Command Servers are active.Explanation SNA View process has detected a possible problem with connection to the mainframe, indicating that the HCI and Command Server may have terminated.
Recommended Action Make certain that the HCI and Command Servers are active and functioning properly. If not, review all SNA View error messages and restart them once any problems have been corrected. If they are still active, attempt to rerun the failing process.
Error Message SVSRV071 Command not processed. Verify that the HCI and Command Servers are active.Explanation A mainframe command was issued but SNA View was unable to process it. The HCI, Command Server, or both may no longer be active and functioning properly. No further processing for the issued command will take place.
Recommended Action Verify that the HCI and Command Servers are up and functioning properly. If they are not, restart them or contact the Cisco TAC.
Explanation The SNA View Task Manager could not retrieve SNA View domain names. The Task Manager will terminate.
Recommended Action Verify that configuration files for at least a single domain exists in /etc.
Error Message SVTSK020 Task Manager failed opening configuration file for domain.domain is the SNA View domain.
Explanation The SNA View Task Manager could not open the configuration file for a particular domain. The Task Manager will terminate.
Recommended Action Verify that the configuration file's permissions are such that the Task Manager process has read authority.
|
|