HP 3000 Manuals HP 3000 Manuals
Parameters within Syntax (cont.)
Positional parameters (cont.)
NEWUSER
The NEWUSER command enables the system administrator to define a new user
within an account. The administrator can also assign the user a password
and capabilities, and can limit the user's use of system resources.
Parameters defining these values may also be omitted from the command
line; in this case, defaults are assigned to the user.
Syntax
NEWUSER username[.acctname] [;PASS=[password]][;CAP=[capabilitylist]]
[;HOME=[homegroupname]]
Parameters
username Specifies the name of the user. The name must
consist of from one to eight alphanumeric
characters, beginning with an alphabetic character.
acctname Specifies the account in which the user is to
reside. You must have account manager (AM)
capability to use this parameter.
PASS Specifies the user password, used for verifying
logon access only. The password must consist of
from one to eight alphanumeric characters,
beginning with an alphabetic character. The
default is that no password is assigned.
CAP Specifies the list of capabilities permitted for
the user. Each capability is indicated by a
two-letter mnemonic, separated by commas, as
follows:
SM = System manager
AM = Account manager
AL = Account librarian
GL = Group librarian
DI = Diagnostician
OP = System supervisor
NA = Network administrator
NM = Node manager
SF = Save files
ND = Access to nonshareable I/O devices
UV = Use volumes
CV = Create volumes
CS = Use communication subsystem
PS = Programmatic sessions
LG = User logging
PH = Process handling
DS = Extra data segments
MR = Multiple RINs
PM = Privileged mode
IA = Interactive access
BA = Batch access
The default is IA, BA, ND, and SF.
Note the following points about this parameter:
* Capabilities assigned to the user cannot
exceed those assigned to the account.
* Any capabilities removed from the account
are denied to the user.
* The user's capabilities are always verified
to be a subset of the account's capabilities
at logon. This prevents a user from having
a capability not assigned to the account.
HOME Specifies the name of an existing group to be
assigned as the user's home group. The first user
established when an account is created, by default,
has PUB assigned as the home group. Subsequent new
users, by default, have no home group assigned. If
no home group is assigned, the user must always
specify a group when logging on.
Operation Notes
* Usage
You can enter this command from a session, a job, a program, or in
break mode. Pressing Break does not affect this command.
You must have account manager (AM) or system manager (SM)
capability to enter this command. You must have system manager
(SM) capability to specify a user in an account other than your
own.
Example
* To define a new user named LHSMITH in the account FINANCE, assign
a password of SMITTY, and assign a home group of HOMEGPX, enter:
:NEWUSER LHSMITH.FINANCE;PASS=SMITTY;HOME=HOMEGPX
Related Commands
ALTUSER
LISTUSER
NEWACCT
NEWGROUP
OUTFENCE
The OUTFENCE command defines the minimum priority that an output spool
file must have in order to print.
Syntax
[ {ldev }]
OUTFENCE outputpriority [;LDEV=ldev] [;DEV= {devclass}]
[ {devname }]
Parameters
outputpriority Specifies a number between 1 and 14, inclusive.
Spool file printing becomes increasingly limited as
the numbers become higher. For example, the number
1 limits spool file printing the least. The number
14 limits spool file printing the most.
The system prints individual spool files in the
ready state only if their outputpriority is higher
than the current outfence.
LDEV Specifies the logical device number, ldev, of a
printer. You can use this parameter to selectively
defer all output spool files except those currently
being printed by the specified LDEV. (See
Examples.)
DEV Consists of the following parameter values:
ldev Specifies the logical device
number of an output device.
devclass Specifies a device class
containing at least one
printer. This parameter
value must begin with a
letter and consist of eight
or fewer alphanumeric
characters. The device class
name and device name cannot
be the same.
devname Specifies the name of the
printer. This parameter
value must begin with a
letter and consist of eight
or fewer alphanumeric
characters. If you enter an
alphanumeric character
string, the command searches
the device class list first,
then the device name list.
The device class name and
device name cannot be the
same.
Operation Notes
* Usage
You can enter this command from a session, a job, a program, or in
break mode. Pressing Break does not affect this command.
You must enter this command from the console unless your system
administrator has used the ALLOW command, which permits you to
enter this command.
* Altering print priorities
You can prevent all spool files from printing by setting the
outfence to 14. You can prevent a subset of spool files from
printing by setting the outfence higher than the outputpriority of
any spool file in the group.
You can alter the printing priority of a single file without
affecting the entire system by changing the output priority of the
specific spool file(s) using the ALTSPOOLFILE or SPOOLF command.
Examples
* To temporarily defer all output spool files except those waiting
to be printed by LDEV 6, which is usually configured as the system
line printer, do the following:
1. Set the global outfence to 14 and the outfence of LDEV 6 to
7, as shown:
:OUTFENCE 14
:OUTFENCE 7;LDEV=6
This device-specific outfence takes precedence over the
global outfence.
2. Display the new global outputpriority and the
outputpriority of logical device 6 by entering the LISTSPF
or SHOWOUT command, as shown:
:LISTSPF
The system responds as shown:
____________________________________________________________________
| |
| DEV/CL DFID JOBNUM FNAME STATE FRM SPACE RANK PRI #C|
| 6 #O999 #J19 $STDLIST OPENED 512 8 1|
| 6 #O1030 #S77 EDLIST OPENED 512 8 1|
| SLOWLP #O1029 #S71 OUT READY 232 D 7 1|
| 20 #O1001 #S60 $STDLIST OPENED |
| 11 #O1022 #S33 GALLIST READY 768 D 7 1|
| |
| 5 FILES |
| 0 ACTIVE |
| 2 READY; INCLUDING 2 SPOOFLES, 2 DEFERRED |
| 3 OPENED; INCLUDING 2 SPOOFLES |
| 0 LOCKED; INCLUDING 0 SPOOFLES |
| 4 SPOOFLES 2024 SECTORS |
| OUTFENCE = 14 |
| OUTFENCE = 7 FOR LDEV 6 |
____________________________________________________________________
The summary statistics at the bottom of the listing
immediately reflect the new outfence. After all currently
active spool files are finished, no files directed toward a
device other than LDEV 6 can become active.
3. Reset the outfence for all output spool files, as shown:
:OUTFENCE 8
* To define an outfence of 5 for device class PP80, enter:
:OUTFENCE 5;DEV=PP80
Related Commands
ALTSPOOLFILE
LISTSPF
SHOWIN
SHOWOUT
SPOOLER
SPOOLF
PASSWORD
The PASSWORD command enables you to create or change your password. You
can enter this command interactively or programatically within a session.
Syntax
PASSWORD
Parameters
None.
Operation Notes
* Usage
You can enter this command from a session or in break mode. You
cannot use this command if you redirect $STDIN or $STDLIST.
Example
* To change an existing password, enter:
:PASSWORD
The system responds by displaying the following prompts:
ENTER OLD USER PASSWORD:
ENTER NEW USER PASSWORD:
ENTER NEW USER PASSWORD AGAIN:
PASSWORD WAS CHANGED SUCCESSFULLY.
For security purposes, the system does not echo your input
responses.
Related Commands
None
PRINT
The PRINT command prints the contents of a specified file name to the
standard list device, unless you specify another destination.
Syntax
PRINT[[FILE=]filename][;[OUT=]outfile]
Parameters
FILE Specifies the actual file name of the file to be
printed to $STDLIST, unless you specify outfile as
a destination.
The following points apply to this parameter:
* You can specify a temporary or a permanent
disk file with this parameter.
* File equations are ignored unless an
asterisk (*) precedes filename, indicating a
backreference.
* The filename can be $STDIN or $STDINX, the
default.
* If you do not specify a file name, PRINT
takes its input from $STDINX and continues
to do so until you enter the :EOD command on
a new line.
OUT Specifies a destination other than $STDLIST for
filename.
The following points apply to this parameter:
* If filename has embedded carriage-control
characters (CCTL), PRINT inserts a blank in
place of the CCTL in the outfile.
* New files are created as TEMP.
* File equations are ignored unless an
asterisk (*) precedes outfile, indicating a
backreference.
* You must use a file equation to overwrite a
permanent file.
Operation Notes
* Usage
You can enter this command from a session, a job, a program, or in
break mode. Pressing Break aborts the execution of this command.
* Batch print jobs
For batch jobs in which filename defaults to $STDINX, some
commands such as :EOD, EOF, JOB, EOJ, and DATA do not execute as
part of the original job when they follow the PRINT command.
For example, if the JOB command follows the PRINT command, only
the commands preceding the PRINT command execute in the original
job and nothing prints. The JOB command following the PRINT
command is interpreted as the start of a new job, which is then
streamed as a second job.
Examples
* To send the contents of MYFILE to the line printer, XXX, enter:
:FILE XXX;DEV=LP
:PRINT MYFILE, *XXX
The file XXX equates with the line printer. Then the file MYFILE
"prints" to the file *XXX.
* To use the PRINT command itself to create a file, enter the
following lines from your terminal:
:PRINT $STDIN,TAILB
PARM FILE, LAST=5
PRINT !FILE; START = -!LAST
:EOD
:SAVE TAILB
Since the default is temporary, the SAVE command permanently saves
the file TAILB.
Related Commands
EDITOR
FCOPY
PURGE
The PURGE command deletes a file from the system.
Syntax
PURGE filereference[,TEMP]
Parameters
filereference Specifies the actual file designator of the file to
be deleted in the following format:
filename[/lockword][.groupname[.acctname]]
TEMP Specifies that the file is a temporary file in the
job/session temporary file domain. You must enter
this parameter to delete a temporary file. The
default is that a permanent file is assumed.
Operation Notes
* Usage
You can enter this command from a session, a job, a program, or in
break mode. Pressing Break does not affect this command.
You must have write access to a file to delete it.
* Purging unrecognized files
If the file does not exist in the specified domain, the following
message appears:
FILE filename NOT FOUND, NO PURGE DONE. (CIWARN 383)
* Purging non-private spool files
You can purge a non-private spool file by entering PURGE filename.
You must specify the fully qualified file name (including
.OUT.HPSPOOL). The PURGE command deletes the specified spool file
and all links to the spool file directory. The spool file does
not print after you purge it.
Example
* To delete a permanent file named PFILE, enter:
:PURGE PFILE
Related Commands
ALTSEC
BUILD
LISTFILE
LISTSPF
PURGEACCT
The PURGEACCT command removes an entire account and its groups and users
from the system directory. The command removes every user not currently
logged on and every group or file or both not in use. If a group is in
use, the account cannot be purged.
Syntax
PURGEACCT acctname
Parameters
acctname Specifies the name of the account to be deleted.
This name must contain from one to eight
alphanumeric characters, beginning with an
alphabetic character.
Operation Notes
* Usage
You can enter this command from a session, a job, a program, or in
break mode. Pressing Break does not affect this command.
You must have system manager (SM) capability to enter this
command.
* When to purge an account
To completely purge an account, you must enter PURGEACCT when the
account is inactive. If you enter the command while the account
is in use, the account remains on the system and active users,
groups, and files are not purged from the account.
* Purge verification
When you enter PURGEACCT during a session, the system displays the
following verification prompt to ensure that you do not
accidentally purge the wrong account:
ACCT acctname TO BE PURGED?
No verification message is printed when you include the PURGEACCT
command within a job.
* Order of purged elements
Account elements are purged in the following order:
1. users
2. volume set definitions
3. files
4. groups
5. the account
_________________________________________________________________
CAUTION It is not advisable to purge the SYS account because you
can destroy critical files by doing so.
_________________________________________________________________
Examples
* To remove an account named EXCESS, enter:
:PURGEACCT EXCESS
ACCT EXCESS TO BE PURGED? (YES/NO)YES
:
Related Commands
LISTACCT
NEWACCT
PURGEGROUP
PURGEUSER
PURGEGROUP
The PURGEGROUP command enables a system administrator or account manager
to remove a group from an account. The command automatically removes all
files that belong to the group that is being purged.
Syntax
PURGEGROUP groupname[.acctname]
Parameters
groupname Specifies the name of the group in the logon
account to be removed. This name must contain from
one to eight alphanumeric characters, beginning
with an alphabetic character.
acctname Specifies the account where the group is located.
System manager (SM) capability is required to use
this parameter.
Operation Notes
* Usage
You can enter this command from a session, a job, a program, or in
break mode. Pressing Break does not affect this command.
You must have system manager (SM) or account manager (AM)
capability to enter this command.
* When to purge a group
To completely purge a group, you must enter PURGEGROUP when the
group and its files are inactive; otherwise, the group remains on
the system and only inactive files are purged.
* Purge verification
When you enter PURGEGROUP during a session, the system displays
the following verification prompt to ensure that you do not
accidentally purge the wrong group:
GROUP groupname TO BE PURGED?
No verification message is printed when you include the PURGEGROUP
command within a job.
* Order of purged elements
Group elements are purged by files first, then the group. If no
files in the group are in use, and the group itself is not in use,
the PURGEGROUP command removes the entire group, otherwise, only
inactive files are removed. To completely purge the group in this
case, reenter the PURGEGROUP command when neither the group nor
its files are in use.
_________________________________________________________________
CAUTION Do not attempt to purge the PUB group of the SYS account.
You cannot completely purge the public group of the
system account, PUB.SYS. If you specify this group in the
groupname parameter, all nonsystem and inactive files are
purged, which seriously impairs the proper functioning of
the entire system.
_________________________________________________________________
Example
* To purge a group named EXCESS, enter:
:PURGEGROUP EXCESS
GROUP EXCESS TO BE PURGED? (YES/NO)YES
:
Related Commands
LISTGROUP
NEWGROUP
PURGEACCT
PURGEUSER
PURGEUSER
The PURGEUSER command enables a system administrator or an account
manager to remove a user from an account.
Syntax
PURGEUSER user[.acctname]
Parameters
user Specifies the name of the user to be deleted. This
name must contain from one to eight alphanumeric
characters, beginning with an alphabetic character.
acctname Specifies the name of the account where the user is
located. The default is the logon account of the
account manager. System manager (SM) capability is
required to use this parameter.
Operation Notes
* Usage
You can enter this command from a session, a job, a program, or in
break mode. Pressing Break does not affect this command.
You must have system manager (SM) or account manager (AM)
capability to enter this command.
You cannot purge a user if he or she is currently logged on. If
you try to purge a user currently logged on to the system, the
system responds by displaying the message IN USE: CAN'T BE
PURGED. You cannot purge MANAGER.SYS.
* Purge verification
When you enter PURGEUSER during a session, the system displays the
following verification prompt to ensure that you do not
accidentally purge the wrong user:
USER user TO BE PURGED? (YES/NO)
* Deleting remaining files
The files created by a purged user remain after you purge the user
from the system. The following choices are available for deleting
files:
* The system administrator with system manager (SM)
capability can remove the files' account by entering the
PURGEACCT command.
* Someone with account manager (AM) capability can remove the
files' group by entering the PURGEGROUP command.
* Anyone can enter the PURGE command for each file to be
deleted.
Example
* To remove a user named USER1, enter:
:PURGEUSER USER1
USER1 TO BE PURGED? (YES/NO)YES
Related Commands
LISTUSER
NEWUSER
PURGE
PURGEACCT
PURGEGROUP
RECALL/CtrlA RECALL
The RECALL/CtrlA RECALL command displays all pending console resource
request messages. You reply to pending resource requests by using the
REPLY command.
Syntax
From a terminal:
RECALL
From the console:
CtrlA RECALL
Parameters
None.
Operation Notes
* Usage
You can enter this command from a session, a job, a program, or in
break mode. Pressing Break does not affect this command.
You can enter the RECALL command only if your system administrator
has used the ALLOW command or ASSOCIATE command which permits you
to enter this command.
* Differences between RECALL and CtrlA RECALL
Both of these commands function identically except that you can
enter CtrlA RECALL only from the console and not from a job or
program. The = sign appears when you press CtrlA.
Pressing these keys enables you to enter certain commands on a
console from which another process (such as STORE) is currently
running. You should only use the CtrlA RECALL command if the
RECALL command cannot be used.
Examples
* To display all pending console messages from your terminal, enter:
:RECALL
If no requests are pending for a reply, the following message
appears:
NO REPLIES PENDING (CIWARN 3020)
If a request is pending for a reply, a message similar to the
following appears:
THE FOLLOWING REPLIES ARE PENDING:
10:05/#J19/15/LDEV # FOR "L00576" ON TAPE1600 (NUM)?
* To display all pending console messages from the console, enter:
:CtrlA
:=RECALL
If no requests are pending for a reply, the following message
appears:
NO REQUESTS PENDING (SYS 15)
Related Commands
REPLY