HP 3000 Manuals

&EXPORT [ HP DeskManager Customization ] MPE/iX 5.0 Documentation


HP DeskManager Customization

&EXPORT 

Syntax 

&EXPORT {item} {filename} [area]

where:

item                  quoted string or numeric value in the range 1 to
                      1023
filename              parenthetical string
area                  numeric value in the range 1 to 25

Description 

&EXPORT copies an item from the current area to an MPE file.  Item 
specifies the item to be copied.  If filename is present, it must be a
valid MPE filename (including a lockword if required) and a file of that
name may not currently exist.  If a filename is not given for the MPE
file, HP Desk provides one.  The filename may be a null parenthetic
string, "()", in which case, HP Desk must generate a filename.  If this
happens, the filename will be of the form P#######, that is, the letter
"P" followed by up to seven digits, to hold the item.  If you use HP Menu
Intrinsics, you may want to give an area in this command.  It represents
the current object area which will be updated with the name of the
exported file.  This area can be accessed by a program using the HP Menu
Intrinsics.  Refer to Chapter 12  for further information on the
current object store.

If the item exported is a text item (filecode 1167), a file label will be
written to the file containing the subject of the item.  The format of
the label has "DESK" as the first 4 characters, followed by the subject
in the following 60 characters.  This information may then by accessed by
an application program.

See also:  &CLEAROBJ, &IMPORT, <OBJECTNAME>.

Example 

     &EXPORT "Weekly Status Report" (Report)

This will copy the item called "Weekly Status Report" to an MPE file
called "Report".



MPE/iX 5.0 Documentation