Création d'un fichier de configuration de générateur de module de remplacement d'appel

Vous pouvez créer un module de remplacement d'appel pour identifier l'emplacement de votre installation Rational Application Developer et pour contrôler la génération de code de liaison de données Java™.

Avant de commencer

Créez un projet Rational Application Developer pour le code qui est généré par le générateur de module de remplacement d'appel COBOL.

Pourquoi et quand exécuter cette tâche

Le fichier de configuration du générateur de module de remplacement d'appel contient des paramètres permettant d'identifier l'emplacement de votre installation Rational Application Developer et de contrôler la génération de code liaison de données Java. L'emplacement du fichier de configuration est spécifié par le paramètre -configFile pour les appels de ligne de commande ou par l'attribut configFile de la balise <csg> pour les appels Ant.

Assurez-vous que les paramètres requis EclipseHome, WorkSpace et EclipseProjectName dans le fichier de configuration sont corrects pour l'installation Rational Application Developer.

Procédure

  1. Ouvrez un éditeur et créez un fichier de configuration de générateur de module de remplacement d'appel.

    Vous pouvez affecter n'importe quel nom au fichier de configuration de générateur de module de remplacement d'appel. Les exemples de générateur de module de remplacement d'appel COBOL dans ce centre de documentation utilisent le nom de fichier csg.properties.

  2. Indiquez des paramètres de générateur de module de remplacement d'appel COBOL dans le fichier de configuration.
    Le tableau suivant décrit les paramètres de générateur de module de remplacement d'appel.
    Tableau 1. Propriétés permettant de configurer le générateur de module de remplacement d'appel COBOL. Utilisez ces propriétés pour indiquer l'emplacement de l'installation Rational Application Developer et pour contrôler la génération de code de liaison de données Java.
    Name Valeur par défaut Requis ou facultatif Description
    EclipseHome

    [Linux]/opt/IBM/SDP

    [Windows]C:/Program Files/IBM/SDP

    Obligatoire Indique le chemin qualifié complet vers le répertoire racine où Rational Application Developer ou Eclipse est installé dans le système de fichiers.
    Eviter les incidents Eviter les incidents: Utilisez des barres obliques (/), ou n'oubliez pas d'utiliser des caractères d'échappement pour les barres obliques inversées (\\), dans tous les noms de chemin.gotcha
    WorkSpace   Obligatoire Indique le chemin qualifié complet vers le répertoire racine de l'espace de travail Rational Application Developer ou Eclipse à utiliser pour créer la classe de liaison de données Java.
    EclipseProjectName   Obligatoire Indique le nom du projet dans l'espace de travail Rational Application Developer ou Eclipse qui sert de base à la classe Java générée.

    Le projet doit exister avant l'exécution du générateur de module de remplacement d'appel.

    Plateforme Win32 Facultatif Indique le système d'exploitation cible. Les valeurs prises en charge sont Win32, AIX et z/OS. Cette valeur est sensible à la casse.
    CodePage ISO-8859-1 Facultatif Indique la page de codes des données COBOL.
    FloatingPointFormat IEEE 754   Indique le format des virgules flottantes. Les valeurs prises en charge sont IEEE 754 et IBM Hexadecimal.
    ExternalDecimalSign ASCII Facultatif Indique le séparateur décimal externe. Les valeurs prises en charge sont ASCII, EBCDIC et EBCDIC Custom.
    Endian Little Facultatif Spécifie l'endian des données COBOL. Les valeurs prises en charge sont Little et Big.
    RemoteEndian Little Facultatif Spécifie l'endian distant des données COBOL. Les valeurs prises en charge sont Little et Big.
    Quote DOUBLE Facultatif Indique le format des guillemets. Les valeurs prises en charge sont DOUBLE et SINGLE.
    Trunc STD Facultatif Indique la façon dont les zones sont tronquées lors des opérations de calcul ou de déplacement COBOL. Les valeurs prises en charge sont STD, BIN et OPT.
    Nsymbol DBCS Facultatif Indique la façon dont le symbole N est utilisé dans les littéraux et les clauses PICTURE, pour indiquer s'il est nécessaire d'utiliser le traitement national ou DBCS. Les valeurs prises en charge sont DBCS et NATIONAL.
    OverwriteExistingClass true Facultatif Indique si le générateur de module de remplacement d'appel remplace une classe de même nom déjà présente dans le répertoire de sortie. Les valeurs valides sont true et false.
    GenerationStyle Valeur par défaut Facultatif Indique le style de génération. Les valeurs prises en charge sont Default, Preserve case of names et Shorten names.
    Prolixe false Facultatif Indique si le niveau de trace défini doit permettre le débogage. Les valeurs valides sont true et false.
  3. Sauvegardez le fichier de configuration dans un emplacement accessible par le produit Rational Application Developer.

Exemple

Examinez l'exemple de fichier de configuration de générateur de module de remplacement d'appel csg.properties :

# Configuration file for COBOLCallStubGenerator
#####
# EclipseHome specifies the installation location of Rational Application Developer.
#
EclipseHome=full_path_to_Eclipse_directory
 
#####
# Workspace specifies the location of the Rational Application Developer workspace.
# If it does not exist, the COBOLCallStubGenerator creates the workspace.
#
WorkSpace=full_path_to_workspace_directory
 
######
# EclipseProjectName specifies the project in the workspace
# that will receive the generated call stubs and bindings.
#
EclipseProjectName=Eclipse_project_name

#####
#  The target operating system. The permitted options are: Win32, AIX and z/OS.
#
# PARAMETER - Required
# Platform=Win32
Platform=z/OS

#####
#  The target codepage.
#
# PARAMETER - Required
CodePage=IBM1047

#####
# The floating point format has only two possible values: 
#   IEEE 754
#   IBM Hexadecimal
#   The default is IEEE 54
#
# PARAMETER - Required
FloatingPointFormat=IBM Hexadecimal

# PARAMETER - Required
ExternalDecimalSign=EBCDIC

# PARAMETER - Required
Endian=Big

# PARAMETER - Required
RemoteEndian=Little

# PARAMETER - Required
Quote=DOUBLE

# PARAMETER - Required
Trunc=STD

# PARAMETER - Required
Nsymbol=DBCS

#####
# Possible values for overwriteExistingClass are true or false.
#
# PARAMETER - Required
OverwriteExistingClass=true

#####
# Possible values for GenerationStyle are:
#   Default, "Preserve case of names" or "Shorten names"
# Be sure to use quotes for values with space characters in them.
#
# PARAMETER
GenerationStyle=Default

#####
# Verbose sets the trace level to "debug".
# Values for Verbose are either true or false. 
#
# PARAMETER - Optional
Verbose=false

Que faire ensuite

Exécutez le générateur de module de remplacement d'appel COBOL. Vous pouvez exécuter le générateur de remplacement d'appel à partir d'une ligne de commande, d'une tâche Ant ou de l'interface graphique de Rational Application Developer.

Indiquez un chemin qualifié complet vers le fichier de configuration du générateur de module de remplacement d'appel lorsque vous exécutez le générateur de module de remplacement d'appel COBOL. Pour les appels en ligne de commande, utilisez le paramètre -configFile pour spécifier le nom de fichier. Pour les appels Ant et depuis l'interface graphique, utilisez l'attribut configFile qui se trouve dans la tâche <csg> pour spécifier le nom de fichier.


Icône indiquant le type de rubrique Rubrique de tâche



Icône d'horodatage Dernière mise à jour: last_date
http://www14.software.ibm.com/webapp/wsbroker/redirect?version=cord&product=was-nd-mp&topic=tgrid_cobol_csg_create_config
Nom du fichier : tgrid_cobol_csg_create_config.html