@broadcom/file-master-plus-for-zowe-cli

CA® File Master Plus Plug-in for Zowe CLI

Usage no npm install needed!

<script type="module">
  import broadcomFileMasterPlusForZoweCli from 'https://cdn.skypack.dev/@broadcom/file-master-plus-for-zowe-cli';
</script>

README

CA® File Master Plus Plug-in for Zowe CLI

Zowe Conformance Badge

The CA® File Master Plus Plug-in for Zowe CLI helps you quickly create, edit, and manipulate files in virtual storage access method (VSAM), sequential, and partitioned data sets.

Example Use Cases:

As a developer or DevOps admin, you can use the REST API for CA File Master Plus to:

  • Populate VSAM file A with newly constructed test data from the REST API interactively using the POPULATE option.
  • Select desired parts of the source and copy only those parts over to a new VSAM file using the COPY (WITH SELECTION CRITERIA) option,
  • Make an exact copy of VSAM file A using only one REST API command using the COPY option.
  • Rename the VSAM file A and B with ARCHIVE as the second qualifier using the RENAME option.
  • Delete VSAM file A using the REST API using the DELETE option.

Build the CA® File Master Plus Plug-in for Zowe CLI from Source

  • The first time that you download the plug-in from the GitHub repository, issue the following command against the local directory:

    npm install

    This command installs the dependencies and development tools that the plug-in requires. You can resubmit the command at any time to update the tools.

  • To build your code changes, issue the following command:

    npm run build

    The first time you build your code changes, you are prompted for the location of the Imperative CLI Framework package. The location is the node_modules/@zowe folder in the directory where you installed Zowe CLI.

  • When you update package.json to include new dependencies, or when you pull changes that affect package.json, issue the following command to download the dependencies:

    npm update

Create Profiles

To create a profile for the plug-in, complete the following tasks:

  • Create a profile using the profiles create fmp command. For information about syntax, parameters and options, issue the following command:

    `zowe profiles create fmp -h`
    
    Example: `zowe profiles create fmp fmp123 --host fmphost --port 19853 --user mfuser --pass m4pass --protocol http`
    
  • Issue the following command to validate the profile:

    `zowe profiles val fmp`
    

Run Tests

After you change the code, run tests by issuing the following command:

`npm run test`

For more information see https://github.com/gizafoundation/brightside/blob/master/docs/PluginTESTINGGuidelines.md

Note: Ensure that you have access to the gizafoundation/brightside project in GitHub to access the link 

Uninstall the Plug-In

To uninstall the plug-in, issue the following command against the local directory:

`npm uninstall`

For more information, see CA File Master Plus Plug-in for Zowe CLI in the CA Brightside documentation.