
6. OBTAINING THE SYSTEM
INFORMATION
B–61863E–1/06
PMC LIBRARY
206
SC/SC3/SC4 NB/NB2 16i/18i/21i 15i–A
f f f
[Name]
pl_message
[Description]
Reads message data set in the PMC address (A0.0 to A24.7 or A0.0
to A124.7).
[Format]
ret = pl_message(offset_addr,bit_pos,msg,size) ;
unsigned short int ret;
unsigned short int offset_addr;
unsigned short int bit_pos;
unsigned char *msg;
unsigned short int *size;
[Input]
offset_addr Offset address of PMC address “A” (specify 0 to 24 or
0 to 124.)
bit_pos Bit position of PMC address “A” (specify 0 to 7.)
[Output]
*msg Message data character string which was read (up to
255 characters)
*size Length of message data which was read
[Returns]
ret
0 : Normal termination
1 : The specified PMC address is incorrect. (The offset_addr and
bit_pos values are out of range.)
Alternatively, no message data is defined in the specified PMC
address.
[Remarks]
NULL (= 0) is added at the end of message data.
Therefore, the size of the message data buffer (msg) must be the
maximum number of characters +1.
6.3
READING MESSAGE
DATA OF THE
SEQUENCE
PROGRAM