 ------------------------------------------------------------------------------

                               LICENSE  410
                                 23Feb2012

 ------------------------------------------------------------------------------

      LICENSE is a free ware tool from GreenHouse Software & Consulting.
                           No warranty is given.
                          Use it at your own risk!

 ------------------------------------------------------------------------------

Do you know, which files on a Tandem system needed to be licensed?
Do you know, which licensed files do NOT need to be licensed?

Once in a while I stumble into the situation, that someone did a

  FUP LICNESE $SYSTEM.SYS*.*

to 'be on the save side'.

It is an awful task to re-introduce the right settings.

So I invested a few weeks and invented a tool, that does all
this for me (and you):

- it displays the actual LICENSE flag situation
  = licensed OK
  = license  needed
  = revoke   needed (because there is no need for a license)

- it corrects the LICENSE flag situation
  = it sets the license flag on those type 100, 700 and 800
    executables and library files, containing PRIV or CALLABLE code
  = it sets the license flag on those SQL files, needing it
  = it sets the license flag on file $SYSTEM.SYSnn.SORTPROG
  = it resets the license flag from those type 100, 700 and 800
    executables, NOT containing PRIV or CALLABLE code.
  = changes only those files, where a change is required



Command syntax:

  [run] LICENSE[/OUT[file]/] -H[ELP] | [CHECK[ONLY]] file1 [,file2]..[,filen]

where

  OUT file          when not present, causes LICENSE to display the
                    findings and actions to the home terminal.

                    when present, but empty (OUT without a file name)
                    suppress any output (LICENSE sends it to 'banana
                    land')

                    when present, but <file> does not exist: causes
                    LICENSE to create an EDIT type file, and to write
                    the findings and actions to it.

                    when present, and <file> exist: causes LICENSE to
                    write the findings and actions to it.

  CHECKONLY         keyword; directs LICENSE to check and display the
                    actual LICENSE flag situation.

  file1 .. filen    is any valid disk file name, or file name template
                    (wildcards are supported)


Restrictions:
=============

  Every user, allowed to run the LICENSE program, can use the CHECKONLY
  command.

  To manipulate the license flags, the user has to be logged on as
  SUPER.SUPER!

  To license the SQLCI2 program, the file name has to be fully
  qualified to the LICENSE tool.
  The command LICENSE $SYSTEM.sys*.SQL* does NOT license SQLCI2! This
  is done for security reasons.



Running LICENSE without any parameter displays a help screen:

$GHS1 LICENS 3> license
LICENSE (410) - T7172H06 - (23Feb2012)
Copyright (c) GreenHouse Software & Consulting 1994 .. 2003,2006 .. 2010
File name missing.
Syntax is:

  LICENSE [/OUT[out-file]/] [CHECK[ONLY]] file [,file] .. [,file]

where
  CHECK[ONLY]  key word, directing LICENSE to display the actual
               license flag settings.
  out-file     name of file to which the results have to be sent to
  file         any valid file name template.

e.g.:

  LICENSE  secom.*,newtrac.tracer

This corrects the license flags of all executables, matching
the given templates.

  LICENSE  CHECKONLY $system.sys*.*

This displays the license flag situation of all executables,
matching the template.

Every user, allowed to run LICENSE, can execute the CHECKONLY command.
To correct the license flags, the user must be logged on to SUPER.SUPER.
$GHS1 LICENS 4>


Some examples:


  LICENSE $ghs1.secom.*,$ghs1.newtrac.*

This command licenses all files in the two mentioned subvols, where a
license is required, and revokes the license from those files, where
it is NOT required.


  LICENSE $System.sys*.*

With this command
- all files matching the template AND requiring a license, get the
  flag set
- all files matching the template, AND having the flag for NO reason,
  get the flag reset.


  LICENSE CHECKONLY $GHS1.*.*

Checks the LICENSE flag situation of all files, residing on volume $GHS1,
and displays it to the user.



Suggested security settings of the LICENSE tool:
================================================
  GUARDIAN security:  OOAO
  Owner:              SUPER.SUPER
  LICENSE has to be licensed.


In case you like this tool - feel free to use it!


For more tools, have a look at: www.GreenHouse.de


Carl Weber
GreenHouse Software & Consulting
23Feb2012
