Propriétés d’une méthode
Utilisez la page Propriétés de la méthode pour définir les propriétés array, COBOL, design, host definition et recordset sur la méthode.
Propriétés du tableau
| Propriété | Pour |
|---|---|
| Dimensions du tableau | Sélectionnez les dimensions du tableau pour la valeur de retour. La valeur par défaut est (none). |
| Est un tableau | Indiquez si la valeur de retour est un tableau. Les valeurs possibles sont les suivantes : - Vrai - False (valeur par défaut) |
| Se produit en fonction de | Sélectionnez pour indiquer qu’un élément de données numérique précédant la table (recordset ou tableau dans Automation) indique le nombre réel de lignes ou d’éléments envoyés ou reçus. Équivalent aux tables de longueur variable dans COBOL. Utilisez la liste déroulante pour sélectionner l’élément de données numérique qui spécifie cette valeur. Pour CICS Link, le jeu d’enregistrements ou le tableau et le spécificateur de longueur associé doivent être in/out. Les données de la mémoire tampon qui suivent une table de longueur variable suivent immédiatement le dernier élément de données de la table, quelle que soit la taille maximale spécifiée pour la table. Les tableaux avec plusieurs dimensions ne peuvent être utilisés que pour la boucle la plus externe (COBOL) ou la dimension la plus à droite (Microsoft® Visual C++ ® ou Visual Basic). La valeur par défaut est (none). |
Propriétés COBOL
| Propriété | Pour |
|---|---|
| Type de données hôte | Sélectionnez le type de données hôte. |
| Gestion des erreurs | Sélectionnez la gestion des erreurs de valeur de retour. Les valeurs possibles sont les suivantes : - Tronquer. Sélectionnez cette option pour définir TI de manière à tronquer la valeur en cas d’erreur. (par défaut) - Ronde. Sélectionnez cette option pour définir TI pour arrondir la valeur en cas d’erreur. - Erreur. Sélectionnez cette option pour définir TI de manière à renvoyer une erreur lorsqu’une erreur se produit. |
| Caractère de remplissage | Tapez le remplissage de valeur de retour. La valeur par défaut est 0. |
| À partir de l’hôte | Tapez le nombre d’octets de FILLER qui suit cet élément de données dans les mémoires tampons reçues du serveur. FILLER provoque un écart non traduit dans la mémoire tampon. FILLER n’est pas visible côté Automation. La valeur par défaut est 0. |
| Pour héberger | Tapez le nombre d’octets de FILLER qui suit cet élément de données dans les mémoires tampons envoyées au serveur. FILLER provoque un écart non traduit dans la mémoire tampon. FILLER n’est pas visible côté Automation. La valeur par défaut est 0. |
| Mettre à l'échelle | Tapez l’échelle de valeur de retour. |
| Attribut sign | Sélectionnez l’attribut signe de valeur de retour. Les valeurs possibles sont les suivantes : - À la fin. Pour le type de données DISPLAY signé, indique que le signe est à la fin (par défaut). Cette option indique à l’environnement d’exécution TI comment un type de données DISPLAY signé est mis en forme et affecte la conversion des données de l’hôte vers et à partir du type de données Automation. - Fin séparée. Pour le type de données DISPLAY signé, indique que le signe est distinct. Cette option indique à l’environnement d’exécution TI comment un type de données DISPLAY signé est mis en forme et affecte la conversion des données de l’hôte vers et à partir du type de données Automation. - En tête. Pour le type de données DISPLAY signé, indique que le signe est en tête. Cette option indique à l’environnement d’exécution TI comment un type de données DISPLAY signé est mis en forme et affecte la conversion des données de l’hôte vers et à partir du type de données Automation. - Début séparé. Pour le type de données DISPLAY signé, indique que le signe est distinct. |
| Taille | Tapez la taille de la valeur de retour. |
| SOSI | Sélectionnez cette option pour spécifierque les données d’un jeu de caractères à deux octets sont censées commencer par un décalage sortant (SO) et se terminer par un caractère maj-in (SI). Les valeurs possibles sont les suivantes : - True. Les caractères SO et SI sont supprimés des données lorsqu’elles sont reçues de l’application hôte, et les caractères SO et SI sont ajoutés aux données lorsqu’elles sont envoyées à l’application hôte. Dans la longueur du G PIC, il n’est pas nécessaire d’inclure les deux octets pour les caractères SO et SI, car l’environnement d’exécution TI les applique. - False (valeur par défaut) |
| Limitation des chaînes | Sélectionnez la limitation de la chaîne de valeur de retour. Les valeurs possibles sont les suivantes : - Espace rembourré. Indique à l’environnement d’exécution TI que la représentation mainframe de la chaîne est délimitée en remplissant la définition de chaîne avec des caractères d’espace. Par exemple, si la définition COBOL du mainframe est PIC X(10) mais que seuls trois caractères se trouvent dans la chaîne, le mainframe attend sept espaces de fin. Par conséquent, la sélection de cette option indique à l’environnement d’exécution TI de convertir les chaînes envoyées au mainframe pour modifier le caractère d’arrêt NULL de la chaîne en nombre approprié d’espaces de fin avant de l’envoyer au mainframe. Par exemple, si la chaîne est définie sur le mainframe comme PIC X(10), TI envoie une chaîne abc suivie de sept espaces de fin. La sélection de cette option indique également à l’environnement d’exécution TI de convertir la chaîne de sortie retournée à partir du mainframe vers le serveur TI Automation en convertissant les espaces de fin de la chaîne en un seul caractère d’arrêt Null. Pour plus d’informations, consultez Remplissage de chaînes de caractères mainframe avec des espaces. (par défaut) - Terminé par null. Indique à l’environnement d’exécution TI que la représentation mainframe de la chaîne est délimitée par un caractère null (EBCDIC 0x00). La sélection de cette option indique à l’environnement d’exécution TI d’ajouter un caractère null unique à la fin d’une chaîne s’il y a de la place pour l’octet avant d’envoyer une chaîne au mainframe, et indique à l’environnement d’exécution TI de s’arrêter au premier caractère null rencontré lors de la réception d’une chaîne à partir du mainframe. Par conséquent, en sélectionnant cette option, vous indiquez à TI de conserver les espaces de fin dans les chaînes de sortie provenant du mainframe, car TI ne convertira pas les espaces de fin en un seul terminateur NULL. Pour plus d’informations, consultez Remplissage de chaînes de caractères mainframe avec des espaces. |
Propriétés de conception
| Propriété | Pour |
|---|---|
| Autoriser 32 000 entrée/sortie | Sélectionnez cette option si vous souhaitez que TI traite l’entrée DFHCOMMAREA indépendamment de la sortie DFHCOMMAREA. TI combine généralement la zone DFHCOMMAREA d’entrée et la zone DFHCOMMAREA de sortie. Les zones combinées ne peuvent pas dépasser 32 Ko de données. Lorsque cette option est sélectionnée, TI traite l’entrée DFHCOMMAREA indépendamment de la sortie DFHCOMMAREA. Chaque zone d’entrée et de sortie utilise jusqu’à 32 Ko de données. La modification de cette option affecte la méthode actuellement sélectionnée. Les valeurs possibles sont les suivantes : - Vrai - False (par défaut) Remarque : vous pouvez utiliser cette propriété en tant qu’accessoire pour « Utiliser le modèle de programmation de lien » dans le modèle de programmation CICS initié par Windows (WIP) et dans tous les modèles de programmation HIP (traitement initié par l’hôte). Note: Cette propriété n’est disponible que si la propriété Is Link a la valeur True. |
| Description | Tapez une description de la méthode. La description peut être d’un maximum de 250 caractères Unicode. |
| ID de contexte d’aide | Tapez l’ID de contexte d’aide associé à cette méthode. L’ID est utilisé pour se connecter à l’aide pour cette méthode et retourné lorsqu’une exception se produit pendant l’appel de cette méthode. La valeur par défaut est 0. |
| Inclure le paramètre de contexte | Indiquez si la méthode d’objet client inclut automatiquement le contexte. Les valeurs possibles sont les suivantes : - True. Visual Basic .NET inclut automatiquement le contexte comme paramètre supplémentaire dans l’argument. Si vous n’incluez pas le paramètre COMTIContext dans votre appel de méthode avec vos autres paramètres, Visual Basic .NET retourne le message d’erreur Une exception non prise en charge de type « System.MissingMemberException » s’est produite dans microsoft.visualbasic.dll et vous informe que la méthode ne peut pas être appelée avec le nombre de paramètres que vous avez écrits. Si vous recevez ce message, vérifiez que le paramètre de contexte Include est inclus en tant que paramètre dans la liste des paramètres de la méthode. - False. Visual Basic .NET n’inclut pas automatiquement le contexte comme paramètre supplémentaire dans l’argument. Si vous définissez cette propriété sur False et que vous incluez le paramètre COMTIContext dans votre appel de méthode avec vos autres paramètres, Visual Basic .NET retourne le message d’erreur Une exception non prise en charge de type « System.MissingMemberException » s’est produite dans microsoft.visualbasic.dll et vous informe que la méthode ne peut pas être appelée avec le nombre de paramètres que vous avez écrits. Si vous recevez ce message, supprimez le paramètre COMTIContext de la liste des paramètres de méthode. La valeur par défaut est True. |
| Valeur de mémoire tampon initiale | Tapez la valeur de mémoire tampon initiale. La valeur par défaut est null. |
| Is Link | Indiquez si la méthode d’objet hôte utilise le modèle de programmation Link. Les valeurs possibles pour le traitement initié par Windows (WIP) sont les suivantes : - True. Utilisez le modèle de lien. Le modèle de programmation de liaison ne peut être utilisé qu’avec les protocoles de liaison CICS. - False. N’utilisez pas le modèle de lien. La valeur par défaut est False. Les valeurs possibles pour le traitement initié par l’hôte (HIP) sont les suivantes : - Oui. Utilisez le modèle de lien. Le modèle de programmation de liaison peut être utilisé avec tous les protocoles. - Non. N’utilisez pas le modèle de lien. - Lier à l’aide de 32 000 in/out. Utilisez le modèle de lien et définissez les propriétés From Host et To Host. La valeur par défaut est No. |
| Métadonnées | Sélectionnez la façon dont les métadonnées sont gérées. Les valeurs possibles sont les suivantes : - (none). Par défaut, aucune donnée spéciale n’est envoyée ou reçue de l’application hôte. Sélectionnez ce bouton d’option si vous souhaitez uniquement envoyer et recevoir les données de la méthode. - Informations sur la méthode Include. Nom de cette méthode à envoyer à l’hôte avec les données de paramètre. Le nom de la méthode est envoyé sous la forme des 32 premiers octets de la mémoire tampon. Cette option est utile si plusieurs appels de méthode vont à la même transaction et que vous souhaitez différencier les données des différents appels. - Incluez toutes les informations. Toutes les métadonnées disponibles pour être envoyées et reçues avec vos données de méthode. Pour plus d’informations sur le format des métadonnées, consultez la description de « Métadonnées facultatives ». |
| Nom | Tapez le nom de la méthode. Le nom peut être d’un maximum de 250 caractères Unicode. Le nom doit être différent de tout autre nom de méthode dans le même projet. La valeur par défaut est null. |
| Placer la valeur de retour après | Tapez la valeur de retour de la méthode Automation qui suit l’élément de données sélectionné lorsqu’il est reçu de l’hôte. Cette option n’affecte pas le côté Automation. Utilisez cette option lorsque l’élément de données que vous souhaitez spécifier comme valeur de retour Automation n’est pas le premier champ d’élément de données de la déclaration de données qui décrit les données reçues de l’hôte. |
| Remplissage préliminaire | Affichez le nombre d’octets de FILLER reçus de ou envoyés à l’hôte. |
| À partir de l’hôte | Tapez le nombre d’octets de FILLER qui suit cet élément de données dans les mémoires tampons reçues du serveur. FILLER provoque un écart non traduit dans la mémoire tampon. FILLER n’est pas visible côté Automation. |
| Pour héberger | Tapez le nombre d’octets de FILLER qui suit cet élément de données dans les mémoires tampons envoyées au serveur. FILLER provoque un écart non traduit dans la mémoire tampon. FILLER n’est pas visible côté Automation. |
| Type de retour | Sélectionnez le type de valeur de retour. Les valeurs possibles sont les suivantes : - Vide - Boolean - Octet - Date - Monnaie - Decimales - Entier - Long - Double - Seul - String - Type défini par l’utilisateur - Recordset - (none) (valeur par défaut) |
| Champ final de taille variable | - Sélectionnez cette option lorsque le dernier élément de données est une chaîne pour indiquer que la taille de la chaîne varie. Cette option est également utilisée pour définir une table de données ou un jeu d’enregistrements comme étant limité ou comme incluant toutes les lignes telles que définies en tant qu’occurrence maximale définie sur le paramètre . |
| À partir de l’hôte | - Vrai - False (valeur par défaut) |
| Pour héberger | - Vrai - False (valeur par défaut) |
Propriétés de définition d’hôte
| Propriété | Pour |
|---|---|
| Lien vers le nom du programme | Tapez le nom du lien vers le programme (CICS LINK/DPL). |
| ID de transaction miroir | Tapez la miroir TRANID utilisée par cette méthode, si vous souhaitez remplacer l’miroir TRANID pour l’environnement distant (RE) auquel ce composant est associé. Le fait de laisser cette zone vide entraîne l’utilisation de l’miroir TRANID dans la description de l’environnement distant. Le TRANID peut avoir jusqu’à quatre caractères. Les caractères acceptables sont A-Z a-z 0-9 $ @ # . / _ % & ? ! : | = , ; <>. Les noms de transaction commençant par C sont réservés à CICS et ne doivent pas être utilisés. Les caractères % et & peuvent entraîner des problèmes avec l’installation de Access Control de ressources (RACF) si la sécurité des transactions est active. |
| TP Name | Tapez un nom de programme transactionnel source (TP) lorsque le programme d’application CICS doit accéder à une base de données DB2. Le nom tp est référencé dans une entrée RCT (Resource Control Table) CICS, qui associe les transactions CICS aux plans DB2. Spécifie le nom du programme de transaction hôte (IMS ou CICS) ou le nom du lien vers le programme (CICS LINK/DPL). |
Propriétés d’un jeu d’enregistrements
| Propriété | Pour |
|---|---|
| Inclure la taille réelle | Le programme hôte n’inclut pas ou n’attend aucune information indiquant le nombre réel de lignes (jeux d’enregistrements) ou d’éléments (tableaux) envoyés ou reçus. Les valeurs possibles sont les suivantes : - Vrai - False (valeur par défaut) Cette propriété est en lecture seule et sera toujours définie sur False , sauf si elle a été définie sur True au moment où la bibliothèque de types a été créée avec la première version de COM Transaction Integrator. |
| Occurrence maximale | Occurrence de ligne maximale. Indique le nombre maximal de lignes à envoyer ou à recevoir de l’hôte. Équivaut à l’mot clé OCCURS n TIMES sur un élément de groupe COBOL. La valeur par défaut est 1. |
| Se produit en fonction de | Équivalent aux tables de longueur variable dans COBOL. Indique qu’un élément de données numérique précédant la table (recordset ou tableau dans Automation) indique le nombre réel de lignes ou d’éléments envoyés ou reçus. Utilisez la liste déroulante pour sélectionner l’élément de données numérique qui spécifie cette valeur. Pour CICS Link, le jeu d’enregistrements ou le tableau et le spécificateur de longueur associé doivent être in/out. Les données de la mémoire tampon qui suivent une table de longueur variable suivent immédiatement le dernier élément de données de la table, quelle que soit la taille maximale spécifiée pour la table. Pour les tableaux avec plusieurs dimensions, il ne peut être utilisé que pour la boucle la plus externe (COBOL) ou la dimension la plus à droite (Visual C++ ou Visual Basic). Le jeu d’enregistrements de valeur de retour se produit en fonction de . La valeur par défaut est (aucun). |
| Illimitée | Indique que le jeu d’enregistrements est indépendant. Indique qu’un nombre quelconque de lignes peut être envoyé ou reçu de l’hôte. Vous devez sélectionner cette option lorsque les lignes envoyées ou reçues proviennent d’une base de données et que le nombre maximal de lignes n’est pas connu. Les valeurs possibles sont les suivantes : - True. Lorsque le dernier élément de données est une chaîne, cela signifie que la taille de la chaîne varie. - False. Lorsque le dernier élément de données est un tableau, cela signifie que le nombre d’éléments dans le tableau varie. Lorsque le dernier élément de données est un jeu d’enregistrements, cela signifie que le nombre de lignes dans le jeu d’enregistrements varie. (par défaut) |
Attention
Les propriétés d’un composant ne sont pas destinées à être définies ou modifiées par programmation. La définition ou la modification des propriétés par programmation peut entraîner un fonctionnement incorrect du composant.
Voir aussi
Messages de demande de transaction et messages d’écouteur amélioré avec COMTIContext
Nom de méthode, nœud (.NET)
Propriétés (Projet d’intégrateur de transactions)