Foreign Object Maintenance

The foreign object types to be accepted by PAC must be defined by the PAC administrator, using the Foreign Maintenance Administration Function. Then some of these acceptable foreign object types can be allowed for an application and assigned to a location specified in an application-status link for a migration. How to define a foreign type is described here. Allowing an already defined type for an application and assigning it to a location are described in the PAC User's Guide.

Enter Code N on the PAC Administrator Functions Menu to open the following Foreign Maintenance screen.

15:50:38             ***** PREDICT APPLICATION CONTROL *****        2000-01-30
User SAGU                    - Foreign Maintenance -                           
                                                                                
                                                                                
                                                                                
                               Code  Sub-Function                               
                               ----  ---------------------                      
                                 M   Modify Table                               
                                 D   Display Table                              
                                 ?   Help                                       
                                 .   Exit                                       
                               ----  ---------------------                      
                                                                                
                        Code ... _                                              
                                                                                
                                                                                
                                                                                
                                                                                
                                                                                
 Command ===>                                                                   
 Enter-PF1---PF2---PF3---PF4---PF5---PF6---PF7---PF8---PF9---PF10--PF11--PF12---
       Help  Menu  Exit                                                  Canc

Enter Code M (Modify Table) or D (Display table) to display the Foreign Support Maintenance screen.

15:53:25             ***** PREDICT APPLICATION CONTROL *****      2000-01-30
User SAGU                - Foreign Support Maintenance -                      
                                                                                
                                                                                
     No  Code Type Long Text    Short  Description             Add Date   Add User
     --- ---- ---- ------------ ------ ----------------------- ---------  --------
     1   3COL  L   COBOL LOAD__ COB L_ _______________________ 1998-09-19 SAGU    
     2   3COS  S   COBOL SOURCE COB S_ _______________________ 1998-09-19 SAGU    
     3   3JCL  S   JCL TEXT____ JCL___ _______________________ 1998-09-19 SAGU    
     4   3POM  S   POEM________ POEM__ _______________________ 1998-12-14 SAGU    
     5   ____  _   ____________ ______ _______________________                  
     6   ____  _   ____________ ______ _______________________                  
     7   ____  _   ____________ ______ _______________________                  
     8   ____  _   ____________ ______ _______________________                  
     9   ____  _   ____________ ______ _______________________                  
     10  ____  _   ____________ ______ _______________________                  
     11  ____  _   ____________ ______ _______________________                  
     12  ____  _   ____________ ______ _______________________                  
                                                                                
                                                                                
 Command ===>                                                                   
 Enter-PF1---PF2---PF3---PF4---PF5---PF6---PF7---PF8---PF9---PF10--PF11--PF12---
       Help  Menu  Exit              Top   Up    Down                    Canc

If you accessed the table, using the M (Modify Table) code, you can add or modify the types of foreign datasets to be supported at your site. Object types not entered on this table will not be displayed in further selection screens.

Every dataset name and type entered in this table will be stored as a record on the ACF to facilitate the use of the table in the future.

The purpose of this table is to reduce the complexity for the application developer by reducing the list of supported foreign objects. When defining an application, the project leader may want to further limit the foreign objects supported for a particular application. This will make the selection of foreign objects easier since the user will not be concerned with foreign objects their application does not use.

Note:
A foreign type definition can be purged only if it is not allowed for any application and not assigned to any location specified in an application-status link. To purge such a definition, blank out its line on the Foreign Support Maintenance screen.

Start of instruction set To define a foreign dataset to be supported by your PAC installation:

  1. Enter an object Type code.

    For foreign objects, the type code is automatically prefixed with a "3". You are allowed to specify up to three additional characters. This code is used to identify the object type on the object list for migration events and must uniquely identify the dataset. This code cannot be modified once the dataset has been used.

  2. Enter an object format (Fmt).

    Valid values for the object format include

    S for source code, the default.
    L (Load) for compiled (object) code.
  3. Enter both a Long Text and a Short text name for the dataset, and a short Description.

    The long text name is limited to 12 characters; the short text name to 6 characters; and the description to 15 characters.