Utilizing the shell version
Integrating with CGI applications
Integrating with HyperThread
Like any program existing on your website, the AMS can be used within other Perl-based CGI scripts via backtick execution.
Utilizing the shell version
Integrating the AMS with other CGI scripts involves the use of the shell-based AMS (ams_shell.pl), the ams_ssi.cgi program will not work in most cases, and it is generally advised to use the shell version only.
Integrating with CGI applications
Suppose you have your AMS installed in the same absolute pathname used
in the above examples (/usr/local/etc/httpd/cgi-bin/ams_shell.pl) and
also assume your Perl interpreter is installed as /usr/local/bin/perl.
The following Perl code excerpt will call your AMS and return the html containing the adbar and its associated website link, then print it back to the web browser.
$perl = "/usr/local/bin/perl";
$ams = "/usr/local/etc/httpd/cgi-bin/ams_shell.pl";
$ams_html = `$perl $ams`;
print $ams_html;
Using the AMS in this fashion allows your script to be easily modified, simply substitute the proper perl location and AMS location in the defined variables. As with the SSI based version, you can display the returned adbar html source displayed as you like. Just add the necessary html tags to the text you print to the web browser.
Explicit rules can also be used with this implementation exactly as they were used with the #exec cmd examples above. For example, to use the rule AD:USE_THIS_RELATION use the following:
$perl = "/usr/local/bin/perl";
$ams = "/usr/local/etc/httpd/cgi-bin/ams_shell.pl";
$rule = "AD:USE_THIS_RELATION";
$ams_html = `$perl $ams $rule`;
print $ams_html;
Integrating with HyperThread
Your AMS system may also be integrated with the latest version of
the Radiation Hyperthread. A special "CALL" tag has been created for accomplishing this.
To use the CALL tag you simply add it to your template.html
Hyperhread template file (See your Hyperthread Documentation). The CALL tag is formated as follows (assuming the perl and AMS locations used in above examples hold true):
<!--CALL shell="/usr/local/bin/perl /usr/local/etc/httpd/cgi-bin/ams_shell"-->
As with the #exec cmd SSI tag illustrated above, you may also pass specific rules to the AMS using the CALL tag. Suppose, for example, that you have a relation defined for use with your Hyperthread, and that this relation uses the rule AD:USE_DISCUSS. The following CALL tag will invoke your AMS to produce the desired adbar for the discussion system:
<!--CALL shell="/usr/local/bin/perl /usr/local/etc/httpd/cgi-bin/ams_shell AD:USE_DISCUSS"-->
Notes: (1) Be sure to construct the CALL tag so that the whole tag is placed on just one line. Your web browser might be displaying the above CALL tag examples wth line breaks; however, the entire tag must be placed on a single line. (2) You can use any rule names you like with your system. For consistency we have used all rules with the 'AD:etc' format, but you need not stick to this convention (however, you can not use the "=" sign or "+" symbol).
