See Large file support in the Integrated file system topic in the Information Center for the current file system limit of the integrated file system. For files in the integrated file system that are larger than 2 GB, you need to allow your application programs access to 64-bit C runtime functions. You can use the following methods to allow your program access:
- Specify SYSIFCOPT[*IFS64IO] on a compilation command, which causes the native C compiler to define _IFS64_IO_. This causes the macros _LARGE_FILES and _LARGE_FILE_API to be defined.
- Define the macro _LARGE_FILES, either in the program source or by specifying DEFINE['_LARGE_FILES'] on a compilation command. The existing C runtime functions and the relevant data types in the code will all be automatically mapped or redefined to their 64-bit versions.
- Define the macro _LARGE_FILE_API, either in the program source or by specifying DEFINE['_LARGE_FILE_API'] on a compilation command. This makes visible the set of of new 64-bit C runtime functions and data types. The application must explicitly specify the name of the C runtime functions, both existing version and 64-bit version, to use.
The 64-bit C runtime functions include the following:
/* Create a file that is tagged with CCSID 37 */
if [[fp = fopen["/MYFILE" , "w, o_ccsid=37"]] == NULL] {
printf["Failed to open file with o_ccsid=37\n"];
}
fclose[fp];
/* Now reopen the file with CCSID 13488, because your application
wants to deal with the data in UNICODE */
if [[fp = fopen["/MYFILE" , "r+, o_ccsid=13488"]] == NULL] {
printf["Failed to open file with o_ccsid=13488\n"];
}
/* Turn buffering off because read functions do not work when
buffering is on */
if [setbuf[fp, NULL, _IONBF, 0] != 0]{
printf["Unable to turn buffering off\n"];
}
/* Because you opened with o_ccsid = 13488, you must provide
all input data as unicode.
If this program is compiled with LOCALETYPE[*LOCALEUCS2],
L constrants will be unicode. */
funcreturn = fputws[L"ABC", fp]; /* Write a unicode ABC to the file. */
if [funcreturn < 0] {
printf["Error with 'fputws' on line %d\n", __LINE__];
}
/* Because the file was tagged with CCSID 37, the unicode ABC was
converted to EBCDIC ABC when it was written to the file. *//* Create a file that is tagged with CCSID 37 */
if [[fp = fopen["/MYFILE" , "w, o_ccsid=37"]] == NULL] {
printf["Failed to open file with o_ccsid=37\n"];
}
fclose[fp];
/* Now reopen the file with CCSID 13488, because your application
wants to deal with the data in UNICODE */
if [[fp = fopen["/MYFILE" , "r+, o_ccsid=13488"]] == NULL] {
printf["Failed to open file with o_ccsid=13488\n"];
}
/* Turn buffering off because read functions do not work when
buffering is on */
if [setbuf[fp, NULL, _IONBF, 0] != 0]{
printf["Unable to turn buffering off\n"];
}
/* Because you opened with o_ccsid = 13488, you must provide
all input data as unicode.
If this program is compiled with LOCALETYPE[*LOCALEUCS2],
L constrants will be unicode. */
funcreturn = fputws[L"ABC", fp]; /* Write a unicode ABC to the file. */
if [funcreturn < 0] {
printf["Error with 'fputws' on line %d\n", __LINE__];
}
/* Because the file was tagged with CCSID 37, the unicode ABC was
converted to EBCDIC ABC when it was written to the file. *//* Create a file that is tagged with CCSID 37 */
if [[fp = fopen["/MYFILE" , "w, o_ccsid=37"]] == NULL] {
printf["Failed to open file with o_ccsid=37\n"];
}
fclose[fp];
/* Now reopen the file with CCSID 13488, because your application
wants to deal with the data in UNICODE */
if [[fp = fopen["/MYFILE" , "r+, o_ccsid=13488"]] == NULL] {
printf["Failed to open file with o_ccsid=13488\n"];
}
/* Turn buffering off because read functions do not work when
buffering is on */
if [setbuf[fp, NULL, _IONBF, 0] != 0]{
printf["Unable to turn buffering off\n"];
}
/* Because you opened with o_ccsid = 13488, you must provide
all input data as unicode.
If this program is compiled with LOCALETYPE[*LOCALEUCS2],
L constrants will be unicode. */
funcreturn = fputws[L"ABC", fp]; /* Write a unicode ABC to the file. */
if [funcreturn < 0] {
printf["Error with 'fputws' on line %d\n", __LINE__];
}
/* Because the file was tagged with CCSID 37, the unicode ABC was
converted to EBCDIC ABC when it was written to the file. *//* Create a file that is tagged with CCSID 37 */
if [[fp = fopen["/MYFILE" , "w, o_ccsid=37"]] == NULL] {
printf["Failed to open file with o_ccsid=37\n"];
}
fclose[fp];
/* Now reopen the file with CCSID 13488, because your application
wants to deal with the data in UNICODE */
if [[fp = fopen["/MYFILE" , "r+, o_ccsid=13488"]] == NULL] {
printf["Failed to open file with o_ccsid=13488\n"];
}
/* Turn buffering off because read functions do not work when
buffering is on */
if [setbuf[fp, NULL, _IONBF, 0] != 0]{
printf["Unable to turn buffering off\n"];
}
/* Because you opened with o_ccsid = 13488, you must provide
all input data as unicode.
If this program is compiled with LOCALETYPE[*LOCALEUCS2],
L constrants will be unicode. */
funcreturn = fputws[L"ABC", fp]; /* Write a unicode ABC to the file. */
if [funcreturn < 0] {
printf["Error with 'fputws' on line %d\n", __LINE__];
}
/* Because the file was tagged with CCSID 37, the unicode ABC was
converted to EBCDIC ABC when it was written to the file. *//* Create a file that is tagged with CCSID 37 */
if [[fp = fopen["/MYFILE" , "w, o_ccsid=37"]] == NULL] {
printf["Failed to open file with o_ccsid=37\n"];
}
fclose[fp];
/* Now reopen the file with CCSID 13488, because your application
wants to deal with the data in UNICODE */
if [[fp = fopen["/MYFILE" , "r+, o_ccsid=13488"]] == NULL] {
printf["Failed to open file with o_ccsid=13488\n"];
}
/* Turn buffering off because read functions do not work when
buffering is on */
if [setbuf[fp, NULL, _IONBF, 0] != 0]{
printf["Unable to turn buffering off\n"];
}
/* Because you opened with o_ccsid = 13488, you must provide
all input data as unicode.
If this program is compiled with LOCALETYPE[*LOCALEUCS2],
L constrants will be unicode. */
funcreturn = fputws[L"ABC", fp]; /* Write a unicode ABC to the file. */
if [funcreturn < 0] {
printf["Error with 'fputws' on line %d\n", __LINE__];
}
/* Because the file was tagged with CCSID 37, the unicode ABC was
converted to EBCDIC ABC when it was written to the file. *//* Create a file that is tagged with CCSID 37 */
if [[fp = fopen["/MYFILE" , "w, o_ccsid=37"]] == NULL] {
printf["Failed to open file with o_ccsid=37\n"];
}
fclose[fp];
/* Now reopen the file with CCSID 13488, because your application
wants to deal with the data in UNICODE */
if [[fp = fopen["/MYFILE" , "r+, o_ccsid=13488"]] == NULL] {
printf["Failed to open file with o_ccsid=13488\n"];
}
/* Turn buffering off because read functions do not work when
buffering is on */
if [setbuf[fp, NULL, _IONBF, 0] != 0]{
printf["Unable to turn buffering off\n"];
}
/* Because you opened with o_ccsid = 13488, you must provide
all input data as unicode.
If this program is compiled with LOCALETYPE[*LOCALEUCS2],
L constrants will be unicode. */
funcreturn = fputws[L"ABC", fp]; /* Write a unicode ABC to the file. */
if [funcreturn < 0] {
printf["Error with 'fputws' on line %d\n", __LINE__];
}
/* Because the file was tagged with CCSID 37, the unicode ABC was
converted to EBCDIC ABC when it was written to the file. *//* Create a file that is tagged with CCSID 37 */
if [[fp = fopen["/MYFILE" , "w, o_ccsid=37"]] == NULL] {
printf["Failed to open file with o_ccsid=37\n"];
}
fclose[fp];
/* Now reopen the file with CCSID 13488, because your application
wants to deal with the data in UNICODE */
if [[fp = fopen["/MYFILE" , "r+, o_ccsid=13488"]] == NULL] {
printf["Failed to open file with o_ccsid=13488\n"];
}
/* Turn buffering off because read functions do not work when
buffering is on */
if [setbuf[fp, NULL, _IONBF, 0] != 0]{
printf["Unable to turn buffering off\n"];
}
/* Because you opened with o_ccsid = 13488, you must provide
all input data as unicode.
If this program is compiled with LOCALETYPE[*LOCALEUCS2],
L constrants will be unicode. */
funcreturn = fputws[L"ABC", fp]; /* Write a unicode ABC to the file. */
if [funcreturn < 0] {
printf["Error with 'fputws' on line %d\n", __LINE__];
}
/* Because the file was tagged with CCSID 37, the unicode ABC was
converted to EBCDIC ABC when it was written to the file. */#include
#define MAX_LEN 60
int main[void]
{
FILE *stream;
fpos_t pos;
char line1[MAX_LEN];
char line2[MAX_LEN];
char *result;
char ch;
int num;
/* The following call opens a text file for reading. */
if [[stream = fopen["mylib/myfile", "r"]] == NULL]
printf["Could not open data file\n"];
else if [[result = fgets[line1,MAX_LEN,stream]] != NULL]
{
printf["The string read from myfile: %s\n", result];
fclose[stream];
}
/* The following call opens a fixed record length file */
/* for reading and writing. */
if [[stream = fopen["mylib/myfile2", "rb+, lrecl=80, \
blksize=240, recfm=f"]] == NULL]
printf["Could not open data file\n"];
else {
fgetpos[stream, &pos];
if [!fread[line2,sizeof[line2],1,stream]]
perror["fread error"];
else printf["1st record read from myfile2: %s\n", line2];
fsetpos[stream, &pos]; /* Reset pointer to start of file */
fputs[result, stream]; /* The line read from myfile is */
/* written to myfile2. */
fclose[stream];
}
}#include
#define MAX_LEN 60
int main[void]
{
FILE *stream;
fpos_t pos;
char line1[MAX_LEN];
char line2[MAX_LEN];
char *result;
char ch;
int num;
/* The following call opens a text file for reading. */
if [[stream = fopen["mylib/myfile", "r"]] == NULL]
printf["Could not open data file\n"];
else if [[result = fgets[line1,MAX_LEN,stream]] != NULL]
{
printf["The string read from myfile: %s\n", result];
fclose[stream];
}
/* The following call opens a fixed record length file */
/* for reading and writing. */
if [[stream = fopen["mylib/myfile2", "rb+, lrecl=80, \
blksize=240, recfm=f"]] == NULL]
printf["Could not open data file\n"];
else {
fgetpos[stream, &pos];
if [!fread[line2,sizeof[line2],1,stream]]
perror["fread error"];
else printf["1st record read from myfile2: %s\n", line2];
fsetpos[stream, &pos]; /* Reset pointer to start of file */
fputs[result, stream]; /* The line read from myfile is */
/* written to myfile2. */
fclose[stream];
}
}#include
#define MAX_LEN 60
int main[void]
{
FILE *stream;
fpos_t pos;
char line1[MAX_LEN];
char line2[MAX_LEN];
char *result;
char ch;
int num;
/* The following call opens a text file for reading. */
if [[stream = fopen["mylib/myfile", "r"]] == NULL]
printf["Could not open data file\n"];
else if [[result = fgets[line1,MAX_LEN,stream]] != NULL]
{
printf["The string read from myfile: %s\n", result];
fclose[stream];
}
/* The following call opens a fixed record length file */
/* for reading and writing. */
if [[stream = fopen["mylib/myfile2", "rb+, lrecl=80, \
blksize=240, recfm=f"]] == NULL]
printf["Could not open data file\n"];
else {
fgetpos[stream, &pos];
if [!fread[line2,sizeof[line2],1,stream]]
perror["fread error"];
else printf["1st record read from myfile2: %s\n", line2];
fsetpos[stream, &pos]; /* Reset pointer to start of file */
fputs[result, stream]; /* The line read from myfile is */
/* written to myfile2. */
fclose[stream];
}
}Binary files contain a series of characters. For binary files, the system does not translate control characters on input or output.
If a binary file does not exist, you can create one using the following command:
#include
#define MAX_LEN 60
int main[void]
{
FILE *stream;
fpos_t pos;
char line1[MAX_LEN];
char line2[MAX_LEN];
char *result;
char ch;
int num;
/* The following call opens a text file for reading. */
if [[stream = fopen["mylib/myfile", "r"]] == NULL]
printf["Could not open data file\n"];
else if [[result = fgets[line1,MAX_LEN,stream]] != NULL]
{
printf["The string read from myfile: %s\n", result];
fclose[stream];
}
/* The following call opens a fixed record length file */
/* for reading and writing. */
if [[stream = fopen["mylib/myfile2", "rb+, lrecl=80, \
blksize=240, recfm=f"]] == NULL]
printf["Could not open data file\n"];
else {
fgetpos[stream, &pos];
if [!fread[line2,sizeof[line2],1,stream]]
perror["fread error"];
else printf["1st record read from myfile2: %s\n", line2];
fsetpos[stream, &pos]; /* Reset pointer to start of file */
fputs[result, stream]; /* The line read from myfile is */
/* written to myfile2. */
fclose[stream];
}
}When you open a file with a, a+, ab, a+b or ab+ mode, all write operations take place at the end of the file. Although you can reposition the file pointer using the
#include
#define MAX_LEN 60
int main[void]
{
FILE *stream;
fpos_t pos;
char line1[MAX_LEN];
char line2[MAX_LEN];
char *result;
char ch;
int num;
/* The following call opens a text file for reading. */
if [[stream = fopen["mylib/myfile", "r"]] == NULL]
printf["Could not open data file\n"];
else if [[result = fgets[line1,MAX_LEN,stream]] != NULL]
{
printf["The string read from myfile: %s\n", result];
fclose[stream];
}
/* The following call opens a fixed record length file */
/* for reading and writing. */
if [[stream = fopen["mylib/myfile2", "rb+, lrecl=80, \
blksize=240, recfm=f"]] == NULL]
printf["Could not open data file\n"];
else {
fgetpos[stream, &pos];
if [!fread[line2,sizeof[line2],1,stream]]
perror["fread error"];
else printf["1st record read from myfile2: %s\n", line2];
fsetpos[stream, &pos]; /* Reset pointer to start of file */
fputs[result, stream]; /* The line read from myfile is */
/* written to myfile2. */
fclose[stream];
}
}#include
#define MAX_LEN 60
int main[void]
{
FILE *stream;
fpos_t pos;
char line1[MAX_LEN];
char line2[MAX_LEN];
char *result;
char ch;
int num;
/* The following call opens a text file for reading. */
if [[stream = fopen["mylib/myfile", "r"]] == NULL]
printf["Could not open data file\n"];
else if [[result = fgets[line1,MAX_LEN,stream]] != NULL]
{
printf["The string read from myfile: %s\n", result];
fclose[stream];
}
/* The following call opens a fixed record length file */
/* for reading and writing. */
if [[stream = fopen["mylib/myfile2", "rb+, lrecl=80, \
blksize=240, recfm=f"]] == NULL]
printf["Could not open data file\n"];
else {
fgetpos[stream, &pos];
if [!fread[line2,sizeof[line2],1,stream]]
perror["fread error"];
else printf["1st record read from myfile2: %s\n", line2];
fsetpos[stream, &pos]; /* Reset pointer to start of file */
fputs[result, stream]; /* The line read from myfile is */
/* written to myfile2. */
fclose[stream];
}
}When you specify the update mode [using + in the second or third position], you can both read from and write to the file. However, when switching between reading and writing, you must include an intervening positioning function such as the
#include
#define MAX_LEN 60
int main[void]
{
FILE *stream;
fpos_t pos;
char line1[MAX_LEN];
char line2[MAX_LEN];
char *result;
char ch;
int num;
/* The following call opens a text file for reading. */
if [[stream = fopen["mylib/myfile", "r"]] == NULL]
printf["Could not open data file\n"];
else if [[result = fgets[line1,MAX_LEN,stream]] != NULL]
{
printf["The string read from myfile: %s\n", result];
fclose[stream];
}
/* The following call opens a fixed record length file */
/* for reading and writing. */
if [[stream = fopen["mylib/myfile2", "rb+, lrecl=80, \
blksize=240, recfm=f"]] == NULL]
printf["Could not open data file\n"];
else {
fgetpos[stream, &pos];
if [!fread[line2,sizeof[line2],1,stream]]
perror["fread error"];
else printf["1st record read from myfile2: %s\n", line2];
fsetpos[stream, &pos]; /* Reset pointer to start of file */
fputs[result, stream]; /* The line read from myfile is */
/* written to myfile2. */
fclose[stream];
}
}#include
#define MAX_LEN 60
int main[void]
{
FILE *stream;
fpos_t pos;
char line1[MAX_LEN];
char line2[MAX_LEN];
char *result;
char ch;
int num;
/* The following call opens a text file for reading. */
if [[stream = fopen["mylib/myfile", "r"]] == NULL]
printf["Could not open data file\n"];
else if [[result = fgets[line1,MAX_LEN,stream]] != NULL]
{
printf["The string read from myfile: %s\n", result];
fclose[stream];
}
/* The following call opens a fixed record length file */
/* for reading and writing. */
if [[stream = fopen["mylib/myfile2", "rb+, lrecl=80, \
blksize=240, recfm=f"]] == NULL]
printf["Could not open data file\n"];
else {
fgetpos[stream, &pos];
if [!fread[line2,sizeof[line2],1,stream]]
perror["fread error"];
else printf["1st record read from myfile2: %s\n", line2];
fsetpos[stream, &pos]; /* Reset pointer to start of file */
fputs[result, stream]; /* The line read from myfile is */
/* written to myfile2. */
fclose[stream];
}
}#include
#define MAX_LEN 60
int main[void]
{
FILE *stream;
fpos_t pos;
char line1[MAX_LEN];
char line2[MAX_LEN];
char *result;
char ch;
int num;
/* The following call opens a text file for reading. */
if [[stream = fopen["mylib/myfile", "r"]] == NULL]
printf["Could not open data file\n"];
else if [[result = fgets[line1,MAX_LEN,stream]] != NULL]
{
printf["The string read from myfile: %s\n", result];
fclose[stream];
}
/* The following call opens a fixed record length file */
/* for reading and writing. */
if [[stream = fopen["mylib/myfile2", "rb+, lrecl=80, \
blksize=240, recfm=f"]] == NULL]
printf["Could not open data file\n"];
else {
fgetpos[stream, &pos];
if [!fread[line2,sizeof[line2],1,stream]]
perror["fread error"];
else printf["1st record read from myfile2: %s\n", line2];
fsetpos[stream, &pos]; /* Reset pointer to start of file */
fputs[result, stream]; /* The line read from myfile is */
/* written to myfile2. */
fclose[stream];
}
}#include
#define MAX_LEN 60
int main[void]
{
FILE *stream;
fpos_t pos;
char line1[MAX_LEN];
char line2[MAX_LEN];
char *result;
char ch;
int num;
/* The following call opens a text file for reading. */
if [[stream = fopen["mylib/myfile", "r"]] == NULL]
printf["Could not open data file\n"];
else if [[result = fgets[line1,MAX_LEN,stream]] != NULL]
{
printf["The string read from myfile: %s\n", result];
fclose[stream];
}
/* The following call opens a fixed record length file */
/* for reading and writing. */
if [[stream = fopen["mylib/myfile2", "rb+, lrecl=80, \
blksize=240, recfm=f"]] == NULL]
printf["Could not open data file\n"];
else {
fgetpos[stream, &pos];
if [!fread[line2,sizeof[line2],1,stream]]
perror["fread error"];
else printf["1st record read from myfile2: %s\n", line2];
fsetpos[stream, &pos]; /* Reset pointer to start of file */
fputs[result, stream]; /* The line read from myfile is */
/* written to myfile2. */
fclose[stream];
}
}Keyword parameters for non-Integrated File System
blksize=valueSpecifies the maximum length, in bytes, of a physical block of records.lrecl=valueSpecifies the length, in bytes, for fixed-length records and the maximum length for variable-length records.recfm=valuevalue can be:Ffixed-length, deblocked recordsFBfixed-length, blocked recordsVvariable-length, deblocked recordsVBvariable-length, blocked recordsVBSvariable-length, blocked, spanned records for tape filesVSvariable-length, deblocked, spanned records for tape filesDvariable-length, deblocked, unspanned records for ASCII D format for tape filesDBvariable-length, blocked, unspanned records for ASCII D format for tape filesUundefined format for tape filesFAfixed-length that uses first character forms control data for printer files
Note: If the file is created using CTLCHAR[*FCFC], the first character form control will be used. If it is created using CTLCHAR[*NONE], the first character form control will not be used.
commit=valuevalue can be:N This parameter identifies that this file is not opened under commitment control. This is the default.
Y This parameter identifies that this file is opened under commitment control.
ccsid=valueIf a CCSID that is not supported by the operating system is specified, it is ignored by data management.When LOCALETYPE[*LOCALEUTF] is specified on the compilation command, the default value is the LC_CTYPE CCSID value, which is determined by your current locale setting. See setlocale[] — Set Locale for further information about locale settings. When LOCALETYPE[*LOCALEUTF] is not specified on the compilation command, the default value is the job CCSID value. See File CCSID for further information about file CCSID values.
arrseq=valuevalue can be:N This parameter identifies that this file is processed in the way it was created. This is the default.
Y This parameter identifies that this file is processed in arrival sequence.
indicators=valuevalue can be:N This parameter identifies that indicators in display, ICF, or printer files are stored in the file buffer. This is the default.
Y This parameter identifies that indicators in display, ICF, or printer files are stored in a separate indicator area, not in the file buffer. A file buffer is the area the system uses to transfer data to and from the user program and the operating system when writing and reading. You must store indicators in a separate indicator area when processing ICF files.
type=valuevalue can be:memory This parameter identifies this file as a memory file that is available only from C programs. This is the default.
record This parameter specifies that the file is to be opened for sequential record I/O. The file must be opened as a binary file; otherwise, the fopen[] function fails. Read and write operations are done with the fopen[]1 function and the fopen[]2 functions.
Keyword parameters for Integrated File System only
type=valuevalue can be:
record The file is opened for sequential record I/O. [File has to be opened as binary stream.]
ccsid=valueccsid is converted to a code page value. The default is to use the job CCSID value as the code page. The CCSID and codepage option cannot both be specified. The CCSID option provides compatibility with the operating system and Data management based stream I/O.
Note: Mixed data [the data contains both single and double-byte characters] is not supported for a file data processing mode of text. Mixed data is supported for a file processing mode of binary.
If you specify the ccsid keyword, you cannot specify the o_ccsid keyword or the codepage keyword.
Because of the possible expansion or contraction of converted data, making assumptions about data size and the current file offset is dangerous. For example, a file might have a physical size of 100 bytes, but after an application has read 100 bytes from the file, the current file offset might be only 50. In order to read the whole file, the application might have to read 200 bytes or more, depending on the CCSIDs involved. Therefore, file positioning functions, such as fopen[]3,
#include
#define MAX_LEN 60
int main[void]
{
FILE *stream;
fpos_t pos;
char line1[MAX_LEN];
char line2[MAX_LEN];
char *result;
char ch;
int num;
/* The following call opens a text file for reading. */
if [[stream = fopen["mylib/myfile", "r"]] == NULL]
printf["Could not open data file\n"];
else if [[result = fgets[line1,MAX_LEN,stream]] != NULL]
{
printf["The string read from myfile: %s\n", result];
fclose[stream];
}
/* The following call opens a fixed record length file */
/* for reading and writing. */
if [[stream = fopen["mylib/myfile2", "rb+, lrecl=80, \
blksize=240, recfm=f"]] == NULL]
printf["Could not open data file\n"];
else {
fgetpos[stream, &pos];
if [!fread[line2,sizeof[line2],1,stream]]
perror["fread error"];
else printf["1st record read from myfile2: %s\n", line2];
fsetpos[stream, &pos]; /* Reset pointer to start of file */
fputs[result, stream]; /* The line read from myfile is */
/* written to myfile2. */
fclose[stream];
}
}fopen[]5, and #include
#define MAX_LEN 60
int main[void]
{
FILE *stream;
fpos_t pos;
char line1[MAX_LEN];
char line2[MAX_LEN];
char *result;
char ch;
int num;
/* The following call opens a text file for reading. */
if [[stream = fopen["mylib/myfile", "r"]] == NULL]
printf["Could not open data file\n"];
else if [[result = fgets[line1,MAX_LEN,stream]] != NULL]
{
printf["The string read from myfile: %s\n", result];
fclose[stream];
}
/* The following call opens a fixed record length file */
/* for reading and writing. */
if [[stream = fopen["mylib/myfile2", "rb+, lrecl=80, \
blksize=240, recfm=f"]] == NULL]
printf["Could not open data file\n"];
else {
fgetpos[stream, &pos];
if [!fread[line2,sizeof[line2],1,stream]]
perror["fread error"];
else printf["1st record read from myfile2: %s\n", line2];
fsetpos[stream, &pos]; /* Reset pointer to start of file */
fputs[result, stream]; /* The line read from myfile is */
/* written to myfile2. */
fclose[stream];
}
}The fopen[] function might fail with the ECONVERT error when all of the following three conditions occur:
- The file data processing mode is text.
- The code page is not specified.
- The CCSID of the job is 'mixed-data' [the data contains both single-byte and double-byte characters].
When LOCALETYPE[*LOCALEUTF] is specified on the compilation command, the default value is the LC_CTYPE CCSID value, which is determined by your current locale setting. See setlocale[] — Set Locale for further information about locale settings. When LOCALETYPE[*LOCALEUTF] is not specified on the compilation command, the default value is the job CCSID value. See File CCSID for further information about file CCSID values.
This parameter is similar to the ccsid parameter, except that the value specified is not converted to a code page. Also, mixed data is supported. If the file is created, it is tagged with the specified CCSID. If the file already exists, data will be converted from the CCSID of the file to the specified CCSID on read operations. On write operations, the data is assumed to be in the specified CCSID, and is converted to the CCSID of the file.
Because of the possible expansion or contraction of converted data, making assumptions about data size and the current file offset is dangerous. For example, a file might have a physical size of 100 bytes, but after an application has read 100 bytes from the file, the current file offset might be only 50. In order to read the whole file, the application might have to read 200 bytes or more, depending on the CCSIDs involved. Therefore, file positioning functions such as fopen[]3,
#include
#define MAX_LEN 60
int main[void]
{
FILE *stream;
fpos_t pos;
char line1[MAX_LEN];
char line2[MAX_LEN];
char *result;
char ch;
int num;
/* The following call opens a text file for reading. */
if [[stream = fopen["mylib/myfile", "r"]] == NULL]
printf["Could not open data file\n"];
else if [[result = fgets[line1,MAX_LEN,stream]] != NULL]
{
printf["The string read from myfile: %s\n", result];
fclose[stream];
}
/* The following call opens a fixed record length file */
/* for reading and writing. */
if [[stream = fopen["mylib/myfile2", "rb+, lrecl=80, \
blksize=240, recfm=f"]] == NULL]
printf["Could not open data file\n"];
else {
fgetpos[stream, &pos];
if [!fread[line2,sizeof[line2],1,stream]]
perror["fread error"];
else printf["1st record read from myfile2: %s\n", line2];
fsetpos[stream, &pos]; /* Reset pointer to start of file */
fputs[result, stream]; /* The line read from myfile is */
/* written to myfile2. */
fclose[stream];
}
}fopen[]5, and #include
#define MAX_LEN 60
int main[void]
{
FILE *stream;
fpos_t pos;
char line1[MAX_LEN];
char line2[MAX_LEN];
char *result;
char ch;
int num;
/* The following call opens a text file for reading. */
if [[stream = fopen["mylib/myfile", "r"]] == NULL]
printf["Could not open data file\n"];
else if [[result = fgets[line1,MAX_LEN,stream]] != NULL]
{
printf["The string read from myfile: %s\n", result];
fclose[stream];
}
/* The following call opens a fixed record length file */
/* for reading and writing. */
if [[stream = fopen["mylib/myfile2", "rb+, lrecl=80, \
blksize=240, recfm=f"]] == NULL]
printf["Could not open data file\n"];
else {
fgetpos[stream, &pos];
if [!fread[line2,sizeof[line2],1,stream]]
perror["fread error"];
else printf["1st record read from myfile2: %s\n", line2];
fsetpos[stream, &pos]; /* Reset pointer to start of file */
fputs[result, stream]; /* The line read from myfile is */
/* written to myfile2. */
fclose[stream];
}
}Example that uses o_ccsid
/* Create a file that is tagged with CCSID 37 */
if [[fp = fopen["/MYFILE" , "w, o_ccsid=37"]] == NULL] {
printf["Failed to open file with o_ccsid=37\n"];
}
fclose[fp];
/* Now reopen the file with CCSID 13488, because your application
wants to deal with the data in UNICODE */
if [[fp = fopen["/MYFILE" , "r+, o_ccsid=13488"]] == NULL] {
printf["Failed to open file with o_ccsid=13488\n"];
}
/* Turn buffering off because read functions do not work when
buffering is on */
if [setbuf[fp, NULL, _IONBF, 0] != 0]{
printf["Unable to turn buffering off\n"];
}
/* Because you opened with o_ccsid = 13488, you must provide
all input data as unicode.
If this program is compiled with LOCALETYPE[*LOCALEUCS2],
L constrants will be unicode. */
funcreturn = fputws[L"ABC", fp]; /* Write a unicode ABC to the file. */
if [funcreturn < 0] {
printf["Error with 'fputws' on line %d\n", __LINE__];
}
/* Because the file was tagged with CCSID 37, the unicode ABC was
converted to EBCDIC ABC when it was written to the file. */If you specify the codepage keyword, you cannot specify the ccsid keyword or the o_ccsid keyword.
If the file to be opened does not exist, and the open mode specifies that the file should be created, the file is created and tagged with the calculated code page. If the file already exists, the data read from the file is converted from the file's code page to the calculated code page during the read operation. Data written to the file is assumed to be in the calculated code page and is converted to the code page of the file during the write operation.
Y The line terminator to be used is carriage return [CR], new line [NL] combination. When data is read, all carriage returns [CR] are stripped for string functions. When data is written to a file, carriage returns [CR] are added before each new line [NL] character. Line terminator processing only occurs when a file is open with text mode. This is the default.
N The line terminator to be used is new line [NL] only.
The keyword parameters are not case sensitive and should be separated by a comma.
The fopen[] function generally fails if parameters are mismatched.
Return Value
The fopen[] function returns a pointer to a FILE structure type that can be used to access the open file.
Note: To use stream files [type = record] with record I/O functions, you must cast the FILE pointer to an RFILE pointer.
A NULL pointer return value indicates an error.
The value of errno can be set to:ValueMeaningEBADMODEThe file mode that is specified is not valid.EBADNAMEThe file name that is specified is not valid.ECONEVRTConversion error.ENOENTNo file or library.ENOMEMStorage allocation request failed.ENOTOPENThe file is not open.EIOERRORA non-recoverable I/O error occurred.EIORECERRA recoverable I/O error occurred.ESCANFAILUREThe file was marked with a scan failure.
If the mode string passed to fopen[] is correct, but is invalid to that specific type of file, fopen[] will set errno to ENOTOPEN, EIOERROR, or EIORECERR, regardless of the file type.