# Define host

Enter the following information about the host IMS that is to run your transaction.

Prompt for host information

If you check this box, the initial input HTML form will be generated with text entry fields (for Hostname, Port number, and Datastore ID/IMS XCF member name), and any values entered into the corresponding Define host TaskGuide window fields will be used as defaults.

If you do not check this box, you must enter values into the Define host TaskGuide window fields and these values will be hard coded into the C++ source of the generated CGI-BIN program or transaction DLL.

Hostname of the machine running ITOC

Enter the host name of the machine running the IMS TCP/IP OTMA Connection. This must be a hostname and not a TCP/IP address. The host name might or might not have to be fully qualified, depending on how TCP/IP is configured for your web server.

Port number

Enter the port number (maximum of 4 characters) assigned to the IMS TCP/IP OTMA Connection on the machine running the IMS TCP/IP OTMA Connection.

Datastore ID/IMS XCF member name

Enter the

extended coupling facility member name (maximum of 8 characters). This is the Datastore ID you specified when you installed IMS TCP/IP OTMA Connection.

Prompt for user information

If you check this box, the initial input HTML form will be generated with text entry fields (for RACF group name and RACF userid), and any values entered into the corresponding Define host TaskGuide window fields will be used as defaults.

If you do not check this box, the values in these fields will be hard coded into the C++ source of the generated CGI-BIN program or transaction DLL. The RACF group name and RACF userid might be required, depending on the configuration of IMS TCP/IP OTMA Connection and RACF.

IMS TCP/IP OTMA Connection optionally invokes RACF with the group name, userid, and password. If RACF security checking is successful, the UTOKEN returned by RACF is passed to OTMA.

RACF Group name

Enter the RACF group name (which has a maximum of 8 characters) to pass to OTMA. The RACF group name value entered in the HTML text entry field is converted to uppercase by IMS TCP/IP OTMA Connection before invoking RACF.

RACF Userid to pass to OTMA

Enter the RACF userid (maximum of 8 characters) to pass to OTMA. The RACF userid value entered in the HTML text entry field is converted to uppercase by IMS TCP/IP OTMA Connection before invoking RACF.

Prompt for password

If you check the Prompt for user information check box, the prompt for password check box is enabled, Otherwise, it is disabled.

If you check the Prompt for password box, the initial input HTML form will be generated with a text entry field for password. IMS TCP/IP OTMA Connection passes the password to RACF for authentication of the userid. The password value entered in the HTML text entry field is converted to uppercase by IMS TCP/IP OTMA Connection following decryption and before invoking RACF.

If the Prompt for password check box is not checked, a password field is not generated on the initial HTML form.

Convert password to host codepage

If you check this box, the resulting encrypted password is converted as text between the Web server platform and the host (IMS TCP/IP OTMA Connection) platform. This is the default. For example, if the server platform is Windows NT, the characters of the encrypted password are converted from ASCII to EBCDIC.

If this box is not checked, the encrypted password is not converted as text between platforms.

Restriction: Do not chose this type of encryption unless you have incorporated our sample or your own method into the IMS Web Runtime component. Otherwise, you will probably fail user authentication by RACF.

See the “Security” section in the IMS Web Programmer’s Reference for a detailed description of password encryption methods.