You can use file equations when you initiate with the following Report types using RIP:

Naming Conventions for Print and Extract Files

Before using File equations in RIP, you should be familiar with the naming conventions of Print Files and Extract Files in Agile Business Suite.

Print Files:

Print Files or Outstreams are attributes inherited from Glb.OutputStream.

In Enterprise Application, the outputstreams were created with their one character names in the range A to Z. When migrating an Enterprise Application model to Agile Business Suite, the outputstreams are automatically created with their one character names in the range of A to Z.

However, in Agile Business Suite, Print files (output stream attributes) can be named with one, two or more than two characters names. While naming the attributes, it is recommended to use a unique first one or two character mnemonic in the range A to ZZ followed by a logical name. For example, AAFinancials, ABTreasury. Builder uses the first two characters of the outputstream names if they are longer than two characters to form the Internal print file name. For example, PrintAA, PrintAB are the corresponding internal file names.

The first two character combination should be unique otherwise it refers to the same internal print file. For example, AAFinancials and AATreasury are two different outputstreams that refer to the same internal print file in a report, PrintAA.

Extract Files:

Extract files are attributes inherited from Glb.File. Extract files also have the same naming convention as Print files except for the following two differences:

File Equations

Use the letters A through ZZ for Extract files. Print files might be equated using internal name PRINT and PRINTA to PRINTZZ, as though RIP were the Report program being initiated.

The file attributes recognized by RIP are shown in the following table.

Refer to the MCP file attribute documentation for more information on file attributes.

Examples

The following example shows file equations for different PRINT files:

FILE PRINT (FORMID = "INVOICES", PRINTCOPIES = 2)
FILE PRINTAA (FORMID = "SALES", PRINTCOPIES = 5)
FILE PRINTYZ (FORMID = "ACCOUNTS", PRINTCOPIES = 5)

The following example show file equations for different Extract files:

FILE A (TITLE = EXT/FILE/A, KIND = TAPE)
FILE ABCD (TITLE = EXT/FILE/B, KIND = TAPE)

The following example shows the command for running a Report named THISDB/ SUMMARY under RIP, with file equations for the Report name and a default Print file.

Using FILE PRINT (TITLE = SALESANAL):

RUN $NGEN28/RIP ("LP"); FILE REPORT (TITLE=THISDB/SUMMARY);
FILE PRINT (TITLE=SALESANAL ON MYPACK, FORMID="DOUBLE")

The following example shows the command for running a Report named THISDB/ SUMMARY under RIP, with the report name as a parameter to RIP and file equations to the shadow reports PRINTA, PRINTB, PRINTC and PRINTD which use the USERBACKUPNAME attribute. There is no file equate for the default Print file.

   RUN *NGENxx/RIP  
("THISDB/SUMMARY LP"); 
%No file equate for PRINT                                                 
FILE PRINTA(USERBACKUPNAME=TRUE);                                        
FILE PRINTB(USERBACKUPNAME=TRUE,                                          
FILENAME=PRINTFILES/SALESANAL/B);                            
FILE PRINTC(USERBACKUPNAME=TRUE,
FILENAME=PRINTFILES/SALESANAL/C,                              
FAMILYNAME=MYPACK);                                          
FILE PRINTD(USERBACKUPNAME=TRUE,
FILENAME=(MYUSER)PRINTFILES/SALESANAL/D,                              
FAMILYNAME=MYPACK);                                                                                                     

The following table shows the names assigned to the Print files in the above example.