cc/td/doc/product/rtrmgmt/bluelist/cwblue21
hometocprevnextglossaryfeedbacksearchhelp
PDF

Table of Contents

Using the Mainframe Application

Using the Mainframe Application

This chapter describes how to start, stop, and use the mainframe application. It contains these major sections:

Starting and Stopping the Mainframe Application

You can start the mainframe application as a batch job or as a started task.

Starting and Stopping the Application as an MVS Started Task

To start the mainframe application as a started task (an MVS task that is started with a START (S) command), copy the prefix.NSPS210I.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 S NSPOPEN command.

Starting the Application as an MVS Batch Job

To start the mainframe application as a batch job, modify and submit the JCL in prefix.NSPS210I.NSPSSAMP(NSPJCL).

Stopping the Application

To stop the mainframe application, enter the following command from the operator console:

F NSPOPEN,STOP

If the application does not stop, enter the command again.

Mainframe Subtasks

When the mainframe program starts, it also starts a number of subtasks, depending on how you have configured the mainframe application. Table 5-1 lists the subtasks that can be started.


Table 5-1:
Mainframe Subtasks
Subtask ID Purpose Occurrences

DISCOVER

Discovers the PUs and LUs in the network.

1

MVS

Retrieves MVS messages.

1

PPI

Supports the NetView or SOLVE:Netmaster program-to-program interface; lets the workstations receive solicited and unsolicited VTAM messages.

1

PPO

Lets the workstations receive unsolicited VTAM messages.

1

SERVER

Provides LU 6.2 connection to workstations; one occurrence for each workstation connected by LU 6.2.

0-10

SPO

Supports secondary program operators.

0-15 (0 means that no workstations can enter VTAM commands)

STATUS

Reports changes in the status of PUs and LUs to the workstations

1

TCP

TCP/IP connection to a workstation; one occurrence for each workstation connected by TCP/IP

0-20

Issuing Mainframe Commands

You can enter the mainframe commands shown in Table 5-2 from any defined MVS console or extended MVS console, including NetView and SOLVE:Netmaster.


Table 5-2:
Mainframe Commands
Command Description

../../../../../../../lib/help.htm

Displays command help information.

INIT

Starts a defined subtask.

KILL

Stops a defined subtask.

SHOW ADDR

Displays all subtasks memory addresses.

SHOW CONN

Displays the TCP/IP address of each Workstation client connected by TCP/IP.

SHOW DLC

Displays the Media Access Control (MAC), service access point (SAP), and Routing Information Field (RIF) data for a PU name.

SHOW FLOW

Displays the number of messages in the input and output queues for each subtask.

SHOW FREEQ

Displays the number of used and available buffers on the FREE queue for each subtask.

SHOW TASK

Displays the name and status of each subtask.

SHOW TRACE

Displays the current settings for the TRACE command.

SHOW VERSION

Displays the current version information.

STOP

Stops the mainframe task and its subtasks.

TRACE

Starts and stops tracing in the mainframe subtasks

HELP

The HELP command displays the list of mainframe commands.

Command Syntax

F NSPOPEN,HELP

Example

To display the list of mainframe commands, enter the following 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 Sna Host NSP695SNA Host HELP command processed

INIT

The INIT command starts a mainframe 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

Where:

subtask_name is the name of the mainframe subtask that you want to start. Use the F NSPOPEN,SHOW TASK command to display a list of subtasks by name.

Example

To start subtask TCP-0, enter the following command:

F NSPOPEN,INIT TCP-0

Sample Output

NSP595 Command entered: INIT TCP-0

KILL

The KILL command stops a mainframe subtask. The mainframe application 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

Where:

subtask_name is 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 the following command:

F NSPOPEN,KILL TCP-0

SHOW ADDR

The SHOW ADDR command displays the memory addresses of the internal header control block, subtask control block, and MVS task control block for each mainframe subtask. This command is for problem diagnosis only.

Command Syntax

F NSPOPEN,SHOW ADDR

Example

To display the mainframe subtask memory addresses, enter the following 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 MVS0922F338 092685C8 008DD388 NSP603 3 PPI 0922F358 0926ADC8 008D6A88 NSP603 4 STATUS-0 0922F378 0928AE88 008D6858 NSP603 5 SERVER-0 0922F398 092B6608 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 SNA Host SHOW command processed

Table 5-3 describes the fields in the SHOW ADDR command output.


Table 5-3:
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.

SHOW ADDR Fields

SHOW CONN

The SHOW CONN command displays the TCP/IP addresses (or host names) of the client workstations that are connected via TCP/IP.

Command Syntax

F NSPOPEN,SHOW CONN

Example

To display the TCP/IP connections, enter the following 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 SNA Host SHOW command processed

Table 5-4 describes the fields in the SHOW CONN command output.


Table 5-4:
Field Meaning

TNUM

Subtask number.

TASKNAME

Subtask name.

SPECIFIC

TCP/IP port numbers.

CLIENT

IP address of connected workstation.

NO CONNECTION = no workstation connected.

SHOW CONN Fields

SHOW DLC

The SHOW DLC command displays the MAC, SAP, and RIF data for any switched PU name.

Command Syntax

F NSPOPEN,SHOW DLC PU_name

Where:

PU_name is the name of any switched PU.

Example

To display the MAC, SAP, and RIF data for PU IBUPC1, enter the following command:

F NSPOPEN,SHOW DLC IBUPC1

Sample Output

NSP595 Command entered: SHOW DLC IBUPC1 NSP708 IBUPC1 05DAA011 400137451088 04 0000F6419B36 04 NSP710 0A30A0441F42055 NSP695 SNA Host SHOW command processed

Table 5-5 describes the fields in the SHOW DLC command output.


Table 5-5:
Field Meaning

IBUPC1

PU name.

05DAA011

XID.

400137451088

Local MAC.

04

Local SAP.

0000F64190B36

Remote MAC.

04

Remote SAP.

0A30A0441F42055

RIF data.

SHOW DLC Fields

SHOW FLOW

The SHOW FLOW command displays information about the messages for each subtask. The output from the SHOW FLOW command is for use by the Cisco TAC.

Command Syntax

F NSPOPEN,SHOW FLOW

Example

To display the messages in the input and output queues, enter the following command:

F NSPOPEN,SHOW FLOW

Sample Output

NSP595 Command entered: SHOW FLOW NSP605 TNUM TASKNAME INPUTQ OUTPUTQ INFLOWOUTFLOWMC NSP605 1 DISCOVER-0 0 0 00 0 NSP605 2 MVS 0 0 23402340 3 NSP605 3 PPI 0 0 00 0 NSP605 4 STATUS-0 0 0 26 26 0 NSP605 5 SERVER-0 0 0 0 0 0 NSP605 7 TCP-0 0 0 0 0 0 NSP605 9 CMD-0 0 0 9419 0 NSP605 10 SPO-0 0 0 33 0 NSP695 SNA Host SHOW command processed

Table 5-6 describes the fields in the SHOW FLOW command output.


Table 5-6: SHOW FLOW Fields
Field Meaning

TNUM

Subtask number.

TASKNAME

Subtask name.

INPUTQ

Number of message buffers queued to the main task by this subtask.

OUTPUTQ

Number of message buffers queued to this subtask for processing.

INFLOW

Number of message buffers processed by this subtask.

OUTFLOW

Number of message buffers sent out by this subtask.

MC

Number of message buffers allocated to this subtask.

SHOW FREEQ

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 the following command:

F NSPOPEN,SHOW FREEQ

Sample Output

NSP595 Command entered: SHOW FREEQ NSP705 TNUM TASKNAME FREE USED NSP705 0 MAINTASK 40000 NSP705 1 DISCOVER-0 40000 NSP705 2 MVS 12000 NSP705 3 PPI 20000 NSP705 4 STATUS-0 40000 NSP705 5 SERVER-0 25000 NSP705 6 SERVER-1 25000 NSP705 7 TCP-0 25000 NSP705 8 TCP-1 25000 NSP705 9 CMD-0 15000 NSP705 10 SPO-0 40000 NSP695 SNA Host SHOW command processed

Table 5-7 describes the fields in the SHOW FREEQ command output.


Table 5-7:
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.

SHOW FREEQ Fields

SHOW TASK

The SHOW TASK command displays information about all the defined 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 mainframe subtasks, enter the following 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 10NSPDSC1 NSP600 2 MVS UP 0 10NSPCONS2,03000002 NSP600 3 PPI UP 0 10 NSP600 4 STATUS-0 UP 0 10NSPSTA1 NSP600 5 SERVER-0 DOWN 0 10NSPLU01 NSP600 6 SERVER-1 DOWN 0 10NSPLU02 NSP600 7 TCP-0 READY 0 106106,6107 NSP600 8 TCP-1 CONNECTED 0 106126,6127 NSP600 9 CMD-0 UP 0 10NSPCONS1,02000002 NSP600 10 SPO-0 UP 0 10NSPSPO1 NSP695 SNA Host SHOW command processed

Table 5-8 describes the fields in the SHOW TASK command output.


Table 5-8:
SHOW TASK Fields
Field Meaning

TNUM

Subtask number.

TASKNAME

Subtask name.

STATUS

Status of subtask:

  • INIT---Initialized.

  • UP---Up and running.

  • CONNECTED---Client workstation is connected.

  • RUN---Discover subtask is running.

  • READY--- Discover subtask is ready to run, or TCP is ready for connection.

  • DOWN---Subtask was taken down by the KILL command or has exceeded the maximum allowable automatic restarts.

  • DOWNR---Subtask ended and is automatically restarting.

  • QUIESCE---Subtask is ending but is waiting to free memory.

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:

  • CMD---Name and ID of the extended console.

  • DISCOVER---VTAM secondary program operator access method control block (ACB) to which the discover subtask is connected.

  • MVS---Name and ID of the extended console.

  • PPI---No specific data.

  • SERVER---LU name.

  • SPO---VTAM secondary program operator ACB to which the SPO subtask is connected.

  • STATUS---VTAM secondary program operator ACB to which the status subtask is connected.

  • TCP---TCP/IP port number opened for each TCP/IP connection to a workstation.

SHOW TRACE

The SHOW TRACE command displays the current settings used for the TRACE command, which is described in the "TRACE" section.

Command Syntax

F NSPOPEN,SHOW TRACE

Example

To display the settings for current TRACE commands, enter the following 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 SNA Host command processed

Table 5-9 describes the fields in the SHOW TRACE command output.


Table 5-9:
SHOW TRACE Fields
Field Meaning

TNUM

Subtask number.

TASKNAME

Subtask name.

NORMAL

Status of the TRACE command without the DETAIL option:

  • ON---Normal tracing on.

  • OFF---Normal tracing off.

DETAIL

Status of the TRACE command with the DETAIL option:

  • ON---Detail tracing on.

  • OFF---Detail tracing off.

SHOW VERSION

The SHOW VERSION command displays the version of the CiscoWorks Blue Maps and SNA View Mainframe program that is running and the date and time that each mainframe subtask was compiled. Use this information to verify the level of code running on your system.

Command Syntax

F NSPOPEN,SHOW VERSION

Example

To display the application version, enter this command:

F NSPOPEN,SHOW VERSION

Sample Output

NSP595 Command entered: SHOW VERSION NSP607 CiscoWorks Blue Maps and SNA View 2.0 Copyright 1996, 1997, 1998 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 SNA Host SHOW command processed

Table 5-10 describes the fields in the SHOW VERSION command output.


Table 5-10:
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.

SHOW VERSION Fields

STOP

The STOP command stops the mainframe application and its subtasks.

Command Syntax

F NSPOPEN,STOP

Example

To stop the mainframe application, enter the following command:

F NSPOPEN,STOP

TRACE

The TRACE starts and stops tracing for the mainframe main task and its subtasks. When you use the TRACE command to start tracing, the mainframe trace function records internal tracing events.

Command Syntax

[F NSPOPEN,]TRACE {OFF | PATH | INT} {subtask_name | MAIN} [DETAIL]

Syntax Description

F NSPOPEN is used when you issue the command from the command line. Omit this if you use the TRACE command from within the NSPPARM member.

OFF stops the specified mainframe tracing.

PATH starts path tracing. Path tracing records each entry to and exit from mainframe routines.

INT starts internal tracing. Internal tracing records each entry to and exit from mainframe routines, and records additional debugging information.

subtask_name specifies the mainframe subtask to trace. You can specify the name of a specific subtask (such as TCP-2) or you can specify just the root portion of a subtask name when several instances of that subtask type exist. For example, you could use the root name TCP to start tracing on all tasks with the same root TCP in their subtask name, or you could use the specific TCP-2 name. The valid subtask names are as follows:

DETAIL includes traces of internal service routines. If you omit this operand, service routines are not traced.

Notes

You can use the TRACE command inside the NSPPARM member, as described below:

Examples

    1. To use the TRACE command interactively to start detail tracing of the TCP-1 subtask and all SERVER subtasks, enter the following commands:

F NSPOPEN,TRACE PATH TCP-1 DETAIL F NSPOPEN,TRACE PATH SERVER DETAIL

    2. To use the TRACE command from within the NSPPARM member to start tracing of the DISCOVER subtask, put the following in NSPPARM:

DISCOVER NSPDSC1 TRACE INT DISCOVER

    3. To use the TRACE command from within the NSPPARM member to start internal detail tracing of the TCP subtask, put the following in NSPPARM:

TCP 6104 6104 TRACE INT TCP DETAIL


hometocprevnextglossaryfeedbacksearchhelp
Posted: Thu Sep 9 08:39:41 PDT 1999
Copyright 1989-1999©Cisco Systems Inc.