|
|
There are two CORBA modules included with Release 2.0 of Cisco Provisioning Center:
These modules can be found in the $CCP_REL/sys/idl directory.
The SYcrbAV module provides access to the management functions of the Cisco Provisioning Center. This includes the following areas:
The SYcrbAV module consists of the following interfaces:
The CORBA NPT (SYcrbNPT) module provides access to the management functions of Cisco Provisioning Center. This includes the following areas:
The SYcrbNPT module consists of the following interfaces:
![]() |
Note Client application developers should use the SYcrbAV session management interfaces, not the SYcrbNPT session management interfaces. |
The IDL file mentioned above makes use of the Naming Service IDL, the Event Service IDL, and the CORBA Life Cycle Service IDL. The event.idl and lifecyclesservices.idl files are shipped to be used for the development of clients of the Cisco Provisioning Center interface. The Life Cycle Service IDL, is included in the $CCP_REL/sys/idl directory. The Event Service IDL file is located in the $CCP_REL/sys/corba/OrbixEvents.1.0/Untyped1.0c/idl/directory. The Naming Service IDL file is located in the $CCP_REL/sys/corba/OrbixNames_1.1/idl/directory. They are not defined in this chapter.
This section defines the elements of the CORBA command syntax that are used in this chapter.
SYcrbAV::TransactionMode--This is used to select the Transaction mode. It can be one of the following:
Atomic--Cisco Provisioning Center creates and opens a new Transaction, and throws an error if a transaction is already open in the session. This is useful if the upper level application is passing work between Operator sessions, where the Operator might unexpectedly open another Transaction.
Auto--Cisco Provisioning Center uses the Transaction that is open in the current session if there is one, and automatically creates and opens one if not.
Current--Cisco Provisioning Center uses the Transaction that is open in the current session if there is one, or none at all. If the CORBA command requires an open Transaction then not having one causes an error.
Open--Cisco Provisioning Center checks that there is a Transaction open in the current session, and throws an error if not. This is useful if the upper level application is passing work between Operator sessions, where the Operator might unexpectedly close the Transaction.
Specified--Cisco Provisioning Center works within the Transaction specified by the given CRID. If that Transaction is already open in the session then Cisco Provisioning Center uses it. If that Transaction is open in another session or another Transaction is open in the current session then Cisco Provisioning Center throws an error. If no Transaction is open, then Cisco Provisioning Center opens the specified Transaction for the session.
None--Cisco Provisioning Center check that there is no Transaction open in the current session, and throws and error otherwise. If the CORBA command requires an open Transaction then not having one also causes an error.
SYcrbAV::CRID--This is used to specify the object ID of the Transaction. For example, "SYcadChangeOrder:1001"
SYcrbAV::LINKID--This is used to specify the link object ID.
SYcrbNPT::Operation--This specifies the comparison operation is the SYcrbNPT::Lister search criteria. It can be one of the following:
SYcrbNPT::order--This specifies the order in which SYcrbNPT::Lister results can be stored. It can be one of the following:
SYcrbNPT::Mode --This specifies the mode of an object attribute. It can be one of the following:
SYcrbNPT::PendingOperation --This specifies the pending operation returned from the SYcrbNPT::Managed::getPendingOperation method. It can be one of the following:
SYcrbNPT::Permission --This specifies the permission associated with an action as returned by SYcrbNPT::Persistent::getPermittedActions and SYcrbNPT::Lister::getPermittedActions. It can be one of the following:
SYcrbNPT::Category --This specifies the category associated with a Cisco Provisioning Center or CPC exception. Normally, exceptions are only thrown with one of the failed categories. It can be one of the following:
SYcrbNPT::Severity --This specifies the category associated with a given error message in a stack of error messages in a Cisco Provisioning Center of CPC exception. It can be one of the following:
SYcrbNPT::Verbosity --This specifies the verbosity associated with a given error message in a stack of error messages in a Cisco Provisioning Center of CPC exception. It can be one of the following:
SYcrbNPT::EventSource::FilterMode --This specifies the filter mode used when enabling and disabling events. It can be one of the following:
The following constants define the names for the transaction states for the TransactionManager Interface.
Ready State | "Ready" |
Current State | "Current" |
Busy State | "Busy" |
Scheduled State | "Scheduled" |
Applied State | "Applied" |
Alert State | "Alert" |
Abandoned State | "Abandoned" |
The following constants define the names for the actions for the getPermittedActions and getReasonNotPermitted operations in the Persistent Interface and/or Lister interface for persistent objects.
CHOOSE_ACTION | "CHOOSE" |
DISPLAY_ACTION | "DISPLAY" |
GETLIST_ACTION | "GETLIST" |
NEW_ACTION | "NEW" |
REMOVE_ACTION | "REMOVE" |
SAVE_ACTION | "SAVE" |
UNDO_ACTION | "UNDO" |
UPLOAD_ACTION | "UPLOAD" |
VIEW_ACTION | "VIEW" |
ZOOM_ACTION | "ZOOM" |
The following constants define the attribute names for the internal and system attributes for the getValue and getAttributes operations in the Persistent Interface.
SY_OBJECTID_COLUMN | "sy_objectid" |
SY_RETURNOID_COLUMN | "sy_returnid" |
SY_CREATEDATE_COLUMN | "sy_createdate" |
SY_MODIFIEDDATE_COLUMN | "sy_modifieddate" |
SY_SEQUENCENUMBER_COLUMN | "sy_sequencenumber" |
The following constants define the attribute names for the computed internal and system attributes for the getValue and getAttributes operations in the Persistent Interface.
CURRENT_COID_ATTRIBUTE | "current_coid" |
CURRENT_CRNUMBER_ATTRIBUTE | "current_crnumber" |
PENDING_OPERATION_ATTRIBUTE | "pending_operation" |
PENDING_STATUS_ATTRIBUTE | "pending_status" |
The following constants define the values for the pending_status attribute for the getValue and getAttributes operations in the Persistent Interface.
CURRENT_NO_PENDING_STATUS | "CURRENTNOPENDING" |
CURRENT_WITH_PENDING_STATUS | "CURRENTWITHPENDING" |
CURRENT_WITH_INVALID_PENDING_STATUS | "PENDING" |
INVALID_PENDING_STATUS | "INVALID" |
The following constants define the values for the sy_version attribute for the getValue and getAttributes operations in the Persistent Interface.
CURRENT_VERSION | "0" |
CURRENT_VERSION_NUM | 0 |
PENDING_VERSION | "1" |
PENDING_VERSION_NUM | 1 |
The following constants define the values for the sy_pendoperation attribute for the getValue and getAttributes operations in the Persistent Interface.
ADD_PENDING_OPERATION | "0" |
ADD_PENDING_OPERATION_NUM | 0 |
MODIFY_PENDING_OPERATION | "1" |
MODIFY_PENDING_OPERATION_NUM | 1 |
DELETE_PENDING_OPERATION | "2" |
DELETE_PENDING_OPERATION_NUM | 2 |
RELOAD_PENDING_OPERATION | "3" |
RELOAD_PENDING_OPERATION_NUM | 3 |
NO_PENDING_OPERATION | "4" |
NO_PENDING_OPERATION_NUM | 4 |
NEW_PENDING_OPERATION | "5" |
NEW_PENDING_OPERATION_NUMB | 5 |
typedef | string | ObjectId |
typedef | string | ClassId |
typedef | long | DbId |
typedef | string | AttributeName |
typedef | string | AttributeValue |
typedef | long | ErrorNumber |
typedef | string | ErrorText |
typedef | ObjectId | PersistentId |
typedef | string | AttributeItem |
typedef | string | AttributeResultItem |
typedef | string | UniqueByItem |
typedef | sequence<char> | charSeq; |
typedef | sequence<string> | stringSeq; |
typedef | sequence<ObjectId> | ObjectIdSeq; |
typedef | sequence<AttributeValueItem> | AttributeValueItemSeq; |
typedef | sequence<AttributeValueAndModeItem> | AttributeValueAndModeItemSeq |
typedef | sequence<AttributeValueAndGuiModeItem> | AttributeValueAndGuiModeItemSeq; |
typedef | sequence<ActionItem> | ActionItemSeq; |
typedef | sequence<PermissionItem> | PermissionItemSeq; |
typedef | sequence<UpLoadItem> | UpLoadItemSeq; |
typedef | sequence<SubtypeItem> | SubtypeItemSeq; |
typedef | sequence<AttributeError> | AttributeErrorItemSeq; |
typedef | sequence<SearchItem> | SearchItemSeq; |
typedef | sequence<AttributeItem> | AttributeItemSeq; |
typedef | sequence<AttributeResultItem> | AttributeResultItemSeq; |
typedef | sequence<AttributeResultItemSeq> | AttributeResultItemSeqSeq; |
typedef | sequence<OrderByItem> | OrderByItemSeq; |
typedef | sequence<UniqueByItem> | UniqueByItemSeq; |
typedef | sequence<ErrorMessage> | ErrorMessageSeq; |
typedef | sequence<MVCEvent> | MVCEventSeq; |
typedef | long | EventSourceId; |
typedef | sequence<EventSourceId> | EventSourceIdSeq; |
AttributeName | name |
AttributeValue | value |
AttributeName | name |
AttributeValue | value |
Mode | mode |
AttributeName | name |
AttributeValue | value |
Mode | mode |
string | guiMode |
string | name |
string | parm1 |
string | parm2 |
string | name |
Permission | permission |
string | reason |
string | key |
string | value1 |
string | value2 |
classId | className |
string | description |
attributeName | name |
Operation | operation |
AttributeValue | value |
AttributeName | name |
Order | order |
string | evenClass | "CMS" for fabric and service element object,"CCS" for transaction and upload request objects |
string | eventType | one of the "new", "modify", "delete", "revert", "commit", "reject" |
ObjectIdSeq | modeIds | ObjectIdSeqmodelIds - a sequence of objects ids of the object changed |
string | parameters | string parameters contain the number of the foreground or background session where the change originated; when intraSession events are enabled significant events in other sessions will be delivered with a parameter of "0" |
AttributeName | name | name of the errored attribute |
ErrorNumber | number | error number |
ErrorText | text | message describing why the value of this attribute is in error |
string | vendor | the vendor of the software that generated the error (SY for Syndesis) |
string | application | the name of a software application process |
string | pid | the UNIX process where the error was generated |
string | subsystem | the name of a software subsystem |
Severity | severity | |
verbosity | verbosity | |
objectId | objectId | the object id of the object being processed when the error occurred |
ErrorNumber | ident | an error number |
ErrorText | message | a printable error message |
ErrorNumber | status | an error number |
Category | category | an error category |
ErrorMessageSeq | errors | a sequence of error messages |
Cisco Provisioning Center equivalent to NptException.
SycrbNPT::ErrorNumber | status |
SYcrbNPT::ErrorMessageSeq | errors |
Cisco Provisioning Center equivalent to NptSaveException.
SYcrbNPT::ErrorNumber | status |
SYcrbNPT::ErrorMessageSeq | errors |
SYcrbNPT::AttributeErrorItemSeq | failedAttributes-describes the attributes that prevented the object from being saved |
It corresponds to a numbered Cisco Provisioning Center exception of the following classes (class name stored in exception class). It is one of:
It corresponds to a standard Java exception (class name stored in exception class). For example, java.lang.IOException.
String | exceptionClass |
It uses AVExceptionDetailTypes as a discriminator to select between one of AVStackExceptionDetails, AVSaveExceptionDetails, AVNumberExceptionDetails, or AVUnNumberedExceptionDetails.
ErrorStack | errorStack |
ErrorStack | errorStack |
AttributeValue | returnedValue |
ErrorStack | errorStack |
AttributeErrorItemSeq | failedAttributes |
This is a basic Activator exception.
SYcrbNPT::Category | category |
SYcrbNPT::ErrorText | message |
AVExceptionDetails | details |
CRID | abandonedTransactionId |
An exception that is thrown when a invalid EventSourceId is passed as a parameter to an EventSourceFactory method.
An exception is thrown when a type of event is disabled that was not previously enabled.
SYcrbNPT::Category | category |
SYcrbNPT::ErrorText | message |
AVExceptionDetails | details |
CRID | abandonedTransactionId |
StackDetails SaveDetails NumberDetails UnNumber Details
The CORBA interface provides access to Service objects. The Service Object Manager Interface is implemented through the following operations (also called methods).
![]() |
Note When the transactionMode= =Specified, the transactionId must contain the object id of the required transaction, otherwise it should be initialized to "". |
| create | |
|---|---|
Usage: | SOID create (in TransactionMode transactionMode, inout CRID transactionId, in SycrbNPT::AttributeValueItemSeq transactionAttributes, inout ReadSycrbNPT::AttributeValueItemSeq soAttributes) raises AVAutoTransactionException) |
Description: | Creates a new Service object with the given attributes. If soAttributes specifies a Service object profile (with attribute srprofile or srprofile.sy_profname (or its supported alias profilename)), then the profile is always applied first no matter where it appears in the attribute array (to ensure that other specified attributes are not overridden). Note that attribute modes are NOT enforced by this command and read-only attributes can be modified if so desired. |
Parameters: | transactionAttributes--This is used to select the transaction attributes. It can be one or more of the following: briefdescription, domain, vpn. soAttributes--This is used to specify the attributes of the Service object and return the values of all service object attributes. |
| modify | |
|---|---|
Usage: | void modify (in SOID id, in TransactionMode transactionMode, inout CRID transactionId, in SYcrbNPT::AttributeValueItemSeq transactionAttributes, inout SYcrbNPT::AttributeValueItemSeq soAttributes) raises (AVAutoTransactionException) |
Description: | Modifies the given Service Object with the given attributes. The Service object must be specified using the object id in the SOID is input parameter. If soAttributes specifies a Service object profile (with attribute srprofile or srprofile.sy_profname (or its supported alias profilename)), then the profile is always applied first no matter where it appears in the attribute array (to ensure that other specified attributes are not overridden). Note that attribute modes are not enforced by this command and read-only attributes can be modified if so desired. |
Parameters: | transactionAttributes--This is used to select the transaction attributes. It can be one or more of the following: briefdescription, domain, vpn. soAttributes--This is used to specify the attributes of the Service object and return the values of all service object attributes. |
| delete | |
|---|---|
Usage: | void del (in SOID id, in TransactionMode transactionMode, inout CRID transactionId, in SYcrbNPT::AttributeValueItemSeq transactionAttributes, inout SYcrbNPT::AttributeValueItemSeq soAttributes) |
Description: | Deletes the given Service object. The Service object must be specified using the object id in the SOID id input parameter. |
Parameters: | transactionAttributes--This is used to select the transaction attributes. It can be one or more of the following: briefdescription, domain, vpn. soAttributes--This is used to specify the attributes of the Service object and return the values of all service object attributes. |
| get all attributes | |
|---|---|
Usage: | void getAllAttributes (in SOID id, in TransactionMode transactionMode, inout CRID transactionId, out SYcrbNPT::AttributeValueItemSeq soAttributes) raises (AVAutoTransactionException) |
Description: | Returns the attributes of the given Service object. |
Parameters: | soAttributes--This is used to specify the attributes of the Service object and return the values of all service object attributes.
|
| get all attributesWithModes | |
|---|---|
Usage: | void getAllAttributesWithModes (in SOID id, in TransactionMode transactionMode, inout CRID transactionId, out SYcrbNPT::AttributeValueAndItemSeq soAttributesAndModes, raises (AVAutoTransactionException) |
Description: | Same as the get AllAttributes command, except this command also returns the attribute modes of the given Service object. The Service object must be specified using the object id in the SOID id input parameter. |
| get details | |
|---|---|
Usage: | void getDetails (in SOID id) in TransactionMode transactionMode, inout CRID transactionId, out Attribute ValueItemSeqSeq detailsAttributes) raises (AVAutoTransactionException) |
Description: | Same as the getAllAttributes command, except this command also returns the attributes modes of the given Service object. The Service object must be specified using the object id in the SOID id input parameter. |
| list all attributes | |
|---|---|
Usage: | void listAllAttributes (in TransactionMode transactionMode, inout CRID transactionId, in SYcrbNPT::AttributeValueItemSeq criteria, out AttributeValueItemSeqSeq results) raises (AVAutoTransactionException) |
Description: | Returns the zero or more Service objects which match the given search criteria. Any attributes of the Service object can used as criteria, not just the selector attributes identified in its OAF. |
Parameters: | criteria--the search criteria, including: SOFirst=FirstNum--The number of the first object to be returned by the listAllAttributes command. The first object is numbered 1, the second is numbered 2, and so on. The default is 1. SOMax=MaxNum--The maximum number of objects to be returned by the listAllAttributes command, starting at the SOFirst object to the SOFirst + SOMax - 1) object. |
| get all profile attributes | |
|---|---|
Usage | void getAllProfileAttributes (in SOID id, in TransactionMode transactionMode, inout CRID transactionId, out SYcrbNPT::AttributeValueAndModeItemSeq profileAttributes) raises AVAutoTransactionException) |
Description: | Returns the attribute values and modes of the given Service profile. The Service profile must be specified using the object id in the SOID id input parameter. |
| list all profile attributes | |
|---|---|
Usage: | void listAllProfileAttributes (in SOID id, in TransactionMode transactionMode, inout CRID transactionId, in SYcrbNPT::AttributeValueItemSeq criteria, out AttributeValueItenSeqSeq results) raises (AVAutoTransactionException) |
Description: | Returns all attributes of zero or more Service profiles which match the given search criteria. Any attributes of the Service profile can be used as criteria, not just the selector attributes identified in its OAF. |
Parameters: | criteria--the search criteria, including: SOFirst=FirstNum--The number of the first object to be returned by the listAllAttributes command. The first object is numbered 1, the second is numbered 2, and so on. The default is 1. SOMax=MaxNum--The maximum number of objects to be returned by the thelistAllAttributes command, starting at the SOFirst object to the (SOFirst + SOMax -1) object. |
| generic requestion | |
|---|---|
Usage: | void genericrequest (in TransactionMode transactionMode, inout CRID transactionId, in SYcrbNPT::AttributeValueItemSeq transactionAttributes, in string, methodName, inout string methodParameters) raises (AvAutoTransactionException) |
Description: | This is a generic method interface, behavior is instance specific. |
Parameters: | methodName--name of the method methodParameters--the method parameters transactionAttributes--This is used to select the transaction attributes. It can be one or more of the following:briefdescription, domain, vpn. |
The NNI Resiliency Manager Interface is implemented through the following operations (also called methods):
| linkFail | |
|---|---|
Usage: | void linkFail (in LINKID link) raises (AVException) |
Description: | Re-threads the circuits running over the specified failed link. This command returns when it either succeeds or fails. |
Parameters: | link--ID of the link |
| linkRecover | |
|---|---|
Usage: | void linkRecover (in LINKID link) raises (AVException) |
Description: | Restores the specified recovered link. This command returns when it either suceeds or fails. |
Parameters: | link--ID of the link |
| linkRebalance | |
|---|---|
Usage: | void linkRebalance (in LINKID link) raises (AVException) |
Description: | Re-balances the load across links in the same group as the indicated link. This command returns when it either suceeds or fails. |
Parameters | link--ID of the link |
The UNI Resiliency Manager Interface is implemented through the following operations (also called methods):
| unifail | |
|---|---|
Usage: | void unifail (in LPNAME logical port name) raises (AVException) |
Description: | Fails a foreground logical port. This command returns when it either suceeds or fails. |
Parameters: | logical port name--name of the Logical Port name |
| unirecover | |
|---|---|
Usage: | void unirecover (in LPNAME logical port name) raises (AVException) |
Description: | Restores the foreground logical port. This command returns when it either succeeds or fails. |
Parameters: | logical port name--name of the Logical Port name |
The Transaction Manager Interface is implemented through t he following operations (also called methods). The states that a transaction goes through during processing are outlined, in order, in the list below:
| CRID create | |
|---|---|
Usage: | CRID create (in SYcrbNPT::AttributeValueItenSeq attributes) raises (AVException) |
Description: | Creates a new Transaction but does not open it. This command returns the object id of the Transaction. |
Parameters: | attributes--This is used to select the transaction attributes. It can be one of the following: briefdescription, domain, vpn. |
| Crid start | |
|---|---|
Usage: | CRID start (SycrbNPT::AttributeValueItemSeq attributes) |
Description: | Starts a new Transaction with the given BriefDescription, MD, and VPN. This command creates a new Transaction, opens it and then returns the object id of the Transaction. |
Parameters: | attributes--This is used to select the transaction attributes. It can be one of the following: briefdescription, doman, vpn. |
| Open | |
|---|---|
Usage: | void open (in CRID id) raises (AVException) |
Description: | Opens a transaction. |
Parameters: | id--specifies the Transaction ID |
| close | |
|---|---|
Usage: | void close (in CRID id) raises (AVException) |
Description: | Closes a previously opened Transaction. |
Parameters: | id--specifies the transaction ID |
| schedule | |
|---|---|
Usage: | void schedule (in CRID id) raises (AVException) |
Description: | Schedules the Transaction to be applied to the network at the specified future date. This command waits until the Transaction either succeeds to the Applied state or fails to the Abandoned state. |
Parameters: | id--specifies the transaction ID |
| apply | |
|---|---|
Usage: | void apply (in CRID id) raises (AVException) |
Description: | Applies the transaction to the network. This command waits until the Transaction either succeeds to the Applied state or fails to the abandoned state. |
Parameters: | id--specifies the transaction ID |
| abandon | |
|---|---|
Usage: | void abandon (in CRID id) raises (AVException) |
Description: | Abandons the Transaction. This command waits until the Transaction is abandoned. |
Parameters: | id--specifies the transaction ID |
| abort | |
|---|---|
Usage: | void abort (in CRID id) raises (AVException) |
Description: | Aborts the Transaction in the Scheduled state and returns it to the Ready state. This command waits until the Transaction is abandoned. |
Parameters: | id--specifies the transaction ID |
| del | |
|---|---|
Usage: | void del (in CRID id) raises (AVException) |
Description: | Deletes the Transaction and all associated files. It deletes the Transaction by closing it if it is open or abandoning it if it is in the R eady st ate. Delete is possible from th Ready and Current states. |
Parameters: | id--specifies the transaction ID |
| setAttributes | |
|---|---|
Usage: | void setAttributes (in CRID id, in SYcrbNPT::AttributeValueItemSeq attributeNames, out SYcrbNPT::AttributeValueItemSeq attributes) raises (AVException) |
Description: | Provides the user with a mechanism for modifying the value of briefdescription, domain, and vpn. |
Parameters: | id--specifies the transaction ID attributeNames--attribute names attributes--This is used to select the transaction attributes. It can be one of the following: briefdescription, domain, vpn. |
| getAttributes | |
|---|---|
Usage: | void getAttributes (in CRID id) in SYcrbNPT::AttributeValueItemSeq attributes) raises (AVException) |
Description: | Provides the user with a mechanism for getting the values for a specified set of object attributes and their associated modes. |
Parameters: | id--specifies the transaction ID attributesNames--attribute names attributes--returned attribute name and values |
| getAllAttributes | |
|---|---|
Usage: | void getAllAttributes (in CRID id) in SYcrbNPT::AttributeValueItemSeq attributes) raises (AVException) |
Description: | Provides the user with a mechanism for getting all values. |
Parameters: | id--specifies the Transaction ID attributes--returned attribute name and values |
| listAllAttributes | |
|---|---|
Usage: | void listAllAttributes (in CRID id) in SYcrbNPT::AttributeValueItemSeq criteria) raises (AVException) |
Description: | Lists Transactions and returns all of the attributes of matching objects |
Parameters: | criteria--search criteria, including: SOFirst=FirstNum--The number of the first object to be returned by the listAllAttribute command. The first object is numbered 1, the second 2, and so on. The default is 1. SOMax=MaxNum--The maximum number of objects to be returned by the listAllAttributes command, starting at the SOFirst object to the (SOFirst + SOMax -1) object. |
The SYcrbAV Session Factory interface is derived from the SYcrbNPT interfaces. It is implemented through the following operations (also called methods):
| create master | |
|---|---|
Usage: | Session createMaster (in string userName, in string sessionType) raises (NptException) |
Description: | Creates a session. The user name determines access privileges. |
| attach master | |
|---|---|
Usage: | Session attachMaster (in ObjectId sessioniId) raises (NptException) |
Description: | Attaches to an existing session specifiying the session object id. |
| attach master long | |
|---|---|
Usage: | Session attachMasterL (in long sessionid) raises (NptException) |
Description: | Attaches to an existing session specifying the session id as an integer. |
The SYcrbAV Session interface is derived from the SYcrbNPT interfaces. It is implemented thought the following operations (also called methods):
| get services | |
|---|---|
Usage: | CosNaming::Naming Context getServices () |
Description: | Get the list of services. |
| get session id | |
|---|---|
Usage: | DbId getSessionId () |
Description: | Returns the session id as an integer. |
| get open CR | |
|---|---|
Usage: | PersistentId getOpenCR () raises (NptException) |
Description: | Returns to the current Transaction object id. |
| remove | |
|---|---|
Usage: | void remove () |
Description: | This operation ends the session. |
The lister interface is implemented through the following operations (also called methods):
| get object ID | |
|---|---|
Usage: | ObjectId get ObjectId () raises (NptException) |
Description: | 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. |
| get criteria | |
|---|---|
Usage: | void GetCriteria (outSearchItemSeq searchList), out AttributeItemSeq columnList, out OrderByItemSeq orderByList, out UniqueByItemSeq uniqueByList, out boolean noDeletePending) raises (NptException) |
Description: | Gets the criteria set in a previous getList. |
Parameters: | searchList--the search criteria columnList--the object attributes to be returned orderByList--specifies which column(s) the results should be sorted by, and whether ascending or descending order is required uniqueByList--specifies the column(s) used to identify and remove duplicate rows in the results |
| get list | |
|---|---|
Usage: | void getList (outSearchItemSeq searchList), out AttributeItemSeq columnList, out OrderByItemSeq orderByList, in UniqueByItemSeq uniqueByList) raises (NptException) |
Description: | 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 Cisco Provisioning Center Server. Results are subsequently obtained by the Client by calling getItems. |
Paramters: | searchList--the search criteria columnList--the object attributes to be returned orderByList--specifies which column(s) the results should be sorted by, and whether ascending or descending order is required uniqueByList--specifies the column(s) used to identify and remove duplicate rows in the results |
| get full list | |
|---|---|
Usage: | void getFullList (outSearchItemSeq searchList), out AttributeItemSeq columnList, out OrderByItemSeq orderByList, out UniqueByItemSeq uniqueByList) raises (NptException) |
Description: | 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. |
Parameters: | searchList--the search criteria columnList--the object attributes to be returned orderByList--specifies which column(s) the results should be sorted by, and whether ascending or descending order is required uniqueByList--specifies the column(s) used to identify and remove duplicate rows in the results |
| get count | |
|---|---|
Usage: | long getCount () raises (NptException) |
Description: | Provides the user with a mechanism for getting the count of records which match the search criteria. Note that this can be called only after calling getList or getFullList |
| get items | |
|---|---|
Usage: | void getItems (in long fromItem, in long toItem, out AttributeItemSeq names, out AttributeResultItemsSeqSeq results) raises (NptException) |
Description: | Provides the user with a mechanism for getting the object which matched the search criteria. The following data is returned for each object which matched the search critieria: 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. |
Parameters: | fromItem--the index of the first results row to be returned (numbered for 1, not 0) toItem--the index of the last results row to be returned names--attribute column names for returned results results--attribute values (first dimension select the row, second dimension selects the column) |
| clear list | |
|---|---|
Usage: | void clearList () raises (NptException) |
Description: | Clears the result list of the last getList or getObject. This frees up memory resources on the Cisco Provisioning Center Server but does not remove the CORBA Lister object. The perferred 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. |
| get permited actions | |
|---|---|
Usage: | void getPermittedActions (in ActionItemSeq actions, out PermissionItemSeq permission) raises (NptException) |
Description: | Provides the user with a mechanism for determining whether or not a set of actions is permitted. |
| get reason not permitted | |
|---|---|
Usage: | string getReasonNotPermitted (in string actionName, out ErrorName number) raises (NptException) |
Description: | This operation returns the reason why the action is not permitted. |
Parameters: | number--returns an error number |
| generic request | |
|---|---|
Usage: | void genericRequest (in string command, inout string parameters) raises (NptException) |
Description: | This is a generic method interface, behavior is instance specific. |
Parameters: | command--the command name parameters--the string parameter |
| integrated request | |
|---|---|
Usage: | void intergratedRequest (in string command, inout string parameters) raises (NptException) |
Description: | The is a generic method interface, behavior is instance specific. |
Parameters: | command--the command name inputParameter--one input string parameter for the command outputParameter--one output string parameter for the command |
| get sub types | |
|---|---|
Usage: | void getSubtypes (out SubtypeItemSeq subtypeList) raises (NptException) |
Description | 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. |
| remove (from CosLifeCycle::LifeCycleObject) | |
|---|---|
Usage: | void remove () |
Description: | Deletes the Lister object from the Cisco Provisioning Center Server. |
Site Item Lister is derived from Lister. It supports all of the methods defined for Lister, plus the following. Site Item Lister is used to list the attributes of sites associated with a specific Transaction.
| set CR | |
|---|---|
Usage: | void setCR (in PersistentId changeOrderId) raises (NptException) |
Description: | Associate the site item lister with the specified Transaction |
Parameters: | changeOrderId--ID of the Change Request |
The event source interface is implemented through the following operations (also called methods):
| enable event | |
|---|---|
Usage: | void enableEvent (in string eventClass, in string eventType, in ObjectIdSeq modelIds, in FilterMode filter) raises (NptException) |
Description: | Selects the types of events forwarded to the event channel. By default, no events are forwarded. This method can be called more than once and the results are cumulative. |
Parameters: | eventClass--the class of the event eventType--the type of the event modellds--a list of the model for which the event was generated |
| disable event | |
|---|---|
Usage: | void disableEvent (in string eventClass, in string eventType, in ObjectIdSeq modelIds, in FilterMode filters) raises (noSuchEvent, NptException) |
Description: | Disables a type of events that was previously enabled. |
Parameters: | eventClass--the class of the event eventType--the type of the event modelIds--a list of the model for which the event was generated |
| get event channel | |
|---|---|
Usage: | CosEventChannelAdmin::EventChannel getEventChannel () |
Description: | Get the CORBA event channel associated with this EventSource. |
| get event source ID | |
|---|---|
Usage: | EventSourceId get EventSourceId () |
Description: | Get the EventSourceId of this EventSource. |
| create event source | |
|---|---|
Usage: | EventSource createEventSource (in CosEventChannelAdmin::EventChannel channel, out EventSourceId id) raises (NptException) |
Description | Forwards internal Cisco Provisioning Center database change events onto a CORBA Event Service channel. The client application is responsible for creating (and deleting) the event channel. The event channel is passed as an input parameter tot his method. A reference to the EventSource object created is returned as well as the assigned EventSource Id. Creates a new EventSource object. An EvenSource object is an object within the Cisco Provisioning Center Server. |
Parameters: | channel--the event channel id--ID of the event source |
| destroy event source | |
|---|---|
|
|
|
|
|
|
| get event source | |
|---|---|
Usage: | EventSource getEventSource (in EventSourceId) raises (noSuchEventSource) |
Description: | Returns a r eference to the EventSource object given its EventSourceId. |
Parameters: | id--Id of the event source |
| get all event sources | |
|---|---|
Usage: | EventSourceIdSeq getAllEventSources () |
Description: | Returns the EventSourceIds of all of the EventSources in this session. |
The metadata Server interface is implemented through the following operations (also called methods):
| get all attribute names | |
|---|---|
Usage: | void getAllAttributeNames (in Classid className,out AttributeItemSeq names) raises (Npt Exception) |
Description: | Returns all attribute names for the specified class. |
Parameters: | className--the classname, defined in the OAF names--the list of attribute names |
Upload Request in derived from Persistent. It supports the methods defined for Persistent plus the following:
| abort upload request | |
|---|---|
Usage: | perationaborts an upvoid abort () raises (NptException) |
Description: | This operation aborts an upload request that is running. |
Upload Request Factory is derived from Persistent Factory. The upload request factory interface is implemented through the following operations (also called methods):
| bind upload request | |
|---|---|
Usage: | UploadRequest bindUploadRequest (in PersistentId id) raises (NptException) |
Description: | This operation passes an object id for the upload request into the bind and it will give you a CORBA object reference to the upload request. |
Parameters: | id--specifies the persistent object ID. |
Network Element is derived from Managed, which is derived from Persistent. The network element interface is implemented through the following operations (also called methods):
| upLoad | |
|---|---|
Usage: | PersistentId upLoad (in UpLoadItemSeq parameters) raises (NptException) |
Description: | 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 finishes processing. If an error occurs, the UROld is set to "". |
Parameters: | parameters--these are equipment module specific |
Network Element Factory is derived from Persistent Factory. The network element factory interface is implemented through the following operations (also called methods):
| create network element | |
|---|---|
Usage: | NetworkElement createNetworkElement (in ClassId nptClassName) raises (NptException) |
Description: | Create a network element. |
Parameters: | nptClassName--the classname, defined in the OAF |
| bind network element | |
|---|---|
Usage: | NetworkElement bindNetworkElement (in PersistentId id) raises (NptException) |
Description: | This operation passes an object id for the network element into the bind and it will give you a CORBA object reference for the network element. |
Parameters: | id--specifies the persistent object ID |
The persistent interface is implemented through the following operations (also called methods).
| is new | |
|---|---|
Usage: | boolean is New () raises (NptException) |
Description: | If this operation returns TRUE this is a new object, FALSE otherwise. |
| get persistent ID | |
|---|---|
Usage: | PersistentId getPersistentId () raises (NptException) |
Description: | Get persistent ID for the object. |
| set parent | |
|---|---|
Usage: | void setParent (in PersistentId parent) raises (NptException) |
Description: | Set the parent. |
Parameters: | parent |
| get mode | |
|---|---|
Usage: | Mode getMode (in AttributeName attributeName) raises (NptException) |
Description: | Get the mode for the specified attribute. If the object has an associated profile, then the mode is defined by the profile for profiled attributes. |
| get value | |
|---|---|
Usage: | AttributeValue getValue (in AttributeName attributeName) raises (NptGetValueException, NptException) |
Description: | This operation gets the modified value of the specified attribute. The modified version is the version of the object in memory which can not yet been saved |
| overwrite value | |
|---|---|
Usage: | ovid overwriteValue (in AttributeName attributeName, in AttributeValue attributeValue) raises (NptException) |
Description: | This operation sets the values of the specified attributes without checking for mode of the attributes. |
Parameters: | attributeName--the attribute name attributeValue--the attribute value |
| get attributes | |
|---|---|
Usage: | void getAttributes (in AttributeItemSeq attributes, out AttributeValueItemSeq results) raises (NptException) |
Description: | Provides the user with a mechanism for getting the values for a specified set of object attributes. |
| get attributes and mode | |
|---|---|
Usage: | void getAttributesandMode(in AttributeItemSeq attributes, out AttributeValueandModeItemSeq results) raises (NptException) |
Description: | Provides the user with a mechanism for getting the values for a specified set of object attributes and their associated modes. |
| get attributes and GUI mode | |
|---|---|
Usage: | void getAttributesGuiMode (in AttributeItemSeq attributes, out AttributeValueandGuiModeItemSeq results) raises (NptException) |
Description: | Provides the user with a mechanism for getting the values for a specified set of object attributes and their GUI modes. |
| set attributes | |
|---|---|
Usage: | void setAttribute (in AttributeValueItemSeq attributeList, out raises (NptException) |
Description: | Provides the user with a mechanism for setting the values for a specified set of object attributes. The value of the attributes are set in memory but not into the database until a save is done. |
Parameters: | attributeList--attribute list |
| overwrite attributes | |
|---|---|
Usage: | void overwriteAttributes (in AttributeValueItemSeq attributeList) raises (NptException) |
Description: | This operation sets the values of the specified attributes without checking for the mode of the attributes. |
Parameters: | attributeList--attribute list |
| set assocaition by name | |
|---|---|
Usage: | void setAssociationByName (in AttributeName attributeName) raises (NptException) |
Description: | Set association by criteria. |
Parameters: | attributeName--the attribute name criteria |
| get permitted actions | |
|---|---|
Usage: | void getPermittedActions (in ActionItemSeq actions, out PermissionItemSeq permission) raises (NptException) |
Description: | Provides the user with a mechanism for determining whether or not a set of actions is permitted. This is typicall used by viewers and scripters. |
| get reason not permitted | |
|---|---|
Usage: | string getReasonNotPermitted (in string actionName, out ErrorNumber number) raises (NptException) |
Description: | This operation returns the reason why the action is not permitted. |
Parameters: | actionName--This is the specified action (for example, getList action) number--This is the returned error number of the reason. |
| generic request | |
|---|---|
Usage: | void genericRequest (in string command, inout string parameters) raises (NptException) |
Description: | This is a generic method interface, behavior is instance specific. |
Parameters: | command--the command name parameters--the string parameter |
| integrated request | |
|---|---|
Usage: | void intergratedRequest (in string command, in string inputParameters, out string outputParameter) raises (NptException) |
Description | This is a generic method interface, behavior is instance specific. |
Parameters: | command--the command name inputParameter--one input string parameter for the command outputParameter--one output string parameter for the command |
| get translated text | |
|---|---|
Usage: | string getTranslatedText (in string text) raises (NptException) |
Description: | Provides the user with a mechanism for translating (coverting) a text string. This is typically used by viewers to create the window title. |
Parameters: | text--text string. |
| undo | |
|---|---|
Usage: | void undo () raises (NptException) |
Description: | 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. |
| save | |
|---|---|
Usage: | void save (inout AttributeErrorItemSeq errorList) raises (NptException, NptSave Exception) |
Description: | 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. |
| remove | |
|---|---|
Usage: | void remove (inout AttributeErrorItemSeq errorList raises (NptException, NptSaveException) |
Description: | Provides the user with a mechanism for removing (deleting) the object. The errorList parameter is normally not used. |
The persistent factory interface is implemented through the following operations (also called methods):
| create object | |
|---|---|
Usage: | Persistent createObject (in ClassId, nptClassName) raises (NptException) |
Description: | Create object. |
Parameters: | nptClassName--the classname, defined in the OAF |
| bind object | |
|---|---|
Usage: | Persistent bindObject (in PersistentId id) raises (NptException) |
Description: | This operation passes on an object id for the object into the bind and it will give you a CORBA object reference for the object. |
Parameters: | id--ID of the object |
| get object class | |
|---|---|
Usage: | ClassId getObjectClass (in PersistentId id) raises (NptException) |
Description: | Get object class |
Parameters: | id--ID of the object |
| create lister | |
|---|---|
Usage: | Lister CreateLister (in ClassIf nptClassName) raises (NptException) |
Description: | Create lister for the specified class name. |
Parameters: | nptClassName--the classname, defined in the OAF. |
| bind lister | |
|---|---|
Usage: | Lister bindLister (in ObjectId id) raises (nptException) |
Description: | This operation passes an object id for the lister into the bind and it will give you a CORBA object reference for the lister. |
Parameters: | id--ID of the lister. |
| create new site item lister | |
|---|---|
Usage: | SiteItemLister createSiteItemLister (in objectId coid) raises (NptException) |
Description: | Create site item lister for the specified object ID. |
Parameters: | coid--This specifies the Transaction or change order object id. |
Managed is derived from Persistent. Managed adds the following methods:
| revert | |
|---|---|
Usage: | void revert (inout AttributeErrorItemSeq errorList) raises (NptException, NptSaveException) |
Description: | Provides the user with a mechanism for reverting changes to the object. An object reverts by deleting all of its pending records. |
Parameters: | errorList--normally not used get pending operation |
| get pending operation | |
|---|---|
Usage: | void getPendingOperation () raises (NptException) |
Description: | Gets the pending operation for the object. See SYcrbNPT::PendingOperation for return enum. |
Parameters: | seekOffset--the index into the file of the first byte to be returned nBytes--the number of bytes form seekOffset forward to be read for the file. data--the requested bytes from the file. returnvalue--the actual number of bytes returned. |
The Log File Server interface provides read access to Cisco Provisioning Center log files.
| read | |
|---|---|
Usage: | unsigned long read (in string fileName, in long seekOffset, in unsigned long nBytes, out charSeq data) raises (NptException) |
Description: | read log file by name. |
Parameters: | filename--the name of the file relative to the $CCP_REL/log directory |
| readAudit | |
|---|---|
Usage: | unsigned long readAudit (in long crId, in long seekOffset, in unsigned long nBytes, out charSeq data) raises (NptException) |
Description: | Read audit log file by Transaction number. |
Parameters | crld--the Transaction number |
| readSite | |
|---|---|
Usage: | unsigned long readSite (in long CrId, in string siteName, in long seekOffset, in unsigned long nBytes, out charSeq data) raises (NptException) |
Description: | Read site log file by site name and Transaction number. |
Parameters: | crld--the Transaction number siteName--the site name |
| readSiteError | |
|---|---|
Usage: | unsigned long readSite (in long CrId, in string siteName, in long seekOffset, in unsigned long nBytes, out charSeq data) raises (NptException) |
Description: | Read site error log file by site name and Transaction number. |
Parameters: | crId--The transaction number siteName--the site name |
| readEvent | |
|---|---|
Usage: | unsigned long readEvent (in long seeOffset, in unsigned long nBytes, out charSeq data) raises (NptException) |
Description: | Read the event file. |
| readSystemAdmin | |
|---|---|
Usage: | unsigned long readSystemAdmin (in long seekOffset, in unsigned long nBytes, out charSeq data) raises (NptException) |
Description: | Read the system admin file. |
![]()
![]()
![]()
![]()
![]()
![]()
![]()
Posted: Thu Aug 3 16:30:30 PDT 2000
Copyright 1989-2000©Cisco Systems Inc.