COGNOS Business Intelligence Series 7
pes.pdf pes.pdf
Appendix B: Batch Administration CONNECT Connects to a PowerPlay server. The server may be secured using a simple password or Access Manager. The following example connects to the server "srv28a" as the user name "JuliaX" using the password "neptune": CONNECT srv28a USER JuliaX PASSWORD neptune CD Changes the current folder. The command-line prompt indicates the current folder and the path from the root folder (the server). The following example changes the current folder from "/global networking/finances" to "/global networking/hub product/marketing". For clarity, the prompt is included in the example: global networking /finances> CD "../hub products/marketing" global networking/hub products/marketing> COPY Creates a copy of an object and its associated overridden properties in a new object. The following example copies the report "gnt" from the parent folder to the folder "/CF systems" and names the new object "great outdoors": COPY ../gnt "/CF systems/great outdoors" CRN REPLACE CUBENAME Changes the cube name of all PowerPlay cubes or reports that match a current cube name and whose gateway matches the current server's gateway. The following example changes the name of all objects named "Great Outdoors" on the current gateway to "Sample Cube": CRN REPLACE CUBENAME "Great Outdoors" "Sample Cube" CRN REPLACE GATEWAY Changes the gateway of all PowerPlay cubes or reports that currently match a given gateway. The following example changes the gateway of all objects whose gateway is "http://myhost/ppdscgi.exe" to "http://otherhost/ppdscgi.exe" CRN REPLACE GATEWAY "http://myhost/ppdscgi.exe" "http://otherhost/ppdscgi.exe" DISABLE Changes the status of an object so that it is unavailable to users. The following example makes the object "Finance" unavailable: DISABLE Finance The following example makes the object "Great Outdoors" unavailable: DISABLE "Great Outdoors" If the object is a folder or server, all child objects are also made unavailable. ENABLE Changes the status of an object so that it is available to users. The following example makes the object "Sales 98" available: ENABLE "Sales 98" If the object is a folder or server, all child objects are also made available. EXIT Closes the ppadmtool utility. HELP Shows a list of the ppadmtool commands. 104 Cognos PowerPlay (R)
Appendix B: Batch Administration KILL Stops the process for the object. The following example, stops the current processes for the Great Outdoors cube: KILL "Great Outdoors" LIST Lists all the objects in the specified folder. The following example lists all objects in the folder "/docs/recent reports": LIST "/docs/recent reports" If no folder is specified, all the objects in the current folder are listed. MOVE Moves an object and its associated overridden properties to a new object, while leaving behind a shortcut to the new object to prevent broken links. The following example creates a new object "bls" in the "/new/" folder. It also replaces the original object "gnt" with a shortcut of the same name, linked to "bls": MOVE gnt "/new/bls" NOTIFY Invokes a cube update notification process. This process includes • updating the Modified date and time for all the related cube and Report NewsItems in Upfront to the date and time when you run the NOTIFY command • changing the status of these NewsItems to Unread to reflect the fact that the cube data has changed • running the related PowerPlay Agents that had been scheduled to run on cube refresh Before running the NOTIFY command, you must ensure that the refreshed cube has been copied successfully to the location as defined in PowerPlay Enterprise - Server Administration. You must also ensure that the user has specified the connection to the PowerPlay Enterprise Server containing the refreshed cube. The NOTIFY command uses the following syntax: NOTIFY {(CUBE_OBJECT objectname | CUBE_FILE filename)} EVENT = UPDATE [ON_ERROR IGNORE | FAIL] • CUBE_OBJECT objectname Use this option if you know the name that you have assigned to the cube. The following example invokes a cube update notification process on the refreshed cube Great Outdoors.mdc, specifying the object name "Great Outdoors": NOTIFY CUBE_OBJECT "Great Outdoors" EVENT=UPDATE • CUBE_FILE filename Use this option when you want to reference the cube filename. The following example invokes a cube update notification process on the refreshed cube Great Outdoors.mdc, specifying the file path: NOTIFY CUBE_FILE "C:\Program Files\Cognos\cer4\ppserver\great_outdoors.mdc" EVENT=UPDATE • ON_ERROR The optional parameter ONERROR specifies the result of the command if the update notification failed for one of the listed objects. IGNORE - the command is considered successful if update notification is successful for at least one object. FAIL - the command is considered a failure if update notification failed for one of the listed objects. PUBLISH Publishes an object to the portal (Upfront or Cognos Connection). The following example adds the object "Marketing" as an Upfront NewsItem: Enterprise Server Guide 105
- Page 53 and 54: Chapter 4: Deploy Cubes and Reports
- Page 55 and 56: Chapter 4: Deploy Cubes and Reports
- Page 57 and 58: Chapter 4: Deploy Cubes and Reports
- Page 59 and 60: Chapter 4: Deploy Cubes and Reports
- Page 61 and 62: Chapter 5: Provide Drill-through Ac
- Page 63 and 64: Chapter 5: Provide Drill-through Ac
- Page 65 and 66: Chapter 5: Provide Drill-through Ac
- Page 67 and 68: Chapter 5: Provide Drill-through Ac
- Page 69 and 70: Chapter 5: Provide Drill-through Ac
- Page 71 and 72: Chapter 6: Audit Server Activity Us
- Page 73 and 74: Chapter 6: Audit Server Activity 2.
- Page 75 and 76: Chapter 6: Audit Server Activity Th
- Page 77 and 78: Chapter 6: Audit Server Activity Co
- Page 79 and 80: Level Usage Table Chapter 6: Audit
- Page 81 and 82: Appendix A: Context Help This secti
- Page 83 and 84: Appendix A: Context Help Maximum Re
- Page 85 and 86: Appendix A: Context Help Parent Sho
- Page 87 and 88: Appendix A: Context Help When this
- Page 89 and 90: Appendix A: Context Help If most in
- Page 91 and 92: Appendix A: Context Help Report Lig
- Page 93 and 94: Appendix A: Context Help Text Color
- Page 95 and 96: Appendix A: Context Help Button Set
- Page 97 and 98: Appendix A: Context Help Impromptu
- Page 99 and 100: Appendix A: Context Help Delete Del
- Page 101 and 102: Appendix B: Batch Administration Th
- Page 103: Appendix B: Batch Administration De
- Page 107 and 108: Appendix B: Batch Administration Yo
- Page 109 and 110: Appendix C: Managing Temporary File
- Page 111 and 112: Appendix C: Managing Temporary File
- Page 113 and 114: Glossary Agent A user-defined proce
- Page 115 and 116: NewsItem In Upfront, an entry that
- Page 117 and 118: Index Symbols .crr files, 62, 68 .c
- Page 119 and 120: Index cubes, 13 location, 14 mirror
- Page 121 and 122: Index O definition, 114 OLAP, 13 P
- Page 123 and 124: Index Server groups, 28 server mirr
Appendix B: Batch Administration<br />
CONNECT<br />
Connects to a PowerPlay server. The server may be secured using a simple password or Access<br />
Manager. The following example connects to the server "srv28a" as the user name "JuliaX" using<br />
the password "neptune":<br />
CONNECT srv28a USER JuliaX PASSWORD neptune<br />
CD<br />
Changes the current folder. The command-line prompt indicates the current folder and the path<br />
from the root folder (the server). The following example changes the current folder from "/global<br />
networking/finances" to "/global networking/hub product/marketing". For clarity, the prompt is<br />
included in the example:<br />
global networking /finances> CD "../hub products/marketing"<br />
global networking/hub products/marketing><br />
COPY<br />
Creates a copy of an object and its associated overridden properties in a new object. The following<br />
example copies the report "gnt" from the parent folder to the folder "/CF systems" and names the<br />
new object "great outdoors":<br />
COPY ../gnt "/CF systems/great outdoors"<br />
CRN REPLACE CUBENAME<br />
Changes the cube name of all PowerPlay cubes or reports that match a current cube name and<br />
whose gateway matches the current server's gateway.<br />
The following example changes the name of all objects named "Great Outdoors" on the current<br />
gateway to "Sample Cube":<br />
CRN REPLACE CUBENAME "Great Outdoors" "Sample Cube"<br />
CRN REPLACE GATEWAY<br />
Changes the gateway of all PowerPlay cubes or reports that currently match a given gateway.<br />
The following example changes the gateway of all objects whose gateway is<br />
"http://myhost/ppdscgi.exe" to "http://otherhost/ppdscgi.exe"<br />
CRN REPLACE GATEWAY "http://myhost/ppdscgi.exe" "http://otherhost/ppdscgi.exe"<br />
DISABLE<br />
Changes the status of an object so that it is unavailable to users. The following example makes the<br />
object "Finance" unavailable:<br />
DISABLE Finance<br />
The following example makes the object "Great Outdoors" unavailable:<br />
DISABLE "Great Outdoors"<br />
If the object is a folder or server, all child objects are also made unavailable.<br />
ENABLE<br />
Changes the status of an object so that it is available to users. The following example makes the<br />
object "Sales 98" available:<br />
ENABLE "Sales 98"<br />
If the object is a folder or server, all child objects are also made available.<br />
EXIT<br />
Closes the ppadmtool utility.<br />
HELP<br />
Shows a list of the ppadmtool commands.<br />
104 Cognos PowerPlay (R)