Installation Guide - NetCOBOL

Installation Guide 

PowerGEM Installation Guide i

Second Edition: January 2009 

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. 

Copyright 1997-2009 Fujitsu Limited. 

NetCOBOL is copyrighted by Fujitsu Limited with all rights reserved. As a component of that 

program NetCOBOL uses libXpm developed by Groupe BULL and licensed to Fujitsu Limited 

under the requirement to reflect the following permission only as it pertains to the libXpm. 

Copyright (c) 1989-94 GROUPE BULL 

Permission is hereby granted, free of charge, to any person obtaining a copy of the libXpm 

and associated documentation files (the "libXpm software"), to deal in the libXpm software 

without restriction, including without limitation the rights to use, copy, modify, merge, 

publish, distribute, sublicense, and/or sell copies of the libXpm Software, and to permit 

persons to whom the libXpm Software is furnished to do so, subject to the following 

conditions: The above copyright notice and this permission notice shall be included in all 

copies or substantial portions of the Software. 

THE LIBXPM SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, 

EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF 

MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRIGEMENT. IN 

NO EVENT SHALL GROUPE BULL BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER 

LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING 

FROM, OUT OF OR IN CONNECTION WITH THE LIBXPM SOFTWARE OR THE USE OR 

OTHER DEALINGS IN THE LIBXPM SOFTWARE. 

Except as contained in this notice, the name of GROUPE BULL shall not be used in 

advertising or otherwise to promote the sale, use or other dealings in this libXpm software 

without prior written authorization from GROUPE BULL.

Preface 

This installation guide includes information required before and during the 

installation of the NetCOBOL family of products on the Solaris Operating System. 

Audience 

This guide is intended for programmers who will be installing the NetCOBOL 

product family. 

How this Manual is organized 

This manual contains the following information: 

• Media on which NetCOBOL is distributed 

• Packages that make up the NetCOBOL product family 

• Manuals that are provided by NetCOBOL Family 

• How to install the NetCOBOL family, and related installation considerations 

How to Use this Manual 

For optimal use of this guide, readers should have a working knowledge of the 

Solaris Operating System and the COBOL programming language. 

Conventions Used in this Manual 

This manual uses the following typographic conventions. 

Example of convention Description 

mkdir /cdrom What you type appears in Courier bold (contrasted 

with on-screen computer output). 

pkgadd The names of commands, directories, files, and 

variables as well as on-screen computer output are 

depicted in Courier. 

license_dir Courier italics indicate a command-line placeholder; 

replace with a real name or value. 

… Ellipses indicate the item immediately preceding can 

be specified repeatedly. 

[def] Indicates that the enclosed item may be omitted. 

{ABC|DEF} Indicates that one of the enclosed items delimited by | 

is to be selected. 

The sheet acts as an application 

creation form. 

“NetCOBOL User's Guide” 

See Table 2 “Required Disk Size”. 

Italics are occasionally used for emphasis. 

References to other publications or sections within 

publications are in quotation marks.

Related Manuals 

• NetCOBOL Product Overview 

• NetCOBOL License Management Guide 

• NetCOBOL Language Reference 

• NetCOBOL User’s Guide 

• NetCOBOL CBL Subroutine User’s Guide 

• NetCOBOL COBOL File Access Subroutine User’s Guide 

• NetCOBOL Web Guide 

• NetCOBOL SAF Subroutine User’s Guide 

• NetCOBOL CGI Subroutine User’s Guide 

• NetCOBOL Syntax Sample 

• NetCOBOL Message Guide 

• PowerFORM Runtime Reference 

• Data Converter User’s Guide 

High Risk Activity 

The Customer acknowledges and agrees that the Product is designed, developed 

and manufactured as contemplated for general use, including without limitation, 

general office use, personal use, household use, and ordinary industrial use, but is 

not designed, developed and manufactured as contemplated for use accompanying 

fatal risks or dangers that, unless extremely high safety is secured, could lead 

directly to death, personal injury, severe physical damage or other loss (hereinafter 

"High Safety Required Use"), including without limitation, nuclear reaction control 

in nuclear facility, aircraft flight control, air traffic control, mass transport control, 

medical life support system, missile launch control in weapon system. The 

Customer shall not use the Product without securing the sufficient safety required 

for the High Safety Required Use. In addition, Fujitsu (or other affiliate's name) 

shall not be liable against the Customer and/or any third party for any claims or 

damages arising in connection with the High Safety Required Use of the Product. 

Trademarks 

• SPARC® is a registered trademark of SPARC International, Inc. Products 

bearing SPARC trademarks are based on an architecture developed by Sun 

Microsystems, Inc. 

• Solaris Operating System is a trademark of Sun Microsystems, Inc. 

• Motif and OSF/Motif are trademarks of Open Software Foundation, Inc. 

• C-ISAM is a registered trademark of International Business Machines 

Corporation. 

• NetCOBOL is a trademark or registered trademark of Fujitsu Limited or its 

subsidiaries in the United States or other countries or in both.

• Other brand and product names are trademarks or registered trademarks of 

their respective owners. 

Acknowledgements 

This software is based in part on the work of the Independent JPEG Group

Contents 

Distribution ............................................................................................ 8 

Packages .................................................................................................................. 8 

Manuals .................................................................................................................... 9 

Operating Environment ......................................................................... 10 

Software Environment ............................................................................................ 11 

Disk Space.............................................................................................................. 11 

Restriction and Notes ........................................................................... 12 

Restriction .............................................................................................................. 12 

Notes ...................................................................................................................... 14 

Installing NetCOBOL ............................................................................. 22 

Preparation for Installation..................................................................................... 22 

Package Installation ............................................................................................... 22 

Deleting a Package................................................................................................. 28 

Notes on Non Global Zone ...................................................................................... 28 

Notes on Accessing C-ISAM files ............................................................................ 28 

Setting Up the User Environment ........................................................................... 28 

Appendix A. Security ............................................................................. 33 

Appendix B. libjpeg ............................................................................... 33

8 Installation Guide 

Distribution 

Packages 

NetCOBOL is distributed on CD-ROM. 

All package files of NetCOBOL for SPARC Architecture V10.0.0 family are provided 

by CD-ROM or NetCOBOL web site. 

A package is one or more program that makes up a software function. Table 1 lists 

the product names and functions associated with the NetCOBOL family. 

Table 1: NetCOBOL Family Packages 

Package file Name Package Name Function 

NETCOBOL 

FJSVcbl NetCOBOL Development Kit 

FJSVcblid NetCOBOL GUI Tools 

FJSVcbr NetCOBOL Runtime System 

FJSVcbree NetCOBOL Runtime System for 

Interstage Job Workload Server 

NETCOBRT FJSVcbr NetCOBOL Runtime System 

FJSVcbree NetCOBOL Runtime System for 

Interstage Job Workload Server 

PFORMRTS FPFORMrts PowerFORM Runtime system 

PGEM F-PGEM Resource management system 

PBSORT FSUNbsort Sort/merge system 

DATACONV FJSVdatcv Data Converter 

DATAEDIT FJSVdated Data Editor 

Client/DATAEDIT/* --- Client package of Data Editor that 

runs on Windows 

Client/ISSRM/* --- Client package of Remote 

Debugging Component for 

Interstage Studio that runs on 

Windows

Manuals 

Installation Guide 9 

NetCOBOL for SPARC Architecture V10.0.0 family provides following PDF manuals. 

Table 2 lists the manuals associated with the NetCOBOL family. 

Table 2: NetCOBOL Family Manuals 

Directory File Name Description 

.. 

(/cdrom/cdrom0) 

InstallGuide.pdf NetCOBOL Family Installation Guide 

(this manual). 

. Overview.pdf NetCOBOL Product Overview 

NETCOBOL 

NetCOBLanguageRef.pdf COBOL Language Reference 

NetCOBSyntaxSamples.pdf NetCOBOL Syntax Samples 

NetCOBUsersGuide.pdf NetCOBOL User’s Guide 

NetCOBWebGuide.pdf NetCOBOL Web Guide 

NetCOBCGISubGuide.pdf NetCOBOL CGI Subroutines User’s 

Guide 

NetCOBSAFSubGuide.pdf NetCOBOL SAF Subroutines User’s 


NetCOBCBLSubGuide.pdf NetCOBOL CBL Subroutines User’s 


NetCOBFileAccessGuide.pdf NetCOBOL File Access Subroutines 

User’s Guide 

NetCOBMessages.pdf NetCOBOL Messages 

PFORM PowerFORMRTSRef.pdf PowerFORM Runtime Reference 

PGEM PowerGEMUsersGuide.pdf PowerGEM User’s Guide 

DATACONV DataConvManual.pdf Data Converter Online Manual 

Notes: 

• Refer to the man manuals below for the usage of PowerBSORT. 

bsort(1): Sorting, merging and copying business data. 

bsortex(1): Sorting, merging and copying business data. 

(Extended bsort) 

xbsort(1): Sorting, merging and copying business data in 

Motif Window. 

bsrtclse(3): Erasing the BSORT operating environment 

including a library which was loaded into virtual 

storage with the bsrtopen function. 

bsrtget(3): Receiving sorted records from BSORT after the sort 

feature has been executed. 

bsrtmrge(3): Passing a record from an application program to 

BSORT or receiving a merged record from BSORT


after the merge feature has been executed. 

bsrtopen(3): Loading and opening BSORT. 

bsrtput(3): Passing a record from an application program to 

BSORT after the sort feature has been executed. 

bsort_env(5): Initiating the BSORT operating environment. 

bsort_errdetail(5): BSORT function errors codes. 

bsort_func(5): BSORT function specifications. 

bsort_guide(5): Introduction of business sorting and merging 

functions. 

bsort_message(5): BSORT messages. 

• Data Editor manual is installed with client program. 

Accessing manuals from CD-ROM in a Solaris environment 

1. Place the media in the CD-ROM drive. 

2. Mount the CD-ROM if it is not already mounted. 

Open the following files in an environment where PDF files can be read. In this 

example, it is assumed that the CD-ROM is mounted on /cdrom/cdrom0. 

/cdrom/cdrom0/manual/ReadFirst.pdf 

Accessing manuals from CD-ROM in a Windows environment 

1. Place the media in the CD-ROM drive. 

Open the following files in an environment where PDF files can be read. In this 

example, X is the name of the CD-ROM drive. 

X:¥manual¥manual.pdf 

manual.pdf is a PDF package format which multiple PDF files are built. 

Operating Environment 

Following software environment and hardware environment are required to use 

this software.

Software Environment 

Prerequisite Software 


Following software products needs to be installed on the system before you can 

use NetCOBOL: 

Required Software 

Disk Space 

Solaris 10 Operating System 

Following softwares are required when this software is used. 

No Software name Package name Version 

Level 

1 Symfoware Server 

Enterprise Edition 

Symfoware/RD 

B related 

package(note 

1) 

2 Oracle 9i All packages 

(Note 1) 

3 Oracle 10g All packages 

(Note 1) 

4 Oracle 11g All packages 

(Note 1) 

5 Interstage 

Application Server 

7.0.1 and 

later 

9.0.2 and 

later 

FJSVihs 7.0.1 and 

later 

Conditions 

[NetCOBOL] 

Required for use of 

Symfoware RDB server. 



Oracle 9i. 

10.1.0 [NetCOBOL] 


Oracle 10g. 

11.1.0 [NetCOBOL] 


Oracle 11g. 


Required for 

development and use of 

CORBA application. 

6 C-ISAM -- -- [NetCOBOL] 

[PowerBSORT] 

Required for inputoutput 

processing of C- 

ISAM files. 

Note1: Please refer installation guide and software release guide of each product 

for details. 

The following disk space is necessary for each directory to install this software 

newly. Please expand the size of corresponding file system if there is a necessary.


No Directory Disk space requirement (M bytes) Remarks 

1 / 0.1 

2 /usr 0.1 

3 /var 0.9 

4 /opt 75.1 

5 /home 0 

6 /$DIR (Note) 3.8 

(Note) $DIR is a directory name which PowerGEM is installed. Default name is /opt. 

Restriction and Notes 

Restriction 

In this software, there is something to which use is restricted among the matters 

described in the manual. The content, the corrective action, and the release time of 

the restrictions are indicated as follows. 

No Restriction Corrective action Release time 

1 [NetCOBOL][PowerFORM Runtime] 

The print of UTF-16 surrogate pair 

letters is not supported. A letter of 

UTF-16 surrogate pair is expressed by 

four bytes. 

2 [NetCOBOL] 

Presentation files are not supported. 


A compilation unit cannot end in a 

COPY statement (e.g. an END 

PROGRAM statement is present in a 

COPY file). The compiler does not 

work correctly in this case. 


For the screen handling function: 

- The SIZE clause cannot be specified 

for numeric and numeric edited 

screen items. 

- The JUSTIFIED clause and the SIZE 

clause cannot be specified at the same 

time. 

- The PROMPT clause is invalid when 

None Undefined 


Correct source 

program to end at 

out of COPY BOOK. 

Undefined 

None Undefined

the JUSTIFIED clause is used. 

- If a PROMPT clause is specified for 

an input screen item, the character 

specified in the PROMPT clause cannot 

be recognized in the item, since all of 

the occurrences of the specified 

character in the item are replaced 

with blanks. 


The following clauses cannot be 

specified in report group description 

entries: 

- CHARACTER TYPE clause 

- PRINTING POSITION clause 

Note: The NetCOBOL compiler does 

not issue diagnostic messages when 

these clauses are specified in report 

group description entries. 


When a program is compiled, in-line 

comments may not be written 

correctly to the source program listing 

when the following conditions are 

satisfied: 

- The code at compilation is UTF8, and 

- A new line is started within the inline 

comment in the source program 

listing. 

7 [PowerFORM Runtime] 

Following features are not supported. 

- Specifying URL by IPv6 address for a 

built-in media to be printed. 

- Specifying URL by IPv6 address for 

MEDIRAIR (built-in media storage 

directory name) key word on a printer 

information file 

8 [Data Editor] 

Only the IPv4 address is supported for 

connected-limitation configuration 

feature from the Data Editor Client. 





None Undefined


Notes 

Program, Class and method names 

• The COBOL system uses, internally, names that start with two underscores 

(__). A program, class or method name that starts with two successive 

underscores may already have been used as an internal name. 

• The following names cannot be used: 

- MAIN, main, JMP???, COB_???, COBOL_???, COBW3_??? 

- Names described in Appendix G: “Subroutines Offered by NetCOBOL” in the 

“NetCOBOL User’s Guide”. 

Warning error on RAISING phrase 

Compile error "JMN3448I-W" may be issued on a RAISING phrase in an EXIT 

METHOD statement. This is a result of adding the RAISING phrase to the 

PROCEDURE DIVISION header. However, the error does not affect program 

execution. Refer to the "Procedure Division Header" section in the "NetCOBOL 

Language Reference" for details. 

Fixed format 

When compile option SRF(FIX[,FIX]) is specified and the source record length is 

greater than 80 bytes, earlier versions of the compiler assumed that the part 

beyond column 81 was the next record. In this version, the compiler ignores the 

part beyond column 81. 

Stronger Checks on LINKAGE SECTION Items 

In NetCOBOL, the COBOL compiler checks for illegal references to data items 

defined in the LINKAGE SECTION at compile time. As a result, programs that 

compiled correctly with earlier versions of Fujitsu COBOL may now generate one of 

the following compilation errors: 

• JMN3482I-S: Illegal use of a data item defined in the LINKAGE SECTION of a 

called program, method, or second entry point. 

• JMN3483I-S and JMN5595I-S: Illegal use of a data item defined in the 

LINKAGE SECTION of the main program (the command line argument of OSIV 

format). 

If these errors are output, the program should be corrected as follows: 

• When JMN3482I-S is output 

If the data item indicated by the diagnostic message was used as a parameter 

for a called program, method, or second entry point, correct this by specifying 

the data item in the USING/RETURNING phrase of the PROCEDURE DIVISION 

(for programs and methods) or USING phrase of the ENTRY statement (for 

secondary entry points). If the data item is not used for this purpose, you 

should define it in the WORKING-STORAGE SECTION. 

• When JMN3483I-S or JMN5595I-S is output

For Oracle 


Data items can be defined in the LINKAGE SECTION of main programs only to 

receive command line arguments by OSIV format. If the data item is used for 

this purpose, correct the data item definition according to the diagnostic 

message. 

If the data item is not used for this purpose, define it in the WORKING- 

STORAGE SECTION. 

The application for Oracle created using NetCOBOL is a 32-bit application. 

IBM DB2 Universal Database 

The embedded SQL program interface that uses the DB2 Universal Database 

precompiler is supported in NetCOBOL. However, it must be used under the 

following conditions: 

a) Supported version 

IBM DB2 Universal Database Version 9.x 

b) Description of the program 

Describe the COBOL source using a fixed format for the reference format, 

[related option: SRF (type of reference format)], and follow the instructions in 

the DB2 Universal Database manual regarding the embedded SQL statement. 

c) Pre-compile 

Specify the following for the PRECOMPILE command parameter: 

- TARGET ANSI_COBOL 

d) Compiler options 

Specify the following compiler option: 

- ALPHAL(WORD) 

Do not specify the following compiler options: 

- DLOAD [dynamic program structure] 

- THREAD(MULTI)/-Tm [multithreading database access] 

Refer to Appendix A “Compiler Options" in the NetCOBOL User's Guide for 

details. 

e) COBOL library of DB2 Universal Database used for the compile 

Use the COBOL library for ANSI with DB2 Universal Database. 

f) Application 

A 32-bit application is created for DB2 Universal Database using NetCOBOL. 

g) Others 

In NetCOBOL, the program interface that uses the DB2 API is not supported. 

The operation of the object program that uses the DB2 API cannot be 

guaranteed. Refer to the article on COBOL programming in the DB2 Universal 

Database manual for additional information.


File Utility Functions 

The file utility functions available with NetCOBOL for Windows are not offered with 

the UNIX products. To migrate applications that use these functions from Windows, 

it is necessary remove the use of the file utility functions from the programs. 

GUI Tools 

Depending on the environment, X server has a limitation in the number of colors 

that can be handled at the same time. If an application using many colors has 

started before the GUI tool is started, the tool may be unable to be started or it 

may no longer be displayed in the correct color. To avoid this, terminate 

unnecessary applications or change the starting order of applications. 

The OPEN LOOK Windows Manager (olwm) 

Tools in NetCOBOL display their windows using the Motif Runtime. 

When OPEN LOOK Window Manager (olwm) is used, note the following: 

a) When a new window such as an option sheet is opened, the position of the 

input focus does not move automatically by default. 

To move the input focus automatically, add the following item to 

$HOME/.Xdefaults. 

OpenWindows.AutoInputFocus:True 

b) Occasionally, sub-windows are displayed at the back of the main window. 

To have the sub-window always display in front of the main window, add the 

following item to $HOME/.Xdefaults. 

OpenWindows.KeepTransientsAbove:True 

c) When using language functions that use the window system, it is necessary to 

update each resource file. 

d) When a sub-window that prohibits input to a main window is displayed, it is 

likely that input to other sub-windows will also be inhibited. 

To enable input to the other sub-windows, close the sub-window that prohibits 

input to the main window. 

e) Invalid items in the window menu may not be displayed as disabled. However, 

selecting the items is still invalid. 

f) The application icon may not be displayed correctly. 

FJSVcblid package 

FJSVcblid package provides following GUI tools on X-Window. 

• Project manager 

• Editor 

• Message managing tool 

• Source analyzing tool

• Builder 

• Compile option setting tool 

• Link option setting tool 

• SCREEN-DESIGNER 

Install the FJSVcblid package if you use these tools. 


Also, these GUI tools will stop to be released in future. Consider to use remote 

development environment from Windows NetCOBOL. 

Project Manager and the cobmkmf and cobdepend Commands 

When Project Manager and the cobmkmf and cobdepend commands check on 

dependencies, they search for the following keywords in the source programs: 

PROGRAM-ID, CLASS-ID, METHOD-ID, PROTOTYPE, PROPERTY, INHERITS, COPY, 

CALL, REPOSITORY, CLASS 

Dependencies may not be determined correctly in the following cases, so confirm 

the correctness of dependence relationships. 

• When two or more compilation units exist in one source file. 

• When the program name or class name defined in the source program is 

different from the actual filename. 

• When these keywords exist in debugging lines. 

• When keywords, or words that influence dependencies, are replaced using 

COPY or REPLACE statements. 

• When the keyword, or a word that influences dependence, is continued on the 

next line. 

Use the cobmkmf and cobdepend commands when you want to create a Makefile 

of the project that includes cross reference or indirect reference classes. 

Remote Development using NetCOBOL Studio on Windows 

Environment 

COBOL application can be remotely developed by using NetCOBOL Studio on 

Windows operating system. 

• To develop remotely by NetCOBOL Studio, setup an environment on the Solaris 

side. Refer to “NetCOBOL Studio User’s Guide” of NetCOBOL for Windows for 

details of the environmental setting. 

• The NetCOBOL product for Windows V9.0L10 or later is required. 

• The NetCOBOL product for Windows V10.0.0 or later is required if your 

environment is IPv6. 

• Configure “PASV mode” for FTP on a remote server information file when IPv6 

environment is used. Refer to “NetCOBOL Studio User’s Guide” of NetCOBOL 

for Windows for details of remote server information configuration. 

• Configure “PASV mode” for FTP on a remote server information file when 

Windows Server 2008 is used as a client. For details of remote server


information configuration, refer to “NetCOBOL Studio User’s Guide” of 

NetCOBOL for Windows. 

Remote Development using Interstage Studio on Windows 

Environment 

This product provides a client program “Remote debugging component for 

Interstage Studio”. The client program enables to debug remotely a COBOL 

application using Interstage Studio on Windows operating system. 

• The Interstage Studio Enterprise Edition V9.1.0 or later is required. 

• Refer to description (readme.txt) stored in /Clent/ISSRM of product CD-ROM of 

this software for details and the installation of “Remote debugging component 

for Interstage Studio”. 

• Configure “PASV mode” for FTP on a remote server information file when 

Windows Server 2008 is used as a client. For details of remote server 

information configuration, refer to “Interstage Studio User’s Guide” of 

Interstage Studio for Windows. 

Remote Development using NetCOBOL Project Manager on 

Windows Environment 

COBOL application can be remotely developed by using NetCOBOL Project Manager 

on Windows operating system. 

• Only csh is available for user shell. 

• Add source command on login shell ($HOME/.cshrc). 

source /opt/FJSVcbl/config/cobol.csh 

• Set FTP and rexec service up to be available. 

• Refer to “NetCOBOL User’s Guide” of NetCOBOL for Windows for details of 

remote development by project manager of NetCOBOL on Windows operating 

system. 

• The NetCOBOL V8 or later is required on the Windows operating system. 

Using the Debugger 

• The coverage level 2 function cannot be used when the CPU is an UltraSPARC. 

Substitute it with the coverage level 1 function. 

• When you use the debugger's coverage function for a program in which 

object-oriented functions are used, specify compile option NODLOAD. 

• When debugging a multithreaded program, the following message may be 

displayed, depending on the timing of loading the program: 

”An error detected in the debugger.(10121)” 

Restart the debugger again if this error occurs. 

• The debugging information file must be created at the same time as the 

object contained in the program for debugging is produced. The object will


not be recognized as a debugging object if these files are not created by the 

same compile. 

• The int type binary integer data items are handled by the debugger as if they 

were the following alphanumeric data items: 

- Operand of LIST command 

- Operand of SET command 

- Argument of function 

The int type binary integer data item is considered to be the following 

alphanumeric data items: 

- BINARY-CHAR -> PIC X(1) ---- one-byte alphanumeric 

- BINARY-SHORT -> PIC X(2) ---- two-byte alphanumeric 

- BINARY-LONG -> PIC X(4) ---- four-byte alphanumeric 

- BINARY-DOUBLE -> PIC X(8) ---- eight byte alphanumeric 

When you want to set a value for an int type binary item using the SET 

command, use a hexadecimal nonnumeric literal. 

• When you cannot operate a remote debugger, confirm the input waiting state 

of the terminal (waiting for the input of the data of the ACCEPT statement). 

When debugging remotely, the standard I/O is supported as a terminal that 

starts the remote debugger connector (svdrds). Multiple remote debuggers 

can be connected using the same terminal. When a remote debugger hangs 

due to terminal sharing, cancel the session and reconnect the remote 

debugger. 

• Neither the command file nor the operation record file are interchangeable 

between the various operating systems (Solaris, Windows, Linux). You need to 

create individual versions of these files for each operating system. 

Related Products Compatible with Multithreaded Programs 

The following products can work with multithreaded NetCOBOL applications: 

• PowerFORM RTS 

• PowerBSORT 

• Oracle 9i (9.0.1 or later) 

• Oracle 10g (10.1.0) 

• Oracle 11g (11.1.0) 

Unicode 

Related Products 

Symfoware Server Enterprise Edition V7.0.1 and later are related products that 

works with NetCOBOL applications in a Unicode environment. 

Code Conversion


Execute the code conversion on the Solaris Operating System when you convert 

resources such as source programs or libraries to Unicode. Ensure that you use the 

same code conversion tool for converting resources, development, and operation. 

Development Tools 

The following development tools are not guaranteed in Unicode: 

• Project Manager and its related commands (i.e. command names starting with 

“pmgr”). 

• Screen Designer and its related commands (i.e. command names starting with 

“sde”) 

• Interactive debugger (screen mode) 

SORT/MERGE Statements 

If PowerBSORT V5.0 or later is installed, PowerBSORT is used for sort-merge 

processing in a Unicode environment. 

Using PowerFORM Runtime 

• Don’t operate a file descriptor on another thread while the file descriptor is 

opened if the file descriptor is shared between threads. 

Using Data Editor 

a) Starting and Ending the Data Editor 

Before starting the Data Editor, set up the environment for Data Editor using 

the following command: 

# dataedit_start 

To end the Data Editor, use the following command: 

# dataedit_stop 

b) Communication time of session 

The communication line is automatically shut downed when communication 

(like data-extract and data-update) is not occurred even if the time specified 

with DATAEDIT_TIME (default is 60 minutes) is exceeded. 

Be careful about getting out of the seat while large volume data is operated. 

c) Action Following an Error 

If you are linked to a client program and the client program terminates 

abnormally, the Solaris Operating Environment considers that linkage as not 

ended, and you may not be able to terminate the server program using the 

dataedit_stop command. If this happens, Data Editor will recognize that an 

abnormal termination has happened after the timeout time (the time set in 

DATAEDIT_TIME) has elapsed. You can then terminate the server program. 

Avoid forced termination using the kill (1) command, as this may corrupt open 

COBOL files. 

d) Recovering Damaged Indexed Files


If an error occurs while you are editing indexed files, the files may be 

damaged. If this happens, you can use the COBOL file utility (cobfrcov 

command) to recover the files. 

e) IPv4 and IPv6 coexistence environment 

The Data Editor server and the client are connected by the same internet 

protocol. 

For example, the client program needs to connect Data Editor with same IPv6 

protocol when the Data Editor runs in the IPv6 environment. 

Refer to “Setting service and environment file (Data Editor)” for an 

environment file. 

Checking the operation of Data Converter 

To check the operation of the Data Converter take the following steps: 

1. Copy the sample file to any directory. 

% cp /opt/FJSVdatcv/sample/* copy-destination-directory 

2. Change the current directory to the copy destination directory and execute 

the following dataconvf command and sample.sh This sample contains a minor 

error. The error content is output to sample.msg. 

% dataconvf -if datal -of datal.out -formatf datal.format -itype 

data -otype rdb -icode jef 

3. Check that the converter terminates after the following messages have been 

displayed: 

Data Converter: Input file name : sample 

Data Converter: Record length in data definition statement Input : 116 

Output : 116 

Data Converter: Number of input records --> 15 

Data Converter: Number of output records --> 15 

4. The vi command can be used to check the contents of the conversion result 

because the result is stored in an RDB loader file. 

Note: 

% vi data1.out 

If all command operands are omitted, simple help information is displayed. 

Using PowerBSORT 

a) BSORT function 

BSORT function doesn’t support multithread environment. 

b) xbsort command 

• xbsort command doesn’t support Unicode environment.


Installing NetCOBOL 

• Refresh the screen using button when all file names are not 

listed on the file selection screen. 

Only users who are registered as super users, on systems configured as servers, 

can install NetCOBOL and its related packages. 

Preparation for Installation 

Confirmation of system environment 

1. Confirm whether the package has already been installed by pkginfo command. 

#pkginfo package-name 

ERROR: information for “package-name” was not found 

# 

Delete the package by pkgrm command when the package has already been 

installed. For deleting the package, see “Deleting a Package”. 

Installation time 

The installation time of this software is about 6 minutes. 

Package Installation 

The installation of NetCOBOL uses either the pkgadd command or the INSTALL.sh 

shell script. 

• Using INSTALL.sh 

If some packages which have same package name provided by this 

software are already installed, this shell script removes the packages, and 

installs them again. Also, this shell script can install packages except some 

packages which are already installed. 

All replies are confirmed before an actual processing. 

It is not necessary to consider “Notes on Non Global Zone”. 

• Using pkgadd command 

Only specific packages can be installed. 

You need to install FJSVcblid package at installation process if you use GUI tool like 

Project Manager which runs on X-Window. 

Also, refer to /Client/FJSVcblrm/Readme.txt on CD-ROM, and install a client 

program if you use remote development from Interstage Studio on Windows 

operating system.

Using INSTALL.sh 

Install the packages using the INSTALL.sh shell script. 

# /cdrom/cdrom0/INSTALL.sh 

+-----------------------------------+ 

| Confirmation: product information | 

+-----------------------------------+ 

Which product are you trying to install? 

1: NetCOBOL Enterprise Edition 

2: NetCOBOL Runtime system of Enterprise Edition 

3 PowerBSORT 

4 DataTools 

Please choose number on the above list [number: 1 - 4> 

Select the number corresponding to the product that you purchased. 


To skip this process, specify the product name as the parameter in the INSTALL.sh 

shell script, as shown below: 

# /cdrom/cdrom0/INSTALL.sh –p Product_Name 

Product_Name is as below: 

Enterprise : NetCOBOL Enterprise Edition 

Enterprise_Runtime : NetCOBOL Runtime System of Enterprise Edition 

PowerBSORT : PowerBSORT 

DataTools : Data Tools 

1. Specify installation GUI-Based Development Tools 

Specify either installation or no-installation of GUI-Based Development Tools if 

you are installing a NetCOBOL Enterprise Edition. 

+-------------------------------------------+ 

| Confirmation: GUI-Based Development Tools | 

+-------------------------------------------+ 

Do you want to install GUI-Based Development Tools? 

(default:n) [y:Yes, I install it, n:No, I don't]> 

2. Specify uninstallation before installation. 

If some packages are already installed, uninstall or skip installation of the 

package. 

+------------------------------------------+ 

| Confirmation: uninstallation of packages | 

+------------------------------------------+ 

Following packages are already installed. 

Installed packages /Packages which you are trying to 

install


NetCOBOL (9.0,REV=1.0E) /NetCOBOL (10.0.0,REV=1.0E) 

NetCOBOL Runtime System (9.0,REV=1.0E) /NetCOBOL Runtime System 

(10.0.0,REV=1.0E) 

Fujitsu PowerFORM Runtime System (9.0,REV=1.0) /Fujitsu PowerFORM Runtime 

System (10.0.0,REV=1.0) 

DataConverter (V5L1(5.1.1.0)) /DataConverter (V5L5(5.5.2.0)) 

DataEditor (V5L2(5.2.2.0)) /DataEditor (V5L5(5.5.0.0)) 

PowerGEM (1.1.4) /PowerGEM (1.1.4) 

PowerBSORT (V5.0L10) /PowerBSORT (6.0.0,REV=1.0E) 

Do you want to uninstall them and install newer one? 

(default:n) [y: uninstalling, n: not uninstalling/installing, 

q:quit]> 

3. Packages are uninstalled and installed automatically 

If you specify uninstallation, it is processed as shown below: 

+-------------------------+ 

| Starting uninstallation | 

+-------------------------+ 

+ /usr/sbin/pkgrm -n -a ./admin FJSVcbl 

Removal of was successful. 

+ /usr/sbin/pkgrm -n -a ./admin FJSVcbr 


+ /usr/sbin/pkgrm -n -a ./admin FPFORMrts 


+ /usr/sbin/pkgrm -n -a ./admin FJSVdatcv 


+ /usr/sbin/pkgrm -n -a ./admin FJSVdated 


+ /usr/sbin/pkgrm -n -a ./admin F-PGEM 


+ /usr/sbin/pkgrm -n -a ./admin FSUNbsort 


Then, packages are installed as shown below: 

+ /usr/sbin/pkgadd -d ./NETCOBOL -G -n -a ./admin FJSVcbl 

All Rights Reserved, Copyright (c) FUJITSU LIMITED 2000-2009 

Portions Copyright (c) UNIX Systems Laboratories, Inc. 1998 

Installation of was successful. 

+ /usr/sbin/pkgadd -d ./NETCOBRT -G -n -a ./admin FJSVcbr 




+ /usr/sbin/pkgadd -d ./NETCOBRT -G -n -a ./admin FJSVcbree 



Installation of was successful.


+ /usr/sbin/pkgadd -d ./PFORMRTS -G -n -a ./admin -r ./response/FPFORMrts 

FPFORMrts 




+ /usr/sbin/pkgadd -d ./DATACONV -G -n -a ./admin -r ./response/FJSVdatcv 

FJSVdatcv 

Copyright 1996-2009 FUJITSU LIMITED 

THIS PACKAGE CONTENTS UNPUBLISHED PROPRIETARY SOURCE CODE OF 

FUJITSU. 

The copyright notice above does not evidence any 

actual or intended publication of such source code. 


+ /usr/sbin/pkgadd -d ./DATAEDIT -G -n -a ./admin -r ./response/FJSVdated 

FJSVdated 


THIS PACKAGE CONTENTS UNPUBLISHED PROPRIETARY SOURCE CODE OF 

FUJITSU. 




+ /usr/sbin/pkgadd -d ./PGEM -G -n -a ./admin -r ./response/F-PGEM F-PGEM 

Copyright (c) FUJITSU LIMITED 2003 

All Rights Reserved. 

THIS PACKAGE CONTENTS UNPUBLISHED PROPRIENTARY SOURCE CODE OF FUJITSU. 




+ /usr/sbin/pkgadd -d ./PBSORT -G -n -a ./admin FSUNbsort 



Using pkgadd command 

1. Install the NetCOBOL package by the pkgadd command. 

# pkgadd -d /cdrom/cdrom0/NETCOBOL -G 

2. The package stored in CD-ROM is displayed as follows. Select the desired 

packages. 

The following packages are available: 

1 FJSVcbl NetCOBOL 

(sparc) 10.0.0,REV=1.0E 

2 FJSVcblid NetCOBOL Integrated Development Environment


(sparc) 10.0.0,REV=1.0 

3 FJSVcbr NetCOBOL Runtime System 

(sparc) 10.0.0,REV=1.0E 

4 FJSVcbree NetCOBOL Runtime System Enterprise Edition 

(sparc) 10.0.0,REV=1.0 

Select package(s) you wish to process (or 'all' to process all packages). 

(default: all) [?,??,q]: 

3. After that, respond to the displayed prompts. 

4. Install the PowerFORM Runtime package by the pkgadd command. 

# pkgadd -d /cdrom/cdrom0/PFORMRTS -G 


1 FPFORMrts Fujitsu PowerFORM Runtime System 

(sparc) 10.0.0,REV=1.0 




6. Install the PowerGEM package using the pkgadd command. 

# pkgadd -d /cdrom/cdrom0/PGEM -G 


packages. 


1 F-PGEM PowerGEM (sparc) 1.1.4 




9. Install the Data Converter package using the pkgadd command. 

# pkgadd -d /cdrom/cdrom0/DATACONV -G 


packages. 


1 FJSVdatcv DataConverter 

(sparc) V5L5(5.5.2.0)





12. Install the Data Editor package using the pkgadd command. 

# pkgadd -d /cdrom/cdrom0/DATAEDIT -G 


packages. 


1 FJSVdated DataEditor 

(sparc) V5L5(5.5.0.0) 




15. Install the PowerBSORT package using the pkgadd command. 

# pkgadd -d /cdrom/cdrom0/PBSORT -G 


packages. 


1 FSUNbsort PowerBSORT 

(sparc) 6.0.0,REV=1.0E 




COBOL information on make.rules 

When the installation of the NetCOBOL compiler and the debugger is complete, 

COBOL information is set in /usr/share/lib/make/make.rules. COBOL information on 

make.rules is shown below: 

... 

SUFFIXES = .o .c .c~ .cc .cc~ .y .y~ .l .l~ .s .s~ .sh .sh~ .S .S~ .i .ln \ 

.h .h~ .f .f~ .for .for~ .F .F~ f90 .f90~ .ftn .ftn~ mod .mod~ \


.sym .def .def~ .p .p~ .r .r~ .cps .cps~ .C .C~ .Y .Y~ .L .L~ \ 

.java .java~ .class .cob .cob~ 

... 

# COBOL language section 

COBOL=cobol 

COBFLAGS= 

COMPILE.cob=$(COBOL) $(COBFLAGS) -c 

LINK.cob=$(COBOL) $(COBFLAGS) $(LDFLAGS) 

.cob: 

$(LINK.cob) -o $@ $< $(LDLIBS) 

.cob.o: 

$(COMPILE.cob) $(OUTPUT_OPTION) $< 

.cob.a: 

$(COMPILE.cob) -o $% $< 

$(AR) $(ARFLAGS) $@ $% 

$(RM) $% 

... 

Deleting a Package 

To delete a NetCOBOL package, use the pkgrm command. 

#pkgrm FJSVcblid FJSVcbl FJSVcbree FJSVcbr F-PGEM FPFORMrts FJSVdatcv 

FJSVdated FSUNbsort 

Notes on Non Global Zone 

If you install a NetCOBOL Family product in a non-global zone, you must remove 

the /usr inheritance. If a NetCOBOL Family product is installed in a non-global 

zone in which /usr is inherited, the installation will fail. 

Notes on Accessing C-ISAM files 

To access C-ISAM files by PowerBSORT, follow these steps: 

1. Follow the instructions in " Package Installation ". 

2. Add the C compiler directory path to PATH environment variable. 

3. Execute the following command: 

# cd /opt/FSUNbsort/config 

# ./remake 

Setting Up the User Environment 

The NetCOBOL family of products requires certain environment variables to be set 

prior to execution. Two methods for setting environment variables are described 

below.

Single Package Installation 


The NetCOBOL and PowerBSORT environment can be set using the shell script 

below. 

For a development environment: 

/opt/FJSVcbl/config/cobol.sh (Bourne shell) 

/opt/FJSVcbl/config/cobol.csh (C shell) 

For a runtime environment: 

/opt/FJSVcbl/config/cobolrt.sh (Bourne shell) 

/opt/FJSVcbl/config/cobolrt.csh (C shell) 

For a PowerBSORT environment: 

Multiple Package Installation 

/opt/FSUNbsort/config/psort.sh (Bourne shell) 

/opt/FSUNbsort/config/psort.csh (C shell) 

Follow these instructions for using SetUpEnv.sh: 

1. Copy /cdrom/cdrom0/SetupEnv.sh to your working folder. 

2. Run SetupEnv.sh to produce the following files: 

PROFILE.NETCOBOL.sh (Bourne shell) 

LOGIN.NETCOBOL.csh (C shell) 

3. Run the desired file to setup environment variables. 

Bourne Shell 

Run “. PROFILE.NETCOBOL.sh” or merge the contents to $HOME/.profile. 

Note: Make sure you use the period-space at the beginning of the literal. This 

ensures that a new process is not created and the environment variable 

settings will be available for following applications. 

C Shell 

Run “source LOGIN.NETCOBOL.csh” or merge the contents to $HOME/.cshrc. 

Environment variable list 

Program name 

No. Environment name Contents Comment SetupEnv.sh 

NetCOBOL 

1 PATH Directory of If set manually, refer Supported 

COBOL compiler to the shell script 

and several under 

utilities 

/opt/FJSVcbl/config


2 LD_LIBRARY_PATH Directory of 

COBOL compiler 

and COBOL 

runtime 

3 MANPATH Directory of 

COBOL man 

manuals 

4 NLSPATH Directory of 

COBOL message 

catalog 

5 XUSERFILESEARCHPATH Directory of 

resource file 

6 DTHELPUSERSEARCHPATH Directory of 

COBOL 

development 

tool Help file 

7 COBCOPY CopyBook 

directory like 

Web Subroutine 

PowerFORM Runtime 


PowerFORM 

Runtime 

libraries 

PowerGEM 

9 PATH Directory of 

PowerGEM 

Utilities 


PowerGEM 

Utility library 

Data Editor 

11 PATH Directory of 

server program 


server program 

13 DATAEDIT_TEMP *1 Working 

directory 

14 DATAEDIT_LOG *1 Directory for 

messaged 

output by server 

program 

15 DATAEDIT_BACK *1 Directory for 

backup file of 

the data file 

16 DATAEDIT_TIME *1 Time in minutes 

until end of 

communication 

Refer to the 

PowerFORM Runtime 

Reference for other 

environment 

variables. 

Set this in the login 

shell ($HOME/.cshrc) 

if the remote 

development feature 

is used. 

Specify a directory 

for which all login 

user Ids on Data 

Editor have write 

authority 

Supported 

Supported 

Supported 

Supported 

Supported 

Supported 

Supported 

Supported 

Supported 

Supported 

Supported 

Not 

supported 

Not 

supported 

Not 

supported 

Not 

supported

for one session 

17 DATAEDIT_MSG *1 Directory for 

message file of 

the server 

program 

*1: Specify all paths by their absolute path names. 

Data Converter 

18 DATACONV_DIR Directory where 

Data Converter 

is stored. 

19 PATH Directory where 

dataconvf 

command is 

stored. 

20 LD_LIBRARY_PATH Directory where 

code conversion 

and record 

editing parts are 

stored 

21 TMPDIR Working 

directory 

PowerBSORT 

22 PATH Directory pf 

PowerBSORT 


PowerBSORT 

24 MANPATH Directory pf 

PowerBSORT 

man manuals 

25 NLSPATH Directory of 

PowerBSORT 

message catalog 

26 XFILESEARCHPATH Directory of 

xbsort command 


This can be omitted 

if OS locale is EUC. 

Specify the directory 

if the locale is C or 

Unicode. 

message.ascii is used 

if C locale is used. 

message.utf8 is used 

if Unicode locale is 

used. 

Refer to each installation guide regarding the above environment variables. 

Data Editor setting 

Data Editor users should follow these steps to configure their development 

environment. 

1. Defining a port number. 

Not 

supported 

Supported 

Supported 

Supported 

Not 

supported 

Supported 

Supported 

Supported 

Supported 

Supported


The server program and client program use a socket interface for linking to 

each other. Define the following port number for linkage to Data Editor in the 

/etc/services file. 

Service name : dataed 

it Port number : Any value within the range 5001 to 9999 

Protocol : tcp 

Alias of the service name: (None) 

2. Use a vi editor to add a line to the /etc/services file. The following shows an 

example of adding a line: 

dataedit 7001/tcp #Data Editor 

3. Defining the environment file 

In IPv6 environment, the environment file is not required. 

Environment 

Variable 

Description 

SI_STRSV.ip File for restricting connection from a client to a particular 

IP address (high-order two bytes). 

Obtaining a License Password 

* Create in the directory specified in the environment 

variable DATAEDIT_LOG. 

The name of the created file is prepended to SI_STRSV.ip 

Example: File name: SI_STRSV.ip 

100.111 - ->Permit access from a 100.111.xxx.xxx 

system 

200.222 --->Enter a line feed character when 

specifying multiple values 

To obtain a license password, you must know the Host ID of your system, and you 

must be a super user. To obtain your computer’s Host ID, execute the sysdef -h 

command on your computer. The result will be similar to the following: 

# sysdef -h 

* 

*Host ID 

* 

18058a88 

The Host ID of this machine is “18058a88” 

Note: Once the license password has been obtained, the registered license cannot 

be changed or added to. 

Once you have the Host ID, apply to NetCOBOL distributor for your license 

password by completing the registration form at: 

http://www.netcobol.com/registration/sparc 

Within two business days, you will receive your license password by email.

Place your license password file by the following path name. 

/etc/opt/NetCOBOL/license.txt 

Appendix A. Security 


Since there are Internet-enabled functions in the development environment, it is 

recommended that you use the NetCOBOL development environment only in an 

Intranet, and not in the more open Internet environment. 

Appendix B. libjpeg 

This product uses libjpeg in the JPEG output function.

Installation Guide - NetCOBOL

Create successful ePaper yourself

Delete template?

Save as template?