Gen Example : Passphrase and Encryption cookbook

Products

• Gen
• Gen - Host Encyclopedia
• Gen - Run Time Distributed
• Gen - Workstation Toolset

Issue/Introduction

Gen Example - Passphrase and Encryption cookbook instructions.

Environment

Release : 8.6

Resolution

The following are example instructions for a test of Passphrase and Encryption.  They are not intended to replace the published Gen documentation.

The first step is to review the Passphrase announcement which contains some information on required PTFs: Now Available: 200 character passwords in Client Manager (Password Phrases)

There is also a video that discusses Passphrase which includes an example.
That video can be found by:

• Go to support.broadcom.com. Login and ensure "Mainframe Software" is selected (top right option next to login name).
• On that page under Quick Links use Mainframe Software Education and then select the link for Learning@Broadcom.
• In the Search field enter 'Gen™: Getting Started with Password Phrase with Client Manager 100'.

The modified source code is attached to this article.

PASSPHRASE

These steps are provided to implement a simple example.

Compile/Link
1. Verify PTFs are applied.
2. Start and verify the Transaction Enabler (TE) is running correctly.  Run application that uses Client Manager (CM).  Stop the TE and CM.
3. Save C:\Program Files (x86)\CA\Gen86\Gen\aeuexitn.dll
4. Save C:\Program Files (x86)\CA\Gen86\Gen\aeuexitn.lib
5. Save C:\Program Files (x86)\CA\Gen86\Gen\tirsecv.c
6. Copy modified tirsecv.c for enhanced security to C:\Program Files (x86)\CA\Gen86\Gen\
7. Open DOS Command Prompt with Run as Administrator
8. cd C:\Program Files (x86)\CA\Gen86\Gen\
9. Execute: genenv.bat 32 2019     (Assuming VS2019)
10. Execute: MKEXITS.BAT

Test
11. Start TE and CM.
12. Set Security Level to Defer, run 'Send Test Trans.', return should be 'Test Transaction ECHO Returned from: <servername>'.
NOTE: If you did not get the User Exit DLL aeuexitn.dll created correctly, this message may occur.  'Test Transaction return code is 643, Client security user exit not installed.
13. Set Security Level to Remote-Enhanced, enter bogus incorrect Passphrase, run 'Send Test Trans.', return should be '<servername> - Test Transaction return code is 903, Security: Invalid Password
14. Set Security Level to Remote-Enhanced, enter correct Passphrase value from below, run 'Send Test Trans.', return should be 'Test Transaction ECHO Returned from: <servername>'.
This is test passphrase InterOP@1234!#$^*()A-Z a-z 0-9 <+!|&*-%?:=$@endpassword

ENCRYPTION from Client Manager  (OPTIONAL)

  These steps are provided to implement an simple example, assuming the PASSPHRASE example above has been done.

Compile/Link
1. Save C:\Program Files (x86)\CA\Gen86\Gen\TIRDCRYP.C
2. Copy modified TIRDCRYP.C to C:\Program Files (x86)\CA\Gen86\Gen\
3. Open DOS Command Prompt with Run as Administrator
4. cd C:\Program Files (x86)\CA\Gen86\Gen\
5. Execute: genenv.bat 32 2019     (Assuming VS2019)
6. Execute: MKEXITS.BAT

Compile/Link
7. Save C:\Program Files (x86)\CA\Gen86\Gen\DECREN.DLL
8. Save C:\Program Files (x86)\CA\Gen86\Gen\Samples\ClientManager\DECREXIT.C
9. Copy modified DECREXIT.C (encrypting outgoing message) to C:\Program Files (x86)\CA\Gen86\Gen\Samples\ClientManager
10. Open DOS Command Prompt with Run as Administrator
11. cd C:\Program Files (x86)\CA\Gen86\Gen\Samples\ClientManager\
12. Execute: genenv.bat 32 2019     (Assuming VS2019)
13. Execute: MAKEDECR.BAT
14. Copy C:\Program Files (x86)\CA\Gen86\Gen\Samples\ClientManager\DECREn.DLL to C:\Program Files (x86)\CA\Gen86\Gen\

Test
15. Start or restart the TE.
16. Start CM.
17. Set Security Level to Remote-Enhanced, enter correct Passphrase value from below, run 'Send Test Trans.', return should be 'Test Transaction ECHO Returned from: <servername>'.
This is test passphrase InterOP@1234!#$^*()A-Z a-z 0-9 <+!|&*-%?:=$@endpassword
18. Run a Client Server application and note that it should work correctly.
  To test and verify Encryption and Decryption Exit is executed.
19. Stop the TE.
20. Restore the PassPhrase version of the aeuexitn.dll in to C:\Program Files (x86)\CA\Gen86\Gen
21. Start the TE.
22. Start CM.
23. Set Security Level to Remote-Enhanced, enter correct Passphrase value from below, run 'Send Test Trans.', return will be '<servername> - Test Transaction return code 641, Decryption user exit not installed'.
This is test passphrase InterOP@1234!#$^*()A-Z a-z 0-9 <+!|&*-%?:=$@endpassword