CVTRPCSRC

Convertir source RPC

En bref

La commande Convertir source RPC (CVTRPCSRC) génère du code C à partir d'un fichier en entrée écrit en langage RPC.

CVTRPCSRC se lit CVT (Convertir) + RPCSRC. Sur IBM i, le nom d'une commande associe presque toujours un verbe et un objet.

Syntaxe minimale

CVTRPCSRC FROMFILE(…)

Paramètres

FROMFILE Fichier d'origine obligatoire
OPTION Option
PROTOCOL Protocole
TOFILE Fichier de destination

Astuce : dans une session 5250, tapez CVTRPCSRC 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 Convertir source RPC (CVTRPCSRC) génère du code C à partir d'un fichier en entrée écrit en langage RPC. Le code C créé peut être utilisé pour mettre en oeuvre un protocole RPC.

Cette commande équivaut à exécuter l'utilitaire rpcgen sur un système UNIX.

Cette commande est équivalente à la commande suivante :

RPCGEN

Restrictions :

L'utilisateur doit disposer du droit d'exécution (*X) sur chacun des répertoires du chemin pour les fichiers en entrée et en sortie.
L'utilisateur doit disposer du droit de lecture (*R) sur le fichier en entrée.
L'utilisateur doit disposer du droit d'écriture et d'exécution (*WX) sur le répertoire de fichiers en sortie.

Paramètres

Mot-clé	Description	Valeurs possibles	Remarques
FROMFILE	Fichier d'origine	Chemin d'accès	Obligatoire, positionnel 1
OPTION	Option	ALL, XDR, HDR, CLTSTUB, SVRSTUB, CLTSAMP, SVRSAMP, NOSAMP	Facultatif
PROTOCOL	Protocole	Values (jusqu'à 2 répétitions): NONE, TCP, *UDP	Facultatif
TOFILE	Fichier de destination	Chemin d'accès	Facultatif

Fichier d'origine (FROMFILE)

Indique le nom de chemin du fichier source en entrée écrit en langage RPC. Ce fichier doit appartenir au système de fichiers "racine" (/) ou QOpenSys.

Pour obtenir de plus amples informations relatives à la spécification des noms de chemin, reportez-vous à "Object naming rules" dans la rubrique Rubriques CL de la catégorie Programmation de l'IBM i Information Center, à l'adresse http://www.ibm.com/systems/i/infocenter/.

Option (OPTION)

Indique les options de compilation.

*NOSAMP: Tous les types de fichiers sont créés, à l'exception des fichiers exemples (*CLTSAMP et *SVRSAMP).
*ALL: Tous les types de fichiers sont créés.
*XDR: Le fichier en entrée est compilé dans les routines XDR (eXternal Data Representation).
*HDR: Le fichier en entrée est compilé dans les définitions de données C (fichier en-tête).
*CLTSTUB: Le fichier en entrée est compilé dans les procédures de raccord du client.
*SVRSTUB: Le fichier en entrée est compilé dans les procédures de raccord du serveur. Toutefois, aucune routine "principale" n'est créée.
*CLTSAMP: Un code client exemple utilisant les appels de procédure éloignés est créé. Le fichier peut être personnalisé pour l'application.
*SVRSAMP: Un code serveur exemple utilisant les appels de procédure éloignés est créé. Le fichier peut être personnalisé pour l'application.

Protocole (PROTOCOL)

Compilation dans les procédures de raccord du serveur pour le transport spécifié. La valeur indiquée doit être présente dans le fichier /etc/netconfig au moment de l'exécution de l'application serveur. Ce paramètre n'est admis que lorsque OPTION(*SVRSTUB) est spécifié. Une ou plusieurs des options suivantes peut être spécifiée :

*NONE: Les procédures de raccord du serveur pour tous les transports se trouvant dans le fichier /etc/netconfig sont compilées.
*TCP: Les procédures de raccord du serveur pour le transport TCP sont compilées.
*UDP: Les procédures de raccord du serveur pour le transport UDP sont compilées.

Fichier de destination (TOFILE)

Indique le chemin du fichier en sortie. Cette option n'est admise que si l'option OPTION(*ALL) ou OPTION(*NOSAMP) n'est pas spécifiée. Lorsque ces dernières sont spécifiées ou si le paramètre TOFILE n'est pas indiqué lors de l'utilisation d'une autre option, le paramètre Fichier d'origine (FROMFILE) sert à générer le nom TOFILE comme indiqué ci-après, où nomfichier désigne le nom du fichier en entrée extrait du paramètre FROMFILE.

nomfichier.h pour un fichier en-tête
nomfichier_xdr.c pour un fichier XDR
nomfichier_clnt.c pour les fichiers raccords client
nomfichier_svc.c pour les fichiers raccords serveur
nomfichier_client.c pour les fichiers exemples client
nomfichier_server.c pour les fichiers exemples serveur

Le ou les fichiers en sortie du code exemple ne doivent pas exister ; s'ils existent, la commande échoue et d'autres fichiers en sortie sont supprimés.

'nom-chemin-fichier-destination': Indiquez un nom de chemin à utiliser pour créer le ou les noms du fichier de destination.
Pour obtenir de plus amples informations relatives à la spécification des noms de chemin, reportez-vous à "Object naming rules" dans la rubrique Rubriques CL de la catégorie Programmation de l'IBM i Information Center, à l'adresse http://www.ibm.com/systems/i/infocenter/.

Exemples

Exemple 1 : Conversion d'un source RPC en fichiers par défaut

CVTRPCSRC   FROMFILE('/myrpc')  OPTION(*ALL)

Cette commande convertit le fichier en langage RPC /myrpc dans tous les quatre types de fichier, *XDR, *HDR, *CLTSTUB et *SVRSTUB. Le paramètre par défaut PROTOCOL(*TCP) est utilisé pour générer les programmes de raccord côté serveur. Les noms suivants sont affectés aux fichiers :

monrpc.h pour un fichier en-tête
monrpc_xdr.c pour un fichier XDR
monrpc_clnt.c pour les fichiers raccords client
monrpc_svc.c pour les fichiers raccords serveur

Exemple 2 : Conversion d'un source RPC en raccords client uniquement

CVTRPCSRC   FROMFILE('/monrpc2')  OPTION(*CLTSTUB)
            TOFILE('/monclnt.c')

Cette commande convertit le fichier en langage RPC /monrpc2 en procédures de raccord client. Les résultats sont placés dans le fichier /monclnt.c comme indiqué.

Messages d'erreur

Messages *ESCAPE

CPFB416: Echec de la commande CVTRPCSRC ou RPCGEN.