HP 3000 Manuals

WHO [ MPE/iX Intrinsics Reference Manual ] MPE/iX 5.0 Documentation


MPE/iX Intrinsics Reference Manual

WHO 

NM and CM callable.

Returns the access mode and attributes of the user calling the intrinsic.

Syntax 
______________________________________________
|                                            |
|          U16   I32     I32     CA          |
|     WHO(mode,capability,localattr,username,|
|             CA      CA       CA     U16    |
|         groupname,acctname,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:2       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 

Intrinsics            None

Commands              None

Manuals               Getting System Information Programmer's Guide 
                      (32650-90018) and Point-to-Point Workstation I/O 
                      Reference Manual (30000-90250).



MPE/iX 5.0 Documentation