{"id":32124002,"url":"https://github.com/controlm/ctm-vscode-extension","last_synced_at":"2026-02-21T19:34:16.780Z","repository":{"id":108805446,"uuid":"556797740","full_name":"controlm/ctm-vscode-extension","owner":"controlm","description":"Control-M extension for Visual Studio Code","archived":false,"fork":false,"pushed_at":"2025-10-30T14:57:38.000Z","size":1511,"stargazers_count":0,"open_issues_count":1,"forks_count":2,"subscribers_count":3,"default_branch":"main","last_synced_at":"2026-02-13T08:15:50.264Z","etag":null,"topics":["automation","automation-api","control-m","controlm","jobs-as-code","orchestration"],"latest_commit_sha":null,"homepage":"","language":null,"has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"apache-2.0","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/controlm.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":"CODE_OF_CONDUCT.md","threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null}},"created_at":"2022-10-24T14:31:04.000Z","updated_at":"2025-10-30T14:57:42.000Z","dependencies_parsed_at":"2024-03-13T06:37:20.771Z","dependency_job_id":null,"html_url":"https://github.com/controlm/ctm-vscode-extension","commit_stats":null,"previous_names":[],"tags_count":0,"template":false,"template_full_name":null,"purl":"pkg:github/controlm/ctm-vscode-extension","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/controlm%2Fctm-vscode-extension","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/controlm%2Fctm-vscode-extension/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/controlm%2Fctm-vscode-extension/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/controlm%2Fctm-vscode-extension/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/controlm","download_url":"https://codeload.github.com/controlm/ctm-vscode-extension/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/controlm%2Fctm-vscode-extension/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":29424982,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-02-13T22:20:51.549Z","status":"ssl_error","status_checked_at":"2026-02-13T22:20:49.838Z","response_time":78,"last_error":"SSL_read: unexpected eof while reading","robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":false,"can_crawl_api":true,"host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["automation","automation-api","control-m","controlm","jobs-as-code","orchestration"],"created_at":"2025-10-20T21:34:32.660Z","updated_at":"2026-02-21T19:34:16.774Z","avatar_url":"https://github.com/controlm.png","language":null,"funding_links":[],"categories":[],"sub_categories":[],"readme":"# Jobs-As-Code Werkzeugkiste for Control-M Next Generation\r\n\r\n**Orchestrate the Impossible™**\r\n\r\nIntegrate BMC Control-M workflows with Visual Studio Code. Write, manage, and deploy Control-M jobs using modern development practices.\r\n\r\n![Version](https://img.shields.io/badge/Version-1.0.7-brightgreen) ![License](https://img.shields.io/badge/License-Apache%202.0-blue) ![Publisher](https://img.shields.io/badge/Publisher-BMC%20Software-blue) ![](https://img.shields.io/badge/dynamic/json.svg?label=Build%20State\u0026url=https://raw.githubusercontent.com/controlm/ctm-vscode-extension/main/package.json\u0026query=build\u0026colorB=red)\r\n\r\n## Overview\r\n\r\nThe Control-M Extension brings enterprise workflow automation capabilities directly into VS Code. Build, test, and deploy Control-M jobs using Jobs-as-Code with full IDE support.\r\n\r\n**Key Features:**\r\n- 🌳 **Visual Infrastructure Browser** - Browse Control-M/Servers, Agents, and Host Groups\r\n- 📋 **Job Management** - Create and manage Control-M jobs from VS Code\r\n- 🔌 **Connection Profiles** - Manage multiple Control-M environments\r\n- 📝 **Code Snippets** - Pre-built templates for jobs and configurations\r\n- 🔄 **Jobs-as-Code** - Define workflows in JSON or Python\r\n- 📊 **Telemetry** - Usage and feature tracking (experimental)\r\n\r\n## Quick Start\r\n\r\n### 1. Installation\r\n\r\nInstall from VS Code Marketplace: [Jobs-As-Code Werkzeugkiste for Control-M Next Generation](https://marketplace.visualstudio.com/items?itemName=bmcsoftware.jobs-as-code)\r\n\r\n```\r\next install jobs-as-code\r\n```\r\n\r\n\r\nOr install manually:\r\n```bash\r\ncode --install-extension jobs-as-code-x.y.z.vsix \r\n```\r\n\r\n### 2. Configure Connection\r\n\r\n1. Open VS Code Settings (`Cmd+,` or `Ctrl+,`)\r\n2. Search for \"Control-M\"\r\n3. Configure:\r\n   - **Control-M URL**: Your Automation API endpoint (e.g., `https://ctm.example.local:8443/automation-api`)\r\n   - **API Token**: Your Control-M API token (stored securely)\r\n\r\nOr use `.ctm_connection.json` in your workspace:\r\n```json\r\n{\r\n  \"endpoint\": \"https://ctm.example.local:8443/automation-api\",\r\n  \"token\": \"your-api-token\"\r\n}\r\n```\r\n\r\n**Getting an API Token:**\r\n```bash\r\n# Login to get token\r\nhttps://ctm.example.local:8443/Welcome\r\n```\r\n\r\n### 3. Start Using\r\n\r\n1. Open Command Palette (`Cmd+Shift+P` or `Ctrl+Shift+P`)\r\n2. Type \"Control-M\" to see available commands\r\n3. Try \"Control-M: Show Infrastructure\" to browse your environment\r\n\r\n## Features in Detail\r\n\r\n### Infrastructure Browser\r\n\r\nView your Control-M environment structure:\r\n- **Control-M/Servers** - All registered servers\r\n- **Agents** - Agents by server with status indicators\r\n- **Host Groups** - Logical agent groupings\r\n\r\n**Usage:**\r\n1. Click Control-M icon in Activity Bar\r\n2. Expand servers to see agents\r\n3. Right-click items for context actions\r\n\r\n### Job Management\r\n\r\nCreate and manage jobs using modern development practices:\r\n- **JSON Jobs** - Define jobs in JSON format\r\n- **Python Jobs** - Use Python API for complex workflows\r\n- **Snippets** - Quick templates for common job types\r\n\r\n**Supported Job Types:**\r\n- Command jobs\r\n- Script jobs\r\n- Application Integrator jobs\r\n- AWS ECS jobs\r\n- And more...\r\n\r\n### Code Snippets\r\n\r\nType `ctm-` in JSON or Python files to see available snippets:\r\n- `ctm-job-simple` - Basic job template\r\n- `ctm-job-aws-ecs` - AWS ECS job\r\n- `ctm-connection-profile` - Connection profile\r\n- `ctm-python-job` - Python API job\r\n\r\n### Settings\r\n\r\nConfigure the extension behavior:\r\n\r\n| Setting | Description | Default |\r\n|---------|-------------|---------|\r\n| `controlm.endpoint` | Automation API URL | (none) |\r\n| `controlm.token` | API authentication token | (none) |\r\n\r\n## Documentation\r\n\r\nComprehensive documentation is available to help you get the most out of the Control-M Extension:\r\n\r\n### 📚 [Getting Started Guide](docs/GETTING_STARTED.md)\r\nComplete guide for new users:\r\n- Installation and setup instructions\r\n- Initial configuration walkthrough\r\n- Your first tasks with the extension\r\n- Troubleshooting common issues\r\n\r\n### 📖 [Features Guide](docs/FEATURES_GUIDE.md)\r\nDetailed reference for all extension capabilities:\r\n- Infrastructure Management (Datacenters, Agents, Host Groups, etc.)\r\n- Workload Management (Folders, Jobs, Export functionality)\r\n- Data Services (MFT/MFTE configuration and management)\r\n- Job Development (Build, Run, Deploy services)\r\n- Code Snippets and templates\r\n- Configuration options and advanced features\r\n\r\n### 🔧 [REST API Reference](docs/REST_API_REFERENCE.md)\r\nTechnical documentation for developers:\r\n- Complete list of Control-M Automation API endpoints used\r\n- Request/response formats and examples\r\n- Authentication and security details\r\n- Performance considerations and best practices\r\n\r\n### 📝 [Snippets Guide](docs/SNIPPETS_GUIDE.md)\r\nComplete reference for all 200+ code snippets:\r\n- Job type snippets for all Control-M job types\r\n- Connection profile snippets for all platforms\r\n- MFTE configuration snippets\r\n- Python API snippets\r\n- Usage examples and best practices\r\n\r\n## 📖 Control-M Folders\r\n\r\n### Privacy Guard\r\n\r\nTo gather the agent's GPG keys or to import a GPG key these Control-M folder will be executed against the target agent:\r\n\r\n- [VSCODE_PRIVACY_GUARD_IMPORT](folders/VSCODE_PRIVACY_GUARD_IMPORT.json)\r\n\r\n- [VSCODE_PRIVACY_GUARD_LIST](folders/VSCODE_PRIVACY_GUARD_LIST.json)\r\n\r\n\r\n## Troubleshooting\r\n\r\nIf you encounter issues while using the Control-M Jobs-As-Code Toolkit, try the following tips:\r\n\r\n### Connection Issues:\r\n\r\nDouble-check your Control-M Automation API endpoint and API token in the extension settings.\r\nEnsure your network allows access to the Control-M server.\r\nIf using a .ctm_connection.json file, verify its format and location.\r\n\r\n### Authentication Problems:\r\n\r\nMake sure your API token is valid and not expired.\r\nRefer to the Getting Started Guide for instructions on obtaining a new token.\r\n\r\n### Missing Features or Commands:\r\n\r\nConfirm you have the latest version of the extension installed.\r\nReview the Features Guide to see which functionality is supported.\r\n\r\n### General Errors:\r\n\r\nCheck the output and error logs in VS Code (View \u003e Output).\r\nRestart VS Code after installation or configuration changes.\r\nIf problems persist, consult the documentation or reach out via the BMC community forums or GitHub issues.\r\n\r\n\r\n## Disclaimer\r\nThis extension is provided by BMC Software as a community-driven, open-source solution for educational and demonstration purposes only. The content and functionality are offered “as is” without warranty of any kind, either express or implied, including but not limited to warranties of merchantability, fitness for a particular purpose, or non-infringement. Use of this extension in any production or production-like environment is strictly out of scope and not supported.\r\n\r\n## User Responsibilities\r\n\r\nBy downloading or using this extension, you acknowledge and agree that:\r\n\r\n- You are solely responsible for evaluating its suitability for your intended use.\r\n- You must not use this extension in any production or production-like environment.\r\n- You are responsible for ensuring compliance with all applicable laws, regulations, and organizational policies when using this extension.\r\n- Any reliance on the extension or its outputs is at your own risk.\r\n\r\n## Limitation of Liability\r\n\r\nTo the fullest extent permitted by law, BMC Software and its contributors disclaim any and all liability for any direct, indirect, incidental, special, consequential, or punitive damages arising out of or in connection with the use of, or reliance on, this extension or any related information.\r\n\r\n## Need help or want to contribute?\r\n\r\nVisit the https://community.bmc.com/ or open an issue on https://github.com/controlm/ctm-vscode-extension/issues.\r\n\r\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fcontrolm%2Fctm-vscode-extension","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fcontrolm%2Fctm-vscode-extension","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fcontrolm%2Fctm-vscode-extension/lists"}