Table Of Contents
Command Line Interface Commands
Activate Command
ClearAllDebug Command
ClearDebug Command
DownVolume Command
GetDebug Command
GetLog Command
GetSkin Command
GetVolume Command
IsActive Command
IsConfigured Command
IsEnabled Command
IsLatch Command
IsTraffic Command
IsTxMuted Command
Play Command
Ptt Command
SetAllDebug Command
SetDebug Command
SetVolume Command
StartLog Command
StopLog Command
UpVolume Command
Command Line Interface Commands
This chapter describes each of the PMC Command Line Interface (CLI) commands in detail.
For each command, this chapter provides the following information, as appropriate:
•
Description—Explains what the command does
•
Syntax—Shows how to issue the command and describes the meaning of any arguments and options
•
Return codes—Describes the meaning of any return codes that the command generates
•
Examples—Provides examples of how to use the command
•
Related commands—Lists and cross-references related PMC CLI commands
Table 2-1 lists the PMC CLI commands. It also provides a brief description of each command, and a reference to the section that describes the command in detail.
Note
PMC CLI commands are not case sensitive. For example, entering PMC.EXE -Activate, PMC.exe -ACTIVATE, or pmc.exe -activate will execute the same command.
Table 2-1 IPICS CLI Command Summaries
Command
|
Description
|
Reference
|
PMC.EXE -Activate [-line #]
|
Toggles the Activate/Deactivate button on the specified PTT channel
|
Activate Command
|
PMC.EXE -ClearAllDebug
|
Clears all debug options that are currently selected on the PMC Debug menu
|
ClearAllDebug Command
|
PMC.EXE -ClearDebug option
|
Clears the specified debug option on the PMC Debug menu
|
ClearDebug Command
|
PMC.EXE -DownVolume [-line #]
|
Decreases the volume for the specified PTT channel by a value of 10, to a minimum value of 0
|
DownVolume Command
|
PMC.EXE -GetDebug option
|
Returns a code that indicates whether the specified debug option is selected on the PMC Debug menu
|
GetDebug Command
|
PMC.EXE -GetLog file
|
Returns a code that indicates whether logging to the specified log file is on or off
|
GetLog Command
|
PMC.EXE -GetSkin
|
Returns a code that indicates the currently selected skin
|
GetSkin Command
|
PMC.EXE -GetVolume [-line #]
|
Returns a code that represents the audio output volume that is set for the specified PTT channel
|
GetVolume Command
|
PMC.EXE -IsActivate [-line #]
|
Returns a code that designates whether the specified PTT channel is active
|
IsActive Command
|
PMC.EXE -IsConfigured [-line #]
|
Returns a code that designates whether the specified PTT channel is configured
|
IsConfigured Command
|
PMC.EXE -IsEnabled [-line #]
|
Returns a code that designates whether the specified PTT channel is enabled
|
IsEnabled Command
|
PMC.EXE -IsLatch [-line #]
|
Determines whether the PMC PTT button for the specified PTT channel is latched
|
IsLatch Command
|
PMC.EXE -IsTraffic [-line #]
|
Determines whether there is any receive (RX) or transmit (TX) traffic on the specified PTT channel
|
IsTraffic Command
|
PMC.EXE -IsTxMuted [-line #]
|
Returns a code that designates whether the specified PTT is muted by Cisco IPICS.
|
IsTxMuted Command
|
PMC.EXE -Play file [-line #]
|
Outputs a wave audio file to the specified PTT channel
|
Play Command
|
PMC.EXE -Ptt [-line #]
|
Latches or unlatches the PMC PTT button for the specified PTT channel
|
Ptt Command
|
PMC.EXE -SetAllDebug
|
Selects all debug options that are available on the PMC Debug menu
|
SetAllDebug Command
|
PMC.EXE -SetDebug option
|
Selects the specified debug option on the PMC Debug menu
|
SetDebug Command
|
PMC.EXE -SetVolume level [-line #]
|
Specifies the audio output volume for the specified PTT channel
|
SetVolume Command
|
PMC.EXE -StartLog file
|
Turns on logging to the specified log file
|
StartLog Command
|
PMC.EXE -StopLog file
|
Turns off logging to the specified log file
|
StopLog Command
|
PMC.EXE -UpVolume [-line #]
|
Increases the volume for the specified PTT channel by a value of 10, to a maximum value of 100
|
UpVolume Command
|
Activate Command
The Activate command toggles the Activate/Deactivate button on the specified PTT channel.
If the Activate/Deactivate button is active, issuing this command deactivates it. If the Activate/Deactivate button is not active, issuing this command activates it. There are no return codes for this command.
Syntax
The syntax of this command is:
PMC.EXE -Activate [-line #]
The -line # option, where # is a number 1 through 8, specifies the PTT channel to which this command applies. If you omit this option, the command will apply to channel 1.
Examples
Table 2-2 shows examples of the Activate command.
Table 2-2 Examples of Activate Command Usage
Command
|
Result
|
PMC.EXE -Activate
|
Activates channel 1 if it is not active. Deactivates channel 1 if it is active.
|
PMC.EXE -Activate -line 1
|
Activates channel 1 if it is not active. Deactivates channel 1 if it is active.
|
PMC.EXE -Activate -line 6
|
Activates channel 6 if it is not active. Deactivates channel 6 if it is active.
|
Related Command
•
IsActive Command—Returns a code that designates whether the selected channel is active
ClearAllDebug Command
The ClearAllDebug command clears all debug options that are currently selected on the PMC Debug menu.
Syntax
The syntax of this command is:
PMC.EXE -ClearAllDebug
Related Commands
•
ClearDebug Command—Clears the specified debug option on the PMC Debug menu
•
GetDebug Command—Returns a code that indicates whether the specified debug option is selected on the PMC Debug menu
•
SetAllDebug Command—Selects all debug options that are available on the PMC Debug menu
•
SetDebug Command—Selects the specified debug option on the PMC Debug menu
ClearDebug Command
The ClearDebug command clears the specified debug option on the PMC Debug menu.
Syntax
The syntax of this command is:
PMC.EXE -ClearDebug option
The option argument is the name of the debug option to clear.
Examples
Table 2-3 shows examples of the ClearDebug command.
Table 2-3 Examples of ClearDebug Command Usage
Command
|
Result
|
PMC.EXE -ClearDebug lsm
|
Clears the lsm debug option on the PMC Debug menu
|
PMC.EXE -ClearDebug auth
|
Clears the auth debug option on the PMC Debug menu
|
Related Commands
•
ClearAllDebug Command—Clears all debug options that are currently selected on the PMC Debug menu
•
GetDebug Command—Returns a code that indicates whether the specified debug option is selected on the PMC Debug menu
•
SetAllDebug Command—Selects all debug options that are available on the PMC Debug menu
•
SetDebug Command—Selects the specified debug option on the PMC Debug menu
DownVolume Command
The DownVolume decreases the volume for the specified PTT channel by a value of 10, to a minimum value of 0. This command has the same effect as clicking the PMC Decrease Volume button. There are no return codes for this command.
Syntax
The syntax of this command is:
PMC.EXE -DownVolume [-line #]
The -line # option, where # is a number 1 through 8, specifies the PTT channel to which this command applies. If you omit this option, the command will apply to channel 1.
Examples
Table 2-4 shows examples of the DownVolume command.
Table 2-4 Examples of DownVolume Command Usage
Command
|
Result
|
PMC.EXE -DownVolume
|
If the volume of channel 1 is 50, decreases the volume to 40
|
PMC.EXE -DownVolume -line 1
|
If the volume of channel 1 is 75, decreases the volume to 65
|
PMC.EXE -DownVolume -line 3
|
If the volume of channel 3 is 37 decreases the volume to 27
|
PMC.EXE -DownVolume -line 6
|
If the volume of channel 6 is 5 decreases the volume to 0 (the minimum value)
|
Related Commands
•
GetVolume Command—Returns a code that represents the audio output volume that is set for the specified PTT channel
•
SetVolume Command—Specifies the audio output volume output for the specified PTT channel
•
UpVolume Command—Has the same effect as clicking the PMC Increase Volume button
GetDebug Command
The GetDebug command returns a code that indicates whether the specified debug option is selected on the PMC Debug menu.
.Syntax
The syntax of this command is:
PMC.EXE -GetDebug option
The option argument is the name of the debug option for which to obtain information.
Return Codes
Table 2-5 shows the return codes for the GetDebug command.
Table 2-5 Return Codes for the GetDebug Command
Return Code
|
Skin
|
0
|
The specified debug option is not selected
|
1
|
The specified debug option is selected
|
Examples
Table 2-6 shows examples of the GetDebug command.
Table 2-6 Examples of GetDebug Command Usage
Command
|
Result
|
PMC.EXE -GetDebug lsm
|
Returns 0 if the lsm debug option is not selected on the PMC Debug menu. Returns 1 if it is selected.
|
PMC.EXE -GetDebug auth
|
Returns 0 if the auth debug option is not selected on the PMC Debug menu. Returns 1 if it is selected.
|
Related Commands
•
ClearAllDebug Command—Clears all debug options that are currently selected on the PMC Debug menu
•
ClearDebug Command—Clears the specified debug option on the PMC Debug menu
•
SetAllDebug Command—Selects all debug options that are available on the PMC Debug menu
•
SetDebug Command—Selects the specified debug option on the PMC Debug menu
GetLog Command
The GetLog command returns a code that indicates whether logging to the specified log file is on or off.
Syntax
The syntax of this command is:
PMC.EXE -GetLog file
The file argument is one of the following strings, which specifies the log file for which to obtain information:
•
Authentication.log
•
ChannelActivity.log
•
UserInterface.log
•
ChannelStatistics.log
Return Codes
Table 2-7 shows the return codes for the GetLog command.
Table 2-7 Return Codes for the GetLog Command
Return Code
|
Skin
|
0
|
Logging to the specified log file is off
|
1
|
Logging to the specified log file is on
|
Examples
Table 2-8 shows examples of the GetLog command.
Table 2-8 Examples of GetLog Command Usage
Command
|
Result
|
PMC.EXE -Getlog Authentication.log
|
Returns 0 if logging to the Authentication.log if off. Returns 1 if logging to this file is on.
|
PMC.EXE -GetLog UserInterface.log
|
Returns 0 if logging to the UserInterface.log if off. Returns 1 if logging to this file is on.
|
Related Commands
•
StartLog Command—Turns on logging to the specified log file
•
StopLog Command—Turns off logging to the specified log file
GetSkin Command
The GetSkin command returns a code that indicates the skin that is selected for the PMC. This command recognizes only the skins that are provided with the PMC.
Syntax
The syntax of this command is:
PMC.EXE -GetSkin
Return Codes
Table 2-9 shows the return codes for the GetSkin command.
Table 2-9 Return Codes for the GetSkin Command
Return Code
|
Skin
|
0
|
IPICS_Mouse_8_SkinCtrl.xml
|
1
|
IPICS_Mouse_4_SkinCtrl.xml
|
2
|
IPICS_Touch_8_SkinCtrl.xml
|
3
|
IPICS_Touch_4_SkinCtrl.xml
|
4
|
IPICS_Touch_8_LR_SkinCtrl.xml
|
5
|
IPICS_Touch_4_LR_SkinCtrl.xml
|
6 and above
|
User added skin
|
GetVolume Command
The GetVolume command returns a code that represents the audio output volume that is set for the specified PTT channel.
Syntax
The syntax of this command is:
PMC.EXE -GetVolume [-line #]
The -line # option, where # is a number 1 through 8, specifies the PTT channel to which this command applies. If you omit this option, the command will apply to channel 1.
Return Codes
Table 2-10 shows the return codes for the GetVolume command.
Table 2-10 Return Codes for the GetVolume Command
Return Code
|
Meaning
|
0
|
Minimum volume level
|
1 through 99
|
Intermediate volume levels
|
100
|
Maximum volume level
|
Related Commands
•
DownVolume Command—Has the same effect as clicking the PMC Decrease Volume button
•
SetVolume Command—Specifies the audio output volume output for the specified PTT channel
•
UpVolume Command—Has the same effect as clicking the PMC Increase Volume button
IsActive Command
The IsActive command returns a code that designates whether the selected channel is active.
Syntax
PMC.EXE -IsActive [-line #]
The -line # option, where # is a number 1 through 8, specifies the PTT channel to which this command applies. If you omit this option, the command will apply to channel 1.
Return Codes
Table 2-11 shows the return codes for the IsActive command.
Table 2-11 Return Codes for the IsActive Command
Return Code
|
Meaning
|
0
|
Specified channel is not active
|
1
|
Specified channel is active
|
Related Command
•
Activate Command—Toggles the Activate/Deactivate button on the specified PTT channel
IsConfigured Command
The IsConfigured command returns a code that designates whether the selected channel has been configured in Cisco IPICS.
Syntax
PMC.EXE -IsConfigured [-line #]
The -line # option, where # is a number 1 through 8, specifies the PTT channel to which this command applies. If you omit this option, the command will apply to channel 1.
Return Codes
Table 2-12 shows the return codes for the IsConfigured command.
Table 2-12 Return Codes for the IsConfigured Command
Return Code
|
Meaning
|
0
|
Specified channel is not configured
|
1
|
Specified channel is configured
|
IsEnabled Command
The IsEnabled command returns a code that designates whether the selected channel is enabled in Cisco IPICS.
Syntax
PMC.EXE -IsEnabled [-line #]
The -line # option, where # is a number 1 through 8, specifies the PTT channel to which this command applies. If you omit this option, the command will apply to channel 1.
Return Codes
Table 2-13 shows the return codes for the IsEnabled command.
Table 2-13 Return Codes for the IsEnabled Command
Return Code
|
Meaning
|
0
|
Specified channel is not enabled
|
1
|
Specified channel is enabled
|
IsLatch Command
The IsLatch command determines whether the PMC PTT button for the specified channel is latched. The return code indicates the state of the PTT button.
Syntax
The syntax of this command is:
PMC.EXE -IsLatch [-line #]
The -line # option, where # is a number 1 through 8, specifies the PTT channel to which this command applies. If you omit this option, the command will apply to channel 1.
Return Codes
Table 2-14 shows the return codes for the IsLatch command.
Table 2-14 Return Codes for the IsLatch Command
Return Code
|
Meaning
|
0
|
PTT button is not latched
|
1
|
PTT button is latched
|
Related Command
•
Ptt Command—Latches or unlatches the PMC PTT button for the specified PTT channel
IsTraffic Command
The IsTraffic command determines whether there is any receive (RX) or transmit (TX) traffic on the specified PTT channel. The return code indicates the type of traffic present.
Syntax
The syntax of this command is:
PMC.EXE -IsTraffic [-line #]
The -line # option, where # is a number 1 through 8, specifies the PTT channel to which this command applies. If you omit this option, the command will apply to channel 1.
Return Codes
Table 2-15 shows the return codes for the IsTraffic command.
Table 2-15 Return Codes for the IsTraffic Command
Return Code
|
Meaning
|
0
|
No traffic detected
|
1
|
Receive traffic detected
|
2
|
Transmit traffic detected
|
3
|
Receive traffic and transmit traffic detected
|
IsTxMuted Command
The IsTxMuted command returns a code that designates whether the selected channel is muted by Cisco IPICS. When a channel is muted, a PMC user cannot transmit on that channel.
Syntax
PMC.EXE -IsTxMuted [-line #]
The -line # option, where # is a number 1 through 8, specifies the PTT channel to which this command applies. If you omit this option, the command will apply to channel 1.
Return Codes
Table 2-16 shows the return codes for the IsTxMuted command.
Table 2-16 Return Codes for the IsTxMuted Command
Return Code
|
Meaning
|
0
|
Specified channel is not muted
|
1
|
Specified channel is muted
|
Play Command
The Play command outputs a wave audio file to the specified PTT channel.
Specifically, this command latches the PMC PTT button, plays the designated wave file, and then unlatches the PTT button. There are no return codes for this command.
Syntax
The syntax of this command is:
PMC.EXE -Play file [-line #]
The file argument is the path and file name of the wave file to play.
The -line # option, where # is a number 1 through 8, specifies the PTT channel lie to which this command applies. If you omit this option, the command will apply to channel 1.
Examples
Table 2-17 shows examples of the Play command.
Table 2-17 Examples of Play Command Usage
Command
|
Result
|
PMC.EXE -Play C:\sounds\tone.wav
|
Plays the tone.wav file in the C:\sounds folder to PTT channel 1
|
PMC.EXE -Play C:\sounds\tone.wav -line 3
|
Plays the tone.wav file in the C:\sounds folder to PTT channel 3
|
Ptt Command
The Ptt (push-to-talk) command latches or unlatches the PMC PTT button for the specified PTT channel.
If the PTT button is latched, issuing this command unlatches it. If the PTT button is unlatched, issuing this command latches it. There are no return codes for this command.
Syntax
The syntax of this command is:
PMC.EXE -Ptt [-line #]
The -line # option, where # is a number 1 through 8, specifies the PTT channel to which this command applies. If you omit this option, the command will apply to channel 1.
Examples
Table 2-18 shows examples of the Ptt command.
Table 2-18 Examples of Ptt Command Usage
Command
|
Result
|
PMC.EXE -Ptt
|
Latches the PTT button for channel 1 if it is not latched. Unlatches this button if it is latched.
|
PMC.EXE -Ptt -line 1
|
Latches the PTT button for channel 1 if it is not latched. Unlatches this button if it is latched.
|
PMC.EXE -Ptt -line 8
|
Latches the PTT button for channel 8 if it is not latched. Unlatches this button if it is latched.
|
Related Command
•
IsLatch Command—Determines whether the PMC PTT button for the specified channel is latched
SetAllDebug Command
The SetAllDebug command selects all debug options that are available on the PMC Debug menu.
Note
Some debug options are not available until at least one PTT channel has been activated.
Syntax
The syntax of this command is:
PMC.EXE -SetAllDebug
Related Commands
•
ClearAllDebug Command—Clears all debug options that are currently selected on the PMC Debug menu
•
ClearDebug Command—Clears the specified debug option on the PMC Debug menu
•
GetDebug Command—Returns a code that indicates whether the specified debug option is selected on the PMC Debug menu
•
SetDebug Command—Selects the specified debug option on the PMC Debug menu
SetDebug Command
The SetDebug command selects the specified debug option on the PMC Debug menu.
Note
Some debug options are not available until at least one PTT channel has been activated.
Syntax
The syntax of this command is:
PMC.EXE -SetDebug option
The option argument is the name of the debug option to select.
Examples
Table 2-19 shows examples of the SetDebug command.
Table 2-19 Examples of SetDebug Command Usage
Command
|
Result
|
PMC.EXE -SetDebug lsm
|
Sets the lsm debug option on the PMC Debug menu
|
PMC.EXE -SetDebug auth
|
Sets the auth debug option on the PMC Debug menu
|
Related Commands
•
ClearAllDebug Command—Clears all debug options that are currently selected on the PMC Debug menu
•
ClearDebug Command—Clears the specified debug option on the PMC Debug menu
•
GetDebug Command—Returns a code that indicates whether the specified debug option is selected on the PMC Debug menu
•
SetAllDebug Command—Selects all debug options that are available on the PMC Debug menu
SetVolume Command
The SetVolume command specifies the audio output volume for the specified PTT channel. It also returns a code that represents the output volume.
Syntax
The syntax of this command is:
PMC.EXE -SetVolume level [-line #]
The level argument is a number, 0 through 100, which specifies the output volume. The minimum volume level is 0, and the maximum volume level is 100.
The -line # option, where # is a number 1 through 8, specifies the PTT channel to which this command applies. If you omit this option, the command will apply to channel 1.
Return Codes
Table 2-20 shows the return codes for the SetVolume command.
Table 2-20 Return Codes for the SetVolume Command
Return Code
|
Meaning
|
0
|
Minimum volume level
|
1 through 99
|
Intermediate volume levels
|
100
|
Maximum volume level
|
Examples
Table 2-21 shows examples of the SetVolume command.
Table 2-21 Examples of SetVolume Command Usage
Command
|
Result
|
PMC.EXE -SetVolume 100
|
Sets the output volume for channel 1 to the maximum level
|
PMC.EXE -SetVolume 1 -line 2
|
Sets the output volume for channel 2 to the minimum level
|
PMC.EXE -SetVolume 50 -line 5
|
Sets the output volume for channel 5 to an intermediate level
|
Related Commands
•
DownVolume Command—Has the same effect as clicking the PMC Decrease Volume button
•
GetVolume Command—Returns a code that represents the audio output volume that is set for the specified PTT channel
•
UpVolume Command—Has the same effect as clicking the PMC Increase Volume button
StartLog Command
The StartLog command turns on logging to the specified log file.
Syntax
The syntax of this command is:
PMC.EXE -StartLog file
The file argument is one of the following strings, which specifies the log file for which to turn on logging:
•
Authentication.log
•
ChannelActivity.log
•
UserInterface.log
•
ChannelStatistics.log
Examples
Table 2-22 shows examples of the StartLog command.
Table 2-22 Return Codes for the StartLog Command
Command
|
Result
|
PMC.EXE -StartLog Authentication.log
|
Turns on logging to the Authentication.log log file
|
PMC.EXE -StartLog ChannelActivity.log
|
Turns on logging to the ChannelActivity.log log file
|
Related Commands
•
GetLog Command—Returns a code that indicates whether logging to the specified log file is on or off
•
StopLog Command—Turns off logging to the specified log file
StopLog Command
The StopLog command turns off logging to the specified log file.
Syntax
The syntax of this command is:
PMC.EXE -StopLog file
The file argument is one of the following strings, which specifies the log file for which to turn off logging:
•
Authentication.log
•
ChannelActivity.log
•
UserInterface.log
•
ChannelStatistics.log
Examples
Table 2-23 shows examples of the StopLog command.
Table 2-23 Return Codes for the StopLog Command
Command
|
Result
|
PMC.EXE -StopLog Authentication.log
|
Turns off logging to the Authentication.log log file
|
PMC.EXE -StopLog ChannelActivity.log
|
Turns off logging to the ChannelActivity.log log file
|
Related Commands
•
GetLog Command—Returns a code that indicates whether logging to the specified log file is on or off
•
StartLog Command—Turns on logging to the specified log file
UpVolume Command
The UpVolume command increases the volume for the specified PTT channel by a value of 10, to a maximum value of 100. This command has the same effect as clicking the PMC Increase Volume button. There are no return codes for this command.
Syntax
The syntax of this command is:
PMC.EXE -UpVolume [-line #]
The -line # option, where # is a number 1 through 8, specifies the PTT channel to which this command applies. If you omit this option, the command will apply to channel 1.
Examples
Table 2-24 shows examples of the UpVolume command.
Table 2-24 Examples of UpVolume Command Usage
Command
|
Result
|
PMC.EXE -UpVolume
|
If the volume of channel 1 is 20, increases the volume to 30
|
PMC.EXE -UpVolume -line 1
|
If the volume of channel 1 is 65, increases the value to 75
|
PMC.EXE -UpVolume -line 3
|
If the volume of channel 3 is 52, increases the value to 62
|
PMC.EXE -UpVolume -line 5
|
If the volume of channel 5 is 97, increases the value to 100 (the maximum value)
|
Related Commands
•
DownVolume Command—Has the same effect as clicking the PMC Decrease Volume button
•
GetVolume Command—Returns a code that represents the audio output volume that is set for the specified PTT channel
•
SetVolume Command—Specifies the audio output volume output for the specified PTT channel