Using commands on the z/OS NFS client

The following is a summary of the syntax for the commands described in this topic. See Mount command syntax and examples and Unmount command syntax and examples for information about the mount and unmount commands.

The mvslogin command is used to log in to z/OS from your workstation. The mvslogin command can be issued multiple times, and the last one overrides the previous one. The mvslogin command is required only when accessing data on systems where the z/OS NFS server site security attribute is set to saf or safexp.

Note: As of z/OS V1R11, mvslogin is no longer required for NFS v4 requests using RPCSEC_GSS authentication. Instead, for these requests, the z/OS NFS server will use the user's Kerberos identity associated with the request to establish the user's RACF identity/authority.

The following is the mvslogin command syntax.


>>-mvslogin--+-------------------+--+------------+-------------->
             +- -p---------------+  '- -g--group-'   
             +- -n---------------+                   
             +- -pn--------------+                   
             +- -P--mvs_passwd---+                   
             '- -P--'passphrase'-'                   

>--+-----------+--+--------------+--hostname--+------------+---><
   '-norpcbind-'  '- -a--account-'            '-mvs_userid-'

where

Operand: Description
-p: Causes a prompt for the user’s z/OS password. The password is passed to z/OS to validate the user logging in. Your security procedures determine whether you should use this parameter.
-n: Causes a prompt for a new password.
-pn: Causes a prompt for the user’s current password and then causes two prompts for the user’s new password.
-P mvs_passwd: No prompt for your z/OS password; just type your z/OS password after the -P. This enables you to automate your MVS login.
-P ‘passphrase': No prompt for your z/OS password phrase, a text string of a minimum of 9 to 14 characters (depending on whether or not ICHPWX11 is installed) to a maximum of 100 characters. This enables you to automate your MVS login. See z/OS Security Server RACF Command Language Reference for more information on the z/OS password phrase and its syntax rules.
-g group: A group name string passed to z/OS for accounting purposes. The maximum length is 8 characters.
-norpcbind: Specifies that mvslogin should not look for the RPCBIND protocol on the NFS server system. The default is that mvslogin will first look for the RPCBIND protocol. If that request fails, or times out, it will then look for the PORTMAPPER. If this keyword is used, mvslogin will immediately use the PORTMAPPER protocol. Using this keyword, when it is known that the NFS server system does not support RPCBIND, can improve the performance of mvslogin, because it does not look for RPCBIND first. This keyword has no effect if the client system is not enabled for IP version 6 (IPv6).
-a account: An account string passed to z/OS for accounting purposes. The maximum length is 16 characters.
hostname: The name of the z/OS host (for example, mvshost1). The default is the local host.
mvs_userid: A user ID that z/OS recognizes as valid. If you do not specify this parameter, your workstation user name is used. The NFS server does not support the use of an alias user ID or a mixed case user ID with the mvslogin command.

The showattr command is used to display the default attributes or the attributes that have been set for a specific mount point. If you specify a mount point, showattr shows the attributes for the mount point, including the overriding values. For descriptions of the attributes, see Initialization attributes for the z/OS NFS server.

The following is the showattr command syntax.


>>-showattr--+-----+--+-----------+--hostname--+------------+--><
             '- -t-'  '-norpcbind-'            '-/localpath-'

where

Operand: Description
-t: Used to specify tersed output.
-norpcbind: Specifies that showattr should not look for the RPCBIND protocol on the NFS server system. The default is that showattr will first look for the RPCBIND protocol. If that request fails, or times out, it will then look for the PORTMAPPER. If this keyword is used, showattr will immediately use the PORTMAPPER protocol. Using this keyword, when it is known that the NFS server system does not support RPCBIND, can improve the performance of showattr, because it does not look for RPCBIND first. This keyword has no effect if the client system is not enabled for IP version 6 (IPv6).
hostname: The name of the z/OS host (for example, mvshost1). The default is the local host.
/localpath: The mount point on your client system (for example, /u/smith/mnt). This should be an empty directory.

The nfsstat command is used to display the NFS client and server statistical information, to reset the statistical information to zero, to display NFS mount point information, or to set the debug status.

The following is the nfsstat command syntax.


>>-nfsstat--+-----------------------+--------------------------><
            +-+-----+---------------+   
            | +- -2-+               |   
            | +- -3-+               |   
            | '- -4-'               |   
            +- -c-------------------+   
            +- -n-------------------+   
            +- -r-------------------+   
            +- -s-------------------+   
            +- -z-------------------+   
            +- -m--+-------------+--+   
            |      '-mount point-'  |   
            +- -mi--+-------------+-+   
            |       '-mount point-' |   
            '- -v--+----------+-----'   
                   +-a--------+         
                   +-m module-+         
                   '-t task---'

where

Operand

Description

-2

Displays statistics for Version 2 of the z/OS NFS server and z/OS NFS client.

-3

Displays statistics for Version 3 of the z/OS NFS server and z/OS NFS client.

-4

Displays statistics for Version 4 of the z/OS NFS server and z/OS NFS client.

-c

Displays both NFS and RPC statistics about the NFS client. This is the default option on the nfsstat command.

-n

Displays NFS statistics about the NFS client and NFS servers.

To display the NFS statistics of only the client, use -cn
To display the NFS statistics of only the server(s), use -sn

-r

Displays RPC statistics about the NFS client and NFS servers.

To display the RPC statistics of only the client, use -cr
To display the RPC statistics of only the server(s), use -sr

-s

Displays statistics about the NFS servers.

-z

Initializes statistics to zero for the NFS client and NFS servers. Used by root user only. This option can be combined with options -c, -n, and -r on the nfsstat command. When combined with these nfsstat options, each particular set of statistics is set to zero after the statistics are printed.

To only reset the client side statistics, use -cz
To reset the server(s) side statistics , use -sn

-m

Displays the name of each NFS mounted file system.

-mi

Displays the name of each NFS mounted file system and checks the server's IP address validity.

-m mount point

Displays information for the NFS mounted file system on the specified mount point.

-mi mount point

Displays information for the NFS mounted file system on the specified mount point and checks the server's IP address validity.

-v

Returns information about the latest APAR installed on the z/OS NFS client.

-v a

Returns a list of all the modules in the z/OS NFS client with their current level information. At the end of the list is information about the latest APAR installed.

-v m module

Returns information about the APAR level of the specified module.

-v t task

Returns information about the APAR level of the specified task.

Any of the options specified previously in this section in the nfsstat command can be used in conjunction with each other to display the desired statistics. The following are some examples of such usage:

To display the RPC and NFS statistics of the z/OS NFS client and the z/OS NFS server(s): nfsstat (that is, with no options, which is equivalent to nfsstat –cs or –csrn or –rn or –csr234)
To display the RPC statistics of the z/OS NFS client and the z/OS NFS server(s): nfsstat –csr
To display the NFS version 2 statistics of the z/OS NFS client: nfststat –c2
To display the NFS version 3 statistics of the z/OS NFS Client and the z/OS NFS server(s): nfsstat -cs3
To display the NFS version 4 statistics of the z/OS NFS server(s): nfsstat -s4

Note: The examples listed previously in this section are not a complete list, but a sampling of the combinational usage of the nfsstat command's options. As stated previously, any of the nfsstat command's options can be combined with each other to achieve the desired level of filtering to display the desired statistics.

The showmount command is used to display the remote NFS server mount information. If you omit the options, the default option displays hostnames of all remote mounts from the hostname NFS server. If you omit the hostname parameter, then the local hostname is used.

The following is the showmount command syntax.


>>-showmount--+-----+--+-----------+--hostname-----------------><
              +- -a-+  '-norpcbind-'             
              +- -d-+                            
              '- -e-'

If you omit the options, the default option displays hostnames of all remote mounts from the hostname NFS server.

where

Operand: Description
-a: Displays all mounts in the format hostname:directory from the hostname specified in the showmount command.
-d: Displays only directory names of all mounts from the hostname specified in the showmount command.
-e: Displays the list of exported directories from the hostname specified in the showmount command. Directory entries are shown as they appear in the exports data set.
Note that exported directory entries containing symbolic links are displayed with both the symbolic link path and resolved real path for NFSV4 mounts only (after the mount has been completed). NFSV3 mounted paths will display only the symbolic link path.
-norpcbind: Specifies that showmount should not look for the RPCBIND protocol on the NFS server system. The default is that showmount will first look for the RPCBIND protocol. If that request fails, or times out, it will then look for the PORTMAPPER. If this keyword is used, showmount will immediately use the PORTMAPPER protocol. Using this keyword, when it is known that the NFS server system does not support RPCBIND, can improve the performance of showmount, because it does not look for RPCBIND first. This keyword has no effect if the client system is not enabled for IP version 6 (IPv6).
hostname: The name of the NFS server host (for example, mvshost1). The default is the local host.

The crnl2nl command will remove the carriage-return and end-of-file mark (EOF) from the input file. No other conversions are performed. Either, or both the input and output file can be a local or remote file.

The following is the crnl2nl command syntax.


>>-crnl2nl--input--output--------------------------------------><

The data is assumed to be in EBCDIC format.

where

Operand: Description
input: Absolute path name of the input file to be converted.
output: Absolute path name of the output file.

The nl2crnl converts the line delimiter from MVS format to carriage-return newline (CRNL) format; the newline (NL) in the input file is converted to the carriage-return newline pairs (CR, NL). No other conversions are performed. Both input and/or output file can be local or remote file.

The following is the nl2crnl command syntax.


>>-nl2crnl--input--output--------------------------------------><

where

Operand: Description
input: Absolute path name of the input file to be converted.
output: Absolute path name of the output file.

Note:

The size of the write buffer is double the size of the read buffer.
The data is assumed to be in EBCDIC format.

The mvslogout command is used to disconnect from the remote z/OS NFS server host. The mvslogout command is only required when the mvslogin command was used to begin the connection.

The following is the mvslogout command syntax.


>>-mvslogout--+-----------+--hostname--------------------------><
              '-norpcbind-'

where

Operand: Description
-norpcbind: Specifies that mvslogout should not look for the RPCBIND protocol on the NFS server system. The default is that mvslogout will first look for the RPCBIND protocol. If that request fails, or times out, it will then look for the PORTMAPPER. If this keyword is used, mvslogout will immediately use the PORTMAPPER protocol. Using this keyword, when it is known that the NFS server system does not support RPCBIND, can improve the performance of mvslogout, because it does not look for RPCBIND first. This keyword has no effect if the client system is not enabled for IP version 6 (IPv6).
hostname: The name of the z/OS host (for example, mvshost1). The default is the local host.