Troubleshooting
Problem
You are receiving HTTP/1.1 404 Service not found. This occurs when running a CICS Transaction Server for z/OS (CICS TS) application program that contains a WEB OPEN command.
Cause
HTTPVNUM and HTTPRNUM were specified on the WEB OPEN command causing a request with the OPTIONS method to be sent from CICS to the other side (the server) to find the version and release of the server. In this case, the server either was not prepared to process the request, or refused to and rejected it, causing the error.
Diagnosing The Problem
In the trace, you see following sequence of events:
- The WEB OPEN URIMAP HTTPVNUM HTTPRNUM NOHANDLE command is issued.
- CICS creates and establishes the socket.
- This is followed by the SSL handshake flow: sending its client hello, certificate, change cipher spec request.
- Then the CICS region (the client) sends the following to the server:
OPTIONS * HTTP/1.1..Host:xxx.yyy.com..User-Agent: IBM_CICS_Transaction_Server/4.1.0
(zOS)..Date: dd mm yyyy hh:mm:ss GMT..TE: trailers..Connection: Keep-Alive - The server(the other side) did the normal SSL handshake: sending its server hello, followed by an enormous amount of certificate data.
- After SSL handshake is done, CICS receives the following:
HTTP/1.1 404 Service not found, No handler was found matching the request.
Client IP: xxx.xxx.xxx.xxx - Socket connection is closed.
Resolving The Problem
If you do not need the version and release of the server, remove HTTPVNUM and HTTPRNUM from the EXEC CICS WEB OPEN command. This will stop the OPTIONS request from being sent.
Alternatively, make a change to the server side to accept and process the OPTIONS request.
[{"Type":"MASTER","Line of Business":{"code":"LOB70","label":"Z TPS"},"Business Unit":{"code":"BU048","label":"IBM Software"},"Product":{"code":"SSGMGV","label":"CICS Transaction Server"},"ARM Category":[{"code":"a8m0z00000007d1AAA","label":"Developing applications"},{"code":"a8m0z00000007gPAAQ","label":"Web Services"}],"ARM Case Number":"","Platform":[{"code":"PF035","label":"z\/OS"}],"Version":"5.4.0;5.5.0;5.6.0;6.1.0;6.2.0"}]
Product Synonym
CICS/TS CICS TS CICS Transaction Server
Was this topic helpful?
Document Information
Modified date:
05 January 2026
UID
swg21605662