ShowSet
– Instructions
Program to submit commands to
ShowShifter via a command line
interface.
Updates in version
2.0:
Program amended to use a
locking file to perform queuing so that multiple calls work
correctly when ShowShifter is inactive
- 10 second pause inserted between
calls to allow time for ShowShifter to
Shutdown properly.
2 additional facilities
are now provided:
To provide an
export listing of the ShowShifter
Schedule
To shutdown
Showshifter
Download and
Installation Instructions:
| 1 |
In most cases it may be
possible just to download the ShowSet.exe file on
it's own and start running it. This
download is very small compared to the
full installation package, so you probably would want
to try it first.
|
| 2 |
If this does not work
and the program says it cannot find files or DLL's then
the chances are that the VB
run-time files are required. In this case then a
full installation will be required
and you will have to download the full set
of files do do a set-up.
Put the setup.exe,
setup.lst and
showset.cab files into a directory on their own on your
PC and then run setup.exe, the install should be fairly
self-explanatory.
|
You will now be able to
run the ShowSet.exe program.
Operating
Instructions:
ShowSet.exe is run from a
command line, either by typing in a MS-DOS box or by
calling from another script/program.
Parameters can be
passed to Set a Recording, Remove a
Recording, or request a Channel Change.
Each Option starts with a
/ (slash), followed by a two letter code,
followed by an = (equal sign), followed by the parameters
which are separated by ::(colon
colon)
| 1 |
Option /SR to Set a
Recording:
ShowSet.exe
/SR=Channel 5::2002-08-11
19:00::30::Channel 4 News
Parameters =
ChannelName::StartDateTime::Duration::ProgrammeName
This sets a recording
with the default Video Server name format of
ProgrammeName
on Date, eg.
the above command would create:
Channel
4 News on Sun, Aug 11 2002.wmv
|
| 2 |
Option /SN to Set a
Named Recording:
ShowSet.exe /SN=Channel
5::2002-08-11 19:00::30::Channel 4
News
Parameters =
ChannelName::StartDateTime::Duration::ProgrammeName
This sets a recording
with a forced file name format, eg.
the above command would
create:
Channel 4
News.wmv
|
| 3 |
Option /DR to
Delete a Recording:
ShowSet.exe/DR=2002-08-11
19:00
Parameter =
StartDateTime
|
| 4 |
Option /WP to Watch
a Program
ShowSet.exe /WP=BBC 1
Parameter =
ChannelName
|
| 5 |
Option /SC to
Set a timed Channel change
ShowSet.exe /SC=BBC 1::2002-08-15
23:05
Parameters =
ChannelName::StartDateTime
|
| 6 |
Option /ES to
Export the ShowShifter schedule
ShowSet.exe /ES=c:\showset\export.prn
Parameters =
DirectoryPath\FileName
|
| 7 |
Option /SH to force
a Shutdown of ShowShifter
ShowSet.exe /SH
This last parameter
will close ShowShifter regardless
of whether a recording is in
progress or not.
|
Error
Reporting:
Any
VideoServer errors reported will be added to an error log
file:
ShowSet
YYYY-MM-DD HHMMSS.Log
eg.
ShowSet 2002-09-08 144326.log
Any log file greater than
7 days old will be automatically deleted.
Error Log format is as
follows:
DateTime, CommandSubmitted,
ErrorDescription
Examples are:
"08/09/2002 15:05:30","/sn=channel
5::2002-10-15 14:30::120::Frasier","This
recording has already been scheduled."
"08/09/2002
15:06:05","/sc=bbc1::2002-10-15
14:50","Channel change clashes with another scheduled
event:15.10.2002 14:30-16:30 Frasier"