Command Line Interface Commands

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