Service SQL IBM i (AS/400) · Fonction scalaire
SYSTOOLS.GENERATE_PDF
Convertir un fichier spoule en PDF
Convertit un fichier spoule en document PDF enregistré dans l'IFS, à partir du travail, du nom et du numéro du fichier spoule.
À quoi ça sert
Cette fonction scalaire prend un fichier spoule, repéré par JOB_NAME (nom qualifié numéro/utilisateur/travail), SPOOLED_FILE_NAME et SPOOLED_FILE_NUMBER, le convertit en PDF et l'écrit à l'emplacement PATH_NAME de l'IFS.
On s'en sert pour archiver des états ou les envoyer par courriel sans outil externe : on la combine avec une requête sur QSYS2.SPOOLED_FILE_INFO pour trouver les fichiers, puis avec SYSTOOLS.SEND_EMAIL pour les expédier. Elle s'exécute avec VALUES.
Résultat réel sur un IBM i 7.5
Pas de démonstration : la fonction écrit un fichier PDF dans l'IFS.
L'exemple d'IBM
Convertir un fichier spoule en PDF et l'enregistrer sous /usr/listing1.
-- Description: Convert a spooled file to PDF format and save it as /usr/listing1.
VALUES SYSTOOLS.GENERATE_PDF(
JOB_NAME => '908049/QUSER/QZDASOINIT',
SPOOLED_FILE_NAME => 'PGMA',
SPOOLED_FILE_NUMBER => 2,
PATH_NAME => '/usr/listing1');Bon à savoir
Le profil qui exécute la fonction doit pouvoir lire le fichier spoule et écrire dans le répertoire de l'IFS visé.
Paramètres
| Paramètre | Type | Par défaut | Signification |
|---|---|---|---|
JOB_NAME |
VARCHAR(28) | obligatoire | Nom du travail |
SPOOLED_FILE_NAME |
VARCHAR(10) | obligatoire | Nom du fichier spoule |
SPOOLED_FILE_NUMBER |
VARCHAR(6) | obligatoire | Numéro du fichier spoule |
PATH_NAME |
DOUBLE-BYTE CHAR LARGE OBJECT | obligatoire | Chemin |