Command:             CMD_PGM_OPTIONS
Destination:         SD_PGM
Destination Channel: 0

Description

Clients use this command to specify one or more options to be used for a program upload to the .

Command Data Format

Handle	reserved	Option	Length of Option Data	Option Data	padding	...
1 byte	3 bytes	1 byte	1 byte	variable	0 - 3 bytes	...
		One Option

Handle

This is the handle returned by a previous CMD_PGM_DESC command.

Option

This is the option to be applied to the program as it is being uploaded or after it has been uploaded. Valid Options are:

Option	Description		Length of Option Data	Option Data
PGM_CONV	The file to be uploaded is binary and should not have CR LF character combinations replaced by an LF character.	default	1	PGM_BIN
	The file to be uploaded is ASCII and should have CR LF character combinations replaced by a single LF character.			PGM_ASCII
PGM_TYPE	The file is a program and should be set as executable.	default	1	PGM_PGM
	The file is data and should not be set as executable.			PGM_DATA

If an option is not specified, it is set to the value indicated as default in the above table.

Length of Option Data

The number of bytes of Option Data to follow. If set to zero, no Option Data is present.

Option Data

Data needed by the Option.

Response Data Format

None.

Response Return Codes

RESP_OK	Execution of the command was successful.
RESP_INVAL_PARAM	Either the Option, Option Data or the Handle is not valid.
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.