IDMS REST API EDC5111I Permission denied. (errno2=0x744C7246)

Products

• IDMS
• IDMS - Database

Issue/Introduction

The IDMS REST API JVM procedure JVMPRC86 fails to startup with condition code 100 and the following errors:

ERROR Application run failed

Caused by: org.springframework.boot.web.server.WebServerException: Unable to start embedded Tomcat server

Caused by: java.net.SocketException: EDC5111I Permission denied. (errno2=0x744C7246)

Environment

Release: 19.0

Resolution

There maybe multiple TCP/IP stacks on this LPAR and due to TCPIP restrictions, the IDMS REST API can only bind to one stack.

Set the stack affinity to point to a specific stack by adding the following as the first step in the startup JCL:

//STEP1 EXEC PGM=BPXTCAFF,PARM=IPSTACK

Where IPSTACK is the name of the IBM TCPIP stack 

If still a problem it means the port specified in the server section of the application.yml file is already in use:

server: 
      address: ip_address
      port: port_number

Run the following to check if this is the case:

//TSOBATCH     EXEC PGM=IKJEFT01
//SYSTSOUT  DD SYSOUT=*
//SYSTSPRT  DD SYSOUT=*
//SYSPRINT  DD SYSOUT=*
//SYSTSIN   DD *
  NETSTAT CONN (PORT port_number
/*

If the port number is already in use specify a different port number in the application.yml:

server: 
      address: ip_address
      port: new_port_number

You can reserve the port number for IDMS REST API use by adding it to the TCPIP PROFILE member.

Additional Information

For more information on the IDMS REST API see documentation section Install the REST API.