What is it?

A new integrated web services (IWS) script, getConfigurationFile.sh, has been created that will allow users to retrieve the XML (e.g. PCML) for a service and/or to generate a property file for a service.  Command usage:

getConfigurationFile.sh                                            
   -server 'server-name' -locationDirectory 'location-directory'   
   [-type '*ML|*PROPERTY|*ALL']                                  
   [-serviceList 'service-list|*ALL']                                                       

where

• -server is the name of the web services server.  
• -locationDirectory is the absolute path to the directory in which the configuration file(s) will be created.  
• -type is the configuration file to retrieve. Possible types:        
  • *ML                  - Return the markup language file associated with specified service(s).  
  • *PROPERTY   - Return the property file associated with specified service(s). This is the file that you would specify on the installWebService.sh command.
  • *ALL                - Return all files associated with specified service(s).                                                                           
• -serviceList is a colon-delimited string listing the services for which the configuration file should be retrieved.  A value of *ALL means retrieve the configuration file for all services.                                         

Why use it?

As you may know, you can install a web service based on a property file by using the installWebService.sh command.  However, the creation of the property file was a slow, inefficient, error-prone manual process.  And you still had to specify some of the parameter options on the installWebService.sh command in addition to the property file.  The getConfigurationFile.sh script will generate a complete property file that does not require you to specify parameter options on the installWebService.sh command.  For example, to get the properties file for a web service ConvertTemp:

getConfigurationFile.sh -server WSERVICE -locationDirectory /tmp  -serviceList ConvertTemp

Then, to install the service you would use the installWebService.sh script as follows:

installwebservice.sh -server WSTEST   -propertiesFile /tmp/ConvertTemp.properties

In addition, the new script allows you to retrieve the complete XML file that IWS uses when deploying the service.  The XML may be used on the installWebService.sh command (and must be specified when you are trying to install an SQL based web service).

Availability

The support is enabled in the following PTFs:

SI70249 V7R2M0
SI69902 V7R3M0
SI69903 V7R4M0