RCLOBJOWN

Récupérer objets par propriét

En bref

La commande RCLOBJOWN vérifie que les objets possédés par un profil utilisateur figurent dans une bibliothèque, ce qui est requis.

RCLOBJOWN se lit RCL (Récupérer (libérer)) + OBJOWN. Sur IBM i, le nom d'une commande associe presque toujours un verbe et un objet.

Syntaxe minimale

RCLOBJOWN USRPRF(…)

Paramètres

USRPRF Profil utilisateur obligatoire

Astuce : dans une session 5250, tapez RCLOBJOWN 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 RCLOBJOWN vérifie que les objets possédés par un profil utilisateur figurent dans une bibliothèque, ce qui est requis. Si tel n'est pas le cas pour certains de ces objets possédés, ils sont insérés dans une bibliothèque. Si l'objet ne peut figurer que dans une bibliothèque système spécifique, il est inséré dans cette bibliothèque. Si l'objet peut résider dans n'importe quelle bibliothèque utilisateur et s'il est récupéré depuis l'ASP système (1) ou un ASP utilisateur de base (1 à 32), il est inséré dans la bibliothèque QRCL. Si l'objet est récupéré depuis un ASP principal ou secondaire, il est inséré dans une bibliothèque QRCLnnnnn ( nnnnn désigne le numéro affecté par le système d'exploitation à l'ASP principal).

Lorsqu'un profil utilisateur est supprimé et qu'il possède des objets ne figurant pas dans une bibliothèque, le message CPC2216 est envoyé après la suppression du profil utilisateur pour indiquer que la propriété des objets a été modifiée et qu'une opération de récupération, RCLOBJOWN ou RCLSTG, est nécessaire pour placer les objets dans une bibliothèque. RCLSTG étant une commande dont l'exécution peut durer un certain temps, vous pouvez tenter d'exécuter la commande RCLOBJOWN, plus rapide, car elle ne vérifie que les objets possédés par le profil utilisateur spécifié. Si la commande RCLOBJOWN ne permet pas de récupérer les objets, vous devrez exécuter la commande RCLSTG pour les récupérer.

Lorsqu'un profil utilisateur est supprimé parce qu'il est endommagé, les objets possédés par le profil utilisateur sont laissés sans propriétaire. Dans ce cas, vous devez exécuter la commande RCLSTG pour affecter ces objets au profil utilisateur QDFTOWN. Une fois la commande RCLSTG exécutée, vous pouvez utiliser la commande CHGOBJOWN pour modifier la propriété des objets affectés à QDFTOWN par la commande RCLSTG.

Si la commande RCLOBJOWN est exécutée sur un profil utilisateur dont les objets résident dans un ASP indépendant, ce dernier doit être à l'état DISPONIBLE pour que ces objets puissent être récupérés.

Remarque :La commande RCLOBJOWN effectue uniquement un sous-ensemble des fonctions exécutées par la commande RCLSTG. Reportez-vous aux informations sur la commande RCLSTG pour connaître les autres commandes de récupération qu'il est possible d'utiliser pour exécuter certaines parties de la fonction RCLSTG.

Restrictions :

Cette commande est fournie avec le droit public *EXCLUDE.
Tous les sous-systèmes doivent être inactifs pour que la commande RCLOBJOWN puisse être indiquée. A cet effet, vous pouvez utiliser la commande ENDSYS (Arrêter le système) ou ENDSBS (Arrêter un sous-système) en indiquant la valeur *ALL au paramètre SBS. Vous devez disposer du droit d'exploitation des travaux *JOBCTL pour utiliser la commande ENDSYS ou ENDSBS.
Cette commande ne permet pas de récupérer les objets *DOC ou *FLR à l'endroit où figurent les documents. Elle ne permet pas non plus de récupérer les objets *DIR ni les types d'objet suivants résidant dans les répertoires :
- Fichier STREAM (*STMF)
- Lien symbolique (*SYMLNK)
- File d'attente premier entré, premier sorti (*FIFO)
- Fichier spécial de type bloc (*BLKSF)
- Port (*SOCKET)

Paramètres

Mot-clé	Description	Valeurs possibles	Remarques
USRPRF	Profil utilisateur	Nom simple	Obligatoire, positionnel 1

Profil utilisateur (USRPRF)

Profil utilisateur pour lequel la récupération sera effectuée.

nom-simple: Indiquez le nom du profil utilisateur à traiter.

Exemples

Exemple 1: Récupération d'objets pour un profil utilisateur

RCLOBJOWN   USRPRF(MYPROFILE)

Cette commande permet de vérifier tous les objets possédés par MYPROFILE. Si certains objets ne figurent pas dans une bibliothèque, ils sont placés dans une bibliothèque système. Un message est envoyé pour chaque objet inséré dans une bibliothèque système par l'opération de récupération.

Messages d'erreur

Messages *ESCAPE

CPF8204: Le contrôle de validation ne peut pas être actif pendant une opération RCLSTG ou RCLOBJOWN.
CPF8208: L'état du système ne permet pas la récupération des objets par le propriétaire.
CPF8213: Impossible d'insérer l'objet &1 dans la bibliothèque &2.
CPF8215: Profil utilisateur &1 endommagé.
CPF8220: Bibliothèque &1 endommagée. La commande RCLOBJOWN est terminée.
CPF8232: Des définitions de validation empêchent des opérations RCLSTG ou RCLOBJOWN.
CPF8282: Profil utilisateur &1 non trouvé.