9.9 LanBoard Object

Represents a network board on the NetWare server.

NOTE: All LanBoard properties are read-only.

9.9.1 Address property

Returns the node address of the network board.

Syntax

object.Address

Type

String.

Attributes

Read-only.

Example

This example returns the node address of the network board.

’Find the first LAN board and print its information 
set srv = createobject ("ucx:Server") 
set boards = srv.lanboards 
set board = boards.Element(1) 
     print ("Address: "&board.Address)

9.9.2 CardId property

Contains a number assigned to the network board by the Independent Manufacturer Support Program (IMSP).

Syntax

object.CardId

Type

Integer.

Attributes

Read-only.

Remarks

The IMSP assigns strings for the frame type.

Example

This example contains a number assigned to the network board by the Independent Manufacturer Support Program (IMSP).

’Find the first LAN board and print its information 
set srv = createobject ("ucx:Server") 
set boards = srv.lanboards 
set board = boards.Element(1) 
     print ("Card identifier: "&board.CardId)

9.9.3 FullName property

Returns the full name of the network board. For example, "NE2000 ETHERNET Driver."

Syntax

object.FullName

Type

String.

Attributes

Read-only.

Example

This example returns the full name of the network board.

’Find the first LAN board and print its information 
set srv = createobject ("ucx:Server") 
set boards = srv.lanboards 
set board = boards.Element(1) 
     print ("Full name: "&board.FullName)

9.9.4 Instance property

Contains the number of the physical boards the logical board is using.

Syntax

object.Instance

Type

Integer.

Attributes

Read-only.

Remarks

If a driver is driving one physical board, all the logical boards using this board would have a value of 1 in this field. If a second physical board is added, all the logical boards using the second physical board would have a value of 2 in this field.

Example

This example contains the number of the physical boards that the logical board is using.

’Find the first LAN board and print its information 
set srv = createobject ("ucx:Server") 
set boards = srv.lanboards 
set board = boards.Element(1) 
     print ("Number of the physical card: "&board.Number)

9.9.5 LogicalName property

Returns the logical name of the network board. A board's logical name is specified during load time.

Syntax

object.LogicalName

Type

String.

Attributes

Read-only.

Example

This example returns the logical name of the network board.

’Find the first LAN board and print its information 
set srv = createobject ("ucx:Server") 
set boards = srv.lanboards 
set board = boards.Element(1) 
     print ("Logical name: "&board.LogicalName)

9.9.6 MaxRecvSize property

Contains the maximum packet size, in bytes, a protocol stack can send or receive using this network board.

Syntax

object.MaxRecvSize

Type

Integer.

Attributes

Read-only.

Example

This example contains the maximum send or receive packet size (in bytes) that the network board can transmit or receive.

’Find the first LAN board and print its information 
set srv = createobject ("ucx:Server") 
set boards = srv.lanboards 
set board = boards.Element(1) 
     print ("Maximum receive size: "&board.MaxRecvSize)

9.9.7 MaxSize property

Contains the maximum send or receive packet size, in bytes, that the network board can transmit or receive.

Syntax

object.MaxSize

Type

Integer.

Attributes

Read-only.

Example

This example contains the maximum send or receive packet size (in bytes) that the network board can transmit or receive.

’Find the first LAN board and print its information 
set srv = createobject ("ucx:Server") 
set boards = srv.lanboards 
set board = boards.Element(1) 
     print ("Maximum packet size: "&board.MaxSize)

9.9.8 MediaId property

Contains a number that identifies the link-level envelope (frame ID).

Syntax

object.MediaId

Type

Integer.

Attributes

Read-only.

Example

This example contains a number that identifies the link-level envelope (frame ID).

’Find the first LAN board and print its information 
set srv = createobject ("ucx:Server") 
set boards = srv.lanboards 
set board = boards.Element(1) 
     print ("Media identifier: "&board.MediaId)

9.9.9 MediaType property

Contains a pointer to a length-preceded, zero-terminated string that describes the frame type of the Multiple Link Interface Driver (MLID) software. For example,“ETHERNET_802.3”.

Syntax

object.MediaType

Type

String.

Attributes

Read-only.

Example

This example contains a pointer to a length-preceded, zero-terminated string that describes the frame type of the Multiple Link Interface Driver (MLID) software.

’Find the first LAN board and print its information 
set srv = createobject ("ucx:Server") 
set boards = srv.lanboards 
set board = boards.Element(1) 
     print ("Media type: "&board.MediaType)

9.9.10 ModeFlags property

This property gives the modes supported by the LAN driver.

Syntax

object.ModeFlags

Type

Integer. See Remarks below.

Attributes

Read-only.

Remarks

Each bit of this integer represents a value. The value of nth bit can be extracted by using following formula:X = ModeFlags / (2^n)NthBitValue = X mod 2

See Section A.19, ModeFlag Bits.

Example

This example gives the modes supported by the LAN driver.

’Find the first LAN board and print its information 
set srv = createobject ("ucx:Server") 
set boards = srv.lanboards 
set board = boards.Element(1) 
     print ("Supported mode flags: "&board.ModeFlags)

9.9.11 Number property

Returns the logical board number assigned to the network board by the LSL (Link Support Layer software). The value is 0-255.

Syntax

object.Number

Type

Integer.

Attributes

Read-only.

Example

This example gives the logical board number assigned to the network board.

’Find the first LAN board and print its information 
set srv = createobject ("ucx:Server") 
set boards = srv.lanboards 
set board = boards.Element(1)
     print ("Logical board number: "&board.Number)

See Also

9.9.12 PrimaryDMA property

Returns a value of 1 if primary DMA is used by the network board.

Syntax

object.PrimaryDMA

Type

String.

Attributes

Read-only.

Remarks

This property is not used if the return value is FF.

If the network board does not use a primary DMA, this property returns 0.

Example

This example returns a value of 1 if primary DMA is used by the network board. Else returns 0.

’Find the first LAN board and print its information 
set srv = createobject ("ucx:Server") 
set boards = srv.lanboards 
set board = boards.Element(1) 
     print ("Primary DMA: "&board.primaryDMA)

9.9.13 PrimaryInterrupt property

Returns the network board's primary interrupt number.

Syntax

object.PrimaryInterrupt

Type

String.

Attributes

Read-only.

Remarks

This property is not used if the return value is FF.

Example

This example returns the primary interrupt number.

’Find the first LAN board and print its information 
set srv = createobject ("ucx:Server") 
set boards = srv.lanboards 
set board = boards.Element(1) 
     print ("Primary interrupt: "&board.primaryinterrupt)

9.9.14 ReceiveSize property

Contains the maximum packet size (or best size), in bytes, that the network board can receive.

Syntax

object.ReceiveSize

Type

Integer.

Attributes

Read-only.

Example

This example contains the maximum packet size (or best size), in bytes, that the network board can receive.

’Find the first LAN board and print its information 
set srv = createobject ("ucx:Server") 
set boards = srv.lanboards 
set board = boards.Element(1) 
   print ("Maximum receive size: "&board.Receive)

9.9.15 SecondaryDMA property

Returns a value of 1 if a secondary DMA is used by the network board.

Syntax

object.SecondaryDMA

Type

String.

Attributes

Read-only.

Remarks

This property is not used if the return value is FF.

If the network board does not use a secondary DMA, this property returns 0.

Example

This example returns a value of 1 if secondary DMA is used by the network board. Otherwise, 0.

’Find the first LAN board and print its information 
set srv = createobject ("ucx:Server") 
set boards = srv.lanboards 
set board = boards.Element(1) 
     print ("Secondary DMA: "&board.secondaryDMA)

9.9.16 SecondaryInterrupt property

Returns the secondary interrupt number.

Syntax

object.SecondaryInterrupt

Type

String.

Attributes

Read-only.

Remarks

This property is not used if the return value is FF.

Example

This example returns the secondary interrupt number.

’Find the first LAN board and print its information 
set srv = createobject ("ucx:Server") 
set boards = srv.lanboards 
set board = boards.Element(1) 
     print ("Secondary interrupt: "&board.secondaryinterrupt)

9.9.17 ShortName property

Returns the short name of the network board. Short names are eight characters or less.

Syntax

object.ShortName

Type

String.

Attributes

Read-only.

Example

This example returns the short name of the network board.

’Find the first LAN board and print its information 
set srv = createobject ("ucx:Server") 
set boards = srv.lanboards 
set board = boards.Element(1) 
     print ("Short name: "&board.ShortName)

9.9.18 Slot property

Contains the slot number where the network board is installed if the board is running in an MCA or EISA machine. Otherwise, this field is 0.

Syntax

object.Slot

Type

String.

Attributes

Read-only.

Example

This example the slot number where the network board is installed if the board is running in an MCA or EISA machine. Otherwise, this field is 0.

’Find the first LAN board and print its information 
set srv = createobject ("ucx:Server") 
set boards = srv.lanboards 
set board = boards.Element(1) 
     print ("Board slot: "&board.slot)

9.9.19 VersionMajor property

Gives the Novell-defined major version number of the configuration table.

Syntax

object.VersionMajor

Type

String.

Attributes

Read-only.

Example

This example gives the Novell-defined major version number of the configuration table.

’Find the first LAN board and print its information 
set srv = createobject ("ucx:Server") 
set boards = srv.lanboards 
set board = boards.Element(1) 
     print ("Major version number: "&board.VersionMajor)

9.9.20 VersionMinor property

Gives the Novell-defined minor version number of the configuration table.

Syntax

object.VersionMinor

Type

String.

Attributes

Read-only.

Example

This example gives the Novell-defined minor version number of the configuration table.

’Find the first LAN board and print its information 
set srv = createobject ("ucx:Server") 
set boards = srv.lanboards 
set board = boards.Element(1) 
     print ("Minor version number: "&board.VersionMinor)