Define an ESP WEB_DOCLIT job to start a Web Service passing parameters

Products

• ESP Workload Automation

Issue/Introduction

How to define a Web Service Document/Literal (WEB_DOCLIT) job to run on a mainframe communicating with a Web Server in a Windows or UNIX environment.

 

Resolution

Sample WEB_DOCLIT job definition:  (initiates a ServiceName Start Request named "XXX_ESP", and passes two parameters named "JobName" and "AgentName")

 

WEB_DOCLIT PAMTEST
  AGENT AGENTU_WEB                                                    
  OPERATION executeStartRequest                                       
  ENDPOINT_URL http://[<server_name>]:<port>/<path>/soap          
  PORTNAME ServiceNameSoap                                           
  SERVICENAME ServiceName                                            
  WSDL_URL http://[server_name]:<port>/itpam/soap?wsdl         
  PARAMETER NAME(/executeStartRequest) VALUE('')                      
  PARAMETER NAME(/executeStartRequest/auth) VALUE('')                 
  PARAMETER NAME(/executeStartRequest/auth/user) VALUE(userid)      
  PARAMETER NAME(/executeStartRequest/auth/password) VALUE(password)  
  PARAMETER NAME(/executeStartRequest/objLocation) VALUE('')          
  PARAMETER NAME(/executeStartRequest/objLocation/name) VALUE(XXX_ESP)
  PARAMETER NAME(/executeStartRequest/objLocation/path) VALUE('/')    
  PARAMETER NAME(/executeStartRequest/params) VALUE('')               
  PARAMETER NAME(/executeStartRequest/params/param) +                 
            VALUE('This is my Job Name')                              
  PARAMETER NAME(/executeStartRequest/params/param@name) VALUE(JobName)
  PARAMETER NAME(/executeStartRequest/params/param) +                 
            VALUE('This is my Agent Name')                            
PARAMETER NAME(/executeStartRequest/params/param@name) VALUE(AgentName)
  RUN DAILY                                                             
ENDJOB

Modify the following fields for your environment:
1) ENDPOINT_URL
2) WSDL_URL
3) The userid is a valid ServiceName userid
4) The password is a valid ServiceName password

Note:
The WEB_DOCLIT job type requires the WOBDEF module CYBESOWD.   The WOBDEF may also be coded as an ESP init statement: WOBDEF CYBESOWD

Execute the following ESP page mode command to load this module:   OPER WOBDEF LOAD(CYBESOWD)