HP 3000 Manuals

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