MSS Specific File Attributes.

The MSS FTP Service supports setting an MSS file's class of service, comment, project number, retention period and the read and write passwords. All of these parameters will be used when writing files to the MSS. If you do not set them, the normal defaults (as provided by the DCS msrcp command) will apply. For reads of files from the MSS, only the read password will apply. Once set, the values will be remembered and applied to each subsequent read or write as appropriate. See the NCAR Mass Storage Service User Reference, which describes these attributes in detail.

The FTP standard defines a way to pass site specific commands to an FTP server from a client. This is knows as a SITE command. They way you issue it is FTP Client specific, but you may be able to issue a site or quote site command to your FTP Client.

Setting the Class of Service

To set a specific class of service value, issue the SITE CLAS command. The argument is the same class of service as that provided to the DCS msclass command. For example:

ftp> site clas reliability=economy
200 CLAS command ok.

To reset the class of service to the default value, issue the SITE CLAS command with no argument. For example:

ftp> site clas
200 Command ok, class of service defaulted.

Setting the Comment

To set a comment, issue the SITE CMNT command. The argument is the MSS file comment. For example:

ftp> site cmnt This is a comment.
200 CMNT command ok.

To reset the comment to an empty value, issue the SITE CMNT command with no argument. For example:

ftp> site cmnt
200 Command ok, comment turned off.

Setting the Project Number

To set the project number to be used for file transfers, as well as the number to assign when writing a file to the MSS, issue the SITE PROJ command. The argument is the project number. For example:

ftp> site proj 01234567
200 PROJ command ok.

To display the current project number, issue the SITE PROJ command with no argument. For example:

ftp> site proj
211 Current project is 01234567

Setting the Retention Period

To set a retention period, issue the SITE PER command. The argument is MSS file comment. For example:

ftp> site per 180
200 PER command ok.

To reset the retention period to the default value, issue the SITE PER command with no argument. For example:

ftp> site per
200 Command ok, retention period defaulted.

Setting the Read Password

To set a read password, issue the SITE RPWD command. The argument is the read password. For example:

ftp> site rpwd abc123 
200 RPWD command ok.

To reset the read password to an empty value, either issue the SITE RPWD command with no argument or the exact string OFF (case sensitive). For example:

ftp> site rpwd
200 Command okay. Read password turned off.

Setting the Write Password

To set a write password, issue the SITE WPWD command. The argument is the write password. For example:

ftp> site wpwd abc123
200 WPWD command ok.

To reset the write password to an empty value, either issue the SITE WPWD command with no argument or the exact string OFF (case sensitive). For example:

ftp> site wpwd
200 Command okay. Write password turned off.

Displaying the MSS Specific Parameters.

To display the MSS specific parameters, along with other parameters related to your FTP session, issue the STAT command. Your FTP Client may call it something like rstat or you may need to issue it with a quote stat client command. For example:

ftp> rstat
211-FTP session status:
 User: AUSER @  (::ffff:127.0.0.1@45310)
 Scientist: 0000
 Project: 01234567
 Class of service: usage=economy
 Comment: This is a comment.
 Retention period: default
 Read password: is off
 Write password: is set
 Session idle timeout: 600 (seconds)
 Number of transfers: 0
 Bytes transferred: 0
 Allocation size (ALLO parameter): 0
 Restart location (REST parameter): 0
 Maximum file size: 12,000,000,000 (bytes)
 Maximum file size for STOR when ALLO is not used: 500,000,000 (bytes)
211 End of status.

Documentation about the MSS specific SITE commands can be also displayed. For example:

ftp> site help
214-The following SITE commands are recognized:
 HELP    CLAS    CMNT    PER     PROJ    RPWD    WPWD    
 Send 'SITE HELP <command>' for command specifics.
214 Documentation available at http://www.cisl.ucar.edu/mss/ftp/
ftp> site help clas
214 Syntax: SITE CLAS [<sp> <class-of-service>]