Tachyon Re-Xmit - Command Line Options

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

trex -in file-name-or-path-pattern -dsn data-set-name
     [-m member-names] [-msg message-file-name]
     [-origin node.user] [-target node.user]
     [-filedata {text|record|binder}] [-tabs {0|4|8}]
     [-recfm record-format] [-lrecl record-length]
     [-blksize block-size] [-dirblks [+]blocks]
     [-space {cyl|trk},[+]primary[,secondary]]
     [-device {3330|3340|3350|3375|3380|3390|9345}]
     [-@parameter-file-name] [-out] transmit-file-name
Where:
trex
The Command Line Interface program name is trex. If the directory containing the trex program is not in the PATH, then the path name must be specified. e.g. C:\Tachyon\trex
-in file-name-or-path-pattern
To create a TRANSMIT file for a sequential data set, the -in option must be followed by the name of an existing workstation file. To create a TRANSMIT file for a partitioned data set, the -in option must be followed by a path pattern which will be used to select workstation files to become members of the PDS. The path pattern must contain &M, &m or (for Windows only) *. The &M or &m is replaced by the member name. &M specifies that the member name is in upper case and &m specifies that the member name is in lower case. For Windows, * matches files regardless of case. The -in option is required. For example: -in C:\MACLIB\&M.MAC
-dsn data-set-name
The -dsn option specifies the name of the data set in the TRANSMIT file. The data-set-name must follow the rules for normal OS/390 data set names. The -dsn option is required. For example: -dsn sys1.maclib
-m member-names
The -m option selects the members to be included in a TRANSMIT file containing a partitioned data set. If the -m option is not specified, all members that match the -in path pattern will be included. If -m is specified, it must be followed by the member names. 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 to follow the member name list. For example: -m MEMBER1 MEMBER3
-msg message-file-name
The -msg option instructs Tachyon Re-Xmit to include a message in the TRANSMIT file and specifies the name of the workstation file containing the message text. If the -msg option is not specified, no message will be included in the TRANSMIT file. For example: -msg C:\MYFILES\message.txt
-origin node.user
-target node.user
The -origin and -target options specify the node name and user-ID included in the TRANSMIT file as the origin and target. The node name and user-ID must be 1 to 8 characters, all of which must be A through Z or 0 through 9 and the first character must be A through Z. The node name must be followed by a period and then the user-ID. For example: -origin mvs001.me
-filedata {text|record|binder}
The -filedata option specifies the format of the workstation files to be included in the TRANSMIT file. -filedata binder is only allowed when the -in option specifies a path pattern for a PDS. -filedata text and -filedata  are allowed for transmitting sequential or partitioned data sets.
-tabs {0|4|8}
For text input files (-filedata text), this parameter specifies the tab expansion option. -tabs 0 disables tab expansion. -tabs 4 and -tabs 8 enable tab expansion and set the tab stops to the specified value.
-recfm record-format
The -recfm option specifies the record format of the data set included in the TRANSMIT file. For -filedata record, this option also specifies the format of the input files. The record format code must be one of:
F
Fixed unblocked records
FB
Fixed blocked records
FS
Fixed unblocked standard records (not allowed for PDS)
FBS
Fixed blocked standard records (not allowed for PDS)
V
Variable unblocked records
VB
Variable blocked records
VS
Spanned unblocked records (not allowed for PDS)
VBS
Spanned blocked records (not allowed for PDS)
U
Undefined records
These record format codes may also be specified with A or M as the last letter, indicating that the records start with ASA or machine control characters. The M code is not allowed with -filedata text. For -filedata binder, this option is not needed since load libraries always contain undefined records. For example: -recfm fb
-lrecl record-length
The -lrecl option specifies the logical record length of the data set included in the TRANSMIT file. For -filedata record, this option also specifies the record length of the input files. For -filedata text, this option specifies the maximum length of any text line. This option is not needed with -recfm u.
-blksize block-size
The -blksize option specifies the block size of the data set included in the TRANSMIT file. For -filedata record, this option also specifies the block size of the input files.
-dirblks [+]blocks
For a PDS, the -dirblks option specifies the number of directory blocks that will be allocated in the transmitted data set. If the block count is specified without the leading plus sign, the number of blocks must be enough to hold the directory entries of all transmitted members. If the block count is specified with the leading plus sign, the specified count will be added to the number of blocks required for the transmitted members.
-space {cyl|trk},[+]primary[,secondary]
For a PDS, the -space option specifies the allocation unit and allocation size of the data set included in the TRANSMIT file. If cyl is specified the allocation will be in cylinders, otherwise for trk the allocation will be in tracks. If the primary allocation is specified without a leading plus sign, the allocation must be large enough to hold the directory and all transmitted members. If the primary allocation is specified with a leading plus sign, the specified allocation will be added to the minimum allocation required.
-device {3330|3340|3350|3375|3380|3390|9345}
For a PDS, the -device option specifies the device type of the data set included in the TRANSMIT file. The RECEIVE command can unload the PDS to a different device type, but the internal format of the TRANSMIT file records for a PDS is device dependent. The device code also determines the maximum allocation size and maximum block size.
-@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.
[-out] transmit-file-name
The -out option specifies the name of the TRANSMIT file to be created. If the TRANSMIT file name is the last option on the command line, -out is optional. The TRANSMIT file name is always required on the trex command line.

Using the Command Line Interface Interactive Mode

When the Tachyon Re-Xmit Command Line Interface program (trex) is invoked, it attempts to obtain the information it needs from the command line parameters. If any required information is not specified in the command line parameters, you will be prompted for the information.

When you are asked to respond to a question, you should type your response and press the ENTER key. Some questions will include a default answer in square brackets: e.g. Directory blocks (5-32767) [5]:
For this question, if the correct answer is 5, you only need to press the ENTER key. If you type a response to this question, the answer must be between 5 and 32767.


Frames No Frames Previous Next Contents
Introduction Setup Link Edit Un-Xmit Re-Xmit Update Utility Translation
© Copyright 1999-2005, Tachyon Software® LLC.
Last modified on April 13, 2005