PMDF_SNMP040.AȽPMDF_SNMP040.ABACK *.*;/EXCL=*.DIR DISK$MANUFACTURE:[CONTRIBUTED-SOFTWARE.APPLICATIONS.PMDF_SNMP]PMDF_SNMP040.A/SAVE/BLOCK=2048/INTER/NOCRC/GROUP=0 MADISON  @/錚E7.1 _HQ:: _$1$DKF400: V6.2 *[MADISON.MADMAN]ASYNC.H;1+,54 . / @ 47 U-50123KPWO5 6> DY7>8j49>"ꊚG @HJextern void async_compat_test(OIDC_T last_match, int compc, OIDC_T *compl, SNMP_PKT_T *pktp, VB_T *vbp); extern void async_compat_get(OIDC_T last_match, int compc, OIDC_T *compl, SNMP_PKT_T *pktp, VB_T *vbp); extern void async_compat_next(OIDC_T last_match, int compc, OIDC_T *compl, SNMP_PKT_T *pktp, VB_T *vbp); extern void async_compat_set(OIDC_T last_match, int compc, OIDC_T *compl, SNMP_PKT_T *pktp, VB_T *vbp); PMDF_SNMP040.A5[MADISON.MADMAN]DESCRIP.MMS;36j *[MADISON.MADMAN]DESCRIP.MMS;36+,. / @ 4j J-50123KPWO56)|7~F<|89G @HJ!J! DESCRIP.MMS file for building the PMDF SNMP subagent, for use with MMK!>! COPYRIGHT 1995, TGV SOFTWARE, INC. ALL RIGHTS RESERVED.!! AUTHOR: M. Madison!! CREATION DATE: 23-OCT-1995!! MODIFICATION HISTORY:!/! 23-OCT-1995 V1.0 Madison Initial coding.IFDEF __AXP__ ARCH = AXPCFLAGS = $(CFLAGS)ASNMPLIBS = MULTINET_SNMPDEV_LIBRARY:SNMP.OLB/LIB,SNMPAUXI.OLB/LIB.ELSE ARCH = VAX.IFDEF USE_DECC CC = CC/DECCCFLAGS = $(CFLAGS)ASNMPLIBS = MULTINET_SNMPDEV_LIBRARY:SNMP.OLB/LIB,SNMPAUXI.OLB/LIBCRTL =.ELSE CC = CC/VAXCKSNMPLIBS = MULTINET_SNMPDEV_LIBRARY:SNMP_VAXC.OLB/LIB,SNMPAUXI_VAXC.OLB/LIB"CRTL = ,SYS$DISK:[]VAXCRTL.OPT/OPT.ENDIF.ENDIF.FIRST @ @MAKE$:SETUP SUBPROCESS0 @ DEFINE/NOLOG BIN$ SYS$DISK:[.BIN-$(ARCH)]j @ IF F$SEARCH("''make_version'_SYSEXE:LINK.CLD") .NES. "" THEN SET COMMAND 'make_version'_SYSEXE:LINK.CLD\ @ IF F$SEARCH("''make_version'_SYSEXE:LINK.CLD") .NES. "" THEN LINK = "''make_version'LINK"3 @ @DISKPMDF_SNMP040.A5[MADISON.MADMAN]DESCRIP.MMS;36j ~?$SYSTEM:[SYSTEM_ROOTS.VAX.DECC040]SETUP.IFDEF __AXP__3 @ @DISK$SYSTEM:[SYSTEM_ROOTS.AXP.DECC041]SETUP @ @MAKE$:GCC DEASSIGN# @ DEASSIGN DECC$SYSTEM_INCLUDE$ @ DEASSIGN DECC$LIBRARY_INCLUDE.ENDIFFLINKFLAGS = $(LINKFLAGS)/TRACE/MAP=BIN$:$(MMS$TARGET_FNAME)/CROSS/FULL .IFDEF DEBUGCFLAGS = $(CFLAGS)/DEBUG/NOOPTLINKFLAGS = $(LINKFLAGS)/DEBUG.ENDIF .IFDEF LISTACFLAGS = $(CFLAGS)/LIST=BIN$:$(MMS$TARGET_FNAME)/SHOW=ALL/MACHINE.ENDIF6CFLAGS = $(CFLAGS)/INCLUDE=(MULTINET_SNMPDEV_INCLUDE:)'ALL : BIN$:PMDF_SNMP_SA.EXE @ !/BIN$:PMDF_SNMP_SA.EXE : BIN$:PMDF_SNMP_SA.OBJ,-& BIN$:PMDF_SNMP_SUBS.OBJ8 $(LINK)$(LINKFLAGS) $(MMS$SOURCE_LIST),$(SNMPLIBS),-8 SYS$DISK:[]SOCKET_LIBRARY.OPT/OPT $(CRTL)?BIN$:PMDF_SNMP_SA.OBJ : PMDF_SNMP_SA.C, PMDF_SNMP_SA.H, ASYNC.H/PMDF_SNMP_SA.H : RFC1565.MIB, RFC1566.MIB2 @ MIBCOMP := $MULTINET_SNMPDEV_LIBRARY:MIBCOMP= MIBCOMP -quiet -o $(MMS$TARGET) $(MMS$SOURCE_LIST_SPACES)<BIN$:PMDF_SNMP_SUBS.OBJ : PMDF_SNMP_SUBS.C, PMDF_SNMP_SUBS.HPMDF_SNMP040.AI5[MADISON.MADMAN]KITINSTAL.COM;7c$%*[MADISON.MADMAN]KITINSTAL.COM;7+,I.$/ @ 4c$!-50123KPWO"56xߜ錚7x^錚89G @HJ*$ ON CONTROL_Y THEN VMI$CALLBACK CONTROL_Y$ !7$ IF P1 .NES. "VMI$_INSTALL" THEN EXIT VMI$_UNSUPPORTED$ !H$ ! Turn on BYPASS. This is required if this kit is written off a CD-ROM0$ ! and the files in the kit are protected S:RE.$ !$ SET PROCESS/PRIV=BYPASS$ !$ SAY = "WRITE SYS$OUTPUT"$ SAY ""F$ SAY " *------------------------------------------*"F$ SAY " | |"F$ SAY " | Installing MultiNet PMDF SNMP subagent |"F$ SAY " | |"F$ SAY " *------------------------------------------*"$ SAY ""S$ SAY " Copyright (c) 1995, Innosoft International, Inc. & TGV Software, Inc."D$ SAY " Unpublished --- all rights reserved under"C$ SAY " the copyright laws of the United States"$ SAY ""<$ SAY " Restricted Rights Legend"$ SAY ""H$ SAY " Use, dPMDF_SNMP040.AI5[MADISON.MADMAN]KITINSTAL.COM;7c$uplication, or disclosure by the government"Q$ SAY " is subject to restrictions as set forth in subparagraph (c)(1)(ii)"J$ SAY " of the Rights in Technical Data and Computer Software"I$ SAY " clause at DFARS 252.227-7013 or as set forth in the"I$ SAY " Commercial Computer Software --- Restricted Rights"<$ SAY " clause at FAR 52.227-19."$ SAY ""$ !$$ ! Ensure that PMDF_ROOT is defined$ !6$ PMDF$ROOT = F$TRNLNM("PMDF_ROOT","LNM$SYSTEM_TABLE")$ IF PMDF$ROOT .EQS. ""$ THEN'$ VMI$CALLBACK MESSAGE F NOTRUNNING -J "This kit requires that PMDF V5.0 or later be installed and running"$ EXIT VMI$_FAILURE$ ENDIF$ !0$ ! Check PMDF_VERSION, needs to be at least 5.0$ !I$ PMDF$VERSION = F$EDIT(F$TRNLNM("PMDF_VERSION","LNM$SYSTEM_TABLE")-".",-- "COLLAPSE,UNCOMMENT")?$ IF F$TYPE(PMDF$VERSION) .NES. "INTEGER" THEN GOTO BAD_VERSION($ PMDF$VERSION = F$INTEGER(PMDF$VERSION)F$ IF PMDF$VERSION .GE. 50 .OR. PMDF$VERSION .EQ. 0 THEN GOTO ASK_PURGE$ BAD_VERSION:'$ VMI$CALLBACK MESSAGE F WRONGVERSION -H "This kit requires that PMDF V5.0 or later be installed and running"$ EXIT VMI$_FAILURE$ !+$ ! Purge files replaced by this procedure?$ ! $ ASK_PURGE:$ VMI$CALLBACK SET PURGE ASK$ !&$ ! Deal with hardware platform issues$ !#$ IF F$GETSYI("HW_MODEL") .GT. 1023$ THEN$ PMDF$VAX = 0$ pi_vax := PROVIDE_FILE$ pi_axp := PROVIDE_IMAGE$ ELSE$ PPMDF_SNMP040.AI5[MADISON.MADMAN]KITINSTAL.COM;7c$:VMDF$VAX = 1$ pi_vax := PROVIDE_IMAGE$ pi_axp := PROVIDE_FILE$ ENDIF$ ! $ IF PMDF$VAX THEN GOTO VAX_ARCH$ PMDF$INSTALL_AXP = 1$ TYPE SYS$INPUTP OpenVMS AXP executables will be provided automatically by this installation.M The installation of OpenVMS VAX executables is optional. Having both setsB of executables on the same system causes no conflicts in PMDF.%$ VMI$CALLBACK ASK PMDF$INSTALL_VAX -M "Install OpenVMS VAX executables as well as OpenVMS AXP executables" NO B$ GOTO ASK_MA_IP_0$ ! $ VAX_ARCH:$ PMDF$INSTALL_VAX = 1$ TYPE SYS$INPUTP OpenVMS VAX executables will be provided automatically by this installation.M The installation of OpenVMS AXP executables is optional. Having both setsB of executables on the same system causes no conflicts in PMDF.%$ VMI$CALLBACK ASK PMDF$INSTALL_AXP -M "Install OpenVMS AXP executables as well as OpenVMS VAX executables" NO B$ !<$ ! Determine the IP address of the master agent; no default$ !$ ASK_MA_IP_0:$ TYPE SYS$INPUTO In order to communicate with the SNMP master agent, the SNMP subagent needsN to know the IP address of the host on which the master agent runs. If youL elect not to supply an IP address, then the subagent will attempt to use8 the IP address specified by the site-defined logicalM MULTINET_SNMP_MASTER_AGENT_ADDRESS. If you do not define that logical orM wish to override it, then answer YES to this question. Otherwise, answer9 NO. NotPMDF_SNMP040.AI5[MADISON.MADMAN]KITINSTAL.COM;7c$ e that if you answer NO and do not define theM MULTINET_SNMP_MASTER_AGENT_ADDRESS logical, then the subagent will assumeL that the master agent runs on the local host and will use the IP address 127.0.0.1.M If you wish, at this point you may specify an explicit IP address to use.D At a later time you may alter your selection by editing the file PMDF_COM:PMDF_SNMP_SA.COM.G Specify the IP address in a.b.c.d form with a, b, c, and d integers= between 0 and 255, inclusive. For example, 192.160.0.73.$ ASK_MA_IP_1: $ VMI$CALLBACK ASK PMDF$ANSWER -H "Would you like to specify an IP address for the master agent" YES B$ IF .NOT. PMDF$ANSWER$ THEN$ PMDF$MA_IP = ""$ GOTO ASK_MA_PORT_0$ ENDIFC$ VMI$CALLBACK ASK PMDF$MA_IP "IP address of the master agent" "" S6$ PMDF$MA_IP = F$EDIT(PMDF$MA_IP,"COLLAPSE,UNCOMMENT")$ !#$ VAL = F$ELEMENT(0,".",PMDF$MA_IP)G$ IF VAL .EQS. "." .OR. F$TYPE(VAL) .NES. "INTEGER" THEN GOTO BAD_MA_IP$ VAL = F$INTEGER(VAL)5$ IF VAL .LT. 0 .OR. VAL .GT. 255 THEN GOTO BAD_MA_IP$ !#$ VAL = F$ELEMENT(1,".",PMDF$MA_IP)G$ IF VAL .EQS. "." .OR. F$TYPE(VAL) .NES. "INTEGER" THEN GOTO BAD_MA_IP$ VAL = F$INTEGER(VAL)5$ IF VAL .LT. 0 .OR. VAL .GT. 255 THEN GOTO BAD_MA_IP$ !#$ VAL = F$ELEMENT(2,".",PMDF$MA_IP)G$ IF VAL .EQS. "." .OR. F$TYPE(VAL) .NES. "INTEGER" THEN GOTO BAD_MA_IP$ VAL = F$INTEGER(VAL)5$ IF VAL .LT. 0 .OR. VAL .GT. 255 THEN GOTO BAD_MA_IP$ !#$ VAL = F$ELEMENT(3,".",PMDF$MA_IP)G$ IF VAL .EQPMDF_SNMP040.AI5[MADISON.MADMAN]KITINSTAL.COM;7c$O S. "." .OR. F$TYPE(VAL) .NES. "INTEGER" THEN GOTO BAD_MA_IP$ VAL = F$INTEGER(VAL)5$ IF VAL .LT. 0 .OR. VAL .GT. 255 THEN GOTO BAD_MA_IP$ !#$ VAL = F$ELEMENT(4,".",PMDF$MA_IP)&$ IF VAL .NES. "." THEN GOTO BAD_MA_IP$ GOTO ASK_MA_PORT_0$ ! $ BAD_MA_IP:$ TYPE SYS$INPUTI Invalid IP address entered. Please specify the IP address in a.b.c.dH form with a, b, c, and d integers between 0 and 255, inclusive. For example, 192.160.0.73.$ GOTO ASK_MA_IP_1$ !B$ ! Determine the UDP port the master agent listens on; no default$ !$ ASK_MA_PORT_0:$ TYPE SYS$INPUTO The SNMP master agent needs to listen on a fixed UDP port for requests fromK SNMP subagents. By default, the SNMP master agent is not configured toN listen on any port: you must configure it to listen on a UDP port with theI SET MASTER-AGENT-PORT command of the MULTINET CONFIGURE/SNMP utility.G Thus, you must choose a UDP port number in the range 1024 to 65535,N inclusive, for the SNMP master agent to listen on and then configure it to listen on that port.K The SNMP subagent then needs to be told the port number you selected soN that it can communicate with the master agent. If you elect not to supplyI a UDP port number, then the subagent will attempt to use the UDP portN specified by the site-defined logical MULTINET_SNMP_MASTER_AGENT_PORT. IfM you do not define that logical or wish to override it, then answer YES to) this question. Otherwise, answer  PMDF_SNMP040.AI5[MADISON.MADMAN]KITINSTAL.COM;7c$ NO.K If you wish, at this point you may specify an explicit UDP port number.D At a later time you may alter your selection by editing the file PMDF_COM:PMDF_SNMP_SA.COM.F The UDP port number must be in the range 1024 to 65535, inclusive.$ ASK_MA_PORT_1: $ VMI$CALLBACK ASK PMDF$ANSWER -L "Would you like to specify a UDP port number for the master agent" YES B$ IF .NOT. PMDF$ANSWER$ THEN$ PMDF$MA_PORT = 0$ GOTO ASK_DOC$ ENDIFN$ VMI$CALLBACK ASK PMDF$MA_PORT "UDP port on which the master agent listens" - "" I8$ IF PMDF$MA_PORT .LT. 1024 .OR. PMDF$MA_PORT .GT. 65535$ THEN$ TYPE SYS$INPUTK The UDP port number must be greater than or equal to 1024 and less thanH or equal to 5000. Please select a different UDP port number in that range.$ GOTO ASK_MA_PORT_1$ ENDIF$ !$ ! Install documentation?$ ! $ ASK_DOC:$ TYPE SYS$INPUTN You may optionally install the "MultiNet PMDF SNMP Subagent Installation &B Usage Guide" manual (ASCII, PostScript, and Bookreader files).O$ VMI$CALLBACK ASK PMDF$INSTALL_DOC "Do you wish to install documentation" NO B$ ! $ ! Install objects and sources?$ !$ ASK_SOURCES:N$ VMI$CALLBACK ASK PMDF$INSTALL_SRC "Do you wish to install source files" NO BN$ VMI$CALLBACK ASK PMDF$INSTALL_OBJ "Do you wish to install object files" NO B$ !$ DONE_ASKING:#$ VMI$CALLBACK MESSAGE I NOMORQST -@ "No further questions will be asked during the installation"'$ VMI$CALLBACK MESSAGE I PLEAS PMDF_SNMP040.AI5[MADISON.MADMAN]KITINSTAL.COM;7c$<EIGNORE -? "Please ignore any %CREATE-I-EXISTS informational messages"$ !$ ! Install the files$ !$ VMI$CALLBACK SET SAFETY NO$ !<$ IF F$SEARCH("PMDF_ROOT:[000000]COM.DIR;1") .EQS. "" THEN -8 VMI$CALLBACK CREATE_DIRECTORY USER PMDF_ROOT:[COM] -= "/PROT=(S:RWED,O:RWED,G:RE,W:RE)/OWNER=[1,4]/VERSION=0"$ SAY ""2$ SAY "Installing PMDF_COM:PMDF_START_SNMP_SA.COM"H$ VMI$CALLBACK PROVIDE_FILE PMDF_ PMDF_START_SNMP_SA.COM PMDF_ROOT:[COM]$ !$ IF PMDF$INSTALL_VAX$ THENB$ IF F$SEARCH("PMDF_ROOT:[000000]VAX_EXE.DIR;1") .EQS. "" THEN -> VMI$CALLBACK CREATE_DIRECTORY USER PMDF_ROOT:[VAX_EXE] -? "/PROT=(S:RWED,O:RWED,G:RE,W:RE)/OWNER=[1,4]/VERSION=0"8$ SAY "Installing PMDF_ROOT:[VAX_EXE]PMDF_SNMP_SA.EXE"@$ RENAME VMI$KWD:PMDF_SNMP_SA.VAX-EXE VMI$KWD:PMDF_SNMP_SA.EXED$ VMI$CALLBACK 'pi_vax' PMDF_ PMDF_SNMP_SA.EXE PMDF_ROOT:[VAX_EXE]$ IF PMDF$INSTALL_OBJ$ THEND$ IF F$SEARCH("PMDF_ROOT:[000000]VAX_OBJ.DIR;1") .EQS. "" THEN -@ VMI$CALLBACK CREATE_DIRECTORY USER PMDF_ROOT:[VAX_OBJ] -A "/PROT=(S:RWED,O:RWED,G:RE,W:RE)/OWNER=[1,4]/VERSION=0":$ SAY "Installing PMDF_ROOT:[VAX_OBJ]PMDF_SNMP_SA.OBJ"B$ RENAME VMI$KWD:PMDF_SNMP_SA.VAX-OBJ VMI$KWD:PMDF_SNMP_SA.OBJJ$ VMI$CALLBACK PROVIDE_FILE PMDF_ PMDF_SNMP_SA.OBJ PMDF_ROOT:[VAX_OBJ]<$ SAY "Installing PMDF_ROOT:[VAX_OBJ]PMDF_SNMP_SUBS.OBJ"F$ RENAME VMI$KWD:PMDF_SNMP_SUBS.VAX-OBJ VMI$KWD:PMDF_SNMP_SUBS.OBJL$ VMI$CALLBACK PROVIDE_FILE PMDF_ PMDF_SNMP_SUBS.OBJ P PMDF_SNMP040.AI5[MADISON.MADMAN]KITINSTAL.COM;7c$2MDF_ROOT:[VAX_OBJ] $ ENDIF$ ENDIF$ !$ IF PMDF$INSTALL_AXP$ THEND$ IF F$SEARCH("PMDF_ROOT:[000000]ALPHA_EXE.DIR;1") .EQS. "" THEN -@ VMI$CALLBACK CREATE_DIRECTORY USER PMDF_ROOT:[ALPHA_EXE] -? "/PROT=(S:RWED,O:RWED,G:RE,W:RE)/OWNER=[1,4]/VERSION=0":$ SAY "Installing PMDF_ROOT:[ALPHA_EXE]PMDF_SNMP_SA.EXE"@$ RENAME VMI$KWD:PMDF_SNMP_SA.AXP-EXE VMI$KWD:PMDF_SNMP_SA.EXEF$ VMI$CALLBACK 'pi_axp' PMDF_ PMDF_SNMP_SA.EXE PMDF_ROOT:[ALPHA_EXE]$ IF PMDF$INSTALL_OBJ$ THENF$ IF F$SEARCH("PMDF_ROOT:[000000]ALPHA_OBJ.DIR;1") .EQS. "" THEN -B VMI$CALLBACK CREATE_DIRECTORY USER PMDF_ROOT:[ALPHA_OBJ] -A "/PROT=(S:RWED,O:RWED,G:RE,W:RE)/OWNER=[1,4]/VERSION=0"<$ SAY "Installing PMDF_ROOT:[ALPHA_OBJ]PMDF_SNMP_SA.OBJ"B$ RENAME VMI$KWD:PMDF_SNMP_SA.AXP-OBJ VMI$KWD:PMDF_SNMP_SA.OBJL$ VMI$CALLBACK PROVIDE_FILE PMDF_ PMDF_SNMP_SA.OBJ PMDF_ROOT:[ALPHA_OBJ]>$ SAY "Installing PMDF_ROOT:[ALPHA_OBJ]PMDF_SNMP_SUBS.OBJ"F$ RENAME VMI$KWD:PMDF_SNMP_SUBS.AXP-OBJ VMI$KWD:PMDF_SNMP_SUBS.OBJN$ VMI$CALLBACK PROVIDE_FILE PMDF_ PMDF_SNMP_SUBS.OBJ PMDF_ROOT:[ALPHA_OBJ] $ ENDIF$ ENDIF$ !$ IF PMDF$INSTALL_DOC$ THEN*$ SAY "Installing PMDF_DOC:PMDF_SNMP.PS":$ VMI$CALLBACK PROVIDE_FILE PMDF_ PMDF_SNMP.PS PMDF_DOC:A$ IF F$SEARCH("PMDF_ROOT:[DOC]DECW$BOOK.DIR;1") .EQS. "" THEN -D VMI$CALLBACK CREATE_DIRECTORY USER PMDF_ROOT:[DOC.DECW$BOOK] -? "/PROT=(S:RWED,O:RWED,G:RE,W:RE)/OWNER=[1,4]/VERSION=0"A$ SAY "Installing  PMDF_SNMP040.AI5[MADISON.MADMAN]KITINSTAL.COM;7c$PMDF_ROOT:[DOC.DECW$BOOK]PMDF_SNMP.DECW$BOOK"9$ VMI$CALLBACK PROVIDE_FILE PMDF_ PMDF_SNMP.DECW$BOOK - PMDF_ROOT:[DOC.DECW$BOOK]F$ SAY "Installing PMDF_ROOT:[DOC.DECW$BOOK]PMDF_SNMP.DECW$BOOKSHELF">$ VMI$CALLBACK PROVIDE_FILE PMDF_ PMDF_SNMP.DECW$BOOKSHELF - PMDF_ROOT:[DOC.DECW$BOOK]$ ENDIF$ !$ IF PMDF$INSTALL_SRC$ THEN>$ IF F$SEARCH("PMDF_ROOT:[000000]SRC.DIR;1") .EQS. "" THEN -: VMI$CALLBACK CREATE_DIRECTORY USER PMDF_ROOT:[SRC] -? "/PROT=(S:RWED,O:RWED,G:RE,W:RE)/OWNER=[1,4]/VERSION=0"?$ IF F$SEARCH("PMDF_ROOT:[SRC]SNMP_SA.DIR;1") .EQS. "" THEN -B VMI$CALLBACK CREATE_DIRECTORY USER PMDF_ROOT:[SRC.SNMP_SA] -? "/PROT=(S:RWED,O:RWED,G:RE,W:RE)/OWNER=[1,4]/VERSION=0":$ SAY "Installing PMDF_ROOT:[SRC.SNMP_SA]PMDF_SNMP_SA.C"L$ VMI$CALLBACK PROVIDE_FILE PMDF_ PMDF_SNMP_SA.C PMDF_ROOT:[SRC.SNMP_SA]:$ SAY "Installing PMDF_ROOT:[SRC.SNMP_SA]PMDF_SNMP_SA.H"L$ VMI$CALLBACK PROVIDE_FILE PMDF_ PMDF_SNMP_SA.H PMDF_ROOT:[SRC.SNMP_SA]<$ SAY "Installing PMDF_ROOT:[SRC.SNMP_SA]PMDF_SNMP_SUBS.C"L$ VMI$CALLBACK PROVIDE_FILE PMDF_ PMDF_SNMP_SUBS.C PMDF_ROOT:[SRC.SNMP_SA]<$ SAY "Installing PMDF_ROOT:[SRC.SNMP_SA]PMDF_SNMP_SUBS.H"L$ VMI$CALLBACK PROVIDE_FILE PMDF_ PMDF_SNMP_SUBS.H PMDF_ROOT:[SRC.SNMP_SA]3$ SAY "Installing PMDF_ROOT:[SRC.SNMP_SA]ASYNC.H"C$ VMI$CALLBACK PROVIDE_FILE PMDF_ ASYNC.H PMDF_ROOT:[SRC.SNMP_SA]7$ SAY "Installing PMDF_ROOT:[SRC.SNMP_SA]RFC1565.MIB"G$ VMI$CALLBACK PROVIDE_FILE PMDF_ RFC1565.MIB  PMDF_SNMP040.AI5[MADISON.MADMAN]KITINSTAL.COM;7c$y0PMDF_ROOT:[SRC.SNMP_SA]7$ SAY "Installing PMDF_ROOT:[SRC.SNMP_SA]RFC1566.MIB"G$ VMI$CALLBACK PROVIDE_FILE PMDF_ RFC1566.MIB PMDF_ROOT:[SRC.SNMP_SA]$ ENDIF$ !G$ IF F$LOGICAL("PMDF_COMFILE") .nes. "" THEN CLOSE/NOERROR PMDF_COMFILE*$ SAY "Creating PMDF_COM:PMDF_SNMP_SA.COM"9$ OPEN/WRITE PMDF_COMFILE PMDF_ROOT:[COM]PMDF_SNMP_SA.COM$ WRT = "WRITE PMDF_COMFILE"$ DSQ = "'" + "'"$ !&$ WRT "$ ! PMDF_COM:PMDF_SNMP_SA.COM" $ WRT "$ !"V$ WRT "$ ! This command procedure is run by the PMDF SNMP subagent detached process." $ WRT "$ !"=$ WRT "$ ! Copyright (c) 1995, Innosoft International, Inc."!$ WRT "$ ! All rights reserved." $ WRT "$ !"X$ WRT "$ !!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!" $ WRT "$ !T$ WRT "$ ma_port = ""''PMDF$MA_PORT'"" ! UDP port on which the master agent listens"C$ WRT "$ ma_ip = ""''PMDF$MA_IP'"" ! Master agent's IP address" $ WRT "$ !"=$ WRT "$ ! Set the process name to something a little nicer" $ WRT "$ !"$ WRT "$ i = 1"!$ WRT "$ on error then goto loop"+$ WRT "$ set process/name=""PMDF SNMP SA"""$ WRT "$ goto continue" $ WRT "$ !"D$ WRT "$ ! Looks like the process name ""PMDF SNMP SA"" is in use;"B$ WRT "$ ! try for a process name of the form ""PMDF SNMP SA #""" $ WRT "$ !"$ WRT "$ loop:"#$ WRT "$ on error then goto loop"$ WRT "$ i = i + 1"'$ WRT "$ if i .ge. 10 then goto done"7$ WRT "$ set process/name=""PMDF SNMP SA "+DSQ+"i'""" $ WRT "$ !"$ WRT "$ done:" $ WRPMDF_SNMP040.AI5[MADISON.MADMAN]KITINSTAL.COM;7c$T "$ !"$ WRT "$ ! Now proceed on" $ WRT "$ !"$ WRT "$ continue:"$ WRT "$ set noon" $ WRT "$ !"=$ WRT "$ ! Move to the PMDF login directory, establish some">$ WRT "$ ! error handling, and then run the channel program." $ WRT "$ !"$ WRT "$ set default pmdf_log:"$$ WRT "$ on error then goto restart"$ WRT "$ sa_opt = """""K$ WRT "$ if ma_ip .nes. """" then sa_opt = sa_opt+""-ma_ip "+DSQ+"ma_ip'"""M$ WRT "$ if ma_port .gt. 0 then sa_opt = sa_opt+""-ma_port "+DSQ+"ma_port'"""3$ WRT "$ subagent = ""$pmdf_exe:pmdf_snmp_sa.exe"""!$ WRT "$ subagent "+DSQ+"sa_opt'" $ WRT "$ !"9$ WRT "$ ! We exited for some reason; restart ourselves" $ WRT "$ !"$ WRT "$ restart:"%$ WRT "$ status = f$integer($status)"&$ WRT "$ if status .eq. 1 then exit 1"($ WRT "$ error_text = f$message(status)"$ WRT "$ on error then exit"&$ WRT "$ pid = f$getjpi("""",""PID"")"$ WRT "$ if status .eq. %x20b4"$ WRT "$ then" $ WRT "$ !"$ WRT "$ ! Shutdown requested" $ WRT "$ !"*$ WRT "$ request/to=(central,network) -"S$ WRT " ""PMDF SNMP subagent process (PID = "+DSQ+"pid') exiting as requested"""$ WRT "$ exit 1"$ WRT "$ endif"$ WRT "$ if status .eq. %x20b2"$ WRT "$ then" $ WRT "$ !"$ WRT "$ ! Restart requested" $ WRT "$ !"*$ WRT "$ request/to=(central,network) -"b$ WRT " ""PMDF SNMP subagent process (PID = "+DSQ+"pid') exiting and restarting as requested"""$ WRT "$ else" $ WRT "$ !"*$ WRT "$ ! Unknown error -- exit for good" $ WRT "$ !"*$ WRT "$ requestPMDF_SNMP040.AI5[MADISON.MADMAN]KITINSTAL.COM;7c$@C!/to=(central,network) -"c$ WRT " ""PMDF SNMP subagent process (PID = "+DSQ+"pid') exited with error "+DSQ+"error_text'"""o$ WRT "$ exit status"d$ WRT "$ endif"r $ WRT "$ !"D$ WRT "$ ! Now restart"n $ WRT "$ !"p&$ WRT "$ define/user sys$output nla0:"%$ WRT "$ define/user sys$error nla0:"U-$ WRT "$ set process/name=""PMDF SNMP exit"""-$$ WRT "$ @pmdf_com:pmdf_snmp_sa.com"$ WRT "$ exit 1"$ ! $ CLOSE PMDF_COMFILE$ ! $ ! All done$ !$ EXIT VMI$_SUCCESS | Installing MultiNet PM*[MADISON.MADMAN]MAKE.COM;1+,SI. / @ 45 -50123KPWO56F H䇙7&X䇙8Ϗ49>"ꊚG @HJ$ arch = "VAX"5$ IF F$GETSYI("HW_MODEL") .GE. 1024 THEN arch = "AXP"*$ DEFINE/NOLOG BIN$ SYS$DISK:[.BIN-'arch']$ MMK 'P1 'P2 'P3 'P4 'P5 'P6%*[MADISON.MADMAN]PMDF_SNMP.DECW$BOOK;2+,t.~/ @ 4~{,-50123KPWO|56ģo7:p89>"ꊚG @HJPMDF_SNMP040.At5%[MADISON.MADMAN]PMDF_SNMP.DECW$BOOK;2~S(az7MultiNet PMDF SNMP Subagent Installation & Usage Guide~k?PMDF_SNMP  Contents  Examples  Tables  #&Index(/ EXAMPLESEXAMPLESil#..=A2-1Examplesubagent installation2- 1 Example subagent installationGq#6=@3-1UsingMULTINETSHOW/SNMP_HOST3- 1 Using MULTINET SHOW/SNMP_HOST\+TABLESTABLES]l((=A1-1 SupportedMIB variables1- 1 Supported MIB variablesXl%%=A1-2Variable descriptions1- 2 Variable descriptions cPMDF_SNMP040.At5%[MADISON.MADMAN]PMDF_SNMP.DECW$BOOK;2~\,,=A2-1Filesincludedinthekit2- 1 Files included in the kit0Nl  =A3-1Subagentoptions3- 1 Subagent options`  / CONTENTSCONTENTS8 E[TitlePageTitle Page@E\ CopyrightPageCopyright Page1xE\PrefacePreface @g$L1 Introduction1 Introduction7O)$K1.1 Relationshipbetweenthe&&masteragentandsubagent1.1 Relationship between the master agent and subagentVg%%$L1.2MIB variablesserved1.2 MIB variables servedXw''$K1.3Wheretogoforhelp1.3 Where to go for help#@g$K2 Installation2 Installation&Dw$L2.1 Requirements2.1 Requirements'~(>($K2.2Files installedbythe& installation2.2 Files installed by the installation/kw#00$L2.3 Preparingforthe installation2.3 Preparing for the installation2~(>/$A2.3.1 ConfiguringtheSNMPmasterpagent2.3.1 Configuring the SNMP master agent4gl!..$A2.3.2 Preparingtorun VMSINSTAL2.3.2 Preparing to run VMSINSTAL8Uw$$$K2.4Example installation2.4 Example installationC\g(($K2.5Post installationtasks2.5 PPMDF_SNMP040.At5%[MADISON.MADMAN]PMDF_SNMP.DECW$BOOK;2~: ost installation tasksI:w $L3 Operation3 OperationQ4K*$K3.1 Starting, restarting,and!&stoppingthesubagent3.1 Starting, restarting, and stopping the subagentU2J/$L3.2Queryingthe variablesserved&bythesubagent3.2 Querying the variables served by the subagent[^w))$K3.3Thesubagent execuatable3.3 The subagent execuatable^/ EXAMPLESEXAMPLESil#..=A2-1Examplesubagent installation2- 1 Example subagent installationGq#6=@3-1UsingMULTINETSHOW/SNMP_HOST3- 1 Using MULTINET SHOW/SNMP_HOST\+TABLESTABLES]l((=A1-1 SupportedMIB variables1- 1 Supported MIB variablesXl%%=A1-2Variable descriptions1- 2 Variable descriptions c\,,=A2-1Filesincludedinthekit2- 1 Files included in the kit0Nl  =A3-1Subagentoptions3- 1 Subagent options`sS* Copyright1995InnosoftInternational,Inc.'&TGV Software,Inc. ~AllRights Reserved.ySO(OMultiNetPMDFSNMPSubagent'O: Installation&UsageGuide O September1995UOJThisdocPMDF_SNMP040.At5%[MADISON.MADMAN]PMDF_SNMP.DECW$BOOK;2~ ument describesthe installationandusageoftheMultiNetUOPMDFSNMPsubagentdesignedforusewiththeMultiNetMIB-IISNMPOagent.sI'ORevision/Update information:"^ThisisanewmanualkAOSoftwareVersion:%^MultiNetV3.5,PMDFV5.0|R*O OperatingSystemandVersion:(^OpenVMSVAXV5.4orlater;Q''^OpenVMSAXPV6.1orlaterW W   ! Q  O OSO? Copyright1995InnosoftInternational,Inc.'&TGV Software,Inc.iO Unpublished-allrightsreservedunderthe copyrightlawsoftheUnitedStatesofOAmericac_Nopartofthis publicationmaybe reproduced, transmitted, transcribed,storedjOina retrievalsystem,or translatedintoanylanguageorcomputer language,inanykOformorbyanymeans electronic, mechanical, magnetic,optical, chemical,or otherwise7O&withoutthepriorwritten permissionof:(InnosoftInternational,Inc.+$1050EastGarveyAvenueSouth'fWestCovina,CA91790USA?Voice:'+18189193600;FAX:+18189193614sales@innosoft.com\InnosoftInternational,Inc.,andTGV Software,Inc.PMDF_SNMP040.At5%[MADISON.MADMAN]PMDF_SNMP.DECW$BOOK;2~q , (``Authors'')makenofOrepresentationsor warrantieswithrespecttothecontentshereofand specificallynO disclaimanyimplied warrantiesofmerchantabilityorfitnessforany particularpurpose.gOM Furthermore,theAuthorsreservetherighttorevisethis publicationandtomakehOchangesfromtimetotimeinthecontenthereofwithout obligationoftheAuthorsCOtonotifyanypersonofsuchrevisionorchanges.`m UseofMultiNetandPMDFsoftwareand associated documentationis authorizedeO onlybyaSoftwareLicense Agreement.'Suchlicense agreementsspecifythenumbergO ofsystemsonwhichthesoftwareis authorizedforuse,and,amongotherthings,kO4  specificallyprohibituseor duplicationofsoftwareordocumentation,inwholeorinOOw part,exceptas authorizedbytheSoftwareLicense Agreement.$h  RestrictedRightsLegendAH Use, duplication,or disclosurebythe governmentUt issubjectto restrictionsassetforthin subparagraph (c)(1)(ii)G oftheRightsin TechnicalDataandComputerSoftwareF clauseatDFARS 252.227-7013orassetforthinthe?Q  CommercialComputerSoftware- RestrictedRights%M clauseatFAR 52.227-19.JMultiNetisa registered trademarkofTGV Software,Inc.PPMDFisa registered traPMDF_SNMP040.At5%[MADISON.MADMAN]PMDF_SNMP.DECW$BOOK;2~,demarkofInnosoftInternational,Inc.W8EnvoyandEmissaryare trademarksofEpilogue Technology Corporation.* } }  ; OPreface ! j#OPurposeofthisManualL4Thismanual describeshowtoinstallandusetheMultiNetGOPMDFSNMP subagent.+ThissubagentisintendedforuseJOwithMultiNetV3.5orlaterandPMDFV5.0orlater.,InLO>ordertousethe subagent,theMultiNetMIB-IIagentmustOalsobe installed.  ! LThismanualassumes familiarityonthepartofthereaderDOwithSNMP;noattemptismadetodescribeSNMPorJO5theuseofSNMPagents, subagents,orclients..AllsuchMO discussionsareoutsidethescopeofthis document.+ConsultMOthe documentationforyourSNMPclientsoftwarefordetailsJO>onusingyourSNMPclient.)Foran introductiontoSNMP,"Othreegoodbooksare:{ Z Q `mHmTheSimpleBook:'An IntroductiontoInternet Management  m,KSecondEdition,byMarshallT.Rose,1994,PrenticeHall,ISBN0-13-177254-6. `:TCP/IP Illustrated,Volume1:-The ProtocolsF,byW.ARichardStePMDF_SNMP040.At5%[MADISON.MADMAN]PMDF_SNMP.DECW$BOOK;2~Hvens,1994,Addison-Wesley,ISBN0-201-O63346-9. `AInternetworkingwithTCP/IP,VolumeI: Principles,'' Protocols,and Architecture.',SecondEdition,byDouglasE.>Comer,1991,PrenticeHall,ISBN0-13-468505-9.FOTherelevantRFCsthatdefinethebasiclanguageandDO datatypesforSNMPv1MIBsareRFCs1155,1212,andEO51215.,ForSNMPv2MIBs,consultRFCs1442,1443,andO1444.NL Questionsaboutthe installation,configuration,anduseofGOthePMDFSNMPsubagentshouldbedirectedtoInnosoftO5International,Inc.:(mInnosoftInternational,Inc.+1050EastGarveyAvenueSouth'WestCovina,CA91790USA?wVoice:&+18189193600;FAX:+18189193614service@innosoft.com*grr X. M 1#Message TransportAgent5y M 2MIfrunon differenthosts,thetwohostsmustbeableto!5exchangeUDPpackets.ee  !! [O 1.2 IntroductionHThischapterpresentsanoverviewoftheMultiNPMDF_SNMP040.At5%[MADISON.MADMAN]PMDF_SNMP.DECW$BOOK;2~_etPMDFIOSNMP subagent:(its relationshipwiththeMultiNetMIB-IILOBSNMPagent,anda descriptionofthethesubagentserves.*rMM3 0OTable1-1:7 SupportedMIB variables O %2FapplicationTable variablesOVariablename OIDuSyntax O O applName  mib-2.27.1.1.2StringO: applVersion : mib-2.27.1.1.4String O mtaTable variablesO-Variablename -OIDu-Syntax OI O mtaReceivedMessages# mib-2.28.1.1.1 Counter32O mtaStoredMessages! mib-2.28.1.1.2Gauge32 O, mtaTransmittedMessages#, mib-2.28.1.1.3 Counter32Oz mtaReceivedVolume#z mib-2.28.1.1.4 Counter32O mtaStoredVolume! mib-2.28.1.1.5Gauge32O mtaTransmittedVolume# mib-2.28.1.1.6 Counter32Ob mtaReceivedRecipients#b mib-2.28.1.1.7 Counter32O mtaStoredRecipients! mib-2.28.1.1.8Gauge32"O mtaTransmittedRecipients# mib-2.28.1.1.9 Counter32 Of "= mtaGroupTable variablesOVariablename OIDuSyntax O  "OT mtaGroupReceivedMessages#T mib-2.28.2.1.2 Counter32 O mtaGroupStoredMessages! mib-2.28.2.1.4Gauge32%O mtaGroupTransmittedMessages# mib-2.28.2.1.5 Counter32 O= mtaGrouPMDF_SNMP040.At5%[MADISON.MADMAN]PMDF_SNMP.DECW$BOOK;2~pReceivedVolume#= mib-2.28.2.1.6 Counter32O mtaGroupStoredVolume! mib-2.28.2.1.7Gauge32#O mtaGroupTransmittedVolume# mib-2.28.2.1.8 Counter32$O% mtaGroupReceivedRecipients#% mib-2.28.2.1.9 Counter32"Os mtaGroupStoredRecipients"s mib-2.28.2.1.10Gauge32'O mtaGroupTransmittedRecipients$ mib-2.28.2.1.11 Counter32O mtaGroupName! mib-2.28.2.1.25String OX O Note:0 theOIDformib-2is 1.3.6.1.2.1. O i ` M 3HSeeRFCs1565and1566forthe specificationofthoseLMIBs.(CopiesofthoseRFCsmaybefoundinthe directory`PMDF_ROOT:[DOC.RFC].]]C z C -OTable1-2:7Variable descriptions O !OF mtaGroupTablevariableFPMDFcounteruF Description Ob ]O mtaGroupReceivedMessagesRECEIVED_MESSAGESCountofmessagesenqueuedtotheu channel. Oq mtaGroupStoredMessagesq STORED_MESSAGES0uq Countofmessagesenqueuedtothe,u channelbutnotyet delivered.eO8 mtaGroupTransmittedMessagesVDELIVERED_MESSAGESCountofmessages delivered (dequeued)u bythechannel. O mtaGroupReceivedVolume RECEIVED_VOLUME1u Volumeofmessagesenqueuedtothe4uM channelasmeasurediPMDF_SNMP040.At5%[MADISON.MADMAN]PMDF_SNMP.DECW$BOOK;2~yFnKbytes=1024u bytes.O mtaGroupStoredVolume STORED_VOLUME,u Volumeofmessagesenqueuedto4ub thechannelbutnotyet deliveredasu measuredinKbytes.^O) mtaGroupTransmittedVolumeDELIVERED_VOLUMEVolumeofmessageswhichhavebeen5uw delivered (dequeued)bythechannelasu measuredinKbytes.bO> mtaGroupReceivedRecipientsRECEIVED_RECIPIENTSVolumeofmessagesenqueuedtothe5u channelasmeasuredbythetotalnum-2u berofenvelope recipient addresses."OS mtaGroupStoredRecipientsS STORED_RECIPIENTS1uS Volumeofmessagesenqueuedtothe5u channelbutnotyet deliveredasmea-5u suredbythetotalnumberofenvelopeu; recipient addresses.fO mtaGroupTransmittedRecipientsADELIVERED_RECIPIENTSVolumeofmessageswhichhavebeen1u delivered (dequeued)bythechannel2uP asmeasuredbythetotalnumberof)u envelope recipient addresses.O mtaGroupName!u Nameofthechannel. O= a%%  GO1.1B Relationshipbetweenthemasteragentandsubagent0UTheMultiNetPMDFSNMPsubagent(iUsubagentU)worksBOinconcertwiththeMultiNetMIB-IISNMPagent(masterOagentL)toserveoutaspecificportionoftheMIBtPMDF_SNMP040.At5%[MADISON.MADMAN]PMDF_SNMP.DECW$BOOK;2~ݬree.*This0O^portionofthetree, describedin^Section1.2,c^is associatedwith!O monitoringPMDF'sMTA  15 activities.*!|?*n/! lCVThemasteragentandsubagent communicatewithoneOanotherusingUDP.  25[Thesubagent registerswiththemasterOOagenttheportionoftheMIBtreewhichitwillserveout.NO`WhenaSNMPclientmakesarequestagainstthatportionofROthetree,themasteragentrelaystherequesttothe subagent.LOThesubagent generatesaresponsewhichisthensentbackROjtothemasteragentwhothenrelaysittotheclient.)Clients>Ocannotsendrequestsdirectlytothe subagent.*f"/@VThesubagentreadsPMDF'schannelcountersusing=OthePMDFAPIroutinePMDF_get_channel_counters.DOEachtimethatroutineiscalled,!thePMDFcounterGO`synchronization processesacrossthecluster synchronizeDOthenode-specific, in-memorycachesofcounterswithKOthe cluster-wide,on-diskdatabaseof counters.+SincethisKOjprocessmaytakeseveralseconds,thesubagentcachestheCO informationreturnedbyPMDF_get_chPMDF_SNMP040.At5%[MADISON.MADMAN]PMDF_SNMP.DECW$BOOK;2~@5"annel_countersandOOwillonlycallthatroutinewhenthecacheismorethan30Ossecondsold.*{G G  S w)%O1.2BMIB variablesservedDUThesubagentservesoutselected variablesfromtheOMADMANMIBs.  34 specifically,those variablesfromtheIOapplicationTable, mtaTable,and mtaGroupTabletablesshown O^in^Table1-1.*d"/*!a?^BEachPMDFchannelis identifiedwithwithanMTANOgroup.,Thus,foreachchannel,therewillbearowinthe7O<mtaGroupTable..Forexample,ifthereare k<M< channels,$OtheOIDmib-2.28.2.1.25. n, givesthenameofthechannelO associatedwiththe n(Dthrowinthetablewhere nJ satisfies OE 1 vE  En E  EM FE. bCOnlyone applicationandMTAis recognizedbytheIOsubagentand consequentlythereisonlyonerowintheNO5applicationTableandmtaTabletables.'Theonlyvalidinstance@O identifierforthosetwotablesisthus``.1'';0i.e.,foreithertable,SOthePMDF_SNMP040.At5%[MADISON.MADMAN]PMDF_SNMP.DECW$BOOK;2~9%OIDforaninstanceofavariableisformedbytakingthePO>OIDofthevariableand appending``.1''toit.*Forexample, Oa getF operationonmib-2.27.1.1.4.1wouldreturntheversionOnumberofPMDF.L"FEachrowofthe mtaGroupTabletable correspondstoaDOsetofPMDFchannelcounters maintainedbyPMDF.A8O5 descriptionofeachvariableisgivenin5Table1-2.q5TheseEOcountersmaybedirectly manipulatedonPMDFsystems>OwiththeDCLcommandPMDFCOUNTERScommandorCO>withthePMDFQM/MAINTENANCEutility.)Refertothe(OPMDFSystem Manager'sGuide'forfurther informationon'OthePMDFchannel counters.*d? >!EThevaluesinthemtaTable correspondtothecolumn'OsumsofthemtaGroupTable;oe.g.,mtaReceivedMessagesGO<isthesumoverallrowsofthe mtaGroupTablecolumn#OmtaGroupReceivedMessages. _UNote _=The underlyingPMDFchannelcountersmaytake=onnegativevalues..However,the corresponding@OMIB variablesmustbe non-negative.+To reconcile@this difference,thesubagenttrackstheminimumCvalueseenforeachchannelcounterPMDF_SNMP040.At5%[MADISON.MADMAN]PMDF_SNMP.DECW$BOOK;2~ (andthenuses=YthatminimumtoadjusttheMIBvariablesuchBthatithasaminimumofzero..Thisisdoneby>  subtractingtheminimumvaluefromthecounter?bwhenthatminimumislessthanzero..ForthisGreason,thevaluesofthecounters displayedwiththe;PMDFCOUNTERScommandmaydifferfromthose+l displayedfromaSNMPclient. *"3HH#'O1.3BWheretogoforhelpLU Questionsaboutthe installation,configuration,anduseofGOthePMDFSNMPsubagentshouldbedirectedtoInnosoftOInternational,Inc.:$(mInnosoftInternational,Inc.+1050EastGarveyAvenueSouth'WestCovina,CA91790USA?wVoice:&+18189193600;FAX:+18189193614service@innosoft.com*%--,  M 1DThesecondand subsequentPMDF subagentstoattemptJ5toregisterwithamasteragentalreadyhandlingaPMDFPsubagentwillbeunabletoregister themselvesandwillexit.^^D&%O 2.2 Installationp03 PMDF_SNMP040.At5%[MADISON.MADMAN]PMDF_SNMP.DECW$BOOK;2~J+F4OTable2-1:7Filesincludedinthekit O OFFileFTarget directory/ F Description Ob OPMDF_SNMP_SA.EXE PMDF_EXE:/  Subagent executable OPMDF_START_SNMP_SA.COM PMDF_COM:-/  Proceduretostartthesubagent/ E processOPMDF_SNMP_SA.COM PMDF_COM:,/  Procedureexecutedbythesub-/  agentprocessO-PMDF_SNMP_SA.OBJ- PMDF_OBJ:,/ - Subagentobjectfile (optional)O{PMDF_SNMP_SUBS.OBJ{ PMDF_OBJ:,/ { Subagentobjectfile (optional)O PMDF_SNMP.PS PMDF_DOC:"/  Thismanual (optional)OPMDF_SNMP.DECW$BOOK#PMDF_ROOT:[DOC.DECW$BOOK]"/  Thismanual (optional)=OcPMDF_SNMP.DECW$BOOKSHELFPMDF_ROOT:[DOC.DECW$BOOK]"/ c Thismanual (optional)OPMDF_SNMP_SA.C!PMDF_ROOT:[SRC.SNMP_SA],/  Subagentsourcefile (optional)OPMDF_SNMP_SA.H!PMDF_ROOT:[SRC.SNMP_SA],/  Subagentsourcefile (optional)OLPMDF_SNMP_SUBS.C!LPMDF_ROOT:[SRC.SNMP_SA],/ L Subagentsourcefile (optional)OPMDF_SNMP_SUBS.H!PMDF_ROOT:[SRC.SNMP_SA],/  Subagentsourcefile (optional)O RFC1565.MIB!PMDF_ROOT:[SRC.SNMP_SA],/  Subagentsourcefile (optional)O4 RFC1566.MIB!4PMDF_ROOT:[SRC.SNMP_SA],/ 4 Subagentsourcefile (optional) OBUILD_PMDF_SNMP_SA.COM!PMDF_SNMP040.At5%[MADISON.MADMAN]PMDF_SNMP.DECW$BOOK;2~2.PMDF_ROOT:[SRC.SNMP_SA],/  Subagentsourcefile (optional) O   'O2.1B RequirementsFUInordertoinstalltheMultiNetPMDFSNMP subagent,)Oyoumusthavethe following( `m=mMultiNetV3.5orlater installedandrunning, `>PMDFV5.0orlater installedandrunning,and `l+lthePMDFSNMPsubagentkit(plPMDF_SNMP035.A zl).)! aOOThesubagentmustbe installedandrunonahostwithbothMOMultiNetV3.5orlaterandPMDFV5.0orlater.(BeforeyouLO5canusethe subagent,youmustalsoinstalland configure2OtheMultiNetSNMPMIB-IIagent(themasteragent).(ThePOmasteragentandsubagentneednotberunonthesamehost.HO>However,thehostonwhichthemasteragentrunsmustKOhaveMultiNetV3.5orlaterandbeabletoexchangeUDPIOpacketswiththesystemrunningthe subagent.(PMDFneedIOHnotbe installedonthehostrunningthemasteragent.* EOwingtohowthesubagent registersitsMIBwithaFOmasteragent,twoPMDF subagentscannotsimultaneouslyLO5usethesamemasteragent.'Thus, PMDF_SNMP040.At5%[MADISON.MADMAN]PMDF_SNMP.DECW$BOOK;2~T1tomonitorPMDFactivitySOintwo different clusters,youneedtorunatleastonemasterPOagentperclusterandatleastonesubagentineachcluster.LO>Eachsubagentmustregisterwitha differentmasteragent.LOSiteswishingtorunmorethanonesubagentpercluser(Le.g.,KOforreasonsof redundancy)maydosobyrunningmultipleGOHmasteragentsintheclusterandhavingeachsubagent6Oregisterwitha differentmasteragent.;+! LNotethatasubagentneednotuseamasteragentrunningQOinthesamecluster:'thesubagentmerelyneedstoensurethatPO5itdoesnotattempttousethesamemasteragentasanotherOPMDF subagent. q 1*+D/,J-!  IVInthePMDFclusterstobe monitored,thePMDFchannelJOcountersmustbeenabled.-Thisisthedefault..TheyareFOonlydisabledifLOG_STATISTICS=0is specifiedintheO`PMDF_TABLE:OPTION.DAT2{`file.+In addition,thePMDFcounterFOsynchonization processesmustberunningoneachhostGOrunningPMDF.Againthisisthedefault.-SeeAppendixOjBoftheV5.05BjPMDFforOpenVMS: InstallationGuide&OReleaseNotes@Oforfurtherdetailsont!PMDF_SNMP040.At5%[MADISON.MADMAN]PMDF_SNMP.DECW$BOOK;2~ 4hose processes.)Finally,JOthesubagentprocessmusthaveSYSLCK privilegeinorderIOstoissuerequeststo synchronizethecountersandWORLD/O privilegeinordertoreadthem.*.mm/6O2.2BFiles installedbythe installationUTable2-1=@Uliststhefiles installedbythe installationNO procedure.'AllfilesareplacedinthePMDF directorytree.*/e?0*1gG, Ue8OExample2-1:7Examplesubagent installation OG$#G@SYS$UPDATE:VMSINSTAL.COMGzOpenVMS%VAX&Software&Product% Installation& Procedure%6.1)OIt%is% 18-MAY-1995%at%14:20.BOEnter%a&question&mark%(?)&at&any%time&for%help.SO*&Are%you% satisfied&with%the&backup%of%your&system%disk&[YES]?  YESBO4*&Where&will%the& distribution%volumes&be&mounted:4 D0:[000000]_OEnter%the%products%to%be% processed&from%the&first& distribution%volume%set.O*& Products: PMDF_SNMP035FO-*&Enter& installation%options&you%wish&to&use%(none):   M1+RETURN % M C 8OThe% following&products&will%be% processed: PMDF_SNMP%V3.5Azn Beginning% instal"PMDF_SNMP040.At5%[MADISON.MADMAN]PMDF_SNMP.DECW$BOOK;2~m7lation%of% PMDF_SNMP&V3.5%at%14:21FO%VMSINSTAL-I-RESTORE,% Restoring&product%save%set%A%...6A,*------------------------------------------* | 4 |:|K Installing&MultiNet&PMDF%SNMP%subagentJ| | 4 |6`,*------------------------------------------*X/ Copyright%(c)&1995,&Innosoft&International,&Inc.%&%TGV% Software,&Inc.8 Unpublished%---&all%rights%reserved%under7:Ythe% copyright%laws%of%the%United&States$d Restricted%Rights%LegendA, Use,& duplication,%or% disclosure&by&the% governmentUTt is%subject%to% restrictions%as%set&forth&in& subparagraph% (c)(1)(ii)G4 of%the&Rights%in% Technical%Data%and%Computer%SoftwareFZ clause%at%DFARS% 252.227-7013%or%as%set&forth&in&theAL  Commercial&Computer&Software&---% Restricted&Rights%d clause&at&FAR% 52.227-19.VO *&Do&you%want&to&purge&files&replaced&by&this% installation&[YES]? YES_f OpenVMS%VAX% executables%will%be%provided% automatically&by&this% installation.] The& installation%of%OpenVMS&AXP% executables%is% optional.%Having&both%setsR of% executables%on%the&same%system&causes%no% conflicts%in%PMDF._O_ *&Install%OpenVMS%AXP% executables%as%well%as%OpenVMS&VAX% executables%[NO]? ? _ YESa In%order%to% communicate%with%the%SNMP%master%agent,&the%SNMP&subagent&needsb to%kn#PMDF_SNMP040.At5%[MADISON.MADMAN]PMDF_SNMP.DECW$BOOK;2~S:ow%the%IP%address%of%the%host%on%which%the%master&agent&runs.KIf%you_X elect%not&to&supply%an%IP%address,%then&the%subagent%will&attempt%to%useE the&IP&address% specified&by&the% site-defined%logicalZ #MULTINET_SNMP_MASTER_AGENT_ADDRESS.KIf&you%do%not%define&that%logical%or]0wish%to%override%it,%then%answer%YES&to&this% question.K Otherwise,&answerIxNO.KNote&that%if%you&answer%NO%and%do%not&define%theY"MULTINET_SNMP_MASTER_AGENT_ADDRESS%logical,%then&the%subagent%will&assume`that%the%master&agent&runs%on%the&local&host%and&will%use&the%IP%addressP 127.0.0.1.aIf%you&wish,&at&this%point%you&may%specify&an&explicit&IP&address%to%use.VAt%a%later%time&you%may%alter%your% selection%by%editing%the%file$IPMDF_COM:PMDF_SNMP_SA.COM.ZSpecify%the%IP%address%in%a.b.c.d&form%with%a,%b,%c,%and%d%integersIbetween%0&and%255,& inclusive.KFor%example,% 192.160.0.73.COj*&Would&you%like&to&specify%an%IP%address%[YES]? 1  3MhRETURN 3M  1O*&IP&address%of%the&master%agent:D 128.93.253.2c!The&SNMP%master&agent&needs&to&listen%on%a&fixed&UDP%port&for%requests%from[iSNMP% subagents.KBy%default,%the%SNMP%master%agent%is%not& configured%toclisten&on&any%port:%you%must% configure%it%to%$PMDF_SNMP040.At5%[MADISON.MADMAN]PMDF_SNMP.DECW$BOOK;2~&_=listen&on&a%UDP&port%with%the]SET&MASTER-AGENT-PORT&command%of%the&MULTINET&CONFIGURE/SNMP&utility.&Thus,_Ayou&must%choose&a%UDP&port%number&in&the%range%1024&to&65535,% inclusive,afor&the%SNMP&master%agent%to%listen%on%and&then% configure&it&to&listen%onthat%port.^:The&SNMP%subagent%then%needs%to%be%told&the%port&number%you%selected%so`that%it%can% communicate%with%the%master&agent.JIf%you&elect&not%to%supply\a%UDP%port%number,&then%the&subagent&will%attempt%to%use%the&UDP%portY specified&by&the% site-defined%logical% MULTINET_SNMP_MASTER_AGENT_PORT.JIfaZyou&do&not%define%that%logical&or&wish%to%override%it,&then%answer&YES%to2this% question.K Otherwise,%answer&NO.^ If%you&wish,&at&this%point%you&may%specify&an&explicit&UDP%port&number.VSAt%a%later%time&you%may%alter%your% selection%by%editing%the%file$PMDF_COM:PMDF_SNMP_SA.COM.XThe&UDP%port&number%must&be&in&the%range%1024&to&65535,% inclusive.HOm*&Would&you%like&to&specify%a%UDP%port%number%[YES]? mYES?O*&UDP%port&on&which&the%master%agent%listens:33033^You&may% optionally&install%the& "MultiNet%PMDF&SNMP%Subagent% Installation&&FfUsage%Guide"&manual% (PostScript%and% Bookreader%files).=O*&Do&you%wish&to&install% docu%PMDF_SNMP040.At5%[MADISON.MADMAN]PMDF_SNMP.DECW$BOOK;2~@mentation%[NO]?   MRETURN M  =O.*&Do&you%wish&to&install%source&files&[NO]?   M,RETURN M D =O*&Do&you%wish&to&install%object&files&[NO]? L  NMRETURN NM  VO%PMDF_SNMP-I-NOMORQST,&No&further% questions&will%be%asked%during&the installationZOc%PMDF_SNMP-I-PLEASEIGNORE,%Please%ignore&any%%CREATE-I-EXISTS& informationalmessages5O Installing&PMDF_COM:PMDF_START_SNMP_SA.COM9O\ Installing&#PMDF_ROOT:[VAX_EXE]PMDF_SNMP_SA.EXE;O Installing&%PMDF_ROOT:[ALPHA_EXE]PMDF_SNMP_SA.EXE-OCreating%PMDF_COM:PMDF_SNMP_SA.COMAzU Installation%of% PMDF_SNMP%V3.5% completed%at%14:22g  Z200O2.3B Preparingforthe installation*3#4 6O2.3.1B ConfiguringtheSNMPmasteragentB4Before installingtheMultiNetPMDFSNMP subagent,JOyoushould configureandenabletheMultiNetSNMPmasterSOagentifyouhavenotalreadydoneso.'To configuretheagent,AO=usetheMULTINETCONFIGURE/SNMPutility.)YouwillPOneedtoselectaUDPportforthemasteragenttousewhenAO communicatingwith subagents.-TheUDPportnumberPOGmustbeintherange1024to&PMDF_SNMP040.At5%[MADISON.MADMAN]PMDF_SNMP.DECW$BOOK;2~,C65535.)For instance,issuethe7O followingcommandstoselectport33033: O$$"$MULTINET&CONFIGURE/SNMP9OlMultiNet%SNMP& Configuration%Utility%V3.5(1)OO[Reading%in% configuration&from%"MULTINET:SNMP_AGENT.CONFIGURATION]O SNMP-CONFIG>'SET%MASTER-AGENT-PORT%33033OD SNMP-CONFIG>DSHOWO sysDescr:MultiNetO sysContact: PostmasterO= sysLocation:=AnytownORead-Community:public#OMaster-Agent-Port:33033O SNMP-CONFIG>SAVEaO][Writing% configuration&to&:MULTINET_COMMON_ROOT:[MULTINET]SNMP_AGENT.CONFIGURATION.3]O SNMP-CONFIG>EXIT O$&5 >OncetheUDPportnumberhasbeen configured,?OenabletheSNMPmasteragentwiththeMULTINET$O5CONFIGURE/SERVERutility: O$$MULTINET&CONFIGURE/SERVER;OMultiNet%Server% Configuration%Utility&3.4(35)MOI[Reading%in% configuration&from% MULTINET:SERVICES.MASTER_SERVER]OSERVER-CONFIG>ZENABLE%SNMPOSERVER-CONFIG>ZSAVE%O![Writing% configuration&toCOi9MULTINET_COMMON_ROOT:[MULTINET]SERVICES.MASTER_SERVER;93]OSERVER-CONFIG>ZRESTARTMO%RUN-S-PROC_ID,%identification%of%created%process&is&24E05F31OASERVER-CONFIG>ZAEXITAO[Configuration%not% modified,&so&no&update%needed]'PMDF_SNMP040.At5%[MADISON.MADMAN]PMDF_SNMP.DECW$BOOK;2~F O$6NKONotethateveniftheSNMPmasteragentisenabled,youKOmaystillneedtoissueaRESTARTcommandafteryouset!O5theUDPportnumber.*7!8.O2.3.2B Preparingtorun VMSINSTALB4TheMultiNetPMDFSNMPsubagentis installedwith?O VMSINSTAL.The VMSINSTAL procedurewillasksixHO questionsspecifictothe installationofthe subagent:9 `m1.CmInstallOpenVMSAXP executablesaswellasOpenVMSVAX executables?BWhenyouinstallthesubagentfromaVAXsystem,HwyouwillbeaskedwhetherornotyouwouldalsolikeBtoinstallAlphaAXPsupport./ Similarly,whenyouF(installfromanAlphaAXPsystem,youwillbeaskedGwhetherornottoinstallVAXsupport.+AnswerYESifMyouwouldlikesupportforboth platformstobe installed.F2Notethatalthoughthesubagentmaybe installedforHmultiplearchitectures,onlyonesubagentshouldberun perOpenVMScluster.: `2.IWouldyouliketosupplyanIPaddressforthemaster/agent?EInorderto communicatewiththeSNMPmasteragent,Ithe(PMDF_SNMP040.At5%[MADISON.MADMAN]PMDF_SNMP.DECW$BOOK;2~5ISNMPsubagentneedstoknowtheIPaddressoftheI9hostonwhichthemasteragentruns.,IfyouelectnotJtosupplyanIPaddress,thenthesubagentwillattemptNtousetheIPaddress specifiedbythe site-definedlogical-B#MULTINET_SNMP_MASTER_AGENT_ADDRESS.NIfyoudonotdefinethatlogicalorwishtooverrideit,DthenanswerYEStothis question.+ Otherwise,answerILNO.NotethatifyouanswerNOanddonotdefinethe,"MULTINET_SNMP_MASTER_AGENT_ADDRESSHlogical,thenthesubagentwillassumethatthemasterMVagentrunsonthelocalhostandwillusetheIPaddress 127.0.0.1.; NJIfyouanswerYES,youwillthenbepromptedtosupplyLtheIPaddressofthemasteragent.'EntertheIPaddress5ina.b.c.dform;5e.g.,5 192.160.0.73.<!  `3.GWouldyouliketospecifyaUDPportnumberforthe/masteragent?JInadditiontotheIPaddressofthemasteragent,theDsubagentalsoneedstoknowtheUDPportonwhichJ9themasteragentlistensfor requests.-IfyouelectnotFtosupplyaUDPportnumber,thenthesubagentwillLattempttousetheUDPport specifiedbythe site-defined3B)PMDF_SNMP040.At5%[MADISON.MADMAN]PMDF_SNMP.DECW$BOOK;2~.Llogical MULTINET_SNMP_MASTER_AGENT_PORT.TIfyoudonotdefinethatlogicalorwishtooverrideit,thenCanswerYEStothis question.' Otherwise,answerNO.= 6JIfyouanswerYES,youwillthenbepromptedtosupplyHthenumberoftheUDPportusedbythemasteragent.B5SupplytheUDPportnumberwhichmustbeintheFrange1024to65535, inclusive.-Itmustbethesame<portnumber specifiedwiththe``SETMASTER-2> AGENT-PORT''command in theMULTINET>CONFIGURE/SNMPutility.*Usethat utility'sSHOW7commandtoseewhichportwas selected: Ot$"tMULTINET&CONFIGURE/SNMP9OMultiNet%SNMP& Configuration%Utility%V3.5(1)OO[Reading%in% configuration&from%"MULTINET:SNMP_AGENT.CONFIGURATION]OL SNMP-CONFIG>LSHOWO sysDescr:MultiNetO sysContact: PostmasterOE sysLocation:EAnytownORead-Community:public#OMaster-Agent-Port:44000O SNMP-CONFIG>4>!   If'Master-Agent-Port3doesnotappearintheSHOWoutput,2thennosettinghasbeenmade.-SeeSection2.3.1 forH5 instructionson configuringthemasteragent'sUDPportnumber.*>?4C*PMDF_SNMP040.At5%[MADISON.MADMAN]PMDF_SNMP.DECW$BOOK;2~FO?  `4.4Doyouwishtoinstalldocumentation?H/AnswerYESifyouwouldlike Bookreaderand PostScript2 documentationfiles installedtothe#PMDF_ROOT:[DOC.DECW$BOOK] andsPMDF_ROOT:[DOC] directories.@!  `5.4Doyouwishtoinstallsourcefiles?F/AnswerYESifyouwouldlikesourcefiles installed.BThe source files will be placed!in the directory!PMDF_ROOT:[SRC.SNMP_SA]*/.ThesourcefilescanonlyE9becompiledifyoualsohave availabletheMultiNetHsubagentsupporttoolswhichincludeEpilogue Technology4 Corporation'sEnvoySNMPheaderfiles.Aw [Y `6.4Doyouwishtoinstallobjectfiles?K/AnswerYESifyouwouldlikeobjectfiles installed.*The=objectfileswillbeplacedinthe directoryPMDF_ROOT:[VAX_OBJ] andqPMDF_ROOT:[ALPHA_OBJ]- directories,as appropriate.'TheP9objectfilesareonlyofuseifyoualsohave availabletheFMultiNetsubagentsupporttoolswhichincludeEpilogue< Technology Corporation'sEnvoySNMP libraries.IBWithoutthose libraries,youcannotrelinkthe subagent.*B+PMDF_SNMP040.At5%[MADISON.MADMAN]PMDF_SNMP.DECW$BOOK;2~RK! >{ M 2N Actually,after starting,thesubagentwillsend registrationQ5requestsonceevery10secondsforupto30minutesoruntilLitgetsa response.,So,themasteragentcanactuallybeSstartedafterthesubagentprovidedthatitisstartednolater2>than30minutesafterthe subagent.PP6N   M 3MIfyouwishtorunmultiple subagentsintheclusterthenH5youmayneedtomodifythecommand procedureforeachQnodesoastoreflecttheIPaddressofthemasteragenttoSbeusedbythatnode.'ThesimplestwaytodothatistohaveL>eachnodeusethemasteragentrunningonthesamenode.NThatismostreadily accomplishedbyusing 127.0.0.1asthe.IPaddressofthemasteragent.KK_C w5$O2.4BExample installationUExample2-16UshowsaPMDFSNMPsubagent installationGOdialogueusingthe VMSINSTALutility.,Inthisexample,GOthe PMDF_SNMP035kithasbeencopiedtothe directoryO^ D0:[000000]"^priorto installation.*COG:D! fJWhenever appropriate,eachpromptalso,PMDF_SNMP040.At5%[MADISON.MADMAN]PMDF_SNMP.DECW$BOOK;2~UsuppliesadefaultHOanswerwhichisenclosedwithinsquare brackets.+SimplyO5pressingreturn, 3 T2RETURN T K3+5,selectsthedefaultanswer.EERememberthatthevaluesenteredinthissampleareKOforpurposesofexampleonly..BesuretousethevaluesIO5 appropriateforyoursystemwhenyouperformtheactualO installation.*F*HUU ;R M 1FNotethatdirectaccesstothePMDFchannelcounters?5maybehadthroughthePMDFAPIroutinePMDF_Gget_channel_counters.)Thatroutineis documentedinthe/PMDF Programmer's ReferenceManual ?.i' ' 5I (O2.5BPost installationtasksKUAfterrunningthe installation procedure,allthatremainsROistostartthesubagentrunning.)ThisisdonebyissuingtheOcommand O$* @PMDF_COM:PMDF_START_SNMP_SA.COMyJ ONOonthePMDFhostfromwhichyouwishtorunthe subagent.GONotethattheMultiNetmasteragentshouldalreadybeO5running.  2E5Whenthesubagentruns,itwilll-PMDF_SNMP040.At5%[MADISON.MADMAN]PMDF_SNMP.DECW$BOOK;2~\JXogerrorsandany/O debugging informationtothefilePMDF_LOG:SNMP_SA.LOG .*J"/KLMCVYoushouldmodifyyoursystemstartup proceduretoOexecutethecommand-O4$& @PMDF_COM:PMDF_START_SNMP_SA.COMM! ;OonatleastonePMDFnodeinthecluster. 7g 3vThecommandFOshouldbeexecutedafterPMDFandMultiNethavebeenLO5started.,Note,however,thatthesubagentwillwaituptoHOonehourforPMDFtobestartedas determinedbytheBOpresenceofthelogical PMDF_VERSION.ThesubagentQO>willalsowaituptoonehourforMultiNettobestartedasKO determinedbythepresenceofthelogical MULTINET.AfterROboththoselogicalsaredefined,thesubagentwillwaitupwardsQOHofhalfanhourforeitherapostiveornegative registration3Oacknowledgmentfromthemasteragent.*M7:"/NO! *LVIfyoushouldchangetheIPaddressorUDPportusedbythecommand O$,"@PMDF_COM:START_SYNCH_COUNTERS.COM*ZQKK%1`n M(OTable3-1:7Subagentoptions O OFOptionF Description Ob O-debug8 Enabledebugoutput.!Disabledbydefault.O$-ma_ipE$ ip-addresse$ IPaddressofthehostrunningthemasteragent.#Ifnot specifiedthe1PMDF_SNMP040.At5%[MADISON.MADMAN]PMDF_SNMP.DECW$BOOK;2~ydntheIPKq address specifiedwiththe"MULTINET_SNMP_MASTER_AGENT_ADDRESSm logicalwillbeused."Ifthatlogicalisnotdefined,thenthelocalhost, 127.0.0.1,  isassumed.O-ma_portport^ UDPportonwhichthemasteragentlistensforsubagent requests.&IfnotQ specifiedthentheport specifiedwiththeMULTINET_SNMP_MASTER_.! AGENT_PORTlogicalwillbeused. OG a)INDEXINDEX!i  iFF)S9FilesFilesCSN8PMDF_SNMP_SA.COMPMDF_SNMP_SA.COMOOS  N8PMDF_START_SNMP_SA.COMPMDF_START_SNMP_SA.COMI9S N8 SNMP_SA.LOGSNMP_SA.LOGJ!i  iII7S 9 InstallationInstallation1SN8ExampleExampleCFSN8Post installationPost installationIASN9PreinstallationPreinstallation2;S N8 RequirementsRequirements'!i  iMM/S8MADMANMADMAN<S 9MasteragentMaster agent8S N8IPaddressIP address:4S N8UDPportUDP port<%S  9MIBMIB+SN8OIDsOIDs5S N8 VariablesVariablesGS2PMDF_SNMP040.At5%[MADISON.MADMAN]PMDF_SNMP.DECW$BOOK;2~g9MIB-IISNMPagentMIB-II SNMP agent!i  iOO+S9OIDsOIDs!i  jRR;S 8 RequirementsRequirements'4S 8RFC1565RFC 15654S 9RFC1566RFC 1566!i  jSS3S 8SubagentSubagent1SN8OptionsOptions_7S N8 RestartingRestartingV3S N9StartingStartingI3S N8StoppingStoppingX!i  iVV5S 8 VariablesVariablesXX"!$[ 2BO3.2BQueryingthe variablesservedbythesubagentJUThe variablesservedbythesubagentarequeriedwithaOOSNMPclient.*Theclientmustdirectitsqueriestothehost&Orunningthemasteragent.)Example3-1# illustratestheuseof=O^theMULTINETSHOW/SNMP_HOSTcommandtoexecuteOOsomesimplequeries.(Intheexample,themasteragentisonKOthehostacme.comandthefifthrowofthe mtaGroupTableLOhisqueried.)Thatrow correspondstothe mtcp_localchannelGOasshownbyqueryingmtaGroupName.5whichhastheOIDOmib-2.28.2.1.25.5.*[)O\*]3PMDF_SNMP040.At5%[MADISON.MADMAN]PMDF_SNMP.DECW$BOOK;2~= j$"^w )O3.3BThesubagent execuatable2UThesubagent executableisthefile#UPMDF_EXE:PMDF_SNMP_SA.EXE 5 U.NOThatimageisrunfromadetachedprocesscreatedwiththe)OPMDF_COM:PMDF_START_SNMP_SA.COM"command procedure.)TheFO^detachedprocessitselfexecutesthecommand procedure#OPMDF_COM:PMDF_SNMP_SA.COM ._NDThesubagenthasthreeoptions (switches)whichmayJObe specifiedonthe invocationcommandlineasshowninO5Table3-1*_Oa?`*a   !!!!!!"#"$$%$  PrefacePrefacePrefacePrefacePrefacePrefacePrefacePreface1. Introduction1. Introduction=1.1 Relationship between the master agent and subagent Note 1=1.1 Relationship between the master agent4PMDF_SNMP040.At5%[MADISON.MADMAN]PMDF_SNMP.DECW$BOOK;2~m and subagent Note 2=1.1 Relationship between the master agent and subagent=1.1 Relationship between the master agent and subagent1.2 MIB variables served*Table 1- 1: Supported MIB variables Note 31.2 MIB variables served1.2 MIB variables served1.2 MIB variables served(Table 1- 2: Variable descriptions1.2 MIB variables served1.2 MIB variables served1.3 Where to go for help1.3 Where to go for help1.3 Where to go for help2. Installation2.1 Requirements2.1 Requirements2.1 Requirements2.1 Requirements2.1 Requirements Note 12.1 Requirements2.1 Requirements.2.2 Files installed by the installation,Table 2- 1: Files included in the kit.2.2 Files installed by the installation)2.3 Preparing for the installation)2.3 Preparing for the installation.2.3.1 Configuring the SNMP master agent.2.3.1 Configuring the SNMP master agent.2.3.1 Configuring the SNMP master agent.2.3.1 Configuring the SNMP master agent'2.3.2 Preparing to run VMSINSTAL'2.3.2 Preparing to run VMSINSTAL'2.3.2 Preparing to run VMSINSTAL'2.3.2 Preparing to run VMSINSTAL'2.3.2 Preparing to run VMSINSTAL'2.3.2 Preparing to run VMSINSTAL'2.3.2 Preparing to run VMSINSTAL'2.3.2 Preparing to run VMSINSTAL'2.3.2 Preparing to run VMSINSTAL'2.3.2 Preparing to run VMSINSTAL'2.3.2 Preparing to 5PMDF_SNMP040.At5%[MADISON.MADMAN]PMDF_SNMP.DECW$BOOK;2~vprun VMSINSTAL2.4 Example installation2.4 Example installation2.4 Example installation2.4 Example installation2Example 2- 1: Example subagent installation2.4 Example installation"2.5 Post installation tasks"2.5 Post installation tasks Note 2"2.5 Post installation tasks"2.5 Post installation tasks Note 3"2.5 Post installation tasks"2.5 Post installation tasks3. Operation Note 13. Operation3. Operation:3.1 Starting, restarting, and stopping the subagent:3.1 Starting, restarting, and stopping the subagent:3.1 Starting, restarting, and stopping the subagent:3.1 Starting, restarting, and stopping the subagent:3.1 Starting, restarting, and stopping the subagent:3.1 Starting, restarting, and stopping the subagent83.2 Querying the variables served by the subagent2Example 3- 1: Using MULTINET SHOW/SNMP_HOST83.2 Querying the variables served by the subagent#3.3 The subagent execuatable#3.3 The subagent execuatable#Table 3- 1: Subagent options#3.3 The subagent execuatable& & 123456789PREFACEHEAD1_PURPOSE126PMDF_SNMP040.At5%[MADISON.MADMAN]PMDF_SNMP.DECW$BOOK;2~us1314151617CHAPTER_INTRO19HEAD1_INTRO_MULTINET_DECW_FN_1_122_DECW_FN_2_22425HEAD1_INTRO_VARIABLESTABLE_VARIABLES_DECW_FN_3_3293031TABLE_DESCRIPTIONS3334HEAD1_INTRO_HELP3637CHAPTER_INSTALLATIONHEAD1_INSTALL_REQUIRE40414243_DECW_FN_1_44546HEAD1_INSTALL_FILESTABLE_FILES49HEAD1_INSTALL_PREP51HEAD2_INSTALL_PREP_MA535455HEAD2_INSTALL_PREP_VMI575859607PMDF_SNMP040.At5%[MADISON.MADMAN]PMDF_SNMP.DECW$BOOK;2~Ov616263646566HEAD1_INSTALL_EXAMPLE686970EXAMPLE_INSTALLATION72HEAD1_INSTALL_POST74_DECW_FN_2_57677_DECW_FN_3_67980CHAPTER_OPERATION_DECW_FN_1_78384HEAD1_OPERATION_START8687888990HEAD1_OPERATION_QUERYEXAMPLE_SAMPLEQUERIES93HEAD1_OPERATION_EXE95TABLE_SUBAGENT_OPTIONS97 B-ADOBE-Helvetica-Medium-R-Normal--*-120-*-*-P-*-ISO8859-1@-ADOBE-Helvetica-Bold-R-Normal--*-180-*-*-P-*-ISO8859-1@-ADOBE-Helvetica-Bold-R-Normal--*-120-*-*-P-*-ISO8859-1B-ADOBE-Helvetica-Medium-R-Normal--*-100-*-*-P-*-ISO8859-1B-ADOBE-Helvetica-Medium-O-Normal--*-100-*-*-P-*-IS8PMDF_SNMP040.At5%[MADISON.MADMAN]PMDF_SNMP.DECW$BOOK;2~~lyO8859-1@-ADOBE-Helvetica-Bold-R-Normal--*-140-*-*-P-*-ISO8859-1O-ADOBE-New Century Schoolbook-Medium-R-Normal--*-140-*-*-P-*-ISO8859-1/-ADOBE-Symbol-*-R-*--*-140-*-*-P-*-*-*O-ADOBE-New Century Schoolbook-Medium-I-Normal--*-140-*-*-P-*-ISO8859-1M -ADOBE-New Century Schoolbook-Bold-R-Normal--*-100-*-*-P-*-ISO8859-1O -ADOBE-New Century Schoolbook-Medium-R-Normal--*-100-*-*-P-*-ISO8859-1O -ADOBE-New Century Schoolbook-Medium-R-Normal--*-120-*-*-P-*-ISO8859-1> -ADOBE-Times-Medium-R-Normal--*-140-*-*-P-*-ISO8859-1L -ADOBE-Interim DM-Medium-I-Normal--*-140-*-*-P-*-DEC-DECMATH_SYMBOLL-ADOBE-Interim DM-Medium-I-Normal--*-140-*-*-P-*-DEC-DECMATH_ITALIC@-ADOBE-Courier-Medium-R-Normal--*-120-*-*-M-*-ISO8859-1>-ADOBE-Courier-Bold-R-Normal--*-120-*-*-M-*-ISO8859-1@-ADOBE-Courier-Medium-O-Normal--*-120-*-*-M-*-ISO8859-1kl r& x x RW  } `e|%,r"G M](H*h^.T *8-4m*A" SK5vV' QRP[VJU`hX]jcKd9PMDF_SNMP040.AB5*[MADISON.MADMAN]PMDF_SNMP.DECW$BOOKSHELF;1E **[MADISON.MADMAN]PMDF_SNMP.DECW$BOOKSHELF;1+,B. / @ 4E H-50123KPWO56| "_7 D_8u͙9>"ꊚG @HJEBOOK\pmdf_snmp\MultiNet PMDF SNMP Subagent Installation & Usage Guide*[MADISON.MADMAN]PMDF_SNMP.PS;2+,t?./ @ 4i-50123KPWO56Y7 "ꊚG @HJ%!PS-Adobe-2.0%%Creator: VAX DOCUMENT V2.0K%%+Copyright 1986,1987,1988,1989,1990,1991 DIGITAL EQUIPMENT CORPORATION. %%+All Rights Reserved.%%DocumentFonts: (atend)%%Pages: (atend) %%EndComments*/DEC_DVC$dict where { %FIND DICTIONARY pop}{ %else /DEC_DVC$dict 300 dict def } ifelse %/BeginDVC$PSDoc { %BEGIN DOCUMENT vmstatus pop pop 0 eq {' DEC_DVC$dict begin InitializeState }{ %else< /DVC$PSJob save def DEC_DVC$dict begin InitializeState /DVC$PSF:PMDF_SNMP040.At?5[MADISON.MADMAN]PMDF_SNMP.PS;2ionts save def } ifelse} def"/EndDVC$PSDoc { %END DOCUMENT'% --- Preserving current page count --- vmstatus pop pop 0 eq { end }{ %else/ DVC$PSFonts restore end DVC$PSJob restore } ifelse} def%DEC_DVC$dict begin%5mark % CREATE ISOLatin1Encoding if not there already/ISOLatin1Encoding0 8#000 1 8#054 {StandardEncoding exch get} for  /minus0 8#056 1 8#217 {StandardEncoding exch get} for /dotlessi 0 8#301 1 8#317 {StandardEncoding exch get} for H /space /exclamdown /cent /sterling /currency /yen /brokenbar /section G /dieresis /copyright /ordfeminine /guillemotleft /logicalnot /hyphen L /registered /macron /degree /plusminus /twosuperior /threesuperior /acute E /mu /paragraph /periodcentered /cedilla /onesuperior /ordmasculine L /guillemotright /onequarter /onehalf /threequarters /questiondown /Agrave O /Aacute /Acircumflex /Atilde /Adieresis /Aring /AE /Ccedilla /Egrave /Eacute O /Ecircumflex /Edieresis /Igrave /Iacute /Icircumflex /Idieresis /Eth /Ntilde L /Ograve /Oacute /Ocircumflex /Otilde /Odieresis /multiply /Oslash /Ugrave M /Uacute /Ucircumflex /Udieresis /Yacute /Thorn /germandbls /agrave /aacute G /acircumflex /atilde /adieresis /aring /ae /ccedilla /egrave /eacute N /ecircumflex /edieresis /igrave /iacute /icircumflex /idieresis /eth /ntildeJ /ograve /oacute /ocircumflex /otilde /odieresis /divide /oslash /ugrave < /uacute /ucircumflex /udieresis /yacute /thorn /ydieresis 9 /ISOLatin1Encoding where not {25;PMDF_SNMP040.At?5[MADISON.MADMAN]PMDF_SNMP.PS;2i=6 array astore def} if cleartomark%-/DOCPSE ISOLatin1Encoding 256 array copy def "mark % CREATE DOCPSE ENCODING 8#055 /hyphenC 8#201 /bullet 8#202 /emdash 8#203 /endash 8#204 /daggerC 8#205 /daggerdbl 8#206 /registered 8#207 /trademark %8#210 /Delta? 8#211 /fi 8#212 /fl 8#213 /OE 8#214 /oe 8#215 /Ydieresis) counttomark -1 bitshift % DIVIDE BY 2: {DOCPSE 3 1 roll put} repeat % STACK NOW CONTAINS MARK cleartomark%9/reencodedict 10 dict def %Local storage for "ReENCODE"3/ReENCODE { % /basefont /newfont encoding ReENCODE7 /newencoding exch def %ARG: NAME OF ENCODING VECTORC /newfontname exch def %ARG: NEW NAME FOR FONT AFTER RE-ENCODING findfont> /basefontdict exch def %ARG: NAME OF FONT TO BE RE-ENCODED? basefontdict maxlength dict begin %CREATE AND OPEN NEW DICT= basefontdict { %COPY ENTRIES FROM BASE FONT DICT TO NEW ONE 1 index /FID ne {5 def %IF NOT THE ONE WE'RE ENCODING, JUST COPY PTRS } { %else: pop pop %IGNORE FID AND ENCODING FOR ONE WE'RE ENCODING } ifelse } forall, /FontName newfontname def %DEFINE NEW NAME 6 /Encoding newencoding def %DEFINE NEW ENCODING VECTOR; newfontname currentdict definefont %TURN IT INTO A PS FONT3 pop %IGNORE MODIFIED DICT RETURNED BY DEFINEFONT end} def%/cvsstr 64 string def/tempmatrix matrix def%/BP { % BEGIN PAGE /Magnification exch def /Colorsused 0 def /processcolor false def /RVmatrix <PMDF_SNMP040.At?5[MADISON.MADMAN]PMDF_SNMP.PS;2imatrix def /DVC$PSPage save def} def%*/EP {DVC$PSPage restore} def % END PAGE%5/XP { % EXIT PAGE (TEMPORARILY) TO ADD FONTS/CHARSE % SAVE CURRENT POINT AND COLOR INFORMATION SO IT CAN BE RESET LATERH matrix currentmatrix aload pop currentrgbcolor Colorsused processcolor# /Xpos where {pop Xpos} {0} ifelse# /Ypos where {pop Ypos} {0} ifelse9 /currentpoint cvx stopped {0 0 moveto currentpoint} if / /DVC$PSPage where {pop DVC$PSPage restore} if moveto /Ypos exch def /Xpos exch def9 /processcolor exch def /Colorsused exch def setrgbcolor matrix astore setmatrix} def%-/RP {/DVC$PSPage save def} def % RESUME PAGE%A/PF {GlobalMode LocalMode} def % PURGE FONTS TO RECLAIM MEMORY%@/GlobalMode { % SWITCH TO BASE SAVE/RESTORE LEVEL, SAVING STATEK /DEC$EDMS_SEPARATE_COLORS where{pop DEC$EDMS_SEPARATE_COLORS}{9999}ifelse! RVmatrix aload pop processcolorC PortraitMode PaperWidth PaperHeight PxlResolution Resolution I Magnification Ymax Xorigin Yorigin RasterScaleFactor0 % SAVE CURRENTPOINT INFORMATION TO RESET LATER9 /currentpoint cvx stopped {0 0 moveto currentpoint} if / /DVC$PSPage where {pop DVC$PSPage restore} if# DVC$PSFonts restore RecoverState} def%2/RecoverState { % PRESERVE STATE AT BASE LEVEL 20 copyL /Ypos exch def /Xpos exch def /RasterScaleFactor exch def? /Yorigin exch def /Xorigin exch def /Ymax exch defH /Magnification exch def /Resolution e=PMDF_SNMP040.At?5[MADISON.MADMAN]PMDF_SNMP.PS;2iv xch def /PxlResolution exch defG /PaperHeight exch def /PaperWidth exch def /PortraitMode exch def< /processcolor exch def matrix astore /RVmatrix exch def< dup 9999 ne{/DEC$EDMS_SEPARATE_COLORS exch def}{pop}ifelse DoInitialScaling RVmatrix concat3 PortraitMode not {PaperWidth 0 SetupLandscape} if Xpos Ypos moveto} def%B/InitializeState { % INITIALIZE STATE VARIABLES TO DEFAULT VALUES. /Resolution 3600 def /PxlResolution 300 def5 /RasterScaleFactor PxlResolution Resolution div def /PortraitMode true def9 /Magnification 1000 def /Xorigin 0 def /Yorigin 0 defC /Xpos 0 def /Ypos 0 def /InitialMatrix matrix currentmatrix defB /Colorsused 0 def /processcolor false def /RVmatrix matrix def} def%D/LocalMode { % SWITCH FROM BASE SAVE/RESTORE LEVEL, RESTORING STATE= /Ypos exch def /Xpos exch def /RasterScaleFactor exch def6 /Yorigin exch def /Xorigin exch def /Ymax exch defH /Magnification exch def /Resolution exch def /PxlResolution exch defE /PaperHeight exch def /PaperWidth exch def /PortraitMode exch def: /processcolor exch def matrix astore /RVmatrix exch def< dup 9999 ne{/DEC$EDMS_SEPARATE_COLORS exch def}{pop}ifelse DoInitialScaling RVmatrix concat3 PortraitMode not {PaperWidth 0 SetupLandscape} if Xpos Ypos moveto- /DVC$PSFonts save def /DVC$PSPage save def} def% % ABBREVIATIONS /S /show load def/SV /save load def/RST /restore load def/Yadjust {Ymax exch sub} def%C/SXY { % (x,y) PO>PMDF_SNMP040.At?5[MADISON.MADMAN]PMDF_SNMP.PS;2ilSITION ABSOLUTE, JUST SET Xpos & Ypos, DON'T MOVE( Yadjust /Ypos exch def /Xpos exch def} def%$/XY { % (x,y) POSITION ABSOLUTE7 Yadjust 2 copy /Ypos exch def /Xpos exch def moveto} def%#/X { % (x,0) POSITION ABSOLUTEF currentpoint exch pop 2 copy /Ypos exch def /Xpos exch def moveto} def%$/Y { % (0,y) POSITION ABSOLUTE ' currentpoint pop exch Yadjust 2 copy' /Ypos exch def /Xpos exch def moveto} def%$/xy { % (x,y) POSITION RELATIVE9 neg rmoveto currentpoint /Ypos exch def /Xpos exch def} def%#/x { % (x,0) POSITION RELATIVE7 0 rmoveto currentpoint /Ypos exch def /Xpos exch def} def%#/y { % (0,y) POSITION RELATIVE@ 0 exch neg rmoveto currentpoint /Ypos exch def /Xpos exch def} def%/R { % DRAW A RULE$ /ht exch def /wd exch def gsave % 0 setgray currentpoint newpath moveto 0 ht rlineto wd 0 rlineto$ 0 ht neg rlineto wd neg 0 rlineto( closepath fill grestore wd 0 rmoveto, currentpoint /Ypos exch def /Xpos exch def} def%D/RES { % RES/ /Resolution exch def /PxlResolution exch def5 /RasterScaleFactor PxlResolution Resolution div def DoInitialScaling} def%,/DoInitialScaling { % DO INITIAL SCALING6 InitialMatrix setmatrix 72 Resolution div dup scale} def%2/PM { % PM XP/ /PaperWidth exch def /PaperHeight exch def0 /Ymax PaperHeight ?PMDF_SNMP040.At?5[MADISON.MADMAN]PMDF_SNMP.PS;2iOdef /PortraitMode true def DoInitialScaling RP} def %*/SetupLandscape {translate 90 rotate} def3/LM { % LM  XP/ /PaperWidth exch def /PaperHeight exch def1 /Ymax PaperWidth def /PortraitMode false def0 DoInitialScaling PaperWidth 0 SetupLandscape RP} def %*/MAG { % CHANGE MAGNIFICATION SETTING! XP /Magnification exch def RP} def%8/SPB { % SPB - BEGIN "\SPECIAL" MODE- Yadjust /Yorigin exch def /Xorigin exch def currentrgbcolor Colorsused& GlobalMode Xorigin Yorigin translate9 Resolution 72 div dup scale % RESTORE DEFAULT SCALINGB Magnification 1000 div dup scale % ADJUST FOR ANY MAGNIFICATIONA /Xpos Xpos 72 Resolution div mul 1000 Magnification div mul defA /Ypos Ypos 72 Resolution div mul 1000 Magnification div mul defG /spsavobj save def %SAVE STATE & STACK DEPTH FOR CLEANUP AFTER FIGUREG /showpage {} def %DISABLE DURING FIGURE; `RESTORE' WILL BLOW DEF AWAY> /DEC$EDMS_SEPARATE_COLORS where % if separating colors. { % thenC pop processcolor % if using process colors0 { % thenE DEC$EDMS_SEPARATE_COLORS 0 ge % if on color pass .ge. 02 { % then@ { pop 1 } settransfer % write only white2 }{ % else" /DEC$EDMS_TRAP_SWELL whe@PMDF_SNMP040.At?5[MADISON.MADMAN]PMDF_SNMP.PS;2ire, { pop DEC$EDMS_SEPARATE_COLORS -4 eq5 { /EDMS_setlinewidth /setlinewidth load defK /setlinewidth { DEC$EDMS_TRAP_SWELL mul EDMS_setlinewidth } def } if } ifE /EDMS_setrgbcolor % set up for a redefineK /setrgbcolor load def % of the setrgbcolor operatorK currentscreen % get the current screen parametersF /DEC$EDMS_SCREEN_ANGLE where % if changing the screen angle. { % thenA pop exch pop % replace the old angle< DEC$EDMS_SCREEN_ANGLE exch % with the new one } ifJ /DEC$EDMS_SCREEN_FREQ where % if changing the screen frequency. { % thenE pop 3 -1 roll pop % replace the old frequency< DEC$EDMS_SCREEN_FREQ 3 1 roll % with the new one } if@ setscreen % Set the new parameters /setrgbcolor { /b exch def /g exch def /r exch def /c3 1 r sub def /m3 1 g sub def /y3 1 b sub defM /k c3 m3 2 copy gt { exch } if pop y3 2 copy gt { exch } if pop def /ik 1 k sub def ik 0 ne# { /c4 c3 k sub ik div def# /m4