Commande CL IBM i (AS/400)

SBMNWSCMD

Soumettre cde serveur réseau

En bref

La commande SBMNWSCMD permet de soumettre une commande à exécuter sur le serveur désigné.

SBMNWSCMD se lit SBM (Soumettre) + NWSCMD. Sur IBM i, le nom d'une commande associe presque toujours un verbe et un objet.

Syntaxe minimale

SBMNWSCMD CMD(…) SERVER(…)

Paramètres

CMD Commande obligatoire
SERVER Serveur obligatoire
NOLOGCMD Commande (non consignée)
SVRTYPE Type de serveur
CMDTYPE Type de commande
LODUSRPRF Charger profil utilisateur
AUTDMN Domaine d'authentification
CMDSTDOUT Sortie standard de commande
CVTSTDOUT Convertir sortie standard

Astuce : dans une session 5250, tapez SBMNWSCMD puis F4 pour l'invite de saisie, et F1 sur un paramètre pour son aide.

Aide IBM i de la commande

Texte du F1, IBM i 7.5 en français (bibliothèque QSYS)

Où s'exécute : Tous les environnements (*ALL)
Compatible multitâche : Non

La commande SBMNWSCMD permet de soumettre une commande à exécuter sur le serveur désigné. Pour SVRTYPE(*WINDOWS) ou (*WINDOWSNT), le paramètre CMDSTDOUT contrôle la destination de la sortie.

Paramètres

Mot-clé	Description	Valeurs possibles	Remarques
CMD	Commande	Valeur caractère, *NOLOGCMD	Obligatoire, positionnel 1
SERVER	Serveur	Valeur caractère	Obligatoire, positionnel 2
NOLOGCMD	Commande (non consignée)	Valeur caractère	Facultatif
SVRTYPE	Type de serveur	NWSUSRA, NWSA, WINDOWS, WINDOWSNT	Facultatif
CMDTYPE	Type de commande	SVRTYPE, WINDOWS, *WINDOWSNT	Facultatif
LODUSRPRF	Charger profil utilisateur	YES, NO	Facultatif
AUTDMN	Domaine d'authentification	Valeur caractère, PRIMARY, LOCAL	Facultatif
CMDSTDOUT	Sortie standard de commande	Chemin d'accès, JOBLOG, PRINT	Facultatif
CVTSTDOUT	Convertir sortie standard	YES, NO	Facultatif

Commande (CMD)

Indique la commande envoyée au serveur de réseau. La syntaxe de la commande spécifiée à ce paramètre n'est pas vérifiée.

*NOLOGCMD: Indique que l'utilisateur veut soumettre une chaîne de commande qui n'est pas consignée dans l'historique du travail. Ceci est utile lorsque la chaîne de commande contient des données confidentielles telles que des mots de passe. Si vous indiquez *NOLOGCMD, vous devez entrer une chaîne de commande au paramètre NOLOGCMD.
commande: Chaîne de commande à soumettre au serveur de réseau. Elle est consignée dans l'historique du travail.

Ce paramètre est obligatoire.

Serveur (SERVER)

Indique le nom du serveur sur lequel la commande est lancée.

Ce paramètre est obligatoire.

Commande (non consignée) (NOLOGCMD)

Indique la chaîne de commande à soumettre au serveur de réseau. Elle ne sera pas répercutée dans l'historique du travail. Ce paramètre vous permet de soumettre des commandes contenant des données confidentielles telles que des mots de passe. Il ne peut et ne doit être utilisé que si CMD(*NOLOGCMD) est spécifié.

Remarque :La commande étant exécutée sur un serveur, la présence de cette option ne peut pas empêcher le serveur de retourner la chaîne de commande dans les données de sortie. Par conséquent, il se peut que certaines commandes soient retournées et affichées dans l'historique du travail ou le fichier spoule.

Type de serveur (SVRTYPE)

Indique le type de serveur auquel la commande est envoyée.

*NWSUSRA: Le type de serveur indiqué dans les attributs de serveur de réseau (commande CHGNWSUSRA) pour le profil exécutant SBMNWSCMD est utilisé.
*NWSA: Le type de serveur indiqué dans les attributs de serveur de réseau (commande CHGNWSA) est utilisé.
*WINDOWS ou *WINDOWSNT: Le type de serveur est Windows. Seules les commandes Windows peuvent être exécutées sur un serveur local Windows.
Remarque :La valeur *WINDOWS doit être utilisée à partir de la V5R4. La valeur *WINDOWSNT est prise en charge à des fins de compatibilité avec les éditions antérieures à la V5R4.

Type de commande (CMDTYPE)

Indique le type de la commande indiquée au paramètre CMD. Ce paramètre est utilisé par le système pour déterminer le type de traitement nécessaire pour cette commande.

Remarque :Ce paramètre est ignoré.

*SVRTYPE: La commande est traitée en fonction du type de serveur indiqué au paramètre SVRTYPE. S'il s'agit d'un serveur *WINDOWS ou *WINDOWSNT, le système considère que la chaîne envoyée est une commande Windows.
*WINDOWS ou *WINDOWSNT: La chaîne envoyée est une commande Windows.
Remarque :La valeur *WINDOWS doit être utilisée à partir de la V5R4. La valeur *WINDOWSNT est prise en charge à des fins de compatibilité avec les éditions antérieures à la V5R4.

Charger profil utilisateur (LODUSRPRF)

Permet d'indiquer si le profil utilisateur doit être chargé ou non sur le serveur éloigné dans le cadre de l'environnement de connexion.

Remarque :Ce paramètre n'est admis que si SVRTYPE(*WINDOWS) ou (*WINDOWSNT) est spécifié.

*YES: Le profil utilisateur est chargé.
*NO: Le profil utilisateur n'est pas chargé.

Domaine d'authentification (AUTDMN)

Indique le domaine Windows dans lequel l'utilisateur est authentifié.

Remarque :Ce paramètre n'est admis que si SVRTYPE(*WINDOWS) ou (*WINDOWSNT) est spécifié.

*PRIMARY: L'utilisateur est authentifié dans le domaine principal du serveur.
*LOCAL: L'utilisateur est authentifié sur le serveur local.
'nom-domaine': Indiquez le nom du domaine dans lequel l'utilisateur est authentifié.

Sortie standard de commande (CMDSTDOUT)

Indique, s'il y a lieu, l'emplacement de stockage de la sortie standard de la commande. Une sortie standard peut être écrite dans l'historique du travail qui émet cette commande, dans un fichier spoule ou dans un fichier. L'erreur standard retournée par la commande est toujours dirigée vers l'historique du travail qui émet cette commande.

Remarque :Ce paramètre n'est admis que si SVRTYPE(*WINDOWS) ou (*WINDOWSNT) est spécifié.

*JOBLOG: La sortie standard de la commande de serveur de réseau est dirigée vers l'historique du travail qui émet cette commande. Elle partage l'historique du travail avec la sortie d'erreurs standard de la commande de serveur de réseau. Ces deux types de sortie peuvent ne pas être dissociées dans l'historique du travail, en fonction de l'ordre d'écriture de la sortie standard et des informations d'erreurs standard.
*PRINT: La sortie standard de la commande de serveur de réseau est dirigée vers un fichier spoule. Si CVTSTDOUT(*YES) est indiqué, certains caractères de contrôle tels que les avance ligne et les retours chariot sont convertis en nouvelles lignes et en d'autres caractères de contrôle non affichables (par exemple, les caractères de mise en évidence et de soulignement sont convertis en blancs).
'nom-chemin-fichier-STREAM': Indiquez le chemin du fichier STREAM vers lequel la sortie standard de la commande de serveur de réseau est dirigée. Le chemin indiqué doit exister. Si le fichier STREAM n'existe pas, il est créé. S'il existe, toutes les données sont recouvertes. Pour plus de détails sur le nom de chemin, reportez-vous au manuel Rubriques Système de fichiers intégré de l'IBM i Information Center, à l'adresse http://www.ibm.com/systems/i/infocenter/.

Convertir sortie standard (CVTSTDOUT)

Indique si la sortie standard est convertie du jeu de codes du serveur vers le CCSID du profil utilisateur qui a soumis la commande. Dans le cas d'une sortie binaire, CVTSTDOUT(*NO) doit être indiqué.

Remarque :Ce paramètre n'est admis que lorsque CMDSTDOUT(*PRINT) ou CMDSTDOUT(nom-chemin-fichier-STREAM) est indiqué.

*YES: La sortie est convertie du jeu de codes du serveur au CCSID du profil utilisateur qui a soumis la commande.
*NO: La sortie n'est pas convertie à partir du jeu de codes du serveur.

Exemples

Exemple 1 : Soumission d'une commande Windows

SBMNWSCMD   CMD('net config server')  SERVER(WINSVR)
            CMDSTDOUT(*JOBLOG)

Cette commande permet d'afficher les paramètres de service Windows Server sur le serveur Windows WINSVR. La sortie standard de la commande est transmise à l'i5/OS et dirigée vers l'historique du travail.

Messages d'erreur

Messages *ESCAPE

CPFA43F: Commande du serveur de réseau non soumise.
CPFA46C: Impossible d'exécuter la commande sur le serveur &1.
CPFA46F: Description de serveur de réseau &1 introuvable.