Chapter 10: Generation

This chapter contains information on generating applications, including procedures, parameters, and regeneration.

Generate Procedures

Do the following:

  1. Select any generation parameters (see following topics).

  2. Display your application on Application Painter.

  3. Generate entire application or generate your screens followed by your programs, as follows:

    To Generate...
    		 Enter...

    Single screen

    GENERATE SC screenname in Command field, or G in screen selection field

    Multiple screens

    G in screen selection fields

    All screens

    GENERATE SC ALL in Command field

    Single program

    GENERATE SC programname in Command field, or G in program selection field

    Multiple programs

    G in program selection fields

    All programs

    GENERATE SC ALL in Command field

    Entire application

    GENERATE in Command field

    ISPF prototype

    ISPF in DC field, GENERATE in Command field

Parameters

Verify or change default parameters that define your development and application target environments. Access from Application Painter by entering OPT in the Command field, or select from APS Main Menu.

Reset the following to their original values at installation time:

BIND options

Job control cards

SQL

Library prefixes and DSNs

Generator options

APS precompiler options

IDMS options

 

  1. Transfer to Generator Options to define options for the generation process.

  2. Transfer to Project Group Environment to define your project and group settings from a centralized location.

  3. Transfer to Precompiler Options to vary some APS parameters during program precompilation.

  4. Transfer to Report Options to define characteristics that apply to all your APS documentation reports.

  5. Transfer to SQL Bind and Translate Options to specify DB2 BIND options.

  6. Transfer to Job Cards to establish up to five job cards with varying information.

  7. Transfer to IDMS Options to define IDMS-specific parameters.

Generation Options

  1. Use APS Generator Options to define options for the generation process.

    Option
    		 Description and Values

    Target

    Define operating system (OS), database (DB), data communications (DC) and SQL targets.

    Job Class

    Any job class valid at your site and known to the APS generators.

    Job Dest

    Site-specific.

    MSG Class

    Site-specific.

    LISTGEN

    YES

    Provide a listing of generated code.

    NO

    Default. Do not provide listing.

    COBOL

    YES

    Save generated COBOL program source in the library or directory that is appropriate for your DC target.

    NO

    Default. Do not save COBOL source.

    Object

    YES

    Save generated object code in appropriate library.

    NO

    Default. Do not save object code.

    MFS/BMS

    YES

    Save generated MFS or BMS in the library or directory appropriate for your IMS or CICS target.

    NO

    Default. Do not save.

    GENSRC

    YES

    Save generated source code in the GENSRC directory or data set.

    NO

    Default. Do not save GENSRC.

    APS Parm

    Override the APS Parm field on the Precompiler Options screen.

    COBOL Parm

    Specify parameters or directives for COBOL compiler.

    CARDIN Member

    Specify the CNTL library APSDBDC member.

    Generate COBOL II

    YES

    Generate COBOL II code.

    NO

    Do not generate.

    Generate COBOL II

    YES

    Compile with VS-COBOL II. Use VS-COBOL II directive for Micro Focus COBOL.

    NO

    Default. Compile with standard COBOL.

    CICS Release

    CICS release at your site.

    IMS Release

    IMS release at your site.

    SUPRA

    YES

    Pass native SUPRA procedural statements through APS unchanged.

    NO

    Process SUPRA procedural statements.

Project Group Environment

Define your project and group settings on APS Project Group Environment.

Option
 Description and Values

Project

Project name. Maximum 8 alphanumeric characters; first character alphabetic.

Group

Group name. Maximum 8 alphanumeric characters; first character alphabetic.

DDIFILE

Location of data set or directory where APS stores extracted information for DBD and DDI statements. Do not specify the name DDIFILE. Default is current project and group.

Data Element Library Prefix

Location of the Data Element Facility APSDE directory or data set; do not specify the name APSDE.

Precompiler Options

Select various APS parameters to obtain special features during program recompilation on APS Precompiler Options. The APS Parm field displays the modified parameters.

The following lists the parameters and their valid values. The Keywords columns specifies the keywords generated by the parameter; you can enter these keywords in the APS Parm field on the Generator Options screen.

Option
 Description and Values

APOST

Overrides QUOTE.

YES

Default. Lets you use the apostrophe character to delimit non-numeric literals in your input source.

QUOTE

Overrides APOST.

YES

Lets you use the single quote character to delimit non-numeric literals in your input source.

NO

Default.

SCBTRACE

YES

Activates the SAGE-TRACE-FLAG debugging facility.

RWT

YES

Default. Generate COBOL code from APS Report Writer statements. Specify with COBOL II compiler.

NO

Pass Report Writer statements directly to the COBOL compiler.

For very large programs, enter rwt=bigrwt in the APS Parm field on the Generator Options screen.

MOCKUP-FMP

YES

Scan lines in report mock-ups and processes the characters % $ & and + as Customization Facility symbols.

NO

Default.

SUBR

YES

Generated source is a subroutine program.

NO

Default. Generated source is a primary program.

NARROW

YES

Default. 80 columns is the message report width.

NO

132 columns is the width.

EVALMESS

YES

Generate messages that list evaluation bracket resolutions. Usually results in long listings.

NO

Default.

GENSEQ

Overrides SPACESEQ.

YES

Default. Generate sequence numbers in columns 1-6 for blank or out-of-sequence lines of source code and when new lines are generated.

SPACESEQ

Overrides GENSEQ.

YES

Generate spaces in columns 1-6; incompatible with LANG=TEXT.

SPACEIDENT

See also, GENIDENT, IDENT, SEQ.

YES

Generate spaces in columns 73-80. Incompatible with LANG=TEXT.

FMP

YES

Default. Process APS macros and user-defined Customization Facility macros.

NO

Use only with your own JCL skeleton.

Source

YES

Print the main input source program, specified in the MAIN option, after the message report.

NO

Default.

GENDIRECT

YES

Allow generation of nested IF statements in the COBOL source.

MAIN

Location of the main input source.

MAININ

=YES

INSTREAM

=YES

Member Name

=membername

XLATE

Specify which processing step(s) that APS performs. You can stop processing at any of the steps listed below. All options except ALL are mutually exclusive.

ALL

=YES

SCB

=YES

FMP

=YES

RED

=YES

RWT

=YES

EMARK

Three-character string that marks error and warning lines of the message report.

Questions=

YES

Dollars=

YES

3-Char String=

string

IDENT

See also, GENIDENT, SPACEIDENT, SEQ.

YES

Generate the internal program name in columns 73-80.

NO

Default.

SQL BIND Options

The APS Bind Options screen let you specify parameters and change default values for your SQL database target.

Field
 Description and Values

Database

Database name. Required for OS/2 Database Manager.

DB2 System Name

Appropriate name for your site.

Plan Name

Plan name you use when you Bind an application. If you leave this field blank, the default depends upon your use of the BIND command in the Application Painter.

Owner of Plan (Authid)

Leave this field blank or specify a primary or secondary authorization ID of the BIND.

Qualifier

Leave this field blank or specify the implicit qualifier for the unqualified table names, views, indexes, and aliases contained in the plan.

Action

Specify the bind action to be executed. Valid values: ADD or REPLACE.

Retain Execution Authority

Used only when you specify REPLACE in the Action field. Valid values: YES or NO.

Isolation Level

Valid values: RR or CS.

Plan Validation Time

Valid values: RUN or BIND.

Explain Path Selection

YES

Activate the DB2 EXPLAIN function.

NO

Do not activate the function.

Resource Acquisition Time

Valid values: Use or Allocate.
If you enter ALLOCATE, enter DEALLOCATE in the Resource Release Time field.

Resource Release Time

Valid values: COMMIT or DEALLOCATE.

Defer Prepare

YES

Generate the keyword DEFER(PREPARE), which defers the prepare statement referring to a remote object.

NO

Default.

Cache Size

Size (in bytes) of the authorization cache to be acquired in the EDMPOOL for the plan. Valid values: 0 to 4096.

Data Currency

YES

Data currency is required for ambiguous cursors.

NO

Data currency is not required.

Current Server

Leave this field blank or specify a connection to a location before the plan runs.

Message Flag

Specify which messages display. Valid values: I, W, E, C, or blank.

Job Control Cards

Establish up to five job cards with varying job names, account information, classes, and other attributes on Job Control Cards. After these are defined, specify the job card you want ( such as J1 or J2) in the Job Class field of other APS screens.

IDMS Options

The APS IDMS DB Options screen let you specify parameters and change default values for your IDMS database target.

Field
 Description and Values

Dictionary Name

Specify the dictionary name.

Central Version or Local

Compile environment. APS generates a SYSTRNL with a unique DSN whose high level qualifier is your user ID.

CV

Default. Central Version.

LOCAL

Also enter a volume in the IDMS Local Jrnl Disk Vol field.

DUMMY

APS generates a SYSTRNL DD DUMMY.

IDMS Local Jrnl Disk Vol

Local compile disk volume for journal.

Dictionary Update

YES

Log program compile information to the dictionary.

NO

Default. Do not log.

IDMS DMLC Output to PDS

YES

Write DMLC compile statements to a PDS. Allocate a &DSN..IDMSOUT PDS prior to compilation.

NO

Default. Do not write DMLC compile statements.

IDMS Loadlib Qualifier

Specify full qualifiers for IDMS..LOADLIB.

IDMS SYSCTL DSN

Specify DSN of IDMS dictionary.

CV Node Name

Name of central version DDS node under which LOADLIB program is compiled.

DMLIST (List Generation)

YES

Generate list.

NO

Default. Do not generate list.

Generate DB-BIND in Pgm

YES

Do not suppress the generation of the DB-BIND macro.

NO

Suppress the generation of the DB-BIND macro. Code the DB-BIND macro in your program.

IDMS Password

N/A

Regenerate Procedures

Follow the procedures below when you make a change to your application.

Add

To add a screen:

  1. Modify the application definition on Application Painter.

  2. Modify the program(s) that utilize the screen in Online Express or on Program Painter.

  3. Generate the screen.

  4. Generate and compile the affected program(s).

    To add a program, data structure, report mock-up, macro PSB, or subchema:

  5. Modify the application definition on Application Painter.

  6. Modify any affected program(s) in Online Express or on Program Painter.

  7. Generate and compile new or affected program(s).

Modify

To modify DB/DC targets:

  1. Modify the application definition on Application Painter.

  2. Modify any other affected entities.

  3. Generate and compile entire application.

    To modify a program, data structure, PSB, or subschema:

  4. Generate and compile affected programs.

    To modify a screen:

  5. If you modify headings, text, or attributes, generate the screen.

  6. If you add, delete, or reshuffle fields, generate the screen and then compile all programs using the screen

    To modify a macro or report mock-up:

  7. Compile the program(s) using the entity.

Delete

To delete a screen, program, data structure, report mock-up, macro, PSB, or subschema:

  1. Modify the application definition on Application Painter.

  2. Modify any other affected entities.

  3. Generate and compile entire application.

Rename

To rename an application:

No modification or generation is required.

To rename a program:

  1. Modify the application definition on Application Painter.

  2. Modify associated screen(s) parameters on Screen Painter Screen Generation Parameters.

  3. Generate affected screen(s).

  4. Generate and compile renamed program.

    To rename a screen:

  5. Modify the application definition on Application Painter.

  6. Modify the program(s) that utilize the screen in Online Express or on Program Painter.

  7. Generate the screen.

  8. Generate and compile the affected program(s).

    To rename a data structure, report mock-up, macro PSB, or subschema:

  9. Modify the application definition on Application Painter.

  10. Modify any affected program(s) in Online Express or on Program Painter.

  11. Generate and compile new or affected program(s).

 

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