ADDRESS VOX Commands › Utility Commands › SETMSGSTREAM Command

SETMSGSTREAM Command

The SETMSGSTREAM command serves as a connection between the notification server and the rest of CA Automation Point. The SETMSGSTREAM command duplicates the message stream from the notification server to a queue that is accessible using PPQs, local or remote. This queue can then be read and will act like a source of messages to the other CA Automation Point tools.

This command has the following format:

ADDRESS VOX "SETMSGSTREAM QUEUE(AP_SERVER) 
  [SEVERITY(ERROR|WARNING|INFORMATIONAL)]"

QUEUE

Specifies the name of the queue you want to use to communicate with another application.

SEVERITY

(Optional) This operand allows you to analyze the errors in the notification server and determine the severity of each error. Values are:

ERROR

Duplicates only error messages

WARNING

Duplicates warning and error messages

INFORMATIONAL

Duplicates all messages

Default: INFORMATIONAL

Return Information:

After the SETMSGSTREAM command executes, it sets the special REXX return code variable RC.

• If the command executes successfully, the RC variable contains a value of zero.
• If the command does not execute successfully, the RC variable contains one of the following values: 5102, 5117, 5155, 5199, 5201. (See the Message Reference Guide for further information.) Additionally, the VOX.ERROR variable contains the complete VOX error message, which includes the four-digit return code and complete error message text.