@GetPortsList (Formula Language)

Returns a list of enabled or disabled ports.

Syntax

@GetPortsList( [ portType ] )

Parameters

[ portType ]

Keyword. Must be enclosed in brackets. Use one of the following keywords:

[ENABLED]

Returns a list of currently enabled ports.

[DISABLED]

Returns a list of currently disabled ports.

Return value

portsList

Text list. Each port name is one element of the list.

Usage

@GetPortsList is used by the Public and Personal Address books to determine the list of available ports for each Location record. You can then select a port from that list.

This function does not work in column formulas, selection formulas, or selective replication formulas.

You cannot use this @function in Web applications.

Examples

  1. This example returns Lan0;TCP;AppleTalk if those are the currently enabled ports.
    @GetPortsList([Enabled])
  2. This example returns COM1;COM2 if those are the currently disabled ports.
    @GetPortsList([Disabled])
Note: The text list uses the multi-value separator specified for the current field, or the list separator specified for the current column in a view.