Stand Alone Installation
Most users will install the SRP Mail Utility using the SRP Mail Utility Installer downloaded from the website. The installer places the SRPMail.dll into your OpenInsight directory and adds several modules to your application. Simply follow the install prompts to complete the process. You will be prompted to enter the SYSPROG username and password since the components will be installed into the SYSPROG application.
RDK Installation
The website does not provide an RDK, but we are willing to provide you with one upon request. Usually, this is only needed if, for some reason, the stand alone installation fails to execute. Our RDKs always contain a subdirectory for each version of OI. In other words, the zip file will contain an RDK for each version of OI. To install one of our RDKs, just follow these simple steps:
1. Extract the ZIP file to an empty directory.
2. From an OpenInsight command prompt, type "RUN RDKINSTALL <DIR>" where <DIR> is the directory containing the RDK that matches your version of OI.
3. Verify that all the components (see below) were installed.
Note that there will not be a directory for each minor release of OpenInsight. For instance, both OpenInsight versions 7.2 and 7.2.1 will use the 7.2 subfolder.
Components
The following files are installed into the OpenInsight directory:
File | Description |
---|---|
SRPMail.dll | Contains the SRP Mail Utility API execution logic. |
SRP_Mail.chm | The SRP Mail Utility help document. |
The following entities are installed to the SYSPROG application:
Type | Entity | Description |
---|---|---|
Application Rows | SYSREPOSRELEASES:SYSPROG_SRP_MAIL_RDK SYSREPOSVIEWS:SYSPROG_SRP_MAIL_RDK | Deployment Definition for SPR Mail RDK Repository View for SPR Mail RDK |
DLLs | SRPMAIL | Entity Pointer to SRPMail.DLL file |
HTML Document | SAMPLE_HTML_EMAIL | The sample HTML email used in the SRP Mail Demo window |
BMP Image | SRPICON | SRP Icon Bitmap |
ICO Image | SRP | SRP Icon |
Message Boxes | SRP_MAIL_DEMO | Message Box used in the SRP Mail Demo window |
OpenInsight Form Executables | SRP_MAIL_DEMO | The SRP Mail Demo window |
OpenInsight Forms | SRP_MAIL_DEMO | The SRP Mail Demo window (source) |
Stored Procedure Debug Tables | SEND_EMAIL_SAMPLE SRP_MAIL_DEMO_EVENTS | Sends an email; used in the SRP Mail Demo window Commuter module for SRP Mail Demo window |
Stored Procedure Executables | SEND_EMAIL_SAMPLE SRPSENDMAIL SRP_SEND_MAIL SRP_MAIL_DEMO_EVENTS | Sends an email; used in the SRP Mail Demo window deprecated. Retained for backward compatability. The SRP_Send_Mail stored procedure Commuter module for SRP Mail Demo window |
Stored Procedure Inserts | SRPMAIL_INSERTS | The SRP Mail Utility inserts for use with the SRP_Send_Mail function |
Stored Procedures | SEND_EMAIL_SAMPLE SRP_MAIL_DEMO_EVENTS | Sends an email; used in the SRP Mail Demo window (source) Commuter module for SRP Mail Demo window (source) |
Windows Help Files | SRP_MAIL | Entity pointer to the SRP_Mail.chm file |
SRPMail.dll
The SRPMail.dll must reside either in your OpenInsight directory or in your Windows System32 folder. If, for any reason, this file is missing, then download the installation from our website to reinstall.
SRP Email Executables
The SRP Mail Utility Install should have installed one stored procedure executable. Examine the SYSOBJ to verify the existence of $SRP_SEND_MAIL. If this record is missing, you can re-run the setup or manually add it using the following steps:
1. Create a new record
2. Copy and Paste the following text
SRPMAIL LPASTR STDCALL SRPSendMail(LPASTR, LPASTR) LPASTR STDCALL SRPSendMail(LPASTR, LPASTR) AS SRP_Send_Mail
3. Save the record in SYSPROCS as DLL_SRP_MAIL
4. From the command line, type the following:
run declare_fcns "DLL_SRP_MAIL"
SRPMAIL_INSERTS
The SRP Mail Utility Install should have installed an Insert record called SRPMAIL_INSERTS. The contents of the insert are provided below in the event that the SRPMAIL_INSERT did not install or was lost:
Compile insert SRPMAIL_INSERTS Declare function SRPSendMail, SRP_Send_Mail //----------------------------------- // Configuration // fields Equ SendUsing$ to 1 Equ SMTPServerPickupDir$ to 2 Equ SMTPServerPort$ to 3 Equ SMTPServer$ to 4 Equ SMTPAuthenticate$ to 5 Equ SMTPSendUsername$ to 6 Equ SMTPSendPassword$ to 7 Equ SMTPUseSSL$ to 8 // SendUsing values Equ SendUsing_Pickup$ to 1 Equ SendUsing_Port$ to 2 // SMTPServerPort values Equ SMTPServerPortDefault$ to 25 //----------------------------------- // Message // fields Equ SRPMail_Subject$ to 1 Equ SRPMail_From$ to 2 Equ SRPMail_To$ to 3 Equ SRPMail_Cc$ to 4 Equ SRPMail_Bcc$ to 5 Equ SRPMail_ReplyTo$ to 6 Equ SRPMail_BodyType$ to 7 Equ SRPMail_Body$ to 8 Equ SRPMail_Attachments$ to 9 Equ SRPMail_Importance$ to 10 // Importance Levels Equ SRPMail_Importance_Low$ to 0 Equ SRPMail_Importance_Normal$ to 1 Equ SRPMail_Importance_High$ to 2