MPE/iX Commands Reference Manual (32650-90877)

Chapter 3 99
Command List I
Commands ABORT to BYE
Operation Notes
This command builds a new file on disk. If it is an ASCII file, the initially allocated file
space is initialized to blanks. If it is a binary file, the file space is initialized to zeros.
Unless the TEMP parameter is specified, the file is saved in the permanent file domain. To
create a permanent file, you must have save file (SF) capability and SAVE access in the
group to which the new file belongs. You can only build a file belonging to your logon
account.
If specified, the DEV= parameter must be consistent with the group to which the new file
belongs. If the group's home volume set is not mounted, BUILD implicitly generates a
volume set reservation request. If the volume is not recognized by the system, the
command fails. Refer to Volume Management Reference Manual.
The default characteristics of a file created with the BUILD command are: fixed length
records of 128 words each, a blocking factor of 1, binary formatted, permanent file, a record
limit of 1023, and a maximum of 8 extents with 0 extent initially allocated. This is
equivalent to entering:
BUILD filename ;REC=128,1,F,BINARY;DEV=DISC;DISC=1023,8,
Use
This command may be issued from a session, a job, a program, or in break mode. Pressing
Break has no effect on this command.
Examples
The following example creates a permanent disk file named WORKFILE, which can reside on
any disk. WORKFILE has fixed length records of 80 bytes each. The records are blocked 3
records per block (which is the
blockfactor ), and are written in ASCII code. The file has a
maximum capacity of 2000 records divided into 10 extents with 2 extents initially
allocated.
BUILD WORKFILE;REC=-80,3,F,ASCII;DISC=2000,10,2
The following example uses the CODE= parameter to create a logging file called NEWDATA:
BUILD NEWDATA;DISC=3000,1,1;CODE=LOG
Related Information
Commands COPY, LISTFILE, LISTF, LISTFTEMP, PURGE, RENAME
Manuals MPE/iX Intrinsics Reference Manual
Native Mode Spooler Reference Manual
BYE
Ends an interactive session. (Native Mode)
Syntax
BYE