RPTADMIN C-1





Copyright (C) 1994-95 Conetic Software Systems, Inc. All names, products, and services mentioned are the trademarks of their respective organizations.



NAME


rptadmin - administer reportfile catalog

SYNOPSIS


   rptadmin -a  [-vx] [-C comment] [-P precompile] lreport sysname
   rptadmin -c  [-vx] lreport [comprpt]
   rptadmin -d  [-vx] lreport
   rptadmin -f  [-v] lreport
   rptadmin -l  [-v] dbname [printfields]
   rptadmin -r  [-v] lreport [printfields]
   rptadmin -t  [-v] lreport
   rptadmin -u  [-vx] [-C comment] [-P precompile] [-S sysname] lreport

DESCRIPTION


Rptadmin maintains the reportfile catalog.  Rptadmin either adds, updates 
or deletes a logical reportfile entry from the reportfile catalog, or 
provides catalog information on existing entries.

One of the following flags must be specified to indicate the operation 
to be performed by rptadmin:

-a      Adds an entry for lreport to the reportfile catalog.  An entry in 
        the reportfile catalog cannot already exist for the logical 
        reportfile lreport.  Sysname names the path-name of the reportfile.  
        This can be an absolute pathname or a pathname relative to the home 
        directory of the database.

        The -C flag initializes the description catalog field for a logical 
        reportfile.  If it is omitted, the description field is set to null. 
        The -P flag initializes the precompile status catalog field.  If it 
        is omitted, the precompile status field is set to no.

-c      Compiles the logical reportfile, lreport, into an intermediate code 
        for future inter-pretation by wtr(C-1).  The intermediate code is 
        written to comprpt, unless omitted.  If the logical report has 
        the precompile status field set to yes, the compiled code is 
        written to the reportfile's compiled pathname.  This pathname is 
        formed by appending .rw to the pathname of the logical reportfile.  
        If the precompile status field is set to no, the intermediate code 
        is written to the default a.rw file.  With the -v flag specified, 
        the reportfile's compiled pathname is written on standard output.

        The reportfile for lreport is assumed to be a report writer source 
        file (created with a text editor) or a visual report that was 
        created with either wtrdef(C-1) or creport(C-1).  If the pathname 
        for lreport happens to be the compiled version of a report, no 
        additional compilations are performed.

-d      Deletes the logical reportfile entry for lreport from the reportfile 
        catalog.  The physical reportfile is not removed from the system.

-f      Displays on standard output the absolute pathname of lreport.

-l      Displays all logical reportfiles currently defined for the 
        database dbname.  With the -v flag, titles for all selected 
        printfields are displayed.  With no printfields selected, the 
        default is the description of each logical reportfile in addition 
        to its' name.  Printfields selects the catalog field information 
        displayed for each logical reportfile.  The printfields available 
        for a logical reportfile are dbname, rptname, sysname, desc, 
        precompile, and type.

-r      Displays the catalog field information for one logical reportfile 
        entry.  With the -v flag, titles for all selected printfields are 
        displayed.  With no printfields selected, the default is the 
        description of lreport and its' name.  The printfields available 
        for a logical reportfile are dbname, rptname, sysname, desc, 
        precompile, and type.

-t      Displays the report type of lreport.  A reportfile can represent 
        one of three (3) valid report types.  Report types supported are:

        VISUAL          Represents reports created with wtrdef(C-1).

        TEXT            Represents reports created with a text editor.

        COMPILED        Represents reports that have been compiled with 
                        crw(C-1).  A compiled report is the intermediate 
                        code which is interpretable by wtr(C-1).

-u      Updates the catalog entry for the existing logical reportfile 
        lreport.  At least one of the optional flags (-C, -P, or -S) must 
        be supplied when updating a logical reportfile entry.

The meanings of the optional flags are:

-v      Displays progress information on standard output.

-x      Displays on standard output the commands run by rptadmin.

-C comment
        Supplies the description of lreport that is stored with the logical 
        reportfile entry. If the -C flag is specified, comment is required 
        and must be quoted if embedded with blanks, tabs or newlines.  If 
        this flag is omitted when adding a logical reportfile, the 
        description is set to null.  If this flag is omitted when the -u 
        flag is specified, the description for the logical reportfile is 
        unchanged.

-P boolean
        Specifies the precompile status of lreport.  The precompile status 
        indicates whether a compiled version of the report should be 
        maintained for a logical report. Boolean is either set to yes, 
        maintain a compiled version of the report, or no, do not maintain 
        a compiled version for lreport.  If a compiled reportfile is 
        maintained, the pathname for the compiled version of the report 
        is formed by appending .rw to the pathname of the logical reportfile.

-S sysname
        Names the system pathname for the logical reportfile lreport.  
        Sysname can be an absolute pathname (e.q. /usr/cbase/demo/rpt/mag), 
        or a pathname relative to the home directory of the database 
        (e.q. rpt/mag).

SEE ALSO


rptedit(C-1), grace(C-1), crw(C-1), wtr(C-1), wtrdef(C-1), creport(C-1), 
preport(C-1), wtr(C-1), rptupd(C-1).