|
|
Updating the Mainframe Application Software
This chapter contains instructions for updating VTAM and MVS resources on the mainframe, as well as updating the SNA View input parameter cards to customize SNA View for your site's particular needs. You will refer to different sections of this chapter depending on whether your connection to the workstation is via LU6.2 or TCP/IP. The following topics are discussed in this chapter:
You must configure the mainframe to communicate with the CiscoWorks Blue Maps workstation by one of the following protocols:
This section describes modifications to the VTAM datasets of a mainframe that is connected to the SNA View workstation via LU6.2. If your workstation connection uses a TCP/IP connection, refer to "Configuring TCP/IP Connectivity."
To configure LU6.2 connectivity, you perform the following steps:
SNASVCMG MODEENT LOGMODE=SNASVCMG,FMPROF=X'13',TSPROF=X'07', X
PRIPROT=X'B0',SECPROT=X'B0',COMPROT=X'D0B1', X
RUSIZES=X'8585',PSERVIC=X'060200000000000000000300', X
ENCR=B'0000'
*
PARALLEL MODEENT LOGMODE=PARALLEL,FMPROF=X'13',TSPROF=X'07', X
PRIPROT=X'B0',SECPROT=X'B0',COMPROT=X'50B1',TYPE=X'00', X
RUSIZES=X'8787',PSERVIC=X'060200000000000000002F00'
*
DSIL6MOD MODEENT LOGMODE=DSIL6MOD,FMPROF=X'13',TSPROF=X'07', X
PRIPROT=X'B0',SECPROT=X'B0',COMPROT=X'50B1',TYPE=X'00', X
SSNDPAC=X'00',SRCVPAC=X'03',PSNDPAC=X'03', X
RUSIZES=X'8585',PSERVIC=X'060200000000000000002C00'
MODIFY NET,TABLE,NEWTAB=modetab,OPTION=LOAD
This section provides modifications to your mainframe TCP/IP installation required for SNA View. If your workstation connection is via LU6.2, go to "Performing MVS and VTAM Updates." TCP/IP connectivity can be one of the following types:
The following steps are for systems that use IBM TCP/IP for MVS.
6106 TCP NSPOPEN 6107 TCP NSPOPEN
//NSPOPEN EXEC PGM=NSPOPEN,PARM='=TCPIP_PREFIX=TCPIPX'
If your system uses Interlink SNS/TCP access, copy the LSCNCOM Load Module.
Interlink provides an LSCNCOM load module that must be used in place of the LSCNCOM that is provided in prefix.SNAVIEW.NSPLOAD. Either replace the module in prefix.NSPOPEN.NSPLOAD, or name the Interlink TCP/IP load library in the STEPLIB of the SNA View startup job ahead of prefix.SNAVIEW.NSPLOAD.
This section presents the modifications required in your system's MVS and VTAM datasets. These changes are necessary regardless of the method used to connect the workstation. Notify your system programmer of the changes to be made to the SYS1.PARMLIB members.
TRXNAME=NSPOPEN,PGN=8
SET ICS=xx
PPT PGMNAME(NSPOPEN) NOSWAP SYST
SET SCH=xx
MODIFY vtamproc,PPOLOG=YES
//ASMIST JOB (), 00010001
// CLASS=A, 00020001
// MSGCLASS=D, 00030001
// MSGLEVEL=(1,1), 00040001
// NOTIFY=&SYSUID, 00050001
// TIME=1440 00060001
//*
//* CHANGE NSP HIGH LEVEL PREFIX TO YOUR DSN NAMING CONVENTION
//*
//ASMIST PROC MBR=ISTEXCCS,DSNPRE=NSP
//ASM EXEC PGM=ASMA90,PARM='OBJECT,NODECK,TERM,XREF(SHORT)',
// REGION=4M
//SYSLIB DD DISP=SHR,DSN=SYS1.MACLIB,DCB=BLKSIZE=23440
// DD DISP=SHR,DSN=SYS1.MODGEN
// DD DISP=SHR,DSN=&DSNPRE.SNAVIEW.NSPSAMP
//SYSUT1 DD UNIT=SYSDA,SPACE=(TRK,(20,10))
//SYSUT2 DD UNIT=SYSDA,SPACE=(TRK,(20,10))
//SYSUT3 DD UNIT=SYSDA,SPACE=(TRK,(20,10))
//SYSPUNCH DD DUMMY
//SYSLIN DD DSN=&&OBJ,DISP=(MOD,PASS),UNIT=SYSDA,
// SPACE=(80,(200,50))
//SYSTERM DD SYSOUT=*
//SYSPRINT DD SYSOUT=*
//SYSIN DD DSN=&DSNPRE.SNAVIEW.NSPSAMP(&MBR),DISP=SHR
//LKED EXEC PGM=IEWL,REGION=4M,
// PARM='LIST,XREF,AMODE=24,RMODE=24'
//SYSPRINT DD SYSOUT=*
//SYSUT1 DD UNIT=SYSDA,SPACE=(TRK,(2,1))
//SYSLMOD DD DSN=&DSNPRE.SNAVIEW.NSPLOAD(&MBR),DISP=SHR
//SYSLIN DD DSNAME=&&OBJ,DISP=(OLD,DELETE)
// PEND
//S1 EXEC ASMIST,MBR=ISTEXCCS
//LKED.SYSLMOD DD DSN=SYS1.LOCAL.VTAMLIB(ISTEXCCS),DISP=SHR
//NSPVSAM JOB (),
// CLASS=A,
// MSGCLASS=D,
// MSGLEVEL=(1,1),
// NOTIFY=&SYSUID,
// TIME=1440
//*
//*----------------------------------------------------------------
//* THIS STEP BUILDS THE XID VSAM CLUSTERS
//*----------------------------------------------------------------
//* CHANGE MVSWK1 TO VALID VOLSER
//*----------------------------------------------------------------
//VSAM1 EXEC PGM=IDCAMS
//SYSPRINT DD SYSOUT=*
//SYSIN DD *
DEL NSP.XIDDATA1
DEF CLUSTER (NAME(NSP.XIDDATA1) -
INDEXED -
REUSE -
SHAREOPTIONS(3 3) -
VOL(MVSWK1) -
KEYS(24 0) -
RECSZ(230 230) -
FSPC(20 10) -
CISZ(4096) -
IMBED) -
DATA(NAME(NSP.XIDDATA1.DATA) -
CYLINDERS (2 0))-
INDEX(NAME(NSP.XIDDATA1.INDEX) -
TRACKS (2 0))
/*
//XIDPRM JOB (`PRIME VSAM DATA BASE'), MSGCLASS=0, CLASS=A //* //S1 EXEC PGM=NSPPRIME //STEPLIB DD DSN=NSP.SNAVIEW.NSPLOAD, DISP=SHR //VSAMDB DD DSN=NSP.SNAVIEW.XIDDATA, DISP=SHR
//XIDDATA DD DSN=AAA.BBB, DISP=SHR
This section lists and describes the initialization parameter cards that you must customize to match the mainframe resources with the workstation configuration. The cards listed in Table 2-1 are located in prefix.SNAVIEW.NSPSAMP(NSPPARM).
Table 2-1 SNA View Parameter Cards
| ParameterCard | Valid Values | Description Summary |
|---|---|---|
| PPO | VTAM APPL Definition | PPO APPL defined to allow SNA View to act as VTAM PPO. |
| CNM | VTAM APPL Definition | CNM APPL defined to allow SNA View to act as alert receiver. |
| PPI | none | Request setup of the PPI to NetView or Netmaster. |
| SPO | VTAM APPL Definition | SPO APPL to allow SNA View to send commands to VTAM. |
| SEC | Load module | Load module to be called for security calls. |
| SERVER | APPL, LU, Mode, Message Server, Command Server | Identify VTAM resources for LU6.2 workstation connection. |
| TCP | HCI port, CMD port | Identify port numbers for TCP/IP workstation connection. |
| MVS | Console Name | Provides SNA View with MVS console support. |
| CMD | Console Name | Provides SNA View with the ability to issue MVS commands. |
Valid Values: VTAM APPL Definition
Sample Syntax: PPO NSPPO1
Description: The ID of the APPL definition coded with AUTH=PPO. This identifies the Primary Program Operator application which will receive unsolicited VTAM messages.
Valid Values: VTAM APPL Definition
Sample Syntax: CNM DSICRTR
Description: The ID of the APPL definition coded with AUTH=CNM. This identifies the application program which receives unsolicited network services requests (alerts) that require further processing. The default alerts application name used by VTAM is DSICRTR (defined in the CNM routing table ISTMGC01).
Valid Values: none
Sample Syntax: PPI
Description: Add this card to connect SNA View to the NetView or Netmaster PPI for the receipt of VTAM messages and alerts. The program-to-program interface must be active in accordance with the NetView or Netmaster documentation.
Valid Values: VTAM APPL Definition
Sample Syntax: SPO NSPSPO1
Description: The ID of an APPL definition card coded with AUTH=SPO. This identifies a Secondary Program Operator application which will receive solicited messages generated by commands issued from the workstation. Multiple SPO cards are allowed.
Valid Values: Load module
Sample Syntax: SEC NSPRACF
Description: This card identifies the load module in prefix.SNAVIEW.NSPLOAD called to process calls to the mainframe security software.
Valid Values: plu slu logmode TPM TPC
Sample Syntax: SERVER NSPAPL1 NSPLU01 PARALLEL NSPENMS NSPPENCS
Description: This card identifies the necessary values needed to establish a parallel LU6.2 connection to the workstation. Multiple SERVER cards are allowed. The positional parameters are as follows:
Valid Values: hciport cmdport
Sample Syntax: TCP 6106 6107
Description: This card identifies the TCP/IP ports that are used on the SNA View workstation for the HCI Server and the Command Server. Multiple TCP cards are allowed. The positional parameters are as follows:
Valid Values: Console Name
Sample Syntax: MVS NSPCONS1
Description: The MVS parameter card specifies the name of the extended MCS console to be defined for receipt of MVS messages. If this name is defined in RACF, the OPERPARM values for this name will be used for the console definition. Otherwise, a console will be defined with default parameters AUTH=INFO and ROUTCDE=ALL.
Valid Values: Console Name
Sample Syntax: CMD NSPCONS2
Description: The CMD parameter card specifies the name of the extended MCS console to be defined for issuing MVS commands from SNA View. If this name is defined in RACF, the OPERPARM values for this name will be used for the console definition; otherwise, a console will be defined with default parameters AUTH=ALL and ROUTCDE=NONE.
This section explains the updates necessary for SNA View to work in conjunction with NetView. The following topics are described in this section:
Verify that the NetView subsystem address space is active, as defined in the NetView Installation and Administration Guide. The NetView subsystem interface is necessary for cross-memory communications between NetView and SNA View. The subsystem application should be initiated before NetView is engaged.
Follow the procedure in this section to change the NetView dataset for SNA View collection.
TASK MOD=NSPLU62,TSKID=NSPLU62,PRI=8,INIT=Y
DSTINIT XITCI=NSPITCI
NSPMQS CMDMDL MOD=NSPMQS,RES=N
NSPAUTO1 OPERATOR PASSWORD=PASSWORD
PROFILEN NSPPROF
NSPPROF PROFILE
AUTH MSGRECVR=NO,CTL=GLOBAL
END
AUTOTASK OPID=NSPAUTO1
Follow this procedure to copy members to NetView libraries.
SNA View requires three exits, a DST, and a command processor to run in NetView's address space. The load modules for these processes are provided in prefix.SNAVIEW.NSPLOAD for NetView Version 2.2.
If your system is running NetView 2.2, copy the following load modules from prefix.SNAVIEW.NSPLOAD into a NetView STEPLIB dataset:
If you are using a version of NetView other than Version 2.2, modify and submit the JCL in prefix.SNAVIEW.NSPSAMP(ASMJCL) according to the instructions in that member to create the five load modules.
Routing Information Data is retrieved from the VSAM database by NetView Command Processors invoked by SNA View over the program-to-program interface provided by NetView.
Follow this procedure to install the NetView Command Processor.
***************************************************************** * ADD THE FOLLOWING TASK STATEMENTS * NOTE: THE FOLLOWING TASK STATEMENTS ARE NECESSARY * TO SUPPORT SNAVIEW AND RELATED APPLICATIONS ***************************************************************** Sample Member (NSPDBDMN) TASK MOD=DSIZDST, TSKID=NSPDBX, MEM=NSPXIDA, PRI=6, INIT=N
*----------------------------------------------------------------* * THE FOLLOWING COMMANDS ARE USED TO RETRIEVE RIF INFO * * FROM THE VSAM DATABASE. * *----------------------------------------------------------------* Sample Member (NSPDBCMD) NSPDB CMDMDL MOD=NSPDB, TYPE=R, RES=N NSPLIST CMDMDL MOD=NSPLIST, TYPE=D, PARSE=N, RES=N NSPREDK CMDMDL MOD=NSPREDK, TYPE=D, PARSE=N, RES=N NSPDEL CMDMDL MOD=NSPDEL, TYPE=D, PARSE=N, RES=N NSPUPD CMDMDL MOD=NSPUPD, TYPE=D, PARSE=N, RES=N NSPKEYD CMDMDL MOD=NSPKEYD, TYPE=D, PARSE=N, RES=N
Sample Member (NSPXIDA): DSTINIT PDDNM=XIDDATA DSTINIT DSRBO=5 DSTINIT XITVN=NSPXITVN DSTINIT FUNCT=VSAM
//XIDDATA DD DSN=AAA.BBB, DISP=SHR
Restart NetView to activate the changes to NetView.
This section describes how to allow CiscoWorks Blue SNA View to interact with Netmaster. The dataset members listed in Table 2-2 are located in prefix.SNAVIEW.NSPCLIST and are used to facilitate the following changes:
You do not have to restart Netmaster for the changes to take effect.
| PROC | Description |
|---|---|
| NSPDOC | Documentation of procs, how to implement SNA View |
| NSPCNM | Documentation on changes to CNMPROC for SNA View |
| NSPPPO | Documentation on changes to PPOPROC for SNA View |
| NSPPPI | PROC---CNM & PPO message PPI sender. |
| NSPCMD | PROC---Command PPI receiver (NSPNETV) |
| NSPCM1 | PROC ---Command issuer and sender |
Sub BSYS NSPKPPI Sub BSYS NSPKCMD
SH PPIUSERS
|
|
Copyright 1988-1996 © Cisco Systems Inc.