List node files on Net-Storage volume
Component: | BS2000 |
Functional area: | File processing |
Domain: | FILE |
Privileges: | STD-PROCESSING |
Routing code: | @ (bei NBCONOPI=N) bzw. E (bei NBCONOPI=Y) |
Function
The LIST-NODE-FILES command lists node files (files of the type NODE-FILE) which are located on a Net-Storage volume and can be imported with the IMPORT-NODE-FILE command. This comprises all node files with a BS2000-compliant name which are stored directly in the user-specific directory on the Net-Storage volume. Directories and files located below it are not taken into account.
The command supports structured output in S variables (see "Output in S variable").
Privileged functions
Systems support (TSOS privilege) can have node files from all user-specific directories listed.
Format
LIST-NODE-FILES |
VOLUME = <vsn 6..6> ,USER-DIRECTORY = *OWN / *ALL / <name 1..8> ,NODE-FILE-NAME = <filename 1..54 without-cat-gen-vers with-wild(80)> ,INFORMATION = *STD / *SUMMARY ,OUTPUT = *SYSOUT / list-poss(2): *SYSOUT / *SYSLST |
Operands
VOLUME = <vsn 6..6>
VSN of the Net-Storage volumes whose node files are to be listed.
USER-DIRECTORY = *OWN / *ALL / <name 1..8 >
Directory of the user ID from which the node files are listed. The directory name is the same as the user ID. Only those files are listed which reside directly below this directory on the Net-Storage volume. Directories contained in the directory are ignored. Nonprivileged users can only obtain information on node files for their own user ID.
USER-DIRECTORY = *OWN
Lists node files from the directory of the user's own user ID.
USER-DIRECTORY = *ALL
This operand value is reserved for privileged users. Lists node files from all user directories of the Net-Storage volume.
USER-DIRECTORY = <name 1..8 >
Lists node files from the specified user directory. The name of the directory corresponds to the user ID. Nonprivileged users can only specify their own user ID.
NODE-FILE-NAME = <filename 1..54 without-cat-gen-vers with-wild(80)>
File names of the node files which are to be listed. Only files with BS2000-compliant file names are listed, i.e. node files which can be imported.
INFORMATION = *STD / *SUMMARY
Controls the scope of the information to be output.
INFORMATION = *STD
Outputs a line of information with the most important file attributes in summarized form for each node file. The line of information contains brief information about the file access rights, file size, change date and file name. Up to 74 characters are displayed.
INFORMATION = *SUMMARY
For each specified user directory, outputs the number of node files and the total number of bytes which these occupy in this directory.
OUTPUT =
Specifies where the information is to be output.
OUTPUT = *SYSOUT
The output is directed to SYSOUT.
OUTPUT = *SYSLST
Output is written to SYSLST.
Return codes
(SC2) | SC1 | Maincode | Meaning |
|---|---|---|---|
0 | CMD0001 | Command executed | |
64 | CMD0102 | Interrupted by K2 key | |
64 | CMD0216 | Privilege errors | |
64 | DMS051B | Requested user ID not in pubset | |
64 | DMS0594 | Not enough virtual memory available | |
64 | DMS0586 | It is not possible to access or reserve a volume at present | |
32 | DMS05C7 | DMS internal error | |
64 | DMS0607 | Error when generating S variables | |
64 | DMS0640 | ONETSTOR reports communication problem with net client | |
64 | DMS0643 | Net client reports access error | |
64 | DMS0644 | Net client reports internal error | |
64 | DMS06CC | No file matches selection criteria |
Output format
Sample output
/list-node-files volume=ck68@0,user-dir=*own,node-file-name=* CK68@0/USER1/ ———————————————————————————————————————————————————————— (1) -rw------- 10k Sep 12 14:27 NNDF1 —————————————————————————————————— (2) -rw------- 2M May 21 01:10 NNDF2 -rw------- 1M May 21 01:15 NNDF3 -rw------- 2M May 21 01:20 NNDF4
Explanation of the output
The following information is output for each specified user-specific directory:
(1) | Path name of the user-specific directory containing the displayed node files. |
(2) | The following file attributes are displayed for each file of the user-specific directory:
|
Output in S variable
The INFORMATION operand identifies the S variables which are to be created.
Output information | Name of the S variable | T | Contents | Condition |
|---|---|---|---|---|
Name of the file | var(*LIST).F-NAME | S | ’’ | INF=*STD |
File size, depending on size | var(*LIST).F-SIZE | I | ’’ | INF=*STD |
Execute permission for GROUP | var(*LIST).GROUP.EXEC | S | ’’ | INF=*STD |
Read permission for GROUP | var(*LIST).GROUP.READ | S | ’’ | INF=*STD |
Write permission for GROUP | var(*LIST).GROUP.WRITE | S | ’’ | INF=*STD |
Date of last file modification | var(*LIST).LAST-CHA-DATE | S | ’’ | INF=*STD |
Time of last file modification | var(*LIST).LAST-CHA-TIME | S | ’’ | INF=*STD |
Number of node files in the directory | var(*LIST).NUM-OF-F | I | ’’ | INF=*SUM |
Execute permission for OTHERS | var(*LIST).OTHERS.EXEC | S | ’’ | INF=*STD |
Read permission for OTHERS | var(*LIST).OTHERS.READ | S | ’’ | INF=*STD |
Write permission for OTHERS | var(*LIST).OTHERS.WRITE | S | ’’ | INF=*STD |
Execute permission for OWNER | var(*LIST).OWNER.EXEC | S | ’’ | INF=*STD |
Read permission for OWNER | var(*LIST).OWNER.READ | S | ’’ | INF=*STD |
Write permission for OWNER | var(*LIST).OWNER.WRITE | S | ’’ | INF=*STD |
UNIX file type | var(*LIST).UNIX-F-TYPE | S | ’’ | INF=*STD |
UNIX path name: directory of the node file | var(*LIST).UNIX-PATHNAME | S | ’’ | INF=*STD/ |
Sum of the storage space of the node files in the directory | var(*LIST).USED-BYTES | I | ’’ | INF=*SUM |
user ID | var(*LIST).USER-ID | S | ’’ | INF=*STD |