COGNOS Business Intelligence Series 7

pes.pdf pes.pdf

sharepoint.cabq.gov
from sharepoint.cabq.gov More from this publisher
20.07.2014 Views

Appendix B: Batch Administration HELP KILL name LIST [folder] MOVE name name NOTIFY {(CUBE_OBJECT objectname | CUBE_FILE filename)} EVENT = UPDATE [ON_ERROR IGNORE | FAIL] PUBLISH name PUBLISHLINK name QUIT REMOVE type [PATH] name REMOVE DS name DS mirror REMOVELINK name RENAME source destination RESET name property RESET BELOW folder property SET name property=value SHOW name filename Specifies the fully qualified path of the mdc file, including the file extension. folder Specifies an object name of type FOLDER, which represents the folder path within the PowerPlay Enterprise Server hierarchy. mirror Mirror reference for the object. The syntax for a mirror reference is server[:port]/name. name Specifies the name of an object (cube, report, or folder). When the object is a folder, it can be used to form a folder hierarchy (see the Conventions section below). A server is also considered the root folder. objectname Specifies the logical name of the cube as defined in PowerPlay Enterprise - Server Administration. option Specifies a command option, as described in the Options section below. password Specifies either a simple server password or the password for the specified Access Manager user name. path Specifies a physical path to the data source file. Uses the format of your operating system (UNIX or Windows). port Specifies Port number of the PowerPlay server. 102 Cognos PowerPlay (R)

Appendix B: Batch Administration Description Conventions Options property Specifies an object property in (.) object hierarchy format. For a list of properties, use the SHOW command. server Specifies the name or IP address of a PowerPlay server. type Specifies the type of object. The type can be CUBE, REPORT, or FOLDER. username Specifies a user name belonging to an Access Manager user class. value Specifies the value for a property. The ppadmtool program executes PowerPlay server commands from the UNIX command shell or Windows Command Prompt. When entering file paths or the variable "name" (when the object is a folder), a dot (.) represents the current folder, two dots (..) represent the parent folder, and a slash (/) represents the root folder, which is the server. For example, the following script disables all objects on server hp_srv. ppadmtool > connect hp_srv > disable ./ > exit When entering file names or paths containing spaces, enclose the entire file name or path in quotation marks ("). For example SHOW "great outdoors" COPY ../gnt "/CF systems/great outdoors" You can also redirect input from a file and output to a file. ppadmtool < ../adm/daily_update.txt > check.log ADD Adds a new object to the connected server. PATH indicates a data source file and DS indicates mirror reference. The following example adds the report "Finance" to the connected server: ADD REPORT Finance PATH /applications/finance.ppx The following example adds the folder "Finance" which has a mirror reference to the object "FinanceHQ" on server remote3, which is running a PowerPlay server on port 8065: ADD FOLDER Finance DS remote3:8065/FinanceHQ If a type is not specified, the object is assumed to be a cube. ADD DS Adds a mirror reference to an existing object. The following example adds two mirror reference (to the servers "remote2" and "remote3") to the cube "Marketing": ADD DS CUBE Marketing DS remote2/mkt ADD DS CUBE Marketing DS remote3/mkt If a type is not specified, the object is assumed to be a cube. Enterprise Server Guide 103

Appendix B: Batch Administration<br />

Description<br />

Conventions<br />

Options<br />

property<br />

Specifies an object property in (.) object hierarchy format. For a list of properties, use the SHOW<br />

command.<br />

server<br />

Specifies the name or IP address of a PowerPlay server.<br />

type<br />

Specifies the type of object. The type can be CUBE, REPORT, or FOLDER.<br />

username<br />

Specifies a user name belonging to an Access Manager user class.<br />

value<br />

Specifies the value for a property.<br />

The ppadmtool program executes PowerPlay server commands from the UNIX command shell or<br />

Windows Command Prompt.<br />

When entering file paths or the variable "name" (when the object is a folder), a dot (.) represents<br />

the current folder, two dots (..) represent the parent folder, and a slash (/) represents the root<br />

folder, which is the server. For example, the following script disables all objects on server hp_srv.<br />

ppadmtool<br />

> connect hp_srv<br />

> disable ./<br />

> exit<br />

When entering file names or paths containing spaces, enclose the entire file name or path in<br />

quotation marks ("). For example<br />

SHOW "great outdoors"<br />

COPY ../gnt "/CF systems/great outdoors"<br />

You can also redirect input from a file and output to a file.<br />

ppadmtool < ../adm/daily_update.txt > check.log<br />

ADD<br />

Adds a new object to the connected server. PATH indicates a data source file and DS indicates<br />

mirror reference. The following example adds the report "Finance" to the connected server:<br />

ADD REPORT Finance PATH /applications/finance.ppx<br />

The following example adds the folder "Finance" which has a mirror reference to the object<br />

"FinanceHQ" on server remote3, which is running a PowerPlay server on port 8065:<br />

ADD FOLDER Finance DS remote3:8065/FinanceHQ<br />

If a type is not specified, the object is assumed to be a cube.<br />

ADD DS<br />

Adds a mirror reference to an existing object. The following example adds two mirror reference<br />

(to the servers "remote2" and "remote3") to the cube "Marketing":<br />

ADD DS CUBE Marketing DS remote2/mkt<br />

ADD DS CUBE Marketing DS remote3/mkt<br />

If a type is not specified, the object is assumed to be a cube.<br />

Enterprise Server Guide 103

Hooray! Your file is uploaded and ready to be published.

Saved successfully!

Ooh no, something went wrong!