isCOBOL Evolve : Appendices : Library Routines : S$IO : S-MAKE-FUNCTION
S-MAKE-FUNCTION
This function creates a new sequential file. It overwrites any existing file of the same name unless they’re in use. If the file is in use, the function fails.
Syntax:
 SET S-MAKE-FUNCTION TO TRUE
 
 CALL "S$IO" USING SIO-FUNCTION
                  name
                 [lParms]
           GIVING returnCode
Parameters:
name
the name of the file to create.
lParms
a string that describes various logical characteristics of the file. The string consists of three numeric fields separated by commas:
• Maximum record size. This is the size in bytes of the largest record to be placed in the file. This can range from 1 to 67,108,864.
• File type. This must be a single byte containing a binary value that indicates the type of the file. You should use the same values as described in S-OPEN-FUNCTION.
• Block size. This is the size of a block of records.
 
This parameter is optional. If omitted, the values are not known to the runtime.
Return code:
returnCode can be any signed numeric data item and provides additional information:
>0
Operation successful.
0
Operation failed.