Tivoli Service Desk 6.0 Developer's Toolkit - Guide du concepteur d'interfaces (Interface Designer)

Chapitre 9 : Codes retour et constantes système de CPIC

Retour à la table des matières


Introduction

Généralités

Les codes retour pouvant être émis pour les commandes CPIC sont classés par ordre alphabétique. Les mnémoniques indiquées avec la description ne correspondent pas à des constantes TSD Script définies par le système. Elles sont uniquement indiquées ici pour servir de modèles à toutes les constantes que vous souhaitez définir.

Codes retour CPIC

Code retour Description
1 CPIC_SUCCESS. Cette valeur est renvoyée par toutes les commandes CPIC lorsque leur exécution aboutit.
-1 CM_ALLOCATE_FAILURE_NO_RETRY. Les tentatives d'attribution de conversation ont échoué. Cette situation nécessite vraisemblablement une intervention de l'utilisateur afin de rectifier la configuration des services du noeud. Il est probable que la limite de session (LU, mode) en cours pour la paire (nom de LU, nom de mode) spécifiée soit égale à 0, ou qu'une erreur soit présente dans la définition du système. Pour résoudre cet incident, vous pouvez tenter de changer le nom de mode de la conversation.
-2 CM_ALLOCATE_FAILURE_RETRY. La tenative d'affectation de conversation a échoué, suite à un événement qui peut être temporaire. Cette condition résulte généralement d'une carence temporaire en ressources au niveau de l'une des LU impliquées dans la conversation. L'application procède automatiquement à une nouvelle exécution de la commande.
-3 CM_CONVERSATION_TYPE_MISMATCH. La LU partenaire rejette la demande, car le partenaire n'assure pas la prise en charge du type de conversation impliqué. Ce code est renvoyé lors d'un appel ultérieur de CPICAllocate.
-5 CM_PIP_NOT_SPECIFIED_CORRECTLY. La LU partenaire a rejeté la demande d'attribution, car plusieurs variables sont définies pour les paramètres d'initialisation de l'application éloignée. Ce type d'appel devrait être lancé à une API autre que CPIC.
-6 CM_SECURITY_NOT_VALID. La LU distante a rejeté la demande, car les informations relatives à la sécurité d'accès sont incorrectes. Ces informations sont fournies par le système des services du noeud local. Cette situation se produit généralement lorsque vous avez configuré la sécurité requise dans les informations annexes de PIC, mais que vous n'avez encore établi aucune connexion avec les services du noeud local. Dans d'autres cas, le mot de passe que vous avez entré pour vous connecter n'est pas reconnu par la machine distante.
-7 CM_SYNC_LVL_NOT_SUPPORTED_LU. Le niveau de synchronisation requis par votre application n'est pas pris en charge par la LU éloignée. CPIC prend uniquement en charge les nivaux de synchronisation de $CPICNone et de $CPICConfirm. Le niveau de synchronisation de SYNC_POINT n'est pas pris en charge.
-8 CM_SYNC_LVL_NOT_SUPPORTED_PGM. Le niveau de synchronisation demandé par vote application n'est pas pris en charge par l'application partenaire. CPIC prend uniquement en charge des niveaux de synchronisation $CPICNone et $CPICConfirm, mais pas de SYNC_POINT.
-9 CM_TPN_NOT_RECOGNIZED. La LU éloignée a rejeté la demande car l'application locale a spécifié un nom de programme de transactions non reconnu par la LU éloignée.
-10 CM_TP_NOT_AVAILABLE_NO_RETRY La LU éloignée a rejeté la demande d'attribution car l'application locale a spécifié un programme de transactions que la LU éloignée reconnaît, mais ne peut démarrer. L'intervention de l'utilisateur est requise dans une certaine mesure.
-11 CM_TP_NOT_AVAILABLE_RETRY. La LU éloignée a rejeté la demande d'attribution car l'application locale a spécifié un programme de transactions que la LU éloignée reconnaît, mais ne peut démarrer immédiatement. Il est possible que cette situation soit seulement temporaire.
-17 CM_DEALLOCATED_ABEND. L'application éloignée a été désaffectée, le type de désaffectation spécifie un abandon, ou bien la LU distante a été désaffectée en raison d'une fin anormale du fonctionnement de l'application éloignée.
-18 CM_DEALLOCATED_NORMAL. L'application éloignée a désaffecté la conversation à l'état normal.
-19 CM_PARAMETER_ERROR. L'application éloignée a lancé une commande CPIC qui spécifie un paramètre non valide. Le terme de "paramètre" concerne les caractéristiques associées à l'identifiant de la conversation. L'incident peut donc être lié à certaines valeurs contenues dans les informations annexes CPIC.
-20 CM_PRODUCT_SPECIFIC_ERROR. Indique que l'application qui lance l'appel (dans le cas présent, la boîte à outils du développeur de Tivoli Service Desk) a décelé une erreur et n'est pas en mesure de poursuivre la conversation. Cette situation survient fréquemment en environnement OS/2, lorsque la variable APPCTPN n'a pas été configurée avant le démarrage d'une application CPIC.
-21 CM_PROGRAM_ERROR_NO_TRUNC. L'application éloignée a lancé un appel SendError sur une conversation de base ou mappée. Aucune donnée n'a été tronquée durant cette opération.
-22 CM_PROGRAM_ERROR_PURGING. L'application éloignée a lancé une erreur SendError. Si l'application éloignée se trouvait à l'état de Réception ou de Confirmation, les informations peuvent être purgées.
-23 CM_PROGRAM_ERROR_TRUNC. L'application éloignée a lancé un appel SendError sur une conversation de base, et l'appel a tronqué un enregistrement logique.
-24 CM_PROGRAM_PARAMETER_CHECK. Votre application CPIC a lancé une commande CPIC dont les informations conteiennent certains paramètres incorrects. Les occurrences de ce code retour sont provoquées par des noms de destination symbolique erronés (erreur de casse, par exemple), ou par un défaut d'initialisation d'un identifiant de conversation. Cet incident peut également concerner les caractéristiques associées à l'identifiant de conversation. Dans ce cas, la source du problème se trouve placée sous le contrôle de l'application locale.
-25 CM_PROGRAM_STATE_CHECK. Votre application a lancé une commande CPIC non valable pour l'état en cours. Par exemple, votre application a tenté d'envoyer des données alors que l'application se trouvait à l'état de Réception.
-26 CM_RESOURCE_FAILURE_NO_RETRY. Suite à une défaillance, la conversation a été achevée prématurément. Cette situation n'est pas temporaire, ce qui signifie par exemple que l'application ne doit pas renouveler l'appel de la commande sans intervention extérieure.
-27 CM_RESOURCE_FAILURE_RETRY. Suite à une défaillance, la conversation a été achevée prématurément. Cette situation est probablement temporaire, ce qui signifie que l'application peut renouveler l'appel de la commande sans qu'une intervention extérieure soit nécessaire.
-28 CM_UNSUCCESSFUL. L'exécution de la commande CPIC a échoué.
-30 CM_DEALLOCATED_ABEND_SVC. L'application a vraisemblablement désaffecté la conversation de base avec un type ABEND_SVC. Dans d'autres cas, l'application éloignée a subi une fin anormale et le système de services du noeud de la LU partenaire a désaffecté la conversation en faveur de l'application éloignée. Ce type d'appel devrait être lancé à une API autre que CPIC.
-31 CM_DEALLOCATED_ABEND_TIMER. L'application a désaffecté la conversation de base avec un type ABEND_TIMER. Ce type d'appel devrait être lancé à une API autre que CPIC.
-32 CM_SVC_ERROR_NO_TRUNC. L'application éloignée a émis une erreur SendError avec un type de SVC et l'instruction n'a provoqué aucune troncature d'enregistrement de données. Ce type d'appel devrait être effectué avec une API autre que CPIC.
-33 CM_SVC_ERROR_PURGING. L'application éloignée a émis une erreur SendError avec un type de SVC, avec troncature possible d'un enregistrement de données. Ce type d'appel devrait être effectué avec une API autre que CPIC.
-34 CM_SVC_ERROR_TRUNC. L'application éloignée a émis une erreur SendError avec un type de SVC et une troncature d'enregistrement de données. Ce type d'appel devrait être effectué avec une API autre que CPIC.
-37 CM_OPERATION_NOT_ACCEPTED. L'une des opérations précédentes de la conversation spécifiée n'a pas été terminée. Cette situation peut se présenter dans le cas d'une application mettant en oeuvre plusieurs unités d'exécution.
-100 CM_TAKE_BACKOUT. L'application éloignée a lancé un appel Backout pour la récupération de ressources SAA. L'application locale doit adresser un appel Backout au dernier point de synchronisation. Ce code est renvoyé uniquement dans le cas de conversations du type SYNC_POINT.
-130 CM_DEALLOCATED_ABEND_BO. L'application éloignée a été désaffectée avec un type DEALLOCATE_ABEND et l'application locale doit adresser un appel Backout au dernier point de synchronisation. Ce code est renvoyé uniquement dans le cas de conversations du type SYNC_POINT.
-131 CM_DEALLOCATED_ABEND_SVC_BO. L'application a vraisemblablement désaffecté la conversation de base avec un type ABEND_SVC. Dans d'autres cas, l'application éloignée a subi une fin anormale et le système de services du noeud de la LU partenaire a désaffecté la conversation en faveur de l'application éloignée. Ce type d'appel devrait être lancé à une API autre que CPIC. L'application locale doit adresser un appel Backout au dernier point de synchronisation. Ce code est renvoyé uniquement dans le cas de conversations du type SYNC_POINT.
-132 CM_DEALLOCATED_ABEND_TIMER_BO. L'application a désaffecté la conversation de base avec un type ABEND_TIMER. Ce code est renvoyé uniquement dans le cas de conversations du type SYNC_POINT. Ce type d'appel devrait être lancé à une API autre que CPIC.
-133 CM_RESOURCE_FAIL_NO_RETRY_BO. Suite à une défaillance, la conversation a été achevée prématurément. Cette situation n'est pas temporaire, ce qui signifie que l'application ne doit pas renouveler l'appel de la commande sans intervention extérieure. L'application locale doit adresser un appel Backout au dernier point de synchronisation. Ce code est renvoyé uniquement dans le cas de conversations du type SYNC_POINT.
-134 CM_RESOURCE_FAILURE_RETRY_BO. Suite à une défaillance, la conversation a été achevée prématurément. Il est possible que cette situation soit seulement temporaire. Ce code est renvoyé uniquement dans le cas de conversations du type SYNC_POINT.
-135 CM_DEALLOCATED_NORMAL_BO. L'application locale a désaffecté la conversation. Elle doit adresser un appel Backout au dernier point de synchronisation. Ce code est renvoyé uniquement dans le cas de conversations du type SYNC_POINT.

Constantes système CPIC

Codes retour des opérations CPIC

Code retour Description
-501 CPIC_GET_CONVTYPE_FAILED. Lors du traitement de CPICAccept, la boîte à outils du développeur de TSD a besoin de connaître le type de la conversation entrante (mappée ou de base). Lorsque cette opération échoue, la boîte à outils du développeur de TSD n'assure pas la prise en charge de la conversation entrante.
-502 CPIC_OUT_OF_MEMORY. Une allocation de mémoire a échoué lors du traitement d'une commande CPIC.
-503 CPIC_SET_FILL_FAILED. Lors du traitement de CPICAccept pour une conversation de base entrante, la boîte à outils du développeur de TSD tente de définir le type de remplissage sur FILL_LL. Lorsque cette opération échoue, la boîte à outils du développeur de TSD n'assure pas la prise en charge de la conversation entrante.
-504 CPIC_TPNAME_CONV_FAILED. Le processus de conversion des noms vers les formats de programmes de transactions des services SNA a échoué.
-505 CPIC_TPNAME_TOO_SHORT. Le TPName spécifié pour la commande CPICSetSideInfo est trop court pour désigner un nom de programme de transactions de service SNA.
-506 CPIC_DEFAULT_CONVTYPE_FAILED. Durant le traitement d'une commande CPICInitialize, la boîte à outils du développeur de TSD a tenté de définir un type de conversation mappée. Ce code retour est émis lorsque l'opération se traduit par un échec.
-507 CPIC_VARLEN_FOR_BASIC. La boîte à outils du développeur de TSD a détecté une zone VAR dans un fichier DDF de conversation de base. La boîte à outils n'assure pas la prise en charge des zones de longueur variable dans le cas des conversations de base.
-508 CPIC_INVALID_CONVERSATION. L'identifiant de conversation transmis à CPIC est incorrect. L'initialisation d'une conversation doit avoir lieu avant que celle-ci puisse être attribuée.
-509 CPIC_INVALID_SDN. Le nom de destination symbolique spécifié dans la commande CPIC est incorrect.
-510 CPIC_INVALID_DDF_NAME. Le paramètre du nom de fichier DDF transmis est incorrect.
-511 CPIC_INVALID_TP_NAME. Le paramètre du nom de programme de transactions transmis est incorrect. Ce paramètre peut être $Unknown.
-512 CPIC_INVALID_PLU_NAME. Le paramètre du nom de programme de transactions transmis est incorrect. Ce paramètre peut être $Unknown.
-513 CPIC_INVALID_PARAMETER. L'un des paramètres de référence transmis à la commande CPIC est incorrect. Ce paramètre peut être $Unknown.
-514 CPIC_INVALID_VALUE. L'un des paramètres de référence transmis à la commande CPIC est incorrect. Ce paramètre peut être $Unknown.

Codes retour pour la conversion des chaînes de caractères

Code retour Description
-1501 CONV_BUFFER_LENGTH_ERROR. La boîte à outils du développeur de TSD a tenté sans succès de convertir une chaîne de caractères depuis ou vers le format ASCII, car un paramètre de longueur incorrect a été transmis à CM/2.
-1502 CONV_COMM_SUBSYSTEM_NOT_LOADED. La tentative de conversion de la chaîne de caractères n'a pas abouti car le sous-système du noeud de services n'a pas été chargé (le démarrage de CM/2 n'a pas eu lieu).
-1503 CONV_CONVERSION_ERROR. Les services du noeud n'ont pas pu convertir les caractères car la chaîne source contient des caractères absents de la table de conversion. Cela signifie probablement que le fichier DDF utilisé ne spécifiait pas la variable CUSTOM_CONVERT=TRUE, et que vous avez tenté d'envoyer ou de recevoir une chaîne non prise en charge par la table de valeurs par défaut des services de noeud.
-1504 CONV_CUSTOM_TABLE_ERROR. Le chargement de la table personnalisée que vous avez spécifiée lors de la configuration des services du noeud n'a pas eu lieu. Vous pouvez utiliser la table personnalisée ACSGTAB.DAT fournie avec CM/2.
-1505 CONV_GENERAL_ERROR. Suite à une erreur non indentifiée, la conversion des caractères n'a pas abouti.
-1506 CONV_INVALID_CHARACTER_SET. Suite à une erreur interne de la boîte à outils du développeur de TSD, la conversion n'a pas été effectuée par les services du noeud .

Codes retour DDF

Code retour Description
-2501 CPIC_DDF_INVALID_TYPE. Le nom de type spécifié pour une zone du fichier DDF est incorrect.
-2502 CPIC_DDF_INVALID_FIELD_DECIMALS. La définition d'une largeur de zone décimale dans le fichier DDF est incorrecte.
-2503 CPIC_DDF_INVALID_FIELD_WIDTH. L'une des largeurs de zone spécifiées dans le fichier DDF est incorrecte.
-2504 CPIC_DDF_NO_FIELD_TYPE. Le fichier DDF comporte une zone pour laquelle aucun type n'a été spécifié.
-2505 CPIC_DDF_UNKNOWN_PARTNER_ATTRIB. L'un des attributs contenus dans la section Partner du fichier DDF n'est pas reconnu.
-2506 CPIC_DDF_UNRECOGNIZED_SECTION. Le fichier DDF comporte une zone non reconnue.
-2507 CPIC_DDF_FILE_OPEN_ERROR. L'ouverture du fichier DDF est impossible. Assurez-vous que le nom est orthographié correctement et que, selon les cas, la variable PATH a été définie entièrement, ou qu'elle est contenue dans la variable d'environnemnt DPATH.
-2508 CPIC_DDF_FILE_READ_ERROR. Le fichier DDF a été ouvert, mais sa lecture par la boîte à outils du développeur de TSD est impossible. Assurez-vous que vous possédez les droits de lecture sur ce fichier.
-2509 CPIC_DDF_FILE_CLOSE_ERROR. Après la lecture du fichier DDF, la boîte à outils du développeur de TSD n'a pas pu refermer le fichier.
-2510 CPIC_DDF_NOT_SPECIFIED. Aucun fichier DDF n'a été spécifié dans la commande. Cette situation se produit lorsque vous avez utilisé les commandes $SIZEOF ou $INCLUDE dans le fichier DDF, mais que vous n'avez pas transmis le nom de ce dernier aux commandes concernées.
-2511 CPIC_DDF_DUPLICATE_FIELD. L'une des zones du fichier DDF a été spécifiée en double.
-2512 CPIC_DDF_INVALID_VAR_LEN. Le fichier DDF comporte une zone définie selon le type VAR, mais cette zone n'est pas la dernière du fichier DDF.
-2513 CPIC_BAD_VAR_LEN_PARAM. La zone d'enregistrement de TSD Script définie dans le fichier DDF comme étant du type VAR, ne correspond pas à une zone de chaîne de caractères.

Codes retour généraux de CPIC

Code retour Description
-2514 CPIC_TYPE_CONVERSION_ERROR. La conversion entre le type spécifié pour une zone d'enregistrement de TSD Script et le type spécifié pour cette zone dans le fichier DDF, n'a pas été effectuée avec succès par la boîte à outils du développeur de TSD.
-2516 CPIC_CANT_SEND_UNKNOWN. Le fichier DDF comporte une valeur FALSE pour la colonne sendunknowns d'une zone $Unknown lors de l'appel de CPICSend.
-2517 CPIC_BUF_TOO_SMALL. La taille de mémoire tampon de réception est insuffisante par rapport au fichier DDF spécifié. Vérifiez que les largeurs de zones définies dans le fichier DDF sont correctes.
-2518 CPIC_CANNOT_CREATE_SEM. Suite à une erreur de traitement interne, la boîte à outils du développeur de TSD a interrompu la création des sémaphores.
-2519 CPIC_CANNOT_GET_SEM. Suite à une erreur de traitement interne, la boîte à outils du développeur de TSD a interrompu l'accès aux sémaphores.
-2520 CPIC_GENERAL_ERROR. Suite à une erreur de traitement interne, la boîte à outils du développeur de TSD a interrompu l'exécution des commandes CPIC.

Constantes systèmes de TSD Script

Généralités

Plusieurs commandes CPIC utilisent des paramètres entiers pour désigner des indicateurs de comportement. Afin de faciliter la lisibilité de ces commandes, la liste des constantes système de TSD Script permet de fournir des noms mnémoniques pour ces valeurs.

Valeurs d'état de conversion

Mnémonique Valeur
$CPICInitState 2
$CPICSendState 3
$CPICReceiveState 4
$CPICSendPendingState 5
$CPICConfirmState 6
$CPICConfirmSendState 7
$CPICConfirmDeallocateState 8
$CPICDeferReceiveState 9
$CPICDeferDeallocateState 10

Valeurs de données reçues

Mnémonique Valeur
$CPICNoDataReceived 0
$CPICDataReceived 1
$CPICCompleteDataReceived 2
$CPICIncompleteDataReceived 3

Valeurs de type de désaffectation

Mnémonique Valeur
$CPICDeallocateSyncLevel 0
$CPICDeallocateFlush 1
$CPICDeallocateConfirm 2
$CPICDeallocateAbend 3

Valeurs de détection d'erreurs

Mnémonique Valeur
$CPICReceiveError 0
$CPICSendError 1

Valeurs de type de préparation à la réception

Mnémonique Valeur
$CPICPrepToReceiveSyncLevel 0
$CPICPrepToReceiveFlush 1
$CPICPrepToReceiveConfirm 2

Valeur de type de réception

Mnémonique Valeur
$CPICReceiveAndWait 0
$CPICReceiveImmediate 1

Valeurs de réception des demandes d'envoi

Mnémonique Valeur
$CPICReqToSendNotReceived 0
$CPICReqToSendReceived 1

Valeurs de niveaux de synchronisation

Mnémonique Valeur
$CPICNone 0
$CPICConfirm 1
$CPICSyncPoint 2

Valeurs de contrôle de retour

Mnémonique Valeur
$CPICWhenSessionAllocated 0
$CPICImmediate 1

Valeurs de type d'envoi

Mnémonique Valeur
$CPICBufferData 0
$CPICSendAndFlush 1
$CPICSendAndConfirm 2
$CPICSendAndPrepToReceive 3
$CPICSendAndAllocate 4

Valeurs de réception d'état

Mnémonique Valeur
$CPICNoStatusReceived 0
$CPICSendReceived 1
$CPICConfirmReceived 2
$CPICConfirmSendReceived 3
$CPICConfirmSendReceived 4
$CPICTakeCommit 5
$CPICTakeCommitSend 6
$CPICTakeCommitDeallocate 7

Valeurs de type de sécurité de conversation

Mnémonique Valeur
$CPICSecurityNone 0
$CPICSecuritySame 1
$CPICSecurityProgram 2

Valeurs du type de nom de programme de transactions

Mnémonique Valeur
$CPICApplicationTP 0
$CPICSNAServiceTP 1

Types de conversation

Mnémonique Valeur
$CPICBasicConversation 0
$CPICMappedConversation 1

Tivoli Service Desk 6.0 Developer's Toolkit - Guide des API existantes

Retour à la table des matières

Copyright