DLTDST

La commande DLTDST (Supprimer une distribution) vous permet de supprimer vos propres distributions ou de supprimer des distributions pour un autre utilisateur. Cette commande permet également aux opérateurs système de supprimer des objets de distribution endommagés ou dissociés (des objets de distribution qui ne sont pas contrôlés par un objet de suivi de distribution).

Restrictions :

1. Si vous travaillez par procuration d'un autre utilisateur, vous devez en avoir reçu la permission via la commande GRTUSRPMN (Accorder une procuration à un utilisateur), ou disposer du droit spécial *ALLOBJ.
2. Le demandeur de la commande doit être inscrit dans le répertoire de distribution du système.
3. Un demandeur ne peut recevoir de distribution personnelle lorsqu'il travaille par procuration.
4. Les objets de distribution endommagés ou dissociés ne peuvent être supprimés que par l'utilisateur ayant ouvert une session avec le droit *ALLOBJ.

Paramètres

Identificateur de distribution (DSTID)

Indique l'identificateur unique de la distribution. Celui-ci a été assigné à la distribution par le système qui l'a généré. 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).

Ce paramètre admet des valeurs multiples.

Ce paramètre est obligatoire.

*ERROBJ

Les distributions à supprimer sont des objets de distribution endommagés ou dissociés.

Remarque :Pour supprimer une distribution endommagée ou dissociée, vous devez également préciser une valeur au paramètre OBJ.

identificateur-distribution

Indiquez les identificateurs de distribution. Vous pouvez préciser :

• jusqu'à 50 identificateurs,
• l'adresse de l'expéditeur (insérez des blancs à droite pour totaliser 8 caractères),
• l'ID utilisateur de l'expéditeur (insérez des blancs à droite pour totaliser 8 caractères),
• un numéro de séquence en décimal étendu (4 chiffres avec zéros à gauche).

  Remarques :

  • Des apostrophes sont nécessaires si l'identificateur de distribution contient des blancs ou des caractères spéciaux.
  • La distribution indiquée ne doit pas être endommagée ou dissociée.

Entrante ou sortante (OPTION)

Indique si la distribution indiquée à l'invite Identificateur de distribution (paramètre DSTID) est entrante, sortante ou erronée.

*IN

Une distribution entrante envoyée à l'utilisateur est supprimée.

*OUT

Une distribution sortante envoyée par l'utilisateur est supprimée. L'état sortant est attribué par le système à une distribution envoyée à un ou plusieurs utilisateurs, qui doivent fournir un accusé de réception.

*ERR

Une distribution erronée, c'est-à-dire retournée parce qu'une erreur s'est produite en cours d'acheminement, est supprimée.

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.

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.

*NONE

Il n'y a pas de distribution en double. Pour les distributions entrantes, la valeur *NONE correspond au suffixe 01, et pour les distributions sortantes ou qui n'ont pas été diffusées, elle correspond au suffixe 00.

suffixe-ID-distribution

Indiquez le suffixe associé à la distribution, ce qui permettra d'identifier de façon spécifique les distributions en double.

Objet (OBJ)

Indique les objets de distribution endommagés ou dissociés à supprimer.

*NONE

Aucun objet de distribution endommagé ou mal associé n'est supprimé.

*ALL

Tous les objets de distribution endommagés ou dissociés sont supprimés.

nom-objet

Indiquez le nom de l'objet endommagé ou mal associé à supprimer.

L'objet désigné peut être un objet local ou éloigné.

• Un nom d'objet local est composé de l'adresse et de l'ID utilisateur de l'expéditeur (complétés par des blancs à droite jusqu'à totaliser 8 caractères au maximum), ainsi que d'un numéro de séquence en décimal étendu (4 chiffres avec zéros à gauche). Par exemple :

  'LIMOGES MORIN   0204'   ou
  ADREXPEDIDUTILIS0099
  

  Les apostrophes sont nécessaires si l'identificateur de distribution comporte des blancs ou des caractères spéciaux. L'identificateur de distribution est défini de cette manière parce que les blancs sont admis dans un ID ou une adresse utilisateur.

• Un nom d'objet éloigné est composé du nom du système éloigné ainsi que de la date et de l'heure système. Par exemple :

  'QOSRDIST091112509152355'
  

  où QOSRDIST est le nom du système éloigné, 0911125 représente la date système (25 novembre 1991) et 09152355 représente l'heure système (9:15:23:55).

Les identificateurs des distributions endommagées ou dissociées peuvent être déterminés lors de l'exécution de la commande SAVDLO (Sauvegarder un document ou un dossier) et de l'identification des objets de distribution endommagés ou dissociés.

Vous pouvez désigner jusqu'à 50 objets à supprimer.

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.

Si les valeurs entrées aux invites Identificateur de distribution (paramètre DSTID) et Identificateur utilisateur (paramètre USRID) sont extraites d'un fichier de sortie créé à l'aide de la commande QRYDST (Interroger les distributions), utilisez la valeur '930 500' pour ce paramètre.

*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 : suppression de la distribution entrante envoyée à l'utilisateur

DLTDST   DSTID(('RCH38P  DURANT  0019'))  USRID(*CURRENT)
         DSTIDEXN(02)

Cette commande permet de supprimer une distribution entrante envoyée à l'utilisateur.

Exemple 2 : suppression de l'état d'une distribution sortante

DLTDST   DSTID(('SYSTEM20  MARTIN  1361'))
         USRID(*CURRENT)  DSTIDEXN(00)
         OPTION(*OUT)  CMDCHRID(101 37)

Cette commande permet de supprimer l'état associé à une distribution sortante. La valeur du paramètre DSTID est codée avec un identificateur de caractères, où la page de code est 37 et le jeu de caractères 101. Elle est ensuite convertie avant que le système tente de localiser la distribution dans l'index de distribution du destinataire.

Exemple 3 : suppression de la distribution entrante envoyée à un utilisateur connecté

DLTDST   DSTID(('CHICAGO LEFEVRE   0013'))

Cette commande permet de supprimer une distribution entrante envoyée un utilisateur connecté. Par défaut, l'extension de la distribution est '01' pour les distributions entrantes. En cas d'envoi de doublons de distributions, cette commande supprime uniquement la première occurrence.

Exemple 4 : suppression de toutes les distributions endommagées

DLTDST   DSTID(*ERROBJ)  OBJ(*ALL)

Cette commande permet de supprimer toutes les distributions endommagées et dissociées sur le système.

Messages d'erreur

Messages *ESCAPE

CPF89BD

L'objet doit être indiqué avec DSTID(*ERROBJ).

CPF900A

&2 distribution(s) supprimée(s); &1 distribution(s) non supprimée(s).

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

CPF9016

La demande d'annulation de la distribution de &2-&3-&4 pour &1 n'a pas abouti.

CPF905C

Erreur lors de la recherche d'une table de conversion.

CPF906C

La distribution n'a pas été supprimée.

CPF9096

Impossible utiliser CMDCHRID(*DEVD) ou DOCCHRID(*DEVD) en traitement par lots.