COPYBOOK Preprocessor for AS400 /ISERIES

Début de FR_README v1.0

Ceci décrit l'objet et de composantes de /COPYBOOK et comment télécharger, installer, utiliser et exécuter le /COPYBOOK préprocesseur.

BUT
/COPYBOOK permet aux développeurs sur AS400 pour travailler sur les sources avec une plus grande flexibilité et permet une utilisation plus efficace des membres source existants.
Il le fait en facilitant un cahier à fusionner dans l'utilisation de numéros de ligne. En d'autres termes, c'est possible maintenant à copier des portions d'un membre source dans un autre lors de la compilation, plutôt que d'un membre complet.
Une gamme de lignes d'un membre source peut être copié. Il n'est plus nécessaire d'isoler la source de la copie dans une pièce séparée.
En outre, les sources DDS peut maintenant être copié. Par exemple, les déclarations de contrôle sous-fichier à partir du fichier d'un écran peuvent être copiées dans un autre Fichier écran au moment de la compilation. De même, les bannières écran ne doit être défini dans le fichier d'un écran et copiée comme requis dans d'autres écrans.

RSTLIB
Pour restaurer la bibliothèque sauvé, tout d'abord créer un fichier de sauvegarde sur l'AS400. Utiliser FTP avec des binaires pour télécharger le fichier pour le fichier de sauvegarde vous avez créé.
Vous pouvez puis déplacer le contenu dans une bibliothèque ou les bibliothèques de votre choix.

Méthode
Il ya deux étapes. Étape 1 est l'inclusion du préprocesseur /Copybook dans le membre source cible. Étape 2 est d'exécuter la commande d'ADP, qui traite l'/Copybook commande pour développer la source et ensuite (éventuellement) compiler les sources étendues.

/COPYBOOK dans la source membre

Lorsqu'on utilise /COPYBOOK fixe dans un RPG-ligne de source en format-fixe ou une ligne de DDS, un * est attendue en position 7. Cela force SEU à considérer la ligne comme un commentaire. /COPYBOOK doit être écrit dans les positions 8 - 16. Alternativement, lorsqu'on utilise /COPYBOOK en ligne free-Fromat RPG, des // sont attendus en positions 8 - 9. /COPYBOOK est ensuite attendue dans les positions 10 - 18.

Le format de la déclaration /COPYBOOK	est	/COPYBOOK	LIBRARY/FILE,MEMBER:dddd-àààà
	ou	/COPYBOOK	FILE,MEMBER:dddd-àààà
	ou	/COPYBOOK	MEMBER:dddd-àààà
	ou	/COPYBOOK	MEMBER

Un espace est requis entre /COPYBOOK et le caractère suivant.

LIBRARY et FILE sont optionnels.
Si LIBRARY est omis, le nom de la bibliothèque dans laquelle le fichier source contenant des membres à la déclaration /COPYBOOK est inséré.
Si FILE est omis, le nom du fichier source contenant des membres à la déclaration /COPYBOOK est inséré.

Si aucune plage de numéro de ligne est donné, le membre complet est copié.

On peut entrer des inscriptions alphabétiques en majuscules ou en minuscules ou une combinaison.
Toutes les inscriptions alphabétiques sont converties en majuscules.

Si un numéro existe tout seule, le membre est copié à partir de cette ligne jusqu'à la fin.

Jusqu'à 99 //Copybook déclarations peuvent être imbriqués.

Un membre ne peuvent pas appeler lui-même ou d'un supérieur dans la hiérarchie imbriquée.

ADP Preprocessor Command

Ceci décrit la commande ADP comme il est fourni. Vous pouvez changer la commande, et le CL ADP6 pour répondre aux besoins de votre environnement - masi c'est necessaire a conserver les paramètres d'ADP5 dans le même ordre et avec les mêmes longueurs et types.
ADP est la commande préprocesseur. Il lit les lignes dans le membre source d'entrée, élargit le répertoire /COPYBOOK des déclarations, et, par défaut, écrit la source agrandi à partir de déposer ADOUTPUT dans QTEMP bibliothèque.
Le nom du membre et le nom du fichier d'entrée sont exigés.
Si vous souhaitez compiler le code source immédiatement après l'expansion, vous pouvez entrer la commande du compilateur pertinents.
De même, si vous souhaitez garder la sortie expaned, ou écrire à un autre emplacement, vous pouvez changer les paramètres de sortie selon les besoins.
NOTE ... il est nécessaire de recompiler la commande ADP avant la première utilisation.

COMPOSANTES
Le fichier téléchargé est appelé MCKABTSAVF. Cette ia une AS400 enregistrer le fichier, la sortie d'un SAVLIB
. La bibliothèque qui a été enregistré est appelé MCKABT. Il ya quatre objets dans cette bibliothèque - ADP5, ADP6, ADP et ADPSOURCE. NOTE .. . il est nécessaire de recompiler la commande ADP avant la première utilisation.
ADP5 est l'exécutable qui se lit dans le membre source contenant le dossier /COPYBOOK cahier(s) et écrit la source agrandi à partir de déposer ADPOUTPUT. ADP6 est un programme CL qui appelle ADP5. ADP est la commande qui ADP6 en appelle à son tour. ADPSOURCE fichier contient les membres source pour ADP6 et de l'ADP.