From ef4f06ee77a9c96e4f2d93e11389c80dcdd8245c Mon Sep 17 00:00:00 2001 From: Sanjula Date: Tue, 27 Aug 2024 09:15:18 -0400 Subject: [PATCH] Document to create iproj.json before source migration Signed-off-by: Sanjula --- docs/pages/projectExplorer/migrate-source.md | 6 ++++-- 1 file changed, 4 insertions(+), 2 deletions(-) diff --git a/docs/pages/projectExplorer/migrate-source.md b/docs/pages/projectExplorer/migrate-source.md index 389d3baf..6398c143 100644 --- a/docs/pages/projectExplorer/migrate-source.md +++ b/docs/pages/projectExplorer/migrate-source.md @@ -2,11 +2,13 @@ A quick and easy way to get started with local development is to begin with migrating source from QSYS. This source migrating process leverages the `cvtsrcpf` command in `makei` as a source code conversion tool. This command essentially converts all members in a given source physical file to properly encoded, terminated, and named source files in an IFS directory. Following this conversion, the files will be bundled into a tar file which will be downloaded and extracted into the project so that you can begin with local development. -?> To learn more about this source code conversion too, check out the documentation on [cvtsrcpf](https://ibm.github.io/ibmi-bob/#/cli/makei?id=cvtsrcpf). +?> To learn more about this source code conversion tool, check out the documentation on [cvtsrcpf](https://ibm.github.io/ibmi-bob/#/cli/makei?id=cvtsrcpf). ## Start the Source Migration -To begin the source migration process, browse for the library containing the source physical files you would like to migrate using the **Object Browser** view. Once you have found the desired library, use the **Migrate Source** action. This can also be done on any library in the **Project Explorer** view. +To begin the source migration process, first ensure that you have a workspace folder opened with an `iproj.json` file. If you are creating a new project, follow the steps [here](pages/projectExplorer/create-new-project?id=create-new-project) which outline how this file can be created. + +Now that your workspace folder is recognized as an IBM i project, browse for the library containing the source physical files you would like to migrate using the **Object Browser** view. Once you have found the desired library, use the **Migrate Source** action. This can also be done on any library in the **Project Explorer** view. ![Migrate Source](../../assets/ProjectExplorer_37.png)