CHGCMNE
Modifier poste communications
En bref
La commande Modifier poste communications CHGCMNE (Modifier un poste communications) permet de modifier les attributs d'un poste communications existant dans une description de sous-système existante.
CHGCMNE se lit CHG
(Modifier) + CMNE.
Sur IBM i, le nom d'une commande associe presque toujours un verbe et un objet.
Syntaxe minimale
CHGCMNE SBSD(…)
Paramètres
-
SBSDDescription de sous-système obligatoire -
DEVUnité -
RMTLOCNAMELieu éloigné -
JOBDDescription de travail -
DFTUSRProfil utilisateur par défaut -
MODEMode -
MAXACTMaximum de travaux actifs
Astuce : dans une session 5250, tapez CHGCMNE puis F4 pour
l'invite de saisie, et F1 sur un paramètre pour son aide.
Aide IBM i de la commande
Texte du F1, IBM i 7.5 en français
(bibliothèque QSYS)
Où s'exécute : Tous les environnements (*ALL)
Compatible multitâche : Non
La commande Modifier poste communications CHGCMNE (Modifier un poste communications) permet de modifier les attributs d'un poste communications existant dans une description de sous-système existante.
Remarques :
- Lorsque vous modifiez les paramètres Description de travail JOBD, Profil utilisateur par défaut ou DFTUSR, le poste communications est également modifié. Cependant, la valeur de ces paramètres n'est pas modifiée pour tous les travaux en cours d'exécution.
- Si le paramètre Maximum de travaux actifs MAXACT prend une valeur inférieure au nombre total de travaux en cours pour ce poste communications, aucune nouvelle demande de démarrage de programme n'est traitée. Les travaux actifs continuent de s'exécuter, mais aucun nouveau programme ne peut démarrer tant que le nombre de travaux actifs n'est pas inférieur à la valeur indiquée dans le paramètre MAXACT.
Restrictions :
- Pour utiliser cette commande, vous devez détenir les droits suivants :
- les droits opérationnels sur les objets (*OBJOPR), de gestion des objets (*OBJMGT) et de lecture (*READ) sur la description de sous-système indiquée, et le droit d'exécution (*EXECUTE) sur la bibliothèque contenant la description de sous-système
- les droits opérationnels sur les objets (*OBJOPR) et de lecture (*READ) sur la description de travail, et le droit d'exécution (*EXECUTE) sur la bibliothèque contenant cette description de travail
- le droit d'utilisation (*USE) sur le profil utilisateur
- Seul un utilisateur détenant le droit spécial *ALLOBJ peut modifier un poste qui ne possède pas de description de travail.
Paramètres
| Mot-clé | Description | Valeurs possibles | Remarques |
|---|---|---|---|
| SBSD | Description de sous-système | Nom d'objet qualifié | Obligatoire, positionnel 1 |
| Qualificatif 1: Description de sous-système | Nom | ||
| Qualificatif 2: Biblio | Nom, *LIBL, *CURLIB | ||
| DEV | Unité | Nom générique, nom, *ALL, *APPC, *ASYNC, *BSCEL, *FINANCE, *INTRA, *RETAIL, *SNUF | Facultatif, positionnel 2 |
| RMTLOCNAME | Lieu éloigné | Nom de communication | Facultatif, positionnel 3 |
| JOBD | Description de travail | Valeurs uniques: *SAME, *USRPRF, *SBSD Autres valeurs: Nom d'objet qualifié |
Facultatif, positionnel 4 |
| Qualificatif 1: Description de travail | Nom | ||
| Qualificatif 2: Biblio | Nom, *LIBL, *CURLIB | ||
| DFTUSR | Profil utilisateur par défaut | Nom, *SAME, *NONE, *SYS | Facultatif |
| MODE | Mode | Nom de communication, *ANY | Facultatif |
| MAXACT | Maximum de travaux actifs | 0-32000, *SAME, *NOMAX | Facultatif |
Description de sous-système (SBSD)
Indique le nom et la bibliothèque de la description de sous-système contenant le poste communications à modifier.
Ce paramètre est obligatoire.
Qualificatif 1 : Description de sous-système
- nom
- Indiquez le nom du sous-système pour lequel le poste communications est modifié.
Remarque : L'objet QSYSSBSD fourni par IBM n'est pas admis pour ce paramètre.
Qualificatif 2 : Biblio
- *LIBL
- Une recherche s'effectue sur toutes les bibliothèques figurant dans la liste des bibliothèques d'unité d'exécution, afin de trouver une occurrence.
- *CURLIB
- L'objet est recherché dans la bibliothèque en cours de l'unité d'exécution. Si cette dernière n'est pas précisée, QGPL est prise par défaut.
- nom
- Indiquez la bibliothèque dans laquelle figure la description de sous-système.
Unité (DEV)
Indique le nom de la description d'unité ou le type d'unité à utiliser avec ce poste communications.
Remarque :Vous devez obligatoirement affecter une valeur à ce paramètre ou au paramètre Lieu éloigné RMTLOCNAME, mais pas aux deux.
- *ALL
- Ce poste communications utilise tous les types ou noms d'unités communications.
- *APPC
- Ce poste communications utilise toutes les unités communications évoluées de programme à programme. Les unités créées à l'aide de la commande Créer une unité APPC CRTDEVAPPC peuvent être utilisées.
- *ASYNC
- Toutes les unités de communications asynchrones peuvent être utilisées avec ce poste communications. Les unités créées à l'aide de la commande CRTDEVASC (Créer une unité asynchrone) peuvent être utilisées. Cette valeur n'est correcte que si vous avez indiqué *ANY à l'invite Mode (paramètre MODE).
- *BSCEL
- Toutes les unités de communications de transmission binaire synchrone peuvent être utilisées avec ce poste communications. Les unités créées à l'aide de la commande Créer une unité BSC CRTDEVBSC peuvent être utilisées. Cette valeur n'est correcte que si vous avez indiqué *ANY à l'invite Mode (paramètre MODE).
- *FINANCE
- Indique que toutes les unités de communications bancaires peuvent être utilisées avec ce poste communications. Les unités créées à l'aide de la commande Créer une unité bancaire CRTDEVFNC peuvent être utilisées par ce poste communications. Cette valeur n'est correcte que si vous avez indiqué *ANY à l'invite Mode (paramètre MODE).
- *INTRA
- Toutes les unités de communications INTRA peuvent être utilisées avec ce poste communications. Les unités créées à l'aide de la commande Créer une unité INTRA CRTDEVINTR peuvent être utilisées. Cette valeur n'est correcte que si vous avez indiqué *ANY à l'invite Mode (paramètre MODE).
- *RETAIL
- Toutes les unités de communications point de vente peuvent être utilisées avec ce poste communications. Les unités créées à l'aide de la commande Créer une unité point de vente CRTDEVRTL peuvent être utilisées par ce poste communications. Cette valeur n'est correcte que si vous avez indiqué *ANY à l'invite Mode (paramètre MODE).
- *SNUF
- Toutes les unités de communications SNUF peuvent être utilisées avec ce poste communications. Les unités créées à l'aide de la commande Créer une unité SNUF CRTDEVSNUF peuvent être utilisées. Cette valeur n'est correcte que si vous avez indiqué *ANY à l'invite Mode (paramètre MODE).
- nom-générique
- Indiquez le nom générique de la description d'unité utilisée avec ce poste communications.
- nom
- Indiquez la description d'unité à utiliser avec ce poste communications.
Lieu éloigné (RMTLOCNAME)
Indique le nom du lieu éloigné à utiliser avec ce poste communications. Vous pouvez utiliser le nom de lieu éloigné indiqué dans la description d'unité associée. Aucun contrôle de validité n'est effectué sur le nom de lieu éloigné.
Remarque :Vous devez obligatoirement affecter une valeur à ce paramètre ou au paramètre Unité DEV, mais pas aux deux.
- nom-communications
- Indiquez le nom du lieu éloigné utilisé avec ce poste communications.
Description de travail (JOBD)
Indique le nom et la bibliothèque de la description de travail à utiliser pour les travaux démarrés à la suite d'une demande de démarrage de programme et traités par l'intermédiaire de ce poste communications. Si la description de travail n'existe pas lors de l'ajout ou de la modification du poste, vous devez indiquer un qualifiant de bibliothèque car le nom qualifié de la description de travail est conservé dans la description de sous-système.
Remarque :Seul un utilisateur détenant les droits spéciaux sur tous les objets (*ALLOBJ) est admis à ajouter ou modifier un élément qui ne possède pas de description de travail.
Valeurs uniques
- *SAME
- La valeur en cours de ce paramètre ne change pas.
- *USRPRF
- Les travaux lancés par l'intermédiaire de ce poste communications utilisent le nom de la description de travail indiqué dans le profil de l'utilisateur ayant demandé le lancement de programme.
- *SBSD
- Les travaux lancés via ce poste communications utilisent le nom de description de travail indiqué dans le profil de l'utilisateur qui a fait la demande de démarrage de programme.
Qualificatif 1 : Description de travail
- nom
- Indiquez le nom de la description de travail à utiliser pour les travaux traités via ce poste communications.
Qualificatif 2 : Biblio
- *LIBL
- Une recherche s'effectue sur toutes les bibliothèques figurant dans la liste des bibliothèques d'unité d'exécution, afin de trouver une occurrence.
- *CURLIB
- L'objet est recherché dans la bibliothèque en cours de l'unité d'exécution. Si cette dernière n'est pas précisée, QGPL est prise par défaut.
- nom
- Indiquez le nom de la bibliothèque de description de travail.
Profil utilisateur par défaut (DFTUSR)
Indique le profil utilisateur par défaut utilisé pour une demande de démarrage de programme dans laquelle ne figure aucune information de sécurité. Ce profil n'est pas utilisé pour les demandes de démarrage de programme qui contiennent un mot de passe ou qui indiquent un profil utilisateur (correct ou non).
- *SAME
- La valeur en cours de ce paramètre ne change pas.
- *NONE
- Aucun profil utilisateur par défaut n'est indiqué.
- *SYS
- Toutes les demandes de démarrage de programme utilisateur seront traitées comme si *NONE avait été indiqué. Toute demande de démarrage de programme envoyée par des fonctions système sera exécutée sous un profil utilisateur prédéfini si aucun profil utilisateur n'est indiqué dans la demande.
- nom
- Indiquez le nom du profil utilisateur à utiliser pour toutes les demandes de démarrage de programme qui entrent dans le système par l'intermédiaire de ce poste communications et qui ne contiennent ni mot de passe ni nom de profil utilisateur.
Remarque :QDFTOWN, QLPINSTALL, QSECOFR, QSPL, QDOC, QDBSHR, QRJE, QTSTRQS et QSYS sont des valeurs incorrectes pour ce paramètre.
Mode (MODE)
Indique le nom de mode de l'unité communications ou du lieu éloigné dont le poste communications doit être ajouté ou modifié.
- *ANY
- Tous les modes disponibles définis pour l'unité communications ou le lieu éloigné sont alloués au sous-système. Si aucun mode défini n'a été associé à l'unité communications, celle-ci est directement allouée au sous-système.
- nom
- Indiquez le nom du mode de l'unité communications ou du lieu éloigné à ajouter ou modifier.
Remarque :Les noms SNASVCMG et CPSVCMG ne sont pas valides pour ce paramètre.
Maximum de travaux actifs (MAXACT)
Indique le nombre maximal de travaux (demandes de démarrage de programme reçues) pouvant être actifs simultanément via ce poste communications.
- *SAME
- La valeur en cours de cet attribut ne change pas.
- *NOMAX
- Aucun maximum n'est fixé pour le nombre de travaux pouvant être actifs simultanément via ce poste communications.
- 1-32000
- Indiquez le nombre maximal de travaux pouvant être actifs simultanément via ce poste communications.
Exemples
CHGCMNE SBSD(QGPL/BAKER) DEV(A12) MAXACT(*NOMAX)
Cette commande modifie le poste communications (dans la description de sous-système QGPL/BAKER) pour l'unité A12 et le mode *ANY. Le niveau d'activité maximal est passé en *NOMAX, ce qui signifie que le poste communications ne limite pas le nombre de demandes de démarrage de programme qui peuvent être actives simultanément. Cependant, la valeur MAXJOBS dans la description de sous-système BAKER limite le nombre total de travaux qui peuvent être actifs dans le sous-système. Cela comprend ceux qui sont créés par les demandes de démarrage de programme. L'utilisateur peut également limiter le nombre de travaux actifs pouvant être routés via un poste de routage particulier (MAXACT). La limite indiquée dans le poste de routage peut contrôler le nombre de travaux utilisant un pool spécifique ou le niveau de récursivité d'un programme particulier. Dans tous les cas, aucune de ces limites ne peut être dépassée à la suite du traitement d'une demande de programme.
Messages d'erreur
Messages *ESCAPE
© Copyright IBM Corp. Texte d'aide reproduit à des fins de formation.