ADDRESS AXC Commands › Commands for Automation Tasks › MSG Command

MSG Command

The MSG command allows you to indirectly process host messages through CA Automation Point rules, even in sessions where you cannot normally use rules (such as processor console or any sessions running full-screen applications). The MSG command creates a message block out of the passed text that, to CA Automation Point rules, appears to come from the session you specify.

This command has the following format:

"MSG 'message' SESSION(sessname) 
  [ACTION(YES|NO]
  [JOBID(jobid)]
  [JOBNAME(jobname)]
  [MONNAME(sysname1)]
  [MONNUM(sysnum)]
  [MONPRTY(prioritylevel)]
  [MONTYPE(alerttype)]
  [PREFIX(prefix)]
  [REPLYID(replynum)]
  [SYSNAME(sysname2)]
  [TIME(time)]"

message

Specifies the text of the message that you want to send.

SESSION

Specifies the name of the session from where the message appears to originate. This session can be user defined or internal. For internal sessions, use the name that corresponds to the appropriate [set to your product name] window:

ACTION

(Optional) Specifies whether the message sent is an action message.

Default: NO

JOBID

(Optional) Specifies the current JES job ID associated with the message. This operand is valid for session types ECS, MCS, RCS, and VM.

JOBNAME

(Optional) Specifies the job name of the address space that issued the message.

MONNAME

(Optional) Specifies the source system name for a DataFrame message.

MONNUM

(Optional) Specifies the source system number for a DataFrame message.

MONPRTY

(Optional) Specifies the priority level of the alert message by the DataFrame system.

MONTYPE

(Optional) Specifies the type of the alert message issued by the DataFrame system.

PREFIX

(Optional) Specifies a character string that controls the formatting of messages that appear in CA Automation Point function windows displaying message activity.

For more information, see the description of the Global Session Prefix field in the help for the Configuration Manager, Expert Interface, Automation, Session Definition Sets dialog.

REPLYID

(Optional) Specifies the reply number for the message (if the message to be sent is a WTOR message).

SYSNAME

(Optional) Specifies the source system name for a message.

TIME

(Optional) Specifies the current time for the workstation in the form hhmmss.

Usage Note:

The MSG command can send a message up to 494 characters long. A string longer than 494 characters causes a negative return code.

Examples:

• To send a test message that appears (to CA Automation Point rules) to come from session S028, issue the following command:

  "MSG 'AXC0001 THIS IS A TEST MESSAGE FROM S028' SESSION(SO28)"
  

• Suppose that you have defined a non-automated session named HP_01 and are controlling the session with REXX programs. Use the MSG command to send messages (appearing to originate from session HP_01) that CA Automation Point rules can process, as shown in these REXX program statements:

  "GETSCRN SESSION(HP_01)"
  "MSG '&LINE1' SESSION(HP_01) JOBNAME(SCREEN_4)"
  

  The example REXX fragment sends the first line of Session HP_01's current screen through rules for processing. The optional JOBNAME operand assigns a job name that your rules can use to further identify the message. For example, the following CA Automation Point rule recognizes the message with the SCREEN_4 job name and colors the message bright red in the Merged Messages window:

  MSGID(ALERT 10) WHEN(&JOBNAME EQ SCREEN_4) COLOR(BRIGHT RED)