ZZUtils - ZZLOCATE

This utility locates a Natural Module; it determines which application libraries contain the specified Natural member(s).  In addition to the library names, the userid and date and timestamps are listed.  This allows the user quickly to see how many versions of the member exist and which version contains the most recent updates.

The program requires the user to enter a member name or wildcard.  A wildcard is specified with an asterisk ('*') delimiter.

If both source and cataloged objects exist for a member, the date and timestamp data will reflect that of the source module.  This default may be overridden via the second, optional, input parameter, in which case the date and timestamp data will reflect that of the cataloged module.

ZZLOCATE's search is limited to the current FUSER file; it does not search multiple data bases.

ZZLOCATE may be executed on-line or in batch.  The simplest way to invoke it is on the command line:

For example, the command "ZZLOCATE ZZADACMD" produces a "standard" report, while the command "ZZLOCATE ZZADA*" produces a "wildcard" report.  If ZZLOCATE is invoked without parameters, a selection screen is displayed.
 

The report's data columns are defined as follows.
 
Library The Natural libraries in which the module was found.
Module This is displayed only if a wild card is specified.  In any case the report header contains the module name specification. 
Type The type of module found.
Typ The type of object found, source and/or cataloged.
D Blank if the source and cataloged objects have identical timestamps; contains '*' otherwise.
Userid The ID of the user who updated the timestamp.
Date Time The timestamp of the latest SAVE, CATalog, or STOW.  If both source and cataloged modules exist, refer to the header to determine which timestamp is displayed.  In "Last Updated (x)", 'x' will contain S or C, indicating source and cataloged, respectively. 
Term The terminal ID where the timestamp was updated.
Nat SM The version of Natural when the timestamp was updated.


ZZLOCATE Selection Screen:
 
 ZZLOCATE Natural Utilities                                       98-02-28 15:02 
          Locate a Natural Module 
 
 

                  Enter program name (or wildcard): ________ 

               Timestamp override (Source|Catalog): S 
 
 
 
 
 
 
 
 
 
 
 
 

          PF3/PF15 Exit                      PF11/PF23 Author 
 
 


ZZLOCATE Standard Listing:
 
 ZZLOCATE Natural Utilities                                       98-02-28 15:03 
          ZZADACMD exists in the following libraries                    Page:  1 

                            ..............  Last Updated (S)  ............... 
 Library  Type        Typ D Userid     Date     Time   Term    ADA  Nat SM 

 ARGDEVLP Program       C   C000128  94-03-28 20:21:30 C000128      2.2 0006 
 ZZUTIL   Program     S/C * C000128  93-07-08 19:15:09 C000128      2.1 0007 
                       -----  End of Library List  ----- 
 
 
 
 
 
 
 
 
 
 
 
 

 Press ENTER for a new selection or PF3/PF15 to exit 
 

ZZLOCATE Wildcard Listing:
 
 ZZLOCATE Natural Utilities                                       98-02-28 15:11 
          ZZADA*   exists in the following libraries                    Page:  1 

                                     ...........  Last Updated (S)  ............ 
 Library  Module   Type        Typ D Userid     Date     Time   Term    Nat SM 

 ARGDEVLP ZZADACMD Program       C   C000128  94-03-28 20:21:30 C000128 2.2 0006 
 ZZUTIL   ZZADACMD Program     S/C * C000128  93-07-08 19:15:09 C000128 2.1 0007 
          ZZADAR01 Program     S     TGRTRGZ  94-10-03 14:16:22 TGRTRGZ 2.2 0005 
          ZZADAR02 Program     S     TGRTRGZ  94-10-03 14:17:30 TGRTRGZ 2.2 0005 
                       -----  End of Library List  ----- 
 
 
 
 
 
 
 
 
 
 

 Press ENTER for a new selection or PF3/PF15 to exit 
 

ZZLOCATE is in the object module section of ZZUtils, a collection of Natural utilities.

Return to top.

Return to Ralph G. Zbrog's home page.

Last updated April 25, 1998, by Ralph G. Zbrog.