Objet :
HSPO (HH&S Spool Offload) est un utilitaire UNIX/Windows permettant de traiter les fichiers de spool offload en provenance de MVS/JES2, et de les décomposer en flots logiques homogènes (lignes de texte ou flot AFP pur) en vue de leur traitement par un sous-système d'impression ACIF.
Le programme HSPO est appelé dans un batch de traitement, ou via un system call à partir d'une application, avec comme paramètre le nom du fichier contenant le spool offload transmis.
HSPO extrait les SYSOUT du spool offload sous forme de fichiers.
Plateformes disponibles :
Systèmes Linux, Windows, AIX
Linux
Windows
AIX
Nota : nous portons sur tout système ayant un compilateur C : Solaris, HP-UX…
Usage :
hspo [-h] [-v] [-vv] [-tdir] [-p] [-n] [-a [-k]] [-s] [-Rsep [-A]] [-V] input_offload_file_name
Options :
-h, --help | affiche la liste des options |
-v, --verbose | indique les résultats de la décomposition, au fur et à mesure |
-vv, --very-verbose | plus de détails |
-tdir, --target-directory=dir | écrit dans le répertoire cible dir |
-p, --print-names | affichage sur standard output de la liste des fichiers créés |
-n, --no-blank-page | suppression des pages vides |
-a, --asa | transforme les codes machine CCW (Channel Command Word) en codes ASA dans les enregistrements texte |
-k, --keep-temp | conserve les fichiers temporaires avec codes CCW quand l'option --asa est utilisée (par défaut : supprime les fichiers temporaires) |
-s, --split | découpage de chaque SYSOUT en fichiers distincts texte et AFP |
-Rsep, --Record-separator=sep | remplace le séparateur d'enregistrement de chaque enregistrement texte par <sep>, avec sep = CRLF (défaut pour Windows), LF (défaut pour UNIX), ou valeur choisie par l'utilisateur Xhh (hh : valeur hexa) |
-A, --AFP-separator | ajoute un séparateur d'enregistrement après chaque enregistrement AFP par défaut : pas d'ajout de séparateur |
-V, --variable-length | format "IBM variable" : préfixe chaque enregistrement avec la longueur d'enregistrement (2 bytes, big endian) et supprime tout CR/LF. |
XXXXXXXXX-p-c-FFFF-JJJJJJJJ-iiii-ssss.YYYYYYYY (mixed mode)XXXXXXXXX-p-c-FFFF-JJJJJJJJ-iiii-ssss_nnnn.YYYYYYYY (split mode)avec :
XXXXXXXX | nom du fichier en entrée |
p | priorité en entrée |
c | nombre de copies (1, 2, ...) |
FFFF | nom de la forme (form name) |
JJJJJJJJ | Jobname MVS |
iiii | Jobid MVS |
ssss | rang de la SYSOUT dans le spool offload (0001, 0002 ...) |
nnnn | en mode split, rang du flot homogène dans cette SYSOUT (001, 002, ...) |
YYYYYYYY | nom du PAGEDEF, extrait de la carte '//... OUTPUT ...' |
Exemple 1 :
Soit à traiter un spool offload de nom 'OFFLOAD7', avec un total de 7 SYSOUT.
Chaque SYSOUT est de type 'AFP mixed mode' (bannière début + flot AFP + bannière fin).
La commande :
… etc.
Chaque fichier contient un flot mixte AFP/texte, avec les lignes de texte terminées par un CRLF (x'0D0A') pour Windows ou un LF (x'0A') pour UNIX.
Chaque SYSOUT est de type 'AFP mixed mode' (bannière début + flot AFP + bannière fin).
La commande :
hspo OFFLOAD7donnera les fichiers suivants :
OFFLOAD7-ERDPRTT-4090-0001.GDCRD (1re SYSOUT)
OFFLOAD7-ERDPRTT-4092-0002.GDCRD (2e SYSOUT)
OFFLOAD7-ERDPRTT-4092-0003.GDCRD (3e SYSOUT)
… etc.
OFFLOAD7-ERDPRTT-4099-0007.GDCRD (7e SYSOUT)
Chaque fichier contient un flot mixte AFP/texte, avec les lignes de texte terminées par un CRLF (x'0D0A') pour Windows ou un LF (x'0A') pour UNIX.
Exemple 2 :
Le même fichier en entrée, mais on désire terminer chaque record, texte ou AFP, par un caractère '25'hexa, et on veut obtenir la liste des fichiers créés :
hspo --print-names --Record-separator=X25 --AFP-separator OFFLOAD7ou
hspo -p -RX25 -A OFFLOAD7 > OFFLOAD7_names.txt
Pour télécharger et évaluer librement HSPO sur vos propres plateformes, n'hésitez pas à nous contacter.