setAssignedClocks

This command is used to change which Format Clock will be used when scheduling a specific date/hour.

Sample Request

<mmRequest command="setAssignedClocks" station="StationID">
	<contents>
		<assignments>
			<assignment time="2024-11-11T00:00:00" code="AA" />
			<assignment time="2024-11-11T01:00:00" code="AB" />
			<assignment time="2024-11-11T02:00:00" code="AC" />
		</assignments>
	</contents>
</mmRequest>

Request Notes

This is tied to the Format Scheduler and acts as setting hour overrides there. Assignments made this way will override the active grid, grid rotation and any Format Scheduler day or week overrides. You can specify any number of date/hours to change in a single call. Each must include the hour specified in ISO date/time format and the Clock Code of the clock you wish to assign to that hour. If you wish to remove a clock override from an hour, you can set code=”” (blank string) which will remove any clock override, if one exists.

Sample Reply

<mmReply command="setAssignedClocks" station="StationID" status="ok">
	<contents>
		<assignments>
			<assignment time="2024-11-11T00:00:00" code="AA" name="Clock AA" locked="0"/>
			<assignment time="2024-11-11T01:00:00" code="AB" name="Clock AB" locked="0"/>
			<assignment time="2024-11-11T02:00:00" code="AC" name="Clock AC" locked="0"/>
		</assignments>
	</contents>
</mmReply>

Reply Notes

The command will return an assignment tag for each hour that was requested, which includes the Clock Code and Clock Name that will be used. In addition, the locked attribute returns 0 or 1 based on whether the clock is already locked in history. Hours in Archive History will also indicate locked=”1”. Attempts to change the clock for an hour that is already locked or archived will not be successful. Error tags will be returned when this is detected, and in the case where you attempt to specify a Format Clock code that does not exist.

Compatibility and Version Info

Available in all versionsAvailable in MusicMaster PRO 8.0.15 or later.

Available in MusicMaster CS 2.5.0.12 or later.