tsmpipe/README.md

# About
TSMPIPE is a Tivoli Storage Manager (TSM) or now known as Spectrum Protect client, that enables you to take data from STDIN and store that in TSM as a BACKUP or ARCHIVE object.
By using this client, you dont need to do a dump to disk process, followed by using the Spectrum Protect Backup Archive Client. (So no more consuming disk space with old dumps!)

Restoring data, is the reverse step, restoring directly back to the application from Spectrum Protect.

# Using
In its simplest form, you can
```cat myfile.ext | tsmpipe -c [MORE OPTIONS]```

Or, where an application supports "dumping" to STDOUT, you can pipe that dump into TSMPIPE.
```myappdump | tsmpipe -c [OPTIONS]```

Getting data back is the reverse
```tsmpipe -x [MORE OPTIONS] > myfile```

Or, back to your application
```tsmpipe -x [MORE OPTIONS] | myapp```

This client can also calculate a digest while backuping up data (like MD5, SHA1, etc) - so that you can verify that the dump out of the application matches what goes into
Spectrum Protect. For example:

```
myappdump > file
md5sum file
cat file | tsmpipe -cBs /example/ -f file -m md5
tsmpipe -xBs /example/ -f file > file2
md5sum file2
```

The MD5 calculation should match in all cases - including the MD5 printed by tsmpipe. See the build test script for more details.
# Building
Building TSMPIPE is hopefully relatively easy - it's currently only tested on Linux (specifically CentOS), but it should be buildable on other Spectrum Protect
supported platforms, however you may need to create an appropriate Makefile.

Here is a blog on building on Linux: https://thefrinkiac7.wordpress.com/data-protection/building-tsmpipe

# Help
For help, use tsmpipe -h
To test that you can connect to TSM, use tsmpipe -i