CARMA preferences

CARMA has several settings that can be modified through preferences. To access these settings, in the Preferences window, expand the Team node, and select CARMA. The CARMA preferences can also be accessed by selecting Preferences from the menu bar of each of the three CARMA views. Each of the check boxes in this menu modifies some setting in CARMA.

Disable known unsupported actions: Marking this check box disables any actions a RAM reports as unsupported. For example, the sample PDS RAM does not support the Check-out action. When you try to use this option, a message appears stating that the particular action is not supported and disable the action from selection.
Custom parameter search order: Marking this check box sets the order of where to look for values for custom parameters. When a custom action is run that requires custom parameters, Developer for z/OS® searches through the metadata in an attempt to find values for the parameters. You can adjust the order of this search by moving each metadata location up or down in the list using the buttons to the right. User Entered values are values that are previously entered by the user on the same action but not necessarily on the same member. For example, if User Entered was set at the highest level in the Custom Parameter Search Order and Action 1 was called on Member 1 and then Action 1 was called on Member 2, then the user entered values for custom parameters would be pre-filled in for the user to update, change, or resubmit. A similar example of this is if Action 1 was called on Member 1 and then Action 2 was called on Member 2 and Action 2 requests a parameter that is requested by Action 1, the values for this custom parameter will not be pre-filled for the user.; Property Values are metadata, or member information, with the same name as the parameter. For each CARMA member, there is a list of property values that are associated with the member. If a custom action requests a parameter with the same name as a key in the property value list, then it will automatically fill the custom parameter with the value associated with the key.; Finally, the Server Specified Defaults are the default values set up for the parameter in the VSAM configuration files. These defaults are created when a custom parameter is created for use with a particular custom action on some RAM.
Always prompt for parameter values: Marking this check box shows the prompt to enter parameter values, even if the values have been stored in the metadata from a previous call. When the check box is cleared, the first time a user calls an action, the prompt to enter parameter values is shown, but for any subsequent call on the action, the previously entered values are sent without prompting the user for updates.
Prompt for confirmation when deleting: Marking this check box ensures that a prompt is shown to the user verifying that the delete was intentional. When the check box is cleared, the prompt to verify with the user will not be displayed
Prompt for confirmation when moving project association to RAM: Marking this check box ensures that a prompt is shown to the user when they do something that would cause a local or z/OS project to be associated with multiple repository instances. When this happens, the association changes from the original repository instance to the RAM itself. The prompt notifies the user that the association is changing to the RAM and gives the user the option to cancel the action and the change in association. Users can be notified of this association change as CARMA actions can be called only against what a particular member or container is associated to, and behavior can vary between a repository instance and a RAM. Clearing the check box turns off this prompting.
Check for host modifications before replacing the member: Marking this check box prompts the user if changes have occurred in the CARMA member before checking it in. For example, if a CARMA member checked out to a local project has unchecked in modifications and the version of the CARMA member in the repository has already been modified, then when a user attempts to check in his or her changes to the CARMA member a notification is displayed informing that the checked-out CARMA member is not the most up to date and checking in changes might cause the already checked in changes to be lost.
Refresh affects only direct children: Marking this check box only allows the refresh of CARMA containers and members to go one level deep. Clearing this check box allows for a recursive refresh of the CARMA containers and members. However, a recursive refresh is expensive and time consuming, so generally keeping the check box marked is a good thing.
Show the resource display metadata in the CARMA view: Marking this check box sets CARMA to display metadata, such as file extensions, in the CARMA view. The metadata has to be downloaded from the RAM in order for it to be displayed which is what the following two settings address. Clearing this check box keeps the metadata from downloading from the host and as a result no file extensions are shown on CARMA members.
Retrieve the resource display metadata automatically: Marking this check box sets CARMA to automatically download the metadata from the RAM for each CARMA member and the file extensions show up automatically. For metadata to show up when this check box is cleared, the user must select the CARMA member at least once at which time the particular metadata is downloaded from the RAM.
Retrieve resource display metadata on containers: This setting is not available to mark if the check box, Retrieve the resource display metadata automatically is not selected. Marking this check box sets the metadata that is downloaded from the RAM to be downloaded from the containers rather than each individual CARMA member. This ends up grabbing a smaller amount of metadata from the host, and as a result all CARMA members contain the same file extension and metadata that is associated with CARMA. The exception to this is when a specific CARMA member has a different extension set and the metadata for that member is retrieved separately, such as when a user views the member's properties.
Clear all CARMA 'do not show again' settings and show all hidden dialogs again: Selecting Clear resets all of the CARMA dialog windows that feature a 'do not show again' option. After the settings are cleared, these dialog windows will be displayed again in the future.