PreviousNext
Help > Programmation avec LAUNCHER Office > Les commandes CL > LNCSHELL - Commande CL
LNCSHELL - Commande CL

La commande LNCSHELL exécute une commande DOS, ouvre un document ou exécute un programme sur une station Windows. 

 

Paramètres

 

Commande, Document ou Exe

CDM

 

Répertoire du Doc ou Exe

FLR

*NONE

Paramètres du prog. Exécutable

PARMEXE

*NONE

Attendre fin exécution

WAITCMD

*NO

Retourner niveau d'erreur

ERRORLVL

*YES

Exécution visible

VISIBLE

*NO

Placer la fenêtre en 1er plan

FOCUS

*YES

Minimiser la fenêtre active

MINCURWIN

*NO

Action sur le document ou Exe

ACTION

*NONE

Répertoire par défaut

WRKFLR

*NONE

Nom du PC serveur LAUNCHER

EXESRV

*DFT

Option de fermeture de communication

ENDOPT

*ALL

 

Détails

 

Commande, Document ou Exe (CMD)

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

 

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 où se trouve le fichier.

Remarque : Ce paramètre est facultatif dans le cas où 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.

 

Attendre fin exécution (WAITCMD)

Les valeurs possibles sont :

*NO

L'application n'attend pas que la commande soit exécutée.

*YES

L'application attend indéfiniment que la commande soit exécutée.

La main sera rendu 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 millisecondes. 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 a la valeur *YES.

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é.

 

Exécution visible (VISIBLE)

Les valeurs possibles sont :

*NO

L'exécution de la commande n'est pas visible.

*YES

L'exécution de la commande est visible.

 

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

Les valeurs possibles sont :

*YES

La fenêtre de l'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 (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)

Ce paramètre ne s'applique pas à l'exécution de commandes DOS (paramètre CMD).

Les valeurs possibles sont :

OPEN

Cette valeur doit être indiquée si le paramètre CMD désigne un

programme exécutable lorsque le paramètre CMD désigne un document, la

valeur OPEN permet d'ouvrir le document sous Windows, avec son

application par défaut.

PRINT

Lorsque le paramètre CMD désigne un document, la valeur PRINT permet d'imprimer le document sous Windows.

 

Répertoire par défaut (WRKFLR)

Désigne le répertoire par défaut pendant l'exécution de la commande

ou du programme.

 

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 Office (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 Office 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.

 

Exemple

 

Création et ouverture d’un fichier PDF :

 

PGM

 

LNCOPEN

 

LNCCMD CMD(WORDOPEN) PARM1(NEW)

 

LNCCMD CMD(WTYPETEXT) PARM1('CECI EST UN FICHIER QUI A ETE +

CONVERTI EN FICHIER PDF')

 

LNCCMD CMD(PDFPRINTER) +

PARM1('FILE="C:\TEMP\TEMP.PDF"')

 

LNCCMD CMD(WPRINT) PARM1('PRINTER="LAUNCHER_PDF"')

 

LNCCMD CMD(WORDCLOSE)

 

LNCSHELL CMD('C:\TEMP\TEMP.PDF') WAITCMD(*NO) VISIBLE(*YES) +

ACTION(OPEN) EXESRV(*DEV)

 

LNCCLOSE

 

ENDPGM