Hostlist :: Metavariables


Hosts in hostlist - objects which can contain any variables with free names. All information about hosts, except name and IP address, NetView keeps in such variables. Some these variable used to keep host's adjustments, some others - additional information about hosts. You can specify metavariables to be displayed as columns in detailed view mode. Direct access to this variables you can get from scripts, plugins or other programs via nvapi.dll, wich can be dound in system directore after installation of NetView. Here is incomplete list of some metavariables, which are used by NetView:

map

Hostlist name where host will be displayed.

addtm

When host was added to hostlist. F.e. "20:34.07 2002/12/02"

lchtm

Time and date when host stated was changed last time

left

X host's position on visual map [int]

top

Y host's position on visual map [int]

pipo Individual specified recheck method. 0 -by ping, 1 -port scan, 2 -port scan, if no ports found - ping. Used when bit flag 0x20 is set in metavariable "flags"

stport

Individual specified port list in format port1;port2;...portN - up to 8 ports. Used when bit flag 0x20 is set in metavariable "flags"

scan

List of opened ports found during last recheck scan. In format port1;port2;...portN

stpdel

Individual specified timeout when checking by ping. Used when bit flag 0x20 is set in metavariable "flags"

wgrp

Workgroup or domain

sdesc

Host's self comment

cdesc

User specified comment

ison

Host's state. Can be "on","off","?"

route

Route to the host in format "IP1|hostname1/IP2|hostname2/.../IPend|hostnameend/"

image

bmp or gif image to display on Visual map when host is online

ofimg

bmp or gif image to display on Visual map when host is offline

ctime This is displayed in Connection column
dwlnk Hosts list to be used as linked to this (when bit 0 in flags is off) In format - хост1|хост2|хост3|...|хостN| - you can specify here both hostnames or IPs.After changing this metavariable (or after changing many such variables of different host) in order to apply changes you shoud use NMPN_ACTION with flag NVACTION_SETSTATE - after this dependencies will be rethinked and stored to the downlnk и uplnk metavariables (don't change this variables manually)

flags

Bit mask with different host's adjustments. [DWORD]: 
$1 - Enable host recheck
$2 - Enable linking host position to visual map grid
$4 - Enable lines nodes linking when dragging directly this host
$8 - Enable alert when host goes Online
$10 - Enable alert when host goes Offline
$20 - Use individual recheck settings instead of global
$40 - Open command stored in "opcmd" by doubleclick
$80 -  Dynamic IP option is enabled
$100 - Static entry option is enabled
$200 - NETBIOS is disabled
$400 - FTP Active mode is enabled
$800 - Host is visible only in Visual map/plan view modes
$1000 -FTP Passive mode is enabled

© 2001-2004 Killer{R}   © 2003 VoVaN