Tachyon Un-Xmit - Command Line Options

The command line syntax for the Tachyon Un-Xmit Command Line Interface Program is:

tux [-s|-l|-e] [-out target-path] [-file file-number]
    [-type {text|dump|tos|ibm|convert|delink|relink}]
    [-sysprint path|-nosysprint] [-bindparm {nomap|map|xref}]
    [-[no]replace] [-format {f|v|vb|vs|vbs|0|2e|2i|4|4s}]
    [-lrecl record-length] [-blksize block-size] [-tabs {0|4|8}]
    [-char xx] [-[no]strip] [-[no]ascii] [-[no]trunc] [-dos|-unix]
    [-@parameter-file-name] [-all|-m member names] xmit-file

tux

The Command Line Interface program name is tux. If the directory containing the tux program is not in the PATH, then the path name must be specified. e.g. C:\Tachyon\tux

xmit-file

The file name of the TRANSMIT file is the only required command line parameter.

-s

The -s option specifies that a summary report of the contents of the xmit-file is to be produced. If this option is specified, no other function will be performed by Tachyon Un-Xmit.

-l

The -l option specifies that a listing of the contents of the selected file-number is to be produced. This option is not useful for a sequential data set. For a partitioned data set, a directory listing will be printed. For a message data set, the contents will be printed. If this option is specified, no other function will be performed by Tachyon Un-Xmit.

-e

The -e option specifies that the selected file-number is to be extracted. If this option is specified, no other function will be performed by Tachyon Un-Xmit.

-file file-number

TRANSMIT files can contain more than one data set. Unless a message data set was specified on the TSO/E TRANSMIT command that produced the TRANSMIT file, the file will normally contain only one data set and the -file parameter is not required. You can see how many data sets are contained in a TRANSMIT file by printing a summary report (see the -s option).

-out target-path

For an extract function, this parameter specifies the path name or path pattern for the output file(s). If a sequential data set is to be extracted, the target-path must be the output file name. If members of a partitioned data set are to be extracted, the target-path must be the path pattern for the output files. The path pattern must contain &M or &m. The &M or &m is replaced by the member name being extracted. &M is replaced by the member name in upper case and &m is replaced by the member name in lower case. e.g. -out C:\MACLIB\&M.MAC
If the target-path is prefixed with &D, the &D will be replaced with the name of the directory containing the TRANSMIT file, causing the output files to be created in the same directory as the input file. e.g. -out &D&M.MAC

-type {text|dump|tos|ibm|convert|delink|relink}

For an extract function, this parameter selects the output file type.

-sysprint listing-path | -nosysprint

For a -type relink extract function, this parameter specifies the binder output listing file. If -nosysprint is specified, the binder listing will be written to stdout. If a listing-path is specified, it can be either a file name or a path pattern. If a file name is provided, the binder reports for all members will be written to the same file. If a path pattern is provided, a separate listing file will be produced for each member extracted. A path pattern must contain &M or &m. The &M or &m is replaced by the member name being extracted. &M is replaced by the member name in upper case and &m is replaced by the member name in lower case. e.g. -sysprint C:\BINDER\&M.LST
If the listing-path is prefixed with &D, the &D will be replaced with the name of the directory containing the TRANSMIT file, causing the listing files to be created in the same directory as the input file. e.g. -sysprint &Dbinder.lst

-bindparm {nomap|map|xref}

For a -type relink extract function, this parameter specifies the -parm value that will be passed to the binder. The parameter code must be one of the following:

Option	-parm Value
nomap	NOMAP,NOXREF
map	MAP,NOXREF
xref	MAP,XREF

-replace and -noreplace

For an extract function, if an output file exists, this parameter specifies if the existing file is to be replaced. If -replace is specified, existing files will always be replaced. If -noreplace is specified, existing files will not be replaced. If neither is specified, you will be asked if you want to replace the existing file.

-format {f|v|vb|vs|vbs|0|2e|2i|4|4s}

For a -type convert extract function, this parameter selects the output file format. The format code must be one of the following:

f

Fixed

v

Variable Unblocked

vb

Variable Blocked

vs

Spanned Unblocked

vbs

Spanned Blocked

0

No Record Delimiters

2e

2-byte Exclusive RDW

2i

2-byte Inclusive RDW

4

4-byte Standard RDW

4s

4-byte Spanned RDW

-lrecl record-length

For a -type text extract function, this parameter sets the maximum record length. Records longer than record-length will be truncated. If the record-length is 0, records will not be truncated.
For a -type dump extract function, this parameter sets the width of the dump listing. record-length values less than 120 select the narrow format. If the record-length is 0 or greater than 119, the wide format dump will be produced.
For a -type convert extract function, this parameter sets the logical record length. If the record-length is 0, the record length is obtained from the original data set.

-blksize block-size

For a -type convert extract function with blocked or spanned output records, this parameter sets the maximum block size.

-tabs {0|4|8}

For a -type text extract function, this parameter specifies the tab compression option. -tabs 0 disables tab compression. -tabs 4 and -tabs 8 enable tab compression and set the tab stops to the specified value.

-char xx

For a -type convert extract function this parameter sets the strip / pad character. The value must be a 2-digit hexadecimal number from 00 to FF. For -format f output records, any records shorter than the -lrecl record-length value will be padded with the specified character. For other output record formats if -strip is specified, any records ending in the specified character will be stripped of those characters.

-strip and -nostrip

For a -type text extract function this parameter specifies if records ending in EBCDIC character values less than or equal to X'40' should be stripped of those characters.
For a -type convert extract function with output record formats other than -format f, this parameter specifies if records ending in the -char xx value should be stripped of those characters.

-ascii and -noascii

For a -type convert extract function this parameter specifies if output records should be translated using the EBCDIC to ASCII translation table.

-trunc and -notrunc

For a -type convert extract function this parameter specifies if output records should be truncated if they are longer than the maximum record length set through the -lrecl parameter. If -notrunc is specified and any output records (after any stripping) are longer than the maximum record length, an error message will be displayed and the extract function will be terminated.

-dos and -unix

For a -type text extract function this parameter specifies if output lines should be terminated in the DOS/Windows style (carriage-return and line-feed: X'0D0A') or the UNIX style (line-feed: X'0A').

-@parameter-file-name

The -@ command line parameter may be used to provide the linkage editor with command line parameters that are in a file. This can help you overcome the severe limitations on the length of the command line imposed by Windows 95, Windows 98 and Windows ME. (Windows NT, Windows 2000, Windows XP, Linux and UNIX do not have these limitations.) A file name must immediately follow the -@ parameter. Multiple -@ parameters are allowed but the -@ parameter itself is not allowed within a file referenced by the -@ parameter. The -@ parameter is logically replaced with the contents of the file.

-all and -m member-names

For an extract function of a partitioned data set, this parameter selects the members to be extracted. If -all is specified or -m is not specified, all members included in the PDS in the TRANSMIT file will be extracted. If -m is specified, it must be followed by the member names. Any alphabetic characters in the member names must be in upper case. The member names must be listed with at least one blank between each one. The end of the member name list is recognized when an invalid member name is encountered, allowing other command line parameters or the TRANSMIT file name to follow the member name list, unless the TRANSMIT file name is also a valid member name. e.g. -m MEMBER1 MEMBER3