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.
>>-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.
>>-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.
>>-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.
>>-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.
>>-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).