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

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.