CHGDSTD

Modifier une distribution

En bref

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

Syntaxe minimale

CHGDSTD DSTID(…)

Paramètres

DSTID Identificateur de distribution obligatoire
DSTIDEXN Suffixe ID de distribution
COMMENT Commentaire
USRID Identificateur utilisateur
SENSITIV Degré de protection
PERSONAL Personnel
IMPORTANCE Importance du contenu
PTY Priorité
DOCD Description du document
DOCDATE Date du document
EXPDATE Date d'expiration
ACTDATE Date limite de traitement
CMPDATE Date de traitement
REFERENCE Référence
STATUS Etat
PROJECT Projet
DOCLANGID Identificateur de langue
DOCCNTRYID ID pays ou région
DSTEXPDATE Indic expiration distribution
AUTHOR Auteur
DOCCLS Classe de document
KWD Mot clé
SUBJECT Objet
FILCAB Classeur
CPYLST Liste des copies
CMDCHRID ID caractères pour commande
DOCCHRID ID caractères du document

Astuce : dans une session 5250, tapez CHGDSTD 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 CHGDSTD (Modifier une distribution) permet de modifier la description (auteur, objet ou mots clés) ainsi que les informations portant sur l'accès à une distribution se trouvant dans la corbeille Courrier. Pour certains paramètres, il est possible de supprimer ou d'ajouter des données de description.

Restrictions : (1) Pour travailler pour le compte d'un autre utilisateur, vous devez obtenir une procuration de ce dernier. Une telle procuration est donnée au moyen de la commande GRTUSRPMN (Accorder une procuration à un utilisateur). (2) Le demandeur de cette commande doit être inscrit au répertoire de distribution du système. (3) Un utilisateur ne peut recevoir de courrier personnel lorsqu'il travaille sous procuration.

Paramètres

Mot-clé	Description	Valeurs possibles	Remarques
DSTID	Identificateur de distribution	Valeur caractère	Obligatoire, positionnel 1
DSTIDEXN	Suffixe ID de distribution	1-99, *NONE	Facultatif
COMMENT	Commentaire	Valeur caractère, SAME, RMV	Facultatif
USRID	Identificateur utilisateur	Valeurs uniques: CURRENT Autres valeurs: Liste d'éléments*	Facultatif
	Élément 1: ID utilisateur	Valeur caractère
	Élément 2: Adresse	Valeur caractère
SENSITIV	Degré de protection	SAME, NONE, PERSONAL, PRIVATE, *CONFIDENTIAL	Facultatif
PERSONAL	Personnel	SAME, NO, *YES	Facultatif
IMPORTANCE	Importance du contenu	SAME, NORMAL, LOW, HIGH	Facultatif
PTY	Priorité	SAME, NORMAL, *HIGH	Facultatif
DOCD	Description du document	Valeur caractère, *SAME	Facultatif
DOCDATE	Date du document	Date, SAME, RMV	Facultatif
EXPDATE	Date d'expiration	Date, SAME, RMV	Facultatif
ACTDATE	Date limite de traitement	Date, SAME, RMV	Facultatif
CMPDATE	Date de traitement	Date, SAME, RMV	Facultatif
REFERENCE	Référence	Valeur caractère, SAME, RMV	Facultatif
STATUS	Etat	Valeur caractère, SAME, RMV	Facultatif
PROJECT	Projet	Valeur caractère, SAME, RMV	Facultatif
DOCLANGID	Identificateur de langue	Valeur caractère, JOB, SAME	Facultatif
DOCCNTRYID	ID pays ou région	Valeur caractère, JOB, SAME	Facultatif
DSTEXPDATE	Indic expiration distribution	Liste d'éléments	Facultatif
	Élément 1: Date	Date, SAME, CURRENT, *RMV
	Élément 2: Heure	Heure, SAME, CURRENT, *ENDOFDAY
AUTHOR	Auteur	Valeurs uniques: SAME Autres valeurs (jusqu'à 50 répétitions): Liste d'éléments*	Facultatif
	Élément 1: Auteur	Valeur caractère
	Élément 2: Nouvel auteur	Valeur caractère, ADD, RMV
DOCCLS	Classe de document	Valeur caractère, SAME, RMV	Facultatif
KWD	Mot clé	Valeurs uniques: SAME Autres valeurs (jusqu'à 50 répétitions): Liste d'éléments*	Facultatif
	Élément 1: Mot clé	Valeur caractère
	Élément 2: Nouveau mot clé	Valeur caractère, ADD, RMV
SUBJECT	Objet	Valeurs uniques: SAME Autres valeurs (jusqu'à 50 répétitions): Liste d'éléments*	Facultatif
	Élément 1: Objet	Valeur caractère
	Élément 2: Nouvel objet	Valeur caractère, ADD, RMV
FILCAB	Classeur	Valeur caractère, SAME, RMV	Facultatif
CPYLST	Liste des copies	Valeurs uniques: SAME Autres valeurs (jusqu'à 50 répétitions): Liste d'éléments*	Facultatif
	Élément 1: Liste des copies	Valeur caractère
	Élément 2: Nouvelle liste de copie	Valeur caractère, ADD, RMV
CMDCHRID	ID caractères pour commande	Valeurs uniques: SYSVAL, DEVD Autres valeurs: Liste d'éléments	Facultatif
	Élément 1: Jeu de caractères graphiques	Entier
	Élément 2: Page de codes	Entier
DOCCHRID	ID caractères du document	Valeurs uniques: SYSVAL, DEVD, SAME Autres valeurs: Liste d'éléments*	Facultatif
	Élément 1: Jeu de caractères graphiques	Entier
	Élément 2: Page de codes	Entier

Identificateur de distribution (DSTID)

Indique l'identificateur unique de la distribution. Celui-ci est affecté à la distribution par le système qui l'a généré. Un message d'erreur est émis si l'identificateur concerne une distribution sortante.

ID-distribution: L'identificateur de distribution comporte trois éléments, qui apparaissent dans l'ordre suivant : la deuxième partie du code ID de l'expéditeur, la première partie de ce code (comptant toutes deux 8 positions comblées, au besoin, par des caractères de remplissage à droite) et un numéro de séquence de 4 chiffres, en décimal étendu, avec zéros à gauche. Par exemple : 'NEWYORK SMITH 0204'. Ce paramètre est obligatoire lorsque la valeur *DSTID est indiquée à l'invite Information à envoyer (paramètre TYPE).

Ce paramètre est obligatoire.

Suffixe ID de distribution (DSTIDEXN)

Indique le suffixe de l'identificateur de distribution, s'il en existe un, précisé à l'invite Identificateur de distribution(paramètre DSTID). Ce suffixe, qui est composé de deux chiffres, peut prendre une valeur de 01 et 99 et identifie de façon spécifique les distributions en double. La valeur par défaut est 01.

*NONE: Il n'y a pas de distribution en double. La valeur *NONE correspond au suffixe 01.
suffixe-ID-distribution: Indiquez le suffixe associé à la distribution, ce qui permettra d'identifier de façon spécifique les distributions en double.

Commentaire (COMMENT)

Commentaires sur la distribution.

*SAME: Le commentaire ne change pas.
*RMV: Le commentaire est supprimé de la distribution.
commentaire: Vous pouvez inclure, entre apostrophes, jusqu'à 256 caractères de texte.

Identificateur utilisateur (USRID)

ID utilisateur et adresse associés à cette demande.

*CURRENT: L'utilisateur exécutant la commande a accès à la distribution à modifier.
ID-utilisateur adresse: Indiquez l'ID et l'adresse de l'utilisateur ayant accès à la distribution à modifier. Si elles sont différentes de la combinaison actuelle, alors l'utilisateur en cours doit être autorisé à travailler sous procuration de l'utilisateur autorisé. Les autorisations sont accordées à l'aide de la commande GRTUSRPMN (Accorder une procuration à un utilisateur) ou par OfficeVision/400.

Degré de protection (SENSITIV)

Indique le degré de protection tel qu'il est défini par la norme X.400. Les quatre degrés de protection possibles sont les suivants : Aucun, Personnel, Privé et Confidentiel. Un utilisateur travaillant par procuration d'un utilisateur autorisé ne peut pas accéder aux distributions de type Privé.

*SAME: La valeur reste inchangée.
*NONE: La distribution n'est pas protégée.
*PERSONAL: La distribution est transmise personnellement à un utilisateur.
*PRIVATE: La distribution contient des informations auxquelles seul le destinataire doit accéder.
*CONFIDENTIAL: La distribution contient des informations dont la manipulation obéit à des règles internes à la société.

Personnel (PERSONAL)

Indique si la distribution du document fait l'objet de restrictions. Ce paramètre est à présent remplacé par le paramètre SENSITIV, mais vous pouvez encore continuer à l'utiliser. Il est toutefois possible qu'il soit supprimé dans une prochaine édition ; veuillez donc utiliser dans la mesure du possible le paramètre SENSITIV.

Si la valeur *YES est affectée au paramètre PERSONAL, le paramètre SENSITIV doit être omis ou bien posséder la valeur *NONE. Si l'invite de commande est demandée en omettant ce paramètre, il ne s'affiche pas.

*SAME: La valeur reste inchangée.
*NO: Le propriétaire et les utilisateurs possédant des droits sur la distribution peuvent accéder à celle-ci, de même que les utilisateurs travaillant par procuration d'utilisateurs autorisés. Cette valeur correspond à la valeur *NONE du paramètre SENSITIV.
*YES: Seul le propriétaire peut accéder aux documents de type Privé. Les utilisateurs autorisés à travailler par procuration d'autres utilisateurs autorisés ne peuvent pas accéder à la distribution. La valeur *PRIVATE est attribuée au paramètre SENSITIV.

Importance du contenu (IMPORTANCE)

Indique le degré d'importance (faible, normal ou élevé) du contenu d'une distribution. Ce paramètre est distinct du niveau de priorité, qui affecte uniquement la vitesse de transmission de la distribution.

*SAME: La valeur reste inchangée.
*NORMAL: Distribution d'importance normale.
*HIGH: Distribution d'importance élevée.
*LOW: Distribution de faible importance.

Priorité (PTY)

Indique la vitesse de transmission de la distribution. Dans les versions précédentes, le niveau de priorité indiquait la vitesse à laquelle les distributions parvenaient au système. Pour assurer la compatibilité avec les applications de ces versions, ce paramètre est conservé. Si l'invite de commande est demandée sans ce paramètre, celui-ci ne s'affiche pas.

*SAME: La valeur reste inchangée.
*NORMAL: La distribution parvient au système par une ligne à vitesse normale.
*HIGH: La distribution parvient au système par une ligne à vitesse élevée.

Description du document (DOCD)

Description du document à modifier. Il s'agit de la zone nom du document du profil de l'architecture d'échange de document.

*SAME: La description du document ne change pas.
description-du-document: Entrez la nouvelle description du document. Vous pouvez utiliser jusqu'à 44 caractères, entre apostrophes.

Date du document (DOCDATE)

Toute date que l'utilisateur veut attribuer à la distribution.

*SAME: La date de la distribution ne change pas.
*RMV: La date de la distribution est supprimée.
date-du-document: Indiquez la date à ajouter ou à modifier.

Date d'expiration (EXPDATE)

Date de péremption de la distribution.

*SAME: La date de péremption ne change pas.
*RMV: La date de péremption est supprimée de la distribution.
date-de-péremption: Indiquez la date de péremption à remplacer ou à ajouter. Respectez le format de date du travail.

Date limite de traitement (ACTDATE)

Indique la date limite de traitement.

*SAME: La date limite de traitement ne change pas.
*RMV: La date limite de traitement est supprimée de la distribution.
date-limite-de-traitement: Indiquez la date limite de traitement ou changez la date limite en cours, en respectant le format de date du travail.

Date de traitement (CMPDATE)

Date de traitement du document.

*SAME: La date de traitement ne change pas.
*RMV: La date de traitement est supprimée de la distribution.
date-de-traitement: Indiquez une date de traitement ou modifiez la date de traitement en cours. Respectez le format de date du travail.

Référence (REFERENCE)

Référence associée à la distribution.

*SAME: La zone de référence ne change pas.
*RMV: La référence est supprimée de la distribution.
référence: Indiquez la référence à modifier ou à ajouter. Vous pouvez utiliser jusqu'à 60 caractères.

Etat (STATUS)

Etat de la distribution, tel qu'il a été défini par l'utilisateur, par exemple, En cours, En attente d'approbation, Supprimé, etc.

*SAME: L'indicateur d'état ne change pas.
*RMV: L'indicateur d'état est supprimé.
état: Précisez l'indicateur d'état à modifier ou à ajouter. Vous pouvez utiliser jusqu'à 20 caractères.

Projet (PROJECT)

Nom de projet associé à la distribution.

*SAME: Le nom de projet ne change pas.
*RMV: Le nom de projet est supprimé de la distribution.
projet: Indiquez le projet à remplacer ou à ajouter. Vous pouvez utiliser jusqu'à 10 caractères.

Identificateur de langue (DOCLANGID)

Indique l'identificateur de langue qui sera placé dans le profil d'échange (IDP) de ce document de distribution.

Ce paramètre permet d'ajouter un identificateur de langue au profil d'échange du document (IDP) si cet identificateur n'a pas encore été indiqué ou de modifier l'identificateur existant.

Remarque :Si vous attribuez une valeur à ce paramètre et qu'aucune valeur n'a été précisée en regard de l'invite ID pays ou région (paramètre DOCCNTRYID), vous devez indiquer également un identificateur de pays ou de région.

*SAME: L'identificateur de langue ne change pas.
*JOB: L'identificateur de langue indiqué pour le travail à partir duquel cette commande a été entrée est utilisé.
identificateur-de-langue: Indiquez un identificateur de langue. Pour afficher la liste des identificateurs possibles, appuyez sur F4 à partir de l'invite Identificateur de langue (paramètre DOCLANGID).

ID pays ou région (DOCCNTRYID)

Indique l'identificateur de pays ou de région qui sera placé dans le profil d'échange (IDP) de ce document de distribution.

Ce paramètre permet d'ajouter un identificateur de pays ou de région au profil d'échange du document (IDP) si cet identificateur n'a pas encore été indiqué ou de modifier l'identificateur existant.

Remarque :Si vous attribuez une valeur à ce paramètre et qu'aucune valeur n'a été précisée en regard de l'invite Identificateur de langue (paramètre DOCLANGID), vous devez indiquer également un identificateur de langue.

*SAME: L'identificateur de pays ou de région ne change pas.
*JOB: L'identificateur de pays ou de région indiqué pour le travail à partir duquel cette commande a été entrée est utilisé.
identificateur-pays-ou-région: Indiquez un identificateur de pays ou de région. Pour afficher la liste des identificateurs possibles, appuyez sur la touche F4 à partir de l'invite ID pays ou région (paramètre DOCCNTRYID).

Indic expiration distribution (DSTEXPDATE)

Indique la date et l'heure auxquelles la présence de la distribution n'est plus nécessaire dans le registre courrier.

Les valeurs possibles pour la date d'expiration de la distribution sont les suivantes :

*SAME

La valeur reste inchangée.

Si la valeur *SAME est indiquée à la fois pour la date et l'heure d'expiration de la distribution, aucune modification n'est apportée.

Si une valeur différente de *SAME est indiquée pour l'heure d'expiration de la distribution, la commande permet de vérifier l'existence d'une date d'expiration pour la distribution. Si une date existe, elle demeure inchangée et l'heure est modifiée comme indiqué. S'il n'existe aucune date d'expiration pour la distribution, un message d'erreur est émis et vous devez alors indiquer une valeur différente de *SAME.

*CURRENT

La date d'expiration de la distribution est fixée à la date du jour.

*RMV

La date et l'heure d'expiration de la distribution sont retirées du document.

date-expiration-distribution

Indiquez la date d'expiration à utiliser. Vous devez respecter le format défini par la valeur système QDATFMT.

Les valeurs possibles pour l'heure d'expiration de la distribution sont les suivantes :

*SAME

La valeur reste inchangée.

Si la valeur *SAME est indiquée à la fois pour la date et l'heure d'expiration de la distribution, aucune modification n'est apportée.

Si une valeur différente de *SAME est indiquée pour la date d'expiration de la distribution, le système vérifie l'existence d'une heure d'expiration de la distribution. Si une heure existe, elle demeure inchangée et la date est modifiée comme indiqué. S'il n'existe aucune heure d'expiration pour la distribution, un message d'erreur est émis et vous devez alors indiquer une valeur différente de *SAME.

*CURRENT

L'heure d'expiration de la distribution est fixée à l'heure en cours.

*ENDOFDAY

Le délai d'expiration représente la fin de la date indiquée. L'heure prend la valeur 23:59:59.

heure-expiration-distribution

Indiquez l'heure d'expiration à utiliser.

L'heure est indiquée au format 24 heures avec l'utilisation facultative d'un séparateur horaire.

Si vous n'utilisez pas de séparateur, indiquez une chaîne horaire de 4 ou 6 chiffres (hhmm ou hhmmss où hh=heures, mm=minutes et ss=secondes). Les valeurs admises pour hh sont comprises entre 00 et 23. Pour mm et ss, elles sont comprises entre 00 et 59.

Si vous utilisez un séparateur d'heure, indiquez une chaîne de 5 ou 8 chiffres (heures et minutes, ou heures, minutes et secondes). Le séparateur indiqué par la valeur système QTIMSEP est utilisé pour séparer les heures, les minutes et les secondes. Si la commande est entrée à partir d'une ligne de commande, vous devez délimiter la chaîne horaire par des apostrophes. Si vous utilisez un séparateur d'heure différent de celui employé pour votre travail, la commande n'aboutit pas. Les valeurs admises pour hh sont comprises entre 00 et 23. Pour mm et ss, elles sont comprises entre 00 et 59.

Auteur (AUTHOR)

Auteur(s) de la distribution. Vous pouvez utiliser jusqu'à 20 caractères, entre apostrophes.

Ce paramètre admet des valeurs multiples.

Les valeurs possibles pour l'invite Auteur sont les suivantes :

*SAME: L'auteur du document ne change pas.
auteur: Indiquez un auteur à modifier, supprimer ou ajouter.

Les valeurs possibles pour le nouvel auteur sont les suivantes :

nouvel-auteur: Indiquez le nom du nouvel auteur.
*ADD: La valeur indiquée est ajoutée à l'information portant sur la distribution.
*RMV: La valeur indiquée ne sera plus comprise dans l'information portant sur la distribution.

Classe de document (DOCCLS)

Classe de la distribution.

*SAME: La classe de la distribution ne change pas.
*RMV: La classe de la distribution est supprimée.
classe-de-document: Indiquez la classe à supprimer ou à ajouter. Vous pouvez entrer jusqu'à 16 caractères, entre apostrophes.

Mot clé (KWD)

Mots clés pouvant être utilisés pour décrire la distribution.

Ce paramètre admet des valeurs multiples.

Les valeurs possibles pour l'invite Mot clé sont les suivantes :

*SAME: Les mots clés ne changent pas.
mot clé: Indiquez un mot clé à modifier, à supprimer ou à ajouter. Vous pouvez entrer jusqu'à 60 caractères, entre apostrophes.

Les valeurs possibles pour le nouveau mot clé sont les suivantes :

nouveau-mot clé: Indiquez un nouveau mot clé pour remplacer le mot clé utilisé. Vous pouvez entrer jusqu'à 60 caractères, entre apostrophes.
*ADD: La valeur indiquée est ajoutée à l'information portant sur la distribution.
*RMV: La valeur indiquée ne sera plus comprise dans l'information portant sur la distribution.

Objet (SUBJECT)

Sujet de la distribution.

Ce paramètre admet des valeurs multiples.

Les valeurs possibles pour l'invite Objet sont les suivantes :

*SAME: Le sujet de la distribution ne change pas.
sujet: Indiquez un sujet à modifier, supprimer ou ajouter. Vous pouvez utiliser jusqu'à 60 caractères.

Les valeurs possibles pour le nouvel objet sont les suivantes :

nouveau-sujet: Indiquez un sujet pour remplacer le sujet en cours. Vous pouvez utiliser jusqu'à 60 caractères.
*ADD: Le sujet désigné est ajouté à l'information portant sur la distribution.
*RMV: Le sujet désigné ne sera plus compris dans l'information portant sur la distribution.

Classeur (FILCAB)

Lieu de stockage de la distribution. Ce paramètre, qui est réservé aux distributions imprimées, modifie seulement la zone du profil d'échange du document imprimé.

*SAME: Le classeur ne change pas.
*RMV: L'information relative au classeur est supprimée de la distribution.
classeur: Indiquez le classeur à modifier ou à ajouter.

Liste des copies (CPYLST)

Noms ou adresses des destinataires de la distribution.

Ce paramètre admet des valeurs multiples.

Les valeurs possibles pour l'invite Liste de copie sont les suivantes :

*SAME: La liste des copies ne change pas.
liste-des-copies: Indiquez, pour la liste des copies, un poste à modifier, à supprimer ou à ajouter.

Les valeurs possibles pour la nouvelle liste des copies sont les suivantes :

nouvelle-liste-des-copies: Indiquez le poste de la liste des copies devant remplacer le poste en cours.
*ADD: Le poste de liste des copies indiqué est ajouté à l'information portant sur la liste de diffusion.
*RMV: Le poste de liste des copies ne sera plus compris dans l'information portant sur la liste de diffusion.

ID caractères pour commande (CMDCHRID)

Identificateur de caractères (jeu de caractères graphiques et page de codes) correspondant aux données saisies comme valeurs des paramètres de la commande. Cet identificateur dépend de l'écran utilisé pour l'entrée de la commande.

*SYSVAL: Le système détermine les valeurs de jeu de caractères graphiques et de page de codes pour les paramètres de commande à partir de la valeur système QCHRID.

*DEVD: Le système détermine le jeu de caractères graphiques et la page de codes applicables à partir de la description d'unité écran sur laquelle la commande a été entrée. Cette option ne peut être utilisée que pour un travail interactif. Si elle est indiquée pour un travail par lots, une erreur se produit.

Elément 1 : Jeu de caractères graphiques

1 à 32767: Indiquez le jeu de caractères graphiques à utiliser.

Elément 2 : Page de codes

1 à 32767: Indiquez la page de codes à utiliser.

ID caractères du document (DOCCHRID)

Identificateur de caractères (jeu de caractères graphiques et page de codes) correspondant aux données de document à utiliser. Cet identificateur est fonction de l'écran ayant servi à la création de ces données de document.

*SAME: L'identificateur de caractères ne change pas.

*SYSVAL: Le système détermine les valeurs de jeu de caractères graphiques et de page de codes pour les paramètres de commande à partir de la valeur système QCHRID.

*DEVD: Le système détermine le jeu de caractères graphiques et la page de codes applicables à partir de la description d'unité écran sur laquelle la commande a été entrée. Cette option ne peut être utilisée que pour un travail interactif. Si elle est indiquée pour un travail par lots, une erreur se produit.

jeu-de-caractères-graphiques page-de-codes: Indiquez le jeu de caractères graphiques et la page de codes utilisés pour la création des données.

Remarque :Chaque élément peut comporter jusqu'à 5 chiffres.

Exemples

Exemple 1 : suppression d'un auteur

CHGDSTD   DSTID('NEWYORK DUPONT   0201')  DSTIDEXN(01)
          AUTHOR('Jean Durant' *DLT)
          KWD('Numériseurs PC' *ADD)

Cette commande permet de supprimer l'un des auteurs associés à une distribution, et d'ajouter un nouveau mot clé à la distribution.

Exemple 2 : modification du nom de document défini par l'utilisateur

CHGDSTD   DSTID('NEWYORK DUPONT  0201')  DSTIDEXN(02)
          DOCD('S/38 1984 Ventes')  USRID(JACOBSON RCHJACOB)

Dans l'exemple ci-dessus, une personne autorisée à travailler pour le compte de JACOBSON modifie le nom du document défini par l'utilisateur et associé à un document issu de la seconde distribution.

Messages d'erreur

Messages *ESCAPE

CPF90D5: La description de la distribution n'a pas été modifiée.
CPF900B: ID util et adresse &1 &2 introuvables dans répertoire système.
CPF900C: L'ouverture de session et la vérification d'inscription de l'util ont échoué.
CPF905C: Erreur lors de la recherche d'une table de conversion.
CPF9096: Impossible utiliser CMDCHRID(*DEVD) ou DOCCHRID(*DEVD) en traitement par lots.