USER-ATTRIBUTES

File 86
Op-Sys BS2000/OSD
Statement FIND
Task Reads the user attributes of the calling user.

If you are the system administrator, you can retrieve the attributes of all users. You may encounter functional restrictions when SECOS is installed.


Common Fields for all Operating Systems

Dictionary Field Name F/L Mu DE Remarks
ERROR-CODE N3      
ERROR-TEXT A58      
NODE N5   D  
NODE-NAME A16   D  
SYSTEM-MESSAGE-CODE A10      
SYSTEM-CODE B2      
USER-ID A8   D  
FUNCTION A8   D  
SEVER A3   D  
PASSWORD A8   D  
PASSWORD-MODS A3   D  
MAX-ACC-REC A5   D  
CSTMP-MACRO A3   D  
PUBLIC-SPACE N8   D  
RESIDENT-PAGES N5   D  
MAX-PUBLIC-SPACE N8   D  
ENFORCE A3   D  
AUDIT A3   D  
TP-IGNORE A4   D  
DEFAULT-PUBSET A4   D  
TEST-PRIVILEGE A3   D  
COMMANDS-FILE-NAME A54   D  
MAIL-ADDRESS A64   D  
ACCOUNT-NUMBER A8   D  
MAX-CPU-TIME N5   D  
NO-TIME-LIMIT A3   D  
EXPRESS A3   D  
PRIORITY N3   D  
TTYPL A3   D  
INHIBIT-DEACTIVATION A3   D  
CLASS N3   D  
USER-PRIVILEGE A4   D  
MAX-OUTPUT-LINES A8   D  
MAX-INPUT-CARDS A8   D  
USER-ADDRESS-SPACE N5   D  
USERID-PUBSET A4   D  

Relevant Error Codes

Code Text BS2000/OSD
530 Access denied by Security Facility X
733 User ID does not exist X
749 PVS (CATID) not available X
771 No information found X
799 Entire System Server internal error. X

Field Descriptions

Field Name Type/Length Operating System
ACCOUNT-NUMBER (A8)  

Account number for user ID. If more than one account number exists, it is necessary to have a processing loop in Natural to get them all.

Field Name Type/Length Operating System
AUDIT (A3)  

Possible options:

Option Explanation
NO  User is not authorized.
YES  User can specify for the files of his user ID that access to them must be supervised by the system.
Field Name Type/Length Operating System
CLASS (N3)  

SPOOLOUT class (0-255) for the user's account number.

Field Name Type/Length Operating System
COMMANDS-FILE-NAME (A54)  

Name of group syntax file or profile for SDF.

Field Name Type/Length Operating System
CSTMP-MACRO (A3)  

Specifies whether the CSTMP macro (define memory pool as read only) can be used. Possible options:

Option Explanation
NO  CSTMP macro not allowed.
YES  CSTMP macro can be used (define memory pool as read only).
Field Name Type/Length Operating System
DEFAULT-PUBSET (A4)  

Default pubset assigned for user. This is used for allocation of files when no pubset is specified.

Field Name Type/Length Operating System
ENFORCE (A3)  

Possible options:

Option Explanation
NO  User is not authorized.
YES  User can force usage of PAM pages although the limit specified in MAX-PUBLIC-SPACE has already been reached for the user ID.
Field Name Type/Length Operating System
EXPRESS (A3)  

Specifies whether the user can start batch jobs under the specified account number immediately, even though the limit for running jobs of the job classes assigned to the user has been reached. Possible options:

Option Explanation
NO  The user is not authorized.
YES  The user is authorized.
Field Name Type/Length Operating System
FUNCTION (A8)  

Possible options:

Option Explanation
READ  Default. Read information for user ID.
READNXT  Read information for user following entry for user ID in TSOSJOIN (only allowed for TSOS).
Field Name Type/Length Operating System
INHIBIT-DEACTIVATION (A3)  

Possible options:

Option Explanation
NO  Tasks can be deactivated by user.
YES  Prohibit deactivation of tasks of this account number.
Field Name Type/Length Operating System
MAIL-ADDRESS (A64)  

Mail address for output listings.

Field Name Type/Length Operating System
MAX-ACC-REC (A5)  

Maximum number of accounting records which can be written by a job or program. Possible values:

Value Explanation
n  Maximum number, 0-32767.
NL  There is no limit.
Field Name Type/Length Operating System
MAX-CPU-TIME (N5)  

Maximum CPU time in seconds available for this account number (1-65535) The default is 65535.

Field Name Type/Length Operating System
MAX-INPUT-CARDS (A8)  

Maximum number of SYSOPT cards allowed for tasks of this user, or NO LIMIT, if the number is not restricted.

Field Name Type/Length Operating System
MAX-OUTPUT-LINES (A8)  

Maximum number of SYSLST lines allowed for tasks of this user, or NO LIMIT, if the number is not restricted.,

Field Name Type/Length Operating System
MAX-PUBLIC-SPACE (N8)  

Maximum number of PAM pages of public space which can be occupied by this user.

Field Name Type/Length Operating System
NO-TIME-LIMIT (A3)  

Specifies whether the user is allowed to specify TIME=NTL for batch jobs under this account number. Possible options:

Option Explanation
NO  The user is not authorized.
YES  The user is authorized.
Field Name Type/Length Operating System
PASSWORD (A8)  

Possible options:

Option Explanation
NO  No password.
YES  User ID is password-protected.
Field Name Type/Length Operating System
PASSWORD-MODS (A3)  

Specifies whether the user can change or delete his password. Possible values:

Value Explanation
NO  User cannot change or delete his/her password.
YES  User can delete his password.
Field Name Type/Length Operating System
PRIORITY (N3)  

Default job priority for this account number.

Field Name Type/Length Operating System
PUBLIC-SPACE (N8)  

Number of PAM pages used on public space for this user ID.

Field Name Type/Length Operating System
RESIDENT-PAGES (N5)  

Number of resident pages of real memory available for use (maximum is 32767).

Field Name Type/Length Operating System
SEVER (A3)  

Possible values:

Value Explanation
NO  Not severed.
YES  User ID severed.
Field Name Type/Length Operating System
TEST-PRIVILEGE (A3)  

Defines whether user can change the privilege level for use of the software product AID. Possible options:

Option Explanation
NO  The user can change the authorization at will.
YES  The user can change the authorization only with the operator's permission.
Field Name Type/Length Operating System
TP-IGNORE (A4)  

States whether the operator can ignore tape label checks for the user. Possible options:

Option Explanation
NO  Default. Error messages cannot be ignored.
ALL  All error messages are ignored.
BLP  For tapes processed in INPUT or REVERSE mode, no label checking is performed.
READ  Messages for input files can be ignored.
YES  Can only be ignored by the tape owner or TSOS.
Field Name Type/Length Operating System
TTYPL (A3)  

Allowed category where tasks for this user and account number are grouped. Possible options:

Option Explanation
STD  BATCH and DIALOG type tasks are allowed.
SYS  All task types are allowed.
TP  BATCH, DIALOG and TP are allowed.
Field Name Type/Length Operating System
USER-ADDRESS-SPACE (N5)  

Size of address space for tasks of this user in MB.

Field Name Type/Length Operating System
USER-ID (A8)  

Identification of user, whose information is to be read. The default is your own user ID. To read information on other users, your user ID must be TSOS.

Field Name Type/Length Operating System
USERID-PUBSET (A4)  

ID of pubset from which user attributes are to be read.

Field Name Type/Length Operating System
USER-PRIVILEGE (A4)  

Specifies whether the user is TSOS-authorized or not. Possible options:

Option Explanation
USER  Normal user.
TSOS  The user is authorized.