LIST
The LIST command returns a working list of absolute file names in a directory.
The working list to return the file names must be defined with a single field long enough to contain the absolute file name.
If no DIR keyword is provided and the current directory has not be changed using other commands, the default JSM instance directory will be searched. Sub-directories are not searched.
If no EXT keyword is provided all files in the directory will be searched by default.
LIST ------------- DIR --------- directory path ---------------->
>-- EXT --------- file extension ---------------->
>-- SORT -------- *NONE ------------------------->
*NAME
*MODIFIED
>-- REVERSE ----- *YES --------------------------|
*NO
Keywords
|
DIR |
Nominate a relative or absolute directory path to be searched. Sub-directories are not searched. |
|
EXT |
Only select files with a nominated file extension. The filtering match is not case sensitive and does not require a '.' prefix. For example:
LIST EXT(CSV)
|
|
SORT |
The optional sort keyword allows sorting on file name or modified date. The default value is *NONE. |
|
REVERSE |
The optional reverse keyword allows the sorted order to be reversed. The default value is *NO. |
Examples
RDML
This will return a list of file names in the /csvdata directory that have a CSV extension.
DEF_LIST NAME(#WRKLIST) FIELDS(#PATH) TYPE(*WORKING)
USE BUILTIN(JSM_COMMAND) WITH_ARGS('LIST DIR(/CSVDATA) EXT(CSV) SERVICE_LIST(PATH)') TO_GET(#JSMSTS #JSMMSG #WRKLST)
or equivalently,
DEF_LIST NAME(#WRKLIST) FIELDS(#PATH) TYPE(*WORKING)
USE BUILTIN(JSM_COMMAND) WITH_ARGS('SET DIR(/CSVDATA)') TO_GET(#JSMSTS #JSMMSG)
USE BUILTIN(JSM_COMMAND) WITH_ARGS('LIST EXT(CSV) SERVICE_LIST(PATH)') TO_GET(#JSMSTS #JSMMSG #WRKLST)
RDMLX
Def_list name(#wrklist) fields(#path) type(*working)
use builtin(jsmx_command) with_args(#jsmhandle 'list dir(/csvdata) ext(csv)') to_get(#jsmsts #jsmmsg #wrklist)