I am trying to use a console request through z/OSMF.  

With 

https://10.1.1.2:10443/zosmf/restconsoles/consoles/colin

I get the following.    The link to the doc gives   code 500 rc 3 reason 14 and code 500 rc 3 reason  18  ....  ,but not 17.

Please can someone tell me where to find what this means.

Response Body

{  "reason": "POST TSO/E Service returns null.",  "return-code": 3,  "reason-code": 17}

Hi Colin,

Could you please open a case with IBM Support.  You can use the Diagnostic Assistant desktop application to capture a copy of the z/OSMF and Liberty logs to include in the case.  It is possible that the TSO proc that z/OSMF is configured to use is incorrect, so you can check that.

Thank you,
John Czukkermann

I am trying to use a console request through z/OSMF.  

With 

https://10.1.1.2:10443/zosmf/restconsoles/consoles/colin

I get the following.    The link to the doc gives   code 500 rc 3 reason 14 and code 500 rc 3 reason  18  ....  ,but not 17.

Please can someone tell me where to find what this means.

Response Body

{  "reason": "POST TSO/E Service returns null.",  "return-code": 3,  "reason-code": 17}

Hi John,

I cant raise a case as I run on zD&T with ADCD on z86 hardware.

I get the 3,17 even if I stop CEA.

I thought the problem may have been permission related, so I reran the z/OSMF security jobs and now I get

reason:      Timeout when creating TSO address space for console IBMUSER
return-code: 2
reason-code: 21

_____________

I turned on as many traces as I knew, and nothing obvious jumped out at me.

In the 3,17 problem the last few entries of the trace ( attached)  are 

1 Trace: 6/22/25, 11:54:50:936 GMT? t=8c2418 key=P8 (3009003) 
  Description: Exit: ntv_setThreadSecurityEnvironment 
  safServiceResult:   data_address=00000053_d7bfe958, data_length=20 

 setStatusCode(sc): Status code: 500 

I dont get the reason:    {  "reason": "POST TSO/E Service returns null.",  "return-code": 3,  "reason-code": 17} in the trace 

I stopped CEA - but that made no difference.

I expect it is a simple set up problem  ( but I am good at falling over bugs).  If you can give a hint where to look, I can keep looking 

Colin

Hi Colin,

Could you please open a case with IBM Support.  You can use the Diagnostic Assistant desktop application to capture a copy of the z/OSMF and Liberty logs to include in the case.  It is possible that the TSO proc that z/OSMF is configured to use is incorrect, so you can check that.

Thank you,
John Czukkermann

I am trying to use a console request through z/OSMF.  

With 

https://10.1.1.2:10443/zosmf/restconsoles/consoles/colin

I get the following.    The link to the doc gives   code 500 rc 3 reason 14 and code 500 rc 3 reason  18  ....  ,but not 17.

Please can someone tell me where to find what this means.

Response Body

{  "reason": "POST TSO/E Service returns null.",  "return-code": 3,  "reason-code": 17}

After several rabbit holes,  I found the problem.   

In my IZUPRMCM  I had not specified HOSTNAME, and this was picking up the value HOSTNAME S0W1.DAL-EBIS.IHOST.COM from somewhere.

in the IZUG0.log was

2025-06-28T07:26:36.337Z|00000089|com.ibm.zoszmf.config.security.listener.Bootstrap|contextDestroyed 
INFO:IZUSAINTL000: The Security Configuration Assistant Application is started 
Ýtx:¨ 
2025-06-28T07:26:37.348Z|000000B0|com.ibm.zoszmf.consoles.tsoconnect.Connection|run 
WARNING:exception when run as server: 
java.net.SocketTimeoutException: Connect timed out 
 at java.base/sun.nio.ch.NioSocketImpl.timedFinishConnect(NioSocketImpl.java:551) 
 at java.base/sun.nio.ch.NioSocketImpl.connect(NioSocketImpl.java:597) 
 at java.base/java.net.SocksSocketImpl.connect(SocksSocketImpl.java:327) 
 at java.base/java.net.Socket.connect(Socket.java:751) 
 at java.base/sun.security.ssl.SSLSocketImpl.connect(SSLSocketImpl.java:304) 
 at java.base/sun.net.NetworkClient.doConnect(NetworkClient.java:178) 
 at java.base/sun.net.www.http.HttpClient.openServer(HttpClient.java:531) 
 at java.base/sun.net.www.http.HttpClient.openServer(HttpClient.java:636) 
 at java.base/sun.net.www.protocol.https.HttpsClient.<init>(HttpsClient.java:264) 

When I added HOSTNAME(10.1.1.2)    and restarted z/OSMF  it all started to work.

________________________________________________________

I could use certififcates to map to a userid and it worked.  If I had no userid,  and no certificate I got 
 curl -X PUT --header Content-Type: application/json --header Accept: application/json --insecure -d { "cmd": "d a,l",  "sol-key": "JES"  } https://10.1.1.2:10443/zosmf/restconsoles/consoles/COLINNO

{"reason":" POST returns error: Error 500: java.lang.NullPointerException: Cannot invoke &quot;java.lang.String.toUpperCase&#40;&#41;&quot; because the return value of &quot;com.ibm.zoszmf.util.auth.ZmfContext.getUserName&#40;&#41;&quot; is null","return-code":3,"reason-code":16}

and the trace had 

INFO:LTPAToken2 is: null 
Ýtx0000000000000127:null@10.1.0.2 (PUT) /zosmf/restconsoles/consoles/COLINNO?null¨ 
2025-06-28T17:02:59.754Z|0000008D|com.ibm.zoszmf.util.web.rest.AbstractRestServlet|processTransaction() 
SEVERE:IZUG802E: An error occurred. Error: "java.lang.NullPointerException" 
com.ibm.zoszmf.util.CommonException: IZUG802E: An error occurred. Error: "java.lang.NullPointerException" 
   com.ibm.zoszmf.util.web.rest.AbstractRestServlet.processTransaction(AbstractRestServlet.java:386) 
-  -  -  -  -  -  -  -  -  -  -  -  -  -  -  -  -  -  -  -  -  -  -  -  -  -  -  -  -  -  -  -  -  -  -  -  -  -  -  
   java.base/java.util.concurrent.ThreadPoolExecutor.runWorker(ThreadPoolExecutor.java:1144) 
   java.base/java.util.concurrent.ThreadPoolExecutor$Worker.run(ThreadPoolExecutor.java:642) 
   java.base/java.lang.Thread.run(Thread.java:1595) 
+-> java.lang.NullPointerException: Cannot invoke 
"java.lang.String.toUpperCase()" because the return value of 
"com.ibm.zoszmf.util.auth.ZmfContext.getUserName()" is null 
                                                                                                                     
   com.ibm.zoszmf.util.tso.servlet.TsoServicesServlet$TsoStartHandler.handlePost(TsoServicesServlet.java:804) 
   com.ibm.zoszmf.util.web.rest.AbstractRestServlet.processTransaction(AbstractRestServlet.java:329) 
   com.ibm.zoszmf.util.web.rest.AbstractRestServlet.doPost(AbstractRestServlet.java:190) 

Hi John,

I cant raise a case as I run on zD&T with ADCD on z86 hardware.

I get the 3,17 even if I stop CEA.

I thought the problem may have been permission related, so I reran the z/OSMF security jobs and now I get

reason:      Timeout when creating TSO address space for console IBMUSER
return-code: 2
reason-code: 21

_____________

I turned on as many traces as I knew, and nothing obvious jumped out at me.

In the 3,17 problem the last few entries of the trace ( attached)  are 

1 Trace: 6/22/25, 11:54:50:936 GMT? t=8c2418 key=P8 (3009003) 
  Description: Exit: ntv_setThreadSecurityEnvironment 
  safServiceResult:   data_address=00000053_d7bfe958, data_length=20 

 setStatusCode(sc): Status code: 500 

I dont get the reason:    {  "reason": "POST TSO/E Service returns null.",  "return-code": 3,  "reason-code": 17} in the trace 

I stopped CEA - but that made no difference.

I expect it is a simple set up problem  ( but I am good at falling over bugs).  If you can give a hint where to look, I can keep looking 

Colin

Hi Colin,

Could you please open a case with IBM Support.  You can use the Diagnostic Assistant desktop application to capture a copy of the z/OSMF and Liberty logs to include in the case.  It is possible that the TSO proc that z/OSMF is configured to use is incorrect, so you can check that.

Thank you,
John Czukkermann

I am trying to use a console request through z/OSMF.  

With 

https://10.1.1.2:10443/zosmf/restconsoles/consoles/colin

I get the following.    The link to the doc gives   code 500 rc 3 reason 14 and code 500 rc 3 reason  18  ....  ,but not 17.

Please can someone tell me where to find what this means.

Response Body

{  "reason": "POST TSO/E Service returns null.",  "return-code": 3,  "reason-code": 17}