Start of change

Managing CICS Web support resources

You can use the CICS® system programming interface and the CICS-supplied transactions CEMT and CEDA to create, install, update and delete CICS Web support resources.

The CICS-supplied transaction CEDA can be used to create and install TCPIPSERVICE, URIMAP, TRANSACTION and DOCTEMPLATE resource definitions. Resource definition for CICS Web support has more information about setting up resource definitions for CICS Web support.

The CICS system programming interface includes the following commands for CICS Web support administration:
INQUIRE TCPIP
Inquire on the status of TCP/IP support in the CICS system. The command returns the open status for TCP/IP and the maximum and current number of IP sockets in the CICS region.
SET TCPIP
You can use this command to open or close TCP/IP support, either normally, with active tasks being allowed to complete, or immediately, with active tasks being terminated abnormally. Closing TCP/IP support means that all inbound and outbound requests are rejected, and CICS Web support is stopped completely. You can also use this command to increase or reduce the maximum number of IP sockets in the CICS region. If you do not have superuser authority, the limit that you can set is lower, and CICS informs you if it has imposed this lower limit.
CREATE TCPIPSERVICE
Create a TCPIPSERVICE definition for a port.
DISCARD TCPIPSERVICE
Delete the TCPIPSERVICE definition for a port. The TCPIPSERVICE definition must be closed (using the SET TCPIPSERVICE command) before it can be discarded.
INQUIRE TCPIPSERVICE
Inquire on a TCPIPSERVICE definition. As well as displaying the attributes of the definition, the inquiry shows the current DNS registration status and open status for the definition. TCPIPSERVICE definitions may also be browsed.
SET TCPIPSERVICE
You can use this command to change the request queue limit, the data receive limit, the DNS registration status, or the analyzer program for the TCPIPSERVICE definition. You can also use this command to close the TCPIPSERVICE definition. You can choose to stop listening on the port normally, with active tasks being allowed to complete, or immediately, with active tasks being terminated abnormally.
CREATE URIMAP
Create a URIMAP definition for a request.
DISCARD URIMAP
Delete a URIMAP definition. Requests that were handled by the deleted definition might be matched by a less specific URIMAP definition that has a wildcard character in the path. Otherwise, they will pass to the analyzer program for the TCPIPSERVICE definition. If you want to reject the requests without this alternative handling, disable the URIMAP definition rather than discarding it.
INQUIRE URIMAP
Inquire on a URIMAP definition. As well as displaying the attributes of the definition, the inquiry shows if a URIMAP has been disabled on an individual basis, or if it is unavailable because the virtual host of which it is a part has been disabled. URIMAP definitions may also be browsed.
SET URIMAP
You can use this command to enable or disable a URIMAP definition. When a URIMAP definition is disabled, CICS returns an HTTP 503 response (Service Unavailable) to the Web client through a Web error program. You can also use this command to set the LOCATION and REDIRECTTYPE attributes to specify redirection, or to end a redirection.
INQUIRE HOST
Inquire on a virtual host. Virtual hosts may also be browsed. Administering virtual hosting explains how to manage virtual hosts.
SET HOST
Enable or disable a virtual host. Administering virtual hosting explains how to manage virtual hosts.
TRANSACTION, DOCTEMPLATE and PROGRAM resources that you use for CICS Web support can also be managed using SPI commands. CICS System Programming Reference has full information about all these commands.
The CICS-supplied transaction CEMT includes the following commands for CICS Web support administration:
  • INQUIRE TCPIP
  • SET TCPIP
  • INQUIRE TCPIPSERVICE
  • SET TCPIPSERVICE
  • INQUIRE URIMAP
  • SET URIMAP
  • INQUIRE HOST
  • SET HOST
TRANSACTION and PROGRAM resources that you use for CICS Web support can also be managed using CEMT, and you can inquire on DOCTEMPLATE resources. CICS Supplied Transactions has full information about all these commands, and explains how to use CEMT.

CICSPlex® SM can also be used to manage the resources listed here.

End of change