ARSperl: ARS2.x-3.x / Perl5 integration kit

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.

Release Notes

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.

Installation

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.