docmain.css" /> B. Record and edit a logon macro in a Web-Based session. - Automated Sign-On for Mainframe Administrator Guide

B. Record and edit a logon macro in a Web-Based session.

The logon macro is initiated when an authenticated user launches the session to connect or reconnect to the host.

NOTE:These instructions are guidelines to enable Automated Sign-On for Mainframe. Although error- checking is omitted for brevity and clarity, the macro author should check for errors as required by the application.

  1. Open the session you created from Manage Sessions.

  2. Start the macro recorder.(Click Macro > Start recording.)

  3. Connect to the host and log on to the appropriate host application using a valid user name and password.

    You will edit the macro to replace specific user information with values that support logon by any authenticated user.

  4. Click Macro > Stop Recording...

  5. Enter the macro name, such as TSO Logon.

  6. Save the macro and click OK to acknowledge the alert message, which tells you that the macro will be saved to the MSS Administrative Server only after you save and exit the session.

  7. Click Macro > Macros... Select the macro you just created and click Edit.The macro opens for editing in a Macro Editor window.

  8. Below the variable definitions at the top of the recorded macro, add the following line:

    var credentials = eclcredentials.getDASOPassTicket( "APPID" );

    where "APPID" is replaced with the appropriate host application ID.

  9. In the macro’s “performAction” function, edit the statement that sends your user name.

    Remove your user name and replace it with the mainframe username that was retrieved by the getDASOPassTicket method. The edited line should look like this:

    ps.SendDASOUserID( credentials );
  10. In the macro’s “performAction” function, comment out or delete the lines that use the SendCredential method to transmit the mainframe password. Replace it with a new line that transmits the passticket retrieved from the MSS Administrative Server.

    The modified line should look like this:

    ps.SendDASOPassTicket( credentials );
  11. Save the macro and close the Macro Editor window.

  12. To configure the macro to run on session startup, or to run on each connection, click Macros > Macros…

  13. In the Macros dialog box, select “Run at startup” if you want the automated sign-on macro to run after the session launches.

    Click the Events button, then assign the macro as the “On connect macro” if you want the automated sign-on macro to run every time the session connects.

  14. Close the Macros dialog box, then Save and Exit the session to send the settings to the MSS Administrative Server.