System Active Retrieval

This document covers the following topics:

Displaying the System Active Retrieval Screen
Retrieval Type and Output Mode
Limiting the Scope of System Active Retrieval
Retrieval Types

Displaying the System Active Retrieval Screen

The System Active Retrieval screen is displayed with function code A and object code SY in a main menu or the command ACTIVE SYSTEM.

    13:34:23             *****  P R E D I C T  *****              2007-05-31
    Plan   3              - (SY) System Active Retrieval -              Profile HNO
   
      Retrieval type                          Retrieval type
   
      D  Systems                              I  Libraries
      P  Systems containing programs          O  Libraries not documented
      N  Systems not implemented              T  Libraries with members
   
    Retrieval type .....
    Output mode .......* L  List
   
    System ID ..........                                  System of type ..*
    Library ............                                  User system Fnr ..
    Library structure .*                                  User system DBnr .
   
   
    Restrictions ......*   Profile HNO,used
    Output options ....*   Profile HNO
   
    Command ===>
    Enter-PF1---PF2---PF3---PF4---PF5---PF6---PF7---PF8---PF9---PF10--PF11--PF12---
          Help  Next  Stop  Last  LnkEl Flip  Print Impl  AdmFi SelFi Prof  Main

System Active Retrieval functions retrieve information from Predict system objects that are regarded to be implemented and XRef data for objects contained in the respective libraries (systems). A Predict system object is regarded to be implemented if

an implementation pointer exists and points to a Natural library that contains objects cataloged with the active reference option switched on
DB2 application plan exists, indicating the system is physically implemented in DB2.

Retrieval Type and Output Mode

An active retrieval operation consists of a retrieval type and an output mode. The retrieval types are described in more detail below. The output mode determines how the results are presented. Not all output modes are valid for all retrieval types. See table below.

Retrieval Type	Code	Output Mode
Retrieval Type	Code	select	list	disp
Systems	D	Y	Y	Y
Libraries	I	Y	Y
Systems not implemented	N	Y	Y
Libraries not documented	O	Y	Y
Systems containing programs	P		Y	Y
Libraries with members	T		Y

Limiting the Scope of System Active Retrieval

Not all parameters are valid for all retrieval types. See table below.

Parameter	Retrieval Type
Parameter	D	I	N	O	P	T
System ID	X		X		X
System of type	X		X		X
Library	X	X		X	X	X
User system Fnr	X	X		X	X	X
User system DBnr	X	X		X	X	X
Library structure					X
Restrictions	X		X		X
Output options	X	X	X	X	X	X

Parameter	Description
System ID	Restricts operation to system with ID specified. Use asterisk notation to specify a range.
Systems of type	Restricts operation to systems of type specified. Enter asterisk for possible values. Enter blank for all program types.
Library, User system Fnr, DBnr	These three parameters restrict the operation to programs with the implementation pointer specified. Enter asterisk to specify range.
Library structure	Only systems with an implementation pointer that can be found in the steplib structure defined in this Library Structure and with children of type Program are evaluated. See Systems containing programs. The full implications of this parameter are described in the section Steplib Support #n the Predict and Other Systems documentation.
Restrictions	The scope of the function can be limited by Restrictions. Restrictions can be specified temporarily with code T in this field or taken from a profile. See Using Restrictions and Output Options from Profiles. Restrictions apply only to Predict objects. They cannot be applied to libraries, for example.
Output options	Output options determine the amount of information contained in a report. Output options can be specified temporarily with code T in the field Output options or taken from a profile. Enter asterisk for valid values or see Output Options for more information.

Retrieval Types

Systems - Code D

Provides information on systems by invoking the retrieval type of same name. Output mode D, L or S must be specified:

Output Mode	Description
D	Shows for each system the attributes that are specified in the output options. Command: `DISPLAY SYSTEM`
L	Lists systems with their main attributes. Command: `LIST SYSTEM`
S	Produces a list as above from which systems can be selected for further processing or commands added to the workplan. Command: `SELECT SYSTEM`

Libraries - Code I

Provides information on applications that use Natural members along with any Predict system definitions. Output mode L or S must be specified:

Output Mode	Description
L	Lists implemented libraries. If the library is defined in Predict, the corresponding system is also indicated. If not, libraries are marked >>>>library not documented<<<<. Command: `LIST LIBRARY`
S	Produces list as above, from which libraries can be selected for further processing. Command: `SELECT LIBRARY`

Systems not implemented - Code N

Provides information on systems which are documented in Predict but do not correspond to applications actually in use. Output mode L or S must be specified:

Output Mode Description

Output Mode	Description
L	Lists systems not implemented. System type, library, file number and database number are also given. If no implementation data is available, the message >>>no pointer<<< appears. For DB2: plan name is given instead of library, file and database number. If plan name does not exist, the message >>>not in catalog<<<< appears. Command: Note: `XIST SYSTEM`
S	Produces list as above, from which systems can be selected for further processing or commands added to the workplan. Enter an asterisk in field Cmd for list of possible functions.

Lists systems not implemented. System type, library, file number and database number are also given. If no implementation data is available, the message >>>no pointer<<< appears.

For DB2: plan name is given instead of library, file and database number. If plan name does not exist, the message >>>not in catalog<<<< appears.

Command: Note: XIST SYSTEM

S Produces list as above, from which systems can be selected for further processing or commands added to the workplan. Enter an asterisk in field Cmd for list of possible functions.

Libraries not documented - Code O

Provides information on libraries that use Natural members but have no corresponding Predict definitions. Output mode L or S must be specified:

Output Mode	Description
L	Lists libraries not defined in Predict. File number and database number are also indicated. List is sorted by database number. Command: `UNDEFINED LIBRARY`
S	Produces list as above, from which libraries can be selected for further processing.

Libraries with members - Code T

Provides information on applications which use Natural members and data areas, along with any members and any corresponding Predict program definitions that exist.

Command: ELEMENTS LIBRARY

Output mode L must be specified:

Output Mode	Description
L	Lists libraries with members. If a member is defined in Predict, the corresponding program is also indicated. If not, the member is marked >>>not documented<<<.

Systems containing programs - Code P

Lists systems with programs contained in them. For each system all linked programs and all programs for which XRef data exist in the documented library are listed. Output mode L or D must be specified.

Output Mode	Description
L	Name, type and implementation pointer of the system and at least one line for each program contained in the system is displayed, depending on the output options specified. Command: `CONTAINING PROGRAM`
D	Produces list as above, but more information about the system is displayed.

For more information on executing this function with parameter Library structure, see the section Steplib Support in the Predict and Other Systems documentation.