Oracle Essbase 9 Implementation Guide- P68 pps

Automating your Essbase Cube [ 320 ] Code Sample: alter user 'HYPUSER' add to group ESSPROFIT; alter user 'HYPUSER" RESET; Display user The display user MaxL statement will display the user information like username, last logon date, enables, and password reset days remaining. Syntax: display user all | <User-name> | in group (all | <Group-name>); Code Sample: display user all; display user in group all; display user in group ESSPROFIT; Drop user The drop user MaxL statement will delete the existing user. Syntax: drop user <user-name>; Code Sample: drop user ESSUSER; Grant user The grant user MaxL statement will grant permissions to the user. Syntax: grant user SYS-SYSTEM-PRIVILEGE | SYS-SYSTEM-ROLE | APP-SYSTEM-ROLE ON APPLICATION <APP-Name> | GRANTED-DBS-SYSTEM-ROLE ON DATABASE <Db-name> | FILTER <Filter-name> | EXECUTE <Calc-name> TO <User-name> | <Group- name>; Code Sample: grant user administrator to Sarma; grant user no_access to Joe; This material is copyright and is licensed for the sole use by Paul Corcorran on 5th July 2009 8601 ave. p #1, , lubbock, , 79423 Download at Boykma.Com Chapter 8 [ 321 ] Working at the System level with MaxL The database administrator is sometimes required to clear the Essbase log, unload all the application from the memory, or kill a process which is running. All of these statements can also be performed by the system MaxL statement. The system MaxL statement has only two actions to alter or display information. Alter system properties Using the alter system MaxL statement, you will be able to load and unload an application on the server, clear the Essbase log le, set invalid login limit, set password reset days, enable/disable Unicode, log out all or a specic user session. These changes are all updated at the analytic server level. Let's see some of the alter system statements in use. Syntax: alter system load application all | <App-Name>; alter system unload application all | <App-Name>; alter system clear logfile; alter system logout session all | <Session-id> | by user <User-name> | on application <App-Name> | on database <Db-Name>; alter system enable unicode; alter system disable unicode; Code Sample: alter system load application 'ESSCAR'; alter system logout session by user 'SARMA'; Display system properties The display system MaxL statement displays the information about the Essbase server. Syntax: display system version | ports_in_use | expost_directory | license_info; Code Sample: display system all; display system ports_in_use; This material is copyright and is licensed for the sole use by Paul Corcorran on 5th July 2009 8601 ave. p #1, , lubbock, , 79423 Download at Boykma.Com Automating your Essbase Cube [ 322 ] Substitution variables Substitution variables can also be updated by using MaxL statements and commands. The following commands adding, updating, and dropping the substitution variables can be at the application, database, or the server level. • add variable: This is used to create a new Substitution Variable. Syntax: Adding variables at Application level—these can be accessed by only the application specied. alter application <App-Name> add variable <variable-Name> <variable-value>; Adding variables at Database level—these can be accessed by only the database specied. alter database <App-Name>.<db-name> add variable <variable-Name> <variable-value>; Adding variables at the System level – these can be accessed by all of the applications that reside on the Essbase server alter system add variable <variable-Name> <variable-value>; Code Samples: alter application 'ESSCAR' add variable 'sCurrMonth' '200902'; alter database 'ESSCAR'. 'ESSCAR' add variable 'sCurrMonth' '200902'; alter system add variable 'sCurrMonth' '200902'; • set variable: This is used to update the value of an existing Substitution Variable. If the variable is not dened, then use add variable rst to create a new Substitution Variable. Syntax: Setting variables at the application level alter application <App-Name> set variable <variable-Name> <variable-value>; Setting variables at the database level alter database <App-Name>.<db-name> set variable <variable-Name> <variable-value> ; This material is copyright and is licensed for the sole use by Paul Corcorran on 5th July 2009 8601 ave. p #1, , lubbock, , 79423 Download at Boykma.Com Chapter 8 [ 323 ] Setting variables at the System level alter system set variable <variable-Name> <variable-value>; Code Samples: alter application 'ESSCAR' set variable 'sCurrMonth' '200902'; alter database 'ESSCAR'. 'ESSCAR' set variable 'sCurrMonth' '200902'; alter system set variable 'sCurrMonth' '200902'; • drop variable: This command is used to delete an existing Substitution Variable. Syntax: Drop a substitution variable at the Application level alter application <App-Name> drop variable <variable-Name>; Drop a substitution variable at the Database level alter database <App-Name>.<db-name> drop variable <variable-Name>; Drop a substitution variable at the System level alter system drop variable <variable-Name>; Code Samples: alter application 'ESSCAR' drop variable 'sCurrMonth'; alter database 'ESSCAR'. 'ESSCAR' drop variable 'sCurrMonth'; alter system drop variable 'sCurrMonth'; Executing a MaxL statement Now that you have learned how powerful the MaxL statements are, let's see how we can execute the statements. The MaxL statements can be written in any text editor like Windows Notepad and you then save the le with the .mxl extension. How do we run a MaxL statement? There are a couple of ways this can be accomplished. They are as follows: • Run MaxL from the command prompt using the MaxL shell • Executing a MaxL statement from the MaxL editor in EAS This material is copyright and is licensed for the sole use by Paul Corcorran on 5th July 2009 8601 ave. p #1, , lubbock, , 79423 Download at Boykma.Com Automating your Essbase Cube [ 324 ] Executing MaxL from Command Prompt When you install the Essbase client, by default, the MaxL shell executable is provided and is named essmsh.exe. This executable will be located in the bin folder of the Oracle client home install folder, typically as shown: <Hyperion_home>\AnalyticServices\bin The extension for a MaxL le is .mxl, and the les are ASCII text les, which you can write statements and edit in any common text editor like Windows Notepad. To execute your script you go to the bin folder path and re off the MaxL script as shown below. Open a blank Notepad text le and type in these MaxL statements: spool on to 'C:\book\MaxlOutput.txt'; /* This sends all the Maxl outputs to the File mentioned */ login hypuser password on localhost; /* Log in to the Essbase Server */ create application 'EsscarN'; /* This Step creates the Application called EsscarN */ create database 'EsscarN'.'EsscarN' as 'Esscar'.'Esscar'; /* This creates the copy of the Database Esscar and new Database name is EsscarN */ alter database 'EsscarN'.'EsscarN' reset data; /* This statement will clear all the Pre-existing data */ alter database 'EsscarN'.'EsscarN' set variable 'sCurrMonth' '200902'; /* Sets a variable called sCurrMonth */ import database 'EsscarN'.'EsscarN' data connect as 'hypuser' identified by 'password' using server rules_file 'dSales' on error write to 'C:/book/dataload.err'; /* This statement loads the data into the Cube */ logout; /* logs out users session */ exit; /* Exits from Maxl */ Save the le with the.mxl extension then open the Command Prompt and run your MaxL script from the prompt as shown in the following screenshot. If you type ESSMSH in the command prompt and the MaxL prompt does not show up, then go to the Environment Variables and add the path below: <Hyperion-home>\AnalyticServices\bin\essmsh.exe. After you add this into the path, you will be able to run MaxL from anywhere in the DOS prompt. This material is copyright and is licensed for the sole use by Paul Corcorran on 5th July 2009 8601 ave. p #1, , lubbock, , 79423 Download at Boykma.Com . Corcorran on 5th July 20 09 8601 ave. p #1, , lubbock, , 794 23 Download at Boykma.Com Automating your Essbase Cube [ 324 ] Executing MaxL from Command Prompt When you install the Essbase client, by. licensed for the sole use by Paul Corcorran on 5th July 20 09 8601 ave. p #1, , lubbock, , 794 23 Download at Boykma.Com Automating your Essbase Cube [ 322 ] Substitution variables Substitution variables. '20 090 2'; alter database 'ESSCAR'. 'ESSCAR' set variable 'sCurrMonth' '20 090 2'; alter system set variable 'sCurrMonth' '20 090 2';