FUJITSU Software NetCOBOL V11.0 COBOL File Access Subroutine User's Guide Linux(64) J2UL-1948-01ENZ0(00) October 2014 Preface What are the NetCOBOL File Access Routines? The NetCOBOL File Access Routines are Application Programming Interface (API) functions used to access COBOL files from C language programs. The API provides a common interface to COBOL files. The C application developer is not required to develop low-level file handling code or understand the intricacies of the physical file storage system. By using the function calls outlined in this API, C applications can safely access COBOL files in a manner consistent with the COBOL Runtime System. Additionally, the API's serve to isolate the C application from changes in the COBOL file behavior that may change with newer versions of NetCOBOL. Purpose of this Manual This manual explains the COBOL File Access Routines only. The intended audience of this manual should be familiar with the concept of COBOL file structures and I-O techniques. This software supports the development and operation of C applications that access COBOL files. The reader is assumed to have sufficient understanding of the C programming language. This manual does not explain how COBOL file I-O works. For this information, refer to "NetCOBOL Language Reference", "NetCOBOL User's Guide" and "NetCOBOL Messages" Product Names The names of products described in this manual are abbreviated as follows: Product Name Abbreviation Red Hat(R) Enterprise Linux(R) 7 (for Intel64) Linux Red Hat(R) Enterprise Linux(R) 6 (for Intel64) Microsoft(R) Windows Server(R) 2012 R2 Datacenter Windows Server 2012 R2 Microsoft(R) Windows Server(R) 2012 R2 Standard Microsoft(R) Windows Server(R) 2012 R2 Essentials Microsoft(R) Windows Server(R) 2012 R2 Foundation Microsoft(R) Windows Server(R) 2012 Datacenter Windows Server 2012 Microsoft(R) Windows Server(R) 2012 Standard Microsoft(R) Windows Server(R) 2012 Essentials Microsoft(R) Windows Server(R) 2012 Foundation Microsoft(R) Windows Server(R) 2008 R2 Foundation Windows Server 2008 R2 Microsoft(R) Windows Server(R) 2008 R2 Standard Microsoft(R) Windows Server(R) 2008 R2 Enterprise Microsoft(R) Windows Server(R) 2008 R2 Datacenter Windows(R) 8.1 Windows 8.1 Windows(R) 8.1 Pro Windows(R) 8.1 Enterprise Windows(R) 8 Windows 8 Windows(R) 8 Pro Windows(R) 8 Enterprise - i - Product Name Abbreviation Windows(R) 7 Home Premium Windows 7 Windows(R) 7 Professional Windows(R) 7 Enterprise Windows(R) 7 Ultimate Microsoft(R) Visual C++(R) development system Visual C++ Microsoft(R) Visual Basic(R) programming system Visual Basic Trademarks The trademarks used in this manual are: - NetCOBOL is a trademark or registered trademark of Fujitsu Limited or its subsidiaries in the United States or other countries or in both. - Oracle and Java are registered trademarks of Oracle and/or its affiliates. Other names may be trademarks of their respective owners. Oracle Solaris might be described as Solaris, Solaris Operating System, or Solaris OS. - Linux is a registered trademark of Mr. Linus Torvalds in the United States and other countries. - UNIX is a registered trademark of The Open Group in the United States and other countries. - X Window System is a trademark of The Open Group. - Red Hat, RPM, and other Red Hat-based trademarks and logos are trademarks or registered trademarks of Red Hat, Inc. in the United States and other countries. - Microsoft, Windows and Windows Server are trademarks or registered trademarks of Microsoft Corporation in the United States and other countries. - Other brand and product names are trademarks or registered trademarks of their respective owners. Export Regulation Exportation/release of this document may require necessary procedures in accordance with the regulations of your resident country and/or US export control laws. The contents of this manual may be revised without prior notice. No part of this document may be reproduced or transmitted in any form or by any means, electronic or mechanical, for any purpose, without the express written permission of Fujitsu Limited. October 2014 Copyright 2010-2014 FUJITSU LIMITED - ii - Contents Chapter 1 Before Using this Software...................................................................................................................................... 1 1.1 About COBOL File Access Routines.................................................................................................................................................. 1 1.2 Requirements....................................................................................................................................................................................... 1 1.3 Environment Setup.............................................................................................................................................................................. 1 Chapter 2 Usage...................................................................................................................................................................... 2 2.1 Making C Source Programs.................................................................................................................................................................2 2.2 Compilation of C Source Programs.....................................................................................................................................................2 2.3 Linking Objects....................................................................................................................................................................................2 2.4 Application Program Execution...........................................................................................................................................................2 Chapter 3 API Functions.......................................................................................................................................................... 3 3.1 cobfa_close()........................................................................................................................................................................................4 3.2 cobfa_delcurr().....................................................................................................................................................................................4 3.3 cobfa_delkey()..................................................................................................................................................................................... 5 3.4 cobfa_delrec()...................................................................................................................................................................................... 6 3.5 cobfa_errno()....................................................................................................................................................................................... 7 3.6 cobfa_indexinfo().................................................................................................................................................................................8 3.7 cobfa_open()........................................................................................................................................................................................ 9 3.8 cobfa_rdkey().....................................................................................................................................................................................13 3.9 cobfa_rdnext()....................................................................................................................................................................................14 3.10 cobfa_rdrec()....................................................................................................................................................................................16 3.11 cobfa_reclen().................................................................................................................................................................................. 17 3.12 cobfa_recnum()................................................................................................................................................................................18 3.13 cobfa_release().................................................................................................................................................................................18 3.14 cobfa_rewcurr()............................................................................................................................................................................... 19 3.15 cobfa_rewkey()................................................................................................................................................................................ 20 3.16 cobfa_rewrec()................................................................................................................................................................................. 21 3.17 cobfa_stat()...................................................................................................................................................................................... 22 3.18 cobfa_stkey()..................................................................................................................................................................................