MPE/iX BUILD command parameters can be
used to modify the default file building parameters for files transferred
to an MPE/iX system.
When no BUILD command parameters are specified
with the target MPE/iX file designation, the MPE/iX FTP server builds
the file with the following defaults depending on the transfer mode
used:
For ASCII file transfers:
REC=-80,,F,ASCII;DISC=204800 |
which translates to a file with 80 byte fixed length ASCII
records. The maximum number of records the file can contain is 204,800.
For binary file transfers:
REC=-256,,F,BINARY;DISC=204800 |
which translates to a file with fixed length binary records,
with a maximum record size of 256 bytes. The maximum number of records
the file can contain is 204,800.
For bytestream file transfers:
which translates to a file with byte length records, with
a maximum record size of 1 byte. The default number of records is
16,384,000.
Build Command Parameters |
 |
An MPE/iX FTP user can change how a file is copied from a
remote system to MPE/iX by using the MPE/iX BUILD
command parameters with the GET command using
the following syntax:
ftp> GET remotefile localfile;buildparms |
For a remote user (accessing the MPE/iX FTP server), you can
save a file on MPE/iX using the following syntax with the PUT
command:
ftp> PUT localfile remotefile;buildparms |
The supported BUILD command parameters
are:
:REC=[-rcsizebytes][,blkfactor[,[{F}][,{BINARY}]]]]
{V} {ASCII}
{B}
[;DEV=device]
[;CODE=filecode]
[;DISC=[numrec][,[numextents][,[initialloc]]]] |
- REC=-recsizeinbytes
A negative value indicates record size in bytes.
A positive integer value indicates record size in words (two bytes
per word). If DEV= is not specified,
the default record size is 128 words.
- blkfactor
The default blkfactor
size is one. When creating variable length files, include the 1
in the parameter string to maintain the record size specified in
the parameter REC=.
- F, V, B
Indicates fixed (F),
variable (V), byte (B),
length records. The default is fixed (F).
- BINARY ASCII
Indicates the type of records the file contains:
BINARY for binary coded records
or ASCII for ASCII
coded records. BINARY is the default.
- DEV=device
Specifies where the file will be stored. The default
is to a disk file.
- CODE=filecode
A code indicating a specially formatted file. Example:
CODE=PROG. Default is none.
- DISC=numrec
The value that affects file transfer success is
numrec. This value sets the maximum
number of records the file can contain. Must be large enough for
the target file or the file transfer will fail. The default is 1,023
records.
When you specify BUILD parameters
in an FTP transfer, you do not have to specify the MPE/iX file type
standard (STD) since it is the default. Note that STD is the only
supported MPE/iX file type.
For more information about BUILD
parameters, use MPE/iX online help (HELP BUILD PARMS),
or see the MPE/iX Commands Reference Manual.
Examples Using BUILD Parameters |
|
The first example shows an MPE/iX user transferring a file
from the remote system to an MPE/iX system using only the CODE=PROG
parameter:
ftp> GET filex file2;CODE=PROG |
The file is created with the BUILD command
defaults: fixed binary, 128 word records, with a maximum number
of records equal to 1,023.
The second example shows an MPE/iX user transferring a group
of binary files from the remote system to an MPE/iX system:
FTP> BINARY
200 Type set to l.
ftp> MGET P* ;CODE=PROG |
All files in the set beginning with letter "P"
are created with the following attributes: file code label PROG,
fixed binary, 128 word records, and a maximum number of records
equal to 1,023. The blank space preceding the semicolon is required.
The third example shows a remote user transferring a file
from their system to an MPE/iX system using BUILD
parameters as follows:
ftp> PUT myfile MPEFILE;Rec=-256,1,F,BINARY;DISC=11000;CODE=PROG |
An MPE/iX fixed binary file named MPEFILE
is created with records of 256 bytes, with a maximum record size
of 11,000. The file code label is PROG.
