PreviousIntroduction COBOL Source InformationNext

Chapter 2: Development Environment Menu System

The Server Express Integrated Development Environment (SDE) enables you to access Server Express components directly from a hierarchical menu system.

2.1 Introduction

This chapter describes the SDE menu system. It gives you an overview of each menu. The menus and the options on them are described in detail in the sections SDE Main Menu and SDE Alternate Menu later in this chapter.

You can invoke Server Express components from the command line as described in the individual chapters for the components in this book. Where appropriate, the following sections refer you to the relevant chapter for details of how to do this.

You can use the SDE menu system to:

2.2 The SDE Menu System

The SDE main menu has an Alternate menu. Some of the SDE's submenus have Alternate and Control menus. You display the Alternate or Control menus by pressing the Alt or Ctrl keys, repectively. These keys are toggle keys. To return to the main menu, toggle off the respective Alt or Ctrl key. See the appendix UNIX Key Usage Chart for further information on the Alt and Ctrl keys.

2.2.1 Exiting from Submenus

You can exit from menus and submenus using the Escape key. Escape exits the SDE menu system and returns you to the operating system prompt. From submenus, Escape exits that menu and returns you to the previous menu in the hierarchy.

2.2.2 Main Menu

Each component on the main menu, with the exception of Help, Alt, and Escape, has its own menu containing options relating to that component. The following components are available from the main menu:

Component
Accessed Using
Editor F2
Compiler syntax-check phase F3
Animator F4
Run F5
Compiler generate phase F6
Callable shared object creation F7
Link F8
Dialog System F9
UNIX Session Recorder F10

2.2.3 Alternate Menu

To access the Alternate menu, press the Alt key on the main menu. The SDE Alternate menu hierarchy provides access to other components of Server Express. Each component on this menu, with the exception of F1=help, has its own menu containing options relating to that component. The following components are available from the Alternate menu:

Component
Accessed Using
Configuration utilities F2
Operating system command F3
Data File Editor F4
Profiler F5
Directory F6

2.3 Invoking the Server Express Development Environment

When you install Server Express, your Getting Started instructs you to set certain environment variables, for example, COBDIR and PATH. You might also need to alter the TERM environment variable depending on the terminal emulation you require.

Additionally, if the -N run-time switch is enabled when you invoke Server Express, you will not be able to access the help facility. See the chapter Descriptions of Run-time Switches in your Server Express User's Guide for further information on the -N run-time switch.

To invoke Server Express, enter:

sde

The screen displays a banner containing details of Server Express, and the relevant copyright notices. The SDE main menu is displayed at the bottom of the banner screen as follows:



Figure 2-1: SDE Main Menu

To access the components, you press the key on the main menu which corresponds to the component you require. You can also access components from the Alternate menu. To do this, you press the Alt key, which invokes the Alternate menu, and press the key for the function you require. To return to the main menu, press the Alt key again.

The following sections describe the options on the menus and submenus available to you within SDE menu system.

2.4 SDE Main Menu

The components of the SDE main menu are described in the following sections.


Note: Throughout this chapter, references to pressing keys such as function or status keys imply the logical pressing and releasing of these keys rather than the physical keystrokes. Some keys are symbolic key names that might not be present on your keyboard. See the appendix UNIX Key Usage Chart for information on the actual keystrokes required to achieve the documented function.


2.4.1 Help Information

Pressing F1=help on any menu in the SDE displays help information for the menu you are using.

2.4.2 Editing a Program

Pressing F2=edit on the SDE main menu invokes the COBOL Editor. The COBOL Editor menu is displayed as shown in Figure 2-2.



Figure 2-2: COBOL Editor Menu

You can now use the COBOL Editor either to create a new program, or to load and edit an existing one. Full information on all options available to you from the Editor menu can be found in the chapter Editor .

2.4.3 Syntax-checking a Program

Pressing F3=compile on the SDE main menu invokes the Compiler to syntax-check your program and generate intermediate code ready for animating. The Compiler displays the Compile menu shown in Figure 2-3.



Figure 2-3: Syntax-check Menu

To syntax-check a program, first decide which options and directives on this menu you want to set or unset. The options on the Compile menu enable you to:

Changing the settings of these options alters the way in which your program is compiled. When you change the settings on this menu, the settings defined within the COBOPT environment variable are overwritten. See the descriptions of the individual options on this menu in the following sections for their default settings.

You can set directives for the Compiler in various ways. The method used to specify the directives determines the precedence - when a directive is processed, it overrides any previous settings of that directive. Directives are processed in the following sequence:

  1. Directives from the directives file cobol.dir

  2. Directives set or unset by using F6=lang

  3. Directives set or unset by using F9/F10=opt

  4. Directives from initial $SET statements in the program source code

See the chapter Using the Compiler in your Server Express User's Guide for information on the use of cobol.dir and $SET.

When you have set or unset the options and directives you want to use to compile your program, you then either press Enter to compile the .cbl program name displayed at the file prompt, or overtype this name with the name of the program you want to compile and press Enter. In either case, you can specify a pathname with the program name. If you specify a pathname, any output files, including the .idy file , are placed in the directory indicated by that path. When compilation has finished, you are returned to the SDE main menu.

If you recompile a program for which you have previously generated native code, the existing .gnt file for that program is deleted unless the compilation is unsuccessful.

See the chapters Creating Programs, Using the Compiler and Directives for Compiler in your Server Express User's Guide for further information on the Compiler and the directives available.

The options available to you on the Compile menu are described in the following sections.

2.4.3.1 F2=dir

F2=dir on the Compile menu enables you to invoke the Directory Facility. A list of COBOL source files in the current directory is displayed, that is, those which have an extension of .cbl or .CBL. You can select one of these files, causing its name to appear at the file prompt. If you then press Enter, that file is compiled. For further information on how to select a file using the Directory Facility, see the section Working With Files and Directories later in this chapter.

2.4.3.2 F3=pause

F3=pause on the Compile menu is a toggle which sets or unsets the ERRQ Compiler directive . When set, the word "Pause" appears on the status line. Setting this directive causes the Compiler to pause if it finds an error or any code which causes a warning message to be output. If the Compiler finds an error, an error message is displayed together with the prompt:

CONTINUE COMPILING PROGRAM ?  Yes/No/Zoom

Responding with Y(es) continues compilation until the Compiler finds any other error, when the Compiler will again pause and display the error with the continuation prompt.

Responding with N(o) stops the compilation and invokes the COBOL Editor. The Editor highlights the first error you encountered. You can now correct the error. This feature works only when you invoke the Compiler from the SDE menu system.

Responding with Z(oom) continues the compilation until the end of the program without pausing. A list of any errors found in this compilation is output either to the screen or to a listings file (see the section F4=lst for further details). When the compilation finishes, the Compiler automatically invokes the Editor, positioning the cursor at the first error so that you can correct it. This works only from the SDE menu system.

In each case, you can recompile your program either by pressing F3=compile on the SDE main menu, or by pressing F2=COBOL on the Editor menu. The name of your program is already displayed at the Compile menu File prompt, so you just press Enter to recompile your program.

By default, the ERRQ directive is set.

2.4.3.3 F4=lst

F4=list on the Compile menu is a toggle which enables you to produce a Compiler listing, and select the device on which you want to produce it.

The options available to you from this toggle are: Nolist (which suppresses the listing), List-Con (which displays the listing on the console), or List-File (which writes the listing to a file with the basename of the file you are compiling, plus a .lst extension).

Pressing F4 repeatedly enables you to cycle through these options. The option you select is displayed on the status line. The default is Nolist.

For further information on these options, see the chapter Directives for Compiler in your Server Express User's Guide.

2.4.3.4 F6=lang

F6=lang on the Compile menu is a toggle which enables you to set or unset COBOL language dialect directives. Setting these directives enables Server Express to compile any code in your program that you might have incorporated from other COBOL languages.

The COBOL language dialect directives that you can set using this toggle are:

XOPEN
OSVS
ANS85
VSC2(1)
VSC2(2)
VSC2(3)
VSC2(4)

or none of these if you decide you do not want to set a language dialect directive. Pressing F6 repeatedly enables you to cycle through these options. The directive you set is displayed on the status line. The default is XOPEN.

When a dialect directive is selected from the list above, the other directives from the list are explicitly unset.

See your Language Reference for further details of COBOL language dialects.

2.4.3.5 F7=xref

F7=xref on the Compile menu is a toggle which enables the Compiler to produce a cross-reference listing. If you toggle xref on, then "Xref" is displayed on the status line. The default is that no cross-reference listing is produced.

Note that this option takes effect only if you do not suppress the listing. See the section F4=lst for further information on suppressing a listing.

2.4.3.6 F9/F10=opt

F10 displays the Set-More-Directives menu for entering additional Compiler directives (see Figure 2-4).



Figure 2-4: Set-More-Directives Menu

F9 toggles to enable or disable the additional directives entered using the Set-More-Directives menu. When F9 is toggled on, the indicator "Opt-on" is displayed on the information line, and the selected directives are enabled. When F9 is toggled off, the indicator "Opt-on" is not displayed, and the directives are disabled.

When you start the Compiler, it uses the directives specified in this menu as long as the "Opt-on" indicator is shown. A parameter to a directive must be enclosed either within double quotation marks (" ") or parentheses. It cannot be preceded by an equals sign ( = ). Information on specifying Compiler directives is contained in the chapter Creating Programs in your Server Express User's Guide.

If you want to specify more directives than can fit on the prompt line, you should end your list of directives with an ampersand (&), which you separate from the final directive by one space. This causes the Compiler to pause at the beginning of the compilation and prompt you to enter further directives.

When you have specified the directives, press Enter to accept them and return to the Compile menu. You can repeatedly enable and disable these directives once they have been accepted by pressing F9 on the Compile menu.

Pressing Escape on the Set-More-Directives menu either before the directives have been accepted, or without specifying any directives returns you to the Compile menu without setting any directives.

When you use the Compiler within the SDE, all of the options and directives set in the COBOPT environment variable are supplied to the Compiler, followed by those directives set from these menus.

For further information on available Compiler directives, see the chapter Directives for Compiler in your Server Express User's Guide.

2.4.4 Animating a Program

Pressing F4=animate on the SDE main menu displays an interface menu for Animator.



Figure 2-5: Animate Menu

To use Animator to debug a program, you must first compile the program (see the section Syntax-checking a Program earlier in this chapter for details). You then decide which Animator options and directives you want to set or unset using this interface menu.

The options on the Animate menu enable you to set run-time switches, zoom through your program, and set further Animator directives. Changing the settings of these options alters the way in which your program is debugged.

Alternatively, you can use the defaults for these options and directives. See the individual descriptions of the options on this menu in the following sections for their default settings.

When you have set or unset the options and directives you want to use to debug your program, you then either press Enter to debug the .int program name displayed at the file prompt, or overtype this name with the name of the program you want to debug before pressing Enter. In either case, you can specify a pathname with the program name. If you do specify a path, Animator will expect its files to be located in the directory indicated by the path.

Once animation begins, the screen displays your program with the first executable statement highlighted. The Animate interface menu changes to the Animate menu. When you have finished debugging you are returned to the SDE main menu.

See your Debugging Handbook for full details of the Animator and the Animate menu.

The options on the Animate interface menu are described in the following sections.

2.4.4.1 F2=dir

F2=dir on the Animate interface menu enables you to access the Directory Facility, which displays all of the .int or .gnt files in the current directory. For further information on this option, see the section Working With Files and Directories later in this chapter.

2.4.4.2 F3=switches

F3=switches on the Animate interface menu enables you to set run-time switches before animating your program. When you press F3, the Switches submenu shown in Figure 2-6 is displayed.



Figure 2-6: Switches Menu

Using this menu, you can set or unset the run-time switches 0 to 8, the ANSI Debug switch (D) and the keyboard interrupt switch (i). By default the switches 0 to 8 and D are unset and as such are displayed on the status line prefixed with a minus sign ( - ). The i switch is set by default and is prefixed with a plus sign ( + ) sign. To toggle the options on and off press the key corresponding to the switch. See the chapter Running in your Server Express User's Guide for details of how to use run-time switches.

To enable the switch settings, press Enter to return to the Animate interface menu. Alternatively, if you decide not to change any switch settings, or you do not want to validate the settings you have just specified, press Escape. The switch settings remain unchanged and you are returned to the Animate interface menu.

Whenever you invoke the switches menu, the COBSW environment variable is read. The settings of the switches displayed on this menu reflect the current settings in COBSW. When you alter any of the switch settings using this menu, COBSW is rewritten with the adjusted settings. The new settings will then apply throughout the SDE until you change them using either this menu, or the other switch submenus on the Run menu, or you rewrite the COBSW environment variable. See the appendix Micro Focus Environment Variables in your Server Express User's Guide for further details of the COBSW environment variable.

2.4.4.3 F4=threads

F4=threads on the Animate interface menu is a toggle which sets or unsets the Animator MULTITHREAD directive. When this directive is set, "Threaded" is displayed on the status line.

By default, the MULTITHREAD directive is unset.

See the chapter Directives for Animator in your Debugging Handbook for further details of this directive.

2.4.4.4 F9/F10=options

F10=set-cmd-ln on the Animate interface menu displays the Set-Command-Line menu (see Figure 2-7). This menu enables you to specify a program command line (using a maximum of 62 characters) on the Prompt line. Program command lines can be either text or numbers in any format.



Figure 2-7: Set-More-Animator-Directives/Command Line Menu

F9 toggles to enable or disable the program command line entered using the Set-Command-Line menu. When F9 is toggled on, the indicator "Cmd-ln-on" is displayed on the information line, and the selected command line is enabled. When F9 is toggled off, the indicator "Cmd-ln-on" is not displayed, and the command line is disabled.

When you start Animator, it uses the directives specified in this menu as long as the "Opt-on" indicator is shown.

You specify directives on this menu before the "end" prompt, in the same format as you would for an anim command line. Any word you specify before the "end" prompt is assumed to be a directive.

If you want to specify more directives than can fit on the prompt line, you end your list of directives with an ampersand (&), which you separate from the final directive by one space. This causes Animator to pause at the beginning of animation and prompt you to enter further directives.

Note that any directives you have set using the COBANIMOPT environment variable will also be used by the Animator within the SDE menu system. However, when using Animator from the command line, any directives you specify there may overwrite the directives specified using COBANIMOPT. See the appendix Micro Focus Environment Variables in your Server Express User's Guide for further information on COBANIMOPT.

To specify a command line, you position the cursor after the "end" prompt and type in your command-line parameters.

When you have specified the directives and/or command-line parameters, press Enter to accept them and return to the Animate menu. You can repeatedly enable and disable the parameters or directives once they have been accepted by pressing F9 on the Animate menu.

Pressing Escape on the Set-Command-Line/Directives menu either before the command or directives have been accepted, or without specifying a command or any directives, returns you to the Animate interface menu without setting any directives or a command line.

2.4.5 Running a Program

Pressing F5=run on the SDE main menu enables you to dynamically load and run .int files, .gnt files, and callable shared objects. The Run menu is displayed as follows:



Figure 2-8: Run Menu

To run a program, you must first compile it to .int format or compile and generate it to .gnt format. See the sections Syntax Checking and Generating Native Code for information on how to compile and generate your program. You should then decide which options on this menu you want to set or unset.

The options on this menu enable you to select a program using the Directory Facility, change the settings of the run-time switches and specify program command lines. Changing the settings of the run-time switches and specifying a program command may alter the way in which your program runs.

Alternatively, you can use the defaults for these options. See the descriptions of the options on this menu for their defaults. When you have selected the options you want to use to run your program, either press Enter to run the program name displayed at the file prompt, or overtype this name with the name of the program you want to run and press Enter. When your program run has finished, you are returned to the SDE main menu.


Note: You cannot run linked executable programs from this Run menu. Instead, you should run them from the Operating System Command menu, which is described later in this chapter.


For further information on running a program, see the chapter Running in your Server Express User's Guide.

The options on this menu are described in the following sections.

2.4.5.1 F2=dir

F2=dir on the Run menu enables you to access the Directory Facility which displays all of the .int and .gnt files in the current directory. For further information on this option, see the section Working With Files and Directories later in this chapter.

2.4.5.2 F3=switches

F3=switches on the Run menu enables you to set run-time switches before you run a program. When you press F3, the following Switches submenu is displayed:



Figure 2-9: Switches Menu

Using this menu, you can set and unset the run-time switches 0 to 8, the ANSI Debug switch (D) and the keyboard interrupt switch (i). By default the switches 0 to 8 and D are unset and as such are displayed on the status line prefixed with a minus sign ( - ). The i switch is set by default and is prefixed with a plus sign ( + ). To toggle the options on and off press the key corresponding to the switch. See the chapter Descriptions of Run-time Switches in your Server Express User's Guide for details of run-time switches.

To enable the switch settings, press Enter to return to the Run menu. Alternatively, if you decide not to change any switch settings, or you do not want to validate the settings you have just specified, press Escape. The switch settings remain unchanged and you are returned to the Run menu.

Whenever you invoke the switches menu, the COBSW environment variable is read. The settings of the switches displayed on this menu reflect the current settings in COBSW. When you alter any of the switch settings using this menu, COBSW is rewritten with the adjusted settings. The new settings apply throughout the SDE until you change them using either this menu, or the other switch submenus on the Animator menu, or you rewrite the COBSW environment variable. See the chapter Running and the appendix Micro Focus Environment Variables in your Server Express User's Guide for further details of the COBSW environment variable.

2.4.5.3 F9/F10=set-cmd-ln

F10=set-cmd-ln on the Run menu displays the Set-Command-Line menu (see Figure 2-10). This menu enables you to specify a program command line (using a maximum of 62 characters) on the Prompt line. Program command lines can be either text or numbers in any format.

F9 toggles to enable or disable the program command line entered using the Set-Command-Line menu. When F9 is toggled on, the indicator "Cmd-ln-on" is displayed on the information line, and the selected command line is enabled. When F9 is toggled off, the indicator "Cmd-ln-on" is not displayed, and the command line is disabled.



Figure 2-10: Set Command Line Menu

When you have specified the program command line, press Enter to accept it and return to the Run menu. You can repeatedly enable or disable this command line once it has been accepted by pressing F9 on the Run menu.

When you start the program, it uses the command line specified in this menu as long as the "Cmd-ln-on" indicator is shown.

Pressing Escape on the Set-User-Program-Command-Line menu either before the command line has been accepted, or without specifying a command line, returns you to the Run menu without accepting the command line.

2.4.6 Generating Native Code

Pressing F6=generate on the SDE main menu invokes the Compiler to generate native code. The Generate menu is displayed as shown in Figure 2-11.



Figure 2-11: Generate Menu

The options on the Generate menu enable you to set or unset the ANIM, OPT and CHECK Compiler directives and generate your code to either .gnt generated code or the system .o object format. Changing the settings of these options alters the way in which your program is generated.

When you change the settings using this menu, the settings within the COBOPT environment variable are temporarily overwritten. See the descriptions of the options on this menu for their default settings.

When you have set or unset the options and directives you want to use to when you generate code, you then either press Enter to generate code from the .int program whose name is displayed at the file prompt, or overtype this name with the name of the program you want to generate and press Enter. In either case, you can specify a pathname with the program name. If you do, any output files are placed in the directory indicated by that path. When code generation finishes, you are returned to the SDE main menu.

For further information on the Compiler, see the chapter Using the Compiler in your Server Express User's Guide.

The options on this menu are described in the following sections.

2.4.6.1 F2=dir

F2=dir on the Generate menu enables you to access the Directory Facility which displays all of the .cbl, .CBL, and .int files in the current directory. For further information on this option, see the section Working With Files and Directories later in this chapter.

2.4.6.2 F3=anim

F3=anim on the Generate menu is a toggle which sets or unsets the ANIM Compiler directive. On Server Express, you can use Animator on generated code. When set, the indicator "Anim" appears on the status line. See the chapter Directives for Compiler in your Server Express User's Guide for details of the ANIM directive.

2.4.6.3 F4=opt

F4=opt on the Generate menu is a toggle which sets or unsets the OPT Compiler directive. When set, the indicator "Opt" appears on the status line; the program will be generated using the default level of OPT"2". If you want to use any other level of optimization you will have to set the OPT directive yourself. See the chapter Directives for Compiler in your Server Express User's Guide for details of the OPT directive.

2.4.6.4 F5=check

F5=check on the Generate menu is a toggle which sets or unsets the CHECK Compiler directive. When set, the indicator "Check" appears on the status line; the program will be generated using the CHECK directive which turns on all run-time checks in generated code. See the chapter Directives for Compiler in your Server Express User's Guide for details of the CHECK directive.

2.4.6.5 F6=gnt/object

F6=gnt/object on the Generate menu produces either dynamically loadable .gnt code or linkable .o object format code from your compiled program.

By default, the Compiler produces a .gnt file . A "Gnt" indicator is displayed on the status line. To produce object code, you press the F6=gnt/object toggle. When you do this, the "Gnt" indicator on the status line changes to "Object". You then specify a program name in exactly the same way as you would to produce generated code. The resulting object file has an .o extension.

To revert to producing .gnt generated code, press F6 again. The "Object" indicator on the status line changes to "Gnt". You can alternate between producing generated and object code in this way.

2.4.6.6 F9/F10=opt

F9/F10=opt on the Generate menu is a toggle which enables you to set additional generate-phase Compiler directives on the prompt line before you compile your program. See the description of this option in the section Syntax Checking earlier in this chapter for information on its use.

2.4.7 Creating Callable Shared Objects

Pressing F7=CSO on the SDE main menu invokes cob to produce a callable shared object. The Shared-Object menu as shown in Figure 2-12 is displayed.



Figure 2-12: Shared-Object Menu

See the chapters Packaging Applications and Callable Shared Objects in your Server Express User's Guide for details of callable shared objects.

The options on this menu are described in the following sections.

2.4.7.1 F2=dir

F2=dir on the Shared-Object menu enables you to access the Directory Facility which displays all of the .cbl, .CBL,.int, and .gnt files in the current directory. For further information on this option, see the section Working With Files and Directories later in this chapter.

2.4.7.2 F3=Unresolved_Symb

F3=Unresolved_Symb on the Shared-Object menu causes any unresolved reference to be treated as a COBOL program to be dynamically loaded. Normally, such references would cause a fatal error at link time. This is the same as using the cob -U flag.

When you do this, the "List-Sym" indicator is shown on the status line.

2.4.7.3 F4=thread

F4=thread on the Shared-Object menu enables you to specify whether the executable file is to be linked to the threaded or non-threaded run-time system. To create a multi-threaded executable, press the F4=thread key. When you do this, the "Non-Threaded" indicator on the status line changes to "Threaded". Any executables created while toggled to "Threaded" use the multi-threaded run-time system.

2.4.7.4 F5=C++

F5=C++ on the Shared-Object menu enables you to create a callable shared object in which COBOL and C++ objects are packaged together. Note that this option does not enable you to compile C++ objects; you must use the C++ compiler to do that. This is the same as using the cob -z,CC flag. When you do this, the "C++" indicator is shown on the status line.

2.4.7.5 F9/F10=options

F10=options on the Linker menu displays the Set-More-Linker-Directives menu (see Figure 2-13). This menu enables you to specify cob flags or directives on the prompt line which are then passed to the Linker before you link your program.



Figure 2-13: Set-More-Linker-Directives Menu


Note: You should specify only those cob flags associated with linking on this command line.


F9 toggles to enable or disable the flags or directives entered using the Set-More-Linker-Directives menu. When F9 is toggled on, the indicator "Options-on" is displayed on the information line, and the selected flags and/or directives are enabled. When F9 is toggled off, the indicator "Options-on" is not displayed, and the flags and/or directives are disabled.

When you have specified the cob flags or directives, press Enter to accept them and return to the Linker menu. You can repeatedly enable or disable these cob flags once they have been accepted by pressing F9 on the Linker menu.

Pressing Escape on the Set-More-Linker-Directives menu either before the flags or directives have been accepted, or without specifying directives returns you to the Linker menu without setting any flags or directives.

For further information on cob flags, see the chapter Descriptions of Cob Flags in your Server Express User's Guide. For further information on linking, see the chapter Linking to System Executables in your Server Express User's Guide.

2.4.8 Linking Programs

Pressing F8=link on the SDE main menu invokes the Server Express Linker, which enables you to produce linked object files. The Linker menu as shown in Figure 2-14 is displayed.



Figure 2-14: Linker Menu

To link a program, you must first generate it to object code. This can be done automatically by specifying an input file with an extension such as .cbl or .int. See the section Generating Native Code earlier in this chapter and the chapter Creating Programs in your Server Express User's Guide for details of how to generate your code to object code. You should then decide which cob flags or directives you want to pass to the Linker. This alters the way your program is linked.

Alternatively, you can link your program without specifying any directives.

When you have set or unset the cob flags or directives you want to pass to the Linker, you then either press Enter to link the program name displayed at the file prompt, overtype this name with the name of the program you want to link, or select a file using the directory facility and press Enter. When linking has finished, you are returned to the SDE main menu.

The options on this menu are described in the following section.

2.4.8.1 F2=dir

F2=dir on the Linker menu enables you to access the Directory Facility which displays all of the .cbl, .CBL, .int, and .gnt files in the current directory. For further information on this option, see the section Working With Files and Directories later in this chapter.

2.4.8.2 F3=exe/shlib

F3=exe/shlib on the Linker menu enables you to specify which executable format you want to create. Use this key to toggle between a system executable (when "Exe" is displayed on the status line) and shared library (when "Shlib" is displayed on the status line).

2.4.8.3 F4=thread

F4=thread on the Linker menu enables you to specify whether the executable file is to be linked to the threaded or non-threaded run-time system. To create a multi-threaded executable, press the F4=thread key. When you do this, the "Non-Threaded" indicator on the status line changes to "Threaded". Any executables created while toggled to "Threaded" will use the multi-threaded run-time system.

2.4.8.4 F5=C++

F5=C++ on the Shared-Object menu enables you to create a system executable or shared library in which COBOL and C++ objects are packaged together. Note that this option does not enable you to compile C++ objects; you must use the C++ compiler to do that. This is the same as using the cob -z,CC flag. When you do this, the "C++" indicator is shown on the status line.

2.4.8.5 F9/F10=options

F10=options on the Linker menu displays the Set-More-Linker-Directives menu (see Figure 2-15). This menu enables you to specify cob flags or directives on the prompt line which are then passed to the Linker before you link your program.



Figure 2-15: Set-More-Linker-Directives Menu


Note: You should specify only those cob flags associated with linking on this command line.


F9 toggles to enable or disable the flags or directives entered using the Set-More-Linker-Directives menu. When F9 is toggled on, the indicator "Options-on" is displayed on the information line, and the selected flags and/or directives are enabled. When F9 is toggled off, the indicator "Options-on" is not displayed, and the flags and/or directives are disabled.

When you have specified the cob flags or directives, press Enter to accept them and return to the Linker menu. You can repeatedly enable or disable these cob flags once they have been accepted by pressing F9 on the Linker menu.

Pressing Escape on the Set-More-Linker-Directives menu either before the flags or directives have been accepted, or without specifying directives returns you to the Linker menu without setting any flags or directives.

For further information on cob flags, see the chapter Descriptions of Cob Flags in your Server Express User's Guide. For further information on linking, see the chapter Linking to System Executables in your Server Express User's Guide.

2.4.9 Creating Character User Interaces Using Dialog System

Pressing F9=Dialog-system on the SDE main menu invokes character mode Dialog System, which enables you to produce character user interfaces. For information on the menus associated with Dialog System, see your Dialog System Character Mode User's Guide.

2.4.10 Recording UNIX Sessions

Pressing F10=session on the SDE main menu invokes the Session Recorder, which enables you to record keystrokes entered into, and screen output from, COBOL programs compiled with this COBOL system. You can then play back the recording and use it either to demonstrate how a product works or to perform automatic program testing. The following menu is displayed:



Figure 2-16: UNIX Session Recorder Menu

To record a session with a program, you must first compile it or compile and generate it. Then set or unset any one or more of the keystroke, screen, or anim-sess options.

To begin session recording you press either the F5=animate or the F6=run option, enter the name of the program you want to session record, then press Enter.

You should specify a terminal number only if you intend to use multi-terminal session recording, which is described, together with the functionality and usage information, in the chapter UNIX Session Recorder.

The options on the UNIX Session Recorder menu are described in the following sections.

2.4.10.1 F2=keystroke

F2=keystroke on the UNIX Session Recorder menu is a toggle which enables you to record key input from a session, or play back recorded keystrokes at either the normal speed or fast speed.

The options available to you from this toggle are Key-Rec (which records keystrokes), Key-Replay (which replays all keystrokes recorded during a session), Key-ReplayFF (which replays all keystrokes recorded during a session in fast mode), or none of these, should you decide not to use keystrokes. Pressing F2 repeatedly cycles through these options. The option you select is displayed on the status line with the exception of no keystroke recording, which is the default.

2.4.10.2 F3=screen

F3=screen on the UNIX Session Recorder menu is a toggle which enables you to record screen output from the terminals you specify during a session. The options available to you from this toggle are Scrn-Rec (which enables screen output recording), or no screen output recording, should you decide not to record screen output. Pressing F3 repeatedly enables you to toggle between these options. If you choose to record screen output, Scrn-Rec is displayed on the status line, otherwise no entry for screen recording appears on the status line.

The default is that no screen recording takes place.

You can play back a screen recording or compare screen recordings from two or more session recordings using the UNIX Screens Compare utility from the command line or the Operating System Command menu (see later in this chapter for details). See the chapter UNIX Session Recorder for further information on the UNIX Screens Compare utility.

2.4.10.3 F4=anim-sess

F4=anim-sess on the UNIX Session Recorder menu is a toggle which, when set, causes keystrokes made to Animator and keystrokes entered into COBOL applications, as well as screen output from Animator and the COBOL application, to be recorded or played back during animation, depending on the settings of the keystroke and screen toggles.

By default, this option is unset. Pressing F4 repeatedly enables you to toggle between these options.

2.4.10.4 F5=animate

F5=animate on the UNIX Session Recorder menu invokes the Animator. Invoking an Animator from the UNIX Session Recorder menu causes animation to occur under the control of the UNIX Session Recorder.

When you invoke the Animator from the Session Recorder, the menu and all of its options are the same as if you had invoked the Animator from the SDE main menu, with the exception of the status line. See Figure 2-17.



Figure 2-17: Animate Menu from the UNIX Session Recorder

When your program animation has finished, you are automatically returned to the UNIX Session Recorder menu.

Alternatively, if you decide not to animate your program after you have accessed this Animate menu, pressing Escape returns you to the UNIX Session Recorder menu.

See the section Animating a Program earlier in this chapter for details of the Animator options available to you.

2.4.10.5 F6=run

F6=run on the UNIX Session Recorder menu invokes the Run menu, which enables you to run your program under the control of the UNIX Session Recorder. Invoking the Run menu from the UNIX Session Recorder menu causes your programs to run under the control of the UNIX Session Recorder.

When you invoke the Run menu from the UNIX Session Recorder, the menu and all of its options are the same as if you had invoked the Run menu from the SDE main menu, with the exception of the status line. See Figure 2-18.



Figure 2-18: Run Menu from the UNIX Session Recorder

When your program run has finished, you are automatically returned to the UNIX Session Recorder menu.

Alternatively, if you decide not to run your program after you have accessed this Run menu, pressing Escape returns you to the UNIX Session Recorder menu.

See the section Running a Program earlier in this chapter for details of the Run options available to you.

2.4.10.6 F9/F10=options

F10 on the UNIX Session Recorder menu displays the Set-Session-Name/Terminal menu (see Figure 2-19). This menu enables you to specify the name (up to eight characters, no extension) of the session you want to use for session recording and/or the number of the terminal you want to use in your session recording and playback, together with their respective session flags.

F9 toggles to enable or disable the session and/or terminal specified using the Set-Session-Name/Terminal menu. When F9 is toggled on, the indicator "Options-on" appears on the information line and the specified session and/or terminal are enabled. When F9 is toggled off, the indicator "Options-on" is not displayed, and the session and/or terminal are disabled.



Figure 2-19: Set-Session-Name/Terminal Menu

When you specify a session name and/or terminal number together on this prompt line, the terminal number must be separated from the session name by at least one space. The format for specifying a terminal number is described in the chapter UNIX Session Recorder.

When you have specified a session name and/or the terminal number, press Enter to accept them and return to the UNIX Session Recorder menu.

When you start Session Recorder, it uses the directives specified in this menu as long as the "Options-on" indicator is shown.

Pressing Escape on the Set-Session-Name/Terminal menu either before the session name or terminal number has been accepted, or without specifying a session name or any terminal number returns you to the UNIX Session Recorder menu without specifying either of these.

2.5 SDE Alternate Menu

Pressing Alt on the SDE main menu invokes the SDE Alternate menu. The Alternate menu is displayed as follows:



Figure 2-20: SDE Alternate Menu

From the SDE Alternate menu you can invoke further components of Server Express. These are briefly described in the following sections.

2.5.1 Configuring Adis

Pressing F2=config on the SDE Alternate menu invokes the Configuration Utilities menu. You can execute the Adis configuration utilities from here. The Configuration menu is displayed as follows:



Figure 2-21: Configuration Utilities Menu

Using this menu, you can configure the Screen Configuration and the Keyboard and set environment variables for the current process. The menu options are briefly described in the following sections.

2.5.1.1 F2=adiscf

F2=adiscf on the Configuration Utilities menu enables you to alter the configuration held in the ADISCTRL database. When you press F2, the following menu is displayed:



Figure 2-22: Adiscf Menu

The options on this menu are fully described in the chapter Configuring Enhanced Accept and Display in your Programmer's Guide to Creating User Interfaces, as is the ADISCTRL database.

2.5.1.2 F3=keybcf

F3=keybcf on the Configuration Utilities menu enables you to use the Keyboard Configuration utility to alter the keystroke configurations in the cobkeymp database.

Using these options, you can review, alter or save Adis keys, Animator function keys, user function keys and compatibility keys.

Note that changes to the Animator function keys affect the keystroke configuration for all of the Server Express tools. Therefore, if you want to configure keystrokes for the Editor, for example, you use the Animator Function Keys option.

See the chapter Configuring Your Keyboard in your Programmer's Guide to Creating User Interfaces for further information on this utility, and on cobkeymp files.

2.5.1.3 F5=env-var

F5=env-var on the Configuration Utilities menu enables you to set environment variables for the current process. Pressing F5 invokes the menu shown in Figure 2-23:



Figure 2-23: Set Environment Variables Menu

To set or change the value of an environment variable, enter an environment variable name on the prompt line and press Enter. Server Express reads the environment variable with that name and outputs the environment variable and its current value separated by an equals sign (= ). You can then edit this value and press Enter. Server Express rewrites the environment variable and displays the environment variable name at the prompt as a confirmation that the environment variable has been rewritten.

You can also confirm that any environment variable has been rewritten by pressing Enter when that environment variable name is displayed at the prompt. This restarts the above process.

If you decide that you do not want to set environment variables, press Escape to return to the Configuration Utilities menu leaving the environment variable settings as they were before you accessed this menu.


Note: Server Express always displays the contents of an environment variable if you specify a single environment variable name at the prompt. However, if you type text in addititon to the environment variable name, the additional text is taken to be the value for the environment variable name; the environment variable is therefore set to the value of the additional text. For example, if you type:

libpath \mydir\myapps

the additional text is assumed to be the value to which you want to set LIBPATH. In this case, LIBPATH would be set to \mydir\myapps.

When you are setting an environment variable, the environment variable name and the setting cannot exceed 65 characters. If you are reading an existing environment variable, only the first 65 characters will be displayed


See the appendix Micro Focus Environment Variables in your Server Express User's Guide for a list of valid environment variables.

2.5.2 Entering Operating System Commands

Pressing F3=OS-command on the SDE Alternate menu invokes the Operating System Command menu. This facility enables you to enter a UNIX operating system command which is then passed to the default shell on your system. Pressing F3 invokes the following menu:



Figure 2-24: Operating System Command Menu

Enter any valid operating system command at the prompt and press Enter to accept it and return to the Alternate menu.

Pressing Escape either before the command has been accepted, or without specifying a command, returns you to the Alternate menu.

2.5.3 Editing Data Files

Pressing F4=data-file-editor on the SDE Alternate menu invokes the Data File Editor Menu:



Figure 2-25: Data File Editor Menu

For information on how to use this menu, see the chapter Data File Editor.

2.5.4 Profiling Programs

F5=profiler on the SDE Alternate menu invokes the COBOL Profiler facility. When you run a program which has been compiled with the PROFILE directive, an .ipf file is produced. The .ipf file contains run-time performance statistics and one is produced each time you run the program. The previous .ipf file with the same basename is overwritten. The Profiler facility translates the data within the .ipf file to a readable format. When you invoke the Profiler facility, the Profiler menu is displayed as shown in Figure 2-26.



Figure 2-26: Profiler Menu

The options on this menu enable you to specify that you want the run-time performance statistics to be displayed on the screen, or sent to a list file. You can also specify additional Profiler directives. Changing the options on this menu and specifying Profiler directives alters the way in which your program's statistics are output.

When you have set or unset the options you want to use to output statistics from your program, you then either press Enter to start profiling the program name displayed at the file prompt, or overtype this name with the name of the program whose run-time statistics you want to translate, and press Enter. In either case you should not specify a program name extension. When profiling has finished, you are returned to the Alternate menu.

For further information on the COBOL Profiler, see the chapter Profiler.

The options on the Profiler menu are described in the following sections.

2.5.4.1 F4=list

F4=list on the Profiler menu is a toggle which enables you either to display the run-time performance statistics on the screen or to send them to a file which has the basename of the file you submitted for profiling, plus a .prf extension. The indicators "List" and "List-file" respectively appear on the status line to show the status of the toggle. The default is List-file.

2.5.4.2 F9/F10=options

F10=options on the Profiler menu displays the Set-More-Profiler-Directives menu (see Figure 2-27). This menu enables you to set additional Profiler directives.



Figure 2-27: Set-More-Profiler-Directives Menu

F9 toggles to enable or disable the additional directives entered using the Set-More-Profiler-Directives menu. When F9 is toggled on, the indicator "Opt-on" is displayed on the information line, and the selected directives are enabled. When F9 is toggled off, the indicator "Opt-on" is not displayed, and the directives are disabled.

When you have specified the directives, press Enter to accept them. You can repeatedly enable and disable the directives once they have been accepted by pressing F9 on the Profiler menu.

Pressing Escape either before the directives have been accepted, or without specifying directives returns you to the Profiler menu.

2.5.5 Working With Files and Directories

Pressing F6=Directory on the SDE Alternate menu displays lists of all files in the current directory and the following menu:



Figure 2-28: Directory Facility Menu

You can change directories to display any files in other directories. You can select a file from the list by using the cursor keys to move to the file and then pressing Enter to select it.

For information on the functionality of this facility see the chapter Directory Facility in this book.

This menu can also be accessed from other submenus in the SDE menu system.

2.5.6 Exiting the SDE Alternate Menu

Pressing Alt on the Alternate menu returns you to the SDE main menu.


Copyright © 2000 MERANT International Limited. All rights reserved.
This document and the proprietary marks and names used herein are protected by international law.

PreviousIntroduction COBOL Source InformationNext