VSCODIUM Z OPEN EDITOR and PL1 local files

[kraabrsg]

Hi there,

we made tasks with powershell to automate project setup in vscodium.
To set a project and download the necessary files to a folder just writing in "product" and "release" is needed.
This means also each time all files are downloaded to a local folder.

To somehow avoid that only changed files should be downloaded from the mainframe.

We can't manage to successfully resolve local copybooks (a *.code-workspace file is used to resolve the mainframe files )

"zopeneditor.propertygroups": [ { "name": "mvs-members", "type": "mvs", "syslib": [ "zzzz.ttt.xxxx", "xxxx.yyyy.zzz", ] }

i have tried this example(in the folder i have files with xxxxx.INC like set in "zopeneditor.datasets.pl1Datasets" ) from
https://ibm.github.io/zopeneditor-about/Docs/setting_propertygroup.html#_3-absolute-path-patterns :
"name": "local-files", "type": "local", "syslib": [ "C:\Users\\Desktop\zopeneditor-sample\COPYBOOK", "C:/Users//Desktop/zopeneditor-sample/INCLUDES" ],

When opening a pl1 file just copybooks from type MVS get resolved but no local files.

Am i missing something (z open editor version 1.2.1)?

Thank you!

[phaumer]

@kraabrsg this section in the docs gives guidance and examples for property groups. When you use backslashes you always need to type two to escape it or the editor will even show you a red squiggle as you are creating an invalid string in your json. Forward-slashes you type a single one. However, we recommend using a path relative to your workspace and not an absolute path. That would also make sharing property groups with others easier.

Also enable debug level logging to trace why your includes fail. For example, I added this property group in our sample repo

"zopeneditor.propertygroups": [
        {
            "name": "PL1-absolute",
            "type": "local",
            "language": "pl1",
            "syslib": [
                "C:\\Users\\peter\\Dev\\wazi-sample\\INCLUDES"
            ]
        },
        {...

Then I can see log entries such as these. You can double click the request id (6sgztn in my case) in the VS Code log viewer to have the editor highlight all the other relevant occurrences in the log related to that request and scroll down:

2021-07-08T09:22:20.854-0700 DEBUG: ZLanguagesResourceResolver.documentRequested: The PL1 language server requested the following include file: "CUSTPLI". The ID for this request was assigned as "6sgztn" There are 1 pending requests being processed.
2021-07-08T09:22:20.855-0700 DEBUG: ZLanguagesResourceResolver.findIncludeFiles(RequestId:6sgztn): Started looking for "CUSTPLI" in 3 property groups: [PL1-absolute, SAM-Copybooks, MVS-PL1-lib]. Will search in that order.
...
2021-07-08T09:22:20.856-0700 DEBUG: ZLanguagesResourceResolver.findIncludeFiles(RequestId:6sgztn): Looking for local or downloaded "CUSTPLI" in ["C:\\Users\\peter\\Dev\\wazi-sample\\INCLUDES"] using file extensions [".inc",".include",".plinc",".pcx",".pci",".pinc",".PLARGE"].
2021-07-08T09:22:20.858-0700 DEBUG: ZLanguagesResourceResolver.resolve(RequestId:6sgztn): Found include file "CUSTPLI" in "file:///C:/Users/peter/Dev/wazi-sample/INCLUDES/CUSTPLI.inc"
...
2021-07-08T09:22:20.859-0700 DEBUG: ZLanguagesResourceResolver.buildResponse(RequestId:6sgztn): File "CUSTPLI" was found.
2021-07-08T09:22:20.860-0700 DEBUG: ZLanguagesResourceResolver.buildResponse(RequestId:6sgztn): Finished request 6sgztn. 0 pending requests left to process.

The log file shows you all the property groups that it is considering, the folders it is searching in and where it found the file.

If it cannot find it then it will show that with this message:

2021-07-08T09:34:30.783-0700 DEBUG: ZLanguagesResourceResolver.findIncludeFiles(RequestId:k5zyei): Looking for local or downloaded "CUSTPLI" in ["C:\\Users\\peter\\Dev\\wazi-sample\\INC"] using file extensions [".inc",".include",".plinc",".pcx",".pci",".pinc",".PLARGE"].
2021-07-08T09:34:30.784-0700 DEBUG: ZLanguagesResourceResolver.findIncludeFiles(RequestId:k5zyei): Did not find "CUSTPLI"

If you have remote property groups it will show you errors of trying to receive them, which could be a no-found or if there are problems with your Zowe profile respective other messages coming back from RSE API or z/OSMF. If it does not find it in the end it will log a WARN level message.

2021-07-08T09:36:35.168-0700 DEBUG: ZLanguagesResourceResolver.documentRequested: The PL1 language server requested the following include file: "CUSTPLI". The ID for this request was assigned as "vumubo" There are 1 pending requests being processed.
2021-07-08T09:36:35.169-0700 DEBUG: ZLanguagesResourceResolver.findIncludeFiles(RequestId:vumubo): Started looking for "CUSTPLI" in 2 property groups: [PL1-absolute, MVS-PL1-lib]. Will search in that order.
2021-07-08T09:36:35.170-0700 DEBUG: ZLanguagesResourceResolver.findIncludeFiles(RequestId:vumubo): Looking for local or downloaded "CUSTPLI" in ["C:\\Users\\peter\\Dev\\wazi-sample\\INC"] using file extensions [".inc",".include",".plinc",".pcx",".pci",".pinc",".PLARGE"].
2021-07-08T09:36:35.174-0700 DEBUG: ZoweResourceResolver.downloadMVSDataset(RequestId:vumubo): Looking for data set member "IBMUSER.SAMPLE.PLINC(CUSTPLI)" on MVS using Zowe CLI Profile "tvt4119rseapi". 
2021-07-08T09:36:35.209-0700 DEBUG: ZoweResourceResolver.downloadMVSDataset(RequestId:vumubo): Data set member search request for "IBMUSER.SAMPLE.PLINC(CUSTPLI)" returned: 
>>> Zowe REST Operations API Error:
http(s) request error event called
Error: getaddrinfo ENOTFOUND server.sample.com
<<<. If it is a Not Found error then no problem, will look in other property group locations.
2021-07-08T09:36:35.210-0700 DEBUG: ZLanguagesResourceResolver.findIncludeFiles(RequestId:vumubo): Looking for local or downloaded "CUSTPLI" in ["C:\\Users\\peter\\Dev\\wazi-sample\\INC"] using file extensions [".inc",".include",".plinc",".pcx",".pci",".pinc",".PLARGE"].
2021-07-08T09:36:35.213-0700 DEBUG: ZLanguagesResourceResolver.findIncludeFiles(RequestId:vumubo): Did not find "CUSTPLI"
2021-07-08T09:36:35.215-0700 WARN : The PL1 language server requested the include file "CUSTPLI", which was not found. enforceCaseSensitiveIncludeFileNames was set to true. Check your Zowe CLI profile and property groups settings and, if not already done so, switch to the "DEBUG" log level for more information.

Hope this helps giving you some pointers for how to analyze it.