|
|
This chapter describes how to start, stop, and use the SNA View mainframe application. It contains these major sections:
You can start SNA View automatically when NetView or SOLVE:Netmaster start, or you can start SNA View separately. When the SNA View mainframe application is running on the mainframe, you operate CiscoWorks Blue SNA View from your workstation.
To start SNA View as a started task (an MVS task that is started with a START (S) command), copy the prefix.NSPS120I.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
To start SNA View as a batch job, modify and submit the JCL in prefix.NSPS120I.NSPSSAMP(NSPJCL).
To stop SNA View, issue the following STOP (P) command from the operator console:
P NSPOPEN
You can also stop the SNA View mainframe application by issuing the following MODIFY (F) command from an MVS console:
F NSPOPEN,STOP
To stop the SNA View mainframe application from the SNA View workstation, activate the Mainframe Commands client and enter the following command from the Mainframe Commands window at the SNA View workstation:
F NSPOPEN,STOP
When the SNA View mainframe program starts, it also starts a number of subtasks, depending on how you have configured the SNA View mainframe application. Table 5-1 lists the subtasks that can be started.
| Subtask ID | Purpose | Maximum Occurrences |
|---|---|---|
| CMD | Lets the SNA View Task Manager issue MVS commands | 1 (0 means that no SNA View workstations can enter MVS commands) |
| DISCOVER | Discovers the PUs and LUs in the network | 1 |
| MVS | Sends MVS messages to the SNA View workstations | 1 |
| PPI | Supports the NetView or SOLVE:Netmaster program-to-program interface; lets the SNA View workstations receive solicited and unsolicited VTAM messages | 1 |
| PPO | Lets the SNA View workstations receive unsolicited VTAM messages | 1 |
| SERVER | Provides LU 6.2 connection to SNA View workstations; one occurrence for each SNA View workstation connected by LU 6.2 | 0-10 |
| SPO | Supports secondary program operators | 0-15 (0 means that no SNA View workstations can enter MVS commands) |
| STATUS | Reports changes in the status of PUs and LUs to the SNA View workstations | 1 |
| TCP | TCP/IP connection to SNA View workstation; one occurrence for each SNA View workstation connected by TCP/IP | 0-20 |
You can enter the SNA View mainframe commands shown in Table 5-2 from any defined MVS console or extended MVS console, including NetView and SOLVE:Netmaster, and from the SNA View workstation's mainframe command window.
| Command | Description |
|---|---|
| FILTER ADD Command | Adds a filter statement to the SNA View message filter |
| FILTER DEL Command | Deletes a filter statement from the SNA View message filter |
| ../../../../../../../lib/help.htm | Displays SNA View command help information |
| INIT Command | Starts a defined SNA View subtask |
| KILL Command | Stops a defined SNA View subtask |
| MESSAGES Command | Controls which mainframe messages are sent to the SNA View workstation |
| SHOW ADDR Command | Displays all SNA View subtasks memory addresses |
| SHOW CONN Command | Displays the TCP/IP address of each SNA View Workstation client connected by TCP/IP |
| SHOW DLC Command | Displays the Media Access Control (MAC), service access point (SAP), and Routing Information Field (RIF) data for a PU name |
| SHOW FILTER Command | Displays the configured SNA View filter statements |
| SHOW FLOW Command | Displays the number of messages in the input and output queues for each SNA View subtask |
| SHOW FREEQ Command | Displays the number of used and available buffers on the FREE queue for each SNA View subtask |
| SHOW MESSAGES Command | Displays the settings of the MESSAGES command and the MESSAGES parameter card |
| SHOW TASK Command | Displays the name and status of each SNA View subtask |
| SHOW TRACE Command | Displays the current settings for the TRACE command |
| SHOW VERSION Command | Displays the current SNA View version information |
| STOP Command | Stops the SNA View mainframe task and its subtasks |
| TRACE Command | Starts and stops tracing in the SNA View mainframe subtasks |
The FILTER ADD command adds mainframe message IDs to the message-filtering table. (You can also use the FILTER parameter card, as described in section "Updating the SNA View Configuration File (NSPPARM)" in the chapter "Updating the Mainframe Application Software."
If no mainframe message IDs are in the filter table, and the value set by the MESSAGES command or parameter card is not OFF, all messages that are captured by the MVS, PPI, and PPO subtasks are passed to the SNA View workstations. If any mainframe message IDs are in the filter table, then only those messages with IDs that match an entry in the filter table are sent to the SNA View workstations.
| Command Syntax: | F NSPOPEN,FILTER ADD message_ID |
| Syntax Description:
message_ID |
The message ID of a VTAM or MVS message to be added to the filter table. |
Example: To add message IST555I to the filter table, which causes occurrences of message IST555I to be forwarded to workstations, enter this command:
F NSPOPEN,FILTER ADD IST555I
Sample Output:
NSP595 Command entered: FILTER ADD IST555I
NSP610 Message filter IST555I added
The FILTER DEL command deletes a filter statement from the message-filtering table.
| Command Syntax: | F NSPOPEN,FILTER DEL message_ID |
| Syntax Description:
message_ID |
The message ID of a VTAM or MVS message to be deleted from the filter table. |
Example: To delete message IST555E from the filter table, which prevents message IST555E from being forwarded to workstations, enter this command:
F NSPOPEN,FILTER DEL IST555E
Sample Output:
NSP595 Command entered: FILTER DEL IST555E
NSP610 Message filter IST555E deleted
The HELP command displays the list of SNA View mainframe commands.
| Command Syntax: | F NSPOPEN,HELP |
Example: To display the SNA View mainframe commands, enter this command:
F NSPOPEN,HELP
Sample Output:
NSP595 Command Entered: HELP
FILTER ADD msgid - Adds a message filter
FILTER DEL msgid - Deletes a message filter
HELP - Display this list
INIT - Activate a defined subtask
KILL - Terminate a defined subtask
MESSAGES - Control mainframe messages
SHOW ADDR - Display the important memory addresses
of each subtask
SHOW CONN - Display the client information for the
TCP subtasks
SHOW DLC puname - Display the mac, sap, and rif
information for a pu
SHOW FILTER - Display all defined message filters
SHOW FLOW - Display task message flow
information
SHOW FREEQ - Display task free queue
SHOW MESSAGES - Display the MESSAGES value
SHOW TASK - Display all subtasks and their status
SHOW TRACE - Display all subtasks and their traces
SHOW VERSION - Display the compiled date and time
of each subtask, and product version
STOP - Shutdown SnaView
NSP695 SnaView HELP command processed
The INIT command starts an SNA View subtask that is already defined in the NSPPARM configuration file. When you start a subtask, automatic restarts are enabled for that subtask.
| Command Syntax: | F NSPOPEN,INIT subtask_name |
| Syntax Description:
subtask_name |
The name of the SNA View subtask that you want to start. Use the F NSPOPEN,SHOW TASK command to display a list of SNA View subtasks by name. |
Example: To start subtask TCP-0, enter this command:
F NSPOPEN,INIT TCP-0
Sample Output:
NSP595 Command entered: INIT TCP-0
The KILL command stops an SNA View subtask. SNA View then displays a message to remind you that the automatic restart 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. You can restart the subtask with the INIT command.
| Command Syntax: | F NSPOPEN,KILL subtask_name |
| Syntax Description:
subtask_name |
The name of the subtask to be killed. Use the F NSPOPEN,SHOW TASK command to display a list of subtasks by name. |
Example: To kill subtask TCP-0, enter this command:
F NSPOPEN,KILL TCP-0
Use the MESSAGES command to specify whether VTAM and MVS messages are sent to the SNA workstation. If you use the OFF option, neither VTAM nor MVS messages are sent to the SNA View workstation.
The user at the SNA View workstation can start MVS and VTAM message clients to display VTAM and MVS messages. However, if you use the MESSAGES command with the OFF option, there will be no MVS or VTAM messages to display.
| Command Syntax: | F NSPOPEN,MESSAGES option |
| Syntax Description:
option |
Specifies whether VTAM and MVS messages are sent to the SNA View workstation for viewing. ON--Both VTAM and MVS messages are sent to the SNA View workstation where the user can choose to view them. OFF--Neither VTAM nor MVS messages are sent to the SNA View workstation. The workstation user cannot view them. VTAM--Only VTAM messages are sent to the SNA View workstation where the user can choose to view them. MVS messages are not sent. MVS--Only MVS messages are sent to the SNA View workstation where the user can choose to view them. VTAM messages are not sent. |
Example: To have all VTAM messages forwarded to the SNA View workstation, enter this command:
F NSPOPEN,MESSAGES VTAM
The SHOW ADDR command displays the memory addresses of the internal header control block, subtask control block, and MVS task control block for each SNA View subtask. This command is for problem diagnosis only.
| Command Syntax: | F NSPOPEN,SHOW ADDR |
Example: To display the SNA View subtask memory addresses, enter this command:
F NSPOPEN,SHOW ADDR
Sample Output:
NSP595 Command entered: SHOW ADDR
NSP603 TNUM TASKNAME ADDRESS HEADER TCB
NSP603 0 MAINTASK 00000000 09259E88 00000000
NSP603 1 DISCOVER-0 0922F318 09253E88 008DD6D0
NSP603 2 MVS 0922F338 092685C8 008DD388
NSP603 3 PPI 0922F358 0926ADC8 008D6A88
NSP603 4 STATUS-0 0922F378 0928AE88 008D6858
NSP603 5 SERVER-0 0922F398 092B6608 00000000
NSP603 6 SERVER-1 0922F3B8 092D5608 00000000
NSP603 7 TCP-0 0922F3D8 09346608 008BEE88
NSP603 8 TCP-1 0922F3F8 0934A608 008D5E88
NSP603 9 CMD-0 0922F418 0934D5C8 008C0A88
NSP603 10 SPO-0 0922F438 0944AE88 008C0858
NSP695 SnaView SHOW command processed
Table 5-3 describes the fields in the SHOW ADDR command output.
| Field | Meaning |
|---|---|
| TNUM | Subtask number |
| TASKNAME | Subtask name |
| ADDRESS | Address of subtask control block for this subtask |
| HEADER | Address of subtask header |
| TCB | Task control block address |
The SHOW CONN command displays the TCP/IP addresses (or host names) of the client SNA View workstations that are connected via TCP/IP.
| Command Syntax: | F NSPOPEN,SHOW CONN |
Example: To display the TCP/IP connections, enter this command:
F NSPOPEN,SHOW CONN
Sample Output:
NSP595 Command entered: SHOW CONN
NSP706 TNUM TASKNAME SPECIFIC CLIENT
NSP706 7 TCP-0 6506,6507 NO CONNECTION
NSP706 8 TCP-1 6516,6517 171.69.163.115
NSP695 SnaView SHOW command processed
Table 5-4 describes the fields in the SHOW CONN command output.
| Field | Meaning |
|---|---|
| TNUM | Subtask number |
| TASKNAME | Subtask name |
| SPECIFIC | TCP/IP port numbers |
| CLIENT | IP address of connected SNA View workstation
NO CONNECTION = no SNA View workstation connected |
The SHOW DLC command displays the MAC, SAP, and RIF data for any switched PU name.
| Command Syntax: | F NSPOPEN,SHOW DLC PU_name |
| Syntax Description:
PU_name |
The name of any switched PU. |
Example: To display the MAC, SAP, and RIF data for PU IBUPC1, enter this command:
F NSPOPEN,SHOW DLC IBUPC1
Sample Output:
NSP595 Command entered: SHOW DLC IBUPC1
NSP708 IBUPC1 05DAA011 400137451088 04 0000F6419B36 04 0A30A0441F42055
NSP695 SnaView SHOW command processed
Table 5-5 describes the fields in the SHOW DLC command output.
| Field | Meaning |
|---|---|
| IBUPC1 | PU name |
| 05DAA011 | XID |
| 400137451088 | Local MAC |
| 04 | Local SAP |
| 0000F64190B36 | Remote MAC |
| 04 | Remote SAP |
| 0A30A0441F42055 | RIF data |
The SHOW FILTER command displays the filter statements from the message-filtering table.
| Command Syntax: | F NSPOPEN,SHOW FILTER |
Example: To display SNA View message filter statements, enter this command:
F NSPOPEN,SHOW FILTER
Sample Output:
NSP595 Command entered: SHOW FILTER
NSP609 IST005I IST006I IST777I IST888I IST999E
NSP609 IST555I
NSP695 SnaView SHOW command processed
The output shows all message IDs that have been entered into the filter table and that will be forwarded to SNA View workstations.
The SHOW FLOW command displays information about the messages for each subtask. The output produced by the SHOW FLOW command is for diagnostic use by the Cisco TAC.
| Command Syntax: | F NSPOPEN,SHOW FLOW |
Example: To display the messages in the input and output queues, enter this command:
F NSPOPEN,SHOW FLOW
Sample Output:
NSP595 Command entered: SHOW FLOW
NSP605 TNUM TASKNAME INPUTQ OUTPUTQ INFLOW OUTFLOW MC
NSP605 1 DISCOVER-0 0 0 0 0 0
NSP605 2 MVS 0 0 2340 2340 3
NSP605 3 PPI 0 0 0 0 0
NSP605 4 STATUS-0 0 0 26 26 0
NSP605 5 SERVER-0 0 0 0 0 0
NSP605 6 SERVER-1 0 0 0 0 0
NSP605 7 TCP-0 0 0 0 0 0
NSP605 8 TCP-1 0 0 22 122 2
NSP605 9 CMD-0 0 0 94 19 0
NSP605 10 SPO-0 0 0 3 3 0
NSP695 SnaView SHOW command processed
Table 5-6 describes the fields in the SHOW FLOW command output.
The SHOW FREEQ command displays the number of buffers used and available on the queue for each subtask.
| Command Syntax: | F NSPOPEN,SHOW FREEQ |
Example: To display the buffer usage, enter this command:
F NSPOPEN,SHOW FREEQ
Sample Output:
NSP595 Command entered: SHOW FREEQ
NSP705 TNUM TASKNAME FREE USED
NSP705 0 MAINTASK 4000 0
NSP705 1 DISCOVER-0 4000 0
NSP705 2 MVS 1200 0
NSP705 3 PPI 2000 0
NSP705 4 STATUS-0 4000 0
NSP705 5 SERVER-0 2500 0
NSP705 6 SERVER-1 2500 0
NSP705 7 TCP-0 2500 0
NSP705 8 TCP-1 2500 0
NSP705 9 CMD-0 1500 0
NSP705 10 SPO-0 4000 0
NSP695 SnaView SHOW command processed
Table 5-7 describes the fields in the SHOW FREEQ command output.
| Field | Meaning |
|---|---|
| TNUM | Subtask number |
| TASKNAME | Subtask name |
| FREE | Number of unused elements in the queue for this subtask |
| USED | Number of used elements in the queue for this subtask |
The SHOW MESSAGES command displays the settings of the MESSAGES command and the MESSAGES parameter card.
| Command Syntax: | F NSPOPEN,SHOW MESSAGES |
Example: To display the MESSAGES setting, enter this command:
F NSPOPEN,SHOW MESSAGES
Sample Output:
This sample output occurs when VTAM messages are enabled.
NSP595 Command entered: SHOW MESSAGES
NSP709 MESSAGES VTAM
The SHOW TASK command displays information about all the defined SNA View mainframe subtasks. As shown in Table 5-8, the data in the SPECIFIC column differs for each type of subtask.
| Command Syntax: | F NSPOPEN,SHOW TASK |
Example: To display the SNA View subtasks, enter this command:
F NSPOPEN,SHOW TASK
Sample Output
NSP595 Command entered: SHOW TASK
NSP600 TNUM TASKNAME STATUS RESTARTS/LIMIT SPECIFIC
NSP600 1 DISCOVER-0 READY 0 10 NSPDSC1
NSP600 2 MVS UP 0 10 NSPCONS2,03000002
NSP600 3 PPI UP 0 10
NSP600 4 STATUS-0 UP 0 10 NSPSTA1
NSP600 5 SERVER-0 DOWN 0 10 NSPLU01
NSP600 6 SERVER-1 DOWN 0 10 NSPLU02
NSP600 7 TCP-0 READY 0 10 6106,6107
NSP600 8 TCP-1 CONNECTED 0 10 6126,6127
NSP600 9 CMD-0 UP 0 10 NSPCONS1,02000002
NSP600 10 SPO-0 UP 0 10 NSPSPO1
NSP695 SnaView SHOW command processed
Table 5-8 describes the fields in the SHOW TASK command output.
| Field | Meaning |
|---|---|
| TNUM | Subtask number |
| TASKNAME | Subtask name |
| STATUS | Status of subtask:
|
|
RESTARTS | Number of current automatic restarts for this subtask |
| LIMIT | Maximum number of times subtask can be DOWNR before being DOWN |
| SPECIFIC | Information specific to subtask type:
|
The SHOW TRACE command displays the current settings used for the TRACE command, which is described in the section "TRACE Command."
| Command Syntax: | F NSPOPEN,SHOW TRACE |
Example: To display the settings for current TRACE commands, enter this command:
F NSPOPEN,SHOW TRACE
Sample Output:
NSP595 Command entered: SHOW TRACE
NSP707 TNUM TASKNAME NORMAL DETAIL
NSP707 0 MAINTASK ON OFF
NSP707 1 DISCOVER-0 OFF OFF
NSP707 2 MVS OFF OFF
NSP707 3 PPI ON OFF
NSP707 4 SEC OFF OFF
NSP707 5 STATUS-0 OFF OFF
NSP707 6 TCP-0 ON OFF
NSP707 7 CMD-0 OFF OFF
NSP707 8 SPO-0 OFF OFF
NSP695 SnaView SHOW command processed
Table 5-9 describes the fields in the SHOW TRACE command output.
The SHOW VERSION command displays the version of SNA View that is running and the date and time that each SNA View subtask was compiled. You can use this information to verify the level of code running on your system.
| Command Syntax: | F NSPOPEN,SHOW VERSION |
Example: To display the SNA View version, enter this command:
F NSPOPEN,SHOW VERSION
Sample Output:
NSP595 Command entered: SHOW VERSION
NSP607 CiscoWorks Blue SNA View 1.2 Copyright 1996, 1997 Cisco Systems
NSP608 TASKNAME DATE TIME
NSP600 DISCOVER-0 Oct 15 1997 14:47:04
NSP600 MVS Oct 15 1997 14:47:04
NSP600 PPI Oct 15 1997 14:47:04
NSP600 STATUS-0 Oct 15 1997 14:47:04
NSP600 SERVER-0 Oct 15 1997 14:47:04
NSP600 SERVER-1 Oct 15 1997 14:47:04
NSP600 TCP-0 Oct 15 1997 14:47:04
NSP600 TCP-1 Oct 15 1997 14:47:04
NSP600 CMD-0 Oct 15 1997 14:47:04
NSP600 SPO-0 Oct 15 1997 14:47:04
NSP695 SnaView SHOW command processed
Table 5-10 describes the fields in the SHOW VERSION command output.
| Field | Meaning |
|---|---|
| TASKNAME | Subtask name |
| DATE | Date that the load module for this task was compiled |
| TIME | Time that the load module for this task was compiled |
The STOP command stops the SNA View mainframe program and its subtasks.
| Command Syntax: | F NSPOPEN,STOP |
Example: To stop the SNA View mainframe program, enter this command:
F NSPOPEN,STOP
The TRACE starts and stops tracing for the SNA View mainframe main task and its subtasks. When you use the TRACE command to start tracing, the SNA View mainframe trace function records internal tracing events.
Example: To start detail tracing of the TCP-1 subtask and all SERVER subtasks, enter these commands:
F NSPOPEN,TRACE PATH TCP-1 DETAIL
F NSPOPEN,TRACE PATH SERVER DETAIL
|
|