HP 3000 Manuals HP 3000 Manuals
Using BUILD Parameters with FTP
MPE XL BUILD command parameters can be used to modify the default file
building parameters for files transferred to an MPE XL system.
When no BUILD command parameters are specified with the target MPE XL
file designation, the MPE XL FTP server builds the file with the
following defaults depending on the transfer mode used:
For ASCII file transfers:
REC=-80,,F,ASCII;DISC=104800
which translates to a file with 80 byte fixed length ASCII records. The
maximum number of records the file can contain is 104,800.
For binary file transfers:
REC=-252,,V,BINARY;DISC=104800
which translates to a file with variable length binary records, with a
maximum record size of 252 bytes. The maximum number of records the file
can contain is 104,800.
Build Command Parameters
An MPE XL FTP user can change how a file is copied from a remote system
to MPE XL by using the MPE XL BUILD command parameters with the GET
command using the following syntax:
ftp> GET remotefile localfile;buildparms
For a remote user (accessing the MPE XL FTP server), you can save a file
on MPE XL using the following syntax with the PUT command:
ftp> PUT localfile remotefile;buildparms
Syntax
The supported BUILD command parameters are:
______________________________________________________________
| |
| ;REC=[-recsizebytes][,blkfactor[,[{F}][,{BINARY}] ] ] ]|
| {V} {ASCII} |
| [;DEV= device] |
| [;CODE= filecode] |
| [;DISC=[ numrec][,[ numextents][,[ initialloc] ] ] ] |
______________________________________________________________
Parameters
Description
REC=- A negative value indicates record size in bytes. A
recsizeinbytes 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 Indicates fixed (F) or variable (V) 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 disc 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 XL file type standard (STD) since it is the default.
Note that STD is the only supported MPE XL file type.
For more information about BUILD parameters, use MPE XL on-line help (
HELP BUILD PARMS ), or see the MPE XL Commands Reference Manual.
Examples Using BUILD Parameters
The first example shows an MPE XL user transferring a file from the
remote system to an MPE XL 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 XL user transferring a group of binary
files from the remote system to an MPE XL system:
ftp> BINARY
200 Type set to I.
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 XL system using BUILD parameters as follows:
ftp> PUT myfile MPEFILE;rec=-252;DISC=11000;CODE=PROG
An MPE XL fixed binary file named MPEFILE is created with records of 252
bytes, with a maximum record size of 11,000. The file code label is PROG
.