PMDF User's Guide
OpenVMS Edition


Previous Next Contents Index


SET & SHOW AUDIO_COMMAND

Controls the DCL command used to playback MIME audio type body parts.

restrictions

Requires SYSPRV privilege to set information for users other than yourself; requires SYSPRV or SYSNAM privilege to show information about users other than yourself.

Syntax

SET AUDIO_COMMAND command

SET NOAUDIO_COMMAND

SHOW AUDIO_COMMAND

Qualifiers Defaults
/ALL /NOALL
/LOG /NOLOG
/UIC="[g,m]" None
/USER=username None

Parameters

command

DCL command to use to playback and audio file.

Description

The SET and SHOW AUDIO_COMMAND commands control how PMDF MAIL plays back MIME messages containing parts labelled as type audio (e.g., audio files).

PMDF MAIL has its own procedures for replaying audio messages. You may override these procedures with the SET AUDIO_COMMAND. With this command, you specify a DCL command which accepts six parameters: (1) the message content type (always AUDIO), (2) the message content subtype, (3) the name of the file containing the audio data, (4) a title to show, if desired, when replaying the audio data, (5) whether or not to delete the file after displaying it (DELETE or NODELETE), and (6) the user's preferred audio device as selected with the SET AUDIO_DEVICE command. The specified DCL command will then be executed from a subprocess each time an application is to be displayed; the parameters (1) --- (6) will be provided by PMDF MAIL.

To undo a setting made with SET AUDIO_COMMAND, use SET NOAUDIO_COMMAND. The current setting, if any, may be queried with SHOW AUDIO_COMMAND.


Examples

Suppose that the following command procedure D1:[BOB]AUDIO.COM has been replay audio files:


$ set noverify 
$ set noon 
$ ! 
$ ! D1:[BOB]APPL.COM  -- Display a message part of type APPLICATION 
$ ! 
$ ! P1 = content type    (always "AUDIO") 
$ ! P2 = content subtype (accept BASIC and DDIF/DIVA) 
$ ! P3 = file name       (file containing application data to display) 
$ ! P4 = title           (we ignore this) 
$ ! P5 = DELETE/NODELETE 
$ ! P6 = audio device 
$ ! 
$ P2 = F$EDIT (P2, "UPCASE") 
$ if "BASIC"  .eqs. P2 then goto BASIC 
$ if "DDIF"   .eqs. P2 then goto DDIF 
$ if "DIVA"   .eqs. P2 then goto DIVA 
$ write sys$output "Unrecognized content type/subtype: ''P1'/''P2'" 
$ goto DONE 
$ ! 
$ DDIF: 
$ DIVA: 
$   VIEW/INTERFACE=DECWINDOWS 'P3'/FORMAT=DDIF 
$   goto DONE 
$ BASIC: 
$   SET COMMAND D1:[BOB.TOOLS]AUDIO.CLD 
$   AUDIO PLAY/DEVICE='P6' 'P3' 
$   goto DONE 
$ DONE: 
$   if f$edit (P5, "UPCASE") .eqs. "DELETE" then delete/nolog 'P3'; 
$   exit 
To instruct PMDF MAIL to use this procedure to display message parts of type APPLICATION, issue the following command:


EMAIL> SET AUDIO_COMMAND "@D1:[BOB]AUDIO.COM"
EMAIL> SHOW AUDIO_COMMAND
Application viewing command is "@D1:[BOB]AUDIO.COM". 
EMAIL> 


Previous Next Contents Index