SHOW [ SNA NRJE User/Programmer Reference Manual ] MPE/iX 5.0 Documentation
SNA NRJE User/Programmer Reference Manual
SHOW
Provides information about jobs you have submitted.
If you are connected to a VSE/POWER host system, only those jobs awaiting
transmission are shown.
Syntax
______________________________________________________________
| |
| { SpoolfileID } |
| { Name } |
| { UserName.AcctName }[;W[SID]=Wsid]|
| SH[OW] { @ } |
| {;HJ=HostJob [,HostJob[,...]] } |
| {;HJ=FirstJob/LastJob } |
| {;HJ=#0 SpoolfileID } |
______________________________________________________________
Parameters
SpoolfileID Use when you want to show information about a specific job. The
SpoolfileID parameter is assigned by the spooler after you submit a
job. Its form is nnnnn, where n is a digit. Jobs can be shown by
SpoolfileID only before they are transmitted to the host. To view
job status by SpoolfileID after the job is transmitted to the host,
you would indicate the output spool ID in the HostJob parameter.
Name The spool file name associated with your job in the NRJE reader queue
and the name associated with your job in the Job Log. You can submit
several jobs with the same name, and then use the SHOW Name command
to receive information on all of them.
UserName.AcctName Use for information about jobs submitted by UserName.AcctName.
A period (.) must separate UserName from AcctName.
If your logon UserName.AcctName is different from what you specified,
you must be configured with NM user capability to use this parameter.
@ Use to show information about all jobs you submitted, when your logon
UserName.AcctName is the same as the job UserName.AcctName. If you
have NM capability, all jobs submitted by other users are shown,
also.
HostJob Either the jobname from the job card or the job number assigned by
the host. Jobs can be shown by HostJob only after they have been
entered in the Job Log (that is, transmitted to the host). Multiple
job numbers and names are allowed; a maximum of five single job
numbers or jobnames are allowed, delimited by commas (,). There is
no limit when a range is specified.
You can also view job status after the job is transmitted to the host
without getting into the console (;HJ=#0 SpoolfileID).
Wsid Overrides the default Wsid named in the NRJE command, for this
command only. Unless you are configured with NM capability, you must
be the submitter of the jobs you want to SHOW.
Description
The SHOW command enables you to display a list of specified jobs
submitted to the host. You specify the list of jobs to show by entering
a SpoolfileID, a Name, a UserName.AcctName, an @ symbol, or HostJob name
or number. You can specify a particular workstation transmission queue
by entering the WSID=Wsid parameter in this command. If you omit the
Wsid parameter, this command refers to the transmission queue of the
default workstation. You establish a default workstation by using the
Wsid parameter when you start an NRJE workstation with an NRJE command.
The display from the SHOW command is split into two sections. The first
section provides information on jobs that have not yet been transmitted
to the host. The second section provides information on jobs that have
already been transmitted. The second section of information comes from
the Job Log and therefore is not provided if you are connected to a
VSE/POWER host system. For MPE XL, release 2.1 or later, only the first
100 untransmitted jobs are shown at a time.
Untransmitted Files
The list you receive identifies each specified job by SpoolfileID, Name,
and UserName.AcctName. The priority , state , rank size, and time when
each specified job was submitted are also displayed. Each column of
output provided by the SHOW command for untransmitted files is described
below.
Column Heading Contents
#O A SpoolfileID.
Name The name of the file associated with your job.
Pri The spool file transmission queue priority number. The
highest priority is 14, the lowest 0.
State The spooling state of the file:
MPE V and MPE XL prior\ MPE XL release 2.1 and
to release 2.1 later
ACTIVE ACTIVE
READY READY
OPEN OPEN
LOCKED DEFER
CREATE
TRANSFER
PRINT
PROBLEM
DEL_PENDING
SPSAVE
Refer to the MPE V/E System Operation and Resource
Management Reference Manual (32033-90005) or the MPE XL
Native Mode Spooler Reference Manual (32650-90166) for an
additional discussion of spooling states.
Rank The order of a file within its transmission queue.
Size The number of spool file sectors of the file.
User.Account The UserName.AcctName of the submitter of this job.
Time When this job was submitted.
Transmitted Files
For files that have already been transmitted to the host, display of the
PRINT, PUNCH, and FORMS dispositions is in a free format. NRJE attempts
to display these fields on a single line if possible, but will use
multiple lines as necessary. If you took the default for any of these
options, NRJE displays the string (NOT SPECIFIED) for each applicable
option. In such cases, output routing depends on the configured defaults
for the remote logical writers and any routing designations using form
names and Lookup Table entries. The keyword FILE indicates that the user
entered a backreferenced formal file designator. See the SUBMIT command
for information on the PRINT, PUNCH , and FORMS options.
Restriction
You must be configured with NM capability to use this command for jobs
outside of your logon UserName.AcctName.
Example
____________________________________________________________________________
| |
| RMT32>REMARK THIS SHOW @ IS BY A USER WITH NM CAPABILITY |
| |
| Provide information about all jobs. |
| |
| RMT32>SHOW @ |
| |
| #O Name Pri State Rank Size User.Account Time |
| 1069 13 READY 1 32 KEN.NRJE 10:48 |
| 1075 12 READY 2 20 ANNE.NRJE 10:55 |
| |
| 2 JOB(S) AWAITING TRANSMISSION TO HOST. |
| |
| --JOB#=1030 JOBNAME=DS1 USER=ANNE.NRJE |
| TRANSMITTED TO HOST WED, AUG 5, 1987, 4:05 PM HOST#=3022 |
| PR= (NOT SPECIFIED) PU= (NOT SPECIFIED) FO= (NOT SPECIFIED) |
| |
| --JOB#=1022 JOBNAME=I USER=KEN.NRJE |
| 5 DATA SETS RECEIVED FROM HOST AS OF WED, AUG 5, 1987, 4:20 PM |
| PR= (NOT SPECIFIED) PU= (NOT SPECIFIED) FO= (NOT SPECIFIED) |
| |
2 JOB(S) TRANSMITTED TO HOST.
____________________________________________________________________________
_______________________________________________________________________________
| |
| RMT32>REMARK THIS SHOW @ IS BY A USER WITHOUT NM CAPABILITY |
| |
| Provide information about all jobs owned by user who|
| entered SHOW command. |
| |
| RMT32>SHOW @ |
| |
| #O Name Pri State Rank Size User.Account Time |
| 1069 13 READY 3 32 KEN.NRJE 10:48 |
| |
| 1 JOB(S) AWAITING TRANSMISSION TO HOST. |
| |
| --JOB#=1022 JOBNAME=I USER=KEN.NRJE |
| 5 DATA SETS RECEIVED FROM HOST AS OF WED, AUG 5, 1987, 4:20 PM |
| PR= (NOT SPECIFIED) PU= (NOT SPECIFIED) FO= (NOT SPECIFIED) |
| |
| 1 JOB(S) TRANSMITTED TO HOST. |
| |
| RMT32>REMARK THIS USER HAS NM CAPABILITY |
| RMT32>SHOW ;HJ=1022,1030 |
| |
| --JOB#=1022 JOBNAME=I USER=KEN.NRJE |
| 5 DATA SETS RECEIVED FROM HOST AS OF WED, AUG 5, 1987, 4:20 PM |
| PR= FILE OUTPUT;DEV=PP;ENV=LP602.HPENV.SYS PU= (NOT SPECIFIED) |
| FO=discfile.mygroup.myacct. |
| |
| --JOB#=1030 JOBNAME=DS1 USER=ANNE.NRJE |
| TRANSMITTED TO HOST WED, AUG 5, 1987, 4:05 PM HOST#=3022 |
| PR= (NOT SPECIFIED) PU= (NOT SPECIFIED) FO= (NOT SPECIFIED) |
| |
| 2 JOB(S) TRANSMITTED TO HOST. |
_______________________________________________________________________________
Text Reference
The following intrinsics are related to this command:
* NRJEJobInfo: returns information about jobs awaiting transmission.
* NRJEHJInfo: returns information about transmitted jobs from the Job
Log.
These intrinsics are described in Chapter 5, "User Intrinsics."
MPE/iX 5.0 Documentation