Using the PAC commands
Use the PAC language to create IBM® UrbanCode® Deploy processes.
To get started, install the PAC tools.
- On the IBM UrbanCode Deploy Dashboard, click .
- Extract the downloaded pacc-version_number file.
- Optionally, if you want to reference PAC commands from anywhere on your computer, add the folder to your path system variable.
PAC tools consist of a number of command files. The primary commands are upload and download. The
primary commands are further organized by type: application, component, and generic. For example,
the PAC command to upload an application process is:
The PAC command to download a generic process is:
Similarly, you can upload and download a component process using the PAC
The command format for uploading PAC files is provided in the following code example:
upload-<process-type>-process <user-name> <server-url> <process-id> <next-version> input.pac
All PAC scripts have the same arguments and differ only by the type of process referenced. For example, to upload an application-type file named my_command.pac, the command might look like the following code example:
upload-application-process my_user_name https://my_server:4540 17542df8-a0a3-7b7d-ffa9-88ebe19324a9 2 my_command.pac
This command example uploads a new version of the application process defined in the my_command.pac file.
The command format for downloading PAC files is provided in the following code example:
download-<process-type>-process <user-name> <server-url> <process-id> <next-version> input.pac
For example, to download an application-type file named my_command.pac, the command might look like the following code example:
download-application-process my_user_name https://my_server:4540 17542df8-a0a3-7b7d-ffa9-88ebe19324a9 3 my_command.pac
This command example downloads the process identified by the version ID to a PAC file named my_command.pac. If the version is not specified, the latest version is downloaded.
To implement PAC processes, complete the following steps:
From the IBM UrbanCode Deploy Dashboard, create a process.
The process can be of any type, application, component, or generic. You use the ID assigned by the server to the process in your PAC files to identify the process. You do not need to define steps with the process designer.
From the command line, download the PAC file using the
- In any text editor, edit the PAC file.
Upload the PAC file using the process ID assigned to it by the server.
Along with the process ID you obtained from the server, you must assign a unique process version number to the uploaded process.