Whatever message this page gives is out now! Go check it out!

setStatus

Last update:
May 18, 2026

Description

Sets the online presence status of the gateway, including any custom away message.

Syntax

Boolean = setStatus(status, customAwayMsg)

See also

Parameters

ParameterDescription
status
The gateway's online presence status; one of the following:
  • ONLINE
  • AWAY
  • DND(Do Not Disturb)
  • NA(Not Available)
  • FREE_TO_CHAT
  • IDLE
XMPP only
  • NA (Not Available)
  • FREE_TO_CHAT
  • IDLE
Sametime only:
  • IDLE
customAwayMsg
A text string containing a custom message for the status. Can be the empty string if you do not need a custom away message.

Returns

True, if the operation was successful; False. otherwise. Passing an invalid status for the protocol causes this method to return False.

Usage

Do not use the setStatus method to go offline. Although the method accepts a parameter of OFFLINE, the gateway immediately resets itself to be online. To set the gateway offline, stop the gateway instance in the ColdFusion Administrator, or use the stopGatewayInstance method in the CFIDE.adminapi.eventgateway CFC.

Example

See  GatewayHelper example in  Using the GatewayHelper object  in the Developing ColdFusion Applications, which uses all GatewayHelper class methods.

Share this page

Was this page helpful?
We're glad. Tell us how this page helped.
We're sorry. Can you tell us what didn't work for you?
Thank you for your feedback. Your response will help improve this page.

On this page