YFLTMDLLST (Filter a Model Object List) Command

This command allows a user to remove unwanted entries from a model object list.
ca2e87
This command allows a user to remove unwanted entries from a model object list.
An outlist capability allows users to filter entries to an alternative list leaving the input list unchanged by the filtering process.
Contents
Required
YFLTMDLLST-Required
Optional
YFLTMDLLST-Optional YFLTMDLLST-Optional YFLTMDLLST-Optional YFLTMDLLST-Optional YFLTMDLLST-Optional YFLTMDLLST-Optional YFLTMDLLST-Optional YFLTMDLLST-Optional YFLTMDLLST-Optional YFLTMDLLST-Optional YFLTMDLLST-Optional
Parameters
The following are parameters for the YFLTMDLLST command.
DLLST
The qualified name of the model object list that is filtered. Values for these parameters are as follows:
  • *MDLPRF
    -- (default) Special value meaning that the model object list name is retrieved from the user profile extension record for the current user in the specified model library. The change list value is retrieved.
  • *USER
    -- Special value meaning that the user profile name of the current user is used as the list name for the target of the command.
  • *ALLOBJ
    -- Special value meaning that a model object list is not used, but that all model objects are included in the command. If this value is specified for MDLLST, then an OUTLST must also be specified.
  • *SELECT
    -- Special value indicating that the model object list is selected using an interactive display function.
  • list name
    -- The name of the list to be filtered.
  • *MDLLIB
    -- (default) Special value meaning that the first model library found in the user's current library list is used.
  • library name
    -- The name of the model library.
OUTLST
The name of the target model object list for entries that satisfy the filter. Values for these parameters are as follows:
  • *NONE
    -- (default) Special value meaning that no outlist processing is performed. In this case, all changes are made to the input list.
  • *MDLPRF
    -- Special value meaning that the model object list name is retrieved from the user profile extension record for the current user in the specified model library. The outlist value is retrieved.
  • *USER
    -- Special value meaning that the user profile name of the current user is used as the list name.
  • list name
    -- The name of the target list.
OBJNAM
The object name details on which to filter. This parameter consists of up to five sets of three elements which together identify the model objects. Values for these parameters are as follows:
  • *ANY
    -- (default) No filtering by model object name.
  • *ALL
    -- All model object owners are included.
  • owner name
    -- Name mask of the file to which model objects to be included must belong. That is, the condition is satisfied if a given object is owned by the specified file.
  • *ARRAYS
    -- Special value for the product internal file *ARRAYS.
  • *MESSAGES
    -- Special value for the product internal file *MESSAGES.
  • object name
    -- Name mask of the object that is satisfied for a given object to be included.
  • *ALL
    -- (default) All objects are added.
  • *ACP
    -- Objects of type access path.
  • *APP
    -- Objects of type application area.
  • *ARR
    -- Objects of type array.
  • *CND
    -- Objects of type condition.
  • *FIL
    -- Objects of type file.
  • *FLD
    -- Objects of type field.
  • *FUN
    -- Objects of type function.
  • *MSG
    -- Objects of type message.
LSTDATE
The date stored on the model object list entry on which to filter. The value for this parameter is as follows:
  • *ANY
    -- (default) No filtering on list entry date.
  • Otherwise, LSTDATE is a list parameter made up of the following elements:
  • Date type on which to filter:
    • *CHG
      -- (default) Filter on last change date of object.
    • *CRT
      -- Filter on create date of object.
    • *GEN
      -- For generatable objects, filter on last successful generation date of object.
    • *CHK
      -- Filter on the check out date of object.
  • date operator:
    • *EQ
      -- (default) Equal to.
    • *NE
      -- Not equal to.
    • *GT
      -- Greater than.
    • *LT
      -- Less than.
  • date (Entered in system date format):
    • *QDATE
      -- (default) Use current system date.
  • time (Entered in
    hhmmss
    format):
    • *ANY
      -- (default) Any time will satisfy the condition.
OBJDATE
The date stored on the model object record on which to filter. The value for this parameter is as follows:
  • *ANY
    -- (default) No filtering on list entry date.
  • Otherwise, OBJDATE is a list parameter made up of the following elements:
  • Date type on which to filter:
    • *CHG
      -- (default) Filter on last change date of object.
    • *CRT
      -- Filter on create date of object.
    • *GEN
      -- For generatable objects, filter on last successful generation date of object.
    • *CHK
      -- Filter on the check out date of object.
    • *IMP
      -- Filter on the import date of the object.
  • Date operator:
    • *EQ
      -- (default) Equal to.
    • *NE
      -- Not equal to.
    • *GT
      -- Greater than.
    • *LT
      -- Less than.
  • Date (Entered in system date format):
    • *QDATE
      -- (default) Use current system date.
  • Time (Entered in
    hhmmss
    format):
    • *ANY
      -- (default) Any time will satisfy the condition.
CHGUSR
The name of the user who made the change to model objects on which to filter. If used, model objects in the list are filtered according to the current value of the change user field on the model object record corresponding with each list entry. Values for these parameters are as follows:
  • *ANY
    -- (default) No filtering on change user.
  • *CURRENT
    -- The name of the current user is used to filter model objects.
  • user name
    -- The user name on which to filter.
ACTRQD
The model object action required flag on which to filter. If used, model objects in the list are filtered according to the current status of the action required flag on the model object record corresponding with each list entry. Values for these parameters are as follows:
  • *ANY
    -- (default) No filtering on action required flag.
  • *NONE
    -- Model objects with no action required flag set.
  • *ALL
    -- Model objects with action required flag set.
  • *GEN
    -- Model objects with status *GEN satisfy the condition.
  • *EDT
    -- Model objects with status *EDT satisfy the condition.
SYSOBJ
Indicates whether or not the object is a system object to be included in the filtering process. Values for these parameters are as follows:
  • *ANY
    -- (default) No filtering on system object status.
  • *YES
    -- Only system objects satisfy the condition.
  • *NO
    -- Only non-system objects satisfy the condition.
CHGTYP
The change type value assigned to a model object on which to filter. If used, model objects in the list are filtered according to the status of the change type flag on the model object record corresponding with each list entry. Values for these parameters are as follows:
  • *ANY
    -- (default) No filtering on change type flag.
  • *PUBLIC
    -- Model objects with status *PUB satisfy the condition.
  • *PRIVATE
    -- Model objects with status *PRV satisfy the condition.
IPCPRC
Impact processed indicator shows whether the impact of a change to the object has been applied to the using objects of the changed object. Values for these parameters are as follows:
  • *ANY
    -- (default) No filtering on impact processed indicator.
  • *YES
    -- Model objects with impact processed *YES will satisfy the condition.
  • *NO
    -- Model objects with impact processed *NO will satisfy the condition.
PRMTYP
The promotion type value assigned to a model object list entry on which to filter. Values for these parameters are as follows:
  • *ANY
    -- (default) No filtering on promotion type flag.
  • *ADD
    -- Model object list entries with status *ADD satisfy the condition.
  • *CHG
    -- Model object list entries with status *CHG satisfy the condition.
  • *GEN
    -- Model object list entries with status *GEN satisfy the condition.
VSNTYP
The model object version type flag on which to filter. If used, model objects in the list are filtered according to the current status of the version type flag on the model object record corresponding with each list entry. Values for these parameters are as follows:
  • *ANY
    -- (default) No filtering on version type flag.
  • *DEV
    -- Model objects with status *DEV satisfy the condition.
  • *PRD
    -- Model objects with status *PRD satisfy the condition.
  • *ARC
    -- Model objects with status *ARC satisfy the condition.
VSNSNC
The model object version synchronized flag on which to filter. If used, model objects in the list are filtered according to the current status of the version synchronized flag on the model object record corresponding with each list entry. Values for these parameters are as follows:
  • *ANY
    -- (default) No filtering on version synchronized flag.
  • *YES
    -- Model objects with status *YES satisfy the condition.
  • *NO
    -- Model objects with status *NO satisfy the condition.
CHKUSR
The user who checked out the list entry on which to filter. If used, model objects in the list are filtered according to the check out user value on the model object record corresponding with each list entry. Values for these parameters are as follows:
  • *ANY
    -- (default) No filtering on check out user.
  • *CURRENT
    -- The current user name is used.
  • user name
    -- The user name on which to filter.
CHKLST
The list name on which a given list entry is currently checked out. If used, model objects in the list are filtered according to the check out list value on the model object record corresponding with each list entry. Values for these parameters are as follows:
  • *ANY
    -- (default) No filtering on check out list.
  • *CURRENT
    -- The current user name is used for list name filtering.
  • *NONE
    -- Only those objects that have no value specified for check out list satisfy the condition.
  • list name
    -- The list name on which to filter.
CHKSTS
The check out status on which to filter. If used, model objects in the list are filtered according to the check out status value on the model object record corresponding with each list entry. Values for these parameters are as follows:
  • *ANY
    -- (default) No filtering on check out status.
  • status value
    -- The value on which to filter.
CPYOBJ
The status of the copy object indicator on the list entry. Values for these parameters are as follows:
  • *ANY
    -- (default) No filtering.
  • *SELECTED
    -- Selected entries satisfy the condition. Selected means explicitly selected for the purposes of the Copy Model Objects command (YCPYMDLOBJ).
  • *NONE
    -- Entries that are not selected satisfy the condition.
CPYRQD
The status of the copy required indicator on the list entry. Values for these parameters are as follows:
  • *ANY
    -- (default) No filtering.
  • *SELECTED
    -- Selected entries satisfy the condition. Selected means implicitly selected for the purposes of the Copy Model Objects command (YCPYMDLOBJ).
  • *NONE
    -- Entries that are not selected satisfy the condition.
CPYSTS
The status of the copy status indicator on the list entry. Values for these parameters are as follows:
  • *ANY
    -- (default) No filtering.
  • *NEW
    -- Entries with a value of *NEW satisfy the condition.
GENATR
This parameter allows up to five different general attributes of the object to be used in the filtering process. Values for these parameters are as follows:
  • *ANY
    -- (default) No filtering.
  • *OBJDLT
    -- Only entries that refer to deleted objects satisfy the condition.
    When filtering for deleted objects it is not possible to add entries for deleted objects to an output list because the corresponding object does not exist. To process these entries, copy the input list to the output list first, then filter *SELECT the deleted objects.
  • *GENFUN
    -- Only generatable functions satisfy the condition.
  • *GENOBJ
    -- Only generatable objects satisfy the condition.
  • *DBFFUN
    -- Only database functions satisfy the condition.
  • *DEVFUN
    -- Only device based functions satisfy the condition.
  • *DSPFUN
    -- Only display functions satisfy the condition.
  • *EDTFUN
    -- Only edit functions satisfy the condition.
  • *EXTFUN
    -- Only external functions satisfy the condition.
  • *INTFUN
    -- Only internal functions satisfy the condition.
  • *PRTFUN
    -- Only print functions satisfy the condition.
  • *CHGOBJ
    -- Only change object database functions satisfy the condition.
  • *CRTOBJ
    -- Only create object database functions satisfy the condition.
  • *DLTOBJ
    -- Only delete object database functions satisfy the condition.
  • *DSPFIL
    -- Only display file functions satisfy the condition.
  • *DSPREC
    -- Only display record functions satisfy the condition.
  • *DSPTRN
    -- Only display transaction functions satisfy the condition.
  • *EDTFIL
    -- Only edit file functions satisfy the condition.
  • *EDTRCD
    -- Only edit record functions satisfy the condition.
  • *EDTTRN
    -- Only edit transaction functions satisfy the condition.
  • *EXCEXT
    -- Only execute external functions satisfy the condition.
  • *EXCINT
    -- Only execute internal functions satisfy the condition.
  • *PMTRCD
    -- Only prompt record functions satisfy the condition.
  • *PRTFIL
    -- Only print file functions satisfy the condition.
  • *PRTOBJ
    -- Only print object functions satisfy the condition.
  • *SELRCD
    -- Only select record functions satisfy the condition.
  • *USRPGM
    -- Only user program functions satisfy the condition.
  • *USRSRC
    -- Only user source functions satisfy the condition.
OBJATR
This parameter allows model objects to be filtered by up to five different model object attributes. Values for these parameters are as follows:
  • *ANY
    -- (default) No filtering on object attribute value is performed.
  • object attribute
    -- A list of three character object attributes may be entered.
For example, if physical access paths were required, specifying FILTER(*SELECT) OBJATR(PHY) will select any such entries in the input list.
OUTFLAGVAL
This parameter specifies the initial value to be placed in the object selected flag associated with each list entry. Values for these parameters are as follows:
  • *SAME
    -- (default) No flag value is used. New entries are written with the flag indicating that the entry is not selected. No change to the selection status of existing entries.
  • *NONE
    -- New and existing entries are flagged as not selected.
  • *SELECTED
    -- New and existing list entries are flagged as selected. This flag can be used by other list commands when selecting list entries.
OUTCPYOBJ
This parameter specifies the initial value to be placed in the copy object flag associated with each list entry. This flag is used by the Copy Model Object command (YCPYMDLOBJ) when selecting objects to copy to a target model. Values for these parameters are as follows:
  • *SAME
    -- (default) No flag value is used. New entries are written with the flag indicating that the entry is not selected. No change to the selection status of existing entries.
  • *NONE
    -- New and existing entries are flagged as not selected.
  • *SELECTED
    -- New and existing list entries are flagged as selected.
Notes
The input model object list must already exist prior to running this command.
A value other than *MDLLIB for MDLLST may result in the library list being changed. If the user is currently editing a model, the switching of the library list will not occur and the command will fail. If changed during processing, the library list is changed back after execution.
If *ANY is used for a parameter, that parameter is not used for filtering.
The various parameters are ANDed together. Thus, the following request would select all functions from the input list changed today:
       YFLTMDLLST OBJNAM( *ALL *ALL *FUN ) +   DATE(*CHG *EQ *QDATE *ANY ) 
Where a list of values may be specified for a parameter the elements are ORed together. Thus, the following would select access paths or functions that have had an action required since they were last generated:
       YFLTMDLLST OBJNAM((*ALL *ALL *ACP) (*ALL + *ALL *FUN)) ACTRQD(*ALL)
When *ALLOBJ is specified for MDLLST, meaning that all current model objects are examined, then the OUTLST parameter must specify a target model object list.
When filtering on LSTDATE, list entries are filtered according to the value recorded on the list entry. Note that this is historic data relating to the time that the entry was written. Use the Check Model Object list command (YCHKMDLLST) to refresh list entries.
The OUTLSTOPT parameter is ignored if *NONE is specified for OUTLST or if the target model object list does not already exist.
It should be noted that if an OUTLST is specified, there will be no changes to the input list.
Where a name mask is supported, users may specify wild card characters to filter object names. Upper and lower case differences are ignored in these fields.
?
may be used as a wild card character in any position in the string and means match on any character.
*
anywhere within the mask indicates a floating scan.
*
at the end of the mask indicates a generic name. For example:
  • *INV001*
    -- Would select all objects with INV001 anywhere in the name.
  • *INV001
    -- Would select all objects ending with INV001.
  • *INV???
    -- Would select all objects ending with INV at the 4th, 5th and 6th positions from the end.
  • INV*UPD*
    -- Would select objects starting with INV and containing UPD.
Examples
To filter model object list WRKOBJS to out list WRKLST so that it contains all objects requiring a visit due to updates made to component objects:
YFLTMDLLST ( *EDT ) MDLLST +
 (*MDLLIB/WRKOBJS ) OUTLST +
 (*MDLLIB/WRKLST) OUTLSTOPT +
 ( *REPLACE ) ACTRQD
To filter model object list FUNLST so that it contains only objects relating to Costing (note that a reliable naming convention is required for this type of filtering):
YFLTMDLLST ( '*COST*' ) MDLLST + (*MDLLIB/FUNLST) OBJNAM
To filter model object list ALLOBJLST so that it contains only non-current objects:
YFLTMDLLST FILTER( *OMIT ) ( *YES ) + MDLLST(ALLOBJLST ) CUROBJ