z/OS Network File System Guide and Reference
Previous topic | Next topic | Contents | Contact z/OS | Library | PDF


Using commands on AIX

z/OS Network File System Guide and Reference
SC23-6883-00

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.

Note: When the z/OS NFS server site attributes hfssec, mvssec, or pubsec specify any of the Kerberos security flavors (krb5, krb5i, or krb5p):
  • An MVS login is no longer required when using RPCSEC_GSS. The RACF authentication is done automatically based on your Kerberos principal.

The following is the mvslogin command syntax.

Read syntax diagramSkip visual syntax diagram
>>-mvslogin--+--------------------+--+------------+------------->
             +- -p----------------+  '- -g--group-'   
             +- -n----------------+                   
             +- -pn---------------+                   
             +- -P-- mvs_passwd---+                   
             '- -P-- 'passphrase'-'                   

>--+-------------+--+--------------+---------------------------->
   '- -norpcbind-'  '- -a--account-'   

>--hostname--+------------+------------------------------------><
             '-mvs_userid-'   

where

Operand
Description
-p
Causes a prompt for your MVS™ 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 z/OS 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 z/OS 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).
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 z/OS NFS server does not support the use of an alias user ID or a mixed case user ID with the mvslogin command.

The mount command is used to make a connection between a mount point on your local file system and one or more files in the z/OS file system.

The following is the mount command syntax.

Read syntax diagramSkip visual syntax diagram
>>-mount--+--------------+--hostname:"/prefix/mvs_qual---------->
          '- -o clnt_opt-'                               

>--+------------+--"--/localpath-------------------------------><
   '-,attribute-'                  

where

Operand
Description
-o clnt_opt
The client mount command options (such as soft,timeo=20). Refer to the documentation of your client operating system for a description of the options for your client environment.
hostname
The name of the z/OS host (for example, mvshost1).
/prefix
An optional explicit prefix for selecting the z/OS UNIX file system type (the HFSPREFIX( ) site attribute value), or for selecting the MVS file system type (the MVSPREFIX( ) site attribute value). If no prefix is specified, then the implicit prefix heuristic specified in the IMPPREFIX site attribute is used for determining the file system type.
mvs_qual
The path name of a z/OS UNIX directory or an MVS high-level qualifier for accessing z/OS MVS data sets.
attribute
A z/OS NFS server data set creation or file processing attribute (such as text). See Initialization attributes for the z/OS NFS server. If you specify any attributes, make sure you enclose mvs_qual and the attributes in double quotation marks.
/localpath
The mount point on your client system (for example, /u/smith/mnt). This should be an empty directory.

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.

Read syntax diagramSkip visual syntax diagram
>>-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).
/localpath
The mount point on your client system (for example, /u/smith/mnt). This should be an empty directory.

The umount command is used to break the connection between the mount point on your client and the server. When you issue this client command, the file you were editing is released (written to DASD). You do not need to unmount after each session, unmount only when you no longer have a need to access the z/OS file system. Check the documentation for your client operating system to ensure that you enter the umount command correctly.

The following is the umount command syntax.

Read syntax diagramSkip visual syntax diagram
>>-umount--/localpath------------------------------------------><

where

Operand
Description
/localpath
The mount point on your client system (for example, /u/smith/mnt). This should be an empty directory.

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.

Read syntax diagramSkip visual syntax diagram
>>-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).

Go to the previous page Go to the next page




Copyright IBM Corporation 1990, 2014