ENDPJ

La commande ENDPJ (Arrêter travaux anticipés) permet d'arrêter tous les travaux associés à un poste travaux à démarrage anticipé dans un sous-système actif.

Ces travaux peuvent être en attente de demande, ou être déjà associés à une demande. Tous les fichiers spoule en sortie associés aux travaux à arrêter peuvent soit être arrêtés, soit rester dans la file d'attente en sortie. Le nombre maximal de messages à consigner dans chacun des historiques de travail peut également être modifié.

Restrictions :

1. Pour utiliser cette commande, vous devez disposer des droits suivants :
   • Droit spécial de contrôle de travaux (*JOBCTL)
   • Droit d'exécution (*EXECUTE) sur la bibliothèque contenant le programme
   • Droit d'utilisation (*USE) sur toutes les descriptions d'unité ASP dans le groupe d'ASP si la description du sous-système fait mention d'un groupe d'ASP.
2. Les fichiers spoule en sortie placés dans des files d'attente de sortie dans des ASP indépendants (ASP 33-255) ne sont pas supprimés, excepté si la description du sous-système fait mention d'un groupe d'ASP et si les fichiers se trouvent dans des files d'attente de sortie dans ce groupe d'ASP.

Paramètres

Sous-système (SBS)

Indique le nom du sous-système actif qui contient le poste travaux à démarrage anticipé.

Ce paramètre est obligatoire.

nom

Indiquez le nom du sous-système actif qui contient le poste travaux à démarrage anticipé.

Programme (PGM)

Indique le nom qualifié du programme associé au poste travaux à démarrage anticipé.

Ce paramètre est obligatoire.

Qualificatif 1 : Programme

nom

Indiquez le nom du programme associé au poste travail à démarrage anticipé.

Qualificatif 2 : Biblio

*LIBL

La recherche est effectuée dans toutes les bibliothèques de la liste des bibliothèques jusqu'à ce qu'une occurrence soit trouvée.

*CURLIB

Le programme est recherché dans la bibliothèque en cours de l'unité d'exécution. Si la bibliothèque n'est pas indiquée, QGPL est utilisée par défaut.

nom

Indiquez la bibliothèque contenant le programme.

Type d'arrêt (OPTION)

Indique si les travaux sont arrêtés de façon contrôlée, ce qui permet à l'application d'exécuter un traitement de fin de travail.

*CNTRLD

Les travaux sont arrêtés de façon contrôlée. Cela permet au programme qui s'exécute d'effectuer un traitement de fin de travail. Lorsqu'un travail arrêté comporte une procédure de traitement de signaux pour le signal asynchrone SIGTERM, ce dernier est généré pour ce travail. L'application dispose du temps indiqué au paramètre DELAY pour effectuer le ménage avant la fin du travail.

*IMMED

Les travaux sont arrêtés immédiatement. Lorsqu'un travail arrêté comporte une procédure de traitement de signaux pour le signal asynchrone SIGTERM, ce dernier est généré pour ce travail et la valeur système QENDJOBLMT définit le temps maximal. Le programme en cours doit traiter le signal SIGTERM pour pouvoir effectuer les opérations de fin de traitement.

Remarque :La valeur *IMMED peut générer des résultats inattendus si les données ont été partiellement mises à jour. Cette valeur doit être utilisée uniquement en cas d'échec de l'arrêt contrôlé.

Délai d'arrêt contrôlé (DELAY)

Indique le délai (en secondes) accordé au programme pour exécuter un traitement de fin de travail, en cas d'arrêt contrôlé. Si le traitement n'est pas terminé une fois ce délai écoulé, l'arrêt du travail est immédiat. Seul un traitement d'apurement par le système sera exécuté. Ce paramètre n'est pas valide si *IMMED est indiqué pour le paramètre OPTION (Type d'arrêt).

30

Un délai maximal de 30 secondes est accordé pour procéder au traitement de fin de travail avant l'arrêt de chaque travail à démarrage anticipé.

1-999999

Indiquez le temps d'attente maximal (en secondes) avant l'arrêt de chaque travail à démarrage anticipé.

Suppression fichiers spoule (SPLFILE)

Indique si les fichiers spoule en sortie, générés par le travail, seront conservés pour édition, ou s'ils seront supprimés.

*NO

Les fichiers spoule en sortie, générés par les travaux à arrêter, seront conservés pour édition. Lorsque le travail est arrêté, l'attribut de travail SPLFACN détermine si les fichiers spoule sont détachés du travail ou conservés avec celui-ci.

*YES

Les fichiers spoule en sortie créés par les travaux en cours d'arrêt et placés dans les files d'attente en sortie du pool ASP système (ASP 1) ou du pool ASP utilisateur de base (ASP 2-32) sont supprimés. Les fichiers spoule en sortie placés dans les files d'attente en sortie de pools ASP indépendants (ASP 33-255) ne sont pas supprimés. L'historique est conservé.

Maximum postes dans historique (LOGLMT)

Indique le nombre maximal de postes de la file d'attente de messages du travail qui peuvent être consignés dans l'historique, pour le travail qui s'arrête. Ce paramètre permet de limiter le nombre de messages du fichier imprimante de l'historique (QPJOBLOG).

*SAME

La valeur définie précédemment reste inchangée. Le système utilise la valeur *NOMAX, si aucune limite de consignation des messages n'a été définie pour ces travaux à démarrage anticipé dans une précédente commande.

*NOMAX

Il n'y a pas de limite pour le nombre de messages à consigner. Tous les messages de chaque file d'attente de messages de travail doivent être consignés dans l'historique du travail, pour chaque travail.

nombre-entier

Indiquez le nombre maximal de messages à consigner dans l'historique du travail, pour chaque travail. Cette valeur ne sera prise en compte que si elle est définie avant que le nombre de messages n'ait atteint cette limite. Sinon, une fois la limite atteinte, la consignation des messages dans l'historique s'arrête. Si vous entrez 0, et qu'aucun message n'a été consigné, aucun historique n'est généré.

Exemples

Exemple 1 : Arrêt immédiat d'un travail

ENDPJ   SBS(SBS1)  PGM(PJLIB/PJPGM)  OPTION(*IMMED)
        SPLFILE(*YES)

Cette commande permet d'arrêter immédiatement tous les travaux associés au poste travaux à démarrage anticipé PJPGM du sous-système SBS1. La sortie spoule générée par ces travaux à démarrage anticipé est supprimée et l'historique du travail est sauvegardé.

Exemple 2 : Report de l'arrêt d'un travail

ENDPJ   SBS(SBS2)  PGM(PJPGM2)  OPTION(*CNTRLD)
        DELAY(50)  SPLFILE(*NO)

Cette commande permet d'arrêter tous les travaux associés au poste travaux à démarrage anticipé PJPGM2 du sous-système SBS2. La sortie spoule de ces travaux est sauvegardée pour édition. Les travaux disposent de 50 secondes pour effectuer toutes les procédure de ménage. Ils s'arrêtent immédiatement à l'issue de ce délai.

Messages d'erreur

Messages *ESCAPE

CPF0922

Commande ENDRPJ non admise actuellement.

CPF101C

Non autorisé sur l'unité &1.

CPF1083

Les travaux anticipés sont déjà en cours d'arrêt contrôlé.

CPF1084

Les travaux anticipés sont déjà en cours d'arrêt immédiat.

CPF1227

Pas de droits d'usage sur la commande.

CPF1317

Aucune réponse du sous-système pour le travail &3/&2/&1.

CPF1351

Erreur dans le sous-système pour le travail &3/&2/&1.

CPF1834

Poste travaux anticipés inexistant pour programme &1 de &2.

CPF9820

Non autorisé à utiliser la bibliothèque &1.