FTP adapter request and response for mkdir command
When you use a context item as an input for an adapter request, you must enclose the adapter request in <request-data> elements. However, when you create a static request, <request-data> is not required and the adapter request starts with the <adapterName-adapter-request> element.
BMC recommends that you do not include empty elements in the adapter request because they might cause errors.
The following table describes the elements of an FTP adapter request with a mkdir command:
Elements of an FTP adapter request with a mkdir command
The following figure shows an XML template of the adapter request for the FTP adapter with mkdir command.
XML template of the FTP adapter request with mkdir command
<ftp-request>
<targets>
<target name=""/>
</targets>
<data-transfer-mode></data-transfer-mode>
<commands>
<mkdir></mkdir>
</commands>
</ftp-request>
The following figure shows an XML sample of the adapter request for the FTP adapter with mkdir command.
XML sample of the FTP adapter request with mkdir command
<ftp-request>
<targets>
<target name="host1"/>
<character-set>Shift_JIS</character-set>
</targets>
<data-transfer-mode>PASSIVE or ACTIVE</data-transfer-mode>
<commands>
<mkdir>/path/to/new/directory/directory name</mkdir>
</commands>
</ftp-request>
The mkdir command request for the FTP adapter returns an adapter response that contains the summary information for the command.
The following table describes the elements of an FTP adapter response to a request with mkdir command:
Elements of an FTP adapter response to a request with mkdir command
The following figure illustrates an XML sample of the adapter response for the FTP adapter with mkdir command.
XML sample of the FTP adapter response with mkdir command
<ftp-command-output>
<request-metadata>
<status>success</status>
<error>Present only with status of 'error'</error>
</request-metadata>
<targets-output>
<target-output host="server1">
<target-metadata>
<status>success</status>
<error>Present only with status of 'error'</error>
</target-metadata>
<commands-output>
<command-output>
<metadata>
<id>1</id>
<command>mkdir</command>
<execution-milliseconds>value</execution-milliseconds>
<status>success</status>
<error>Present only with status of 'error'</error>
</metadata>
<output/>
</command-output>
</commands-output>
</target-output>
</targets-output>
</ftp-command-output>