This general macro is used to send messages to specified display
terminals. Messages can consist of:
- The user's own text
- A prepared message
- A prepared message completed by the user's substitution data.
Messages may be preceded by a header containing any or all of the
following:
- Time stamp
- Symbolic link number
- Symbolic link and channel number
- Symbolic line number.
Messages may be sent to any or all of the following addresses:
- Prime CRAS
- RO CRAS
- Address specified in EBROUT
- System Control Center
- Address specified by the user.
Format
- label
- A symbolic name can be assigned to the macro statement.
- message_number
- This specifies a prepared message number. Message numbers are
contained in CMAMC. The X'00'-X'FE' specify
"canned" messages. The CXJMOTX = X'FF' specifies its own text
supplied.
- work_area
- This specifies the address of a 16-byte work area, aligned on a halfword
boundary, which is immediately followed by text substitution data if
required.
Entry Requirements
- The work area is defined by the data macro CMAMC. Ensure the work
area is aligned on a halfword boundary and set up the last four fields as
follows before issuing a KARMA macro:
- CMAOHD
- If own text is specified or if the user wishes to override the canned
header indicator this 1-byte field must contain the user's header
indicator byte (See Programming Considerations). Otherwise, this byte
must be set to zero.
- CMAOAD
- If own text is specified or if the user wishes to override the canned
addressee indicator, this 1-byte field must contain the user's addressee
indicator byte. (See Programming Considerations). Otherwise,
this byte must be set to zero.
- CMAOCT
- If own text is specified or if substitution data is required, this
halfword field must contain the character count of text or substitution data
immediately following the work area.
- CMAOTX
- If the addresses indicator byte specifies own address supplied, the first
three bytes of this area contain the LNIATA of the terminal to which the
message is to be sent.
If the message number specified was CXJMOTX-own text, this area will
contain up to 80 bytes of text, including the EOM. If a canned message
has been specified, this area may contain substitution data for completing the
message.
- The following describes the ECB work area:
- EBW000-EBWKAD
- Fullword link keypoint address
- EBW004-EBWCAD
- Fullword channel keypoint address for channel oriented messages, that is
those messages which require information pertaining to a particular line or
channel, either in the message header, or as substitution data in the text of
the message.
If the alarm/message is not channel oriented, the first byte of this field
must contain X'FF'.
Level 6 must be available.
- Ensure register 1 (R1), R6, R7, R14, and R15 are available.
Return Conditions
- Control is returned to the next sequential instruction.
- The contents of registers R1, R6, R7, R14, and R15 are
unpredictable. All other registers are unchanged.
Programming Considerations
The KARMA macro enters CMC1, which sets up the work area and issues a CRETC
macro (with the S parameter) to CMA1 to output the requested message.
Examples
None.