These are the available app settings that can be edited via the File/Settings menu.
File/Settings/Edit Settings will launch the settings file using the built-in editor for editing the XML settings.
❗Be careful when editing XML settings as you can mess up your XML file settings. You might want to consider making a backup of your AppSettings.xml file via the File/Settings/Backup Settings File menu option. It creates a timestamped backup of the AppSettings.xml file in this format: AppSettings_yyyymmddhhmmss.xml
❗ After making changes to settings, simply save the settings file and restart the app in order for new settings to take effect. As of V1.0.1.16 the restart is not necessary.
This is the developer library where source members can be checked out to if you have a license for iForGit. Used by the IFORGIT/MBCHKO and IFORGIT/MBCHKI commands.
Default - IFORGITTMP
This setting determines whether iForGit source management options are enabled. Default-True
This setting determines whether iForGit source management options are visible on the source list context menu. Default-True
If you don't use iForGit and don't want to see the iForGit menu options, simply change this setting to False.
This setting contains a list of one or more web site links that can be accessed from the links menu.
Each option contains: Site Desc and ``URL Link``` separated by pipe. Then each entry ends with a comma.
Example:
Work with IBM i GitHub Site|https://github.com/richardschoen/workwithibmipdm,
MobiGoGo - Automation-API integration-Mobile and Web Development|https://www.mobigogo.net,
iForGit - Git Versioning for Classic Source Files|https://www.iforgit.com,
This list is dyamically build and contains a list of recently used srclibrary/srcfile combination.
Example:
QSHONI/SOURCE,QGPL/QCLSRC
This setting hold a list of available editor programs and their associated command lines to run the editor program. Special value @@FILENAME will pass the filename at the selected point in a command line.
Internal|Internal,VS Code|vscode://file/@@FILENAME,Notepad|notepad.exe,Notepad++|notepad++.exe
This setting hold a list of available viewer programs and their associated command lines to run the viewer program. Special value @@FILENAME will pass the filename at the selected point in a command line.
Internal|Internal,VS Code|vscode://file/@@FILENAME,Notepad|notepad.exe,Notepad++|notepad++.exe
This is the application title. Work with IBM i - Programming Development Manager (PDM)
This is the last used IBM i host name or ip address to connect to. (Automatically updated with last used.)
This is the last IBM i user name that was used to connect with. (Automatically updated with last used.)
This setting is not used. Passwords are not stored.
This is the last SSH port connected to. Default-22 (Automatically updated with last used.)
Currently not used with direct connection.
Use private key.
Currently not used with direct connection.
Private key file.
Currently not used with direct connection.
This is the last source file that was listed. (Automatically updated with last used.)
This is the last source file library where the lastsource file is located. (Automatically updated with last used.)
This is the last IFS directory listed. (Not currently enabled.)
This is the Windows editor app to use when editing source members.
Default - Internal
Any Windows editor that accepts a filename as a parameter can be used.
This is the commandline argument passed when the source editor is launched. Default - @@FILENAME to pass the selected local file name.
Use Windows ShellExecute to launch editor app. Default-True
This is the Windows viewer app to use when browsing remote source members. Default - Internal
Any Windows editor that accepts a filename as a parameter can be used.
Sometimes you may want a different viewing to view source rather than edit it.
This is the commandline argument passed when the source editor is launched. Default - @@FILENAME to pass the selected local file name.
Use Windows ShellExecute to launch viewer app. Default-True
This is the log file to use for logging operations.
Default-c:\tmp_workwithibmi\logfile.txt (Currently cannot change location)
Set the setting with comma delimited list of libraries if you only want to view a select list of libraries in the source library dropdown.
Ex: QTEMP,QGPL,MYLIB1
If you want to use this setting, set loadalllibrarylist setting to False
If you want to pre-populate a list of IBM i systems to connect to, set this value in the format of: systemname,systemname
Ex: system1,system2
Otherwise you can type the desired system name and it will get saved in the ibmihost setting.
Load a list of all libraries. Default-True
This CL command template drives the iForGit SRCTOGIT command defaults for committing source members from a source file to selected git repo.
IFORGIT/SRCTOGIT SRCFILE(&L/&F)
SRCMBR(&N)
SRCHEADER(*YES)
SRCDATSEQ(*NO)
REPLACE(*YES)
EDITOPT(*NONE)
VALIDREPO(*YES)
IFSMKDIR(*YES)
INITREPO(*YES)
COMMITOPT(*COMMITSYNC)
COMMENT(*DATEUSER)
Since the command is stored in XML format, & should be used to represent the ampersand character: &.
More info on iForGit to help IBM i developers eliminate Awkward Git Integration. http://www.iforgit.com
This CL command template drives the iForGit SRCFRMGIT command defaults for pulling committed source members from selected git repo back to source file.
IFORGIT/SRCFRMGIT IFSREPODIR(*LIBREPODTAARA)
FROMIFSFIL(*LIBFILEPATH)
SRCFILE(&L/&F)
SRCMBR(&N)
SRCTYPE('&T')
SRCDATSEQ(*NO)
VALIDREPO(*YES)
COMMITOPT(*COMMITSYNC)
Since the command is stored in XML format, & should be used to represent the ampersand character: &.
More info on iForGit to help IBM i developers eliminate Awkward Git Integration. http://www.iforgit.com
This CL command calls the MBRARC command to create a snapshot copy of the selected source member.
IFORGIT/MBRARC SRCFILE(&L/&F)
SRCMBR(&N)
ARCSRCFILE(*DEFAULT)
This CL command calls the MBRCHKO command to check out a copy of the source member to a developers library and optionally remove from the production library once copied to prevent changes while checked out.
IFORGIT/MBRCHKO SRCFILE(&L/&F)
SRCMBR(&N)
TOSRCFILE(&DEVLIB/&F)
TOSRCMBR(&N)
REPLACE(*NO)
SKIPEXIST(*NO)
RMVPRDCOPY(*NO)
ARCSRCFILE(*DEFAULT)
ARCHIVE(*YES)
This CL command calls the MBRCHKI command to check in a copy of the source member from a developers library and optionally remove from the development library once copied.
IFORGIT/MBRCHKI SRCFILE(&L/&DEVLIB)
SRCMBR(&N)
TOSRCFILE(&L/&F)
TOSRCMBR(&N)
REPLACE(*NO)
RMVDEVCOPY(*NO)
ARCSRCFILE(*DEFAULT)
ARCHIVE(*YES)
This is the PDM options file to read for enabling PDM option handling. Default-QAUOOPT
This is the PDM options file library to read for enabling PDM option handling. ```Default-QGPL``
Command line to launch IBM Access Client Solutions.
Default: C:\ibmaccess\Start_Programs\Windows_x86-64\acslaunch_win-64.exe
Command line to launch 5250 emulator.
Default: @@APPDIR\emulator\VB5250.exe
Command line to launch VS Code as an editor.
Default: vscode://file/@@FILENAME
Command line to launch Notepad++ as an editor.
c:\Program Files (x86)\Notepad++\notepad++.exe
Use CPYTOIMPF command to copy source member to IFS rather than CPYTOSTMF. This setting allows you to switch between using CPYTOIMPF and CPYTOSTMF when downloading source members. Default-False to use CPYTOSTMF to export a source member to an IFS file.
CCSID for the from database file when copying from source member with CPYTOSTMF command. Change to 37 or your local CCSID if you get errors downloading source members. This controls the DBFCCSID parameter on the CPYTOSTMF command. CPYTOSTMF is used for downloading source members if usecpytoimpf setting=False.
Default: *FILE
CCSID for IFS stream file when copying from source member with CPYTOSTMF command.
Default: 1208 (UTF-8)
CCSID for the from database file when copying from source member with CPYTOIMPF command. Change to 37 or your local CCSID if you get errors downloading source members. This controls the DBFCCSID parameter on the CPYTOSTMF command. CPYTOSTMF is used for downloading source members if usecpytoimpf setting=False.
Default: *FILE
CCSID for IFS stream file when copying from source member with CPYTOIMPF command.
Default: 1208 (UTF-8)
Database file CCSID for CPYFRMSTMF command when copying source back to IBM i source member.
Change to 37 or your local CCSID if you get errors uploading source members. This controls the DBFCCSID parameter on the CPYFRMSTMF command. CPYFRMSTMF is used when uploading source members.
Default: *FILE
End of line format for CPYFRMSTMF command when copying source back to IBM i source member.
Default: *ALL
Source grid alternating row color.
Default: LightSteelBlue
Main form width.
Default: 1024
Main form height.
Default: 650
Editor and viewer form width.
Default: 800
Editor and viewer form height.
Default: 600
Use DSPFD instead of SQL to get source member list.
Default: False
View compiler output.
Default: True
Always view compiler output on both success and failure of compiles.
Default: True
Temporary object library.
Default: TMPMB
Description to use for the temporary IBM i library.
Default: Work with IBM i Temp Library (Can be cleared)</SettingValue>
Start the app in full screen mode.
Default-False
This is the CRTCMD command template to use when compiling CL commands.
CRTCMD CMD(&L/&N)
PGM(&L/&NC)
SRCFILE(&L/&F)
SRCMBR(&N)
PRDLIB(&L)
REPLACE(*YES)
This is the CRTCLPGM command template to use when compiling CLP programs.
CRTCLPGM PGM(&L/&N)
SRCFILE(&L/&F)
SRCMBR(&N)
LOG(*JOB)
ALWRTVSRC(*YES)
REPLACE(*YES)
This is the CRTBNDCL command template to use when compiling CLLE programs.
CRTBNDCL PGM(&L/&N)
SRCFILE(&L/&F)
SRCMBR(&N)
DFTACTGRP(*YES)
REPLACE(*YES)
DBGVIEW(*SOURCE)
This is the CRTRPGPGM command template to use when compiling RPG programs.
CRTRPGPGM PGM(&L/&N)
SRCFILE(&L/&F)
SRCMBR(N)
REPLACE(*YES)
This is the CRTBNDPGM command template to use when compiling RPGLE programs.
CRTBNDRPG PGM(&L/&N)
SRCFILE(&L/&F)
SRCMBR(&N)
DFTACTGRP(*YES)
DBGVIEW(*SOURCE)
REPLACE(*YES)
This is the CRTSQLRPGI command template to use when compiling SQLRPGLE programs.
CRTSQLRPGI OBJ(&L/&N)
SRCFILE(&L/&F)
SRCMBR(&N)
COMMIT(*NONE)
OBJTYPE(*PGM)
CLOSQLCSR(*ENDMOD)
REPLACE(*YES)
This is the CRTPF command template to use when compiling physical files.
CRTPF FILE(&L/&N)
SRCFILE(&L/&F)
SRCMBR(&N)
FILETYPE(*DATA)
MBR(*FILE)
MAXMBRS(1)
SIZE(*NOMAX)
This is the CRTLF command template to use when compiling logical files.
CRTLF FILE(&L/&N)
SRCFILE(&L/&F)
SRCMBR(&N)
FILETYPE(*DATA)
MBR(*FILE)
DTAMBRS(*ALL)
MAXMBRS(1)
This is the QSHEXEC CL command used to run PASE commands from the Run PASE Command options.
Requires QShell on i to be loaded. Library name: QSHONI
QSHONI/QSHEXEC CMDLINE('@@CMDLINE')
SETPKGPATH(*YES)
DSPSTDOUT(*NO)
LOGSTDOUT(*NO)
PRTSTDOUT(*NO)
DLTSTDOUT(*YES)
OUTFILE(@@OUTFILELIB/@@OUTFILE)
This is the default command for the change library list menu option.
CHGLIBL LIBL(QTEMP QGPL) CURLIB(*SAME)
Font size for editor and viewer. Font size is changed via font selection on viewer and editor forms.
Default - 10
Font name for editor and viewer. Font name and family is changed via font selection on viewer and editor forms.
Default - Courier New
Font name for editor and viewer. Font name and family is changed via font selection on viewer and editor forms.
Default - Courier New
This setting is used to set the backcolor for the alternating row colors in the Data Grids. Defaults to "LightSteelBlue if missing it is set as LightSteelBlue for default. List of available colors: https://github.com/richardschoen/workwithibmipdm/blob/main/availablecolors.md
This setting is used to set the backcolor for top panels above the source list data grids. Defaults to "Gainsboro if missing it is also set as Gainsboro for default. List of available colors: https://github.com/richardschoen/workwithibmipdm/blob/main/availablecolors.md
Set up one or more named library lists. Format: Default|QTEMP,QGPL;QSHONI Dev|QTEMP,QGPL,QSHONI.
There is also a dropdown on the main form to select and apply the selected library list.
Delete temp IFS files after downloading. Default=True. If user is having issues with character conversion, this setting can be set to False and the IFS files created when uploading and downloading files are left in the /tmp/workwithibmi IFS folder and can be accessed via the greenscreen with the WRKLNK command: WRKLNK OBJ('/tmp/workwithibmi/*'). Once the file list is up, the files can be viewed with Option 5. Option 8 will show the Coded character set ID the IBM i has set for the IFS file. The CCSID should normally be: 1208 if no default CCSID settings have not been changes in the Work with IBM i AppSettings.xml file.
Added new setting placeholder for CCSID in case we need to use a custom CCSID for data conversions when exporting and importing source members. CCSID setting is not implemented yet as the app jobs should already use the CCSID for the appropriate user profile automatically. Default=37
Determine which IASP a library belongs to based on IASP setting.
If empty setting, we use DB2 service to retreive IASP info for a library.
If hard coded value such as: iasp01 we use that value for the IASP.
If set to *NONE, we assume no iasp. Default value: *NONE.