Banner
HomeTOCPrevNextGlossSearchHelp

PDF

Table of Contents

Troubleshooting SNA View on the Workstation



Troubleshooting SNA View on the Workstation

Troubleshooting SNA View on the Workstation

This chapter contains the following sections:


Overview of SNA View Workstation Error Handling

SNA View processes relay operating and error messages to several locations.

All SNA View errors are of the form SV XXXnnn message, 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.


Generating Supplemental Debugging Data

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.

Table 6-1 Available Debug Settings

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:

Table 6-2 Debug Process Identifiers

Process ID Affected SNA View Processes
SVHCI Host Connection Interface
SVALERTP Alert Server, Alarm Manager, and X Alert Client
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


General Problems

This section highlights problems that are not particular to any single component of SNA View. This section discusses the following problems:


Note You must be the root user to complete many of the tasks in this section.


Environment Variable Problems

The SVHOME environment variable must be set before SNA View will function properly. This variable must be set to the SNA View's 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.

For example, if the SVHOME environment variable is not set and you attempt to launch the Alert Server, the following error message will be returned:

SVINI030 Alert Server needs the SVHOME environment variable set properly.        

If the environment variable is set, but set incorrectly (to /var/sv, for example), you would receive a message similar to the following:

SVEXE010 CP_Table_Init() failed to open file        
/var/sv/parm/svcodepts/svcpt01.txt 
Reason: No such file or directory.

In this example, the Alert Server is unable to locate the necessary code point tables in the directory /var/sv/parm because they do not exist. In general, if SNA View is unable to locate specific files that it requires, the SVHOME environment variable should be checked first.


Configuration File Problems

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.


Note SNA View processes retrieve parameters only once during initialization. Therefore, after making modifications to a configuration file, the necessary processes must be recycled to put the changes into effect.

The following sections describe each of these parameters, and the problems that can arise if they are not set correctly.


SVPATH

SNA View home directory (such as /usr/sv).

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 changed from its default value of none and the Status Manager is started, the following error messages will be written to stderr:

SVEXE010 Set_Debug_Flag2() failed to open file none/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.


SVVTAM_AGENT_ADDR

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 X 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.        


SVMVS_AGENT_ADDR

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 X 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.        


SVALERT_AGENT_ADDR

Machine name of workstation running the Alert Server.

If this parameter is not properly set to the machine name of the workstation where the Alert Server will be running, the X Alert Window clients will not be able to register to receive unsolicited Alert messages.

Two symptoms indicate the SVALERT_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 Alert Server is not currently running on that machine, the following error message will be generated:

SVSRV050    Timed out waiting for server registration response.        


SVCMDS_AGENT_ADDR

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 X 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.         


SVHCI_AGENT_ADDR

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, MVS, and Alert 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.


SVMF_AGENT_ADDR

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, then the Host Connection Interface and the Command Server will not initialize successfully (when using TCP/IP for communications between the mainframe and the 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 the following 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 refer to the CiscoWorks Blue SNA View Mainframe Installation Guide for more details.


SVCMD_TIMEOUT

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.

After increasing the value of this parameter, the Status Manager or Discovery processes must be recycled. Please note that the Command Server does not need to be recycled.

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 refer to the CiscoWorks Blue SNA View Mainframe Installation Guide for assistance.


SVCMD_OPERATOR

Valid NetView operator ID.

If this parameter is not set to a valid NetView operator ID, NetView commands issued from the X Command Client window will fail.

SVWORK_AREA

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)."


SVVTAM_AGENT_PORT, SVMVS_AGENT_PORT, SVALERT_AGENT_PORT,SVCMDS_AGENT_PORT

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, Alert 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.        


SVHCI_VTAM_PORT, SVHCI_MVS_PORT, SVHCI_ALERT_PORT, SVHCI_STATUS_PORT

The Host Connection Interface communicates with the VTAM, MVS and Alert 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.


SVMF_HCI_AGENT_PORT, SVMF_CMDS_AGENT_PORT

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 refer to 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.


Authority and Access Problems (Permissions)

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 Status Manager, which opens a file in SNA View's temporary work directory, specified by the configuration file parameter WORK_AREA (the default value of WORK_AREA is /tmp). The Status Manager uses this file to store its own process identifier and to determine whether there is already a Status Manager running for a specific domain.

If the Status Manager is originally run under the Root user ID, and later run under a particular user's ID, the following error messages are generated by SNA View:

SVSM020    Cannot store the Status Manager's Process ID: exiting.        
SVEXE102    Status Manager process of domain [domain name] has exited.

In this example, the Status Manager process was unable to obtain write authority for the necessary file, so the process exited. Changing the file permissions or ownership of the SV_s_m_pid.[domain] file in /tmp would correct the problem (where DOMAIN is equal to the appropriate SNA View domain name).

Files placed in WORK_AREA by SNA View are prefixed by SV*. The Status Manager, Discovery, Domain Layout and Refresh processes all place files in the directory specified by the WORK_AREA configuration parameter.

Table 6-3 lists the files created by each process.

Table 6-3 Work Files Created by SNA View Processes

Process Files Created
Status Manager SV_s_m_grep
SV_s_m_pid
SV_act_stat
Discovery and Refresh SV_clstrs
SV_terms

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.

Table 6-4 Log Files Utilized by SNA View Processes

Process Associated Log File
Status Manager svstatman.log
VTAM Server svvtam.log
MVS Server svmvs.log
VTAM Message Log svmessage_log
MVS Message Log svmvs_message_log

In order for an SNA View process to function as expected, all of the parameters it references must be available and set correctly.

Table 6-5 lists the parameter files referenced by each of the SNA View processes.


Note All SNA View parameter files reside in the $SVHOME/parm directory unless otherwise specified in the table to be a subdirectory of $SVHOME/parm.

Table 6-5 Parameter Files Referenced by SNA View Processes

Process Parameter Files Referenced
Host Connection Interface svdebug.parm
Command Server svdebug.parm
VTAM Server svdebug.parm
svvtamsysfilter.tbl
MVS Server svdebug.parm
svmvssysfilter.tbl
Alert Server svdebug.parm
svcodepts/svcpt01.txt
svcodepts/svcpt10.txt
svcodepts/svcpt81.txt
svcodepts/svcpt82.txt
svcodepts/svcpt92.txt
svcodepts/svcpt93.txt
svcodepts/svcpt94.txt
svcodepts/svcpt95.txt
svcodepts/svcpt96.txt
Status Manager svdebug.parm
SNA View Discovery Process svdebug.parm
Refresh Maps Process svdebug.parm
Check Status Process svdebug.parm
VTAM Message Log svdebug.parm
MVS Message Log svdebug.parm
Mainframe Commands Window svdebug.parm
VTAM Messages Window svdebug.parm
MVS Messages Window svdebug.parm
Alert Window svdebug.parm
svcodepts/svcpt01.txt
svcodepts/svcpt10.txt
svcodepts/svcpt81.txt
svcodepts/svcpt82.txt
svcodepts/svcpt92.txt
svcodepts/svcpt93.txt
svcodepts/svcpt94.txt
svcodepts/svcpt95.txt
svcodepts/svcpt96.txt
Alert Summary Window svdebug.parm
svcodepts/svcpt01.txt
svcodepts/svcpt10.txt
svcodepts/svcpt81.txt
svcodepts/svcpt82.txt
svcodepts/svcpt92.txt
svcodepts/svcpt93.txt
svcodepts/svcpt94.txt
svcodepts/svcpt95.txt
svcodepts/svcpt96.txt
Command Client Process svdebug.parm


Component-Specific Problems

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:


Note You must have superuser authority on the workstation or mainframe logon to complete many of the tasks described in this chapter.


Problems Relating to Task Management

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.


Problems Connecting to a Specific Domain

If you attempt to connect to a domain you believe to be active but the Task Manager indicates that the domain is inaccessible, either the HCI and Command Server for that domain are not running properly, or there are problems with the domain's configuration file. In order to gain access to a particular domain, the Task Manager attempts to register to the Command Server for that domain. If this registration is unsuccessful, the domain is considered inaccessible.

First, 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.

Next, issue one of the following commands, depending upon your operating system, to determine what SNA View processes are currently running.

On HP-UX, AIX, OSF/1, and Solaris systems:

ps -ef|grep sv        

On SunOS systems:

  ps -ax|grep sv        

The response to this command will indicate whether or not the HCI and Command Server are actually running for the desired domain.

If the HCI and Command Server are running for domain DOMAIN1, for example, messages similar to the following will be displayed:

root 14154     1  8 05:13:47 ?        0:00         
/usr/sv/bin/svcommand_tcp_server DOMAIN1
root 14152     1  8 05:13:42 ?        0:00 
/usr/sv/bin/svhci_tcp_server DOMAIN1
root 14187 14138  0 05:24:37 ttyp5    0:00 grep sv

If the HCI and Command Server are shown by the ps command to be active, either they did not initialize successfully, or the Command Server is no longer accepting registration requests. In either case, check the console where they were started for SNA View error messages. If you are unable to locate any error messages, stop the HCI and Command Server processes using the UNIX kill command.

Re-starting the HCI and Command Server in LU6.2 environments        

If the domain uses LU6.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 they have not, refer to "Problems Starting the Host Connection Interface and Command Server Tasks" for more information.

Restarting the HCI and Command Server in TCP/IP environments        

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].

If the above SVINI001 messages are not produced, or if the HCI and Command Server exit for any reason, refer to "Problems Starting the Host Connection Interface and Command Server Tasks" for the appropriate action to take.


Problems Starting the Host Connection Interface and Command Server Tasks

The HCI and Command Server are responsible for all communications with the SNA View mainframe component and are therefore critical to all SNA View workstation processes. This section provides solutions to several problem scenarios that could prevent the HCI and Command Server from starting successfully.


Configuration file problems

If the HCI or Command Server are having socket-related communication problems, refer to "Configuration File Problems" for details on parameters required to establish socket communications.


Connectivity problems

If the HCI and Command Server are having problems establishing TCP/IP or LU6.2 communications with the mainframe component, refer to "Workstation-to-Mainframe Connectivity Problems" for details on specific problems and solutions.

Problems Starting the VTAM Server Task

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.


Problems Starting the MVS Server Task

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.


Problems Starting the Alert Server Task

The Alert Server is responsible for providing SNA Alerts to all registered Alert clients. If the Alert Server will not initialize successfully, 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_ALERT_PORT configuration parameters. Verify that they are set correctly and that the Host Connection Interface is active.


Sybase problems

The Alert Server stores SNA Alerts on a per resource basis in a Sybase database. If there is a problem with the Sybase database that prevents the Alert Server from logging in to or writing to the database, the Alert Server may not initialize successfully or run properly.

Environment Variables. The Alert server requires that the SYBASE and DSQUERY environment variables be set properly in order to establish a session with the Sybase database. If DSQUERY is not set, the default value of SNA will be utilized. Verify that these environment variables are set properly before starting the Alert Server.

Database login failure. The Alert Server will generate the following messages if it encounters problems logging in to the Sybase database:

SVSYB000  Sybase database login failure, rc:         [rc]
SVEXE000  Alert Server failed calling DbLogin().
SVEXE102  Alert Server process of domain [DOMAIN] has exited.

Verify that any and all Sybase servers are up and running properly or contact your Sybase database administrator for assistance. Once these issues are resolved restart the Alert Server.

Database write failure. The Alert Server will generate the following messages if it encounters problems adding or updating database records:

SVSYB010  Unexpected error during attempt to add database record, rc:         [rc]
SVEXE000  Alert Server failed calling db_filter().
SVEXE102  Alert Server process of domain [DOMAIN] has exited.

or

SVSYB010  Unexpected error during attempt to update database record, rc:         [rc]
SVEXE000  Alert Server failed calling db_filter().
SVEXE102  Alert Server process of domain [DOMAIN] has exited.

Verify that any and all Sybase servers are up and running properly or contact your Sybase database administrator for assistance. Once these issues are resolved, restart the Alert Server.


Problems Starting the VTAM Message Log Task

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" pay for details on possible solutions. In the "Configuration File Problems" subsection of "General Problems," pay special 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.


Problems Starting the MVS Message Log Task

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 refer to "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.


Problems Starting the Status Manager Task

If the Status Manager will not initialize successfully, note the error messages generated and refer to "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.


Problems Relating to Discovery and Status Management

Problem relating to discovery and status management include:


Problems Discovering your Correlation Data

Discovery is a process that gathers the information on Physical Units (PUs) for a specific domain and inputs that information into the Sybase database.


Connectivity Errors

To gather information for the discovery process, a connection to the domain must be established. Problems can occur with this connection. Refer to "Workstation-to-Mainframe Connectivity Problems" for more detail.


Command-Related Errors

Discovery gathers the domain information by issuing VTAM displays. These commands may fail in some cases. For details, refer to "Problems Issuing Mainframe Commands."


Errors Specifying a Domain Name

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.        


Output File Permissions Errors

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 prefixed by SV_XXX, which reside in the SVWORK_AREA directory.


Sybase API Initialization Error

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.


Configuration Variable Error

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, refer to "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.


Log File Error

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.


Data Gathering Errors

The Pu_discover process gathers some of the data about SNA resources by issuing a VTAM command (d net,clstrs) to the mainframe that it is monitoring. If the response from that command is in error, the Pu_discover process will exit with the following error messages:

PU_DISCOVER - the clstrs command failed: exiting.        
SVEXE102 PU_Discover process of domain [domain] has exited.

The Pu_discover 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_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_DISCOVER - data_collection - cannot open pu data file: return.        

If Pu_discover finds an error in the above mentioned file it, will stop gathering data for that resource and output the following error message:

PU_DISCOVER - the clstrs command failed: return.        

Pu_discover 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_discover - Unable to open RIF-MAC data file.        


Data Conversion Errors

The Pu_discover process must convert 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 generated:

PU_DISCOVER - PU type not converted: return = PU_TYPE_NUMBER        
logfile     PU NAME = PU_NAME was not added: type conversion failed.
PU_DISCOVER - PU status not converted: return = STATUS_NUMBER
logfile     PU NAME = PU_NAME was not added: status conversion failed.
PU_DISCOVER - LU status not converted: return = STATUS_NUMBER
logfile    LU NAME = %s was not added: status conversion failed.


Debug File Errors

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.


Unknown Resource Type

If Discovery encounters a resource that it does not know how to handle, it will issue the following messages:

SVDIS500  An unknown ISTXXXI message was found: exiting.        
SVEXE102 Evoicon_up process of domain [domain] has exited.

Please contact the Cisco TAC if this problem occurs.


Logical Units not Discovered

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.


Problems with Managing the Status of Your SNA Network

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.


Connectivity Errors

To receive information on status changes, a connection to the monitored domain must be established. Problems can occur with this connection. Refer to "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.


Command-Related Errors

The Status Manager gathers information on new resources by issuing VTAM displays. These commands may fail in some cases. For details, refer to "Problems Issuing Mainframe Commands."


Errors Specifying a Domain Name

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.        


Sybase API Initialization Error

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.


Configuration Variable Error

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, refer to "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.


Socket Mode Error

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.


Socket Errors

Since Pu_status_manager is a standard client, the socket errors (SVSOKxxx) described in "SNA View Workstation Messages" should be referred to for details.


Data Gathering Errors

The Pu_status_manager 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_sm_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_STATUS_MANAGER - data_collection - cannot open pu data file: return.        

If Pu_status_manager finds an error in the above mentioned file it will stop gathering data for that resource and output the following error message:

PU_STATUS_MANAGER - the clstrs command failed: return.        

The Pu_status_manager 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_status_manager - Unable to open RIF-MAC data file.        


Data Conversion Errors

The Pu_status_manager process must convert the VTAM data into the 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_STATUS_MANAGER - PU type not converted: return = PU_TYPE_NUMBER        
logfile     PU NAME = PU_NAME was not added: type conversion failed.
PU_STATUS_MANAGER - PU status not converted: return = STATUS_NUMBER
logfile     PU NAME = PU_NAME was not added: status conversion failed.
PU_STATUS_MANAGER - LU status not converted: return = STATUS_NUMBER
logfile    LU NAME = %s was not added: status conversion failed.


Debug File Errors

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.


Problems Checking the Status of a Device in Your SNA Network

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 Errors

Connectivity to the domain in which the resource resides must be established in order to receive the display information. Refer to "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  Evo_identify can not reach domain         [DOMAIN]: exiting.
SVEXE100  Evo_identify process has exited.


Command-Related Errors

Check Status gathers information on new resources by issuing VTAM displays. These commands may fail in some cases. For details refer to "Problems Issuing Mainframe Commands."


Errors Specifying a Domain Name and Resources

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]>.


Sybase API initialization Error

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.


Configuration Variable Error

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, refer to "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.


Data Gathering Errors

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.        


Data Conversion Errors

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.


Debug File Errors

The Pu_identify 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_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.


Problems Issuing Mainframe Commands

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:


Time Out Attempting to Register to the Command Server

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. Refer to "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.


Unable to Log into Mainframe Command Window

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.


Pull-Down Menu Commands Time out Waiting for Command Responses

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. 

Refer to the information on the SVCMD_TIMEOUT information in "Configuration File Problems" for details on this parameter.


Incomplete Command Responses Returned to Mainframe Command Window

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. Refer to the information on the SVCMD_TIMEOUT parameter in "Configuration File Problems" for details on the performance group setting.


Problems Specific to Issuing VTAM Commands

The following situations can arise while issuing VTAM commands.


Receiving Command Invalid Message

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. Refer to IBM's VTAM Operations Guide for the syntax for specific commands.


No Command Responses Returned

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. Refer to the CiscoWorks Blue SNA View Mainframe Installation Guide or your system administrator for details on how to determine if a SPO subtask is active.


Problems Specific to Issuing MVS Commands

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. Refer to the CiscoWorks Blue SNA View Mainframe Installation Guide or your system administrator for details on determining if the CMD subtask is active.


Problems Specific to Issuing NetView Commands

The following situations can arise while issuing NetView commands.


No Command Responses Returned

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. Refer to the CiscoWorks Blue SNA View Mainframe Installation Guide or your system administrator for details on determining if the PPI subtask is active.


Commands Fail with SV315 Return Message

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         

Refer to "Configuration File Problems" for details on the SVCMD_OPERATOR configuration parameter.


Problems With Unsolicited Mainframe Messages

Potential problems with unsolicited mainframe messages are categorized as follows:


Problems Receiving Unsolicited VTAM Messages

The following situations can arise with receiving unsolicited VTAM messages.


Problems Starting the VTAM Messages Window

If the VTAM Messages client window does not come up successfully, review the error messages issued by the process to standard error. Also, refer to "General Problems" for details on possible solutions.


Problems Registering to the VTAM Server

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, refer to "Configuration File Problems" for details on the SVVTAM_AGENT_ADDR and SVVTAM_AGENT_PORT parameters.


Registered to VTAM Server but Receiving No Messages

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.


Problems Receiving Unsolicited MVS Messages

The following situations can arise with receiving unsolicited MVS messages.


Problems Starting the MVS Messages Window

If the MVS Messages client window does not come up successfully, review the error messages issued by the process to standard error. Also, refer to "General Problems" for details on possible solutions.


Problems Registering to the MVS Server

If the MVS Messages window appears but then times out while attempting to register to the MVS 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 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, refer to "Configuration File Problems" for details on the SVMVS_AGENT_ADDR and SVMVS_AGENT_PORT parameters.


Registered to MVS Server but Receiving No Messages

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.


Problems Receiving SNA Alerts

The following situations can arise with receiving SNA alerts.


Problems Starting the Alert Window

If the Alert client window does not come up successfully, then review the error messages issued by the process to standard error. Also, refer to "General Problems" for details on possible solutions.


Problems Registering to the Alert Server

If the Alert window appears but then times out while attempting to register to the Alert 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 Alert Server is not up and running properly, or the SVALERT_AGENT_ADDR and/or SVALERT_AGENT_PORT configuration parameters are not set correctly.

Verify that the Alert Server is running on the proper machine and, if so, refer to "Configuration File Problems" for details on the SVALERT_AGENT_ADDR and SVALERT_AGENT_PORT parameters.


Registered to the Alert Server but Receiving No Alerts

When SNA View is running in conjunction with NetView, the PPI subtask must be active in order for SNA View to receive unsolicited alert data. If running in a VTAM-only environment, the CNM subtask must be active in order to receive SNA alerts. Verify that the proper SNA View subtask is currently active on the mainframe by contacting your mainframe system administrator.


Problems Retrieving Alarm Summary Information for an SNA Resource

The following situations can arise with retrieving alarm summary information for an SNA resource.


Problems Starting the Alarm Summary Window

If the Alarm Summary window does not come up successfully, review the error messages issued by the process to standard error. Also, refer to "General Problems" for details on possible solutions.


No Database Record for Specified Resource

The Alarm Summary process will issue the following error message to a Motif pop-up window in the event that the selected resource has no alerts stored in the alert database:

SVSYB050 Alert database contains no record for resource         [resource]

Please select another SNA resource or verify that the Alert Server is active and wait until an SNA alert is received against this resource.


Workstation-to-Mainframe Connectivity Problems

This section details problems related to communications between the mainframe and the workstation in TCP/IP and LU6.2-connected environments.


TCP/IP Connectivity Problems

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.

If any of these steps do not verify correctly, resolve the problem and recycle SNA View.


LU6.2 Connectivity Problems

LU6.2 connectivity issues can be rather complex to debug. The vast majority of LU6.2 connectivity issues are resolved during the installation phase of SNA View when communications are initially configured.

The best source of information for debugging LU6.2 problems is the job log of the SNA View mainframe component. This log will contain any error messages written by the failed SERVER subtask. Please refer to the CiscoWorks Blue SNA View Mainframe Installation Guide for more details on problems and solutions with the SERVER subtask and LU6.2 communications. This section discusses issues specific to the SNA stacks that SNA View will run under.


Problems with HP's SNAplus Software

If HP's SNAplus software is in use, there are two sources of information that are helpful when troubleshooting LU6.2 connectivity problems: logs (audit and error messages) and link traces.


Configuring Audit and Error Logging

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 refer to the HP-UX SNAplusLink Administrator's Guide for more details on specifying log files and message severity levels.


Starting an SNAplus Link with Tracing

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 refer to the HP-UX SNAplusLink Administrator's Guide for more details.


Problems with IBM's SNA Services or SNA Server Software

The following situations can arise with using IBM's SNA Services or SNA Server software for host connectivity.


Verifying Transaction Programs in $SVHOME/bin

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 LU6.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 LU6.2 communications, they can be created by issuing 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


Generating SNA Error Reports Via SMIT

The SNA Services and SNA Server applications maintain error logs which detail SNA (and therefore LU6.2) failures that occur. Follow these steps or refer to 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.


SNA View Workstation Messages

This document explains the messages generated by the SNA View workstation component.

The following categories of messages are described in this appendix:


Installation Messages --- SVINSxxx

Error Message SVINS000

Install Program was unable to locate a domain menu entry.        

Explanation The SNA View install program was unable to find a domain menu entry in the registration file it was modifying. Install program will terminate.

Recommended Action Contact the Cisco TAC.

Error Message SVINS010

Install Program was unable to copy file         to directory.

file is the SNA View install file.

directory is the destination directory.

Explanation The SNA View install program was unable to copy a required file to the specified directory. Install program will terminate.

Recommended Action Check the file permissions on the specified directory. You must have root authority when running the install program.

Error Message SVINS011

Install Program was unable to append file         to path.

file is the SNA View install file.

path is the destination file path.

Explanation The SNA View install program was unable to append a required file to the specified file. Install program will terminate.

Recommended Action Check the file permissions on the specified directory. You must have root authority when running the install program.


Socket Communication Messages --- SVSOKxxx

Error Message SVSOK001

process         failed calling function, reason: explanation

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: socket        

socket 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: socket        

socket 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: explanation

process 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.


LU6.2 Communication Messages --- SVLUXxxx

Error Message SVLUX000

process         failed calling name with errno: renumber

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 LU6.2 system routine and was returned an error code. The SNA View process that detected the error will terminate.

Recommended Action Review any LU6.2 communication errors generated in the mainframe's system log or the workstation's SNA stack error logs. Verify that your LU6.2 communications are configured properly.

Error Message SVLUX010

Failure opening direction         LU6.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 LU6.2 communication errors generated in the mainframe's system log or the workstation's SNA stack error logs. Verify that your LU6.2 communications are configured properly.

Error Message SVLUX020

Failure allocating direction         LU6.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 LU6.2 communication errors generated in the mainframe's system log or the workstation's SNA stack error logs. Verify that your LU6.2 communications are configured properly.

Error Message SVLUX030

Failure reading over direction         LU6.2 conversation.

direction is inbound or outbound.

Explanation The HCI or the Command Server failed to read from the LU6.2 connection that exists between it and the mainframe code. The SNA View process that detected the error will terminate.

Recommended Action Review any LU6.2 communication errors generated in the mainframe's system log or the workstation's SNA stack error logs. Verify that your LU6.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 LU6.2 communication errors generated in the mainframe's system log or the workstation's SNA stack error logs. Verify that your LU6.2 communications are configured properly.

Error Message SVLUX040

Failure confirming conversation         LU6.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 LU6.2 communication errors generated in the mainframe's system log or the workstation's SNA stack error logs. Verify that your LU6.2 communications are configured properly.

Error Message SVLUX050

Failure sending over conversation         LU6.2 conversation.

conversation is the inbound or outbound conversation.

Explanation The HCI or Command Server detected a failure while attempting to send over the LU6.2 conversation with the mainframe. The SNA View process that detected this failure will terminate.

Recommended Action Review any LU6.2 communication errors generated in the mainframe's system log or the workstation's SNA stack error logs. Verify that your LU6.2 SNA profiles are configured properly.

Error Message SVLUX060

Failure closing conversation         LU6.2 conversation.

conversation is the inbound or outbound conversation.

Explanation The HCI or Command Server detected a failure while attempting to close the LU6.2 conversation with the mainframe. The SNA View process that detected this failure will terminate.

Recommended Action Review any LU6.2 communication errors generated in the mainframe's system log or the workstation's SNA stack error logs. Verify that your LU6.2 SNA profiles are configured properly.


Management Platform API Messages --- SVAPIxxx

Error Message SVAPI001

process         can not make initial connection with management API.

process is the SNA View process.

Explanation An SNA View process cannot make its initial connection with the network management platform. The SNA View process that detected the error will terminate.

Recommended Action The SNA View process should be executing with the same User ID and User Group as the network management platform. Stopping and starting the entire management structure can also help. This action includes the network management platform and all of the SNA View processes.

Error Message SVAPI002

process         was not able fill symbol map.

process is the SNA View process.

Explanation An SNA View process cannot open the symbol parm file $SVHOME/parm/sv- discover.parm. The SNA View process that detected this failure will terminate.

Recommended Action Verify that the $SVHOME environment variable is set correctly. Also verify the file permissions on the symbol/status parm file svdiscover.parm/svstatman.parm. They should be set so that the User ID under which the network management platform is running has read-write authority.

Error Message SVAPI003

process         was not able fill status map.

process is the SNA View process.

Explanation An SNA View process cannot open the status parm file: $SVHOME/parm/sv- statman.parm. Because the SNA View process cannot get the data it needs to interact with the network management platform's API, it must exit.

Recommended Action Verify that the $SVHOME environment variable is set correctly. Also verify the file permissions on the symbol/status parm file svdiscover.parm/svstatman.parm. They should be set so that the User ID under which the network management platform is running has read-write authority.

Error Message SVAPI004

process         was not able to lock data base.

process is the SNA View process.

Explanation An SNA View process cannot lock the SunNet Manager network management platform database. The SNA View process that detected the error will terminate.

Recommended Action Verify that the SNA View process is executing with the same user ID and user group as the network management platform.

Error Message SVAPI005

process         failed trying to add a node to the management platform: code.

process is the SNA View process.

code is the integer error code.

Explanation An SNA View process failed to add a node to the network management platform database and received an error code. The SNA View process that detected the error will terminate.

Recommended Action Verify that the SNA View process is executing with the same user ID and user group as the network management platform.

Error Message SVAPI100

API error message: text        .

text is the error message text.

Explanation A text error message set by the network management platform API.

Recommended Action No user action is required.


Process Initialization Messages --- SVINIxxx

Error Message SVINI000

process         initialized successfully.

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 server        

server 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 LU6.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 Execution Messages --- SVEXExxx

Error Message SVEXE0

process         has completed without error.

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 function

process 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: rcnumber

process 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: message

process 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. 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 SVEXE010

process         failed to open file path, reason: message

process 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.


Encryption Messages --- SVENCxxx

Error Message SVENC000

License is not in order, exiting immediately.        

Explanation SNA View's license file /etc/sv_lic does not contain a valid encryption key. SNA View will terminate.

Recommended Action Contact your SNA View representative and obtain a valid encryption key to place in the /etc/sv_lic file.

Error Message SVENC001

License check failed on IP address check: message        .

message is the SNA View license message.

Explanation While attempting to validate the SNA View license, the IP address verification failed with message. SNA View will terminate.

Recommended Action Contact your SNA View representative and obtain a valid encryption key to place in the /etc/sv_lic file.


Server Messages --- SVSRVxxx

Error Message SVSRV000

Invalid message type received by process1         from process2: type

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: value 

value 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.


Message Filtering Messages --- SVFILxxx

Error Message SVFIL000

Line number         of type system filter table is invalid.

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 pair        

Explanation 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 entry        

Explanation 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.


Alert Server Messages --- SVALSxxx

Error Message SVALS012

Parsing error, no internal code point table for subvector: name        

name is the subvector for when a code table is not available.

Explanation The Alert Server has detected a parsing error. A code point translation request was made for a subvector for which no internal code point table exists. The Alert Server process will terminate.

Recommended Action If this problem persists, contact the Cisco TAC.


Client Messages --- SVCLIxxx

Error Message SVCLI000

Invalid -display option use: -display Display Name.        

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: rcnumber

client 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 user name and password, which failed to pass RACF. The SNA View client must exit.

Recommended Action Ensure that the user name 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


Discover Messages --- SVDISxxx

Error Message SVDIS097

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 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.


Status Manager Messages --- SVSMxxx

Error Message SVSM010

PS file could not be opened: exiting.        

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.


Identifying Process Messages --- SVIDxxx

Error Message SVID010

act_stat could not open input file name        

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.


Check Status Messages --- SVCSxxx

Error Message SVCS010

The name of the resource can not be found on the command line: exiting.        

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.


Build Select Messages --- SVBSELxxx

Error Message SVBSEL001

PS file could not be opened: exiting.        

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 that particular domain, paying 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 in a specific file.

Since it cannot store its process Id, no other svbuild_select 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.


Building SNA Network Messages --- SVBSNxxx

Error Message SVBSN010

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 SVBSN020

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 SVBSN030

The manipulation of display         is complete.

display is the type of display.

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.


Refresh Messages --- SVREFxxx

Error Message SVREF010

Active_Refresh cannot open data file path        : returning.

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.


Task Manager Messages --- SVTSKxxx

Error Message SVTSK000

Task Manager has failed to make connection with the management platform.        

Explanation For Some of the management platforms, the SNA View Task Manager must make connection with the management platform to start the SNA View Status Manager and the SNA View Alarm Manager. In this case the process of making the connection failed.

The SNA View Task Manager continues, but the SNA View Status Manager and the SNA View Alarm Manager will not be able to start.

Recommended Action Start the SNA View Task Manager from the management platform's pull-down menu system.

Error Message SVTSK010

Task Manager has failed to retrieve domain names: exiting.        

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.

Error Message SVTSK030

Task Manager failed to open its process ID file.        

Explanation The SNA View Task Manager could not open the file it uses to store process IDs. Without the process IDs, the task manager cannot stop processes and must exit.

Recommended Action Check the permission on the /tmp directory to ensure that the SNA View Task Manager can open a file in it.

HomeTOCPrevNextGlossSearchHelp
-

Copyright 1988-1996 © Cisco Systems Inc.