Working with Net-Storage

After Net-Storage volumes have been created, BS2000 users can utilize them via the interfaces of DMS if this is permitted in their user entry. The available storage space on Net-Storage is then limited only by the size of the released storage space on the net server.

• You can use the DMS commands with the STORAGE-TYPE operand specified to create and edit files on Net-Storage volumes, e.g. with

  /CREATE-FILE or /MODIFY-FILE-ATTRIBUTES
              FILENAME=...,
              SUPPORT=*PUBLIC-DISK(STORAGE-TYPE=*NET-STORAGE,..)

  Catalog entries are generated in both the local pubset and in the Net-Storage volume's catalog. The files are also created in the UNIX file system with the file size 0. See also "General conditions".

  The system determines the Net-Storage volume on which the file is created as follows:

  • If a standard Net-Storage volume exists for the pubset specified under FILE-NAME, this is selected automatically.

  • If no standard Net-Storage volume exists for the specified pubset, a non-standard Net-Storage volume is selected. If more than one non-standard Net-Storage volume exist, the system determines a volume itself.

  The user must therefore specify a volume when he/she wishes to choose a particular non-standard Net-Storage volume from multiple existing non-standard Net-Storage volumes:

  /CREATE-FILE FILE-NAME=...,SUPPORT=*PUBLIC-DISK(STORAGE-CLASS=*NONE(
               VOLUME=NETS00, DEVICE=NETSTOR))

  The user can employ the SHOW-PUBSET-NET-STORAGE command to obtain information on the Net-Storage volumes assigned to a pubset.

  If the file type is not specified, a BS2000 file is created by default. To create a node file, you must specify the file type explicitly, e.g. with

  /CREATE-FILE FILE-NAME=...,
               SUPPORT=*PUBLIC-DISK(
                  STORAGE-TYPE=*NET-STORAGE(FILE-TYPE=*NODE-FILE), 
                      STORAGE-CLASS=*NONE(VOLUME=NET001,DEVICE=NETSTOR))
  

  In this case, if it does not already exist a user-specific directory is generated in which the specified file is created. This directory is also assigned the POSIX ACLs required to guarantee the user access from open systems, too.

• The SHOW-FILE-ATTRIBUTES command displays the file attributes and the storage location (volume and device type NETSTOR) of the file. By default the information from the associated pubset's TSOSCAT is displayed. You can request information from the catalog of a Net-Storage volume as follows:

  /SHOW-FILE-ATTRIBUTES ..., 
        SELECT=*BY-ATTRIBUTES(FROM-CATALOG=*NET(VOLUME=...))

• You can use the DMS commands with the STORAGE-TYPE selection operand specified to select files on Net-Storage volumes, e.g. with

  /SHOW-FILE-ATTRIBUTES oder /DELETE-FILE
        SELECT=*BY-ATTRIBUTES(STORAGE-TYPE=*NET-STORAGE,..,FILE-TYPE=...)

  With the FILE-TYPE operand you can restrict the selection to BS2000 files or node files.

• You can import BS2000 files which are not yet known in BS2000 from Net-Storage, i.e. create a catalog entry in the local pubset, e.g. with:

  /IMPORT-FILE SUPPORT=*DISK(VOLUME=P@BA00,DEVICE-TYPE=NETSTOR,...,PUBSET=A)

  In this case the Net-Storage volume must be assigned to the pubset into whose catalog the entries are to be imported. Systems support can assign a Net-Storage volume which has not yet been assigned using ADD-NET-STORAGE-VOLUME.

• You can also simulate the import in advance, e.g. with:

  /CHECK-IMPORT-DISK-FILE VOLUME=P@BA00,DEVICE-TYPE=NETSTOR,PUBSET=A,...

• If you assign a currently unassigned Net-Storage volume of the type NETVOL to a pubset with ADD-NET-STORAGE-VOLUME ... IMPORT = * YES, the existing Net-Storage files are automatically imported into TSOSCAT. If it is found during the import process that the filename of a NETVOL file already exists on the pubset, the IMPORT run is aborted. Files that have already been imported are removed. The system administrator can now clean up the pubset to remove the files concerned and repeat the run.
• You can import node files which are not yet known in BS2000 from Net-Storage, i.e. create a catalog entry in the local pubset, e.g. with:

• /IMPORT-NODE-FILE VOLUME=P@BA00, FILE-NAME=...[,FILE-STRUCTURE=...]

  The catalog entry is generated from the Inode attributes of the node file. The default setting for the FILE-STRUCTURE operand is *STD. This is equivalent to specifying *PAM, meaning the file is imported as a PAM file (FILE-STRUC=PAM file attribute). Node files containing binary data (e.g. types data, tar, executable etc.) should be imported as PAM files. Node files containing text based data (type text) should be imported as SAM files by explicitly specifying FILE-STRUCTURE=*SAM (FILE-STRUC=SAM and REC-FORM=V file attribute). For details on processing SAM node files, see section "Working with SAM node files".

  "Normal" files can be imported only if their names comply with the BS2000 conventions.

• You can query the information on the node files on a Net-Storage volume irrespective of whether they are already known in BS2000. However, only node files which comply with the BS2000 naming conventions are displayed, i.e. files which can also be imported. You can obtain information on your own node files with, for instance,

  /LIST-NODE-FILES VOLUME=P@BA00, USER-DIRECTORY=*OWN, NODE-FILE-NAME=...

• You can export files on Net-Storage volumes of type NETSTOR using the STORAGE-TYPE operand, e.g. with

  /EXPORT-FILE ...,SELECT=*BY-ATTRIBUTES(STORAGE-TYPE=*NET-STORAGE,...)

  This is not intended for files on Net-Storage volumes of the NETVOL type.
• You can export node files with /EXPORT-NODE-FILE.
  

It makes sense to export individual files when inconsistencies are corrected manually (e.g. after the failure of the Net-Storage).

In the case of type BS2000 files on Net-Storage volumes of the NETVOL type, such cleanups can only be carried out using the PURGE statement of the SPCCNTRL utility.

• The CHECK-FILE-CONSISTENCY, REMOVE-FILE-ALLOCATION-LOCKS and REPAIR-DISK-FILES commands support operation of Net-Storage by means of the selection operand SELECT=*NET-STORAGE.

• The DMS program interfaces also support Net-Storage, e.g. the CATAL, ERASE, FILE, FSTAT, IMPORT and RDTFT macros.
  A file on a Net-Storage volume is accessed in the conventional manner by specifying the catalog ID, user ID and file name.

• The BS2000 software products HSMS and ARCHIVE enable you to save and restore files on Net-Storage like local files, see the "HSMS" manual [10 (Related publications)].

• Files on Net-Storage can be used directly in the UNIX or Windows system of the net server, e.g. BS2000 files as control or print files:

  • The CONVERT-FILE-TO-PDF command generates PDF files in a binarycompatible format.

  • The software product BS2ZIP generates zip archives in a WINZIP-compatible format.

  Linux or Windows applications may only access BS2000 files in read-only mode. When Linux or Windows applications are also to access the files in write mode, node files must be used.