POSDBF

Positionner un fichier BD

En bref

La commande POSDBF (Positionner un fichier base de données) permet de positionner un fichier base de données soit au début soit à la fin d'un fichier ouvert.

POSDBF se lit POS (Positionner) + DBF. Sur IBM i, le nom d'une commande associe presque toujours un verbe et un objet.

Syntaxe minimale

POSDBF OPNID(…) POSITION(…)

Paramètres

OPNID ID ouverture fichier obligatoire
POSITION Position fichier obligatoire

Astuce : dans une session 5250, tapez POSDBF 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 : Oui

La commande POSDBF (Positionner un fichier base de données) permet de positionner un fichier base de données soit au début soit à la fin d'un fichier ouvert.

Paramètres

Mot-clé	Description	Valeurs possibles	Remarques
OPNID	ID ouverture fichier	Nom	Obligatoire, positionnel 1
POSITION	Position fichier	START, END	Obligatoire, positionnel 2

ID ouverture fichier (OPNID)

Identifie le fichier ouvert à repositionner. Ce fichier doit être ouvert soit à l'aide de la commande OPNDBF (Ouvrir un fichier base de données), soit à l'aide de la commande OPNQRYF (Ouvrir un fichier de requête).

Ce paramètre est obligatoire.

nom: Indiquez l'identificateur d'ouverture de fichier.

Position fichier (POSITION)

Indique la position de début ou de fin du fichier base de données.

Ce paramètre est obligatoire.

*START: Le fichier base de données est positionné au début du membre ouvert en cours. Une fois le fichier positionné, une opération de lecture pour l'enregistrement suivant vous permet d'obtenir le premier enregistrement du membre. Une opération de lecture pour l'enregistrement précédent vous permet d'obtenir le dernier enregistrement du membre précédent, si *ALL est indiqué pour le paramètre Membre de substitution (MBR) de la commande OVRDBF (Substituer un fichier base de données). Dans le cas contraire, une condition d'exception correspondant à un dépassement de début du fichier se produit.
*END: Le fichier base de données est positionné à la fin du membre ouvert en cours. Une fois la position de fin définie, une opération de lecture pour l'enregistrement suivant vous permet d'obtenir le premier enregistrement du membre suivant, si *ALL est indiqué pour le paramètre MBR de la commande OVRDBF (Substituer un fichier base de données). Dans le cas contraire, une condition d'exception correspondant à un dépassement de fin de fichier se produit. Une opération de lecture pour l'enregistrement précédent vous permet d'obtenir le dernier enregistrement du membre.

Exemples

POSDBF   OPNID(XXX)  POSITION(*START)

Cette commande définit la position d'enregistrement du fichier base de données qui est ouvert lorsque OPNID(XXX) a pour valeur la position de début du membre de fichier base de données qui est actuellement ouvert.

Messages d'erreur

Messages *ESCAPE

CPF5213: Le positionnement du membre &3 a échoué.
CPF5230: Aucun fichier ouvert avec OPNID(&4).