La
commande CPYTOMDB permet de transférer
des données d’un fichier ou d’une requête de l’AS/400
vers une table dans une base
de données ACCESS.
Paramètres
|
Sélection auto base ACCESS |
SELMDB |
F |
|
Base ACCES de destination |
TOMDB |
|
|
Chemin d'accès à la base |
MDBPTH |
*DFT |
|
Source de la copie |
CPYSRC |
*FILE *SQL |
|
Fichier d'origine |
FROMFILE |
|
|
Bibliothèque |
|
*LIBL |
|
Membre d'origine |
FROMMBR |
*FIRST |
|
Requête SQL |
FROMSQL |
'SELECT * FROM' |
|
Analyse |
FROMQRY |
|
|
Bibliothèque |
|
*LIBL |
|
Table ACCESS de destination |
TOTBL |
|
|
Remplacement oun ajout enreg. |
TBLOPT |
*ADD |
|
Afficher le document |
SHOWDOC |
*YES |
|
Transfert unicode |
|
*YES |
|
Nom du serveur LAUNCHER |
EXESRV |
*DFT |
|
Option de fin |
ENDOPT |
*NONE |
Détails
La commande CPYTOMDB permet de lancer l'application ACCESS sur un
P.C. pour effectuer différentes copies dans les tables de la base
de données active.
Les données peuvent être ajoutées aux enregistrements déjà contenus
dans une table ou remplacer le contenu de la table.
La technique de la copie *MAP *DROP de CPYF est utilisée à chaque fois.
Sélection auto base ACCESS (SELMDB)
Ce paramètre permet de sélectionner le document manuellement
(saisie obligatoire) ou automatiquement (sélection du document à
partir d'une boîte de dialogue Windows).
Ce paramètre est obligatoire.
Les valeurs possibles sont :
F
La valeur F (comme FREE) permet à l'utilisateur d'obtenir
l'invite pour saisir le nom du document, son dossier ainsi que
son chemin d'accès.
S
La valeur S (comme SELECT) permet à l'utilisateur de
sélectionner automatiquement le nom du document par
l'intermédiaire d'une boîte de dialogue Windows renvoyée à
l'écran.
Il est donc possible dans ce cas de parcourir les différents
dossiers de son disque local (ou disques réseaux) pour y
retrouver la base de données ACCESS.
Remarque : L'utilisation du choix S n'est valable qu'à partir
de la ligne de commandes AS/400. Lors de la création d'un
programme CL, ce choix ne fonctionne pas et F est obligatoire.
Base ACCESS de destination (TOMDB)
Indique le nom de la base ACCESS à utiliser ou à créer.
La création de la base de données ACCESS est toujours effectuée
si la base de données saisie au paramètre TOMDB n'existe pas.
Remarque : L'extension .mdb ne doit pas être spécifiée
Les valeurs possibles sont :
nom-base-de-données
Indiquez le nom de la base de données à utiliser ou à créer.
*CURRENT
La base de donnée ouverte lors de la dernière session
LAUNCHER
Office est de nouveau utilisée. Cette option est valable
lorsque l'utilisateur a besoin d'effectuer plusieurs copies de
données dans différentes tables d'une même base. La valeur
*CURRENT n'est valable que si la dernière connexion
LAUNCHER Office n'a pas été fermée lors de la dernière commande
CPYTOMDB.
Chemin d'accès à la base (MDBPTH)
Indique le nom du chemin d'accès à utiliser pour la base de
données.
Les valeurs possibles sont les suivantes :
*DFT
La valeur spéciale *DFT indique que le chemin d'accès utilisé
pour l'accès à la base ACCESS est le chemin d'accès référencé
dans le fichier des options par défaut LAUNCHER400. Pour
visualiser ou modifier la valeur du chemin d'accès utilisé par
défaut par la commande CPYTOMDB, sélectionnez dans la liste le
mot clé MDBPTH après appel du programme WRKLNCDFT.
*NONE
Indique que le chemin d'accès (root et dossier) est déjà
indiqué au paramètre TOMDB.
nom-chemin-d'accès
Indiquez le nom complet du chemin d'accès utilisé pour accéder
à la base ACCESS en respectant la syntaxe suivante : C:\Program
Files\LAUNCHER400\Mes Bases
Remarque : La syntaxe C:\Mes Documents\LAUNCHER400 est
correcte alors que la syntaxe C:\Mes Documents\LAUNCHER400\
est incorrecte.
Source de la copie (CPYSRC)
Indique l'origine de la source à copier.
Les valeurs possibles sont les suivantes :
*FILE
L'origine de la copie est un fichier base de données.
*QRY
L'origine de la copie est une analyse query (objet de type
*QRYDFN).
*SQL
L'origine de la copie est une instruction SQL SELECT
Fichier d'origine (FROMFILE)
Indique le nom et la bibliothèque du fichier base de données à
copier. Ce
paramètre est utilisé lorsque le paramètre CPYSRC est défini sur
*FILE.
Le fichier base de données peut
être physique ou logique.
Pour la bibliothèque, les valeurs possibles sont les suivantes :
*LIBL
La recherche est effectuée dans toutes les bibliothèques
utilisateur et système de la liste des bibliothèques du travail
jusqu'à ce que la première occurrence soit trouvée.
*CURLIB
Le fichier base de données est recherché dans la bibliothèque
en cours du travail, si celle-ci n'est pas précisée.
Membre d'origine (FROMMBR)
Indique le nom du membre fichier base de données, à utiliser pour
la copie.
Ce paramètre est utilisé lorsque le paramètre CPYSRC est
défini sur *FILE.
Les valeurs possibles sont les suivantes :
*FIRST
Le premier membre du fichier base de données est copié.
nom-membre
Indique le nom du membre du fichier base de données d'origine.
Requête SQL (FROMSQL)
Saisir la requête SQL pour extraire les données à copier.
This
parameter is used when parameter CPYSRC is set to *SQL.
Analyse (FROMQRY)
Spécifie le nom de la
requête à utiliser pour obtenir les données.
Ce paramètre est utilisé lorsque le paramètre CPYSRC est défini sur *QRY.
Nom de la requête
Entrez le nom de la requête.
Les valeurs de bibliothèque possible sont:
* LIBL
La liste de
bibliothèques est explorée pour trouver la bibliothèque
où se trouve le fichier de requête.
Nom de la bibliothèque
Entrez le nom de la bibliothèque contenant le fichier de requête.
Table ACCESS de destination (TOTBL)
Indique le nom de la table ACCESS utilisée.
Si la table n'existe pas, cette dernière est automatiquement créée.
Remplacement ou ajout enregistrements. (TBLOPT)
Indique comment les enregistrements sont introduits dans la table
ACCESS.
Les valeurs possibles sont :
*ADD
L'ajout des données est effectué sur la table ACCESS.
*REPLACE
Le remplacement des données de la table ACCESS est effectué.
Afficher le document (SHOWDOC)
Indique si le document est affiché ou non à l'écran.
Les valeurs possibles sont :
*NO
Le document résolu n'est pas montré à l'écran.
*YES
Le document résolu sera rendu visible à l'écran.
*YES (par défaut) ou *NO.
Nom du serveur LAUNCHER (EXESRV)
Spécifie le nom du serveur sur lequel ACCESS doit être exécuté. Ce
nom peut correspondre à un autre poste de travail. Le nom du Host
ou l'adresse IP sont des choix valides.
Les valeurs possibles sont :
*DFT
Le traitement est exécuté sur le serveur référencé dans le
fichier LNCDFTP réservé à la définition des options
LAUNCHER Office (mot clé MDBSRV).
*DEV
Le traitement est exécuté sur le poste du demandeur.
*CURRENT
Dans le cas où la dernière connexion n'a pas été fermée
(paramètre ENDOPT =*NONE ou *APP ou
*DOC dans la
dernière commande CPYTOMDB), la
connexion précédente est de nouveau utilisée.
adresse IP ou nom de l'hôte
Le traitement est exécuté sur un autre poste que celui du
demandeur. Dans ce cas, la saisie du nom du poste en question
est demandé.
Remarque : Il est impératif que le programme LAUNCHER
soit
démarré sur le poste sur lequel les demandes sont exécutées.
Option de fin (ENDOPT)
Indique si la communication LAUNCHER Office sera fermée après
traitement.
Les valeurs possibles sont :
*ALL
La communication LAUNCHER entre le job et le serveur PC sera
fermée.
*APP
L'application
Access sera fermée mais la communication
LAUNCHER entre le job et le serveur PC restera ouverte.
L'application pourra envoyer une autre commande
CPYTOMDB en spécifiant valeur *CURRENT au paramètre EXESRV.
*DOC
Le fichier Access
sera fermé mais l'application et la communication
LAUNCHER entre le job et le serveur PC resteront actives.
*CON
Seule la connexion LAUNCHER est fermée.
*NONE
La communication LAUNCHER entre le job et le serveur PC
ne sera pas
fermée ainsi que l'application, ACCESS et le fichier ACCESS.
Description : COPIE D'UN FICHIER PF AS/400 VERS UNE BASE MS ACCESS
La table nommée "TABLE1" est utilisé pour la copie.
A noter que le chemin d'accès à la base de données est indiqué au
paramètre TOMDB et qu'il ne doit pas être spécifié au paramètre MDBPATH
Si la base de données existe déjà, les données de la table sont remplacées.
Si la base de données n'existe pas, elle est automatiquement créée et la
table TABLE1 est ajoutée.
PGM
CPYTOMDB SELMDB(F) TOMDB('%LNCDIR%\SAMPLES\R_MDB') +
MDBPTH(*NONE) FROMFILE(SP_CUST) +
TOTBL('TABLE1') TBLOPT(*ADD) UNICOD(*YES) +
EXESRV(*DEV) ENDOPT(*APP)
LNCSHELL CMD('%LNCDIR%\Samples\S_LNCSQL.MDB') +
VISIBLE(*YES) ACTION(OPEN) EXESRV(*CURRENT)
ENDPGM