CICS Explorer® plug-in variables

The variables that are required to configure and install the web service resources that are required to connect to the CICS® IA plug-in.

You can connect to the collector from the CICS® IA plug-in with CICS® IA by using the web service interface. The following fields are used to configure the location of the web service files and the TCP/IP port number that is used for the web service call.

CICS® IA CONTROL REGION
If you want to configure the CICS® resources that are required to connect the CICS® IA plug-in to a controlling region, set this field to YES.

REQUIRED.

TCP IP PORT
The TCP/IP port number that is used in the web service call. The configuration EXEC uses the specified TCP/IP port number in the POrtnumber field in the CSD TCPIPSERVICE resource definition. This definition enables the web service listener on the port.

REQUIRED if this region is used as a CICS® IA controlling region.

WEB SERVICES FILES LOCATION
The zFS prefix path to the CICS® web service binding directory, or pickup directory. This path is decided at SMPE installation time. View the installation data set member CIUMKDIR and look for the value of the idir variable. The suffix, /IBM/webservices/wsbind/provider is appended to the value specified in this field to build the full path to the pickup directory. The full path name is used by the configuration EXEC in the Wsdir field for the CSD PIPELINE resource definition.

REQUIRED if this region is used as a CICS® IA controlling region. For a Short configuration, this field is not displayed and defaults to /usr/lpp/cicsia/v630.

WEB SERVICE SHELF
The zFS prefix path to the CICS® web service Shelf directory. The suffix, /shelf is appended to the value specified in this field to build the full path to the Shelf directory. The full path name is used by the configuration EXEC in the Shelf field for the CSD PIPELINE resource definition.

REQUIRED if this region is used as a CICS® IA controlling region. For a Short configuration, this field is not displayed and defaults to /usr/lpp/cicsia/v630.

CONFIGURATION FILE
The zFS prefix path to the CICS® web service pipeline configuration file. This path is decided at CICS® Transaction Server SMPE installation time. View the installation data set member DFHMKDIR and look for the value of the idir variable. The pipeline configuration file is an XML file, which includes descriptions of SOAP header processing and message handler programs. The suffix /samples/pipelines/basicsoap11provider.xml is appended to the value specified in this field to build the full path to the pipeline configuration file. The full path name is used by the configuration EXEC in the COnfigfile field for the CSD PIPELINE resource definition.

REQUIRED if this region is used as a CICS® IA controlling region. For a Short configuration, this field is not displayed and defaults to /usr/lpp/cicsts/v630.

CSD WEB SERVICE CSD GROUP
This field defines the name of the web services resources group, which is created in the CSD file of the controlling region. The group contains the TCPIPSERVICE, PIPELINE, and PROGRAM definitions that are required to enable web service operations in CICS® TS. This group is appended to the CICS AOR LIST NAME.

REQUIRED if this region is used as a CICS® IA controlling region. For a Short configuration, this field is not displayed and defaults to IA63WEBS.