RPTEDIT C-1





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



NAME


rptedit - create or maintain logical reportfiles

SYNOPSIS


rptedit [-vx] [lreport]
rptedit -c [ -etvx] [ -C comment ] [ -D directory ] [ -P boolean ]]
   [ lreport ]

DESCRIPTION


Rptedit creates or modifies logical reportfiles used by the report writer 
program.  The -c flag is used to create a newlogical reportfile.  If the 
create (-c) flag is omitted, the existing logical reportfile lreport is 
modified.  After the reportfile has been created or modified, it is compiled 
into an intermediate code.  If errors occur during this compile, the 
reportfile can be saved as is, discarded, or looped back into the edit 
reportfile stage.  If the precompile status field (-P) for the logical 
reportfile is set to yes, the intermediate code is saved and written to 
the reportfile's compiled pathname.  This pathname is formed by appending 
.rw to the pathname of the reportfile.  When a report is created, an entry 
for the logical reportfile is added to the reportfile catalog.

A reportfile can be created and maintained in one (1) of two (2) formats.  
The reportfile can be created as a visual reportfile maintained by 
wtrdef(C-1) or a text reportfile maintained by a user selected text editor.  
The user selects the text editor by setting the environment variable 
EDITOR to the command name of an appropriate text editor.

The following flags apply to rptedit:

-c      Creates the logical reportfile lreport.  An entry in the 
        reportfile catalog cannot already exist for lreport.  If the -t 
        flag is selected, a text editor is invoked to create a text 
        reportfile.  If the -t flag is omitted, wtrdef(C-1) is invoked to 
        create a visual reportfile.  After the report has been created, 
        a logical reportfile entry for lreport is added to the reportfile 
        catalog.  If a file exist in the named directory that matches 
        the logical reportfile name, or the name is too long for a file 
        entry, a unique name is generated for the reportfile's pathname.

        The optional flags -e, -t, -C, D and -P apply only when a reportfile 
        is initially being created.

-e      Enters expert mode by displaying a parameter form and allows input 
        of arguments that are available with the rptedit command.  The -e 
        flag only applies when the create (-c) flag has been specified with 
        a logical reportfile that does not already exist.  The parameter 
        form accepts input in the same manner as form(C-1)

-v      Displays progress information on standard output.

-x      Displays on standard output the commands run by rptedit.
	
-C comment
        Supplies the description of lreport that is stored with the logical 
        reportfile entry. If specified, comment is required and must be 
        quoted if embedded with blanks, tabs or newlines.  The -C flag 
        applies only when invoked rpteditis (-c) flag.  If the -C flag 
        is omitted, the description is set to null.

-D directory
        Names the directory to contain the new reportfile.  The reportfile 
        directory must be an absolute pathname or a pathname relative to 
        the database's home directory.  If the reportfile directory is 
        not defined, rptedit uses the directory scr relative to the 
        database's home directory.

-P boolean
        Specifies the precompile status of lreport.  The precompile status 
        indicates whether a compiled version of lreport should be maintained. 
        Boolean indicates the precompile status.  The value for boolean is 
        either set to yes, to maintain a compiled version of lreport, or no, 
        do not maintain a compiled version of lreport. If a compiled 
        reportfile is maintained, the pathname of the compiled version of 
        the report is formed by appending .rw to the pathname of the logical 
        reportfile.
 
If the lreport argument is omitted, a parameter form is displayed requesting 
for the logical reportfile.  This form accepts input in the same manner as 
form(C-1).

SEE ALSO


rptadmin(C-1), rptupd(C-1), rptrm(C-1), wtr(C-1), wtrdef(C-1).
Chapter 7, Creating Visual Reports. 
Chapter 9, Report Writer Programming Guide.
Chapter 10, Report Writer Programming Reference.