gtpm2m1hMigration Guide: Program Update Tapes

File System Support (APAR PJ25089)

The following section discusses the migration considerations for file system support.

Prerequisite APARs

See the APEDIT for APAR PJ25089 for more information about prerequisite APARs.

Apply the following APARs after you apply file system support (APAR PJ25089):

See Appendix A, PUT 2-15 Interface Changes by Authorized Program Analysis Report (APAR) for more information about the interface changes for these APARs.

Functional Overview

The TPF 4.1 system now provides support for a file system. The key concepts of file system support are an application programming interface (API) and C run-time environment supporting main functions. Implementation of file system support eases porting of application programs by providing a standard and open interface.

The file access API contains all of the standard C library functions and part of the Portable Operating System Interface for Computer Environments (POSIX) standards, and reduces the complexity of TPF application programs suited to flat files by providing a flat-file data model as a simpler alternative to the TPF linked-record architecture.

Architecture

This section explains what a file system is, as well as providing functional summary and characteristics information.

What Is the File System?

The file system is a standard file access method that is ANSI Standard C compliant. File system support completes the TPF 4.1 system implementation of the ANSI compliant Standard C library that began with ISO-C support.

File system support implements most of the POSIX.1, sections 5 (Files and Directories), 6 (Input and Output Primitives), and 8.2 (C Language Input/Output Functions) standard. The file system also includes functions from the POSIX.1b (ftruncate and fsync) and from the POSIX.1a drafts (the fchown, lstat, readlink and symlink C functions).

Standard input, output, and error streams are also supported in the file system.

Functional Summary

File system support introduces the concepts of path names and directories (for example, /name/name) and provides the following:

However, file system support does not extend to TPF programs (executables) and can only be used by ISO-C programs.

Additional Characteristics

The file system is subsystem unique, processor shared, and subsystem user shared. Therefore, each subsystem has its own root and directory hierarchy.

In addition, the file system uses TPF collection support as a data store. The file data is contained in pool records. Each file requires a set of #INODE and #FLOCK fixed file records, which contain the file characteristics and the name of the current working directory. These records are allocated at system generation time and assigned when the file is created. File system support also uses TPF transaction services to ensure atomicity. See TPF Transaction Services (APAR PJ25094) for more information about TPF transaction services.

A file descriptor represents the file to the application program. A file descriptor is an unsigned integer that is first returned by the open or creat C functions and passed to the read, write, lseek, and close C functions. These file input/output (I/O) functions are building blocks for the C library file functions that deal with streams. File descriptors 0, 1, and 2 are initially reserved for the standard input, output, and error streams.

The ZOODB INIT command is used to initialize both the file system (including establishing the root directories) and TPF collection support (TPFCS). The ZFINT command can be used to add additional #INODE and #FLOCK fixed file record pairs to an already established file system. If you enter the ZOODB INIT command when some subsystems are not in NORM state, the ZFINT command is also used to initialize file system support in those subsystems.

Operating Environment Requirements and Planning Information

There are none.

Interface Changes

The following section summarizes interface changes.

C/C++ Language

The following section summarizes C/C++ language changes. This information is presented in alphabetic order by the type of C/C++ language information. See the TPF C/C++ Language Support User's Guide and TPF Application Programming for more information about the C/C++ language.

Build Scripts

Table 340 summarizes changes to the build scripts used by the build tool. This information is presented in alphabetic order by the name of the build script.

Table 340. Changes to Build Scripts for File System Support

Build Script Type New, Changed, or No Longer Supported? Description of Change
CBOTBS DLM New Added #INODE fixed file record and root directory initialization.
CFINBS DLM New Added ZFINT command support.
CFZFBS DLM New Added file system initialization.
CISOBS DLM Changed Added file system API support.
COMXBS DLM Changed Added file system functions.
CTALBS DLM Changed Added support for the tpf_movec library function.

Dynamic Load Module (DLM) Stubs

There are no changes.

General Use C/C++ Language Header Files

Table 341 summarizes the general use C/C++ language header file changes. This information is presented in alphabetic order by the name of the general use C/C++ language header file.

General use means these header files are available for your use.

Table 341. Changes to General Use C/C++ Language Header Files for File System Support

C/C++ Language Header File New, Changed, or No Longer Supported? Do You Need to Recompile Segments?
c$ddsm.h New Not Applicable
c$ddtb.h New Not Applicable
c$eb0eb.h Changed No
c$fer0.h Changed No
c$fsqu.h New Not Applicable
c$fva0.h Changed No
c$proc.h Changed No
c$spif.h New Not Applicable
c$uprs.h Changed No
dirent.h New Not Applicable
errno.h Changed No
limits.h Changed No
modes.h Changed No
socket.h Changed No
stat.h New Not Applicable
stdio.h Changed No
sysapi.h Changed No
unistd.h Changed No
utime.h New Not Applicable

Implementation-Specific C/C++ Language Header Files (IBM Use Only)

Table 342 summarizes the general use C/C++ language header file changes that are for IBM use only. This information is presented in alphabetic order by the name of the general use C/C++ language header file.

Table 342. Changes to Implementation-Specific C/C++ Language Header Files (IBM Use Only). for File System Support

C/C++ Language Header File (IBM Use Only) New, Changed, or No Longer Supported? Do You Need to Recompile Segments?
i$back.h New No
i$call.h New No
i$fdes.h New No
i$fsct.h New No
i$fsdd.h New No
i$fsqu.h Changed No
i$glue.h New No
i$gulp.h New No
i$link.h New No
i$make.h New No
i$node.h New No
i$opfd.h New No
i$path.h New No
i$psxl.h New No
i$tdat.h New No
i$tenv.h New No
i$tran.h New No
i$treq.h New No
i$tres.h New No
i$trth.h New No
i$zero.h New No

Library Interface Scripts

Table 343 summarizes changes to the library interface scripts used by the library interface tool and the build tool. This information is presented in alphabetic order by the name of the library interface script.

Table 343. Changes to Library Interface Scripts for File System Support

Library Interface Script New, Changed, or No Longer Supported? Description of Change
CISOXV Changed Added file system API functions.
COMXXV Changed Added file system library functions.
CTALXV Changed Added the tpf_movec library member.

Library Members (Object Files)

Table 344 summarizes the library member (object file) changes. This information is presented in alphabetic order by the name of the library member (object file).

Table 344. Changes to Library Members (Object Files) for File System Support

Library Member (Object File) Library Module Name New, Changed, or No Longer Supported? Type Description of Change
CASSRT CISO Changed C Language Changed the use of the puts C function to fputs.
CATOF CISO Changed Object-Only Internal changes.
CBCLSE CISO New Object-Only Added the fclose C function.
CBDFMT CISO Changed Object-Only Internal changes.
CBFLGS CISO New Object-Only Added the clearerr, feof, and ferror C functions.
CBFLSH CISO New Object-Only Added the fflush C function.
CBGETC CISO New Object-Only Added the fgetc, getc, and getchar C functions.
CBGETS CISO No Longer Supported Assembler Replaced by the CCGETS library member.
CBGPOS CISO New Object-Only Added the fgetpos and ftell C functions.
CBKFCB CISO Changed Object-Only Internal use.
CBOPEN CISO New Object-Only Added the fopen C function.
CBPERR CISO New Object-Only Added the perror C function.
CBPUTC CISO New Object-Only Added the fputc, putc, and putchar C functions.
CBPUTS CISO No Longer Supported Assembler Replaced by the CCPUTS library member.
CBREAD CISO New Object-Only Added the fread C function.
CBREOP CISO New Object-Only Added the freopen C function.
CBRPOS CISO New Object-Only Added the fseek, fsetpos, and rewind C functions.
CBSTBF CISO New Object-Only Added the setbuf and setvbuf C functions.
CBSTER CISO Changed C Language Added new errno messages.
CBUNGT CISO New Object-Only Added the ungetc C function.
CBWRIT CISO New Object-Only Added the fwrite C function.
CCGETS CISO New Object-Only Added the gets C function.
CCLOCP CISO Changed Object-Only Internal changes.
CCLOCS CISO Changed Object-Only Internal changes.
CCPRTF CISO New Object-Only Added the printf C function.
CCPUTS CISO New Object-Only Added the puts C function.
CCSCNF CISO New Object-Only Added the scanf C function.
CDDNUL COMX New C Language Added the null device driver.
CDDSOC COMX New C Language Added the socket device driver.
CDDTBL COMX New C Language Added a file system device driver table.
CDOECV CISO Changed Object-Only Internal changes.
CDOFCV CISO Changed Object-Only Internal changes.
CFPRTF CISO New Object-Only Added the fprintf C function.
CFSCNF CISO New Object-Only Added the fscanf C function.
CFSINT CISO Changed Object-Only Internal changes.
CFS001 COMX New C Language Added the access C function.
CFS002 COMX New C Language Added the chdir C function.
CFS003 COMX New C Language Added the chmod C function.
CFS004 COMX New C Language Added the chown C function.
CFS005 COMX New C Language Added the close C function.
CFS006 COMX New C Language Added the closedir C function.
CFS007 COMX New C Language Added the creat C function.
CFS008 COMX New C Language Added the dup C function.
CFS009 COMX New C Language Added the dup2 C function.
CFS010 COMX New C Language Added the fchmod C function.
CFS011 COMX New C Language Added the fchown C function.
CFS012 COMX New C Language Added the fcntl C function.
CFS013 COMX New C Language Added the fstat C function.
CFS014 COMX New C Language Added the fsync C function.
CFS015 COMX New C Language Added the ftruncate C function.
CFS016 COMX New C Language Added the getcwd C function.
CFS017 COMX New C Language Added the link C function.
CFS018 COMX New C Language Added the lseek C function.
CFS019 COMX New C Language Added the lstat C function.
CFS020 COMX New C Language Added the mkdir C function.
CFS021 COMX New C Language Added the mknod C function.
CFS022 COMX New C Language Added the open C function.
CFS023 COMX New C Language Added the opendir C function.
CFS024 COMX New C Language Added the read C function.
CFS025 COMX New C Language Added the readdir C function.
CFS026 COMX New C Language Added the readlink C function.
CFS027 COMX New C Language Added the remove C function.
CFS028 COMX New C Language Added the rename C function.
CFS029 COMX New C Language Added the rewinddir C function.
CFS030 COMX New C Language Added the rmdir C function.
CFS031 COMX New C Language Added the stat C function.
CFS032 COMX New C Language Added the symlink C function.
CFS033 COMX New C Language Added the tmpfile C function.
CFS034 COMX New C Language Added the tmpnam C function.
CFS035 COMX New C Language Added the umask C function.
CFS036 COMX New C Language Added the unlink C function.
CFS037 COMX New C Language Added the utime C function.
CFS038 COMX New C Language Added the write C function.
CFS102 COMX New C Language Added the internal FDUPFD function.
CFS103 COMX New C Language Added the internal FGETFD function.
CFS104 COMX New C Language Added the internal FGETFL function.
CFS106 COMX New C Language Added the internal FILENODE function.
CFS108 COMX New C Language Added the internal FINDNODE function.
CFS109 COMX New C Language Added the internla FREEFD function.
CFS111 COMX New C Language Added the internal FREENODE function.
CFS113 COMX New C Language Added the internal FSETFD function.
CFS114 COMX New C Language Added the internal FSETFL function.
CFS115 COMX New C Language Added the internal FUNLCK function.
CFS116 COMX New C Language Added the internal FWRLCK function.
CFS119 COMX New C Language Added the internal GETFS function.
CFS121 COMX New C Language Added the internal GETNODE function.
CFS123 COMX New C Language Added the internal IACCESS function.
CFS126 COMX New C Language Added the internal ICHMOD function.
CFS127 COMX New C Language Added the internal ICHOWN function.
CFS130 COMX New C Language Added the internal ILINK function.
CFS131 COMX New C Language Added the internal INAMETOI function.
CFS135 COMX New C Language Added the internal IREADLNK function.
CFS139 COMX New C Language Added the internal ISTAT function.
CFS145 COMX New C Language Added the internal LOCKNODE function.
CFS147 COMX New C Language Added the internal LOCKPROC function.
CFS148 COMX New C Language Added the internal LOCKZERO function.
CFS149 COMX New C Language Added the internal MAKEFILE function.
CFS150 COMX New C Language Added the internal PATHTOII function.
CFS152 COMX New C Language Added the internal SUBSUME function.
CFS153 COMX New C Language Added the internal TESTFD function.
CFS154 COMX New C Language Added the internal TRANPATH function.
CFS157 COMX New C Language Added the internal UNLKNODE function.
CFS159 COMX New C Language Added the internal UNLKPROC function.
CFS160 COMX New C Language Added the internal UNLKZERO function.
CFS164 COMX New C Language Added the internal FILEBACK function.
CFS165 COMX New C Language Added the internal FINDBACK function.
CFS166 COMX New C Language Added the internal LOCKBACK function.
CFS167 COMX New C Language Added the internal UNLKBACK function.
CFS168 COMX New C Language Added the internal TRANMDN function.
CFS169 CISO New C Language Added support to initialize the POSIX layer.
CFS304 COMX New C Language Added the internal CLOSE04 function.
CFS354 COMX New C Language Added the internal GET04 function.
CFS404 COMX New C Language Added the internal OPEN04 function.
CFS454 COMX New C Language Added the internal PURGE04 function.
CFS504 COMX New C Language Added the internal PUT04 function.
CFS554 COMX New C Language Added the internal RESIZE04 function.
CFS604 COMX New C Language Added the internal SIZE04 function.
CGSCAN CISO Changed Object-Only Internal macro changes.
CHDGFN CISO Changed Object-Only Internal changes.
CILG10 CISO New Object-Only Added an internal function.
CLLOAD CISO Changed Object-Only Internal changes.
CMOVEC CTAL New Assembler Added the tpf_movec C function.
COFLNO CISO New Object-Only Added the fileno C function.
COFLOK CISO New Object-Only Added an internal function.
COPSTR CISO Changed Object-Only Added an internal function.
CPRSMA CISO Changed C Language Updated for redirection of standard I/O.
CPRTF CISO No Longer Supported C Language Replaced by the CCPRTF library member (object file).
CSCNF CISO No Longer Supported C Language Replaced by the CCSCNF library member (object file).
CSFMON CISO Changed Object-Only Internal changes.
CSGFAE CISO New C Language Internal changes.
CSITOA CISO New Object-Only Added an internal function.
CSPRTF CISO Changed Object-Only Added the sprintf C function.
CSSCNF CISO Changed Object-Only Added the scanf C function.
CSTLCL CISO Changed Object-Only Internal changes.
CSTOLD CISO Changed Object-Only Internal changes.
CSYSTM CISO Changed C Language Enhanced for file system support
CVFPTF CISO New Object-Only Added the vfprintf C function.
CVPRTF CISO New Object-Only Added the vprintf C function.
CVSPTF CISO Changed Object-Only Added the vsprintf C function.
CWLEN CISO Changed Object-Only Internal changes.
CWNCPY CISO Changed Object-Only Internal changes.
CXXFUN CISO Changed Object-Only Added C exit cleanup.
C1FDOP CISO New Object-Only Added the fdopen C function.
C1MHFS CISO New Object-Only Added an internal function.
C1OHFS CISO New Object-Only Added an internal function.
C1OPST CISO New Object-Only Added an internal function.
C1P124 CISO New Object-Only Added an internal function.
C514 COMX Changed C Language Changed internal function.
C528 COMX Changed C Language Changed internal function.
C537 COMX Changed C Language Changed internal function.
UDDIPM COMX New C Language Sample input message device driver.
UDDTBL COMX New C Language User device driver table.
UDDWTC COMX New C Language Sample WTOPC output device driver.

Link-Edited Modules

There are no changes.

Members (Object Files)

Table 345 summarizes changes to members (object files). This information is presented in alphabetic order by the name of the member (object file).

Notes:

  1. You must recompile or reassemble a member (object file) if it has changed.

  2. You must prelink and link a dynamic load module (DLM) if it has changed.

Table 345. Changes to Members (Object Files) for File System Support

Member (Object File) DLM/DLL New, Changed, or No Longer Supported? Type Description of Change
CBOT CBOT New C Language Added initialization of #INODE fixed file records and setup of root directories.
CENV CENV Changed C Language Added defaults for the current working directory and the stdin, stdout, and stderr C functions.
CFIN CFIN New C Language Added verification of the integrity of #INODE 0 fixed file record.
CFZF CFZF New C Language Initialized the file system.
UBOT CBOT New C Language Provided for user exit at file system initialization.

Object Code Only (OCO) Stubs

There are no changes.

Configuration Constant (CONKC) Tags

There are no changes.

Control Program Interface (CINFC) Tags

There are no changes.

Copy Members

Table 346 summarizes copy member changes. This information is presented in alphabetic order by the name of the copy member.

Table 346. Changes to Copy Members for File System Support

Copy Member Type CSECT Where Copy Member Is Located New, Changed, or No Longer Supported? Description of Change
CCIT Control Program CCNUCL Changed Internal changes.
CHSZ Control Program CCNUCL Changed Initialized the new fields in page 2 of the entry control block (ECB).
CICR Control Program CCNUCL Changed Added file system initialization.
CLW5 Control Program CCLAW3 Changed Added a test for file system file descriptors.
CLW7 Control Program CCLAW3 Changed Added a test for file system file descriptors.

Fixed File Records

Table 347 summarizes fixed file record changes. This information is presented in alphabetic order by the name of the fixed file record.

Table 347. Changes to Fixed File Records for File System Support

Fixed File Record New, Changed, or No Longer Supported? Description of Change
#INODE New Fixed file records used for the file system.
#FLOCK New Fixed file records used for the file system.

Macros

The following section summarizes the macro changes. This information is presented in alphabetic order by the type of macro.

Advanced Program-to-Program Communications (APPC) Macros

There are no changes.

Communication Macros and Statements

There are no changes.

Data Macros

Table 348 summarizes the data macro changes. This information is presented in alphabetic order by the name of the data macro.

Table 348. Changes to Data Macros for File System Support

Data Macro New, Changed, or No Longer Supported? Do You Need to Reassemble Programs That Use This Data Macro?
DCTPFX Changed No
EB0EB Changed No
GROUP Changed No
ICLAWE Changed No
IDSDSA Changed No
IEQCE2 Changed No
INODE New Not Applicable
IPROC Changed No

General Macros

There are no changes.

Selected Equate Macros

There are no changes.

Structured Programming Macros (SPMs)

There are no changes.

System Initialization Program (SIP) Skeleton and Internal Macros (Inner Macros)

Table 349 summarizes the system initialization program (SIP) skeleton and internal macro changes. This information is presented in alphabetic order by the name of the SIP skeleton and internal macro. See TPF System Generation for a complete description of the SIP skeleton and internal macros. If the SIP skeleton and internal macro (inner macro) is changed, you must reassemble the SIP Stage I deck and run the appropriate job contorl language (JCL) jobs from the SIP Stage II deck.

Table 349. Changes to SIP Skeleton and Internal Macros for File System Support

SIP Skeleton and Internal Macro New, Changed, or No Longer Supported?
SPPGML Changed
SPRIAT Changed

System Initialization Program (SIP) Stage I Macros and Statements

There are no changes.

System Initialization Program (SIP) Stage II Macros

Table 350 summarizes system initialization program (SIP) Stage II macro changes. This information is presented in alphabetic order by the name of the SIP Stage II macro. See TPF System Generation for a complete description of the SIP Stage II macros. If IBMPAL is changed, you must run the system allocator (SALO) and load the new program allocation table (PAT) to the TPF 4.1 system.

Table 350. Changes to SIP Stage II Macros for File System Support

SIP Stage II Macro New, Changed, or No Longer Supported?
IBMPAL Changed

System Communication Keypoint (SCK) Generation Macros

There are no changes.

System Macros

There are no changes.

System Macros (IBM Use Only)

There are no changes.

Segments

Table 351 summarizes segment changes. This information is presented in alphabetic order by the name of the segment.

Table 351. Changes to Segments for File System Support

Segment Type Link-Edit Module (Where Offline Segment Is Linked) New, Changed, or No Longer Supported? Description of Change
BKD7 Real-Time Assembler Not Applicable New Added a recoup descriptor for file system records.
CJ01 Real-Time Assembler Not Applicable Changed Added file system initialization for all subsystems in the ZOODB command.
CTKO Real-Time Assembler Not Applicable Changed Added a call to file system initialization (CFIN).
CLMINT Real-Time Assembler Not Applicable Changed Added code to complete file system initialization.
CVAB Real-Time Assembler Not Applicable Changed Added support for the ZFINT command.
CVCX Real-Time Assembler Not Applicable Changed Added a call to the CBOT segment.
FTER00 Offline C Language FCTBG Changed Added file system error messages.
FTVA02 Offline C Language FCTBG Changed Added validation of the file system record types.
FTVA03 Offline C Language FCTBG Changed Added file system records to the list of valid record types.

System Equates

There are no changes.

User Exits

Control Program (CP) User Exits and ECB User Exits summarize the control program (CP) and ECB user exit changes. See TPF System Installation Support Reference for a complete description of all user exits.

Control Program (CP) User Exits

There are no changes.

ECB User Exits

This information is presented in alphabetic order by the name of the function.

Table 352. Changes to User Exits for File System Support

Function User Exit Activated In User Exit Program New, Changed, or No Longer Supported? Description of Change
Initialization CBOT UBOT New Allows you to create directories or set up device drivers at file system initialization time.

Functional and Operational Changes

The following section summarizes functional and operational changes. This information is presented in alphabetic order by the functional or operational change.

See Appendix A, "PUT 2-15 Interface Changes by Authorized Program Analysis Report (APAR)" for a summary of functional and operational changes by APAR.

Commands

Table 353 summarizes command changes. This information is presented in alphabetic order by the name of the command. See TPF Operations for a complete description of all commands.

Attention: Changes to commands can impact any automation programs you are using in your complex.

Table 353. Changes to Commands for File System Support

Command New, Changed, or No Longer Supported? Description of Change
ZFINT New Sets the file system initialization flag.

Messages and System Errors

Table 354 summarizes message (offline and online messages) and system error changes.

The message IDs or system error numbers are listed in numeric order preceded by their alphabetic prefix. Some offline and online messages do not have a standard message ID. For these, the messages are presented in alphabetic order based on the initial message text; or for those messages that begin with variable information, the initial message text that follows that variable information. See Messages (System Error and Offline) and Messages (Online) for a complete description of all messages and system errors.

Attention: Changes to offline messages, online messages, and system errors may impact any automation programs you are using in your complex.

Table 354. Changes to Messages and System Errors for File System Support

Message ID or System Error Number Message Type New, Changed, or No Longer Supported?
007510 System Error New
007511 System Error New
007512 System Error New
007513 System Error New
007514 System Error New
007515 System Error New
007516 System Error New
007517 System Error New
CBOT0001E Online New
CBOT0002E Online New
CBOT0004I Online New
CBOT0005E Online New
CFIN0001W Online New
CFIN0002E Online New
CFIN0003I Online New
CFIN0004I Online New
CFIN0005W Online New
FCTB0108E Offline New
FILE0005W Online New
FINT0001I Online New
FINT0002I Online New
FINT0005E Online New
FINT0006I Online New
FINT0007I Online New

Performance or Tuning Changes

There are no changes.

Storage Considerations and Changes

There are no changes.

System Initialization Program (SIP) and System Generation Changes

There are no changes.

Loading Process Changes

There are no changes.

Online System Load Changes

There are no changes.

Publication Changes

Table 355 summarizes changes to the publications in the TPF library. This information is presented in alphabetic order by the publication title. See the TPF Library Guide for more information about the TPF library.

Table 355. Changes to TPF Publications for File System Support

Publication Title Softcopy File Name Description of Change
TPF Application Programming GTPAPP07 A general description of file system support considerations has been added.
TPF C/C++ Language Support User's Guide GTPCLU07 Added file system API C functions.
TPF Concepts and Structures GTPACON05 Updated with high-level file system concepts.
TPF Library Guide GTPDOC07 Updated with definitions for new terminology in the master glossary.
Messages (System Error and Offline) and Messages (Online) Not Applicable Updated with information about messages and system errors that were added, changed, and no longer supported for file system support.
TPF Migration Guide: Program Update Tapes GTPMIG07 Updated with migration considerations for file system support.
TPF Operations GTPOPR07 Updated with information about the commands that were added and changed for file system support.
TPF System Installation Support Reference GTPINR07 Updated with information about the new UBOT user exit.
TPF Programming Standards GTPPSM07 Updated with information about modified and additional C programming standards.
TPF System Generation GTPSYSG07 Added information about #INODE and #FLOCK fixed file records.

Host System Changes

There are no changes.

Application Programming Interface (API) Changes

File system support has changed the implementation of the perror and assert C functions by ISO-C support as follows:

Both of these C functions can be directed to WTOPC if opened on a WTOPC special file or a SERRC special file.

Database Changes

There are no changes.

Feature Changes

There are no changes.

Installation Validation

There are no changes.

Migration Scenarios

This section provides information about how to install file system support on your TPF 4.1 system, as well as how to customize file system support after installation. Instructions are also provided about installing file system support without affecting your existing systems.

To Install File System Support on Your TPF 4.1 System

Use the following procedure to use the file system in your TPF 4.1 system.

Additional Information:

See TPF Operations for more information about the ZFINT and ZOODB INIT commands.

To Customize File System Support after Installation

You can customize file system support in the following ways:

To Install File System Support without Affecting Existing TPF 4.1 Systems

APAR PJ25089 requires that changes to existing C language applications that call the assert, gets, printf, puts, or scanf C functions be made at the same time the APAR is applied. Another APAR, PJ25240, permits you to install file system support without affecting existing C language applications, and permits C language applications that require the old versions of the assert, gets, printf, puts, or scanf C functions to coexist with new applications that use full file system support.

Note:
APAR PJ25240 does not permit an ECB to call both old and new file system functions.

The previous version of the scanf C function scans one line of input, even if there are more or fewer formatters than can be scanned in the line. (Standard C treats a newline as a whitespace character.)

With the new file system functions you can intermix whichever of the text-oriented I/O functions as are convenient to read or write the same stream. This is not possible to do with the old functions.

Migration to File System Support

The new migration to file system support works as follows: