VOS File Transfer Utilities

Last updated 2006-07-27.

This directory contains programs that can be used to compress and decompress VOS files, or can be used to convert a VOS file to a stream file while retaining its original VOS structure information for eventual restoration. Unlike other programs on this file server, these programs are available already compiled. Over time, we will be converting the file server to store all files in compressed, encapsulated form using these tools.

Together with the standard VOS save and restore commands, these commands enable you to save a complete VOS file or directory in a single, compact stream file without losing any VOS file type information. Such files are called "bundled" files for convenience.

The VOS command macro "bundle.cm" can be used to create a bundled file, and the command macro "unbundle.cm" can be used to turn a bundled file back into the original VOS file or directory.

Bundling Utility Files

README.txt "readme" file for this directory, with instructions on how to transfer the files using FTP.

UPDATE.txt description of the latest changes to these utilities.

bundle.cm VOS command macro to create a bundled file.

bundle.help help file for bundle.cm command.

unbundle.cm VOS command macro to unbundle a file.

unbundle.help help file for unbundle.cm command.

decode_vos_file.doc documentation of decode_vos_file.pm command.

decode_vos_file.help help file for decode_vos_file.pm command.

encode_vos_file.68k.pm 68k version of encode_vos_file.pm.

encode_vos_file.7100.pm PA-7100 version of encode_vos_file.pm.

encode_vos_file.8000.pm PA-8xxx version of encode_vos_file.pm.

encode_vos_file.860.pm i860 version of encode_vos_file.pm.

encode_vos_file.pentium4.pm Pentium4 version of encode_vos_file.pm.

encode_vos_file.doc documentation of the encode_vos_file command.

encode_vos_file.help help file for the encode_vos_file command.

evf-2.0.save.evf.gz bundled file with encode_vos_file source.

gzip-1_2.exe gzip version 1.2.4 for MS-DOS (self-extracting file).

gzip-1.2.4.save.evf.gz bundled file with gzip version 1.2.4 source and the VOS binaries.

bzip2.7100.pm PA-7100 version of bzip2.pm.

bzip2.8000.pm PA-8xxx version of bzip2.pm.

bzip2.pentium4.pm Pentium4 (V Series) version of bzip2.pm.

gzip.68000.pm 68000 and 68010 version of gzip.pm.

gzip.68k.pm 68020 and 68030 version of gzip.pm.

gzip.7100.pm PA-7100 version of gzip.pm.

gzip.8000.pm PA-8000 version of gzip.pm.

gzip.860.pm i860 version of gzip.pm.

gzip.pentium4.pm Pentium4 (V Series) version of gzip.pm.

gzip.nt.68000.pm 68000 and 68010 version of gzip.pm, no symbol tables.

gzip.nt.68k.pm 68020 and 68030 version of gzip.pm, no symbol tables.

gzip.nt.7100.pm PA-7100 version of gzip.pm, no symbol tables.

gzip.nt.8000.pm PA-8000 version of gzip.pm, no symbol tables.

gzip.nt.860.pm i860 version of gzip.pm, no symbol tables.

gzip.nt.pentium4.pm Pentium4 (V Series) version of gzip.pm, no symbol tables.

gzip.doc man page for gzip.

gzip.info general info file for gzip.

gzip.tar original gzip distribution file (useful for PC, Workstation, or Unix® environments).

COPYING GNU General Public License (covers gzip).

Download Example

1. Transfer the following files to a local machine (VOS, PC, Mac, Sun, whatever). FTP will create stream files on whatever platform you are using.

   ftp ftp.stratus.com 
   [user: anonymous            ]
   [pass: your_name@your_site  ]
   cd /pub/vos/utility
   ascii
   get bundle.cm
   get unbundle.cm
   get decode_vos_file.doc
   get encode_vos_file.doc
   get gzip.doc
   get gzip.info
   get bundle.help
   get unbundle.help
   get decode_vos_file.help
   get encode_vos_file.help
   binary
   get evf-2.0.save.evf.gz
   get gzip-1.2.4.save.evf.gz
   get encode_vos_file.68k.pm
   get encode_vos_file.7100.pm
   get encode_vos_file.8000.pm
   get encode_vos_file.860.pm
   get encode_vos_file.pentium4.pm
   get bzip2.7100.pm
   get bzip2.8000.pm
   get bzip2.pentium4.pm
   get gzip.68k.pm
   get gzip.68000.pm
   get gzip.7100.pm
   get gzip.8000.pm
   get gzip.860.pm
   get gzip.pentium4.pm
   bye
   

2. Transfer the above files to VOS using FTP or any method that preserves the file contents exactly. By default, files transferred in binary mode are created using the stream organization. This is the correct organization for program modules for the Pentium4 architecture. The program modules for the 68000, i860, and PA-RISC architectures must be created using the fixed-4096 organization, or must be converted to this organization before they can be executed. Run the following VOS commands to convert stream files with the "pm" suffix to fixed-4096 files. The cvt_stream_to_fixed command is available starting in VOS 11.5. If you are running a version of VOS that does not have the cvt_stream_to_fixed command, call your Stratus Customer Assistance Center and request that they send it to you.

   !cvt_stream_to_fixed encode_vos_file.68k.pm
   !cvt_stream_to_fixed encode_vos_file.7100.pm
   !cvt_stream_to_fixed encode_vos_file.8000.pm
   !cvt_stream_to_fixed encode_vos_file.860.pm
   !cvt_stream_to_fixed bzip2.7100.pm
   !cvt_stream_to_fixed bzip2.8000.pm
   !cvt_stream_to_fixed gzip.68k.pm
   !cvt_stream_to_fixed gzip.68000.pm
   !cvt_stream_to_fixed gzip.7100.pm
   !cvt_stream_to_fixed gzip.8000.pm
   !cvt_stream_to_fixed gzip.860.pm
   

3. Select the proper versions for your hardware platform.

   !copy_file *.68000.pm *.pm /* For an FT200/XA400/XA600 platform
   !copy_file *.68k.pm *.pm   /* For a XA2000 (68020/68030) platform
   !copy_file *.860.pm *.pm   /* For an XA/R (i860) platform
   !copy_file *.7100.pm *.pm  /* For a Continuum (PA-RISC) platform
   !copy_file *.8000.pm *.pm  /* For a Continuum (PA-RISC 8xxx) platform
   !copy_file *.pentium4.pm *.pm /* For a V Series (Pentium4) platform
   

4. Create decode_vos_file.pm

   !copy_file encode_vos_file.pm decode_vos_file.pm
   

   or

   !link encode_vos_file.pm decode_vos_file.pm
   

5. If you want to see the source code, execute the following commands:

   !create_dir gzip_source
   !unbundle gzip-1.2.4.save.evf.gz gzip_source
   
   !create_dir evf_source
   !unbundle evf-2.0.save.evf.gz evf_source
   

Note

You need the VOS Standard C compiler (aka ANSI C Compiler; the cc command) in order to compile the source code for gzip. Note that the VOS ANSI C compiler is able to compile the gzip source code without ANY changes! The source code will not compile with the older VOS C compiler.

Either the VOS C compiler or the VOS Standard C compiler can be used to compile the source code for encode_vos_file.

Comments

If you have questions or comments about these commands, please post them to the USENET newsgroup "comp.sys.stratus" or, if you are a subscriber to the "info-stratus@LIST.STRATAGY.COM" mailing list, you may send them to this mailing list. The authors of the commands respectfully request that you not contact them directly.

These programs are not supported by Stratus Customer Service.

All information is © 1994-2004 Stratus Technologies Bermuda, Ltd. All Rights Reserved.