Name

bstr_vmd_loop − Perform a user-defined operation on all the objects in a VMD matching a pattern. 

Syntax

bstr_t_status   bstr_vmd_loop (
                                  bstr_t_reference ∗vmd,
                                  bstr_t_component_criteria criteria,
                                  bstr_t_descriptor ∗key,
                                  bstr_t_string    pattern,
                                  int (∗func)()    ∗user_function,
                                  bstr_t_address   user_parameter,
                                  bstr_t_status   continue_on_error,
                                  bstr_t_rcb       ∗control,
                                  bstr_t_sequence  ∗matching_objects,
                                  bstr_t_status    ∗last_status);

Description

The bstr_vmd_loop procedure searches a vmd for all the objects whose name matches a pattern and applies the user-defined function to them. 

See previous paragraph for the concepts related to user function. 

Arguments

vmd
access: read
The reference to the vmd to be examined.

criteria
access: read
See bstr_vmd_get_components. 

key
access: read
See bstr_vmd_get_components. 

pattern
access: read
The optional pattern to be used for matching object names. If not defined, the default pattern "∗" is used.

(∗func)()    ∗user_function
access: read
This optional parameter is activated on the objects belonging to a VMD and matching the pattern.

user_parameter
access: read
This optional parameter specifies a user supplied parameter to be passed to a user function after the reference to an object matching the pattern.

continue_on_error
access: read
Refer to the description in the previous paragraph.

∗control
access: write
The address of an optional request control block.

∗matching_objects
access: write
This optional parameter represents the list of objects satisfying the pattern matching. This parameter of the user function parameter should be provided.

last_status
access: write
See description in the previous paragraph.

Return Values