Chat now with support
Chat with Support

InTrust 11.6.1 - Customization Kit

SystemInformationObject

NAME

DESCRIPTION

GetComputerName(address)

Retrieves the NetBIOS or DNS name associated with the specified computer address.

The address parameter is a NetBIOS name. If the parameter is not specified, the method works with the local computer.

GetDomainName(address)

Retrieves the domain name.

The address parameter is a NetBIOS name. If the parameter is not specified, the method works with the local computer.

GetComputerRole(address)

Retrieves the computer role.

The address parameter is a NetBIOS name. If the parameter is not specified, the method works with the local computer.

GetPlatformId(address)

Retrieves the platform ID.

The address parameter is a NetBIOS name. If the parameter is not specified, the method works with the local computer.

GetVersionMajor(address)

Retrieves the major number of the operating system version of the computer with the specified address.

The address parameter is a NetBIOS name. If the parameter is not specified, the method works with the local computer.

GetVersionMinor(address)

Retrieves the minor number of the operating system version of the computer with the specified address.

The address parameter is a NetBIOS name. If the parameter is not specified, the method works with the local computer.

GetTimeOfDayInfo(address)

Returns a TimeOfDayInfoObject object.

The address parameter is a NetBIOS name. If the parameter is not specified, the method works with the local computer.

IsLocalHost(address)

Verifies whether the specified address (or computer name) is the address of the local computer.

The address parameter is a NetBIOS name or an IP address. If the parameter is not specified, the method works with the local computer.

Example

The following script displays all available information about the "SERVER" computer.

try
{
    var si = new SystemInformationObject();
    print(si.GetComputerName("server"));
    print(si.GetDomainName("server"));
    print(si.GetPlatformId("server"));
    print(si.GetVersionMajor("server"));
    print(si.GetVersionMinor("server"));
    print(si.IsLocalHost("server"));
    
    var ti = si.GetTimeOfDayInfo("server");
    print(ti.elapsedt);
    print(ti.msecs);
    print(ti.hours);
    print(ti.mins);
    print(ti.secs);
    print(ti.hunds);
    print(ti.timezone);
    print(ti.tinterval);
    print(ti.day);
    print(ti.month);
    print(ti.year);
    print(ti.weekday);
}
catch (err)
{
    print("Error: " + err);
}

TextStream

NAME

TYPE

DESCRIPTION

Read([count])

method

Returns a single character (by default) or the specified number of characters according to the current encoding.

ReadLine()

method

Gets a line from the file.

Close()

method

Closes the file. If you do not close the file explicitly, it will be automatically closed during the next garbage collection session.

AtEndOfStream

property

Returns true if the file pointer is at the end of a TextStream file; false otherwise. Read-only.

TellG

property

Returns the number of bytes read from the stream and dispatched into the script. Not aligned to internal buffer boundary.

TimeOfDayInfoObject

NAME

DESCRIPTION

elapsedt

Specifies the number of seconds since 00:00:00, January 1, 1970, GMT.

msecs

Specifies the number of milliseconds from an arbitrary starting point (system reset).

hours

Specifies the current hour. Valid values are 0 through 23.

mins

Specifies the current minute. Valid values are 0 through 59.

secs

Specifies the current second. Valid values are 0 through 59.

hunds

Specifies the current hundredth of a second. Valid values are 0 through 99.

timezone

Specifies the time zone of the server. This value is calculated, in minutes, from Greenwich Mean Time (GMT). For time zones west of Greenwich, the value is positive; for time zones east of Greenwich, the value is negative. A value of -1 indicates that the time zone is undefined.

tinterval

Specifies the time interval for each tick of the clock. Each integral integer represents one ten-thousandth of a second (0.0001 second).

day Specifies the day of the month. Valid values are 1 through 31.

month

Specifies the month of the year. Valid values are 1 through 12.

year

Specifies the year.

weekday

Specifies the day of the week. Valid values are 0 through 6, where 0 is Sunday, 1 is Monday, and so on.

See also the example for the SystemInformationObject object.

InTrust-Specific Objects

Glossary

An InTrust organization parameter is a setting that affects some aspect of InTrust operation related to agents, jobs, licenses and so on. In InTrust Manager, these settings can be configured in the properties of the InTrust root node, an InTrust server or an agent.

A facet is a file with an agent's organization parameter settings. An agent has one facet per InTrust server; if an agent responds to multiple servers, it has multiple facets. The file is located in the config subfolder of the agent installation folder, and the file name is the GUID of the server from which the agent inherits organization parameter settings.

A facet can contain organization parameter values defined at the following three levels:

  1. Organization level, if any parameters are inherited all the way down

  2. Server level, if any parameters are defined for the InTrust server and inherited by the agent

  3. Agent level, if any parameters are defined specifically for the agent

Organization parameter settings can be read using the ADCEnvironment object. See Organization Parameter Editor for details about setting parameter values for organizations, servers and agents.

Generic Objects

Audit Script Object Model

The following objects are available to scripts in custom text log data sources. In addition, these data sources can use all objects available to custom scripted data sources.

Script Callbacks

Provider callbacks

NAME

DESCRIPTION

Audit_EnumInstances(host)

Returns a two-dimensional string array, where the nested arrays have two elements. Element [i][0] is the name of the i-th instance and element [i][1] is a display name. For Windows computers, the display name is the NetBIOS name. For Unix computers, it is the localhost name.

The host parameter can be one of the following:

  • Empty string for localhost

  • Host name

  • IP address

Audit_BeforeCollection

No return value.

Audit_Connect(instance, log)

Boolean.

Audit_Seek(position)

Boolean. A Position object is passed to this function. Audit_Seek uses the object to determine which event gathering stopped at when data was last collected.

If the precise position is found, true is returned, otherwise false is returned. If the result is false, InTrust session details will show that the position cannot be found.

Audit_CollectEvents()

Returns an object which is a collection of user-supplied properties. Performs log gathering.

Audit_AfterCollection(success)

No return value.

 

Comparer callback

NAME

DESCRIPTION

Audit_ComparePositions(p1, p2)

Returns a signed integer indicating the ordering of p1 and p2.

  • >0 if p1 > p2

  • 0 if p1 == p2

  • <0 if p1 < p2

where p1 and p2 are Position objects.

Audit Script Engine and Audit Script Host Cooperation

The audit script engine exposes a C++ interface to ECMAScript.

This interface does the following:

  • Supports the scripting object model

  • Dispatches calls between the audit script host and the scripting machine

  • Converts parameters from C++ types to scripting types and vice versa

Type conversion takes place as follows:

  • C++ type to script callback:

CONVERTED FROM

CONVERTED TO

AuditScriptEngine::EnumInstances

script::Audit_EnumInstances

AuditScriptEngine::GetDataName

script:: Audit_GetDataName

AuditScriptEngine::BeforeCollection

script:: Audit_BeforeCollection

AuditScriptEngine::Connect

script:: Audit_Connect

AuditScriptEngine::Seek

script:: Audit_Seek

AuditScriptEngine::CollectEvents

script:: Audit_CollectEvents

AuditScriptEngine::AfterCollection

script:: Audit_AfterCollection

  • Script object model to C++ type:

CONVERTED FROM

CONVERTED TO

AuditProvider::SubmitEventPositionPair

AuditScriptHost:: SubmitEventPositionPair

AuditProvider::LogMessage

AuditScriptHost::LogMessage

AuditProvider::OperationStatus

AuditScriptHost::OperationStatus

AuditProvider::Trace

AuditScriptHost::Trace

Audit Script Position Processor and Audit Script Host Cooperation

Audit script position processor is a middle layer between Audit script host and position comparer script. Audit script position processor should dispatch calls from AuditScriptPositionProcessor::ComparePositions to the script's Audit_ComparePositions callback.

Error Reporting

Audit script engine errors can be reported in two ways:

  • Using the ErrorInfo object (the result is written to the InTrust Server log)

  • As exceptions of the ADCException type for the audit script host to catch (the result is included in the InTrust session information)

Notes about exceptions:

  • Scripting callbacks should raise a JScript exception if they encounter any exceptional situation.

  • The audit script engine should catch such exceptions, translate them to ADCException objects and throw them again as C++ exceptions.

  • Script exceptions are translated into C++ exceptions. Exception information appears in session details.

  • The audit script position processor has the same error handling model as the audit script engine.

Related Documents

The document was helpful.

Select Rating

I easily found the information I needed.

Select Rating