ADDCMNE

La commande Ajouter poste communications ADDCMNE (Ajouter poste communications) permet d'ajouter un poste communications à la description d'un sous-système existant. Chaque poste communications décrit une ou plusieurs unités de communication, leur type, ou les lieux éloignés pour lesquels le sous-système lancera des travaux lorsqu'il recevra des demandes de démarrage de programmes. Le sous-système peut allouer une unité de communication, à condition qu'elle ne soit pas déjà allouée à un autre sous-système ou à un autre travail. Une unité de communication déjà allouée peut être désallouée et rendue disponible pour d'autres sous-systèmes.

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 ajouter un poste qui ne possède pas de description de travail.
3. Un sous-système ne peut pas allouer une unité de communication déjà allouée à un autre sous-système ou à un autre travail.

Paramètres

Description de sous-système (SBSD)

Indique le nom et la bibliothèque de la description de sous-système à laquelle le poste communications doit être ajouté ou dans laquelle il doit être modifié.

Ce paramètre est obligatoire.

Qualificatif 1 : Description de sous-système

nom

Indiquez le nom du sous-système auquel le poste communications est ajouté.

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 le nom de la bibliothèque de la description de sous-système à laquelle le poste communications est ajouté.

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

*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 par l'intermédiaire de ce poste communications utilisent la description de sous-système dont le nom est identique à celui indiqué en regard de l'invite Description de sous-système (paramètre SBSD).

Qualificatif 1 : Description de travail

nom

Indiquez le nom de la description de travail à utiliser pour les travaux lancé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 la bibliothèque dans laquelle figure la 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).

*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.

*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

ADDCMNE   SBSD(ALIB/SBS1)  DEV(COMDEV)

Cette commande ajoute un poste communications pour l'unité APPC nommée COMDEV et le mode *ANY à la description du sous-système SBS1, qui se trouve dans la bibliothèque ALIB. DFTUSR est paramétré par défaut sur *NONE, ce qui signifie qu'aucun travail ne peut entrer dans le système par cette unité à moins que des informations de sécurité admises ne soient fournies à la demande de démarrage 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.