WebSphere MQ Adapter 6.5 | webMethods WebSphere MQ Adapter Documentation | webMethods WebSphere MQ Adapter Installation and User’s Guide Documentation | Adapter Services | Configuring PCF Command Services
Configuring PCF Command Services
Using the PCF Command Service
Output Signature Properties for the PCF Command Service
A PCF Command service issues Programmable Command Format (PCF) commands to the WebSphere MQ command server for execution. PCF commands allow you to use a single application to perform network administration from a single queue manager within the network.
For more information about PCF Command services, see PCF Command Services. You configure WebSphere MQ Adapter services using Designer.
To use this feature, you should be familiar with the WebSphere MQ Programmable Command Formats, described in the WebSphere MQ Programmable Command Formats and Administration Interface (SC34-6598).
On platforms other than z/OS, the queue to which the PCF commands are sent is always called the SYSTEM.ADMIN.COMMAND.QUEUE. On z/OS, commands are sent to SYSTEM.COMMAND.INPUT, although SYSTEM.ADMIN.COMMAND.QUEUE can be an alias for it.
*To configure a PCF Command service
1. Review the steps in Before Configuring or Managing Adapter Services.
2. Start Designer.
3. Using Designer, perform the following:
a. Right-click the package in which the service should be contained and select New > Adapter Service.
b. Select the parent namespace and type a name for the adapter service.
c. Click Next.
4. Select WebSphere MQ Adapter as the adapter type and click Next.
5. Select the appropriate Adapter Connection Name and click Next.
If you are using the adapter with Integration Server 8.0 SP1 or earlier, adapter services cannot use connections that are also used for adapter listeners.
6. From the list of available templates, select the PCF Command Service template and do the following:
Select a package and folder to contain the service, type a unique name for the service, and click Finish.
The adapter service editor for the PCF Command service appears. You can select the Adapter Settings tab at any time to confirm adapter service properties such as Adapter Name, Adapter Connection Name, and Adapter Service Template, as necessary.
7. Select the PCF Command Service tab to configure the following fields:
PCF Command
Select the PCF command you want to execute.
Wait Interval (msec)
The time period that the service waits for a reply message to appear on the queue. Enter this value in milliseconds.
Default: 60000
Throw Exception on Failure?
Select whether the service throws an exception on failure:
*Checked Throws an exception when the adapter service returns error codes.
*Unchecked Returns reasonCode, conditionCode, and errorMsg in the output signature.
Default: Checked
8. Select the Optional Request Parameters tab to specify the optional Input parameters.
Use the following icons to manage the rows on the Optional Request Parameters tab:
*To select an optional request parameter for the selected PCF command, select the icon (or the Fill in all rows to the icon).
*To change the order of the selected parameters, use the or icons.
*To delete any of the selected parameter, use the icon.
The specified Optional Request Parameters appear on the Input/Output tab in the Input signature for this adapter service.
Some PCF commands have mandatory Request parameters, which will appear under RequiredParameters in the Input signature of the service.
9. Select the Response Parameters tab to select the response parameters for the selected pcf command. To select the response parameters follow the same instructions as specified in step 8. The specified Response Parameters appear on the Input/Output tab in the Output signature for this adapter service.
For more information about Request Parameters and Response Parameters, see WebSphere MQ Programmable Command Formats and Administration Interface (SC34-6598).
When using Designer, Designer contains only the Adapter Settings and Input/Output tabs. The information from the Audit and Permissions tabs appears in the Properties panel, and the information from the Results tab appears in the Service Results panel in Designer. For more information, see the webMethods Service Development Help for your release.
10. From the File menu, select Save.