          APPENDIX A  Installing NetView Code Points for NetWare


The code points allow NetView to display additional information
about alerts that are received from NMA for NetView. This appendix
describes

o  How to determine whether you need to install NetView code points

o  An overview of the installation procedure

o  How to install NetView code points on a Virtual Machine (VM)  
   system

o  How to install NetView code points on an Multiple Virtual
   Storage (MVS) system


DO YOU NEED TO INSTALL?

Beginning with NetView v2.1, all versions of NetView contain all
the code points required to display NetWare alerts. Contact a
NetView operator or your systems programmer and ask for the version
number of NetView. If the host is running NetView v2.1 or higher,
you do not need to install code points.

If the host is running an older version of NetView (before v2.1),
you might need to install additional code points as described later
in this appendix. You do not need to install the code points if the
code points for NMA for NetView v1.2 or NetWare for SAA v1.2 are
already installed on the NetView host. Once the code points are
installed for one NetWare for SAA v1.2-and-later server, the
installed code points support all NetWare for SAA v1.2-and-later
servers.


INSTALLATION OVERVIEW

This section provides a general overview of the installation
process. Detailed procedures for the VM and MVS host systems appear
later in this appendix.

The installation procedure in this chapter requires the following
hardware and software components:

o  NetView software installed at the NetView host.

o  NetWare for SAA or an equivalent product that enables
   communications and file transfers between a PC and the host
   computer installed at a NetWare server.

o  A 3270 terminal emulation product (such as the NetWare 3270 
   LAN Workstation product from Attachmate) installed at the 
   LAN workstation.


                                                              A-1
o  A cabling connection between NetWare for SAA and the NetView
   host.

o  A cabling connection between NetWare for SAA and the workstation 
   that is running 3270 emulation software.

To install the code point messages, you must perform the following
tasks:

o  Task 1. Prepare to transfer files to the host:

   o  Install NetWare for SAA (or a product with similar features)
      so that you can access the host from a workstation on the
      NetWare LAN.

   o  Using a 3270 emulation software package with file transfer 
      capabilities on a LAN workstation, establish a host session 
      and access the NetView RUN disk.

o  Task 2. Install the code point messages:

    o  Using a 3270 emulation software package, transfer the code
       point files from the NMA for NetView v1.3, Disk 2 to the
       NetView RUN disk.

    o  Using the 3270 emulation software, compile the code point files.

    o  Using a NetView console or NetView on the workstation running
       in 3270 emulation, edit the NetView startup command file.

    o  Using a NetView console or NetView on the workstation running
       in 3270 emulation, restart NetView and set the NetView recording
       and viewing filters.

Detailed instructions for these tasks appear in the following
sections.


PREPARING FOR FILE TRANSFER (VM AND MVS INSTALLATIONS)

To prepare for transferring code point files to the host, follow
these steps:

1.  Install NetWare for SAA (or a product with similar features)
    so that you can access the host from a workstation on the
    NetWare LAN.

2.  Locate the code point files on NMA for NetView v1.3, Disk 2.

    The files that you need are located in the CP directory on
    this diskette.  Instructions for creating this diskette appear
    under "Preparing the Installation Diskettes" in Chapter 2.


                                                              A-2
3.  On a LAN workstation, start up the 3270 emulation 
    software and the file transfer software.

4.  Establish a host session on the workstation.

    You must use a workstation with a 3.5-inch floppy diskette
    drive.  To establish the host session, you can use NetWare
    for SAA and a 3270 emulation software package with file 
    transfer capabilities.
    
    In some windows-based 3270 emulation programs, file transfer
    software is integrated into the main program.  In most DOS-based 
    3270 emulation packages, a SEND program is provided to transfer 
    files to the host.

    For additional information on using 3270 emulation software
    and on transferring files, please consult the publications for 
    the products you are using.


INSTALLING NETVIEW CODE POINTS IN VM SYSTEMS

Before starting the procedures in this section, complete the
procedures in the preceding section, "Preparing for File Transfer
(VM and MVS Installations)" earlier in this appendix.

IMPORTANT:  The following procedure is based on recommendations in
the NetView Customization Guide (IBM publication SC31-6016). Novell
recommends that you review the information on creating user-defined
generic code points before attempting to install the code points. 

To continue installing the NetView code points, complete the
following steps:

1.  Running a host session from the LAN workstation running 3270
    emulation, log on to MAINT.

    If you do not know how to log on to MAINT, contact your host
    systems programmer.

2.  Access the NetView RUN disk by entering the following command:
 
    ACCESS 334 A

3.  Using the file transfer software at the workstation under
    3270 emulation, transfer the code point files to the NetView 
    RUN disk.


                                                              A-3
    When transferring the files, use the ASCII, CRLF, and fixed
    record format options. If you are using a SEND program,
    for example, enter the following at the DOS prompt (>):

    >SEND BNJ81UTB.NCC BNJ81UTB NCCFLST A (ASCII CRLF RECFM F

    >SEND BNJ82UTB.NCC BNJ82UTB NCCFLST A (ASCII CRLF RECFM F 

    >SEND BNJ92UTB.NCC BNJ92UTB NCCFLST A (ASCII CRLF RECFM F

    >SEND BNJ93UTB.NCC BNJ93UTB NCCFLST A (ASCII CRLF RECFM F

    >SEND BNJ94UTB.NCC BNJ94UTB NCCFLST A (ASCII CRLF RECFM F

    >SEND BNJ95UTB.NCC BNJ95UTB NCCFLST A (ASCII CRLF RECFM F

    >SEND BNJ96UTB.NCC BNJ96UTB NCCFLST A (ASCII CRLF RECFM F

4.  Running a host session from a workstation under 3270 
    emulation, compile the transferred files on the host by 
    entering

    CNMSVM07 NUMBER=81 NETLNK=NOVELL

    CNMSVM07 NUMBER=82 NETLNK=NOVELL

    CNMSVM07 NUMBER=92 NETLNK=NOVELL

    CNMSVM07 NUMBER=93 NETLNK=NOVELL

    CNMSVM07 NUMBER=94 NETLNK=NOVELL

    CNMSVM07 NUMBER=95 NETLNK=NOVELL

    CNMSVM07 NUMBER=96 NETLNK=NOVELL

5.  Running a host session from the workstation under 3270 emulation,
    open the NetView startup command file for editing by entering
    the following command:

    XEDIT NETSTRT GCS 








                                                              A-4
6.  Within the NetView startup file, locate the GLOBAL command
    and insert the word NOVELL immediately after the word LOADLIB.

    This step includes the Novell library in the list of NetView
    libraries that are loaded at startup. The modified GLOBAL
    command will look like the following:

    `GLOBAL LOADLIB NOVELL PROPMX USER NCCF
      STATMON NLDM NPDA' 

7.  Log on to a NetView console and shut down NetView by entering
    the following NetView command:

    CLOSE IMMED

    WARNING:  This command brings down NetView.  To avoid
    untimely interruption of NetView services, consider
    performing this step during a scheduled maintenance period.

8.  When NetView has completed shutdown, log on to the NetView
    virtual machine.  Then start up NetView by entering the
    by entering the following VM command:

    CP IPL GCS

9.  While NetView is starting up, check the startup messages to
    make sure that they include

    BNJ090I NETVIEW USER CODE POINT TABLE BNJ92UTB IS AVAILABLE 

    BNJ090I NETVIEW USER CODE POINT TABLE BNJ93UTB IS AVAILABLE 

    BNJ090I NETVIEW USER CODE POINT TABLE BNJ94UTB IS AVAILABLE 

    BNJ090I NETVIEW USER CODE POINT TABLE BNJ95UTB IS AVAILABLE 

    BNJ090I NETVIEW USER CODE POINT TABLE BNJ96UTB IS AVAILABLE 

    BNJ090I NETVIEW USER CODE POINT TABLE BNJ81UTB IS AVAILABLE 

    BNJ090I NETVIEW USER CODE POINT TABLE BNJ82UTB IS AVAILABLE 

    The preceding messages indicate that the code point files for
    NetWare are available. If these messages are directed to
    another console, they will not appear.



                                                              A-5
10. Disconnect from the NetView virtual machine by entering the
    following command:

    #CP DISC 

11. Log on to NetView. When NetView main menu appears, select NPDA
    (Network Problem Determination Application) by entering

    NPDA

12. From the NetView NPDA prompt, set the NetView recording and
    viewing filters by entering the following NetView commands:

    srf arec pass e paff

    srf arec pass e temp

    srf arec pass e impd

    svf pass e paff

    svf pass e temp

    svf pass e impd

    NOTE:  To display NetWare messages, the recording and viewing
    filters must be set each time NetView is started. To simplify
    NetView startup, enter these commands in a CLIST file.


INSTALLING NETVIEW CODE POINTS IN MVS SYSTEMS

Before starting the procedures in this section, complete the
procedures in "Preparing for File Transfer (VM and MVS
Installations)" earlier in this appendix.

IMPORTANT:  The following procedure is based on recommendations in
the NetView Customization Guide (IBM publication SC31-6016). Novell
recommends that you review the information on creating user-defined
generic code points before attempting to install the code points. 

To continue installing the NetView code points, follow these steps:

1.  Running a host session from a workstation running a 3270 
    emulation software package, log on with a Time Sharing
    Option (TSO) user ID that has sufficient access rights to be
    able to create or update a system data set such as SYS1.xxxx.

2.  Using this host session and the Interactive System Productivity 
    Facility (ISPF), allocate a partitioned data set (PDS) to 
    contain the code point files.




                                                              A-6
    Give the data set a name like SYS2.NTVW.CODE.POINTS. Make sure
    to set the allocation parameters to the following values: 

    o  LRECL = 80 

    o  RECFM = FB 

    o  Directory blocks should be 5 

    o  Primary allocation should be at least one cylinder--or the
       equivalent in fixed-block architecture (FBA) blocks

    o  Secondary allocation should be at least one cylinder or the
       equivalent in FBA blocks

3.  Exit ISPF by entering

    =X 

4.  Using the file transfer software at the workstation under 3270
    emulation, transfer the INSTALL.JCL file and the code point
    files to the host.

    When transferring the files, use the ASCII and CRLF options.
    If you are using a SEND program, for example, enter

    >SEND BNJ92UTB.NCC 
      'SYS2.NTVW.CODE.POINTS(BNJ92UTB)'
       ASCII CRLF 

    >SEND BNJ93UTB.NCC 
      'SYS2.NTVW.CODE.POINTS(BNJ93UTB)'
       ASCII CRLF 

    >SEND BNJ94UTB.NCC 
      'SYS2.NTVW.CODE.POINTS(BNJ94UTB)'
       ASCII CRLF 

    >SEND BNJ95UTB.NCC 
      'SYS2.NTVW.CODE.POINTS(BNJ95UTB)'
       ASCII CRLF 

    >SEND BNJ96UTB.NCC 
      'SYS2.NTVW.CODE.POINTS(BNJ96UTB)'
       ASCII CRLF 

    >SEND BNJ81UTB.NCC 
      'SYS2.NTVW.CODE.POINTS(BNJ81UTB)'
       ASCII CRLF 






                                                              A-7
    >SEND BNJ82UTB.NCC 
      'SYS2.NTVW.CODE.POINTS(BNJ82UTB)'
       ASCII CRLF 

    >SEND INSTALL.JCL 
      'SYS2.NTVW.CODE.POINTS(INSTALL)'
       ASCII CRLF 

5.  From a host terminal or a LAN workstation running a host 
    and the ISPF editor under 3270 emulation, open the member

    'SYS2.NTVW.CODE.POINTS(INSTALL)'

6.  Follow the directions inside the job control language (JCL)
    listing. These instructions appear under the label

    TO EXECUTE THIS JCL:

    Refer to Figure A-1 at the end of this appendix for a sample
    JCL listing for a code point installation.

    For additional information on using listings similar to this
    sample, refer to the Network Program Products Samples book
    (SC30-3352) from IBM.

7.  Submit the job. 

    After successful completion of this job, the code points load
    library member should be installed correctly. 

8.  Log on to a NetView console and shut down NetView by entering
    the following NetView command:

    CLOSE IMMED 

    WARNING:  This command brings down NetView. To avoid untimely
    interruption of NetView services, consider performing this step
    during a scheduled system maintenance period.

9.  At the primary MVS operator console, start NetView by entering
    the following command:

    S CNMPROC

10. While NetView is starting up, check the startup messages to
    make sure that they include

    BNJ090I NETVIEW USER CODE POINT TABLE BNJ92UTB IS AVAILABLE 

    BNJ090I NETVIEW USER CODE POINT TABLE BNJ93UTB IS AVAILABLE 



                                                              A-8
    BNJ090I NETVIEW USER CODE POINT TABLE BNJ94UTB IS AVAILABLE 

    BNJ090I NETVIEW USER CODE POINT TABLE BNJ95UTB IS AVAILABLE 

    BNJ090I NETVIEW USER CODE POINT TABLE BNJ96UTB IS AVAILABLE 

    BNJ090I NETVIEW USER CODE POINT TABLE BNJ81UTB IS AVAILABLE 

    BNJ090I NETVIEW USER CODE POINT TABLE BNJ82UTB IS AVAILABLE 

    The preceding messages indicate that the code point files for
    NetWare are available. If these messages are directed to
    another console, they will not appear.

11. Log on to NetView. When the NetView main menu appears, select
    NPDA (Network  Problem Determination Application) by entering

    NPDA

12. From the NetView NPDA prompt, set the NetView recording and
    viewing filters by entering the following NetView commands:

    srf arec pass e paff

    srf arec pass e temp

    srf arec pass e impd

    svf pass e paff

    svf pass e temp

    svf pass e impd

    NOTE:  To display NetWare messages, the recording and viewing
    filters must be set each time NetView is started. To simplify
    NetView startup, enter these commands in a CLIST file.













                                                              A-9
Example A-1
Code Points Installation JCL
_________________________________________________________________
//        JOB
//
*****************************************************************
//*                                                             *
//*DESCRIPTION: PARSE, ASSEMBLE, AND LINKEDIT USER DEFINED CODE *
//*             POINT TABLES.                                   *
//*                                                             *
//*  NOTE ===>  THIS JCL ASSUMES:                               *
//*                                                             *
//*   1)  THE CODE POINT SOURCE IS CONTAINED IN A               *
//*       SINGLE LIBRARY                                        * 
//*   2)  THE MEMBER NAMES ARE FORMATED ASD AAABBCCC            *
//*       WHERE AAA = BNJ                                       *
//*                            BB  = CODE POINT TABLE NUMBER    *
//*                           CCC = UTB (MODIFIABLE BY SYMBOLIC *
//*                                 VARIABLE "NAME")            *
//*                                                             *
//*  TO EXECUTE THIS JCL:                                       *
//*   1.)  PUT YOUR OWN JOB CARD ON THE JOB                     *
//*   2.)  MODIFY SYMBOLIC VARIABLE "NETLNK" TO POINT TO THE    *
//*        NETVIEW LOAD LIBRARY YOU WANT THE CODE POINTS        *
//*        LINKED INTO                                          *
//*   3.)  MODIFY SYMBOLIC VARIABLE "USERLIB" TO POINT TO THE   *
//*        SOURCE LIBRARY NAME CONTAINING THE CODE POINTS.      *
//*                                                             *
//***************************************************************
//CNMUSER PROC    NUMBER=,
//        NAME=UTB,
//        NETLNK='CNM.USERLNK',    ** USER CODE POINT LIBRARY
//        REG=1,                   ** REGION SIZE IN MEG
//        SOUTA='*',               ** DEFAULT PRINTED OUTPUT CLASS
//        UNIT=SYSDA,              ** DEVICE TYPE FOR DASD
//        USERLIB='SYS2.NTVW.CODE.POINTS', ** CODE POINTS SOURCE
//        PS=3,                    ** PRIMARY CYLINDER ALLOCATION
//        SS=1                     ** SECONDARY CYLINDER ALLOCATION
//
*****************************************************************
//*  VERIFY USER TABLE INPUT
//
//***************************************************************
//PARSE    EXEC   PGM=BNJUSTBL,REGION=&REG.M,
//            PARM='&NUMBER'
//STEPLIB  DD DSN=SYS1.NPDALIB,DISP=SHR
//INTABLE  DD DSN=&USERLIB(BNJ&NUMBER&NAME),DISP=SHR
//OUTTABLE DD DSN=&&OUTDCB,DISP=(NEW,PASS),UNIT=&UNIT,
//            SPACE=(CYL,(&PS,&SS)),
//            DCB=(DSORG=PS,LRECL=80,BLKSIZE=3120,RECFM=FB)
//SYSPRINT DD SYSOUT=&SOUTA
//SYSUDUMP DD DUMMY
//SYSUT1   DD UNIT=&UNIT,SPACE=(CYL,(&PS,&SS))
*****************************************************************

                                                              A-10
Example A-1 (continued)
Code Points Installation JCL
_________________________________________________________________
//
//*  ASSEMBLE STEP
//
*****************************************************************
//ASM     EXEC PGM=IFOX00,PARM='LOAD,NODECK,OBJECT',
//             REGION=&REG.M,COND=(4,LT)
//SYSPRINT  DD SYSOUT=&SOUTA
//SYSLIB    DD DSNAME=SYS1.MACLIB,DISP=SHR
//SYSUT1    DD UNIT=&UNIT,SPACE=(CYL,(1,1))
//SYSUT2    DD UNIT=&UNIT,SPACE=(CYL,(1,1))
//SYSUT3    DD UNIT=&UNIT,SPACE=(CYL,(1,1))
//SYSGO     DD DSNAME=&&SYSGO,DISP=(NEW,PASS),UNIT=&UNIT,
//       SPACE=(CYL,(&PS,&SS)),
//       DCB=(DSORG=PS,LRECL=80,BLKSIZE=3120,RECFM=FB)
//SYSIN    DD DSN=*.PARSE.OUTTABLE,
//         DISP=(OLD,DELETE)
//
*****************************************************************
//*  LINKEDIT STEP
//
*****************************************************************
//LINK    EXEC PGM=IEWL,
//             PARM='XREF,LET,LIST,SIZE=(512K,128K),NCAL,REUS',
//             REGION=&REG.M,COND=(4,LT)
//SYSPRINT  DD SYSOUT=&SOUTA
//SYSUT1    DD SPACE=(CYL,(1,1)),DISP=(NEW,PASS),UNIT=&UNIT
//SYSLMOD  DD DSN=&NETLNK(BNJ&NUMBER&NAME),
//         DISP=SHR
//SYSLIN   DD DSNAME=&&SYSGO,DISP=(OLD,DELETE)
//         PEND
//STEP1    EXEC PROC=CNMUSER,NUMBER=92
//STEP2    EXEC PROC=CNMUSER,NUMBER=93
//STEP3    EXEC PROC=CNMUSER,NUMBER=94
//STEP4    EXEC PROC=CNMUSER,NUMBER=95
//STEP5    EXEC PROC=CNMUSER,NUMBER=96
//STEP6    EXEC PROC=CNMUSER,NUMBER=81
//STEP7    EXEC PROC=CNMUSER,NUMBER=82
_________________________________________________________________














                                                              A-11
