INGIBRKR

Edit online

Purpose

INGIBRKR sends messages to a running System Automation Info Broker process, that forwards the message to an Apache Kafka system. Messages can be any user-defined message strings.

This command can also be used to forward SDF messages to the System Automation Info Broker, that can be interpreted by a dashboard like Service Management Unite (SMU).

Syntax

Read syntax diagramSkip visual syntax diagramINGIBRKRPUBTOPIC= topic_nameDATA= dataWAIT=YESWAIT=NOWAIT= nnn

Parameters

PUB
The PUB function sends the message to the System Automation Info Broker, which then dispatches the message to the Apache Kafka system. This function takes effect by default, if it's omitted.
TOPIC
This required parameter is the name of the topic of the Apache Kafka system to which the message has to be sent. The format can be [a-zA-Z0-9\\._\\-] and its maximum length is 32 characters.

DATA
This optional parameter contains the text to be send as a message. The format can be any text, but if it contains blanks, you need to place the text in quotes.

If this parameter is not specified, the command will look in the default SAFE and send the text found there as a message.

WAIT

This optional parameter specifies whether or not to wait until the request is complete. The default is YES. nnn is the number of seconds to wait before giving up and reporting that a timeout has occurred. The maximum time interval is 999 seconds.

Return Code

0
The INGIBRKR command was able to successfully dispatch the message.
1
When a WAIT value was specified, the message was not dispatched in that period of time.
4
One or more parameters for the command are mistyped or wrong.
8
Unexpected error occurred.

Messages

  • AOF204I : EXPECTED PARAMETERS MISSING OR INVALID FOR REQUEST INGIBRKR - DATA
  • AOF204I : EXPECTED PARAMETERS MISSING OR INVALID FOR REQUEST INGIBRKR - TOPIC
  • AOF204I : EXPECTED PARAMETERS MISSING OR INVALID FOR REQUEST INGIBRKR - WAIT
  • AOF772I : PARSING ERROR PROCESSING INGIBRKR - Invalid keyword "badkeyword" found
  • AOF802I : INTERNAL ERROR DETECTED IN clist, ERROR DATA:
  • AOF171I : TIMEOUT OF n SECONDS EXPIRED (If WAIT is default, then n=1)
  • AOF099I : FUNCTION COMPLETED

Restrictions and Limitations

None.

Example

Sending message: 
INGIBRKR PUB TOPIC=Topic1 DATA=Data1
INGIBRKR PUB TOPIC=Topic2 DATA='Data 2'
Sending data from the default SAFE:
INGIBRKR PUB TOPIC=Topic1  /* Data will be fetched from default SAFE */
PIPE LIT /safedata/ | NETV INGIBRKR TOPIC=top | CONS ONLY
PIPE STEM.x COLLECT | NETV INGIBRKR TOPIC=top | CONS ONLY 
PIPE NETV myREXX | NETV INGIBRKR TOPIC=top | CONS ONLY
Sending message with WAIT:
INGIBRKR PUB TOPIC=Topic1 DATA=Data1 WAIT=10
INGIBRKR PUB TOPIC=Topic1 DATA=Data1 WAIT=Y
INGIBRKR PUB TOPIC=Topic1 DATA=Data1 WAIT=N