PROGRAMMING-STAFF Help Index
PROGRAMMING-STAFF Help Contents

Displayed below are PROGRAMMING-STAFF help topics.

Keyboard

PROGRAMMING-STAFF Keys

Operation

[File] Menu

[Edit] Menu

[Search] Menu

[Project] Menu

[Tools] Menu

[Windows] Menu

Note: Throughout this help system, you will see products abbreviated as follows:

•	Microsoft(R) Windows NT(TM) Workstation operating system Version 3.51

Windows NT(TM) or Windows NT(TM) 3.51

•	Microsoft(R) Windows NT(TM) Server Network operating system Version 3.51

Windows NT(TM) or Windows NT(TM) 3.51

•	Microsoft(R) Windows(R) 95 operating system

Windows(R) 95


PROGRAMMING-STAFF Operation

[File] Menu

[Edit] Menu

[Search] Menu

[Project] Menu

[Tools] Menu

[Window] Menu

Note: Do not specify file names containing a blank while using PROGRAMMING-STAFF.


PROGRAMMING-STAFF Key

The following shortcut keys can be used in PROGRAMMING-STAFF:

Alt + F4         Close the active window.

Ctrl + Z         Select [EDIT]-[UNDO].

Ctrl + X         Select [EDIT]-[CUT].

Ctrl + C         Select [EDIT]-[COPY].

Ctrl + V         Select [EDIT]-[PASTE].

Del              Select [EDIT]-[DELETE].

Ctrl + F         Select [SEARCH]-[FIND].

Ctrl + R         Select [SEARCH]-[REPLACE].

F3               Select [SEARCH]-[NEXT].

F4               Select [SEARCH]-[PREVIOUS].

F5               Select [SEARCH]-[JUMP].

Ctrl + Home      Select [SEARCH]-[TOP].

Ctrl + End       Select [SEARCH]-[END].

F11              Select [SEARCH]-[TAG JUMP].

Shift + F11      Select [SEARCH]-[BACK TAG JUMP].


[File] Menu

The following commands and items appear on the [File] Menu:

New

Open

Close

Save

Save As

Compile

Compiler Options

Customize Editor

Fonts

Save Setting on Exit

Exit

File History


[New] Menu Command

Open a new file in the PROGRAMMING-STAFF editor.


[Open] Menu Command

Open the specified file in the PROGRAMMING-STAFF editor. Specify a file name in the [Open File] dialog box.


[Close] Menu Command

Close the PROGRAMMING-STAFF editor.


[Save] Menu Command

Save the current PROGRAMMING-STAFF editor text using the name by which it was last saved. If the current PROGRAMMING-STAFF editor text has not yet been saved, as in the case of a new file, the Save As dialog box will be displayed for you to enter the file name.


[Save As] Menu Command

Save the current PROGRAMMING-STAFF editor text in the specified file. Specify a file name in the [Save As] dialog box.


[Compile] Menu Command

Compile the COBOL source displayed in the current PROGRAMMING-STAFF editor window.

Note: Do not write-protect the source file or source file directory.


[Compiler Options] Menu Command

Display the [Compiler Options] dialog box for the COBOL source in the current PROGRAMMING-STAFF editor window.

Note: There is no difference between setting the compiler options in the [Compiler Options] window which started from the PROGRAMMING-STAFF editor or from the [Project] Window, and setting the compiler options in the [Compiler Options] Dialog started from WINCOB. Refer to the [Compiler Options] Dialog Box.

Related Items

[Compiler Options] Dialog Box

Compiler options


[Fonts] Menu Command

Specify the font to be used by the PROGRAMMING-STAFF editor.


[Customize Editor] Menu Command

The [Customize Editor] Menu contains the following subcommands:

[Set]

[Reset]


[Customize Editor] Dialog Box

If you wish to use a different editor from the one supplied with PROGRAMMING-STAFF, register your chosen editor by specifying the command-line required to invoke it in the [Customize Editor] dialog box.

Once the editor has been registered in this manner, it can be activated from PROGRAMMING-STAFF.

The following explains how to use the [Customize Editor] dialog box:

[Customize Editor] Dialog Box Operation

•	[Command-Line] Edit box:

Specify the command-line used to invoke your chosen editor.

•	[OK] Button:

Accept the specified information and close the dialog box.

•	[Cancel] Button:

Ignore the specified information and close the dialog box.

•	[Browse] Button:

Search for the file name to be used as the invoking command in the [Command-Line].


[Reset] Menu Subcommand

Reset PROGRAMMING-STAFF to use the PROGRAMMING-STAFF editor rather than one you may have specified using the [Customize Editor] function.


[Save Setting on Exit] Menu Command

Check this item to save the current settings (such as window size) when exiting.


[Exit] Menu Command

Terminate PROGRAMMING-STAFF.

If [Save Setting on Exit] is checked, the settings current on exiting are saved.


[File History] Menu List

Display a list of previously opened files. Files selected from the history list are opened in the PROGRAMMING-STAFF editor. Up to four files are displayed. Updating the list deletes the entry for the least recently edited file.


[Edit] Menu

The following commands and items appear on the [Edit] menu:

Undo

Cut

Copy

Paste

Delete

Select All

Word Wrap

Line Number


[Undo] Menu Command

Undo the previous edit operation.


[Cut] Menu Command

Delete the selection from the document and store it on the clipboard.


[Copy] Menu Command

Copy the selection to the clipboard.


[Paste] Menu Command

Insert a copy of the clipboard contents at the cursor position.


[Delete] Menu Command

Delete the selection from the document. The deleted selection is not stored on the clipboard.


[Select All] Menu Command

Select the entire document.


[Word Wrap] Menu Command

Lines of a document that do not fit in the window wrap to the next line. The file itself is not changed.

Notes:

•	When the PROGRAMMING-STAFF editor displays a compilation message (diagnostic message),

it cannot execute a jump tag if a file name or line number is displayed on more than one line after word-wrapping.

•	When the PROGRAMMING-STAFF editor the tag jump ahead is turned on a right edge, the tag jump may not be able to be normalized.


[Line Number] Menu Command

The [Line Number] menu command has the following subcommands:

Create

Renumber


[Create] Menu Subcommand

Add six-digit line numbers at the beginning of each line of the document._

Note: Once created, line numbers cannot be canceled by selecting the [Undo] menu command.


[Renumber] Menu Subcommand

Recreate and overwrite the six-digit line numbers at the beginning of each line of the document.

Note: Renumbering cannot be reversed by selecting the [Undo] menu command.


[Search] Menu

The following commands and items appear on the [Search] menu:

Find

Replace

Next

Previous

Jump

Top

Bottom

Tag Jump

Back Tag Jump


[Find] Menu Command

Displays the [Find] dialog box for finding a character string within the document.


[Replace] Menu Command

Displays the [Replace] dialog box for finding and replacing a character string within the document.

Notes:

•	In the [Find] dialog box , a character string cannot be specified for replacement.

•	For Windows NT(TM), Once replacement has been executed, it cannot be canceled by selecting [EDIT]-[UNDO].


[Next] Menu Command

Search for the specified character string forward from the cursor location and select the first occurrence.

The previously found or replaced character string is a valid search character string.


[Previous] Menu Command

Search for the specified character string backward from the cursor location and select the first occurrence.

The previously found or replaced character string is a valid search character string.


[Jump] Menu Command

Displays the [Jump] dialog box. In the dialog box, specify the relative line number.

[Jump] Dialog Box


[Jump] Dialog Box

Jump to the relative line number specified in the dialog box.

The following explains how to use the [Jump] dialog box:

[Jump] Dialog Box Operation

•	[Relative Line Number] Edit box:

Specify a relative line number for the jump. This is the line where you wish the cursor to be placed. The document text in the editing window will be repositioned to display this line.

•	[OK] Button:

Move the cursor to the beginning of the line with the relative line number specified in the Relative line number [edit box].

•	[Cancel] Button:

Close the dialog box, discarding all information.

•	[Help] Button:

Displays Help.


[Top] Menu Command

Move the cursor to the beginning of the file the PROGRAMMING-STAFF editor is editing.


[Bottom] Menu Command

Move the cursor to the end of the file the PROGRAMMING- STAFF editor is editing.


[Tag Jump] Menu Command

Select the line containing the name of the file to be opened and the error line number from the error message displayed in the PROGRAMMING- STAFF editor.

Select [Tag Jump] to open the file in the PROGRAMMING-STAFF editor and to position the cursor at the error line number.

If the file in the selected error message is already open in the PROGRAMMING-STAFF editor, the tag jump is executed in the active window.


[Back Tag Jump] Menu Command

If [Back Tag Jump] is selected for the PROGRAMMING-STAFF editor for which a tag jump was executed,

the jump-from message window becomes active, and the cursor is positioned at the selected message line.

Note: A back tag jump can be executed only once, immediately after a tag jump.


[Project] Menu

The following commands and items appear on the [Project] menu:

Open

Files

Option

Make

Execute

Close

Argument at Execution

Create Module-Definition Files

Project History

Related Item

[Project] Window


[Project] Window

The [project] window manages all of the project functions.

The following explains [project] window operation:

•	[project] window list box

The file names currently registered in the project file are displayed.

If a COBOL source, library file, or module-definition file has been selected, double-clicking opens the file for editing.

If an application file is selected, double-clicking causes it to be executed.

[Files] Button

[Compiler Options] Button

[Linker Options] Button

[Build / Rebuild] Buttons

[Execute] Button

Notes:

•	A project file being edited by the PROGRAMMING-STAFF editor can be edited even after the [project] window is closed.

•	Do not write-protect the project file or project file directory.


[Open] Menu Command

Displays the [Open project] dialog box. Opens the project file specified and displays the project information in the [Project] window.

Notes:

•	An existing or a new project file can be specified, but more than one project file cannot be specified at the same time.

•	Only *.PRJ can be selected as the file name extension. If a file name does not have an extension, .PRJ is added.


[Files] Menu Command / Button

If no target file(s) have been specified, as in the case of a new project, the [Target Files] dialog box is displayed to register target files in the project. Otherwise this command displays the [Dependent Files] dialog box to register dependent files for the selected target.

Related items

[Dependent Files] Dialog Box

[Target Files] Dialog Box

[Library Files] Dialog Box


[Dependent Files] Dialog Box

The following explains how to use the [Dependent Files] dialog box:

[Dependent Files] Dialog Box Operation

•	[Targets] Combo box:

Select a target. The [List] list box displays files dependent on the selected target.

•	[File] Edit box:

Type the full path to a file dependent on the target selected in the [Targets] combo box.

Click the [Add] button to register the path in the [List] list box.

•	[List] List box:

Display the files dependent on the target selected in the [Targets] combo box.

An icon indicating file type is displayed before each file name. More than one file can be selected.

Note: This button also cancels the settings in the [Target Files] and [Library Files] dialog boxes.

•	[Set] Button:

Displays the target specification dialog box. The target specified in the dialog box is added to the [Targets] combo box.

Related Items

[Target Files] dialog Box

•	[Browse] Button:

Displays the [Browse Files] dialog box . More than one file can be selected.

The file types that can be selected are COBOL source (*.COB, *.CBL or *.COBOL), module-definition (*.DEF), object (*.OBJ), and library (*.LIB) files.

The [File] Edit box displays file name specified in the dialog box.

•	[Add] Button:

Add the file name displayed in the [File] Edit box to the list box. The files that can be registered extensions are *.COB, *.CBL, and *.COBOL (COBOL source file), *.DEF (module-definition file), *.OBJ (object file), and *.LIB (library file).

Notes:

•	The export library file (target-name.EXP) in the dynamic link library cannot be selected because it is created automatically.

•	The module-definition file (target-name.DEF), import library file (target-name.LIB), and export library file (target-name.EXP) names are fixed. If a module-definition file has already been created, change its name.

•	[Delete] Button:

Delete the selected file name from those displayed in the [List] list box.

•	[Main program] Button:

Specify the file name selected from those displayed in the [List] as the main program.

The icon displayed before the file specified as the main program turns red. If the selected file already exists, the specification is canceled; select a new file as the main program. If a file already specified as the main program is selected, the specification is canceled.

Notes:

•	More than one dependent file cannot be specified as the main program for a single application program.

•	If a dynamic link library is specified as the target, the main program cannot be specified.

•	[Libraries] Button:

Displays the [Library Files] dialog box to specify a library for the file selected from those displayed in the [List] list box.

Related Items

[Library Files] Dialog Box

•	[OK] Button:

Save the settings in the project file and close the dialog box. The [Project] window displays the registered file names.

Related Item

[Project] Window

•	[Cancel] Button:

Cancel all settings and close the dialog box.

•	[Help] Button:

Displays Help.


[Target Files] Dialog Box

The following explains how to use the Project-Target Files dialog box:

 [Target Files] Dialog Box Operation

•	[File] Edit box:

Type the full path name to the target. Click the Add button to register the path in the Target Files list box.

•	[List] List box:

Displays the registered target names. More than one target can be selected.

•	[Browse] Button:

Open the [Browse Files] dialog box. More than one file can be selected. The files that can be selected are application (*.EXE) and dynamic link library (*.DLL). A file name specified in the dialog box is displayed in the [File] Edit box.

•	[Add] Button:

Add the file name displayed in the [File] Edit box to the list box. The files that can be registered extensions are *.EXE (application file) and *.DLL (dynamic link library).

•	[Update] Button:

Change the file name selected from those displayed in the [List] list box to the target file name typed in the edit box.

Note: A target name between an application program and a dynamic link library cannot be modified.

•	[Delete] Button:

Delete the selected file name from those displayed in the [List] list box.

•	[OK] Button:

Accept the settings and close the dialog box.

•	[Cancel] Button:

Ignore the settings and close the dialog box.

•	[Help] Button:

Displays Help.


[Library Files] Dialog Box

The following explains how to use the [Library Files] dialog box:

[Library Files] Dialog Box Operation

•	[Dependent Source File]:

Displays a COBOL source file selected from the [List] list box in the [Dependent Files] dialog box. A library is set for this file.

•	[File] Edit box:

Type the full path of a library file. Click the Add button to register the path and file name in the Library Files list box.

•	[List] List box:

Displays registered library file names. More than one library file can be selected.

•	[Browse] Button:

Display the [Browse Files] dialog box. More than one file can be selected. A file name specified in the dialog is displayed in the [File] Edit box.

•	[Add] Button:

Add the file name displayed in the [File] Edit box to the list box.

•	[Delete] Button:

Delete the selected file name from the [List] list box.

•	[OK] Button:

Accept the settings and close the dialog box.

•	[Cancel] Button:

Ignore the settings and close the dialog box.

•	[Help] Button:

Displays Help.


[Option] Menu Command

The [Option] menu command has the following subcommands:

Compiler Options

Linker Options

Note: There is no difference in the procedure for setting the compiler options in the [Compiler Options] Window from the PROGRAMMING-STAFF editor or the [Project] Window [Compiler Options] Dialog Box. Refer to [Compiler Options] Dialog Box.


[Linker Options] Menu Subcommand / Button

Displays the [Linker Options] dialog box to specify linker options for the project.

[Linker Options] Dialog Box


[Linker Options] Dialog Box

Specify linker options in the dialog box.

The following explains how to use the [Linker Options] dialog box:

[Linker Options] Dialog Box Operation

•	[Linker Options] Edit box

Enter a linker option. If compiler option TEST is specified, the debug option is automatically specified.

•	[Browse] Button:

Displays the [Browse Files] dialog box. The file names specified in the dialog are displayed in the [Linker Options] edit box.

•	[OK] Button:

Accept the settings and close the dialog box.

•	[Cancel] Button:

Ignore the settings and close the dialog box.

•	[Help] Button:

Displays Help.


[Make] Menu Command

The [Make] menu command has the following subcommands that are also available as buttons in the [Project] Window:

•	[Build]:

Compile and Link the file based on dependence Information.

•	[Rebuild]:

Compile and link all files in the project.

Note: For Windows(R) 95, there is no notice of a build or rebuild error. Confirm error by the message.


[Execute] Menu Command
[Execute] Menu Command / Button

Execute an executable file created in the project. Any specified run-time parameters will be used.

Related Item

Runtime Environment Setup Window Help


[Close] Menu Command

Close the [project] window. Any project file the PROGRAMMING-STAFF editor is editing is not automatically closed.


[Argument at Execution] Menu Command

Displays the [Argument at Execution] dialog box. Select [Execute] Menu / Button and specify the parameters to be passed to the application program that will be executed.

Related Item

[Argument at Execution] Dialog Box


[Argument at Execution] Dialog Box

Select [Execute] Menu Command / Button and specify the parameters to be passed to the application program that will be executed.

The following explains how to use the [Argument at Execution] dialog box.

[Argument at Execution] Dialog Box

•	[Command-Line Argument] Edit box:

Specify the parameters to be used in executing the application program.

•	[Browse] Button:

Displays the [Browse Files] dialog box. The [Argument at Execution] edit box displays the file name specified in the dialog box.

•	[OK] Button:

Accept the settings and close the dialog box.

•	[Cancel] Button:

Ignore the settings and close the dialog box.

•	[Help] Button:

Displays Help.


[Create Module-Definition Files] Menu
[Create Module-Definition Files] Menu Command

When Make is used to create a dynamic link library, there may be no module-definition file. If this menu item is selected, a module-definition file is created automatically.

Notes:

•	The PROGRAMMING-STAFF project function can handle only a module-definition file named dynamic-link-library-name.DEF. If a module-definition file has already been created, change the file name.

•	Module-definition-statement "EXPORTS" of dynamic-link-library specifies the object file name. Use the editor to specify a correct statement.


[Project History] Menu List

Display a list of previously opened project files. Files selected from the history list are displayed in the [Project] window.

Up to four files are displayed. Updating the list deletes the least recently edited file


[Tools] Menu

The following lists the commands and utilities that appear on the [Tools] menu:

WINCOB [Compile]

WINLINK [Link]

WINSVD [Debug]

WINEXEC [Execute]

COBFUT32 [File Utility]

Customize Menus


[WINCOB [Compile] ] Utility Command

Activate the Windows COBOL85 Compiler (WINCOB).

Keyboard

WINCOB Keys

Operation

[WINCOB] Window

Compiler Options

[Compiler Options] Dialog Box

Compiler Options


[WINLINK [Link] ] Utility Command

Activate the Windows Linker (WINLINK).

Operations

[Linking Files] Window

[Building COBOL Libraries] Window


[WINSVD [Debug] ] Utility Command

Activate the COBOL85 Interactive Debugger (WINSVD).

WINSVD Help


[WINEXEC [Execute] ] Utility Command

Activate WINEXEC.

Operations

WINEXEC Window

Using the WINEXEC Window

Related Item

Runtime Environment Setup Window Help


[COBFUT32 [File Utility] ] Utility Command

Activate the COBOL85 File Utility (COBFUT32).

COBFUT32 Help


[Customize Menus] Menu Command

Specify the application to be registered on the PROGRAMMING-STAFF [Tools] menu in the [Customize Menus] dialog box.

Once the registered application program has been added to the [Tools] menu, it can be activated from there.

Related Items

[Customize Menus] Dialog Box

[Command-Line] Dialog Box


[Customize Menus] Dialog Box

The following explains how to use the [Customize Menus] dialog box:

[Customize Menus] Dialog Box Operation

•	[Menu] List box:

Display a list of the menu names of application programs registered in the [Tools] menu.

•	[Add] Button:

Click this button to add information to the [Menus] list box. A menu name and a command line are set.

Related Item

[Command-Line] Dialog Box

•	[Change] Button:

Click this button to change information in the [Menus] list box. The menu name and command line are changed.

Related Items

[Command-Line] Dialog Box

•	[Delete] Button:

Click this button to Delete information from the [Menus] list box.

•	[OK] Button:

Accept the settings and close the dialog box.

The registered menu items are displayed on the pull-down [Tools] menu.

•	[Cancel] Button:

Ignore the settings and close the dialog box.

•	[Help] Button:

Displays Help.


[Command-Line] Dialog Box

•	[Command-Line] Edit box:

Enter the command line name for the application program to be registered.

•	[Browse] Button:

Select a file name to be entered in [Command Line] from the [Browse Files] dialog box.

•	[Macros] Button:

Select a macro name to be entered in [Command Line] from the [Macros] dialog box.

Related Item

[Macros] Dialog Box

•	[Menu Name] Edit box:

Enter the menu name of the application to be registered. The default name is command line name.

•	[OK] Button:

Accept the settings and close the dialog box.

The registered menu name is displayed on the [Menu Name] list box.

•	[Cancel] Button:

Ignore the settings and close the dialog box.

•	[Help] Button:

Displays Help.


[Macros] Dialog Box

Specify a macro name to be entered for the command line.

The following explains how to use the Macros dialog box:

Elements and Function of the Macros Dialog Box

•	[List] Combo box:

Specify a macro name to be inserted in the command line.

If $FILESELECT is specified, the [Browse Files] dialog box opens.

If $INPUT is specified, the [Command-Line Argument] dialog box opens.

•	[Explanation] List box:

Display an explanation of a macro specified in the [List] list box.

•	[OK] Button:

Accept the information and close the dialog box.

The specified macro name is inserted in the [Command-Line] edit box.

•	[Cancel] Button:

Ignore the selection and close the dialog box.

•	[Help] Button:

Displays Help.

Notes:

•	Only one macro name can be specified in the Command-Line edit box.

•	Only $FILESELECT and $INPUT can be specified as macro names.

•	To specify a dollar sign ($) that is not in a macro name, specify two consecutive dollar signs.

Related Item

[Command-Line Argument] Dialog Box


Using the [Command-Line Argument] Dialog Box
[Command-Line Argument] Dialog Box

The following explains how to use the [Command-Line Argument] dialog box.

Elements and Function of the [Command-Line Argument] Dialog Box

•	[Command-Line Argument] Edit box:

Specify a command name, and arguments and a file name to be passed to the command.

•	[Browse] Button:

Select this button to display the Browse Files dialog box to select files.

•	[OK] Button:

Accept the specified information and close the dialog box.

•	[Cancel] Button:

Ignore the specified information and close the dialog box.

•	[Help] Button:

Displays Help.


Compiler Options

The following is a list of the compiler options that can be specified:

AIMLIB

ALPHAL

BINARY

CHECK

CONF

COPY

CURRENCY

DLOAD

EQUALS

FILEEXT

FILELIB

FLAG

FLAGSW

FORMEXT

FORMLIB

GEN

LANGLVL

LIB

LINECOUNT

LINESIZE

MAIN

MESSAGE

MODE

NCW

NSPCOMP

NUMBER

OBJECT

OPTIMIZE

PRINT

QUOTE/APOST

RSV

SDS

SOURCE

SRF

SSIN

SSOUT

STD1

TAB

TEST

TRACE

TRUNC

ZWB

Related Items

[Compiler Options] Dialog Box

[Library Names] Dialog Box


AIMLIB

Specify the directory where a subschema-definition file is stored.

Specify multiple directory names when the storage files are placed under multiple directory.

Note: If the -A option is also specified, the priority is (1)-A option, (2) compiler option AIMLIB.

Procedure

When using compiler option AIMLIB, specify a destination directory in the [AIMLIB-Directory where the subschema-definition file exists] edit box.

Click the [Browse] button to list directory.


ALPHAL

Specify whether to process lowercase alphabetic user words in a source program as uppercase (ALPHAL) or not (NOALPHAL).


BINARY

Specify how to assign storage to binary data items and how to handle the leftmost bit of an unsigned binary item.

•	BINARY(WORD,MLBON):

Assign storage for binary data items to areas of two, four, or eight words long, calculated from the number of decimal digits used to define the items. The leftmost bit of an unsigned binary item is always handled as a sign.

•	BINARY(WORD,MLBOFF):

Assign storage for binary data items to areas of two, four, or eight words long, calculated from the number of decimal digits used to define the items. The leftmost bit of an unsigned binary item is always handle as part of the numeric value.

•	BINARY(BYTE):

Assign storage for binary data items to areas of one to eight words long, calculated from the number of decimal digits used to define the items. The leftmost bit of an unsigned binary item is always handled as part of the numeric value.


CHECK

Specify whether to use the check function (CHECK) or not (NOCHECK).The frequency for the message to be displayed is specified by an integer in the range 0 - 999999. The default value is 1.

Notes:

•	When using the compiler option "CHECK", processing continues until n messages have been issued. By the area destruction etc., the program may not work as expected. When 0 is specified for n, processing continues without regard to the number of messages issued.

•	If compiler option CHECK is used, extra processing code is incorporated into the object program, potentially degrading performance.

After debugging, specify NOCHECK and recompile the program.


COPY

Specify whether to copy (COPY) or not to copy (NOCOPY) the original library into the source program listing along with the COPY statement.

Note: COPY has meaning only when the compiler option SOURCE is also specified.


CONF

Specify whether to issue messages (CONF) or not to issue messages (NOCONF) concerning incompatibilities between the old and new COBOL standards.

Incompatible items are indicated by I-level diagnostic messages. The meaning of the messages are as follows:

•	CONF(68):

The item has a different meaning between '68 ANS COBOL and '85 ANS COBOL.

•	CONF(74):

The item has a different meaning between '74 ANS COBOL and '85 ANS COBOL.

•	CONF(OBS):

The language specification or function is obsolete.

Note: Compiler options CONF(68) and CONF(74) have meaning only when the compiler option LANGLVL(85) is also specified.

Purpose: Compiler option CONF can be used to change a program created according to an old standard to satisfy '85 ANS COBOL.


CURRENCY

CURRENCY specifies the character to be used as the currency sign.


DLOAD

Specify whether to dynamically load (DLOAD) or not dynamically load (NODLOAD) a subprogram specified by the CALL "literal" statement.


EQUALS

Specify whether to guarantee (EQUALS) or not (NOEQUALS) that record output order is the same as the input order when multiple records with the same key are found during execution of a SORT statement.

If NOEQUALS is specified, the output order of records with the same key is not predetermined.

Note: Specifying EQUALS can adversely affect performance because special processing is performed to guarantee the input order during sorting.


FILEEXT

Specify the extension of the file descriptor storage file. Any character string can be specified.

To specify that no extension be used, specify the character string NONE instead of an extension.

More than one extension cannot be specified at the same time.

•	Note: When this option is specified, the priority is (1)compiler option FILEEXT, (2)environment value FFD_SUFFIX, (3)default (FFD).


FILELIB

Specify the directory where the file descriptor storage file is stored.

Specify multiple directory names when the storage files are placed under multiple directory.

Notes:

•	If more than one directory is specified, they are searched in the order specified.

•	If the -f option is also specified, the priority is (1)-f option, (2)compiler option FILELIB, (3) environment value FILELIB, (4) current directory.

•	The full-path directory name can be up to 126 bytes.

Procedure

When using the compiler option "FILELIB", specify a directory name in the [file description directory name] edit box. Click the [Browse Files] button to list directory.


FLAG

Specify the level of diagnostic messages to be displayed by the compiler.

•	FLAG(I):

All diagnostic messages

•	FLAG(W):

W level or higher diagnostic messages

•	FLAG(E):

E level or higher diagnostic messages

Note: Although CONF outputs I-level messages, these are displayed irrespective of FLAG specification.


FLAGSW

Specify whether to display (FLAGSW) or not display (NOFLAGSW) messages concerning the level of the COBOL standard applying to elements in COBOL syntax. The flag specifications are as follows:

•	FLAGSW(STDM):

Indicate language elements not belonging to the low level of the COBOL standard.

•	FLAGSW(STDI):

Indicate language elements not belonging to the intermediate level of the COBOL standard.

•	FLAGSW(STDH):

Indicate language elements not belonging to the high level of the COBOL standard.

•	FLAGSW(RPW):

Indicate language elements in standard COBOL reports.

•	FLAGSW(SIA):

Indicate language elements not belonging to Fujitsu System Integrated Architecture (SIA).

Purpose: The compiler option FLAGSW (SIA) is useful for creating programs that run on other systems.


FORMEXT

Specify the extension for the screen or form descriptor storage file. An arbitrary character string can be specified.

Specify character string NONE instead of an extension if an extension is not to be added.

More than one extension cannot be specified at the same time.

Note: When this option is specified, the priority is (1)compiler option FORMEXT, (2)environment value SMED_SUFFIX, (3)default (PMD).


FORMLIB

When incorporating record definition statements from screen or form descriptor information using the COPY statement of IN/OF XMDLIB,

specify the directory containing the screen or form descriptor storage file.

Specify multiple directory names when the files used have been placed under multiple directory.

Notes:

•	If more than one directory is specified, they are searched in the order specified.

•	If the -m option is also specified, the search order is (1) -m option, (2) compiler option FORMLIB, (3) environment value FORMLIB, (4) current directory.

•	The full-path directory name can be up to 126 bytes.

Procedure

When using compiler option FORMLIB, specify a directory name in the [screen or form descriptor directory name] edit box. Click the [Browse] button to list the directory.


GEN

Specify whether to display (GEN) or not display (NOGEN) an AIM DBMS linkage area (FCOM) and an AIM expansion record area (UWA).


LANGLVL

Specify how to interpret items in the source program that have different meaning under the old and new COBOL standards:

•	LANGLVL(68):

Interpret the program according to '68 ANS COBOL.

•	LANGLVL(74):

Interpret the program according to '74 ANS COBOL.

•	LANGLVL(85):

Interpret the program according to '85 ANS COBOL.


LIB

Specify the directory where a library file is stored when the library function (COPY COBOL statement) is used.

Specify multiple directory names when the storage files are placed under multiple directory.

Notes:

•	If more than directory is specified, they are searched in the order specified.

•	If the -I option is also specified, the search order is the (1) -I option, (2) compiler option LIB, (3) current directory.

Procedure

When using compiler option LIB, specify a directory name in the [library directory name] edit box. Click the [Browse] button to list the directory.


LINECOUNT

Specify the number of lines per page used when generating the compilation list. The number is an integer up to three digits in length. The default value is 60.

Note: If a value in the range 0 to 12 is specified, lines are printed with no page feed.


LINESIZE

Specify the maximum number of alphanumeric characters per line displayed in the compilation list.

Specify 80 or a three digit integer of 120 or higher. The default value is 136.

Notes:

•	Some compilation lists are generated with a fixed number of characters regardless of the specification of compiler option LINESIZE.

•	The maximum allowable value is 136. If a greater value is specified, 136 is used.


MAIN

Specify whether the COBOL source program to be compiled is the main program (MAIN) or a subprogram (NOMAIN).

Note: Be sure to specify MAIN for the COBOL source program that is to be the main program.

      When compiling continuous programs or compiling from a project, use the [Main Program] button.


MESSAGE

Specify whether to generate (MESSAGE) or not generate (NOMESSAGE) an option information list and compilation statistics.


MODE

An ACCEPT statement may specify a numeric data item on the receiving side in format "ACCEPT identifier [FROM mnemonic name]."When executing this kind of ACCEPT statement, specify whether to right-justify the value as a numeric (MODE(STD)) or left-justify it as a character (MODE(CCVS)).

Note: When "MODE(CCVS)" is specified, only an external decimal item can be specified as a numeric item on the receive side of the ACCEPT statement.


NCW

Character set of Japanese user-defined word.

This option is applicable only in Japan.


NSPCOMP

NSPCOMP option decides treatment of national space in comparison to be used as national space or ANK space.

- NSPCOMP(NSP): If NSP set, national space treated as national space.

- NSPCOMP(ASP): If ASP set, national space treated as ANK space.


NUMBER

Specify whether to use values in the sequence number area of the source program (NUMBER) or values generated by the compiler (NONUMBER) as line numbers identifying each line in the source program.

When compiler option NUMBER is specified, line numbers in the number area that contain a non-numeric character or are not in ascending order have the value of the previous line with one added.

If compiler option NONUMBER is specified, line numbers start at 1 and are incremented by 1.

Notes:

•	When compiler option NUMBER is specified, the same line number may be repeated.

•	If compiler option NUMBER is specified, the message linkage function cannot be used.


OBJECT

Specify whether to generate (OBJECT) or not generate (NOOBJECT) an object program.

When an object program is generated, the file is usually created in the same directory as that of the source program. You can change the destination directory as required.

Procedure

When using compiler option OBJECT, specify a destination directory in the [object program directory] edit box.

Click the [Browse] button to list directory.


OPTIMIZE

Specify whether to create a globally optimized object program (OPTIMIZE) or not to create such an object program (NOOPTIMIZE).


PRINT

Specify whether to generate a compilation list. If a compilation list is generated, the file is usually created in the same directory as that of the source program.

You can change the destination directory as required.

Procedure

When using compiler option PRINT, specify a destination directory in the [compilation list directory] edit box. Click the [Browse] button to list directory.


QUOTE / APOST

Specify whether to handle the value of figurative constants QUOTE or QUOTES as quotation marks (QUOTE) or an apostrophe (APOST).

Note: Quotation marks in a source program can be either single or double regardless of the setting of this option,

but the same type must be used for the beginning and end mark.


RSV

The reserved word list determines which words are reserved for use by the compiler and which are available to be used as program data item name. Specify the type of reserved words used,according to the language specifications for which your application was coded, as follows:

•	RSV(ALL): Reserved words for COBOL85 V20 or later

•	RSV(V111): Reserved words for M-Series COBOL85 V11L11

•	RSV(V112): Reserved words for M-Series COBOL85 V11L20

•	RSV(V122): Reserved words for M-Series COBOL85 V12L20

•	RSV(V125): Reserved words for COBOL85 V12L50

•	RSV(VSR2): Reserved words for VS COBOLII REL 2.0

•	RSV(VSR3): Reserved words for VS COBOLII REL 3.0


SDS

Specify whether to transcribe the send side sign of a signed internal decimal item as is (SDS) or using the predetermined sign (NOSDS).

Plus signs have hexadecimal values from X'O' to X'F' except X'B' and X'D', which are treated as minus signs. The predetermined sign is X'C' for positive and X'D' for negative.


SOURCE

Specify whether to generate (SOURCE) or not generate (NOSOURCE) the source program list.

If SOURCE is selected, the list is output to the directory specified by compilation option PRINT or the -dp option.

Note: If neither the PRINT compiler option nor the -dp option is specified, the source program will not be generated regardless of the specification of this option.


SRF

Specify whether to use a fixed-length format (FIX) or a free- length format (FREE) or a variable- length format (VAR) for COBOL source programs and libraries.

Specify the program format first, then the library format.

Specify the formats as follows:

•	FIX,FIX: Fixed-length format for both source programs and libraries

•	FIX,VAR: Fixed-length format for source programs, variable- length format for libraries

•	FIX,FREE: Fixed-length format for source programs, free- length format for libraries

•	VAR,FIX: Variable-length format for source programs, fixed-length format for libraries

•	VAR,VAR: Variable-length format for both source programs and libraries

•	VAR,FREE: Variable-length format for source programs, free-length format for libraries

•	FREE,FIX: Free-length format for source programs, fixed-length format for libraries

•	FREE,VAR: Free-length format for source programs, variable-length format for libraries

•	FREE,FREE: Free-length format for both source programs and libraries


SSIN

Specify the input data source for the COBOL ACCEPT statement.

•	SSIN(execution-environment-information-name): Input data from a file. Set the file path name for the execution environment information name at execution.

•	SSIN(SYSIN): Input data from a console window.

Note: The execution environment information name must be a string of eight or fewer uppercase alphabetic and numeric characters starting with an uppercase alphabetic character (A to Z). The name must be different from those used for other files.


SSOUT

Specify the destination for data output by the COBOL DISPLAY statement.

•	SSOUT(execution-environment-information-name): Output data to a file. Set a file path for the execution environment information name at execution.

•	SSOUT(SYSOUT): Output data to a console window.

Note: The execution environment information name must be a string of eight or fewer uppercase alphabetic and numeric characters starting with an uppercase alphabetic character (A to Z). This name must not match an execution environment information name (file identifier) used for another file.


STD1

When EBCDIC is specified in ALPHABET clause, specify the collating sequence of alphanumeric code.

•	STD1(ASCII): If ASCII is specified, alphanumeric code is considered as ASCII code.

•	STD1(JIS1): If JIS1 is specified, alphanumeric code is considered as JIS8 code.

•	STD1(JIS2): If JIS2 is specified, alphanumeric code is considered as JIS7 code.


TAB

Specify whether to set a tab to four columns (TAB(4)) or eight columns (TAB(8)). The value of a tab is the tab character value itself.


TEST

Specify whether to use the interactive debugger at execution (TEST) or not to use the debugger (NOTEST).

When the debugger is used, the debug information file for the debugger is usually created in the same directory as that of the source program. You can change the destination directory as required.

Note: If the compiler option OPTIMIZE is also specified, your program will be compiled as NOOPTIMIZE even though the option will be displayed in the fixed compiler option as OPTIMIZE.

Procedure

When using compiler option TEST, specify a destination directory in the [debug information directory] edit box.

Click the [Browse] button to list directory.

After debugging, specify NOTEST and recompile the program.


TRACE

Specify whether to use the trace function (TRACE) or not to use the trace function (NOTRACE).

The frequency for the trace function to be displayed is specified by an integer in the range 0 - 999999. The default value is 200.

Note: When compiler option TRACE is used, trace information display processing is incorporated into the object program, potentially degrading the execution performance.

After debugging, specify NOTRACE and recompile the program.


TRUNC

Specify how to truncate high-order digits on the receiving side when moving a numeric to a binary item.

•	TRUNC:

The result value is stored on the receiving side after its high-order digits are truncated according to the PICTURE clause on the receiving side.

If compiler option OPTIMIZE is also specified, variables introduced from an external or internal decimal item by optimization are also truncated.

The truncation processing is executed only when the number of digits in the integer part on the sending side is greater than the number of digits on the receiving side.

•	NOTRUNC:

Priority is given to object program execution speed. If execution is faster without truncation processing, the object program is stored without values being truncated.

When using the NOTRUNC option, design the program so that values exceeding the PICTURE clause specification are not stored on the receiving side.

PICTURE clause description

•	Moving from S999VP (three figures in integer part) to S99V99 (two figures in integer part):

Truncate high-order digits.

•	Moving from SPV999 (zero figures in integer part) to S99V99 (two figures in integer part):

Will not truncate high-order digits.

Notes:

•	When using the TRUNC option, the value stored in an area depends on the hardware.

•	When using the NOTRUNC option, design the program so that values exceeding the PICTURE clause specification are not stored on the receiving side.

•	The compiler determines whether or not truncation is executed when the compiler option NOTRUNC is specified.

•	For this reason, a program suppressing truncation(NOTRUNC) may not be compatible with other systems.


ZWB

Specify whether to compare a signed external decimal item with an alphanumeric field by ignoring the sign (ZWB) or not (NOZWB).

Alphanumeric field here means an alphanumeric or alphabetic item, alphanumeric or numeric edited item, nonnumeric literal, or figurative constant except zero.

Example:

77  ED  PIC  S9(3)  VALUE  +123.

77  AN  PIC   X(3)  VALUE  "123".

ED = AN is true or false as follows:

•	When the compiler option ZWB is specified: True

•	When the compiler option NOZWB is specified: False


WINCOB Help Index
WINCOB Help Contents

Displayed below are the help topics related to WINCOB.

Keyboard

WINCOB Keys

Operation

[WINCOB] Window

[WINCOB] Window(Continuous Compilation)

Compiler Options

[Compiler Options] Dialog Box

Compiler Options

Note: Do not write-protect the source file or source file directory.


WINCOB Keys

The following keys can be used in WINCOB:

Key combination Function

Alt + F4          Close the active window.


[WINCOB] Window

The following explains how to compile a program using the [WINCOB] window:

Compilation Procedure

1	Activating the [WINCOB] Window

To display the [WINCOB] window, execute the WINCOB command using one of the following methods:

•	Select [WINCOB [Compilation] ] from the PROGRAMMING-STAFF [Tools] menu.

•	Start "WINCOB.EXE".

2	Specifying the COBOL source program to be compiled

Specify the name of a source file to be compiled in the [Source File Name] edit box in the [WINCOB] window.

Related items

Using the [WINCOB] Window

[WINCOB] Window (Continuous Compilation)

3	Setting compiler options

The COBOL compiler must be given compiler options to tailor the compilation process to your needs.

In addition, some functions (nucleus, file, sort and merge, and source text manipulation) in the COBOL source program require specification of a compiler option. Select Option from the [WINCOB] window menu bar and specify compiler options in the [Compiler Options] dialog box.

Note: Compiler options can be set only when a COBOL source file has been specified. Be sure to specify a COBOL source file before setting compiler options.

Related item

[Compiler Options] Dialog Box

Compiler Options

4	Setting library-names

If the COBOL source program contains a COPY statement specifying a library-name, the library-name must be associated with the directory containing it.

Click the [Library Names] button in the [Compiler Options] dialog box and type a library-name in the [Library Names] dialog box.

Related item

[Library Names] Dialog Box

5	Starting compilation

After setting the required information, start compilation by clicking the [OK] or [Compile] button in the [WINCOB] window.

When compilation starts, the compilation progress screen is displayed.

6	Correcting compilation errors

When compilation ends, the PROGRAMMING-STAFF editor displays a compilation message.

If compilation errors were detected, correct the program using the message linkage function and compile the program again.

Related item

[Tag Jump] Menu

7	Terminating compilation

To continue compilation, repeat the procedure from step 2. To terminate compilation, click the [Cancel] button from the [WINCOB] window.


[Compiler Options] Dialog Box

The following explains how to use the [Compiler Options] dialog box:

To add a compiler option:

•	Click the [Add] button.

•	Select the compiler option to be added from the list box in the [Compiler Options] dialog box.

•	Click the [Add] button.

•	Specify the option in the [Compiler Options] dialog box.

Related item

[Add Compiler Options] Dialog Box

To change a compiler option:

•	Select the compiler option to be changed in the [Compiler Options] list box.

•	Click the [Change] button.

•	Change the setting in the [Set Compiler Options] dialog box.

To delete a compiler option:

•	Select the compiler option to be deleted in the [Compiler Options] list box.

•	Click the [Delete] button.

To set a library-name:

•	Click the [Library Name] button.

•	Specify the library-name in the [Library Names] dialog box.

Related items

[Library Names] Dialog Box

To set other compiler options:

•	Set other compiler options in the [Other Compiler Options] edit box.

To process the information:

•	Select the [OK] button in the [Compiler Options] dialog box.

To ignore the information:

•	Select the [Cancel] button in the [Compiler Options] dialog box.

Notes:

•	DEFAULT.CBI, in the same directory as the COBOL source file, is searched for compiler options.

In the [WINCOB] window, however, only the same compiler option can be specified in a file under the same directory.

To specify a different compiler option, place a compiler directive statement in the COBOL source program.

•	Project-name.CBI, in the same directory as the project file is searched for compiler options, when Project Manegement Function is used.

To specify a different compiler option for a COBOL source program stored in a project, place a compiler directing statement in the

COBOL source program.

•	Compiler options can only be set in WINCOB if a COBOL source file has been specified of in the [WINCOB] window.

•	Compiler options can only be set from the PROGRAMMING-STAFF editor when a source file has been given a name (via Save-As).

Related item

Compiler Options


[Library Names] Dialog Box

To add a specified library-name:

•	Click the [Add] button.

•	Specify the [Library Name] and [Directory] edit boxes in the [Add Library Name] dialog box.

•	Click the [OK] button.

Related item

[Add Library Name] Dialog Box

To change the storage directory of a specified library-name:

•	Select the library-name to be changed from the [Library Names] list box.

•	Click the [Change] button.

•	Change the setting in the [Change Library's Directory] dialog box.

Related Item

[Modify Library's Directory] Dialog Box

To delete a specified library-name:

•	Select the library-name to be deleted from the [Library Names] list box.

•	Click the [Delete] button.

Note: To browse for directory, click the [Browse] button in the [Add Library Name] dialog box. The [Browse Directory] dialog box opens.

Only one directory can be specified. The [Directory] edit box displays the directory specified in the dialog box.


[WINCOB] Window (Continuous Compilation)

The following explains how to compile multiple files using the WINCOB window:

Continuous Compilation Procedure

1	Activating the [WINCOB] window

Activate the [WINCOB] window the same way as for compiling a single source file.

2	Specifying continuous compilation

Select [Continuous Compilation] menu command from [Mode] on the menu bar of the [WINCOB] window to display the Continuous Compilation window.

Related Item

Using the [WINCOB] Window

3	Specifying source files to be compiled

Specify the name of a source file in the [Source File] edit box and click the [Add] button.

The [List] list box displays the specified files.

4	Specifying compiler options and library-names

After selecting source files from the [List] list box, specify the required compiler options and library-names.

Use the same methods as those for compilation of a single source file. Specify the main program in step 5.

Notes:

•	Compiler options can be set only when a source file has been specified. Be sure to specify a source file before setting compiler options.

•	DEFAULT.CBI, in the same directory as the selected file, is searched for compiler options. In the [WINCOB] window, the same compiler options apply to all files in the same directory. To set a different compiler option, place a compiler directive statement in the COBOL source program.

Related Items

[Compiler Options] Dialog Box

[Library Names] Dialog Box

5	Specifying the main program

Select file name of the main program from the [List] list box, and click the [Main] button.

The icon of the specified file turns red.

To cancel specification of the main program, select the file name and click the [Sub] button.

Note: This specification overrides compiler option MAIN specification in the [Compiler Options] dialog box.

The order of precedence of compiler option MAIN is as follows:

•	Specification by a compiler directive statement in the COBOL source

•	Specification by the [Main] button

•	Specification in the [Compiler Options] dialog box

6	Starting continuous compilation

After setting the required information, click the [OK] or [Compile] button in the [WINCOB] window to start compilation.

The specified files are compiled one after another. Even when a compilation error is detected in a program, compilation continues until the last program is compiled.

7	Correcting compilation errors

When compilation ends, the PROGRAMMING-STAFF editor displays a compilation message.

If compilation errors are detected, correct the program using the error search function, then recompile the program.

Related Item

[Tag Jump] Menu

8	Terminating continuous compilation

To continue compilation, repeat the procedure from step 3. To terminate compilation, click the [Cancel] button in the [WINCOB] window.


Using the [WINCOB] Window

The following explains how to use the [WINCOB] window:

Elements and Function of the [WINCOB] Window

•	[Source File] Edit Box:

Specify the name of the file containing the source program to be compiled.

Select the file from the [Browse Files] dialog box or type the name directly in the [Source File] edit box.

•	[Browse] Button:

Displays the [Browse Files] dialog box. More than one file can be selected. The [File Name] edit box displays the selected file.

•	[OK] Button:

Start compilation and close the window.

•	[Cancel] Button:

Close the window. Do not perform compilation.

•	[Options] Button:

Displays the [Compiler Options] dialog box to set compiler options.

Related Items

[Compiler Options] Dialog Box

Compiler Options

•	[Compile] Button:

Click to start compilation after a file name and compiler options have been specified.

•	[Mode] Menu Bar:

Select standard or continuous compilation.

Related Item

[WINCOB] Window (Continuos Compilation)

•	[Help] Menu Bar:

Displays Help.

If continuous compilation is selected from [Mode] on the menu bar, the following items are added to the [WINCOB] window:

•	[List] List Box:

Display a list of files for continuous compilation.

To specify a file, select the file from the [Browse Files] dialog box or type the file name directly in the [File Name] edit box.

Next, click the [Add] button, or press the Enter key to add the file.

•	[Add] Button:

Add the file name displayed in the [File Names] edit box to the [List] list box.

•	[Delete] Button:

Delete the selected file name from the [List] list box.

•	[Main] Button:

Specify a file selected the [List] list box as the main program. The icon of the specified file turns red.

•	[Sub] Button:

Specify a file selected from the [List] list box as a subprogram.


[Add Compiler Option] Dialog Box

The following explains how to use the [Add Compiler Option] dialog box:

Elements and Function of the [Add Compiler Option] Dialog Box

•	[Compiler Options] List Box:

Displays a list of the compiler options that have not yet been selected. After selecting an option click the [Add] button or double-click the option be added to display the dialog box setting the selected compiler option.

•	[Add] Button:

Display the dialog box to set compiler options in the [Compiler Options] List Box.

•	[Cancel] Button:

Close the dialog box.

•	[Help] Button:

Displays Help.


[Add Library Name] Dialog Box

The following explains how to use the [Add Library Name] dialog box:

Elements and Function of the [Add Library Name] Dialog Box

•	[Library Name] Edit Box:

Specify a library name to be added. Specify a library name of COPY statement described to the COBOL source program.

•	[Directory] Edit Box:

Specify the directory related to the library name.

•	[Browse] Button:

Display the [Browse Directory] dialog box. The directory specified in the dialog box is displayed in the [Directory] edit box.

•	[OK] Button:

Accept the settings and close the dialog box.

•	[Cancel] Button:

Ignore the settings and close the dialog box.

•	[Help] Button:

Displays Help.


[Modify Library's Directory] Dialog Box
[Modify Library’s Directory] Dialog Box

The following explains how to use the [Modify Library's Directory] dialog box:

Elements and Function of the [Modify Library's Directory] Dialog Box

•	[Library Name] Text area:

A library name must be displayed to modify its directory.

•	[Directory] Edit box:

Specify the directory related to the library name.

•	[Browse] Button:

Displays the [Browse Directory] dialog box. The directory specified in the dialog box is displayed in the [Directory] edit box.

•	[OK] Button:

Accept the settings and close the dialog box.

•	[Cancel] Button:

Ignore the settings and close the dialog box.

•	[Help] Button:

Displays Help.


WINLINK Help Contents

Listed below are help topics related to WINLINK.

Commands can be selected in the WINLINK [Linking Files] and WINLINK [Building COBOL Libraries] windows from the [Commands] pull-down menu on the menu bar of each window.

Operation

WINLINK [Linking Files] Window

Using the WINLINK [Linking Files] Window

WINLINK [Building COBOL Libraries] Window

Using the WINLINK [Building COBOL Libraries] Window


WINLINK [Linking Files] Window

The following explains how to use the WINLINK [Linking Files] window and how to use the accelerator keys:

Linking Procedure

1	Activating the WINLINK [Linking Files] window

To display the WINLINK [Linking Files] window, execute the WINLINK command using one of the following methods:

•	Select WINLINK from the PROGRAMMING-STAFF [Tools] menu.

•	Start "WINLINK.EXE".

Note:

To call the WINLINK [Linking Files] window from the WINLINK [Building COBOL Libraries] window, select [Commands] on the menu bar and click [Linking Files] on the pull-down menu.

Related Item

Using the WINLINK [Linking Files] Window

2	Specifying the target

Use the [Target] radio button to select the type of file to be specified in the [File Names] edit box.

3	Specifying files required for linkage

•	Select a file to be linked from the [Browse Files] dialog box, or type a file name in the [File Names] edit box.

•	After specifying a file name, press the Enter key or click the [Add] button to display the file name in the [List] list box.

•	The first specified object file name whose extension is changed to EXE or DLL is set automatically in uppercase in the [Target] edit box.

•	Libraries can also be created in the WINLINK [Building COBOL Libraries] window.

Note:

•	If a module-definition file is not specified, the module-definition file target-name.DEF is used. If it does not exist, it is created.

•	The module-definition statement EXPORTS for a dynamic link library (DLL) specifies an object file name. The statement must be specified using the editor.

•	To change the target name, type a new name in the [Target] edit box and press the Enter key.

•	File names containing a blank cannot be specified as a target name.

Related Items

Create Module-Definition Files

Using the WINLINK [Linking Files] Window

WINLINK [Building COBOL Libraries] Window

4	Setting linker options

Click the [Options] button in the WINLINK [Linking Files] window and specify a linker option in the [Linker Options] dialog box.

Related Item

Using the [Linker Options] Dialog Box

5	Starting linkage

After setting the information required for linkage, click the [Link] button in the WINLINK [Linking Files] window to start the linker.

Note:

•	When creating a dynamic link library (DLL), create an export library file (target name.EXP) and an import library file (target name.LIB) at the same time. Note that files with the same name are replaced.

6	Terminating the linker

When linking ends, a message Is displayed.

To continue link processing, repeat the procedure from step 2.

To terminate the processing, click the [Cancel] button.

Note: For Windows(R) 95, there is no notice of a linker error. Confirm error by the message.

Accelerator keys

Alt + F4          Close the active window.


Using the WINLINK [Linking Files] Window

The following explains how to use the WINLINK [Linking Files] window:

Elements and Function of the WINLINK [Linking Files] Window

•	[Target] edit box:

Specify the name of a file to be created by the linker.

•	[Type] Radio button:

Select the type (extension) of the file specified in the [Target] edit box.

•	[Link File] Edit box:

Specify a file name to be added to the [List] list box.

•	[List] List box:

Display the names of files to be linked.

•	[Browse] Button:

Displays the [Browse Files] dialog box. More than one file can be selected.

The file types that can be selected are *.OBJ (object file) and *.LIB (library file). The File Names edit box displays the selected files.

•	[Add] Button:

Add the file name specified in the [Link File] edit box to the [List] list box.

Note: When a dynamic link library (DLL) is created, there is no need to add a file because an export library file (target-name.EXP) is automatically created.

•	[Delete] Button:

Delete the selected file name from the [List] list box.

Note: If an object file with the same name as the target name is deleted (when two or more file names are registered in the [List] list box), the target name is automatically changed.

•	[OK] Button:

Start the linker and close the window.

•	[Cancel] Button:

Close the WINLINK [Linking Files] window without performing any processing.

•	[Options] Button:

Displays the [Linker Options] dialog box to set linker options.

Related Item

Using the [Linker Options] Dialog Box

•	[Link] Button:

Click to start linking files after their file names have been specified.

Note: For Windows(R) 95, there is no notice of a linker error. Confirm error by the message.

•	[Commands] Menu bar:

Open the pull-down menu to select the WINLINK [Linking Files] or WINLINK [Building COBOL Libraries] window.

Related Item

WINLINK [Building COBOL Libraries] Window

•	[Help] Menu bar:

Displays help.


Using the [Linker Options] Dialog Box

The following explains how to use the Linker Options dialog box:

Elements and Function of the [Linker Options] Dialog Box

•	[Linker Options] Edit box:

Specify a linker option.

•	[Debug] Button:

Specify a debug option. The option is displayed in the [Options] edit box.

•	[OK] Button:

Accept the specified linker option and close the dialog box.

•	[Cancel] Button:

Close the dialog box, discarding specified linker option information.

•	[Help] Button

Displays Help.


WINLINK [Building COBOL Libraries] Window

The following explains how to use the WINLINK [Building COBOL Libraries] window and the accelerator keys to create a library:

Library Creation Procedure

1	Displaying the WINLINK [Building COBOL Libraries] window

Execute WINLINK and select [Commands] from the menu bar.

Select [Build COBOL Library] from the displayed pull-down menu to display the WINLINK [Building COBOL Libraries] window.

2	Specifying the files required to build a COBOL library

Specify the object files to be linked.

Specify a file name in the [Object File] edit box and click the [Add] button. The object file is displayed in the [List] list box.

The first specified object file whose extension is changed to LIB is set automatically in uppercase in the [COBOL Library file] Edit box.

Notes:

•	To change the library-name, type a new name in the [COBOL Library file] Edit box and press the Enter key.

•	Do not specify an object file with compiler option MAIN.

•	A file name containing a blank cannot be specified as a library-name.

Related Item

Using the WINLINK [Building COBOL Libraries] Window

3	Starting a command

After setting the required information, click the [OK] or the [Build] button to start building the library.

When building starts, the console window opens.

Notes:

•	If an existing library-name is specified, the file is deleted and a new file is created.

•	For Windows(R) 95, there is no notice of linker error. Confirm error by the message.

4	Terminating the command

When building ends, the console window displays a message reporting that the library has been built.

To continue building libraries, repeat the procedure from step 2.

To terminate the processing, select the [Cancel] button in the WINLINK [Building COBOL Libraries] window.

Accelerator key

Alt + F4          Close the active window.


Using the WINLINK [Building COBOL Libraries] Window

The following explains how to use the WINLINK [Building COBOL Libraries] window:

Elements and Function of the WINLINK [Building COBOL Libraries] Window

[COBOL Library file] Edit box:

Specify the name of the library to be created.

[Browse] Button:

Displays the [Browse Files] dialog box. More than one file can be selected.

The only file type that can be selected file is *.LIB (library file). The [Library File] edit box displays the selected files.

[File] Edit box:

Type the name of a file to be registered in the [List] list box.

[Browse] Button:

Displays the [Browse Files] dialog box. More than one file can be selected.

The file types that can be selected are *.OBJ (object files) and *.LIB (library files). The [Object File] edit box displays the selected files.

[List] List box:

Displays the object files to be linked.

[Add] Button:

Add the file name specified in the [Object File] edit box to the [List] list box.

[Delete] Button:

Delete the selected file name from the [List] list box.

Note:

If an object file with the same name as the COBOL Library File is deleted, when two or more file have been registered in the [List] list box, the library name is changed automatically.

[OK] Button:

Start building a library and close the window.

[Cancel] Button:

Close the WINLINK [Building COBOL Libraries] window.

[Build] Button:

After specifying files, click this button to build a library.

Note: For Windows(R) 95, there is no notice of a linker error. Confirm error by the message.

[Commands] Menu bar:

Open the pull-down menu for selecting the WINLINK [Linking Files] window or the WINLINK [Building COBOL Libraries] window.

Related Item

WINLINK [Linking Files] Window

[Help] Menu bar:

Displays Help.


WINEXEC Help Contents

Listed below are the help topics related to WINEXEC.

Operation

[WINEXEC] Window

Using the [WINEXEC] Window

Related Item

Runtime Environment Setup Window Help


[WINEXEC] Window

The following explains how to use the [WINEXEC] window and accelerator keys:

Application Execution Procedure

1	Activating the [WINEXEC] Window

To display the [WINEXEC] window, execute the WINEXEC command using one of the following methods:

•	Select [WINEXEC] from the PROGRAMMING-STAFF [Tools] menu.

•	Start "WINEXEC.EXE".

Related Item

Using the [WINEXEC] Window

2	Specifying the file to be executed

Specify the name of the file to be executed in the [Command Line] edit box.

3	Specifying arguments

Type any required arguments in the [Command Line] edit box in command line format.

4	Starting execution

After setting the required information, click the [OK] or the [Execute] button to start program execution.

5	Setting runtime environment information

When a COBOL program is executed, the [Runtime Environment Setup] window may be displayed. If necessary, set runtime environment information and close the window.

6	Re-executing a program

The [List] list box displays programs that have been executed from the [WINEXEC] window. To re-execute a program, double-click its name in the list box.

7	Terminating execution

To terminate execution of a program, click the [Cancel] button in the [WINEXEC] window.

Accelerator Key

Alt + F4          Close the active window.

Related Item

Runtime Environment Setup Window Help


Using the [WINEXEC] Window

The following explains how to use the [WINEXEC] window:

Elements and Function of the [WINEXEC] Window

•	[Command Line] Edit box:

Specify an executable file.

•	[List] List box:

Display a list of files that have been executed.

Note: The [List] list box displays up to ten files. If eleven or more files are listed, the oldest is replaced by the name of the program executed next.

•	[Browse] Button:

Display the [Browse Files] dialog box. The file types that can be selected are *.EXE, *.COM, *.PIF, and *.BAT (program files).

The Command Line edit box displays the selected file.

•	[Delete] Button:

Delete the selected file name from the [List] list box.

•	[OK] Button:

Start execution and close the window.

•	[Cancel] Button:

Close the [WINEXEC] window without executing a program.

•	[Execute] Button:

Click the button to start execution after selecting and executable file.

•	[Help] Menu bar:

Displays Help.

Related Item

Runtime Environment Setup Window Help


[Window] Menu

The following lists the commands and items that appear on the [Window] menu:

Project Window

Cascade

Tile

Arrange Icons

Close All

Display Windows


[Project Window] Menu Command

Activate the [project] window. This item can be used only when a project is open.


[Cascade] Menu Command

Display the PROGRAMMING-STAFF editor and message windows currently open in the [PROGRAMMING-STAFF] window, arranged in a cascade.


[Tile] Menu Command

Display the PROGRAMMING-STAFF editor and message windows currently open in the [PROGRAMMING-STAFF] window, arranged as tiles.


[Arrange Icons] Menu Command

Align and space icons in the [PROGRAMMING-STAFF] window.


[Close All] Menu Command

Close all PROGRAMMING-STAFF editor and message windows currently open in the [PROGRAMMING-STAFF] window.


[Display Windows] Menu List

Display a list of windows currently open in the [PROGRAMMING-STAFF] window. A window selected from the list becomes the active window.

If ten or more windows are open, nine windows are listed and the [More Windows...] menu command is added at the tenth position. The tenth and subsequent windows can be selected from the list box in the [Select Window] dialog box.