Cisco Cisco Prime Optical 10.6 Developer's Guide

Page of 665
Cisco Prime Optical 10.6 GateWay/CORBA Programmer Reference Guide 
 
 
146
 
3.5.1  getEmsSession 
Synopsis 
Description 
This interface enables the NMS to obtain the EmsSession_I object, which contains all managers of the 
EMS. 
Prime Optical allows 4 to 25 concurrent login sessions and as many user profiles as required for 
configuring the number of concurrent login sessions. See 
 to 
configure the number of concurrent login sessions. The username and password must contain from 1 to 53 
characters. 
This interface can also accept the encrypted username and password. To enable encryption on the 
username and password, check the Enable encryption for username and password check box in the 
Prime Optical client Control Panel for the GateWay/CORBA service. Prime Optical then decrypts the 
username and password accordingly. 
To encrypt the username and password, you must use the RSA algorithm with the public key or the public 
key pair provided by Prime Optical. To obtain the Prime Optical public key, use the 
emsSessionFactory::EmsSessionFactory_I::getEmsPublicKey API. To obtain the Prime Optical public 
key pair, use the emsSessionFactory::EmsSessionFactory_I::getEmsPublicKeyPair API. 
Parameters 
Name 
Type 
Input/ 
Output 
Description 
user 
String 
In 
User or application that is trying to access 
the server. This user must have a profile 
created in Prime Optical. 
password 
String 
In 
Password for the user application. 
client 
nmsSession::NmsSession_I  In 
Handle to the NMS NmsSession_I object, to 
which the returned EmsSession_I object 
must be associated. 
emsSessionInterface  emsSession::EmsSession_I  Out 
CORBA Interoperable Object Reference 
(IOR) for the EmsSession_I interface. 
 
Throws 
Compliance 
TMF-defined.