Use this system macro to send a message to the computer room agent set
(CRAS).
- Note:
- The CRASC macro should not be used by system programs and
applications. System programs and applications must use the ROUTC
macro. All replies must be made with the WTOPC macro.
Format
- label
- A symbolic name can be assigned to the macro statement.
- symbol1
- A data level in the ECB must be specified as parameter one.
Entry Requirements
Return Conditions
- Control is returned to the next sequential instruction.
- The contents of R14 and R15 are unknown. The contents of all other
registers are preserved across this macro call.
- The specified data level (CBRW) is available.
Programming Considerations
- This macro can be run from the main I-stream only.
- The message to be sent is contained in a storage block held by the entry
control block.
- A check is made by the control program (CP) to determine whether the ECB
is holding a block of storage at the specified level. If a block is not
held, control is transferred to the system error routine.
- The block of storage containing the message to be sent is no longer
available to the operational program.
- The status of the sending operation can never be determined by the
operational program.
- The operational program may use the specified level immediately upon
return from this macro.
Examples
Send message to the prime CRAS.
GETCC D3,L1
MVC 16(CRASCMSGL-CRASCMSG-1,R14),CRASCMSG
CRASC D3
.
.
CRASMSG DC AL2(CRASMSGL-CRASMSG-3)
DC XL3'010000'
DC C'TEXT OF THE MESSAGE',AL1(#EOM)
CRASMSGL EQU *