HP 3000 Manuals HP 3000 Manuals
Parameters within Syntax (cont..)
Positional parameters (cont.)
RELEASE
The RELEASE command removes security provisions from a file. Security
does not resume for a released file until you enter the SECURE command
for the file or until the system is restarted with a SYSGEN tape created
before the file was released.
Syntax
RELEASE filereference
Parameters
filereference Specifies the file designator for which you want to
suspend file access control. The form of
filereference consists of the following elements:
filename[/lockword][.groupname[.acctname]]
If the file has a lockword, you must specify it;
otherwise, the system prompts you for it. If you
do not specify groupname.acctname, the system
assumes the logon group and account.
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 use this command only for permanent disk files you have
created. Under default system security provisions, the file must
be in your logon account and must belong to your logon or home
group.
* Checking the file status
If you have the appropriate capabilities, you can enter the
LISTFILE command to determine if a file is currently released or
secured. Your ability to check passwords depends on your
capability level. Refer to the LISTFILE command for more
information.
* Access control definition
An access control definition (ACD) overrides file access controls
whether or not you have released or secured the file.
* Unaffected access controls
This command does not affect the following access controls:
Privileged files You cannot release privileged files.
Lockwords You cannot remove lockwords.
ACDs This command does not affect access control
definitions, however, if you remove an ACD, a
file associated with the ACD can be released.
Refer to the ALTSEC command in the Help
Facility for more information about ACDs.
Example
* To release all security provisions for a file named FILE1 in a
logon group and account named GROUP1.ACCT1, enter:
:RELEASE FILE1
If the system fails to locate the file, the following error
message appears:
UNABLE TO ACCESS FILE1.GROUP1.ACCT1. (CIERR 356)
Related Commands
ALTSEC
LISTFILE
SECURE
RENAME
The RENAME command changes the system identification for a file. You can
use this command to change the name of a file, to move a file from one
group to another, or to change the lockword.
Syntax
RENAME oldfilereference,newfilereference[,TEMP]
Parameters
oldfile- reference Specifies the current name of the file. The form
of oldfilereference consists of the following
elements:
filename[/lockword][.groupname[.acctname]]
If you specify acctname, the logon account must
belong to you; you must be the creator of the file
to rename it.
newfile- reference Specifies the new name of the file in the same
format as oldfilereference. If you specify
acctname, the logon account must belong to you. If
you specify groupname, you must have SAVE access to
the group name. If you omit acctname and/or
groupname, the logon account and/or group are
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.
* Requirements
To rename a file, you must be the file's creator and must have
exclusive access to the file. You cannot rename files that exist
in other accounts. To copy files that exist in other accounts,
use the FCOPY command.
* Restrictions
You cannot use this command for compatibility mode KSAM files,
because there are internal linkages between the key information
and the data files, however, you can use this command to rename
KSAM MPE/iX files.
* Renaming spool files
The RENAME command renames spool files if you have access to them,
but only for spool files that are not linked to the spooler print
queues.
Examples
* To change the name of a file named OLDFILE to a file named
NEWFILE, enter:
:RENAME OLDFILE,NEWFILE
* To change the lockword of the file FILE2 from LOCKA to LOCKB,
enter:
:RENAME FILE2/LOCKA,FILE2/LOCKB
* To move a file from GROUP1 to GROUP2 within the same account,
enter:
:RENAME MYFILE.GROUP1,MYFILE.GROUP2
To apply the command as shown above, you must have save access to
the group named in the second parameter (GROUP2). Also, both
groups must reside in the system.
Related Commands
COPY
LISTFILE
LISTSPF
PURGE
REPLY/CtrlA REPLY
The REPLY command enables you to reply to pending resource requests.
Syntax
From a terminal:
REPLY pin,reply
From the console:
CtrlA REPLY pin,reply
Parameters
pin Specifies the message sender's process
identification number (PIN), which always appears
after the second forward slash (/) of the message.
In the following example, the PIN is 43.
?16:15/#S25/43/LDEV# FOR "T" ON TAPE (NUM)?
reply Specifies one of three reply types shown in
parentheses in the message:
(NUM) Supply a logical device
number.
(Y/N) Supply YES (Y) or NO (N).
(MAX CHARS=nn) Supply a string expression
consisting of nn characters
or fewer. This reply type is
only used for labeled tapes.
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 REPLY command only if your system administrator has used
the ALLOW command or ASSOCIATE command, which permits you to enter
this command.
* Differences between REPLY and CtrlA REPLY
Both of these commands function identically except that you can
enter CtrlA REPLY 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 use the CtrlA REPLY command only if the REPLY
command cannot be used.
* Replying to requests
Programs requesting the use of a device waiting for a reply remain
suspended indefinitely and cannot be aborted until you enter the
REPLY or ABORT command. If you cannot reply as requested, such as
when a particular device is nonexistent, use 0 if (NUM) is
requested or use N if (Y/N) is requested. This action aborts the
pending resource request.
Examples
* To respond to the following standard tape message, enter:
10:05/#J19/15/LDEV# FOR "NAS" OF TAPE1600 (NUM)?
:REPLY 15,7
or
CTRL A
=REPLY 15,7
* To reply to a standard forms request, enter:
16:00/#S93/22/STANDARD FORMS
?16:00/#S93/22/LDEV # FOR #S95;L ON LP (NUM)?
:REPLY 22,12
or
CTRL A
=REPLY 22,12
Related Commands
ALLOW
ALTSPOOLFILE
ASSOCIATE
RECALL
SYSGEN (AUTOREPLY)
REPORT
The REPORT command displays the total resource usage logged against
accounts and groups, as well as the resource limits. Standard users can
only display data for their logon group. Users with account manager (AM)
capability can display all groups in their account. Users with system
manager (SM) capability can display all groups in all accounts.
Syntax
REPORT [groupset][,listfile]
Parameters
groupset Specifies the accounts and groups for which
information is to be listed. The permissible
parameter values and their capability requirements
are as follows:
group Reports on the specified
group in the logon account.
This is the default for
standard users, who can
specify only their logon
group.
@ Reports on all groups in the
logon account. This is the
default for account managers,
and only users with account
manager (AM) or system
manager (SM) capability can
use this parameter value.
group.acct Reports on the specified
group in the specified
account. This parameter
value requires system manager
(SM) capability.
@.acct Reports on all groups in the
specified account. This
parameter requires account
manager (AM) capability (if
it is the logon account) or
system manager (SM)
capability for any account.
@.@ Reports on all groups in all
accounts. This parameter
value requires system manager
(SM) capability.
group.@ Reports on a specified group
in any account. This
parameter value requires
system manager (SM)
capability.
You can use the following wildcard characters to
specify a set of names:
@ Specifies zero or more alphanumeric
characters. Used by itself, @ specifies
all possible combinations of such
characters. Used with other characters,
@ specifies all the possible names that
include the specified characters.
(@ABC@ translates to all names that
include ABC anywhere in the name.)
# Specifies one numeric character. (A###@
translates to all names that begin with
A followed by any three digits, followed
by any combination of zero to four
alphanumeric characters.)
? Specifies one alphanumeric character.
(A?# translates to all the
three-character names that begin with A,
followed by an alphanumeric, followed by
a digit.)
You can use these characters as follows:
n@ Reports on all groups starting with the
character "n."
@n Reports on all groups ending with the
character "n."
n@x Reports on all groups starting with the
character "n" and ending with the
character "x."
n##...# Reports on all groups starting with the
character "n" containing all digits
after the "n."
?n@ Reports on all groups whose second
character is "n."
n? Reports on all two-character groups
starting with the character "n."
?n Reports on all two-character groups
ending with the character "n."
You can also use these characters, when placed
appropriately in the groupset parameter, to report
on accounts.
listfile Specifies the file designator of the output file
where the information is to be written. The
default is $STDLIST, but you can redirect output
with a file equation as follows:
:FILE LIST1;DEV=LP
:REPORT, *LIST1
Operation Notes
* Usage
You can enter this command from a session, a job, a program, or in
break mode. Pressing Break aborts execution of this command.
You must have account manager (AM) capability to enter this
command for an entire account, and you must have system manager
(SM) capability to enter this command for the entire system.
Example
* To obtain a report of account information for the account, SOPRM,
enter:
:REPORT @.SOPRM
ACCOUNT FILESPACE-SECTORS CPU-SECONDS CONNECT-MINUTES
/GROUP COUNT LIMIT COUNT LIMIT COUNT LIMIT
SOPRM 99004 ** 99057 ** 88407 **
/GLOSSARY 1068 ** 542 ** 656 **
/PUB 182 ** 123 ** 1155 **
/SECT1 180 ** 85 ** 429 **
/SECT10 11779 ** 25271 ** 9716 **
/SECT2 390 ** 4123 ** 5302 **
The information in the display shows usage counts and limits for
permanent file space in sectors, CPU-time in seconds, and session
connect-time in minutes. The file space usage count reflects the
number of sectors used when you enter the command; however,
CPU-time and connect-time usage appear as they were immediately
before the beginning of the current job. Two asterisks (**) under
the LIMIT column indicate that no predefined limit for this
resource exists.
Related Commands
LISTFILE
RESETACCT
RESTORE
The RESTORE command returns files that are currently stored on magnetic
tape to the system.
Syntax
RESTORE [restorefile][;filesetlist][;option[;...]]
where option is:
[;DEV={devclass}][;SHOW[=showparmlist[,showparmlist[,...]]]]
[ {ldn }]
[ {LOCAL } ]
[;{GROUP=groupname } [;...]]
[ {ACCOUNT=accountname} ]
[;{KEEP }][;ONERROR={QUIT}][;DIRECTORY][;LISTDIR]
[ {NOKEEP}][ {SKIP}]
Parameters
restorefile Specifies the name of the magnetic tape file that
contains the files that you want to restore to the
system. You must backreference the file by using
an asterisk (*). First, you must use a file
equation before entering the RESTORE command. For
instance, if you want to restore files from a file
called SOURCE, you would enter the following file
equation before entering the RESTORE command:
FILE SOURCE;DEV=TAPE
A message appears on the console asking you to
mount the tape identified by the restorefile
parameter and to allocate the device.
Before entering RESTORE, you can identify
restorefile as a magnetic tape file using the FILE
command. If you do not specify a device, the
system uses the default filename, your username,
and TAPE as the device. For instance, if you are
logged on to TOM.MGR, a tape request is generated
for TOM. You cannot use a file equation to change
the default.
filesetlist Specifies the set of files to be restored. The
default is @ (all files in the logon group)
regardless of capabilities. The form of this
parameter is as follows:
filesetitem[,filesetitem[...]]
where filesetitem can be ^indirectfile or fileset.
indirectfile Consists of a file that
contains the files to be
restored along with restore
options. If you specify
options, you can list them
only after the first
semicolon (;) on each line.
An option you specify on one
line operates on all files in
the indirect file.
If you use the ;DATE option,
you can specify it on only
one line. If ;DATE appears
on more than one line, the
last occurrence is used, and
an error message appears.
fileset Specifies the set of files to
be restored and, optionally,
the files to be excluded in
the form:
filestorestore[-filestoexclude[..]]
The system restores any file
that matches filestorestore
unless the file also matches
filestoexclude, which
specifies files to be
excluded from the restore
operation. The maximum
number of filestoexclude is
nine.
Both filestorestore and
filestoexclude may be fully
qualified in the form:
filename[.groupname[.accountname]]
You can use the following
wildcard characters to
specify file, group, or
account names. Each wildcard
character applies toward the
eight-character limit for
group, account, and file
names.
@ Zero or
more
alphanumeric
characters
(8
maximum).
# One
numeric
character.
? One
alphanumeric
character.
[ ] A range
of
characters.
You can use these characters
to specify sets of files:
n@ All
files
beginning
with
the
character
"n."
@n All
files
ending
with
the
character
"n."
n@x All
files
beginning
with
the
character
"n" and
ending
with
the
character
"x".
n##...# All
files
starting
with
the
character
"n"
followed
by as
many
digits
as
there
are "#"
marks
(maximum
7).
This is
useful
for
restoring
all
EDIT/3000
temporary
files
(K#######).
?n@ Any
file
whose
second
character
is "n."
n? All
two-
character
files
that
begin
with
the
character
"n."
?n All
two-
character
files
that
end
with
the
character
"n."
[A-C]@ All
files
that
begin
with
the
letters
"A,"
"B," or
"C."
myset [e-g1] All
files
that
begin
with
the
name
"myset"
and end
in "e,"
"f,"
"g," or
"1."
myset[d-e 1-6] All
files
that
begin
with
the
name
"myset"
and end
in "d"
or "e",
or "1,"
"2,"
"3,"
"4,"
"5," or
"6."
You can enter a file set in
any of the following formats:
file.group.acct One
particular
file in
one
particular
group
in one
particular
account.
file.group One
particular
file in
one
particular
group
in the
logon
account.
file One
particular
file in
the
logon
group
and
account.
@.group.acct All of
the
files
in one
particular
group
in one
particular
account.
@.group All of
the
files
in one
particular
group
in the
logon
account.
@.@.acct All of
the
files
in all
of the
groups
in one
particular
account.
@ All of
the
files
in the
logon
group
and
account.
This is
the
default
for all
users
regardless
of
capabilities.
@.@ All of
the
files
in all
of the
groups
in the
logon
account.
@.@.@ All of
the
files
in the
system.
thisisit. @.acct Any
file
named
thisisit
in all
of the
groups
in one
particular
account.
DEV Specifies the device where the file resides. The
parameter value choices are as follows:
devclass Specifies the type of device.
If you specify devclass, the
system allocates the file to
the home volume set (within
the specified device class)
of the group where a file is
being restored.
ldn Specifies a particular
device. If you specify ldn,
the system allocates the file
to the device only if one of
the volumes in the home
volume set (of the group
where a file is being
restored) currently occupies
the device.
The default is that the system attempts to restore
the file in the following order:
* Attempts to restore the file on a logical
device compatible with the type and subtype
specified in the file's file label and with
the type and subtype of the mounted home
volume set (of the group where a file is
being restored).
* Attempts, if the above method fails, to
restore the file on the same device class as
specified in the file's file label and that
of the mounted home volume set (of the group
where a file is being restored).
* Attempts, if the above method fails, to
restore the file on any member of the home
volume set (of the group where a file is
being restored).
If all of the above methods fail, the file is not
restored.
SHOW Instructs the RESTORE command to report information
for every restored file. The default is that only
the total number of all unrestored files are
listed. For unrestored files, the reason and names
are listed. The listing goes to $STDLIST (formal
file designator SYSLIST) unless you have used the
FILE command to direct the listing to another
device. For instance,
FILE SYSLIST;DEV=LP
sends the listing to the line printer if you enter
the file equation before you enter the RESTORE
command.
The format for the value showparmlist is:
showparm [,showparm[,showparm[,...]]]
where showparm can be one of the following:
SHORT Overrides a default of LONG
and displays the file name,
group name, account name,
volume restrictions, file
size (in sectors), file code
(mnemonic if available), and
reel number.
LONG Overrides a default of SHORT
and displays all of the SHORT
information plus the record
size, blocking factor,
maximum number of extents
allowed, end-of-file, and
file record limit.
DATES Displays the creation date,
the last date of access, and
the last date of
modification.
SECURITY Displays the file creator and
the security matrix.
OFFLINE Sends an additional copy to
the device OFFLINE, which
defaults to device LP.
If you specify the SHOW parameter and you omit the
value showparmlist, then the default is SHORT if
the recordsize of SYSLIST is less than 118 (99 in
compatibility mode) characters, or LONG if the
recordsize is equal to or greater than 118 (99 in
compatibility mode).
LOCAL Specifies that files are restored regardless of the
system directory structure. The files are stored
under your logon group and account. You must have
read access to the tape to use this parameter.
GROUP Specifies that the files being restored are
restored to an existing group identified as
groupname. If you specify LOCAL, you cannot
specify groupname.
ACCOUNT Specifies that the files being restored are
restored to an existing account identified as
accountname.
KEEP Instructs the system to preserve the file on the
disk and to ignore the file on the restore tape,
assuming that the file on the restore tape has the
same name as a file already residing on the disk.
The file on tape is not restored and the file on
the disk is preserved.
The default is that if you do not specify KEEP, the
file on the RESTORE tape replaces the identically
named file on the disk. The only exception is if
the file on the disk is being accessed when RESTORE
attempts to replace it. In this case, RESTORE
preserves the file on the disk (as if you had
specified KEEP) and ignores the file on the tape.
NOKEEP Instructs the system to restore every file on the
tape, even if it has the same name as a file
already residing on the disk. The default is
NOKEEP.
ONERROR Instructs RESTORE how to proceed if a tape read
error occurs. Although the parameter is optional,
you must select one of the following parameter
choices if you use this parameter:
QUIT Instructs RESTORE to abort
after a tape read error.
SKIP Instructs RESTORE to perform
a file-skip-forward past a
tape error, to resynchronize,
and to resume reading from
the tape.
If you omit this parameter, the default is QUIT for
both labeled and unlabeled tapes.
DIRECTORY Instructs RESTORE to restore all the volume set
directories on the media. You must have system
supervisor (OP) or system manager (SM) capability
to use this parameter.
LISTDIR Displays the directory on tape, if specified with
DIRECTORY. LISTDIR without DIRECTORY displays
information from the tape directory and tape label,
but does not restore any files.
Displayed items include the tape creation type,
record size, and any files that match your
filesetlist. Security restrictions that apply to
filesetlist also apply for this parameter. The
output is sent to SYSLIST.
This parameter only applies to store tapes created
with NMSTORE. It cannot be used on compatibility
mode tapes.
Operation Notes
* Usage
You can enter this command from a session, a job, and a program.
Pressing Break aborts the execution of this command.
You must have system manager (SM), system supervisor (OP), or
privileged mode (PM) capability to use this command for privileged
files.
* Command process
After you enter this command, a message on the console requests
you to mount the tape identified by the restorefile parameter and
to reply to the device. A message does not appear if Autoreply is
configured through SYSGEN. If a reply is pending, RESTORE waits
for the reply before proceeding.
RESTORE then restores the file(s) and sends the generated output
to a file whose formal designator is SYSLIST. If the system
encounters an error, the RESTORE command reports the error to
SYSLIST (defaults to $STDLIST) and continues. The system does not
restore any files belonging to a group whose home volume set has
not been mounted.
* Required capabilities for restoring files
Your capabilities determine which files you can restore. If you
have standard user capability, you can restore files only in your
logon group. If you have system manager (SM) or system supervisor
(OP) capability, you can restore any file from a store tape,
assuming that the account and group to which the file belongs and
the user who created the file are defined in the system. If you
have account manager (AM) capability, you can restore any file in
your account. Restoring files with negative file codes requires
privileged mode (PM), system supervisor (OP), or system manager
(SM) capability.
* Lockword requirements
If you do not have system manager (SM) or system supervisor (OP)
capability, you must always supply the lockword; however, if you
have account manager (AM) capability and are working in your own
account, you do not have to supply a lockword. If you enter
RESTORE as a job, you must supply file lockwords if you do not
have SM, OP, or AM capability.
Your system administrator can restore files without specifying the
lockword only if he or she enters RESTORE during a session.
* Disk space requirements
The RESTORE command determines whether sufficient disk space is
available to restore a file that already exists on the disk. If
sufficient space is available, RESTORE writes a new copy of the
file to the disk before purging the old copy of the file. The
system purges the old copy of the file only if the restore
operation is successful.
If sufficient space is unavailable and the file is not a data set
from an IMAGE database, RESTORE first purges the old copy of the
file and then writes a new copy to the disk. If the restore
operation fails in this circumstance, the following message
appears on $STDLIST, informing you that a copy of the file does
not exist on the disk:
***WARNING: OLD FILE HAS BEEN PURGED***
If the file is an IMAGE database data set and sufficient space is
unavailable, RESTORE does not purge the old copy of the file.
* Restoring files without specifying a file set
If you restore all files without specifying a filesetlist, the
RESTORE command warns you that the system has restored all files,
based on your capabilities. The following example shows how the
system responds if a user with system manager (SM) capability
enters RESTORE without a filesetlist:
:RESTORE
STORE/RESTORE, VERSION 3 (C) 1986 HEWLETT-PACKARD CO.
FRI, APR 26, 1991. 11:57 AM
****WARNING: AN 'EMPTY' FILESET WAS FOUND...BASED ON YOUR
CAPABILITIES, '@.@.@' WILL BE ASSUMED****
(S/R 1911)
Examples
* To restore all files belonging to your logon group from the
restorefile T, enter:
:FILE T;DEV=TAPE
:RESTORE *T;@;KEEP;SHOW
The system responds by prompting you to mount the tape identified
as T. If a file on T already exists in your group, it is not
restored because you specified the KEEP parameter.
* To restore file ABC without specifying a restorefile (no file
equation is necessary), enter:
:RESTORE;ABC.PUB.SYS;SHOW
STORE/RESTORE, VERSION A.20.03 (C) 1986 HEWLETT-PACKARD CO.
FRI, APR 26, 1991, 11:56 AM
WILL RESTORE 1 FILES; NUMBER OF FILES ON TAPE=
FILENAME GROUP ACCOUNT VOLUME RESTRICTIONS SECTORS CODE REEL
ABC .PUB .SYS MPEXL_SYSTEM_VOLUME_SET 4 NMPROG 2
FILES RESTORED: 1
:
* To print the list of restored files on a line printer, enter:
:FILE SYSLIST;DEV=LP
:FILE T;DEV=TAPE
:RESTORE *T;@;SHOW
* To restore all files except those in the PUB group of the SYS
account, enter:
:RESTORE *T;@.@.@-@.PUB.SYS
Related Commands
RECALL
REPLY
STORE
RESUME
The RESUME command resumes execution of a program or subsystem command
that was suspended after you pressed the Break key. The program resumes
at the point where execution was suspended.
Syntax
RESUME
Parameters
None.
Operation Notes
* Usage
You can only enter this command in break mode. You cannot enter
this command from a job, a program, or a session (unless in break
mode). Pressing Break does not affect this command.
* Entering commands other than RESUME
If you enter a program or subsystem command after pressing Break,
the command interpreter prints the following message on your
terminal: ABORT? (YES/NO). If you respond YES to the message, the
command interpreter aborts the currently suspended program. If
you respond NO to the message, the command interpreter prints the
message COMMAND NOT ALLOWED IN BREAK and prompts you for another
command. If you now enter RESUME, the suspended program resumes
at the point where it was interrupted.
You can enter most commands after pressing Break. Only the
commands that create processes require you to resume or abort the
interrupted program.
Example
* To continue a suspended program at the point of interruption, do
the following:
1. Enter the following command:
:RESUME
The system responds by displaying the following message:
READ PENDING
2. Press Return to resume the program.
Related Commands
ABORT