Exécuter commande SHELL (LNCSHELL)

Parameters

Keyword	Description	Choices	Notes
CMD	Commande, Document ou Exe.	Character value	Optional, Positional 1
FLR	Répertoire du Doc. ou Exe.	Character value, DFT, NONE	Optional, Positional 2
PARMEXE	Paramètres du prog. Exécutable	Character value, *NONE	Optional, Positional 3
WAITCMD	Attendre fin exéc. (millisec)	1-99999999, NO, YES	Optional, Positional 4
ERRORLVL	Retourner niveau d'erreur	1-99999, YES, NO	Optional, Positional 5
VISIBLE	Exécution visible	YES, NO	Optional, Positional 6
FOCUS	Placer la fenêtre en 1er plan	YES, NO	Optional, Positional 7
MINCURWIN	Minimiser la fenêtre active	YES, NO	Optional, Positional 8
ACTION	Action sur le document ou Exe.	NONE, OPEN, PRINT, EXPLORE, OPEN, PRINT, EXPLORE	Optional, Positional 9
WRKFLR	Répertoire par défaut	Character value, DFT, NONE	Optional, Positional 10
EXESRV	Nom du PC serveur LAUNCHER	Character value, DFT, DEV, *CURRENT	Optional, Positional 11
ENDOPT	Option de fermeture de comm.	ALL, CON, *NONE	Optional, Positional 12

Top

Commande, Document ou Exe (CMD)

Indique un nom de document à ouvrir, une commande DOS à exécuter, ou un nom de programme exécutable.

Exemples:

COPY F:\Docs\Template C:\Temp

http://www.easycom-aura.com

F:\DocDB\Doc001.pdf

WordPad

Répertoire du Doc. ou Exe (FLR)

Si le paramètre CMD désigne un document ou un programme exécutable, FLR peut alors désigner un chemin de répertoire ou se trouve le fichier.

Remarque :Ce paramètre est facultatif dans le cas ou le paramètre CMD est renseigné avec le chemin complet (D:\Racine\Répertoire\Document)

Le caractère '\' ne doit pas figurer à la fin du chemin saisi.

Un chemin réseau sous la forme \\Serveur\Partage\répertoire peut être spécifié pour le paramètre FLR.

Paramètres du prog. Exécutable (PARMEXE)

Si le paramètre CMD désigne un programme exécutable, des paramètres à passer peuvent être indiqués ici.

Les caractères guillemets (") doivent être doublés ("").

Attendre fin exécution (WAITCMD)

Le travail peut attendre la fin d'exécution de la commande, ou la fermeture de l'application sur le PC. Cette attente peut être infinie, ou limitée à un délai exprimé en milli-secondes.

Les valeurs possibles sont :

*NO: Le travail n'attend pas la fin d'exécution du programme sur le PC.
*YES: Le travail attend indéfiniment que la commande soit exécutée. La main sera rendue au programme AS/400 quand l'exécution de la commande sera terminée.
Valeur: Le travail attend la fermeture du programme appelé sur le PC, jusqu'à un délai maximum exprimé en milli-secondes. Si le délai est expiré, le message LNC0701 est envoyé au travail, avec la valeur 99999 dans les 5 premiers caractères.

Attention, certaines applications, tel que Internet Explorer, ne permettent pas d'attendre la fin d'exécution.

Retour niveau d'erreur (ERRORLVL)

Indique si le retour de l'appel de commande doit être testé.

Cette option n'est valide que si WAITCMD est différent de *NO.

Les valeurs possibles sont :

*YES: Si un code différent de 0 est retourné, le message LNC0701 est envoyé au travail. Les 5 premiers caractères du message représentent le numéro d'erreur. La valeur 99999 est retournée quand le délai exprimé par WAITCMD a été dépassé.
*NO: Le retour de l'appel de commande n'est pas testé.
Valeur: Le message LNC0701 n'est envoyé au travail que si le code de retour du programme appelé sur le PC est supérieur ou égal à la valeur exprimée.

Placer la fenêtre en 1er plan (FOCUS)

Les valeurs possibles sont :

*YES: La fenêtre de 'application lancée sur le PC sera placée au 1er plan des fenêtres actives sur Windows.
*NO: La fenêtre active restera inchangée.
Ceci permet de garder la fenêtre de l'émulation de terminal toujours active.

Minimiser la fenêtre active courante (MINCURWIN)

Les valeurs possibles sont :

*YES: La fenêtre active est minimisée. Si WAITCMD n'a pas la valeur '*NO', la fenêtre sera restaurée à la fin de l'exécution du programme appelé.
*NO: La fenêtre active reste affichée dans sa taille normale.

Action sur le document ou Exe (ACTION)

Indique l'action qui doit être réalisée avec la commande, ou le fichier passé au paramètre CMD

Les valeurs possibles sont :

*NONE

La commande donnée au paramètre CMD sera confiée à l'interpréteur de commandes de Windows.

La valeur *NONE est obligatoire pour l'exécution de commandes DOS tel que COPY, DEL, MKDIR, ...

Si l'exécution visible est demandée avec l'option VISIBLE(*YES) une fenêtre "Invite de commande" de Windows s'ouvrira.

OPEN ou *OPEN

Cette valeur doit être indiquée si le paramètre CMD désigne un programme exécutable, ou un document ou fichier associée à une application par défaut.

Lorsque le paramètre CMD désigne un document ou un fichier, l'application associée est automatiquement ouverte par Windows.

PRINT ou *PRINT

Lorsque le paramètre CMD désigne un document, la valeur PRINT permet d'imprimer le document sous Windows, en utilisant l'application par défaut associée.

Nom du serveur LAUNCHER (EXESRV)

Spécifie le nom du serveur sur lequel la commande doit être exécutée. Ce nom peut correspondre à un autre poste de travail. Le nom du Host ou l'adresse IP sont des choix valides.

Les valeurs possibles sont :

*DFT: Le traitement est exécuté sur le serveur référencé dans le fichier LNCDFTP réservé à la définition des options Launcher/400 (mot clé LNCSRV).
*DEV: Le traitement est exécuté sur le poste de l'utilisateur interactif courant.
Cette valeur ne pas être utilisée dans un travail soumis.
*CURRENT: Dans le cas ou la dernière connexion n'a pas été fermée (paramètre ENDOPT=*NO) lors de la dernière commande LNCSHELL, la connexion précédente est de nouveau utilisée.
adresse IP ou nom de l'hôte: La traitement est exécuté sur un PC du réseau, désigné ici par son nom d'hôte, ou son adresse TCP/IP.

Remarque :Il est impératif que le programme LAUNCHER/400 soit démarré sur le poste sur lequel les demandes sont exécutées.

Option de fermeture de comm (ENDOPT)

Indique si la communication est fermée après le traitement de la commande.

Les valeurs possibles sont :

*ALL: La communication LAUNCHER entre le job et le serveur PC sera fermée. L'application ne pourra pas envoyer une autre commande en spécifiant valeur *CURRENT au paramètre EXESRV
*NONE: La communication LAUNCHER entre le job et le serveur PC ne sera pas fermée. L'application pourra envoyer une autre commande en spécifiant la valeur *CURRENT au paramètre EXESRV