Sharing files to a loaded repository workspace

After you create files, you can share the files to an already loaded repository workspace.

About this task

When you share files to a loaded repository workspace, you must specify the target repository, component, zComponent project, zFolder, and file extension for the file to be shared. You can share an individual file in a data set or share all unshared files in a data set. You can share a file from either the Source Control panel or the z/OS Data Sets panel. Whether you are sharing a single file or multiple files, the processes of sharing the files are the same. There are two methods you can use to set the properties.
  1. You can specify the properties for the file by selecting an existing file as the model to use for the properties of the new file.
  2. You can specify the properties for the file by entering the information for the properties into the product panels.
To select an existing file as a model for the properties you want the new file to have, follow these steps:
  1. You can share a file from either the Source Control panel or the z/OS Data Sets panel. Enter SL (share like) next to the file you want to use as the model for the properties of the file.
  2. On the Member Model Selection panel, select the member that you want to use as a model for the properties of the new member you are sharing. If there are many members to select from as the model, enter Locate on the command line with a case-sensitive member name. Locate can be abbreviated as Loc or L.
  3. On the New Change Set panel, you can specify the work item to associate with sharing this new member. If you want to create a new work item, enter a forward slash (/) next to that option. Press the Enter key to share the member.
    Note: You can press F3 to exit from the panel or F12 to cancel the information you entered. If you use these function keys, the share is completed and associated to a change set, but without a comment or an associated work item.
  4. On the Confirm Share Like panel, review the information to ensure that it is correct, and press the Enter key. Members are shared with the same properties as the model member.
    Note: If you press F3 to exit from the panel or F12 to cancel the information you entered, the share is canceled.
To specify the properties for the files in the panels, follow these steps:
  1. To share a single file, enter an S next to the file with the question mark (?) on the Source Control panel. To share all unshared files in a data set, enter an S next to the data set on the z/OS Data Sets panel.
  2. After you enter the S on one of the panels, press the Enter key.
  3. In the Select Repository Workspace panel, enter a forward slash (/) next to one of the currently loaded repository workspaces where the files are to be shared and press the Enter key.
  4. On the Select Component panel, decide where to store the files.
    1. To share files to a new component, enter a forward slash (/) next to New component, enter the new component name, and press the Enter key to create the component.
    2. To share files to an existing component, enter a forward slash (/) next to the component in the repository workspace where the files are to be shared and press the Enter key.
  5. On the Select zComponent project panel, decide where to share the files.
    1. To share files to a new component, enter the new zComponent project name.
    2. To share files to an existing component, decide in which zComponent project to share the files.
      • To share files to a new zComponent project, enter a forward slash (/) next to the New zComponent Project and enter the zComponent project name. Press the Enter key to create the project.
      • To share files to an existing zComponent project, enter a forward slash (/) next to an existing zComponent project and press the Enter key.
        • On the Select zFolder panel, decide in which zFolder to share the files.
          • To share files to an existing zFolder, enter a forward slash (/) next to the zFolder and press the Enter key.
          • To share files to a new zFolder, enter a forward slash (/) next to the New zFolder choice and press the Enter key.
  6. Enter a zFolder name on the Associate Data Set Definition panel.
    • Associate the zFolder with a new data set definition by entering a forward slash (/) next to New Data Set Definition. A new data set definition is created with the same name as the zFolder. If a data set definition exists with the zFolder name, the data set definition name is named with the zFolder name and a number, such as COBOL(2).
    • Associate the zFolder with an existing data set definition by entering a forward slash (/) next to the data set definition in the list.
  7. Specify zFile extensions and properties on the Specify zFile Extensions/Properties panel. You can enter the following items on the Specify zFile Extensions/Properties panel:
    1. Optional: Enter the extension for the file and press the Enter key.
      Note: File extensions are disregarded when you are working on z/OS. However, if you load zFiles to a computer with an operating system that uses extensions, a file extension helps ensure that an appropriate editor opens the zFile.
    2. You can enter a forward slash (/) in the file properties column to specify specific file properties for the file. If you are sharing multiple files at the same time, you can apply one set of file properties for all files. Enter a forward slash (/) next to Specify File properties for all files.
  8. If you entered a forward slash (/) in the file properties column of the Specify zFile Extensions/Properties panel, you can enter more properties in the zFile information panel:
    Code page
    If the file you are editing must display in a particular code page in the ISPF client, set the code page in this field. The file is stored with the default code page of the repository, which is normally UTF-8. The file is converted to the local EBCDIC code page when it is transferred to z/OS. If the code page property exists and you must delete the current code page property, enter a forward slash (/) next to Code Page.
    Binary mode
    If you the selected file must be stored in the repository as a binary file, enter a forward slash (/) next to Binary mode. The line delimiter file property is set to None (Binary) and the MIME Type property is set to application/unknown.
    Ignore Changes
    To not include this file during a dependency build as a change, enter a forward slash (/) next to Ignore Changes.
    Always Load
    To always load this file during dependency builds, enter a forward slash (/) next to Always Load. You do not have to load an entire repository workspace when you run a build. You can load only those files in the dependency set of the programs you are building. If a file you need is not a part of one of those dependency sets, select Always load during dependency build.
    User Variables
    To specify or change file-specific values for a variable that is specified in a translator, enter a forward slash (/) next to User Variables. If a translator accepts a user variable to specify the TEST option on a compilation, set the user variable to turn on the TEST option for just this file. For more information about translator variables, see Creating a z/OS language definition.
    Language Definition
    • If there is an associated language definition for the file, the language definition is shown in the field.
    • If no language definition is associated with the file, but the file extension is registered in an existing language definition, that language definition is shown in the field.
    • To select a language definition to associate with the file, enter a 1 in the action field to browse the available language definitions. On the Language Definitions List panel, enter a forward slash (/) next to the language definition to use when the build includes the file. Press the Enter key to add the language definition to the zFile information panel.
    • To dissociate the language definition that is shown in the field, enter a 2 to clear the language definition. If the file extension is registered in an existing language definition, that language definition replaces the cleared language definition.
  9. When you finish entering properties in the zFile information panel, press F3 to process the properties. You can also press F12 to cancel the properties and return to the Specify zFile Extensions/Properties panel.
  10. On the New Change Set panel, you can specify the work item to associate with sharing this new member. To create a new work item, enter a forward slash (/) next to that option. Press the Enter key to share the member.
    Note: You can press F3 to exit from the panel or F12 to cancel the information you entered. If you use these function keys, the share is completed and associated to a change set, but without a comment or an associated work item.

video icon Video

Jazz.net channel
Software Education channel

learn icon Courses

IoT Academy
Skills Gateway

ask icon Community

Jazz.net
Jazz.net forums
Jazz.net library

support icon Support

IBM Support Community
Deployment wiki