PreviousNext
Help > Programmation avec LAUNCHER Office > Les commandes LNCCMD > Liste des commandes > Commande DBFXFER
Commande DBFXFER

Transfère un fichier de base de données AS/400, ou le résultat d’une requête SQL, ou un document de l’IFS, vers un PC.

 

Le résultat du transfert d’un fichier base de données, ou d’une requête SQL sera en format texte sur le PC.

 

Syntaxe

 

CHGVAR

VAR(&CMD) VALUE('DBFXFER')

CHGVAR

VAR(&PARM1) VALUE('
File="Fichier PC cible"
[;UNICODE=True/False]
[;Fixed=True/False]
[;FixedNL=True/False]
[;ColHdg=True/False]
[;Delimiter="délimiteur"]
[;DecimalPt="point décimal"]
[;QuoteText=True/False]
[;DescFile=True/False]
')

CHGVAR

VAR(&PARM2) VALUE('
MAXREC=Nombre maximum d’enregistrements ;
COLHDG=LNAME / COLHDG / SNAME ;
<Fichier Base de données / Document IFS / Requête SQL>
')

CALL

PGM(LNCCMD) PARM(&HANDLE &CMD &OPT &PARM1 &PARM2+ &RESULT)

 

 

 

 

 

Paramètres

 

 

Paramètres

 

Parm1

Parm1 contient des options qui seront interprétées par LAUNCHER Office sur le PC.

File=Chemin complet vers le fichier cible à créer sur le PC.
Si le mot "FILE=" est omis, alors tout le paramètre Parm1 représente le chemin vers le fichier cible.

UNICODE=True / False (Défaut=False).
Par défaut, les données sont stockées en format 8 bits par caractères.
Au format UNICODE les caractères sont codés sur 16 Bits.

Fixed=True / False (Défaut=False).
Par défaut, le fichier sera au format CSV. Les colonnes sont séparées par un point virgule.

Si Fixed est vrai, les colonnes seront de taille fixe, sans séparateur de colonnes ou de lignes.

FixedNL
Comme pour Fixed, les colonnes seront de taille fixe, mais les lignes seront séparées par un "retour ligne".

ColHdg=True / False (Défaut=True). Par défaut, la première ligne du fichier résultat contient les noms des colonnes . Si ColHdg est faux, les données commenceront dès la première ligne.

Delimiter : Le séparateur de colonnes est le point virgule (;) par défaut. Ce séparateur peut être changé ici.
Exemple : Delimiter=","
Le délimiteur peut être totalement supprimé par :
Delimiter=""
Si le fichier ne comporte qu’un seul champ, pour des raisons de compatibilité avec MS Office, un délimiteur est ajouté à la fin de chaque ligne.

DecimalPt : Le point décimal par défaut sera celui défini dans l’environnement Windows du PC. Il peut être changé ici.
Exemple: DecimalPt=","

QuoteText=True / False (Défaut=True). Les valeurs des colonnes sont encadrées par des guillemets, sauf si QuoteText est faux.

DescFile=True / False (Défaut=True). Un fichier de description (*.LFD) est généré par LAUNCHER Office dans le même répertoire que le fichier de destination. Ce fichier de description est utilisé par LAUNCHER Office lors d’une exportation vers Excel. Pour économiser des ressources, la génération de ce fichier de description peut être évitée en donnant la valeur faux à DescFile.



Parm2

Parm2 contient des options qui seront interprétées par LAUNCHER sur l ‘AS/400.

Les options doivent figurer en début, séparées par point virgule ( ;). La valeur de Parm2 se termine par le nom de la source de données AS/400 à transférer.

MAXREC=Nombre; Cette option permet de plafonner le transfert à un nombre maximum d’enregistrement. Par défaut, il n’y a aucun plafond.

COLHDG= LNAME / COLHDG / SNAME 
Les entêtes des colonnes sur le fichier PC seront constituées :
Si COLHDG=LNAME : par les nom longs ou Alias.
Si COLHDG=COLHDG : par les entêtes de colonnes.
Si COLHDG=SNAME : par les noms courts (Défaut).

 

Fichier base de données : Donnez le nom du fichier, avec éventuellement la librairie et le membre.
La syntaxe d’un nom qualifié est : LIBRAIRIE/FICHIER(MEMBRE)
La librairie et le membre sont optionnels.

Document de l’IFS : Donnez le chemin complet vers le document dans les dossiers, précédé du mot « DOCUMENT:»
Exemple : ‘DOCUMENT:/qdls/dossierdoc/lettre.pdf’

 

Résultat d’une requête SQL : Le mot « SQL:» doit précéder le texte de la requête SQL.
Exemple : ‘SQL:select * from customer where dept=’’75’’’
Si un fichier doit être qualifié dans le texte de la requête, le nom de librairie et le nom de fichier doivent être séparés par un caractère point, selon la syntaxe SQL.
Exemple : ‘SQL:select * from mylib.myfile’

 

RESULT

En retour &RESULT contient le nombre de records (9 chiffres).


 

Cette fonction de transfert de données ne nécessite aucun autre logiciel que LAUNCHER Office sur le PC.

Pour le transfert d’un document de l’IFS, il n’est pas utile de connecter un disque virtuel du PC à l’IFS.

 

Remarque : Un fichier .lfd est également crée.

 

Exemple

CHGVAR

VAR(&CMD) VALUE('DBFXFER')

CHGVAR

VAR(&PARM1) VALUE('file="%LNCDIR%\fusion.txt ')

CHGVAR

VAR(&PARM2) VALUE('COLHDG=LNAME;LAUNCHER/SP_CUST')

CHGVAR

VAR(&CMD) VALUE('DBFXFER')

CHGVAR

VAR(&PARM1) VALUE('%TEMP%\readme.txt')

CHGVAR

VAR(&PARM2) VALUE('DOCUMENT:/home/qsecofr/vim-6.3/readme.txt')

CHGVAR

VAR(&CMD) VALUE('DBFXFER')

CHGVAR

VAR(&PARM1) VALUE('%TEMP%\trf.txt ')

CHGVAR

VAR(&PARM2) VALUE('MAXREC=100;SQL:select * from customer')