GetIdentity

This procedure returns the following information:

The user ID of the MVS™ user
The host machine name
The network domain name
The user ID of the TCP/IP address space

The host machine name and domain name are extracted from the HostName and DomainOrigin statements, respectively, in TCPIP.DATA. If a HostName statement is not specified, then the default host machine name is the name specified by the TCP/IP installer during installation (the name from the line containing the definition, VMCF,MVPXSSI,nodename, in the IEFSSNxx member of PARMLIB). The TCP/IP address space user ID is extracted from the TcpipUserid/TcpipJobname statement in TCPIP.DATA; if the statement is not specified, the default is TCPIP. See z/OS Communications Server: IP Configuration Reference for information about TCPIP.DATA search order.

Figure 1 shows the GetIdentity procedure.

Figure 1. GetIdentity example

   procedure GetIdentity
            (
        var    UserId:  DirectoryNameType;
        var    HostName, DomainName: String;
        var    TcpIpServiceName: DirectoryNameType;
        var    Result: integer
            );
            external;

Parameter: Description
UserId: The user ID of the TSO user or the job name of a batch job that has invoked GetIdentity.
HostName: The host machine name.
DomainName: The network domain name.
TcpIpServiceName: The user ID of the TCP/IP address space.
Result: Indicates success or failure of the call.