How to create or modify the video on demand Vod_config.scr script file in Microsoft TV Foundation Edition Hybrid Edition 1.0.2 (915601)



The information in this article applies to:

  • Microsoft TV Foundation Edition Hybrid Edition 1.0.2

INTRODUCTION

In Microsoft TV Foundation Edition Hybrid Edition (MSTV FEH1) 1.0.2 Server, the Vod_config.scr script file is used to enable or disable the video on demand (VOD) barker screen in the MSTV FEH1 Client set-top box (STB).

MORE INFORMATION

The MSTV FEH1 Server has the flexibility to provide cable network operators the choice to display a video barker MPEG stream. The MPEG stream channel is started when the user of the STB goes to the tunable channel that takes the user to the VOD menu page. You can customize this script according to the channel map settings of the user. To create or to modify the Vod_config.scr script, use the following methods.

Create or update the Vod_config.scr file

The Vod_config.scr script file is located in the Config folder of each language subfolder of a particular user interface (UI) package. Typically, the UI package is located under a subfolder of the C:\MSTVSolution\ClientGUI folder. The name of this subfolder is the page build number. For example, the script files are located in the following folders for the English and Spanish versions of GUI Page file build #5363:
  • C:\MSTVSolution\ClientGUI\BuildNumber\en_US\config
  • C:\MSTVSolution\ClientGUI\BuildNumber\es_MX\config
These folders are located on the primary application server at the headend. When the Vod_config.scr script file does not exist, you must create the script file. The Vod_config.scr script file contains two variables. These variables appear on their own line of code and indicate the VOD Barker Channel Number and the VOD Index Channel. For example, the Vod_config.scr script file may resemble the following code example
FG(VRC, VOD_Barker_Channel_Number); 
FG(VCHN, VOD_Index_Channel);
You can customize the VOD_Barker_Channel_Number and VOD_Index_Channel variables according to the Video Home Office (VHO) needs.

Notes
  • If the headend does not contain a video barker channel, you must set the value of the VOD_Barker_Channel_Number variable to 0. By default, the value of the VOD_Barker_Channel variable is 0.
  • You must set the VOD Index Channel to the tunable channel that is associated with the VOD menu page. By default, the value of the VOD_Index_Channel variable is 0.
For example, when the video barker does not exist in the VHO headend, the assigned channel value should be 0. When the tunable channel that takes customers to the VOD menu page is associated with channel 900, the Vod_config.scr file resembles the following code example.
FG(VRC, 0); 
FG(VCHN, 900); 
Note The customer defines the channel value number and the channel index number.

Create script files for regions

To customize UI pages for a region, you must create or modify a separate script file for each region. Save the script file in the C:\MSTVSolution\ClientGUI\ folder and name the file UpdatePages_region300x.txt. In special cases, some VHO sites may have more than one region. In that case, you can substitute a valid number for a different region instead of the x placeholder in the file name. For example, the script file may resemble the following:
connect http://localhost/pagefiledelivery/targetingservice.asmx
asset pushupdate english_pages_<RegionNumber><GUI_Path>\ClientGUI\<Page_Build_Number>\en_US
asset pushupdate spanish_pages_<RegionNumber><GUI_Path>\ClientGUI\<Page_Build_Number>\es_MX
The following example command file contains UI pages build 5363 that support English and Spanish language for the region #3006:
connect http://localhost/pagefiledelivery/targetingservice.asmx
asset pushupdate english_pages_3006<C:\MSTVSolution>\ClientGUI\5363\en_US
asset pushupdate spanish_pages_3006<C:\MSTVSolution>\ClientGUI\5363\es_MX
Notes
  • When the file name is UpdatePages_region3006.txt, the file will only update the UI page for region 3006. When the VHO site has more than one region, you can create another file and change 3006 to a different region number. For example, a file that is named UpdatePages_region3003.txt will only update the UI page for region 3003.
  • You must modify the <C:\MSTVSolution>\ClientGUI\<RegionNumber> path in the file to point to the correct GUI files.

Propagate the UI pages to the set-top box

At the command prompt, run the following commands:

CD C:\Program Files\Microsoft TV Foundation Edition Hybrid\bin\

DeployContent UpdatePages_region3006.txt

Notes
  • You must run the command for each different region file.
  • After you run the command, reset the set-top box. To reset the set-top box, unplug and then plug back in the power cord.
  • Verify the VOD script update.

Modification Type:MajorLast Reviewed:5/23/2006
Keywords:kbtshoot kbhowto KB915601 kbAudDeveloper kbAudITPRO