La proprietà commandPath

Utilizzare la proprietà commandPath per specificare i percorsi da cui IBM® MQ Managed File Transfer può eseguire comandi. Prestare la massima attenzione quando si imposta questa proprietà poiché qualsiasi comando in uno dei commandPaths specificati può essere effettivamente richiamato da un sistema client remoto che è in grado di inviare comandi all'agent.

È possibile specificare un comando da eseguire sul sistema in cui l'agent è in esecuzione dalle funzioni di trasferimento gestito e di chiamata gestita di IBM MQ Managed File Transfer. Per ulteriori informazioni, consultare Richiamo del programma. Tuttavia, i comandi devono essere sui percorsi a cui fa riferimento la proprietà dell'agent commandPath .

Se il comando specificato non è completo, IBM MQ Managed File Transfer tenta di trovare un comando corrispondente nel percorso del comando. Se è presente più di un comando corrispondente nel percorso del comando, viene utilizzata la prima corrispondenza.

Per impostazione predefinita, la proprietà commandPath è vuota in modo che l'agent non possa richiamare alcun comando.

Specificare la proprietà dell'agent commandPath come segue:

commandPath=command_directory_name 
separator...command_directory_name

Oppure, solo per z/OS® , specificare:

commandPath=command_directory_name_or_data_set_name_prefix 
separator...command_directory_name_or_data_set_name_prefix

dove:

nome_directory_comando è un percorso di directory per i comandi che è possibile eseguire.
command_directory_name_or_data_set_name_prefix è un percorso di directory di z/OS UNIX System Services per i comandi che possono essere eseguiti o un prefisso di nome dataset che inizia con //. È possibile scegliere di utilizzare un prefisso di nome dataset completo o non qualificato (ovvero, nel formato: //'HLQ...' o //HLQ...). Specificare i dataset partizionati nel formato //'HLQ()...' o //HLQ().... Utilizzare i dataset per specificare solo i comandi di script JCL.
separatore è il separatore specifico della piattaforma.

Ad esempio, su un sistema UNIX se si desidera eseguire i comandi ubicati nelle directory /home/user/cmds1 e /home/user/cmds2, impostare la proprietà dell'agent commandPath come riportato di seguito:

commandPath=/home/user/cmds1:/home/user/cmds2

Ad esempio, su un sistema Windows se si desidera eseguire i comandi ubicati nelle directory C:\File Transfer\commands e C:\File Transfer\agent commands, impostare la proprietà dell'agent commandPath come riportato di seguito:

commandPath=C:\\File Transfer\\commands;C:\\File Transfer\\agent commands

Su un sistema Windows, il carattere di separazione, barra retroversa (\), deve essere preceduto da un carattere di escape e immesso come doppia barra retroversa (\\). Il carattere barra rovesciata (\) può anche essere sostituito con una barra (/).

Ad esempio, su un sistema IBM 4690 , il carattere separatore è un punto e virgola (;). Per eseguire i comandi che si trovano nelle directory f:/fteuser/cmds e mqftcmds:/public , dove mqftcmds è un nome logico IBM 4690 definito in una directory che contiene i comandi, impostare la proprietà dell'agent commandPath come riportato di seguito:

commandPath=f:/fteuser/cmds;mqftcmds:/public

Ad esempio, su z/OS se si desidera eseguire comandi che sono:

Nelle directory /home/user/cmds1 e /home/user/cmds2
Nei dataset che iniziano con //'USER.CMD1', //CMD2,
Membri di un PDS completo denominato //'USER.CMDS'

impostare la proprietà dell'agent commandPath come segue:

commandPath=/home/user/cmds1:/home/user/cmds2://'USER.CMD1'://CMD2://'USER.CMDS()'

Importante: prestare estrema attenzione quando si imposta questa proprietà, poiché qualsiasi comando in uno dei commandPaths specificati può essere richiamato da un sistema client remoto che è in grado di inviare comandi all'agent. Per questo motivo, per impostazione predefinita, quando si specifica un commandPath, sandboxing è configurato in modo che a tutte le directory commandPath (e alle loro sottodirectory) venga automaticamente negato l'accesso per un trasferimento:

Se l'agent è configurato per utilizzare una sandbox agent, le directory commandPath vengono aggiunte automaticamente all'elenco di directory negate all'avvio dell'agent.
Se l'agent è configurato con una o più sandbox utente, le directory commandPath vengono aggiunte come elementi <exclude> agli elementi <read> e <write> per ogni sandbox utente all'avvio dell'agent.
Se l'agent non è configurato per utilizzare una sandbox dell'agent o una sandbox dell'utente, viene creata una nuova sandbox dell'agent all'avvio dell'agent con le directory commandPath specificate come directory negate.

È possibile sovrascrivere questo comportamento per motivi di compatibilità con le seguenti release:

IBM WebSphere® MQ File Transfer Edition.
Il componente IBM WebSphere MQ V7.5.0.1 Managed File Transfer (o versioni precedenti).
Il componente IBM WebSphere MQ V7.5.0.2 Managed File Transfer (o versione successiva) su un'installazione che non ha la proprietà di installazione enableFunctionalFixPack=7502 impostata.

È possibile sovrascrivere questo comportamento aggiungendo la seguente proprietà al file agent.properties :

addCommandPathToSandbox=false

Quando la proprietà addCommandPathToSandbox è presente e impostata su false, si verifica il seguente comportamento:

Se l'agent è configurato per utilizzare una sandbox dell'agent e la sandbox non dispone di alcuna directory consentita specificata, le directory commandPath vengono automaticamente aggiunte all'elenco di directory negate all'avvio dell'agent.
Se l'agent è configurato per utilizzare una sandbox dell'agent e la sandbox ha una o più directory consentite specificate, le directory commandPath non vengono aggiunte all'elenco di directory negate all'avvio dell'agent.
Se l'agente è configurato con una o più sandbox utente, le sandbox utente non vengono modificate e le directory commandPath non vengono aggiunte come elementi <exclude> agli elementi <read> e <write> per ogni sandbox utente.
Se l'agent non è configurato per utilizzare una sandbox dell'agent o una sandbox dell'utente, viene creata una nuova sandbox dell'agent all'avvio dell'agent con le directory commandPath specificate come directory negate.

La proprietà commandPath è descritta in Il file agent.properties.