Setting Up User Exits › Signon and Signoff Exit › General Notes About the Parameter List

General Notes About the Parameter List

The following notes are general information about the parameter list:

1. This parameter list is delivered for function codes 4 through 28, although not every parameter is delivered for every function.
2. The profile name will always be blank. If any of the function calls change the value of this field, the change will be remembered and passed to the get profile call point. If the value is not altered at this time, that model will be used to build the user's profile.
3. The user data field is reserved.
4. The application name is the name of the primary ACB.
5. If Security System=User, the user signon and signoff exit can use the security record address as a suitable pointer to its own security record, but the user must delete the security record before the signon process is completed.
6. There are four contiguous 80-byte message lines. They can all be accessed from the address of the first one. Even though there are return codes at some call points to display messages, they are not necessary. The presence or absence of text in these fields determines whether a message will be displayed.
7. Use blank spaces, not zeros, to clear the password, password phrase or message line fields.
8. Passwords and Password Phrases are passed to this exit either encrypted or unencrypted depending on the setting of the field titled "Keep Pswds Encrypted" on the TEN0090 System Options Table Detail Panel.

When a site uses the TEN1003 signon panel (Set by the "Default LOGO" parameter on the TEN0108 System Options Table Detail Panel.) then users can sign on to TPX with either a password or password phrase depending on how the userid has been defined by security.

Password Phrases generally are passed to this exit in the following format:

The Signon data (4) call to TPXUSNSF can receive a password phrase that is not prefixed by X’FF’ (password phrase control block ID) and a 1 byte lenth field. It occurs when the parameter "Keep Pswds Encrypted" is set to "N". These calls to TPXUSNSF occur before TPX has parsed the password or new password variable. When the 100 byte buffer is passed to the exit then the exit must figure out whether it has received a password or a password phrase.