next up previous index
Next: J530 Reasonable Intervals Up: CERNLIB Previous: J401 Print Banner

J403 Print Banner Text

Routine ID: J403
Author(s): J. ZollLibrary: KERNLIB
Submitter: Submitted: 19.09.1991
Language: FortranRevised:

XBANNER can be used to create either a banner page or to print simple banner text. For a banner page printing may be repeated to make a recto-verso page; for simple text printing is done only once without page eject. The current date and time is always printed.

Structure:

Complete program, executable module normally on /cern/pro/bin
User Entry Names: XBANNER
External References: VIZPRI (J200), DATIME (Z007)
Files Referenced: User controlled

Usage:

The command line

    xbanner  where arg1 arg2 arg3 ...
prints the text strings 'argi ' as large characters, normally on one line each, onto the file selected by 'where'.

'where' specifies the output file, pre--fixed by zero, one, or two control characters. If no file name is given, standard output is assumed, in which case exactly one control character, 1 or 0, must be given.

The pre-fix control characters select the following actions:

2
create a recto-verso banner page;
1
create a single banner page; page-eject is Fortran style with '1' in column 1.
0
print banner text only, default.
+
append to existing file.
=
overwrite file if existing.
If a file-name is given without ' +' or ' =' a new file (cycle) is created on the VAX, and on Unix machines ' =' is assumed.

The parameters 'argi ' specify the text to be printed, each 'argi ' giving rise to one or more lines: Normally a parameter gives just one line. But if its first character is not alphabetic and equal to its last character each such character, except the first, indicates a line break.

Typing xbanner without parameters causes a display of the help information.

Examples:

      xbanner 1         KERN UPDATE /// 1.18 APOLLO
      xbanner 1=y.lis '/KERN/UPDATE/oct 89//1.18/APOLLO/'
      xbanner 1+y.lis   KERN UPDATE "oct 89" // 1.18 APOLLO
all create a single banner page of 6 large lines; the first example prints to standard output, the other two onto file y.lis, either overwriting or appending. In these examples // causes one blank line and /// gives 2 blank lines. Note that a blank within a parameter has to be protected so as not to break it into 2 parameters.

The next example adds one large line to y.lis:

      xbanner  +y.lis /fzcopy
giving:
                         19/09/91  16.06             19/09/91  16.06
 
               ffffffffffff  zzzzzzzzzzzz   cccccccccc   oooooooooooo  ppppppppp
          //   ffffffffffff  zzzzzzzzzzzz  cccccccccccc  oooooooooooo  ppppppppp
         //    ff                     zz   cc        cc  oo        oo  pp
        //     ff                    zz    cc            oo        oo  pp
       //      ff                   zz     cc            oo        oo  pp
      //       ffffffff            zz      cc            oo        oo  ppppppppp
     //        ffffffff           zz       cc            oo        oo  ppppppppp
    //         ff                zz        cc            oo        oo  pp
   //          ff               zz         cc            oo        oo  pp
  //           ff              zz          cc        cc  oo        oo  pp
 //            ff             zzzzzzzzzzz  cccccccccccc  oooooooooooo  pp
               ff            zzzzzzzzzzzz   cccccccccc   oooooooooooo  pp

J530



next up previous index
Next: J530 Reasonable Intervals Up: CERNLIB Previous: J401 Print Banner


Janne Saarela
Mon Apr 3 15:06:23 METDST 1995