Define Format

The Define Format window allows you to decide how your formats will work.

 

To access the Define Format window, open the Maintain Formats window and select the [Add], [Duplicate], or [Modify] buttons. (See the topic, Maintain Formats to learn how to access the Maintain Formats window.)

 

 

The Define Format window offers the following features.

Format Name

Use this option to name your format.

 

General Options

Auto-Detect Micro Filename Mask

You must enter a mask in this box so FileSWEEP knows which files to format during transfer. A mask is a filename which works like a DOS wildcard to specify more than one file. For example, if to apply this format to all files on your PC which end with the filename extension ".txt", enter a mask of "*.txt", where the asterisk "*" represents any character or characters.

You may also designate individual filenames. You may specify several masks if you separate them with a semicolon.

 

REPORT.DAT

This would cause the format to only be used when the micro file name during a transfer is "REPORT.DAT".

 

REPORT.*

This would cause the format to only be used when the micro file name during a transfer starting with "REPORT". It would work for "REPORT.1", "REPORT.DAT", etc.

 

*.TXT

This would cause the format to be used with any micro file name ending in "TXT".

 

*.DAT;*.CFG

This would cause the format to be used with any micro file name ending in either "DAT" or "CFG".

Record Delimiter

You must use this option to tell FileSWEEP what distinguishes one record from another in the file you download. (Records usually appear on separate lines of your display.)

 

None

This choice tells FileSWEEP not to separate one record from another.

 

CR/LF

This choice instructs FileSWEEP that each record appears separated by a carriage return and line feed character.

 

CR

This choice informs FileSWEEP that each record appears separated by a carriage return.

 

Tab

This choice lets FileSWEEP know that each record appears separated by a tab character.

Field Delimiter

Sometimes the records in a file contain fields. This option allows you to tell FileSWEEP what delimits, or separates, fields. Field delimiters only work when the micro file type is "With Fields".

Micro Record Length

This option allows you to tell FileSWEEP the length of records to expect from files on your host system. Either enter the length in the box, or choose Auto if you want FileSWEEP to find the length for you. (This option will not work unless you select the "fixed length" Micro choice in the File Types area.)

[Fields]

This option allows you to define the fields which appear in your records in the Define Fields window. (This option will not work unless you select the "With Fields" Micro choice in the File Types area.)

Field Count

This text shows how many fields you have defined to appear within each record. (This option will not work unless you select the "With Fields" Micro choice in the File Types area.)

View Data as Transferred

Choose this option to view data on your screen during transfers.

 

Upload Options

If Duplicate File

This item allows you to choose what FileSWEEP should do if it encounters a duplicate file on your host.

 

Cancel

This choice cancels the transfer if FileSWEEP finds duplicate file name on your host.

 

Overwrite

This choice will overwrite the previous file on your host.

 

Append

This choice will append (or add) the file you upload to the duplicate file on your host.

Expand Tabs To Spaces

This option will convert tabs to spaces when FileSWEEP uploads a file.

Honor Ctrl+Z As End-Of-File

This option tells FileSWEEP to consider a "Ctrl+Z" character as the end of a file (ASCII value 26). Some DOS applications designate the end of text files with "Ctrl+Z" characters.

Append Sequence Numbers

If you enable this option, CTCBridge will add numbers, in a numeric sequence of your choice, to each record in the files it uploads to your host.

This option only applies to host file types which contain sequence numbers. Those file types are:

·   ALGOL

·   DCALGOL

·   Sequential

·   COBOL

·   COBOL74

·   DASDL

Start

The number you enter in this box will be the first in the numeric sequence of files which FileSWEEP appends to the filenames of files you upload.

Increment

FileSWEEP will add the number you enter here to the host file name each time you upload a file.

Host Record Length

This option allows you to specify the length of records as they should be on your host system. If you do not wish to specify this length, select the Auto option and FileSWEEP will find this value for you.

Host Blocking Factor

Use this option to specify how many records to fit in one block on your host system. Your host system stores its data in blocks, and the size of these blocks should be as close as possible to the sector size of your host disk as possible, to conserve space. Choose the Auto check box if you want FileSWEEP to set this determine this value automatically.

 

Download Options

If Duplicate File

This item allows you to choose what FileSWEEP should do if it encounters a duplicate file on your PC.

 

Cancel

This choice cancels the transfer if FileSWEEP finds duplicate file name on your PC.

 

Overwrite

This choice will overwrite the previous file on your PC.

 

Append

This choice will append (or add) the file you download to the duplicate file on your PC.

Compress Spaces To Tabs

This option will convert spaces to tab characters when FileSWEEP downloads a file.

Append Ctrl+Z At End-Of-File

This option places a "Ctrl+Z" character at the end of the file you download(ASCII decimal value 26). Some DOS applications designate the end of text files with "Ctrl+Z" characters.

Remove Sequence Numbers

Some files on the host need to be stored with sequence numbers, meaning every record in the file is numbered. You may not want sequence numbers your file. To remove them, check this box.

This option only applies to host file types which contain sequence numbers. Those file types are:

·   ALGOL

·   DCALGOL

·   Sequential

·   COBOL

·   COBOL74

·   DASDL

For COBOL and COBOL74 file types, FileSWEEP deletes the first six characters of the record. For the other file types, FileSWEEP truncates the record length and removes the last eight characters.

 

File Types

Host

This option allows you to choose the type of file you expect to download or create on you host system.

Local

This option allows you to choose the type of file you expect to upload or create on your personal computer.

 

Fixed Length

Choose this option if every record will be or is the same length. This option enables the General Options Micro Record Length option.

 

Variable Length

Choose this option if every record will not have or does not have the same length.

 

With Fields

Choose this option if your fixed length records contain fields. This option enables the General Options [Fields] button.

 

Related Topics: