WHO

Syntax

       U16   I32         I32        CA        CA         CA
  WHO (mode, capability, localattr, username, groupname, acctname,
  
    CA        U16
    homename, term);

Parameters

mode

16-bit unsigned integer by reference (optional)

Returns the current user's access mode. In this half word, the bits have the following meanings:

Bits

Value/Meaning

15:1

0

The job/session input file and job/session list file are not interactive.

1

The job/session input file and job/session list file form an interactive pair. A person responding through the input device can establish a dialog with a program that displays information on the list device.

14:1

0

The job/session input file and job/session list file are not duplicative.

1

The job/session input file and job/session list file form a duplicative pair. Images on the input device are duplicated automatically on the list device.

12:1

00

Not used.

01

The user is accessing the system through a session.

10

The user is accessing the system through a job.

11

Not used.

0:12

Reserved for the operating system

capability

32-bit signed integer by reference (optional)

Returns the user's file access attributes, user attributes, and capability class attributes if the appropriate bit = 1. The high-order half word indicates file access attributes and user attributes; the low-order half word indicates possession of capability-class attributes. The significance of these bits is as follows:

Bits

Value/Meaning

0:1

System manager (SM)

1:1

Account manager (AM)

2:1

Account librarian (AL)

3:1

Group librarian (GL)

4:1

Diagnostician (DI)

5:1

System supervisor (OP)

6:1

Volume set creation (CV)

7:1

Volume set usage (UV)

8:1

User logging (LG)

9:4

Reserved for the operating system

13:1

Communications system (CS)

14:1

Nonshareable devices (ND)

15:1

Save files (SF)

16:7

Reserved for the operating system

23:1

Batch access (BA)

24:1

Interactive access (IA)

25:1

Privileged mode (PM)

26:2

Reserved for the operating system

28:1

Multiple RINs (MR)

29:1

Reserved for the operating system

30:1

Extra data segments (DS)

31:1

Process handling (PH)

localattr

32-bit signed integer by reference (optional)

Returns the local attributes of the user, as defined by a user with the account manager attribute.

username

character array (optional)

Returns the user's name in an 8-character array.

groupname

character array (optional)

Returns the name of the user's logon group in an 8-character array.

acctname

character array (optional)

Returns the name of the user's logon account in an 8-character array.

homename

character array (optional)

Returns the name of the user's home group in an 8-character array. If a home group is not assigned, this array is filled with blanks.

term

16-bit unsigned integer by reference (optional)

Returns the logical device number of the job/session input device. If this is a spooled (STREAM) batch job, then the logical device number is the virtual device.

A virtual device simulates a spooling device. Users cannot own the actual spooling device, so the virtual device allows users access to spooling. Each virtual device is temporarily assigned a logical device number for the duration of the input or output spooling process. Since the same logical device number can be reassigned to another virtual device with different physical characteristics, such as page length, the virtual device is not permanently configured in the system configuration. You can also obtain the logical device number of the virtual device with FFILEINFO.

Related Information