CRTUDFS

La commande CRTUDFS (Créer système fichiers util) permet de créer un système de fichiers, dont les objets peuvent être rendus accessibles au système de fichiers intégré à l'aide de la commande ADDMFS (Ajouter un système de fichiers monté) ou MOUNT.

Un système de fichiers défini par l'utilisateur (UDFS) est représenté par le type d'objet *BLKSF (fichier spécial de type bloc).

Restrictions :

• Pour utiliser cette commande, l'utilisateur doit disposer du droit spécial de configuration système d'entrée-sortie (*IOSYSCFG).
• S'il souhaite indiquer une valeur autre que *SYSVAL pour le paramètre Valeur d'audit des objets (CRTOBJAUD), l'utilisateur doit disposer du droit spécial d'audit (*AUDIT).
• S'il souhaite indiquer une valeur autre que *PARENT pour le paramètre Option de scannage des objets (CRTOBJSCAN), l'utilisateur doit disposer des droits spéciaux *ALLOBJ et *SECADM.
• Pour la création d'un système UDFS temporaire, les droits spéciaux sur tous les objets (*ALLOBJ) sont nécessaires.
• Il est possible de créer environ 4000 systèmes de fichiers définis par l'utilisateur dans un ASP indépendant.

Paramètres

Système fichiers utilisateur (UDFS)

Indique le nom du chemin du système de fichiers à créer. Ce nom doit se présenter selon l'un des formats suivants :

• /dev/qaspXX/nom-udfs.udfs, où XX représente le numéro de l'ASP système ou utilisateur de base sur le système, et où nom-udfs représente le nom du système de fichiers défini par l'utilisateur. Les autres éléments du chemin doivent apparaître tels qu'ils sont indiqués dans cet exemple.
• /dev/nom-asp/nom-udfs.udfs, où nom-asp représente le nom admis d'un pool de mémoire secondaire (ASP) indépendant, et où nom-udfs représente le nom d'un système de fichiers défini par l'utilisateur. Les autres éléments du chemin doivent apparaître tels qu'ils sont indiqués dans cet exemple.
• /dev/QASP01/nom-udfs.tmpudfs, où nom-udfs représente le nom du système de fichiers défini par l'utilisateur. Du fait que le nom se termine par '.tmpudfs', tous les objets créés dans le système de fichiers seront des objets temporaires qui seront supprimés lors du démontage du système de fichiers, lors du redémarrage du système ou lors de l'exécution de la commande RCLSTG (Récupérer mémoire secondaire). Un système UDFS temporaire ne peut être créé que dans l'ASP système (QASP01).

L'élément du nom de chemin doit être unique dans le répertoire qaspXX ou nom-asp indiqué.

Ce paramètre est obligatoire.

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

Droits publics sur données (DTAAUT)

Indique les droits publics accordés à l'utilisateur sur les données du nouveau système de fichiers défini par l'utilisateur (UDFS), ou bien indique que tous les droits sont hérités du répertoire dans lequel le nouveau système de fichiers doit être créé.

*INDIR

Les droits sur le système de fichiers défini par l'utilisateur (UDFS) qui doit être créé dépendent du répertoire dans lequel il doit être créé. Cela signifie que le groupe principal du nouveau système de fichiers défini par l'utilisateur, la liste d'autorisation et les droits publics, privés et de groupe principal du nouveau système de fichiers défini par l'utilisateur seront hérités du répertoire /dev/qaspXX ou /dev/aspname. Si la valeur *INDIR est indiquée pour le paramètre Droits publics sur l'objet (OBJAUT) ou DTAAUT, elle doit l'être pour les deux en même temps.

*RWX

L'utilisateur peut modifier l'objet et exécuter des fonctions de base sur ce dernier, à l'exception de celles limitées au propriétaire ou soumises à un droit d'existence (*OBJEXIST), de gestion (*OBJMGT), de modification (*OBJALTER) et de référence sur l'objet (*OBJREF). Le droit de lecture, écriture et exécution (*RWX) permet de disposer du droit d'opération sur l'objet (*OBJOPR) ainsi que de tous les droits sur les données.

*RW

L'utilisateur peut visualiser et modifier le contenu d'un objet. Le droit de lecture et écriture (*RW) permet de disposer du droit *OBJOPR ainsi que des droits de lecture (*READ), d'ajout (*ADD), de mise à jour (*UPD) et de suppression (*DLT) sur les données.

*RX

L'utilisateur peut exécuter des opérations de base sur l'objet, telles que l'exécution d'un programme ou l'affichage du contenu d'un fichier. Toutefois, cet utilisateur ne peut pas modifier l'objet. Le droit de lecture et d'exécution (*RX) fournit le droit *OBJOPR ainsi que les droits *READ et *EXECUTE sur les données.

*WX

L'utilisateur peut modifier le contenu d'un objet, exécuter un programme ou lancer une recherche dans une bibliothèque ou un répertoire. Le droit d'écriture et d'exécution (*WX) fournit le droit *OBJOPR ainsi que les droits *READ, *UPD, *DLT et *EXECUTE sur les données.

*R

L'utilisateur peut visualiser le contenu d'un objet. Le droit de lecture (*R) fournit le droit *OBJOPR ainsi que le droit *READ sur les données.

*W

L'utilisateur peut modifier le contenu d'un objet. Le droit d'écriture (*W) fournit le droit *OBJOPR ainsi que les droits *READ, *UPD et *DLT sur les données.

*X

L'utilisateur peut exécuter un programme ou lancer une recherche dans une bibliothèque ou un répertoire. Le droit d'exécution (*X) fournit le droit *OBJOPR ainsi que le droit *EXECUTE sur les données.

*EXCLUDE

L'utilisateur ne peut pas accéder à l'objet. Si cette valeur spéciale est utilisée, OBJAUT doit avoir la valeur *NONE.

*NONE

L'utilisateur ne dispose d'aucun droit sur les données de l'objet. Vous ne pouvez pas utiliser cette valeur si *NONE est indiqué pour OBJAUT.

nom-liste-autorisation

Le format de la liste d'autorisation reste le format à dix caractères en cours. Si cette valeur spéciale est utilisée, OBJAUT doit avoir la valeur *NONE. Une liste d'autorisation ne peut pas être indiquée pour un système UDFS temporaire.

Droits publics sur l'objet (OBJAUT)

Indique les droits publics accordés aux utilisateurs sur le système de fichiers défini par l'utilisateur, ou bien indique que tous les droits sont hérités du répertoire dans lequel le nouvel objet doit être créé.

*INDIR

Les droits sur le système de fichiers défini par l'utilisateur (UDFS) à créer dépendent du répertoire dans lequel l'objet doit être créé. Cela signifie que le groupe principal du nouveau système de fichiers défini par l'utilisateur, la liste d'autorisation et les droits publics, privés et de groupe principal du nouveau système de fichiers défini par l'utilisateur seront hérités du répertoire /dev/qaspXX ou /dev/aspname. Si la valeur *INDIR est indiquée pour le paramètre OBJAUT ou Droits publics sur données (DTAAUT), elle doit l'être pour les deux en même temps.

*NONE

Aucun autre droit sur l'objet (*OBJEXIST, *OBJMGT, *OBJALTER ou *OBJREF) n'est accordé aux utilisateurs. Si la valeur *EXCLUDE ou une liste d'autorisation est spécifiée au paramètre DTAAUT, *NONE doit également être indiqué. Cette valeur ne peut pas être utilisée si le paramètre DTAAUT a pour valeur *NONE.

*ALL

Tous les autres droits sur l'objet (*OBJEXIST, *OBJMGT, *OBJALTER ou *OBJREF) sont accordés aux utilisateurs.

L'utilisateur peut indiquer jusqu'à quatre valeurs parmi les suivantes :

*OBJEXIST

Un droit d'existence sur l'objet (*OBJEXIST) est accordé à l'utilisateur. Ce dernier peut ainsi supprimer l'objet, libérer de l'espace de l'objet, effectuer des opérations de sauvegarde et de restauration et transférer la propriété de l'objet.

*OBJMGT

Un droit de gestion d'objet (*OBJMGT) est accordé à l'utilisateur. Ce dernier peut ainsi définir une sécurité pour l'objet, déplacer ou rebaptiser ce dernier et ajouter des membres aux fichiers base de données.

*OBJALTER

Un droit de modification d'objet (*OBJALTER) est accordé à l'utilisateur. Ce dernier peut modifier les attributs des objets. Dans un fichier base de données, il peut ajouter et enlever des déclencheurs ainsi que des contraintes référentielles ou uniques et modifier les attributs du fichier base de données. Si l'utilisateur dispose de ce droit sur un module SQL, il peut en modifier les attributs. Pour l'instant, ce droit n'est utilisé que pour les fichiers base de données et les modules SQL.

*OBJREF

Un droit de référence d'objet (*OBJREF) est accordé à l'utilisateur. Utilisable uniquement pour les fichiers base de données, ce droit permet à l'utilisateur de référencer un objet à partir d'un autre objet de telle sorte que les opérations effectuées sur le premier objet soient limitées par le second objet. Dans un fichier physique, l'utilisateur peut ajouter une contrainte référentielle dans laquelle le fichier physique est le parent.

Valeur d'audit des objets (CRTOBJAUD)

Indique la valeur d'audit pour les objets créés dans le répertoire racine de ce système de fichiers défini par l'utilisateur.

*SYSVAL

La valeur d'audit des objets créés dans le système UDFS est déterminée par la valeur système QCRTOBJAUD.

*NONE

Le fait d'utiliser cet objet ou de le modifier ne provoque pas l'envoi d'un poste d'audit au journal de sécurité.

*USRPRF

Le profil de l'utilisateur qui accède à l'objet permet de déterminer si un enregistrement d'audit doit être envoyé pour cet accès. Le paramètre OBJAUD de la commande CHGUSRAUD (Modifier audit d'utilisateur) est utilisé pour activer l'audit d'un utilisateur spécifique.

*CHANGE

Tous les accès en modification effectués par tous les utilisateurs sur cet objet sont consignés.

*ALL

Tous les accès en modification ou en lecture effectués par tous les utilisateurs sur cet objet sont consignés.

Option de scannage des objets (CRTOBJSCAN)

Indique si les objets créés dans le répertoire racine du système de fichiers défini par l'utilisateur vont être scannés lorsque des programmes d'exit sont enregistrés sur un des points d'exit liés au scannage du système de fichiers intégré.

Les points d'exit liés au scannage du système de fichiers intégré sont les suivants :

• QIBM_QP0L_SCAN_OPEN - Programme d'exit d'analyse à l'ouverture du système de fichiers intégré QIBM_QP0L_SCAN_OPEN - Integrated File System Scan on Open Exit Program
• QIBM_QP0L_SCAN_CLOSE - Programme d'exit d'analyse à la fermeture du système de fichiers intégré QIBM_QP0L_SCAN_CLOSE - Integrated File System Scan on Close Exit Program

Pour plus d'informations sur ces points d'exit, reportez-vous au manuel Ensemble de rubriques API de la catégorie Programmation de l'IBM i Information Center (http://www.ibm.com/systems/i/infocenter/).

Même si cet attribut peut être défini pour les systèmes de fichiers définis par l'utilisateur, seuls les objets figurant dans les répertoires *TYPE2 de ce système de fichiers défini par l'utilisateur sont réellement scannés, quelle que soit la valeur définie pour cet attribut.

*PARENT

La valeur de l'attribut de création de scannage d'objet pour ce système de fichiers défini par l'utilisateur est copiée à partir de la valeur d'attribut de création de scannage d'objet du répertoire parent.

*YES

Une fois qu'un objet est créé dans le système de fichiers défini par l'utilisateur, l'objet va être scanné conformément aux règles décrites dans les programmes d'exit liés au scannage, si l'objet a été modifié ou si le logiciel de scannage a été mis à jour depuis le dernier scannage de l'objet.

*NO

Après la création d'un objet dans le système de fichiers défini par l'utilisateur, l'objet n'est pas scanné par les programmes d'exit liés au scannage.

Remarque :Si la valeur *NOPOSTRST du paramètre QSCANFSCTL n'est pas indiquée lors de la restauration d'un objet comportant cet attribut, l'objet est scanné au moins une fois après la restauration.

*CHGONLY

Une fois qu'un objet est créé dans le système de fichiers défini par l'utilisateur, cet objet est scanné conformément aux règles décrites dans les programmes d'exit liés au scannage, s'il a été modifié depuis la dernière fois qu'il a été scanné. Il n'est pas scanné si le logiciel de scannage a été mis à jour. Cet attribut ne prend effet que si la valeur système *USEOCOATR a été indiquée pour QSCANFSCTL. Dans le cas contraire, on considère que l'attribut a pour valeur *YES.

Remarque :Si la valeur *NOPOSTRST du paramètre QSCANFSCTL n'est pas indiquée lors de la restauration d'un objet comportant cet attribut, l'objet est scanné au moins une fois après la restauration.

Renommer et délier restreints (RSTDRNMUNL)

Indique si des restrictions spéciales s'appliquent ou non pour les opérations de changement de nom ou de suppression de lien effectuées sur les objets du répertoire racine du système de fichiers défini par l'utilisateur. Cet attribut est identique au bit mode S_ISVTX de ce répertoire.

*NO

Aucune autre restriction ne s'applique au changement de nom ou à la suppression de lien des objets du répertoire racine du système de fichiers défini par l'utilisateur.

*YES

Les objets du répertoire racine du système de fichiers défini par l'utilisateur ne peuvent faire l'objet d'un changement de nom ou d'une suppression de lien que si l'utilisateur qui effectue l'opération remplit une ou plusieurs des conditions suivantes :

1. L'utilisateur est le propriétaire de l'objet.
2. L'utilisateur est le propriétaire du répertoire.
3. L'utilisateur dispose des droits spéciaux sur tous les objets (*ALLOBJ).

Opt mémoire disque par défaut (DFTDISKSTG)

Permet d'indiquer la façon dont la mémoire secondaire doit être allouée par le système pour les fichiers STREAM (*STMF) créés dans ce système de fichiers défini par l'utilisateur. Cette option n'est pas prise en compte pour les fichiers STREAM *TYPE1.

*NORMAL

La mémoire secondaire est allouée normalement : au fur et à mesure des besoins en mémoire secondaire supplémentaire, celle-ci sera allouée à des domaines dimensionnés logiquement afin de répondre aux besoins en espace en cours ainsi qu'aux futurs besoins prévisibles tout en minimisant le nombre d'opérations d'E-S sur le disque.

*MINIMIZE

La mémoire secondaire est allouée afin de minimiser l'espace utilisé par l'objet : au fur et à mesure des besoins en mémoire secondaire supplémentaire, celle-ci sera allouée à des domaines de petite taille afin de répondre aux besoins en espace en cours. L'accès à un objet composé de plusieurs petits domaines augmente le nombre d'opérations d'E-S sur le disque pour cet objet.

*DYNAMIC

Le système fixe automatiquement la mémoire secondaire optimale allouée à l'objet, en équilibrant l'espace utilisé et les opérations d'E-S sur le disque. Par exemple, lorsqu'un fichier possède beaucoup de domaines de petite taille, il est fréquemment lu et modifié en écriture. Par conséquent, les allocations de mémoire secondaire futures nécessiteront des domaines plus grands afin de réduire le nombre d'opérations d'E-S sur le disque. Sinon, lorsqu'un fichier est fréquemment tronqué, les allocations futures de mémoire secondaire nécessiteront des domaines plus petits pour réduire l'espace utilisé. De plus, les informations sont gérées par les tailles de fichier STREAM pour le système et son activité. Ces informations sur la taille des fichiers vous aident également à déterminer la mémoire secondaire optimale allouée à l'objet par rapport à la taille des autres objets.

Opt mémoire princ par défaut (DFTMAINSTG)

Permet d'indiquer la façon dont la mémoire principale doit être allouée et utilisée par le système pour les fichiers STREAM (*STMF) créés dans ce système de fichiers défini par l'utilisateur.

*NORMAL

La mémoire principale est allouée normalement. Le maximum de mémoire possible est alloué et utilisé. Le nombre d'opérations d'E-S sur le disque est réduit car les informations sont placées dans la mémoire cache de la mémoire principale.

*MINIMIZE

La mémoire principale est allouée afin de réduire l'espace utilisé par l'objet. Le minimum de mémoire principale possible est alloué et utilisé. L'utilisation de la mémoire principale est ainsi réduite alors que le nombre des opérations d'E-S sur le disque augmente car moins d'informations sont placées en mémoire cache dans la mémoire principale.

*DYNAMIC

Le système fixe automatiquement la mémoire principale optimale allouée à l'objet, selon l'activité des autres systèmes et le degré d'occupation de la mémoire principale. Si la mémoire principale est peu occupée, un maximum de mémoire principale est alloué et utilisé afin de réduire le nombre d'opérations d'E-S sur le disque. Dans le cas contraire, un volume de mémoire principale moindre est alloué afin de limiter les conflits. Cette option agit uniquement lorsque l'option de pagination du pool de mémoire a la valeur *CALC. Lorsque l'option de pagination du pool de mémoire a la valeur *FIXED, le résultat est le même qu'avec *NORMAL. Lorsque l'accès à l'objet s'effectue via un serveur de fichiers, l'option est sans effet. Elle se comporte de la même façon qu'avec la valeur *NORMAL.

Distinction majusc/minusc (CASE)

Indique si la distinction majuscules/minuscules s'applique ou non pour ce système de fichiers.

*MONO

Le système de fichiers ne tient pas compte de la distinction majuscules/minuscules. Par exemple, les noms FichierA et fichiera font référence au même objet.

*MIXED

Le système de fichiers tient compte de la distinction majuscules/minuscules. Par exemple, les noms FichierA et fichiera NE FONT PAS référence au même objet.

Format de fichier par défaut (DFTFILEFMT)

Indique le format des fichiers STREAM (*STMF) créés dans ce système de fichiers défini par l'utilisateur.

*TYPE2

Un objet *STMF *TYPE2 est doté d'un accès aux fichiers très performant et était nouveau en version 4 édition 4 de l'IBM i. La taille minimale d'objet est de 4096 octets et la taille maximale d'objet est d'environ 1 téraoctet. Un fichier STREAM *TYPE2 peut réaliser un mappage de mémoire et indiquer un attribut permettant d'optimiser l'affectation de mémoire disque.

*TYPE1

Un objet *STMF *TYPE1 dispose du même format que les objets *STMF créés lors d'éditions antérieures à la version 4 édition 4 de l'IBM i. La taille minimale pour cet objet est de 4096 octets et sa taille maximale est d'environ 128 gigaoctets.

Choix unité stockage second (UNIT)

Indique le support de stockage préférentiel pour les objets créés dans le fichier défini par l'utilisateur.

*ANY

Pas de support de stockage préférentiel. La mémoire est allouée à partir de n'importe quel support de stockage disponible.

*SSD

L'unité SSD est le support de stockage préférentiel. La mémoire doit être allouée à partir d'un support de ce type, si disponible.

Texte 'descriptif' (TEXT)

Description du système de fichiers défini par l'utilisateur.

*BLANK

Aucun texte n'est indiqué.

alphanumérique

Indiquez, entre apostrophes, un texte de 50 caractères au maximum.

Exemples

Exemple 1 : Création d'un système UDFS permanent dans un ASP système

CRTUDFS   UDFS('/dev/QASP01/alain.udfs)  TEXT('Alain Besson')

Cette commande crée un système de fichiers défini par l'utilisateur (UDFS) appelé alain.udfs dans le pool de mémoire secondaire système (ASP 1).

Exemple 2 : Création d'un système UDFS permanent dans l'ASP 3

CRTUDFS   UDFS('/dev/QASP03/pascal.udfs')  CASE(*MIXED)

Cette commande crée un système de fichiers défini par l'utilisateur (UDFS) appelé pascal.udfs avec distinction majuscules/minuscules dans le pool de mémoire secondaire utilisateur (ASP) 3.

Exemple 3 : Création d'un système UDFS permanent avec sélection des options de mémoire

CRTUDFS   UDFS('/dev/NOMASPI/marie.udfs')
          DFTDISKSTG(*DYNAMIC) DFTMAINSTG(*DYNAMIC)

Cette commande crée un système UDFS nommé marie.udfs dans le pool de mémoire secondaire (ASP) indépendant nommé NOMASPI. Par ailleurs, pour tout fichier STREAM créé dans cet UDFS, les options de mémoire disque et de mémoire principale prennent la valeur *DYNAMIC afin d'optimiser l'allocation de ces mémoires.

Exemple 4 : Création d'un système UDFS temporaire dans un ASP système

CRTUDFS   UDFS('/dev/QASP01/rené.tmpudfs')
          CASE(*MIXED) TEXT('René Besson')
          DFTDISKSTG(*DYNAMIC) DFTMAINSTG(*DYNAMIC)

Cette commande crée un système de fichiers défini par l'utilisateur (UDFS) nommé rené.tmpudfs et avec distinction majuscules/minuscules dans le pool de mémoire secondaire système (ASP 1). Par ailleurs, pour tout fichier STREAM créé dans cet UDFS, les options de mémoire disque et de mémoire principale prennent la valeur *DYNAMIC afin d'optimiser l'allocation de ces mémoires. Du fait que le nom se termine par '.tmpudfs', tous les objets du système de fichiers seront des objets temporaires qui seront supprimés lors du démontage du système de fichiers, lors du redémarrage du système ou lors de l'exécution de la commande RCLSTG (Récupérer mémoire secondaire).

Messages d'erreur

Messages *ESCAPE

CPFA0A2

Données incorrectes transmises à l'opération.

CPFA09C

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

CPFA0A9

Objet introuvable. L'objet est &1.

CPFA0B1

Opération demandée non admise. Incident d'accès.

CPFA1B8

Droit *IOSYSCFG obligatoire pour utiliser &1.