Update CV startup JCL
Ensure that the necessary datasets have been added to the CV startup JCL as described in the "TCP/IP Support" section of the CA IDMS DocOps site found here.
Update CV System Generation
Use the following system generation syntax as a sample of the statements required to support the usage of TCP/IP based ODBC connections in the CV. Listed below are the customization points that you should consider:
· The PORT IS value in the listener PTERM (TCPJSRV) is what must be used later in the definition of any data sources intending to use this new communications interface. By default, the PORT number is set to 3700. This number can be changed at the discretion of your site. The port number specified must be unique within your LPAR.
· The REPEAT COUNT in the bulk PTERM definition should be set to the maximum number of concurrent connections you expect to use.
DEFAULT STATUS IS ON
DEFAULT TCP_NODELAY OPTION IS OFF
DEFAULT STACK IS DEFAULT
MAXIMUM NUMBER OF SOCKETS IS DEFAULT
MAXIMUM NUMBER OF SOCKETS PER TASK IS DEFAULT
PLUGIN MODULE IS RHDCD1IP
SERVICES FILE IS SERVICES CASE SENSITIVE
ADD LINE TCPIP
TYPE IS SOCKET
ADD PTERM TCPJSRV
TYPE IS LISTENER
PORT IS 3700
TASK IS RHDCNP3J
MODE IS SYSTEM PARM IS 'TASK=IDMSJSRV'
ADD LTERM TCLJSRV
PTERM IS TCPJSRV
ADD PTERM TCP0001
TYPE IS BULK
REPEAT COUNT IS 49
ADD LTERM TCL0001
PTERM IS TCP0001
For more information, see Defining the CA IDMS System Using TCP/IP.
Work with your Mainframe Network Security Administrator
Access to mainframe-based ports are often times secured behind a network firewall. If such is the case at your site, you will need to work with your mainframe network security administrator to gain access to whatever "listener" port number you selected in your TCPJSRV PTERM definition.
Ensure that Task Code RHDCNP3J is Unsecured
If task-level security is enabled on your CA-IDMS CV, then you must bypass security for the RHDCNP3J task. The TCP/IP line driver invokes task RHDCNP3J before the user-id and password are received. Therefore, task code RHDCNP3J must be unsecured and executable by any user.
You can achieve this directly in your RHDCSRTT assembly with this macro entry:
Or you can GRANT it to PUBLIC with these security definitions:
CREATE RESOURCE CATEGORY ODBC_TCPIP
ADD TASK RHDCNP3J
GRANT EXECUTE ON CATEGORY ODBC_TCPIP TO PUBLIC
The task code specified in the TASK= clause in the listener PTERM (IDMSJSRV by default) is executed after the user-id and password are received and as such it can be used to implement security to allow specific users and groups access to the connection being defined.
Change Data Source definitions to use protocol IDMS
To change your CA IDMS data source definitions to use the wire protocol, go into the ODBC Data Source Administrator application, click either the User DSN or System DSN tab as appropriate, and then click on the data source you wish to change.
Click Configure, and then click the Server tab. Select the "IDMS" Communications Protocol. Then specify the host name of the LPAR where your CV is running and the PORT NUMBER as defined in the listener PTERM.
Click Apply, OK and then OK again to exit the ODBC Administrator.