SET DB2ENTRY

Définit les attributs d'une DB2ENTRY particulière utilisée pour définir les ressources à utiliser par une transaction spécifique ou par un groupe de transactions lors de l'accès à Db2®.

Syntaxe

Avertissement : Les commandes système sont puissantes car elles fournissent des informations sur l'état du système et permettent d'y apporter des modifications. Les commandes du système ne doivent être utilisées que par les applications et les utilisateurs autorisés.

Activez les contrôles de sécurité sur les commandes en spécifiant le paramètre d'initialisation du système XCMD et en vous assurant que le contrôle de sécurité des commandes est actif pour la transaction (soit en spécifiant CMDSEC(YES) dans la définition de la ressource TRANSACTION, soit en spécifiant ALWAYS dans le paramètre d'initialisation du système CMDSEC ).

SET DB2ENTRY

Conditions : NOTAUTH, NOTFND, INVREQ

NOHANDLE, RESP, et RESP2 sont des options communes qui peuvent être ajoutées à toutes les commandes EXEC CICS pour traiter les conditions d'erreur. Elles ne sont pas explicitement incluses dans le diagramme syntaxique de la commande et dans les descriptions des options. Pour plus d'informations sur ces options communes et la syntaxe de la commande EXEC CICS, voir EXEC CICS Format de la commande et considérations de programmation. Pour plus d'informations sur l'utilisation des CVDA, voir CICS-value data areas (CVDAs).

Cette commande est sûre pour les threads.

Description

L'entrée est identifiée par le nom avec lequel elle a été définie dans CEDA.

Options

ACCOUNTREC

Spécifie la quantité minimale de comptabilité Db2 requise pour les transactions utilisant les threads du pool. Le minimum spécifié peut être dépassé comme décrit dans les options suivantes. Les valeurs de CVDA sont :

AUCUN: Aucun enregistrement comptable n'est requis pour les transactions utilisant des fils de pool.
Db2 produit au moins un enregistrement comptable pour chaque thread lorsque le thread est terminé. Les modifications d'autorisation entraînent en outre la production de documents comptables.
TXID: La fonction d'attachement CICS® Db2 entraîne la production d'un enregistrement comptable lorsque le transid utilisant le thread change.
Étant donné que les threads du pool sont généralement utilisés par un certain nombre d'identifiants de transaction différents, il est plus probable qu'une transaction contenant plusieurs unités de travail (UOW) utilise un thread différent pour chaque UOW (en supposant que le thread soit libéré au point de synchronisation). Dans ce cas, un enregistrement comptable peut être produit par UOW.
TASK: La facilité d'attachement CICS Db2 entraîne la production d'au moins un enregistrement comptable pour chaque tâche CICS.
Une transaction contenant plusieurs UOW (en supposant que le thread soit libéré au point de synchronisation) peut utiliser un thread différent pour chacun de ses UOW. Il peut en résulter un enregistrement comptable pour chaque UOW.
UOW: La fonction d'attachement CICS Db2 entraîne la production d'un enregistrement comptable pour chaque UOW, en supposant que le thread est libéré à la fin de l'UOW.

AUTHID

Spécifie l'identifiant à utiliser pour le contrôle de sécurité lors de l'utilisation de cette DB2ENTRY. Si AUTHId est spécifié, AUTHTYpe ne peut pas être spécifié.

AUTHTYPE

Renvoie le type d'identifiant qui peut être utilisé pour le contrôle de sécurité lors de l'utilisation de cette DB2ENTRY. Si AUTHTYpe est spécifié, AUTHid peut ne pas l'être. Les valeurs de CVDA sont :

GROUPE

Spécifie l'USERID à 8 caractères et le nom du groupe connecté comme ID d'autorisation. Le tableau suivant montre comment ces deux valeurs sont interprétées par Db2.

ID transmis à Db2	Comment Db2 interprète les valeurs
CICS identifiant de l'utilisateur de connexion (USERID)	Représente l'ID d'autorisation Db2 d'autorisation primaire.
RACF®-nom du groupe connecté	Si la liste d'options de groupe RACF n'est pas active, Db2 utilise le nom du groupe connecté fourni par la CICS comme ID d'autorisation Db2 secondaire. Si la liste RACF des options de groupe est active, Db2 ignore le nom du groupe connecté fourni par la fonction de rattachement CICS, mais la valeur apparaît dans la liste Db2 des ID d'autorisation secondaires Db2.

Pour utiliser l'option GROUP, le système CICS doit avoir RACF la sécurité externe SEC=YES spécifiée dans la CICS table d'initialisation du système (SIT).

Si aucun identifiant de groupe RACF n'est disponible pour cet USERID, un champ de 8 caractères vides est transmis à Db2 en tant qu'identifiant de groupe.

signer

Spécifie que le paramètre SIGNID du DB2CONN doit être utilisé comme ID d'autorisation de la ressource.

TERME

Spécifie l'identification du terminal (quatre caractères complétés par huit) en tant qu'ID d'autorisation. Un ID d'autorisation ne peut pas être obtenu de cette manière si un terminal n'est pas connecté à la transaction.

Si une transaction est lancée (à l'aide d'une commande CICS) et qu'aucun terminal ne lui est associé, AUTHTYPE(TERM) ne doit pas être utilisé.

TX

Spécifie l'identification de la transaction (quatre caractères complétés par huit) en tant qu'ID d'autorisation.

identification d"opérateur

L'identification de l'opérateur associée à la transaction CICS est utilisée comme identifiant d'autorisation (trois caractères complétés par huit).

USERID

L'USERID à 8 caractères associé à la transaction CICS est utilisé comme ID d'autorisation.

Lorsque l'exit Db2 sample sign-on DSN3@.SGN est utilisé avec AUTHTYPE(USERID), l'exit envoie l'ID de l'utilisateur à Db2 en tant qu'ID d'autorisation primaire et l'ID du groupe RACF à Db2 en tant qu'ID secondaire. Lorsque l'exemple de sortie de connexion est utilisé, il n'y a pas de différence entre AUTHTYPE(USERID) et AUTHTYPE(GROUP).

BUSY(Cvda)

Spécifie ce que CICS doit faire si un SET DB2ENTRY DISABLED est émis et que l'entrée est occupée lorsque la commande set est émise. Les valeurs de CVDA sont :

WAIT: CICS doit attendre que toute l'activité sur la DB2ENTRY soit terminée avant de désactiver la DB2ENTRY. CICS renvoie ensuite le contrôle à l'application.
Notez que lorsqu'une DB2ENTRY est en phase de quiescing, toutes les transactions existantes sont autorisées à se terminer. Les transactions déjà en file d'attente par rapport à l'entrée sont également autorisées à s'achever. Les nouvelles transactions qui tentent d'accéder à la DB2ENTRY sont acheminées vers le POOL, ou interrompues, ou reçoivent une SQLCODE en fonction de la configuration de DISABLEDACT.
NOWAIT: C'est la même chose que WAIT, sauf que le contrôle revient à l'application dès que la requête SET DISABLED est mise en file d'attente.
FORCE: Toutes les tâches utilisant la DB2ENTRY, et celles en file d'attente contre la DB2ENTRY sont forcepurgées. La DB2ENTRY est alors DISABLED et le contrôle revient à l'application.

DISABLEDACT

Spécifie ce que CICS doit faire avec les nouvelles transactions qui accèdent à une DB2ENTRY lorsqu'elle a été désactivée ou mise hors service. Les valeurs de CVDA sont :

POOL: Le dispositif d'attachement CICS Db2 achemine la demande vers le pool. Le message DFHDB2072 est envoyé à la destination des données transitoires spécifiée par MSGQUEUEn sur la DB2CONN pour chaque transaction acheminée vers le pool.
arrêt anormal: La CICS Db2 attachement interrompt la transaction. Le code de fin est AD26.
SQLCODE: Un SQLCODE est renvoyé à l'application indiquant que la DB2ENTRY est désactivée.

ENABLESTATUS(cvda)

Indique si les applications peuvent accéder à la DB2ENTRY. Les valeurs de CVDA sont :

ENABLED: Les applications peuvent accéder à la DB2ENTRY.
DISABLED: Les applications ne peuvent pas accéder à la DB2ENTRY. Une DB2ENTRY doit être désactivée avant de pouvoir être réinstallée ou supprimée.

PLAN

Spécifie le nom du plan à utiliser pour cette DB2ENTRY.

Si PLAN est spécifié, PLANEXITNAME ne peut pas être spécifié.

PLANEXITNAME

Spécifie le nom de l'exit de plan dynamique à utiliser pour cette DB2ENTRY. Si vous modifiez le PLAN et le PLANExitname alors qu'il y a des transactions actives pour la DB2ENTRY, la prochaine fois que la transaction libère le thread, le plan/la sortie est déterminé(e) à l'aide des nouvelles règles. Si PLANExitname est spécifié, PLAN ne peut pas être spécifié.

PRIORITY

Spécifie la priorité des TCB des threads pour cette DB2ENTRY par rapport à la CICS TCB principale (QR TCB). Les TCB de threads sont des CICS TCB ouverts L8. Les valeurs de CVDA sont :

ÉLEVÉ: Les TCB de threads ont une priorité plus élevée que le CICS QR TCB.
equal: Les TCB de threads ont la même priorité que le CICS QR TCB.
FAIBLE: Les TCB de threads ont une priorité inférieure à celle du CICS QR TCB.

PROTECTNUM

Spécifie le nombre maximum de threads protégés pour cette DB2ENTRY.

THREADLIMIT

Spécifie le nombre maximum de threads pour cette DB2ENTRY que l'attachement CICS Db2 autorise à être actifs avant que des demandes d'attente ne soient faites ou qu'elles soient rejetées.

COTES D'ÉPAULE

Spécifie si CICS transmettra un XID à Db2 pour permettre à Db2 de partager les verrous avec tout autre thread qui transmet le même XID. D'autres threads peuvent provenir d'autres régions CICS ou d'autres gestionnaires de transactions tels que IMS TM, et accéder à Db2 dans la même unité de travail globale. Le XID n'est pas utilisé pour la récupération entre CICS et Db2.

Non: CICS ne transmettra pas de XID à Db2. Les verrous ne seront pas partagés avec d'autres threads dans la même unité de travail globale. Un curseur ouvert avec maintien restera ouvert à travers les points de synchronisation.
OUI: CICS transmettra un XID à Db2. Il agit comme un jeton et permet à Db2 de partager les verrous avec n'importe quel autre thread qui utilise le même XID.

THREADWAIT

Indique si les transactions doivent attendre un thread DB2ENTRY, être interrompues ou déborder sur le pool si le nombre de threads actifs DB2ENTRY atteint le nombre THREADLimit. Les valeurs de CVDA sont :

TWAIT: Si tous les threads sont occupés, une transaction attend qu'un thread se libère.
NE PAS ATTENDRE: Si des threads sont occupés, une transaction est terminée avec un code d'interruption AD2P.
TPOOL: Si tous les threads sont occupés, la transaction est détournée pour utiliser le pool de threads. Si le pool est également occupé et que NOTWAIT a été spécifié pour le paramètre THREADWAIT sur le DB2CONN. La transaction est terminée avec le code abend AD3T.

Remarques :

Lorsque vous modifiez la valeur de AUTHId ou AUTHType, un contrôle de sécurité de substitution est effectué si la sécurité est active. Cela permet de s'assurer que l'identifiant sous lequel SET est exécuté est autorisé à agir au nom de l'identifiant en cours de définition.
Tous les paramètres de SET DB2ENTRY peuvent être définis lorsque l'attachement CICS Db2 est actif et que les transactions sont actives.

Conditions

NOTAUTH

L'utilisateur associé à la tâche émettrice n'est pas autorisé à utiliser cette commande, ou n'est pas autorisé à accéder à cette ressource.

RESP2 valeurs :

100: Échec de l'autorisation de la commande
101: Échec de l'autorisation des ressources
102: Défaut d'autorisation de la mère porteuse
103: Échec de l'autorisation Authtype

NOTFND

RESP2 valeurs :

1: Il n'y a pas de DB2ENTRY actuellement installé avec le nom spécifié.

INVREQ

RESP2 valeurs :

2: Valeur d'action non valide
3: Valeur d'Authtype non valide
4: Valeur d'occupation non valide
5: Valeur invalide de enablestatus
7: Valeur de priorité non valide
8: Valeur invalide de Threadwait
9: Mauvais personnages dans Authid
10: Mauvais personnages dans Plan
11: Les mauvais personnages de Planexitname
12: Authid et Authtype spécifiés
13: Les noms Plan et Planexit ont tous deux été spécifiés
14: L'entrée est désactivée
30: Protectnum supérieur à Threadlimit ou protectnum < 0 ou protectnum > 2000
16: Threadwait doit être un tpool avec Threadlimit=0
17: Threadlimit > 2000 ou Threadlimit < 0 ou Threadlimit > TCBLIMIT
18: Valeur invalide de Accountrec
19: SET DISABLED lorsque l'option FORCE ou WAIT a été spécifiée, mais que cette transaction utilise elle-même la DB2ENTRY.
20: Valeur SHARELOCKS non valide