DLTDLO

La commande DLTDLO (Supprimer un document ou dossier) permet de supprimer un document ou un dossier.

Cette commande permet de supprimer les dossiers et documents périmés, de façon à ne pas encombrer l'espace disque avec des objets inutiles.

Remarque :Lorsqu'un document est supprimé, le système demande la suppression du poste correspondant dans l'index de texte (s'il existe).

Restrictions :

• Pour supprimer un document ou un dossier, vous devez disposer du droit *ALL sur celui-ci ou détenir le droit spécial *ALLOBJ (tous les objets) ou *SECADM (administrateur de la sécurité).
• Vous devez disposer du droit spécial *ALLOBJ ou *SECADM pour supprimer tous les documents ou les dossiers ou pour indiquer un propriétaire autre que vous-même.
• Une fois que vous avez appuyé sur ENTREE, le document ou le dossier indiqué est supprimé ; il n'y a pas d'invite avant sa suppression.
• Si le document ou le dossier est en cours d'utilisation, ni l'un ni l'autre ne seront supprimés.
• Lorsque plusieurs documents ou dossiers doivent être supprimés et que l'un d'eux est en cours d'utilisation ou que vous n'êtes pas autorisé à les supprimer, un message est émis et la fonction continue de supprimer les documents ou les dossiers restant dans la liste.
• Si un dossier et tous les documents et les dossiers qui y figurent sont en cours de suppression, tout document ou dossier ne pouvant être supprimé reste dans le dossier, mais tous les autres sont supprimés. Un message est émis concernant les documents ou dossiers ne pouvant être supprimés.
• Lors de l'utilisation de cette commande, un message d'erreur indiquant que des objets internes sont verrouillés peut apparaître. Un autre utilisateur utilise les fonctions de bibliothèque du document qui ne peuvent être lancées en même temps que la commande DLTDLO. Par conséquent, attendez quelques instants pour relancer la commande.
• Une valeur de pool de mémoire secondaire *ANY peut être indiquée uniquement si DLO(*ALL) FLR(*ANY) ou DLO(*SEARCH) FLR(*ANY) sont indiqués.

Paramètres

Document ou dossier (DLO)

Indique les documents ou les dossiers qui sont supprimés. Si DLO(*SEARCH) n'est pas indiqué, vous ne pouvez pas spécifier CRTDATE, CHKEXP, DOCCLS, CMDCHRID ou OWNER.

Ce paramètre est obligatoire.

*ALL

Tous les documents et dossiers classés dans le dossier indiqué dans le paramètre Dans le dossier (FLR) sont supprimés.

*SEARCH

Tous les documents et dossiers répondant aux valeurs de recherche sont supprimés. Ces valeurs sont précisées à l'aide des paramètres suivants. Quand plus d'un paramètre est indiqué, l'opérateur "AND" sert à les lier :

• paramètre Dans le dossier (FLR)
• paramètre Période de création (CRTDATE)
• paramètre Date d'expiration (CHKEXP)
• paramètre Classe de document (DOCCLS)
• paramètre Profil du propriétaire (OWNER)

Quand *SEARCH est indiqué, la recherche porte sur les descripteurs du document.

*SYSOBJNAM

Les noms d'objet système des documents ou des dossiers indiqués dans le paramètre Nom d'objet système (SYSOBJNAM) sont utilisés.

nom

Indiquez le nom du ou des documents ou dossiers à supprimer. Vous pouvez en indiquer jusqu'à 300.

Remarque :Pour supprimer un dossier et tous les documents et dossiers qu'il contient, indiquez *ALL dans le paramètre Document ou dossier (DLO) et le nom du dossier dans le paramètre Dans le dossier (FLR). Par contre, si vous indiquez un nom de dossier dans le paramètre Document ou dossier (DLO), le dossier ne pourra être supprimé que s'il est vide.

Dans le dossier (FLR)

Dossier contenant les documents ou les dossiers. Si le document ou le dossier ne figure pas dans un dossier, *NONE est indiqué.

*NONE

Le document ou le dossier ne se trouve pas dans un dossier. Les valeurs *SEARCH et *ALL indiquées dans le paramètre Document ou dossier (DLO) ne s'appliquent qu'aux documents et dossiers qui ne sont contenus dans aucun dossier.

*ANY

Une recherche est lancée à l'échelle du système. Les valeurs *SEARCH et *ALL indiquées dans le paramètre Document ou dossier (DLO) s'appliquent à tous les documents et dossiers, y compris ceux qui ne sont contenus dans aucun dossier.

nom

Indiquez le nom du dossier contenant les documents ou les dossiers.

Période de création (CRTDATE)

Indique que les documents et dossiers créés dans l'intervalle de temps précisé sont supprimés. Si ce paramètre est indiqué, *SEARCH doit également l'être dans le paramètre Document ou dossier (DLO).

Elément 1 : Heure de début

*AVAIL

Tous les documents et dossiers créés sont supprimés, peu importe le moment de leur création.

heure

Indiquez une heure. Seuls les documents et dossiers créés à compter de l'heure indiquée, à la date de début, sont supprimés. Les séparateurs sont optionnels.

• Si vous n'utilisez pas de séparateur d'heure, indiquez une chaîne de 4 ou 6 chiffres (hhmm ou hhmmss), où hh = heures, mm = minutes, ss = secondes.
• Si vous utilisez des séparateurs, indiquez une chaîne de 5 ou 8 chiffres, où le séparateur indiqué dans votre description de travail permet de distinguer les heures, les minutes et les secondes. Si vous entrez cette commande à partir de la ligne de commande, cette chaîne doit être placée entre apostrophes. Si vous utilisez un séparateur différent de celui indiqué dans votre description de travail, la commande n'aboutira pas.
• Indiquez 0 pour la valeur des secondes car celles-ci sont inutilisées dans le processus de sélection.

Si vous utilisez l'heure de début comme critère de recherche, la date de début doit être différente de *BEGIN.

Elément 2 : Date de début

*CURRENT

Seuls les documents et dossiers créés le jour où vous entrez cette commande et après l'heure de début (le cas échéant) sont supprimés.

*BEGIN

Tous les documents et dossiers créés sont supprimés, peu importe leur date de création. (Les valeurs date et heure de début ne sont pas prises en compte.)

date

Indiquez une date. Seuls les documents et dossiers créés à compter de cette date sont supprimés. Respectez le format de date du travail.

Elément 3 : Heure de fin

*AVAIL

Tous les documents et dossiers créés sont supprimés, peu importe le moment de leur création.

heure

Indiquez une heure. Seuls les documents et dossiers qui, à la date de fin, ont été créés au plus tard à l'heure indiquée sont supprimés. Pour plus de détails sur l'indication de l'heure, reportez-vous au paragraphe heure de début. Si vous utilisez l'heure de fin comme critère de recherche, la date de fin doit être différente de *END.

Elément 4 : Date de fin

*END

Tous les documents et dossiers sont supprimés, peu importe leur date de création. L'heure de fin n'est pas prise en compte.

date

Indiquez une date. Seuls les documents et dossiers créés au plus tard à cette date sont supprimés. Respectez le format de date du travail.

Date d'expiration (CHKEXP)

Date de péremption des documents à supprimer. Cette information précise la date à partir de laquelle un document n'est plus utile. Tout document portant une date de péremption (inscrite par l'utilisateur à l'écran Modification des descripteurs d'un document) antérieure à la date indiquée est supprimé. Si ce paramètre est indiqué, *SEARCH doit également l'être dans le paramètre Document ou dossier (DLO).

*NO

La date de péremption du document n'est pas prise en compte.

*CURRENT

Seuls les documents portant une date de péremption antérieure à la date du jour sont supprimés.

date

Indiquez une date. Seuls les documents portant une date de péremption antérieure à cette date sont supprimés.

Classe de document (DOCCLS)

Classe des documents à supprimer. Si ce paramètre est indiqué, *SEARCH doit également l'être dans le paramètre Document ou dossier (DLO).

*ANY

Les documents sont supprimés indépendamment de leur classe de document.

classe

Indiquez une chaîne de 1 à 16 caractères. Seuls les documents de la classe indiquée doivent être supprimés. Pour faciliter la comparaison, la classe indiquée et la classe de chaque document sont converties en majuscules.

Profil du propriétaire (OWNER)

Propriétaire des documents et dossiers à supprimer. Si ce paramètre est indiqué, *SEARCH doit également l'être dans le paramètre Document ou dossier (DLO).

*CURRENT

Seuls les documents ou les dossiers vous appartenant sont supprimés.

*ALL

Les documents et les dossiers sont supprimés indépendamment du propriétaire de l'objet. Vous devez disposer du droit spécial *ALLOBJ (tous les objets) ou *SECADM (administrateur de sécurité) pour indiquer *ALL.

nom

Indiquez le nom d'un utilisateur. Seuls les documents ou les dossiers lui appartenant sont supprimés. Vous devez disposer du droit spécial *ALLOBJ ou *SECADM pour pouvoir indiquer le nom d'un propriétaire autre que vous-même.

Nom d'objet système (SYSOBJNAM)

Nom d'objet système des documents ou dossiers à supprimer (maximum 300). Le nom d'objet système est indiqué uniquement lorsque la valeur *SYSOBJNAM l'est dans le paramètre Document ou dossier (DLO).

nom

Indiquez le nom des objets système à supprimer.

ID caractères pour commande (CMDCHRID)

Indique l'ID caractères (jeu de caractères graphiques et page de codes) pour les données entrées comme valeurs des paramètres de commande (ceci s'applique au paramètre Classe de document (DOCCLS)). L'ID caractères dépend de l'écran où la commande a été entrée.

*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 les valeurs du jeu de caractères graphiques et de la page de codes selon la description de l'écran où la commande est entrée. Cette option est admise uniquement lorsqu'elle est précisée à partir d'un travail interactif. Si vous l'utilisez dans un programme CL interactif ou un travail en mode traitement par lots, un message d'erreur est généré.

jeu-de-caractères-graphiques-page-de-codes

Indiquez les valeurs de jeu de caractères graphiques et de la page de codes utilisées pour créer le paramètre de la commande. Chaque valeur peut comporter jusqu'à 3 chiffres.

ID pool mémoire secondaire (ASP)

Indique l'ID pool de mémoire secondaire (ASP) de l'objet de la bibliothèque du document à supprimer. Une valeur autre que *ANY peut être indiquée à ce paramètre seulement si *ALL or *SEARCH est indiqué au paramètre DLO et *ANY est indiqué au paramètre FLR.

*ANY

Les objets de la bibliothèque de documents sont supprimés indépendamment de leur pool de mémoire secondaire (ASP).

1-32

Seuls les objets de la bibliothèque de documents se trouvant dans le pool de mémoire secondaire indiqué sont supprimés. Tous les objets de la bibliothèque de documents se trouvant dans d'autres pools sont ignorés. La valeur indiquée doit désigner un ASP contenant des objets de bibliothèque de documents. L'ASP 1 correspond à l'ASP système.

Remarque :Cette option permet d'aider au rétablissement d'un ASP utilisateur endommagé, en particulier un pool en dépassement. Les objets de la bibliothèque de documents et leurs descripteurs sont supprimés du pool endommagé - après que les actions nécessaires de rétablissement de données ont été mises en oeuvre pour le pool de mémoire secondaire. Ainsi, les objets en dépassement et les objets risquant d'être endommagés sont retirés du pool avant la restauration des supports de sauvegarde.

Exemples

Exemple 1 : suppression d'un dossier

DLTDLO   DLO(ABC)

Cette commande permet de supprimer le dossier ABC s'il ne contient aucun document ou dossier.

Exemple 2 : suppression de tous les documents et dossiers d'un dossier

DLTDLO   DLO(*ALL)  FLR(ABC)

Cette commande permet de supprimer tous les documents et dossiers que l'utilisateur est autorisé à supprimer dans le dossier ABC. Si le dossier ABC est vide, il est alors également supprimé.

Exemple 3 : suppression de tous les documents d'une classe de document en utilisant le droit spécial *SECADM

DLTDLO   DLO(*SEARCH)
         CRTDATE((*AVAIL 080187) (*AVAIL 083187))
         DOCCLS(LETTERS)  OWNER(*ALL)

Cette commande permet de supprimer tous les documents de la classe de document LETTERS classés dans le système en août 1987. Seuls le responsable de la sécurité et un utilisateur disposant du droit spécial *SECADM sont autorisés à indiquer le paramètre OWNER(*ALL).

Exemple 4 : suppression des documents de l'utilisateur en cours

DLTDLO   DLO(*SEARCH)  CRTDATE((*AVAIL *BEGIN) (*AVAIL *END))
         DOCCLS(*ANY)  OWNER(*CURRENT)

Cette commande permet de supprimer tous les documents appartenant à l'utilisateur actuel.

Exemple 5 : suppression des documents de l'utilisateur classés ce jour

DLTDLO   DLO(*SEARCH)

Cette commande permet de supprimer tous les documents appartenant à l'utilisateur spécifié qui ont été classés le jour courant.

Exemple 6 : suppression de documents et dossiers comportant des descripteurs de documents

DLTDLO   DLO(*SEARCH)  CRTDATE((*AVAIL *BEGIN) (*AVAIL *END))
         DOCCLS(*ANY)  OWNER(*ALL)

Cette commande permet de supprimer du système tous les documents et dossiers comportant des descripteurs de documents. Si les descripteurs du document ne sont pas synchronisés avec les objets du document et du dossier, ils sont identiques à DLO(*ALL). Les rubriques Sauvegarde, Reprise et Disponibilité de l'Information Center comportent davantage d'informations sur la synchronisation des descripteurs de documents.

Messages d'erreur

Messages *ESCAPE

CPF2204

Profil utilisateur &1 non trouvé.

CPF8A16

Tous les documents ou dossiers n'ont pas été supprimés. &1 objets supprimés.

CPF9005

Les ressources système nécessaires pour traiter cette demande ne sont pas disponibles.

CPF9006

Utilisateur non inscrit dans le répertoire de distribution du système.

CPF9012

L'ouverture de la session d'échange de documents pour &1 a échoué.

CPF9029

Vous n'êtes pas autorisé à indiquer le profil propriétaire &1.

CPF903A

0pération demandée impossible si activité document/dossier en cours.

CPF9031

Vous n'êtes pas autorisé à indiquer DLO(*ALL).

CPF9032

La session d'échange de documents n'a pas été démarrée.

CPF9046

Aucun document ne répond aux critères de recherche dans le dossier &1.

CPF9062

Vous devez indiquer une date lorsque l'heure est différente de *AVAIL.

CPF9063

Les valeurs de début et de fin pour CRTDATE sont inversées.

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.