Obtaining the location of files and data

How to obtain information about the location of files and data.

IBM Storage Archive Enterprise Edition allows the migration and premigration of files to tape for up to three different tape storage pools. A tape storage pool is a collection of tape cartridges. The number of copies of a file (sometimes referred to as replicas) is the number of tape cartridges that contain the migrated file. If you have two copies of the file, then the file was written on two different tape cartridges. Each copy is written to a different tape storage pool. It is recommended that you have at least two tape storage pools to allow for redundancy. When you have multiple copies, you can also export one of the copies for offsite storage.

After a file migrates from disk to tape you can find information about the state of the file, including which tape cartridges contain the file. Finding this information can be done with several different commands, as shown in the following list:

The eeadm file state command.
The mmlsattr command.
The dsmls command.

The use of the mmlsattr and dsmls commands are complementary to the eeadm file state command, and they use the information that is provided by the eeadm file state command if the commands produce conflicting information.

The eeadm file state command

The eeadm file state command shows what files are on tape and where they are located. See eeadm file state for detailed usage information, command syntax, and a description of the output received from the command. See eeadm file state command output for examples of the command output when you use different command options.

The mmlsattr command

The command syntax is mmlsattr -L -d <filepath_regular_express> where <filepath_regular_expression> can be either a single file, a group of files separated by spaces, or file name expansion (a process known as globbing by recognizing and expanding wildcards), and either by full file name path or the relative file name.

Note: The IBM Storage Scale mmlsattr command output displays some Misc attributes about files that should not be confused with IBM Storage Archive EE status that uses the same or similar terms. The mmlsattr Misc attributes ARCHIVE and OFFLINE, have the following meaning:

ARCHIVE: This attribute refers to the archive flag in a Windows environment. It is not related to IBM Storage Archive EE.
OFFLINE: This attribute indicates that a file is in the migrated state. Do not confuse it with a tape that is in the offline state.

The following three examples show different ways of using the mmlsattr command.

Example 1


[root@ltfs19 test1]# mmlsattr -L -d file1.bin
file name:            file1.bin
metadata replication: 1 max 2
data replication:     1 max 2
immutable:            no
appendOnly:           no
flags:
storage pool name:    system
fileset name:         root
snapshot name:
creation time:        Thu May 26 11:06:48 2022
Misc attributes:      ARCHIVE
Encrypted:            no
security.selinux:     "unconfined_u:object_r:unlabeled_t:s0?"
dmapi.IBMSGEN#:       "2"
dmapi.IBMUID:         "14591119098657558160-5079056949696843795-1203814736-119446-0"
dmapi.PREMTM0:        "1653530808"
dmapi.PRETPS0:        "F31353L9@66a659e5-cbfb-4c40-a61d-3fa5fe1623a0:5c663f36-f558-4e57-aeda-e9304f8f70a2@ON"
dmapi.IBMProv:        "ltfs????"
dmapi.IBMTPS:         "1 F31353L9@66a659e5-cbfb-4c40-a61d-3fa5fe1623a0@5c663f36-f558-4e57-aeda-e9304f8f70a2"
dmapi.IBMMD5:         "a1445eb5b46eb6b8817d13d79237b6a4"
dmapi.IBMPMig:        "?????????????[@z?l%!x???????"
gpfs.dmapi.region:    0x0000000000000000000000000000000006000000127F0000

Example 2


[root@ltfs19 test1]# mmlsattr -L -d file1.bin file2.bin
file name:            file1.bin
metadata replication: 1 max 2
data replication:     1 max 2
immutable:            no
appendOnly:           no
flags:
storage pool name:    system
fileset name:         root
snapshot name:
creation time:        Thu May 26 11:06:48 2022
Misc attributes:      ARCHIVE
Encrypted:            no
security.selinux:     "unconfined_u:object_r:unlabeled_t:s0?"
dmapi.IBMSGEN#:       "2"
dmapi.IBMUID:         "14591119098657558160-5079056949696843795-1203814736-119446-0"
dmapi.PREMTM0:        "1653530808"
dmapi.PRETPS0:        "F31353L9@66a659e5-cbfb-4c40-a61d-3fa5fe1623a0:5c663f36-f558-4e57-aeda-e9304f8f70a2@ON"
dmapi.IBMProv:        "ltfs????"
dmapi.IBMTPS:         "1 F31353L9@66a659e5-cbfb-4c40-a61d-3fa5fe1623a0@5c663f36-f558-4e57-aeda-e9304f8f70a2"
dmapi.IBMMD5:         "a1445eb5b46eb6b8817d13d79237b6a4"
dmapi.IBMPMig:        "?????????????[@z?l%!x???????"
gpfs.dmapi.region:    0x0000000000000000000000000000000006000000127F0000
file name:            file2.bin
metadata replication: 1 max 2
data replication:     1 max 2
immutable:            no
appendOnly:           no
flags:
storage pool name:    system
fileset name:         root
snapshot name:
creation time:        Thu May 26 10:57:47 2022
Misc attributes:      ARCHIVE OFFLINE
Encrypted:            no
security.selinux:     "unconfined_u:object_r:unlabeled_t:s0?"
dmapi.IBMSGEN#:       "1"
dmapi.IBMUID:         "14591119098657558160-5079056949696843795-1579211380-119441-0"
dmapi.PREMTM0:        "1653530267"
dmapi.PRETPS0:        "F31351L9@66a659e5-cbfb-4c40-a61d-3fa5fe1623a0:5c663f36-f558-4e57-aeda-e9304f8f70a2@ON"
dmapi.IBMProv:        "ltfs????"
dmapi.IBMMD5:         "8d37d335109c8d0c387a516a356dc1b6"
dmapi.IBMObj:         "?????????????Z@z?-?W?5q?i????????????(??????????????????????????????????????????????????????????????????????????????????????"
gpfs.dmapi.region:    0x000000000000000000000000000000000700000000000000
dmapi.IBMTPS:         "1 F31353L9@66a659e5-cbfb-4c40-a61d-3fa5fe1623a0@5c663f36-f558-4e57-aeda-e9304f8f70a2"

Example 3


[root@ltfs19 test1]# mmlsattr -L -d file*
file name:            file1.bin
metadata replication: 1 max 2
data replication:     1 max 2
immutable:            no
appendOnly:           no
flags:
storage pool name:    system
fileset name:         root
snapshot name:
creation time:        Thu May 26 11:06:48 2022
Misc attributes:      ARCHIVE
Encrypted:            no
security.selinux:     "unconfined_u:object_r:unlabeled_t:s0?"
dmapi.IBMSGEN#:       "2"
dmapi.IBMUID:         "14591119098657558160-5079056949696843795-1203814736-119446-0"
dmapi.PREMTM0:        "1653530808"
dmapi.PRETPS0:        "F31353L9@66a659e5-cbfb-4c40-a61d-3fa5fe1623a0:5c663f36-f558-4e57-aeda-e9304f8f70a2@ON"
dmapi.IBMProv:        "ltfs????"
dmapi.IBMTPS:         "1 F31353L9@66a659e5-cbfb-4c40-a61d-3fa5fe1623a0@5c663f36-f558-4e57-aeda-e9304f8f70a2"
dmapi.IBMMD5:         "a1445eb5b46eb6b8817d13d79237b6a4"
dmapi.IBMPMig:        "?????????????[@z?l%!x???????"
gpfs.dmapi.region:    0x0000000000000000000000000000000006000000127F0000
file name:            file2.bin
metadata replication: 1 max 2
data replication:     1 max 2
immutable:            no
appendOnly:           no
flags:
storage pool name:    system
fileset name:         root
snapshot name:
creation time:        Thu May 26 10:57:47 2022
Misc attributes:      ARCHIVE OFFLINE
Encrypted:            no
security.selinux:     "unconfined_u:object_r:unlabeled_t:s0?"
dmapi.IBMSGEN#:       "1"
dmapi.IBMUID:         "14591119098657558160-5079056949696843795-1579211380-119441-0"
dmapi.PREMTM0:        "1653530267"
dmapi.PRETPS0:        "F31351L9@66a659e5-cbfb-4c40-a61d-3fa5fe1623a0:5c663f36-f558-4e57-aeda-e9304f8f70a2@ON"
dmapi.IBMProv:        "ltfs????"
dmapi.IBMMD5:         "8d37d335109c8d0c387a516a356dc1b6"
dmapi.IBMObj:         "?????????????Z@z?-?W?5q?i????????????(??????????????????????????????????????????????????????????????????????????????????????"
gpfs.dmapi.region:    0x000000000000000000000000000000000700000000000000
dmapi.IBMTPS:         "1 F31353L9@66a659e5-cbfb-4c40-a61d-3fa5fe1623a0@5c663f36-f558-4e57-aeda-e9304f8f70a2"

The dsmls command

The command syntax is dsmls <filepath_regular_express> where <filepath_regular_expression> can be either a single file, a group of files separated by spaces, or file name expansion (a process known as globbing by recognizing and expanding wildcards), and either by full file name path or the relative file name. The following three examples show different ways of using the dsmls <filepath_regular_express> command.

Example 1

[root@ltfseevm ~]# dsmls /ibm/gpfs/file1.bin
IBM Storage Protect
Command Line Space Management Client Interface
  Client Version 8, Release 1, Level 9.1
  Client date/time: 04/16/2020 09:06:55
(c) Copyright by IBM Corporation and other(s) 1990, 2020. All Rights Reserved.

        ActS         ResS         ResB   FSt    Prvd      FName

   209715200    209715200       204800   p      ltfs      file1.bin

Example 2

[root@ltfseevm ~]# dsmls /ibm/gpfs/file1.bin /ibm/gpfs/file2.bin
IBM Storage Protect
Command Line Space Management Client Interface
  Client Version 8, Release 1, Level 9.1
  Client date/time: 04/16/2020 09:06:55
(c) Copyright by IBM Corporation and other(s) 1990, 2020. All Rights Reserved.

        ActS         ResS         ResB   FSt    Prvd      FName

   209715200    209715200       204800   p      ltfs      file1.bin
   209715200            0            0   m      ltfs      file2.bin

Example 3

[root@ltfseevm ~]# dsmls /ibm/gpfs/file1*
IBM Storage Protect
Command Line Space Management Client Interface
  Client Version 8, Release 1, Level 9.1
  Client date/time: 04/16/2020 09:06:55
(c) Copyright by IBM Corporation and other(s) 1990, 2020. All Rights Reserved.

        ActS         ResS         ResB   FSt    Prvd      FName

      102400            0            0   m      ltfs      file10.bin
   209715200    209715200       204800   p      ltfs      file1.bin

The following table describes the fields in the output examples:

Field name	Description
`ActS`	The actual size of the file in bytes
`ResS`	The resident size in bytes.
`ResB`	The resident block size in kB.
`FSt`	The file state of the file.
`Prvd`	The name of the provider, which is always `ltfs` for IBM Storage Archive EE files.

Similar to the mmlsattr command, the dsmls command does not contain the tape cartridge information with the physical tape details in IBM Storage Archive EE.