NSM-MS File and Element Definitions

The following files are used by application NSM-MS, Natural Secured Menus - Maintenance Sys.

The Predict Data Dictionary definitions for these files and their associated data elements are shown in the following tables.

APPLICATION

Application information used by the Natural Secured Menus Architecture and managed by the NSM Maintenance System.

Element definitions for file: APPLICATION (U-51)
Typ Lvl Field name Fmt Len CO Index Definition
  1 APPLICATION-ID
DB=AA CS=UA
HD=/ID
A 8.0 N U An identifier of a Natural
application and/or library
name. Used to group related
programs and operational
functions designed to address
a specific need. Functions
within an application also
share common security features
and administration.
  1 APPLICATION-NAME
DB=AB CS=NS
HD=Application Name
A 40.0 N   Descriptive name of a Natural
application. This field is
maintained in mixed case.
  1 NSM-APPLICATION
DB=AO CS=NS
HD=/App
L   N   A flag which identifies an
application as an NSM
application if it is TRUE or
not an NSM application when
FALSE.
  1 NATURAL-LIBRARY
DB=AP CS=NS
HD=/Library
A 8.0 N   The physical library from
which the logical application
is executed. This is the
library which must be logged
onto with the Natural LOGON
command.
  1 MAIN-MENU-COMMAND-ID
DB=AC CS=NS
HD=/Command
A 4.0 N   The COMMAND-ID for the main
menu of a Natural application
which utilizes the Natural
Secured Menus Architecture
(NSM-A). This command is
automatically invoked for a
user entering the applica-
tion.
  1 APPLICATION-PREFIXES
DB=AD CS=NS
HD=/Prefix
A 4.0 N   Two two character prefixes
used to define the
application area prefix used
to construct program names
and the Predict 'fields'
file name for an application.
SB 1 APPLICATION-PREFIX
DB=GD CS=NS
HD=/Pre
A 2.0 N   The two character prefix used
to identify objects associated
with the application via this
application area abbreviation.
SB 1 AA-FIELDS-PREFIX
DB=GE CS=NS
HD=/Pre
A 2.0 N   The two character application
area designation which is used
to identify the conceptual
file used to define the data
elements associated with an
application, e.g. aa-FIELDS.
If this value is blank, the
APPLICATION-PREFIX is used for
this purpose. These prefixes
are used by the online help
facilities to construct the
file name where element
definitions can be found
within Predict.
  1 APPLICATION-LOCK
DB=AE CS=NS
HD=/Lock
A 1.0 N   A flag indicating whether the
application is available for
use or not. Values are:
  L = Locked and unavailable
  U = Unlocked and available
  1 DATE-NOTICE
DB=AF CS=NS
HD=/Date
D   N   The date that the current
application notice is to be
effective and available (may
be a future date or blank if
there is no notice, Natural
date format). This date may be
entered in a number of formats
and will be converted to
display MM/DD/YYYY.
MU 1 NOTICE
DB=AG CS=UA Max Occ=15
HD=Notice
A 72.0 N   Notices which are available
for broadcast to all appli-
cation users, keyed by the
date of the notice and the
user's date of last logon.
A total of 15 lines per
notice is the maximum
allowed. This field is
maintained in mixed case.
MU 1 APPLICATION-OWNER-DESK-ID
DB=AH CS=NS Max Occ=5
HD=/Owner
A 8.0 N   A list of the DESK-IDs assign-
ed administrative management
responsibilities for the
Natural application. A maxi-
mum of 5 owners has been
arbitrarily established. The
first owner specified will be
identified in messages as the
contact person for the appli-
cation.
SP 1 OWNER-APPLICATION
DB=AI CS=*
HD=Owner-Application
A 16.0 N D The super descriptor composed
of APPLICATION-OWNER-DESK-ID &
APPLICATION-ID used to identi-
fy the applications whose
security is administered by
a specific desk.
MU 1 APPLICATION-ANALYST-USER-ID
DB=AZ CS=NS Max Occ=5
HD=Analyst
A 8.0 N   A list of analysts or support
personnel that are responsible
for the application, defined
by the analysts' Natural user
ID. A maximum of 5 analysts
will be maintained. The first
analyst identified will be
considered the primary contact
and may be referenced within
system messages.
SP 1 ANALYST-APPLICATION
DB=GA CS=*
HD=Analyst - Appl.
A 16.0 N D The super descriptor composed
of APPLICATION-ANALYST-USER-ID
and APPLICATION-ID used to
identify applications an
analysts is assigned support
responsibilities.
  1 NAME-OF-VS-MAINTENANCE-PGM
DB=AJ CS=NS
HD=/Program
A 8.0 N   The name of the program which
performs value security maint-
enance for this application.
The maintenance program is
located in the NSM applica-
tion. A value of blank in
this field indicates that the
application does not utilize
value security.
  1 VALID-SECURITY-LEVELS
DB=AK CS=NS
HD=/Levels
A 15.0 N   The valid values for "security
level" for an application, or
blank, if the application does
not utilize security levels.
The fields AU-SECURITY-LEVEL
and the last position of
COMMAND-ID-SECURITY-LEVEL are
edited against this list.
A maximum of 15 security
levels has been arbitrarily
established.
MU 1 SECURITY-LEVEL-COMMENTS
DB=AL CS=NS
HD=Security Level Comments
A 32.0 N   This field contains comments
on how the Security Level
field is utilized within an
application. It is displayed
by the HELP facility during
Application-User or Command-
Security-Group maintenance.
Security levels should be
noted one per line followed
by an '=' and a description.
This field is maintained in
mixed case.
MU 1 REASON-APPLICATION-LOCKED
DB=AM CS=NS
HD=Reason for Application Lock
A 50.0 N   An explanation for why an
application has been locked
and is unavailable. This
message will be displayed to
user's who attempt to access
the application while it is
locked. This message is
restricted to 5 lines and is
maintained in mixed case.
MU 1 REASON-CSG-LOCKED
DB=AN CS=NS
HD=/Security Group Lock
A 50.0 N   An explanation of why this
application has been locked
from use by selected command
security groups. This message
will be displayed when a user
of a selected group attempts
to access the application.
This message is restricted to
5 lines and is maintained in
mixed case.
PE 1 ACTION-LIST
DB=AQ CS=* Max Occ=10
HD=/List
        A list of ACTION codes used by
an application along with data
and other parameters
associated with the action.
A maximum of 10 actions are
maintained in this list.
  2 ACTION
DB=AR CS=NS
HD=Act
PE=ACTION-LIST
A 1.0 N   A code used to identify the
action to be performed within
a given function. The action
codes should be used uniformly
throughout an application.
Standard values include but
may not be limited to:
V = View (inquire only)
A = Add (create a new entity)
U = Update (change data)
C = Copy (reuse the same data)
D = Delete (remove an entity)
R = Review (act on TARGET txn)
S = Submit (initate a process)
F = Fix (chg historical data)
X = Cancel (delete historical)
  2 ACTION-DESC
DB=AS CS=NS
HD=Action desc.
PE=ACTION-LIST
A 16.0 N   A description of the
associated action code.
  2 MINIMUM-SECURITY-LEVEL
DB=AT CS=NS
HD=/SL
PE=ACTION-LIST
A 1.0 N   The minimum SECURITY-LEVEL
value that may be defined for
a user/command and still
permit execution of the
associated action.
  2 PROTECT-UPD-FIELDS
DB=AU CS=NS
HD=/Flds
PE=ACTION-LIST
L   N   A flag indicating that for the
associated ACTION, the update
fields within the body of the
screen are to be protected
from entry. This flag should
be TRUE for View or Delete
and FALSE for Update or Add.
  1 DEFAULT-ACCESS-PERMITTED
DB=GB CS=NS
L   N   An indicator of whether an
application may be accessed
by a user without explicit
approval. Possible values
are:
Y = Yes, the application may
    be accessed by anyone
    with an ID.
N = No, the application may
    not be accessed unless the
    administrator has provided
    explicit approval via a
    definition in the
    APPLICATION-DESK file.
  1 DEFAULT-COMMAND-SECURITY-GROUP
DB=CE CS=NS
HD=/Group
A 8.0 N   The default command security
group to be associated with a
user permitted default access
to an application.
  1 DEFAULT-VALUE-SECURITY-GROUP
DB=CI CS=NS
HD=/Group
A 8.0 N   The default value security
group to be associated with a
user permitted default access
to an application.
  1 DEFAULT-SECURITY-LEVEL
DB=CG CS=NS
HD=/Lvl
A 1.0 N   The security level to be
associated with a user who is
provided 'default' access to
an application.
SP 1 DEFAULT-ACCESS-APPLICATION
DB=GC CS=*
A 9.0 N D The Adabas super-descriptor
composed of the fields
DEFAULT-ACCESS-PERMITTED and
APPLICATION-ID. Used to list
applications which permit a
default level of access
(explicit access does not
have to be defined).
  1 DATE-OF-ENTRY
DB=A3 CS=UA
HD=/Entered
D   N   Date that a record was first
added to a file in NATURAL
date format.
  1 DATE-OF-UPDATE
DB=A0 CS=UA
HD=/Update
D   F   Date a record was last updated
in Natural's date format.
  1 UPDATED-BY-USER
DB=A2 CS=UA
HD=/ By
A 8.0 N   The Natural user ID (USER-ID)
of the last user to update a
record or associated item.
  1 TIME-STAMP
DB=A1 CS=UA
HD=Time Stamp
B 8.0 F   This field is used to uniquely
identify each update to a
record. Each time a record is
updated, this field should be
assigned the value of the
Natural function *TIMESTMP.
Programs should check to see
if this field has changed from
the time they first read a
record until the the time they
read the record with hold.
This will determine if someone
else has altered the record.

APPLICATION-DESK

Information about the desks which are allowed access to an application and what privileges or restrictions apply to that access. Users are associated with desks, which then determines the type of access. The Application - Desk definitions are a critical part of NSM security.

Element definitions for file: APPLICATION-DESK (U-51)
Typ Lvl Field name Fmt Len CO Index Definition
  1 APPLICATION-ID
DB=CA CS=UA
HD=/ID
A 8.0 N   An identifier of a Natural
application and/or library
name. Used to group related
programs and operational
functions designed to address
a specific need. Functions
within an application also
share common security features
and administration.
  1 DESK-ID
DB=CB CS=UA
HD=/ID
A 8.0 N   A unique identifier for a desk
which represents a job or a
specific area of
responsibility as related to
the use of automated computer
systems.
SP 1 DESK-APPLICATION
DB=CC CS=*
HD=Desk - Appl
A 16.0 N D The super descriptor composed
of DESK-ID and APPLICATION-ID.
This index is used to identify
those desks which have been
defined with explicit access
to an application.
SP 1 APPLICATION-DESK
DB=CD CS=*
HD=Appl. - Desk
A 16.0 N D The super descriptor composed
of APPLICATION-ID and DESK-ID
used to list all desks that
are explicityly permitted
access to an application.
  1 COMMAND-SECURITY-GROUP
DB=CE CS=NS
HD=/Group
A 8.0 N   A code used to group users &
desks according to their
command related security
restrictions.
SP 1 APPLICATION-CSG
DB=CF CS=NS
HD=/Sec Group
A 16.0 N D The super descriptor composed
of APPLICATION-ID and COMMAND-
SECURITY-GROUP used to identi-
fy users of an application and
command security group.
  1 AD-SECURITY-LEVEL
DB=CG CS=NS
HD=/Lvl
A 1.0 N   A code which indicates the
level of security clearance
for a desk within an applica-
tion. The SECURITY-LEVEL-
COMMENT field in the file
APPLICATION contains specific
information about how this
field is utilized within the
application. The field VALID-
SECURITY-LEVELS contains the
possible values for this
application. A value of blank
is required if this applica-
tion does not utilize security
levels.
  1 AD-JOB-SECURITY-CLASS
DB=BI CS=NS
HD=/Classes
A 8.0 N   A list of the one character
job security classes that a
desk is authorized to submit
for an application. All jobs
defined to the JOBS applica-
tion may be classified by a
one character code and users
are only allowed to submit
those jobs when the job's
security class matches one of
the security classes permitted
for the desk assigned to the
user.
  1 VALUE-SECURITY-GROUP
DB=CI CS=NS
HD=/Group
A 8.0 N   A code used to group users &
desks according to their value
related security restrictions.
This field will be blank if
an application does not
utilize value security.
SP 1 APPLICATION-VSG
DB=CK CS=NS
HD=/Group
A 16.0 N D The super descriptor composed
of APPLICATION-ID and VALUE-
SECURITY-GROUP used to identi-
fy users of an application and
value security group.
  1 DATE-OF-ENTRY
DB=A3 CS=UA
HD=/Entered
D   N   Date that a record was first
added to a file in NATURAL
date format.
  1 DATE-OF-UPDATE
DB=A0 CS=UA
HD=/Update
D   F   Date a record was last updated
in Natural's date format.
  1 UPDATED-BY-USER
DB=A2 CS=UA
HD=/ By
A 8.0 N   The Natural user ID (USER-ID)
of the last user to update a
record or associated item.
  1 TIME-STAMP
DB=A1 CS=UA
HD=Time Stamp
B 8.0 F   This field is used to uniquely
identify each update to a
record. Each time a record is
updated, this field should be
assigned the value of the
Natural function *TIMESTMP.
Programs should check to see
if this field has changed from
the time they first read a
record until the the time they
read the record with hold.
This will determine if someone
else has altered the record.

APPLICATION-USER

Information about application users. Entries here provide attributes unique to a user of an application. This data is not critical to the operation of an NSM application.

Element definitions for file: APPLICATION-USER (U-51)
Typ Lvl Field name Fmt Len CO Index Definition
  1 APPLICATION-ID
DB=HA CS=UA
A 8.0 N   An identifier of a Natural
application and/or library
name. Used to group related
programs and operational
functions designed to address
a specific need. Functions
within an application also
share common security features
and administration.
  1 USER-ID
DB=HB CS=UA
A 8.0 N   The unique identifier assigned
to users of Natural. Online
users are auto logged into
Natural from CICS, so their ID
is the same as that assigned
by CICS (a three character
code). The USER-ID must be
defined to Natural Security.
SP 1 APPLICATION-USER
DB=H1 CS=NS
A 16.0 N U The super descriptor composed
of APPLICATION-ID and USER-ID
for accessing all users of an
application.
  1 DATE-LAST-LOGON
DB=CH CS=NS
HD=/Date
D   N   Date that a user last logged
onto an application. Used as
an audit trail of activity
and to determine when to
display the welcome screen and
notices which may be posted
for the application.

COMMAND-SECURITY

Information about an application command security group. These entries define the commands that may be allowed or disallowed for the users of a command security group. This data is required by the Natural Secured Menus Architecture and is managed by the NSM Maintenance System.

Element definitions for file: COMMAND-SECURITY (U-51)
Typ Lvl Field name Fmt Len CO Index Definition
  1 APPLICATION-ID
DB=DA CS=UA
HD=/ID
A 8.0 N   An identifier of a Natural
application and/or library
name. Used to group related
programs and operational
functions designed to address
a specific need. Functions
within an application also
share common security features
and administration.
  1 COMMAND-SECURITY-GROUP
DB=DB CS=NS
HD=/Group
A 8.0 N   A code used to group users &
desks according to their
command related security
restrictions.
SP 1 APPLICATION-COMMAND-SEC-GROUP
DB=DC CS=NS
HD=/Sec Group
A 16.0 N D The super descriptor composed
of APPLICATION-ID and COMMAND-
SECURITY-GROUP used to access
the security restrictions
for the application and
security group.
  1 COMMAND-SECURITY-GROUP-DESC
DB=DD CS=NS
HD=/Description
A 50.0 N   The description for a command
security group. Used to help
identify the purpose or intent
of the security group. This
field is maintained in mixed
case.
  1 COMMANDS-ALLOWED-DISALLOWED
DB=DE CS=NS
HD=/Dis-all
A 1.0 N   A code indicating how the list
of commands associated with a
command security group are to
be interpreted.
Values are:
A = Allow the listed commands
    with the lower security
    level when specified
D = Disallow the listed
    commands
S = Allow all commands not
    listed with the 'view'
    security level, disallow
    commands listed with '-'
    security level, and allow
    all others as Specified
MU 1 COMMAND-ID-SECURITY-LEVEL
DB=DF CS=NS
HD=/Sec Level
A 5.0 N   The COMMAND-IDs that are
allowed or disallowed for the
associated COMMAND-SECURITY-
GROUP plus an optional code
indicatig additional security
level restrictions that are to
be applied for this command to
users of this group. The
format of this field is XXXXZ
where XXXX is the COMMAND-ID &
Z is the security level. The
lower value, Z or AU-SECURITY-
LEVEL, is used for this cmd.
This list of commands + secur-
ity levels has been arbitra-
rily restricted to 100 values.
  1 COMMAND-GROUP-LOCK
DB=DG CS=NS
HD=/Lock
A 1.0 N   A flag indicating whether
users in this command security
group are allowed access to
this application. This can
be used to temporarily lock
users out of the application,
however it is only checked at
the time the user signs onto
the application. Values are:
  L = Locked and unavailable
  U = Unlocked and available
  1 DATE-OF-ENTRY
DB=A3 CS=UA
HD=/Entered
D   N   Date that a record was first
added to a file in NATURAL
date format.
  1 DATE-OF-UPDATE
DB=A0 CS=UA
HD=/Update
D   F   Date a record was last updated
in Natural's date format.
  1 UPDATED-BY-USER
DB=A2 CS=UA
HD=/ By
A 8.0 N   The Natural user ID (USER-ID)
of the last user to update a
record or associated item.
  1 TIME-STAMP
DB=A1 CS=UA
HD=Time Stamp
B 8.0 F   This field is used to uniquely
identify each update to a
record. Each time a record is
updated, this field should be
assigned the value of the
Natural function *TIMESTMP.
Programs should check to see
if this field has changed from
the time they first read a
record until the the time they
read the record with hold.
This will determine if someone
else has altered the record.

DESK

An entity used for NSM security and TARGET transaction routing definitions. Desks are defined where ever there is a job with responsibilities that include access to an NSM application. Individuals are assigned to desks and via this relationship provided access to NSM systems.

Element definitions for file: DESK (U-51)
Typ Lvl Field name Fmt Len CO Index Definition
  1 DESK-ID
DB=BG CS=UA
HD=/Library
A 8.0 N U A unique identifier for a desk
which represents a job or a
specific area of
responsibility as related to
the use of automated computer
systems.
  1 DESK-NAME
DB=AB CS=NS
HD=Desk Name
A 40.0 N   Short but descriptive name
which can be used to identify
a specific desk when viewing
lists or selecting IDs from
a list. This field is
maintained in mixed case.
  1 BUDGETARY-UNIT-NO
DB=BC CS=UA
HD=/Unit
N 4.0 N   Unique numeric identifier for
a UAF budgetary unit. A
budgetary unit is an
organizational entity that
either receives a budget or
has staff. It exists between
the company-cost center and
the department levels. All
cost centers are associated
with a budgetary unit, all
budgetary units are associated
with a department.
SP 1 BUDGETARY-UNIT-DESK
DB=BE CS=*
A 12.0 N D The Adabas super-descriptor
composed of BUDGETARY-UNIT-NO
and DESK-ID. This index is
used to list desks in
sequence of the budgetary unit
for which they were created.
MU 1 DESK-DESC
DB=AG CS=NS Max Occ=10
HD=Desk Description
A 72.0 N   A narrative which describes
the administrative
responsibilities associated
with a desk or job function.
Specifically information is
maintained to assist in the
determination of computer
system access privileges and
requirements for electronic
transaction approval. This
field is maintained in mixed
case.
  1 DATE-OF-UPDATE
DB=A0 CS=UA
HD=/Update
D   F   Date a record was last updated
in Natural's date format.
  1 TIME-STAMP
DB=A1 CS=UA
HD=Time Stamp
B 8.0 F   This field is used to uniquely
identify each update to a
record. Each time a record is
updated, this field should be
assigned the value of the
Natural function *TIMESTMP.
Programs should check to see
if this field has changed from
the time they first read a
record until the the time they
read the record with hold.
This will determine if someone
else has altered the record.
  1 UPDATED-BY-USER
DB=A2 CS=UA
HD=/ By
A 8.0 N   The Natural user ID (USER-ID)
of the last user to update a
record or associated item.
  1 DATE-OF-ENTRY
DB=A3 CS=UA
HD=/Entered
D   N   Date that a record was first
added to a file in NATURAL
date format.

DESK-ASSIGNMENT

Contains the time stamped record of desk assignments, either associated with a PSB Position (for regular IDs assigned to appointed employees) or a User ID (for temporary IDs, hourly employees, or non University employees). This record is checked at signon to determine the Desk-ID to be assigned to a user during their online session. Two desks are permitted for a position so it might serve two job functions on an interim basis.

Element definitions for file: DESK-ASSIGNMENT (U-112)
Typ Lvl Field name Fmt Len CO Index Definition
** Assignment Identifiers
  1 DESK-ASSIGNMENT-TYPE
DB=AA CS=NS
A 1.0 F   Identifies the type of desk
assignment as:
P = Position, this assignment
    is for a PSB position and
    the Desk-Assignment-ID is
    a position number, or
U = User, this assignment is
    for an hourly employee,
    a temporary User, or a
    non-UA employee and the
    Desk-Assignment-ID is a
    User-ID.
  1 DESK-ASSIGNMENT-ID
DB=AB CS=NS
A 8.0 F   The identifier of the entity
for which a desk assignment is
made (as defined by the
associated Desk-Assignment-
Type) as either a Position
number (5 digits left
justified zero filled) or a
User-ID.
  1 TIME-PERIOD-BEGIN
DB=AC CS=UA
HD=Period Begin
T   F   The beginning point in time
of a period of time for which
an entity is effective.
  1 TIME-PERIOD-END
DB=AD CS=UA
HD=Period End
T   F   The ending point in time
of a period of time for which
an entity is effective.
** Assignment Attributes
MU 1 DESK-ID
DB=AE CS=UA Max Occ=2
HD=Desk ID
A 8.0 N   A unique identifier for a desk
which represents a job or a
specific area of
responsibility as related to
the use of automated computer
systems.
** Audit Log and Control
  1 NEAR-CURRENT-OR-FUTURE-CD
DB=AF CS=NS
A 1.0 N   A code of 'Y' identifies
entries which are effective
near the current time or are
effective for a future
period. This value is null
for past records, and is used
in super-descriptors to
suppress the creation of
indexes to those historical
records. This provides more
efficient access to current
and future effective dated
records.
PE 1 AUDIT-LOG-GROUP
DB=AG CS=* Max Occ=2
        The periodic repeating group
used to record audit
information. Occurrences
represent the following
maintenance activity:
1 - Initial creation or update
    other than 'ending' the
    period, or
2 - Ending the period due to
    a change in the record
    effective after this
    period.
  2 TIME-OF-UPDATE
DB=AH CS=UA
HD=/Updated
PE=AUDIT-LOG-GROUP
T   N   Date and time that a record or
associated item was last
updated on the data base.
  2 UPDATED-BY-USER
DB=AI CS=UA
HD=/ By
PE=AUDIT-LOG-GROUP
A 8.0 N   The Natural user ID (USER-ID)
of the last user to update a
record or associated item.
  2 UPDATED-BY-PROGRAM
DB=AJ CS=UA
PE=AUDIT-LOG-GROUP
A 8.0 N   The Natural program name
that updated a record or
associated entity.
  1 TIME-STAMP
DB=AM CS=UA
HD=Time Stamp
B 8.0 F   This field is used to uniquely
identify each update to a
record. Each time a record is
updated, this field should be
assigned the value of the
Natural function *TIMESTMP.
Programs should check to see
if this field has changed from
the time they first read a
record until the the time they
read the record with hold.
This will determine if someone
else has altered the record.
** Super Descriptors
SP 1 TYPE-ID-END-KEY
DB=S1 CS=*
A 16.0   U The super-descriptor composed
of Desk-Assignment-Type,
Desk-Assignment-ID, and
Time-Period-End. This index
is used to uniquely identify
the desk assignment entries
and to retrieve the desk
assignment for a type and ID
as of any point in time.
SP 1 NCOF-DESK-TYPE-ID-END-KEY
DB=S2 CS=*
A 25.0 N D The super-descriptor composed
of Near-Current-or-Future-Cd,
Desk-ID, Desk-Assignment-Type,
Desk-Assignment-ID, and
Time-Period-End. This index
is used to retrieve the
assignments (positions or
user IDs) for a desk for a
point in time.

MENU-COMMAND

The actual menus and control information for applications using the Natural Secured Menus Architecture. One entry is maintained per menu and identified by the application and menu command. This data is managed by the NSM Maintenance System.

Element definitions for file: MENU-COMMAND (U-51)
Typ Lvl Field name Fmt Len CO Index Definition
  1 APPLICATION-ID
DB=FA CS=UA
HD=/ID
A 8.0 N   An identifier of a Natural
application and/or library
name. Used to group related
programs and operational
functions designed to address
a specific need. Functions
within an application also
share common security features
and administration.
  1 MENU-COMMAND-ID
DB=FB CS=NS
HD=/Command
A 4.0 N   The COMMAND-ID for a menu
within an application.
SP 1 APPLICATION-MENU-COMMAND
DB=FC CS=NS
HD=/Command
A 12.0 N D The super descriptor composed
of the APPLICATION-ID and
MENU-COMMAND-ID used for
access to the commands that
will appear on the given
application menu.
  1 MENU-COMMAND-DESCRIPTION
DB=FD CS=NS
HD=Menu Command Description
A 40.0 N   The description for a menu
command (the associated
MENU-COMMAND-ID). This value
is redundant with the field
COMMAND-DESCRIPTION and should
be maintained identically.
The redundancy is required for
system efficiency. This field
is maintained in mixed case.
PE 1 MENU-COMMANDS
DB=FE CS=NS
        The periodic repeating group
which contains the list of
commands which are to appear
on a menu. The menu is
identified by the field
MENU-COMMAND-ID. A maximum of
14 commands are allowed per
menu.
  2 COMMAND-ID
DB=FF CS=NS
HD=/ID
PE=MENU-COMMANDS
A 4.0 N   The COMMAND-IDs which appear
on the menu for a given MENU-
COMMAND-ID. All valid appli-
cation commands should appear
as a COMMAND-ID within this
periodic group.
  2 COMMAND-DESCRIPTION
DB=FG CS=NS
HD=Command Description
PE=MENU-COMMANDS
A 40.0 N    
  2 COMMAND-TYPE
DB=FH CS=NS
HD=/Type
PE=MENU-COMMANDS
A 1.0 N   An identifier for a COMMAND-
ID, distinguishes commands as
menus or function modules
(programs). Values are:
 M = Menus
 F = Function modules residing
    in the application library
 U = Function modules residing
    in the system library and
    named UAOxxxx
  2 REQUIRED-KEY-FIELDS
DB=FI CS=NS
HD=Required Keys
PE=MENU-COMMANDS
A 30.0 N   Key fields which are required
by the associated COMMAND-ID.
Used for display on the menu
and only valid for function
modules. This field is main-
tained in mixed case.
SP 1 APPLICATION-TYPE-COMMAND
DB=FM CS=NS
HD=/Command
A 13.0 N D The super descriptor composed
of the APPLICATION-ID,
COMMAND-TYPE, and COMMAND-ID
used for verification of
commands as function modules
or menus.
SP 1 APPLICATION-COMMAND
DB=FN CS=NS
HD=Appl. - Cmd
A 12.0 N D The super descriptor composed
of the APPLICATION-ID and
COMMAND-ID.
  1 DATE-OF-ENTRY
DB=A3 CS=UA
HD=/Entered
D   N   Date that a record was first
added to a file in NATURAL
date format.
  1 DATE-OF-UPDATE
DB=A0 CS=UA
HD=/Update
D   F   Date a record was last updated
in Natural's date format.
  1 UPDATED-BY-USER
DB=A2 CS=UA
HD=/ By
A 8.0 N   The Natural user ID (USER-ID)
of the last user to update a
record or associated item.
  1 TIME-STAMP
DB=A1 CS=UA
HD=Time Stamp
B 8.0 F   This field is used to uniquely
identify each update to a
record. Each time a record is
updated, this field should be
assigned the value of the
Natural function *TIMESTMP.
Programs should check to see
if this field has changed from
the time they first read a
record until the the time they
read the record with hold.
This will determine if someone
else has altered the record.

USER

Information about users of Natural, separate and external to Natural Security or Predict although all users should be defined to Natural Security. This data is broadly used but was created for the Natural Secured Menus Architecture and is managed by the NSM Maintenance System.

Element definitions for file: USER (U-51)
Typ Lvl Field name Fmt Len CO Index Definition
  1 USER-ID
DB=BA CS=UA
HD=User ID
A 8.0 N U The unique identifier assigned
to users of Natural. Online
users are auto logged into
Natural from CICS, so their ID
is the same as that assigned
by CICS (a three character
code). The USER-ID must be
defined to Natural Security.
  1 USER-STATUS
DB=AE CS=NS
HD=/Sta
A 1.0 N   The status of a Natural User
ID. Possible values are:
A = Active ID for a current
    employee.
T = Temporary ID that has been
    assigned to a supervisor
    to be loaned on an interim
    basis to a transient
    employee or to be loaned
    until a permanent ID can
    be established.
I = An old and inactive ID
    no longer authorized for
    access.
  1 USER-NAME
DB=BB CS=UA
HD=User Name
A 32.0 N   Name of the person assigned
a USER-ID in the format last
name, comma, space, first name
or initial, space, and option-
ally middle name and initial.
For example, 'Smith, John P.'.
This field is maintained in
mixed case.
HY 1 USER-SEARCH-NAME
DB=U1 CS=NS
HD=User Search Name
A 32.0 N D The hyper-descriptor built by
converting the USER-NAME to
upper case, used in name
searches.
  1 BUDGETARY-UNIT-NO
DB=BC CS=UA
HD=/Unit
N 4.0 N   Unique numeric identifier for
a UAF budgetary unit. A
budgetary unit is an
organizational entity that
either receives a budget or
has staff. It exists between
the company-cost center and
the department levels. All
cost centers are associated
with a budgetary unit, all
budgetary units are associated
with a department.
SP 1 STATUS-BUDGETARY-UNIT-USER
DB=B3 CS=*
A 13.0 N D The super-descriptor composed
of USER-STATUS,
BUDGETARY-UNIT-NO, and
USER-ID. This index is used
to retrieve IDs in a given
status for a given budgetary
unit.
MU 1 USER-DESK-ID
DB=AH CS=* Max Occ=2
HD=/Desk ID
A 8.0 N    
SP 1 USER-DESK-USER
DB=B1 CS=*
A 16.0 N D The super-descriptor composed
of USER-DESK-ID and USER-ID.
This index is used to
retrieve users by the desks
to which they are assigned.
  1 USER-SSN
DB=BF CS=NS
HD=User SSN
P 9.0 N   The user's social security
number (when available).
This also serves as the USER
ID for batch job accounting.
SP 1 USER-SSN-STATUS
DB=B2 CS=*
A 6.0 N D The super-descriptor composed
of USER-SSN and USER-STATUS.
This is index is used to
retrieve IDs that have been
assigned to a specific
individual.
  1 USER-CMS-NODE
DB=BJ CS=NS
HD=/ Node
A 8.0 N   The node or system ID where
the USER-CMS-ID is located.
Blank if the user does not
have a CMS ID or it is not
known.
  1 USER-CMS-ID
DB=BK CS=NS
HD=/ ID
A 8.0 N   The user's CMS ID that exists
on the USER-CMS-NODE. Blank
if the user does not have a
CMS ID or it is not known.
  1 USER-MAIL-BLDG
DB=BL CS=NS
HD=Bldg
A 4.0 N   The mailing service building
code identifying the location
where the user has specified
s/he prefers to have campus
mail delivered. A blank value
indicates that the depart-
ment's mailing address should
be used.
  1 USER-MAIL-ROOM
DB=BM CS=NS
HD=Room
A 4.0 N   The mailing service room
number where the user has
indicated s/he prefers to have
campus mail delivered. A
blank value indicates that
the department's mailing
address should be used.
  1 USER-DEFAULT-APPLICATION
DB=BN CS=NS
HD=/Application
A 8.0 N   The Natural application that
the user prefers to be logged
into automatically at Natural
sign on or blank if the user
prefers to select the
application on the LOGON
screen.
  1 USER-CASE
DB=BO CS=NS
HD=/Case
A 1.0 N   The default case translation
option desired by the user:
L = accept & retain Lowercase
    characters on input
U = Translate all lowercase
    input to Uppercase
Note that NSM applications
will set this translation
option automatically when the
application is accessed. This
default value is set by the
LOGON application, but may be
altered by the user or other
programs.
  1 USER-PRINT-DEST
DB=BP CS=NS
HD=/Destination
A 17.0 N   The default destination for
user generated hardcopy
output. At this time the only
valid values are RSCS remote
printer IDs or the user's CMS
ID in the format 'node,id'.
  1 USER-TERMINAL-TYPE
DB=BQ CS=NS
HD=/ Type
A 4.0 N   The user's desired terminal
device type setting which is
automatically established at
Natural sign on. The possible
values are:
  3270 = Basic functionality
  3278 = Extended attributes
  3279 = Color support
  1 USER-MESSAGE-LINE
DB=BR CS=NS
HD=/Loc
A 1.0 N   The user's desired location of
the Natural message line,
which is automatically
established at Natural signon:
  T = Top line of the screen
  B = Bottom line
  1 USER-MESSAGE-COLOR
DB=BS CS=NS
HD=/Color
A 2.0 N   The user's desired color for
the Natural message line,
which is automatically
established at Natural sign
on. This value is one of the
standard Natural color codes
or blank if Natural's default
color is to be used.
  1 USER-PF-KEY-FORMAT
DB=BT CS=NS
HD=/Format
A 1.0 N   The user's desired PF Key line
format which is automatically
established at Natural sign
on. Possible values are:
N = Normal, PF key numbers
    located above definitions
S = SAA format: 'PFnn-value'
P = PC format: 'Fnn-value'
  1 USER-PF-KEY-COLORS
DB=BU CS=NS
HD=/Colors
A 4.0 N   The user's desired PF Key
colors which are automatically
established at Natural sign
on. Two Natural color code
values may be maintained, the
first for the key name (PF1)
and the second for the
associated function name
(Help). A blank value
indicates the system default
colors are to be used.
  1 USER-FIELD-COLORS
DB=BV CS=NS
HD=/ Colors
A 16.0 N   The user's desired field
colors which are automatically
established at Natural sign
on. Seven Natural color codes
(or blank for system defaults)
are maintained within this
field and correspond in order
with the field attributes:
 Protected: default,
   intensified, reverse video
   and underline
 Modifiable: default,
   intensified, reverse video
   and underline
  1 USER-COLORS-OVERRIDE
DB=BW CS=NS
HD=/Over
L   N   A flag, which when true,
indicates that the USER-FIELD-
COLORS specification will
override colors assigned by
the application program.
  1 USER-NSM-FA-OPTIONS
DB=BX CS=NS
HD=/Options
A 12.0 N   Four field attribute options
and color codes used by
selected NSM applications for:
1) modifiable default fields,
2) modifiable intensified
fields, 3) conditionally
protected fields, & 4) TARGET
'previous value' fields. Each
is 3 chars consisting of an
option and an optional
Natural color code. Possible
options are:
D = Default intensity
I = Intensified
V = Reverse video
U = Underline
  1 USER-E-MAIL-ADDR
DB=BY CS=NS
HD=User's e-mail address
A 40.0 N   The user's e-mail address as
maintained through the 'User
Profile' by the user. This
address is place on e-mail
originated by this user from
within administrative
applications.
  1 DATE-OF-ENTRY
DB=A3 CS=UA
HD=/Entered
D   N   Date that a record was first
added to a file in NATURAL
date format.
  1 DATE-OF-UPDATE
DB=A0 CS=UA
HD=/Update
D   F   Date a record was last updated
in Natural's date format.
  1 UPDATED-BY-USER
DB=A2 CS=UA
HD=/ By
A 8.0 N   The Natural user ID (USER-ID)
of the last user to update a
record or associated item.
  1 TIME-STAMP
DB=A1 CS=UA
HD=Time Stamp
B 8.0 F   This field is used to uniquely
identify each update to a
record. Each time a record is
updated, this field should be
assigned the value of the
Natural function *TIMESTMP.
Programs should check to see
if this field has changed from
the time they first read a
record until the the time they
read the record with hold.
This will determine if someone
else has altered the record.

VALUE-SECURITY

Information about application value security groups. These entries define restrictions to data that are enforced by the application for users of this security group. Value based security is an optional part of the Natural Secured Menus Architecture. These security definitions are maintained by the NSM Maintenance System.

Element definitions for file: VALUE-SECURITY (U-51)
Typ Lvl Field name Fmt Len CO Index Definition
  1 APPLICATION-ID
DB=EA CS=UA
HD=/ID
A 8.0 N   An identifier of a Natural
application and/or library
name. Used to group related
programs and operational
functions designed to address
a specific need. Functions
within an application also
share common security features
and administration.
  1 VALUE-SECURITY-GROUP
DB=EB CS=NS
HD=/Group
A 8.0 N   A code used to group users &
desks according to their value
related security restrictions.
This field will be blank if
an application does not
utilize value security.
SP 1 APPLICATION-VALUE-SEC-GROUP
DB=EC CS=NS
HD=/Group
A 16.0 N D The super descriptor composed
of the APPLICATION-ID and
VALUE-SECURITY-GROUP for
access to value security
restrictions for the applica-
tion and security group.
  1 VALUE-SECURITY-GROUP-DESC
DB=ED CS=NS
HD=/Description
A 50.0 N   The description for a value
security group. Used to help
identify the purpose or intent
of the security group. This
field is maintained in mixed
case.
MU 1 VALUE-RESTRICTIONS
DB=EE CS=NS
HD=Value Restrictions
A 253.0 N   This field contains security
by value restrictions as
needed and defined by each
application. See application
specific docuementation for
more information.
  1 DATE-OF-ENTRY
DB=A3 CS=UA
HD=/Entered
D   N   Date that a record was first
added to a file in NATURAL
date format.
  1 DATE-OF-UPDATE
DB=A0 CS=UA
HD=/Update
D   F   Date a record was last updated
in Natural's date format.
  1 UPDATED-BY-USER
DB=A2 CS=UA
HD=/ By
A 8.0 N   The Natural user ID (USER-ID)
of the last user to update a
record or associated item.
  1 TIME-STAMP
DB=A1 CS=UA
HD=Time Stamp
B 8.0 F   This field is used to uniquely
identify each update to a
record. Each time a record is
updated, this field should be
assigned the value of the
Natural function *TIMESTMP.
Programs should check to see
if this field has changed from
the time they first read a
record until the the time they
read the record with hold.
This will determine if someone
else has altered the record.