Copyright: COPYRIGHT FUJITSU LIMITED. 1992-1996


Runtime Environment Setup Window Help

•	Using the runtime environment setup window

•	COBOL runtime environment information

•	Entry infformation


Using the Runtime Environment Setup Window

•	Display the runtime environment setup window

•	Selecting the information section

•	Setup the runtime environment

•	Saving runtime environment information to the initialization file

•	Closing the runtime environment setup window

•	[Printer Font Specifies]dialog box operations

•	[Environment Variables List]dialog box operations

•	[COBOL Environment Variables(Keywords)]dialog box operations

•	[Select Printer Name]dialog box operations

Note

The information you save in the initialization file is used when you execute the program.


Displaying the Runtime Environment Setup Window

The runtime environment setup window is displayed when a cobol application is invoked.You can switch the display of the window on and off by using the @EnvSetWindow environment variable in the application’s section of the COBOL85.CBR initialization file.

@EnvSetWindow=USE

Displays the runtime environment setup window.

@EnvSetWindow=UNUSE

Does not display the runtime environment setup window.


Selecting the Information Section

Choose Section information or Entry section information from the Section pulldown of the runtime environment setup window.The runtime environment information for the selected section is displayed in the list box.


Setting the Runtime Environment

•	Adding Runtime Environment Information

•	Changing Runtime Environment Information

•	Deleting Runtime Environment Information


Adding Runtime Environment Information

To add runtime environment information,enter the runtime environment information in the text box and click the [Setup]button.The information is displayed in the list box.


Changing Runtime Environment Information

To change displayed runtime environment information in the list box:

1	Select the item you want to change from the list box.

2	After the selected information is displayed in the text box,change the contents and click the [Setup]button.

3	The changed information is displayed in the list box.


Deleting Runtime Environment Information

To delete displayed runtime environment information from the list box:

1	Select the item you want to delete from the list box.

2	Click the [Delete]button,and the selected information is deleted from the list box.


Saving Environment Information to the Initialization File

To save runtime environment information in the initialization file,Click the [Save]button.Only the selected information,highlighted in blue in the list box,is saved in the initialization file.

The information you save in the initialization file is used when you execute the program.


Closing the Runtime Environment Setup Window

To close the runtime environment setup window,click the [Run]button.The runtime environment setup window is closed and the program is executed.


COBOL Runtime Environment Information

The following COBOL runtime environment variables can be set.

•	@GOPT

•	@MGPRM

•	@IconDLL

•	@IconName

•	@ScrnSize

•	@MessOutFile

•	@CnslWinSize

•	@CnslBufLine

•	@WinCloseMsg

•	@EnvSetWindow

•	@AllFileExclusive

•	@CnslFont

•	@ScrnFont

•	@PrinterFontName

•	@CBR_ENTRYFILE

•	@CBR_CI_CODETYPE

•	@CBR__CINF

•	File identifier name

•	Access name of SYSIN

•	Access name of SYSOUT

•	TERMINATOR

•	FCBxxxx

•	FOVLDIR

•	OVD_SUFFIX

•	FOVLTYPE

•	@CBR_PrintTextPosition

•	@CBR_TextAlign

•	@PRN_FormName

•	@DefaultFCB_Name


@GOPT

@GOPT(Set Runtime options)Specification Format

@GOPT=[Runtime options]

0	Specify runtime options as a list of runtime options.

1	Example

@GOPT=r20 c20


@MGPRM

@MGPRM(Set the GS-series Format Runtime Parameter)Specification Format

@MGPRM=["character string"]

0	Specify a sequence of one or more characters within double quotes (").@MGPRM defines a text string to be passed to the main COBOL program.For more information about the GS-series format runtime parameter,see Appendix K,"Function Comparison."

1	Example

@MGPRM="A2042CDE"


@IconDLL

@IconDLL(Set the DLL name of an Icon Resource)Specification Format

@IconDLL=[file name of a .DLL icon resource]

0	Specifies the DLL name of an icon resource file.If an icon resource is not contained in the executable file but is contained in a .DLL file,specify the name of the .DLL.COBOL85 provides an icon resource .DLL,F3BIICON.DLL.To use it.


@IconName

@IconName(Set the Identifier of an Icon Resource)Specification Format

@IconName=[identifier name of icon resource]

0	Specifies the identifier name of an icon resource.The name of the icon resource contained in F3BIICON.DLL is COB85EXE.

1	Note

To create an icon,you need to use the Windows(R)software development kit.


#@ScrnSize

@ScrnSize(Set the Size of the Logical Screen for Screen Handling)Specification Format

@ScrnSize=[(number of columns,number of rows)]

0	Specifies the logical window size for the screen operation facility.The numbers of columns and rows can be from 1 to 999.If (number of columns +1)*(number of rows)exceeds 16250,an error occurs at program execution time.


@MessOutFile

@MessOutFile(Set the Message Output File)Specification Format

@MessOutFile=[file name for messages]
Specifies a file to which runtime library messages should be written.If you specified file name for messages,message box isn’t displayed in the screen.


@CnslWinSize

@CnslWinSize(Set the Size of the Console Window)Specification Format

@CnslWinSize=[(number of columns,number of rows)]

0	Specifies the console window size used with ACCEPT and DISPLAY statements.The numbers of columns and rows can be from 1 to 999.If you specify a value less than the minimum value allowed by system,the minimum value is used.If you specify a value greater than the maximum value allowed by system,the maximum value is used.


@CnslBufLine

@CnslBufLine(Set the Buffer Count for the Console Window)Specification Format

@CnslBufLine=[number of rows for console window buffer]

0	Specifies the number of rows for the console window buffer used by ACCEPT and DISPLAY statements.The value can be from 1 to 9999.If (number of columns specified by @CnslWinSize +1)*(number of rows for console window buffer)exceeds 65000,the specified number of rows for the buffer is reduced.For example if the number of columns of the console window is 80,you can have up to 802 rows in the console window buffer.If the number of columns of the console window is 91,you can have up to 706 rows in the console window buffer.


@WinCloseMsg

@WinCloseMsg(Set a Display Message When the Window Close)Specification Format

@WinCloseMsg=[ON or OFF]

0	If you want confirmation messages to be displayed,specify @WinCloseMsg=ON.

1	If you do not want the messages displayed use,@WinCloseMsg=OFF.

2	@WinCloseMsg=ON is the default.


@EnvSetWindow

@EnvSetWindow(Set if the Run-time Environment Setup Window is Used)Specification Format

@EnvSetWindow=[USE or UNUSE]

0	Specify whether the Run-time Environment Setup window is displayed (USE)or not (UNUSE)when a program is executed.To change to USE once UNUSE is set,modify the contents of the initialization file.


@AllFileExclusive

@AllFileExclusive(Set Exclusive Control of Files)Specification Format

@AllFileExclusive=[YES or NO]

0	Specify whether all files are exclusively controlled (YES)or not (NO)when a program is executed.When YES is selected,files used by the program cannot be accessed from any other program (open error).

1	Note

File exclusive control can reduce file access time.


@CnslFont

@CnslFont(Set the Console Window Font)Specification Format

@CnslFont=[(font name,font size)]

0	Specify the font of the console window used for the ACCEPT/DISPLAY function.


@ScrnFont

@ScrnFont(Set the Font Used for Screen Handling)Specification Format

@ScrnFont=[(font name,font size)]

0	Specify the font used for screen handling.


@PrinterFontName

@PrinterFontName(Set the Font Used for Print Files)Specification Format

@PrinterFontName=(Minchou-font-name,Gothic-font-name)

0	Specify the font used for print files.


@CBR_ENTRYFILE

@CBR_ENTRYFILE(Set the Entry Information File)Specification Format

@CBR_ENTRYFILE=[entry file name for calling programs]

0	Specify the name of the file that contains entry information for calling programs.Specify the full path name as the entry file name.


@CBR_CI_CODETYPE

@CBR_CI_CODETYPE(Code system used in the Simplified inter-Application Communication in)Specification Format

@CBR_CI_CODETYPE=EBCDIC-KANA

0	Specify the code system of the compiled object.If you use the Simplified inter-Application Communication in the object compiled by JEF code,you should be specified “EBCDIC-KANA”.

1	Do not specify the value for this environment variable if you do not use JEF code.

2	Note

If you want to use this environment variable,COBOL85 JEF OPTION is necessary.


File identifier

File identifier(Set the File Used by the Program)

File identifier=file name

0	"file identifier"is the name specified in the ASSIGN clause of the COBOL source program."file name"is the file name of the physical file.

1	This specification is required to establish the link between the file description in the program and the physical file.

2	Specify file identifiers with uppercase characters in the runtime environment information,even if you specified them with lowercase characters in the COBOL program.

3	Example

[ASSIGN clause in the COBOL source program]

ASSGIN TO OUTFILE

[Physical file name]

F:\WORK.DAT

[The runtime environment information]

OUTFILE=F:\WORK.DAT


SYSIN Access Name

SYSIN Access Name(ACCEPT statements)

SYSIN Access Name=file name

0	Specify the environment variable name specified in the compiler option SSIN as SYSIN access name.Specify the name of the file used as the data input destination when the ACCEPT statement of the ACCEPT/DISPLAY function is run.

1	Example

[SSIN compilation option]

SSIN(INFILE)

[File containing data for ACCEPT statements]

A:\INDATA.TXT

[The runtime environment information]

INFILE=A:\INDATA.TXT


SYSOUT Access Name

SYSOUT Access Name(Set the Output File for the ACCEPT/DISPLAY Function)

SYSOUT Access Name=file name

0	Specify the environment variable name specified in the compiler option SSOUT as SYSOUT access name.Specify the name of the file used as the data output destination when the DISPLAY statement of the ACCEPT/DISPLAY function is run.

1	Example

[SSOUT compilation option]

SSOUT(OUTFILE)

[File to receive output from DISPLAY statements]

A:\OUTDATA.TXT

[The runtime environment information]

OUTFILE=A:\OUTDATA.TXT


TERMINATOR

TERMINATOR(Set the Function Keys for Screen Handling)

The following TERMINATOR(Defines active function keys for the screen operation facility)are specification format.

0	TERMINATOR=[!]key word[[,[!]key word]...]

1	"key word"must have the format "PFnn"or "PFmm-PFnn"."PFnn":nn is from 01 to 24.For example,PF01 is function key 1.

2	"PFmm-PFnn":This format defines the range of function keys.mm and nn are from 01 to 24.PFmm is the first function key number and PFnn is the last function key number.

3	"!"disables input of the specified function key.

4	Example

TERMINATOR=PF1-PF3,!PF4-PF24


FCBxxxx

FCBxxxx(Contains the FCB control statement)

FCBxxxx=FCB control statement

0	"xxxx"is the FCB name specified in the I control record."FCB control statement"is the FCB control statement.For the format of the FCB control statement,see Appendix M,"FCB Control Statement."


FOVLDIR

FOVLDIR(Set the folder Containing Form Overlay Patterns)Specification Format

The following FOVLDIR(Set the folder Containing Form Overlay Patterns)are specification format.

0	FOVLDIR=folder name

1	Specify the folder containing form overlay patterns in folder-name by using an absolute path name.Only one folder can be specified in folder name.


OVD_SUFFIX

OVD_SUFFIX(Set the Extension of the Form Overlay Pattern File)Specification Format

The following OVD_SUFFIX(Set the Extension of the Form Overlay Pattern File)are specification format.

0	OVD_SUFFIX=extension

1	"extension"is the extension to be used for form overlay patterns files.


FOVLTYPE

FOVLTYPE(Set the Format of the Form Overlay Pattern File)Specification Format

The following FOVLTYPE(Set the Format of the Form Overlay Pattern File)are specification format.

0	FOVLTYPE=format

1	"format"is the type of form overlay pattern file and the first four characters of the overlay file names.If it is not specified,"KOL5"is used as a default for FOVLTYPE.


Entry Information

Entry Information(Subprogram Name,Secondary Entry Name)Specification Format

Entry information is required only for programs having dynamic program structure.

•	Subprogram Name Specification Format

•	Secondary Entry Name Specification Format


Subprogram Name Specification Format

subprogram name=DLL file name

"subprogram name"is the name of a subprogram contained within a DLL file.This is the primary entry name for the subprograms contained in the DLL file.

"DLL file name"is the name of the DLL file that contains the subprogram.

If a subprogram name in a DLL file is the same as the DLL file name this information need not be specified.


Secondary Entry Name Specification Format

secondary entry name=primary entry name

"secondary entry name"is the name specified by an ENTRY statement in a COBOL85 program,or a program name of another compilation unit.

"primary entry name"is the name specified by "sub program name=DLL file name".

This information must be specified for all programs that are called by other programs.


[Printer Font Specifies]dialog box operations

[OK]button

Click the [OK]button you want to use as printer font selected contents in the [MINCHOU]list box and the [GOTHIC]list box list box.Click the [OK]button,selected information in shape is displayed in Runtime Environment Setup window edit box.

[Cancel]button

Click the [Cancel]button,you want to get out the [Printer Font Specifies]dialog box without doing anything.Click the [Cancel]button,you will return to Runtime Environment Setup window.

[Help]button

Click the [Help]button you want to refer this help.


[Environment Variables List]dialog box operations

[OK]button

Click the [OK]button,you want to modify selected contents in the [System Environment Variables Name List]list box.Click the [OK]button,selected information is displayed in Runtime Environment Setup window edit box.

[Cancel]button

Click the [Cancel]button,you want to get out the [Environment Variables List]dialog box without doing anything.Click the [Cancel]button,you will return to Runtime Environment Setup window.

[Help]button

Click the [Help]button you want to refer this help.


[COBOL Environment Variables(Keywords)]dialog box operations

[OK]button

Click the [OK]button,you want to modify selected contents in the [Environment Variables Information]list box.Click the [OK]button,selected information is displayed in the Runtime Environment Setup window edit box.

[Cancel]button

Click the [Cancel]button,you want to get out the [COBOL Environment Variables(Keywords)]dialog box without doing anything.Click the [Cancel]button,you will return to Runtime Environment Setup window.

[Help]button

Click the [Help]button you want to refer this help.


[Select Printer Name]dialog box operations

[OK]button

Click the [OK]button you want to get selected contents in the [Printer name]combo box.

Click the [OK]button,selected information is displayed in Runtime Environment Setup window edit box.

[Cancel]button

Click the [Cancel]button,you want to get out the [Select Printer Name]dialog box without doing anything.Click the [Cancel]button,you will return to Runtime Environment Setup window.

[Help]button

Click the [Help]button you want to refer this help.


@CBR_CINF

@CBR_CINF(Specifies the LD Definition File)

@CBR_CINF=LD Definition File name

If you want to use the Simplified inter-Application Communication facility,specify the LD Definition File name.


@CBR_PrintTextPosition

@CBR_PrintTextPosition(Specification of method of calculating character arrangement coordinates)

@CBR_PrintTextPosition=TYPE1(not to correct coordinates of the character arrangement)or TYPE2(to correct coordinates of the character arrangement)

When the print of the FORMAT phrase none is filed,the method of calculating coordinates (x,y)by which the printed character is arranged will be specified.


@CBR_TextAlign

@CBR_TextAlign(Specification of match of the top/bottom when arranges in character line)

@CBR_TextAlign=[TOP or BOTTOM]

When the print of the FORMAT phrase none is filed,the position of the print character arranged in the line will be specified.An effective range of this specification is in the execution unit.


@PRN_FormName_XXX

@PRN_FormName_XXX(Specification of form name)

@PRN_FormName_XXX=paper name

When the print of the FORMAT phrase none is filed,the form name is associated and will be specified the replacement of the character string of three characters or less specified for the size field on I control record with the XXX part of this execution environment information name and corresponding to this execution.


@DefaultFCB_Name

@DefaultFCB_Name(Specification of Default FCB Name)

@DefaultFCB_Name=Default FCB name

The name of FCB used by default is specified.Should associate with this execution environment information name and the specified FCB name define the FCB control statement as well as the case to change FCB from I control record dynamically beforehand.