9.16 ParamObject Object

Holds the various attributes and its values for a server-settable parameter. Only the Value property can be modified.

9.16.1 Advanced property

Determines if the parameter is an advanced command.

Syntax

object.Advanced

Type

Boolean. Returns TRUE if the parameter is an advanced command; otherwise, FALSE.

Attributes

Read-only.

Example

This example returns TRUE if the parameter is an advanced command; otherwise, FALSE.

set srv = CreateObject("ucx:Server") 
set srvparams = srvr.Params 
set paramObj = Srvparams.Get ("TimeSync Add Time Source") 
     print("Is Advanced " & paramObj.Advanced)

9.16.2 Category property

Returns the category number of the settable parameter.

Syntax

object.Category

Type

Integer. See Remarks below for a list of possible values.

Attributes

Read-only.

Remarks

Category Values:

0

Communications

1

Memory

2

File cache

3

Dir cache

4

File system

5

Locking

6

TTS

7

Disk

8

Time

9

NCP

10

Miscellaneous

Example

This example returns the category number of the settable parameter.

set srv = CreateObject("ucx:Server") 
set srvparams = srvr.Params 
set paramObj = Srvparams.Get ("TimeSync Add Time Source") 
     print("Category number is " & paramObj.Category)

9.16.3 Description property

Returns the description of the settable parameter.

Syntax

object.Description

Type

String.

Attributes

Read-only.

Example

This example returns the description of the settable parameter.

set srv = CreateObject("ucx:Server") 
set srvparams = srvr.Params 
set paramObj = Srvparams.Get ("TimeSync Add Time Source") 
     print("Description is " & paramObj.Description)

9.16.4 Internal property

Determines whether or not the parameter is internal.

Syntax

object.Internal

Type

Boolean. Returns TRUE if the parameter is internal; otherwise, FALSE.

Attributes

Read-only.

Remarks

These parameters are not typically set by a system administrator. Servman.nlm and the console command SET do not display internal commands. They are intended for use by the developers of the OS and/or components that add them.

Example

This example returns TRUE if the parameter is internal; otherwise, FALSE.

set srv = CreateObject("ucx:Server") 
set srvparams = srvr.Params 
set paramObj = Srvparams.Get ("TimeSync Add Time Source") 
     print("Is Internal " & paramObj.Internal)

9.16.5 LowerLimit property

Defines the lower limit for the settable parameter, if present.

Syntax

object.LowerLimit

Type

Long.

Attributes

Read-only.

Remarks

If the data type is Time Ticks, it represents time in ticks.

Example

This example defines the lower limit for the settable parameter.

set srv = CreateObject("ucx:Server") 
set srvparams = srvr.Params 
set paramObj = Srvparams.Get ("TimeSync Add Time Source") 
     print("Lower limit is " & paramObj.LowerLimit)

9.16.6 Name property

Returns the settable parameter.

Syntax

object.Name

Type

String.

Attributes

Read-only.

Example

This example returns the settable parameter.

set srv = CreateObject("ucx:Server") 
set srvparams = srvr.Params 
set paramObj = Srvparams.Get ("TimeSync Add Time Source") 
     print("Name is " & paramObj.Name)

9.16.7 Nflags property

Defines the properties of the Parameter object, such as when it can be set.

Syntax

object.Nflags

Type

Integer.

Attributes

Read-only.

Remarks

All Boolean properties in this object are based on the value of this property.

Possible Integer values are:

0001

Startup only.

0004

Advanced parameter.

0008

Startup or later.

0016

Not secured console. (The parameter cannot be set if the console is secured.)

Example

This example defines the properties of the Parameter object, such as when it can be set.

set srv = CreateObject("ucx:Server") 
set srvparams = srvr.Params 
set paramObj = Srvparams.Get ("TimeSync Add Time Source") 
     print("Flags is " & paramObj.Nflags)

9.16.8 Nonsecure property

Determines whether or not the parameter can be changed when the console is secure.

Syntax

object.Nonsecure

Type

Boolean. Returns TRUE if the parameter can be changed when the console is secure; otherwise, FALSE.

Attributes

Read-only.

Example

This example returns TRUE if the parameter can be changed when the console is secure; otherwise, FALSE.

set srv = CreateObject("ucx:Server") 
set srvparams = srvr.Params 
set paramObj = Srvparams.Get ("TimeSync Add Time Source") 
     print("Is Nonsecure " & paramObj.Nonsecure)

9.16.9 Sequence property

Returns the sequence number of the settable parameter.

Syntax

object.Sequence

Type

Integer.

Attributes

Read-only.

Example

This example returns the sequence number of the settable parameter.

set srv = CreateObject("ucx:Server") 
set srvparams = srvr.Params 
set paramObj = Srvparams.Get ("TimeSync Add Time Source") 
     print("Sequence number is " & paramObj.Sequence)

9.16.10 StartupOkay property

Determines whether or not the parameter can be set in startup.ncf.

Syntax

object.StartupOkay

Type

Boolean.

Attributes

Read-only.

Example

This example returns TRUE if the parameter can be set in startup.ncf.

set srv = CreateObject("ucx:Server") 
set srvparams = srvr.Params 
set paramObj = Srvparams.Get ("TimeSync Add Time Source") 
     print("Is StartupOkay " & paramObj.StartupOkay)

9.16.11 StartupOnly property

Determines whether or not the parameter can be changed only in startup.ncf.

Syntax

object.StartupOnly

Type

Boolean.

Attributes

Read-only.

Example

This example returns TRUE if the parameter can be changed only in startup.ncf.

set srv = CreateObject("ucx:Server") 
set srvparams = srvr.Params 
set paramObj = Srvparams.Get ("TimeSync Add Time Source") 
     print("Is StartupOnly " & paramObj.StartupOnly)

9.16.12 Type property

Returns the data type of the settable parameter.

Syntax

object.Type

Type

Integer.

Attributes

Read-only.

Example

This example returns the data type of the settable parameter.

set srv = CreateObject("ucx:Server") 
set srvparams = srvr.Params 
set paramObj = Srvparams.Get ("TimeSync Add Time Source") 
     print("Data type is " & paramObj.Type)

9.16.13 UpperLimit property

Defines the upper limit for the settable parameter, if present.

Syntax

object.UpperLimit

Type

Long.

Attributes

Read-only.

Remarks

If the data type is String, this property contains the maximum string length. If the data type is TimeTicks, it represents time in ticks.

Example

This example defines the upper limit for the settable parameter.

set srv = CreateObject("ucx:Server") 
set srvparams = srvr.Params 
set paramObj = Srvparams.Get ("TimeSync Add Time Source") 
     print("Upper limit is " & paramObj.UpperLimit)

9.16.14 Value property

Returns the value (of the settable ParamObject) which can be modified.

Syntax

object.Value[=NewValue As AnyType]

Type

AnyType.

Attributes

Read-only.

Remarks

NewValue is an optional parameter that represents the new value for the ParamObject. It can be an Integer or a String.

Example

This example returns the value (of the settable parameter), which can be modified.

set srv = CreateObject("ucx:Server") 
set srvparams = srvr.Params 
set paramObj = Srvparams.Get ("TimeSync Add Time Source") 
     print("Value is " & paramObj.Value)