PWD
Purpose
The PWD statement can be used to define passwords for use with a data REXX function or with a REXX command in a privileged authority environment. A data REXX function is always privileged unless a member is being read by a non-privileged command such as the BROWSE command. Commands are privileged if invoked by NetView® processes (as with auxInitCmd) or if an AUTBYPAS call has successfully invoked privilege. Both a data REXX function and a REXX command use the getpw() function call to obtain the password.
Syntax
where:
- name
- A name to be associated with the password being defined. The name variable
can be any sequence of eight characters. The characters can be any
combination of alphanumeric characters or the three national characters:
the at sign (
@), the number sign (#), or the dollar sign ($). The name variable does not need to be an identifier, such as an operator ID, defined to the NetView program. Use uppercase characters only. - suffix
- A qualifier that can be appended at the end of name.
This is used if more than one password is to be associated with the
same name.
- Names qualified by
.Pare referred to as primary. - Names qualified by
.Sare referred to as secondary.
- Names qualified by
- password
- The password to be associated with name, name.P, or name.S. The password can be any combination of 1 - 24 case sensitive alphanumeric characters or symbols, excluding blanks, equal signs, ampersands, periods, the less than symbol, and non-printable characters (00x - 3F).
Usage notes
- For passwords to be hidden, include PWD statements in member CNMSTPWD. You can use READSEC to protect CNMSTPWD from being displayed by the BROWSE command.
- The sample CNMSTPWD contains password statements that can be modified and used.
Examples
- PWD.mytask = pw1
After this, getpw('mytask') returns
pw1 - PWD.DSILOG.P = pw2
After this, getpw('DSILOG','P') returns
pw2 - PWD.DSILOG.S = pw3
After this, getpw('DSILOG','S') returns
pw3