Rational Programming Patterns for System z

Assistant de création de Rubrique

Vous devez renseigner toutes les zones de cet assistant pour créer une Rubrique.

Projet
Sélectionnez un projet dans la liste déroulante ou saisissez le nom d'un projet dans laquelle l'instance sera sauvegardée.

Un projet représente la répartition physique de vos instances dans l'espace de travail. Il regroupe des répertoires et des fichiers. Il sert à organiser les ressources qui pourront ensuite être générées, partagées ou versionnées.

Un projet Pacbase contient un sous-ensemble de fichiers qui correspondent aux modèles et/ou sources générés constituant une application Pacbase.

Il peut y avoir plusieurs projets par référentiel (un référentiel est l'équivalent d'une base de données)

Package
Sélectionnez un package dans la liste déroulante ou saisissez le nom d'un nouveau package.

Un package est un regroupement logique d'informations.

Les ressources logiques contenues dans un package peuvent être réparties dans plusieurs projets.

Les packages représentent les branches de vos projets. Chaque package contient ses propres instances.

Pour les ressources transférées depuis Pacbase, la convention de nommage d'un package est : {Nom du référentiel}.{Chemin de la Bibliothèque}.{Nom de la Bibliothèque}. Il est donc conseillé de respecter ces règles de nommage lors de la création d'un package. Pour refléter la hiérarchie des Bibliothèques, saisissez les noms de Bibliothèques (en commençant par la Bibliothèque la plus haute dans la hiérarchie) en les séparant par un point (ex: 'COM.CIF'). Il y aura ainsi une branche de premier niveau, COM, avec ses instances, et une branche de deuxième niveau, CIF, avec ses propres instances.

Nom
Ce nom est un code alphanumérique qui repère la Rubrique indépendamment de toute appartenance à une Structure de Données, à un Etat ou à un Ecran Il est donc inutile d'inclure un code Segment, Etat ou Ecran dans le code Rubrique : ce code sera automatiquement ajouté lors de la génération.

Certains noms de Rubriques ont un emploi réservé dans les Structures de Données, les Etats ou les Ecrans. Leur définition est donc interdite :

Tableau 1. Liste des noms réservés pour les Rubriques
Nom Réservé pour
FILLER Alignement des champs

ENPR

GRPR

ERUT

Contrôle d'erreur sur les fichiers mouvements (options du module Langage Batch) :

Contrôle d'erreurs des Rubriques

Contrôle d'erreurs des Segments

Contrôle d'erreurs définies par l'utilisateur

Rubrique mère
Il est possible de définir des variantes d'une Rubrique, permettant d'en modifier les caractéristiques pour une utilisation particulière. Chaque variante est définie comme une Rubrique fille ayant pour mère la Rubrique concernée. Les caractéristiques issues de la mère sont alors modifiables.

Toutes les Rubriques d'une même famille sont ainsi logiquement reliées dans la base. Une Rubrique fille, étant une variante d'un concept supérieur, ne peut pas être mère à son tour.

Pour indiquer une Rubrique mère, cliquez sur le bouton Modifier et sélectionnez une Rubrique dans l'assistant de sélection.

Format interne
Ce format, affiché aussi dans l'onglet Vue d'ensemble, est obligatoire, sauf si la Rubrique est une Propriété.
Ce format est utilisé lorsque la Rubrique est appelée dans un :
  • Fichier de l'application (fichier permanent, base de données, fichier temporaire),
  • Ecran en entrée de la zone, si aucun format conversationnel n'est indiqué (voir la zone Type de ligne dans l'onglet Lignes -D de l'éditeur de Rubrique).
Ce format est transféré automatiquement vers les Segments où se fait l'appel de Rubrique. Mais vous pouvez finalement choisir le format approprié dans l'onglet Lignes -CD des Programmes qui appellent ces Segments.

Vous devez assurer la compatibilité entre le format interne et le format d'entrée.

Vous devez saisir le format interne comme une picture COBOL, sans caractères d'édition.
Notes :
  • Dans la majorité des cas, le format de type numérique d'une Rubrique est entré tel quel. Toutefois, s'il excède 10 caractères, vous devez supprimer le 9 après la virgule. (par exemple, le format S9(10)V9(3) qui occupe 11 caractères sera entré sous la forme S9(10)V(3) qui n'occupe que 10 caractères, mais il sera généré sous la forme S9(10)V9(3).
  • Pour les Rubriques de type 'Unicode' (type U), vous devez indiquer N(n) ou un format numérique signé ou non.
La clause INTERNAL USAGE concerne ce format seul.
Remarque : Pour les Rubriques de type 'Unicode', si le format interne est numérique signé, l'usage interne doit être X ou 1.
Vous pouvez indiquer les formats symboliques suivants pour les Rubriques de type date :
Tableau 2. Formats symboliques pour les dates
Valeur Signification
D Date sans siècle (JJMMAA ou MMJJAA)
I Date sans siècle (AAMMJJ)
E Date sans siècle (JJ/MM/AA ou MM/JJ/AA)
S Date avec siècle (SSAAMMJJ)
C Date avec siècle (JJMMSSAA ou MMJJSSAA)
M Date avec siècle (JJ/MM/SSAA ou MM/JJ/SSAA)
G Format grégorien (SSAA-MM-JJ)
T Format TIME (HH:MM:SS)
TS Format TIMESTAMP
Remarque : Pour les formats incluant un séparateur (E, G, M, T), vous pouvez indiquer, à la suite du caractère représentant le format, un caractère représentant un séparateur différent de celui prévu par défaut dans le format. Par exemple, vous pouvez indiquer G/ dans cette zone pour générer un format grégorien SSAA/MM/JJ.au lieu du format grégorien standard SSAA-MM-JJ.

Pour l'utilisation des formats avec les différents types de blocs bases de données, se reporter aux tableaux récapitulatifs du chapitre Colonnes : Rubriques dans le Manuel DBD relationnelles SQL, disponible à l'URL suivante :

http://www-1.ibm.com/support/docview.wss?rs=37&context=SSEP67&uid=swg27005478

Définition des paramètres de génération
Les paramètres de génération sont définis dans les Bibliothèques. Ces paramètres sont liés à l'adaptation au système d'exploitation utilisé.

Pour sélectionner une Bibliothèque, cliquez sur le bouton Modifier....

Libellé
Saisissez le libellé identifiant l'instance. Il constituera un critère de recherche lors d'une recherche d'instance.
Ouvrir l'éditeur après la création
Cochez cette boîte pour que l'éditeur de l'instance en création s'ouvre automatiquement. L'éditeur s'ouvrira sur l'onglet 'Vue d'ensemble'. Depuis cet onglet, vous pourrez accéder aux autre onglets de l'instance afin d'en indiquer toutes les caractéristiques.