PMDF User's Guide
OpenVMS Edition
PMDF-USR-VMS-6.0

Controls the DCL command used to display a MIME image type body part.

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 IMAGE_COMMAND command

SET NOIMAGE_COMMAND

SHOW IMAGE_COMMAND

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

PARAMETERS

command

DCL command to use to display an image.

DESCRIPTION

The SET and SHOW IMAGE_COMMAND commands control how PMDF MAIL displays MIME messages containing parts labelled as type image (e.g., a GIF or TIFF image).

PMDF MAIL has its own procedures for displaying images. You may override these procedures with the SET IMAGE_COMMAND. With this command, you specify a DCL command which accepts five parameters: (1) the message content type (always IMAGE), (2) the message content subtype, (3) the name of the file containing the data to display, (4) a title to show, if possible, when displaying the image, and (5) whether or not to delete the file after displaying it (DELETE or NODELETE). The specified DCL command will then be executed from a subprocess each time an image is to be displayed; the parameters (1) --- (5) will be provided by PMDF MAIL.

To undo a setting made with the SET IMAGE_COMMAND command, use SET NOIMAGE_COMMAND. The current setting may be queried with the SHOW IMAGE_COMMAND command.

Examples

Suppose that the following command procedure D1:[BOB]IMAGE.COM has been developed to display images using the XV utility provided with PMDF:

$ set noverify 
$ set noon 
$ ! 
$ ! D1:[BOB]IMAGE.COM  -- Display a message part of type IMAGE using XV 
$ ! 
$ ! P1 = content type    (always "IMAGE") 
$ ! P2 = content subtype (accept anything; let XV decide what to do with it) 
$ ! P3 = file name       (file containing image data to display) 
$ ! P4 = title           (window title; e.g., "NEWMAIL 3") 
$ ! P5 = DELETE/NODELETE 
$ ! 
$ WNAME = """-wname"" ""''P2'""" 
$ XV    = "$PMDF_EXE:XV.EXE" 
$ XV 'wname' 'P3' 
$ 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 IMAGE, issue the following command:

EMAIL> SET IMAGE_COMMAND "@D1:[BOB]IMAGE.COM"
EMAIL> SHOW IMAGE_COMMAND
Image viewing command is "@D1:[BOB]IMAGE.COM". 
EMAIL>