Commande SHELL

Permet d’exécuter des commandes DOS, d’ouvrir des documents, ou de lancer l’exécution de programmes.

Syntaxe

CHGVAR	VAR(&CMD) VALUE('SHELL')
CHGVAR	VAR(&PARM1) VALUE('commande dos \| nom du document')
CHGVAR	VAR(&PARM2) VALUE(' [ ; Wait=True / False / Nombre ] [ ; Errorlevel=True / False ] [ ; Visible=True / False ] [ ; Focus=True / False ] [ ; Minimize=True / False ] [ ; OpenDocument=True / False ] [ ; Directory="Répertoire par défaut" ] [ ; Action="open" \| "explore" \| "print" ] ')
CALL	PGM(LNCCMD) PARM(&HANDLE &CMD &OPT &PARM1 + &PARM2 &RESULT)

Paramètres

Parm1

Commande DOS à exécuter sur la station Windows,
(ex: COPY F:\Docs\Template.doc C:\Temp).
Ou, chemin vers un document à ouvrir, ou URL Internet à laquelle se connecter.

Parm2

Wait = True/False/Nombre.
Défaut = True.
L’application attendra que la commande soit exécutée, sans délai si Wait a la valeur vrai. Si un nombre est exprimé, il indique un délai maximum d’attente en milli secondes.

Errorlevel = True / False.
Le programme AS/400 recevra le niveau d’erreur en retour de l’appel de la commande.
Le niveau d’erreur est retourné dans le paramètre &RESULT, codé sur 5 chiffres.

Visible = True / False. Défaut = False.
L’exécution de la commande peut se faire en non visible.

Focus = True / False. Défaut = True.
Si Focus a le valeur faux, la nouvelle application lancée ne prend pas le focus Windows.
Dans une application interactive, cela permet d’afficher des données ou images avec une application, et de garder le terminal 5250 toujours actif.

Minimize = True / False. Défaut = False.
Si Minimize est vrai, la fenêtre active au moment de l'exécution de cette commande, sera minimisée.
Si Wait n'a pas la valeur 'Faux', cette fenêtre sera restaurée à la fin de l'exécution de la commande.

OpenDocument = True / False. Défaut = False.
Quand cette option est vraie, &PARM1 contient le chemin vers un nom de fichier à ouvrir, ou une URL Internet.
Windows utilisera l’application approprié pour le type du fichier désigné.

Directory permet de fixer le répertoire par défaut pour la commande à exécuter, ou le document à ouvrir.

Action indique une action particulière à faire pour un document.
L’option "OpenDocument=" est équivalente à Action="open".
Action peut prendre les valeurs : "open", "print", "explore".

Remarque

Pour certaines applications, tel que Internet Explorer, il n’est pas possible d’attendre la fin de leur exécution.
Quelle que soit la valeur donnée à l’option Wait, la commande est lancée, et votre processus reprend la main immédiatement.

Exemples

Cet exemple copie un fichier d’un répertoire vers un autre.

CHGVAR	VAR(&CMD) VALUE('SHELL')
CHGVAR	VAR(&PARM1) VALUE('COPY \Templates\Invoice.doc C:\Temp\Invoice.doc')
CHGVAR	VAR(&PARM2) VALUE('ErrorLevel')
CALL	PGM(LNCCMD) PARM(&HANDLE &CMD &OPT &PARM1 + &PARM2 &RESULT)

Cet exemple connecte la station Windows à un site Web.

CHGVAR	VAR(&CMD) VALUE('SHELL')
CHGVAR	VAR(&PARM1) VALUE('http://www.easycom-aura.com’)
CHGVAR	VAR(&PARM2) VALUE('OpenDocument')
CALL	PGM(LNCCMD) PARM(&HANDLE &CMD &OPT &PARM1 + &PARM2 &RESULT)

Cet exemple ouvre une page HTML avec le navigateur par défaut.

CHGVAR	VAR(&CMD) VALUE('SHELL')
CHGVAR	VAR(&PARM1) VALUE('\Pages\Document.htm')
CHGVAR	VAR(&PARM2) VALUE('OpenDocument')
CALL	PGM(LNCCMD) PARM(&HANDLE &CMD &OPT &PARM1 + &PARM2 &RESULT)