WRKOBJLCK

Gérer verrouillages d'objet

En bref

La commande WRKOBJLCK (Gérer verrouillages d'objet) permet de gérer les demandes de verrouillage relatives à un objet donné dans le système.

WRKOBJLCK se lit WRK (Gérer) + OBJLCK. Sur IBM i, le nom d'une commande associe presque toujours un verbe et un objet.

Syntaxe minimale

WRKOBJLCK OBJ(…) OBJTYPE(…)

Paramètres

OBJ Objet obligatoire
OBJTYPE Type d'objet obligatoire
MBR Membre
ASPDEV Unité ASP
OUTPUT Sortie

Astuce : dans une session 5250, tapez WRKOBJLCK 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 WRKOBJLCK (Gérer verrouillages d'objet) permet de gérer les demandes de verrouillage relatives à un objet donné dans le système. Vous pouvez gérer les verrouillages tenus et les verrouillages en attente.

Restrictions :

L'utilisateur doit disposer du droit d'exécution *EXECUTE sur la bibliothèque contenant l'objet et sur la description d'unité ASP. Sinon, l'utilisateur doit disposer du droit d'exploitation *JOBCTL.
Cette commande ne permet pas d'afficher les verrouillages d'enregistrement des fichiers base de données.
Les files d'attente de messages de poste de travail ne peuvent pas être allouées et n'ont donc pas de verrouillages. Une file d'attente de messages de poste de travail est associée à une description d'unité de poste de travail du même nom. Par conséquent, pour déterminer le motif de non fonctionnement d'une opération qui requiert l'allocation de la file d'attente de messages de poste de travail, l'utilisateur doit vérifier si des verrouillages figurent sur la description d'unité du même nom.

Paramètres

Mot-clé	Description	Valeurs possibles	Remarques
OBJ	Objet	Nom d'objet qualifié	Obligatoire, positionnel 1
	Qualificatif 1: Objet	Nom
	Qualificatif 2: Biblio	Nom, LIBL, CURLIB
OBJTYPE	Type d'objet	ALRTBL, AUTL, BNDDIR, CFGL, CHTFMT, CLD, CLS, CMD, CNNL, COSD, CRG, CRQD, CSI, CSPMAP, CSPTBL, CTLD, DEVD, DOC, DTAARA, DTADCT, DTAQ, EDTD, EXITRG, FCT, FILE, FLR, FNTRSC, FNTTBL, FORMDF, FTR, GSS, IGCDCT, IGCSRT, IGCTBL, IMGCLG, IPXD, JOBD, JOBQ, JOBSCD, JRN, JRNRCV, LIB, LIND, LOCALE, MEDDFN, MENU, MGTCOL, MODD, MODULE, MSGF, MSGQ, M36, M36CFG, NODL, NTBD, NWID, NWSCFG, NWSD, OUTQ, OVL, PAGDFN, PAGSEG, PDFMAP, PDG, PGM, PNLGRP, PRDAVL, PRDDFN, PRDLOD, PSFCFG, QMFORM, QMQRY, QRYDFN, SBSD, SCHIDX, SPADCT, SQLPKG, SQLUDT, SQLXSR, SRVPGM, SSND, S36, TBL, TIMZON, USRIDX, USRPRF, USRQ, USRSPC, VLDL, WSCST	Obligatoire, positionnel 2
MBR	Membre	Nom, NONE, FIRST, *ALL	Facultatif, positionnel 3
ASPDEV	Unité ASP	Nom, , SYSBAS	Facultatif
OUTPUT	Sortie	, PRINT	Facultatif

Objet (OBJ)

Indique le nom et la bibliothèque de l'objet dont les verrouillages doivent être affichés.

Ce paramètre est obligatoire.

Qualificatif 1 : Objet

nom: Indiquez le nom de l'objet.

Qualificatif 2 : Biblio

*LIBL: La recherche porte sur toutes les bibliothèques de l'unité d'exécution jusqu'à ce que la première occurrence soit trouvée.
*CURLIB: La bibliothèque en cours pour l'unité d'exécution permet de localiser l'objet. Si celle-ci n'est indiquée, QGPL est prise par défaut.

nom: Indiquez le nom de la bibliothèque contenant l'objet.

Si un membre de fichier est indiqué et que *LIBL représente la valeur de bibliothèque du fichier, la recherche s'effectue dans le premier fichier dans la liste des bibliothèques de l'unité d'exécution. Pour les types d'objet existant uniquement dans la bibliothèque QSYS (*DEVD par exemple), seuls QSYS et *LIBL sont acceptés. Lorsque vous indiquez une valeur autre que * pour Unité ASP (ASPDEV), *LIBL ne peut pas être indiqué.

Type d'objet (OBJTYPE)

Précise le type d'objet dont les verrouillages sont à afficher. Indiquez la valeur prédéfinie qui permet d'identifier le type d'objet.

Ce paramètre est obligatoire.

Type-objet: Indiquez le type d'objet. Pour plus d'informations, reportez au paramètre OBJTYPE (Type d'objet) de la commande WRKOBJ (Gérer les objets).

Membre (MBR)

Indique le nom de membre d'un fichier base de données. Ce paramètre est admis uniquement si un fichier base de données a été indiqué pour le paramètre OBJ (Objet).

*NONE: Aucun verrouillage de membre n'est affiché, à l'exception des verrouillages de niveau fichier. L'écran Verrouillages d'objets permet de demander l'affichage des verrouillages de la totalité des membres.
*FIRST: Le premier membre du fichier base de données indiqué est affiché.
*ALL: Les verrouillages de membres sont affichés pour tous les membres du fichier base de données.
nom: Indiquez le nom du membre de fichier base de données dont les verrouillages doivent être affichés.

Unité ASP (ASPDEV)

Indique le nom de l'unité ASP dans laquelle se trouve la bibliothèque contenant l'objet spécifié pour le paramètre OBJ (Objet). Si la bibliothèque de l'objet réside dans un ASP qui ne fait pas partie de l'espace de nom de bibliothèque associé à l'unité d'exécution, ce paramètre doit être indiqué pour assurer que l'objet correct est utilisé comme cible de l'opération.

*: Les ASP qui font actuellement partie du nom d'espace de bibliothèque de l'unité d'exécution seront recherchés pour localiser l'objet. Les ASP concernés sont l'ASP système (numéro d'ASP 1), tous les ASP utilisateur de base configurés (numéros d'ASP 2 à 32) et, si l'unité d'exécution est dotée d'un groupe d'ASP, tous les ASP indépendants du groupe d'ASP.
*SYSBAS: Le système ASP et les ASP utilisateur de base feront l'objet d'une recherche afin de localiser l'objet. Aucun ASP indépendant ne sera recherché, même si l'unité d'exécution est dotée d'un groupe d'ASP.
nom: Le nom d'unité de l'ASP indépendant qui doit être recherché pour localiser l'objet. L'ASP indépendant doit avoir été activé (en mettant l'unité ASP en fonction) et avoir un état défini comme "Actif" ou "Disponible". L'ASP système et les ASP utilisateur de base ne seront pas recherchés.

Sortie (OUTPUT)

Indique si la sortie générée par la commande doit être affichée sur le poste de travail demandeur, ou imprimée avec la sortie spoule du travail.

*: La sortie est affichée pour les travaux interactifs ou imprimée avec la sortie spoule de travaux dans le cas des travaux non interactifs.

*PRINT: Le résultat est placé dans un fichier spoule de la file d'attente en sortie du travail.

Exemples

Exemple 1 : impression des informations concernant le verrouillage d'objet d'un fichier

WRKOBJLCK   OBJ(*LIBL/LOCKEDFILE)  OBJTYPE(*FILE)
            MBR(LOCKEDMBR) OUTPUT(*PRINT)

Cette commande permet d'imprimer les informations de verrouillage du membre LOCKEDMBR situé dans le fichier LOCKEDFILE. La liste des bibliothèques permet de localiser le fichier.

Exemple 2 : gestion des verrouillages d'objet d'une bibliothèque sur un ASP indépendant

WRKOBJLCK   OBJ(QSYS/LIBNAME) OBJTYPE(*LIB) ASPDEV(PRODXX)

Cette commande permet à l'utilisateur de gérer les informations de verrouillage de la bibliothèque LIBNAME située sur l'unité de pool de mémoire secondaire (ASP) PRODXX.

Messages d'erreur

Messages *ESCAPE

CPFB8ED: La description d'unité &1 est incorrecte pour l'opération.
CPF0919: Bibliothèque endommagée dans la liste des bibliothèques.
CPF0924: Bibliothèque inutilisable dans la liste des bibliothèques.
CPF0935: Nom de membre non admis pour un objet de type *&2.
CPF0939: Objet &3 de type &2 non trouvé dans la bibliothèque &4.
CPF0948: Membre &1 du fichier &3 de &4 non trouvé.
CPF095B: Valeur pour ASPDEV incorrecte avec valeur spéciale pour bibliothèque.
CPF0950: &2 &3 non trouvé dans la bibliothèque &4.
CPF0951: QSYS est la seule bibliothèque correcte pour type d'objet &2.
CPF0952: Bibliothèque &4 non trouvée pour &2 &3.
CPF0953: Bibliothèque de la liste des bibliothèques précédemment supprimée.
CPF0958: &2 &3 de &4 sauvegardé avec libération mémoire.
CPF0988: Bibliothèque &4 endommagée.
CPF1093: Substitution incorrecte du type d'unité du fichier.
CPF3285: Fichier &1 de la bibliothèque &3 endommagé.
CPF9803: Impossible d'allouer l'objet &2 de la bibliothèque &3.
CPF9804: Objet &2 dans bibliothèque &3 endommagé.
CPF9814: Unité &1 non trouvée.
CPF9820: Non autorisé à utiliser la bibliothèque &1.
CPF9825: Accès non autorisé à l'unité &1.
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.
CPF9850: Substitution non admise pour fichier imprimante &1.
CPF9851: Valeur de ligne fin de page trop faible pour fichier &1 dans &2.
CPF9871: Erreur lors du traitement.