Previous Topic: Main MenuNext Topic: General Options Screen—Page 2


General Options Screen—Page 1

The first page of the General Options screen is used to specify options for an application:

The first page of the General Options screen is accessed from the Main Menu by choosing option 1 at the Screen prompt.

The current settings for the application options are displayed on the screen. Each option can be changed by overwriting the displayed setting.

Sample Screen

General Options Page 1 of 2 Application name: TESTAPPL Version: 1 Description . . . TEST APPLICATION Maximum responses . . . . . . . . . . . . . 500 Date format . . . . . . . . . . . . . . . . 1 1. mm/dd/yy 2. dd/mm/yy 3. yy/mm/dd 4. yy/ddd Execution environment . . . . . . . . . . . 1 1. Online 2. Batch Default execution mode. . . . . . . . . . . 1 1. Step 2. Fast Default print destination . . . . . . . . . Default print class . . . . . . . . . . . . 1 Enter F1=Help F3=Exit F4=Prev F5=Next F8=Fwd

Field Descriptions

Application Name

Specifies the name of the current application, as specified on the Main Menu screen. This field is protected.

Version

Specifies the version number, in the range 1 through 9999, of the current application.

Description

Specifies a 1- to 32-byte description of the current application. This field is a documentation aid. The application description is included in the load module created for the application.

Maximum Responses

Specifies the maximum number of responses, in the range 0 through 9999, that can be defined for the application. The default maximum number of responses is 500.

The application compiler creates a table of responses for each application; 19 bytes are allocated in the table for each response that can be defined. Therefore, the value specified for Maximum responses determines the amount of space that is allocated for the response table.

To optimize processing efficiency, the space allocated for the response table should be kept as small as possible. If the application developer attempts to add more responses than the maximum number specified, the application compiler returns a message indicating that the attempt to add a response was unsuccessful because of insufficient space. The developer can return to the General Options screen at any time during an application compiler session and increase the Maximum responses specification.

The value does limit the number of responses that can be added, but the size of the load module is exactly tailored to the actual number of responses, not set at this limit.

Date Format

Specifies the format in which the current date appears on runtime menu and help screens. At runtime, the current date is retrieved from DC/UCF and is stored in the specified format in ADSO- APPLICATION-GLOBAL-RECORD and ADSO-APPLICATION- MENU-RECORD, if applicable. When a runtime menu or help screen is displayed, the runtime system retrieves the date from the applicable record.

The date format is selected by entering the appropriate number in the response field following Date format. Available formats are as follows:

Execution Environment

Specifies whether the application will execute online or under CA ADS Batch.

Default Execution Mode

Sets the default execution mode for the application.

If STEP mode is specified, the runtime system responds to a user signon with the message that the signon is accepted. The user then must press [Enter] to initiate the first function of the application. STEP mode is the default.

If FAST mode is specified, the system responds to an acceptable signon by directly initiating the first function automatically.

Default Print Destination

Specifies a DC/UCF print destination. If not specified, the print destination defaults at runtime to the system default.

At runtime, the specified print destination is stored in the AGR-PRINT-DESTINATION field of the ADSO-APPLICATION-GLOBAL-RECORD. WRITE PRINTER commands can use the default by specifying a print destination of AGR-PRINT-DESTINATION.

Default Print Class

Specifies a DC/UCF print class number in the range 1 through 64. If not specified, the print class defaults at runtime to the physical terminal default.

At runtime, the specified print class is stored in the AGR-PRINT-CLASS field of the ADSO-APPLICATION- GLOBAL-RECORD. WRITE PRINTER process commands can use the default by specifying a print class of AGR-PRINT-CLASS.

More information:

System Records