HP 3000 Manuals

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