RLSIFSLCK

La commande Libérer verrous syst fichiers (RLSIFSLCK) permet de :

• Libérer tous les verrous de plage d'octets du système NFS maintenus par un client NFS indiqué.
• Libérer tous les verrous de plage d'octets (tous types) maintenus sur un objet indiqué.
• Libérer tous les verrous de plage d'octets ainsi que l'état NFS version 4 maintenus par le serveur NFS sur l'intégralité d'un système de fichiers.

N'utilisez cette commande que pour libérer des ressources qu'il est impossible de libérer par d'autres moyens.

Pour plus de détails sur les verrous de plage d'octets, reportez-vous à la section décrivant l'API fcntl dans le manuel Ensemble de rubriques API de la catégorie Programmation de l'IBM i Information Center (http://www.ibm.com/systems/i/infocenter/), ou le manuel i5/OS Network File System Support, SC41-5714.

Restrictions :

• Pour utiliser cette commande, l'utilisateur doit disposer du droit spécial de configuration système d'entrée-sortie (*IOSYSCFG).
• L'utilisateur doit disposer du droit d'exécution (*X) sur les répertoires des préfixes de nom de chemin.
• L'utilisateur doit disposer du droit de lecture (*R) sur l'objet dont les verrous sont en cours de libération.

Paramètres

Lieu éloigné (RMTLOCNAME)

Indique le nom de l'hôte ou l'adresse Internet d'un système éloigné dont les verrous NFS sur des fichiers locaux sont à libérer.

Le nom du système éloigné doit être correct pour que la commande aboutisse. L'utilisateur peut attribuer un nom d'hôte à une adresse Internet à l'aide de l'option Work with TCP/IP host table entries du menu Configure TCP/IP (commande CFGTCP). Un serveur de noms éloigné peut également être utilisé pour mapper des noms de systèmes éloignés avec des adresses Internet. Pour indiquer le nom d'un serveur de noms éloigné, utilisez l'option de modification de serveur de noms éloigné du menu CFGTCP.

Les conventions suivantes s'appliquent aux noms d'hôte :

• Le premier caractère doit être une lettre (A à Z) ou un chiffre (0 à 9).
• Le dernier caractère doit être une lettre (A à Z) ou un chiffre (0 à 9).
• Vous pouvez utiliser indifféremment des majuscules et des minuscules ; aucune distinction n'est effectuée.
• Les blancs ( ) ne sont pas admis.
• Les caractères spéciaux, le point (.) et le signe moins (-) sont admis.
• Chaque partie du nom séparée par des points (.) peut comporter jusqu'à 63 caractères au maximum.
• Un nom peut comporter de 1 à 255 caractères.

'nom-lieu-éloigné'

Indique le nom de l'hôte ou l'adresse Internet d'un système éloigné dont les verrous NFS sur des fichiers locaux sont à libérer.

Remarque :Vous devez indiquer soit le paramètre RMTLOCNAME, soit Objet (OBJ) et non les deux.

Objet (OBJ)

Indique le nom de chemin d'un objet (ou du système de fichiers d'un objet) dont vous souhaitez libérer les verrous. Les paramètres Verrouillages serveur NFS (NFSSVRLCK) et Verr locaux plages d'octets (LCLBRNGLCK) permettent d'identifier les verrous à libérer. Le paramètre Système de fichiers de l'objet (OBJMFS) permet d'indiquer si le paramètre OBJ représente l'objet même ou le système de fichiers de cet objet.

'nom-chemin'

Indique le nom de chemin de l'objet représentant les verrous à libérer.

Remarque :Vous devez indiquer soit Lieu éloigné (RMTLOCNAME), soit le paramètre OBJ, et non les deux.

Pour obtenir de plus amples informations relatives à la spécification des noms de chemin, reportez-vous à "Object naming rules" dans la rubrique Rubriques CL de la catégorie Programmation de l'IBM i Information Center, à l'adresse http://www.ibm.com/systems/i/infocenter/.

Remarque :Ce paramètre est compatible Unicode. Pour plus d'informations, reportez-vous à la section sur la prise en charge Unicode dans CL, dans les Rubriques CL de la catégorie Programmation de l'IBM i Information Center, à l'adresse http://www.ibm.com/systems/i/infocenter/.

Verrouillages serveur NFS (NFSSVRLCK)

Indique si tous les verrous et l'état NFS version 4 doivent être libérés ou non pour l'objet indiqué. Ce paramètre est ignoré si le paramètre RMTLOCNAM est par ailleurs utilisé.

*YES

Tous les verrous et l'état NFS version 4 maintenus par le serveur NFS seront supprimés pour l'objet.

*NO

Les verrous et l'état NFS version 4 maintenus par le serveur NFS ne seront pas libérés.

Verr locaux plages d'octets (LCLBRNGLCK)

Indique si tous les verrous de plage d'octets locaux doivent être libérés ou non pour l'objet indiqué. Ces verrous seront tous libérés, quels que soient leur type et l'opération qui en est à l'origine. Ce paramètre est ignoré si le paramètre RMTLOCNAM est par ailleurs utilisé.

Remarque :Vous pouvez utiliser soit le paramètre LCLBRNGLCK, soit le paramètre Système de fichiers de l'objet (OBJMFS), mais pas les deux.

*YES

Tous les verrous de plage d'octets locaux placés sur l'objet indiqué seront libérés.

*NO

Les verrous de plage d'octets locaux placés sur l'objet indiqué ne seront pas libérés.

Système de fichiers de l'objet (OBJMFS)

Indique si tous les verrous et l'état NFS version 4 doivent être libérés pour le système de fichiers dans lequel se trouve l'objet indiqué. Ce paramètre est ignoré si le paramètre RMTLOCNAM est par ailleurs utilisé.

Remarque :Vous pouvez utiliser soit le paramètre OBJMFS, soit le paramètre Verr locaux plages d'octets (LCLBRNGLCK), mais pas les deux.

*NO

Les verrous et l'état NFS version 4 ne doivent pas être libérés pour le système de fichiers dans lequel se trouve l'objet indiqué.

*YES

Tous les verrous et l'état NFS version 4 doivent être libérés pour le système de fichiers dans lequel se trouve l'objet indiqué.

Exemples

Exemple 1 : Libération de tous les verrous pour un système éloigné

RLSIFSLCK   RMTLOCNAME('rainbow1')

Cette commande libère les verrous lié au système de gestion de fichiers en réseau (NFS) détenus sur des fichiers locaux par le système rainbow1.

Exemple 2 : Libération de verrous pour un objet local

RLSIFSLCK   OBJ('/ComptesClients/Mai')

Cette commande libère tous les verrous de plage d'octets appliqués à l'objet /ComptesClients/Mai.

Exemple 3 : Libération des verrous pour un système de fichiers

RLSIFSLCK OBJ('/ComptesClients/Avril') NFSSVRLCK(*YES)
          LCLBRNGLCK(*NO) OBJMFS(*YES)

Cette commande libère tous les verrous et l'état NFS version 4 pour le système de fichiers contenant /ComptesClients/Avril.

Messages d'erreur

Messages *ESCAPE

CPFA09C

Aucun droit sur l'objet. L'objet est &1.

CPFA0A9

Objet introuvable. L'objet est &1.

CPFA1B6

Impossible de libérer les verrouillages, code raison &1. L'objet est &3.

CPFA1B8

Droit *IOSYSCFG obligatoire pour utiliser &1.