IBM Support

Script to generate property file for a service



Script to generate property file for a service


You are in: IBM i Technology Updates > Welcome to IBM Integrated Web Services for i Technology Updates > Script to generate property file for a service

What is it?

A new integrated web services (IWS) script,, 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:                                            
   -server 'server-name' -locationDirectory 'location-directory'   
   [-type '*ML|*PROPERTY|*ALL']                                  
   [-serviceList 'service-list|*ALL']    


  • -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 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 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 command in addition to the property file.  The script will generate a complete property file that does not require you to specify parameter options on the command.  For example, to get the properties file for a web service ConvertTemp: -server WSERVICE -locationDirectory /tmp  -serviceList ConvertTemp

Then, to install the service you would use the script as follows: -server WSTEST   -propertiesFile /tmp/

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 command (and must be specified when you are trying to install an SQL based web service).


The support is enabled in the following PTFs:

SI70249 V7R2M0
SI69902 V7R3M0
SI69903 V7R4M0

[{"Business Unit":{"code":"BU058","label":"IBM Infrastructure w\/TPS"},"Product":{"code":"HW1A1","label":"IBM Power Systems"},"Component":"","Platform":[{"code":"PF012","label":"IBM i"}],"Version":"All Versions","Edition":"","Line of Business":{"code":"LOB08","label":"Cognitive Systems"}}]

Document Information

Modified date:
30 December 2019