Comment : |
La fonction JOBNAME récupère la chaîne d'identification brute du processus en cours depuis le système d'exploitation. Ceci est généralement connu en tant que processus PID au niveau du système d'exploitation. La fonction est valide dans tous les environnements, mais elle est typiquement utilisée dans le gestionnaire de dialogue et retourne la valeur en tant que chaîne alphanumérique (même dans le cas où un PID est purement numérique pour certains systèmes d'exploitation).
Remarque : les chaînes JOBNAME diffèrent en fonction du système d'exploitation en termes d'apparence de longueur. Par exemple, les noms de travaux Windows, UNIX, et z/OS job sont purement numériques (typiquement, d'une longueur maximale de 8 caractères), tandis que le nom d'un travail OpenVMS est hexadécimal (toujours d'une longueur de 8 caractères), et un travail IBM i est une chaîne à trois parties d'une longueur maximale de 26 caractères. Bien qu'il soit possible qu'une application soit exécutée plus tard au sein d'un autre environnement (non prévisible), il est recommandé d'utiliser la longueur maximale 26 pour éviter une troncature accidentelle. Les applications qui utilisent cette fonction dans tout autre but qu'une simple identification doivent aussi être prises en compte pour la différence dans le code d'application.
JOBNAME(length, output)
où :
Entier
est le nombre maximal de caractères à renvoyer depuis l'appel système PID.
Alphanumérique
est la chaîne d'identification du processus renvoyé, dont la longueur dépend de la plate-forme sur laquelle la fonction est exécutée. Fournit un longueur aussi longtemps que nécessaire pour votre plate-forme; sans quoi, la sortie sera tronquée.
L'exemple suivant utilise la fonction JOBNAME pour récupérer la chaîne d'identification du processus en cours sous la forme d'une chaîne A26 puis pour effectuer une troncature afin de l'utiliser dans une instruction -TYPE :
-SET &JOBNAME = JOBNAME(26, 'A26'); -SET &JOBNAME = TRUNCATE(&JOBNAME); -TYPE The Current system PID &JOBNAME is processing.
Par exemple, sous Windows, la sortie est similaire à la suivante :
The Current system PID 2536 is processing.
| WebFOCUS |