Schema Reference
The application schema is used to configure the objects returned from a connector.
Note
-
The Account Schema tab is used to define the attributes for each object type in the application being configured. The schema attributes can be defined as Entitlement or Multi-Valued. Refer to Managing Source Account Schemas for more information.
-
The schema attributes that are not present by default must be defined as strings if not specified.
The RACF connector uses the following default correlation and object configurations.
Default Account Schema
Each source supports a variety of details, or attributes, about each user who has an account, such as their name, email address, manager name, and location.
The set of account attributes each source stores and how they're organized is known as the account's schema. To best represent your data, you can configure sources to use an account schema matching the one you use in the external connector. Refer to Managing Source Account Schemas for more information.
Default Account ID
SailPoint requires that certain attributes remain in your configuration. These attributes are referred to as account IDs.
Caution
Changing the attribute marked as the account ID after aggregating accounts can result in duplicate accounts being created. To avoid this, either reset the accounts on this source before editing the account ID attribute or edit the account ID attribute before aggregating accounts.
To resolve issues caused by changing account IDs, reconfigure them to their default values.
The following table lists the default account IDs for this connector:
| Account ID | Schema Object Type |
|---|---|
| USER_ID | Account |
| GROUP_ID | Group |
Default Account Attributes
The RACF connector supports the following default account schema attributes and customer configurable attributes. The attributes must be defined as strings if not specified.
Following are the list of account attributes:
| Attribute Name | Description |
|---|---|
| USER_ID | User's RACF ID |
| UG_DEF | User's default group |
| groups | List of groups this user belongs to |
| SYSTEM_ACCESS | SPECIAL, OPERATIONS, AUDITOR, or ROAUDIT privileges at system level |
| RESTRICTED | Global access checking is bypassed |
| AUTHORITY | Group authority level for user in the default group (USE / CREATE / CONNECT / JOIN) |
| ADSP | Permanent tape and DASD datasets created by the user are protected by discrete profiles |
| CATEGORY | User access to resources is additionally protected by the security categories |
| CLAUTH | Classes in which the user can define profiles |
| DATA | Installation-defined data |
| GRPACC | Group data sets protected by DATASET profiles defined by this user are automatically accessible to other users in the group |
| INTERVAL | Number of days during which a user's password and password phrase (if set) remain valid |
| MODEL | Discrete dataset profile name used as a model when new dataset profiles are created that have USER_ID as the high-level qualifier |
| NAME | Username associated with the USER_ID |
| LANGUAGE.PRIMARY | Primary language of user |
| LANGUAGE.SECONDARY | Secondary language of user |
| OIDCARD | User must supply an operator identification card when logging onto the system |
| OPERATIONS | User has authorization to do maintenance operations on all RACF-protected resources |
| OWNER | Owner of the user or owner group |
| RESUME_DATE | Starting date when user will be allowed to access the system again |
| REVOKE_DATE | Starting date when user will be disallowed to access the system |
| SECLABEL | Default security label |
| SECLEVEL | User's security level |
| UAUDIT | RACF logs most events and changed done by the user |
| WHEN.DAYS | Days of the week when the user is allowed to access the system from a terminal |
| WHEN.TIME | Hours in the day when the user is allowed to access the system from a terminal |
| INFO.INTERVAL | Number of days during which a user's password and password phrase (if set) remain valid |
| INFO.CREATE_DATE | Date when user was defined to RACF |
| INFO.LAST_LOGIN_DATE | Last date user login to system |
| INFO.LAST_LOGIN_TIME | Last time in INFO.LAST_LOGIN_DATE when user logged in to the system |
| INFO.PASSCHG_DATE | Last date user changed their password |
| INFO.UNKNOWNCAT | Security level unknown category |
| RACF_REVOKE_REASON | Revoke reason of account |
CICS Segment Attributes
| Attribute Name | Description |
|---|---|
| CICS.OPIDENT | Operator ID for use by BMS (basic mapping support) |
| CICS.OPCLASS | Classes assigned to this operator to which BMS messages are to be routed |
| CICS.OPPRTY | Priority of the operator |
| CICS.TIMEOUT | Time, in hours and minutes, that the operator is allowed to be idle before being signed off |
| CICS.XRFSOFF | FORCE means that the user is signed off by CICS when an XRF takeover occurs |
DFP Segment Attributes
| Attribute Name | Description |
|---|---|
| DFP.DATAAPPL | DFP data application identifier |
| DFP.DATACLAS | Default data class |
| DFP.MGMTCLAS | Default management class |
| DFP.STORCLAS | Default storage class |
TSO Segment Attributes
| Attribute Name | Description |
|---|---|
| TSO.ACCTNUM | Default TSO account number when logging on |
| TSO.COMMAND | Command run during TSO LOGON |
| TSO.DEST | Default destination to which the system routes dynamically-allocated SYSOUT data sets |
| TSO.HOLDCLASS | Default hold class |
| TSO.JOBCLASS | Default job class |
| TSO.MAXSIZE | Maximum region size the user can request at logon |
| TSO.MSGCLASS | Default message class |
| TSO.PROC | Default logon procedure name when logging on through TSO LOGON panel |
| TSO.SECLABEL | Security label entered or used during TSO LOGON |
| TSO.SIZE | Default or requested region size during TSO LOGON |
| TSO.SYSOUTCLASS | Default SYSOUT class |
| TSO.UNIT | Default name of a device or group of devices that a procedure uses for allocations |
| TSO.USERDATA | Optional installation data defined for the user |
WORKATTR Segment Attributes
| Attribute Name | Description |
|---|---|
| WORKATTR.WAACCNT | Account number for APPC processing |
| WORKATTR.WAADDR1 | Additional address line #1 for SYSOUT delivery |
| WORKATTR.WAADDR2 | Additional address line #2 for SYSOUT delivery |
| WORKATTR.WAADDR3 | Additional address line #3 for SYSOUT delivery |
| WORKATTR.WAADDR4 | Additional address line #4 for SYSOUT delivery |
| WORKATTR.WABLDG | Building that SYSOUT information is to be delivered to |
| WORKATTR.WADEPT | Department that SYSOUT information is to be delivered to |
| WORKATTR.WANAME | User name that SYSOUT information is to be delivered to |
| WORKATTR.WAROOM | Room that SYSOUT information is to be delivered to |
OMVS Segment Attributes
| Attribute Name | Description |
|---|---|
| OMVS.ASSIZEMAX | RLIMIT_AS hard limit (maximum) resource value that processes receive when they are dubbed a process |
| OMVS.CPUTIMEMAX | RLIMIT_CPU hard limit (maximum) resource value that OMVS processes receive when they are dubbed a process |
| OMVS.FILEPROCMAX | Maximum number of files this user is allowed to have concurrently active or open |
| OMVS.HOME | OMVS initial directory path name |
| OMVS.MMAPAREAMAX | Maximum amount of data space storage, in pages, that can be allocated by the user for memory mappings of OMVS files |
| OMVS.PROCUSERMAX | Maximum number of processes this user is allowed to have active at the same time, regardless of how the process became OMVS process |
| OMVS.PROGRAM | First program started when TSO command OMVS is entered or when a batch job is started using the BPXBATCH program |
| OMVS.THREADSMAX | Maximum number of pthread_create threads, including those running, queued, and exited but not detached, that this user can have concurrently active |
| OMVS.UID | OMVS User identifier |
DCE Segment Attributes
| Attribute Name | Description |
|---|---|
| DCE.AUTOLOGIN | Whether OMVS DCE is to log this user into OMVS DCE automatically |
| DCE.DCENAME | DCE principal name defined for this RACF user in the DCE registry |
| DCE.HOMECELL | DCE cell name defined for this RACF user |
| DCE.HOMEUUID | DCE universal unique identifier (UUID) for the cell that this user is defined to |
| DCE.UUID | DCE universal unique identifier (UUID) of the DCE principal defined in DCENAME |
Default Entitlement Attributes
Entitlement attributes define the entitlements, such as groups or roles, that can be assigned to the managed system's user accounts. Refer to Managing Entitlements for more information.
Caution
Changing the attribute marked as the Entitlement ID after aggregating accounts or entitlements can result in duplicate entitlements being created, or access profiles and roles breaking. To avoid this, edit the entitlement schema before performing any aggregations.
Default Group Attributes
The RACF connector also supports groups. The following attributes must be configured on the managed system and in the SailPoint source schema to manage groups.
The following table lists the group attributes:
| Attribute Name | Description |
|---|---|
| GROUP_ID | RACF ID of the group |
| OWNER | RACF-defined user or group which is the owner of the group |
| UNIVERSAL | Universal group with effectively unlimited number of users who may be connected to it |
| MODEL | A discrete MVS dataset profile which is the model for new data sets of this group |
| INFO.CREATE_DATE | Date when this group was defined to RACF |
| DATA | Installation-defined data |
| SUBGROUP | List of all groups which this group is their SUPGROUP |
| TERMUACC | During terminal authorization checking, RACF allows any user in the group access to a terminal based on the universal access authority for that terminal. |
OMVS Segment Attribute
| Attribute Name | Description |
|---|---|
| OMVS.GID | Group identifier |
OVM Segment Attribute
| Attribute Name | Description |
|---|---|
| OVM.GID | OpenExtensions VM group identifier |
DFP Segment Attributes
| Attribute Name | Description |
|---|---|
| DFP.DATAAPPL | DFP data application identifier |
| DFP.DATACLAS | Default data class |
| DFP.MGMTCLAS | Default management class |
| DFP.STORCLAS | Default storage class |
TME Segment Attribute
| Attribute Name | Description |
|---|---|
| TME.ROLES | List of roles that reference a specific group |
Documentation Feedback
Feedback is provided as an informational resource only and does not form part of SailPoint’s official product documentation. SailPoint does not warrant or make any guarantees about the feedback (including without limitation as to its accuracy, relevance, or reliability). All feedback is subject to the terms set forth at https://developer.sailpoint.com/discuss/tos.