HP 3000 Manuals HP 3000 Manuals
Parameters within Syntax (cont.)
Positional parameters (cont.)
BYE
The BYE command terminates an interactive session and displays the
following:
* CPU seconds consumed
* connect time minutes consumed
* date and time of termination
Syntax
BYE
Parameters
None.
Operation Notes
* Usage
You can enter this command from a session, but not from a job, a
program, or in break mode. Pressing Break does not affect this
command.
* Automatic termination
The system automatically terminates your session under the
following circumstances:
* If you enter the HELLO command without logging off your
current session, MPE terminates your current session and
immediately initiates a new one.
* If you are logged on over a telephone line and you hang up
before terminating your session, the system automatically
issues the BYE command.
Example
* To terminate a session, enter:
:BYE
CPU=48. CONNECT=35. FRI, MAY 4, 1990, 10:56 PM
The termination message shown above does not appear if you entered
the BYE command before you initiated a session on the system.
Related Commands
EOJ
EXIT
HELLO
CHGROUP
The CHGROUP command enables you to switch from your current group to
another group within your logon account.
Syntax
CHGROUP [groupname[/grouppass]]
Parameters
groupname Specifies the name of the group that you want to
switch to. If you omit this parameter, you switch
to the home group.
grouppass Specifies the password of the group that you want
to switch to, if the group has a password. If you
want to switch to your home group, you do not need
to provide a password.
Operation Notes
* Usage
You can enter this command from a session or a job, but not from a
program or in break mode. Pressing Break does not affect this
command.
* Command interpreter preservation
This command preserves the entire command interpreter environment
(temporary files, file equations, and variables).
* Password requirements
In a batch job, you must supply a password if a password is
assigned to groupname; otherwise, the job fails and the error
message INCORRECT PASSWORD appears. Similarly, during a session,
you must supply a password if a password is assigned to groupname;
otherwise, the system prompts you for a password.
Examples
* To switch from the current group to your home group, enter:
:CHGROUP
* To switch from the current group to the group called GROUP2,
enter:
:CHGROUP GROUP2
* To switch from the current group to the group called GROUP2 with
the assigned password SECRET, enter:
:CHGROUP GROUP2/SECRET
Related Commands
HELLO
COMMENT
The COMMENT command enables you to insert a comment into a job stream or
a user command.
Syntax
COMMENT [text]
Parameters
text Consists of the comment text that includes an
explanation about the purpose of commands or the
logic used in creating the job. You can also use
text to create job headings. The text can consist
of any ASCII characters.
The default is that a record containing only the
string "COMMENT" is inserted in the command stream.
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.
* Adding comment lines
To continue comment text onto the next line, use an ampersand (&)
as the last nonblank character of the line. Add the ampersand for
each line of text that you want to continue.
Example
* To include the comment THIS IS A SAMPLE JOB in the job named JOB1,
insert the following in your text file:
!JOB JOB1,USER.FINANCE
!COMMENT -- THIS IS A SAMPLE JOB
!FORTGO MYPROG
!EOJ
Related Commands
None
CONSOLE
The CONSOLE command can display the logical device number of the current
console or can move the console to another logical device.
Syntax
CONSOLE [ldev]
Parameters
ldev Specifies the logical device number of the new
console terminal. If you omit this parameter, the
command displays the logical device number of the
current console.
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.
Any user can enter this command to determine the location of the
console; however, you must enter this command from the console to
change its location, unless your system administrator has used the
ALLOW command which permits you to enter this command.
* Command process
When you enter this command, a message that shows the new logical
device number appears on the new console as well as the former
console. All console capabilities transfer to the new console;
the former console becomes a standard session device.
* Restrictions
Restrictions or requirements on the use of this command are as
follows:
* You cannot move the console to a remote terminal, which is
a terminal connected to your system through a distributed
systems (DS) communications line.
* You should not move the console to a terminal that uses a
multipoint terminal software (MTS) line, or a packet
assembly and disassembly (PAD) terminal over a modem.
* Because the console is a session device, you must have a
session logged on to the console in order to enter operator
commands.
* Control and maintenance processor (CMP) and diagnostic
control unit (DCU) prompts and messages remain with the
configured terminal, such as channel 1, device 0, for
example. You cannot move this feature to another terminal.
* You can only execute console (CtrlA) commands from the
console.
Examples
* To determine the current location of the console, enter:
:CONSOLE
CONSOLE IS CURRENTLY ASSIGNED TO LDEV 20
* To transfer the console from the terminal identified by the system
as logical device 20 to the terminal identified as logical device
31, enter:
:CONSOLE 31
CONSOLE HAS BEEN SWITCHED FROM LDEV 20 TO LDEV 31
Related Commands
ALLOW
SHOWALLOW
CONTINUE
The CONTINUE command overrides a command error so that a job or user
command stream continues executing. You typically insert this command in
the command file line preceding any command that you suspect may cause
the job or user command to abort. If an error occurs, the job or user
command continues to run, and the system displays an accompanying error
message.
Syntax
CONTINUE
Parameters
None.
Operation Notes
* Usage
You can enter this command from a job, but not from a session, a
program, or in break mode. Pressing Break does not affect this
command.
Example
* To override a possible error resulting from the processing of
MYPROG and enable JOB1 to continue executing, insert the following
in your file:
!JOB JOB1,USER.FINANCE
!RUN MYPROG
!CONTINUE
!IF JCW <= WARN THEN
! RUN MYPROG2
!ENDIF
!EOJ
Related Commands
JOB
COPY
The COPY command copies a disk file by creating a new identical file.
Syntax
COPY [FROM=]sourcefile[{;TO=}targetfile]
[{, } ]
Parameters
FROM Specifies the name of the file (sourcefile) to be
copied.
TO Specifies the name of the file (targetfile) to
which sourcefile is to be copied. If you omit
targetfile, sourcefile is copied to the target file
as sourcefile.logongroup.logonaccount.
You can qualify targetfile with both the file and
group name, or you can specify only the destination
group. If you specify only the group, COPY copies
the source file in a file called sourcefile to the
specified group. You cannot use COPY to copy files
into another account. Depending on your
capabilities, you may be able to copy files from
another account into your account.
If targetfile already exists in a session, COPY
prompts you as follows:
PURGE OLD targetfile.group.account?
Valid replies are:
Y or YES Instructs COPY to purge the
original targetfile and
create a new targetfile.
N or NO Instructs COPY to terminate.
Break Instructs COPY to terminate.
In a job, the COPY command automatically purges
targetfile if it already exists.
Operation Notes
* Usage
You can enter this command from a session, a job, a program, or in
break mode. Executing the command in break mode does not cause
process creation overhead. Pressing Break aborts the execution of
this command and purges targetfile.
* Command process
This command performs a fast copy of sourcefile to targetfile and
leaves sourcefile unchanged. Both files must be nonspooled disk
files residing on the host system. You can stop the command
process by pressing Break, which purges targetfile.
* File equation options
You can specify files backreferenced with a file equation (*);
however, this command only supports the following file equation
options:
* file name
* final disposition (;TEMP or ;SAVE)
COPY ignores all other file equation options.
* File disposition
The file disposition of targetfile defaults to that of sourcefile.
For example, if sourcefile is TEMP, targetfile is created as TEMP.
If sourcefile is PERM, targetfile is created as PERM. You can
override this file disposition using a file equation.
* File access attributes
All file access attributes of sourcefile, including access control
definitions (ACDs), are duplicated for targetfile.
Examples
* To copy ABCD.logongroup to EFG.logongroup, enter:
:COPY ABCD, EFG
* To copy ABCD.logongroup to ABCD.newgroup, enter:
:COPY ABCD,ABCD.newgroup
* To copy ABCD.grp to ABCD.logongroup, enter:
:COPY ABCD.grp,ABCD
* To copy ABCD.grp to ABCD.mygroup, enter:
:COPY ABCD.grp, .mygroup
Related Commands
FCOPY
RENAME
EDITOR
The EDITOR command starts the EDIT/3000 subsystem, which enables you to
create and alter ASCII text files.
Syntax
EDITOR
Parameters
None.
Operation Notes
* Usage
You can enter this command from a session or a job. You cannot
enter it from a program unless you or the program have process
handling (PH) capability. You also cannot enter this command from
break mode.
Pressing Break suspends execution of this command; entering the
RESUME command continues execution.
Examples
Table 7-1 lists the primary EDIT/3000 commands, explains their
purpose, and provides an example of each command.
Table 7-1. Primary EDIT/3000 Commands
-----------------------------------------------------------------------------------------------
| | | |
| Command | Purpose | Example |
| | | |
-----------------------------------------------------------------------------------------------
| | | |
| ADD | To enter lines of text into the work file | ADD 60,HOLD |
| | or from the hold file | |
| | | |
-----------------------------------------------------------------------------------------------
| | | |
| CHANGE | To replace old text with new text | CHANGE "RECORD" TO "LINE" IN |
| | | 40/70 |
| | | |
-----------------------------------------------------------------------------------------------
| | | |
| COPY | To duplicate portions of text from one | COPY 11/20 TO 80 BY .1 |
| | location to another in the work file | |
| | | |
-----------------------------------------------------------------------------------------------
| | | |
| DELETE | To delete characters and lines from the | DELETE 50/75,150(3)/155(7) |
| | work file | |
| | | |
-----------------------------------------------------------------------------------------------
| | | |
| END | To terminate execution of EDIT/3000 | END |
| | | |
-----------------------------------------------------------------------------------------------
| | | |
| FIND | To locate a point in the work file | FIND *; FIND "PROGRAM" |
| | | |
-----------------------------------------------------------------------------------------------
| | | |
| HOLD | To copy text from the work file into the | HOLD 100/150,APPEND; HOLD 1/10 |
| | hold file (either replacing or appending) | |
| | | |
-----------------------------------------------------------------------------------------------
| | | |
| INSERT | To insert text into the work file from the | INSERT 25(4) |
| | terminal and the hold file | |
| | | |
-----------------------------------------------------------------------------------------------
| | | |
| JOIN | To add all or part of a file to the work | JOIN FILE02 TO 1000 by .1 |
| | file | |
| | | |
-----------------------------------------------------------------------------------------------
| | | |
| KEEP | To save all or part of the work file in a | KEEP FILE02 |
| | user file | |
| | | |
-----------------------------------------------------------------------------------------------
| | | |
| LIST | To display any part or all of the work file | LIST 10/30 |
| | | |
-----------------------------------------------------------------------------------------------
| | | |
| MODIFY | To modify text in the work file using three | MODIFY 50/100 |
| | operations of delete (D), insert (I), and | |
| | replace (R) | |
| | | |
-----------------------------------------------------------------------------------------------
| | | |
| REPLACE | To replace lines in the work file | REPLACE 10/20,HOLD,NOW |
| | | |
-----------------------------------------------------------------------------------------------
Table 7-1. Primary EDIT/3000 Commands (cont.)
-----------------------------------------------------------------------------------------------
| | | |
| Command | Purpose | Example |
| | | |
-----------------------------------------------------------------------------------------------
| | | |
| TEXT | To copy the contents of a user file into | TEXT FILE02 |
| | the work file to be edited | |
| | | |
-----------------------------------------------------------------------------------------------
| | | |
| XPLAIN | To get help on one or more commands. | XPLAIN TEXT |
| | (XPLAIN ALL provides help on all commands.) | |
| | | |
-----------------------------------------------------------------------------------------------
Related Commands
FCOPY
PRINT
EOJ
The EOJ command terminates an input file batch job and displays the CPU
time and the elapsed time since the beginning of the job. This command
is used in conjunction with the JOB command to create an input file for
streaming.
Syntax
EOJ
Parameters
None.
Operation Notes
* Usage
You can enter this command from a job, but not from a session, a
program, or in break mode. Pressing Break does not affect this
command.
* Omitting the command
If you omit this command from an input file, the next JOB command
terminates the current job and starts a new one. The standard
end-of-job display indicates the end of the first job, and the
normal job initiation display indicates the beginning of the next
job.
Example
* To terminate an input file batch job, insert the following in your
text file:
!JOB USER.PUBS
!RUN MYPROG1
!RUN MYPROG2
!EOJ
Related Commands
EXIT
JOB
STREAM
FCOPY
FCOPY is a utility within the system similar to the COPY command, which
enables you to copy data from one file to another file. The FCOPY
command utility provides more flexibility and capabilities than the COPY
command, however.
Syntax
From MPE:
FCOPY {FROM=sourcefile;TO=}[targetfile][;NEW]
From the FCOPY subsystem:
FCOPY
Parameters
FROM Specifies the name of the file (sourcefile) to be
copied.
TO Specifies the name of the file (targetfile) to
which sourcefile is to be copied. If you omit
targetfile, sourcefile is copied to the $STDLIST
device.
NEW Creates a new permanent disk file. The default is
that targetfile must already exist.
Operation Notes
* Usage
You can enter this command from a session, a job, or a program.
Pressing Break suspends the execution of this command. Entering
the RESUME command continues execution of the command.
If you enter this command from a program, either you or the
program must have process handling (PH) capability.
* Utility capabilities
The FCOPY command enables you to do the following tasks:
* Copy data from any input device to any output device.
* Create multiple copies of files.
* Create account-independent magnetic tape copies of disk
files to move from one HP 3000 system to another. (The
STORE and RESTORE commands, however, are recommended for
moving files between systems.)
* Transfer programs or data from one medium to another
(magnetic tape to disk, for example).
* Convert data from one computer code system (EBCDIC, for
instance) to another (ASCII, for instance) as you copy the
data.
* Copy portions of a file.
Refer to the FCOPY Reference Manual (32212-90003) for information on
using these capabilities.
Examples
* To copy the file TEST to a new file named TEMP from the MPE
command interpreter, enter:
:FCOPY FROM=TEST;TO=TEMP;NEW
HP32212A.03.30 FILE COPIER (C) HEWLETT-PACKARD CO. 1990
EOF FOUND IN FROMFILE AFTER RECORD 23
23 RECORDS PROCESSED *** 0 ERRORS
END OF SUBSYSTEM
:
* To copy the file TEST2 to a new file named TEMP2 from the FCOPY
utility subsystem and then exit, enter:
:FCOPY
HP32212A.03.30 FILE COPIER (C) HEWLETT-PACKARD CO. 1990
>FROM=TEST2;TO=TEMP2;NEW
EOF FOUND IN FROMFILE AFTER RECORD 23
23 RECORDS PROCESSED *** 0 ERRORS
>EXIT
END OF SUBSYSTEM
:
Related Commands
COPY
RENAME
FILE
The FILE command enables you to create a file equation that overrides
programmatic or system default file specifications.
Syntax
FILE formaldesignator=[*formaldesignator]
[filereference ]
[;DEV=[#] [device][,[outpri][,numcopies]]]
[ [ [ [F] ]]]
[;REC=[recsize][,[blockfactor][,[U][,BINARY]]]] [;ENV=envfile]
[ [ [ [V][,ASCII ]]]]
[;ACC=[APPEND]] [;FORMS=formsmsg] [;FORMID=formid] [;NOCCTL]
[;CCTL ]
Parameters
formal- designator Specifies a formal file designator in the following
format:
filename[.groupname[.accountname]]
The filename, groupname, and accountname
identifiers form a fully qualified file name. Each
identifier can contain from one to eight
alphanumeric characters, beginning with an
alphabetic character. You can use this file name
to identify the file in subsequent commands.
If formaldesignator is not equated to another file
designation, the parameter specifies the name of an
actual file.
*formal- designator Specifies a backreference to a formal file
designator defined in the FILE command. Note that
this backreferenced form is valid only if it
appears to the right of the equal sign (=).
filereference Specifies the actual file designator of the file in
the following format:
filename[/lockword][.groupname[.accountname]]
Each identifier can contain from one to eight
alphanumeric characters, beginning with an
alphabetic character. In a batch job, the file
does not open if the file has a lockword not
specified in filereference. In a session, the
system prompts you for a lockword if one exists.
DEV Specifies a parameter with one or more of three
parameter options: device, outpri, or numcopies.
If you use DEV, you must include at least one of
these parameters or the # symbol, which specifies
the default device class of DISC.
You can use a previously defined environment
identifier for the DEV parameter, but you cannot
use the domain and organization qualifiers.
Descriptions of the parameter options are as
follows:
device Specifies the logical device
class name or logical device
number of a device, such as a
disk, tape, printer, or a
terminal. The default is
DISC.
outpri Specifies the output priority
requested for an output spool
file, which can range from 1
(the lowest priority) to 13
(the highest priority).
numcopies Specifies the number of
copies requested for an
output spool file. The
maximum number is 127.
REC Specifies a parameter with the following parameter
options:
recsize Indicates the record size.
If you do not use the DEV
parameter, the default is
DISC with 1023 records.
A positive number indicates
words; a negative number
indicates bytes. For
fixed-length files, recsize
is the logical record size.
For undefined-length files,
recsize is the maximum record
size. For variable-length
files, recsize is the maximum
logical record size if the
blockfactor is 1.
Only this parameter option
applies to $STDIN, $STDINX,
or $STDLIST. If you specify
other parameter options for
these files, the FILE command
returns an error.
blockfactor Specifies the number of
logical records per physical
block for new files. The
maximum size is 255.
F, U, or V Defines the format of the
records of the file. A
file can contain
fixed-length records (F),
undefined-length records (U),
or variable-length records
(V). The default is F for
disk files.
BINARY or ASCII Specifies the type of
records. BINARY indicates
binary-coded records and is
the default. ASCII indicates
ASCII-coded records.
ENV Specifies the name of a file, envfile, containing
printer environment information, which controls the
print output formats on the printer. Not all
printers support this feature of accepting
environment information. The envfile can be an
actual file designator, or it can be a formal file
designator preceded by an asterisk (*).
The information in the envfile can contain
specifications for page size, character fonts,
forms, and other printer requirements to be used
with the HP laser printing system. The file must
be in a suitable form for downloading to the
printer.
For example, to specify the environment file
ACCTENV.HPENV.SYS to be used when printing, enter:
FILE ACCTLIST;DEV=ACCTPP;ENV=ACCTENV.HPENV.SYS
For information on creating an environment file for
your printer, refer to your printer documentation.
ACC Specifies only append access to any file.
FORMS Provides an operator message requesting that
certain forms be mounted. The message must appear
and be replied to at the console before the output
data can print on a line printer.
The message can consist of a string of 49 or fewer
ASCII characters terminated by a period. You can
use this parameter to send control characters for
bells and inverse video. If you attempt to send
other control characters, however, blanks and the
associated control character letter may appear.
FORMID Identifies a special form to be mounted. This
parameter only applies to output spool files. The
parameter consists of a string of up to eight
alphanumeric characters, beginning with a letter,
that uniquely identifies the special form.
A message displaying the formid prints on the
console or $STDLIST of the associated user of the
spooled device. The spooler process then waits for
verification that the special forms are mounted
before printing the file for which the formid was
specified.
NOCCTL or CCTL Indicates whether or not you are specifying
carriage-control characters. NOCCTL, the
default, indicates that you are not specifying
carriage-control characters in writes to the file.
CCTL indicates that you are specifying
carriage-control characters in writes to the file.
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 use this command for a file, you must specify a valid, formal
file designator, which is the name by which your program
recognizes the file. The formal file designator enables commands
and code outside your program to reference the file.
* Command duration
The FILE command remains in effect for the entire job or session
unless you cancel it by using the RESET command or you enter
another FILE command for the same formal file designator.
Examples
* To run the program MYPROG that does the following:
* references two files by the file names (formaldesignators)
SOURCE and DEST
* uses two existing disk files, INX and OUTX, as the actual
files for the program
Enter:
:FILE SOURCE=INX
:FILE DEST=OUTX
:RUN MYPROG
* To send output to a new file, FILEX, that has 64-word fixed-length
records and two records per block in ASCII code, enter:
:FILE DEST=FILEX,NEW;REC=64,2,F,ASCII
:RUN MYPROG
Note that the file equation only modifies the specified items.
Related Commands
BUILD
LISTEQ
RESET