COBOL Preferences

graphics/prefs_cob.png

This page provides links to the following:


COBOL Wrapper Preferences

Use the preferences page COBOL > COBOL Wrapper to set the workspace defaults for target operating system, interface types etc. The settings are used as the defaults for the IDL properties when a new IDL file is created. See Generation Settings - Preferences in the COBOL Wrapper documentation.

Deployment Environments Preferences

Use the preferences page COBOL > Deployment Environments to define a connection to the Deployment Service of the RPC server. See Preferences under Server Mapping Deployment Wizard in the Designer documentation.

IDL Extractor for COBOL Preferences

Use the preferences page COBOL > IDL Extractor for COBOL to perform the following tasks:

Manage COBOL Extractor Environments

A COBOL extractor environment provides defaults for the extraction and refers to COBOL programs and copybooks

  • stored locally on the same machine where the Designer is running, a so-called local COBOL extractor environment, or

  • stored remotely on a host computer, a so-called remote COBOL extractor environment. The Extractor Service is required to access COBOL programs and copybooks remotely with a remote COBOL extractor environment. The Extractor Service is supported on operating systems z/OS and BS2000. See Extractor Service in the RPC Server documentation for Batch | IMS | BS2000.

COBOL extractor environments are offered in the IDL Extractor for COBOL wizard to reference the COBOL programs and copybooks and retrieve defaults for the IDL extraction. To create, edit, duplicate and remove COBOL extractor environments, open the preferences page COBOL > IDL Extractor for COBOL and use the buttons on the right.

graphics/prefs_cobExtractor_envs.png

This section describes how to create the following extractor environments:

Creating a New Local Extractor Environment

This section describes the four steps for creating a new local COBOL extractor environment to extract COBOL programs stored inside Software AG Designer or locally on your PC.

Start of instruction setTo create a new local extractor environment

  1. Define the new local environment. On the New Environment page you can specify Name and Operating system.

    graphics/prefs_defineNewLocal.png

    Define the new environment settings:

    • Enter a unique Name for the COBOL extractor environment.

    • Select the Operating system where the COBOL source originates from.

    • Select "Local" for Source Location.

  2. Define the default settings. The Default Settings page provides defaults for Step 4: Define the Extraction Settings and Start Extraction in Using the IDL Extractor for COBOL - Overview. You can set defaults for interface type and COBOL to IDL mapping.

    graphics/prefs_local-mainframe_default.png

    Define the default extraction settings:

    Press Next.

  3. Define the local extractor environment. On the Local Extractor Environment page you can provide a default directory name for the COBOL programs:

    graphics/prefs_local-mainframe_extractorEnv.png

    Choose Workspace... or File System... to browse for a folder. Continue with Next.

  4. Define the local copybook locations. On the Local Copybook Location page you can add directories that will be used to resolve copybooks. Copybooks and members referenced with COPY statements, CA Librarian -INC statements and CA Panvalet ++INCLUDE statements will be searched for in the defined local directories:

    graphics/prefs_local-mainframe_copybook.png

    The file extensions for copybooks can also be entered. If no extensions are specified, the IDL Extractor for COBOL wizard will try to locate copybooks without any file extensions.

    Press Workspace... or File System... to browse for a folder.

    Press Finish.

Creating a New Remote Extractor Environment (z/OS)

This section describes the four steps for creating a new remote COBOL extractor environment to extract remotely z/OS COBOL programs stored in partitioned data sets or CA Librarian data sets.

Start of instruction setTo create a new remote extractor environment

  1. Define the new remote environment. >On the New Environment page you can specify Name, Operating system and the Remote Source Location.

    graphics/prefs_remote-zos_remoteEnv.png

    Define the new environment settings:

    • Enter a unique name for the COBOL extractor environment.

    • Select the Operating system.

    • Select "Remote" for Source location.

  2. Define the default settings.The Default Settings page provides defaults for Step 4: Define the Extraction Settings and Start Extraction in Using the IDL Extractor for COBOL - Overview.

    You can set defaults for Interface Type and COBOL to IDL Mapping.

    graphics/prefs_local-mainframe_default.png

    Define the default settings. See Define the default settings in section Creating a New Local Extractor Environment. Continue with Next.

  3. Define the remote extractor environment. The connection to the Extractor Service to browse for COBOL programs is defined on the Remote Extractor Environment page. See Extractor Service.

    graphics/prefs_remote-zos_extractorEnv.png

    Define the remote extractor environment:

    • Under Broker Parameters, enter the required fields Broker ID and Server Address, usually "RPC/<servername>/CALLNAT". The timeout value must be in the range 1-9999 seconds (default is 60).

    • The EntireX Authentication parameters describe the settings for the broker. See Authentication of User.

    • The RPC Server Authentication parameters describe the settings for the RPC server. See Administering the RPC server | Administering the RPC Server for IMS.

    • A high-level qualifier is required in the Data Set Name or HLQ field. The extractor service will then offer only data sets with this high-level qualifier.

    • In the Member Name field you can provide a prefix for the partitioned data set or CA Librarian members. The extractor service will then offer only members beginning with this prefix.

    Continue with Next.

  4. Define the remote copybook locations. On the Remote Copybook Location page you can add PDS or CA Librarian data sets that will be used to resolve copybooks. Copybooks and members referenced with COPY statements and CA Librarian -INC statements will be searched for in the defined remote data sets:

    graphics/prefs_remote-zos_copybook.png

    Press Insert... to add a new data set entry in the table. Use Remove, Up and Down to manage the data set list.

    Press Finish.

Creating a New Remote Extractor Environment (BS2000)

This section describes the four steps for creating a new remote COBOL extractor environment to extract remotely BS2000 COBOL programs stored in LMS libraries.

Start of instruction setTo create a new remote extractor environment

  1. Define the new remote environment. On the New Environment page you can specify Name, Operating system and the Remote Source Location.

    graphics/prefs_remote-bs2_remoteEnv.png

    Define the new environment settings:

    • Enter a unique name for the COBOL extractor environment.

    • Select the Operating system

    • Select "Remote" for Source location

  2. Define the default settings. The Default Settings page provides defaults for Step 4: Define the Extraction Settings and Start Extraction in Using the IDL Extractor for COBOL - Overview.

    You can set defaults for Interface Type and COBOL to IDL Mapping.

    graphics/prefs_remote-bs2_default.png

    Define the default extraction settings:

    Continue with Next.

  3. Define the remote extractor environment. The connection to the Extractor Service to browse for COBOL programs is defined on the Remote Extractor Environment page. See Extractor Service.

    graphics/prefs_remote-bs2_extractorEnv.png

    Define the remote extractor environment:

    • Under Broker Parameters, enter the required fields Broker ID and Server Address, usually "RPC/<servername>/CALLNAT". The timeout value must be in the range 1-9999 seconds (default is 60).

    • The EntireX Authentication parameters describe the settings for the broker. See Authentication of User.

    • The RPC Server Authentication parameters describe the settings for the RPC server. See Configuring the RPC Server.

    • A high-level qualifier can be entered in the LMS Library Name or HLQ field. The extractor service will then offer only LMS libraries with this high-level qualifier. You can use wildcard notation with asterisk to specify a range of values.

    • In the Element Name field you can provide a prefix for LMS library source elements. The extractor service will then offer only COBOL programs beginning with this prefix.

    Continue with Next.

  4. Define the remote copybook locations. On the Remote Copybook Location page you can add directories that will be used to resolve copybooks. Copybooks referenced with COPY statements will be searched for in the defined remote LMS libraries:

    graphics/prefs_remote-bs2_copybook.png

    Press Insert... to add a new data set entry in the table. Use Remove, Up and Down to manage the list of LMS libraries.

    Press Finish.

Define Prefixes for IDL Parameter Names

You can also use the preferences page COBOL > IDL Extractor for COBOL to define prefixes for IDL parameter names.

graphics/prefs_cobExtractor_filler.png

The defined prefixes are used for FILLER Pseudo-Parameter and are valid for all COBOL extractor environments.