xcall MIAMEX, MX_SETUSRNAM, usrnam$

MX_SETUSRNAM overrides the user name using the syntax:

Normally the user name is retrieved from the operating system when needed. In most cases, that is best. However, there are two cases where it might not be:

• If, for some unfathomable reason you allow all users to login to the operating system with a common user login name, then displaying or retrieving that name in utilities such as SYSTAT (or the ashlog.log) isn't very useful. Usually, the excuse for allowing users to share an operating system login name is that you have a separate login process for the application. If this is the case, then you can now use MX_SETUSRNAM so that the application user name replaces the original operating system login name in SYSTAT and other A-Shell purposes.

• In the case of ATSD, you don't have any control over the operating system login name on the server, although as of this edit, that is now being over-ridden automatically by the username used to initiate the ATE client.

Notes

Over-riding the user name does not fool the operating system. It only affects A-Shell routines that would otherwise retrieve or use the login name.

To reset the user name (back to the original), you can xcall MX_SETUSRNAM with USRNAM$ argument of "".