Please enable JavaScript to view this site.

A-Shell Development History

(Linux only) Add new subroutine XMPP.SBR, which allows sending of instant messages using the XMPP protocol (Extensible Message and Presence Protocol, aka Jabber) to third party instant messaging systems implementing that protocol. Compatible examples include the OpenFire messaging server and Pidgin client.

xcall XMPP, op, fromid, pw, server, port, toid, msg, msgid, flags

Parameters

op  (num)  [in]

Operation code:

Value

Meaning

1

connect, send message, disconnect

 

status  (signed num)  [out]

Return code:

Value

Meaning

0

success

-1

failed to initialize the xmpp library

-2

unable to open xmpp.log

-3

failed to initialize connection structure

-4

failed to set server connection options

-5

failed to connect (authentication? unreachable?)

-6

failed to disconnect

 

fromid  (str)  [in]

JID (Jabber ID) of sender, using syntax name@domain. Must be recognized by server for authentication.

pw (str)  [in]

Authentication password for sender. Currently plain text. Encryption options to be added later.

server (str)  [in]

Hostname or IP address of messaging server

port  (num)  [in]

Port to connect to server on (0 = default: 5222)

toid  (str)  [in]

JID of the receipient (individual or group), e.g. name@domain

msg (str) [in]

Text of message. There is no inherent limit to the length; dynamic strings (S,0) supported.

msgid (str)  [in]

Short string to identify message, preferably unique. Mainly of use for tracking messages within the server.

flags (num)  [in]

option flags (zero or more of the following)

Value

 

Meaning

AXMPPF_LOG

&h0001

output traces to ashmpp.log

AXMPPF_TRUST_TLS

&h0002

trust all TLS certs

AXMPPF_DISABLE_TLS

&h0004

disable TLS; use insecure connect

AXMPPF_DEBUG

&h0008

low level tracing to xmpp.log