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.