TapeTrack Documentation

Because there is more to tape management than you ever realized

User Tools

Site Tools


cli:tmss10ping
 
 

TMSS10Ping

Command line programs are executed via a Command Line Prompt or via a batch file. They cannot be executed by double clicking or right click run

Synopsis

TMSS10Ping [-n count] [-P port] host

Description

TMSS10Ping sends dummy packets to a TapeTrack Framework Server and receives a reply packet.

Unlike the ping command which sends ICMP echo packets, TMSS10Ping sends payload packets via the TCP/IP protocol. This means that even if a firewall is configured to block ping requests, if TapeTrack connections are allowed, then TMSS10Ping packets will be successful.

Options

The options which apply to the TMSS10Ping command are:

  • -n This option sets the number of test packets to send, set as an Integer (default=4).
  • -P This option sets the TCP/IP port to, set as an Integer (default=5000).
  • host Host name(DNS) or dotted IP address of the TapeTrack Framework Server.

Exit Status

  1. zero Program has ended successfully.
  2. non-zero Program was unable to connect to the TapeTrack Framework Server.

Environment

Files

  • stdout Program messages indicating statistics from ping.

Examples

This example tests a TapeTrack connection on port 443.

C:\>TMSS10Ping -P 443 tapetrack.ironmountain.com
44 bytes from 216.229.153.104: seq=1 time=58.00 ms
44 bytes from 216.229.153.104: seq=2 time=58.00 ms
44 bytes from 216.229.153.104: seq=3 time=58.00 ms
44 bytes from 216.229.153.104: seq=4 time=57.00 ms
--- tapetrack.ironmountain.com TMSS10Ping statistics ---
4 packets transmitted

round-trip min/avg/max = 0.00/57.75/58.00 ms

This example sends an email if a TapeTrack Server is down.

#!/bin/bash
TMSS10Ping -P 443 tapetrack.ironmountain.com > /dev/null
[ $? -ne 0 ]; then
sendmail .....
fi

This example sends ping request via a proxy server, creates a trace file and displays the trace file.

set PROXYIP=192.168.1.10
set PROXYPORT=3128
set PROXYUSER=
set PROXYPW=
set TAPETRACKIP=server.databank.co.il
set TAPETRACKPORT=443
set TMSSAPILOGDIR=%TEMP%
set TMSSSERVERPROXY=%PROXYUSER%:-%PROXYPW%@%PROXYIP%:%PROXYPORT%
del /Q "%TMSSAPILOGDIR%\TMSSAPILOG-*.txt"
TMSS10Ping -P %TAPETRACKPORT% %TAPETRACKIP%
type "%TMSSAPILOGDIR%\TMSSAPILOG-*.txt"
pause
Changelog
2015-08-24Changed hascontents to contentcount and change contentcount to a filter rather than bool
2015-08-24Added iscontainer and hascontents to the config file filter logic
2015-05-16Added environmental varialbe TMSSCANFILEUNQUALIFIED which will load and check volumes without Customer-ID and Media-ID qualifiers
2015-05-16Added environmental varialbe TMSSSCANFILENOPARSE which will presume scanfile items are only Volumes and not parse them, saving time
2015-05-16When loading scanfile from import definition, added CUSTOMER and MEDIA keywords to set defaults
2015-05-16When loading scanfile from import definition, changed keyword from VOLUME to BARCODE
2015-05-16Added TMSSUNQUALIFIEDVOLUME environmental variable which forces all barcodes to be printed without Customer-ID and Media-ID
2015-05-04Added support for AD passwords to all command line programs (check for environmental variable TMSSNOMD5)
2014-11-19Changed server argument parser to allow colon in password to support z/OS DD name files
2014-10-26Upgraded development environment from Visual Studio 2012 to Visual Studio 2013
2014-08-07Added UNIX man page
cli/tmss10ping.txt · Last modified: 2022/06/06 02:18 by scunliffe