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.