Ajout d'un paramètre

Utilisez la page Ajouter un paramètre de l'assistant Appel de programme pour définir un paramètre requis par l'objet programme ou programme de service que vous souhaitez appeler. Un programme de service comporte au maximum 7 paramètres. Cochez la case Options avancées pour afficher les attributs avancés d'un paramètre. Pour plus d'informations sur toutes les zones IBM® Toolbox for Java™, voir PCML data tag.

Option Description
Nom de paramètre Nom du paramètre. Il doit s'agir d'un nom de variable Java admis.
Type de données Type de données utilisé pour le paramètre.
Caractère :
Renvoyé en tant que valeur java.lang.String. La valeur par défaut pour le type de données est caractère. Ce type de données occupe un octet pour chaque caractère.
UCS-2/graphique :
Renvoyé en tant que valeur java.lang.String. Ce type de données occupe deux octets pour chaque caractère.
Entier :
Renvoyé en tant que valeur java.lang.Long.
Décimal condensé :
Renvoyé en tant que valeur java.math.BigDecimal.
Décimal étendu :
Renvoyé en tant que valeur java.math.BigDecimal.
Virgule flottante :
Renvoyé en tant que valeur java.lang.Float si une longueur égale à 4 est indiquée ; sinon, renvoyé en tant que valeur java.lang.Double pour une longueur égale à 8.
Octet :
Renvoyé en tant que tableau de valeurs en octets (byte[]). Les données ne sont pas converties.
Structure :
Renvoie le type de données en tant que structure si le paramètre est une structure.
Nom de structure :
Nom de la structure. Pour indiquer un paramètre avec structure comme type de données, définissez d'abord la structure en cliquant sur Ajouter une structure. Si la structure est définie et que vous avez utilisé structure comme type de données, une liste de noms de structure s'affiche dans la zone Nom de structure.
Longueur Longueur requise par ce paramètre. Voir Valeurs de longueur et de précision. Vous pouvez entrer une valeur numérique ou sélectionner une valeur dans la liste déroulante. La liste comprend des éléments de données de type entier utilisés par le programme.
Précision Nombre d'octets de précision pour certains types de données numériques. Voir Valeurs de longueur et de précision.
Count Taille du tableau. Si Nombre est à blanc, le paramètre n'est pas défini en tant que tableau. Il peut toutefois être défini en tant qu'élément d'une structure définie en tant que tableau.
Usage Usage du paramètre (les données de type caractère et numérique sont converties) :
input :
Valeur en entrée dans le programme hôte.
output :
Valeur en sortie provenant du programme hôte. Les données de type caractère et numérique sont converties.
input & output :
A la fois valeur en entrée et en sortie. Il s'agit de la valeur par défaut.
inherit :
L'usage est hérité de l'élément parent. Si la structure n'a pas de parent, l'usage devient input & output.
Valeur initiale Valeur initiale du paramètre si elle n'est pas définie explicitement par le programme d'application lorsque l'usage du paramètre est input ou input & output. Reportez-vous à la description de l'attribut init dans la rubrique PCML data tag.
Taille en sortie Nombre d'octets réservés pour les données en sortie du paramètre. Cette zone doit être laissée à blanc pour les paramètres de sortie de longueur fixe. Reportez-vous à la description de l'attribut outputsize dans la rubrique PCML data tag.
Trim

Enlèvement de blancs dans une donnée de type caractère :

right :
Enlèvement des blancs de fin. Ce paramètre est sélectionné par défaut.
left :
Enlèvement des blancs de tête.
both :
Enlèvement des blancs de tête et de fin.
none :
Pas d'enlèvement des blancs.
Chaîne de type bidirectionnel Chaîne de type bidirectionnel pour les paramètres avec données de type character (caractère). Reportez-vous à la description de l'attribut bidistringtype dans la rubrique PCML data tag.
Version minimale Version minimale d'IBM i dans laquelle cet élément existe. Reportez-vous à la description de l'attribut minvrm dans la rubrique PCML data tag.
Version maximale Version maximale d'IBM i dans laquelle cet élément existe. Reportez-vous à la description de l'attribut maxvrm dans la rubrique PCML data tag.
Position Position de l'élément dans un paramètre de sortie. Reportez-vous à la description de l'attribut offset dans la rubrique PCML data tag.
Décalage à partir de Emplacement de base par rapport auquel l'attribut offset est défini. Reportez-vous à la description de l'attribut offsetfrom dans la rubrique PCML data tag.
CCSID ID de jeu de caractères codés de l'hôte pour les paramètres de type caractère. Si cette zone est laissée à blanc, le CCSID par défaut de l'environnement hôte est utilisé. Reportez-vous à la description de l'attribut ccsid dans la rubrique PCML data tag.
Transmis par Mode de transmission du paramètre. (Uniquement pour les paramètres d'appel de programme de service)
reference :
Le paramètre est transmis par référence. Lors de l'appel du programme, un pointeur désignant la valeur du paramètre est transmis au programme.
value :
Le paramètre est transmis par un entier. Cette valeur est autorisée avec les données de type integer (entier) et une longueur de 4.

Valeurs des attributs de longueur et de précision

Les attributs de longueur et de précision ont des valeurs différentes selon le type de données. Le tableau suivant répertorie les différents types de données avec une description des valeurs de longueur et de précision possibles.

Type de données Longueur Précision
Caractère Nombre de caractères pour ce paramètre Non applicable
UCS-2/graphique : Nombre de caractères pour ce paramètre Non applicable
Entier Nombre d'octets pour ce paramètre Indique le nombre de bits de précision et si l'entier est signé ou non signé.
2 octets Utilisez une valeur de précision de 15 pour un entier signé de 2 octets (par défaut).

Utilisez une valeur de précision de 16 pour un entier non signé de 2 octets

4 octets Utilisez une valeur de précision de 31 pour un entier signé de 4 octets.

Utilisez une valeur de précision de 32 pour un entier non signé de 4 octets.

8 octets Utilisez une valeur de précision de 63 pour un entier signé de 8 octets.
Décimal condensé ou décimal étendu Nombre de chiffres de données pour ce paramètre Nombre de chiffres décimaux pour ce paramètre. Ce nombre doit être supérieur ou égal à zéro et inférieur ou égal au nombre total de chiffres indiqué dans la zone longueur.
Virgule flottante Nombre d'octets pour ce paramètre : 2, 4 ou 8 Non applicable
byte Nombre d'octets de données pour ce paramètre Non applicable
Structure Non admis Non applicable

Le tableau suivant indique la longueur et la précision correspondantes pour une déclaration d'entier dans un programme RPG :

3 byte 1 Non applicable
5 Entier 2 15 pour un entier signé, 16 pour un entier non signé
10 Entier 4 31 pour un entier signé, 32 pour un entier non signé
20 Entier 8 63 pour un entier signé

Le tableau suivant indique la longueur et la précision correspondantes pour une déclaration d'entier dans un programme COBOL :

PIC 9(1) à PIC 9(4) Entier 2 15
PIC 9(5) à PIC 9(9) Entier 4 31
PIC 9(10) à PIC 9(18) Entier 8 63

Commentaires en retour