cc/td/doc/product/rtrmgmt/snaview/snav11
hometocprevnextglossaryfeedbacksearchhelp
PDF

Table of Contents

Using the Mainframe Application

Using the Mainframe Application

This chapter contains three major sections:


Note Do not start the SNA View mainframe application until the workstation installation is complete and ready to connect to the mainframe.

Starting the NetView Interface

The SNA View mainframe task, NSPLU62, starts automatically whenever NetView is started. If it becomes necessary to recycle NSPLU62, you can stop the task by issuing this command from a NetView command prompt:

STOP TASK=NSPLU62

You can restart the task by issuing this command from a NetView command prompt:

START TASK=NSPLU62

Starting the Netmaster Interface

The NSPPI and NSPCMD PROCs are the primary PPI PROCs that either send CNM and PPO data through the PPI or await commands coming from SNA View through the PPI. As such, they must be active at all times and must run in a background environment within Netmaster. To accomplish this, add the following statements to your NMINIT or NMREADY initialization PROCs:

Sub BSYS NSPPI Sub BSYS NSPCMD

You can also issue these commands from an OCS console.

Starting and Stopping SNA View

The mainframe application program can be started as a started task or as a batch job; the started task method is recommended.

Starting SNA View as a Started Task

To start SNA View as a started task, copy the prefix.NSPS110I.NSPSSAMP(NSPOPEN) procedure into the started tasks library, modifying the data set names according to the instructions at the top of the job. Start the NSPOPEN procedure from an MVS console with the following command:

S NSPOPEN

Stopping SNA View as a Started Task

To stop the SNA View task, enter the following command from an MVS console:

P NSPOPEN

You can also stop the SNA View mainframe application from the workstation by entering the endhost command from the SNA View command client.

Starting SNA View as a Batch Job

To start SNA View as a batch job, modify and submit the JCL in prefix.NSPS110I.NSPSSAMP(NSPJCL).

Stopping SNA View

To stop the SNA View batch job, issue the following command from the operator console:

P NSPOPEN

You can also stop the SNA View mainframe application by issuing the following modify command from an MVS console:

MODIFY NSPOPEN, TERM

SNA View Commands

SHOW FILTER Command

The SHOW FILTER command is used to manage a message filtering table. Filters can be listed in the SYSIN cards during initialization or can be added dynamically with the FILTER ADD command. If no filters are defined, all messages that are captured by the PPI or PPO subtask will be passed to the workstation subtasks. If any filters are defined, then only those incoming messages with IDs that match an entry in the filter table will be sent to the workstations. In the example, after the two filters are defined, only IST093I and IST104I messages will be forwarded to the workstations.

F NSPOPEN,SHOW FILTER

FILTER ADD Command

The FILTER ADD command adds filters dynamically to the message filtering table. The following will cause message IST093I to no longer be forwarded to workstations.

F NSPOPEN,FILTER ADD IST093I

SHOW TASK Command

The SHOW TASK command displays all of the defined subtasks. The data in the SPECIFIC field column differs for each subtask. For SPO subtasks, the VTAM SPO ACB that the subtask is connected to is listed. For TCP subtasks, the TCP sockets that are opened for TCP/IP connections are listed. For MVS and CMD subtasks, the name and ID of the extended console are listed.

F NSPOPEN,SHOW TASK

SHOW FLOW Command

The SHOW FLOW command shows the number of messages in the input and output queues for each subtask, the total number of messages that have flowed in and out of each subtask, and the number of memory allocations currently outstanding.

F NSPOPEN,SHOW FLOW

SHOW ADDR Command

The SHOW ADDR command displays the memory addresses of the subtasks' internal header control block, subtask control block, and MVS Task Control Block. This command can be used for problem diagnosis.

F NSPOPEN,SHOW ADDR

SHOW VERSION Command

The SHOW VERSION command displays the version of SNA View that is running and the date that the load module for each of the tasks was compiled. This information can be used to verify the level of code that a system is running.

F NSPOPEN,SHOW VERSION

SHOW DLC Command

The SHOW DLC command displays the MAC/SAP and RIF data for a PU name.

F NSPOPENSHOW DLC pu_name

SHOW FREEQ Command

The SHOW FREEQ command displays the number of buffers used and available on the FREE queue for each subtask.

F NSPOPENSHOW FREEQ

SHOW CONNECTIONS Command

The SHOW CONN command displays the TCP/IP address (or host name) of the client workstations connected via TCP/IP.

F NSPOPENSHOW CONN

KILL Command

The KILL command is used to bring down a subtask. When using the KILL command, SNA View displays a message to remind you that the automatic restarted has been disabled for the subtask that you are killing. The status of the subtask is changed to DOWN. The INPUTQ and OUTPUTQ values are invalid when a subtask is in the DOWN state and should be ignored. The subtask is restarted with the INIT command. Automatic restarts are also reenabled when you initialize the subtask again.

F NSPOPEN,KILL subtask

HELP Command

The HELP command displays the list of SNA View mainframe commands.

F NSPOPEN,HELP

STOP Command

The STOP command ends SNA View.

F NSPOPEN,END

INIT Command

The INIT command will start a defined subtask.

F NSPOPEN,INIT taskname

hometocprevnextglossaryfeedbacksearchhelp
Copyright 1989-1997 © Cisco Systems Inc.