BUILD

Creates and immediately allocates a new empty file on disk.

Syntax

   BUILD filereference

   [;REC=[recsize][,[blockfactor][,{F

                                 U

                                 V}][,{BINARY

                                       ASCII}]]]

   [{;CCTL  

     ;NOCCTL}][;TEMP]



   [;DEV=[ [dsdevice]#][device]]

   [;CODE=filecode]

   [;DISC=[numrec][,[numextents][,[initialloc]]]]

   [{;RIO

     ;NORIO}][{;MSG

               ;CIR

               ;STD

               ;KSAMXL

               ;SPOOL }]  [;ULABEL=numlabels]

   [;KEY={^filereference

          keyinfo} ] [;FIRSTREC=recnum] [{;REUSE

                                         ;NOREUSE}]

   [;langid={langid

             langname}]

Enhancements

filecode

The filecode parameter specifies a particular kind of file. This code is recorded in the file label and is available to processes accessing the file through the FFILEINFO or FGETINFO intrinsics. Although you can specify a positive integer ranging from 0 to 32767 or a mnemonic name for filecode, certain reserved integers and mnemonics have particular system-defined meanings. The native mode spooler file codes are the following:

Integer	Mnemonic	Meaning
1515	INSP	input spool file
1516	OUTSP	output spool file
1517	CHKSP	output spool file checkpoint file

SPOOL

SPOOL specifies an output spool file that is not linked to the spool file directory (SPFDIR) and, therefore, is not printed automatically. No spooling attributes are initialized.

If the output spool file is ever linked to the SPFDIR by using the SPOOLF ...;PRINT command, all attributes are set at that time according to the rules of the command. Spool Files cannot be temporary files. If you specify the ;SPOOL keyword, a file code of 1516 (output spool file) is forced.

BUILD

Technical documentation

» Table of Contents

» Glossary

» Index

Syntax

Enhancements