Commande CREATE TRANDESC

La commande CREATE TRANDESC permet de créer des descripteurs de transaction. Un descripteur est un modèle qui peut être utilisé pour créer des descripteurs ou des ressources.

Un descripteur est créé avec une valeur définie pour chaque attribut. Les attributs non explicitement spécifiés dans la commande CREATE prennent la valeur par défaut. Tout descripteur de transaction peut être créé à l'aide de ce descripteur en tant que modèle, en spécifiant la commande CREATE avec LIKE (DESC (nom_description)).

Sous-sections:

Environnement
Syntaxe
Mots-clés
Notes d'utilisation
Champs de sortie
Codes retour, raison et achèvement
Exemples

Environnement

Le tableau suivant répertorie les environnements (DB/DC, DBCTL et DCCTL) dans lesquels vous pouvez utiliser la commande et les mots clés.

Tableau 1. Environnements valides pour la commande CREATE TRANDESC et les mots clés
Commande / Mots clés	base de données/transmission de données	DCCTL
Créer TRANDESC	X	X
LIKE	X	X
Nom	X	X
SET	X	X

Syntaxe

Les valeurs par défaut affichées dans ce diagramme de syntaxe reflètent les valeurs par défaut définies dans le descripteur de transaction IMS , DFSDSTR1. Si vous définissez un autre descripteur comme descripteur par défaut avec une commande CREATE ou UPDATE TRANDESC , les valeurs par défaut affichées dans ce diagramme de syntaxe risquent de ne pas correspondre à la valeur définie dans le descripteur par défaut en cours.

Mots-clés

Les mots clés suivants sont valides pour la commande CREATE TRANDESC :

LIKE

Indique que le descripteur est créé en utilisant un descripteur existant comme modèle, à la place du descripteur par défaut. Le descripteur par défaut est soit le descripteur IMS DFSDSTR1, soit défini par l'utilisateur. Le type de modèle peut être un descripteur (DESC) ou une ressource (RSC). Le descripteur est créé avec tous les mêmes attributs que le modèle, à l'exception de la valeur DEFAULT (Y) et de la valeur CPRI, qui est une valeur de planification d'exécution qui ne s'applique pas aux descripteurs de transaction. Les attributs définis explicitement par la commande CREATE remplacent les attributs de modèle. DEFAULT (Y) doit être spécifié explicitement pour qu'un descripteur devienne le descripteur par défaut. Les modifications ultérieures apportées au modèle ne sont pas propagées aux ressources ou aux descripteurs qui ont été créés à partir de celui-ci.

Les commandes QUERY peuvent être utilisées pour afficher le nom de modèle et le type de modèle utilisés pour créer le descripteur ou la ressource. Le nom et le type de modèle renvoyés par la commande QUERY sont fournis à titre d'information uniquement. La commande EXPORT exporte une définition de ressource incluant le nom de modèle et le type de modèle vers le membre de définition. La commande IMPORT importe une définition de ressource incluant le nom de modèle et le type de modèle à partir du membre de définition. Une commande IMPORT qui crée une ressource enregistre le nom et le type de modèle, mais n'utilise pas les attributs de modèle.

DESC (nom_description): Indique le nom du descripteur à utiliser comme modèle pour définir ce descripteur.
RSC (nom_ressource): Indique le nom de la ressource à utiliser comme modèle pour définir ce descripteur.

Nom

Indique le nom de 1 à 8 caractères de la transaction. Les noms doivent être alphanumériques (A à Z, 0 à 9, #, $ et @). Les noms ne peuvent pas inclure de blanc, de virgule, de point, de trait d'union ou de signe égal. Les noms ne peuvent pas commencer par DFS, à l'exception de DFSIVPxx et DFSSAMxx. Les noms ne peuvent pas être BASICEDT, DBCDM, DBRC, ISCEDT, MSDB, SDB ou WTOR. Une ressource de transaction et un descripteur de transaction peuvent avoir le même nom. Une transaction ne peut pas avoir le même nom qu'un terminal logique.

SET

Indique les attributs de la transaction à créer. Si le mot clé LIKE est omis, les attributs non spécifiés prennent la valeur définie dans le descripteur par défaut, à savoir le descripteur IMS DFSDSTR1ou défini par l'utilisateur. Si le mot clé LIKE est indiqué, les attributs non spécifiés prennent la valeur définie dans le modèle. Une transaction doit avoir les mêmes caractéristiques dans tous les systèmes où elle est définie lorsqu'elle est partagée. Ces caractéristiques sont les suivantes:

Non conversationnel ou conversationnel
Taille de la zone de mémoire auxiliaire en cas de conversation
Messages à un ou plusieurs segments
Non-interrogation ou interrogation
Récupérable ou non récupérable
Mode de réponse ou mode de non-réponse
Fast Path exclusif, Fast Path potentiel ou non Fast Path

AOCMD

Indique l'option AOI indiquant si la transaction peut émettre l'appel CMD d'AOI type-1 ou l'appel ICMD d'AOI type-2 . Si AOCMD est défini comme CMD, TRAN ou Y, et que le paramètre d'exécution AOI1 est défini comme AOI1=N, aucune vérification d'autorisation n'est effectuée et la transaction est autorisée à émettre des appels CMD et ICMD.

N: Indique que la transaction n'est pas autorisée à émettre des appels CMD de type-1 AOI. La transaction est autorisée à émettre des appels ICMD de type-2 AOI.
CMD: Indique que la transaction est autorisée à émettre des appels type-1 AOI CMD et des appels type-2 AOI ICMD. Si le paramètre d'exécution AOI1 est défini comme C, R ou A, la vérification d'autorisation est basée sur les transactions qui peuvent émettre une commande particulière. Dans ce cas, les commandes (ou les trois premiers caractères des commandes) doivent être définies dans RACF® ou dans un produit équivalent en tant qu'utilisateur. Les transactions AOI type-1 doivent être définies en tant que profils sous la classe TIMS et, pour chaque transaction, les commandes qu'elle peut émettre doivent être spécifiées. La définition d'AOCMD (CMD) nécessite que vous créiez moins d'ID utilisateur que la définition d'AOCMD (TRAN). Cependant, la définition de l'AOCMD (CMD) nécessite la création ou la modification d'un plus grand nombre de profils de ressource.
TRAN: Indique que la transaction est autorisée à émettre des appels type-1 AOI CMD et des appels type-2 AOI ICMD. Si le paramètre d'exécution AOI1 est défini comme C, R ou A, le code de transaction est utilisé pour l'autorisation. La première vérification d'autorisation entraîne la génération de l'élément d'environnement d'accès (ACEE). Cet environnement est conservé pour être utilisé par les vérifications d'autorisation ultérieures. La transaction AOI type-1 doit être définie dans RACF ou dans un produit équivalent en tant qu'utilisateur. Les transactions seront ensuite spécifiées dans les instructions RACF PERMIT pour chaque commande qu'elles sont autorisées à émettre à partir d'une transaction AOI type-1 . La spécification de transactions AOI en tant qu'utilisateurs dans RACF peut entrer en conflit avec le nom d'un utilisateur déjà défini dans RACF. Dans ce cas, le nom de transaction ou le nom d'utilisateur existant doit être modifié.
Y: Indique que la transaction est autorisée à émettre des appels type-1 AOI CMD et des appels type-2 AOI ICMD. Si le paramètre d'exécution AOI1 est défini comme C, R ou A, l'ID utilisateur ou le nom de programme est utilisé pour l'autorisation. Pour certains environnements, si un appel Get Unique n'a pas encore eu lieu, le nom du programme est utilisé pour l'autorisation.

CLASSE

Indique la classe de transaction, qui est un attribut utilisé pour sélectionner une transaction à planifier. Une transaction peut être planifiée si une région de traitement des messages est disponible pour cette classe. La valeur peut être un nombre compris entre 1 et 999. La valeur par défaut est 1. Cette valeur ne doit pas dépasser la valeur indiquée (par spécification ou par défaut) dans le mot clé MAXCLAS= de la macro IMSCTRL.

Définissez les transactions CPI-C avec une classe de message différente de celle utilisée pour les transactions non-CPI-C. IMS traite toutes les transactions CPI-C comme priorité zéro dans la classe de transaction.

CMTEP1E

Indique si la routine de sortie de l'utilisateur Commit (CMTEXIT : Commit user exit routine ) est appelée à la fin de la phase de validation 1.

Attention :

Cet attribut ne peut être défini que pour IMS 15.4 et les versions ultérieures. Toute tentative d'utilisation de cet attribut dans les versions pre-15.4 de IMS entraînera une erreur.

N: Ne pas appeler l'exit Commit à la fin de la phase 1 du commit. Il s'agit de la valeur par défaut.
Y: Appeler l'exit Commit à la fin de la phase 1 du commit ou à la fin du traitement du backout pour un backout.

Note : Il n'y a pas de mot-clé équivalent à TRANSACT pour CMTEP1E.

CMTEP2E

Indique si la routine de sortie de l'utilisateur Commit (CMTEXIT : Commit user exit routine ) est appelée à la fin de la phase de validation 2.

Attention :

Cet attribut ne peut être défini que pour IMS 15.4 et les versions ultérieures. Toute tentative d'utilisation de cet attribut dans les versions pre-15.4 de IMS entraînera une erreur.

N: Ne pas appeler l'exit Commit à la fin de la phase 2 du commit. Il s'agit de la valeur par défaut.
Y: Appeler l'exit Commit à la fin de la phase 2 du commit.

Note : Il n'y a pas de mot-clé équivalent à TRANSACT pour CMTEP2E.

MODE CMTDE

Indique quand les mises à jour de la base de données et les messages de sortie non express sont validés. Cet opérande affecte le redémarrage d'urgence.

MULT: Les mises à jour de base de données et les messages de sortie non express sont validés uniquement lorsque le programme d'application s'arrête normalement, lorsque le nombre limite de traitement a été atteint, ou, dans le cas d'une région dépendante pseudo-WFI, lorsqu'il n'y a plus de messages dans la file d'attente. Par exemple, si cinq transactions sont traitées au cours d'une seule planification d'un programme, les cinq sont validées uniquement lorsque la cinquième est terminée et que le programme s'arrête. Tant qu'une transaction n'a pas été validée, les verrous des enregistrements de base de données mis à jour ne sont pas libérés et les messages de sortie non express ne sont pas mis en file d'attente pour la sortie. Si une application se termine de manière anormale avant de valider ses messages, le redémarrage d'urgence redemande tous les messages qui ont été traités dans la portée de validation et les rend disponibles pour le retraitement.
Si la transaction entraîne l'appel par l'application d'un sous-système externe, tel que DB2®, la sortie Commit Verify fournie par le sous-système externe peut déterminer si CMTMODE(MULT) est pris en charge. Voir la documentation sous la routine de sortie Commit Verify.
SGL: Les mises à jour de la base de données et les messages de sortie non express sont validés lorsque le programme d'application termine le traitement de chaque transaction. IMS appelle le traitement de validation soit lorsque le programme d'application demande le message suivant (émet une unité GU vers le bloc IO-PCB), soit lorsque le programme d'application se termine. Si une application se termine de manière anormale avant de valider son message, le redémarrage d'urgence replace le message qui était en cours avant la fin anormale et le rend disponible pour le nouveau traitement. Il s'agit de la valeur par défaut.
Le mot clé MODE de la macro TRANSACT utilise la valeur par défaut MULT. Le mot clé CMTMODE de la commande CRE TRAN utilise la valeur par défaut SNGL.

Les règles de combinaison de mots clés sont les suivantes:

CONV (Y) et CMTMODE (MULT) s'excluent mutuellement.
CMTMODE (MULT) et WFI (Y) s'excluent mutuellement.

conv

Indique l'option de conversation.

N: La transaction n'est pas conversationnelle. Il s'agit de la valeur par défaut.
Y: La transaction est conversationnelle. Le message de transaction est destiné à un programme conversationnel. Un programme conversationnel traite les transactions en plusieurs étapes. Un programme conversationnel reçoit un message d'un terminal, répond au terminal, mais enregistre les données de la transaction dans une zone de mémoire auxiliaire (SPA). Lorsque la personne au niveau du terminal entre plus de données, le programme a les données qu'il a sauvegardées à partir du dernier message dans le SPA, de sorte qu'il peut continuer à traiter la requête sans que la personne au niveau du terminal ait à saisir à nouveau les données.

Les règles de combinaison de mots clés sont les suivantes:

CMTMODE (MULT) et CONV (Y) s'excluent mutuellement.
CONV (Y) requiert SPASZ et SPATRUNC.
INQ (Y) et CONV (Y) s'excluent mutuellement.
RECOVER (N) et CONV (Y) s'excluent mutuellement.
SPASZ et CONV (N) s'excluent mutuellement.
SPATRUNC et CONV (N) s'excluent mutuellement.

DCLWA

Indique l'option d'écriture anticipée du journal. S'il n'est pas spécifié, la valeur est définie comme étant le paramètre DCLWA dans le membre DFSDFxxx PROCLIB. Si DCLWA n'est pas défini dans le membre DFSDFxxx PROCLIB, la valeur par défaut est DCLWA=Y.

N

IMS ne doit pas effectuer d'écriture anticipée de journal. Indiquez N si l'intégrité des messages d'entrée et la cohérence des messages de sortie avec les mises à jour de base de données associées ne sont pas requises. DCLWA ne s'applique pas au mode de réponse ou au traitement des entrées Fast Path et est ignoré lors de l'exécution d' IMS .

Y

IMS doit effectuer une écriture anticipée du journal pour les messages d'entrée non-réponse récupérables et les messages de sortie de transaction. Cela garantit les éléments suivants:

Une transaction d'entrée sans réponse est rendue récupérable en cas d'échec IMS avant que IMS n'accuse réception de l'entrée.
Les modifications apportées à la base de données sont récupérables avant que IMS n'envoie les messages de réponse de sortie associés.
Les informations contenues dans les mémoires tampon de journal sont écrites dans le journal IMS , avant que l'accusé de réception d'entrée ou la réponse de sortie associée ne soit envoyé au terminal.

Définissez DCLWA (Y) pour tous les types de terminal VTAM.

DEFAULT

Indique si le descripteur est la valeur par défaut.

N: Le descripteur n'est pas la valeur par défaut.
Y: Le descripteur est la valeur par défaut, qui réinitialise le descripteur par défaut existant à DEFAULT (N). Lorsqu'un descripteur ou une ressource est créé sans le mot clé LIKE, tout attribut non spécifié dans la commande CREATE prend la valeur définie dans le descripteur par défaut. Un seul descripteur peut être défini comme valeur par défaut pour un type de ressource. IMS définit un descripteur de transaction par défaut appelé DFSDSTR1, dans lequel tous les attributs sont définis avec la valeur par défaut. La définition d'un descripteur défini par l'utilisateur comme descripteur par défaut remplace le descripteur IMS. Etant donné qu'un seul descripteur de transaction peut être la valeur par défaut à la fois, un seul nom de transaction peut être spécifié avec DEFAULT (Y).

DIRROUTE

Indique l'option de routage MSC.

N: Le programme d'application traitant une transaction n'est pas informé du système à l'origine de la transaction. Le nom du terminal logique d'origine est placé dans le bloc de communication de programme d'entrée-sortie. Il s'agit de la valeur par défaut.
Y: Le programme d'application traitant une transaction est informé du système à l'origine de la transaction, si le routage dirigé par MSC est utilisé dans une configuration système IMS multiple. Un MSNAME correspondant à un chemin logique vers le système d'origine est placé dans le PCB d'entrée-sortie.

EDITRTN

Indique le nom d'un à huit caractères de la routine d'édition d'entrée de transaction qui édite les messages avant que le programme ne reçoive le message. Ce nom doit commencer par un caractère alphabétique. La routine d'édition spécifiée (module de chargement) doit résider dans le fichier USERLIB. Cette routine ne peut pas être identique à celle définie par le paramètre TYPE EDIT = de la définition du système. Un maximum de 255 routines d'édition d'entrée sont prises en charge.

EDITRTN est utilisé pour une transaction potentielle Fast Path lorsque la transaction est routée vers IMS.

Pour les entrées provenant des unités LU 6.2 , la routine d'exit d'édition utilisateur DFSLUEE0 est appelée à la place de la routine d'édition d'entrée de transaction spécifiée dans EDITRTN.

Les règles de combinaison de mots clés sont les suivantes:

FP (E) et EDITRTN s'excluent mutuellement.

EDITUC

Indique l'option d'édition en majuscules.

N: Les données d'entrée ne sont pas converties en majuscules. Il peut se composer de caractères en majuscules et en minuscules, tels qu'ils ont été entrés à partir du terminal.
Y: Les données d'entrée doivent être converties en majuscules avant d'être présentées au programme de traitement. Si FP (E) ou FP (P), la transaction doit être convertie en majuscules avant d'être présentée à la routine d'exit de modification / routage. Il s'agit de la valeur par défaut.
La spécification de EDITUC (Y) pour les terminaux VTAM empêche la transmission de caractères de contrôle d'unité imbriqués.

EMHBSZ

Indique la taille de la mémoire tampon EMH requise pour exécuter la transaction Fast Path. Remplace le paramètre d'exécution EMHL. Si EMHBSZ n'est pas spécifié, la valeur du paramètre d'exécution EMHL est utilisée. La valeur peut être un nombre compris entre 12 et 30720.

Les règles de combinaison de mots clés sont les suivantes:

EMHBSZ>0 requiert la définition de Fast Path.
FP (N) et EMHBSZ>0 s'excluent mutuellement.

HEURE_SORTIE

Indique le temps écoulé, en secondes, que IMS peut utiliser pour annuler la transaction d'entrée. Une fois qu'une transaction a été soumise à IMS, le traitement de la transaction peut être retardé en raison d'une transaction arrêtée ou d'un ralentissement potentiel du système. Dans ce cas, l'utilisateur ou l'application client peut arriver à un délai d'attente avant le traitement de la transaction. Lorsque IMS finit par planifier et traiter la transaction, le message de réponse n'est plus souhaité. Avec le temps écoulé spécifié pour la transaction, IMS peut marquer la transaction en entrée comme étant arrivée à expiration afin que le système ne gaspille pas de cycles d'UC pour traiter la transaction non souhaitée.

La valeur peut être un nombre, en secondes, compris entre 0 et 65535. La valeur par défaut est 0, ce qui signifie qu'aucun délai d'expiration n'est défini pour cette transaction. L'attribut d'expiration de transaction est pris en charge par toutes les interfaces IMS TM.

Restriction: La vérification de l'expiration des transactions n'est pas effectuée au moment de l'unité GU pour les transactions Fast Path, les transactions conversationnelles IMS , les transactions de commutateur de programme à programme et les transactions synchrones APPC.

FP

Indique l'option Fast Path.

E: La transaction est traitée exclusivement en tant que Fast Path. Un code de routage Fast Path portant le même nom est créé. Le programme doit être défini comme programme Fast Path exclusif.
N: La transaction n'est pas candidate au traitement Fast Path. Le programme identifié par PGM () doit être défini comme n'étant pas Fast Path. Il s'agit de la valeur par défaut.
P: La transaction est un candidat potentiel pour le traitement Fast Path. Fast Path-les transactions potentielles doivent pouvoir s'exécuter sous deux programmes: un programme Fast Path exclusif et un programme non Fast Path. Cette commande CREATE TRAN définit le programme non Fast Path avec PGM (). Un programme Fast Path exclusif doit être défini vers lequel cette transaction peut être acheminée. Fast Path-les transactions potentielles doivent être traitées par un exit d'édition et de routage utilisateur pour déterminer si la transaction doit être traitée par le Fast Path IMS . S'il doit être traité par IMS Fast Path, la routine d'exit d'édition et de routage associe la transaction à un code de routage. Ce code de routage identifie le programme Fast Path qui doit traiter la transaction.
Le programme défini par PGM () ne doit pas être défini comme programme Fast Path exclusif.

Les règles de combinaison de mots clés sont les suivantes:

EDITRTN et FP (E) s'excluent mutuellement.
FP (P) et FP (E) requièrent la définition de Fast Path.
MSGTYPE (MULTSEG) et FP (E) s'excluent mutuellement.
MSGTYPE (MULTSEG) et FP (P) s'excluent mutuellement.
MSNAME et FP (E) s'excluent mutuellement.
MSNAME et FP (P) s'excluent mutuellement.
RECOVER (N) et FP (E) s'excluent mutuellement.
RECOVER (N) et FP (E) s'excluent mutuellement.
RESP (N) et FP (E) s'excluent mutuellement.
RESP (N) et FP (P) s'excluent mutuellement.
SIDL et FP (E) s'excluent mutuellement.
SIDL et FP (P) s'excluent mutuellement.
SIDR et FP (E) s'excluent mutuellement.
SIDR et FP (P) s'excluent mutuellement.

INQ

Indique l'option d'interrogation.

N

Il ne s'agit pas d'une transaction d'interrogation. Il s'agit de la valeur par défaut.

Y

Il s'agit d'une transaction d'interrogation. Si INQ (Y) est spécifié, vous pouvez également indiquer si cette transaction doit être récupérée lors d'une urgence IMS ou d'un redémarrage normal à l'aide du paramètre RECOVER ().

Cela ne doit être spécifié que pour les transactions qui, lorsqu'elles sont entrées, ne provoquent pas de modification dans une base de données. Les programmes ne peuvent pas émettre d'appels ISRT, DLET ou REPL vers une base de données lorsqu'ils sont planifiés pour traiter une transaction définie comme INQ (Y).

Un programme d'application ne peut pas exécuter une instruction SQL INSERT, DELETE ou UPDATE lorsque la transaction IMS est définie avec INQ (Y).

Les règles de combinaison de mots clés sont les suivantes:

CONV (Y) et INQ (Y) s'excluent mutuellement.
RECOVER (N) et INQ (N) s'excluent mutuellement.

LCT

Indique le nombre limite. Il s'agit du nombre qui, comparé au nombre de transactions d'entrée en file d'attente et en attente de traitement, détermine si la valeur de priorité normale ou limite est affectée à cette transaction. La valeur peut être un nombre compris entre 1 et 65535. La valeur par défaut est 65535.

La valeur de nombre limite est ignorée pour une transaction traitée par une BMP.

La valeur de nombre limite est ignorée dans un environnement de files d'attente partagées.

LPRI

Indique la priorité de la limite. Il s'agit de la priorité de planification à laquelle cette transaction est associée lorsque le nombre de transactions d'entrée mises en file d'attente et en attente de traitement est supérieur ou égal à la valeur de nombre limite. La priorité de planification est un attribut utilisé pour sélectionner une transaction pour la planification. Une transaction de priorité supérieure est planifiée avant une transaction de priorité inférieure, si elles sont définies avec la même classe. La valeur peut être un nombre compris entre 0 et 14. La valeur par défaut est 1.

Lorsque la priorité de limite est utilisée et que la priorité de planification est élevée à la priorité de limite, la priorité n'est pas réduite à la priorité normale tant que tous les messages mis en file d'attente pour ce nom de transaction ne sont pas traités. Si vous ne voulez pas de priorité de limite pour cette transaction, définissez des valeurs égales pour la priorité normale et la priorité de limite, ainsi qu'un nombre de limites de 65535.

Lorsqu'une transaction est traitée exclusivement par un programme de traitement par lots (BMP), définissez la priorité de limite sur 0. Si le programme indiqué par PGM () est défini avec un type de programme de traitement par lots, la priorité en cours est forcée à 0. Toutefois, une région de traitement de messages par lots (BMP) peut traiter des transactions avec des priorités de planification en cours autres que 0.

Cette priorité contrôle également la priorité des messages créés par cette transaction et envoyés à une destination dans un système distant. Voir aussi la discussion sur les priorités du SMC selon la définition de l'INRP.

La valeur de priorité de limite est ignorée pour une transaction traitée par un BMP.

La valeur de priorité de limite est ignorée dans un environnement de files d'attente partagées.

MAXRGN

Indique le nombre maximal de régions. Cette valeur limite le nombre de régions MPP (Message Processing Program) pouvant être planifiées simultanément pour le traitement d'une transaction. Lorsque le nombre de régions MPP n'est pas limité, une transaction peut monopoliser toutes les régions disponibles. La valeur peut être un nombre compris entre 0 et la valeur indiquée au paramètre de région de contrôle MAXPST =. La valeur par défaut de MAXRGN (0) signifie qu'aucune limite n'est imposée.

Si vous définissez le programme avec le type de planification SERIAL, omettez le mot clé MAXRGN ou définissez-le sur 0.

Les combinaisons de mots clés suivantes s'excluent mutuellement:

Valeur PARLIM (65535) et MAXRGN supérieure à 0
Les valeurs SERIAL (Y) et MAXRGN sont supérieures à 0

MSGTYPE

Indique le type de message (segment unique ou segment multiple). Il indique l'heure à laquelle un message entrant est considéré comme terminé et disponible pour être acheminé vers un programme d'application en vue d'un traitement ultérieur.

Si le routage dirigé par MSC est utilisé dans une configuration système IMS multiple, IMS ne garantit pas que le message et la transaction destinée à traiter ce message sont tous deux des segments uniques ou multiples.

MULTSEG: La longueur du message entrant peut être supérieure à un segment. Il n'est pas admissible pour la planification d'un programme d'application tant qu'une indication de fin de message n'a pas été reçue ou qu'un message complet n'a pas été créé par MFS. Il s'agit de la valeur par défaut.
GSNG: Le message entrant a une longueur d'un segment. Elle devient éligible pour la planification lorsque l'opérateur de terminal indique une fin de segment.

Les règles de combinaison de mots clés sont les suivantes:

FP (E) et MSGTYPE (MULTSEG) s'excluent mutuellement.
FP (P) et MSGTYPE (MULTSEG) s'excluent mutuellement.

MSNAME

Indique le nom de un à huit caractères du chemin de liaison logique dans une configuration de système IMS (MSC) multiple. Un chemin de lien logique est un chemin entre deux systèmes IMS . Les systèmes IMS sont identifiés par l'ID du système distant et l'ID du système local associé au chemin de liaison logique. L'ID du système éloigné identifie le système dans lequel les messages utilisant ce chemin doivent être traités. L'ID système local identifie ce système. Si cette transaction est exportée, les ID système local et distant sont exportés, et non le nom du message. Pour qu'une commande CREATE TRAN ajoute une transaction distante, le nom MSNAME doit déjà être défini.

Les règles de combinaison de mots clés sont les suivantes:

FP (E) et MSNAME s'excluent mutuellement.
FP (P) et MSNAME s'excluent mutuellement.
SIDL et MSNAME s'excluent mutuellement.
SIDR et MSNAME s'excluent mutuellement.

NPRI

Indique la priorité de planification normale. La priorité de planification est un attribut utilisé pour sélectionner une transaction pour la planification. Une transaction de priorité supérieure est planifiée avant une transaction de priorité inférieure, si elles sont définies avec la même classe. Lorsqu'une ressource de transaction est créée, la priorité en cours (CPRI), ou la priorité d'ordonnancement, est initialisée à la priorité normale (INRP). La priorité normale est également affectée à une transaction en tant que priorité en cours lorsque le nombre de transactions d'entrée mises en file d'attente et en attente de traitement est inférieur à la valeur de nombre limite. La valeur peut être un nombre compris entre 0 et 14. La valeur par défaut est 1.

Cette priorité contrôle également la priorité des messages créés par cette transaction et envoyés à une destination dans un système distant.

Lorsqu'une transaction est traitée exclusivement par un programme de traitement par lots (BMP), codez la priorité normale sur 0.

Pour les transactions distantes, priorité utilisée pour envoyer la transaction au système de traitement, appelée priorité de message de liaison MSC. Les trois groupes de priorité de message de liaison MSC sont les suivants:

Faible
Moyen
High

Le groupe de priorité basse comprend les demandes principales dans le système de terminal d'entrée. Des priorités de transaction distante de 0 à 6 sont affectées à ce groupe. Le groupe de support se compose de demandes secondaires, de réponses, de demandes principales dans un système intermédiaire et de demandes principales dans le système de terminal d'entrée. Une priorité de transaction distante de 7 est affectée à ce groupe. Le groupe supérieur se compose de demandes principales dans le système de terminal d'entrée. Les messages de ce groupe sont associés à des priorités de transaction distante de 8 à 14. Au sein de chaque groupe, les messages ont une priorité basée sur la valeur de priorité en cours de la transaction ou de la transaction distante dans le système de terminal d'entrée pour les demandes primaires, et sur le système de traitement le plus récent pour les demandes et les réponses secondaires.

Dans une configuration MSC, la priorité de transaction détermine la priorité utilisée pour envoyer les messages insérés par cette transaction via un lien MSC. Si la transaction insère plusieurs messages à la même destination (par exemple, des pages vers une imprimante) et que ces messages doivent être envoyés dans l'ordre d'insertion, les valeurs de priorité normale et limite doivent être identiques. Si les valeurs de priorité normale et limite ne sont pas identiques, les messages insérés à une priorité plus élevée que les messages précédemment insérés peuvent arriver à leur destination en premier. (Cette restriction ne s'applique pas à plusieurs segments du même message.)

La valeur de priorité normale est ignorée pour une transaction traitée par une BMP.

PARLIM

Indique le nombre maximal de traitements parallèles. Il s'agit du nombre maximal de messages pouvant actuellement être mis en file d'attente, mais pas encore traités, par chaque région de message active actuellement planifiée pour cette transaction. Il s'agit de la valeur de seuil à utiliser lorsque le programme associé est défini avec un type de planification parallèle. Une région supplémentaire est planifiée chaque fois que le nombre de mises en file d'attente de la transaction en cours dépasse la valeur PARLIM multipliée par le nombre de régions actuellement planifiées pour cette transaction.

La valeur peut être un nombre compris entre 0 et 32767 ou 65535. PARLIM (0) indique que tout message d'entrée peut entraîner la planification d'une nouvelle région car la condition de planification est toujours remplie (le nombre de messages est supérieur à zéro). Si vous spécifiez PARLIM (0), vous devez spécifier une valeur MAXRGN pour limiter le nombre de régions pouvant être planifiées pour traiter une transaction particulière. PARLIM (65535) signifie que le traitement parallèle est désactivé et IMS permet de planifier la transaction dans une seule région à la fois. PARLIM (65535) est la valeur par défaut.

La valeur indiquée pour PARLIM s'applique uniquement aux programmes de traitement de messages (MPP) ; elle n'est pas prise en charge pour les programmes de traitement de messages par lots (BMP).

Si vous définissez la transaction en tant que série ou le programme avec un type de planification SERIAL, définissez PARLIM (65535).

Dans un environnement de files d'attente partagées (lorsque le type de planification est PARALLEL), toute valeur PARLIM autre que 65535 entraîne la planification d'une nouvelle région chaque fois que le nombre d'unités GU consécutives réussies dépasse la valeur PARLIM multipliée par le nombre de régions actuellement planifiées pour cette transaction. Pour les environnements de files d'attente partagées, le nombre d'unités GU consécutives réussies est utilisé à la place du nombre de files d'attente. Les nouvelles régions continuent d'être planifiées jusqu'au nombre maximal de régions indiqué sur MAXRGN.

Les règles de combinaison de mots clés sont les suivantes:

MAXRGN>0 et PARLIM (65535) s'excluent mutuellement.
SERIAL (Y) et la valeur PARLIM comprise entre 0 et 32767 s'excluent mutuellement.

gestionnaire de groupes publics

Indique le nom du programme associé à la transaction.

Pour une commande CREATE TRANDESC , le programme n'a pas besoin d'exister jusqu'à ce qu'une commande CREATE TRAN crée une transaction à l'aide du descripteur de transaction.

PLCT

Indique le nombre maximal de traitements. Il s'agit du nombre maximal de messages envoyés au programme d'application par IMS pour traitement sans rechargement du programme d'application. La valeur doit être un nombre compris entre 0 et 65535. PLCT (0) signifie que le nombre maximal de messages envoyés à l'application est de un et que le programme d'application est rechargé avant de recevoir un message suivant. PLCT (65535) signifie qu'aucune limite ne doit être placée sur le nombre de messages traités lors d'un seul chargement de programme. Les valeurs 1 à 65535 sont éligibles pour un traitement de replanification rapide. La valeur par défaut est 65535.

La valeur est utilisée pour déterminer le nombre de messages qu'un programme d'application est autorisé à traiter dans un cycle de planification unique. Lorsque le programme d'application demande et reçoit le nombre de messages indiqué, les demandes suivantes entraînent l'une des deux actions suivantes.

IMS indique qu'il n'existe plus de message si l'une des conditions suivantes est vraie:
- La région n'est pas un MPP.
- Le mode actuellement planifié n'est pas CMTMODE (SNGL).
- Des transactions de priorité égale ou supérieure sont mises en file d'attente pour la région.
IMS peut avoir d'autres messages mis en file d'attente pour le programme d'application. Il incombe au programme d'application de s'arrêter lorsqu'il reçoit un indicateur indiquant qu'aucun autre message n'est disponible. L'arrêt du programme d'application rend la région qu'il occupait disponible pour la replanification. Cette fonction permet à IMS d'activer la planification des transactions de priorité plus élevée qui ont été introduites dans le système alors que les transactions précédentes étaient en cours de traitement. En outre, si des transactions de priorité égale sont mises en file d'attente, elles deviennent éligibles à la planification sur une base FIFO (premier entré, premier sorti).
La région est replanifiée rapidement et renvoie le message suivant à l'application si toutes les conditions suivantes sont remplies:
- La région est un MPP.
- La transaction est CMTMODE (SNGL).
- Aucune transaction égale ou supérieure n'est mise en file d'attente.
- Les messages sont toujours mis en file d'attente pour le programme d'application.

PLCTHEURE

Indique le temps de comptage de la limite de traitement. Il s'agit de la durée (en centièmes de secondes) autorisée pour le traitement d'une transaction (ou d'un message) unique. Ce nombre indique le temps UC maximal autorisé pour chaque message à traiter dans la région de traitement des messages.

Les programmes BMP (Batch Message Programs) ne sont pas affectés par ce paramètre.

La valeur peut être un nombre, en centièmes de secondes, compris entre 1 et 6553500. La valeur 6553500 signifie qu'aucune limite de temps n'est appliquée au programme d'application. La valeur par défaut est 6553500.

Si Fast Path est utilisé, indique, pour un nom de transaction donné, la durée (en centièmes de secondes) pendant laquelle le programme est autorisé à traiter un message de transaction unique. Le temps représente le temps réel qui s'écoule pendant le traitement de la transaction (pas le temps de tâche cumulé). Le temps réel est utilisé car le terminal d'entrée est en mode de réponse et ne peut pas entrer une autre transaction tant que la réponse n'est pas envoyée. Dans ce cas, PLCT () est ignoré.

La valeur contrôle la boucle du programme d'application. Il n'est pas nécessaire d'optimiser la valeur du temps d'exécution de la transaction de programme. Toutefois, la valeur de temps affectée ne doit pas être inférieure à la durée d'exécution par transaction attendue. Si le programme d'application planifié dépasse le produit de PLCTTIME () et de PLCT (), le programme d'application se termine de manière anormale. Si une valeur IMS STIMER de 2 est spécifiée sur la procédure DFSMPR, la région ne s'arrête pas de manière anormale jusqu'à la fin de l'appel DL/I.

Important: Le programme d'application ne doit pas utiliser les services de temporisation STIMER. IMS utilise les services de temporisation STIMER pour l'exécution des transactions. Si un programme d'application émet une macro MVS STIMER, il annule les services de temporisation STIMER définis par IMS. Utilisez plutôt la macro STIMERM pour les demandes de temporisateur de programme d'application.

RECOVER

Indique l'option de reprise.

N: La transaction ne doit pas être récupérée.
Y: La transaction doit être récupérée lors d'un redémarrage d'urgence ou normal d' IMS . Il s'agit de la valeur par défaut.

Les règles de combinaison de mots clés sont les suivantes:

CONV (Y) et RECOVER (N) s'excluent mutuellement.
FP (E) et RECOVER (N) s'excluent mutuellement.
FP (P) et RECOVER (N) s'excluent mutuellement.
INQ (N) et RECOVER (N) s'excluent mutuellement.

DISTANT

Indique l'option distante.

N: La transaction n'est pas distante. La transaction est locale et s'exécute sur le système local. Il s'agit de la valeur par défaut.
Y: La transaction est distante. La transaction s'exécute sur un système distant.

Les règles de combinaison de mots clés sont les suivantes:

REMOTE (Y) requiert MSNAME ou SIDR et SIDL.

RESP

Indique l'option de mode de réponse.

N: La transaction n'est pas en mode réponse. Pour les terminaux spécifiant ou acceptant une valeur par défaut OPTIONS=TRANRESP, l'entrée ne doit pas s'arrêter après la saisie de cette transaction. Il s'agit de la valeur par défaut.
Y: La transaction est en mode réponse. Le terminal à partir duquel la transaction est entrée est conservé et empêche toute entrée supplémentaire jusqu'à la réception d'une réponse. Pour les terminaux qui spécifient ou acceptent une valeur par défaut OPTIONS=TRANRESP, aucun message supplémentaire ne doit être autorisé après la saisie de cette transaction jusqu'à ce que cette dernière envoie un message de réponse au terminal. Le mode de réponse peut être forcé ou annulé par une définition de terminal individuelle. RESP (Y) est ignoré lors du traitement en ligne pour tous les terminaux qui ne fonctionnent pas en mode de réponse.

Les règles de combinaison de mots clés sont les suivantes:

FP (E) et RESP (N) s'excluent mutuellement.
FP (P) et RESP (N) s'excluent mutuellement.

SEGNO

Indique le numéro de segment. Il s'agit du nombre maximal de segments de sortie de programme d'application autorisés dans les files d'attente de messages par appel GU (Get Unique) à partir du programme d'application. La valeur peut être un nombre compris entre 0 et 65535. La valeur par défaut est 0. Si SEGNO (0) est défini, le nombre de segments n'est pas vérifié par le système en ligne lors de l'exécution.

SEGSZ

Indique la taille du segment. Il s'agit du nombre maximal d'octets autorisés dans un segment de sortie. La valeur peut être un nombre compris entre 0 et 65535. La valeur par défaut est 0. Si SEGSZ (0) est défini, la taille du segment n'est pas vérifiée par le système en ligne lors de l'exécution.

Le nombre maximal de segments de message de sortie vers une unité LU 6.2 est de 32767. Si une transaction est censée envoyer une sortie à une unité LU 6.2 , le paramètre SEGSIZE ne doit pas être supérieur à 32767. Toutefois, cela n'est pas appliqué lors du traitement de la commande, car IMS ne peut pas déterminer le type d'unité pour la destination de message jusqu'à l'heure de sortie.

SERIAL

Indique l'option de série.

N: Les messages de la transaction ne sont pas traités en série. Le traitement des messages peut être effectué en parallèle. Les messages sont placés dans la file d'attente d'interruption après une pseudo-fin anormale U3303 . La planification se poursuit jusqu'à ce que des échecs répétés entraînent l'arrêt de la transaction avec une commande USTOP. Il s'agit de la valeur par défaut.
Y: Les messages de la transaction sont traités en série. U3303 Les fins pseudo-anormales ne provoquent pas le placement du message dans la file d'attente d'interruption, mais plutôt dans la file d'attente de messages de transaction, et la transaction est arrêtée avec une commande USTOP. L'instruction USTOP de la transaction est supprimée lorsque la transaction ou la classe est démarrée à l'aide d'une commande /START ou UPD TRAN .

Les règles de combinaison de mots clés sont les suivantes:

MAXRGN>0 et SERIAL (Y) s'excluent mutuellement.
Les valeurs PARLIM 0 à 32767 et SERIAL (Y) s'excluent mutuellement.

SID

Indique l'identification système (SYSID) du système local dans une configuration à plusieurs systèmesIMS (MSC). Le système local est le système d'origine auquel les réponses sont renvoyées. La valeur peut être un nombre compris entre 1 et 2036. Le SYSID local peut être défini dans tout ou partie des MSNAME ou des transactions.

Pour une transaction locale où SIDL n'est pas indiqué, SIDL est défini avec la valeur de l'ID système le plus bas lorsque MSC est activé sur ce système, ou SIDL est défini avec la valeur 0 lorsque MSC n'est pas activé sur ce système. L'ID système local et l'ID système distant sont identiques pour les transactions locales.

Le paramètre SIDL est indépendant du type de liaison (CTC, MTM, TCP/IP, VTAM) indiqué dans le mot clé TYPE= de l'instruction macro MSPLINK.

Les règles de combinaison de mots clés sont les suivantes:

FP (E) et SIDL s'excluent mutuellement, sauf si SIDL et SIDR sont spécifiés en tant que paire et sont égaux à l'ID système local de ce système IMS.
FP (P) et SIDL s'excluent mutuellement.
MSNAME et SIDL s'excluent mutuellement.
La valeur de SIDL doit être définie sur ce système IMS.

SIDR

Indique l'identification système (SYSID) du système distant dans une configuration à plusieurs systèmesIMS (MSC). Le système distant est le système sur lequel le programme d'application s'exécute. La valeur peut être un nombre compris entre 1 et 2036. Le SYSID distant indiqué doit également être défini pour un nom de système (MSNAME).

Pour une transaction locale où SIDR n'est pas spécifié, SIDR est défini comme étant la même valeur que SIDL.

Le paramètre SIDR est indépendant du type de liaison (CTC, MTM, TCP/IP, VTAM) spécifié dans le mot clé TYPE= de l'instruction macro MSPLINK.

Les règles de combinaison de mots clés sont les suivantes:

FP (E) et SIDR s'excluent mutuellement, sauf si SIDL et SIDR sont spécifiés en tant que paire et sont égaux à l'ID système local de ce système IMS.
FP (P) et SIDR s'excluent mutuellement.
MSNAME et SIDR s'excluent mutuellement.
La valeur SIDR doit être définie sur ce IMS.

SPASZ

Indique la taille de la zone de mémoire auxiliaire (SPA), en octets, pour une transaction conversationnelle. La valeur peut être un nombre compris entre 16 et 32767.

CONV (N) et SPASZ s'excluent mutuellement.

SPATRUNC

Indique l'option de troncature de zone de mémoire auxiliaire (SPA) d'une transaction conversationnelle. Définit si les données de la zone de mémoire auxiliaire doivent être tronquées ou conservées à travers un commutateur de programme vers une transaction définie avec une zone de mémoire auxiliaire plus petite. S'il n'est pas spécifié pour une transaction conversationnelle, la valeur est définie comme étant le paramètre TRUNC dans DFSDCxxx.

Lorsqu'une conversation est démarrée pour la première fois et qu'un programme est commuté, l'option SPATRUNC est cochée et définie ou réinitialisée comme indiqué. Lorsque l'option est définie, elle reste définie pour la durée de vie de la conversation ou jusqu'à ce qu'un changement de programme ait lieu sur une transaction qui spécifie que l'option doit être réinitialisée.

Lorsqu'un changement de programme se produit, l'option de données tronquées pour la nouvelle transaction est d'abord vérifiée et cette spécification est définie pour la conversation et est utilisée pour la zone de mémoire auxiliaire insérée dans le message de sortie. Si l'option n'est pas spécifiée pour la nouvelle transaction, l'option en cours pour la conversation est utilisée.

S: IMS conserve toutes les données de la zone de mémoire auxiliaire, même lorsqu'un basculement de programme est effectué sur une transaction définie avec une zone de mémoire auxiliaire plus petite. La transaction avec la zone de mémoire auxiliaire la plus petite ne voit pas les données tronquées, mais lorsque la transaction passe à une transaction avec une zone de mémoire auxiliaire plus grande, les données tronquées sont utilisées.
R: Les données tronquées ne sont pas conservées.

Les règles de combinaison de mots clés sont les suivantes:

CONV (N) et SPATRUNC s'excluent mutuellement.

TRANSTAT

Indique si les statistiques de niveau transaction doivent être consignées pour les programmes gérés par message. Si Y est spécifié, les statistiques de niveau transactionnel sont écrites dans le journal dans un enregistrement X'56FA'

N: Les statistiques de niveau transaction ne doivent pas être consignées.
Y: Les statistiques de niveau transaction doivent être consignées.

Le mot clé TRANSTAT est facultatif. Si aucune valeur n'est indiquée pour le mot clé TRANSTAT, la valeur par défaut du système est utilisée. La valeur par défaut du système pour le paramètre de statistiques de niveau transaction est définie avec le paramètre TRANSTAT dans le membre DFSDFxxx PROCLIB. Si aucune valeur n'est spécifiée pour le paramètre TRANSTAT, la valeur par défaut du système est définie sur N. Le mot clé TRANSTAT dans la commande CREATE TRAN ou CREATE TRANDESC permet à l'utilisateur de remplacer la valeur par défaut du système lors de la création d'une transaction ou d'un descripteur de transaction.

WFI

Indique l'option d'attente d'entrée. Cet attribut ne s'applique pas aux transactions Fast Path, qui se comportent toujours comme des transactions en attente d'entrée.

N: Il ne s'agit pas d'une transaction d'attente d'entrée. Il s'agit de la valeur par défaut.
Y: Il s'agit d'une transaction d'attente d'entrée. Un programme d'application de traitement de messages ou de traitement par lots qui traite les transactions WFI est planifié et appelé normalement. Si la transaction à traiter est définie comme WFI, le programme est autorisé à rester dans la mémoire principale après avoir traité les messages d'entrée disponibles. Le code de statut QC (plus aucun message) est renvoyé au programme si le nombre maximal de traitements (PLCT) est atteint ; une commande est entrée pour modifier le statut de la transaction, de la base de données, du programme ou de la classe planifiée ; les commandes relatives aux bases de données utilisées par la transaction sont entrées ou IMS est arrêté avec un arrêt de point de contrôle.
CMTMODE (MULT) et WFI (Y) s'excluent mutuellement.

Notes d'utilisation

Des descripteurs existent pour la durée de vie du IMS , sauf s'ils sont supprimés à l'aide d'une commande DELETE . Les descripteurs sont récupérables via un démarrage à chaud ou un redémarrage d'urgence IMS . Les descripteurs sont perdus si IMS est démarré à froid, sauf si le démarrage à froid importe des définitions qui ont été exportées alors que IMS était actif.

La commande CREATE TRANDESC est similaire à la modification en ligne locale (à l'aide d'une commande /MODIFY ) ou à la modification en ligne globale (à l'aide d'une commande INITIATE OLC ) pour les ressources de transaction du fichier MODBLKS, sauf que les transactions sont ajoutées de manière dynamique.

La commande CREATE TRANDESC peut être émise uniquement via l'API Operations Manager. Ces commandes s'appliquent aux systèmes DB/DC et DCCTL.

Ces commandes ne sont pas valides sur la région XRF de remplacement ou FDBR. La commande CREATE n'est pas valide si la modification en ligne pour MODBLKS est activée (DFSDFxxx ou DFSCGxxx défini avec MODBLKS=OLC ou MODBLKS non défini).

Champs de sortie

Le tableau suivant présente les zones de sortie CREATE TRANDESC . Les colonnes du tableau sont les suivantes:

Libellé abrégé: Contient le libellé court généré dans la sortie XML.
Mot clé: Identifie le mot clé dans la commande à l'origine de la génération de la zone. N/A apparaît pour les zones de sortie qui sont toujours renvoyées. La valeur error apparaît pour les zones de sortie qui sont renvoyées uniquement en cas d'erreur.
Signification: Fournit une brève description de la zone de sortie.

Tableau 2. Zones de sortie de la commande CREATE TRANDESC
Libellé abrégé	Mot clé	Signification
contrôle des changements	N/A	Code achèvement.
CCTXT	ERREUR	Texte du code achèvement qui explique brièvement la signification du code achèvement différent de zéro.
DESC	TRANDESC	Nom du descripteur de transaction.
MBR	N/A	Membre IMSplex qui a généré la ligne de sortie.
ANCIEN_DÉF	TRANDESC	Ancien nom de descripteur par défaut, si ce descripteur est défini par défaut en spécifiant DEFAULT (Y). L'ancien descripteur par défaut n'est plus le descripteur par défaut.

Codes retour, raison et achèvement

Le tableau suivant contient les codes retour et raison, ainsi qu'une brève explication des codes. Le code retour ou le code raison renvoyé pour la commande peut également indiquer une erreur provenant d'une demande CSL.

Tableau 3. Codes retour et raison de la commande CREATE TRANDESC
Code retour	Code de motif	Signification
X'00000000'	X'00000000'	La commande s'est terminée avec succès. La sortie de la commande contient une ligne pour chaque descripteur, accompagnée de son code achèvement. Pour plus de détails, consultez la table des codes achèvement.
X'00000008'	X'0000204C'	La valeur de la classe n'est pas valide.
X'00000008'	X'00002050'	La valeur CPRI de la priorité en cours n'est pas valide.
X'00000008'	X'00002054'	La valeur LCT du nombre maximal n'est pas valide.
X'00000008'	X'00002058'	La priorité de limite LPRI n'est pas valide.
X'00000008'	X'0000205C'	La région maximale MAXRGN n'est pas valide.
X'00000008'	X'00002060'	La valeur de priorité normale de l'INRP n'est pas valide.
X'00000008'	X'00002064'	La valeur PARLIM de nombre de limites parallèles n'est pas valide.
X'00000008'	X'00002068'	Le nombre maximal de traitements PLCT n'est pas valide.
X'00000008'	X'0000206C'	La valeur du numéro de segment SEGNO n'est pas valide.
X'00000008'	X'00002070'	La valeur SEGSZ de la taille de segment n'est pas valide.
X'00000008'	X'00002100'	CMTMODE (MULT) incompatible avec WFI (Y). Les deux mots clés ont été spécifiés explicitement ou un mot clé a été spécifié explicitement et l'autre attribut a été obtenu à partir du modèle.
X'00000008'	X'00002101'	CONV (Y) mutuellement exclusif avec CMTMODE (MULT). Les deux mots clés ont été spécifiés explicitement ou un mot clé a été spécifié explicitement et l'autre attribut a été obtenu à partir du modèle.
X'00000008'	X'00002102'	CONV (Y) mutuellement exclusif avec INQ (Y). Les deux mots clés ont été spécifiés explicitement ou un mot clé a été spécifié explicitement et l'autre attribut a été obtenu à partir du modèle.
X'00000008'	X'00002103'	CONV (N) incompatible avec SPASZ>0 ou SPATRUNC. Les deux mots clés ont été spécifiés explicitement ou un mot clé a été spécifié explicitement et l'autre attribut a été obtenu à partir du modèle.
X'00000008'	X'00002104'	CONV (Y) mutuellement exclusif avec RECOVER (N). Les deux mots clés ont été spécifiés explicitement ou un mot clé a été spécifié explicitement et l'autre attribut a été obtenu à partir du modèle.
X'00000008'	X'00002105'	CONV (Y) requiert SPASZ et SPATRUNC. Soit SPASZ n'a pas été explicitement spécifié ou défini dans le modèle, soit SPATRUNC n'a pas été explicitement spécifié ou défini dans le modèle. CONV (Y) a été explicitement spécifié ou défini dans le modèle.
X'00000008'	X'00002108'	Nom EDITRTN non valide. EDITRTN a été spécifié explicitement ou obtenu à partir du modèle.
X'00000008'	X'00002109'	Le nombre maximal de 255 routines d'édition a été dépassé. EDITRTN a été spécifié explicitement ou obtenu à partir du modèle.
X'00000008'	X'0000210C'	FP (E) mutuellement exclusif avec EDITRTN. Les deux mots clés ont été spécifiés explicitement ou un mot clé a été spécifié explicitement et l'autre attribut a été obtenu à partir du modèle.
X'00000008'	X'0000210E'	FP (E) ou FP (P) s'excluent mutuellement avec le mot clé MSC, MSNAME ou SIDR et SIDL. Les deux mots clés ont été spécifiés explicitement ou un mot clé a été spécifié explicitement et l'autre attribut a été obtenu à partir du modèle.
X'00000008'	X'0000210F'	FP (E) ou FP (P) mutuellement exclusifs avec MSGTYPE (MULTSEG). Les deux mots clés ont été spécifiés explicitement ou un mot clé a été spécifié explicitement et l'autre attribut a été obtenu à partir du modèle.
X'00000008'	X'00002110'	FP (N) incompatible avec EMHBSZ > 0. Les deux mots clés ont été spécifiés explicitement ou un mot clé a été spécifié explicitement et l'autre attribut a été obtenu à partir du modèle.
X'00000008'	X'00002111'	FP (E) ou FP (P) s'excluent mutuellement avec RECOVER (N). Les deux mots clés ont été spécifiés explicitement ou un mot clé a été spécifié explicitement et l'autre attribut a été obtenu à partir du modèle.
X'00000008'	X'00002112'	FP (E) ou FP (P) mutuellement exclusifs avec RESP (N). Les deux mots clés ont été spécifiés explicitement ou un mot clé a été spécifié explicitement et l'autre attribut a été obtenu à partir du modèle.
X'00000008'	X'00002116'	INQ (N) et RECOVER (N) s'excluent mutuellement. Les deux mots clés ont été spécifiés explicitement ou un mot clé a été spécifié explicitement et l'autre attribut a été obtenu à partir du modèle.
X'00000008'	X'00002117'	Nom de descripteur LIKE non valide.
X'00000008'	X'00002118'	Nom de ressource LIKE non valide.
X'00000008'	X'00002119'	Le mot clé MSC MSNAME ou SIDR et SIDL s'excluent mutuellement avec le programme d'application défini comme programme Fast Path exclusif (FP (E)) associé à cette transaction.
X'00000008'	X'0000211A'	Nom MSNAME non valide.
X'00000008'	X'0000211B'	MSNAME mutuellement exclusif avec SIDR et SIDL.
X'00000008'	X'0000211D'	MAXRGN>0 incompatible avec PARLIM (65535). Les deux mots clés ont été spécifiés explicitement ou un mot clé a été spécifié explicitement et l'autre attribut a été obtenu à partir du modèle.
X'00000008'	X'0000211E'	MAXRGN>0 incompatible avec SERIAL (Y). Soit des mots clés ont été spécifiés explicitement, soit un mot clé a été spécifié explicitement et l'autre attribut a été obtenu à partir du modèle.
X'00000008'	X'00002120'	Définition PGM () manquante. PGM doit être défini pour les transactions locales explicitement ou dans le modèle.
X'00000008'	X'00002121'	La valeur PARLIM est mutuellement exclusive avec SERIAL (Y). Les deux mots clés ont été spécifiés explicitement ou un mot clé a été spécifié explicitement et l'autre attribut a été obtenu à partir du modèle.
X'00000008'	X'00002123'	Nom PGM non valide. PGM a été spécifié explicitement ou obtenu à partir du modèle. Si le descripteur défini par IMS DFSDSTR1 a été utilisé, la commande a échoué car DFSDSTR1 ne définit aucun nom de programme.
X'00000008'	X'00002125'	REMOTE (Y) requiert le mot clé MSC MSNAME ou SIDR et SIDL. MSNAME ou SIDR et SIDL n'ont pas été explicitement indiqués ou définis dans le modèle. REMOTE (Y) a été explicitement spécifié ou défini dans le modèle.
X'00000008'	X'00002126'	Valeur SIDL non valide.
X'00000008'	X'00002127'	SIDL/SIDR doit être spécifié en tant que paire. Soit SIDL a été indiqué seul, soit SIDR a été indiqué seul.
X'00000008'	X'00002128'	Valeur SIDR non valide.
X'00000008'	X'00002133'	Plusieurs paramètres de nom ont été spécifiés avec DEFAULT (Y). Un seul descripteur peut être la valeur par défaut à la fois.
X'0000000C'	X'00003000'	La commande a abouti pour certains descripteurs mais a échoué pour d'autres. La sortie de la commande contient une ligne pour chaque descripteur, accompagnée de son code achèvement. Pour plus de détails, consultez la table des codes achèvement.
X'0000000C'	X'00003004'	La commande n'a abouti pour aucun des descripteurs. La sortie de la commande contient une ligne pour chaque descripteur, accompagnée de son code achèvement. Pour plus de détails, consultez la table des codes achèvement.
X'00000010'	X'0000400C'	La commande n'est pas valide sur l'autre instance XRF.
X'00000010'	X'00004024'	Aucun Fast Path défini, donc FP (E), FP (P) ou EMHBSZ > 0 n'est pas valide.
X'00000010'	X'00004120'	La phase de changement en ligne est en cours.
X'00000010'	X'00004204'	Le modèle est mis au repos. Impossible de mettre le modèle au repos.
X'00000010'	X'00004300'	La commande n'est pas autorisée car la modification en ligne pour MODBLKS est activée (DFSDFxxx ou DFSCGxxx défini avec MODBLKS=OLC ou MODBLKS non défini).
X'00000010'	X'00004310'	Le stockage n'a pas pu être obtenu pour la table de routines d'édition Transaction Input. Un démarrage à froid est nécessaire pour corriger cette erreur.
X'00000010'	X'00004314'	La routine d'édition Transaction Input n'a pas pu être chargée.
X'00000010'	X'00004318'	Une nouvelle routine d'édition d'entrée de transaction n'a pas pu être ajoutée. Le nombre maximal de 255 routines a déjà été atteint.
X'00000014'	X'00005004'	Impossible d'obtenir la mémoire tampon de réponse DFSOCMD.
X'00000014'	X'00005008'	Impossible d'obtenir la mémoire DFSPOOL.
X'00000014'	X'0000500C'	AWE n'a pas pu être obtenu.
X'00000014'	X'00005010'	Impossible d'obtenir le verrou.
X'00000014'	X'00005114'	La ressource ou le descripteur spécifié en tant que modèle est en cours d'importation à partir de la liste de modifications dans le référentiel IMSRSC ou n'a pas été importé correctement à partir de la liste de modifications à la fin du redémarrage d' IMS . Cette ressource ou ce descripteur ne peut pas être référencé en tant que modèle dans une commande CREATE tant qu'il n'a pas été correctement importé à partir du référentiel.

Les erreurs propres au traitement de cette commande sont renvoyées sous forme de codes achèvement. Le tableau suivant contient une explication des codes achèvement.

Tableau 4. Codes achèvement de la commande CREATE TRANDESC
Code de fin d'exécution	Texte du code achèvement	Signification
0		La commande a abouti pour le descripteur de transaction.
11	La ressource existe déjà	Le descripteur de transaction existe déjà.
17	UNE AUTRE COMMANDE EST EN COURS	Une autre commande (telle que DELETE PGM ou UPDATE PGM) est en cours pour le programme référencé par cette transaction.
36	FP=E/FP=N Conflit PGM	La transaction à créer en tant que FP (E) exclusif Fast Path est en conflit avec le programme déjà défini en tant que FP (N) non Fast Path.
3E	FP=N/FP=E CONFLIT PGM	La transaction à créer en tant que FP (N) non Fast Path est en conflit avec le programme déjà défini en tant que FP (E) exclusif Fast Path.
3F	FP=P/BMPTYPE=Y CONFLIT	La transaction à créer en tant que Fast Path potentiel FP (P) entre en conflit avec le programme défini en tant que lot BMPTYPE (Y).
5F	Le nom contient un caractère non valide	Le nom n'est pas valide car il contient un caractère non valide.
61	ERREUR DE MEMOIRE DFSBCB	La demande d'obtention de mémoire BCB pour le bloc de contrôle SMB a échoué.
8A	PARAMETRE JOKER NON PRIS EN CHARGE	La commande CREATE ne prend pas en charge les paramètres génériques. Vous devez spécifier explicitement les noms des descripteurs que vous souhaitez créer.
93	Nom réservé	Le nom est réservé. Par exemple, le nom commence par DFS (à l'exception de DFSSAMxx ou DFSIVPxx) ou est un nom réservé IMS tel que BASICEDT ou WTOR.

Exemples

Voici des exemples de la commande CREATE TRANDESC :

Exemple 1 pour la commande CREATE TRANDESC

Entrée TSO SPOC:

CRE TRANDESC NAME(CONVDESC) LIKE(RSC(CDEBTRNA))
SET(CONV(Y),SPASZ(128),SPATRUNC(R),PGM(DFSSAM04),DEFAULT(Y))

Sortie TSO SPOC:

DescName MbrName    CC OldDefault  
CONVDESC IMS1        0 DFSDSTR1

Entrée de l'API OM:

CMD(CRE TRANDESC NAME(CONVDESC) LIKE(RSC(CDEBTRNA)) 
SET(CONV(Y),SPASZ(128),SPATRUNC(R),PGM(DFSSAM04),DEFAULT(Y)))

Sortie de l'API OM:

<imsout> 
<ctl>
<omname>OM1OM   </omname>
<omvsn>1.3.0</omvsn>
<xmlvsn>20  </xmlvsn>
<statime>2006.307 18:52:58.805900</statime>  
<stotime>2006.307 18:52:58.806677</stotime>
<staseq>BFA6C8765828C44A</staseq>
<stoseq>BFA6C8765859584A</stoseq>
<rqsttkn1>USRT011 10105258</rqsttkn1>
<rc>00000000</rc>
<rsn>00000000</rsn>
</ctl>
<cmd>
<master>IMS1    </master>
<userid>USRT011 </userid>
<verb>CRE </verb>
<kwd>TRANDESC        </kwd>
<input>CRE TRANDESC NAME(CONVDESC) LIKE(RSC(CDEBTRNA))
 SET(CONV(Y),SPASZ(128),SPATRUNC(R),PGM(DFSSAM04),DEFAULT(Y)) </input> 
</cmd>
<cmdrsphdr>
<hdr slbl="DESC" llbl="DescName" scope="LCL" sort="a" key="1"
 scroll="no" len="8" dtype="CHAR" align="left" />
<hdr slbl="MBR" llbl="MbrName" scope="LCL" sort="a" key="2" scroll="no"
 len="8" dtype="CHAR" align="left" />
<hdr slbl="CC" llbl="CC" scope="LCL" sort="n" key="0" scroll="yes"
 len="4" dtype="INT" align="right" skipb="no" />
<hdr slbl="CCTXT" llbl="CCText" scope="LCL" sort="n" key="0"
 scroll="yes" len="*" dtype="CHAR" skipb="yes" align="left" />
<hdr slbl="OLDDEF" llbl="OldDefault" scope="LCL" sort="a" key="2" 
  scroll="no" len="8" dtype="CHAR" align="left" />
 </cmdrsphdr>
 <cmdrspdata>
 <rsp>DESC(CONVDESC) MBR(IMS1) CC(   0) OLDDEF(DFSDSTR1) </rsp>
 </cmdrspdata>
 </imsout>

Explication: Une commande CREATE TRANDESC est émise pour créer un descripteur de transaction pour les transactions conversationnelles. Le descripteur CONVDESC utilise les mêmes attributs que la transaction CDEBTRNA, à l'exception de l'attribut de conversation, de la taille de zone de mémoire auxiliaire, de l'option de troncature de zone de mémoire auxiliaire et du nom de programme. Il devient également le descripteur par défaut, de sorte que si aucun mot clé LIKE n'est spécifié dans une commande CREATE TRAN ou CREATE TRANDESC , la transaction ou le descripteur est défini avec les attributs du descripteur CONVDESC.