DOSTOMPE [ HP Resource Sharing for MPE/iX ] MPE/iX 5.0 Documentation
HP Resource Sharing for MPE/iX
DOSTOMPE
The DOSTOMPE command converts shared disc files from DOS to MPE format.
You can retain both copies of a file, or move a single converted copy
from your shared disc to your MPE account.
To stop the conversion, press CTRLY. If you stop the conversion of
multiple files, you will see the following prompt:
CTRL-Y detected. Do you want to continue the conversion (Y/N)?
If you want to continue the conversion, enter Y. If you do not want to
continue the conversion, enter N, and DISCMGR reports the number of files
that were already converted.
Abbreviation: DTM
DOSTOMPE sourcefile TO targetfile[;options]
sourcefile Shared disc DOS file. Standard DOS wildcards can be
used. The file must be in one of the following formats:
drive:dosfile
(J:FILE1.TXT or J:\DIR1\DIR2\FILE1.TXT)
dosfile
(FILE1.TXT or \DIR1\DIR2\FILE1.TXT)
MPE:\account\group\dosfile
(MPE:\SYS\ADMIN\DIR1\DIR2\FILE1.TXT)
If you have SM capability, you can access a shared disc
in any group or account. If you have AM capability, you
can access a shared disc in any group within your
account.
!sharename [password]:dosfile
(!JOE PASS:\DIR1\DIR2\FILE1.TXT)
targetfile An MPE file. Standard MPE conventions apply, including
the use of wildcards and back-references to file
equations.
options All options can be specified in a single command, except
that ASCII and BINARY, which contradict each other,
cannot both be used.
SHOW--Displays a list of the files as they are being
converted.
MOVE--Purges sourcefile after conversion.
REPLACE--Indicates targetfile replaces existing
targetfile.
ASCII--Specifies targetfile to be an ASCII file.
BINARY--Specifies targetfile to be a binary file
(default = ASCII).
RECSIZE--Specifies targetfile record size in bytes or
words. The default value is -80 if the BINARY option is
not specified. If you specify the BINARY option, the
default is -256. When entering record size, remember to
enter "words" as a positive number (RECSIZE=40) and
bytes as a negative number (RECSIZE=-80).
For example, to copy the DOS file on the J: shared disc called FILE3 to
an MPE file (and to replace an old version of FILE3 with this version),
enter:
DOSTOMPE J:FILE3 TO @;REPLACE
To print the names of the files being converted to a printer or disc
file, use a DMLIST file equation (see Chapter 14, "Advanced Uses of Disc
Manager").
Converting Multiple Files Using Wildcards
You can use standard DOS and MPE wildcard characters to convert multiple
files with a single DOSTOMPE command. These wildcards are @, #, ?, *
(described in the "Converting and Copying Files" section of Chapter 13).
DOS filenames can contain characters that are invalid in MPE filenames.
For example, MPE filenames cannot contain extensions or certain special
characters such as $ or _. DISCMGR produces valid MPE filenames by:
* Dropping DOS file extensions
For example, the DOS filenames REPORT.M1 and MYFILE.EXT would be
changed in MPE to REPORT and MYFILE.
If you need to identify files based on their file extensions,
enter the extension as part of the source filename. For example,
if you want to transfer files that end in the extension .EXT and
you want to be able to recognize these files in MPE by their
extensions, enter this command:
DOSTOMPE *.TXT TO @TXT
This transfers all DOS files with TXT extensions to MPE files
whose eight-character names ended in TXT. If the filename has more
than five characters in it, the letters will be truncated so that
the TXT can be added.
For example, let's say you want to convert the following DOS files
to MPE:
MYFILE.TXT
MYREPORT.TXT
MYRPT.TXT
If you entered the command shown above, these new filenames would
result:
MYFILTXT
MYREPTXT
MYRPTTXT
* Eliminating invalid MPE characters
For example, the DOS file SAMPLE$1 would be changed in MPE to
SAMPLE1.
* Providing generic filenames when DOS filenames are composed
entirely of invalid MPE characters
In an interactive session, DISCMGR prompts you for a unique
filename when a valid MPE filename cannot be produced.
In batch mode, DISCMGR creates generic filenames in the format
FILEnnnn, where nnnn is a number from 0001-9999. For example, the
DOS filename 123&##%.EXT would be renamed in MPE to FILE0001.
* Not converting a file when a duplicate filename exists
In an interactive session, DISCMGR prompts you for a filename when
it encounters a duplicate filename (and you haven't specified the
REPLACE option).
In batch mode, DISCMGR does not convert duplicate files unless you
specify the REPLACE option.
Using Other MPE File Attributes
MPE allows many file attributes during file creation. If DISCMGR
supported all of these attributes, the commands would be too long. You
can use these attributes by using a DMATTRIB file equation to specify
other MPE attributes for the file or fileset you create. The following
FOPEN attributes are supported:
* All Foptions
* All Aoptions
* Record size
* File code
* Block size
* Number of extents
For example, to specify the files you create as 80-byte, fixed ASCII,
message files, enter these commands at the DISCMGR> prompt:
:FILE DMATTRIB;REC=-80,,F,ASCII;MSG
DOSTOMPE J:*.* TO @
The system might display:
Warning, DMATTRIB file attributes are in effect. (DM6202)
FILE1.EXT --- FILE1
"
"
30 files converted.
To turn off these attributes, enter this command:
:RESET DMATTRIB
MPE/iX 5.0 Documentation