Aller au contenu

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

  • SBSD Description de sous-système obligatoire
  • DEV Unité
  • RMTLOCNAME Lieu éloigné
  • JOBD Description de travail
  • DFTUSR Profil utilisateur par défaut
  • MODE Mode
  • MAXACT Maximum 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 :

  1. 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.
  2. 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 :

  1. 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
  2. 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

CPF1619
Description de sous-système &1 de &2 endommagée.
CPF1691
La description de sous-système actif n'a peut-être pas été modifiée.
CPF1697
Description de sous-système &1 non modifiée.

© Copyright IBM Corp. Texte d'aide reproduit à des fins de formation.