Previous Topic Next topic Print topic


Actions and Tools

The following actions are used in the example AWM model:

Action Descriptor ID Description
PDSSAMP_ ACT_FilterMembers Creates an element list on the basis of a filter.  

Is assigned to the filter type and will be executed via the context menu of a filter or a double click (depending on the "Default Action" attribute in "FilterType has Action”).

PDSSAMP_ ACT_GetAllProperties Returns missing properties of an element and its correct element type if PDSSAMP_ACT_FilterMembers cannot determine it.  

Is assigned to each element type and is executed via the context menu entry of an element (“Refresh Element Properties”).

PDSSAMP_ ACT_GetDatasets Returns all the data sets of a project.  

Is assigned to the container element of the first level (PDSSAMP_ELE_Project) and will be executed when expanding the project container element.

PDSSAMP_ ACT_GetProjects Returns all “Projects” (first level of the Container hierarchy). By default this is the user’s mainframe system identification (TSO userid).  

Is referenced by the Root Containers action attribute of the application Options.

PDSSAMP_ ACT_RemoteBrowse Opens an element in the editor (read-only access).  

Is assigned to all element types and can be called up via their context menus.

PDSSAMP_ ACT_RemoteEdit Opens an element in the editor and permits changes.  

Is assigned to the element type ELE_EDITABLE and can be called up via its context menu.

PDSSAMP_ ACT_RetrieveDatasets Returns all the data sets on the basis of a generic input string.

Example: USERID.* delivers:

USERID.COBOL

USERID.PLI

USERID.JCL

Is assigned to the “PROP_Dataset” property and can be executed via input dialogs (including filter dialog) (“Retrieve” button).

PDSSAMP_ACT_ShowMembers

Returns all members of a MVS PO data set.

PDSSAMP_ACT_SearchMembers

Performs a string search on the members of a MVS PO data set.

The following tool descriptors’ actions are necessary to support the actions defined above. The ISPF tools are all of type "Execute ISPF Command" from the ISPF function package.

Tool Descriptor Attribute Meaning
PDSSAMP_ TOOL_ISPF_REX_GetProjects Program ID =

TAUPDGPR

Name of a REXX procedure that returns all the projects (as standard, only the userid) in one file.
PDSSAMP_TOOL_ISPF_REX_GetDatasets Program ID =

TAUPDGPD  

Out Parm Separator = “,“

Name of a REXX procedure that returns all matching data sets to the projects (property values inclusive) in one file.
PDSSAMP_TOOL_ISPF_REX_RetrieveDatasets Program ID =

TAUPDGPL

Name of a REXX procedure that returns all matching data sets to a Search string in a file.
PDSSAMP_TOOL_ISPF_REX_FilterMembers Program ID =

TAUPDELI  

Out Parm Separator = “,“

Name of a REXX procedure that returns an element list, including element properties, in a file on the basis of two parameters (filter criteria).
PDSSAMP_TOOL_AWM_RemoteEdit Tool "Edit MVS File" from the AWM function package Opens the file in which the file descriptor of the input parameter is described in the editor and saves changes.
PDSSAMP_TOOL_AWM_RemoteBrowse Tool "Browse MVS File" from the AWM function package Opens the file in which the file descriptor of the input parameter is described in the editor (read-only).
PDSSAMP_TOOL_REX_GetAllProperties Resource Processing = UPDATE  

Program ID =

TAUPDEPR  

Out Parm Separator = “,“

Updates the selected element with the values that are returned by the tool.  

The REXX procedure TAUPDEPR delivers the suffix, the name of a property set and the element type (match name) to an element if the information is available.  

As spaces can occur in the outputs of the tools, commas are used for the separation of outputs.

PDSSAMP_TOOL_AWM_UI_SearchMember

Tool "Open Modeled Dialog" from the AWM function package

Shows the input dialog for the search tool.

PDSSAMP_TOOL_ISPF_REX_SearchMembers

ProgramID = TAUTOSRC

In Parm Separator = "+%"

Performs a string search in the members of a MVS PO data set.

The table shows only those tool descriptors and relationships whose attribute values cannot be found in the figure above.

The Action Descriptor "PDSSAMP_ACT_RemoteEdit" references the "PDSSAMP_ICON_ELE_Edit" icon.

The figure below shows how the action descriptors must be modeled.

Previous Topic Next topic Print topic