Overview
ARSperl is an integration kit for
Perl5.x and
Remedy ARS 2.x and 3.x API. It
provides a subset of the functionality found in the ARS C API. The source
code to the integration kit and example scripts is made available under the
GPL.
We hope that other ARS fans find the kit useful.
Version
The current release it Version 1.61 and will compile against ARS 2.0,
2.1 and 3.x API libraries.
Support OS's
The perl extension has only been tested on the following OS's:
- Solaris 2.x
- SunOS 4.x
- Irix
- HP-UX
- AIX
- Windows NT
FAQs
We have some useful
excerpts from the mailing lists online.
Bug Reports
If you come across a bug (i.e. it crashes with a SEGV or something like
that) you can report them to:
arsperl-bugs@smurfland.cit.buffalo.edu
Be sure to include the following information in your message:
- OS (operating system) version (example: Solaris 2.5)
- Perl version (example: 5.003)
- ARS version (example: 2.1)
- ARS version (example: 2.1.3)
- ARSperl version (example: 1.42)
- A fragment of the script that causes the crash.
Example:
ars_CreateEntry($ctrl, $schema, $id, $val, $id2, $val2);
- The values of any parameters that you pass to the call that
fails.
Example:
$schema = "AD-Help Desk"
$id = 12345678
$val = "foo"
$id = 24681357
$val = "yadda"
The best way to obtain these values is to use a "print" statement
right before the call that fails.
If you have any other questions or comments you
should subscribe to the mailing list and ask them there.
Mailing List
A mailing list is available for discussions of this perl extension.
Archives of the mailing list are also available.
How to subscribe
Send an email message to majordomo@lurch.cit.buffalo.edu
with a body of ``subscribe arsperl
''. The subject line is
ignored.
Utilities
Utilities that we've written with ARSperl that are handy to have. These
can be found in the examples directory of the distribution.
- WhoUsesIt.pl
-
A script to help you track down filters, schemas etc. Good
for when you try to document your system layout.
- DumpSetup.pl
-
A utility for maintaining backup copies of server definitions
(when run nightly as a cron job).
- AddUsersToGroup.pl
-
Add multiple users to a group.
- DelUsersFromGroup.pl
-
Remove multiple users from a group.
Programmer's Guide
An online guide is available to help use the
functions that this kit adds to the standard perl distribution.
Last Updated: 17 Sep 98
arsperl@smurfland.cit.buffalo.edu
The Remedy Logo is a trademark of Remedy Corporation.