CRTFORMDF

Créer une définition d'imprimé

En bref

La commande CRTFORMDF permet de créer une définition d'imprimé à partir d'un fichier physique.

CRTFORMDF se lit CRT (Créer) + FORMDF. Sur IBM i, le nom d'une commande associe presque toujours un verbe et un objet.

Syntaxe minimale

CRTFORMDF FORMDF(…) FILE(…)

Paramètres

FORMDF Définition d'imprimé obligatoire
FILE Fichier obligatoire
MBR Membre
TEXT Texte 'descriptif'
REPLACE Remplacer définition d'imprimé
AUT Droits

Astuce : dans une session 5250, tapez CRTFORMDF 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 CRTFORMDF permet de créer une définition d'imprimé à partir d'un fichier physique. Celui-ci contient les informations relatives à la définition d'imprimé. Ces informations peuvent, par exemple, provenir d'un système hôte IBM 370* et être au format SAA.

Restriction : En cas d'utilisation en réseau de fichiers spoule sur un IBM 370*, les deux premiers caractères du nom de la définition d'imprimé doivent être 'F1'.

Paramètres

Mot-clé	Description	Valeurs possibles	Remarques
FORMDF	Définition d'imprimé	Nom d'objet qualifié	Obligatoire, positionnel 1
	Qualificatif 1: Définition d'imprimé	Nom
	Qualificatif 2: Biblio	Nom, *CURLIB
FILE	Fichier	Nom d'objet qualifié	Obligatoire, positionnel 2
	Qualificatif 1: Fichier	Nom
	Qualificatif 2: Biblio	Nom, LIBL, CURLIB
MBR	Membre	Nom, *FORMDF	Facultatif, positionnel 3
TEXT	Texte 'descriptif'	Valeur caractère, MBRTXT, BLANK	Facultatif
REPLACE	Remplacer définition d'imprimé	YES, NO	Facultatif
AUT	Droits	Nom, LIBCRTAUT, CHANGE, ALL, USE, *EXCLUDE	Facultatif

Définition d'imprimé (FORMDF)

Indique la définition d'imprimé en cours de création.

Ce paramètre est obligatoire.

Qualificatif 1 : Définition d'imprimé

nom: Indiquez le nom de la définition d'imprimé.

Qualificatif 2 : Biblio

*CURLIB: La définition d'imprimé est placée dans la bibliothèque en cours du travail. Si cette dernière n'est pas précisée, QGPL est prise par défaut.
nom: Indiquez le nom de la bibliothèque dans laquelle vous désirez placer la définition d'imprimé.

Fichier source (FILE)

Fichier contenant les enregistrements de la définition d'imprimé envoyée au système.

Ce paramètre est obligatoire.

Qualificatif 1 : Fichier

nom: Indiquez le nom du fichier contenant les enregistrements de la définition d'imprimé.

Qualificatif 2 : Biblio

*LIBL: La recherche porte sur toutes les bibliothèques de la liste des bibliothèques de l'unité d'exécution en cours jusqu'à ce que la première occurrence soit trouvée.

*CURLIB: Le fichier est recherché dans la bibliothèque en cours du travail. Si cette dernière n'est pas précisée, QGPL est prise par défaut.
nom: Indiquez le nom de la bibliothèque contenant le fichier.

Membre de fichier source (MBR)

Membre de fichier contenant les enregistrements de la définition d'imprimé.

*FORMDF: Le nom du membre de fichier est indiqué au paramètre FORMDF (Définition d'imprimé) de cette commande.
nom: Indiquez le nom du membre du fichier spécifié au paramètre FILE (Fichier source).

Texte 'descriptif' (TEXT)

Texte décrivant brièvement l'objet.

*MBRTXT: Le texte provient du membre de fichier utilisé pour créer la définition d'imprimé. Vous pouvez ajouter ou modifier le texte d'un membre source base de données à l'aide de la commande STRSEU (Démarrer SEU), ADDPFM (Ajouter un membre à un fichier physique) ou CHGPFM (Modifier un membre de fichier physique). Si le fichier est un fichier en entrée ou un fichier unité, le texte est à blanc.
*BLANK: Aucun texte n'est précisé.
valeur-alphanumérique: Indiquez, entre apostrophes, un texte de 50 caractères au maximum.

Remplacer définition d'imprimé (REPLACE)

Indique, dans le cas où une définition d'imprimé de même nom que celle en cours de création existe déjà, si elle doit être remplacée.

*YES: La définition d'imprimé est remplacée.
*NO: Si une définition d'imprimé de même nom existe déjà sur le système, l'opération de création échoue. La définition d'imprimé n'est pas remplacée.

Droits (AUT)

Indique les droits que vous accordez aux utilisateurs qui n'ont pas de droits spécifiques sur l'objet, qui ne figurent pas sur une liste d'autorisation ou dont le profil de groupe ou les profils du groupe supplémentaire ne disposent pas de droits spécifiques sur l'objet.

*LIBCRTAUT: Le système détermine les droits sur l'objet en utilisant la valeur indiquée au paramètre CRTAUT (Droits pour objets créés) de la commande CRTLIB, pour la bibliothèque qui contiendra l'objet à créer. Si la valeur spécifiée au paramètre CRTAUT (Droits pour objets créés) est modifiée, la nouvelle valeur n'affectera pas les objets existants.

*CHANGE: L'utilisateur peut effectuer toutes les opérations sur l'objet, à l'exception de celles réservées au propriétaire ou contrôlées par les droits d'existence de l'objet (*OBJEXIST) et de gestion de l'objet (*OBJMGT). L'utilisateur peut réaliser des fonctions de base sur l'objet et le modifier. Le droit *CHANGE fournit le droit d'opération sur l'objet (*OBJOPR) ainsi que les droits sur toutes les données. Si l'objet est une liste d'autorisation, vous pouvez ajouter, modifier ou supprimer des utilisateurs dans cette liste.

*ALL: L'utilisateur peut effectuer toutes les opérations, à l'exception de celles réservées au propriétaire ou soumises au droit de gestion de la liste d'autorisation (*AUTLMGT). L'utilisateur a un droit d'existence sur l'objet Il peut également effectuer des fonctions de base sur ce dernier, le modifier, définir son niveau de protection et en transférer la propriété.

*USE: L'utilisateur peut effectuer des opérations de base sur l'objet, telles que l'exécution d'un programme ou la lecture d'un fichier. Il ne peut pas le modifier. Le droit d'utilisation (*USE) fournit le droit d'opération sur l'objet (*OBJOPR) ainsi que le droit d'exécution (*EXECUTE).

*EXCLUDE: L'utilisateur n'a pas accès à l'objet.

nom: Indiquez le nom d'une liste d'autorisation. Les droits sur l'objet définis dans la liste sont accordés aux utilisateurs figurant sur celle-ci. La liste d'autorisation doit exister à la création de l'objet.

Exemples

CRTFORMDF   FORMDF(*CURLIB/FORMDF1)
            FILE(*CURLIB/FORMDF)  MBR(F1A01238)
            AUT(*EXCLUDE)
            TEXT('Déf. de format par défaut pour imprimantes AFP')

Cette commande permet de créer la définition de format FORMDF1 dans la bibliothèque en cours ou dans QGPL si aucune bibliothèque en cours n'est définie. L'entrée provient du fichier source FORMDF qui comporte le membre F1A01238, dans la bibliothèque en cours. Si vous indiquez *EXCLUDE au paramètre AUT, l'utilisation de l'objet est limitée à son propriétaire. Le texte permet d'indiquer ce que représente la définition de format.

Messages d'erreur

Messages *ESCAPE

CPF2283: La liste d'autorisation &1 n'existe pas.
CPF8056: &1 de &2 n'est pas un fichier physique.
CPF88C1: Ressource imprimante &2 de type &1 non créée dans &3.
CPF9809: Accès à la bibliothèque &1 impossible.
CPF9810: Bibliothèque &1 non trouvée.
CPF9812: Fichier &1 non trouvé dans la bibliothèque &2.
CPF9822: Non autorisé au fichier &1 de &2.
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.
CPF9870: L'objet &2 de type *&5 existe déjà dans la bibliothèque &3.