Sample Jacl scripts

Sametime® Gateway Server includes several sample scripts written in Jacl (Java™ TCL) to add communities to Sametime Gateway Server, give users access to communities, enable logging, and set properties on message handlers.

Script location

The sample Jacl scripts are located in the stgw_server_root/samples/scripts directory.

For additional information about default paths, see Directory conventions.

Jacl scripts

Jacl scripts are a non-graphical alternative that you can use to configure and manage the Sametime Gateway Server. The WebSphere® administrative scripting tool, wsadmin, is a non-graphical command interpreter environment enabling you to run administrative operations on a server in Jacl.

The scripts perform some of the functions available using the Integrated Solutions Console. But in some cases, the scripts offer increased flexibility. For example, when using the graphical interface to add or update an external community that uses a SIP-based protocol, you must use TLS (Transport Layer Security) as the transport protocol. The updateExternalCommunity script commands allows you to use other transport protocols such as TCP or UDP.

The sample scripts include documentation inside each script. See the script and script command reference for command details and syntax.

Table 1. Sample Jacl scripts
Script Purpose
updateExternalCommunity.jacl Updates the external community by changing its properties such as hostname, domains, port number, and so on.
GiveAllAcl.jacl Gives all local Sametime users access to an external community.
disableAuthz.jacl Disables the authorization controller message handler. The Authorization controller's main task is to allow or disallow the initiator of the message in one community to perform the requested operation with the destination user in another community.
EnableEventlogging.jacl Enables content, instant message, or presence logging in the systemOut.log file.
getMsghandlerList.jacl Gets information on message handlers, including message handler names.
updateMsghandler.jacl Configures a message handler by setting its properties.