Aller au contenu

SNDDST

Envoyer une distribution

En bref

La commande SNDDST (Envoyer une distribution) permet d'envoyer une distribution à un utilisateur, à une liste d'utilisateurs, ou à une liste de diffusion.

SNDDST se lit SND (Envoyer) + DST. Sur IBM i, le nom d'une commande associe presque toujours un verbe et un objet.

Syntaxe minimale

SNDDST TYPE(…)

Paramètres

Astuce : dans une session 5250, tapez SNDDST 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 SNDDST (Envoyer une distribution) permet d'envoyer une distribution à un utilisateur, à une liste d'utilisateurs, ou à une liste de diffusion.

Restrictions :

  • Si vous travaillez pour le compte d'un autre utilisateur, une procuration vous y autorisant doit vous avoir été accordée à l'aide de la commande GRTUSRPMN (Accorder procuration à utilis).
  • Vous devez être inscrit dans le répertoire de distribution du système.
  • Vous ne pouvez pas demander une distribution personnelle si vous travaillez pour le compte d'un autre utilisateur.

Paramètres

Mot-clé Description Valeurs possibles Remarques
TYPE Information à envoyer *MSG, *DOC, *FILE, *IDP, *DSTID, *LMSG Obligatoire, positionnel 1
TOUSRID Destinataire Values (jusqu'à 300 répétitions): Liste d'éléments Facultatif, positionnel 2
Élément 1: ID utilisateur Valeur caractère
Élément 2: Adresse Valeur caractère
Élément 3: Type de destinataire *PRI, *CC, *BCC
TOINTNET Destinataire Internet Values (jusqu'à 300 répétitions): Liste d'éléments Facultatif
Élément 1: Adresse Internet Valeur caractère, *NONE
Élément 2: Type de destinataire *PRI, *CC, *BCC
DSTD Description Valeur caractère Facultatif, positionnel 3
MSG Message Valeur caractère, *NONE, *DSTIDMSG Facultatif
LONGMSG Message long Valeur caractère, *NONE Facultatif
CFMDEL Confirmation de réception *NO, *YES Facultatif
SENSITIV Degré de protection *NONE, *PRIVATE, *PERSONAL, *CONFIDENTIAL Facultatif
PERSONAL Personnel *NO, *YES Facultatif
IMPORTANCE Importance du contenu *NORMAL, *LOW, *HIGH Facultatif
PTY Priorité *NORMAL, *HIGH, *LOW 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
DOCFILE Fichier contenant document Valeurs uniques: *NONE
Autres valeurs: Nom d'objet qualifié
Facultatif
Qualificatif 1: Fichier contenant document Nom
Qualificatif 2: Biblio Nom, *LIBL, *CURLIB
DOCMBR Membre contenant document Nom, *FIRST Facultatif
DOCTYPE Type de document 2-65535, *DFT, *FFT, *RFT Facultatif
SNDFMT Format d'envoi *NOCHG, *NOTE, *FINALFORM Facultatif
SYSCOD Code système Valeur caractère, *DFT Facultatif
DOCCHRID ID caractères du document 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
DSTID Identificateur de distribution Valeur caractère, *NONE Facultatif
DSTIDEXN Suffixe ID de distribution 0-99, *NONE Facultatif
DOC Document Valeur caractère, *DOCID Facultatif
FLR Dans le dossier Valeur caractère, *NONE Facultatif
DOCID Identificateur du document Valeur caractère, *NONE Facultatif
IDPFILE Fichier contenant profil doc Valeurs uniques: *NONE, *DOCFILE, *DSTIDIDP
Autres valeurs: Nom d'objet qualifié
Facultatif
Qualificatif 1: Fichier contenant profil doc Nom
Qualificatif 2: Biblio Nom, *LIBL, *CURLIB
IDPMBR Membre contenant profil doc Nom, *FIRST Facultatif
DOCD Description du document Valeur caractère, *DFT, *DSTD Facultatif
AUTHOR Auteur Valeurs uniques: *NONE, *USRID
Autres valeurs (jusqu'à 50 répétitions): Valeur caractère
Facultatif
DOCCLS Classe de document Valeur caractère, *NONE Facultatif
KWD Mot clé Valeurs uniques: *NONE
Autres valeurs (jusqu'à 50 répétitions): Valeur caractère
Facultatif
SUBJECT Objet Valeurs uniques: *NONE, *DOCD
Autres valeurs (jusqu'à 50 répétitions): Valeur caractère
Facultatif
DOCDATE Date du document Date, *NONE, *CURRENT Facultatif
FILCAB Classeur Valeur caractère, *NONE Facultatif
CPYLST Liste des copies Valeurs uniques: *NONE
Autres valeurs (jusqu'à 50 répétitions): Valeur caractère
Facultatif
EXPDATE Date d'expiration Date, *NONE Facultatif
CRTDATE Date de création Date, *NONE, *CURRENT Facultatif
REFERENCE Référence Valeur caractère, *NONE Facultatif
ACTDATE Date limite de traitement Date, *NONE, *CURRENT Facultatif
RPYDATE Réponse demandée Liste d'éléments Facultatif
Élément 1: Date Date, *NONE, *CURRENT, *ANY
Élément 2: Heure Heure, *ENDOFDAY
STATUS Etat du document Valeur caractère, *NONE Facultatif
CMPDATE Date de traitement Date, *NONE, *CURRENT Facultatif
PROJECT Projet Valeur caractère, *NONE Facultatif
DOCLANGID Identificateur de langue Valeur caractère, *JOB Facultatif
DOCCNTRYID ID pays ou région Valeur caractère, *JOB Facultatif
ALWALTRCP Admettre autre destinataire *YES, *NO Facultatif
DISCLOSE Mentionner destinataires *YES, *NO Facultatif
ALWX400CNV Admettre conversion X.400 *YES, *NO Facultatif
AUTUSR Utilisateur autorisant distrib Valeurs uniques: *NONE
Autres valeurs: Liste d'éléments
Facultatif
Élément 1: ID utilisateur Valeur caractère
Élément 2: Adresse Valeur caractère
DSTEXPDATE Indic expiration distribution Liste d'éléments Facultatif
Élément 1: Date Date, *NONE
Élément 2: Heure Heure, *ENDOFDAY
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

Information à envoyer (TYPE)

Type d'information envoyée et paramètres acceptés pour cette commande.

*MSG
Seul le message précisé à l'invite Message (paramètre MSG) est envoyé.
*DOC
Le document indiqué aux zones Document (paramètre DOC) ou Identificateur du document (paramètre DOCID) est envoyé. Le document n'est envoyé que si l'utilisateur détient un droit sur celui-ci.
*FILE
Le fichier base de données indiqué aux zones Fichier contenant document (paramètre DOCFILE) et Membre contenant document (paramètre DOCMBR) est envoyé sans modification à condition que l'utilisateur ait un droit sur ce fichier.
*IDP
Le profil d'échange du document indiqué aux zones Fichier contenant profil doc (paramètre IDPFILE) et Membre contenant profil doc (paramètre IDPMBR), ou précisé dans le profil de document créé à l'aide de cette commande, est envoyé.
*DSTID
Le poste courrier identifié par l'ID distribution est distribué. L'ID distribution est également appelé nom de la distribution.
*LMSG
Le texte indiqué à l'invite Message long (paramètre LONGMSG) est envoyé sous forme de note FFTDCA. La valeur maximale admise pour le paramètre LONGMSG est 5000 caractères, ce qui représente environ une page de texte. Les paramètres de "détail" (Objet, référence, Auteur, Date, etc.) sont supportés avec TYPE(*LMSG). Le paramètre TOINTNET est également supporté avec TYPE(*LMSG).

Destinataire (TOUSRID)

Permet d'indiquer :

  • L'ID et l'adresse des utilisateurs destinataires. Ces zones peuvent être laissées à blanc lors d'un envoi via Internet.
  • Le nom des listes de diffusion contenant l'ID et l'adresse du ou des utilisateurs auxquels la distribution est envoyée. Cette zone peut être laissée à blanc lors d'un envoi via Internet.

Vous pouvez combiner des ID utilisateur et des listes de diffusion dans la même commande. Vous pouvez indiquer jusqu'à 300 ID et adresses utilisateur.

Si le paramètre TOUSRID ne comporte aucun ID et adresse utilisateur, une adresse Internet doit être spécifiée avec le paramètre TOINTNET.

Les valeurs possibles pour l'ID utilisateur ou l'ID liste sont les suivantes :

ID-utilisateur
Indiquez l'ID de l'utilisateur auquel est envoyée la distribution.
ID-liste
Indiquez l'ID de la liste de diffusion répertoriant les utilisateurs auxquels est envoyée la distribution.

Les valeurs possibles d'adresse d'utilisateur et de qualificatif de liste sont les suivantes :

adresse-utilisateur
Indiquez l'adresse de l'utilisateur (précisée à l'élément 1) auquel est envoyée la distribution.
qualificatif-liste
Indiquez le qualificatif de liste de diffusion des utilisateurs (spécifiés à l'élément 1) auxquels est envoyée la distribution.

Les valeurs possibles de type de destinataire sont les suivantes :

*PRI
L'utilisateur de la liste de diffusion est le destinataire principal de la distribution.
*CC
L'utilisateur ou la liste de diffusion reçoit une copie de la distribution envoyée au destinataire principal. Cependant, le destinataire de la copie ne sera pas désigné sur la distribution comme étant destinataire de la distribution.
*BCC
L'utilisateur ou la liste de diffusion reçoit une copie de la distribution. Cependant, le destinataire de la copie ne sera pas désigné sur la distribution comme étant destinataire de la distribution.

Destinataire Internet (TOINTNET)

Indique l'adresse Internet du ou des utilisateurs auxquels la distribution est envoyée. Si TOINTNET(*NONE) est indiqué, au moins un ID et une adresse utilisateur doivent être spécifiés avec le paramètre TOUSRID. Vous pouvez indiquer jusqu'à 300 adresses Internet.

Le paramètre TOINTNET n'est pas admis lorsque le mot clé TYPE a pour valeur *MSG.

*NONE
Aucune adresse Internet n'est indiquée. Il s'agit d'une valeur unique.
valeur-alphanumérique
Indiquez l'adresse Internet de la personne ou de l'entreprise à laquelle la distribution est envoyée (jusqu'à 253 caractères par adresse).

Les valeurs possibles de type de destinataire sont les suivantes :

*PRI
L'adresse Internet correspond au destinataire principal de la distribution.
*CC
L'adresse Internet recevra une copie de la distribution envoyée au destinataire principal.
*BCC
L'adresse Internet recevra une copie de la distribution. Cependant, le destinataire de la copie ne sera pas désigné sur la distribution comme étant destinataire de la distribution.

Description (DSTD)

Description de la distribution. Vous pouvez utiliser jusqu'à 44 caractères. Ce paramètre est obligatoire et ne peut pas commencer par un blanc ni être constitué uniquement de blancs.

Message (MSG)

Indique si un bref message doit accompagner la distribution.

*NONE
Aucun message n'est envoyé.
*DSTIDMSG
La distribution est accompagnée du message contenu dans la distribution indiquée à l'invite Identificateur de distribution (paramètre DSTID).
texte-du-message
Entrez le message à envoyer aux utilisateurs. Vous pouvez indiquer jusqu'à 256 caractères.

Message (LONGMSG)

Indiquez le texte à envoyer aux destinataires sous forme de note FFTDCA.

*NONE
Aucun texte n'est envoyé. Il s'agit de la valeur par défaut qui est requise lorsque la valeur du paramètre TYPE est autre que *LMSG.
texte-message-long
Indiquez le texte (5000 caractères au maximum) à envoyer aux destinataires. Le texte sera placé dans un document FFTDCA qui sera envoyé sous forme de note.

Le texte doit être formaté à l'aide des options suivantes au sein du texte.

  • :/N - Génère une nouvelle ligne (retour chariot).
  • :/P - Génère un nouveau paragraphe. Nouvelle ligne plus une ligne à blanc (retour chariot et un retour chariot imposé).

Le document est défini avec 10 caractères par pouce, un ID police égal à 11, une marge de gauche en position 1, et une marge de droite en position 75. Si l'option :/N n'est pas utilisée pour démarrer une nouvelle ligne, le texte continue au-delà de la marge de droite et ne peut pas être visualisé par certains clients de messagerie électronique. Les blancs ne sont pas retirés du texte mais ils sont laissés en guise de marque d'indentation ou d'alignement. Aucun texte supplémentaire (liste de destinataires, date/heure, objet, émetteur) n'est ajouté dans le document.

Note technique destinée aux programmeurs : Toute option FFTDCA (au format hexadécimal) peut être insérée dans le texte afin de permettre un plus grand contrôle du format si les options énumérées précédemment ne sont pas suffisantes.

Confirmation de réception (CFMDEL)

Indique si l'expéditeur désire recevoir une confirmation de réception lorsque le destinataire reçoit la distribution. S'il n'en demande pas, il sera quand même avisé de toute erreur d'ID utilisateur ou d'acheminement ou de toute erreur système empêchant la distribution. S'il en demande, il est avisé de la réception de la distribution ou du fait que le destinataire l'a supprimée avant de la recevoir ou a lancé une autre commande pour la traiter. Pour obtenir cette information, l'expéditeur doit lancer la commande QRYDST (Interroger les distributions) en indiquant *OUT à l'invite Entrante ou sortante (paramètre OPTION).

*NO
L'expéditeur ne demande pas de confirmation de réception.
*YES
Une confirmation de réception est demandée.

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

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

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

*NORMAL
Distribution d'importance normale.
*HIGH
Distribution d'importance élevée.
*LOW
Distribution de faible importance.

Priorité (PTY)

Indique le niveau de priorité de la distribution (faible, normal ou élevé). Dans le cas de distributions s'adressant à des destinataires éloignés, le degré de priorité détermine la file d'attente SNADS du système suivant utilisé. Les distributions de priorité normale utilisent la file d'attente normale. Les distributions de faible priorité utilisent la file d'attente normale avec le niveau de priorité le plus bas. Les distributions de priorité élevée utilisent la file d'attente prioritaire du système suivant. La différence entre les niveaux de priorité dépend des informations fournies par l'utilisateur dans la commande CFGDSTSRV (Configurer les services de distribution). La gestion des distributions de priorité peut sensiblement varier d'un noeud de système à l'autre mais, d'une manière générale, les distributions dont le niveau de priorité est élevé empruntent les chemins les plus rapides lorsque c'est possible. Pour les distributions adressées à des destinataires locaux, le degré de priorité détermine si un message est envoyé dans la file d'attente de messages du destinataire afin de l'avertir de la distribution. Ce message n'est envoyé que pour les distributions de priorité élevée.

*NORMAL
La distribution n'est pas prioritaire.
*HIGH
La distribution est prioritaire.
*LOW
La distribution est de faible priorité.

Identificateur utilisateur (USRID)

ID utilisateur et adresse à associer à la demande.

*CURRENT
Vous exécutez la demande pour votre compte.
ID-utilisateur
Indiquez l'ID d'un autre utilisateur ou le vôtre. Vous devez disposer des droits appropriés pour travailler pour le compte d'un autre utilisateur.
adresse-ID-utilisateur
Indiquez l'adresse d'un autre utilisateur ou la vôtre. Vous devez disposer des droits appropriés pour travailler pour le compte d'un autre utilisateur.

Fichier contenant document (DOCFILE)

Noms du fichier base de données et de la bibliothèque contenant les données du document. Il s'agit d'un fichier défini par l'utilisateur ou du fichier de sortie précisé dans les commandes RCVDST (Recevoir une distribution) ou RTVDOC (Extraire un document). Si un fichier de sortie est précisé, seules les données de l'enregistrement des données du document en sont extraites ; le préfixe est supprimé de cet enregistrement.

Les valeurs possibles pour la bibliothèque sont les suivantes :

*LIBL
La recherche porte sur toutes les bibliothèques de la liste des bibliothèques de l'unité d'exécution en cours jusqu'à ce que la première occurrence soit trouvée.
*CURLIB
Le fichier base de données est recherché dans la bibliothèque en cours pour ce travail. Le système utilise QGPL si aucune bibliothèque n'est définie pour le travail.
nom-bibliothèque
Indiquez la bibliothèque où se trouve le fichier base de données.
nom-du-fichier-base-de-données
Indiquez le nom du fichier base de données qui contient les données du document.

Membre contenant document (DOCMBR)

Membre du fichier base de données utilisé.

*FIRST
Le système utilise le premier membre créé dans le fichier base de données.
nom-du-membre
Indiquez le nom du membre du fichier base de données à utiliser.

Type de document (DOCTYPE)

Type de document à utiliser. Cet identificateur permet au système de déterminer s'il lui est possible ou non de traiter le flot de données correctement.

*DFT
Le système crée l'identificateur de type de document approprié d'après l'origine des données.
*FFT
Le document est un texte en forme finale. Ce type de document sera affiché et imprimé, mais non révisé, par le destinataire.
*RFT
Le document est un texte révisable. Ce type de document peut être visualisé, imprimé et révisé par le destinataire.
numéro-du-type-de-document
Indiquez une valeur identifiant le type du document. Cette valeur doit être comprise entre 2 et 65535. Les valeurs comprises entre 2 et 32767 sont contrôlées par enregistrement dans l'Architecture d'échange de documents (DIA) d'IBM et sont réservées aux types de documents définis par IBM. Les valeurs comprises entre 32768 et 65535 ne sont pas enregistrées par IBM et peuvent être utilisées pour des types de documents non définis par IBM. La signification de ces types de documents doit être définie en entrant la valeur du code système en regard de l'invite Code système (paramètre SYSCOD).

Format d'envoi (SNDFMT)

Permet à l'utilisateur d'indiquer le format du document envoyé.

*NOCHG
Le document est envoyé au format en cours.
*NOTE
Le document est envoyé comme note, sous forme de flot de données FFTDCA (Architecture de contenu de document sous forme finale).
*FINALFORM
Le document est envoyé en FFTDCA.

Code système (SYSCOD)

Texte complétant la valeur indiquée à l'invite Type de document (paramètre DOCTYPE) et servant à identifier spécifiquement le type de document à utiliser. Le destinataire détermine les exigences relatives au flot de données du document et à son traitement en vue d'éditer, de visualiser, d'imprimer ou de modifier ce document.

*DFT
Le système fournit un code système par défaut. Si la valeur indiquée à l'invite Type de document (paramètre DOCTYPE) est un numéro se situant entre 2 et 32 767, ce code est 'IBM System i5 CL', extrait du message CPX9026. Si la valeur indiquée à l'invite Type de document (paramètre DOCTYPE) est un numéro se situant entre 32 768 et 65 535, vous devez préciser un code système.
code-système
Entrez le texte identifiant spécifiquement le type de document à envoyer. Vous pouvez indiquer jusqu'à 13 caractères.

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.

*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 les valeurs correspondant au jeu de caractères graphiques et à la page de codes utilisés pour créer les données à distribuer.

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

Identificateur de distribution (DSTID)

Indique l'identificateur unique de la distribution. L'identificateur spécifique à la distribution est attribué par le système au début de la distribution. Les identificateurs de distribution peuvent être trouvés à l'aide de la commande QRYDST (Interroger les distributions). Ils sont également renvoyés par la commande SNDDST (Envoyer une distribution).

*NONE
Aucun identificateur n'est utilisé.
ID-distribution
Indiquez l'identificateur de distribution composé de trois éléments apparaissant dans l'ordre suivant : la deuxième partie de l'ID utilisateur de l'expéditeur, sa première partie (comptant toutes deux huit positions) et un numéro de séquence de quatre 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).

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 2 chiffres, peut prendre une valeur de 00 à 99 et identifie de façon spécifique les distributions en double. Pour les distributions entrantes, seules les valeurs de 01 à 99 sont permises. Le suffixe des accusés de réception doit être 00.

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

Document (DOC)

Nom du document à envoyer.

nom-du-document
Indiquez le nom, attribué par l'utilisateur, du document à envoyer. Vous pouvez utiliser jusqu'à 10 caractères.
*DOCID
Le document à envoyer est identifié par le nom système du document en bibliothèque.

Dans le dossier (FLR)

Nom du dossier contenant le document à envoyer, c'est-à-dire nom attribué par l'utilisateur à ce dossier lors de sa création. Si le nom du document est précisé à l'invite Document (paramètre DOC), vous ne devez pas entrer *DOCID.

*NONE
Le document ne se trouve pas dans un dossier.
nom-du-dossier
Indiquez le nom du dossier contenant le document à envoyer. Ce nom peut se composer d'une série de noms de dossiers si le document à envoyer se trouve dans un dossier qui est contenu dans un ou plusieurs autres dossiers.

Identificateur du document (DOCID)

Indique le nom attribué au document par la bibliothèque. Il s'agit en fait du nom que le système a attribué au document lors de la création de ce dernier. Les documents classés hors du système local ont exclusivement ce type de nom. Les noms de documents attribués par la bibliothèque peuvent être déterminés à l'aide de la commande QRYDOCLIB (Interroger une bibliothèque de documents) ou à l'aide du message renvoyé par la commande FILDOC (Classer un document).

Les noms de documents attribués par la bibliothèque ont une longueur de 24 caractères, et doivent se conformer au format suivant :

AAAAMMJJHHMNSSCSNSNSNSNS

dans lequel :

       AAAA = année
         MM = mois
         JJ = jour
         HH = heures
         MN = minutes
         SS = secondes
         CS = centièmes de seconde
   NSNSNSNS = nom système

*NONE
Aucun nom système de document en bibliothèque n'est obligatoire lorsque le document est identifié à l'invite Document (paramètre DOC).
nom-système-du-document-en-bibliothèque
Indiquez le nom système du document en bibliothèque à envoyer.

Fichier contenant profil doc (IDPFILE)

Indique où se trouvent les informations sur le profil du document. Si vous indiquez ce paramètre, tous les autres paramètres suivant l'invite Membre contenant profil doc (paramètre IDPMBR) sont ignorés, à l'exception des invites ID caractères pour commande (paramètre CMDCHRID) et ID caractères du document (paramètre DOCCHRID).

*NONE
Le profil d'échange du document est fourni par d'autres paramètres de cette commande. Aucun fichier base de données ne contient d'informations relatives à ce profil. Si la valeur *NONE est indiquée, le système ignore l'invite Membre contenant profil doc (paramètre IDPMBR).
*DSTIDIDP
Le système utilise les informations sur le profil d'échange de documents (IDP) associées au document de distribution. Le système ignore l'invite Membre contenant profil doc (paramètre IDPMBR). Cette valeur n'est acceptée que si TYPE (*DSTID) est précisé.
*DOCFILE
Le fichier base de données précisé pour le document contient également les informations sur le profil. Si vous avez indiqué *DOCFILE, les zones Fichier contenant document(paramètre DOCFILE) et Membre contenant document (paramètre DOCMBR) fourniront les informations sur le profil du document.
nom-du-fichier-base-de-données
Indiquez le nom du fichier base de données qui contient le profil d'échange du document (IDP). Ce fichier peut être défini par l'utilisateur ou être le fichier de sortie précisé dans les commandes RCVDST (Recevoir une distribution) ou RTVDOC (Extraire un document). Si vous indiquez un fichier défini par l'utilisateur, il doit avoir le même format que le fichier de sortie produit par RCVDST ou RTVDOC. Si un fichier de sortie est indiqué, seules les données de l'enregistrement du profil de document en sont extraites. Le préfixe est retiré de cet enregistrement.

Les valeurs possibles pour la bibliothèque sont les suivantes :

*LIBL
La recherche porte sur toutes les bibliothèques de la liste des bibliothèques de l'unité d'exécution en cours jusqu'à ce que la première occurrence soit trouvée.
*CURLIB
Le fichier base de données est recherché dans la bibliothèque en cours pour ce travail. Le système utilise QGPL si aucune bibliothèque n'est définie pour le travail.
nom-bibliothèque
Indiquez la bibliothèque où se trouve le fichier base de données.

Membre contenant profil doc (IDPMBR)

Membre du fichier d'échange du document. Ce paramètre n'est utilisé que lorsqu'un nom de fichier base de données est également précisé à l'invite Fichier contenant profil doc (paramètre IDPFILE).

*FIRST
Le système utilise le premier membre créé dans le fichier base de données.
nom-du-membre
Indiquez le nom du membre du fichier base de données à utiliser.

Description du document (DOCD)

Description du document à distribuer. Cette information se trouve dans la zone du nom de document du profil de l'architecture d'échange de document (IDP).

*DFT
Le système génère une description du document. Pour les fichiers de base de données, le format par défaut est nom-bibliothèque/nom-fichier/nom-membre. Le système génère une description de document ; il utilise par défaut le format nom-de-la-bibliothèque/nom-du-fichier/nom-du-membre pour les fichiers base de données, la description de la distribution pour les documents papier, et la description de document associée à la distribution pour les distributions.
*DSTD
La description de la distribution indiquée à l'invite Description (paramètre DSTD) est utilisée comme description de document.
description-du-document
Entrez la description du document. Vous pouvez utiliser jusqu'à 44 caractères.

Auteur (AUTHOR)

Auteur(s) du document.

Ce paramètre admet des valeurs multiples.

*NONE
Aucun auteur n'est identifié pour le document.
*USRID
L'ID utilisateur et l'adresse précisées à l'invite Identificateur utilisateur (paramètre USRID) sont utilisées comme nom d'auteur.
nom-de-l'auteur-du-document
Indiquez le nom des auteurs. Vous pouvez préciser jusqu'à 50 noms.

Classe de document (DOCCLS)

Classe associée au document, par exemple, NOTE DE SERVICE, FORMULAIRE ou FEUILLE.

*NONE
Aucune classe n'est attribuée au document.
classe-de-document
Indiquez la classe du document. Vous pouvez utiliser jusqu'à 16 caractères.

Mot clé (KWD)

Mots clés décrivant le document.

Ce paramètre admet des valeurs multiples.

*NONE
Aucun mot clé n'est défini pour ce document.
mot clé-du-document
Indiquez les mots clés servant à décrire le document. Vous pouvez en entrer jusqu'à 50, chacun comportant un maximum de 60 caractères.

Objet (SUBJECT)

Sujet(s) du document.

Ce paramètre admet des valeurs multiples.

*NONE
Aucun sujet n'est défini pour le document.
*DOCD
La description du document est utilisée comme sujet.
sujet-du-document
Indiquez le ou les sujets du document. Vous pouvez en préciser jusqu'à 50, chacun comportant un maximum de 60 caractères.

Date du document (DOCDATE)

Toute date attribuée au document par l'utilisateur.

*NONE
Aucune date n'est attribuée au document.
*CURRENT
Le système attribue au document la date système en cours.
date-du-document
Indiquez la date du document. Respectez le format de date du travail.

Classeur (FILCAB)

Emplacement de stockage du document. Ce paramètre est réservé aux documents imprimés. Le profil d'échange du document, qui fait référence au document imprimé, est distribué. Ce paramètre est obligatoire si *IDP est indiqué à l'invite Information à envoyer (paramètre TYPE) et si *NONE est précisé à l'invite Fichier contenant profil doc (paramètre IDPFILE).

*NONE
Aucune référence de classeur n'est définie pour ce document.
référence-au-classeur
Indiquez l'emplacement du document imprimé. Vous pouvez utiliser jusqu'à 60 caractères.

Liste des copies (CPYLST)

Nom des destinataires du document.

Ce paramètre admet des valeurs multiples.

*NONE
Aucune liste des copies n'est fournie pour ce document.
liste-destinataires
Indiquez le nom des utilisateurs devant recevoir le document. Vous pouvez entrer jusqu'à 50 noms, chacun comportant un maximum de 60 caractères.

Date d'expiration (EXPDATE)

Indique la date à partir de laquelle le document n'est plus requis.

*NONE
Aucune date de péremption n'est indiquée.
date-de-péremption
Indiquez la date de péremption du document. Respectez le format de date du travail.

Date de création (CRTDATE)

Date de création du document.

*NONE
Aucune date de création n'est indiquée.
*CURRENT
La date système en cours est utilisée comme date de création du document.
date-de-création
Indiquez la date de création du document. Respectez le format de date du travail.

Référence (REFERENCE)

Référence associée au document.

*NONE
Aucune zone référence n'est fournie pour cette distribution.
référence
Indiquez la référence associée au document. Vous pouvez utiliser jusqu'à 60 caractères.

Date limite de traitement (ACTDATE)

Indique la date limite de traitement de la demande. Si aucune date n'est précisée et qu'une date de demande de la réponse est indiquée, la date limite de traitement est définie à partir de la date de demande de la réponse.

*NONE
Aucune date limite de traitement n'est indiquée.
*CURRENT
La date du jour est utilisée.
date-limite-de-traitement
Indiquez la date limite de traitement à utiliser. Vous devez respecter le format défini par la valeur système QDATFMT.

Réponse demandée (RPYDATE)

Indique la date et l'heure limites fixées pour la réponse à la distribution. Le paramètre concerne uniquement les destinataires principaux.

Les valeurs possibles de date de réponse sont les suivantes :

*NONE
Aucune réponse n'est requise.
*CURRENT
La date du jour est utilisée. L'heure prend la valeur par défaut *ENDOFDAY, fixée à 23:59:59.
*ANY
Une réponse est demandée mais aucune date et heure n'est fixée.
date-réponse
Indiquez la date limite de réponse à utiliser. Vous devez respecter le format défini par la valeur système QDATFMT.

Les valeurs possibles d'heure de réponse sont les suivantes :

*ENDOFDAY
Une réponse est demandée au plus tard à la date indiquée. L'heure prend la valeur 23:59:59.
heure-réponse
Indiquez l'heure limite de réponse à 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.

Etat du document (STATUS)

Indique l'état que l'utilisateur a défini pour le document. Exemples d'états : En cours, En attente confirmation, Retiré...

*NONE
Aucun état n'est fourni dans ce document.
état-du-document
Indiquez l'état du document. Vous pouvez utiliser jusqu'à 20 caractères.

Date de traitement (CMPDATE)

Date de traitement du document.

*NONE
Aucune date de traitement n'est fournie.
*CURRENT
La date système en cours est utilisée comme date de traitement.
date-de-traitement
Indiquez la date de traitement de l'action. Respectez le format de date du travail.

Projet (PROJECT)

Projet auquel le document est associé.

*NONE
Il n'y aura pas d'informations sur le projet dans ce document.
projet
Indiquez le projet du document. Vous pouvez utiliser jusqu'à 10 caractères.

Identificateur de langue (DOCLANGID)

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

Remarque :Ce paramètre n'est pas pris en compte si une valeur est indiquée en regard de l'invite Fichier contenant profil doc (paramètre IDPFILE) ou si *MSG ou *DOC est précisé en regard de l'invite Information à envoyer (paramètre TYPE).

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

Remarque :Ce paramètre n'est pas pris en compte si une valeur est indiquée en regard de l'invite Fichier contenant profil doc (paramètre IDPFILE) ou si *MSG ou *DOC est précisé en regard de l'invite Information à envoyer (paramètre TYPE).

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

Admettre autre destinataire (ALWALTRCP)

Indique si la distribution peut être transmise à un autre destinataire, déterminé par le système cible. Cette fonction, utilisée uniquement par les systèmes X.400 en réseau, permet de rediriger certains courriers vers un utilisateur particulier.

Cette zone contient par défaut la valeur *YES. Il est possible qu'un utilisateur indique le degré de protection Privé sans préciser la valeur *NO dans cette zone. Dans ce cas, un élément privé risque d'être envoyé à un autre destinataire. Aucun message d'erreur n'est émis alors.

*YES
La distribution peut être transmise à un autre destinataire.
*NO
La distribution ne peut pas être transmise à un autre destinataire.

Mentionner destinataires (DISCLOSE)

Indique si chaque destinataire peut obtenir ou non la liste des autres destinataires.

*YES
La liste des destinataires est mentionnée.
*NO
La liste des destinataires n'est pas mentionnée.

Admettre conversion X.400 (ALWX400CNV)

Indique si une conversion X.400 est admise dans la distribution soumise. Dans certains cas, l'utilisateur final connaît les capacités du destinataire et est en mesure d'indiquer si la conversion n'est pas nécessaire. L'administrateur du système peut déterminer si la conversion va avoir lieu ou pas. Cette zone permet à l'utilisateur d'inverser ce choix par le biais d'un message. Par exemple, si la fonction passerelle admet la conversion, l'utilisateur peut indiquer dans un message que cette conversion est interdite. La distribution n'est alors pas convertie.

Remarque :Ce paramètre n'est admis que pour la fonction X.400. Il n'a aucun effet sur la transformation des flots de données System i5 (RFT en FFTDCA, par exemple).

*YES
La conversion de la distribution peut être effectuée par le système cible.
*NO
Aucune conversion de la distribution ne peut être effectuée par le système cible.

Utilisateur autorisant distrib (AUTUSR)

Indique l'ID et l'adresse de l'utilisateur qui a autorisé la distribution. Cet utilisateur recevra un exemplaire de la distribution.

*NONE
Aucun utilisateur n'est indiqué.

La valeur possible de l'ID utilisateur est la suivante :

ID-utilisateur
Indiquez l'ID de l'utilisateur qui a autorisé la distribution.

La valeur possible de l'adresse de l'utilisateur est la suivante :

adresse-utilisateur
Indiquez l'adresse de l'utilisateur qui a autorisé la distribution.

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 :

*NONE
Aucune date d'expiration n'est indiquée pour la distribution.
date-expiration-distribution
Indiquez la date d'expiration à utiliser pour la distribution. 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 :

*ENDOFDAY
Une heure de péremption est requise à 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.

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.

Dans certains cas, les données sont converties en une page de codes et un jeu de caractères interchangeables avec d'autres produits OfficeVision/400 IBM. La valeur du jeu de caractères interchangeable et de la page de codes correspondante est '697 500', excepté pour les paramètres USRID à l'invite Identificateur utilisateur, TOUSRID à l'invite Destinataire et DSTID à l'invite Identificateur de distribution, pour lesquels elle est '930 500'. Dans d'autres cas, la page de codes et le jeu de caractères sont associés à la zone et envoyés avec elle, ce qui permet au terminal récepteur d'imprimer et d'afficher correctement cette zone.

Les paramètres suivants font l'objet d'une conversion :

  • Destinataire (TOUSRID)
  • Destinataire Internet (TOINTNET)
  • Identificateur utilisateur (USRID)
  • Identificateur de distribution (DSTID)
  • Code système du document (SYSCOD)
  • Message (MSG)
  • Description (DSTD)

La page de codes et le jeu de caractères sont associés aux paramètres suivants :

  • Message long (LONGMSG)
  • Description du document (DOCD)
  • Auteur (AUTHOR)
  • Classe de document (DOCCLS)
  • Mot clé (KWD)
  • Objet (SUBJECT)
  • Classeur (FILCAB)
  • Liste des copies (CPYLST)
  • Référence (REFERENCE)
  • Etat du document (STATUS)
  • Projet (PROJECT)

Valeurs uniques

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

Exemples

Exemple 1 : envoi d'une distribution pour le compte d'un autre utilisateur

SNDDST   TYPE(*FILE)  TOUSRID((JACKSON RCH38DB))
         DOCTYPE(20000)  SYSCOD(BRANDX)
         DOCFILE(DEPT46ELIB/XTEXT)  DOCMBR(GOLD1IPFS)
         PTY(*HIGH)  USRID(JACOBSON RCH38NBS)
         DSTD('IPFS POUR PROJET GOLD1')  CFMDEL(*YES)
         MSG('Mettre à jour section 1.2.4. Renvoyer pour
impression finale')

Cette commande permet à une personne autorisée à travailler pour le compte de JACOBSON (comme par exemple une secrétaire) d'envoyer une distribution. Le document envoyé est un document texte BRANDX envoyé à un utilisateur qui utilise également le traitement de texte BRANDX.

Exemple 2 : envoi d'un poste de registre courrier

SNDDST   TYPE(*DSTID)  DSTID('NEWYORK DUPONT 0204')
         DSTIDEXN(02)  TOUSRID((JACKSON RCH38DB))
         MSG(*DSTIDMSG)  CFMDEL(*YES)

Cette commande permet d'envoyer un poste de registre courrier identifié par le document de distribution NEWYORK DUPONT 0204 distribué à l'utilisateur JACKSON à l'adresse RCH38DB. Le message du document de distribution est joint à l'envoi.

Messages d'erreur

Messages *ESCAPE

CPF8A87
Le nom de document &2 est incorrect.
CPF8A97
Le nom de dossier &1 est incorrect.
CPF89AA
SNDFMT(*FINALFORM) correct uniquement si TYPE(*DOC).
CPF89AB
SNDFMT(*NOCHG) requis si TYPE(*IDP ou *MSG).
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é.
CPF901A
La demande d'envoi de distribution a échoué.
CPF903D
Identificateur de document incorrect.
CPF905C
Erreur lors de la recherche d'une table de conversion.
CPF9096
Impossible utiliser CMDCHRID(*DEVD) ou DOCCHRID(*DEVD) en traitement par lots.
CPF9845
Erreur lors de l'ouverture du fichier &1.
CPF9846
Erreur lors du traitement du fichier &1 de &2.
CPF9847
Erreur lors de la fermeture du fichier &1 de bibliothèque &2.

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