Back to Program Loader Commands
CMD_PGM_STATUS 
Command:          CMD_PGM_STATUS
Destination:          SD_PGM
Destination Channel:  0

Description

Clients use this command to get the status of a program in the . Only programs uploaded with the CMD_PGM_UPLOAD command may be reported on.


Command Data Format

Name
32 bytes
Name
This is the name of the program in the whose status is to be reported. If the name is less than 32 bytes long, it should be null padded.


Response Data Format

Number Channel ... padding
1 byte 1 byte ... 0-3 bytes
Number
The number of copies of the program currently running in the . A value of 0 indicates that the program is present in the , but is not running.
Channel
The Channel number that can be used in the Frame Header to communicate with the program. If multiple copies of the program are running, multiple channel numbers are returned.
Response Return Codes
RESP_OK Execution of the command was successful.
RESP_UNAVAILABLE Index file is not present on .
RESP_INVAL_PARAM The file does not exist or it was not uploaded via CMD_PGM_UPLOAD.
RESP_UNSUPPORTED This command is not supported on the specified channel.
RESP_UNREG The specified source channel is not registered with the server.
RESP_UNKNOWN_ERR An unknown error occurred.
|Top|