Realm

The Realm (REALM) page is used to provide context for effective-user assignments in conjunction with the Setup Effective User (SCEFFUSR) page. Each action area of effective-user functionality can have its own effective-user assignments, and these assignments are delineated by these contexts (or realms). In this regard, it is possible to permit a single user (or role) to have a different effective user for different purposes. Nevertheless, an implementation is not required to have separate realms for each different purpose. That is, it is possible to group multiple purposes with the same realm in order to simplify the setup of the Effective User table or to indicate that the assignments do not need different information.

Field InformationField Information

Field	Description
Realm ID	Each different context for effective-user assignments has its own identifier. The Realm ID is used as a cross reference between the Action Area ID and the records on Effective User
Realm Name for Action	A descriptive field intended to describe the usage of the realm.
Default?	An entry listed as the default is used when a record on Effective User is saved without a specified realm. Exactly one entry can be listed as the default.
Action Area ID	Each different purpose is assigned its own Action Area ID internally within CGI Advantage. This known list of data can then be used to define as many or as few Realm IDs as needed. An Action Area ID cannot be assigned to more than one Realm ID, but one Realm ID can be assigned one or more Action Area IDs.

Realm ExampleRealm Example

Two uses of Realms

Setting up an effective-user for standard batch execution through the job manager
Setting up an effective-user for catalog loading. It is possible to set up a role assignment to one particular effective user for batch execution and to set up the same role assignment to another effective user for catalog loading.

Example: The Realm ID, CATRLM, is set up for Online Catalog Loading. This Realm ID is then selected on the Setup Effective User (SCEFFUSR) page for users that do not have batch job privileges but need to be able to submit the Catalog Load Batch job. When the batch job is initiated by the user who does not have batch job privileges, the job will be submitted with the effective user who does.

Delivered RealmsDelivered Realms

The following table lists the delivered Reams.

Realm ID	Realm Name for Action	Action Area ID
ASMBRLM	Assembly Execution	102
BATEXEC	Job Manager Batch Execution	0
CATRLM	Online Catalog Loading	101
NEWMARNP	Online New MA Transaction for Renewal Period	104
PSTNGRTN	Posting Routine Invocation	103

The table above shows five separate realms, each for its own separate purpose or use. This purpose can be thought of as an effective-user functionality. The BATEXEC realm defines the context for the Job Manager Batch Execution use of effective-user functionality. That is, when a submitted job runs, CGI Advantage determines the effective user during the job’s execution by using the entries on the Effective User table that have a realm assignment of BATEXEC.

If separate realms are not required, it is possible to assign different Action Area IDs to the same Realm ID. For example, a different setup for the above information could be as follows:

Leave the assignment of the BATEXEC realm with the Action Area ID of 0 as is.
Remove the assignments for the ASMBRLM, CATRLM and PSTNGRTN realms.
Add a new assignment for the MISC realm with an Action Area ID of 101, to take care of the previous definition of the CATRLM realm.
Add an additional assignment for the MISC realm with an Action Area ID of 102, to take care of the previous definition of the ASMBRLM realm.
Add an additional assignment for the MISC realm with an Action Area ID of 103, to take care of the previous definition of the ASMBRLM realm.
Then, the setup on Effective User requires only two different contexts for the four different effective-user functionalities: assignments for effective users in the BATEXEC realm and assignments for effective users in the MISC realm.