Create catalog entry for node files (import node files)
Component: | BS2000 |
Functional area: | File processing |
Domain: | FILE |
Privileges: | STD-PROCESSING |
Routing code: | $ (with NBCONOPI=N) or E (with NBCONOPI=Y) |
Function
The IMPORT-NODE-FILE command creates the catalog entries for node files (files of the type NODE-FILE) which are located on a Net-Storage volume (import). DMS creates the catalog entry for a node file in TSOSCAT and in the file catalog of the Net-Storage volume on the basis of the Node attributes on the NFS server.
Optionally the catalog entries of already imported node files can be updated on the basis of the node attributes on the NFS server (REPLACE=*NODE-FILE-UPDATE operand).
Catalog entries of node files can be deleted again with the EXPORT-NODE-FILE command (export).
Privileged functions
System support staff may export files belonging to any user ID. It may ignore the passwords of protected files and also branch to guided dialog whenever the user ID is changed.
By default, systems support (TSOS privilege) is a co-owner of all the files (and can therefore export files under any user ID). When SECOS is used, this co-ownership can be restricted.
Systems support can generate files under any user ID (TSOS privilege). In conjunction with the SECOS software product a user can allow other user IDs to act as co-owners. Co-owners of a user ID are then also allowed to export a file.
Format
IMPORT-NODE-FILE |
VOLUME = <vsn 6..6> ,FILE-NAME = <filename 1..54 without-cat-gen with-wild(80)> ,FILE-STRUCTURE = *STD / *PAM / *SAM ,REPLACE = *NO / *YES / *NODE-FILE-UPDATE ,IGNORE-PROTECTION = *NO / *YES ,REPORTING = *ERROR / *FULL ,OUTPUT = list-poss(2): *NONE / *SYSLST / *SYSOUT ,PUBSET = *STD / <cat-id 1..4> |
VOLUME = <vsn 6..6>
Volume serial number (VSN) of the Net-Storage volume on which the node files to be imported are stored.
FILE-NAME = <filename 1..54 without-cat-gen with-wild(80)>
Specifies the node files which are to be cataloged.
For privileged users, see "Privileged functions".
FILE-STRUCTURE = *STD / *PAM / *SAM
Specifies the FILE-STRUCTURE attribute of the node file which is entered in the file catalog in accordance with the REPLACE operand.
FILE-STRUCTURE = *STD
The following applies when REPLACE=*NO/*YES: A node file is imported into BS2000 as a PAM file if the file size on the NFS file system is not equal to zero. If the file size on the NFS file system is equal to zero, the imported file is assigned the default attributes of a file generated with CREATE-FILE.
The following applies when REPLACE=*NODE-FILE-UPDATE: The catalog entries are updated on the basis of the node attributes. Both the catalog entries of PAM and SAM files are updated.
FILE-STRUCTURE = *PAM
The following applies when REPLACE=*NO/*YES: A node file is imported into BS2000 as a PAM file irrespective of the file size on the NFS file system.
The following applies when REPLACE=*NODE-FILE-UPDATE: The catalog entries are updated on the basis of the node attributes. Only the catalog entries of PAM files are updated.
FILE-STRUCTURE = *SAM
For REPLACE=*NO/*YES the following applies: a node file will be imported into BS200 as a SAM file, irrespective of the file size on the NFS file system.
If REPLACE=*NODE-FILE-UPDATE, the catalog entries of SAM node files are updated in BS2000.
REPLACE = *NO / *YES / *NODE-FILE-UPDATE
Specifies whether files which already exist in BS2000 are replaced or whether only the catalog entry is updated on the basis of the node attributes on the NFS server.
REPLACE = *NO
Files which already exist are not replaced, nor are their catalog entries updated.
REPLACE = *YES
Files which already exist on the pubset are replaced by the specified node files. Files on public space and on Net-Storage are deleted and files are exported to private disk. When the node files are imported, the entries in TSOSCAT and in the file catalog of the Net-Storage volume are created again.
REPLACE = *NODE-FILE-UPDATE
In the case of files which already exist, the entries in TSOSCAT and in the file catalog of the Net-Storage volume are updated on the basis of the node attributes on the NFS server. The FILE-STRUCTURE operand determines that only catalog entries for files with the specified file structure are updated. FILE-STRUCTURE= *STD specifies that both PAM and SAM files are updated.
IGNORE-PROTECTION = *NO / *YES
The operand value *YES is reserved for privileged users. Systems support can determine whether the protection attributes should be ignored for existing files when REPLACE=*YES is specified.
REPORTING = *ERROR / *FULL
Determines the scope of the processing log which can be requested in the OUTPUT operand.
REPORTING = *ERROR
Only files which could not be imported are listed. The reason is displayed by means of a message code.
REPORTING = *FULL
All files are listed. In the case of files which could not be imported, the reason is displayed with a message code.
OUTPUT = *NONE / list-poss(2): *SYSOUT / *SYSLST
Specifies whether a processing log is to be output.
OUTPUT = *NONE
No processing log is output.
OUTPUT = *SYSOUT
A processing log is output to SYSOUT.
OUTPUT = *SYSLST
A processing log is output to SYSLST.
PUBSET = *STD / <cat-id 1..4>
Specifies the catalog ID of the pubset in which the files are to be cataloged. The Net-Storage volume specified in the VOLUME operand must be assigned to the pubset specified here.
The default setting is *STD, i.e. the catalog entries are set up under the file catalog of the default pubset of the user ID (see the output field DEFAULT-PUBSET in the SHOW-USER-ATTRIBUTES command).
Return codes
(SC2) | SC1 | Maincode | Meaning |
|---|---|---|---|
0 | CMD0001 | Command executed | |
1 | CMD05EE | Path name too long after completion | |
1 | CMD0624 | File name invalid | |
32 | DMS0578 | Internal error in file protection check | |
32 | DMS05C7 | DMS internal error | |
64 | CMD0102 | Interrupted by K2 key | |
64 | CMD0216 | Privilege error | |
64 | DMS0512 | Requested catalog not found | |
64 | DMS051B | Requested user ID not in pubset | |
64 | DMS051C | User not authorized to access pubset | |
64 | DMS0535 | No access authorization on the catalog entry of the file | |
64 | DMS0594 | Not enough virtual memory available | |
64 | DMS05FC | Specified user ID not in home pubset | |
64 | DMS0610 | Function execution supplied a return code for at least one of the selected file names | |
64 | DMS0640 | Access to Net-Storage is rejected by the ONETSTOR subsystem because of communication problems with the net client | |
64 | DMS0642 | Large files not permitted on pubset | |
64 | DMS0643 | Net client reports access error | |
64 | DMS0644 | Net client reports internal error | |
64 | DMS0645 | File does not exist on Net-Storage | |
64 | DMS0649 | Net server reports POSIX-ACL error | |
64 | DMS064A | Net client reports that access to files is forbidden on the Net-Storage volume | |
64 | DMS064B | Access to node files not supported by the net client | |
64 | DMS064C | Directory of the specified user ID does not exist on Net-Server | |
64 | DMS064D | File is not a node file | |
64 | DMS064E | Node file is not located on the specified Net-Storage volume | |
64 | DMS064F | FCB type of the file and specified file structure do not match | |
64 | DMS0650 | No node file found to import | |
64 | DMS0651 | File exists, import not possible | |
64 | DMS06CC | No file matches selection criteria |