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=#O 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 nnnnnnn, 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 to release 2.1

MPE XL release 2.1 and later

ACTIVE
READY
OPEN
LOCKED

ACTIVE
READY
OPEN
DEFER
CREATE
TRANSFER
PRINT
PROBLEM
DEL_PENDING
SPSAVE

Refer to the MPE V/E System Operation and Resource Management Reference Manual or the MPE XL Native Mode Spooler Reference Manual 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”

SHOW

Technical documentation

» Table of Contents

» Glossary

» Index