PERL INTERFACE Sample Clauses

PERL INTERFACE. The Perl interface is a programming interface. Here, the Perl program (to be developed and maintained at Simi Valley) connects to the provisioning system and issues commands in the form of Data Blocks. These commands are very similar to the commands issued by the provisioning system to the server side modules. Consequently, large parts of data structure will be reused between Perl/Provisioning system interface and Provisioning system/Servers interfaces. The Perl interfaces will call up provisioning system on IP port 48000. The data structures that will be passed are struct T_PERL_INTF{ int nVersion; long lBufferSize; int nCommand; int eServerType; char szDomainName[32]; char szAdminUserName[32]; char szAdminPassword[16]; char szUserName[32]; char szUserPassword[16]; int nReturnValue; char szErrorMsg[128]; }; This is the primary building block for all communication structures. This structure contains Version information, full command description, Domain name, Admin user name and password. All subsequent structures are more specific and are described along with interface functionality description. A few fields whose behavior remains constant are explained here and will normally not be described in other sections. They will have further description in other sections only if their immediate behavior differs from the description provided here or values to be used are specified. nVERSION: Holds the version number of the data block. This version number permits clients with different version numbers to communicate with the same server. This field is filled on input. lBUFFERSIZE: Holds the size of the complete buffer. This field will become critical when the data passed will contain variable length fields. This field is filled on input and output. nCOMMAND: Holds the actual command to be executed. This field is filled on input. The permissible values are: - CMD_CREATE - CMD_QUERY - CMD_ALTER - CMD_DELETE - CMD_CHECKAVAILABLE nSERVERTYPE: Holds the type of server that the command is meant for. This field is filled on input. The permissible values are: - SERVER_DOMAIN - SERVER_VIRTUALWEB - SERVER_MAIL - SERVER_USER_FTP - SERVER_USER_MAIL