cc/td/doc/product/rtrmgmt/cpc
hometocprevnextglossaryfeedbacksearchhelp
PDF

Table of Contents

SYcrbNPT.idl

SYcrbNPT.idl

Interfaces

The file SYcrbNPT.idl contains the following interfaces:

SYcrbNPT::ChangeRequest
SYcrbNPT::ChangeRequestFactory
SYcrbNPT::Connection
SYcrbNPT::ConnectionFactory
SYcrbNPT::EndPoint
SYcrbNPT::EndPointFactory
SYcrbNPT::EventSource
SYcrbNPT::EventSourceFactory
SYcrbNPT::Lister
SYcrbNPT::LogFileServer
SYcrbNPT::Managed
SYcrbNPT::ManagedComponent
SYcrbNPT::ManagedComponentFactory
SYcrbNPT::ManagedComponentLister
SYcrbNPT::ManagedFactory
SYcrbNPT::MetaDataServer
SYcrbNPT::NetworkElement
SYcrbNPT::NetworkElementFactory
SYcrbNPT::Persistent
SYcrbNPT::PersistentFactory
SYcrbNPT::Session
SYcrbNPT::SessionFactory
SYcrbNPT::SiteItemLister
SYcrbNPT::UploadRequest
SYcrbNPT::UploadRequestFactory

Module Description

This module provides access to the management functions of the product. This includes the following areas: Session management, Lister interface, and Network Element interface.

Data Structures and Types

ActionItem

Represents the action item.

struct ActionItem
{
    string name; string parm1; string parm2;
};
Members

name--string that represents the name of the permission (one of CHOOSE, DISPLAY, GETLIST, NEW, REMOVE, SAVE, UNDO, UPLOAD, VIEW, ZOOM).

parm1--string that represents parameter1, which

is only used for a NEW action. This represents the Object ID for the parent object of the object being created. Otherwise, it is an empty string.

parm2--string that represents parameter2. This is not used (empty string).

ActionItemSeq

typedef sequence<ActionItem> ActionItemSeq;

AttributeErrorItem

struct AttributeErrorItem
{
    AttributeName name; ErrorNumber number; ErrorText text;
};

AttributeErrorItemSeq

typedef sequence<AttributeErrorItem> AttributeErrorItemSeq;

AttributeItem

Represents the attribute item.

typedef string AttributeItem;

AttributeItemSeq

typedef sequence<AttributeItem> AttributeItemSeq;

AttributeName

Represents the attribute name.

typedef string AttributeName;

AttributeResultItem

Represents the attribute result item.

typedef string AttributeResultItem;

AttributeResultItemSeq

typedef sequence<AttributeResultItem> AttributeResultItemSeq;

AttributeResultItemSeqSeq

typedef sequence<AttributeResultItemSeq> AttributeResultItemSeqSeq;

AttributeValue

Represents the attribute value.

typedef string AttributeValue;

AttributeValueAndGuiModeItem

struct AttributeValueAndGuiModeItem
{
    AttributeName name; AttributeValue value; Mode mode; string guiMode;
};

AttributeValueAndGuiModeItemSeq

typedef sequence<AttributeValueAndGuiModeItem> AttributeValueAndGuiModeItemSeq;

AttributeValueAndModeItem

struct AttributeValueAndModeItem
{
    AttributeName name; AttributeValue value; Mode mode;
};

AttributeValueAndModeItemSeq

typedef sequence<AttributeValueAndModeItem> AttributeValueAndModeItemSeq;

AttributeValueItem

struct AttributeValueItem
{
    AttributeName name; AttributeValue value;
};

AttributeValueItemSeq

typedef sequence<AttributeValueItem> AttributeValueItemSeq;

Category

This specifies the category associated with an exception. Normally exceptions are only thrown with one of the failed categories.

enum Category
{
    succeeded, succeededWithStatus, failedWaitAndRetry, failedCorrectAndRetry, failedNoRetry, fatalFailure
};

charSeq

typedef sequence<char> charSeq;

ClassId

Represents the Class ID.

typedef string ClassId;

DbId

Represents the database ID.

typedef long DbId;

ErrorMessage

Represents the error message.

struct ErrorMessage
{
    string vendor; string application; string pid; string subsystem; Severity severity; Verbosity verbosity; ObjectId objectId; ErrorNumber ident; ErrorText message;
};
Members

vendor--string that represents the vendor of the software that generated the error.

application--string that represents the name of a software application process.

pid--string that represents the UNIX process where the error was generated.

subsystem--string that represents the name of a software subsystem.

severity--Severity that represents the severity.

verbosity--Verbosity that represents the verbosity.

objectId--ObjectId that represents the object ID.

ident--ErrorNumber that represents the error number.

message--ErrorText that represents the text of the error message.

ErrorMessageSeq

Represents the error message sequence.

typedef sequence<ErrorMessage> ErrorMessageSeq;

ErrorNumber

Represents the error number.

typedef long ErrorNumber;

ErrorStack

Represents the error stack.

struct ErrorStack
{
    ErrorNumber status; Category category; ErrorMessageSeq errors;
};
Members

status--ErrorNumber that represents the error number.

category--Category that represents the category.

errors--ErrorMessageSeq that represents the errors.

ErrorText

Represents the error text.

typedef string ErrorText;

EventSourceId

typedef long EventSourceId;

EventSourceIdSeq

typedef sequence<EventSourceId> EventSourceIdSeq;

Mode

Specifies the mode of an object attribute.

enum Mode
{
    UnknownMode, ReadOnlyMode, ReadWriteMode, ProfileReadOnlyMode, ProfileReadWriteMode, GuiMode
};
Enumerators

UnknownMode specifies that the mode is unknown.

ReadOnlyMode specifies that the mode is read-only.

ReadWriteMode specifies that the mode is read/write.

ProfileReadOnlyMode specifies that the mode is read-only for the profile.

ProfileReadWriteMode specifies that the mode is read/write for the profile.

GuiMode specifies that the mode is GUI.

MVCEvent

struct MVCEvent
{
    string eventClass; string eventType; ObjectIdSeq modelIds; string parameters;
};

MVCEventSeq

typedef sequence<MVCEvent> MVCEventSeq;

ObjectId

Represents the Object ID.

typedef string ObjectId;

ObjectIdSeq

typedef sequence<ObjectId> ObjectIdSeq;

Operation

Specifies the comparison operation in the SYcrbNPT::Lister search criteria.

enum Operation
{
    EqualTo, Like, CaseLike, NotEqualTo, NotLike, CaseNotLike, GreaterThan, GreaterThanOrEqualTo, LessThan, LessThanOrEqualTo
};

Order

Specifies the order in which the SYcrbNPT::Lister results can be sorted.

enum Order
{
    AscendingOrder, DescendingOrder
};

OrderByItem

struct OrderByItem
{
    AttributeName name; Order order;
};

OrderByItemSeq

typedef sequence<OrderByItem> OrderByItemSeq;

PendingOperation

Specifies the pending operation returned from the SYcrbNPT::Managed::getPendingOperation method.

enum PendingOperation
{
    UnknownPending, NoPending, NewPending, AddPending, ModifyPending, DeletePending, ReloadPending
};
Enumerators

UnknownPending specifies that the pending operation is unknown.

NoPending specifies that there is no pending operation.

NewPending specifies that there is a new pending operation.

AddPending specifies that a pending operation should be added.

ModifyPending specifies that the pending operation should be modified.

DeletePending specifies that the pending operation should be deleted.

ReloadPending specifies that the pending operation should be reloaded.

Permission

Specifies the permission associated with an action as returned by SYcrbNPT::Persistent::getPermittedActions and SYcrbNPT::Lister::getPermittedActions.

enum Permission
{
    UnknownPermission, YesPermission, NoPermission, NeverPermission
};
Enumerators

UnknownPermission specifies that the permission is unknown.

YesPermission specifies that there is permission for an action.

NoPermission specifies that there is no permission for an action.

NeverPermission specifies that there is never permission for an action.

PermissionItem

struct PermissionItem
{
    string name; Permission permission; string reason;
};

PermissionItemSeq

typedef sequence<PermissionItem> PermissionItemSeq;

PersistentId

Represents the Persistent ID.

typedef ObjectId PersistentId;

SearchItem

struct SearchItem
{
    AttributeName name; Operation operation; AttributeValue value;
};

SearchItemSeq

typedef sequence<SearchItem> SearchItemSeq;

Severity

This specifies the severity associated with a given error message in a stack of error messages in an exception.

enum Severity
{
    information, warning, problem, error, fatal
};

stringSeq

typedef sequence<string> stringSeq;

SubtypeItem

struct SubtypeItem
{
    ClassId className; string description;
};

SubtypeItemSeq

typedef sequence<SubtypeItem> SubtypeItemSeq;

UniqueByItem

Represents the unique by item.

typedef string UniqueByItem;

UniqueByItemSeq

typedef sequence<UniqueByItem> UniqueByItemSeq;

UpLoadItem

Represents the upload item. This is Equipment Module-specific.

struct UpLoadItem
{
    string key; string value1; string value2;
};
Members

key--string that represents the key.

value1--string that represents value1.

value2--string that represents value2.

UpLoadItemSeq

typedef sequence<UpLoadItem> UpLoadItemSeq;

Verbosity

This specifies the verbosity associated with a given error message in a stack of error messages in an exception.

enum Verbosity
{
    user, normal, enhanced, detailed
};

Constants

const string ADD_PENDING_OPERATION = "0"
const long ADD_PENDING_OPERATION_NUM = 0
const string CHECK_ACTION = "CHECK"
const string CHOOSE_ACTION = "CHOOSE"
const string COMMIT_ACTION = "COMMIT"
const string CURRENT_COID_ATTRIBUTE = "current_coid"
const string CURRENT_CRNUMBER_ATTRIBUTE = "current_crnumber"
const string CURRENT_NO_PENDING_STATUS = "CURRENTNOPENDING"
const string CURRENT_VERSION = "0"
const long CURRENT_VERSION_NUM = 0
const string CURRENT_WITH_INVALID_PENDING_STATUS = "CURRENTWITHINVALIDPENDING"
const string CURRENT_WITH_PENDING_STATUS = "CURRENTWITHPENDING"
const string DELETE_PENDING_OPERATION = "2"
const long DELETE_PENDING_OPERATION_NUM = 2
const string DISPLAY_ACTION = "DISPLAY"
const string GETLIST_ACTION = "GETLIST"
const string INVALID_PENDING_STATUS = "INVALID"
const string KEYOBJECTID = "KEYOBJECTID"
const string MODIFY_PENDING_OPERATION = "1"
const long MODIFY_PENDING_OPERATION_NUM = 1
const string NEW_ACTION = "NEW"
const string NEW_PENDING_OPERATION = "5"
const long NEW_PENDING_OPERATION_NUM = 5
const string NO_PENDING_OPERATION = "4"
const long NO_PENDING_OPERATION_NUM = 4
const string PENDING_OPERATION_ATTRIBUTE = "pending_operation"
const string PENDING_STATUS = "PENDING"
const string PENDING_STATUS_ATTRIBUTE = "pending_status"
const string PENDING_VERSION = "1"
const long PENDING_VERSION_NUM = 1
const string REJECT_ACTION = "REJECT"
const string RELOAD_ACTION = "RELOAD"
const string RELOAD_PENDING_OPERATION = "3"
const long RELOAD_PENDING_OPERATION_NUM = 3
const string REMOVE_ACTION = "REMOVE"
const string REVERT_ACTION = "REVERT"
const string SAVE_ACTION = "SAVE"
const string SECURITY_DOMAIN = "domain"
const string SECURITY_UNSECURED = "-"
const string SECURITY_VPN = "vpn"
const string SUPERSEDED1_VERSION = "2"

const long SUPERSEDED1_VERSION_NUM = 2
const string SUPERSEDED2_VERSION = "3"
const long SUPERSEDED2_VERSION_NUM = 3
const string SY_CHANGEORDERID_COLUMN = "sy_changeorderid"
const string SY_COMMITTEDDATE_COLUMN = "sy_committeddate"
const string SY_CONFREV_COLUMN = "sy_confrev"
const string SY_CREATEDDATE_COLUMN = "sy_createddate"
const string SY_MASTEROID_COLUMN = "sy_masteroid"
const string SY_MODIFIEDDATE_COLUMN = "sy_modifieddate"
const string SY_OBJECTID_COLUMN = "sy_objectid"
const string SY_PENDINGOPERATION_COLUMN = "sy_pendoperation"
const string SY_PROFNAME_COLUMN = "sy_profname"
const string SY_RETURNOID_COLUMN = "sy_returnoid"
const string SY_SEQUENCENUMBER_COLUMN = "sy_sequencenumber"
const string SY_SNOOKERSEQNUM_COLUMN = "sy_snookerseqnum"
const string SY_SORTORDER_COLUMN = "sy_sort_order"
const string SY_VERSION_COLUMN = "sy_version"
const string TOMBSTONE_VERSION = "4"
const long TOMBSTONE_VERSION_NUM = 4
const string TRANSLATE_ACTION = "TRANSLATE"
const string UNDO_ACTION = "UNDO"
const string UPLOAD_ACTION = "UPLOAD"
const string VIEW_ACTION = "VIEW"
const string ZOOM_ACTION = "ZOOM"

Exceptions

noSuchEvent

exception noSuchEvent
{
};

noSuchEventSource

This is an exception that is thrown when an invalid EventSourceId is passed as a parameter to an EventSourceFactory method.

exception noSuchEventSource
{
};

NptException

This is an NPT exception.

exception NptException
{
    ErrorStack errorStack;
};

NptGetValueException

This is an NPT get value exception.

exception NptGetValueException
{
    ErrorStack errorStack; AttributeValue returnedValue;
};

NptSaveException

This is an NPT save exception.

exception NptSaveException
{
    ErrorStack errorStack; AttributeErrorItemSeq failedAttributes;
};

Interface ChangeRequest : Persistent

Internal use only.

Operations

abort() operation

Internal use only.

Usage
void abort()
raises(NptException);

approve() operation

Internal use only.

Usage
void approve()
raises(NptException);

check() operation

Internal use only.

Usage
void check()
raises(NptException);

close() operation

Internal use only.

Usage
void close()
raises(NptException);

commit() operation

Internal use only.

Usage
void commit()
raises(NptException);

create() operation

Internal use only.

Usage
void create()
raises(NptException);

open() operation

Internal use only.

Usage
void open()
raises(NptException);

reapprove() operation

Internal use only.

Usage
void reapprove()
raises(NptException);

reject() operation

Internal use only.

Usage
void reject()
raises(NptException);

retry() operation

Internal use only.

Usage
void retry()
raises(NptException);

schedule() operation

Internal use only.

Usage
void schedule()
raises(NptException);

submitForApproval() operation

Internal use only.

Usage
void submitForApproval()
raises(NptException);

submitForScheduling() operation

Internal use only.

Usage
void submitForScheduling()
raises(NptException);

Interface ChangeRequestFactory : PersistentFactory

Internal use only.

Operations

bindChangeRequest() operation

Internal use only.

Usage
ChangeRequest bindChangeRequest(
    in PersistentId id)
raises(NptException);

createChangeRequest() operation

Internal use only.

Usage
ChangeRequest createChangeRequest(
    in ClassId nptClassName)
raises(NptException);

Interface Connection: NetworkElement

Internal use only.

Interface ConnectionFactory : PersistentFactory

Internal use only.

Operations

bindConnection() operation

Internal use only.

Usage
Connection bindConnection(
    in PersistentId id)
raises(NptException);

createConnection() operation

Internal use only.

Usage
Connection createConnection(
    in ClassId nptClassName)
raises(NptException);

Interface EndPoint: NetworkElement

Internal use only.

Interface EndPointFactory: PersistentFactory

Internal use only.

Operations

bindEndPoint() operation

Internal use only.

Usage
EndPoint bindEndPoint(
    in PersistentId id)
raises(NptException);

createEndPoint() operation

Internal use only.

Usage
EndPoint createEndPoint(
    in ClassId nptClassName)
raises(NptException);

Interface EventSource

This interface provides access to the methods for getting, enabling, and disabling events.

Operations

disableEvent() operation

Disables a type of event that was previously enabled.

Usage
void disableEvent(
    in string eventClass, in string eventType, in ObjectIdSeq modelIds, in FilterMode filter)
raises(noSuchEvent, 
    NptException);
Parameters

eventClass--in string represents the class of the event.

eventType--in string represents the type of the event.

modelIds--in ObjectIdSeq represents a list of the model for which the event was generated.

filter--in FilterMode represents the filter mode used when enabling and disabling events.

Raises

noSuchEvent NptException

enableEvent() operation

Selects the types of events forwarded to the even channel. By default, no events are forwarded. This method can be called more than once and the results are cumulative.

Usage
void enableEvent(
    in string eventClass, in string eventType, in ObjectIdSeq modelIds, in FilterMode filter)
raises(NptException);
Parameters

eventClass--in string represents the class of the event.

eventType--in string represents the type of the event.

modelIds--in ObjectIdSeq represents a list of the model for which the event was generated.

filter--in FilterMode represents the filter mode used when enabling and disabling events.

Raises

NptException

getEventChannel() operation

Gets the CORBA event channel associated with this EventSource.

Usage
CosEventChannelAdmin::EventChannel getEventChannel();
Returns

CosEventChannelAdmin::EventChannel

getEventSourceId() operation

Gets the EventSourceId of this EventSource.

Usage
EventSourceId getEventSourceId();
Returns

EventSourceId

Data Structures and Types

FilterMode

This specifies the filter mode used when enabling and disabling events.

enum FilterMode
{
    intraSession, interSession, allSession
};
Enumerators

intraSession represents Events generated inside the same session that you are running.

Interface EventSourceFactory

This interface provides access to the methods for creating, destroying, and getting EventSources.

Operations

createEventSource() operation

Creates a new EventSource object. An EventSource object is an object within the Server that forwards internal database change events onto a CORBA Event Services channel. The Client application is responsible for creating (and deleting) the event channel. The event channel is passed as an input parameter to this method. A reference to the EventSource object created is returned as well as the assigned EventSource id.

Usage
EventSource createEventSource(
    in CosEventChannelAdmin::EventChannel channel, out EventSourceId id)
raises(NptException);
Parameters

channel--in CosEventChannelAdmin::EventChannel represents the event channel.

id--out EventSourceId represents the ID of the event source.

Returns

EventSource

Raises

NptException

destroyEventSource() operation

Deletes an EventSource object. The object to be deleted is identified by its EventSourceId.

Usage
void destroyEventSource(
    in EventSourceId id)
raises(noSuchEventSource);
Parameters

id--in EventSourceId represents the ID of the event source.

Raises

noSuchEventSource

getAllEventSources() operation

Returns the EventSourceIds of all of the EventSources in this session.

Usage
EventSourceIdSeq getAllEventSources();
Returns

EventSourceIdSeq

getEventSource() operation

Returns a reference to the EventSource objects given its EventSourceId.

Usage
EventSource getEventSource(
    in EventSourceId id)
raises(noSuchEventSource);
Parameters

id--in EventSourceId represents the ID of the event source.

Raises

noSuchEventSource

Interface Lister : CosLifeCycle::LifeCycleObject

This interface provides access to the methods for listing attributes.

Operations

clearList() operation

Clears the result list of the last getList or getObject. This frees up memory resources on the Server but does not remove the CORBA lister object. The preferred approach is to use the remove operation that removes the CORBA lister object as well as freeing up the memory associated with the query results.

Usage
void clearList()
raises(NptException);
Raises

NptException

genericRequest() operation

This is a generic method interface, behavior is instance specific.

Usage
void genericRequest(
    in string command, inout string parameters)
raises(NptException);
Parameters

command--in string specifies the command.

parameters--inout string specifies the parameters.

Raises

NptException

getCount() operation

Provides the user with a mechanism for getting the count of records which matched the search crtieria. Note that this can be called only after calling getList or getFullList.

Usage
long getCount()
raises(NptException);
Raises

NptException

getCriteria() operation

Gets the criteria set in a previous getList.

Usage
void getCriteria(
    out SearchItemSeq searchList, out AttributeItemSeq columnList, out OrderByItemSeq orderByList, out UniqueByItemSeq uniqueByList, out boolean noDeletePending)
raises(NptException);
Parameters

searchList--out SearchItemSeq representing the search criteria.

columnList--out AttributeItemSeq representing the object attributes to be returned.

orderByList--out OrderByItemSeq specifies which column(s) the results should be sorted by, and whether ascending or descending order is required.

uniqueByList--out UniqueByItemSeq specifies the column(s) used to identify and remove duplicate rows in the results.

noDeletePending--out boolean

Raises

NptException

getFullList() operation

Provides the user with a mechanism for setting the search criteria and performing the database query for records which match the search criteria. Any criteria can be used for the getList operation with the exception of computed attributes and computed relationships. All rows are returned, current and pending even if for another Transaction.

Usage
void getFullList(
    in SearchItemSeq searchList, in AttributeItemSeq columnList, in OrderByItemSeq orderByList, in UniqueByItemSeq uniqueByList)
raises(NptException);
Parameters

searchList--in SearchItemSeq representing the search criteria.

columnList--in AttributeItemSeq representing the object attributes to be returned.

orderByList--in OrderByItemSeq specifies which column(s) the results should be sorted by, and whether ascending or descending order is required.

uniqueByList--in UniqueByItemSeq specifies the column(s) used to identify and remove duplicate rows in the results.

Raises

NptException

getItems() operation

Provides the user with a mechanism for getting the objects which matched the search criteria. The following data is returned for each object which matched the search criteria: result columns specified by setCriteria, object ID, pending operation: none, add, modify, delete, reload. Note that this can be called only after calling getList or getFullList.

Usage
void getItems(
    in long fromItem, in long toItem, out AttributeItemSeq names, out AttributeResultItemSeqSeq results)
raises(NptException);
Parameters

fromItem--in long specifies the index of the first results row to be returned (numbered from 1, not 0).

toItem--in long specifies the index of the last results row to be returned.

names--out AttributeItemSeq specifies the attribute column names for the returned results.

results--out AttributeResultItemSeqSeq specifies the attribute values (first dimension selects the row, second dimension selects the column).

Raises

NptException

getList() operation

Provides the user with a mechanism for setting the search criteria and performing the database query for records which match the search criteria. Any criteria can be used for the getList operation with the exception of computed attributes and computed relationships. The database is queried and the results are stored in memory in the Server. Results are subsequently obtained by the Client by calling getItems.

Usage
void getList(
    in SearchItemSeq searchList, in AttributeItemSeq columnList, in OrderByItemSeq orderByList, in UniqueByItemSeq uniqueByList)
raises(NptException);
Parameters

searchList--in SearchItemSeq representing the search criteria.

columnList--in AttributeItemSeq representing the object attributes to be returned.

orderByList--in OrderByItemSeq specifies which column(s) the results should be sorted by, and whether ascending or descending order is required.

uniqueByList--in UniqueByItemSeq specifies the column(s) used to identify and remove duplicate rows in the results.

Raises

NptException

getObjectId() operation

Gets the object ID of the lister. Note that lister objects are not persistent. Use of this method should not be required in most situations.

Usage
ObjectId getObjectId()
raises(NptException);
Returns

ObjectId representing the Object ID.

Raises

NptException

getPermittedActions() operation

Provides the user with a mechanism for determining whether or not a set of actions is permitted.

Usage
void getPermittedActions(
    in ActionItemSeq actions, out PermissionItemSeq permission)
raises(NptException);
Parameters

actions--in ActionItemSeq specifies the actions.

permission--out PermissionItemSeq specifies the permission.

Raises

NptException

getReasonNotPermitted() operation

Returns the reason why the action is not permitted.

Usage
string getReasonNotPermitted(
    in string actionName, out ErrorNumber number)
raises(NptException);
Parameters

actionName--in string specifies the action name.

number--out ErrorNumber specifies the error number.

Returns

string

Raises

NptException

getSubtypes() operation

Provides the user with a mechanism for getting the subtypes associated with this object class. This method returns the list of subtypes and the object ID for a new object of each subtype.

Usage
void getSubtypes(
    out SubtypeItemSeq subtypeList)
raises(NptException);
Parameters

subtypeList--out SubtypeItemSeq specifies the subtype list.

Raises

NptException

integratedRequest() operation

This is a generic method interface, behavior is instance specific.

Usage
void integratedRequest(
    in string command, in string inputParameter, out string outputParameter)
raises(NptException);
Parameters

command--in string specifies the command.

inputParameter--in string specifies the input parameter, one input string parameter for the command.

outputParameter--out string specifies the output parameter, one output string parameter for the command.

Raises

NptException

Interface LogFileServer

This interface provides read access to the log files.

Operations

read() operation

Usage
unsigned long read(
    in string fileName, in long seekOffset, in unsigned long nBytes, out charSeq data)
raises(NptException);

readAudit() operation

Usage
unsigned long readAudit(
    in long crId, in long seekOffset, in unsigned long nBytes, out charSeq data)
raises(NptException);

readEvent() operation

Usage
unsigned long readEvent(
    in long seekOffset, in unsigned long nBytes, out charSeq data)
raises(NptException);

readSite() operation

Usage
unsigned long readSite(
    in long crId, in string siteName, in long seekOffset, in unsigned long nBytes, out charSeq data)
raises(NptException);

readSiteError() operation

Usage
unsigned long readSiteError(
    in long crId, in string siteName, in long seekOffset, in unsigned long nBytes, out charSeq data)
raises(NptException);

readSystemAdmin() operation

Usage
unsigned long readSystemAdmin(
    in long seekOffset, in unsigned long nBytes, out charSeq data)
raises(NptException);

Interface Managed: Persistent

This interface provides access to the methods for reverting changes to an object and for getting the pending operation for an object.

Operations

getPendingOperation() operation

Gets the pending operation for an object. For more information about Current and Pending views in the database, refer to the User's Guide.

Usage
PendingOperation getPendingOperation()
raises(NptException);
Returns

PendingOperation

revert() operation

Provides the user with a mechanism for reverting changes to the object. An object reverts by deleting all of its pending records.

Usage
void revert(
    inout AttributeErrorItemSeq errorList)
raises(NptException, 
    NptSaveException);
Parameters

errorList--inout AttributeErrorItemSeq represents the error list. This is normally not used.

Raises

NptException NptSaveException

Interface ManagedComponent : Managed

Internal use only.

Operations

isManagedComponent() operation

Internal use only.

Usage
boolean isManagedComponent()
raises(NptException);

okPartialSave() operation

Internal use only.

Usage
void okPartialSave(
    in PersistentId ownerObjectId)
raises(NptException);

Interface ManagedComponentFactory: PersistentFactory

Internal use only.

Operations

bindManagedComponent() operation

Internal use only.

Usage
ManagedComponent bindManagedComponent(
    in PersistentId id)
raises(NptException);

bindManagedComponentLister() operation

Internal use only.

Usage
ManagedComponentLister bindManagedComponentLister(
    in ObjectId id)
raises(NptException);

createManagedComponent() operation

Internal use only.

Usage
ManagedComponent createManagedComponent(
    in ClassId nptClassName)
raises(NptException);

createManagedComponentLister() operation

Internal use only.

Usage
ManagedComponentLister createManagedComponentLister(
    in ClassId nptClassName)
raises(NptException);

Interface ManagedComponentLister: Lister

This interface is for internal use only.

Operations

addElement() operation

This method is for internal use only.

Usage
PersistentId addElement(
    in AttributeValueItemSeq attributeList)
raises(NptException);

removeElement() operation

This method is for internal use only.

Usage
void removeElement(
    in PersistentId id)
raises(NptException);

Interface ManagedFactory : PersistentFactory

Internal use only.

Operations

bindManaged() operation

Internal use only.

Usage
Managed bindManaged(
    in PersistentId id)
raises(NptException);

createManaged() operation

Internal use only.

Usage
Managed createManaged(
    in ClassId nptClassName)
raises(NptException);

Interface MetaDataServer

This interface provides access to the method for getting all attribute names.

Operations

getAllAttributeNames() operation

Returns all attribute names for the specified class.

Usage
void getAllAttributeNames(
    in ClassId className, out AttributeItemSeq names)
raises(NptException);
Parameters

className--in ClassId represents the classname, defined in the OAF.

names--out AttributeItemSeq represents the list of attribute names.

Raises

NptException

Interface NetworkElement: Managed

This interface provides access to the method for upload.

Operations

reload() operation

Internal use only.

Usage
void reload()
raises(NptException);

upLoad() operation

Uploads the specified object and its contained objects into the database, given the upload information in parameters. This command returns only when the Upload Request has finished processing. If an error occurs, the Upload Request Object ID is set to "".

Usage
PersistentId upLoad(
    in UpLoadItemSeq parameters)
raises(NptException);
Parameters

parameters--in UpLoadItemSeq represents the parameters - these are Equipment Module specific.

Returns

PersistentId

Raises

NptException

Interface NetworkElementFactory: PersistentFactory

This interface provides access to the methods for creating and binding to network elements.

Operations

bindNetworkElement() operation

Passes an object id for the network element into the bind and it returns a CORBA object reference for the network element.

Usage
NetworkElement bindNetworkElement(
    in PersistentId id)
raises(NptException);
Parameters

id--in PersistentId represents the persistent object ID.

Returns

NetworkElement

Raises

NptException

createNetworkElement() operation

Provides the user with a mechanism for creating a network element.

Usage
NetworkElement createNetworkElement(
    in ClassId nptClassName)
raises(NptException);
Parameters

nptClassName--in ClassId represents the classname, defined in the OAF.

Returns

NetworkElement

Raises

NptException

Interface Persistent: CosLifeCycle::LifeCycleObject

This interface provides access to the methods for manipulating persistent objects.

Operations

genericRequest() operation

This is a generic method interface, behavior is instance specific.

Usage
void genericRequest(
    in string command, inout string parameters)
raises(NptException);
Parameters

command--in string represents the command name.

parameters--inout string represents the parameters.

Raises

NptException

getAttributes() operation

Provides the user with a mechanism for getting the values for a specified set of object attributes.

Usage
void getAttributes(
    in AttributeItemSeq attributes, out AttributeValueItemSeq results)
raises(NptException);
Parameters

attributes--in AttributeItemSeq represents the attributes.

results--out AttributeValueItemSeq represents the results.

Raises

NptException

getAttributesAndGuiMode() operation

Provides the user with a mechanism for getting the values for a specified set of object attributes and their GUI modes.

Usage
void getAttributesAndGuiMode(
    in AttributeItemSeq attributes, out AttributeValueAndGuiModeItemSeq results)
raises(NptException);
Parameters

attributes--in AttributeItemSeq represents the attributes.

results--out AttributeValueAndGuiModeItemSeq represents the results.

Raises

NptException

getAttributesAndMode() operation

Provides the user with a mechanism for getting the values for a specified set of object attributes and their associated modes.

Usage
void getAttributesAndMode(
    in AttributeItemSeq attributes, out AttributeValueAndModeItemSeq results)
raises(NptException);
Parameters

attributes--in AttributeItemSeq represents the attributes.

results--out AttributeValueAndModeItemSeq represents the results.

Raises

NptException

getMode() operation

Gets the mode for the specified attribute. If the object has an associated profile, then the mode is defined by the profile for profiles attributes.

Usage
Mode getMode(
    in AttributeName attributeName)
raises(NptException);
Parameters

attributeName--in AttributeName represents the attribute name.

Returns

Mode

Raises

NptException

getPermittedActions() operation

Provides the user with a mechanism for determining whether or not a set of actions is permitted. This is typically used by viewers and scripters.

Usage
void getPermittedActions(
    in ActionItemSeq actions, out PermissionItemSeq permission)
raises(NptException);
Parameters

actions--in ActionItemSeq represents the action.

permission--out PermissionItemSeq represents the permission.

Raises

NptException

getPersistentId() operation

Gets the persistent ID for the object.

Usage
PersistentId getPersistentId()
raises(NptException);
Returns

PersistentId

Raises

NptException

getReasonNotPermitted() operation

Returns the reason why the action is not permitted.

Usage
string getReasonNotPermitted(
    in string actionName, out ErrorNumber number)
raises(NptException);
Parameters

actionName--in string represents the name of the specified action (for example, getList action).

number--out ErrorNumber represents the error number.

Returns

string

Raises

NptException

getTranslatedText() operation

Provides the user with a mechanism for undoing all setAttributes since the last save for this object. This method instructs the object to throw away changes that have not been saved.

Usage
string getTranslatedText(
    in string text)
raises(NptException);
Parameters

text--in string represents the text string.

Returns

string

Raises

NptException

getValue() operation

Gets the modified value of the specified attribute. The modified version is the version of the object in memory which has not yet been saved.

Usage
AttributeValue getValue(
    in AttributeName attributeName)
raises(NptGetValueException, 
    NptException);
Parameters

attributeName--in AttributeName represents the attribute name.

Returns

AttributeValue

Raises

NptGetValueException NptException

integratedRequest() operation

This is a generic method interface, behavior is instance specific.

Usage
void integratedRequest(
    in string command, in string inputParameter, out string outputParameter)
raises(NptException);
Parameters

command--in string represents the command name.

inputParameter--in string represents the one input string parameter for the command.

outputParameter--out string represents the one output string parameter for the command.

Raises

NptException

isNew() operation

Returns TRUE that this is a new object, or FALSE otherwise.

Usage
boolean isNew()
raises(NptException);
Returns

boolean

Raises

NptException

overwriteAttributes() operation

Sets the values of the specified attributes without checking for the mode of the attributes.

Usage
void overwriteAttributes(
    in AttributeValueItemSeq attributeList)
raises(NptException);
Parameters

attributeList--in AttributeValueItemSeq represents the attribute list.

Raises

NptException

overwriteValue() operation

Sets the values of the specified attributes without checking for mode of the attributes.

Usage
void overwriteValue(
    in AttributeName attributeName, in AttributeValue attributeValue)
raises(NptException);
Parameters

attributeName--in AttributeName represents the attribute name.

attributeValue--in AttributeValue represents the attribute value.

Raises

NptException

remove() operation

Provides the user with a mechanism for removing (and deleting) the object. The errorList parameter is normally not used.

Usage
void remove(
    inout AttributeErrorItemSeq errorList)
raises(NptException, 
    NptSaveException);
Parameters

errorList--inout AttributeErrorItemSeq represents the error list.

Raises

NptException NptSaveException

save() operation

Provides the user with a mechanism for saving all object changes to the database that were done with the setAttributes operation. The errorList parameter is normally not used.

Usage
void save(
    inout AttributeErrorItemSeq errorList)
raises(NptException, 
    NptSaveException);
Parameters

errorList--inout AttributeErrorItemSeq represents the error list.

Raises

NptException NptSaveException

setAssociationByCriteria() operation

Sets the association by criteria.

Usage
void setAssociationByCriteria(
    in AttributeName attributeName, in SearchItemSeq criteria)
raises(NptException);
Parameters

attributeName--in AttributeName represents the attribute name.

criteria--in SearchItemSeq represents the criteria.

Raises

NptException

setAssociationByName() operation

Sets the association by name.

Usage
void setAssociationByName(
    in AttributeName attributeName, in AttributeValue attributeValue)
raises(NptException);
Parameters

attributeName--in AttributeName represents the attribute name.

attributeValue--in AttributeValue represents the attribute value.

Raises

NptException

setAttributes() operation

Provides the user with a mechanism for setting the values for a specified set of object attributes. The values of attributes are set in memory but not into the database until a save is done.

Usage
void setAttributes(
    in AttributeValueItemSeq attributeList)
raises(NptException);
Parameters

attributeList--in AttributeValueItemSeq represents the attribute list.

Raises

NptException

setParent() operation

Sets the parent.

Usage
void setParent(
    in PersistentId parent)
raises(NptException);
Parameters

parent--in PersistentId

Raises

NptException

setValue() operation

Sets the value of the specified attribute.

Usage
void setValue(
    in AttributeName attributeName, in AttributeValue attributeValue)
raises(NptException);
Parameters

attributeName--in AttributeName represents the attribute name.

attributeValue--in AttributeValue represents the attribute value.

Raises

NptException

undo() operation

Provides the user with a mechanism for undoing all setAttributes since the last save for this object. This method instructs the object to throw away changes that have not been saved.

Usage
void undo()
raises(NptException);
Raises

NptException

Interface PersistentFactory : CosLifeCycle::GenericFactory

This interface provides access to the methods for creating objects, and creating listers.

Operations

bindLister() operation

Passes an object id for the lister into the bind and it will return a CORBA object reference for the lister.

Usage
Lister bindLister(
    in ObjectId id)
raises(NptException);
Parameters

id--in ObjectId represents the ID of the lister.

Returns

Lister

Raises

NptException

bindObject() operation

Passes an object id for the object into the bind and it will return a CORBA object reference for the object.

Usage
Persistent bindObject(
    in PersistentId id)
raises(NptException);
Parameters

id--in PersistentId represents the ID of the object.

Returns

Persistent

Raises

NptException

createLister() operation

Provides the user with a mechanism for creating a lister for the specified class name.

Usage
Lister createLister(
    in ClassId nptClassName)
raises(NptException);
Parameters

nptClassName--in ClassId represents the classname, identified in the OAF.

Returns

Lister

Raises

NptException

createObject() operation

Provides the user with a mechanism to create objects.

Usage
Persistent createObject(
    in ClassId nptClassName)
raises(NptException);
Parameters

nptClassName--in ClassId represents the classname, defined in the OAF.

Returns

Persistent

Raises

NptException

createSiteItemLister() operation

Provides the user with a mechanism for creating a site item lister for the specified object ID.

Usage
SiteItemLister createSiteItemLister(
    in ObjectId coid)
raises(NptException);
Parameters

coid--in ObjectId specifies the Transaction or Change Order object ID.

Returns

SiteItemLister

Raises

NptException

getObjectClass() operation

Returns the object class.

Usage
ClassId getObjectClass(
    in PersistentId id)
raises(NptException);
Parameters

id--in PersistentId represents the ID of the object.

Returns

ClassId

Raises

NptException

Interface Session

This interface provides access to the methods for creating and managing sessions.

Operations

getOpenCR() operation

Returns the current Transaction object ID.

Usage
PersistentId getOpenCR()
raises(NptException);
Returns

PersistentId representing the Transaction object ID.

Raises

NptException

getServices() operation

Gets the list of services.

Usage
CosNaming::NamingContext getServices();

getSessionId() operation

Returns the session ID as an integer.

Usage
DbId getSessionId();
Returns

DbId representing the session ID.

remove() operation

Ends the session.

Usage
void remove();

Interface SessionFactory

This interface provides access to the methods for creating a new and binding to an existing session.

Operations

attachMaster() operation

Attaches to an existing session specifying the session object id.

Usage
Session attachMaster(
    in ObjectId sessionId)
raises(NptException);
Parameters

sessionId--in ObjectId representing the session ID.

Returns

Session representing the session.

attachMasterL() operation

Attaches to an existing session specifying the session id as an integer.

Usage
Session attachMasterL(
    in long sessionId)
raises(NptException);
Parameters

sessionId--in long representing the session ID.

Returns

Session representing the session.

Raises

NptException

createMaster() operation

Creates a session. The user name determines access privileges.

Usage
Session createMaster(
    in string userName, in string sessionType)
raises(NptException);
Parameters

username--in string representing the username.

sessionType--in string representing the session type.

Returns

Session representing the session.

Raises

NptException

createSession() operation

Internal use only.

Usage
Session createSession()
raises(NptException);

Interface SiteItemLister : Lister

This interface is derived from lister. It supports all of the methods defined for lister, plus the method for setting the Transaction.

Operations

setCR() operation

Associate the site item lister with the specified Transaction.

Usage
void setCR(
    in PersistentId changeOrderId)
raises(NptException);
Parameters

changeOrderId--in PersistentId specifies the ID of the Change Request.

Raises

NptException

Interface UploadRequest : Persistent

This interface provides access to the methods for aborting an upload request.

Operations

abort() operation

Aborts an upload request that is running.

Usage
void abort()
raises(NptException);
Raises

NptException

Interface UploadRequestFactory : PersistentFactory

This interface provides access to the method for binding to an upload request.

Operations

bindUploadRequest() operation

Passes an object id for the upload request into the bind and it returns a CORBA object reference for the upload request.

Usage
UploadRequest bindUploadRequest(
    in PersistentId id)
raises(NptException);
Parameters

id--in PersistentId represents the persistent object ID.

Returns

UploadRequest

Raises

NptException


hometocprevnextglossaryfeedbacksearchhelp
Posted: Thu Aug 3 16:32:47 PDT 2000
Copyright 1989-2000©Cisco Systems Inc.