sas
Test

Defines a specific type of assurance test bound to managed object. The managed object is a specific object to test (eg LSP Ping against an LSP).



public abstract class Test

Properties
accountingFiles Specifies whether this test uses SAA Accounting

type=boolean
default=false

accountingPolicyObjectPointer

type=Pointer
access=read-only
default=

aggregatedWith Specifies if/how the test is aggregated with others tests.

type=sas.AggregationType
access=read-only
default=none
Displayed(tab/group)=Aggregated With (Test Suite)

applicationId Specifies which application created this test.

type=string
access=read-create
default=NFM-P
maximum=20

continuousExec This value specifies whether or not the OAM NE Schedulable test is to be executed indefinitely.

type=boolean
default=false

continuously Specifies whether this test is currently being continuously executed by the node.

type=boolean
access=read-only
default=false

executionState Specifies the desired execution state of this test. This value is set automatically using the sas.AbstractTest.execute method.

type=sas.ExecutionState
access=read-only
default=notRunning

fromNodeId The STM test originates from the site specified in this property.

type=string
access=read-only
default=0.0.0.0
maximum=50

lastGeneratedTime Date (time from January 1st, 1970) when this test was last generated. This attribute has value only when this test is bound to a Test Suite.

type=Date
access=read-only
default=0
Displayed(tab/group)=Last Generated (Test Suite)

neDeployedTest The deployed NE test that remains on the node. The sas.DeployedTest is created as a side-effect of enabling the sas.est.neSchedulable flag.

type=Pointer
access=read-only
default=

nePersistent Used to make this test NE persistent. An NE persistent test is installed onto the node after its first execution

type=boolean
access=read-create
default=false

neSchedulable Used to make this test NE schedulable. An NE schedulable test is immediately installed onto the node, and may use the node's CRON feature to schedule its executions.

type=boolean
access=read-create
default=false
Displayed(tab/group)=NE Schedulable

neSchedulableDeployedTest The deployed NE schedulable test. The sas.DeployedTest is created as a side-effect of enabling the sas.Test.neSchedulable flag.

type=Pointer
access=read-only
default=

neSchedulableTest The NE schedulable test. The sas.NeSchedulableTest is created as a side-effect of enabling the sas.Test.neSchedulable flag.

type=Pointer
access=read-only
default=

nmUser The pointer to the NFM-P user that created the test.

type=Pointer
access=read-only
default=

oneTimeValidate Indicates that the related test suite is a one time validation test suite.

type=boolean
access=read-only
default=false

probeHistory The value of probeHistory indicates whether or not per-probe history will be kept for this test.

type=sas.ProbeHistoryType
default=auto
Displayed(tab/group)=Probe History (Test Parameters/Execution Details)

publishTopic Specifies whether this test should publish results/alarms to Kafka.

type=boolean
default=false

sas.NmThresholdEvent-Set type=Children-Set
suppressAccounting The value of tmnxOamSaaCtlSuppressAccounting specifies whether or not the updating of accounting files is suppressed. The value of 'true (1)' is applicable only when an accounting policy has been specified by tmnxOamSaaCtlAcctPolicyId.

type=boolean
access=read-only
default=false

targetIp The STM test target site specified in this property.

type=string
access=read-only
default=
maximum=50

testDefinition The pointer to the sas.TestDefinition, if any, that this test was created from. Only applicable when aggregatedWith is "testSuite".

type=Pointer
access=read-only
default=
Displayed(tab/group)=Test Definition (Test Suite)

testPolicyUsage The pointer to the sas.TestPolicyUsage, if any, that this test was created from. Only applicable when aggregatedWith is "testSuite".

type=Pointer
access=read-only
default=
Displayed(tab/group)=Test Policy (Test Suite)

testResultStorage This value specifies whether or not the OAM NE Schedulable test results are to be logged to a file, stored in the DB, or both

type=sas.TestResultStorageEnum
default=logToDB

testSuite The pointer to the sas.TestSuite, if any, that owns this test. Only applicable when aggregatedWith is "testSuite".

type=Pointer
access=read-only
default=
Displayed(tab/group)=Test Suite (Test Suite)

testSuiteId The test suite ID. A value of 0 means no associated test suite.

type=long
access=read-only
default=0

testSuiteTestedEntity The pointer to the sas.TestedEntity, if any, that is associated to this object. Only applicable when aggregatedWith is "testSuiteGenerated".

type=Pointer
access=read-only
default=
Displayed(tab/group)=Tested Entity (Test Suite)

testType

type=sas.TestType
access=read-only
default=ping

testedEntityName Displays the service name of the tested entity

type=string
access=read-only
default=
Displayed(tab/group)=Originating Tested Entity

testedObject The managed object being tested.

type=Pointer
access=read-only
default=

 
Overridden Properties
id The identifier for the STM test.

maximum=99999999

weight Specifies the relative load that execution of this test affects the server.

default=10

 
Properties inherited from sas.AbstractTest
administrativeState, description, displayedName, failures, globalId, id, lastRunResult, runs, weight
 
Properties inherited from ManagedObject
actionMask, children-Set, deploymentState, isFaultSquelched, name, objectFullName, selfAlarmed
 
Methods

adhocExecuteAndWait

Creates and executes a new STM test. This method waits until the test is complete and all results are retrieved before returning from the network.
Input Parameters:
deployer : Deployer - the deployment state
synchronousDeploy : boolean - (Optional) Specify whether to block until the changes have been fully deployed to the network. A value of "true" means to block. A value of "false" means to return immediately. Default: false (asynchronous)
clearOnDeployFailure : boolean - (Optional) Specify whether to clear any failed deployers. A value of "true" means to clear. A value of "false" means to leave the failed deployer. Default: false
deployRetries : int - (Optional) The number of times to attempt re-deployment during synchronous deployment. This parameter is meaningless in the asynchronous case. Default: 0
deployRetryInterval : long - (Optional) The number of milliseconds to wait between deployment retries. This parameter is meaningless in the asynchronous case. Default: 0
taskDescription : string - (Optional) A user friendly description of what the operation does. This information will be used by the task manager.
testedObject : Pointer - The object under test or system Address of your node.
test : config(sas.Test) - The test parameters to execute.
timeout : long - The number of milliseconds to wait before receiving the results. If no results are received in the given time, the method returns.
keepTest : boolean - Setting this parameter to false means that any test created for the purposes of execution will be deleted after the results are received from the network.
resultFilter : ResultFilter - (Optional) Filter for narrowing down the information returned per object
continueOnFailure : continueOnFailure - (Optional) Continue processing requests in this stream if an exception occurs, unless the request is invalid. Default: false
Output Parameters:
result : sas.TestResult - The final result of the test execution.
Exceptions:
sas.Test.adhocExecuteAndWaitException

executeAndWait

Immediately starts running an already existing STM test. This method waits until the test is complete and all results are retrieved before returning from the network.
Input Parameters:
deployer : Deployer - the deployment state
synchronousDeploy : boolean - (Optional) Specify whether to block until the changes have been fully deployed to the network. A value of "true" means to block. A value of "false" means to return immediately. Default: false (asynchronous)
clearOnDeployFailure : boolean - (Optional) Specify whether to clear any failed deployers. A value of "true" means to clear. A value of "false" means to leave the failed deployer. Default: false
deployRetries : int - (Optional) The number of times to attempt re-deployment during synchronous deployment. This parameter is meaningless in the asynchronous case. Default: 0
deployRetryInterval : long - (Optional) The number of milliseconds to wait between deployment retries. This parameter is meaningless in the asynchronous case. Default: 0
taskDescription : string - (Optional) A user friendly description of what the operation does. This information will be used by the task manager.
instanceFullName : string - the full name of the object.
timeout : long - The number of milliseconds to wait before receiving the results. If no results are received in the given time, the method returns.
resultFilter : ResultFilter - (Optional) Filter for narrowing down the information returned per object
continueOnFailure : continueOnFailure - (Optional) Continue processing requests in this stream if an exception occurs, unless the request is invalid. Default: false
Output Parameters:
result : sas.TestResult - The final result of the test execution.
Exceptions:
sas.Test.executeAndWaitException

setNeSchedulableAdminState

Starts/Stops Ne Schedulable tests
Input Parameters:
deployer : Deployer - the deployment state
synchronousDeploy : boolean - (Optional) Specify whether to block until the changes have been fully deployed to the network. A value of "true" means to block. A value of "false" means to return immediately. Default: false (asynchronous)
clearOnDeployFailure : boolean - (Optional) Specify whether to clear any failed deployers. A value of "true" means to clear. A value of "false" means to leave the failed deployer. Default: false
deployRetries : int - (Optional) The number of times to attempt re-deployment during synchronous deployment. This parameter is meaningless in the asynchronous case. Default: 0
deployRetryInterval : long - (Optional) The number of milliseconds to wait between deployment retries. This parameter is meaningless in the asynchronous case. Default: 0
taskDescription : string - (Optional) A user friendly description of what the operation does. This information will be used by the task manager.
instanceFullName : string - the full name of the object.
aInValue : int -
continueOnFailure : continueOnFailure - (Optional) Continue processing requests in this stream if an exception occurs, unless the request is invalid. Default: false
Methods inherited from sas.AbstractTest
execute, stop
 
Supported Network Elements
7450 ESS
7210 SAS M
7210 SAS X
7210 SAS E
7210 SAS D
7210 SAS K
7210 SAS T
7210 SAS Mxp
7210 SAS Dxp
7210 SAS S/Sx
7210 SAS R
7250 IXR
7750 SR
7705 SAR Gen 2
7705 SAR Hm
7705 SAR
7705 SAR H
OS6850/6850E
OS6855
OS6400
OS6250
OS6450
OS9700E/9800E
DC VSC
DC 7850
DC 210
DC VSA8
7950 XRS
OS6900 Supported from 7.3.1
OS6860E/OS6860N
OS6870
OS6865
OS6560/OS6560E
OS6570M
Wavence SM
OS6465
OS6360
Product Specifics
7210 SAS D 20.0.0
7210 SAS D 21.0.0
7210 SAS D 22.0.0
7210 SAS D 23.0.0
7210 SAS D 24.0.0
7210 SAS D 25.0.0
7210 SAS Dxp 20.0
7210 SAS Dxp 21.0
7210 SAS Dxp 22.0
7210 SAS Dxp 23.0
7210 SAS Dxp 24.0
7210 SAS Dxp 25.0
7210 SAS K 20.0
7210 SAS K 21.0
7210 SAS K 22.0
7210 SAS K 23.0
7210 SAS K 24.0
7210 SAS K 25.0
7210 SAS M 20.0
7210 SAS M 21.0
7210 SAS Mxp 20.0
7210 SAS Mxp 21.0
7210 SAS Mxp 22.0
7210 SAS Mxp 23.0
7210 SAS Mxp 24.0
7210 SAS Mxp 25.0
7210 SAS R 20.0
7210 SAS R 21.0
7210 SAS R 22.0
7210 SAS R 23.0
7210 SAS R 24.0
7210 SAS R 25.0
7210 SAS S/Sx 20.0
7210 SAS S/Sx 21.0
7210 SAS S/Sx 22.0
7210 SAS S/Sx 23.0
7210 SAS S/Sx 24.0
7210 SAS S/Sx 25.0
7210 SAS T 20.0
7210 SAS T 21.0
7210 SAS T 22.0
7210 SAS T 23.0
7210 SAS T 24.0
7210 SAS T 25.0
7705 SAR H 20.0
7705 SAR H 21.0
7705 SAR H 22.0
7705 SAR H 23.0
7705 SAR H 24.0
7705 SAR H 25.0
7705 SAR H 9.0
7705 SAR 20.0
7705 SAR 21.0
7705 SAR 22.0
7705 SAR 23.0
7705 SAR 24.0
7705 SAR 25.0
OS6250 6.6.3
OS6250 6.6.4
OS6250 6.6.5
OS6250 6.7.1
OS6360 8.10
OS6360 8.10
OS6360 8.9
OS6360 8.9
OS6400 6.4.3
OS6400 6.4.4
OS6400 6.4.5
OS6450 6.6.4
OS6450 6.6.5
OS6450 6.7.1
OS6450 6.7.2
OS6465 8.10
OS6465 8.10
OS6465 8.6
OS6465 8.7
OS6465 8.8
OS6465 8.8
OS6465 8.9
OS6465 8.9
OS6465 8.9
OS6560/OS6560E 8.10
OS6560/OS6560E 8.10
OS6560/OS6560E 8.6
OS6560/OS6560E 8.7
OS6560/OS6560E 8.8
OS6560/OS6560E 8.8
OS6560/OS6560E 8.9
OS6560/OS6560E 8.9
OS6560/OS6560E 8.9
OS6570M 8.10
OS6570M 8.10
OS6570M 8.9
OS6850/6850E 6.4.2
OS6850/6850E 6.4.3
OS6850/6850E 6.4.4
OS6850/6850E 6.4.5
OS6850/6850E 6.4.6
OS6855 6.4.4
OS6855 6.4.5
OS6855 6.4.6
OS6860E/OS6860N 8.10
OS6860E/OS6860N 8.10
OS6860E/OS6860N 8.6
OS6860E/OS6860N 8.7
OS6860E/OS6860N 8.8
OS6860E/OS6860N 8.8
OS6860E/OS6860N 8.9
OS6860E/OS6860N 8.9
OS6860E/OS6860N 8.9
OS6865 8.10
OS6865 8.10
OS6865 8.6
OS6865 8.7
OS6865 8.8
OS6865 8.8
OS6865 8.9
OS6865 8.9
OS6865 8.9
OS6870 8.10
OS6900 8.10
OS6900 8.10
OS6900 8.6
OS6900 8.7
OS6900 8.8
OS6900 8.8
OS6900 8.9
OS6900 8.9
OS6900 8.9
OS9700E/9800E 6.4.3
OS9700E/9800E 6.4.4
OS9700E/9800E 6.4.5
OS9700E/9800E 6.4.6