CHGGRPA

Modifier attributs de groupe

En bref

La commande CHGGRPA (Modifier attributs de groupe) permet de modifier les attributs de groupe d'un travail interactif.

CHGGRPA se lit CHG (Modifier) + GRPA. Sur IBM i, le nom d'une commande associe presque toujours un verbe et un objet.

Syntaxe minimale

CHGGRPA

Paramètres

GRPJOB Travail de groupe
MSGQ File attente messages
TEXT Texte 'descriptif'

Astuce : dans une session 5250, tapez CHGGRPA 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 : Environnements interactifs (*INTERACT *IPGM *IREXX *EXEC)
Compatible multitâche : Non

La commande CHGGRPA (Modifier attributs de groupe) permet de modifier les attributs de groupe d'un travail interactif. Vous devez utiliser la commande CHGGRPA pour changer un travail interactif en travail de groupe avant de lancer la commande TFRGROJOB (Transférer à travail de groupe). Les modifications possibles sont décrites ci-dessous :

Un travail interactif peut devenir un travail de groupe.
Un travail de groupe peut devenir un travail interactif sans groupe.
Une file d'attente de messages peut être associée à un groupe.
Une file d'attente de messages peut être dissociée d'un groupe.
La description d'un travail de groupe peut être modifiée.

Pour plus d'informations sur les travaux de groupe, reportez-vous au manuelEnsemble de rubriques Gestion des travaux de l'IBM i Information Center, à l'adresse http://www.ibm.com/systems/i/infocenter/.

Restrictions :

Pour utiliser cette commande, vous devez disposer du droit *USE sur la file d'attente des messages (MSGQ) et du droit *EXECUTE sur la bibliothèque qui contient la file d'attente de messages.

Paramètres

Mot-clé	Description	Valeurs possibles	Remarques
GRPJOB	Travail de groupe	Nom, SAME, NONE	Facultatif, positionnel 1
MSGQ	File attente messages	Valeurs uniques: SAME, NONE Autres valeurs: Nom d'objet qualifié	Facultatif, positionnel 2
	Qualificatif 1: File attente messages	Nom
	Qualificatif 2: Biblio	Nom, LIBL, CURLIB
TEXT	Texte 'descriptif'	Valeur caractère, SAME, BLANK	Facultatif

Travail de groupe (GRPJOB)

Indique le nom de travail de groupe attribué au travail.

*SAME: Le nom du travail de groupe ne change pas.
*NONE: Le seul travail actif d'un groupe est modifié en travail interactif sans groupe, la zone de données de groupe (*GDA) est supprimée, et la file d'attente de messages affectée au groupe (si elle existe) en est dissociée. Le mode de cette file d'attente ne change pas.
nom: Indiquez le nom de travail de groupe attribué au travail interactif émettant cette commande. Le travail devient alors un travail de groupe et une zone de données de groupe (*GDA) est créée. La longueur de cette zone de données de type caractères correspond à 5212 octets. Vous ne pouvez attribuer un nom de travail de groupe qu'à un travail sans groupe. Ce nom ne peut pas être modifié, mais vous pouvez utiliser le paramètre *NONE, si seul ce travail est actif dans le groupe.

File attente messages (MSGQ)

Indique la file d'attente de messages associée à un groupe. A l'émission de la commande, cette file doit exister, mais il n'est pas indispensable qu'elle soit attribuée au travail.

Valeurs uniques

*SAME: La file d'attente de messages associée au groupe reste inchangée.
*NONE: Aucune file d'attente de messages n'est associée au groupe. S'il en existe une, elle est dissociée du groupe (le mode de la file ne change pas).

Qualificatif 1 : File attente messages

nom: Indiquez le nom de la file d'attente de messages associée à un groupe.

Qualificatif 2 : Biblio

*LIBL: La recherche est effectuée dans toutes les bibliothèques de la liste des bibliothèques jusqu'à ce qu'une occurrence soit trouvée.
*CURLIB: Le programme est recherché dans la bibliothèque en cours de l'unité d'exécution. Si la bibliothèque n'est pas indiquée, QGPL est utilisée par défaut.

nom: Indiquez la bibliothèque contenant la file d'attente de messages.

Texte 'descriptif' (TEXT)

Texte de 50 caractères au maximum, décrivant le travail de groupe. Ce texte apparaît sur l'écran Transfert au travail de groupe (commande TFRGRPJOB, Transférer à travail de groupe).

*SAME: Le texte reste inchangé.
*BLANK: Aucun texte n'est précisé.
valeur-caractère: Indiquez, entre apostrophes, un texte de 50 caractères au maximum.

Exemples

Exemple 1 : Modification d'un travail interactif en travail de groupe

CHGGRPA   GRPJOB(GROUPJ1)  MSGQ(QGPL/GRPMSGQ)

Un travail interactif est d'abord modifié en travail de groupe pour pouvoir créer d'autres travaux de groupe sur le poste de travail. Cette commande permet de modifier le travail d'un poste de travail en travail de groupe appelé GROUPJ1 ; une file d'attente de messages est associée au groupe (dans la mesure où elle se trouve en mode interruption ou avertissement dans le travail qui émet une commande TFRGRPJOB ou ENDGRPJOB). La zone de données de groupe (*GDA) est également créée.

Exemple 2 : Modification d'un travail de groupe en travail sans groupe

CHGGRPA   GRPJOB(*NONE)

Supposons que le travail de l'exemple précédent émette cette commande. Supposons également qu'il s'agisse du seul travail actif du groupe. Le travail de groupe GROUPJ1 devient un travail interactif sans groupe. Le nom du travail de groupe est enlevé et la zone de données de groupe (*GDA) est supprimée. Cette modification peut être effectuée uniquement s'il s'agit du seul travail actif du groupe.

Messages d'erreur

Messages *ESCAPE

CPF1305: Le nom du travail de groupe ne peut pas être modifié.
CPF1306: GRPJOB(*NONE) non permis actuellement.
CPF1307: Le travail de groupe &1 appartient déjà à ce groupe.
CPF1308: Paramètres incompatibles trouvés.
CPF1309: Le sous-système ne peut pas achever la commande &1.
CPF1312: Demande CHGGRPA incorrecte : le travail n'est pas un travail de groupe.
CPF1313: La valeur &1 du paramètre &2 n'est pas un nom correct.
CPF1316: &1 de &2 non admise comme file de messages de groupe.
CPF1317: Aucune réponse du sous-système pour le travail &3/&2/&1.
CPF1328: Non autorisé à la file d'attente de messages &2 de &3.
CPF1329: File d'attente de messages &1 de &2 non trouvée.
CPF1330: File d'attente de messages &1 de &2 non disponible.
CPF1331: &1 de &2 non admise comme file de messages de groupe.
CPF1351: Erreur dans le sous-système pour le travail &3/&2/&1.