HP 3000 Manuals HP 3000 Manuals
Parameters within Syntax (cont.)
Positional parameters (cont.)
RESUMEJOB
The RESUMEJOB command resumes the processing of a job previously
suspended with the BREAKJOB command. The job continues executing from
the point where it was suspended. A message does not appear when
processing resumes.
Syntax
RESUMEJOB #Jnnn
Parameters
#Jnnn Specifies a job number.
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. You can only enter
this command from a terminal other than the console under one of
the following conditions:
* The JOBSECURITY command is set to LOW and #Jnnn refers to a
job logged on to your user.account (or @.account if you are
the account manager).
* Your system administrator has used the ALLOW command which
permits you to enter this command.
Examples
* To display suspended jobs and resume processing a job, do the
following:
1. Enter the following command:
:SHOWJOB SUSP
The system responds by displaying the following message:
JOBNUM STATE INPRI JIN JLIST INTRODUCED JOB NAME
#68 SUSP 105 LP WED. 7:56AM TEST,USER.ACCT
2. Enter the following command to resume processing job number
68:
:RESUMEJOB #J68
Related Commands
ABORTJOB
ALLOW
BREAKJOB
JOBSECURITY
SHOWJOB
RUN
The RUN command executes a program file. It permits the searching of
libraries to satisfy external references. Relocatable libraries (RL) are
not searched.
Syntax
[ {G}]
RUN progfile [;PARM=parameternum] [;LIB= {P}] [;INFO="quotedstring"]
[ {S}]
[ [{*formaldesig}]] [ [{*formaldesig }]]
[;STDIN=[{fileref }]] [;STDLIST=[{fileref [,NEW]}]]
[ [{$NULL }]] [ [{$NULL }]]
Parameters
progfile Specifies the name of the program file to be
executed. This is the only required parameter. If
you specify any other parameters, they override the
default parameters only for the current program
execution.
PARM Specifies a value, parameternum, that you can pass
to the program as a general parameter for control
or other purposes. If you do not specify the
parameter, the default value is zero (0).
The ;PARM= value is limited to a signed 15-bit
decimal or unsigned 16-bit octal or hex value,
unless you use the implied form of the RUN command.
The implied form enables you to use any signed
31-bit number. Refer to "Operation Notes" for
information about the implied form.
LIB Specifies the executable libraries that you can use
to load the program. The available values are as
follows:
G Searches the program's group library first,
then its public account library, and
finally the system library in order to
resolve the program's external references.
P Searches the program's public account
library before the system library to
resolve the program's external references.
S Searches only the system library to resolve
the program's external references. This is
the default.
The group and account libraries referenced by this
parameter must be named SL.group.account for
compatibility mode programs and XL.group.account
for native mode programs. The group and account
are the group and account where the program
resides.
INFO Enables you to pass an ASCII string
("quotedstring") to the program to be run. You
must delimit the string with a matching pair of
quotation marks (either " or '). If you want a
quotation mark to appear within the string, you
must repeat it. For instance, you must type can't
as can''t, and "program" must appear as
""program"".
Including delimiters, the maximum length of the
string is 255 characters, unless you use the
implied form of the RUN command. The implied form
enables you to use up to 279 characters in a
string. Refer to "Operation Notes" for information
about the implied form.
STDIN Specifies the file used as $STDIN by the program
that you want to execute. If you omit this
parameter or if you do not specify anything after
the equal sign (;STDIN=Return, for instance), then
STDIN defaults to the standard list device for the
job or session.
The choices for this parameter are as follows:
*formaldesig Indicates the formal file
designator for a file
previously specified in a
file equation.
fileref Indicates the name of an
existing permanent or
temporary disk file.
$NULL Indicates the actual
file designator of a
system-defined file that is
always handled as an empty
file. When a program reads
from $STDIN, which is equated
to $NULL, it receives an
end-of-file condition.
STDLIST Specifies the file used as $STDLIST by the program
you want to execute. If you omit this parameter or
if you do not specify anything after the equal sign
(;STDLIST=Return, for instance), then STDLIST
defaults to the standard list device for your
session (terminal/screen) or job (job listing).
The choices for this parameter are as follows:
*formaldesig Indicates the formal file
designator for a file
previously specified in a
file equation.
fileref Indicates the name of an
existing permanent or
temporary disk file.
NEW Indicates the name to be
assigned to a job or session
temporary disk file
consisting of 132-byte fixed
ASCII records.
$NULL Indicates the actual
file designator of a
system-defined file that is
always handled as an empty
file. When referenced by a
program as $STDLIST, the
system accepts the associated
write request, but does not
produce physical output;
therefore, you can use $NULL
to discard unneeded output
from an executing program.
Operation Notes
* Usage
You can enter this command from a session or a job. You cannot
enter this command from a program unless you or the calling
program have process handling (PH) capability. Pressing Break
suspends execution of this command. Execution continues when you
enter the RESUME command.
You cannot enter this command directly from break mode. If you
do, the system prompts you to abort the previously suspended
program. If you reply NO, the RUN command does not execute. If
you reply YES, the suspended program aborts and the RUN command
executes.
* Implied form of the command
You can use an implied form of the RUN command by omitting the
command RUN and entering the name of the program along with either
the INFO or PARM parameters. (No other RUN command parameters are
supported.)
The native mode parser, rather than the compatibility mode parser,
is used when you enter the implied form of the command.
Consequently, you can use quotes (" or ') with the program file
name and/or the ;INFO= parameter. Quotes are not required if the
parameter does not contain delimiter characters, such as a blank,
a comma, a semicolon, quotemarks, or an equal sign.
Examples
* To run the program TESTPROG with STDIN set to an old disk file
named INPUT and $STDLIST set to the line printer, enter:
:FILE LPFILE;DEV=LP
:RUN TESTPROG;STDIN=INPUT;STDLIST=*LPFILE
* To set $STDLIST to a temporary disk file named RESULTS that the
RUN command automatically creates, enter:
:FILE INFILE=INPUT,OLD
:RUN TESTPROG;STDLIST=RESULTS,NEW
* To use the INFO= parameter to pass a string to the program, enter:
RUN MYPROG;INFO= "A TEST WITH ""AND"" CHARACTERS"
This examples shows "AND" with an extra pair of quotation marks,
resulting in the following string passed to the program:
A TEST WITH "AND" CHARACTERS
* To pass the same string to the program using the implied form of
the command, enter:
:MYPROG "A TEST WITH ""AND"" CHARACTERS",1
Related Commands
LINK
PREP
XEQ
SECURE
The SECURE command reinstates all file security provisions that you
previously suspended with the RELEASE command.
Syntax
SECURE filereference
Parameters
filereference Specifies the file designator for which you want to
reinstate 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
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.
Example
* To reinstate file access control previously in effect for the file
named FILE1, enter:
:SECURE FILE1
Related Commands
LISTFILE
RELEASE
SHOWDEV
The SHOWDEV command displays status information for all input and output
devices on the system.
Syntax
SHOWDEV [ldev ]
[classname]
Parameters
ldev Specifies the logical device number of the device
for which status information is to be displayed.
This number is unique for each device. Without
this parameter or the classname parameter, the
system displays status information for all devices
on the system.
classname Specifies the class name of device(s) for which
status information is to be displayed. This name
can apply to several devices. Without this
parameter or the ldev parameter, the system
displays status information for all devices on the
system.
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.
* Command field descriptions
When you enter the SHOWDEV command, the display appears in the
following format:
_____________________________________________________________________
| |
| LDEV AVAIL OWNERSHIP VOLID DEN ASSOCIATION|
| |
| 1 DISC 43 FILES |
| 6 SPOOLED SPOOLER OUT |
| 8 AVAIL |
| 20 A UNAVAIL #S311: 7 FILES |
_____________________________________________________________________
Definitions for each of the column fields are as follows:
LDEV Specifies the logical device number and can
include one of the following:
J Accepts jobs.
D Accepts data.
A Accepts jobs and data.
AVAIL Lists the availability of devices and disks
as follows:
AVAIL The device is
available as a real,
nonshareable device.
SPOOLED The device is
available for input or
output spooling.
UNAVAIL The device is
unavailable; it is
controlled by a job, a
session, or a system
process, such as a
spooler.
DISC The device is a disk
and is always
available.
DISC (RPS) The device is a CS-80
disk on which
rotational position
sensing (RPS) has been
enabled.
OWNERSHIP Specifies device ownership and can include
one of the following:
SYS The system controls
ownership. If #nnn
appears, it specifies
the process
identification number
(PIN) of the
controlling process
(program).
SPOOLER IN The input spooler
controls ownership.
SPOOLER OUT The output spooler
controls ownership.
Jnnn The indicated job
controls ownership.
Snnn The indicated session
controls ownership.
nn FILES nn number of files are
currently in use on a
disk.
DOWN The device is offline
as requested by the
system administrator
with the DOWN command.
DP The device is being
taken offline. (A
DOWN command operation
is pending.)
VOLID Specifies the volume identification and can
include one of the following:
IBM The named magnetic
tape volume has a
label written in the
IBM format.
ANSI The named magnetic
tape volume has a
label.
NOLABEL The named magnetic
tape volume has no
label. This is the
default.
DEN Specifies the tape density and can include
one of the following:
6250 The density is 6250
bytes-per-inch (BPI).
1600 The density is 1600
BPI, or the density of
the tape is
unrecognizable.
ASSOCIATION Specifies the logical devices by device
class that the system administrator has
established with the ASSOCIATE command.
Examples
* To display the status of the device identified by logical device
number 5, enter:
:SHOWDEV 5
LDEV AVAIL OWNERSHIP VOLID DEN ASSOCIATION
5 SPOOLED SPOOLER OUT
* To display the status of all devices of the device class CARD,
enter:
:SHOWDEV CARD
LDEV AVAIL OWNERSHIP VOLID DEN ASSOCIATION
6 A AVAIL
Related Commands
ASSOCIATE
DOWN
SHOWJOB
SHOWPROC
SPOOLER
UP
SHOWJOB
The SHOWJOB command displays the following information:
* number of jobs and sessions in each processing state
* current jobfence and job and session limits
* individual spooled and streamed jobs entered in the system
You can choose from three types of display formats.
Syntax
[[#]Snnn ]
[[#]Jnnn ]
SHOWJOB [STATUS ] [;*listfile]
[SCHED ]
[item[;item[;...]]]
Parameters
#Snnn Specifies the session number (assigned by the
system) of the session for which the status
information is to be displayed. The information
appears as described under "Operation Notes." The
default is that the status information for all jobs
and sessions appears.
#Jnnn Specifies the job number (assigned by the system)
of the job for which status information is to be
displayed. The information appears as described
under "Operation Notes." The default is that the
status information for all jobs and sessions
appears.
STATUS Lists the number of jobs and sessions in each
processing state and the current jobfence and job
and session limits. This information appears as
described under "Operation Notes." The default is
that the status information for all jobs and
sessions appears.
SCHED Displays only the scheduled jobs. The information
appears as described under "Operation Notes."
item A list of jobs and sessions whose status is
displayed. The default is that the status
information for all jobs and sessions is displayed.
The syntax for this parameter appears below.
Syntax for Item
[ {INTRO }]
[ {@J }] [ {EXEC }]
[JOB={@S }] [;{SUSP }]
[ {@ }] [ {WAIT [,N]}]
[ {[jsname,]username.acctname}] [ { [,D]}]
Subparameters for Item
JOB A list of jobs and sessions for which status
information is to be displayed. Use one of the
following options:
@J Displays status information
for all jobs.
@S Displays status information
for all sessions.
@ Displays status information
for all jobs and sessions.
This is the default.
[jsname,] username. The jsname is an optional
acctname user-assigned name.
The username is the user name
that the account manager
establishes.
The acctname is the name of
the account that the system
administrator establishes.
You can use @ to replace the
jsname or username in a
specified account.
INTRO, EXEC, SUSP, Displays the status of all jobs or sessions in a
or WAIT specified state.
The INTRO parameter means that the job or session
is being introduced.
The EXEC* parameter means that the job or session
is initializing.
The EXEC parameter means that the job or session is
executing.
The SUSP parameter means that the BREAKJOB command
has suspended the job or session.
The WAIT parameter means that no list devices are
available for the job. The WAIT parameter has the
following subparameters:
N Displays the status of nondeferred ready
device files.
D Displays the status of deferred ready
device files.
*listfile Specifies the formal file designator of the file on
which the output listing is written. This
parameter requires a backreference to a file
equation.
The default characteristics of listfile are that it
is a temporary file, has a record size of 256
bytes, is blocked one record per block, has
carriage control (CCTL), and displays the date and
time. You can override the default characteristics
by using the FILE command.
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.
* Output format
Output appears in one of three possible formats or a combination
of two of the formats.
* If you enter SHOWJOB #Snnn or SHOWJOB #Jnnn, the following
format appears:
JOBNUM STATE IPRI JIN JLIST INTRODUCED JOB NAME
#S16 EXEC 45 45 MON 7:08A TEST.JOB
JOBFENCE= 0; JLIMIT = 3; SLIMIT= 16
* If you enter SHOWJOB STATUS, the following format appears:
7 JOBS:
0 INTRO
0 WAIT; INCL 0 DEFERRED
7 EXEC; INCL 7 SESSIONS
0 SUSP
JOBFENCE= 0; JLIMIT= 3; SLIMIT= 16
* If you enter SHOWJOB SCHED, the following format appears:
CURRENT: 5/13/85 1600
JOBNUM STATE IPRI JIN JLIST SCHEDULED-INTRO JOB NAME
#J38 SCHED 3 10 6 5/16/91 11:24 PAPERS,JON.OSE
#J23 SCHED 8 10 PP 5/25/91 8:01 REPORT,MGR.OSE
#J25 SCHED 8 10 LP 7/12/91 18:05 TEXT,MGR.LPUE
3 JOBS (DISPLAYED)
JOBFENCE=7; JLIMIT=2; SLIMIT=20
In the output shown above, the STATE field shows that the
job is scheduled. The SCHEDULED-INTRO field shows the time
and date that the job is to be introduced to the system.
Note that the scheduled jobs are listed in the order in
which they are to be introduced to the system.
If you enter only the SHOWJOB command, the formatted output for
jobs and sessions in the INTRO, WAIT, and EXEC states appear
first, and the formatted data for jobs in the SCHED state appears
last.
Examples
* To display all jobs and sessions in the system, enter:
:SHOWJOB
JOBNUM STATE IPRI JIN JLIST INTRODUCED JOB NAME
#S745 EXEC 29 29 MON 2:53P DL,SPL.ALANG
#S746 EXEC 26 26 MON 2:53P CLI.AOPSYS
2 JOBS:
0 INTRO
0 WAIT; INCL 0 DEFERRED
2 EXEC; INCL 2 SESSIONS
0 SUSP
JOBFENCE= 2; JLIMIT= 1; SLIMIT= 16
* To determine the number of jobs and sessions in each processing
state, the current jobfence, and the job and session limits,
enter:
:SHOWJOB STATUS
6 JOBS:
0 INTRO
0 WAIT; INCL 0 DEFERRED
6 EXEC; INCL 6 SESSIONS
0 SUSP
JOBFENCE= 0; JLIMIT= 3; SLIMIT= 16
* To override the default characteristics of listfile with the FILE
command, and then show the output produced with the new listfile
characteristics, enter the following sequence of commands:
:FILE A;REC=40,1,F,ASCII;NOCCTL
:SHOWJOB;*A
:SAVE A
:PRINT A
The output appears as shown:
__________________________________________________________________
| |
| HP32212A.03.30 FILE COPIER (C) HEWLETT-PACKARD CO. 1990 |
| |
| MON, AUG 5, 1991, 7:54 AM |
| |
| JOBNUM STATE IPRI JIN JLIST INTRODUCED JOB NAME |
| #S46 EXEC 20 20 MON 7:14A OPERATOR.SYS |
| #S45 EXEC 47 47 MON 6:37A USER.PUBS |
| #S47 EXEC 10S LP MON 7:26A SUPPORT.DOC |
| #S48 EXEC 102 102 MON 7:28A USER.TECH |
| #J19 EXEC 28 28 MON 6:41A JON.OSE |
| #S49 EXEC* 34 34 MON 7:31A TEXT.LPUE |
| #J21 EXEC 10S LP MON 7:15A DELIVER,MAIL.MAIL |
| #J22 EXEC 10S LP MON 7:14A RSPOOLJ,RSPOOL.SYS|
| |
| 8 JOBS (DISPLAYED): |
| 0 INTRO |
| 0 WAIT; INCL 0 DEFERRED |
| 8 EXEC; INCL 5 SESSIONS |
| 0 SUSP |
| JOBFENCE= 6; JLIMIT= 4; SLIMIT= 50 |
| EOF FOUND IN FROMFILE AFTER RECORD 17 |
| |
| 18 RECORDS PROCESSED *** 0 ERRORS |
| |
| END OF SUBSYSTEM |
| : |
__________________________________________________________________
Note that the SHOWJOB command reports a job or session as EXEC*
when it is initializing. After initialization is complete, the
state changes to EXEC. The number of jobs and sessions shown in
the EXEC state is the sum of the jobs and sessions in both EXEC
and EXEC* states.
Related Commands
ABORTJOB
ALTJOB
BREAKJOB
JOBFENCE
LIMIT
RESUMEJOB
SHOWPROC
SHOWME
The SHOWME command displays the status of the current job or session.
The major items displayed are as follows:
* session number
* logon account name
* logon group name
* user name
* release number
* product version
* user version
* current time and date
* logon time
* CPU time consumed
* connection time
* LDEV number
Syntax
SHOWME
Parameters
None.
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.
Example
* To display the status of the current job or session, enter:
______________________________________________________________________
| |
| :SHOWME |
| USER: #S485,MGR.DSUSER,PUB (NOT IN BREAK) |
| RELEASE: A.41.00 MPE XL HP31900 A.51.07 USER VERSION: A.41.00|
| CURRENT: TUE, AUG 27, 1991, 3:33 PM |
| LOGON: TUE, AUG 27, 1991, 9:51 AM |
| CPU SECONDS: 6 CONNECT MINUTES: 342 |
| $STDIN LDEV: 28 $STDLIST LDEV: 28 |
______________________________________________________________________
In the example above, the fields show the following information:
FIELD DEFINITION
USER Shows the job or session number, account,
user, and group. The messages (IN PROGRAM),
(IN BREAK), or (NOT IN BREAK) indicate whether
you entered SHOWME programmatically or
directly from the MPE/iX command interpreter.
RELEASE Shows two version, update level, and fix
(v.uu.ff) numbers. The first v.uu.ff is the
release number that shows the operating system
release identifier. This number is
established by Hewlett-Packard during their
build of the entire software release package
and provides an identity for the release.
The second v.uu.ff is the product number.
This number is established by Hewlett-Packard
and serves as a unique identifier for service
requests (SRs) submitted against the operating
system.
USER VERSION Shows the version, update level, and fix
(v.uu.ff) assigned to your system. This can
be given a value during SYSGEN and enables you
to identify any of your software changes, such
as patch level and third-party software.
CURRENT Shows the current time and date.
LOGON Shows the logon time.
CPU SECONDS Shows the amount of central processor unit
(CPU) time in seconds that this job or session
has consumed.
Note that SHOWME calculates CPU usage by
adding the local CPU usage of the current
process to the accumulated total of all
terminated processes. The CPU usage listed
for a programmatic SHOWME, therefore, would
rarely agree with that for a SHOWME entered in
break mode.
CONNECT MINUTES Shows the amount of time in minutes the job or
session has been connected.
$STDIN LDEV Shows the logical device number of the job or
session's standard input device.
$STDLIST LDEV Shows the standard list device number.
Related Commands
None
SHOWTIME
The SHOWTIME command displays the current time and date, as indicated by
the system clock.
Syntax
SHOWTIME
Parameters
None.
Operation Notes
* Usage
You can enter this command from a session, a job, a program, or in
break mode.
Example
* To display the current date and time, enter:
:SHOWTIME
MON, MAY 6, 1991, 8:47 AM
Related Commands
None