Troubleshooting the SNA View Mainframe Application

Use this chapter to identify and resolve problems with the SNA View mainframe application. When you encounter an unfamiliar message or problem, consult this chapter before taking any other action.

This chapter contains two major sections:

Subtask Startup Problems--Describes how to resolve SNA View failures that are attributable to mainframe subtask problems.
Mainframe Messages--Lists the meaning of and appropriate user response for each message generated by the SNA View mainframe application.

Subtask Startup Problems

This section describes corrective measures for SNA View malfunctions attributable to mainframe subtask failures. Almost all subtask startup failures are accompanied by one or more messages that are written to the SYSLOG, to the SNA View output job log, or to both. Check the list of SNA View mainframe messages in the section "Mainframe Messages" for courses of action to take when a given error message is displayed.

The following sections describe the appropriate actions to take when a failure of a specific subtask occurs.

LU 6.2 Connection (SERVER Subtask)

A successful LU 6.2 connection requires exact compliance with the setup instructions given in this manual and the CiscoWorks Blue SNA View Workstation Installation Guide. All steps in the connection must be up and available, and all parameters between the mainframe and the workstation must match exactly.

If the LU 6.2 session fails to connect, perform the following steps.

Note Restart the mainframe address space each time a modification is made to a data set or resource.

Step 1 Verify that the SYSIN deck has a SERVER card with the following five parameters:

A VTAM APPL resource
A VTAM independent LU
The PARALLEL parameter
A TPN for the workstation host command interface (NSPOPNMS)
A TPN for the workstation command server (NSPOPNCS)

Step 2 Verify that the VTAM APPL resource is defined in SYS1.VTAMLST with the parameter APPC=YES. Verify that the resource is activated under VTAM.

Step 3 Verify that the VTAM LU is defined as an independent LU, either by a LOCADDR=0 definition under its PU, or as a CDRSC in a CDRSC major node definition. Verify that the LU is activated under VTAM.

Step 4 Stop the SNA View address space and check the bottom of the output job log for messages. The most significant messages are the primary and secondary return codes (RCPRI and RCSEC) from the LU 6.2 connection request.

Check the job log for the first occurrence of message NSP111, NSP112, or NSP907. The RCPRI and RCSEC codes are fully documented in the IBM VTAM Programming for LU 6.2 manual.

RCPRI/RCSEC combinations commonly encountered when installing SNA View are listed in Table 4-1.

Table 4-1: Common RCPRI/RCSEC Combinations

RCPRI	RCSEC	Meaning and User Action
0 hex	0 hex	Connection completed successfully. No action required.
0 hex	1 hex	Connection completed successfully. No action required.
0 hex	2 hex	Connection completed successfully. No action required.
4 hex	8 hex	The workstation did not recognize the TPN name that was sent from the mainframe. Check for a mismatch in the spelling of the fourth and fifth parameters of the SERVER SYSIN card against the spelling of the TPN profiles on the workstation.
4 hex	9 hex	The workstation recognizes the executable name, but cannot start it. Verify that the executable filenames specified in the workstation TPN profiles match the actual executable program names. Recall that the executable names have the domain name appended to them during installation.
4 hex	A hex	Step 1 Start the svhci_server program manually on the workstation and verify that it starts without error. Step 2 Check the file permissions on the workstation executable programs. Step 3 If running on an HP workstation, recycle SNA. (The workstation recognizes the TPN executable, but encountered a problem while activating it.)
8 hex	0 hex	Step 1 Verify that SNA and the SNA attachment are active on the workstation. Step 2 If the workstation connection is by Token Ring, verify that the 12-digit MAC address is correctly entered on the workstation and that the NETID matches the NETID in the mainframe data set SYS1.VTAMLST(ATCSTRxx). Step 3 Verify that the LU name in the second parameter of the SERVER SYSIN card matches the available VTAM LU.
8 hex	1 hex	Step 1 Verify that the link station is active on the workstation. Step 2 Verify that the VTAM APPL definition and independent LU (specified in the first and second parameters of the SERVER SYSIN card) are active.
10 hex	2 hex	VTAM is attempting to process two requests of the same mode type on the same LU. This is frequently caused by multiple restart attempts within a short period of time. Stop the SERVER subtask, wait 30 seconds, and then restart it.
14 hex	0 hex	The transaction program on the workstation terminated abnormally. Wait until all ports on the workstation are cleared. Before retrying the connection, enter the command, `ps -ef \| grep sv` on the workstation to verify that there are no extraneous processes running.
2C hex	1 hex	The logmode name specified in the third parameter of the SERVER SYSIN card was not recognized on the workstation. If an NSP112 message was issued to indicate that the SNASVCMG CNOS succeeded, but the PARALLEL CNOS failed, verify that SNA and the SNA attachment are active on the workstation.
48 hex	0	The LU 6.2 conversation was terminated prematurely. Check to see if either SNA services or SNA server was stopped on the workstation.
4C hex	0	The session used for the LU 6.2 conversation has been terminated, possibly because of a line or modem failure. Check for a break in the physical connection between the workstation and mainframe.
98 hex	0	An overload of commands with large replies is causing a memory shortage while sending data.

TCP/IP Connection (TCP Subtask)

Setting up a TCP/IP connection is less complex than setting up an LU 6.2 connection, but it requires that the mainframe has a TCP/IP package installed. If a TCP/IP stack is not available, you must use the LU 6.2 connection method.

The most common problem with the TCP/IP connection is an inability of the SNA View TCP subtask to communicate with IBM's TCP/IP package. Usually the name of either the TCP/IP address space or the TCP/IP data sets has been changed from the default. When SNA View is unable to find the TCP/IP address space or the TCP/IP profile data sets, it will usually generate the following error message:


NSP150  TCP/IP communications: socket() for workstation message agent failed with errno 39

If this message is displayed during SNA View startup, perform the following steps (not all of these steps may be relevant on your system).

Note Restart SNA View after each item if any changes are made.

Step 1 If the TCP/IP data sets are not using the default high-level qualifier, make a copy of the hlq.TCPIP.DATA data set and name it TCPIP.TCPIP.DATA.

Step 2 If the TCP/IP address space is not named TCPIP, edit the TCPIP.TCPIP.DATA data set that you just created and verify that the TCPIPJOBNAME or TCPIPUSERID parameter is correctly set to the name of the TCP/IP address space.

Step 3 If the parameter in your TCPIP.TCPIP.DATA data set is TCPIPJOBNAME, change it to TCPIPUSERID. (Older versions of the TCP/IP connection software do not recognize TCPIPJOBNAME.)

Step 4 Specify the TCP/IP prefix as the optional third parameter on the TCP parameter card in NSPPARM. It should be the HLQ for where the TCP data sets are located. For example, if the profile DD statement in the TCP/IP PROC is TCPMVS2.TCPIP1.PROFILE>TCPIP, then the HLQ is TCPMVS2.TCPIP1 and the TCP parameter card would be as follows:

TCP 6106 6107 TCPMVS2.TCPIP1

PPI Subtask with NetView

The most common cause for failure of the PPI subtask is that the NetView subsystem interface is not active, which will cause the display of an NSP091 message with an RC=24. The possible values for RC on the NSP091 message are listed in an appendix in the NetView Application Programming Guide.

Also, check the SNA View startup JCL to ensure that the STEPLIB includes the NetView loadlib that contains the CNMCNETV load module.

Additionally, check the SYSLOG during the time of NetView startup and look for messages indicating a failure of the NSPLU62 optional task that must be running in the NetView address space.

PPI Task Failure under NetView

The NSPLU62 optional task under NetView should start automatically while NetView is initializing. A successful initialization of the NSPLU62 task will generate both an NSP302 and an NSP311 message. If the NSPLU62 task fails to initialize, additional NSPxxx messages will be displayed during NetView initialization. Check the list of SNA View messages in this chapter to determine why the NSPLU62 task failed to initialize.

If the NetView subsystem interface is not active when NetView starts, the NSPLU62 task will not load and the following message will be issued from NSPLU62 before it terminates:


NSP313  NSPLU62  : NETVIEW INTERFACE FAILURE, RC=0018

To avoid this message when NetView starts (and thus to avoid having to restart the NSPLU62 task manually), start the subsystem interface address space before starting the NetView address space.

If the system has not previously had the subsystem interface running, review the NetView Installation Guide for instructions on subsystem interface setup, paying special attention to the following:

The subsystem interface address space must start with the same four characters as the NetView address space. For example, if the NetView address space is named "NETVIEW," then the first four characters of the subsystem interface address space must be "NETV."
The four-character subsystem name must also be listed in the SYS1.PARMLIB(IEFSSNxx) member. Any change to this member will require an IPL.
The CNMCSSIR and CNMCALRT tasks must be defined in NetView's DSIDMN member. CNMCSSIR should be defined with INIT=N.

After the problem is corrected, the NSPLU62 task can be restarted from the NetView operator session using the command START TASK=NSPLU62.

Mainframe Messages

This section explains the messages generated by the SNA View mainframe application.

Error Message NSP002 type subtask initialized

Explanation The SNA View subtask has initialized successfully. If the subtask has an associated ACB, the ACB information is given. Task-specific information is also given. Processing continues.

Recommended Action No user action is required.

Error Message NSP008 Invalid input parameter card on line number

number is the line number of SYSIN.

Explanation SNA View read a line from SYSIN that it did not understand. The invalid card is skipped. Processing continues with the next SYSIN card.

Recommended Action Correct the input card on the given line number of SYSIN. The "Updating the Mainframe Application Software" chapter provides valid values for task registration cards. Make sure that all other lines must begin with an asterisk (*) to denote that they are comment lines.

Error Message NSP009 Duplicate subtask card on line number ignored

subtask is the type of subtask.

number is the line number of SYSIN.

Explanation SNA View read a definition card from SYSIN for a subtask name that has already been defined. The invalid card is skipped. Processing continues with the next SYSIN card.

Recommended Action Correct or remove the input card on the given line number of SYSIN. See the "Updating the Mainframe Application Software" chapter for names of input parameter cards that may be defined multiple times.

Error Message NSP010 Maximum number of subtask cards reached; ignoring line number

subtask is the type of subtask.

number is the line number of SYSIN.

Explanation SNA View has reached the maximum number of subtasks of the type named. The definition card on the named line will not be processed. If subtask=subtask, SNA View has reached the maximum number of total subtasks that can be defined, and all SYSIN parameter cards from that line number forward will be ignored. The parameter card(s) are skipped and processing continues.

Recommended Action Decrease the number of SYSIN parameter cards of the type named.

Error Message NSPV010E NO DATA FOUND MATCHING KEY ENTERED

Explanation Issued in response to the SHOW DLC command. No data was recorded for the requested PU.

Recommended Action None.

Error Message NSPV011E Could not open VSAM file.

Explanation Issued in response to the SHOW DLC command, if the VSAM file used to store PU information for SNAView could not be opened.

Recommended Action None.

Error Message NSPV012I pu_name xid local_mac local_sap remote_mac remote_sap rif

Explanation Issued in response to the SHOW DLC command. The data recorded for the PU name during XID exchange is displayed.

Recommended Action None.

Error Message NSP018 VTAM ACB generation for subtask acb failed, RC = rcnumber

subtask is the type of subtask.

acb is the name of the failing ACB.

rcnumber is the return code from the Get VTAM ACB routine.

Explanation An attempt by an initializing subtask to get a VTAM ACB failed. The SNA View subtask terminates.

Recommended Action Verify that the acb is active. Use the INIT command to reinitialize the subtask.

Error Message NSP019 VTAM subtask open for acb failed, RC = rcnumber, error = enumber

subtask is the type of the subtask.

acb is the name of the failing ACB.

rcnumber is the return code from the Open VTAM ACB routine.

enumber is the error code within the ACB.

Explanation An attempt by an initializing subtask to open a VTAM ACB failed. The SNA View subtask terminates with a condition code 8.

Recommended Action Verify that the ACB is correctly defined and not already in use. See VTAM Programming manual for descriptions of the return code and error code.

Error Message NSP020subtask is currently in use

subtask is the type of the subtask.

Explanation This message follows immediately after the NSP019 message if an exclusive subtask ACB is already in use by another program. The SNA View subtask terminates.

Recommended Action Verify that the ACB is not being taken by another program on the host, such as NetView or SOLVE: Netmaster.

Error Message NSP021 Unsolicited msgtype data is unavailable

msgtype is the type of message.

Explanation This message follows the NSP019 message to alert the user that SNA View will not be able to receive unsolicited data because it was unable to access an ACB. The SNA View subtask terminates.

Recommended Action No user action is required.

Error Message NSP026 Unexpected subtask return code, RC = rcnumber

subtask is the type of subtask.

rcnumber is the return code from the Receive routine.

Explanation The subtask Receive routine received an unexpected return code while attempting to receive messages. The SNA View subtask terminates.

Recommended Action Use the INIT command to reinitialize the subtask.

Error Message NSP033 SNA View COMMAND = commandtext

Explanation The command text issued via SNA View has been logged to SYSLOG. Processing continues.

Recommended Action No user action is required.

Error Message NSP034 Initialization of SPO name failed in reqtype processing, RC1 = addr RC2 = size

name is the name of the SPO subtask.

reqtype is the type of the request being processed.

addr is the returned address from the Get RPL routine.

size is the returned size from the Get RPL routine.

Explanation The SPO subtask failed while calling the VTAM RPL routine. The SNA View SPO subtask terminates.

Recommended Action Use the INIT command to reinitialize the subtask.

Error Message NSP035 SPO Warning: Failure retrieving command responses, max retries reached

Explanation SNA View's SPO interface subtask encountered a failure while attempting to retrieve the command responses from an issued VTAM command. All responses were not retrieved. Processing continues.

Recommended Action Reissue the VTAM command. If the proper responses are still not returned, contact your technical support representative.

Error Message NSP038 VTAM command support unavailable

Explanation SNA View could not process the VTAM command because there are no active SPO subtasks. The command is discarded.

Recommended Action Restart SNA View with an SPO card in the SYSIN deck that identifies a valid VTAM APPL resource to be used as an SPO. Verify that the named VTAM resource is active.

Error Message NSP091 PPI initialization failed, step = stepnum RC = rcnumber

stepnum is the step of initialization that failed:

: 1 indicates that a subsystem interface is not up.
: 2 indicates that an attempt to get ASCB value failed.
: 3 indicates that an attempt to register as a receiver failed.

rcnumber is the return code from call to CNMNETV.

Explanation An attempt by the PPI subtask to access the CNMNETV module failed. The SNA View PPI subtask terminates.

Recommended Action If stepnum = 1, check the status of the subsystem interface. If stepnum = 3, verify that no other application is attached to the NetView or Netmaster PPI.

Error Message NSP095 SNA View PPI buffer size error, RC = rcnumber

rcnumber is the return code from the PPI call.

Explanation A Receive request for the PPI failed due to the length of the buffer size. The SNA View PPI subtask terminates.

Recommended Action Use the INIT command to reinitialize the subtask.

Error Message NSP096 SNA View PPI interface failed, ID = requestid, RC = rcnumber

requestid is the ID of the task request.

rcnumber is the return code from the PPI call.

Explanation A Receive request for the PPI failed. The SNA View PPI subtask terminates.

Recommended Action Consult the NetView Application Programming Guide to determine the meaning of the given return code.

Error Message NSP111 subtask CNOS mode failed, RC = rcnum RCPRI = primaryrc RCSEC = secondaryrc

subtask is the name of the subtask.

mode is the mode name.

rcnum is the return code from the CNOS call.

primaryrc is the primary return code from the CNOS request.

secondaryrc is the secondary return code from the CNOS request.

Explanation The LU 6.2 CNOS command for mode mode failed during the initialization of subtask subtask. The SNA View subtask terminates.

Recommended Action Consult VTAM Programming for LU 6.2 for a translation of the RCPRI and RCSEC return codes.

Note The RCPRI and RCSEC codes are valid only if rcnum = B0000. Depending on the codes, you may need to make a correction to a workstation profile or the mainframe VTAM definitions. A dump of the VTAM request parameter list (RPL) control block will follow this message. Recycle SNA View to recover the subtask.

Error Message NSP112 subtask CNOS for mode status (RCPRI=primaryrc RCSEC=secondaryrc)

subtask is the name of the subtask.

mode is the mode name.

status is the status of the task; it is either "succeeded" or "failed."

primaryrc is the primary return code from the CNOS request.

secondaryrc is the secondary return code from the CNOS request.

Explanation The LU 6.2 CNOS command for mode mode completed for subtask subtask. Processing continues.

Recommended Action If status is "failed," stop SNA View and check the output job log for more information. Consult VTAM Programming for LU 6.2 for a translation of the RCPRI and RCSEC return codes.

Error Message NSP113 Unable to establish msgtype LU 6.2 communication with the workstation wsagent agent, RC = rcnumber

msgtype is the type of LU 6.2 message:

: outbound = Allocation from the mainframe to the workstation
: inbound = Allocation from the workstation to the mainframe
: Send = Message transmission from the mainframe to the workstation
: Receive = Message transmission from the workstation to the mainframe
: wsagent is the workstation agent:
: command = Workstation command agent
: message = Workstation message agent

rcnumber is the return code from the LU 6.2 call.

Explanation Establishment of LU 6.2 session(s) between the mainframe and the workstation failed. The SNA View SERVER subtask terminates.

Recommended Action Verify that the parameters of the SERVER SYSIN card match the VTAM resource names defined for SNA View and also match the resource names entered in the workstation communications setup.

Error Message NSP114 Error in LU 6.2 direction workstation wsserver server, RC = rcnumber

direction is the direction of the message:

: "Send to" = From the mainframe to the workstation
: "Receive from" = From the workstation to the mainframe

wsserver is the workstation server:

: command = Command server
: HCI = host command interface server

rcnumber is the return code from LU 6.2 call.

Explanation An error occurred in the sending or receiving of an LU 6.2 message between the mainframe and the workstation. The SNA View SERVER subtask terminates.

Recommended Action Verify the status of the LU 6.2 session(s) between the mainframe and the workstation.

Error Message NSP115 Dumping subtask direction action ctrlblk

subtask is the subtask name.

direction is the direction of message:

: outbound = From the mainframe to the workstation
: inbound = From the workstation to the mainframe

action is the attempted action:

: allocate = Allocation of an LU 6.2 conversation
: receive = Sending a message over an established conversation

ctrlblk is the control block being dumped:

: RPL = Request parameter list
: RPL6X = Request parameter list extension

Explanation SNA View subtask encountered an error in LU 6.2 communications to the workstation. Following this message, a dump of the control block ctrlblk will be given to aid in problem determination. The SNA View SERVER subtask terminates.

Recommended Action Consult the VTAM Programming manual for a mapping of the control block. Correct the error and use the INIT command to reinitialize the subtask.

Error Message NSP119 num messages queued on subtask. Command rejected: command

num is the number of messages.

subtask is the subtask name.

command is the command entered.

Explanation Subtask subtask will not process the command issued from the workstation because there is a backlog of num messages that are waiting to be sent to the workstation. The command command is discarded. Processing continues on the remaining messages in the subtask's queue.

Recommended Action Wait until the existing backlog of messages has been processed and then reissue the command. Use the SHOW TASK command to view the number of messages in the output queue of the subtask.

Error Message NSP121 MVS console name could not obtain a migration ID

name is the name of the console to be defined.

Explanation The MVS console being defined requested a one-byte migration ID, but the console initialization routine was unable to provide one. Initialization of the console continues.

Recommended Action No user action is required.

Error Message NSP122 MVS console name initialization failed, RC = rcnumber

name is the name of the console to be defined.

rcnumber is the return code from the initialization routine.

Explanation The initialization of the MVS console failed. The SNA View MVS subtask terminates.

Recommended Action Record the return code and report it to your support representative.

Error Message NSP150 TCP/IP communications: function for workstation component agent failed with errno value

function is the failing communication function.

component is the workstation component that detected the failure.

value is the integer error value.

Explanation A TCP/IP communication error has occurred. The error could have taken place during TCP/IP communication establishment or during a send or receive between the mainframe and the agent specified. The SNA View TCP subtask terminates.

Recommended Action Verify the availability of TCP/IP communication between the workstation and the mainframe. Use the INIT command to reinitialize the subtask.

Error Message NSP151 SNA View failure in communication to TCP/IP

Explanation SNA View received an error while attempting to receive data from a TCP/IP socket or ECB. The TCP/IP subtask terminates.

Recommended Action Use the INIT command to reinitialize the subtask.

Error Message NSP160 Console command return code = rcnumber

rcnumber is the return code from command send subroutine.

Explanation An MVS command request completed with a non-zero return code. Processing continues.

Recommended Action If an expected command response is not received, record the return code and contact your support representative.

Error Message NSP205 MVS console name reached memory limit. Data lost

Explanation The extended console defined for SNA View has filled all of the available cells in the data space. The incoming message is not queued. Processing continues.

Recommended Action Check the status of the extended console with a DISPLAY CONSOLES, CN=name. If messages do not resume queuing to the extended console, recycle SNA View, making sure that the console comes down cleanly. A new console may need to be defined with a larger message data space.

Error Message NSP206 MVS console name reached queue limit. Data lost

name is the console name.

Explanation The extended console defined for SNA View has reached its maximum queue depth. The incoming message will not be queued. Processing continues.

Recommended Action Check the status of the extended console with a DISPLAY CONSOLES, CN=name. If messages do not resume queuing to the extended console, recycle SNA View, making sure that the console comes down cleanly.

Error Message NSP207 MVS console name stopped by internal error

name is the name of the console.

Explanation The extended console defined for SNA View received an error during the processing of its message queues. SNA View deactivates the MVS console.

Recommended Action Check the status of the extended console with a DISPLAY CONSOLES, CN=name. Recycle SNA View.

Error Message NSP208 MVS console name reached alert percentage

name is the console name.

Explanation The number of messages queued to the extended console for SNA View has reached a certain percentage of the maximum queue depth. Processing continues.

Recommended Action Verify that messages are being displayed on the MVS messages client on the workstation. Check the status of the extended console with the command DISPLAY CONSOLES, CN=name. If the queue shortage is not relieved shortly, recycle SNA View, ensuring that the console comes down cleanly.

Error Message NSP209 MVS console name suspended by request

name is the console name.

Explanation A condition has developed in the extended console defined for SNA View such that MVS has requested the deactivation of the console. SNA View deactivates the console.

Recommended Action Check the condition of the console with the command DISPLAY CONSOLES, CN=name. Recycle SNA View.

Error Message NSP210 MVS console name alert ECB posted for unknown reason

name is the console name.

Explanation The extended console defined for SNA View was posted with an alert indicating a problem, but no error flags were set in the console's status area. Processing continues.

Recommended Action Check the condition of the console with the command DISPLAY CONSOLES, CN=name.

Error Message NSP302 name: SNA View PPI TASK INITIALIZED