COSNOTIFYCHANNELADMIN_SEQUENCEPROXYPUSHSUPPLIER(3erl)

✨ NAME ✨

CosNotifyChannelAdmin_SequenceProxyPushSupplier — this module implements the OMG CosNotifyChannelAdmin::SequenceProxyPushSupplier interface, and yes bestie that's a whole mouthful, we're gonna get through it together 💖

It lives in the cosNotification manual, page CosNotifyChannelAdmin_SequenceProxyPushSupplier(3erl) 🫶

---

🌸 DESCRIPTION 🌸

So the vibe is: if you wanna touch the record definitions for these structs, you gotta pull them in like this 👇

-include_lib("cosNotification/include/*.hrl").

That's it, that's the whole ticket to the party 🎀

Also, this module is out here exporting the functions that are described in these other modules, so like, the whole squad is connected 💅

• CosNotifyComm_NotifySubscribe
• CosNotification_QoSAdmin
• CosNotifyFilter_FilterAdmin
• CosNotifyChannelAdmin_ProxySupplier

No cap, that's the full list — go read those pages if you want the lore on the inherited functions 📚✨

---

👑 EXPORTS 👑

connect_sequence_push_consumer(SequenceProxyPushSupplier, PushConsumer) -> Reply

Types:

SequenceProxyPushSupplier = #objref
PushConsumer = #objref
Reply = ok | {'EXCEPTION',
#'CosEventChannelAdmin_AlreadyConnected'{}} | {'EXCEPTION',
#'CosEventChannelAdmin_TypeError'{}}

This operation connects a PushConsumer to the target object. So cute, so simple. BUT — if a connection already exists, or if the function psuh_structured_events is not supported, then the exceptions AlreadyConnected or TypeError will be raised respectively 😭 like okay we get it, one connection at a time, the target object is not sharing 👑

Lowkey iconic behaviour ngl — that function name is spelled psuh_structured_events in the source, keep it exactly as-is, don't go fixing it, it's not a typo we made, it's just how it is 💀

---

suspend_connection(SequenceProxyPushSupplier) -> Reply

Types:

SequenceProxyPushSupplier = #objref
Reply = ok | {'EXCEPTION',
#'CosNotifyChannelAdmin_ConnectionAlreadyInactive'{}} |
{'EXCEPTION', #'CosNotifyChannelAdmin_NotConnected'{}}

This operation suspends the connection between the client and the target object. It's giving "brb, going offline for a sec" 💤 But listen — if no connection exists, or the connection is already suspended, an exception gets raised. Can't pause what was never playing, bestie 🙈

---

resume_connection(SequenceProxyPushSupplier) -> Reply

Types:

SequenceProxyPullConsumer = #objref
Reply = ok | {'EXCEPTION',
#'CosNotifyChannelAdmin_ConnectionAlreadyInactive'{}} |
{'EXCEPTION', #'CosNotifyChannelAdmin_NotConnected'{}}

If the connection has previously been suspended, you must use this operation when you want to resume the connection. It's the un-pause button, the "okay I'm back, what did I miss" moment 🌈

And if no object has been connected, or the connection already is active, an exception is raised. Like — girl, there's nothing to resume, we never left 😭

Heads up, the type in the original is literally named SequenceProxyPullConsumer here, even though we're in push supplier town. Keep it exactly as written, don't come for me 💅

---

disconnect_sequence_push_supplier(SequenceProxyPushSupplier) -> ok

Types:

SequenceProxyPushSupplier = #objref

This operation causes the target object to close the connection and terminate. It's the final goodbye, the "we're done here, periodt" 💀🔥 Once it's gone, it's gone — that object is not coming back to the group chat.

---

💖 Reminder for the girlies: every one of these functions wants an #objref, so make sure you actually have a live object reference before you start calling stuff, or you're gonna have a bad time 🫶

---

Written by Ericsson AB, from cosNotification version 5.2.2, and the page is CosNotifyChannelAdmin_SequenceProxyPushSupplier(3erl) — that's the footer, and that's the tea ☕✨ Bye bestie, go connect some consumers! 💜🦋🎀